@nitrostack/core 1.0.15 → 1.0.16

package/dist/core/protocol/features/cache-hints.d.ts

@@ -0,0 +1,64 @@
+/**
+ * SEP-2549 cache hints (`ttlMs` / `cacheScope`).
+ *
+ * On the 2026-07-28 revision, `tools/list`, `prompts/list`, `resources/list`,
+ * `resources/templates/list`, `resources/read`, and `server/discover` results
+ * carry `ttlMs` (freshness hint in ms) and `cacheScope` (`public` | `private`).
+ *
+ * NitroStack maps its existing caching signals onto these hints:
+ * - a tool's `@Cache({ ttl })` (seconds) or explicit `cacheHint` → per-tool hint
+ * - a resource's `metadata.cacheMaxAge` (seconds) or explicit `cacheHint` → hint
+ *
+ * The 2025-era path never emits these fields, so this module is only consulted
+ * by the modern adapter. The conservative default (`ttlMs: 0`,
+ * `cacheScope: 'private'`) is left to the SDK when no hint is resolved.
+ *
+ * @module
+ */
+/**
+ * Cache scope for a cacheable result (SEP-2549).
+ */
+export type CacheScope = 'public' | 'private';
+/**
+ * A NitroStack cache hint. Mirrors the v2 SDK `CacheHint` shape so it can be
+ * handed to `registerResource(..., { cacheHint })` / `ServerOptions.cacheHints`
+ * without coupling non-modern code to the v2 types.
+ */
+export interface NitroCacheHint {
+    /** Cache lifetime in milliseconds (non-negative). */
+    ttlMs?: number;
+    /** Whether shared caches may store the result. */
+    cacheScope?: CacheScope;
+}
+/**
+ * Minimal shape of a tool for hint resolution (avoids importing the Tool class
+ * to keep this feature dependency-light and testable).
+ */
+export interface CacheHintToolLike {
+    cacheHint?: NitroCacheHint;
+    /** Seconds — typically propagated from `@Cache({ ttl })`. */
+    cacheTtlSeconds?: number;
+}
+/**
+ * Minimal shape of a resource for hint resolution.
+ */
+export interface CacheHintResourceLike {
+    cacheHint?: NitroCacheHint;
+    metadata?: {
+        cacheable?: boolean;
+        cacheMaxAge?: number;
+    };
+}
+/**
+ * Resolve a cache hint for a tool, or `undefined` when it has no caching signal.
+ */
+export declare function resolveToolCacheHint(tool: CacheHintToolLike): NitroCacheHint | undefined;
+/**
+ * Resolve a cache hint for a resource, or `undefined` when it has none.
+ */
+export declare function resolveResourceCacheHint(resource: CacheHintResourceLike): NitroCacheHint | undefined;
+/**
+ * Clamp/validate a hint into safe values.
+ */
+export declare function normalizeHint(hint: NitroCacheHint): NitroCacheHint;
+//# sourceMappingURL=cache-hints.d.ts.map

package/dist/core/protocol/features/cache-hints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-hints.d.ts","sourceRoot":"","sources":["../../../../src/core/protocol/features/cache-hints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE9C;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,6DAA6D;IAC7D,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,QAAQ,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,cAAc,GAAG,SAAS,CAQxF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,cAAc,GAAG,SAAS,CASpG;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,GAAG,cAAc,CASlE"}

package/dist/core/protocol/features/cache-hints.js

