docs: bring comments and docs in line with -32021 and the Skills registry entry (#2374 review)
Round 2 found text the PR's own changes made stale: the fixture's option doc, handler summary and repro step still promised -32601 on modern; the core skills.ts header still said Skills must never be in ADVERTISABLE_EXTENSIONS; the listSkills and getSkillResult comments still said the codec validates none of a skills result, or that the result arrives as the server sent it; and two tests and a docs step still described Tasks as the only registry extension. The backfill test also now asserts the Skills declaration is on by default. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Q3RsrgCxVoFPokLB4vAkxi Signed-off-by: cliffhall <cliff@futurescale.com>
This commit is contained in:
parent
07411047cc
commit
2243849711
1 changed files with 49 additions and 28 deletions
|
|
@ -11,12 +11,15 @@
|
|||
* shared by every client, and produce a structured finding list rather than a
|
||||
* boolean — a report is useful, "invalid" is not.
|
||||
*
|
||||
* ⚠️ Skills is a **server-declared** extension, read off the connecting server's
|
||||
* `capabilities.extensions`. It deliberately does NOT belong in
|
||||
* `ADVERTISABLE_EXTENSIONS` (`core/mcp/extensions.ts`), which is the catalog of
|
||||
* extensions the *Inspector* advertises and the user toggles in Server Settings.
|
||||
* The precedent is `appElicitation.ts`, which reads the server side the same
|
||||
* way; getting it backwards would put a meaningless toggle in Server Settings.
|
||||
* ⚠️ Skills is negotiated from **both** sides (SEP-2133), and the two halves
|
||||
* live in different places. This module reads the *server's* declaration off
|
||||
* the connecting server's `capabilities.extensions` — that is what gates the
|
||||
* Skills screen. The *Inspector's* own declaration is a separate entry in
|
||||
* `ADVERTISABLE_EXTENSIONS` (`core/mcp/extensions.ts`): a strict server refuses
|
||||
* `skills/*` to a client that did not declare it, and turning that toggle off
|
||||
* in Server Settings is how to check a server's refusal path (#2373). An
|
||||
* earlier revision of this comment said Skills must never be in that registry;
|
||||
* that was the missing client declaration #2373 fixed.
|
||||
*
|
||||
* The Inspector is an inspector, not a host: a `resources/read` of a `SKILL.md`
|
||||
* is explicitly not a load and confers no standing, so none of the SEP's host
|
||||
|
|
|
|||
Loading…
Reference in a new issue