@qodo/sdk 0.13.4 → 2.0.0-next.0

package/dist/client/mcp/projection.d.ts

@@ -0,0 +1,109 @@
+/**
+ * SDK-side MCP tool projection.
+ *
+ * `projectMcpTools` resolves a consumer's `mcpTools` selector against the
+ * live {@link McpClientPool} catalog and produces the concrete
+ * `FunctionToolDef[]` shipped to QAR via `AgentSpec.tools`. The function is
+ * the SDK's single point of responsibility for the MCP-projection contract:
+ *
+ *   - **Shape A** (`readonly string[]`) — entries are either MCP names
+ *     (whole-server inclusion) or `<mcp>.<tool>` dotted references
+ *     (specific tool).
+ *   - **Shape B** (`{ allowlist?, blocklist? }`) — set difference,
+ *     same dotted-name resolution as Shape A.
+ *   - **Shape C** (`(tool: DiscoveredMcpTool) => boolean`) — dynamic
+ *     filter receiving every discovered tool across every registered MCP.
+ *
+ * Each match becomes a `FunctionToolDef` carrying the upstream MCP's
+ * `inputSchema` + `description` + (new) `annotations`. Tool names are
+ * auto-prefixed `<mcp>.<tool>` when the per-MCP `prefixToolNames` policy
+ * is on (default); off when the consumer explicitly opted out at
+ * `registerMcp` time. Consumer-shipped `tools[]` entries are merged on
+ * top — consumer-shipped wins on name collision; consumer-shipped tools
+ * escape prefixing because the consumer wrote the name.
+ *
+ * Diagnostics surface drift between consumer code and the live MCP
+ * surface as three buckets:
+ *
+ *   - `unknownMcps` — allowlist entries naming an MCP not in the pool.
+ *   - `unknownMcpTools` — dotted-name allowlist / override entries whose
+ *     suffix doesn't match a discovered tool.
+ *   - `unreachableMcps` — registered MCPs that the selector explicitly
+ *     *referenced* AND whose catalog is absent (cold start hasn't
+ *     populated). Note the **referenced** scope: an unreachable MCP that
+ *     this agent doesn't depend on is silently omitted, NOT flagged.
+ *     Reference scope:
+ *       - Shape A (string[]) — bare names + the MCP part of dotted entries.
+ *       - Shape B allowlist — bare names + dotted MCP parts. Blocklist
+ *         entries do NOT add references (the consumer is trying to
+ *         exclude something; if it's already absent, intent is fulfilled).
+ *       - Shape B blocklist-only (no allowlist) — no references; full
+ *         reachable surface minus blocks.
+ *       - Shape C callback — no references; the consumer accepts whatever
+ *         the live catalog provides.
+ *     The caller chooses what to do with each diagnostic per the
+ *     registered `unavailability` policy.
+ *
+ * Ordering for prompt-cache stability (D17-9): consumer-shipped first
+ * (in original insertion order), then projected tools sorted
+ * lexicographically by `<mcp>.<tool>`. Stable across runs so Anthropic's
+ * prompt-cache prefix matching keeps hitting.
+ *
+ * The function is pure — same inputs, same outputs — so tests can drive
+ * it directly without a live pool. Callers await
+ * `pool.waitForCatalogsToSettle()` BEFORE invoking projection so a
+ * still-loading MCP doesn't read as unreachable.
+ */
+import type { FunctionToolDef, McpToolOverrides, McpToolsSelector } from '../../qar/specs.js';
+import type { McpClientPool } from './McpClientPool.js';
+/**
+ * Input to {@link projectMcpTools}. Consumer-facing fields lifted off the
+ * `InlineAgentSpec` at the wire boundary.
+ */
+export interface ProjectionInput {
+    /** The `mcpTools` selector — Shape A / B / C, or `undefined` to skip discovery. */
+    readonly mcpTools?: McpToolsSelector;
+    /** Consumer-shipped `tools[]` — preserved verbatim (consumer wins on name match). */
+    readonly consumerTools?: readonly FunctionToolDef[] | null;
+    /** Per-tool description overlay — applied AFTER projection. */
+    readonly mcpToolOverrides?: McpToolOverrides;
+}
+/**
+ * Result of {@link projectMcpTools}. `tools` is the merged + ordered
+ * surface (consumer-shipped first, projected sorted lex); `diagnostics`
+ * captures drift the caller may want to raise as typed errors.
+ */
+export interface ProjectionResult {
+    readonly tools: readonly FunctionToolDef[];
+    readonly diagnostics: {
+        readonly unknownMcps: readonly string[];
+        readonly unknownMcpTools: readonly string[];
+        readonly unreachableMcps: readonly string[];
+    };
+}
+/**
+ * Resolve the MCP selector against the pool and produce the concrete
+ * `FunctionToolDef[]` for the wire envelope. See module docblock for the
+ * contract.
+ *
+ * @param input           Consumer-side selector + tools[] + overrides.
+ * @param pool            Live `McpClientPool` (sync-snapshot accessor; the
+ *                        caller is responsible for awaiting
+ *                        `waitForCatalogsToSettle()` first).
+ * @param prefixPolicy    Per-MCP prefix-on policy. Default `true` when the
+ *                        map is missing an entry — the wire fallback for
+ *                        an MCP registered before the projection ergonomics
+ *                        existed.
+ * @param extraKnownMcps  Additional MCP names known to the registry but
+ *                        NOT present in the pool. The canonical use case
+ *                        is `transport: 'sdk'` in-process MCPs whose
+ *                        dispatch path bypasses the pool — they have no
+ *                        `tools/list` contract, so the projection layer
+ *                        doesn't auto-project tools for them; but
+ *                        referencing one in `mcpTools` should NOT raise
+ *                        `QodoUnknownMcpError`. Tools for those MCPs ship
+ *                        via consumer `tools[]` instead. Optional;
+ *                        defaults empty.
+ */
+export declare function projectMcpTools(input: ProjectionInput, pool: McpClientPool, prefixPolicy: ReadonlyMap<string, boolean>, extraKnownMcps?: ReadonlySet<string>): ProjectionResult;
+//# sourceMappingURL=projection.d.ts.map

