@1mcp/agent 0.39.0-beta.2 → 0.39.0-beta.4

package/build/observability/tracing/otelAdapter.js

@@ -0,0 +1,160 @@
+import { context, createContextKey, defaultTextMapGetter, defaultTextMapSetter, isSpanContextValid, propagation, ROOT_CONTEXT, trace, } from '@opentelemetry/api';
+import { AsyncLocalStorageContextManager } from '@opentelemetry/context-async-hooks';
+import { W3CTraceContextPropagator } from '@opentelemetry/core';
+import { types } from 'node:util';
+const propagator = new W3CTraceContextPropagator();
+const lifetimeKey = createContextKey('1mcp.operation-trace-lifetime');
+let installed = false;
+/** Deliberately no NodeSDK, provider, span creation, auto instrumentation or exporters. */
+export function installTracingContext() {
+    if (installed)
+        return;
+    const manager = new AsyncLocalStorageContextManager().enable();
+    if (!context.setGlobalContextManager(manager))
+        manager.disable();
+    propagation.setGlobalPropagator(propagator);
+    installed = true;
+}
+function own(value, key) {
+    if (value === null || typeof value !== 'object' || types.isProxy(value))
+        return undefined;
+    const descriptor = Object.getOwnPropertyDescriptor(value, key);
+    return descriptor && 'value' in descriptor ? descriptor.value : undefined;
+}
+function validTraceState(value) {
+    if (typeof value !== 'string' || value.length > 512 || !value.length)
+        return false;
+    const members = value.split(',');
+    if (members.length > 32)
+        return false;
+    const keys = new Set();
+    for (const member of members) {
+        const match = /^[ \t]*([a-z][a-z0-9_*/-]{0,255}|[a-z0-9][a-z0-9_*/-]{0,240}@[a-z][a-z0-9_*/-]{0,13})=([\x20-\x2b\x2d-\x3c\x3e-\x7e]{0,255}[\x21-\x2b\x2d-\x3c\x3e-\x7e])[ \t]*$/.exec(member);
+        if (!match || keys.has(match[1]))
+            return false;
+        keys.add(match[1]);
+    }
+    return true;
+}
+function extract(params) {
+    const meta = own(params, '_meta');
+    const parent = own(meta, 'traceparent');
+    // Only the exact MCP reserved keys are carriers. Arrays/duplicates/conflicts are invalid.
+    if (typeof parent !== 'string' || parent.length > 512)
+        return ROOT_CONTEXT;
+    if (!/^(?!ff)[0-9a-f]{2}-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}(?:-[\x21-\x7e]+)?$/.test(parent))
+        return ROOT_CONTEXT;
+    const carrier = { traceparent: parent };
+    const state = own(meta, 'tracestate');
+    if (validTraceState(state))
+        carrier.tracestate = state;
+    return propagator.extract(ROOT_CONTEXT, carrier, defaultTextMapGetter);
+}
+function activeContext() {
+    const active = context.active();
+    const lifetime = active.getValue(lifetimeKey);
+    return lifetime?.active === false ? ROOT_CONTEXT : active;
+}
+async function run(parent, operation, signal) {
+    installTracingContext();
+    const lifetime = { active: !signal?.aborted };
+    const abort = () => {
+        lifetime.active = false;
+    };
+    signal?.addEventListener('abort', abort, { once: true });
+    try {
+        return await context.with(parent.setValue(lifetimeKey, lifetime), operation);
+    }
+    finally {
+        lifetime.active = false;
+        signal?.removeEventListener('abort', abort);
+    }
+}
+/** HTTP context is intentionally not an ancestor of the logical MCP operation. */
+export function withMcpTraceContext(params, operation, signal) {
+    return run(extract(params), operation, signal);
+}
+/** Capture only validated tracing facts in an opaque callback for an already-owned interaction. */
+export function captureTraceContext() {
+    const span = trace.getSpanContext(activeContext());
+    const captured = span && isSpanContextValid(span) ? trace.setSpanContext(ROOT_CONTEXT, span) : ROOT_CONTEXT;
+    return (operation, signal, remoteParams) => {
+        const remote = extract(remoteParams);
+        return run(trace.getSpanContext(remote) ? remote : captured, operation, signal);
+    };
+}
+export function getActiveTraceCorrelation() {
+    const span = trace.getSpanContext(activeContext());
+    if (!span || !isSpanContextValid(span))
+        return undefined;
+    return {
+        trace_id: span.traceId,
+        span_id: span.spanId,
+        trace_flags: (span.traceFlags & 0xff).toString(16).padStart(2, '0'),
+    };
+}
+/** Call only after authority/capability stripping, or on gateway-owned protocol metadata. */
+export function injectTraceContext(params) {
+    const carrier = {};
+    const active = activeContext();
+    const span = trace.getSpanContext(active);
+    // OTel 2.2's injector expects TraceFlags (sampled bit), not arbitrary W3C reserved bits.
+    const outgoing = span
+        ? trace.setSpanContext(ROOT_CONTEXT, { ...span, traceFlags: span.traceFlags & 1 })
+        : ROOT_CONTEXT;
+    propagator.inject(outgoing, carrier, defaultTextMapSetter);
+    if (params !== null && typeof params === 'object' && types.isProxy(params))
+        return undefined;
+    const original = params !== null && typeof params === 'object' && !Array.isArray(params) ? params : undefined;
+    const meta = own(original, '_meta');
+    const cleanMeta = {};
+    if (meta && typeof meta === 'object' && !types.isProxy(meta)) {
+        for (const key of Object.keys(meta)) {
+            if (['traceparent', 'tracestate', 'baggage'].includes(key))
+                continue;
+            const descriptor = Object.getOwnPropertyDescriptor(meta, key);
+            if (descriptor && 'value' in descriptor)
+                Object.defineProperty(cleanMeta, key, { value: descriptor.value, enumerable: true, configurable: true });
+        }
+    }
+    Object.assign(cleanMeta, carrier);
+    if (!Object.keys(cleanMeta).length && meta === undefined)
+        return params;
+    const result = {};
+    if (original) {
+        for (const key of Object.keys(original)) {
+            if (key === '_meta')
+                continue;
+            const descriptor = Object.getOwnPropertyDescriptor(original, key);
+            if (descriptor && 'value' in descriptor)
+                Object.defineProperty(result, key, { value: descriptor.value, enumerable: true });
+        }
+    }
+    return Object.assign(result, { _meta: cleanMeta });
+}
+/** Remove only the reserved envelope carrier; business fields named baggage are untouched. */
+export function stripBaggage(value) {
+    const meta = own(value, '_meta');
+    if (meta === null || typeof meta !== 'object' || types.isProxy(meta))
+        return value;
+    if (!Object.getOwnPropertyDescriptor(meta, 'baggage'))
+        return value;
+    const cleanMeta = {};
+    for (const key of Object.keys(meta)) {
+        if (key === 'baggage')
+            continue;
+        const descriptor = Object.getOwnPropertyDescriptor(meta, key);
+        if (descriptor && 'value' in descriptor)
+            Object.defineProperty(cleanMeta, key, { value: descriptor.value, enumerable: true });
+    }
+    const result = {};
+    for (const key of Object.keys(value)) {
+        if (key === '_meta')
+            continue;
+        const descriptor = Object.getOwnPropertyDescriptor(value, key);
+        if (descriptor && 'value' in descriptor)
+            Object.defineProperty(result, key, { value: descriptor.value, enumerable: true });
+    }
+    return Object.assign(result, { _meta: cleanMeta });
+}
+//# sourceMappingURL=otelAdapter.js.map

