@orkestrel/mcp 0.0.19 → 0.0.21

package/dist/src/core/index.d.cts

@@ -8,7 +8,7 @@ import { ToolManagerInterface } from '@orkestrel/tool';
 import { ToolResult } from '@orkestrel/tool';
 
 /**
- * Pipe an {@link MCPTransportInterface} into an {@link MCPClientInterface} — every
+ * Pipes an {@link MCPTransportInterface} into an {@link MCPClientInterface} — every
  * inbound message is decoded and delivered onto the client's OWN transport
  * (`client.transport.emitter`'s `message` / `close` events), resolving/rejecting the
  * client's correlated pending requests exactly as a direct reply would.
@@ -22,7 +22,7 @@ import { ToolResult } from '@orkestrel/tool';
  * this binder then completes the inbound half by decoding each message and pushing it
  * onto `client.transport.emitter` (an {@link import('@orkestrel/emitter').EmitterInterface}
  * exposes `emit`, so no client modification is needed). A malformed / non-JSON-RPC
- * inbound message is DROPPED (§14, total — never throws); a delivery fault is routed to
+ * inbound message is DROPPED (total — never throws); a delivery fault is routed to
  * `client.transport.emitter`'s `error` event (never rethrown). The returned unbind
  * DETACHES this binder (further inbound messages and the transport's `closed` signal are
  * ignored) WITHOUT closing the transport.
@@ -40,7 +40,7 @@ import { ToolResult } from '@orkestrel/tool';
  * itself when a caller's `signal` aborts, on a carrier declaring `duplex`. Adding a registry
  * here would be a second correlation table for ids the client is already correlating, and two
  * tables for one fact drift. The one obligation this binder does carry is delivery: a
- * malformed / non-JSON-RPC inbound message is DROPPED (§14, total — never throws).
+ * malformed / non-JSON-RPC inbound message is DROPPED (total — never throws).
  *
  * @param client - The transport-agnostic client whose transport to deliver messages onto
  * @param transport - The duplex channel to pipe the client over
@@ -58,9 +58,9 @@ import { ToolResult } from '@orkestrel/tool';
 export declare function bindClient(client: MCPClientInterface, transport: MCPTransportInterface): () => void;
 
 /**
- * Pipe an {@link MCPTransportInterface} into an {@link MCPDispatcherInterface} — every
+ * Pipes an {@link MCPTransportInterface} into an {@link MCPDispatcherInterface} — every
  * inbound message runs through `server.handle`, and a defined reply is written back
- * via `transport.send`.
+ * through `transport.send`.
  *
  * @remarks
  * `server.handle` already turns a malformed message into a serialized `-32700` /
@@ -81,7 +81,7 @@ export declare function bindClient(client: MCPClientInterface, transport: MCPTra
  * **This binder OWNS every exchange it starts, and ends each one on every exit.** It holds one
  * `AbortController` per live request, keyed by the request's id and deleted whenever that
  * request leaves — normally, by a throw, or by cancellation — and it supplies that signal to
- * `handle` as {@link import('./types.js').MCPDispatchOptions}. Three consequences follow.
+ * `handle` as {@link import('./types.js').MCPDispatchOptions}. These consequences follow.
  * An inbound `notifications/cancelled` ABORTS the request it names, which is how the message-
  * based cancellation path reaches a tool on the carriers that have one (stdio, WebSocket,
  * `MessagePort`); a cancelled request writes NO response, because a peer that asked for a call
@@ -111,12 +111,12 @@ export declare function bindClient(client: MCPClientInterface, transport: MCPTra
 export declare function bindServer(server: MCPDispatcherInterface, transport: MCPTransportInterface): () => void;
 
 /**
- * Narrow one `tools/call` answer to the arm the peer chose.
+ * Narrows one `tools/call` answer to the arm the peer chose.
  *
  * @remarks
- * The three arms {@link matchesResultType} admits are the whole space this sees, because a
+ * The arms {@link matchesResultType} admits are the whole space this sees, because a
  * `resultType` the client cannot name is refused at correlation. What is left is validating
- * the two arms the protocol gives a shape to, and deriving the tool's value from the one it
+ * the arms the protocol gives a shape to, and deriving the tool's value from the one it
  * does not:
  *
  * - A peer's `structuredContent` is PREFERRED over the content blocks, because it is the
@@ -142,7 +142,7 @@ export declare function bindServer(server: MCPDispatcherInterface, transport: MC
 export declare function buildCallOutcome(name: string, result: unknown): MCPCallOutcome;
 
 /**
- * Build one official cancellation notification for a request already sent.
+ * Builds one official cancellation notification for a request already sent.
  *
  * @remarks
  * `requestId` and `reason` are WIRE SPELLINGS carried verbatim from the dated schema's
@@ -172,7 +172,7 @@ export declare function buildCallOutcome(name: string, result: unknown): MCPCall
 export declare function buildCancelledNotification(id: JSONRPCId, reason?: string): JSONRPCNotification;
 
 /**
- * Build the mandatory modern `server/discover` result.
+ * Builds the mandatory modern `server/discover` result.
  *
  * @remarks
  * `capabilities.resources` and `capabilities.prompts` appear only for servers with their
@@ -190,7 +190,7 @@ export declare function buildCancelledNotification(id: JSONRPCId, reason?: strin
 export declare function buildDiscoverResult(options: MCPServerOptions): MCPDiscoverResult;
 
 /**
- * Build the MCP `initialize` result — the negotiated protocol version, the
+ * Builds the MCP `initialize` result — the negotiated protocol version, the
  * advertised capabilities, and the server identity.
  *
  * @remarks
@@ -208,7 +208,7 @@ export declare function buildDiscoverResult(options: MCPServerOptions): MCPDisco
 export declare function buildInitializeResult(name: string, version: string, requested?: string): MCPLegacyResult;
 
 /**
- * Build a JSON-RPC error {@link JSONRPCErrorResponse} — the `id` echoed, the failure
+ * Builds a JSON-RPC error {@link JSONRPCErrorResponse} — the `id` echoed, the failure
  * as an `error` object.
  *
  * @remarks
@@ -225,7 +225,7 @@ export declare function buildInitializeResult(name: string, version: string, req
 export declare function buildJSONRPCError(id: JSONRPCId | undefined, code: number, message: string, data?: unknown): JSONRPCErrorResponse;
 
 /**
- * Build a JSON-RPC success {@link JSONRPCResultResponse} — the `id` echoed, the
+ * Builds a JSON-RPC success {@link JSONRPCResultResponse} — the `id` echoed, the
  * method's value as `result`.
  *
  * @remarks
@@ -239,7 +239,7 @@ export declare function buildJSONRPCError(id: JSONRPCId | undefined, code: numbe
 export declare function buildJSONRPCResult(id: JSONRPCId, result: MCPResult | MCPLegacyResult): JSONRPCResultResponse;
 
 /**
- * Resolve the caller-facing dispatch options into the options a dispatched method
+ * Resolves the caller-facing dispatch options into the options a dispatched method
  * receives.
  *
  * @remarks
@@ -269,7 +269,7 @@ export declare function buildJSONRPCResult(id: JSONRPCId, result: MCPResult | MC
 export declare function buildMethodOptions(options: MCPDispatchOptions, lifetime: AbortSignal): MCPMethodOptions;
 
 /**
- * Stamp a result with the modern complete-result discriminator and server
+ * Stamps a result with the modern complete-result discriminator and server
  * metadata, plus cache fields when the result is cacheable.
  *
  * @remarks
@@ -296,7 +296,7 @@ export declare function buildModernResult<T extends object>(result: T, identity:
 };
 
 /**
- * Build one official progress notification for the original request stream.
+ * Builds one official progress notification for the original request stream.
  *
  * @param token - The request's original opaque progress token
  * @param progress - The finite progress payload
@@ -305,7 +305,7 @@ export declare function buildModernResult<T extends object>(result: T, identity:
 export declare function buildProgressNotification(token: string | number, progress: MCPProgress): JSONRPCNotification;
 
 /**
- * Build the first notification carrying a subscription id for a listen request.
+ * Builds the first notification carrying a subscription id for a listen request.
  *
  * @param notifications - The exact notification filter the server will honour
  * @param id - The `subscriptions/listen` request id
@@ -314,7 +314,7 @@ export declare function buildProgressNotification(token: string | number, progre
 export declare function buildSubscriptionAcknowledgement(notifications: MCPSubscriptionFilter, id: JSONRPCId): JSONRPCNotification;
 
 /**
- * Intersect a requested subscription filter with the notification families a server supports.
+ * Intersects a requested subscription filter with the notification families a server supports.
  *
  * @param requested - The notification families requested by the client
  * @param supported - The notification families the server can actually produce
@@ -323,7 +323,7 @@ export declare function buildSubscriptionAcknowledgement(notifications: MCPSubsc
 export declare function buildSubscriptionFilter(requested: MCPSubscriptionFilter, supported: MCPSubscriptionFilter): MCPSubscriptionFilter;
 
 /**
- * Build the terminating response for a subscription source that closes gracefully.
+ * Builds the terminating response for a subscription source that closes gracefully.
  *
  * @param id - The `subscriptions/listen` request id
  * @param identity - The server identity included by the modern result stamping site
@@ -332,7 +332,7 @@ export declare function buildSubscriptionFilter(requested: MCPSubscriptionFilter
 export declare function buildSubscriptionResult(id: JSONRPCId, identity: MCPIdentity): JSONRPCResultResponse;
 
 /**
- * Build the canonical Tool call for one validated MCP `tools/call` request.
+ * Builds the canonical Tool call for one validated MCP `tools/call` request.
  *
  * @param request - The original MCP request
  * @param caller - Optional consumer-asserted caller context
@@ -342,7 +342,7 @@ export declare function buildSubscriptionResult(id: JSONRPCId, identity: MCPIden
 export declare function buildToolCall(request: JSONRPCRequest, caller?: unknown, args?: Readonly<Record<string, unknown>>): ToolCall | undefined;
 
 /**
- * Map a {@link ToolManagerInterface}'s definitions to MCP `tools/list` descriptors
+ * Maps a {@link ToolManagerInterface}'s definitions to MCP `tools/list` descriptors
  * — renaming `parameters` to the wire's `inputSchema`.
  *
  * @remarks
@@ -357,7 +357,7 @@ export declare function buildToolCall(request: JSONRPCRequest, caller?: unknown,
 export declare function buildToolDescriptors(manager: ToolManagerInterface): readonly MCPToolDescriptor[];
 
 /**
- * Adapt an {@link MCPTransportInterface} (the environment-agnostic duplex message
+ * Adapts an {@link MCPTransportInterface} (the environment-agnostic duplex message
  * channel) into a {@link MCPClientTransportInterface} — the additive bridge that lets
  * `createMCPClient` run over the new port without any change to `MCPClient`'s
  * existing shape.
@@ -365,7 +365,7 @@ export declare function buildToolDescriptors(manager: ToolManagerInterface): rea
  * @remarks
  * Hand the RESULT to `createMCPClient({ transport })`, then pass the SAME
  * `transport` to {@link import('./helpers.js').bindClient} to complete the inbound
- * wiring: `send` serializes each outbound {@link JSONRPCMessage} and writes it via
+ * wiring: `send` serializes each outbound {@link JSONRPCMessage} and writes it through
  * `transport.send`; `close` closes the underlying
  * `transport`; `start` is a no-op (the duplex channel is already open by the time
  * it is handed in — there is no separate connect step at this layer); `session` is
@@ -393,7 +393,7 @@ export declare function buildToolDescriptors(manager: ToolManagerInterface): rea
 export declare function createDuplexClientTransport(transport: MCPTransportInterface): MCPClientTransportInterface;
 
 /**
- * Create a transport-agnostic Model Context Protocol CLIENT — connects to a REMOTE
+ * Creates a transport-agnostic Model Context Protocol CLIENT — connects to a REMOTE
  * MCP server over an injected {@link import('./types.js').MCPClientTransportInterface},
  * runs the `initialize` handshake, and exposes the server's tools as local
  * {@link import('@orkestrel/tool').ToolInterface}s an agent can run.
@@ -407,8 +407,7 @@ export declare function createDuplexClientTransport(transport: MCPTransportInter
  * locally, so an agent's {@link import('@orkestrel/tool').ToolManagerInterface}
  * isolates it). The transport is injected — a concrete one (the HTTP transport over
  * `fetch`) lives in the published server environment; the client itself is provider-agnostic. Subscribe
- * to `connect` / `disconnect` / `notification` via `client.on(...)` (or
- * `client.emitter.on(...)`).
+ * to `connect` / `disconnect` / `notification` through `client.emitter.on(...)`.
  *
  * @param options - `transport` (the carrier; REQUIRED), an optional `identity`
  *   (the client identity), `timeout` (the per-request deadline), and the reserved `on`
@@ -417,7 +416,7 @@ export declare function createDuplexClientTransport(transport: MCPTransportInter
  *
  * @example
  * ```ts
- * import { createMCPClient } from '@src/core'
+ * import { createMCPClient } from '@orkestrel/mcp'
  * import { createHTTPClientTransport } from '@orkestrel/mcp/server'
  *
  * const client = createMCPClient({
@@ -431,7 +430,7 @@ export declare function createDuplexClientTransport(transport: MCPTransportInter
 export declare function createMCPClient(options: MCPClientOptions): MCPClientInterface;
 
 /**
- * Decorate one MCP server with the fixed legacy method translation.
+ * Decorates one MCP server with the fixed legacy method translation.
  *
  * @param server - The sole modern dispatcher and handshake identity source
  * @returns A dispatcher accepting both modern and legacy invocations
@@ -439,7 +438,7 @@ export declare function createMCPClient(options: MCPClientOptions): MCPClientInt
 export declare function createMCPLegacy(server: MCPServerInterface): MCPDispatcherInterface;
 
 /**
- * Create a transport-agnostic Model Context Protocol server — exposes a live
+ * Creates a transport-agnostic Model Context Protocol server — exposes a live
  * {@link import('@orkestrel/tool').ToolManagerInterface} and an optional
  * {@link import('./types.js').MCPResourceManagerInterface},
  * {@link import('./types.js').MCPPromptManagerInterface}, and
@@ -452,7 +451,7 @@ export declare function createMCPLegacy(server: MCPServerInterface): MCPDispatch
  * and no model. The {@link import('@orkestrel/tool').ToolManagerInterface} already
  * isolates a thrown tool into a `success: false` result (surfaced as an MCP
  * `isError: true` tool result), so a misbehaving tool never crashes a dispatch. Subscribe to the
- * `request` event via `server.emitter.on('request', …)` for tracing.
+ * `request` event through `server.emitter.on('request', …)` for tracing.
  *
  * @param options - `identity` (the server identity), `tools` (the live tool
  *   registry), optional `resources` (the consumer-owned resource registry), optional
@@ -464,7 +463,8 @@ export declare function createMCPLegacy(server: MCPServerInterface): MCPDispatch
  *
  * @example
  * ```ts
- * import { createMCPServer, createTool, createToolManager } from '@src/core'
+ * import { createMCPServer } from '@orkestrel/mcp'
+ * import { createTool, createToolManager } from '@orkestrel/tool'
  *
  * const tools = createToolManager()
  * tools.add(createTool({ name: 'add', execute: (a) => Number(a.x) + Number(a.y) }))
@@ -480,7 +480,7 @@ export declare function createMCPLegacy(server: MCPServerInterface): MCPDispatch
 export declare function createMCPServer(options: MCPServerOptions): MCPServerInterface;
 
 /**
- * Decode one raw inbound message within an explicit bound — the decode a binder performs
+ * Decodes one raw inbound message within an explicit bound — the decode a binder performs
  * before it hands the string on.
  *
  * @remarks
@@ -488,14 +488,14 @@ export declare function createMCPServer(options: MCPServerOptions): MCPServerInt
  * `JSON.parse`d at all: a decoder that parses before it measures has already spent the work
  * the bound exists to refuse. A message over the bound, malformed JSON, and a well-formed
  * value that is not a JSON-RPC message are one answer — `undefined` — because a binder does
- * exactly the same thing with all three: nothing, and let
+ * exactly the same thing with each of them: nothing, and let
  * {@link import('./types.js').MCPServerInterface.handle} produce the wire refusal from the
  * same bound.
  *
- * Total (§14) — never throws, whatever the input.
+ * Total — never throws, whatever the input.
  *
  * @param message - The raw inbound JSON-RPC message string
- * @param limits - The byte and depth bounds to decode within (the server's own, via `limit`)
+ * @param limits - The byte and depth bounds to decode within (the server's own, from `limit`)
  * @returns The decoded message, or `undefined` when it is over the bound or is not one
  *
  * @example
@@ -542,9 +542,6 @@ export declare const DEFAULT_MCP_LIMITS: Readonly<{
     depth: 32;
 }>;
 
-/** The maximum discovery-probe deadline used when a client deadline is configured. */
-export declare const DEFAULT_MCP_PROBE_TIMEOUT = 50;
-
 /**
  * The default per-request deadline (ms) an `MCPClient` applies when `options.timeout`
  * is unset — a request the remote server does not answer within it rejects.
@@ -552,7 +549,7 @@ export declare const DEFAULT_MCP_PROBE_TIMEOUT = 50;
 export declare const DEFAULT_MCP_REQUEST_TIMEOUT = 30000;
 
 /**
- * Compute a lowercase host-neutral SHA-256 digest of one bounded canonical JSON value.
+ * Computes a lowercase host-neutral SHA-256 digest of one bounded canonical JSON value.
  *
  * @param value - The unknown value to validate and digest
  * @param limits - Serialized byte, key, and depth limits
@@ -577,7 +574,7 @@ export declare function digestJSON(value: unknown, limits: MCPJSONLimitOptions):
 export declare const EMPTY_MCP_ARGUMENTS: Readonly<Record<string, unknown>>;
 
 /**
- * Concatenate an MCP tool-call result's text content blocks into one string.
+ * Concatenates an MCP tool-call result's text content blocks into one string.
  *
  * @remarks
  * The inverse of a server splitting a value into text block(s), and TOTAL: a non-record
@@ -597,7 +594,7 @@ export declare const EMPTY_MCP_ARGUMENTS: Readonly<Record<string, unknown>>;
 export declare function extractContentText(result: unknown): string;
 
 /**
- * Infer the wire era for an MCP protocol revision.
+ * Infers the wire era for an MCP protocol revision.
  *
  * @param version - The protocol revision to classify
  * @returns `'modern'` for `2026-07-28`, `'legacy'` for either supported legacy
@@ -606,12 +603,12 @@ export declare function extractContentText(result: unknown): string;
 export declare function inferEra(version: string): MCPEra | undefined;
 
 /**
- * Infer the protocol version an outbound message announces itself with — the ONE
+ * Infers the protocol version an outbound message announces itself with — the ONE
  * projection every HTTP client transport stamps `mcp-protocol-version` from.
  *
  * @remarks
  * This is deliberately the SAME read the server's own expectation performs
- * ({@link import('@src/server').inferHeaderIssue}): a modern request's reserved
+ * ({@link import('@orkestrel/mcp/server').inferHeaderIssue}): a modern request's reserved
  * `_meta` version, accepted whenever it is a string. It is NOT
  * {@link import('./parsers.js').parseRequestContext}, and the difference is the whole
  * point. That parser answers a different question — is the modern metadata WELL FORMED —
@@ -624,7 +621,7 @@ export declare function inferEra(version: string): MCPEra | undefined;
  * `initialize` handshake the transport captured, not from the message.
  *
  * Header NAMES stay with the transports that own the wire (see `constants.ts`); core owns
- * the value this projection derives, which is the part the two faces disagreed about.
+ * the value this projection derives, which is the part the browser and Node faces disagreed about.
  *
  * @param message - The outbound message about to be written
  * @returns The version to announce, or `undefined` when the message announces none
@@ -637,7 +634,7 @@ export declare function inferEra(version: string): MCPEra | undefined;
 export declare function inferRequestVersion(message: JSONRPCMessage): string | undefined;
 
 /**
- * Infer the newest supported protocol revision present in a peer's offer.
+ * Infers the newest supported protocol revision present in a peer's offer.
  *
  * @param offered - The protocol revisions offered by the peer
  * @returns The newest locally supported offered revision, or `undefined`
@@ -645,7 +642,7 @@ export declare function inferRequestVersion(message: JSONRPCMessage): string | u
 export declare function inferVersion(offered: readonly string[]): MCPVersion | undefined;
 
 /**
- * Determine whether a value is one absolute URI under RFC 3986 syntax.
+ * Determines whether a value is one absolute URI under RFC 3986 syntax.
  *
  * @remarks
  * This host-neutral syntax guard does not resolve, normalize, decode, fetch, or apply a
@@ -657,7 +654,7 @@ export declare function inferVersion(offered: readonly string[]): MCPVersion | u
 export declare function isAbsoluteURI(value: unknown): value is string;
 
 /**
- * Determine whether a value is bounded, cycle-free exact JSON.
+ * Determines whether a value is bounded, cycle-free exact JSON.
  *
  * @remarks
  * Traversal is iterative, ancestor-aware, and contained by {@link attempt}; deep input,
@@ -676,7 +673,7 @@ export declare function isAbsoluteURI(value: unknown): value is string;
 export declare function isBoundedJSON<T>(value: T, limits: MCPJSONLimitOptions): value is T & JSONValue;
 
 /**
- * Determine whether a value is a string within a UTF-8 byte bound.
+ * Determines whether a value is a string within a UTF-8 byte bound.
  *
  * @param value - The unknown value to inspect
  * @param bytes - The maximum accepted encoded bytes
@@ -691,7 +688,7 @@ export declare function isBoundedJSON<T>(value: T, limits: MCPJSONLimitOptions):
 export declare function isBoundedString(value: unknown, bytes: number): value is string;
 
 /**
- * Determine whether accepted elicitation content satisfies the exact schema that was issued.
+ * Determines whether accepted elicitation content satisfies the exact schema that was issued.
  *
  * @remarks
  * {@link isMCPElicitResult} says a response has the SHAPE of a response; this says the
@@ -713,7 +710,7 @@ export declare function isBoundedString(value: unknown, bytes: number): value is
  * that answers more than it was asked is not refused for it. A `schema` that is not itself a
  * valid {@link MCPElicitSchema} admits NOTHING — an unenforceable schema is never a permissive
  * one — which is why `schema` is accepted as `unknown` and checked rather than trusted. Total
- * (§14) over hostile content and hostile schemas alike.
+ * over hostile content and hostile schemas alike.
  *
  * @param value - The accepted response content to check
  * @param schema - The exact {@link MCPElicitSchema} that was issued with the elicitation
@@ -734,7 +731,7 @@ export declare function isBoundedString(value: unknown, bytes: number): value is
 export declare function isElicitContent(value: unknown, schema: unknown): value is Readonly<Record<string, MCPElicitValue>>;
 
 /**
- * Determine whether a client capability record declares form-mode elicitation.
+ * Determines whether a client capability record declares form-mode elicitation.
  *
  * @remarks
  * The protocol's empty `elicitation` object is the implicit form-only declaration.
@@ -753,7 +750,7 @@ export declare function isElicitContent(value: unknown, schema: unknown): value
 export declare function isFormElicitationSupported(value: unknown): boolean;
 
 /**
- * Determine whether a parsed value is an MCP `initialize` invocation.
+ * Determines whether a parsed value is an MCP `initialize` invocation.
  *
  * @param value - The already-parsed value to test
  * @returns `true` when `value` is a valid `initialize` request or notification
@@ -766,26 +763,26 @@ export declare function isFormElicitationSupported(value: unknown): boolean;
  */
 export declare function isInitializeRequest(value: unknown): value is JSONRPCInvocation;
 