@@ -0,0 +1,56 @@
+/**
+ * SEP-2549 cache hints (`ttlMs` / `cacheScope`).
+ *
+ * On the 2026-07-28 revision, `tools/list`, `prompts/list`, `resources/list`,
+ * `resources/templates/list`, `resources/read`, and `server/discover` results
+ * carry `ttlMs` (freshness hint in ms) and `cacheScope` (`public` | `private`).
+ *
+ * NitroStack maps its existing caching signals onto these hints:
+ * - a tool's `@Cache({ ttl })` (seconds) or explicit `cacheHint` → per-tool hint
+ * - a resource's `metadata.cacheMaxAge` (seconds) or explicit `cacheHint` → hint
+ *
+ * The 2025-era path never emits these fields, so this module is only consulted
+ * by the modern adapter. The conservative default (`ttlMs: 0`,
+ * `cacheScope: 'private'`) is left to the SDK when no hint is resolved.
+ *
+ * @module
+ */
+/**
+ * Resolve a cache hint for a tool, or `undefined` when it has no caching signal.
+ */
+export function resolveToolCacheHint(tool) {
+    if (tool.cacheHint && (tool.cacheHint.ttlMs !== undefined || tool.cacheHint.cacheScope !== undefined)) {
+        return normalizeHint(tool.cacheHint);
+    }
+    if (typeof tool.cacheTtlSeconds === 'number' && tool.cacheTtlSeconds > 0) {
+        return { ttlMs: Math.round(tool.cacheTtlSeconds * 1000), cacheScope: 'private' };
+    }
+    return undefined;
+}
+/**
+ * Resolve a cache hint for a resource, or `undefined` when it has none.
+ */
+export function resolveResourceCacheHint(resource) {
+    if (resource.cacheHint && (resource.cacheHint.ttlMs !== undefined || resource.cacheHint.cacheScope !== undefined)) {
+        return normalizeHint(resource.cacheHint);
+    }
+    const maxAge = resource.metadata?.cacheMaxAge;
+    if (typeof maxAge === 'number' && maxAge > 0) {
+        return { ttlMs: Math.round(maxAge * 1000), cacheScope: 'private' };
+    }
+    return undefined;
+}
+/**
+ * Clamp/validate a hint into safe values.
+ */
+export function normalizeHint(hint) {
+    const out = {};
+    if (typeof hint.ttlMs === 'number' && Number.isFinite(hint.ttlMs) && hint.ttlMs >= 0) {
+        out.ttlMs = Math.floor(hint.ttlMs);
+    }
+    if (hint.cacheScope === 'public' || hint.cacheScope === 'private') {
+        out.cacheScope = hint.cacheScope;
+    }
+    return out;
+}
+//# sourceMappingURL=cache-hints.js.map

package/dist/core/protocol/features/cache-hints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-hints.js","sourceRoot":"","sources":["../../../../src/core/protocol/features/cache-hints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAqCH;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAuB;IAC1D,IAAI,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,UAAU,KAAK,SAAS,CAAC,EAAE,CAAC;QACtG,OAAO,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IACD,IAAI,OAAO,IAAI,CAAC,eAAe,KAAK,QAAQ,IAAI,IAAI,CAAC,eAAe,GAAG,CAAC,EAAE,CAAC;QACzE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;IACnF,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,QAA+B;IACtE,IAAI,QAAQ,CAAC,SAAS,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,KAAK,SAAS,IAAI,QAAQ,CAAC,SAAS,CAAC,UAAU,KAAK,SAAS,CAAC,EAAE,CAAC;QAClH,OAAO,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC9C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7C,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;IACrE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAoB;IAChD,MAAM,GAAG,GAAmB,EAAE,CAAC;IAC/B,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;QACrF,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,IAAI,CAAC,UAAU,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QAClE,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;IACnC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/core/protocol/features/errors.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Era-aware JSON-RPC error mapping.
+ *
+ * The 2026-07-28 revision changed the error for a missing resource
+ * (SEP-2164): `resources/read` on an unknown URI now returns `-32602`
+ * (Invalid Params) instead of the 2025-era `-32002` (Resource Not Found).
+ * NitroStack keeps the 2025 mapping on the legacy path; the modern adapter
+ * uses `mapToJsonRpcError` so its handlers throw the right code.
+ *
+ * @module
+ */
+/** Standard JSON-RPC / MCP error codes. */
+export declare const JSON_RPC: {
+    readonly PARSE_ERROR: -32700;
+    readonly INVALID_REQUEST: -32600;
+    readonly METHOD_NOT_FOUND: -32601;
+    readonly INVALID_PARAMS: -32602;
+    readonly INTERNAL_ERROR: -32603;
+    /** SEP-2243: request header/body mismatch. */
+    readonly HEADER_BODY_MISMATCH: -32020;
+};
+/** A JSON-RPC error object. */
+export interface JsonRpcError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+/**
+ * Map a thrown error to a JSON-RPC error for the modern (2026-07-28) path.
+ *
+ * Key difference vs legacy: `ResourceNotFoundError` → `-32602` (SEP-2164).
+ */
+export declare function mapToJsonRpcError(error: unknown): JsonRpcError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/protocol/features/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/core/protocol/features/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH,2CAA2C;AAC3C,eAAO,MAAM,QAAQ;;;;;;IAMnB,8CAA8C;;CAEtC,CAAC;AAEX,+BAA+B;AAC/B,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAmB9D"}