package/build/observability/tracing/otelAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"otelAdapter.js","sourceRoot":"","sources":["../../../src/observability/tracing/otelAdapter.ts"],"names":[],"mappings":"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"}

package/build/sdk/contracts/catalogCoverageInvalidation.d.ts

@@ -0,0 +1,4 @@
+export declare function observeCatalogCoverageLoss(source: object, invalidate: () => void): void;
+/** Revoke admitted routes synchronously before any owner callback can dispatch. */
+export declare function reportCatalogCoverageLoss(source: object): void;
+//# sourceMappingURL=catalogCoverageInvalidation.d.ts.map

package/build/sdk/contracts/catalogCoverageInvalidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalogCoverageInvalidation.d.ts","sourceRoot":"","sources":["../../../src/sdk/contracts/catalogCoverageInvalidation.ts"],"names":[],"mappings":"AAIA,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,IAAI,GAAG,IAAI,CAGvF;AAED,mFAAmF;AACnF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE9D"}

package/build/sdk/contracts/catalogCoverageInvalidation.js

@@ -0,0 +1,13 @@
+// One process-local observer per adapter. No SDK objects or wire notifications
+// cross this boundary; the adapter reports only an owned catalog coverage loss.
+const observers = new WeakMap();
+export function observeCatalogCoverageLoss(source, invalidate) {
+    if (observers.has(source))
+        throw new Error('Catalog coverage observer is already registered');
+    observers.set(source, invalidate);
+}
+/** Revoke admitted routes synchronously before any owner callback can dispatch. */
+export function reportCatalogCoverageLoss(source) {
+    observers.get(source)?.();
+}
+//# sourceMappingURL=catalogCoverageInvalidation.js.map