-/** Determine whether a value is an exact finite JSON object. */
+/** Determines whether a value is an exact finite JSON object. */
 export declare function isJSONObject(value: unknown): value is Readonly<Record<string, JSONValue>>;
 
 /**
- * Determine whether a value is one JSON-RPC `error` member.
+ * Determines whether a value is one JSON-RPC `error` member.
  *
  * @remarks
  * The failure OBJECT, not the envelope carrying it — the shape a failed response owns
  * under `error`, and the shape a `failed` {@link MCPTaskDetail} owns under the same name,
- * which is why it is one guard rather than the same three checks written twice.
+ * which is why it is one guard rather than the same checks written twice.
  *
  * It is deliberately STRUCTURAL rather than exact-JSON: `data` is declared `unknown`, so
  * requiring the whole object to survive a JSON clone would refuse a legal error that
  * carried a non-JSON payload. Both callers here hand it an already-owned value.
  *
- * That choice is why the two key reads are guarded. Every sibling guard clones first, and a
+ * That choice is why the key reads are guarded. Every sibling guard clones first, and a
  * clone reads each key once behind a boundary that already owns totality; this one is the
  * family's only DIRECT reader, so it meets `code` and `message` exactly as the value defines
  * them — including as accessors that throw. Reading a named key off an unowned value is
- * itself the hostile step, and it is bounded here rather than allowed to escape. Total (§14).
+ * itself the hostile step, and it is bounded here rather than allowed to escape. Total.
  *
  * @param value - The already-parsed value to test
  * @returns `true` when `value` carries an integer `code` and a string `message`
@@ -799,14 +796,14 @@ export declare function isJSONObject(value: unknown): value is Readonly<Record<s
 export declare function isJSONRPCError(value: unknown): value is JSONRPCError;
 
 /**
- * Determine whether a parsed value is a {@link JSONRPCErrorResponse} — the failure
+ * Determines whether a parsed value is a {@link JSONRPCErrorResponse} — the failure
  * arm of a response.
  *
  * @remarks
  * `id` is OPTIONAL here and only here: a peer that could not read the failed
  * request's id OMITS the member rather than sending `null`, so an absent `id` is
  * valid and a `null` one is not. The envelope must own an `error` and must NOT own a
- * `result`. `error` carries an integer `code` and a string `message`. Total (§14).
+ * `result`. `error` carries an integer `code` and a string `message`. Total.
  *
  * @param value - The already-parsed value to test
  * @returns `true` when `value` is a valid JSON-RPC error response
@@ -820,7 +817,7 @@ export declare function isJSONRPCError(value: unknown): value is JSONRPCError;
 export declare function isJSONRPCErrorResponse(value: unknown): value is JSONRPCErrorResponse;
 
 /**
- * Determine whether a value is a valid JSON-RPC correlation id — a string or a
+ * Determines whether a value is a valid JSON-RPC correlation id — a string or a
  * finite integer.
  *
  * @remarks
@@ -828,7 +825,7 @@ export declare function isJSONRPCErrorResponse(value: unknown): value is JSONRPC
  * absence is what makes a call a notification) and `null` is not one either (MCP
  * omits an unreadable id rather than nulling it). A runtime numeric id must be a
  * finite integer; an empty string is a legal id, because the dated schema imposes
- * no minimum length. Total (§14): any other input returns `false`.
+ * no minimum length. Total: any other input returns `false`.
  *
  * @param value - The already-parsed value to test
  * @returns `true` when `value` is a string or a finite integer
@@ -845,12 +842,12 @@ export declare function isJSONRPCErrorResponse(value: unknown): value is JSONRPC
 export declare function isJSONRPCId(value: unknown): value is JSONRPCId;
 
 /**
- * Determine whether a parsed value is a {@link JSONRPCInvocation} — a request or a
+ * Determines whether a parsed value is a {@link JSONRPCInvocation} — a request or a
  * notification.
  *
  * @remarks
  * The union of {@link isJSONRPCRequest} and {@link isJSONRPCNotification}, which are
- * mutually exclusive, so a positive answer names exactly one arm. Total (§14).
+ * mutually exclusive, so a positive answer names exactly one arm. Total.
  *
  * @param value - The already-parsed value to test
  * @returns `true` when `value` is a valid JSON-RPC request or notification
@@ -858,11 +855,11 @@ export declare function isJSONRPCId(value: unknown): value is JSONRPCId;
 export declare function isJSONRPCInvocation(value: unknown): value is JSONRPCInvocation;
 
 /**
- * Determine whether a parsed value is a {@link JSONRPCMessage} — an invocation or a
+ * Determines whether a parsed value is a {@link JSONRPCMessage} — an invocation or a
  * response.
  *
  * @remarks
- * The union of {@link isJSONRPCInvocation} and {@link isJSONRPCResponse}. Total (§14).
+ * The union of {@link isJSONRPCInvocation} and {@link isJSONRPCResponse}. Total.
  *
  * @param value - The already-parsed value to test
  * @returns `true` when `value` is a valid JSON-RPC message
@@ -870,12 +867,12 @@ export declare function isJSONRPCInvocation(value: unknown): value is JSONRPCInv
 export declare function isJSONRPCMessage(value: unknown): value is JSONRPCMessage;
 
 /**
- * Determine whether a parsed value is a {@link JSONRPCNotification}.
+ * Determines whether a parsed value is a {@link JSONRPCNotification}.
  *
  * @remarks
  * A notification is a request-shaped call carrying NO `id` member — the protocol
  * forbids one, because nothing answers a notification. `params`, when present, must
- * be a record. Total (§14): any other input returns `false`.
+ * be a record. Total: any other input returns `false`.
  *
  * @param value - The already-parsed value to test
  * @returns `true` when `value` is a valid JSON-RPC notification
@@ -889,15 +886,15 @@ export declare function isJSONRPCMessage(value: unknown): value is JSONRPCMessag
 export declare function isJSONRPCNotification(value: unknown): value is JSONRPCNotification;
 
 /**
- * Determine whether a parsed value is a {@link JSONRPCRequest}.
+ * Determines whether a parsed value is a {@link JSONRPCRequest}.
  *
  * @remarks
  * A request is a record with `jsonrpc === '2.0'`, a string `method`, and an `id`
  * that {@link isJSONRPCId} accepts. An id-less call is NOT a request — it is a
  * {@link JSONRPCNotification}, which {@link isJSONRPCNotification} answers for. The
- * two guards are mutually exclusive on every input: this one requires a valid `id`
+ * guards are mutually exclusive on every input: this one requires a valid `id`
  * value, that one requires no own `id` member at all. `params`, when present, must
- * be a record. Total (§14): any other input returns `false`.
+ * be a record. Total: any other input returns `false`.
  *
  * @param value - The already-parsed value to test
  * @returns `true` when `value` is a valid JSON-RPC request
@@ -912,10 +909,10 @@ export declare function isJSONRPCNotification(value: unknown): value is JSONRPCN
 export declare function isJSONRPCRequest(value: unknown): value is JSONRPCRequest;
 
 /**
- * Determine whether a parsed value is a {@link JSONRPCResponse}.
+ * Determines whether a parsed value is a {@link JSONRPCResponse}.
  *
  * @remarks
- * The union of the two mutually exclusive arms. Total (§14).
+ * The union of the mutually exclusive arms. Total.
  *
  * @param value - The already-parsed value to test
  * @returns `true` when `value` is a valid JSON-RPC response
@@ -923,7 +920,7 @@ export declare function isJSONRPCRequest(value: unknown): value is JSONRPCReques
 export declare function isJSONRPCResponse(value: unknown): value is JSONRPCResponse;
 
 /**
- * Determine whether a parsed value is a {@link JSONRPCResultResponse} — the success
+ * Determines whether a parsed value is a {@link JSONRPCResultResponse} — the success
  * arm of a response.
  *
  * @remarks
@@ -932,7 +929,7 @@ export declare function isJSONRPCResponse(value: unknown): value is JSONRPCRespo
  * which is what makes this guard and {@link isJSONRPCErrorResponse} mutually
  * exclusive on every input. `result` itself must be an object: either a modern
  * {@link isMCPResult} or a legacy {@link isMCPLegacyResult}, never a bare primitive.
- * Total (§14).
+ * Total.
  *
  * @param value - The already-parsed value to test
  * @returns `true` when `value` is a valid JSON-RPC result response
@@ -946,7 +943,7 @@ export declare function isJSONRPCResponse(value: unknown): value is JSONRPCRespo
 export declare function isJSONRPCResultResponse(value: unknown): value is JSONRPCResultResponse;
 
 /**
- * Determine whether a value carries valid dated-schema MCP content annotations.
+ * Determines whether a value carries valid dated-schema MCP content annotations.
  *
  * @param value - The unknown value to inspect
  * @returns Whether the value is valid MCP annotations
@@ -954,7 +951,7 @@ export declare function isJSONRPCResultResponse(value: unknown): value is JSONRP
 export declare function isMCPAnnotations(value: unknown): value is MCPAnnotations;
 
 /**
- * Determine whether a value is embedded blob MCP resource contents.
+ * Determines whether a value is embedded blob MCP resource contents.
  *
  * @param value - The unknown value to inspect
  * @returns Whether the value is embedded blob resource contents
@@ -962,18 +959,18 @@ export declare function isMCPAnnotations(value: unknown): value is MCPAnnotation
 export declare function isMCPBlobResource(value: unknown): value is MCPBlobResource;
 
 /**
- * Determine whether a value is a complete modern MCP tool result.
+ * Determines whether a value is a complete modern MCP tool result.
  *
  * @param value - The unknown value to inspect
  * @returns Whether the value is a complete MCP call result
  */
 export declare function isMCPCallResult(value: unknown): value is MCPCallResult;
 
