@fgv/ts-extras-mcp 5.1.0-34

package/temp/ts-extras-mcp.api.json

@@ -0,0 +1,1662 @@
+{
+  "metadata": {
+    "toolPackage": "@microsoft/api-extractor",
+    "toolVersion": "7.58.7",
+    "schemaVersion": 1011,
+    "oldestForwardsCompatibleVersion": 1001,
+    "tsdocConfig": {
+      "$schema": "https://developer.microsoft.com/json-schemas/tsdoc/v0/tsdoc.schema.json",
+      "noStandardTags": true,
+      "tagDefinitions": [
+        {
+          "tagName": "@alpha",
+          "syntaxKind": "modifier"
+        },
+        {
+          "tagName": "@beta",
+          "syntaxKind": "modifier"
+        },
+        {
+          "tagName": "@defaultValue",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@decorator",
+          "syntaxKind": "block",
+          "allowMultiple": true
+        },
+        {
+          "tagName": "@deprecated",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@eventProperty",
+          "syntaxKind": "modifier"
+        },
+        {
+          "tagName": "@example",
+          "syntaxKind": "block",
+          "allowMultiple": true
+        },
+        {
+          "tagName": "@experimental",
+          "syntaxKind": "modifier"
+        },
+        {
+          "tagName": "@inheritDoc",
+          "syntaxKind": "inline"
+        },
+        {
+          "tagName": "@internal",
+          "syntaxKind": "modifier"
+        },
+        {
+          "tagName": "@label",
+          "syntaxKind": "inline"
+        },
+        {
+          "tagName": "@link",
+          "syntaxKind": "inline",
+          "allowMultiple": true
+        },
+        {
+          "tagName": "@override",
+          "syntaxKind": "modifier"
+        },
+        {
+          "tagName": "@packageDocumentation",
+          "syntaxKind": "modifier"
+        },
+        {
+          "tagName": "@param",
+          "syntaxKind": "block",
+          "allowMultiple": true
+        },
+        {
+          "tagName": "@privateRemarks",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@public",
+          "syntaxKind": "modifier"
+        },
+        {
+          "tagName": "@readonly",
+          "syntaxKind": "modifier"
+        },
+        {
+          "tagName": "@remarks",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@returns",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@sealed",
+          "syntaxKind": "modifier"
+        },
+        {
+          "tagName": "@see",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@throws",
+          "syntaxKind": "block",
+          "allowMultiple": true
+        },
+        {
+          "tagName": "@typeParam",
+          "syntaxKind": "block",
+          "allowMultiple": true
+        },
+        {
+          "tagName": "@virtual",
+          "syntaxKind": "modifier"
+        },
+        {
+          "tagName": "@jsx",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@jsxRuntime",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@jsxFrag",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@jsxImportSource",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@betaDocumentation",
+          "syntaxKind": "modifier"
+        },
+        {
+          "tagName": "@internalRemarks",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@preapproved",
+          "syntaxKind": "modifier"
+        }
+      ],
+      "supportForTags": {
+        "@alpha": true,
+        "@beta": true,
+        "@defaultValue": true,
+        "@decorator": true,
+        "@deprecated": true,
+        "@eventProperty": true,
+        "@example": true,
+        "@experimental": true,
+        "@inheritDoc": true,
+        "@internal": true,
+        "@label": true,
+        "@link": true,
+        "@override": true,
+        "@packageDocumentation": true,
+        "@param": true,
+        "@privateRemarks": true,
+        "@public": true,
+        "@readonly": true,
+        "@remarks": true,
+        "@returns": true,
+        "@sealed": true,
+        "@see": true,
+        "@throws": true,
+        "@typeParam": true,
+        "@virtual": true,
+        "@betaDocumentation": true,
+        "@internalRemarks": true,
+        "@preapproved": true
+      },
+      "reportUnsupportedHtmlElements": false
+    }
+  },
+  "kind": "Package",
+  "canonicalReference": "@fgv/ts-extras-mcp!",
+  "docComment": "/**\n * `@fgv/ts-extras-mcp` — a Result-integration boundary over `@modelcontextprotocol/sdk` that connects to MCP (Model Context Protocol) servers, discovers their tools, and adapts each into an `AiAssist.IAiClientTool` so it drops directly into `AiAssist.executeClientToolTurn` — making any MCP server's tools callable across all four cloud providers with no per-provider work.\n *\n * Mirrors the discipline of `@fgv/ts-extras-webauthn` / `@fgv/ts-extras-transformers`: thin `Result<T>` conversion over a well-maintained upstream SDK, with no opinionated orchestration above the boundary.\n *\n * **In scope (slice 1, Node):** transport factories (`createStdioTransport`, `createHttpTransport`), session lifecycle (`connectMcpSession`, `closeMcpSession`), tool discovery + invocation (`listMcpTools`, `callMcpTool`), and the headline adapter (`adaptMcpTools`) which gracefully degrades on tools whose `inputSchema` is outside the supported JSON Schema subset (surfacing them on `skipped` and warning NOISILY).\n *\n * **Explicitly NOT in scope (deferred — see README / docs/FUTURE.md):** - Browser sibling `@fgv/ts-web-extras-mcp` - MCP resources / prompts / sampling features - OAuth / managed auth (static headers only at v0.1) - Multimodal tool-result passthrough (text-block projection only) - Cross-server tool-name namespacing (duplicate names already fail loudly in `executeClientToolTurn`)\n *\n * @packageDocumentation\n */\n",
+  "name": "@fgv/ts-extras-mcp",
+  "preserveMemberOrder": false,
+  "members": [
+    {
+      "kind": "EntryPoint",
+      "canonicalReference": "@fgv/ts-extras-mcp!",
+      "name": "",
+      "preserveMemberOrder": false,
+      "members": [
+        {
+          "kind": "Function",
+          "canonicalReference": "@fgv/ts-extras-mcp!adaptMcpTools:function(1)",
+          "docComment": "/**\n * Discovers an MCP server's tools and adapts each into an `AiAssist.IAiClientTool` that drops directly into `AiAssist.executeClientToolTurn`.\n *\n * @remarks\n *\n * **Constraint 1 — graceful degradation with NOISY warnings.** A tool whose `inputSchema` is outside the JSON Schema subset supported by `JsonSchema.fromJson` is NOT adapted (the model must never be offered a tool whose args we can't validate). Instead it is: 1. excluded from {@link IAdaptMcpToolsResult.tools}; 2. surfaced structurally on {@link IAdaptMcpToolsResult.skipped} with the tool name, the JSON-pointer reason, and the raw failing schema; and 3. logged as a NOISY `warning` (name + reason + raw schema) when an `options.logger` is supplied — so pointing this at a new server immediately reveals every subset feature to extend, with the schema in hand.\n *\n * The whole catalog never fails on a single bad schema; the only failure mode is an upstream `listMcpTools` error.\n *\n * @param session - A connected session from `connectMcpSession`.\n *\n * @param options - Optional logger for the NOISY skip warnings.\n *\n * @returns `Success` with `{ tools, skipped }`, or `Failure` only if tool discovery fails.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function adaptMcpTools(session: "
+            },
+            {
+              "kind": "Reference",
+              "text": "IMcpSession",
+              "canonicalReference": "@fgv/ts-extras-mcp!IMcpSession:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ", options?: "
+            },
+            {
+              "kind": "Reference",
+              "text": "IAdaptMcpToolsOptions",
+              "canonicalReference": "@fgv/ts-extras-mcp!IAdaptMcpToolsOptions:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Reference",
+              "text": "Promise",
+              "canonicalReference": "!Promise:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "<"
+            },
+            {
+              "kind": "Reference",
+              "text": "Result",
+              "canonicalReference": "@fgv/ts-utils!Result:type"
+            },
+            {
+              "kind": "Content",
+              "text": "<"
+            },
+            {
+              "kind": "Reference",
+              "text": "IAdaptMcpToolsResult",
+              "canonicalReference": "@fgv/ts-extras-mcp!IAdaptMcpToolsResult:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ">>"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/packlets/mcp/adapter.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 5,
+            "endIndex": 11
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "session",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            },
+            {
+              "parameterName": "options",
+              "parameterTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "isOptional": true
+            }
+          ],
+          "name": "adaptMcpTools"
+        },
+        {
+          "kind": "Function",
+          "canonicalReference": "@fgv/ts-extras-mcp!callMcpTool:function(1)",
+          "docComment": "/**\n * Calls a named tool on a connected MCP server.\n *\n * @remarks\n *\n * The SDK `CallToolResult` is projected to {@link IMcpToolCallResult} (text-block concatenation; non-text blocks summarized). A result flagged `isError: true` is mapped to `Result.fail` with the projected content — it is never swallowed, so `executeClientToolTurn` routes it back to the model as a provider-native error tool-result.\n *\n * @param session - A session from `connectMcpSession`.\n *\n * @param name - The tool name to invoke.\n *\n * @param args - The tool arguments (a JSON object).\n *\n * @returns `Success` with the projected content, or `Failure` on tool error / transport error / foreign handle.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function callMcpTool(session: "
+            },
+            {
+              "kind": "Reference",
+              "text": "IMcpSession",
+              "canonicalReference": "@fgv/ts-extras-mcp!IMcpSession:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ", name: "
+            },
+            {
+              "kind": "Content",
+              "text": "string"
+            },
+            {
+              "kind": "Content",
+              "text": ", args: "
+            },
+            {
+              "kind": "Reference",
+              "text": "JsonObject",
+              "canonicalReference": "@fgv/ts-json-base!JsonObject:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Reference",
+              "text": "Promise",
+              "canonicalReference": "!Promise:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "<"
+            },
+            {
+              "kind": "Reference",
+              "text": "Result",
+              "canonicalReference": "@fgv/ts-utils!Result:type"
+            },
+            {
+              "kind": "Content",
+              "text": "<"
+            },
+            {
+              "kind": "Reference",
+              "text": "IMcpToolCallResult",
+              "canonicalReference": "@fgv/ts-extras-mcp!IMcpToolCallResult:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ">>"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/packlets/mcp/operations.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 7,
+            "endIndex": 13
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "session",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            },
+            {
+              "parameterName": "name",
+              "parameterTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "isOptional": false
+            },
+            {
+              "parameterName": "args",
+              "parameterTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 6
+              },
+              "isOptional": false
+            }
+          ],
+          "name": "callMcpTool"
+        },
+        {
+          "kind": "Function",
+          "canonicalReference": "@fgv/ts-extras-mcp!closeMcpSession:function(1)",
+          "docComment": "/**\n * Closes an MCP session, tearing down the transport (and any spawned subprocess).\n *\n * @param session - A session from {@link connectMcpSession}.\n *\n * @returns `Success(true)`, or `Failure` if the handle is foreign or the close call throws.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function closeMcpSession(session: "
+            },
+            {
+              "kind": "Reference",
+              "text": "IMcpSession",
+              "canonicalReference": "@fgv/ts-extras-mcp!IMcpSession:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Reference",
+              "text": "Promise",
+              "canonicalReference": "!Promise:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "<"
+            },
+            {
+              "kind": "Reference",
+              "text": "Result",
+              "canonicalReference": "@fgv/ts-utils!Result:type"
+            },
+            {
+              "kind": "Content",
+              "text": "<true>>"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/packlets/mcp/session.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 3,
+            "endIndex": 7
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "session",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            }
+          ],
+          "name": "closeMcpSession"
+        },
+        {
+          "kind": "Function",
+          "canonicalReference": "@fgv/ts-extras-mcp!connectMcpSession:function(1)",
+          "docComment": "/**\n * Connects to an MCP server over the given transport and performs the initialize handshake.\n *\n * @param params - Transport plus optional client identity and logger.\n *\n * @returns `Success` with an opaque {@link IMcpSession}, or `Failure` if the transport handle is foreign or the connection/handshake fails.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function connectMcpSession(params: "
+            },
+            {
+              "kind": "Reference",
+              "text": "IConnectMcpSessionParams",
+              "canonicalReference": "@fgv/ts-extras-mcp!IConnectMcpSessionParams:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Reference",
+              "text": "Promise",
+              "canonicalReference": "!Promise:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "<"
+            },
+            {
+              "kind": "Reference",
+              "text": "Result",
+              "canonicalReference": "@fgv/ts-utils!Result:type"
+            },
+            {
+              "kind": "Content",
+              "text": "<"
+            },
+            {
+              "kind": "Reference",
+              "text": "IMcpSession",
+              "canonicalReference": "@fgv/ts-extras-mcp!IMcpSession:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ">>"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/packlets/mcp/session.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 3,
+            "endIndex": 9
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "params",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            }
+          ],
+          "name": "connectMcpSession"
+        },
+        {
+          "kind": "Function",
+          "canonicalReference": "@fgv/ts-extras-mcp!createHttpTransport:function(1)",
+          "docComment": "/**\n * Creates a Streamable-HTTP MCP transport for the given endpoint URL.\n *\n * @param params - The endpoint URL and optional static headers.\n *\n * @returns `Success` with an opaque transport handle, or `Failure` if the URL is invalid or the SDK constructor throws.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function createHttpTransport(params: "
+            },
+            {
+              "kind": "Reference",
+              "text": "IMcpHttpTransportParams",
+              "canonicalReference": "@fgv/ts-extras-mcp!IMcpHttpTransportParams:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Reference",
+              "text": "Result",
+              "canonicalReference": "@fgv/ts-utils!Result:type"
+            },
+            {
+              "kind": "Content",
+              "text": "<"
+            },
+            {
+              "kind": "Reference",
+              "text": "IMcpTransport",
+              "canonicalReference": "@fgv/ts-extras-mcp!IMcpTransport:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ">"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/packlets/mcp/transports.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 3,
+            "endIndex": 7
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "params",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            }
+          ],
+          "name": "createHttpTransport"
+        },
+        {
+          "kind": "Function",
+          "canonicalReference": "@fgv/ts-extras-mcp!createStdioTransport:function(1)",
+          "docComment": "/**\n * Creates a stdio MCP transport that speaks MCP over the stdin/stdout of a spawned subprocess.\n *\n * @remarks\n *\n * **Security — trust boundary.** The transport spawns `params.command` (with `params.args`) as a child process. Never source the command or arguments from untrusted input; treat them with the same care as any shell-out. See the package README's security note.\n *\n * @param params - The command, arguments, environment, and working directory.\n *\n * @returns `Success` with an opaque transport handle, or `Failure` if the SDK constructor throws (e.g. an empty command).\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function createStdioTransport(params: "
+            },
+            {
+              "kind": "Reference",
+              "text": "IMcpStdioTransportParams",
+              "canonicalReference": "@fgv/ts-extras-mcp!IMcpStdioTransportParams:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Reference",
+              "text": "Result",
+              "canonicalReference": "@fgv/ts-utils!Result:type"
+            },
+            {
+              "kind": "Content",
+              "text": "<"
+            },
+            {
+              "kind": "Reference",
+              "text": "IMcpTransport",
+              "canonicalReference": "@fgv/ts-extras-mcp!IMcpTransport:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ">"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/packlets/mcp/transports.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 3,
+            "endIndex": 7
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "params",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            }
+          ],
+          "name": "createStdioTransport"
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@fgv/ts-extras-mcp!IAdaptMcpToolsOptions:interface",
+          "docComment": "/**\n * Options for {@link adaptMcpTools}.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface IAdaptMcpToolsOptions "
+            }
+          ],
+          "fileUrlPath": "src/packlets/mcp/model.ts",
+          "releaseTag": "Public",
+          "name": "IAdaptMcpToolsOptions",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-extras-mcp!IAdaptMcpToolsOptions#logger:member",
+              "docComment": "/**\n * Logger for the NOISY per-tool skip warnings. When a tool is skipped, a `warning` is emitted including the tool name, the JSON-pointer reason, and the raw failing schema. When omitted, skips are still surfaced structurally on {@link IAdaptMcpToolsResult.skipped}.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly logger?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Logging.ILogger",
+                  "canonicalReference": "@fgv/ts-utils!ILogger:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "logger",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@fgv/ts-extras-mcp!IAdaptMcpToolsResult:interface",
+          "docComment": "/**\n * The result of {@link adaptMcpTools}: cleanly-adapted client tools plus the structurally-surfaced set of tools that could not be adapted (graceful degradation, Constraint 1).\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface IAdaptMcpToolsResult "
+            }
+          ],
+          "fileUrlPath": "src/packlets/mcp/model.ts",
+          "releaseTag": "Public",
+          "name": "IAdaptMcpToolsResult",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-extras-mcp!IAdaptMcpToolsResult#skipped:member",
+              "docComment": "/**\n * Tools excluded because their `inputSchema` is outside the supported JSON Schema subset.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly skipped: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ReadonlyArray",
+                  "canonicalReference": "!ReadonlyArray:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "IMcpSkippedTool",
+                  "canonicalReference": "@fgv/ts-extras-mcp!IMcpSkippedTool:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "skipped",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 5
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-extras-mcp!IAdaptMcpToolsResult#tools:member",
+              "docComment": "/**\n * Tools adapted into `IAiClientTool` — safe to hand to `AiAssist.executeClientToolTurn`.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly tools: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ReadonlyArray",
+                  "canonicalReference": "!ReadonlyArray:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AiAssist.IAiClientTool",
+                  "canonicalReference": "@fgv/ts-extras!IAiClientTool:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "tools",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 5
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@fgv/ts-extras-mcp!IConnectMcpSessionParams:interface",
+          "docComment": "/**\n * Parameters for {@link connectMcpSession}.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface IConnectMcpSessionParams "
+            }
+          ],
+          "fileUrlPath": "src/packlets/mcp/model.ts",
+          "releaseTag": "Public",
+          "name": "IConnectMcpSessionParams",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-extras-mcp!IConnectMcpSessionParams#clientName:member",
+              "docComment": "/**\n * Client name advertised to the server during the initialize handshake. Default `'@fgv/ts-extras-mcp'`.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly clientName?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "clientName",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-extras-mcp!IConnectMcpSessionParams#clientVersion:member",
+              "docComment": "/**\n * Client version advertised to the server. Default the package version.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly clientVersion?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "clientVersion",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-extras-mcp!IConnectMcpSessionParams#logger:member",
+              "docComment": "/**\n * Optional logger for connection diagnostics.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly logger?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Logging.ILogger",
+                  "canonicalReference": "@fgv/ts-utils!ILogger:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "logger",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-extras-mcp!IConnectMcpSessionParams#transport:member",
+              "docComment": "/**\n * A transport produced by {@link createStdioTransport} / {@link createHttpTransport}.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly transport: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "IMcpTransport",
+                  "canonicalReference": "@fgv/ts-extras-mcp!IMcpTransport:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "transport",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@fgv/ts-extras-mcp!IMcpHttpTransportParams:interface",
+          "docComment": "/**\n * Parameters for {@link createHttpTransport}. The transport connects to a Streamable-HTTP MCP endpoint.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface IMcpHttpTransportParams "
+            }
+          ],
+          "fileUrlPath": "src/packlets/mcp/model.ts",
+          "releaseTag": "Public",
+          "name": "IMcpHttpTransportParams",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-extras-mcp!IMcpHttpTransportParams#headers:member",
+              "docComment": "/**\n * Optional static headers (e.g. an `Authorization` bearer token). OAuth/managed auth is out of scope at v0.1.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly headers?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Record",
+                  "canonicalReference": "!Record:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<string, string>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "headers",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-extras-mcp!IMcpHttpTransportParams#url:member",
+              "docComment": "/**\n * Absolute `http`/`https` URL of the MCP server endpoint.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly url: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "url",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@fgv/ts-extras-mcp!IMcpServerInfo:interface",
+          "docComment": "/**\n * Server identity reported during the MCP initialize handshake.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface IMcpServerInfo "
+            }
+          ],
+          "fileUrlPath": "src/packlets/mcp/model.ts",
+          "releaseTag": "Public",
+          "name": "IMcpServerInfo",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-extras-mcp!IMcpServerInfo#name:member",
+              "docComment": "/**\n * Server-advertised name.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly name: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "name",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-extras-mcp!IMcpServerInfo#version:member",
+              "docComment": "/**\n * Server-advertised version.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly version: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "version",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@fgv/ts-extras-mcp!IMcpSession:interface",
+          "docComment": "/**\n * Opaque handle to a connected MCP session. Pass it to {@link listMcpTools}, {@link callMcpTool}, {@link adaptMcpTools}, and {@link closeMcpSession}.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface IMcpSession "
+            }
+          ],
+          "fileUrlPath": "src/packlets/mcp/model.ts",
+          "releaseTag": "Public",
+          "name": "IMcpSession",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-extras-mcp!IMcpSession#clientName:member",
+              "docComment": "/**\n * Client name advertised during the handshake.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly clientName: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "clientName",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-extras-mcp!IMcpSession#clientVersion:member",
+              "docComment": "/**\n * Client version advertised during the handshake.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly clientVersion: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "clientVersion",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-extras-mcp!IMcpSession#serverInfo:member",
+              "docComment": "/**\n * Server identity reported by the handshake, when the server provided one.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly serverInfo: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "IMcpServerInfo",
+                  "canonicalReference": "@fgv/ts-extras-mcp!IMcpServerInfo:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": " | undefined"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "serverInfo",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@fgv/ts-extras-mcp!IMcpSkippedTool:interface",
+          "docComment": "/**\n * A tool that was discovered but could NOT be adapted into an `AiAssist.IAiClientTool`, because its `inputSchema` is outside the JSON Schema subset supported by `JsonSchema.fromJson`. Surfaced structurally so callers/the probe can enumerate exactly which subset features a server needs (with the raw schema in hand to extend `fromJson` later).\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface IMcpSkippedTool "
+            }
+          ],
+          "fileUrlPath": "src/packlets/mcp/model.ts",
+          "releaseTag": "Public",
+          "name": "IMcpSkippedTool",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-extras-mcp!IMcpSkippedTool#name:member",
+              "docComment": "/**\n * The tool's name.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly name: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "name",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-extras-mcp!IMcpSkippedTool#reason:member",
+              "docComment": "/**\n * Why the tool was skipped — the JSON-pointer reason from `JsonSchema.fromJson`, or a structural reason.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly reason: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "reason",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-extras-mcp!IMcpSkippedTool#schema:member",
+              "docComment": "/**\n * The raw failing input schema, verbatim, in hand for additively widening `JsonSchema.fromJson`.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly schema: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "JsonValue",
+                  "canonicalReference": "@fgv/ts-json-base!JsonValue:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "schema",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@fgv/ts-extras-mcp!IMcpStdioTransportParams:interface",
+          "docComment": "/**\n * Parameters for {@link createStdioTransport}. The transport spawns `command` as a subprocess and speaks MCP over its stdin/stdout.\n *\n * @remarks\n *\n * **Security:** stdio transport executes a consumer-supplied command. Treat `command`/`args` as a trust boundary — never source them from untrusted input. See the package README.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface IMcpStdioTransportParams "
+            }
+          ],
+          "fileUrlPath": "src/packlets/mcp/model.ts",
+          "releaseTag": "Public",
+          "name": "IMcpStdioTransportParams",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-extras-mcp!IMcpStdioTransportParams#args:member",
+              "docComment": "/**\n * Arguments passed to the command.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly args?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ReadonlyArray",
+                  "canonicalReference": "!ReadonlyArray:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<string>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "args",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-extras-mcp!IMcpStdioTransportParams#command:member",
+              "docComment": "/**\n * Executable to spawn (e.g. `'npx'`, `'node'`, an absolute path).\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly command: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "command",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-extras-mcp!IMcpStdioTransportParams#cwd:member",
+              "docComment": "/**\n * Working directory for the spawned process.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly cwd?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "cwd",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-extras-mcp!IMcpStdioTransportParams#env:member",
+              "docComment": "/**\n * Environment variables for the spawned process. When omitted, the SDK's safe default set is used.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly env?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Record",
+                  "canonicalReference": "!Record:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<string, string>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "env",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@fgv/ts-extras-mcp!IMcpToolCallResult:interface",
+          "docComment": "/**\n * Successful projection of an MCP `CallToolResult` produced by {@link callMcpTool}.\n *\n * @remarks\n *\n * `content` is the text concatenation of the result's `text` blocks; non-text blocks (image / audio / resource) are projected to a one-line `[<type> block]` summary (multimodal passthrough is out of scope at v0.1). A result with `isError: true` is mapped to `Result.fail(content)` rather than returned here, so it is never silently swallowed.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface IMcpToolCallResult "
+            }
+          ],
+          "fileUrlPath": "src/packlets/mcp/model.ts",
+          "releaseTag": "Public",
+          "name": "IMcpToolCallResult",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-extras-mcp!IMcpToolCallResult#content:member",
+              "docComment": "/**\n * The projected text content of the tool result.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly content: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "content",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@fgv/ts-extras-mcp!IMcpToolDescriptor:interface",
+          "docComment": "/**\n * A tool descriptor discovered from an MCP server via {@link listMcpTools}.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface IMcpToolDescriptor "
+            }
+          ],
+          "fileUrlPath": "src/packlets/mcp/model.ts",
+          "releaseTag": "Public",
+          "name": "IMcpToolDescriptor",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-extras-mcp!IMcpToolDescriptor#description:member",
+              "docComment": "/**\n * Human-readable description, when the server provided one.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly description: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string | undefined"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "description",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-extras-mcp!IMcpToolDescriptor#inputSchema:member",
+              "docComment": "/**\n * The tool's declared input schema as raw JSON. Per the MCP spec this is normally a JSON Schema object; carried verbatim so {@link adaptMcpTools} can run it through `JsonSchema.fromJson` (and surface it on {@link IMcpSkippedTool} when it is outside the supported subset).\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly inputSchema: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "JsonValue",
+                  "canonicalReference": "@fgv/ts-json-base!JsonValue:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "inputSchema",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-extras-mcp!IMcpToolDescriptor#name:member",
+              "docComment": "/**\n * Tool name (unique within a server).\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly name: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "name",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@fgv/ts-extras-mcp!IMcpTransport:interface",
+          "docComment": "/**\n * Opaque handle to an MCP transport produced by {@link createStdioTransport} or {@link createHttpTransport}. Hand it to {@link connectMcpSession}; do not construct directly.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface IMcpTransport "
+            }
+          ],
+          "fileUrlPath": "src/packlets/mcp/model.ts",
+          "releaseTag": "Public",
+          "name": "IMcpTransport",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-extras-mcp!IMcpTransport#transportKind:member",
+              "docComment": "/**\n * Which transport kind this handle wraps.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly transportKind: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "'stdio' | 'http'"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "transportKind",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
+        {
+          "kind": "Function",
+          "canonicalReference": "@fgv/ts-extras-mcp!listMcpTools:function(1)",
+          "docComment": "/**\n * Lists every tool a connected MCP server advertises, following the SDK's `nextCursor` pagination until the full catalog is accumulated.\n *\n * @param session - A session from `connectMcpSession`.\n *\n * @returns `Success` with the full tool catalog, or `Failure` on a foreign handle or a transport/protocol error.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function listMcpTools(session: "
+            },
+            {
+              "kind": "Reference",
+              "text": "IMcpSession",
+              "canonicalReference": "@fgv/ts-extras-mcp!IMcpSession:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Reference",
+              "text": "Promise",
+              "canonicalReference": "!Promise:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "<"
+            },
+            {
+              "kind": "Reference",
+              "text": "Result",
+              "canonicalReference": "@fgv/ts-utils!Result:type"
+            },
+            {
+              "kind": "Content",
+              "text": "<"
+            },
+            {
+              "kind": "Reference",
+              "text": "ReadonlyArray",
+              "canonicalReference": "!ReadonlyArray:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "<"
+            },
+            {
+              "kind": "Reference",
+              "text": "IMcpToolDescriptor",
+              "canonicalReference": "@fgv/ts-extras-mcp!IMcpToolDescriptor:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ">>>"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/packlets/mcp/operations.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 3,
+            "endIndex": 11
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "session",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            }
+          ],
+          "name": "listMcpTools"
+        }
+      ]
+    }
+  ]
+}