@cyanheads/mcp-ts-core 0.12.0 → 0.12.2

package/dist/mcp-server/tools/tool-registration.d.ts

@@ -2,7 +2,7 @@
  * @fileoverview Encapsulates the registration of all tool definitions with an McpServer.
  * @module src/mcp-server/tools/tool-registration
  */
-import type { McpServer } from '@modelcontextprotocol/server';
+import type { McpServer, ServerNotifier } from '@modelcontextprotocol/server';
 import type { ResourceSubscriptions } from '../../mcp-server/notifications.js';
 import type { AnyToolDefinition } from '../../mcp-server/tools/utils/toolDefinition.js';
 import { type HandlerFactoryServices } from '../../mcp-server/tools/utils/toolHandlerFactory.js';
@@ -20,7 +20,7 @@ export declare class ToolRegistry {
     private readonly registeredNames;
     constructor(toolDefs: AnyToolDef[], services?: HandlerFactoryServices | undefined);
     /** Registers all tool definitions with the provided McpServer instance. */
-    registerAll(server: McpServer, subscriptions?: ResourceSubscriptions): Promise<void>;
+    registerAll(server: McpServer, subscriptions?: ResourceSubscriptions, bus?: ServerNotifier): Promise<void>;
     /** Throws at startup if a tool with the same name was already registered. */
     private assertUniqueName;
     private deriveTitleFromName;

package/dist/mcp-server/tools/tool-registration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-registration.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/tool-registration.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,SAAS,EAAgB,MAAM,8BAA8B,CAAC;AAE5E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAE3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AACpF,OAAO,EAGL,KAAK,sBAAsB,EAE5B,MAAM,gDAAgD,CAAC;AAMxD;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,iBAAiB,CAAC;AAE3C,qBAAa,YAAY;IAKrB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,QAAQ,CAAC;IALnB,oEAAoE;IACpE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IAErD,YACU,QAAQ,EAAE,UAAU,EAAE,EACtB,QAAQ,CAAC,EAAE,sBAAsB,YAAA,EACvC;IAEJ,2EAA2E;IAC9D,WAAW,CACtB,MAAM,EAAE,SAAS,EACjB,aAAa,CAAC,EAAE,qBAAqB,GACpC,OAAO,CAAC,IAAI,CAAC,CA6Cf;IAED,6EAA6E;IAC7E,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,mBAAmB;IAI3B;;;OAGG;YACW,YAAY;CAiD3B"}
+{"version":3,"file":"tool-registration.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/tool-registration.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAgB,MAAM,8BAA8B,CAAC;AAE5F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAE3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AACpF,OAAO,EAGL,KAAK,sBAAsB,EAE5B,MAAM,gDAAgD,CAAC;AAMxD;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,iBAAiB,CAAC;AAE3C,qBAAa,YAAY;IAKrB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,QAAQ,CAAC;IALnB,oEAAoE;IACpE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IAErD,YACU,QAAQ,EAAE,UAAU,EAAE,EACtB,QAAQ,CAAC,EAAE,sBAAsB,YAAA,EACvC;IAEJ,2EAA2E;IAC9D,WAAW,CACtB,MAAM,EAAE,SAAS,EACjB,aAAa,CAAC,EAAE,qBAAqB,EACrC,GAAG,CAAC,EAAE,cAAc,GACnB,OAAO,CAAC,IAAI,CAAC,CA8Cf;IAED,6EAA6E;IAC7E,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,mBAAmB;IAI3B;;;OAGG;YACW,YAAY;CAiD3B"}

package/dist/mcp-server/tools/tool-registration.js

@@ -14,7 +14,7 @@ export class ToolRegistry {
         this.services = services;
     }
     /** Registers all tool definitions with the provided McpServer instance. */
-    async registerAll(server, subscriptions) {
+    async registerAll(server, subscriptions, bus) {
         // Reset per-server uniqueness tracking — registries are shared across
         // per-request McpServer instances under HTTP serving.
         this.registeredNames.clear();
@@ -27,6 +27,7 @@ export class ToolRegistry {
             notifyResourceListChanged: () => server.sendResourceListChanged(),
             notifyToolListChanged: () => server.sendToolListChanged(),
             ...(subscriptions && { subscriptions }),
+            ...(bus && { bus }),
         };
         const context = requestContextService.createRequestContext({
             operation: 'ToolRegistry.registerAll',

package/dist/mcp-server/tools/tool-registration.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-registration.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/tool-registration.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tool-registration.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/tool-registration.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/utils/headerParam.d.ts

@@ -0,0 +1,113 @@
+/**
+ * @fileoverview `x-mcp-header` input designation (protocol revision 2026-07-28).
+ *
+ * A tool may designate an input property with `x-mcp-header: "<Name>"`, which
+ * makes the value ride an `Mcp-Param-<Name>` request header alongside the
+ * JSON-RPC body so an intermediary can read it without parsing the body. It is
+ * a mirroring/attestation mechanism, not a relocation: when the body carries a
+ * value for a designated property the matching header MUST be present and
+ * decode equal, and the handler still reads its argument from the body.
+ *
+ * `headerParam()` attaches the annotation via Zod `.meta()`, which passes
+ * through to the emitted JSON Schema verbatim — the emission seam needs no
+ * interception.
+ *
+ * The spec places five constraints on a declaration, and the SDK enforces them
+ * with a `console.warn` rather than a rejection: an invalid declaration still
+ * registers and the tool is then silently dropped by conforming Streamable HTTP
+ * clients. {@link assertHeaderDesignations} runs the same scan at definition
+ * time so the failure is a loud startup error instead. To stay in lockstep with
+ * the runtime it targets, the scan here evaluates the *emitted JSON Schema*
+ * — the same bytes the SDK scans — rather than Zod internals, and mirrors the
+ * SDK's checks, their order, and its first-fault-wins short-circuit.
+ *
+ * @module src/mcp-server/tools/utils/headerParam
+ */
+import type { ZodType } from 'zod';
+/** The JSON Schema extension key a designated input property carries. */
+export declare const X_MCP_HEADER_KEY = "x-mcp-header";
+/**
+ * One step of the walk from the schema root to a designation: a `properties`
+ * key, or a descent through a subschema keyword (`label` names the branch when
+ * the keyword carries several).
+ */
+export type DesignationStep = {
+    readonly key: string;
+    readonly kind: 'property';
+} | {
+    readonly keyword: string;
+    readonly kind: 'branch';
+    readonly label?: number | string;
+};
+/** A validated `x-mcp-header` designation found on an emitted input schema. */
+export interface HeaderDesignation {
+    /** The declared header name — the wire header is `Mcp-Param-<headerName>`. */
+    readonly headerName: string;
+    /** Path from the schema root to the designated property. */
+    readonly path: readonly DesignationStep[];
+    /** The property's emitted JSON Schema `type`. */
+    readonly type: string;
+}
+/**
+ * Outcome of scanning an emitted input schema. Invalid carries the first
+ * violated constraint and where it was found — the SDK stops at the first
+ * fault too, so reporting more would be a divergence, not a courtesy.
+ */
+export type HeaderDesignationScan = {
+    readonly designations: readonly HeaderDesignation[];
+    readonly valid: true;
+} | {
+    readonly path: readonly DesignationStep[];
+    readonly reason: string;
+    readonly valid: false;
+};
+/**
+ * Designates a tool input property as an `x-mcp-header` parameter.
+ *
+ * The emitted property carries `"x-mcp-header": "<headerName>"` and nothing
+ * else about the field changes — description, type, validation, and
+ * requiredness are untouched. The wire header is `Mcp-Param-<headerName>`.
+ *
+ * Returns the same schema type, so it composes in either direction:
+ * `headerParam(z.string(), 'Region').describe('…')` and
+ * `headerParam(z.string().describe('…'), 'Region')` are equivalent.
+ *
+ * Only a primitive-typed property statically reachable through a chain of
+ * `properties` keys may be designated; {@link assertHeaderDesignations} — run
+ * by `tool()` — rejects anything else at definition time.
+ *
+ * @example
+ * ```ts
+ * input: z.object({
+ *   region: headerParam(z.string(), 'Region').describe('Deployment region.'),
+ * })
+ * ```
+ */
+export declare function headerParam<TSchema extends ZodType>(schema: TSchema, headerName: string): TSchema;
+/**
+ * Scans a tool's input root for `x-mcp-header` declarations and validates every
+ * constraint the spec places on them.
+ *
+ * Evaluates the *emitted JSON Schema* — the same bytes the SDK scans — so a
+ * verdict here is the SDK's verdict. Returns `undefined` when the schema cannot
+ * be converted to JSON Schema at all: that is `schema-serializable`'s finding
+ * and a hard SDK failure at registration, and the SDK swallows the same
+ * conversion error around its own scan rather than reporting it twice.
+ *
+ * The walk descends `properties` at any depth (the spec's "any nesting depth"
+ * clause) and visits every excluded position too, with reachability cleared, so
+ * a designation found there fails rather than being missed.
+ */
+export declare function scanHeaderDesignations(input: unknown): HeaderDesignationScan | undefined;
+/**
+ * Renders a designation path in the linter's path vocabulary — `.key` for a
+ * property, `[]`/`[i]` for array positions, `|i` for a composition branch,
+ * `.<key>` for an `additionalProperties` value, `.<keyword>` for anything else.
+ */
+export declare function formatDesignationPath(path: readonly DesignationStep[], root: string): string;
+/**
+ * Throws when a tool's input schema carries an invalid `x-mcp-header`
+ * designation, naming the field path and the violated constraint.
+ */
+export declare function assertHeaderDesignations(toolName: string, input: unknown): void;
+//# sourceMappingURL=headerParam.d.ts.map

package/dist/mcp-server/tools/utils/headerParam.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headerParam.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/headerParam.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAKnC,yEAAyE;AACzE,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAwD/C;;;;GAIG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GACnD;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAAC;AAE5F,+EAA+E;AAC/E,MAAM,WAAW,iBAAiB;IAChC,8EAA8E;IAC9E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,CAAC;IAC1C,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAC7B;IAAE,QAAQ,CAAC,YAAY,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAA;CAAE,GAC7E;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAElG;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,WAAW,CAAC,OAAO,SAAS,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAEjG;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,qBAAqB,GAAG,SAAS,CAIxF;AAqGD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5F;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAe/E"}

package/dist/mcp-server/tools/utils/headerParam.js

@@ -0,0 +1,280 @@
+/**
+ * @fileoverview `x-mcp-header` input designation (protocol revision 2026-07-28).
+ *
+ * A tool may designate an input property with `x-mcp-header: "<Name>"`, which
+ * makes the value ride an `Mcp-Param-<Name>` request header alongside the
+ * JSON-RPC body so an intermediary can read it without parsing the body. It is
+ * a mirroring/attestation mechanism, not a relocation: when the body carries a
+ * value for a designated property the matching header MUST be present and
+ * decode equal, and the handler still reads its argument from the body.
+ *
+ * `headerParam()` attaches the annotation via Zod `.meta()`, which passes
+ * through to the emitted JSON Schema verbatim — the emission seam needs no
+ * interception.
+ *
+ * The spec places five constraints on a declaration, and the SDK enforces them
+ * with a `console.warn` rather than a rejection: an invalid declaration still
+ * registers and the tool is then silently dropped by conforming Streamable HTTP
+ * clients. {@link assertHeaderDesignations} runs the same scan at definition
+ * time so the failure is a loud startup error instead. To stay in lockstep with
+ * the runtime it targets, the scan here evaluates the *emitted JSON Schema*
+ * — the same bytes the SDK scans — rather than Zod internals, and mirrors the
+ * SDK's checks, their order, and its first-fault-wins short-circuit.
+ *
+ * @module src/mcp-server/tools/utils/headerParam
+ */
+import { toJSONSchema } from 'zod/v4/core';
+import { isDiscriminatedUnionSchema } from './schemaShape.js';
+/** The JSON Schema extension key a designated input property carries. */
+export const X_MCP_HEADER_KEY = 'x-mcp-header';
+/**
+ * RFC 9110 §5.1 `token` syntax (`1*tchar`). Rejects empty, space, control
+ * characters (including CR/LF), and the HTTP delimiters.
+ */
+const RFC9110_TOKEN = /^[!#$%&'*+\-.^_`|~0-9A-Za-z]+$/;
+/**
+ * Emitted `type` values a designation may sit on.
+ *
+ * The spec names `string`, `integer`, and `boolean`; the SDK release this
+ * framework targets also accepts `number` (its own source comment tracks the
+ * discrepancy against the conformance referee). Matching the runtime is the
+ * point of this scan — a rule that hard-rejected `number` would fail a
+ * declaration the SDK accepts.
+ */
+const PERMITTED_TYPES = new Set(['boolean', 'integer', 'number', 'string']);
+/**
+ * JSON Schema keywords the static-reachability constraint excludes from the
+ * `properties`-only chain. A designation found under any of them invalidates
+ * the whole tool definition, so the walk visits them specifically to fail them.
+ */
+const NON_REACHABLE_SUBSCHEMA_KEYWORDS = [
+    'items',
+    'prefixItems',
+    'contains',
+    'additionalProperties',
+    'unevaluatedProperties',
+    'unevaluatedItems',
+    'propertyNames',
+    'patternProperties',
+    'dependentSchemas',
+    'oneOf',
+    'anyOf',
+    'allOf',
+    'not',
+    'if',
+    'then',
+    'else',
+    '$defs',
+    'definitions',
+];
+/**
+ * Subschema-carrying keywords whose value is a `name → subschema` map rather
+ * than a single subschema or an array of them.
+ */
+const OBJECT_VALUED_SUBSCHEMA_KEYWORDS = new Set([
+    'patternProperties',
+    'dependentSchemas',
+    '$defs',
+    'definitions',
+]);
+/**
+ * Designates a tool input property as an `x-mcp-header` parameter.
+ *
+ * The emitted property carries `"x-mcp-header": "<headerName>"` and nothing
+ * else about the field changes — description, type, validation, and
+ * requiredness are untouched. The wire header is `Mcp-Param-<headerName>`.
+ *
+ * Returns the same schema type, so it composes in either direction:
+ * `headerParam(z.string(), 'Region').describe('…')` and
+ * `headerParam(z.string().describe('…'), 'Region')` are equivalent.
+ *
+ * Only a primitive-typed property statically reachable through a chain of
+ * `properties` keys may be designated; {@link assertHeaderDesignations} — run
+ * by `tool()` — rejects anything else at definition time.
+ *
+ * @example
+ * ```ts
+ * input: z.object({
+ *   region: headerParam(z.string(), 'Region').describe('Deployment region.'),
+ * })
+ * ```
+ */
+export function headerParam(schema, headerName) {
+    return schema.meta({ [X_MCP_HEADER_KEY]: headerName });
+}
+/**
+ * Scans a tool's input root for `x-mcp-header` declarations and validates every
+ * constraint the spec places on them.
+ *
+ * Evaluates the *emitted JSON Schema* — the same bytes the SDK scans — so a
+ * verdict here is the SDK's verdict. Returns `undefined` when the schema cannot
+ * be converted to JSON Schema at all: that is `schema-serializable`'s finding
+ * and a hard SDK failure at registration, and the SDK swallows the same
+ * conversion error around its own scan rather than reporting it twice.
+ *
+ * The walk descends `properties` at any depth (the spec's "any nesting depth"
+ * clause) and visits every excluded position too, with reachability cleared, so
+ * a designation found there fails rather than being missed.
+ */
+export function scanHeaderDesignations(input) {
+    const inputSchema = emitInputJsonSchema(input);
+    if (inputSchema === undefined)
+        return undefined;
+    return scanEmitted(inputSchema);
+}
+/** The constraint walk itself, over an already-emitted JSON Schema. */
+function scanEmitted(inputSchema) {
+    const designations = [];
+    const seenLower = new Map();
+    const validateDeclaration = (schema, path, reachable) => {
+        if (!reachable || path.length === 0) {
+            return {
+                path,
+                reason: 'x-mcp-header is only permitted on a property statically reachable through a chain of ' +
+                    "'properties' keys — never on the schema root, and never under items, " +
+                    'additionalProperties, oneOf/anyOf/allOf/not, if/then/else, patternProperties, ' +
+                    'dependentSchemas, propertyNames, or a $defs target.',
+            };
+        }
+        const raw = schema[X_MCP_HEADER_KEY];
+        if (typeof raw !== 'string' || raw.length === 0) {
+            return { path, reason: 'x-mcp-header must be a non-empty string.' };
+        }
+        if (!RFC9110_TOKEN.test(raw)) {
+            return {
+                path,
+                reason: `x-mcp-header '${raw}' is not a valid RFC 9110 token — no spaces, control ` +
+                    'characters, or HTTP delimiters.',
+            };
+        }
+        const type = typeof schema.type === 'string' ? schema.type : undefined;
+        if (type === undefined || !PERMITTED_TYPES.has(type)) {
+            return {
+                path,
+                reason: 'x-mcp-header is only permitted on a primitive-typed property (string, integer, ' +
+                    `number, boolean); this property emits type ${type ?? '<none>'}.`,
+            };
+        }
+        const lower = raw.toLowerCase();
+        const prior = seenLower.get(lower);
+        if (prior !== undefined) {
+            return {
+                path,
+                reason: `x-mcp-header '${raw}' is not case-insensitively unique — '${prior}' is already ` +
+                    'declared elsewhere in this schema.',
+            };
+        }
+        seenLower.set(lower, raw);
+        designations.push({ headerName: raw, path, type });
+        return undefined;
+    };
+    const visit = (node, path, reachable) => {
+        if (node === null || typeof node !== 'object')
+            return undefined;
+        const schema = node;
+        if (X_MCP_HEADER_KEY in schema) {
+            const fault = validateDeclaration(schema, path, reachable);
+            if (fault)
+                return fault;
+        }
+        const properties = schema.properties;
+        if (properties !== null && typeof properties === 'object') {
+            for (const [key, child] of Object.entries(properties)) {
+                const fault = visit(child, [...path, { key, kind: 'property' }], reachable);
+                if (fault)
+                    return fault;
+            }
+        }
+        for (const keyword of NON_REACHABLE_SUBSCHEMA_KEYWORDS) {
+            const sub = schema[keyword];
+            if (sub === undefined)
+                continue;
+            for (const [label, branch] of branchesOf(keyword, sub)) {
+                const step = label === undefined ? { keyword, kind: 'branch' } : { keyword, kind: 'branch', label };
+                const fault = visit(branch, [...path, step], false);
+                if (fault)
+                    return fault;
+            }
+        }
+        return undefined;
+    };
+    const fault = visit(inputSchema, [], true);
+    return fault ? { ...fault, valid: false } : { designations, valid: true };
+}
+/**
+ * Renders a designation path in the linter's path vocabulary — `.key` for a
+ * property, `[]`/`[i]` for array positions, `|i` for a composition branch,
+ * `.<key>` for an `additionalProperties` value, `.<keyword>` for anything else.
+ */
+export function formatDesignationPath(path, root) {
+    return path.reduce((rendered, step) => rendered + formatStep(step), root);
+}
+/**
+ * Throws when a tool's input schema carries an invalid `x-mcp-header`
+ * designation, naming the field path and the violated constraint.
+ */
+export function assertHeaderDesignations(toolName, input) {
+    const scan = scanHeaderDesignations(input);
+    if (scan === undefined || scan.valid)
+        return;
+    const unionNote = isDiscriminatedUnionSchema(input)
+        ? " A discriminated-union input root advertises 'oneOf' at the schema root, so every field " +
+            'lives inside a branch — no field of a union-input tool can be designated.'
+        : '';
+    throw new Error(`Tool '${toolName}' declares an invalid x-mcp-header designation at ` +
+        `${formatDesignationPath(scan.path, 'input')}: ${scan.reason}${unionNote} ` +
+        'The MCP SDK only warns about this and registers the tool anyway, leaving conforming ' +
+        'Streamable HTTP clients to drop it from tools/list — so it is rejected here instead.');
+}
+/**
+ * The JSON Schema the SDK scans for a tool's input: the `io: 'input'`
+ * draft-2020-12 conversion with `type: 'object'` stamped on the root (a
+ * discriminated union emits `oneOf` with no root `type`). Reproduced verbatim
+ * so the scanned bytes are the SDK's rather than a near-copy.
+ */
+function emitInputJsonSchema(input) {
+    try {
+        const emitted = toJSONSchema(input, {
+            io: 'input',
+            target: 'draft-2020-12',
+        });
+        return { type: 'object', ...emitted };
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * The subschemas a non-reachable keyword carries, each paired with the label
+ * that names it: an index for an array-valued keyword, a key for a map-valued
+ * one, `undefined` for a single subschema.
+ */
+function branchesOf(keyword, sub) {
+    if (Array.isArray(sub))
+        return sub.map((branch, index) => [index, branch]);
+    if (sub !== null && typeof sub === 'object' && OBJECT_VALUED_SUBSCHEMA_KEYWORDS.has(keyword)) {
+        return Object.entries(sub);
+    }
+    return [[undefined, sub]];
+}
+/** Renders one path step. See {@link formatDesignationPath}. */
+function formatStep(step) {
+    if (step.kind === 'property')
+        return `.${step.key}`;
+    switch (step.keyword) {
+        case 'allOf':
+        case 'anyOf':
+        case 'oneOf':
+            return `|${step.label}`;
+        case 'items':
+            return step.label === undefined ? '[]' : `[${step.label}]`;
+        case 'prefixItems':
+            return `[${step.label}]`;
+        case 'additionalProperties':
+        case 'unevaluatedProperties':
+            return '.<key>';
+        default:
+            return step.label === undefined ? `.<${step.keyword}>` : `.<${step.keyword}:${step.label}>`;
+    }
+}
+//# sourceMappingURL=headerParam.js.map

package/dist/mcp-server/tools/utils/headerParam.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"headerParam.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/headerParam.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/utils/schemaShape.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @fileoverview Runtime shape checks for the Zod roots a tool definition may
+ * declare. Zod 4 tags every schema with `_zod.def.type`, and a discriminated
+ * union tags as `'union'` like any other — the discriminator on its `def` is
+ * what separates the two. Kept in one place so the definition builder, the
+ * server manifest, and the linter agree on what a union root is.
+ * @module src/mcp-server/tools/utils/schemaShape
+ */
+import type { ZodDiscriminatedUnion, ZodObject, ZodRawShape } from 'zod';
+/** True when `value` is a `z.object()`. */
+export declare function isZodObjectSchema(value: unknown): value is ZodObject<ZodRawShape>;
+/**
+ * True when `value` is a `z.discriminatedUnion()`.
+ *
+ * A plain `z.union()` also tags as `'union'` but carries no `discriminator`, so
+ * the discriminator string is the distinguishing field. Only the discriminated
+ * form is accepted as a tool input root: a bare union gives the model no key to
+ * choose a branch by, and every variant's `required` list would apply at once.
+ */
+export declare function isDiscriminatedUnionSchema(value: unknown): value is ZodDiscriminatedUnion<readonly ZodObject<ZodRawShape>[]>;
+/**
+ * The object variants of a tool input root: the union's options, or the single
+ * object itself. Empty when the schema is neither — callers that lint or read
+ * shapes then have nothing to walk rather than a partial view.
+ */
+export declare function inputVariants(schema: unknown): readonly ZodObject<ZodRawShape>[];
+//# sourceMappingURL=schemaShape.d.ts.map

package/dist/mcp-server/tools/utils/schemaShape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaShape.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/schemaShape.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AAOzE,2CAA2C;AAC3C,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAAC,WAAW,CAAC,CAGjF;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,qBAAqB,CAAC,SAAS,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC,CAInE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,SAAS,CAAC,WAAW,CAAC,EAAE,CAQhF"}

package/dist/mcp-server/tools/utils/schemaShape.js

@@ -0,0 +1,43 @@
+/**
+ * @fileoverview Runtime shape checks for the Zod roots a tool definition may
+ * declare. Zod 4 tags every schema with `_zod.def.type`, and a discriminated
+ * union tags as `'union'` like any other — the discriminator on its `def` is
+ * what separates the two. Kept in one place so the definition builder, the
+ * server manifest, and the linter agree on what a union root is.
+ * @module src/mcp-server/tools/utils/schemaShape
+ */
+/** True when `value` is a `z.object()`. */
+export function isZodObjectSchema(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    return value._zod?.def?.type === 'object';
+}
+/**
+ * True when `value` is a `z.discriminatedUnion()`.
+ *
+ * A plain `z.union()` also tags as `'union'` but carries no `discriminator`, so
+ * the discriminator string is the distinguishing field. Only the discriminated
+ * form is accepted as a tool input root: a bare union gives the model no key to
+ * choose a branch by, and every variant's `required` list would apply at once.
+ */
+export function isDiscriminatedUnionSchema(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const def = value._zod?.def;
+    return def?.type === 'union' && typeof def.discriminator === 'string';
+}
+/**
+ * The object variants of a tool input root: the union's options, or the single
+ * object itself. Empty when the schema is neither — callers that lint or read
+ * shapes then have nothing to walk rather than a partial view.
+ */
+export function inputVariants(schema) {
+    if (isDiscriminatedUnionSchema(schema)) {
+        const options = schema.options;
+        return Array.isArray(options)
+            ? options.filter(isZodObjectSchema)
+            : [];
+    }
+    return isZodObjectSchema(schema) ? [schema] : [];
+}
+//# sourceMappingURL=schemaShape.js.map

package/dist/mcp-server/tools/utils/schemaShape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaShape.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/schemaShape.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,2CAA2C;AAC3C,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,OAAQ,KAAsB,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,KAAK,QAAQ,CAAC;AAC9D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,0BAA0B,CACxC,KAAc;IAEd,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,GAAG,GAAI,KAAsB,CAAC,IAAI,EAAE,GAAG,CAAC;IAC9C,OAAO,GAAG,EAAE,IAAI,KAAK,OAAO,IAAI,OAAO,GAAG,CAAC,aAAa,KAAK,QAAQ,CAAC;AACxE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,MAAe;IAC3C,IAAI,0BAA0B,CAAC,MAAM,CAAC,EAAE,CAAC;QACvC,MAAM,OAAO,GAAI,MAAgC,CAAC,OAAO,CAAC;QAC1D,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YAC3B,CAAC,CAAE,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAA8B;YACjE,CAAC,CAAC,EAAE,CAAC;IACT,CAAC;IACD,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACnD,CAAC"}

package/dist/mcp-server/tools/utils/toolDefinition.d.ts

@@ -8,10 +8,11 @@
  * @module src/mcp-server/tools/utils/toolDefinition
  */
 import type { ContentBlock } from '@modelcontextprotocol/server';
-import type { ZodObject, ZodRawShape, z } from 'zod';
+import { type ZodDiscriminatedUnion, type ZodObject, type ZodRawShape, z } from 'zod';
 import type { HandlerContext, ReasonOf } from '../../../core/context.js';
 import type { ErrorContract } from '../../../types-global/errors.js';
 export { type DisabledMetadata, disabledTool } from './disabled-tool.js';
+export { headerParam } from './headerParam.js';
 /**
  * Defines the annotations that provide hints about a tool's behavior.
  * These are not guarantees but are useful for client-side rendering and decision-making.
@@ -82,6 +83,23 @@ export type EnrichmentTrailerConfig<TEnrich extends ZodRawShape | undefined> = T
         render?(value: z.infer<TEnrich[K]>): string;
     };
 } : never;
+/**
+ * What a tool may declare as its `input` root.
+ *
+ * A `z.object()` is the common shape. A `z.discriminatedUnion()` is the
+ * multi-mode shape: mutually exclusive argument sets with a literal
+ * discriminator and per-variant required fields. It advertises as
+ * `{"type":"object","oneOf":[<branch>, …]}` — branches intact, each carrying
+ * its own `required` and `const`-tagged discriminator — with identical bytes on
+ * a 2025-11-25 and a 2026-07-28 connection, since the legacy projection
+ * inspects `outputSchema` alone.
+ *
+ * Input roots may be unions; **output roots may not**. The 2025-era projection
+ * rewrites a non-object output root to `{ result: <natural> }` and wraps
+ * `structuredContent` to match, which would break the success path for every
+ * current client. `output` and `enrichment` stay `ZodObject`-only.
+ */
+export type ToolInputSchema = ZodDiscriminatedUnion<readonly ZodObject<ZodRawShape>[]> | ZodObject<ZodRawShape>;
 /**
  * Represents the complete, self-contained definition of an MCP tool.
  *
@@ -94,7 +112,7 @@ export type EnrichmentTrailerConfig<TEnrich extends ZodRawShape | undefined> = T
  * none is declared). Its inferred fields type `ctx.enrich(...)` and are advertised
  * to clients as part of `outputSchema`.
  */
-export interface ToolDefinition<TInput extends ZodObject<ZodRawShape> = ZodObject<ZodRawShape>, TOutput extends ZodObject<ZodRawShape> = ZodObject<ZodRawShape>, TErrors extends readonly ErrorContract[] | undefined = undefined, TEnrich extends ZodRawShape | undefined = undefined> {
+export interface ToolDefinition<TInput extends ToolInputSchema = ZodObject<ZodRawShape>, TOutput extends ZodObject<ZodRawShape> = ZodObject<ZodRawShape>, TErrors extends readonly ErrorContract[] | undefined = undefined, TEnrich extends ZodRawShape | undefined = undefined> {
     /** Protocol-level metadata (e.g., MCP Apps extension). */
     _meta?: Record<string, unknown>;
     /** UI/behavior hints for clients. */
@@ -193,7 +211,12 @@ export interface ToolDefinition<TInput extends ZodObject<ZodRawShape> = ZodObjec
      * types remain assignable to the type-erased `AnyToolDefinition` array.
      */
     handler(input: z.infer<TInput>, ctx: HandlerContext<ReasonOf<TErrors>, TEnrich>): Promise<z.infer<TOutput>> | z.infer<TOutput>;
-    /** Zod schema for input validation. All fields need `.describe()`. */
+    /**
+     * Zod schema for input validation. All fields need `.describe()`.
+     *
+     * A `z.object()` root, or a `z.discriminatedUnion()` of object variants for a
+     * multi-mode tool — see {@link ToolInputSchema}.
+     */
     input: TInput;
     /** Programmatic unique name (snake_case). */
     name: string;
@@ -211,7 +234,7 @@ export interface ToolDefinition<TInput extends ZodObject<ZodRawShape> = ZodObjec
     title?: string;
 }
 /** Type-erased union for mixed arrays passed to createApp(). */
-export type AnyToolDefinition = ToolDefinition<ZodObject<ZodRawShape>, ZodObject<ZodRawShape>, readonly ErrorContract[] | undefined, ZodRawShape | undefined>;
+export type AnyToolDefinition = ToolDefinition<ToolInputSchema, ZodObject<ZodRawShape>, readonly ErrorContract[] | undefined, ZodRawShape | undefined>;
 /**
  * Creates a tool definition with full type inference from Zod schemas.
  *
@@ -259,5 +282,5 @@ export type AnyToolDefinition = ToolDefinition<ZodObject<ZodRawShape>, ZodObject
  * });
  * ```
  */
-export declare function tool<TInput extends ZodObject<ZodRawShape>, TOutput extends ZodObject<ZodRawShape>, const TErrors extends readonly ErrorContract[] | undefined = undefined, const TEnrich extends ZodRawShape | undefined = undefined>(name: string, options: Omit<ToolDefinition<TInput, TOutput, TErrors, TEnrich>, 'name'>): ToolDefinition<TInput, TOutput, TErrors, TEnrich>;
+export declare function tool<TInput extends ToolInputSchema, TOutput extends ZodObject<ZodRawShape>, const TErrors extends readonly ErrorContract[] | undefined = undefined, const TEnrich extends ZodRawShape | undefined = undefined>(name: string, options: Omit<ToolDefinition<TInput, TOutput, TErrors, TEnrich>, 'name'>): ToolDefinition<TInput, TOutput, TErrors, TEnrich>;
 //# sourceMappingURL=toolDefinition.d.ts.map

package/dist/mcp-server/tools/utils/toolDefinition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toolDefinition.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/toolDefinition.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"toolDefinition.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/toolDefinition.ts"],"names":[],"mappings":"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"}