-/** Determine whether a value is one exact open dated client-capability declaration. */
+/** Determines whether a value is one exact open dated client-capability declaration. */
 export declare function isMCPClientCapabilities(value: unknown): value is MCPClientCapabilities;
 
 /**
- * Determine whether a value is one host-produced completion candidate set.
+ * Determines whether a value is one host-produced completion candidate set.
  *
  * @param value - The unknown value to inspect
  * @returns Whether its candidates and optional result facts are valid
@@ -981,7 +978,7 @@ export declare function isMCPClientCapabilities(value: unknown): value is MCPCli
 export declare function isMCPCompletion(value: unknown): value is MCPCompletion;
 
 /**
- * Determine whether a value is one `completion/complete` parameter object.
+ * Determines whether a value is one `completion/complete` parameter object.
  *
  * @param value - The unknown value to inspect
  * @returns Whether its reference, fragment, and optional string context are valid
@@ -989,7 +986,7 @@ export declare function isMCPCompletion(value: unknown): value is MCPCompletion;
 export declare function isMCPCompletionParams(value: unknown): value is MCPCompletionParams;
 
 /**
- * Determine whether a value is a prompt or resource-template completion reference.
+ * Determines whether a value is a prompt or resource-template completion reference.
  *
  * @param value - The unknown value to inspect
  * @returns Whether the discriminated reference is valid
@@ -997,7 +994,7 @@ export declare function isMCPCompletionParams(value: unknown): value is MCPCompl
 export declare function isMCPCompletionReference(value: unknown): value is MCPCompletionReference;
 
 /**
- * Determine whether a value is one complete, capped `completion/complete` result.
+ * Determines whether a value is one complete, capped `completion/complete` result.
  *
  * @param value - The unknown value to inspect
  * @returns Whether the result is complete and carries at most 100 candidates
@@ -1005,7 +1002,7 @@ export declare function isMCPCompletionReference(value: unknown): value is MCPCo
 export declare function isMCPCompletionResult(value: unknown): value is MCPCompletionResult;
 
 /**
- * Determine whether a value is one exact dated-schema MCP tool content block.
+ * Determines whether a value is one exact dated-schema MCP tool content block.
  *
  * @param value - The unknown value to inspect
  * @returns Whether the value is valid MCP content
@@ -1013,7 +1010,7 @@ export declare function isMCPCompletionResult(value: unknown): value is MCPCompl
 export declare function isMCPContent(value: unknown): value is MCPContent;
 
 /**
- * Determine whether a value is one restricted primitive form-elicitation schema.
+ * Determines whether a value is one restricted primitive form-elicitation schema.
  *
  * @param value - The unknown value to inspect
  * @returns `true` for a supported boolean, numeric, string, or string-array schema
@@ -1027,7 +1024,7 @@ export declare function isMCPContent(value: unknown): value is MCPContent;
 export declare function isMCPElicitFieldSchema(value: unknown): value is MCPElicitFieldSchema;
 
 /**
- * Determine whether a value is a form-mode elicitation parameter object.
+ * Determines whether a value is a form-mode elicitation parameter object.
  *
  * @param value - The unknown value to inspect
  * @returns `true` when `value` has the restricted form elicitation shape
@@ -1043,7 +1040,7 @@ export declare function isMCPElicitFieldSchema(value: unknown): value is MCPElic
 export declare function isMCPElicitForm(value: unknown): value is MCPElicitForm;
 
 /**
- * Determine whether a value is an embedded `elicitation/create` request.
+ * Determines whether a value is an embedded `elicitation/create` request.
  *
  * @param value - The unknown value to inspect
  * @returns `true` when `value` is a form- or URL-mode elicitation request
@@ -1059,7 +1056,7 @@ export declare function isMCPElicitForm(value: unknown): value is MCPElicitForm;
 export declare function isMCPElicitRequest(value: unknown): value is MCPElicitRequest;
 
 /**
- * Determine whether a value is one elicitation response.
+ * Determines whether a value is one elicitation response.
  *
  * @param value - The unknown value to inspect
  * @returns `true` when action/content have the protocol shape
@@ -1072,7 +1069,7 @@ export declare function isMCPElicitRequest(value: unknown): value is MCPElicitRe
 export declare function isMCPElicitResult(value: unknown): value is MCPElicitResult;
 
 /**
- * Determine whether a value is the restricted top-level object schema a form elicitation issues.
+ * Determines whether a value is the restricted top-level object schema a form elicitation issues.
  *
  * @remarks
  * The schema half of {@link isMCPElicitForm}, exported on its own because the issued schema
@@ -1093,7 +1090,7 @@ export declare function isMCPElicitResult(value: unknown): value is MCPElicitRes
 export declare function isMCPElicitSchema(value: unknown): value is MCPElicitSchema;
 
 /**
- * Determine whether a value is a URL-mode elicitation parameter object.
+ * Determines whether a value is a URL-mode elicitation parameter object.
  *
  * @param value - The unknown value to inspect
  * @returns `true` when `value` has the URL elicitation shape
@@ -1106,7 +1103,7 @@ export declare function isMCPElicitSchema(value: unknown): value is MCPElicitSch
 export declare function isMCPElicitURL(value: unknown): value is MCPElicitURL;
 
 /**
- * Determine whether an unknown value is an {@link MCPError}.
+ * Determines whether an unknown value is an {@link MCPError}.
  *
  * @param value - The unknown value to inspect
  * @returns `true` only when the value is an `MCPError`
@@ -1120,18 +1117,18 @@ export declare function isMCPElicitURL(value: unknown): value is MCPElicitURL;
 export declare function isMCPError(value: unknown): value is MCPError;
 
 /**
- * Determine whether a value is one exact dated-schema MCP icon.
+ * Determines whether a value is one exact dated-schema MCP icon.
  *
  * @param value - The unknown value to inspect
  * @returns Whether the value is a valid MCP icon
  */
 export declare function isMCPIcon(value: unknown): value is MCPIcon;
 
-/** Determine whether a value is one complete dated MCP implementation identity. */
+/** Determines whether a value is one complete dated MCP implementation identity. */
 export declare function isMCPIdentity(value: unknown): value is MCPIdentity;
 
 /**
- * Determine whether a value is one legal embedded multi-round-trip request.
+ * Determines whether a value is one legal embedded multi-round-trip request.
  *
  * @param value - The unknown value to inspect
  * @returns `true` for elicitation, deprecated sampling, or deprecated roots requests
@@ -1144,7 +1141,7 @@ export declare function isMCPIdentity(value: unknown): value is MCPIdentity;
 export declare function isMCPInputRequest(value: unknown): value is MCPInputRequest;
 
 /**
- * Determine whether a value is a server-keyed map of embedded input requests.
+ * Determines whether a value is a server-keyed map of embedded input requests.
  *
  * @param value - The unknown value to inspect
  * @returns `true` when every own value is a legal {@link MCPInputRequest}
@@ -1157,7 +1154,7 @@ export declare function isMCPInputRequest(value: unknown): value is MCPInputRequ
 export declare function isMCPInputRequestMap(value: unknown): value is MCPInputRequestMap;
 
 /**
- * Determine whether a value is an MCP input-required result.
+ * Determines whether a value is an MCP input-required result.
  *
  * @remarks
  * Enforces the at-least-one-of rule at runtime: `inputRequests`, `requestState`, or
@@ -1175,7 +1172,7 @@ export declare function isMCPInputRequestMap(value: unknown): value is MCPInputR
 export declare function isMCPInputResult(value: unknown): value is MCPInputResult;
 
 /**
- * Determine whether a value is one legacy-era MCP result.
+ * Determines whether a value is one legacy-era MCP result.
  *
  * @remarks
  * The legacy revision has no result discriminator, so the absence of `resultType` is
@@ -1193,17 +1190,17 @@ export declare function isMCPInputResult(value: unknown): value is MCPInputResul
  */
 export declare function isMCPLegacyResult(value: unknown): value is MCPLegacyResult;
 
-/** Determine whether a value is one dated MCP logging level. */
+/** Determines whether a value is one dated MCP logging level. */
 export declare function isMCPLoggingLevel(value: unknown): value is MCPLoggingLevel;
 
-/** Determine whether a string follows the dated MCP `_meta` key grammar. */
+/** Determines whether a string follows the dated MCP `_meta` key grammar. */
 export declare function isMCPMetaKey(value: unknown): value is string;
 
-/** Determine whether a value is exact finite MCP metadata with valid keys. */
+/** Determines whether a value is exact finite MCP metadata with valid keys. */
 export declare function isMCPMetaObject(value: unknown): value is MCPMetaObject;
 
 /**
- * Determine whether a value carries the shared optional pagination cursor.
+ * Determines whether a value carries the shared optional pagination cursor.
  *
  * @param value - The unknown value to inspect
  * @returns Whether a present `cursor` is a string
@@ -1211,7 +1208,7 @@ export declare function isMCPMetaObject(value: unknown): value is MCPMetaObject;
 export declare function isMCPPaginationParams(value: unknown): value is MCPPaginationParams;
 
 /**
- * Determine whether a value is one exact finite MCP progress payload.
+ * Determines whether a value is one exact finite MCP progress payload.
  *
  * @param value - The unknown value to inspect
  * @returns Whether required progress and optional total/message fields match the dated schema
@@ -1219,7 +1216,7 @@ export declare function isMCPPaginationParams(value: unknown): value is MCPPagin
 export declare function isMCPProgress(value: unknown): value is MCPProgress;
 
 /**
- * Determine whether a value is one `prompts/list` descriptor.
+ * Determines whether a value is one `prompts/list` descriptor.
  *
  * @param value - The unknown value to inspect
  * @returns Whether the prompt descriptor is valid
@@ -1227,7 +1224,7 @@ export declare function isMCPProgress(value: unknown): value is MCPProgress;
 export declare function isMCPPrompt(value: unknown): value is MCPPrompt;
 
 /**
- * Determine whether a value is one prompt argument descriptor.
+ * Determines whether a value is one prompt argument descriptor.
  *
  * @param value - The unknown value to inspect
  * @returns Whether the prompt argument descriptor is valid
@@ -1235,7 +1232,7 @@ export declare function isMCPPrompt(value: unknown): value is MCPPrompt;
 export declare function isMCPPromptArgument(value: unknown): value is MCPPromptArgument;
 
 /**
- * Determine whether a value is one complete `prompts/get` result.
+ * Determines whether a value is one complete `prompts/get` result.
  *
  * @param value - The unknown value to inspect
  * @returns Whether the prompt result and all messages are valid
@@ -1243,7 +1240,7 @@ export declare function isMCPPromptArgument(value: unknown): value is MCPPromptA
 export declare function isMCPPromptGetResult(value: unknown): value is MCPPromptGetResult;
 
 /**
- * Determine whether a value is one prompt message with existing rich content.
+ * Determines whether a value is one prompt message with existing rich content.
  *
  * @param value - The unknown value to inspect
  * @returns Whether the role and content are valid
@@ -1251,7 +1248,7 @@ export declare function isMCPPromptGetResult(value: unknown): value is MCPPrompt
 export declare function isMCPPromptMessage(value: unknown): value is MCPPromptMessage;
 
 /**
- * Determine whether a value is one consumer-owned prompt page.
+ * Determines whether a value is one consumer-owned prompt page.
  *
  * @param value - The unknown value to inspect
  * @returns Whether the prompts and optional following cursor are valid
@@ -1259,7 +1256,7 @@ export declare function isMCPPromptMessage(value: unknown): value is MCPPromptMe
 export declare function isMCPPromptPage(value: unknown): value is MCPPromptPage;
 
 /**
- * Determine whether a value is one `resources/list` descriptor.
+ * Determines whether a value is one `resources/list` descriptor.
  *
  * @param value - The unknown value to inspect
  * @returns Whether the value is a valid resource descriptor
@@ -1267,7 +1264,7 @@ export declare function isMCPPromptPage(value: unknown): value is MCPPromptPage;
 export declare function isMCPResource(value: unknown): value is MCPResource;
 
 /**
- * Determine whether a value is structurally discriminated resource contents.
+ * Determines whether a value is structurally discriminated resource contents.
  *
  * @param value - The unknown value to inspect
  * @returns Whether exactly one of `text` and `blob` is present and valid
@@ -1275,7 +1272,7 @@ export declare function isMCPResource(value: unknown): value is MCPResource;
 export declare function isMCPResourceContents(value: unknown): value is MCPResourceContents;
 
 /**
- * Determine whether a value is one consumer-owned resource page.
+ * Determines whether a value is one consumer-owned resource page.
  *
  * @param value - The unknown value to inspect
  * @returns Whether the resources and optional following cursor are valid
@@ -1283,7 +1280,7 @@ export declare function isMCPResourceContents(value: unknown): value is MCPResou
 export declare function isMCPResourcePage(value: unknown): value is MCPResourcePage;
 
 /**
- * Determine whether a value is one resource-template descriptor.
+ * Determines whether a value is one resource-template descriptor.
  *
  * @remarks
  * This guard validates the descriptor shape. Template expansion and the RFC 6570 feature
@@ -1295,7 +1292,7 @@ export declare function isMCPResourcePage(value: unknown): value is MCPResourceP
 export declare function isMCPResourceTemplate(value: unknown): value is MCPResourceTemplate;
 
 /**
- * Determine whether a value is one consumer-owned resource-template page.
+ * Determines whether a value is one consumer-owned resource-template page.
  *
  * @param value - The unknown value to inspect
  * @returns Whether the templates and optional following cursor are valid
@@ -1303,7 +1300,7 @@ export declare function isMCPResourceTemplate(value: unknown): value is MCPResou
 export declare function isMCPResourceTemplatePage(value: unknown): value is MCPResourceTemplatePage;
 
 /**
- * Determine whether a value is one modern MCP result.
+ * Determines whether a value is one modern MCP result.
  *
  * @remarks
  * The open contract's guard: a record carrying a string `resultType` and, when
@@ -1326,14 +1323,14 @@ export declare function isMCPResourceTemplatePage(value: unknown): value is MCPR
  */
 export declare function isMCPResult(value: unknown): value is MCPResult;
 
-/** Determine whether a value is exact result metadata with a valid reserved server identity. */
+/** Determines whether a value is exact result metadata with a valid reserved server identity. */
 export declare function isMCPResultMetaObject(value: unknown): value is MCPResultMetaObject;
 