package/build/sdk/contracts/catalogCoverageInvalidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalogCoverageInvalidation.js","sourceRoot":"","sources":["../../../src/sdk/contracts/catalogCoverageInvalidation.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,gFAAgF;AAChF,MAAM,SAAS,GAAG,IAAI,OAAO,EAAsB,CAAC;AAEpD,MAAM,UAAU,0BAA0B,CAAC,MAAc,EAAE,UAAsB;IAC/E,IAAI,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IAC9F,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AACpC,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,yBAAyB,CAAC,MAAc;IACtD,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;AAC5B,CAAC"}

package/build/sdk/contracts/jsonValue.d.ts

@@ -4,18 +4,41 @@ export interface JsonObject {
     [key: string]: JsonValue;
 }
 export type JsonValue = JsonPrimitive | JsonArray | JsonObject;
-/** Finite resource budgets applied while validating and cloning foreign values. */
-export declare const JSON_VALUE_LIMITS: Readonly<{
-    maxDepth: 64;
-    maxNodes: 10000;
-    maxTotalStringLength: 1000000;
-}>;
+export interface JsonValueLimits {
+    readonly maxDepth: number;
+    readonly maxNodes: number;
+    readonly maxTotalStringLength: number;
+}
+/** Finite resource budgets applied while validating and cloning one foreign value. */
+export declare const JSON_VALUE_LIMITS: JsonValueLimits;
+/**
+ * Levels a response frame nests above one listed item: the modern frame's `result`,
+ * the list key, and the array index.
+ */
+export declare const RESPONSE_ITEM_DEPTH = 3;
+/**
+ * Budgets for one response the gateway assembles from many upstream values, such as
+ * an aggregated capability list. Response assembly pages its items against these
+ * limits, so every response it sends fits them. The extra depth covers the frame
+ * nesting, so a value that fit {@link JSON_VALUE_LIMITS} upstream still fits here.
+ */
+export declare const RESPONSE_JSON_VALUE_LIMITS: JsonValueLimits;
+/** What a value spends from a {@link JsonValueLimits} budget. */
+export interface JsonValueCost {
+    readonly nodes: number;
+    readonly stringLength: number;
+}
 export declare class InvalidJsonValueError extends TypeError {
     readonly path: string;
     readonly reason: string;
     constructor(path: string, reason: string);
 }
 /** Validates an unknown boundary value and returns a detached plain JSON clone. */
-export declare function toJsonValue(value: unknown): JsonValue;
+export declare function toJsonValue(value: unknown, limits?: JsonValueLimits): JsonValue;
+/**
+ * Validates a value placed `depth` levels below the root of a value checked against
+ * `limits`, and reports the budget it spends, using the same accounting.
+ */
+export declare function measureJsonValue(value: unknown, limits: JsonValueLimits, depth?: number): JsonValueCost;
 export declare function isJsonValue(value: unknown): value is JsonValue;
 //# sourceMappingURL=jsonValue.d.ts.map