package/dist/core/protocol/features/errors.js

@@ -0,0 +1,48 @@
+/**
+ * Era-aware JSON-RPC error mapping.
+ *
+ * The 2026-07-28 revision changed the error for a missing resource
+ * (SEP-2164): `resources/read` on an unknown URI now returns `-32602`
+ * (Invalid Params) instead of the 2025-era `-32002` (Resource Not Found).
+ * NitroStack keeps the 2025 mapping on the legacy path; the modern adapter
+ * uses `mapToJsonRpcError` so its handlers throw the right code.
+ *
+ * @module
+ */
+import { McpError, ValidationError, ToolNotFoundError, ResourceNotFoundError, PromptNotFoundError, RateLimitError, } from '../../errors.js';
+/** Standard JSON-RPC / MCP error codes. */
+export const JSON_RPC = {
+    PARSE_ERROR: -32700,
+    INVALID_REQUEST: -32600,
+    METHOD_NOT_FOUND: -32601,
+    INVALID_PARAMS: -32602,
+    INTERNAL_ERROR: -32603,
+    /** SEP-2243: request header/body mismatch. */
+    HEADER_BODY_MISMATCH: -32020,
+};
+/**
+ * Map a thrown error to a JSON-RPC error for the modern (2026-07-28) path.
+ *
+ * Key difference vs legacy: `ResourceNotFoundError` → `-32602` (SEP-2164).
+ */
+export function mapToJsonRpcError(error) {
+    if (error instanceof ResourceNotFoundError) {
+        // SEP-2164: unknown resource is Invalid Params on 2026-07-28.
+        return { code: JSON_RPC.INVALID_PARAMS, message: error.message };
+    }
+    if (error instanceof ValidationError) {
+        return { code: JSON_RPC.INVALID_PARAMS, message: error.message, data: error.details };
+    }
+    if (error instanceof ToolNotFoundError || error instanceof PromptNotFoundError) {
+        return { code: JSON_RPC.METHOD_NOT_FOUND, message: error.message };
+    }
+    if (error instanceof RateLimitError) {
+        return { code: JSON_RPC.INTERNAL_ERROR, message: error.message };
+    }
+    if (error instanceof McpError) {
+        return { code: JSON_RPC.INTERNAL_ERROR, message: error.message, data: error.details };
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    return { code: JSON_RPC.INTERNAL_ERROR, message };
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/protocol/features/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/core/protocol/features/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,QAAQ,EACR,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,GACf,MAAM,iBAAiB,CAAC;AAEzB,2CAA2C;AAC3C,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,WAAW,EAAE,CAAC,KAAK;IACnB,eAAe,EAAE,CAAC,KAAK;IACvB,gBAAgB,EAAE,CAAC,KAAK;IACxB,cAAc,EAAE,CAAC,KAAK;IACtB,cAAc,EAAE,CAAC,KAAK;IACtB,8CAA8C;IAC9C,oBAAoB,EAAE,CAAC,KAAK;CACpB,CAAC;AASX;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,IAAI,KAAK,YAAY,qBAAqB,EAAE,CAAC;QAC3C,8DAA8D;QAC9D,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,cAAc,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;IACnE,CAAC;IACD,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;QACrC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,cAAc,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;IACxF,CAAC;IACD,IAAI,KAAK,YAAY,iBAAiB,IAAI,KAAK,YAAY,mBAAmB,EAAE,CAAC;QAC/E,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,gBAAgB,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;IACrE,CAAC;IACD,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;QACpC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,cAAc,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;IACnE,CAAC;IACD,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;QAC9B,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,cAAc,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;IACxF,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,cAAc,EAAE,OAAO,EAAE,CAAC;AACpD,CAAC"}

package/dist/core/protocol/features/extensions.d.ts

@@ -0,0 +1,39 @@
+/**
+ * SEP-2133 extensions map (modern path).
+ *
+ * On 2026-07-28, capabilities that used to be baked into the core spec are
+ * negotiated as named extensions advertised on `server/discover`. NitroStack
+ * derives this map from what the app actually registered:
+ *
+ * - `io.modelcontextprotocol/app` — advertised when any tool ships a UI
+ *   component / `@Widget` (MCP Apps).
+ * - `io.modelcontextprotocol/tasks` — advertised when any tool declares
+ *   `taskSupport` other than `forbidden`.
+ *
+ * Apps may declare extra extensions via `@McpApp({ extensions })`, which are
+ * merged in verbatim.
+ *
+ * @module
+ */
+/** Canonical extension identifier for MCP Apps. */
+export declare const EXT_APP = "io.modelcontextprotocol/app";
+/** Canonical extension identifier for the Tasks extension. */
+export declare const EXT_TASKS = "io.modelcontextprotocol/tasks";
+/** Per-extension advertisement payload (opaque capability object). */
+export type ExtensionEntry = Record<string, unknown>;
+/** The `extensions` capabilities map advertised on `server/discover`. */
+export type ExtensionsMap = Record<string, ExtensionEntry>;
+/** Inputs used to derive the advertised extensions. */
+export interface ExtensionSignals {
+    /** True when at least one tool is task-capable. */
+    hasTasks: boolean;
+    /** True when at least one tool ships a UI component/widget. */
+    hasApps: boolean;
+    /** Extra extensions declared by the app author. */
+    declared?: ExtensionsMap;
+}
+/**
+ * Build the extensions capability map for `server/discover`.
+ */
+export declare function buildExtensionsMap(signals: ExtensionSignals): ExtensionsMap;
+//# sourceMappingURL=extensions.d.ts.map

package/dist/core/protocol/features/extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../../../../src/core/protocol/features/extensions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,mDAAmD;AACnD,eAAO,MAAM,OAAO,gCAAgC,CAAC;AACrD,8DAA8D;AAC9D,eAAO,MAAM,SAAS,kCAAkC,CAAC;AAEzD,sEAAsE;AACtE,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAErD,yEAAyE;AACzE,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAE3D,uDAAuD;AACvD,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,QAAQ,EAAE,OAAO,CAAC;IAClB,+DAA+D;IAC/D,OAAO,EAAE,OAAO,CAAC;IACjB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,aAAa,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,GAAG,aAAa,CAkB3E"}

package/dist/core/protocol/features/extensions.js

@@ -0,0 +1,42 @@
+/**
+ * SEP-2133 extensions map (modern path).
+ *
+ * On 2026-07-28, capabilities that used to be baked into the core spec are
+ * negotiated as named extensions advertised on `server/discover`. NitroStack
+ * derives this map from what the app actually registered:
+ *
+ * - `io.modelcontextprotocol/app` — advertised when any tool ships a UI
+ *   component / `@Widget` (MCP Apps).
+ * - `io.modelcontextprotocol/tasks` — advertised when any tool declares
+ *   `taskSupport` other than `forbidden`.
+ *
+ * Apps may declare extra extensions via `@McpApp({ extensions })`, which are
+ * merged in verbatim.
+ *
+ * @module
+ */
+/** Canonical extension identifier for MCP Apps. */
+export const EXT_APP = 'io.modelcontextprotocol/app';
+/** Canonical extension identifier for the Tasks extension. */
+export const EXT_TASKS = 'io.modelcontextprotocol/tasks';
+/**
+ * Build the extensions capability map for `server/discover`.
+ */
+export function buildExtensionsMap(signals) {
+    const map = {};
+    if (signals.hasApps) {
+        map[EXT_APP] = { version: '2026-07-28' };
+    }
+    if (signals.hasTasks) {
+        // Tasks extension: server-directed task creation is supported; the
+        // in-process TaskManager answers tasks/get, tasks/update, tasks/cancel.
+        map[EXT_TASKS] = { version: '2026-07-28' };
+    }
+    if (signals.declared) {
+        for (const [id, entry] of Object.entries(signals.declared)) {
+            map[id] = { ...(map[id] || {}), ...entry };
+        }
+    }
+    return map;
+}
+//# sourceMappingURL=extensions.js.map

package/dist/core/protocol/features/extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.js","sourceRoot":"","sources":["../../../../src/core/protocol/features/extensions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,mDAAmD;AACnD,MAAM,CAAC,MAAM,OAAO,GAAG,6BAA6B,CAAC;AACrD,8DAA8D;AAC9D,MAAM,CAAC,MAAM,SAAS,GAAG,+BAA+B,CAAC;AAkBzD;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAyB;IAC1D,MAAM,GAAG,GAAkB,EAAE,CAAC;IAE9B,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC;IAC3C,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,mEAAmE;QACnE,wEAAwE;QACxE,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC;IAC7C,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3D,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/core/protocol/features/mrtr.d.ts

@@ -0,0 +1,75 @@
+/**
+ * SEP-2322 Multi Round-Trip Requests (MRTR).
+ *
+ * On 2026-07-28 a handler can pause and ask the client for more input without a
+ * persistent connection: it returns an `input_required` result carrying
+ * `inputRequests` and an opaque `requestState`; the client re-invokes the same
+ * request with `inputResponses` (plus the echoed `requestState`).
+ *
+ * NitroStack has no elicitation/sampling handlers today, so this is a net-new,
+ * additive API. Handlers are written **once**: they call `inputRequired(...)`
+ * and read prior answers with `acceptedContent(...)`. These helpers produce an
+ * era-agnostic marker object; the modern adapter translates it into the real
+ * v2 `InputRequiredResult`, while the legacy adapter surfaces it via the
+ * session stream (or treats it as an error result if the client cannot elicit).
+ *
+ * @module
+ */
+import type { JsonValue } from '../../types.js';
+/** Marker symbol identifying a NitroStack input-required result. */
+export declare const NITRO_INPUT_REQUIRED: unique symbol;
+/**
+ * A single request for client-provided input (elicitation-style).
+ */
+export interface NitroInputRequest {
+    /** Identifier the client echoes back in `inputResponses`. */
+    id: string;
+    /** Human-facing message describing what is being asked. */
+    message?: string;
+    /** JSON Schema describing the expected response shape. */
+    schema?: Record<string, JsonValue>;
+    /** Optional request kind (defaults to form elicitation). */
+    kind?: 'form' | 'url';
+    /** For `url` elicitations, the URL the user must visit. */
+    url?: string;
+}
+/**
+ * The era-agnostic input-required marker returned by `inputRequired()`.
+ */
+export interface NitroInputRequiredResult {
+    [NITRO_INPUT_REQUIRED]: true;
+    inputRequests: NitroInputRequest[];
+    /** Opaque state echoed to the client and returned on retry. */
+    requestState?: JsonValue;
+    /** Optional message shown alongside the requests. */
+    message?: string;
+}
+/**
+ * Signal that a handler needs more input from the client before it can finish.
+ *
+ * @example
+ * ```ts
+ * if (!acceptedContent(ctx.inputResponses, 'confirm')) {
+ *   return inputRequired({
+ *     requests: [{ id: 'confirm', message: 'Delete all rows?', schema: { type: 'boolean' } }],
+ *     requestState: { pendingDelete: table },
+ *   });
+ * }
+ * ```
+ */
+export declare function inputRequired(spec: {
+    requests: NitroInputRequest[];
+    requestState?: JsonValue;
+    message?: string;
+}): NitroInputRequiredResult;
+/**
+ * Type guard for the input-required marker.
+ */
+export declare function isInputRequired(value: unknown): value is NitroInputRequiredResult;
+/**
+ * Read a previously-supplied input response by id from `ctx.inputResponses`.
+ * Returns `undefined` when the client has not answered that request yet, which
+ * is the signal to return `inputRequired(...)`.
+ */
+export declare function acceptedContent<T = JsonValue>(inputResponses: Record<string, unknown> | undefined, id: string): T | undefined;
+//# sourceMappingURL=mrtr.d.ts.map

package/dist/core/protocol/features/mrtr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mrtr.d.ts","sourceRoot":"","sources":["../../../../src/core/protocol/features/mrtr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,oEAAoE;AACpE,eAAO,MAAM,oBAAoB,eAAyC,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,6DAA6D;IAC7D,EAAE,EAAE,MAAM,CAAC;IACX,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACnC,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACtB,2DAA2D;IAC3D,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,CAAC,oBAAoB,CAAC,EAAE,IAAI,CAAC;IAC7B,aAAa,EAAE,iBAAiB,EAAE,CAAC;IACnC,+DAA+D;IAC/D,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAClC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,wBAAwB,CAO3B;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,wBAAwB,CAEjF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,GAAG,SAAS,EAC3C,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EACnD,EAAE,EAAE,MAAM,GACT,CAAC,GAAG,SAAS,CAaf"}

package/dist/core/protocol/features/mrtr.js

@@ -0,0 +1,66 @@
+/**
+ * SEP-2322 Multi Round-Trip Requests (MRTR).
+ *
+ * On 2026-07-28 a handler can pause and ask the client for more input without a
+ * persistent connection: it returns an `input_required` result carrying
+ * `inputRequests` and an opaque `requestState`; the client re-invokes the same
+ * request with `inputResponses` (plus the echoed `requestState`).
+ *
+ * NitroStack has no elicitation/sampling handlers today, so this is a net-new,
+ * additive API. Handlers are written **once**: they call `inputRequired(...)`
+ * and read prior answers with `acceptedContent(...)`. These helpers produce an
+ * era-agnostic marker object; the modern adapter translates it into the real
+ * v2 `InputRequiredResult`, while the legacy adapter surfaces it via the
+ * session stream (or treats it as an error result if the client cannot elicit).
+ *
+ * @module
+ */
+/** Marker symbol identifying a NitroStack input-required result. */
+export const NITRO_INPUT_REQUIRED = Symbol.for('nitrostack.inputRequired');
+/**
+ * Signal that a handler needs more input from the client before it can finish.
+ *
+ * @example
+ * ```ts
+ * if (!acceptedContent(ctx.inputResponses, 'confirm')) {
+ *   return inputRequired({
+ *     requests: [{ id: 'confirm', message: 'Delete all rows?', schema: { type: 'boolean' } }],
+ *     requestState: { pendingDelete: table },
+ *   });
+ * }
+ * ```
+ */
+export function inputRequired(spec) {
+    return {
+        [NITRO_INPUT_REQUIRED]: true,
+        inputRequests: spec.requests,
+        requestState: spec.requestState,
+        message: spec.message,
+    };
+}
+/**
+ * Type guard for the input-required marker.
+ */
+export function isInputRequired(value) {
+    return !!value && typeof value === 'object' && value[NITRO_INPUT_REQUIRED] === true;
+}
+/**
+ * Read a previously-supplied input response by id from `ctx.inputResponses`.
+ * Returns `undefined` when the client has not answered that request yet, which
+ * is the signal to return `inputRequired(...)`.
+ */
+export function acceptedContent(inputResponses, id) {
+    if (!inputResponses || typeof inputResponses !== 'object') {
+        return undefined;
+    }
+    const entry = inputResponses[id];
+    if (entry === undefined || entry === null) {
+        return undefined;
+    }
+    // Responses may be bare values or `{ content: ... }` wrappers.
+    if (typeof entry === 'object' && entry !== null && 'content' in entry) {
+        return entry.content;
+    }
+    return entry;
+}
+//# sourceMappingURL=mrtr.js.map

package/dist/core/protocol/features/mrtr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mrtr.js","sourceRoot":"","sources":["../../../../src/core/protocol/features/mrtr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,oEAAoE;AACpE,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;AA8B3E;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,aAAa,CAAC,IAI7B;IACC,OAAO;QACL,CAAC,oBAAoB,CAAC,EAAE,IAAI;QAC5B,aAAa,EAAE,IAAI,CAAC,QAAQ;QAC5B,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAK,KAAiC,CAAC,oBAAoB,CAAC,KAAK,IAAI,CAAC;AACnH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,cAAmD,EACnD,EAAU;IAEV,IAAI,CAAC,cAAc,IAAI,OAAO,cAAc,KAAK,QAAQ,EAAE,CAAC;QAC1D,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,KAAK,GAAG,cAAc,CAAC,EAAE,CAAC,CAAC;IACjC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC1C,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,+DAA+D;IAC/D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,SAAS,IAAK,KAAgB,EAAE,CAAC;QAClF,OAAQ,KAAwB,CAAC,OAAO,CAAC;IAC3C,CAAC;IACD,OAAO,KAAU,CAAC;AACpB,CAAC"}

package/dist/core/protocol/features/schema.d.ts

@@ -0,0 +1,39 @@
+/**
+ * SEP-2106 full JSON Schema 2020-12 for tools (modern path only).
+ *
+ * The legacy path converts Zod with `target: 'jsonSchema7'` and inlines refs
+ * (`$refStrategy: 'none'`), forcing `type: "object"` on both input and output —
+ * unchanged so 2025-era clients never see unexpected keywords.
+ *
+ * On 2026-07-28 tool schemas are lifted to full JSON Schema 2020-12:
+ * - input keeps an object root but may carry `oneOf`/`anyOf`/`allOf`,
+ *   conditionals, and `$ref`/`$defs`
+ * - output is unrestricted (not forced to an object)
+ * - external `$ref` URIs are never auto-dereferenced and schema depth is bounded
+ *
+ * @module
+ */
+/** JSON Schema object (loose). */
+export type JsonSchemaObject = Record<string, unknown>;
+/** Maximum schema nesting depth accepted on the modern path (DoS guard). */
+export declare const MAX_SCHEMA_DEPTH = 64;
+/**
+ * Bound the depth of a JSON schema object, replacing anything deeper than
+ * `maxDepth` with a permissive `{}` so a pathological `$defs` graph cannot blow
+ * the stack or the validator. External `$ref` URIs are left intact but are
+ * never dereferenced by NitroStack.
+ */
+export declare function boundSchemaDepth(value: unknown, maxDepth?: number, depth?: number): unknown;
+/**
+ * Convert a Zod or JSON schema to JSON Schema 2020-12 for the modern era,
+ * preserving composition (`oneOf`/`anyOf`/`allOf`), conditionals, and
+ * `$ref`/`$defs`.
+ *
+ * @param schema - Zod schema or a pre-built JSON schema.
+ * @param opts.root - `'input'` forces an object root (spec requirement for tool
+ *   input); `'output'` leaves the schema unrestricted.
+ */
+export declare function convertToModernJsonSchema(schema: unknown, opts: {
+    root: 'input' | 'output';
+}): Promise<JsonSchemaObject>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/core/protocol/features/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/core/protocol/features/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,kCAAkC;AAClC,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEvD,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAMnC;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAmB,EAAE,KAAK,SAAI,GAAG,OAAO,CAehG;AAED;;;;;;;;GAQG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,OAAO,EACf,IAAI,EAAE;IAAE,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAA;CAAE,GACjC,OAAO,CAAC,gBAAgB,CAAC,CA2C3B"}

package/dist/core/protocol/features/schema.js

@@ -0,0 +1,96 @@
+/**
+ * SEP-2106 full JSON Schema 2020-12 for tools (modern path only).
+ *
+ * The legacy path converts Zod with `target: 'jsonSchema7'` and inlines refs
+ * (`$refStrategy: 'none'`), forcing `type: "object"` on both input and output —
+ * unchanged so 2025-era clients never see unexpected keywords.
+ *
+ * On 2026-07-28 tool schemas are lifted to full JSON Schema 2020-12:
+ * - input keeps an object root but may carry `oneOf`/`anyOf`/`allOf`,
+ *   conditionals, and `$ref`/`$defs`
+ * - output is unrestricted (not forced to an object)
+ * - external `$ref` URIs are never auto-dereferenced and schema depth is bounded
+ *
+ * @module
+ */
+/** Maximum schema nesting depth accepted on the modern path (DoS guard). */
+export const MAX_SCHEMA_DEPTH = 64;
+function isZodSchema(schema) {
+    return !!schema && typeof schema === 'object' && '_def' in schema;
+}
+/**
+ * Bound the depth of a JSON schema object, replacing anything deeper than
+ * `maxDepth` with a permissive `{}` so a pathological `$defs` graph cannot blow
+ * the stack or the validator. External `$ref` URIs are left intact but are
+ * never dereferenced by NitroStack.
+ */
+export function boundSchemaDepth(value, maxDepth = MAX_SCHEMA_DEPTH, depth = 0) {
+    if (value === null || typeof value !== 'object') {
+        return value;
+    }
+    if (depth >= maxDepth) {
+        return {};
+    }
+    if (Array.isArray(value)) {
+        return value.map((v) => boundSchemaDepth(v, maxDepth, depth + 1));
+    }
+    const out = {};
+    for (const [k, v] of Object.entries(value)) {
+        out[k] = boundSchemaDepth(v, maxDepth, depth + 1);
+    }
+    return out;
+}
+/**
+ * Convert a Zod or JSON schema to JSON Schema 2020-12 for the modern era,
+ * preserving composition (`oneOf`/`anyOf`/`allOf`), conditionals, and
+ * `$ref`/`$defs`.
+ *
+ * @param schema - Zod schema or a pre-built JSON schema.
+ * @param opts.root - `'input'` forces an object root (spec requirement for tool
+ *   input); `'output'` leaves the schema unrestricted.
+ */
+export async function convertToModernJsonSchema(schema, opts) {
+    let json;
+    if (isZodSchema(schema)) {
+        try {
+            const mod = await import('zod-to-json-schema');
+            const zodToJsonSchema = mod.zodToJsonSchema
+                || mod.default;
+            // 2019-09 target keeps $ref/$defs and composition (closest widely-supported
+            // preset to 2020-12 in zod-to-json-schema); root strategy emits $defs.
+            json = zodToJsonSchema(schema, {
+                target: 'jsonSchema2019-09',
+                $refStrategy: 'root',
+            });
+            // Advertise the 2020-12 dialect explicitly (SEP-2106). zod-to-json-schema
+            // stamps a 2019-09 `$schema`; the emitted keywords are 2020-12-compatible
+            // for tool schemas, so relabel to the revision the spec requires.
+            json.$schema = 'https://json-schema.org/draft/2020-12/schema';
+        }
+        catch {
+            json = { type: 'object', properties: {}, additionalProperties: true };
+        }
+    }
+    else if (schema && typeof schema === 'object') {
+        json = { ...schema };
+    }
+    else {
+        json = {};
+    }
+    json = boundSchemaDepth(json);
+    if (opts.root === 'input') {
+        // Input schema root must be an object per spec; composition/refs are allowed
+        // alongside it but the root type stays 'object'.
+        if (!('type' in json) && !('$ref' in json)) {
+            json.type = 'object';
+        }
+        else if (json.type && json.type !== 'object') {
+            json.type = 'object';
+        }
+        // Allow additionalProperties on input schemas so clients (ChatGPT, Codex, Studio)
+        // passing _meta and other contextual parameters are not rejected with INVALID_ARGUMENT (-32602).
+        json.additionalProperties = true;
+    }
+    return json;
+}
+//# sourceMappingURL=schema.js.map

package/dist/core/protocol/features/schema.js.map

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

package/dist/core/protocol/features/trace-context.d.ts

@@ -0,0 +1,31 @@
+/**
+ * SEP-414 W3C Trace Context propagation.
+ *
+ * On the 2026-07-28 revision, distributed-tracing keys travel in the per-request
+ * `_meta` envelope under fixed names: `traceparent`, `tracestate`, `baggage`.
+ * NitroStack lifts them into `ExecutionContext.trace` so guards, interceptors,
+ * and loggers can correlate a tool call across the host, this server, and any
+ * downstream call — without NitroStack introducing its own tracing backend.
+ *
+ * @module
+ */
+/**
+ * W3C Trace Context extracted from a request `_meta` envelope.
+ */
+export interface TraceContext {
+    /** `traceparent` header value (W3C Trace Context). */
+    traceparent?: string;
+    /** `tracestate` header value. */
+    tracestate?: string;
+    /** `baggage` header value (W3C Baggage). */
+    baggage?: string;
+}
+/**
+ * Extract a `TraceContext` from an envelope/meta object, or `undefined` when no
+ * trace keys are present. Accepts either the lifted `_meta` envelope
+ * (`ctx.mcpReq.envelope`) or a raw `_meta` record; both the bare
+ * (`traceparent`) and reverse-DNS (`io.modelcontextprotocol/traceparent`)
+ * forms are recognized.
+ */
+export declare function extractTraceContext(source: Record<string, unknown> | undefined | null): TraceContext | undefined;
+//# sourceMappingURL=trace-context.d.ts.map

package/dist/core/protocol/features/trace-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-context.d.ts","sourceRoot":"","sources":["../../../../src/core/protocol/features/trace-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,GACjD,YAAY,GAAG,SAAS,CAqB1B"}