package/dist/client/mcp/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../../src/client/mcp/projection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAGH,OAAO,KAAK,EAEV,eAAe,EAEf,gBAAgB,EAChB,gBAAgB,EAGjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,aAAa,EAAiB,MAAM,oBAAoB,CAAC;AAEvE;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IACrC,qFAAqF;IACrF,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,eAAe,EAAE,GAAG,IAAI,CAAC;IAC3D,+DAA+D;IAC/D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CAC9C;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;IAC3C,QAAQ,CAAC,WAAW,EAAE;QACpB,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;QACxC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;QAC5C,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;KAC7C,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE,aAAa,EACnB,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1C,cAAc,GAAE,WAAW,CAAC,MAAM,CAAmB,GACpD,gBAAgB,CAkLlB"}

package/dist/client/mcp/projection.js

@@ -0,0 +1,446 @@
+/**
+ * SDK-side MCP tool projection.
+ *
+ * `projectMcpTools` resolves a consumer's `mcpTools` selector against the
+ * live {@link McpClientPool} catalog and produces the concrete
+ * `FunctionToolDef[]` shipped to QAR via `AgentSpec.tools`. The function is
+ * the SDK's single point of responsibility for the MCP-projection contract:
+ *
+ *   - **Shape A** (`readonly string[]`) — entries are either MCP names
+ *     (whole-server inclusion) or `<mcp>.<tool>` dotted references
+ *     (specific tool).
+ *   - **Shape B** (`{ allowlist?, blocklist? }`) — set difference,
+ *     same dotted-name resolution as Shape A.
+ *   - **Shape C** (`(tool: DiscoveredMcpTool) => boolean`) — dynamic
+ *     filter receiving every discovered tool across every registered MCP.
+ *
+ * Each match becomes a `FunctionToolDef` carrying the upstream MCP's
+ * `inputSchema` + `description` + (new) `annotations`. Tool names are
+ * auto-prefixed `<mcp>.<tool>` when the per-MCP `prefixToolNames` policy
+ * is on (default); off when the consumer explicitly opted out at
+ * `registerMcp` time. Consumer-shipped `tools[]` entries are merged on
+ * top — consumer-shipped wins on name collision; consumer-shipped tools
+ * escape prefixing because the consumer wrote the name.
+ *
+ * Diagnostics surface drift between consumer code and the live MCP
+ * surface as three buckets:
+ *
+ *   - `unknownMcps` — allowlist entries naming an MCP not in the pool.
+ *   - `unknownMcpTools` — dotted-name allowlist / override entries whose
+ *     suffix doesn't match a discovered tool.
+ *   - `unreachableMcps` — registered MCPs that the selector explicitly
+ *     *referenced* AND whose catalog is absent (cold start hasn't
+ *     populated). Note the **referenced** scope: an unreachable MCP that
+ *     this agent doesn't depend on is silently omitted, NOT flagged.
+ *     Reference scope:
+ *       - Shape A (string[]) — bare names + the MCP part of dotted entries.
+ *       - Shape B allowlist — bare names + dotted MCP parts. Blocklist
+ *         entries do NOT add references (the consumer is trying to
+ *         exclude something; if it's already absent, intent is fulfilled).
+ *       - Shape B blocklist-only (no allowlist) — no references; full
+ *         reachable surface minus blocks.
+ *       - Shape C callback — no references; the consumer accepts whatever
+ *         the live catalog provides.
+ *     The caller chooses what to do with each diagnostic per the
+ *     registered `unavailability` policy.
+ *
+ * Ordering for prompt-cache stability (D17-9): consumer-shipped first
+ * (in original insertion order), then projected tools sorted
+ * lexicographically by `<mcp>.<tool>`. Stable across runs so Anthropic's
+ * prompt-cache prefix matching keeps hitting.
+ *
+ * The function is pure — same inputs, same outputs — so tests can drive
+ * it directly without a live pool. Callers await
+ * `pool.waitForCatalogsToSettle()` BEFORE invoking projection so a
+ * still-loading MCP doesn't read as unreachable.
+ */
+/**
+ * Resolve the MCP selector against the pool and produce the concrete
+ * `FunctionToolDef[]` for the wire envelope. See module docblock for the
+ * contract.
+ *
+ * @param input           Consumer-side selector + tools[] + overrides.
+ * @param pool            Live `McpClientPool` (sync-snapshot accessor; the
+ *                        caller is responsible for awaiting
+ *                        `waitForCatalogsToSettle()` first).
+ * @param prefixPolicy    Per-MCP prefix-on policy. Default `true` when the
+ *                        map is missing an entry — the wire fallback for
+ *                        an MCP registered before the projection ergonomics
+ *                        existed.
+ * @param extraKnownMcps  Additional MCP names known to the registry but
+ *                        NOT present in the pool. The canonical use case
+ *                        is `transport: 'sdk'` in-process MCPs whose
+ *                        dispatch path bypasses the pool — they have no
+ *                        `tools/list` contract, so the projection layer
+ *                        doesn't auto-project tools for them; but
+ *                        referencing one in `mcpTools` should NOT raise
+ *                        `QodoUnknownMcpError`. Tools for those MCPs ship
+ *                        via consumer `tools[]` instead. Optional;
+ *                        defaults empty.
+ */
+export function projectMcpTools(input, pool, prefixPolicy, extraKnownMcps = EMPTY_KNOWN_SET) {
+    // 0. Resolve registered set + cached catalogs + the "referenced" MCP
+    //    set the selector explicitly names. The referenced scope is what
+    //    governs the `unreachableMcps` diagnostic — an MCP the consumer
+    //    doesn't depend on isn't a failure even if its catalog is cold.
+    const registered = pool.listRegisteredNames();
+    const registeredSet = new Set(registered);
+    // Union pool-registered names with the consumer-supplied "extra known"
+    // set so sdk-transport MCPs aren't flagged as unknown.
+    for (const name of extraKnownMcps)
+        registeredSet.add(name);
+    const catalogSnapshot = pool.getCatalogSnapshot();
+    const referencedMcps = collectReferencedMcps(input.mcpTools);
+    // Per-MCP discovered-tool index. Catalogs with `undefined` cache mean
+    // unreachable; recorded in `unreachableMcps` ONLY when the selector
+    // referenced the MCP (per the scope rule documented at the top of
+    // this file). Catalogs present (even an empty array) are reachable.
+    // `extraKnownMcps` entries don't appear here — they have no catalog
+    // and shouldn't be flagged as unreachable either; their tools ship
+    // through the consumer's `tools[]` directly.
+    const discoveredByMcp = new Map();
+    const unreachableMcps = [];
+    for (const mcpName of registered) {
+        const catalog = catalogSnapshot.get(mcpName);
+        if (catalog === undefined) {
+            if (referencedMcps.has(mcpName)) {
+                unreachableMcps.push(mcpName);
+            }
+            continue;
+        }
+        const tools = [];
+        for (const entry of catalog) {
+            tools.push(toDiscovered(mcpName, entry));
+        }
+        discoveredByMcp.set(mcpName, tools);
+    }
+    // 1. Walk the selector — produce a Map<projectedName, FunctionToolDef>
+    //    keyed by the post-prefix name so consumer-shipped collisions
+    //    win on insertion order.
+    const unknownMcps = [];
+    const unknownMcpToolsRef = [];
+    const projected = new Map();
+    const selector = input.mcpTools;
+    if (selector !== undefined) {
+        if (typeof selector === 'function') {
+            // Shape C — run the filter across every discovered tool.
+            for (const [mcpName, tools] of discoveredByMcp) {
+                const prefixOn = readPrefixPolicy(prefixPolicy, mcpName);
+                for (const tool of tools) {
+                    if (selector(tool)) {
+                        const projectedName = prefixOn ? `${mcpName}.${tool.name}` : tool.name;
+                        projected.set(projectedName, toFunctionToolDef(projectedName, tool));
+                    }
+                }
+            }
+        }
+        else if (Array.isArray(selector)) {
+            // Shape A — strings; entries with `.` = specific tool, without = whole MCP.
+            const arr = selector;
+            applyAllowlist(arr, discoveredByMcp, registeredSet, prefixPolicy, projected, unknownMcps, unknownMcpToolsRef);
+        }
+        else {
+            // Shape B — allowlist + blocklist.
+            const ab = selector;
+            if (ab.allowlist !== undefined) {
+                applyAllowlist(ab.allowlist, discoveredByMcp, registeredSet, prefixPolicy, projected, unknownMcps, unknownMcpToolsRef);
+            }
+            else {
+                // Allowlist omitted = include every reachable tool, then
+                // subtract blocklist. Matches "subtract from full" semantics.
+                for (const [mcpName, tools] of discoveredByMcp) {
+                    const prefixOn = readPrefixPolicy(prefixPolicy, mcpName);
+                    for (const tool of tools) {
+                        const projectedName = prefixOn ? `${mcpName}.${tool.name}` : tool.name;
+                        projected.set(projectedName, toFunctionToolDef(projectedName, tool));
+                    }
+                }
+            }
+            if (ab.blocklist !== undefined) {
+                applyBlocklist(ab.blocklist, discoveredByMcp, registeredSet, prefixPolicy, projected, unknownMcps, unknownMcpToolsRef);
+            }
+        }
+    }
+    // 2. Apply description overlays. Keys are tool names AS PROJECTED
+    //    (post-prefix). Unknown keys surface as `unknownMcpTools` UNLESS
+    //    the override targets a tool on an MCP that is unreachable (or
+    //    a non-projecting sdk-transport MCP) — in which case the tool
+    //    can never have been projected and flagging it would defeat the
+    //    `unavailability: 'warn'` graceful-degradation contract. Silently
+    //    skip those — there's no tool to override; the unreachable
+    //    diagnostic / warn-policy log already conveys the absence.
+    const unreachableMcpsSet = new Set(unreachableMcps);
+    if (input.mcpToolOverrides !== undefined) {
+        for (const [projectedName, override] of Object.entries(input.mcpToolOverrides)) {
+            const existing = projected.get(projectedName);
+            if (existing === undefined) {
+                if (overrideTargetsNonProjectingMcp(projectedName, unreachableMcpsSet, extraKnownMcps)) {
+                    // The override's MCP is unreachable or sdk-transport — skip
+                    // silently. The consumer's intent (frame this tool) is moot
+                    // when the tool itself isn't available; the warn-policy
+                    // log already documents the degradation.
+                    continue;
+                }
+                unknownMcpToolsRef.push(projectedName);
+                continue;
+            }
+            if (override.description === undefined)
+                continue;
+            projected.set(projectedName, {
+                type: 'function',
+                function: {
+                    ...existing.function,
+                    description: override.description,
+                },
+            });
+        }
+    }
+    // 3. Sort projected tools lexicographically by name — D17-9 prompt-cache
+    //    stability. Consumer-shipped tools (added in step 4) preserve
+    //    original insertion order.
+    const projectedSorted = [...projected.entries()].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0);
+    // 4. Merge consumer-shipped tools. Consumer-shipped escapes prefixing
+    //    (their name is verbatim) AND wins on name collision with a
+    //    projected tool. Final order: consumer-shipped (original order)
+    //    first, projected (sorted lex) for any name NOT in consumer set.
+    const consumerByName = new Map();
+    if (input.consumerTools !== undefined && input.consumerTools !== null) {
+        for (const tool of input.consumerTools) {
+            consumerByName.set(tool.function.name, tool);
+        }
+    }
+    const out = [];
+    if (input.consumerTools !== undefined && input.consumerTools !== null) {
+        for (const tool of input.consumerTools) {
+            out.push(tool);
+        }
+    }
+    for (const [name, tool] of projectedSorted) {
+        if (consumerByName.has(name))
+            continue;
+        out.push(tool);
+    }
+    return {
+        tools: out,
+        diagnostics: {
+            unknownMcps: dedupe(unknownMcps),
+            unknownMcpTools: dedupe(unknownMcpToolsRef),
+            unreachableMcps: dedupe(unreachableMcps),
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Internals
+// ---------------------------------------------------------------------------
+function applyAllowlist(entries, discoveredByMcp, registeredSet, prefixPolicy, projected, unknownMcps, unknownMcpTools) {
+    for (const entry of entries) {
+        const split = splitDotted(entry);
+        if (split === null) {
+            // Whole-MCP form. Must reference a registered MCP.
+            if (!registeredSet.has(entry)) {
+                unknownMcps.push(entry);
+                continue;
+            }
+            const tools = discoveredByMcp.get(entry);
+            // Tools absent = MCP is unreachable; surfaced separately via
+            // `unreachableMcps`. Skip the entry without recording a per-tool
+            // miss — the caller's policy decision lives on the unreachable
+            // bucket, not here.
+            if (tools === undefined)
+                continue;
+            const prefixOn = readPrefixPolicy(prefixPolicy, entry);
+            for (const tool of tools) {
+                const projectedName = prefixOn ? `${entry}.${tool.name}` : tool.name;
+                projected.set(projectedName, toFunctionToolDef(projectedName, tool));
+            }
+        }
+        else {
+            // Specific-tool form (`<mcp>.<tool>`).
+            const { mcpName, toolName } = split;
+            if (!registeredSet.has(mcpName)) {
+                unknownMcps.push(mcpName);
+                continue;
+            }
+            const tools = discoveredByMcp.get(mcpName);
+            if (tools === undefined)
+                continue; // unreachable — caller policy
+            const match = tools.find((t) => t.name === toolName);
+            if (match === undefined) {
+                unknownMcpTools.push(entry);
+                continue;
+            }
+            const prefixOn = readPrefixPolicy(prefixPolicy, mcpName);
+            const projectedName = prefixOn ? `${mcpName}.${toolName}` : toolName;
+            projected.set(projectedName, toFunctionToolDef(projectedName, match));
+        }
+    }
+}
+function applyBlocklist(entries, discoveredByMcp, registeredSet, prefixPolicy, projected, unknownMcps, unknownMcpTools) {
+    for (const entry of entries) {
+        const split = splitDotted(entry);
+        if (split === null) {
+            // Whole-MCP block — remove every projected tool whose MCP matches.
+            if (!registeredSet.has(entry)) {
+                unknownMcps.push(entry);
+                continue;
+            }
+            const prefixOn = readPrefixPolicy(prefixPolicy, entry);
+            const tools = discoveredByMcp.get(entry);
+            if (tools === undefined)
+                continue;
+            for (const tool of tools) {
+                const projectedName = prefixOn ? `${entry}.${tool.name}` : tool.name;
+                projected.delete(projectedName);
+            }
+        }
+        else {
+            const { mcpName, toolName } = split;
+            if (!registeredSet.has(mcpName)) {
+                unknownMcps.push(mcpName);
+                continue;
+            }
+            const tools = discoveredByMcp.get(mcpName);
+            if (tools === undefined)
+                continue;
+            const match = tools.find((t) => t.name === toolName);
+            if (match === undefined) {
+                unknownMcpTools.push(entry);
+                continue;
+            }
+            const prefixOn = readPrefixPolicy(prefixPolicy, mcpName);
+            const projectedName = prefixOn ? `${mcpName}.${toolName}` : toolName;
+            projected.delete(projectedName);
+        }
+    }
+}
+/**
+ * Build the set of MCP names the selector explicitly *references* —
+ * the scope that governs the `unreachableMcps` diagnostic. Semantics:
+ * fail only for what the consumer's selector depends on.
+ *
+ *   - Shape A (string[]) — bare names + the MCP part of dotted entries
+ *     all count as references.
+ *   - Shape B allowlist — same scope. Blocklist entries do NOT count
+ *     (consumer is trying to exclude; if absent, intent fulfilled).
+ *   - Shape B blocklist-only (no allowlist) — no references. Effective
+ *     surface is "every reachable tool minus blocks"; unreachable MCPs
+ *     are silently omitted from the full-surface seed.
+ *   - Shape C callback — no references. The callback runs across the
+ *     discovered surface; consumer didn't name specific MCPs.
+ *   - Undefined selector — no references (no projection runs).
+ */
+function collectReferencedMcps(selector) {
+    const out = new Set();
+    if (selector === undefined)
+        return out;
+    if (typeof selector === 'function')
+        return out;
+    if (Array.isArray(selector)) {
+        for (const entry of selector) {
+            const split = splitDotted(entry);
+            out.add(split === null ? entry : split.mcpName);
+        }
+        return out;
+    }
+    const ab = selector;
+    if (ab.allowlist !== undefined) {
+        for (const entry of ab.allowlist) {
+            const split = splitDotted(entry);
+            out.add(split === null ? entry : split.mcpName);
+        }
+    }
+    // Blocklist entries deliberately NOT added — see docblock.
+    return out;
+}
+/**
+ * Decide whether a `mcpToolOverrides` key whose tool isn't in the
+ * projected set is safe to silently skip (vs flag as
+ * `unknownMcpTools`). The key is parsed for an `<mcp>.<tool>` prefix;
+ * if the prefix matches an MCP that is unreachable OR a known
+ * non-projecting sdk-transport MCP, the override target was never
+ * projectable — silent skip preserves the `unavailability: 'warn'`
+ * graceful-degradation contract and matches the "ship sdk-transport
+ * MCP tools via consumer tools[]" model.
+ *
+ * Keys without a dot belong to prefix-off MCPs whose owning MCP can't
+ * be inferred from the key alone; those still flag as unknownMcpTools
+ * to preserve drift detection for the prefix-off case.
+ */
+function overrideTargetsNonProjectingMcp(projectedName, unreachableMcps, extraKnownMcps) {
+    const split = splitDotted(projectedName);
+    if (split === null)
+        return false;
+    const owningMcp = split.mcpName;
+    return unreachableMcps.has(owningMcp) || extraKnownMcps.has(owningMcp);
+}
+/** Parse `<mcp>.<tool>` — returns `null` for entries without a dot. */
+function splitDotted(entry) {
+    const idx = entry.indexOf('.');
+    if (idx <= 0)
+        return null;
+    const mcpName = entry.slice(0, idx);
+    const toolName = entry.slice(idx + 1);
+    if (toolName.length === 0)
+        return null;
+    return { mcpName, toolName };
+}
+function readPrefixPolicy(prefixPolicy, mcpName) {
+    const stored = prefixPolicy.get(mcpName);
+    return stored === undefined ? true : stored;
+}
+function toDiscovered(mcpName, entry) {
+    const inputSchema = entry.inputSchema !== undefined
+        ? entry.inputSchema
+        : EMPTY_OBJECT_SCHEMA;
+    const out = {
+        mcpName,
+        name: entry.name,
+        inputSchema,
+    };
+    if (entry.description !== undefined)
+        out.description = entry.description;
+    if (entry.outputSchema !== undefined) {
+        out.outputSchema = entry.outputSchema;
+    }
+    if (entry.annotations !== undefined) {
+        out.annotations = entry.annotations;
+    }
+    return out;
+}
+function toFunctionToolDef(projectedName, tool) {
+    const fn = {
+        name: projectedName,
+        parameters: tool.inputSchema,
+    };
+    if (tool.description !== undefined)
+        fn.description = tool.description;
+    if (tool.annotations !== undefined)
+        fn.annotations = tool.annotations;
+    return { type: 'function', function: fn };
+}
+function dedupe(arr) {
+    if (arr.length <= 1)
+        return arr;
+    const seen = new Set();
+    const out = [];
+    for (const item of arr) {
+        if (seen.has(item))
+            continue;
+        seen.add(item);
+        out.push(item);
+    }
+    return out;
+}
+/**
+ * Default `inputSchema` for MCPs that didn't ship one. Matches the
+ * upstream MCP SDK fallback — `{ type: 'object' }` accepts any args.
+ * Kept as a frozen constant so the projection doesn't allocate per-call
+ * when most tools have proper schemas.
+ */
+const EMPTY_OBJECT_SCHEMA = Object.freeze({ type: 'object' });
+/**
+ * Shared empty set used as the default for the optional `extraKnownMcps`
+ * parameter so the common no-sdk-transport call path doesn't allocate.
+ */
+const EMPTY_KNOWN_SET = new Set();
+//# sourceMappingURL=projection.js.map

package/dist/client/mcp/projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.js","sourceRoot":"","sources":["../../../src/client/mcp/projection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAyCH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAsB,EACtB,IAAmB,EACnB,YAA0C,EAC1C,iBAAsC,eAAe;IAErD,qEAAqE;IACrE,qEAAqE;IACrE,oEAAoE;IACpE,oEAAoE;IACpE,MAAM,UAAU,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;IAC9C,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IAC1C,uEAAuE;IACvE,uDAAuD;IACvD,KAAK,MAAM,IAAI,IAAI,cAAc;QAAE,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC3D,MAAM,eAAe,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;IAClD,MAAM,cAAc,GAAG,qBAAqB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAE7D,sEAAsE;IACtE,oEAAoE;IACpE,kEAAkE;IAClE,oEAAoE;IACpE,oEAAoE;IACpE,mEAAmE;IACnE,6CAA6C;IAC7C,MAAM,eAAe,GAAG,IAAI,GAAG,EAAwC,CAAC;IACxE,MAAM,eAAe,GAAa,EAAE,CAAC;IACrC,KAAK,MAAM,OAAO,IAAI,UAAU,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,IAAI,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBAChC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAChC,CAAC;YACD,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAwB,EAAE,CAAC;QACtC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;QAC3C,CAAC;QACD,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,uEAAuE;IACvE,kEAAkE;IAClE,6BAA6B;IAC7B,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,kBAAkB,GAAa,EAAE,CAAC;IACxC,MAAM,SAAS,GAAG,IAAI,GAAG,EAA2B,CAAC;IAErD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IAChC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;YACnC,yDAAyD;YACzD,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,eAAe,EAAE,CAAC;gBAC/C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;gBACzD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,IAAK,QAAmC,CAAC,IAAI,CAAC,EAAE,CAAC;wBAC/C,MAAM,aAAa,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;wBACvE,SAAS,CAAC,GAAG,CAAC,aAAa,EAAE,iBAAiB,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC,CAAC;oBACvE,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACnC,4EAA4E;YAC5E,MAAM,GAAG,GAAG,QAA6B,CAAC;YAC1C,cAAc,CACZ,GAAG,EACH,eAAe,EACf,aAAa,EACb,YAAY,EACZ,SAAS,EACT,WAAW,EACX,kBAAkB,CACnB,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,mCAAmC;YACnC,MAAM,EAAE,GAAG,QAAsC,CAAC;YAClD,IAAI,EAAE,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC/B,cAAc,CACZ,EAAE,CAAC,SAAS,EACZ,eAAe,EACf,aAAa,EACb,YAAY,EACZ,SAAS,EACT,WAAW,EACX,kBAAkB,CACnB,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,yDAAyD;gBACzD,8DAA8D;gBAC9D,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,eAAe,EAAE,CAAC;oBAC/C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;oBACzD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;wBACzB,MAAM,aAAa,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;wBACvE,SAAS,CAAC,GAAG,CAAC,aAAa,EAAE,iBAAiB,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC,CAAC;oBACvE,CAAC;gBACH,CAAC;YACH,CAAC;YACD,IAAI,EAAE,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC/B,cAAc,CACZ,EAAE,CAAC,SAAS,EACZ,eAAe,EACf,aAAa,EACb,YAAY,EACZ,SAAS,EACT,WAAW,EACX,kBAAkB,CACnB,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,kEAAkE;IAClE,qEAAqE;IACrE,mEAAmE;IACnE,kEAAkE;IAClE,oEAAoE;IACpE,sEAAsE;IACtE,+DAA+D;IAC/D,+DAA+D;IAC/D,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,CAAC;IACpD,IAAI,KAAK,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACzC,KAAK,MAAM,CAAC,aAAa,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAC/E,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YAC9C,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,IAAI,+BAA+B,CAAC,aAAa,EAAE,kBAAkB,EAAE,cAAc,CAAC,EAAE,CAAC;oBACvF,4DAA4D;oBAC5D,4DAA4D;oBAC5D,wDAAwD;oBACxD,yCAAyC;oBACzC,SAAS;gBACX,CAAC;gBACD,kBAAkB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;gBACvC,SAAS;YACX,CAAC;YACD,IAAI,QAAQ,CAAC,WAAW,KAAK,SAAS;gBAAE,SAAS;YACjD,SAAS,CAAC,GAAG,CAAC,aAAa,EAAE;gBAC3B,IAAI,EAAE,UAAU;gBAChB,QAAQ,EAAE;oBACR,GAAG,QAAQ,CAAC,QAAQ;oBACpB,WAAW,EAAE,QAAQ,CAAC,WAAW;iBAClC;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,yEAAyE;IACzE,kEAAkE;IAClE,+BAA+B;IAC/B,MAAM,eAAe,GAAG,CAAC,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CACjE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAC3B,CAAC;IAEF,sEAAsE;IACtE,gEAAgE;IAChE,oEAAoE;IACpE,qEAAqE;IACrE,MAAM,cAAc,GAAG,IAAI,GAAG,EAA2B,CAAC;IAC1D,IAAI,KAAK,CAAC,aAAa,KAAK,SAAS,IAAI,KAAK,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;QACtE,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;YACvC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAAsB,EAAE,CAAC;IAClC,IAAI,KAAK,CAAC,aAAa,KAAK,SAAS,IAAI,KAAK,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;QACtE,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;YACvC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,eAAe,EAAE,CAAC;QAC3C,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QACvC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IAED,OAAO;QACL,KAAK,EAAE,GAAG;QACV,WAAW,EAAE;YACX,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC;YAChC,eAAe,EAAE,MAAM,CAAC,kBAAkB,CAAC;YAC3C,eAAe,EAAE,MAAM,CAAC,eAAe,CAAC;SACzC;KACF,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,SAAS,cAAc,CACrB,OAA0B,EAC1B,eAAkE,EAClE,aAAkC,EAClC,YAA0C,EAC1C,SAAuC,EACvC,WAAqB,EACrB,eAAyB;IAEzB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,mDAAmD;YACnD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9B,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACxB,SAAS;YACX,CAAC;YACD,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACzC,6DAA6D;YAC7D,iEAAiE;YACjE,+DAA+D;YAC/D,oBAAoB;YACpB,IAAI,KAAK,KAAK,SAAS;gBAAE,SAAS;YAClC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;YACvD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,aAAa,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;gBACrE,SAAS,CAAC,GAAG,CAAC,aAAa,EAAE,iBAAiB,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC,CAAC;YACvE,CAAC;QACH,CAAC;aAAM,CAAC;YACN,uCAAuC;YACvC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;YACpC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBAChC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC1B,SAAS;YACX,CAAC;YACD,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC3C,IAAI,KAAK,KAAK,SAAS;gBAAE,SAAS,CAAC,8BAA8B;YACjE,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;YACrD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC5B,SAAS;YACX,CAAC;YACD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACzD,MAAM,aAAa,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;YACrE,SAAS,CAAC,GAAG,CAAC,aAAa,EAAE,iBAAiB,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CACrB,OAA0B,EAC1B,eAAkE,EAClE,aAAkC,EAClC,YAA0C,EAC1C,SAAuC,EACvC,WAAqB,EACrB,eAAyB;IAEzB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,mEAAmE;YACnE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9B,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACxB,SAAS;YACX,CAAC;YACD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;YACvD,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACzC,IAAI,KAAK,KAAK,SAAS;gBAAE,SAAS;YAClC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,aAAa,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;gBACrE,SAAS,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;YACpC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBAChC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC1B,SAAS;YACX,CAAC;YACD,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC3C,IAAI,KAAK,KAAK,SAAS;gBAAE,SAAS;YAClC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;YACrD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC5B,SAAS;YACX,CAAC;YACD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACzD,MAAM,aAAa,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;YACrE,SAAS,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,SAAS,qBAAqB,CAC5B,QAAsC;IAEtC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IACvC,IAAI,OAAO,QAAQ,KAAK,UAAU;QAAE,OAAO,GAAG,CAAC;IAC/C,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,KAAK,MAAM,KAAK,IAAI,QAA6B,EAAE,CAAC;YAClD,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;YACjC,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,MAAM,EAAE,GAAG,QAAsC,CAAC;IAClD,IAAI,EAAE,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAC/B,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,SAAS,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;YACjC,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IACD,2DAA2D;IAC3D,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAS,+BAA+B,CACtC,aAAqB,EACrB,eAAoC,EACpC,cAAmC;IAEnC,MAAM,KAAK,GAAG,WAAW,CAAC,aAAa,CAAC,CAAC;IACzC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACjC,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC;IAChC,OAAO,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AACzE,CAAC;AAED,uEAAuE;AACvE,SAAS,WAAW,CAClB,KAAa;IAEb,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1B,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IACtC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC/B,CAAC;AAED,SAAS,gBAAgB,CACvB,YAA0C,EAC1C,OAAe;IAEf,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACzC,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;AAC9C,CAAC;AAED,SAAS,YAAY,CACnB,OAAe,EACf,KAAoB;IAEpB,MAAM,WAAW,GACf,KAAK,CAAC,WAAW,KAAK,SAAS;QAC7B,CAAC,CAAE,KAAK,CAAC,WAA0B;QACnC,CAAC,CAAC,mBAAmB,CAAC;IAC1B,MAAM,GAAG,GAEL;QACF,OAAO;QACP,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW;KACZ,CAAC;IACF,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS;QAAE,GAAG,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IACzE,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACrC,GAAG,CAAC,YAAY,GAAG,KAAK,CAAC,YAA0B,CAAC;IACtD,CAAC;IACD,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACpC,GAAG,CAAC,WAAW,GAAG,KAAK,CAAC,WAAiC,CAAC;IAC5D,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,iBAAiB,CACxB,aAAqB,EACrB,IAAuB;IAEvB,MAAM,EAAE,GAEJ;QACF,IAAI,EAAE,aAAa;QACnB,UAAU,EAAE,IAAI,CAAC,WAAW;KAC7B,CAAC;IACF,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;QAAE,EAAE,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IACtE,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;QAAE,EAAE,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IACtE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;AAC5C,CAAC;AAED,SAAS,MAAM,CAAC,GAAsB;IACpC,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,GAAG,CAAC;IAChC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,IAAI,IAAI,GAAG,EAAE,CAAC;QACvB,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QAC7B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACf,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,mBAAmB,GAAe,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAe,CAAC;AAExF;;;GAGG;AACH,MAAM,eAAe,GAAwB,IAAI,GAAG,EAAE,CAAC"}

package/dist/client/mcp/substituteEnv.browser.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Browser stub for `substituteEnv.ts`. `process.env` doesn't exist in
+ * the browser globals; the SDK's remote-MCP feature is a server-side
+ * concern (subprocess + arbitrary fetch authority), so the browser
+ * bundle reaches this code only via the McpClientPool import chain —
+ * never to actually substitute anything.
+ *
+ * Returns the input verbatim. If a browser consumer ever wires a remote
+ * MCP, the {@link McpClientPool} browser stub rejects the register call
+ * before this helper is reached.
+ */
+export declare function substituteEnvInString(value: string): string;
+export declare function substituteEnvInHeaders(headers: {
+    readonly [key: string]: string;
+} | undefined): {
+    [key: string]: string;
+} | undefined;
+//# sourceMappingURL=substituteEnv.browser.d.ts.map

package/dist/client/mcp/substituteEnv.browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"substituteEnv.browser.d.ts","sourceRoot":"","sources":["../../../src/client/mcp/substituteEnv.browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GAAG,SAAS,GACtD;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GAAG,SAAS,CAGvC"}

package/dist/client/mcp/substituteEnv.browser.js

@@ -0,0 +1,20 @@
+/**
+ * Browser stub for `substituteEnv.ts`. `process.env` doesn't exist in
+ * the browser globals; the SDK's remote-MCP feature is a server-side
+ * concern (subprocess + arbitrary fetch authority), so the browser
+ * bundle reaches this code only via the McpClientPool import chain —
+ * never to actually substitute anything.
+ *
+ * Returns the input verbatim. If a browser consumer ever wires a remote
+ * MCP, the {@link McpClientPool} browser stub rejects the register call
+ * before this helper is reached.
+ */
+export function substituteEnvInString(value) {
+    return value;
+}
+export function substituteEnvInHeaders(headers) {
+    if (headers === undefined)
+        return undefined;
+    return { ...headers };
+}
+//# sourceMappingURL=substituteEnv.browser.js.map

package/dist/client/mcp/substituteEnv.browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"substituteEnv.browser.js","sourceRoot":"","sources":["../../../src/client/mcp/substituteEnv.browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,OAAuD;IAEvD,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC5C,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;AACxB,CAAC"}