-/** Determine whether a value is one exact open dated server-capability declaration. */
+/** Determines whether a value is one exact open dated server-capability declaration. */
 export declare function isMCPServerCapabilities(value: unknown): value is MCPServerCapabilities;
 
 /**
- * Determine whether a value is a string-valued MCP argument record.
+ * Determines whether a value is a string-valued MCP argument record.
  *
  * @param value - The unknown value to inspect
  * @returns Whether every own argument value is a string
@@ -1341,7 +1338,7 @@ export declare function isMCPServerCapabilities(value: unknown): value is MCPSer
 export declare function isMCPStringArguments(value: unknown): value is Readonly<Record<string, string>>;
 
 /**
- * Determine whether a value is an MCP {@link MCPSubscriptionFilter}.
+ * Determines whether a value is an MCP {@link MCPSubscriptionFilter}.
  *
  * @remarks
  * Every filter field is optional. Boolean notification families accept only booleans, and
@@ -1355,7 +1352,7 @@ export declare function isMCPStringArguments(value: unknown): value is Readonly<
 export declare function isMCPSubscriptionFilter(value: unknown): value is MCPSubscriptionFilter;
 
 /**
- * Determine whether a value is one durable task's full snapshot.
+ * Determines whether a value is one durable task's full snapshot.
  *
  * @remarks
  * The runtime enforcement of {@link MCPTaskManagerInterface.task}'s declared return shape,
@@ -1382,7 +1379,7 @@ export declare function isMCPSubscriptionFilter(value: unknown): value is MCPSub
 export declare function isMCPTaskDetail(value: unknown): value is MCPTaskDetail;
 
 /**
- * Determine whether a value is a modern MCP task-creation result.
+ * Determines whether a value is a modern MCP task-creation result.
  *
  * @remarks
  * The runtime enforcement of {@link MCPTaskManagerInterface.start}'s declared return
@@ -1403,7 +1400,7 @@ export declare function isMCPTaskDetail(value: unknown): value is MCPTaskDetail;
 export declare function isMCPTaskResult(value: unknown): value is MCPTaskResult;
 
 /**
- * Determine whether a value is one of the extension's five task lifecycle states.
+ * Determines whether a value is one of the extension's task lifecycle states.
  *
  * @param value - The unknown value to inspect
  * @returns Whether the value is an {@link MCPTaskStatus}
@@ -1417,7 +1414,7 @@ export declare function isMCPTaskResult(value: unknown): value is MCPTaskResult;
 export declare function isMCPTaskStatus(value: unknown): value is MCPTaskStatus;
 
 /**
- * Determine whether a value is embedded textual MCP resource contents.
+ * Determines whether a value is embedded textual MCP resource contents.
  *
  * @param value - The unknown value to inspect
  * @returns Whether the value is embedded textual resource contents
@@ -1425,7 +1422,7 @@ export declare function isMCPTaskStatus(value: unknown): value is MCPTaskStatus;
 export declare function isMCPTextResource(value: unknown): value is MCPTextResource;
 
 /**
- * Determine whether a value is a supported {@link MCPVersion}.
+ * Determines whether a value is a supported {@link MCPVersion}.
  *
  * @param value - The unknown value to inspect
  * @returns `true` when the value is one of {@link SUPPORTED_PROTOCOL_VERSIONS}
@@ -1433,7 +1430,7 @@ export declare function isMCPTextResource(value: unknown): value is MCPTextResou
 export declare function isMCPVersion(value: unknown): value is MCPVersion;
 
 /**
- * Determine whether a JSON-RPC invocation uses the modern per-request MCP wire shape.
+ * Determines whether a JSON-RPC invocation uses the modern per-request MCP wire shape.
  *
  * @remarks
  * Presence routes and validity answers: this guard checks only that
@@ -1448,7 +1445,7 @@ export declare function isMCPVersion(value: unknown): value is MCPVersion;
 export declare function isModernRequest(value: unknown): value is JSONRPCInvocation;
 
 /**
- * Determine whether a value is one RFC 3339 `full-date` naming a real calendar day.
+ * Determines whether a value is one RFC 3339 `full-date` naming a real calendar day.
  *
  * @remarks
  * RFC 3339 §5.6 defines `date-mday` as `01-28`, `29`, `30`, or `31` BASED ON the month and
@@ -1474,7 +1471,7 @@ export declare function isModernRequest(value: unknown): value is JSONRPCInvocat
 export declare function isRFC3339Date(value: unknown): value is string;
 
 /**
- * Determine whether a value is one RFC 3339 `date-time` naming a real calendar day.
+ * Determines whether a value is one RFC 3339 `date-time` naming a real calendar day.
  *
  * @remarks
  * The `full-date` half is {@link isRFC3339Date}, so an impossible day is refused here for
@@ -1498,7 +1495,7 @@ export declare function isRFC3339Date(value: unknown): value is string;
 export declare function isRFC3339DateTime(value: unknown): value is string;
 
 /**
- * Determine whether a value is standard padded base64 as required by JSON Schema `byte` format.
+ * Determines whether a value is standard padded base64 as required by JSON Schema `byte` format.
  *
  * @param value - The unknown value to inspect
  * @returns Whether the value is an empty or completely padded standard base64 encoding
@@ -1506,7 +1503,7 @@ export declare function isRFC3339DateTime(value: unknown): value is string;
 export declare function isStandardBase64(value: unknown): value is string;
 
 /**
- * Determine whether a client capability record declares the draft Tasks extension.
+ * Determines whether a client capability record declares the draft Tasks extension.
  *
  * @remarks
  * The declaration lives at `extensions['io.modelcontextprotocol/tasks']` and its value is
@@ -1603,7 +1600,7 @@ export declare type JSONRPCId = string | number;
  * One inbound JSON-RPC call — the common dispatch input.
  *
  * @remarks
- * Narrow the two apart on the id: `invocation.id === undefined` is the notification
+ * Narrow the arms apart on the id: `invocation.id === undefined` is the notification
  * arm, and anything else is a {@link JSONRPCRequest}.
  */
 export declare type JSONRPCInvocation = JSONRPCRequest | JSONRPCNotification;
@@ -1620,7 +1617,7 @@ export declare type JSONRPCMessage = JSONRPCInvocation | JSONRPCResponse;
 
 /**
  * A JSON-RPC 2.0 notification — a fire-and-forget `method` call that is answered by
- * nothing (e.g. `notifications/initialized`).
+ * nothing (for example, `notifications/initialized`).
  *
  * @remarks
  * A notification MUST NOT carry an `id`, so `id` is declared `never`: a
@@ -1658,7 +1655,7 @@ export declare interface JSONRPCRequest {
  * A JSON-RPC 2.0 response — the answer to one {@link JSONRPCRequest}.
  *
  * @remarks
- * The two arms are mutually exclusive in the type and in their guards. Narrow them
+ * The arms are mutually exclusive in the type and in their guards. Narrow them
  * apart with `response.error === undefined`.
  */
 export declare type JSONRPCResponse = JSONRPCResultResponse | JSONRPCErrorResponse;
@@ -1681,15 +1678,15 @@ export declare interface JSONRPCResultResponse {
 }
 
 /**
- * Determine whether one method may answer with a given modern `resultType`.
+ * Determines whether one method may answer with a given modern `resultType`.
  *
  * @remarks
- * The dated protocol lets a `tools/call` answer three ways — it COMPLETED, it became a
+ * The dated protocol lets a `tools/call` answer in more than one way — it COMPLETED, it became a
  * durable task, or it needs another round trip — while every other method this client
  * issues has exactly one legal answer. So the arm a peer chose is only meaningful beside
  * the method it answers, and this is the one place that pairing is decided.
  *
- * The rule is deliberately a WHITELIST: an unrecognized `resultType` is refused for every
+ * The rule is deliberately closed: an unrecognized `resultType` is refused for every
  * method, including `tools/call`. A client that carried an arm it cannot name would hand
  * its caller a value whose meaning it invented.
  *
@@ -1707,7 +1704,7 @@ export declare interface JSONRPCResultResponse {
 export declare function matchesResultType(method: string, resultType: unknown): boolean;
 
 /**
- * Determine whether a produced notification belongs to an honoured subscription filter.
+ * Determines whether a produced notification belongs to an honoured subscription filter.
  *
  * @param notification - The server notification offered by the configured producer
  * @param filter - The filter acknowledged to the client
@@ -1752,11 +1749,11 @@ export declare const MCP_META_VERSION = "io.modelcontextprotocol/protocolVersion
  *
  * @remarks
  * The GENERIC code for the whole condition, not one capability's code. This server answers
- * it in two places — a `tools/call` that needs `elicitation`, and a `tasks/*` request whose
- * client never declared `io.modelcontextprotocol/tasks` — and the two are told apart by
+ * it in more than one place — a `tools/call` that needs `elicitation`, and a `tasks/*` request
+ * whose client never declared `io.modelcontextprotocol/tasks` — and they are told apart by
  * `error.data.requiredCapabilities` alone (`{ elicitation: {} }` against
- * `{ extensions: { 'io.modelcontextprotocol/tasks': {} } }`). They are two instances of one
- * condition, so a second numeral would describe the same fact twice. The Tasks extension's
+ * `{ extensions: { 'io.modelcontextprotocol/tasks': {} } }`). They are instances of the same
+ * condition, so a separate numeral would describe the same fact twice. The Tasks extension's
  * own draft prose still shows `-32003` in examples; the dated core schema fixes this code,
  * and the dated schema is what a peer implements against.
  */