package/build/sdk/contracts/jsonValue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jsonValue.d.ts","sourceRoot":"","sources":["../../../src/sdk/contracts/jsonValue.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAC7D,MAAM,MAAM,SAAS,GAAG,SAAS,EAAE,CAAC;AACpC,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AACD,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,SAAS,GAAG,UAAU,CAAC;AAE/D,mFAAmF;AACnF,eAAO,MAAM,iBAAiB;;;;EAI5B,CAAC;AAEH,qBAAa,qBAAsB,SAAQ,SAAS;IAEhD,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM;gBADd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM;CAK1B;AAyGD,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAErD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAQ9D"}
+{"version":3,"file":"jsonValue.d.ts","sourceRoot":"","sources":["../../../src/sdk/contracts/jsonValue.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAC7D,MAAM,MAAM,SAAS,GAAG,SAAS,EAAE,CAAC;AACpC,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AACD,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,SAAS,GAAG,UAAU,CAAC;AAE/D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;CACvC;AAED,sFAAsF;AACtF,eAAO,MAAM,iBAAiB,EAAE,eAI9B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,EAAE,eAIvC,CAAC;AAEH,iEAAiE;AACjE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,qBAAa,qBAAsB,SAAQ,SAAS;IAEhD,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM;gBADd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM;CAK1B;AA8GD,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,GAAE,eAAmC,GAAG,SAAS,CAElG;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,KAAK,SAAI,GAAG,aAAa,CAIlG;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAQ9D"}

package/build/sdk/contracts/jsonValue.js

@@ -1,9 +1,25 @@
-/** Finite resource budgets applied while validating and cloning foreign values. */
+/** Finite resource budgets applied while validating and cloning one foreign value. */
 export const JSON_VALUE_LIMITS = Object.freeze({
     maxDepth: 64,
     maxNodes: 10_000,
     maxTotalStringLength: 1_000_000,
 });
+/**
+ * Levels a response frame nests above one listed item: the modern frame's `result`,
+ * the list key, and the array index.
+ */
+export const RESPONSE_ITEM_DEPTH = 3;
+/**
+ * Budgets for one response the gateway assembles from many upstream values, such as
+ * an aggregated capability list. Response assembly pages its items against these
+ * limits, so every response it sends fits them. The extra depth covers the frame
+ * nesting, so a value that fit {@link JSON_VALUE_LIMITS} upstream still fits here.
+ */
+export const RESPONSE_JSON_VALUE_LIMITS = Object.freeze({
+    maxDepth: JSON_VALUE_LIMITS.maxDepth + RESPONSE_ITEM_DEPTH,
+    maxNodes: 1_000_000,
+    maxTotalStringLength: 32 * 1024 * 1024,
+});
 export class InvalidJsonValueError extends TypeError {
     path;
     reason;
@@ -19,14 +35,14 @@ function fail(path, reason) {
 }
 function consumeNode(state, path) {
     state.nodes += 1;
-    if (state.nodes > JSON_VALUE_LIMITS.maxNodes) {
-        fail(path, `node limit of ${JSON_VALUE_LIMITS.maxNodes} exceeded`);
+    if (state.nodes > state.limits.maxNodes) {
+        fail(path, `node limit of ${state.limits.maxNodes} exceeded`);
     }
 }
 function consumeString(state, path, value) {
     state.stringLength += value.length;
-    if (state.stringLength > JSON_VALUE_LIMITS.maxTotalStringLength) {
-        fail(path, `total string length limit of ${JSON_VALUE_LIMITS.maxTotalStringLength} exceeded`);
+    if (state.stringLength > state.limits.maxTotalStringLength) {
+        fail(path, `total string length limit of ${state.limits.maxTotalStringLength} exceeded`);
     }
 }
 function childPath(path, key) {
@@ -80,8 +96,8 @@ function cloneObject(value, path, depth, state) {
     return result;
 }
 function cloneValue(value, path, depth, state) {
-    if (depth > JSON_VALUE_LIMITS.maxDepth) {
-        fail(path, `depth limit of ${JSON_VALUE_LIMITS.maxDepth} exceeded`);
+    if (depth > state.limits.maxDepth) {
+        fail(path, `depth limit of ${state.limits.maxDepth} exceeded`);
     }
     consumeNode(state, path);
     if (value === null || typeof value === 'boolean')
@@ -109,9 +125,21 @@ function cloneValue(value, path, depth, state) {
         state.ancestors.delete(value);
     }
 }
+function newCloneState(limits) {
+    return { limits, ancestors: new WeakSet(), nodes: 0, stringLength: 0 };
+}
 /** Validates an unknown boundary value and returns a detached plain JSON clone. */
-export function toJsonValue(value) {
-    return cloneValue(value, '$', 0, { ancestors: new WeakSet(), nodes: 0, stringLength: 0 });
+export function toJsonValue(value, limits = JSON_VALUE_LIMITS) {
+    return cloneValue(value, '$', 0, newCloneState(limits));
+}
+/**
+ * Validates a value placed `depth` levels below the root of a value checked against
+ * `limits`, and reports the budget it spends, using the same accounting.
+ */
+export function measureJsonValue(value, limits, depth = 0) {
+    const state = newCloneState(limits);
+    cloneValue(value, '$', depth, state);
+    return { nodes: state.nodes, stringLength: state.stringLength };
 }
 export function isJsonValue(value) {
     try {

package/build/sdk/contracts/jsonValue.js.map

@@ -1 +1 @@
-{"version":3,"file":"jsonValue.js","sourceRoot":"","sources":["../../../src/sdk/contracts/jsonValue.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"jsonValue.js","sourceRoot":"","sources":["../../../src/sdk/contracts/jsonValue.ts"],"names":[],"mappings":"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"}

package/build/sdk/contracts/mcpParamHeaders.d.ts

@@ -0,0 +1,17 @@
+import type { JsonValue } from './index.js';
+export interface McpParamDeclaration {
+    readonly path: readonly string[];
+    readonly name: string;
+    readonly type: 'string' | 'integer' | 'boolean';
+}
+export type McpParamScan = {
+    readonly valid: true;
+    readonly declarations: readonly McpParamDeclaration[];
+} | {
+    readonly valid: false;
+    readonly reason: string;
+};
+/** Scan only detached, budgeted catalog JSON. Never resolve a schema reference or read caller headers. */
+export declare function scanMcpParamDeclarations(schema: JsonValue): McpParamScan;
+export declare function createMcpParamHeaders(declarations: readonly McpParamDeclaration[], args: JsonValue | undefined): Readonly<Record<string, string>>;
+//# sourceMappingURL=mcpParamHeaders.d.ts.map

package/build/sdk/contracts/mcpParamHeaders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpParamHeaders.d.ts","sourceRoot":"","sources":["../../../src/sdk/contracts/mcpParamHeaders.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAE7D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;CACjD;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,SAAS,mBAAmB,EAAE,CAAA;CAAE,GAC/E;IAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAiCvD,0GAA0G;AAC1G,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,YAAY,CAuCxE;AA8CD,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,SAAS,mBAAmB,EAAE,EAC5C,IAAI,EAAE,SAAS,GAAG,SAAS,GAC1B,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAOlC"}

package/build/sdk/contracts/mcpParamHeaders.js

@@ -0,0 +1,134 @@
+import { createGatewayFailure } from '../../gateway/contracts/gatewayFailure.js';
+const invalidHeaderTokenCharacter = /[^!#$%&'*+.^_`|~0-9A-Za-z-]/;
+const excludedSubschemas = [
+    'items',
+    'prefixItems',
+    'contains',
+    'additionalItems',
+    'contentSchema',
+    'additionalProperties',
+    'unevaluatedProperties',
+    'unevaluatedItems',
+    'propertyNames',
+    'patternProperties',
+    'dependentSchemas',
+    'dependencies',
+    'oneOf',
+    'anyOf',
+    'allOf',
+    'not',
+    'if',
+    'then',
+    'else',
+    '$defs',
+    'definitions',
+];
+const mappedSubschemas = new Set(['patternProperties', 'dependentSchemas', 'dependencies', '$defs', 'definitions']);
+function record(value) {
+    if (value === null || Array.isArray(value) || typeof value !== 'object')
+        return undefined;
+    return value;
+}
+/** Scan only detached, budgeted catalog JSON. Never resolve a schema reference or read caller headers. */
+export function scanMcpParamDeclarations(schema) {
+    const declarations = [];
+    const names = new Set();
+    const visit = (value, path, reachable) => {
+        const node = record(value);
+        if (!node)
+            return undefined;
+        if (Object.hasOwn(node, 'x-mcp-header')) {
+            if (!reachable || path.length === 0)
+                return 'Annotation must be reachable through properties';
+            const name = node['x-mcp-header'];
+            if (typeof name !== 'string' || name.length === 0 || invalidHeaderTokenCharacter.test(name))
+                return 'Header name must be an HTTP token';
+            const type = node.type;
+            if (type !== 'string' && type !== 'integer' && type !== 'boolean')
+                return 'Header parameter must have type string, integer, or boolean';
+            const normalized = name.toLowerCase();
+            if (names.has(normalized))
+                return 'Header names must be case-insensitively unique';
+            names.add(normalized);
+            declarations.push({ path, name, type });
+        }
+        const properties = record(node.properties);
+        for (const [name, child] of Object.entries(properties ?? {})) {
+            const failure = visit(child, [...path, name], reachable);
+            if (failure)
+                return failure;
+        }
+        for (const keyword of excludedSubschemas) {
+            const sub = node[keyword];
+            if (sub === undefined)
+                continue;
+            let branches = [sub];
+            if (Array.isArray(sub))
+                branches = sub;
+            else if (mappedSubschemas.has(keyword))
+                branches = Object.values(record(sub) ?? {});
+            for (const branch of branches) {
+                const failure = visit(branch, [], false);
+                if (failure)
+                    return failure;
+            }
+        }
+        return undefined;
+    };
+    const reason = visit(schema, [], true);
+    return reason ? { valid: false, reason } : { valid: true, declarations };
+}
+function argumentAtPath(args, path) {
+    let value = args;
+    for (const name of path) {
+        const parent = record(value);
+        if (!parent || !Object.hasOwn(parent, name))
+            return undefined;
+        value = parent[name];
+    }
+    return value;
+}
+function primitiveValue(value, type) {
+    if (type === 'string')
+        return typeof value === 'string' ? value : undefined;
+    if (type === 'boolean')
+        return typeof value === 'boolean' ? String(value) : undefined;
+    if (typeof value !== 'number')
+        return undefined;
+    if (!Number.isSafeInteger(value))
+        throw createGatewayFailure({
+            kind: 'protocol',
+            code: '-32602',
+            message: 'Header integer parameter must be a safe integer',
+        });
+    return String(value);
+}
+function hasUnsafeFieldCharacter(value) {
+    for (let index = 0; index < value.length; index++) {
+        const code = value.charCodeAt(index);
+        if (code === 9)
+            continue;
+        if (code < 32 || code > 126)
+            return true;
+    }
+    return false;
+}
+function encodeValue(value) {
+    if (value.length === 0 ||
+        value !== value.trim() ||
+        hasUnsafeFieldCharacter(value) ||
+        (value.startsWith('=?base64?') && value.endsWith('?='))) {
+        return `=?base64?${Buffer.from(value, 'utf8').toString('base64')}?=`;
+    }
+    return value;
+}
+export function createMcpParamHeaders(declarations, args) {
+    const headers = {};
+    for (const declaration of declarations) {
+        const value = primitiveValue(argumentAtPath(args, declaration.path), declaration.type);
+        if (value !== undefined)
+            headers[`Mcp-Param-${declaration.name}`] = encodeValue(value);
+    }
+    return headers;
+}
+//# sourceMappingURL=mcpParamHeaders.js.map

package/build/sdk/contracts/mcpParamHeaders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpParamHeaders.js","sourceRoot":"","sources":["../../../src/sdk/contracts/mcpParamHeaders.ts"],"names":[],"mappings":"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"}

package/build/sdk/contracts/requestProgress.d.ts

@@ -0,0 +1,29 @@
+export interface RequestProgressNotification {
+    readonly method: 'notifications/progress';
+    readonly params: {
+        progressToken: string | number;
+        progress: number;
+        total?: number;
+        message?: string;
+    };
+}
+interface Owner {
+    accepting: boolean;
+    active: boolean;
+    pending: number;
+    bytes: number;
+    tail: Promise<void>;
+    failure?: unknown;
+    readonly token: string | number;
+    readonly signal?: AbortSignal;
+    readonly assertCurrent?: () => void;
+    readonly send: (notification: RequestProgressNotification) => Promise<void>;
+}
+/** Retain an opaque scalar token exactly; it never becomes an upstream request token. */
+export declare function requestProgressToken(value: unknown): string | number | undefined;
+/** One inbound exchange owns a bounded delivery queue, independently of any SDK request id. */
+export declare function withRequestProgress<T>(token: unknown, send: Owner['send'], operation: () => Promise<T>, signal?: AbortSignal, assertCurrent?: () => void): Promise<T>;
+/** SDK onprogress already correlates a private SDK token; never accept raw notifications here. */
+export declare function currentRequestProgress(): ((progress: unknown) => void) | undefined;
+export {};
+//# sourceMappingURL=requestProgress.d.ts.map

package/build/sdk/contracts/requestProgress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestProgress.d.ts","sourceRoot":"","sources":["../../../src/sdk/contracts/requestProgress.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE;QAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACzG;AACD,UAAU,KAAK;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,CAAC,YAAY,EAAE,2BAA2B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7E;AAsBD,yFAAyF;AACzF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAIhF;AAED,+FAA+F;AAC/F,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,EACnB,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,MAAM,CAAC,EAAE,WAAW,EACpB,aAAa,CAAC,EAAE,MAAM,IAAI,GACzB,OAAO,CAAC,CAAC,CAAC,CA2BZ;AAED,kGAAkG;AAClG,wBAAgB,sBAAsB,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,SAAS,CA8ClF"}