@@ -1823,14 +1820,14 @@ export declare interface MCPBlobResource {
  * handler is dropped in the same step.
  */
 export declare interface MCPCallOptions {
-    /** Cancel this one in-flight request; an already-aborted signal refuses it unsent. */
+    /** Cancels this one in-flight request; an already-aborted signal refuses it unsent. */
     readonly signal?: AbortSignal;
-    /** Receive this request's progress frames; supplying it stamps the progress token. */
+    /** Receives this request's progress frames; supplying it stamps the progress token. */
     readonly progress?: MCPProgressHandler;
 }
 
 /**
- * What one remote `tools/call` answered — the three arms the dated protocol permits.
+ * What one remote `tools/call` answered — the arms the dated protocol permits.
  *
  * @remarks
  * The peer chooses the arm, so the caller narrows on `resultType`:
@@ -1844,7 +1841,7 @@ export declare interface MCPCallOptions {
  *   is over and the work is not; the outcome arrives later through the task's own methods.
  * - {@link MCPInputResult} — the call needs another round trip before it can finish.
  *
- * A fourth `resultType` is refused rather than surfaced: this union is what the client
+ * An unknown `resultType` is refused rather than surfaced: this union is what the client
  * can carry, and an arm it cannot name is one it cannot hand a caller safely.
  */
 export declare type MCPCallOutcome = {
@@ -1896,16 +1893,16 @@ export declare type MCPCallResult = MCPUnstampedCallResult & {
  *   exit — the deadline, an abort, a rejecting `send`, the answer itself, and the
  *   teardown's drain — without any of those paths knowing they exist.
  * - **Per-request deadline.** An ordinary `#request` carries `this.#timeout`. The initial
- *   discovery probe uses that same 30-second default, or the shorter probe deadline where
- *   `timeout` was configured, so a silent peer cannot hold negotiation indefinitely.
+ *   discovery probe uses that same configured deadline, so a silent peer cannot hold
+ *   negotiation indefinitely.
  *   `AbortSignal.timeout` (never a raw `setTimeout`) rejects only that pending request, and the
  *   same deadline bounds the WAIT on the transport's `close`, the one wait no drain and no signal
  *   can reach. It bounds the wait rather than the close, which keeps running, so a retry joins it
  *   instead of shutting one connection down twice.
  * - **Transport-agnostic.** Imports only core siblings (JSON-RPC + the tool vocabulary);
- *   the concrete transport is injected. Wire fields are narrowed via the contracts
+ *   the concrete transport is injected. Wire fields are narrowed with the contract
  *   guards (no `as`).
- * - **Observable (§13).** The owned `emitter` fires `connect` / `disconnect` /
+ * - **Observable.** The owned `emitter` fires `connect` / `disconnect` /
  *   `notification` / `error`; the emitter isolates a listener throw and routes it to its
  *   `error` handler (the `error` option), so a listener throw can never escape.
  *
@@ -1927,7 +1924,6 @@ export declare class MCPClient implements MCPClientInterface {
     get version(): MCPVersion | undefined;
     get transport(): MCPClientTransportInterface;
     get tasks(): MCPTaskClientInterface;
-    on<K extends keyof MCPClientEventMap>(event: K, handler: (...args: MCPClientEventMap[K]) => void): void;
     connect(): Promise<void>;
     discover(): Promise<MCPDiscoverResult>;
     disconnect(): Promise<void>;
@@ -1951,8 +1947,8 @@ export declare type MCPClientCapabilities = Readonly<Record<string, MCPMetaObjec
 };
 
 /**
- * The push observation surface (§13) of an {@link MCPClientInterface} — the moments a
- * fire-and-forget observer (logging, tracing) subscribes to via `client.emitter.on`.
+ * The push observation surface of an {@link MCPClientInterface} — the moments a
+ * fire-and-forget observer (logging, tracing) subscribes to through `client.emitter.on`.
  *
  * @remarks
  * - `connect` — era negotiation completed and the client is connected: modern after
@@ -1961,14 +1957,14 @@ export declare type MCPClientCapabilities = Readonly<Record<string, MCPMetaObjec
  *   rejected, and the connection it owned on the transport closed — or that close faulted or
  *   timed out, which rejects the `disconnect` caller rather than withholding this event).
  * - `notification` — a server-initiated JSON-RPC NOTIFICATION arrived — forwarded for the
- *   consumer to react to (e.g. a `notifications/tools/list_changed`). A
+ *   consumer to react to (for example, a `notifications/tools/list_changed`). A
  *   `notifications/progress` frame claimed by an in-flight request's progress handler is
  *   delivered there instead, and a RESPONSE correlating to nothing pending is discarded
  *   rather than forwarded here, because it answers a request that has already settled.
- * - `error` — a client-level fault surfaced for observation (typed `unknown`, §13). This is
+ * - `error` — a client-level fault surfaced for observation (typed `unknown`). This is
  *   a DOMAIN event, distinct from the emitter's own listener-error channel: a listener throw
  *   is routed to the emitter's `error` handler (the `error` option), never onto this map.
- *   Declared as a `type` alias (§4.5) so the literal satisfies `EventMap`.
+ *   Declared as a `type` alias so the literal satisfies `EventMap`.
  */
 export declare type MCPClientEventMap = {
     /** Era negotiation completed — the client is connected. */
@@ -1977,7 +1973,7 @@ export declare type MCPClientEventMap = {
     readonly disconnect: readonly [];
     /** A server-initiated notification arrived (not a response to a pending request). */
     readonly notification: readonly [message: JSONRPCMessage];
-    /** A client-level fault surfaced for observation (typed `unknown`, §13). */
+    /** A client-level fault surfaced for observation (typed `unknown`). */
     readonly error: readonly [error: unknown];
 };
 
@@ -2020,18 +2016,18 @@ export declare type MCPClientEventMap = {
  *   says to ignore it rather than surface it as something a caller might act on.
  * - **Per-request deadline.** A request carrying a deadline races an
  *   `AbortSignal.timeout(timeout)`: a server that never replies REJECTS that pending
- *   request once the deadline fires. The initial discovery probe carries one only where
- *   `timeout` was configured, so a default client's probe — and a public `discover` call on such a
- *   client — waits for its peer indefinitely. The client's
+ *   request once the deadline fires. The initial discovery probe and every public request use a
+ *   deadline. An omitted `timeout` selects {@link DEFAULT_MCP_REQUEST_TIMEOUT}; an explicit
+ *   timeout applies that deadline to the probe. The client's
  *   wait on the transport's `close` carries that same deadline, because it is the one wait neither
  *   the pending-request drain nor the supersession signal can reach; the deadline ends the wait,
  *   not the close, so a retry joins that close rather than issuing a second one.
  * - **Transport-agnostic.** Imports only core siblings — JSON-RPC + the tool vocabulary
  *   + the timeout primitive — with no HTTP and no model; the concrete transport is
- *   injected. Wire fields are narrowed via the contracts guards (no `as`).
- * - **Observable (§13).** The owned `emitter` fires `connect` / `disconnect` /
+ *   injected. Wire fields are narrowed with the contract guards (no `as`).
+ * - **Observable.** The owned `emitter` fires `connect` / `disconnect` /
  *   `notification` / `error`; the emitter isolates a listener throw and routes it to its
- *   `error` handler (the `error` option, §13), never the client.
+ *   `error` handler (the `error` option), never the client.
  */
 export declare interface MCPClientInterface {
     readonly emitter: EmitterInterface<MCPClientEventMap>;
@@ -2045,22 +2041,14 @@ export declare interface MCPClientInterface {
      * The draft Tasks extension's client half — reading, answering, and stopping a durable task.
      *
      * @remarks
-     * Always present, because the three `tasks/*` methods are ordinary requests a client may
+     * Always present, because the `tasks/*` methods are ordinary requests a client may
      * issue at any time; whether they SUCCEED is the peer's decision, and a server that did not
-     * configure the extension answers all three `-32601`. Nothing here is advertised, cached, or
+     * configure the extension answers each of them `-32601`. Nothing here is advertised, cached, or
      * polled — see {@link MCPTaskClientInterface} for why the schedule stays the consumer's.
      */
     readonly tasks: MCPTaskClientInterface;
     /**
-     * Subscribe a listener to one of the client's {@link MCPClientEventMap} events —
-     * the convenience forward to `emitter.on` (§13).
-     *
-     * @param event - The event name to subscribe to
-     * @param handler - The listener for that event's argument tuple
-     */
-    on<K extends keyof MCPClientEventMap>(event: K, handler: (...args: MCPClientEventMap[K]) => void): void;
-    /**
-     * Connect to the remote server — open a connection on the transport and negotiate the
+     * Connects to the remote server — opens a connection on the transport and negotiates the
      * modern or legacy wire era without exposing that choice to the caller.
      *
      * @remarks
@@ -2090,21 +2078,19 @@ export declare interface MCPClientInterface {
      */
     connect(): Promise<void>;
     /**
-     * Discover a modern server's supported revisions and capabilities.
+     * Discovers a modern server's supported revisions and capabilities.
      *
      * @remarks
      * The request carries the modern per-request metadata stamp. Unknown revisions in
      * the peer's advertisement are ignored because {@link MCPDiscoverResult} exposes
-     * only revisions this client can negotiate. It carries the same short probe deadline
-     * {@link connect}'s own discovery does, which exists only where a `timeout` was configured — so
-     * on a default client `discover` is UNBOUNDED and waits on a silent peer indefinitely. Configure
-     * `timeout` to bound it.
+     * only revisions this client can negotiate. It carries the configured request deadline;
+     * omitting `timeout` selects {@link DEFAULT_MCP_REQUEST_TIMEOUT}.
      *
      * @returns The validated modern discovery result
      */
     discover(): Promise<MCPDiscoverResult>;
     /**
-     * Disconnect from the remote server — reject every pending request and close the
+     * Disconnects from the remote server — rejects every pending request and closes the
      * connection this client opened on its transport.
      *
      * @remarks
@@ -2121,7 +2107,7 @@ export declare interface MCPClientInterface {
      * `start` — that attempt owns nothing yet and closes what it opens itself. The transport's
      * `close` carries the per-request deadline on the WAIT, so a shutdown the transport accepts and
      * never answers rejects instead of holding this caller and every later {@link connect} — while
-     * that close itself keeps running, since the deadline only ends this client's waiting. A `close`
+     * that close itself keeps running, because the deadline only ends this client's waiting. A `close`
      * that faults or goes unanswered rejects this call and leaves the connection owned, so the next
      * `disconnect` — or the next {@link connect}, which refuses to open while a close is owed —
      * settles it again: joining the close still running when there is one, issuing a fresh `close`
@@ -2137,8 +2123,8 @@ export declare interface MCPClientInterface {
      */
     disconnect(): Promise<void>;
     /**
-     * List the remote server's tools, each wrapped as a local {@link ToolInterface}
-     * whose `execute` runs the remote `tools/call` via {@link call}.
+     * Lists the remote server's tools, each wrapped as a local {@link ToolInterface}
+     * whose `execute` runs the remote `tools/call` through {@link call}.
      *
      * @remarks
      * Runs `tools/list` and maps each descriptor: `name` (narrowed to a string),
@@ -2150,8 +2136,8 @@ export declare interface MCPClientInterface {
      */
     tools(): Promise<readonly ToolInterface[]>;
     /**
-     * Call a remote tool by name — runs `tools/call` and reports which of the three
-     * permitted arms the peer answered with.
+     * Calls a remote tool by name — runs `tools/call` and reports which permitted arm
+     * the peer answered with.
      *
      * @remarks
      * The answer is an {@link MCPCallOutcome} because the peer, not the caller, decides
@@ -2181,7 +2167,7 @@ export declare interface MCPClientInterface {
 /**
  * Options for `createMCPClient` — the {@link MCPClientTransportInterface} to drive, the
  * optional client {@link MCPIdentity}, the per-request `timeout`, and the reserved
- * `on` hooks (§8).
+ * `on` hooks.
  *
  * @remarks
  * - `transport` — the carrier the client drives a remote MCP server over (REQUIRED;
@@ -2199,26 +2185,30 @@ export declare interface MCPClientInterface {
  *   shutdown the transport accepts and never answers rejects its caller instead of wedging the
  *   client — which makes a short `timeout` a short shutdown grace as well as a short request
  *   deadline. Defaults to {@link import('./constants.js').DEFAULT_MCP_REQUEST_TIMEOUT}.
- * - `on` — the §8 reserved key: initial listeners for the client's
+ * - `on` — the reserved `on` key: initial listeners for the client's
  *   {@link MCPClientEventMap}, wired at construction.
  */
 export declare interface MCPClientOptions {
     readonly on?: EmitterHooks<MCPClientEventMap>;
-    /** The emitter's listener-error handler (AGENTS §13) — a listener throw routes here, not to a domain event. */
+    /** The emitter's listener-error handler — a listener throw routes here, not to a domain event. */
     readonly error?: EmitterErrorHandler;
     readonly transport: MCPClientTransportInterface;
     readonly identity?: MCPIdentity;
     /** The open client-capability record carried by modern requests. */
     readonly capabilities?: MCPClientCapabilities;
-    /** An optional protocol revision pin; absence permits negotiation. */
+    /**
+     * An optional exact protocol revision pin; absence permits negotiation. A defined pin must
+     * match the peer's negotiated revision. An unsupported runtime value throws an
+     * {@link MCPError} synchronously during construction.
+     */
     readonly version?: MCPVersion;
     /** The per-request deadline in milliseconds (default {@link import('./constants.js').DEFAULT_MCP_REQUEST_TIMEOUT}). */
     readonly timeout?: number;
 }
 
 /**
- * The observable events of a {@link MCPClientTransportInterface} (§13) — the moments the
- * {@link MCPClientInterface} (and any tracer) subscribes to via `transport.emitter.on`.
+ * The observable events of a {@link MCPClientTransportInterface} — the moments the
+ * {@link MCPClientInterface} (and any tracer) subscribes to through `transport.emitter.on`.
  *
  * @remarks
  * - `message` — a JSON-RPC message ARRIVED from the remote server (a response the
@@ -2227,9 +2217,9 @@ export declare interface MCPClientOptions {
  *   `data:` event) and emits the parsed {@link JSONRPCMessage}.
  * - `close` — the transport's connection ended (a stream closed, `close()` ran).
  * - `error` — a transport-level fault (a malformed message, a network error); the
- *   payload is typed `unknown` (§13). This is a DOMAIN event, distinct from the emitter's
+ *   payload is typed `unknown`. This is a DOMAIN event, distinct from the emitter's
  *   own listener-error channel: a listener throw is routed to the emitter's `error` handler
- *   (the `error` option), never onto this map. Declared as a `type` alias (§4.5) so the
+ *   (the `error` option), never onto this map. Declared as a `type` alias so the
  *   type-literal satisfies `EventMap` structurally.
  */
 export declare type MCPClientTransportEventMap = {
@@ -2237,26 +2227,24 @@ export declare type MCPClientTransportEventMap = {
     readonly message: readonly [message: JSONRPCMessage];
     /** The transport's connection ended. */
     readonly close: readonly [];
-    /** A transport-level fault — the caught error (typed `unknown`, §13). */
+    /** A transport-level fault — the caught error (typed `unknown`). */
     readonly error: readonly [error: unknown];
 };
 
 /**
- * A transport-agnostic carrier for the MCP CLIENT — pumps JSON-RPC messages to a
- * remote server and surfaces the server's replies on its `emitter`'s `message`
- * event, with NO knowledge of the protocol it carries.
+ * A transport-agnostic MCP message carrier — pumps JSON-RPC messages to a peer and
+ * surfaces received messages on its `emitter`'s `message` event, with no knowledge
+ * of the protocol role on either side.
  *
  * @remarks
- * The mirror of the server's "a transport pumps strings through `handle`": here the
- * {@link MCPClientInterface} hands the transport one {@link JSONRPCMessage} via
- * `send`, and the transport delivers each decoded reply back through the
- * `message` event the client subscribed to. The minimal carrier surface (§21): a
+ * A client hands the transport one {@link JSONRPCMessage} through `send`, and the
+ * transport delivers each decoded reply through the `message` event. Server bridges
+ * use the same carrier for bidirectional WebSocket and stdio channels. The minimal surface is a
  * `start` (open the connection / arm any reader), `send` (write one message),
  * and `close` (tear down). `session` exposes a server-assigned session id once a
  * stateful transport has one (`undefined` for the stateless v1) — reserved for the
- * later sessions tier. Concrete transports (the HTTP transport over `fetch`, a future
- * WebSocket one) live in `src/server/mcp`; the in-process loopback transport in the
- * tests is one too.
+ * later sessions tier. Concrete transports live in the browser and server environments;
+ * the in-process loopback transport in the tests implements the same contract.
  */
 export declare interface MCPClientTransportInterface {
     readonly emitter: EmitterInterface<MCPClientTransportEventMap>;
@@ -2281,7 +2269,7 @@ export declare interface MCPClientTransportInterface {
      */
     readonly duplex: boolean;
     /**
-     * Open the transport — establish the connection and arm any reply reader.
+     * Opens the transport — establishes the connection and arms any reply reader.
      *
      * @remarks
      * A `start` that REJECTS must first release whatever it had already acquired. The
@@ -2294,7 +2282,7 @@ export declare interface MCPClientTransportInterface {
      */
     start(): Promise<void>;
     /**
-     * Send one JSON-RPC message to the remote server.
+     * Sends one JSON-RPC message to the remote server.
      *
      * @remarks
      * Each decoded reply is surfaced on the `emitter`'s `message` event — `send`
@@ -2318,10 +2306,10 @@ export declare interface MCPClientTransportInterface {
      */
     send(message: JSONRPCMessage): Promise<void>;
     /**
-     * Close the transport — end the connection and release resources.
+     * Closes the transport — ends the connection and releases resources.
      *
      * @remarks
-     * A `close` must SETTLE, and its two settlements mean different things to its caller: resolving
+     * A `close` must SETTLE, and its settlements mean different things to its caller: resolving
      * says the connection ended, rejecting says it did not. The
      * {@link MCPClientInterface}'s only other bound is a deadline, which reports that the shutdown
      * did not ANSWER and never that it did not happen — so a `close` that resolves or rejects hours
@@ -2330,6 +2318,11 @@ export declare interface MCPClientTransportInterface {
      * gave up waiting JOINS the `close` still running rather than issuing another. It IS called
      * again after an earlier `close` REJECTED, because a rejected close ended nothing.
      *
+     * `close` is IDEMPOTENT: a call on a transport an earlier `close` already ended resolves
+     * without emitting `close` again and without releasing anything a second time. Idempotence
+     * bounds ONE closed lifetime rather than the object — a transport that reopens on `start`
+     * arms itself there, and its next `close` ends that connection and emits once for it.
+     *
      * @returns Resolves once the transport is closed
      */
     close(): Promise<void>;
@@ -2363,7 +2356,7 @@ export declare interface MCPCompletionContext {
  */
 export declare interface MCPCompletionManagerInterface {
     /**
-     * Complete one argument against its host-owned reference.
+     * Completes one argument against its host-owned reference.
      *
      * @param params - The reference, argument fragment, and optional resolved context
      * @param options - The resolved per-request options
@@ -2394,9 +2387,9 @@ export declare type MCPContent = MCPTextContent | MCPImageContent | MCPAudioCont
 
 /** Host-neutral integrity and storage port for opaque MRTR continuation state. */
 export declare interface MCPContinuationInterface {
-    /** Protect a canonical state string and return the opaque client carrier. */
+    /** Protects a canonical state string and returns the opaque client carrier. */
     seal(value: string): Promise<string>;
-    /** Recover a protected canonical state string, or `undefined` when invalid. */
+    /** Recovers a protected canonical state string, or `undefined` when invalid. */
     open(value: string): Promise<string | undefined>;
 }
 
@@ -2415,8 +2408,8 @@ export declare type MCPDiscoverResult = {
  * The minimal transport-facing MCP dispatch surface.
  *
  * @remarks
- * A transport-facing dispatcher needs the resolved message limit and the two dispatch
- * doors. It also shares the server emitter because a binder that owns a message pump has
+ * A transport-facing dispatcher needs the resolved message limit and the `dispatch` and
+ * `handle` doors. It also shares the server emitter because a binder that owns a message pump has
  * no response channel for a contained transport fault and must report that fault as an event.
  */
 export declare interface MCPDispatcherInterface {
@@ -2425,7 +2418,7 @@ export declare interface MCPDispatcherInterface {
     /** The resolved bounds the dispatcher enforces. */
     readonly limit: Required<MCPLimitOptions>;
     /**
-     * Dispatch a parsed JSON-RPC request.
+     * Dispatches a parsed JSON-RPC request.
      *
      * @param request - The parsed request
      * @param options - Optional execution context
@@ -2433,7 +2426,7 @@ export declare interface MCPDispatcherInterface {
      */
     dispatch(request: JSONRPCRequest, options?: MCPDispatchOptions): Promise<JSONRPCResponse | MCPStreamControllerInterface>;
     /**
-     * Dispatch a parsed JSON-RPC notification.
+     * Dispatches a parsed JSON-RPC notification.
      *
      * @param notification - The parsed notification
      * @param options - Optional execution context
@@ -2441,7 +2434,7 @@ export declare interface MCPDispatcherInterface {
      */
     dispatch(notification: JSONRPCNotification, options?: MCPDispatchOptions): Promise<undefined>;
     /**
-     * Dispatch an invocation whose arm is not statically known.
+     * Dispatches an invocation whose arm is not statically known.
      *
      * @param invocation - The parsed invocation
      * @param options - Optional execution context
@@ -2449,7 +2442,7 @@ export declare interface MCPDispatcherInterface {
      */
     dispatch(invocation: JSONRPCInvocation, options?: MCPDispatchOptions): Promise<JSONRPCResponse | MCPStreamControllerInterface | undefined>;
     /**
-     * Handle a raw JSON-RPC string.
+     * Handles a raw JSON-RPC string.
      *
      * @param message - The raw message
      * @param options - Optional execution context
@@ -2593,25 +2586,25 @@ export declare interface MCPEmbeddedResource {
  * The wire era selected by an MCP request's structure.
  *
  * @remarks
- * Two literals, and NOT the boolean a two-value union usually should be: this is a
- * genuine protocol discriminant, not a behavioural switch. It names which of two
- * published wire shapes a request took — a fact the request already carries — and it
+ * `'modern'` and `'legacy'`, and not the boolean such a union would usually be: this is
+ * a genuine protocol discriminant, not a behavioural switch. It names which
+ * published wire shape a request took — a fact the request already carries — and it
  * is emitted on {@link MCPServerEventMap}'s `request` event, where an observer logs
  * or partitions by it. A boolean `modern` would publish the same fact under a name
- * that stops being readable the day a third era exists.
+ * that stops being readable the day another era exists.
  */
 export declare type MCPEra = 'modern' | 'legacy';
 
 /**
- * A remote Model Context Protocol JSON-RPC error, preserving its machine-readable
- * numeric code and optional structured context.
+ * A Model Context Protocol error preserving its machine-readable numeric code and
+ * optional structured context.
  *
  * @remarks
- * {@link MCPClient} throws this error only for a remote JSON-RPC `error` response.
- * Local lifecycle and transport conditions such as disconnects and request timeouts
- * remain plain `Error`s. `context` carries the response's optional `error.data`
- * unchanged and is `undefined` when the peer omitted it. This includes the modern
- * reserved paths: `-32020` carries no context, `-32021` may carry
+ * {@link MCPClient} throws this error for a remote JSON-RPC `error` response and for a
+ * locally detected protocol incompatibility. Local lifecycle and transport conditions such
+ * as disconnects and request timeouts remain plain `Error`s. For a remote response, `context`
+ * carries the optional `error.data` unchanged and is `undefined` when the peer omitted it.
+ * This includes the modern reserved paths: `-32020` carries no context, `-32021` may carry
  * `requiredCapabilities`, and `-32022` carries the peer's `supported` revisions and
  * `requested` revision for negotiation recovery.
  *
@@ -2630,7 +2623,7 @@ export declare class MCPError extends Error {
     readonly code: number;
     readonly context: unknown;
     /**
-     * Create a remote MCP protocol error.
+     * Creates an MCP protocol error.
      *
      * @param message - The human-readable JSON-RPC error message
      * @param code - The machine-readable numeric JSON-RPC error code
@@ -2648,7 +2641,7 @@ export declare interface MCPExecutionContext {
     readonly progress?: MCPProgressInterface;
 }
 
-/** Execute one canonical tool call or return a fully formed complete MCP result. */
+/** Executes one canonical tool call or return a fully formed complete MCP result. */
 export declare type MCPExecutionHandler = (context: MCPExecutionContext) => ToolResult | MCPCallResult | Promise<ToolResult | MCPCallResult>;
 
 /** One sized, themed icon associated with an MCP resource link. */
@@ -2688,7 +2681,7 @@ export declare interface MCPInputContext {
 }
 
 /**
- * Decide whether the current `tools/call` needs operator input.
+ * Decides whether the current `tools/call` needs operator input.
  *
  * @param context - The original call plus a verified response/state on a retry
  * @param options - The resolved per-request method options
@@ -2702,9 +2695,9 @@ export declare interface MCPInputOptions {
     readonly continuation: MCPContinuationInterface;
     /** Continuation lifetime in milliseconds; required so MCP never invents an expiry policy. */
     readonly ttl: number;
-    /** Resolve the authenticated principal for the call in hand. */
+    /** Resolves the authenticated principal for the call in hand. */
     readonly principal: MCPPrincipalHandler;
-    /** Decide whether the call needs a form elicitation, including on verified retries. */
+    /** Decides whether the call needs a form elicitation, including on verified retries. */
     readonly elicit: MCPInputHandler;
 }
 
@@ -2731,7 +2724,7 @@ export declare type MCPInputRequestMap = Readonly<Record<string, MCPInputRequest
  * An incomplete modern result carrying input requests, protected request state, or both.
  *
  * @remarks
- * The two-arm union enforces the protocol's at-least-one-of rule at the type boundary:
+ * The union enforces the protocol's at-least-one-of rule at the type boundary:
  * every value has `inputRequests`, `requestState`, or both.
  */
 export declare type MCPInputResult = {
@@ -2783,7 +2776,7 @@ export declare interface MCPJSONLimitOptions {
 }
 
 /**
- * Translate the fixed legacy method set onto one modern dispatcher.
+ * Translates the fixed legacy method set onto one modern dispatcher.
  *
  * @remarks
  * This decorator owns no execution engine or result normalizer. Modern invocations
@@ -2794,7 +2787,7 @@ export declare interface MCPJSONLimitOptions {
 export declare class MCPLegacy implements MCPDispatcherInterface {
     #private;
     /**
-     * Create a legacy decorator.
+     * Creates a legacy decorator.
      *
      * @param options - The sole dispatcher and legacy handshake identity
      */
@@ -2881,7 +2874,7 @@ export declare type MCPLoggingLevel = 'debug' | 'info' | 'notice' | 'warning' |
  * The `Object` suffix is not a role suffix from the type table — it NAMES THE SHAPE.
  * `_meta` is a JSON object whose values are exact JSON, and a reader who sees
  * `MCPMeta` cannot tell that from a key, a string, or an entry. The same holds for
- * {@link MCPResultMetaObject} and {@link SubscriptionsListenResultMetaObject}, which are
+ * {@link MCPResultMetaObject} and {@link MCPSubscriptionResultMetaObject}, which are
  * that object narrowed by one reserved key each.
  */
 export declare type MCPMetaObject = Readonly<Record<string, JSONValue>>;
@@ -2962,14 +2955,14 @@ export declare class MCPMethodManager implements MCPMethodManagerInterface {
  */
 export declare interface MCPMethodManagerInterface {
     /**
-     * Register one modern method — replacing any handler already under that name.
+     * Registers one modern method — replacing any handler already under that name.
      *
-     * @param name - The JSON-RPC method name to answer (e.g. `'tools/call'`)
+     * @param name - The JSON-RPC method name to answer (for example, `'tools/call'`)
      * @param handler - The handler dispatched for that method
      */
     add(name: string, handler: MCPMethodHandler): void;
     /**
-     * Find the handler registered for one method name.
+     * Finds the handler registered for one method name.
      *
      * @param name - The JSON-RPC method name to resolve
      * @returns The registered handler, or `undefined` when the method is unregistered
@@ -3021,7 +3014,7 @@ export declare interface MCPPaginationResult {
 }
 
 /**
- * Derive the deployment-authenticated principal bound into signed request state.
+ * Derives the deployment-authenticated principal bound into signed request state.
  *
  * @param request - The parsed `tools/call` request
  * @param options - The resolved per-request method options
@@ -3037,7 +3030,7 @@ export declare interface MCPProgress {
 }
 
 /**
- * Receive one progress report a peer published for a request this client issued.
+ * Receives one progress report a peer published for a request this client issued.
  *
  * @remarks
  * The RECEIVING half of {@link MCPProgressInterface}, and deliberately not its mirror:
@@ -3056,7 +3049,7 @@ export declare type MCPProgressHandler = (progress: MCPProgress) => void;
 
 /** Backpressured request-scoped progress reporter supplied to an explicit executor. */
 export declare interface MCPProgressInterface {
-    /** Report one finite, strictly increasing progress value and await its consumption. */
+    /** Reports one finite, strictly increasing progress value and awaits its consumption. */
     report(progress: MCPProgress): Promise<void>;
 }
 
@@ -3086,7 +3079,7 @@ export declare interface MCPProgressInterface {
 export declare class MCPProgressReporter implements MCPProgressInterface {
     #private;
     /**
-     * Create one non-durable progress slot for an active request.
+     * Creates one non-durable progress slot for an active request.
      *
      * @param token - The opaque progress token copied into each notification
      * @param limits - The byte, key, and depth bounds applied to every progress payload
@@ -3094,7 +3087,7 @@ export declare class MCPProgressReporter implements MCPProgressInterface {
      */
     constructor(token: string | number, limits: MCPJSONLimitOptions, signal: AbortSignal);
     /**
-     * Publish one bounded, strictly increasing progress value and await its consumption.
+     * Publishes one bounded, strictly increasing progress value and awaits its consumption.
      *
      * @param progress - The progress payload to own and hand to the serial consumer
      * @returns A promise resolving after {@link take} consumes the item
@@ -3103,14 +3096,14 @@ export declare class MCPProgressReporter implements MCPProgressInterface {
      */
     report(progress: MCPProgress): Promise<void>;
     /**
-     * Take the next progress notification, waiting for the single producer slot when empty.
+     * Takes the next progress notification, waiting for the single producer slot when empty.
      *
      * @returns The official progress notification carrying the original token
      * @throws When the reporter stops or another consumer already has a pending take
      */
     take(): Promise<JSONRPCNotification>;
     /**
-     * Permanently stop the reporter, reject pending work, and detach its abort listener.
+     * Stops the reporter permanently, rejects pending work, and detaches its abort listener.
      *
      * Repeated calls are idempotent. No queued or replayable progress survives the first call.
      *
@@ -3170,7 +3163,7 @@ export declare type MCPPromptListResult = MCPPromptPage & {
  */
 export declare interface MCPPromptManagerInterface {
     /**
-     * Read one prompt page.
+     * Reads one prompt page.
      *
      * @param pagination - The optional opaque cursor
      * @param options - The resolved per-request options
@@ -3178,7 +3171,7 @@ export declare interface MCPPromptManagerInterface {
      */
     prompts(pagination: MCPPaginationParams, options: MCPMethodOptions): MCPPromptPage | Promise<MCPPromptPage>;
     /**
-     * Resolve one named prompt.
+     * Resolves one named prompt.
      *
      * @param params - The prompt name, string arguments, and optional multi-round response carrier
      * @param options - The resolved per-request options
@@ -3221,7 +3214,7 @@ export declare interface MCPRequestContext {
 }
 
 /**
- * Issue one correlated JSON-RPC request and await the peer's result.
+ * Issues one correlated JSON-RPC request and awaits the peer's result.
  *
  * @remarks
  * The door an {@link MCPTaskClientInterface} reaches the wire through, and the whole of what
@@ -3301,7 +3294,7 @@ export declare type MCPResourceListResult = MCPResourcePage & {
  */
 export declare interface MCPResourceManagerInterface {
     /**
-     * Read one resource page.
+     * Reads one resource page.
      *
      * @param pagination - The optional opaque cursor
      * @param options - The resolved per-request options
@@ -3309,7 +3302,7 @@ export declare interface MCPResourceManagerInterface {
      */
     resources(pagination: MCPPaginationParams, options: MCPMethodOptions): MCPResourcePage | Promise<MCPResourcePage>;
     /**
-     * Read one concrete resource URI.
+     * Reads one concrete resource URI.
      *
      * @param params - The URI and optional multi-round response carrier
      * @param options - The resolved per-request options
@@ -3317,7 +3310,7 @@ export declare interface MCPResourceManagerInterface {
      */
     resource(params: MCPResourceReadParams, options: MCPMethodOptions): readonly MCPResourceContents[] | MCPInputResult | undefined | Promise<readonly MCPResourceContents[] | MCPInputResult | undefined>;
     /**
-     * Read one resource-template page.
+     * Reads one resource-template page.
      *
      * @remarks
      * `uriTemplate` values are RFC 6570 strings. Expansion belongs to the manager that resolves
@@ -3395,7 +3388,7 @@ export declare interface MCPResourceTemplateReference {
  * Concrete results — {@link MCPCallResult}, {@link MCPDiscoverResult},
  * {@link MCPListResult}, {@link MCPPromptListResult}, {@link MCPPromptGetResult},
  * {@link MCPCompletionResult}, {@link MCPInputResult}, and
- * {@link SubscriptionsListenResult} — stay CLOSED and keep their literal
+ * {@link MCPSubscriptionResult} — stay CLOSED and keep their literal
  * `resultType`, so a caller that knows which method it called still narrows to a
  * literal through that result's guard. Openness lives here, at the arm a server may
  * answer any registered method through, and nowhere else.
@@ -3421,7 +3414,7 @@ export declare type MCPRole = 'user' | 'assistant';
  * requests over a live {@link ToolManagerInterface}, with NO transport coupling.
  *
  * @remarks
- * - **Two entry points.** `dispatch(invocation)` runs an already-parsed invocation and
+ * - **`dispatch` and `handle`.** `dispatch(invocation)` runs an already-parsed invocation and
  *   resolves a {@link JSONRPCResponse} for a request — or `undefined` for a
  *   {@link JSONRPCNotification}, which carries no `id` and is answered by nothing.
  *   `handle(message)` is the string boundary: it
@@ -3437,8 +3430,8 @@ export declare type MCPRole = 'user' | 'assistant';
  *   every dispatch: the same path a later method or a consumer's own takes, with an
  *   unregistered method still answering `-32601`.
  * - **Provider-agnostic.** Imports only core siblings — JSON-RPC + the tool registry,
- *   no HTTP, no model. Wire fields are narrowed via the contracts guards (no `as`).
- * - **Observable (§13).** The owned `emitter` fires `request` at the top of every
+ *   no HTTP, no model. Wire fields are narrowed with the contract guards (no `as`).
+ * - **Observable.** The owned `emitter` fires `request` at the top of every
  *   dispatch; the emitter isolates a listener throw and routes it to its `error` handler
  *   (the `error` option), so a listener throw can never escape the dispatch.
  *
@@ -3483,17 +3476,17 @@ export declare type MCPServerCapabilities = Readonly<Record<string, MCPMetaObjec
 };
 
 /**
- * The push observation surface (§13) of an {@link MCPServerInterface} — the
+ * The push observation surface of an {@link MCPServerInterface} — the
  * dispatch moments a fire-and-forget observer (logging, tracing) subscribes to
- * via `server.emitter.on`.
+ * through `server.emitter.on`.
  *
  * @remarks
  * `request` fires at the TOP of every `dispatch` with the method, correlating id
  * (ABSENT for a notification, which has none), and structurally selected wire era, BEFORE the
- * method runs — so an observer sees every inbound call. Listener isolation is the emitter's (§13): a
+ * method runs — so an observer sees every inbound call. Listener isolation is the emitter's: a
  * listener throw is routed to the emitter's `error` handler (the `error` option),
  * never onto this map, so a buggy observer can never corrupt a dispatch. Declared as
- * a `type` alias (§4.5) so the type-literal satisfies `EventMap` structurally.
+ * a `type` alias so the type-literal satisfies `EventMap` structurally.
  */
 export declare type MCPServerEventMap = {
     /**
@@ -3537,10 +3530,10 @@ export declare type MCPServerEventMap = {
  * pumps strings through `handle`).
  *
  * @remarks
- * - **Two entry points.** `dispatch(invocation)` is the TYPED core: it takes an
+ * - **`dispatch` and `handle`.** `dispatch(invocation)` is the TYPED core: it takes an
  *   already-parsed {@link JSONRPCInvocation}, runs the method, and resolves a
  *   {@link JSONRPCResponse} — or an {@link MCPStream} for a held-open modern method — for
- *   a {@link JSONRPCRequest}, and `undefined` for a {@link JSONRPCNotification}. Its two
+ *   a {@link JSONRPCRequest}, and `undefined` for a {@link JSONRPCNotification}. Its
  *   overloads say exactly that, so a caller dispatching a request never handles an
  *   `undefined` answer and a caller dispatching a notification never handles a response.
  *   `handle(message)` is the STRING boundary: it `JSON.parse`s the raw message, narrows it
@@ -3555,9 +3548,9 @@ export declare type MCPServerEventMap = {
  *   still answers `-32601`.
  * - **Provider-agnostic.** Imports only core siblings; it speaks JSON-RPC + the
  *   tool registry, with no HTTP, no model, and no backend coupling.
- * - **Observable (§13).** The owned `emitter` ({@link MCPServerEventMap}) fires
+ * - **Observable.** The owned `emitter` ({@link MCPServerEventMap}) fires
  *   `request` per dispatch; the emitter isolates a listener throw and routes it to its
- *   `error` handler (the `error` option, §13), never the dispatch.
+ *   `error` handler (the `error` option), never the dispatch.
  */
 export declare interface MCPServerInterface extends MCPDispatcherInterface {
     readonly identity: MCPIdentity;
@@ -3572,15 +3565,15 @@ export declare interface MCPServerInterface extends MCPDispatcherInterface {
      * code in front of the server needs the SAME number: a binder that decodes an inbound
      * message before handing it on must refuse at the byte the server would have refused at,
      * and the alternative — a second configured copy of one bound, on the binder's own options
-     * — is two numbers that will disagree the first time one of them is changed.
+     * — is a second number that will disagree the first time either is changed.
      */
     readonly limit: Required<MCPLimitOptions>;
     /**
-     * Dispatch an already-parsed request — run its method and resolve its answer.
+     * Dispatches an already-parsed request — runs its method and resolves its answer.
      *
      * @remarks
      * A held-open modern method answers with a CONTROLLED stream instead of a response:
-     * narrow the two apart with `Symbol.asyncIterator in answer`. Whatever the method
+     * narrow a stream from a response with `Symbol.asyncIterator in answer`. Whatever the method
      * produced, what leaves here is an {@link MCPStreamControllerInterface} — dispatch is
      * the one wrapping seam — so a caller may end the exchange promptly without waiting on
      * the producer. `options` is optional, so a caller that cannot abort simply never
@@ -3592,7 +3585,7 @@ export declare interface MCPServerInterface extends MCPDispatcherInterface {
      */
     dispatch(request: JSONRPCRequest, options?: MCPDispatchOptions): Promise<JSONRPCResponse | MCPStreamControllerInterface>;
     /**
-     * Dispatch an already-parsed notification — run its method and answer nothing.
+     * Dispatches an already-parsed notification — runs its method and answers nothing.
      *
      * @param notification - The parsed JSON-RPC notification to dispatch
      * @param options - Per-request execution options (see {@link MCPDispatchOptions})
@@ -3600,7 +3593,7 @@ export declare interface MCPServerInterface extends MCPDispatcherInterface {
      */
     dispatch(notification: JSONRPCNotification, options?: MCPDispatchOptions): Promise<undefined>;
     /**
-     * Dispatch an already-parsed invocation whose arm is not statically known.
+     * Dispatches an already-parsed invocation whose arm is not statically known.
      *
      * @remarks
      * The union arm a transport uses when it has narrowed a message no further than
@@ -3614,7 +3607,7 @@ export declare interface MCPServerInterface extends MCPDispatcherInterface {
      */
     dispatch(invocation: JSONRPCInvocation, options?: MCPDispatchOptions): Promise<JSONRPCResponse | MCPStreamControllerInterface | undefined>;
     /**
-     * Handle a raw message string — parse it, dispatch, and serialize the answer.
+     * Handles a raw message string — parses it, dispatches it, and serializes the answer.
      *
      * @remarks
      * A `JSON.parse` failure resolves a serialized `-32700` (Parse error) response;
@@ -3628,7 +3621,7 @@ export declare interface MCPServerInterface extends MCPDispatcherInterface {
      * The vague-verb prohibition (`process`, `handle`) governs STANDALONE helpers,
      * which carry no entity to supply their object. Here the entity does: `server.handle`
      * reads as "the server handles this message", and it is the string-boundary twin of
-     * {@link dispatch} — one verb per entry point, the same act at two levels of parsing.
+     * {@link dispatch} — one verb per entry point, the same act at the typed and string levels.
      *
      * @param message - The raw JSON-RPC message string
      * @param options - Per-request execution options (see {@link MCPDispatchOptions})
@@ -3640,7 +3633,7 @@ export declare interface MCPServerInterface extends MCPDispatcherInterface {
 /**
  * Options for `createMCPServer` — the server {@link MCPIdentity}, the live
  * {@link ToolManagerInterface} it exposes, optional `instructions`, and the
- * reserved `on` hooks (§8).
+ * reserved `on` hooks.
  *
  * @remarks
  * `identity` identifies the server in the `initialize` handshake (`serverInfo`).
@@ -3648,14 +3641,14 @@ export declare interface MCPServerInterface extends MCPDispatcherInterface {
  * over — its `definitions()` advertise the tools and its `execute()` runs a call
  * (the manager already isolates a tool throw into a `success: false` result, so
  * the server adds none). `resources` is the optional consumer-owned registry the
- * three modern resource methods project without taking ownership of storage. `prompts`
+ * modern resource methods project without taking ownership of storage. `prompts`
  * supplies the equivalent prompt registry for `prompts/list` and `prompts/get`.
  * `completion` supplies independent host-owned lookup and candidate generation for
  * `completion/complete`; the server never parses or expands a resource-template URI.
  * `instructions` is the optional human guidance exposed
  * by `server/discover`. `cache` configures the modern cache stamps: `ttl` is the
  * freshness lifetime in milliseconds and `scope` defaults to `'private'`. `on`
- * is the §8 reserved key: initial listeners for the server's
+ * is the reserved `on` key: initial listeners for the server's
  * {@link MCPServerEventMap}, wired at construction. `input` enables modern
  * `tools/call` multi-round trips: the consumer decides when input is needed and
  * supplies principal/continuation/TTL policy, while MCP assigns the request key and
@@ -3667,7 +3660,7 @@ export declare interface MCPServerInterface extends MCPDispatcherInterface {
  */
 export declare interface MCPServerOptions {
     readonly on?: EmitterHooks<MCPServerEventMap>;
-    /** The emitter's listener-error handler (AGENTS §13) — a listener throw routes here, not to a domain event. */
+    /** The emitter's listener-error handler — a listener throw routes here, not to a domain event. */
     readonly error?: EmitterErrorHandler;
     readonly identity: MCPIdentity;
     /** The live tool registry the server exposes over `tools/list` / `tools/call`. */
@@ -3725,9 +3718,9 @@ export declare interface MCPServerOptions {
  *
  * Held-open closure is a RESULT in the modern revision, not an out-of-band event, so it
  * arrives where a result arrives — the generator's `return`. Consuming a stream and
- * consuming a unary response therefore end the same way, and a transport narrows the two
- * apart at ONE point (`Symbol.asyncIterator in answer`), at the place that already pumps
- * messages onto the wire. The third parameter is stated explicitly because a stream
+ * consuming a unary response therefore end the same way, and a transport narrows a stream
+ * from a response at ONE point (`Symbol.asyncIterator in answer`), at the place that already pumps
+ * messages onto the wire. The `TNext` type parameter is stated explicitly because a stream
  * accepts nothing back from its consumer.
  */
 export declare type MCPStream = AsyncGenerator<JSONRPCNotification, JSONRPCResponse, unknown>;
@@ -3744,10 +3737,10 @@ export declare type MCPStream = AsyncGenerator<JSONRPCNotification, JSONRPCRespo
  * cleanup to the producer — so a cooperating producer is woken rather than waited on —
  * contains every promise the producer settles late, and makes every closure path idempotent.
  *
- * The three closures are deliberately different answers: the source's own return is the
+ * The closures are deliberately different answers: the source's own return is the
  * terminal RESPONSE, `return(value)` is the consumer saying it has the answer already, and
- * {@link stop} is an owner saying there will be no answer at all. Only the first is a
- * message a peer ever sees.
+ * {@link stop} is an owner saying there will be no answer at all. Only the source's own
+ * return is a message a peer ever sees.
  *
  * A producer's own resource cleanup remains the producer's: JavaScript cannot settle work a
  * generator is suspended inside, so the signal is how an uncooperative producer is asked to
@@ -3773,7 +3766,7 @@ export declare type MCPStream = AsyncGenerator<JSONRPCNotification, JSONRPCRespo
 export declare class MCPStreamController implements MCPStreamControllerInterface {
     #private;
     /**
-     * Control one produced stream for the lifetime of one request.
+     * Controls one produced stream for the lifetime of one request.
      *
      * @param source - The produced held-open result whose cancellation this controller owns
      * @param signal - The request signal every closure settles against; its abort ends the exchange
@@ -3781,7 +3774,7 @@ export declare class MCPStreamController implements MCPStreamControllerInterface
      */
     constructor(source: MCPStream, signal: AbortSignal, closure: AbortController);
     /**
-     * Read the next message, or the terminating response that ends the exchange.
+     * Reads the next message, or the terminating response that ends the exchange.
      *
      * @remarks
      * At most one read is outstanding against the source at a time, and a rival read is
@@ -3794,14 +3787,14 @@ export declare class MCPStreamController implements MCPStreamControllerInterface
      */
     next(): Promise<IteratorResult<JSONRPCNotification, JSONRPCResponse>>;
     /**
-     * End the exchange because the consumer already has its answer.
+     * Ends the exchange because the consumer already has its answer.
      *
      * @param value - The terminal the consumer is ending on
      * @returns That terminal as the iteration's `return`
      */
     return(value: JSONRPCResponse | PromiseLike<JSONRPCResponse>): Promise<IteratorResult<JSONRPCNotification, JSONRPCResponse>>;
     /**
-     * End the exchange with a failure the consumer is raising.
+     * Ends the exchange with a failure the consumer is raising.
      *
      * @param error - The failure to end the exchange with
      * @returns Never — the returned promise always rejects
@@ -3809,7 +3802,7 @@ export declare class MCPStreamController implements MCPStreamControllerInterface
      */
     throw(error: unknown): Promise<IteratorResult<JSONRPCNotification, JSONRPCResponse>>;
     /**
-     * End the exchange permanently, with no terminal response.
+     * Ends the exchange permanently, with no terminal response.
      *
      * @remarks
      * Idempotent, and the operation an owner that is not the consumer uses: a transport whose
@@ -3820,7 +3813,7 @@ export declare class MCPStreamController implements MCPStreamControllerInterface
      */
     stop(): void;
     /**
-     * End the exchange when the scope that owns it exits.
+     * Ends the exchange when the scope that owns it exits.
      *
      * @remarks
      * {@link stop} under the name a `finally` calls it by, so a pump discharges its ownership
@@ -3831,7 +3824,7 @@ export declare class MCPStreamController implements MCPStreamControllerInterface
      */
     [Symbol.asyncDispose](): Promise<void>;
     /**
-     * Iterate this exchange — the controller is its own iterator.
+     * Iterates this exchange — the controller is its own iterator.
      *
      * @returns This controller
      */
@@ -3877,7 +3870,7 @@ export declare class MCPStreamController implements MCPStreamControllerInterface
  */
 export declare interface MCPStreamControllerInterface extends MCPStream {
     /**
-     * Read the next notification, or the terminating response that ends the exchange.
+     * Reads the next notification, or the terminating response that ends the exchange.
      *
      * @remarks
      * At most ONE read is outstanding against the producer, and a rival read is refused
@@ -3889,21 +3882,21 @@ export declare interface MCPStreamControllerInterface extends MCPStream {
      */
     next(): Promise<IteratorResult<JSONRPCNotification, JSONRPCResponse>>;
     /**
-     * End the exchange because the consumer already has its answer.
+     * Ends the exchange because the consumer already has its answer.
      *
      * @param value - The terminal the consumer is ending on
      * @returns That terminal as the iteration's `return`
      */
     return(value: JSONRPCResponse | PromiseLike<JSONRPCResponse>): Promise<IteratorResult<JSONRPCNotification, JSONRPCResponse>>;
     /**
-     * End the exchange with a failure the consumer is raising.
+     * Ends the exchange with a failure the consumer is raising.
      *
      * @param error - The failure to end the exchange with
      * @returns Never — the returned promise always rejects with the supplied failure
      */
     throw(error: unknown): Promise<IteratorResult<JSONRPCNotification, JSONRPCResponse>>;
     /**
-     * End the exchange permanently, with no terminal response.
+     * Ends the exchange permanently, with no terminal response.
      *
      * @remarks
      * Idempotent, and never a way to deliver an answer: a read parked on the producer
@@ -3914,7 +3907,7 @@ export declare interface MCPStreamControllerInterface extends MCPStream {
      */
     stop(): void;
     /**
-     * End the exchange when the scope that owns it exits.
+     * Ends the exchange when the scope that owns it exits.
      *
      * @remarks
      * The scoped spelling of {@link stop}, and the member a pump discharges its ownership
@@ -3940,18 +3933,18 @@ export declare interface MCPStreamControllerInterface extends MCPStream {
  * and takes the `MCP` prefix; the keys are the protocol's and do not change.
  */
 export declare interface MCPSubscriptionFilter {
-    /** Receive `notifications/tools/list_changed` when the server produces it. */
+    /** Receives `notifications/tools/list_changed` when the server produces it. */
     readonly toolsListChanged?: boolean;
-    /** Receive `notifications/prompts/list_changed` when the server produces it. */
+    /** Receives `notifications/prompts/list_changed` when the server produces it. */
     readonly promptsListChanged?: boolean;
-    /** Receive `notifications/resources/list_changed` when the server produces it. */
+    /** Receives `notifications/resources/list_changed` when the server produces it. */
     readonly resourcesListChanged?: boolean;
-    /** Receive `notifications/resources/updated` for these resource URIs. */
+    /** Receives `notifications/resources/updated` for these resource URIs. */
     readonly resourceSubscriptions?: readonly string[];
 }
 
 /**
- * Produce notifications for one honoured `subscriptions/listen` filter.
+ * Produces notifications for one honoured `subscriptions/listen` filter.
  *
  * @remarks
  * The producer parks on its own event source while idle and ends its iterable to close the
@@ -3968,10 +3961,22 @@ export declare type MCPSubscriptionHandler = (notifications: MCPSubscriptionFilt
 export declare interface MCPSubscriptionOptions {
     /** The notification filter this server can actually honour. */
     readonly notifications: MCPSubscriptionFilter;
-    /** Open the producer for one honoured filter. */
+    /** Opens the producer for one honoured filter. */
     readonly listen: MCPSubscriptionHandler;
 }
 
+/** The terminating result returned when a `subscriptions/listen` stream closes gracefully. */
+export declare type MCPSubscriptionResult = {
+    readonly resultType: 'complete';
+    readonly _meta: MCPSubscriptionResultMetaObject;
+};
+
+/** The required metadata on a graceful `subscriptions/listen` result. */
+export declare type MCPSubscriptionResultMetaObject = MCPResultMetaObject & {
+    /** The JSON-RPC id of the `subscriptions/listen` request whose stream is closing. */
+    readonly 'io.modelcontextprotocol/subscriptionId': JSONRPCId;
+};
+
 /**
  * One durable task's wire snapshot — the payload a deferred `tools/call` answers with.
  *
@@ -3979,10 +3984,10 @@ export declare interface MCPSubscriptionOptions {
  * Every field name here is a WIRE SPELLING carried verbatim from the extension's
  * schema, so the compound-member prohibition does not reach them; the type NAME is
  * this library's own. `ttlMs` is `null` — not absent — when the task has no expiry,
- * because the schema distinguishes the two. `createdAt` and `lastUpdatedAt` are
+ * because the schema distinguishes absence from `null`. `createdAt` and `lastUpdatedAt` are
  * described as ISO 8601 instants, though the generated schema validates only a
  * string, so this package carries whatever the manager produced without reformatting
- * it. `pollIntervalMs` is the manager's hint about how often the client should ask
+ * it. `pollIntervalMs` is the manager's hint about how often the client can ask
  * again; a manager that pushes notifications instead simply omits it.
  */
 export declare type MCPTask = {
@@ -4000,7 +4005,7 @@ export declare type MCPTask = {
 };
 
 /**
- * The CLIENT half of the draft Tasks extension — the three `tasks/*` methods over one
+ * The CLIENT half of the draft Tasks extension — the `tasks/*` methods over one
  * correlated-request door, exposed as an {@link import('./types.js').MCPClientInterface}'s
  * `tasks`.
  *
@@ -4020,7 +4025,7 @@ export declare type MCPTask = {
  *   client's id space, pending table, deadline policy, and `disconnect` drain rather than
  *   opening a second path to the same peer.
  * - **The peer authorizes.** Nothing is checked locally. A server that never configured the
- *   extension answers all three `-32601`, and a task that never existed, one whose TTL purged
+ *   extension answers each of them `-32601`, and a task that never existed, one whose TTL purged
  *   it, and one belonging to another principal are all the same `-32602` — a refusal this
  *   client passes on rather than resolving into a distinction the peer refused to publish.
  *
@@ -4051,7 +4056,7 @@ export declare class MCPTaskClient implements MCPTaskClientInterface {
  * The mirror of {@link MCPTaskManagerInterface} minus `start`, because creating a task is
  * never the client's decision: the extension gives a client no flag and no parameter to ask
  * for one, and a task exists only because the SERVER deferred a `tools/call` it received. The
- * three methods that remain are the three `tasks/*` methods on the wire.
+ * methods that remain are the `tasks/*` methods on the wire.
  *
  * There is deliberately NO plural accessor, for the same reason the server-side port has none:
  * the extension defines no `tasks/list`, and an accessor that could enumerate tasks would
@@ -4067,12 +4072,12 @@ export declare class MCPTaskClient implements MCPTaskClientInterface {
  * existing `notification` event at zero new mechanism.
  *
  * Every method authorizes on the peer's side, so a task belonging to another principal is
- * indistinguishable from one that never existed and one whose TTL purged it — all three are
+ * indistinguishable from one that never existed and one whose TTL purged it — each is
  * the same `-32602`, deliberately.
  */
 export declare interface MCPTaskClientInterface {
     /**
-     * Read one durable task's current snapshot.
+     * Reads one durable task's current snapshot.
      *
      * @remarks
      * REJECTS rather than answering `undefined` for a task it cannot read. The peer's refusal
@@ -4098,7 +4103,7 @@ export declare interface MCPTaskClientInterface {
      */
     task(id: string): Promise<MCPTaskDetail>;
     /**
-     * Answer the input requests an `input_required` task is waiting on.
+     * Answers the input requests an `input_required` task is waiting on.
      *
      * @remarks
      * The responses are keyed by the request keys the task itself published, and they travel
@@ -4117,7 +4122,7 @@ export declare interface MCPTaskClientInterface {
      */
     update(id: string, responses: Readonly<Record<string, unknown>>): Promise<void>;
     /**
-     * Ask one durable task to stop.
+     * Asks one durable task to stop.
      *
      * @remarks
      * ADVISORY, exactly like the server-side port it mirrors: the acknowledgement reports that
@@ -4193,7 +4198,7 @@ export declare interface MCPTaskContext {
  * that ended it, and `working` / `cancelled` carry nothing extra. Narrow on `status`.
  *
  * `result` is an open {@link MCPResult} rather than an {@link MCPCallResult}: only
- * `tools/call` can currently be deferred, but the payload is the deferred method's
+ * `tools/call` can be deferred, but the payload is the deferred method's
  * own result and the extension says nothing that fixes it to one method forever.
  */
 export declare type MCPTaskDetail = (MCPTask & {
@@ -4212,7 +4217,7 @@ export declare type MCPTaskDetail = (MCPTask & {
 });
 
 /**
- * Decide whether the `tools/call` in hand becomes a durable task.
+ * Decides whether the `tools/call` in hand becomes a durable task.
  *
  * @remarks
  * Deferral is entirely the SERVER's decision. The extension gives a client no flag and
@@ -4248,7 +4253,7 @@ export declare type MCPTaskHandler = (context: MCPTaskContext, options: MCPMetho
  * states the non-goal.
  *
  * {@link task} answers `undefined` for a task that never existed, one whose TTL purged
- * it, AND one this caller is not entitled to see. The three are indistinguishable ON
+ * it, AND one this caller is not entitled to see. They are indistinguishable ON
  * PURPOSE: they all become the same `-32602`, so a `taskId` cannot be probed for
  * existence. A manager that distinguishes them — by throwing for the unauthorized case,
  * say — turns its own store into an enumeration oracle no matter what this package does.
@@ -4259,10 +4264,10 @@ export declare type MCPTaskHandler = (context: MCPTaskContext, options: MCPMetho
  */
 export declare interface MCPTaskManagerInterface {
     /**
-     * Create — or return the existing — durable task for one stable operation key.
+     * Creates — or return the existing — durable task for one stable operation key.
      *
      * @remarks
-     * Three obligations this package cannot enforce, and one consequence that is easy
+     * The obligations this package cannot enforce, and one consequence that is easy
      * to miss:
      *
      * - **Durability before return.** The returned task MUST already be retrievable by
@@ -4287,10 +4292,10 @@ export declare interface MCPTaskManagerInterface {
      */
     start(key: string, context: MCPTaskContext, options: MCPMethodOptions): Promise<MCPTask>;
     /**
-     * Read one task's current snapshot.
+     * Reads one task's current snapshot.
      *
      * @remarks
-     * ALL THREE `tasks/*` methods run through here first, not only `tasks/get`. {@link update}
+     * EVERY `tasks/*` method runs through here first, not only `tasks/get`. {@link update}
      * and {@link abort} answer `void`, so neither has a way to say "no such task" and neither
      * can be the place authorization is decided; this is. Expect one read of the named task
      * before every update and every cancellation, and expect an `undefined` answer to end that
@@ -4302,7 +4307,7 @@ export declare interface MCPTaskManagerInterface {
      */
     task(id: string, options: MCPMethodOptions): Promise<MCPTaskDetail | undefined>;
     /**
-     * Answer the input requests an `input_required` task is waiting on.
+     * Answers the input requests an `input_required` task is waiting on.
      *
      * @remarks
      * Responses are keyed by the request keys the task published. A key the task does not
@@ -4323,7 +4328,7 @@ export declare interface MCPTaskManagerInterface {
      */
     update(id: string, responses: Readonly<Record<string, unknown>>, options: MCPMethodOptions): Promise<void>;
     /**
-     * Ask one task to stop.
+     * Asks one task to stop.
      *
      * @remarks
      * Cancellation is COOPERATIVE: a task that has already finished, or one whose work
@@ -4347,7 +4352,7 @@ export declare interface MCPTaskManagerInterface {
 export declare interface MCPTaskOptions {
     /** The durable store the server creates tasks in and reads them back from. */
     readonly tasks: MCPTaskManagerInterface;
-    /** Decide whether the call in hand is deferred, and under which stable key. */
+    /** Decides whether the call in hand is deferred, and under which stable key. */
     readonly defer: MCPTaskHandler;
 }
 
@@ -4446,20 +4451,20 @@ export declare type MCPTextStream = AsyncGenerator<string, string, unknown>;
 export declare class MCPTextStreamController implements MCPTextStreamControllerInterface {
     #private;
     /**
-     * Mirror one controlled typed exchange as its serialized sequence.
+     * Mirrors one controlled typed exchange as its serialized sequence.
      *
      * @param stream - The controlled typed stream this face serializes and delegates into
      */
     constructor(stream: MCPStreamControllerInterface);
     /**
-     * Read the next serialized message, or the serialized terminating response.
+     * Reads the next serialized message, or the serialized terminating response.
      *
      * @returns The next message as a string, or the terminal as the iteration's `return`
      * @throws Whatever ended the typed exchange, unserialized — an abort is not a message
      */
     next(): Promise<IteratorResult<string, string>>;
     /**
-     * End the exchange because the consumer already has its answer.
+     * Ends the exchange because the consumer already has its answer.
      *
      * @remarks
      * The typed exchange ends with no terminal, because a string is not a
@@ -4472,7 +4477,7 @@ export declare class MCPTextStreamController implements MCPTextStreamControllerI
      */
     return(value: string | PromiseLike<string>): Promise<IteratorResult<string, string>>;
     /**
-     * End the exchange with a failure the consumer is raising.
+     * Ends the exchange with a failure the consumer is raising.
      *
      * @param error - The failure to end the exchange with
      * @returns Never — the returned promise always rejects
@@ -4480,13 +4485,13 @@ export declare class MCPTextStreamController implements MCPTextStreamControllerI
      */
     throw(error: unknown): Promise<IteratorResult<string, string>>;
     /**
-     * End the typed exchange permanently, with no terminal response.
+     * Ends the typed exchange permanently, with no terminal response.
      *
      * @returns Nothing
      */
     stop(): void;
     /**
-     * End the typed exchange when the scope that owns this face exits.
+     * Ends the typed exchange when the scope that owns this face exits.
      *
      * @remarks
      * Delegates downward exactly as {@link stop} does — disposing the serialized arm is
@@ -4496,7 +4501,7 @@ export declare class MCPTextStreamController implements MCPTextStreamControllerI
      */
     [Symbol.asyncDispose](): Promise<void>;
     /**
-     * Iterate this exchange — the controller is its own iterator.
+     * Iterates this exchange — the controller is its own iterator.
      *
      * @returns This controller
      */
@@ -4534,13 +4539,13 @@ export declare class MCPTextStreamController implements MCPTextStreamControllerI
  */
 export declare interface MCPTextStreamControllerInterface extends MCPTextStream {
     /**
-     * Read the next serialized message, or the serialized terminating response.
+     * Reads the next serialized message, or the serialized terminating response.
      *
      * @returns The next message as a string, or the terminal as the iteration's `return`
      */
     next(): Promise<IteratorResult<string, string>>;
     /**
-     * End the exchange because the consumer already has its answer.
+     * Ends the exchange because the consumer already has its answer.
      *
      * @remarks
      * The typed exchange ends with NO terminal: a string is not a {@link JSONRPCResponse}, and
@@ -4552,20 +4557,20 @@ export declare interface MCPTextStreamControllerInterface extends MCPTextStream
      */
     return(value: string | PromiseLike<string>): Promise<IteratorResult<string, string>>;
     /**
-     * End the exchange with a failure the consumer is raising.
+     * Ends the exchange with a failure the consumer is raising.
      *
      * @param error - The failure to end the exchange with
      * @returns Never — the returned promise always rejects with the supplied failure
      */
     throw(error: unknown): Promise<IteratorResult<string, string>>;
     /**
-     * End the exchange permanently, with no terminal response, through the typed stream.
+     * Ends the exchange permanently, with no terminal response, through the typed stream.
      *
      * @returns Nothing
      */
     stop(): void;
     /**
-     * End the typed exchange when the scope that owns this face exits.
+     * Ends the typed exchange when the scope that owns this face exits.
      *
      * @remarks
      * Delegates downward exactly as {@link stop} does, so a pump holding only the serialized
@@ -4616,13 +4621,13 @@ export declare interface MCPToolDescriptor {
  * replaceable handler per event is the whole point of it.
  */
 export declare interface MCPTransportInterface {
-    /** Deliver one outbound JSON-RPC message (already serialized). */
+    /** Delivers one outbound JSON-RPC message (already serialized). */
     readonly send: (message: string) => void | Promise<void>;
-    /** Register the single inbound-message handler — a second call REPLACES the first. */
+    /** Registers the single inbound-message handler — a second call REPLACES the first. */
     readonly listen: (handler: (message: string) => void) => void;
-    /** Register the single closed handler — a second call REPLACES the first. */
+    /** Registers the single closed handler — a second call REPLACES the first. */
     readonly closed: (handler: () => void) => void;
-    /** Close the underlying channel. */
+    /** Closes the underlying channel. */
     readonly close: () => void | Promise<void>;
 }
 
@@ -4634,7 +4639,7 @@ export declare interface MCPTransportInterface {
  * The name states the whole distinction: this is the tool-call result WITHOUT
  * `resultType`, which is the only shape the legacy revision has for one.
  * {@link MCPCallResult} is this payload plus the modern `'complete'` stamp, so
- * stamping is the one difference between the two eras' answers to `tools/call`.
+ * stamping is the one difference between the modern and legacy answers to `tools/call`.
  * Its sole producer is `MCPServer`'s legacy branch, and it is removed with that
  * branch.
  *
@@ -4659,11 +4664,11 @@ export declare type MCPUnstampedCallResult = {
 export declare type MCPVersion = '2026-07-28' | '2025-11-25' | '2025-06-18';
 
 /**
- * Narrow an already-parsed value to a {@link JSONRPCMessage}, or `undefined` when
+ * Narrows an already-parsed value to a {@link JSONRPCMessage}, or `undefined` when
  * it is not one.
  *
  * @remarks
- * Total (§14) — a non-message returns `undefined`, never throws. The input must
+ * Total — a non-message returns `undefined`, never throws. The input must
  * ALREADY be `JSON.parse`d: the raw-string parse (which can throw on malformed
  * JSON) happens in `MCPServer.handle` inside a try/catch that maps a parse failure
  * to a `-32700` response.
@@ -4677,7 +4682,7 @@ export declare type MCPVersion = '2026-07-28' | '2025-11-25' | '2025-06-18';
  * result. Identity is not preserved and is not promised.
  *
  * The parser's sound partner is the COMPOSITE `isJSONRPCMessage(value) &&
- * isBoundedJSON(value, limits)`, and against it both halves of the §15 soundness law
+ * isBoundedJSON(value, limits)`, and against it both halves of the soundness law
  * hold by construction:
  *
  * - Every non-`undefined` result satisfies {@link isJSONRPCMessage}, because the guard
@@ -4708,7 +4713,7 @@ export declare type MCPVersion = '2026-07-28' | '2025-11-25' | '2025-06-18';
 export declare function parseJSONRPCMessage(value: unknown, limits?: MCPJSONLimitOptions): JSONRPCMessage | undefined;
 
 /**
- * Parse the opened value carried by an opaque `requestState` continuation.
+ * Parses the opened value carried by an opaque `requestState` continuation.
  *
  * @remarks
  * This parser does not open the opaque continuation carrier; the configured
@@ -4730,7 +4735,7 @@ export declare function parseJSONRPCMessage(value: unknown, limits?: MCPJSONLimi
 export declare function parseMCPInputState(value: unknown): MCPInputState | undefined;
 
 /**
- * Parse the reserved modern request metadata into an {@link MCPRequestContext}.
+ * Parses the reserved modern request metadata into an {@link MCPRequestContext}.
  *
  * @remarks
  * This is the validity step after {@link isModernRequest}: a defined result can
@@ -4751,7 +4756,7 @@ export declare function parseMCPInputState(value: unknown): MCPInputState | unde
 export declare function parseRequestContext(value: unknown, limits?: MCPJSONLimitOptions): MCPRequestContext | undefined;
 
 /**
- * Read the request id an inbound `notifications/cancelled` names — the inverse of
+ * Reads the request id an inbound `notifications/cancelled` names — the inverse of
  * {@link buildCancelledNotification}.
  *
  * @remarks
@@ -4759,7 +4764,7 @@ export declare function parseRequestContext(value: unknown, limits?: MCPJSONLimi
  * real {@link JSONRPCId}: `null` is not one, and neither is an absent member, so a
  * malformed frame reads as "cancels nothing" rather than as an error. Anything that is not a
  * `notifications/cancelled` notification — a response, a request that happens to use the
- * method name, another notification — reads the same way. Total (§14).
+ * method name, another notification — reads the same way. Total.
  *
  * @param message - The decoded inbound message to read
  * @returns The id of the request being cancelled, or `undefined` when the message cancels nothing
@@ -4772,7 +4777,7 @@ export declare function parseRequestContext(value: unknown, limits?: MCPJSONLimi
 export declare function readCancelledId(message: JSONRPCMessage): JSONRPCId | undefined;
 
 /**
- * Pump a controlled serialized exchange onto a transport — every notification in order, then
+ * Pumps a controlled serialized exchange onto a transport — every notification in order, then
  * the terminating response — and END the exchange however the pump leaves.
  *
  * @remarks
@@ -4807,7 +4812,7 @@ export declare function readCancelledId(message: JSONRPCMessage): JSONRPCId | un
 export declare function sendStream(stream: MCPTextStreamControllerInterface, transport: MCPTransportInterface): Promise<void>;
 
 /**
- * Deterministically serialize one exact JSON value within explicit bounds.
+ * Serializes one exact JSON value deterministically within explicit bounds.
  *
  * @param value - The unknown value to validate and serialize
  * @param limits - Serialized byte, key, and depth limits
@@ -4816,7 +4821,7 @@ export declare function sendStream(stream: MCPTextStreamControllerInterface, tra
 export declare function serializeJSON(value: unknown, limits: MCPJSONLimitOptions): string | undefined;
 
 /**
- * Snapshot one bounded exact JSON value together with its canonical wire serialization.
+ * Snapshots one bounded exact JSON value together with its canonical wire serialization.
  *
  * The returned value is an owned, deeply frozen graph reconstructed from the canonical text;
  * the frozen tuple shares no mutable structure with the input. Invalid exact-JSON shapes,
@@ -4838,10 +4843,10 @@ export declare function serializeJSON(value: unknown, limits: MCPJSONLimitOption
 export declare function snapshotJSON(value: unknown, limits: MCPJSONLimitOptions): readonly [value: JSONValue, text: string] | undefined;
 
 /**
- * Snapshot one exact Tool result and the canonical wire text of a defined success value.
+ * Snapshots one exact Tool result and the canonical wire text of a defined success value.
  *
- * A success must have exactly four own enumerable data properties: `id`, `name`, `success: true`,
- * and `value`. A failure must instead have exactly `id`, `name`, `success: false`, and a string
+ * A success must have exactly the own enumerable data properties `id`, `name`,
+ * `success: true`, and `value`. A failure must instead have exactly `id`, `name`, `success: false`, and a string
  * `error`. The returned result and tuple are frozen. Only a defined success value crosses the
  * bounded JSON ownership seam; it becomes an owned deeply frozen value and receives canonical
  * text. Value-less successes and failures pair with `undefined` text. Non-records, symbol keys,
@@ -4866,7 +4871,7 @@ export declare function snapshotJSON(value: unknown, limits: MCPJSONLimitOptions
 export declare function snapshotToolResult(value: unknown, limits: MCPJSONLimitOptions): readonly [result: ToolResult, text: string | undefined] | undefined;
 
 /**
- * Stamp a subscription notification with the request id reserved for its held-open stream.
+ * Stamps a subscription notification with the request id reserved for its held-open stream.
  *
  * @param notification - The notification to copy and stamp
  * @param id - The `subscriptions/listen` request id
@@ -4874,18 +4879,6 @@ export declare function snapshotToolResult(value: unknown, limits: MCPJSONLimitO
  */
 export declare function stampSubscriptionNotification(notification: JSONRPCNotification, id: JSONRPCId): JSONRPCNotification;
 
-/** The terminating result returned when a `subscriptions/listen` stream closes gracefully. */
-export declare type SubscriptionsListenResult = {
-    readonly resultType: 'complete';
-    readonly _meta: SubscriptionsListenResultMetaObject;
-};
-
-/** The required metadata on a graceful `subscriptions/listen` result. */
-export declare type SubscriptionsListenResultMetaObject = MCPResultMetaObject & {
-    /** The JSON-RPC id of the `subscriptions/listen` request whose stream is closing. */
-    readonly 'io.modelcontextprotocol/subscriptionId': JSONRPCId;
-};
-
 /**
  * The MCP protocol revisions this server can negotiate.
  *