tubeless 0.3.7 → 0.3.8

package/dist/agent/mcp-http.d.ts

@@ -0,0 +1,9 @@
+import { type McpTransport, type McpTransportEvents } from "./mcp-session.js";
+/** A remote server reached over Streamable HTTP. */
+export interface McpHttpOptions {
+    readonly url: string | URL;
+    /** Sent with every request, for example an Authorization header. */
+    readonly headers?: Readonly<Record<string, string>>;
+}
+/** Streamable HTTP: each message is a POST whose JSON or event-stream body carries replies. */
+export declare function httpTransport(label: string, options: McpHttpOptions, events: Pick<McpTransportEvents, "receive">): McpTransport;

package/dist/agent/mcp-http.js

@@ -0,0 +1,129 @@
+import { isRecord, MAX_MESSAGE_BYTES, parseMessage, } from "./mcp-session.js";
+/** Preserve CRLF pairs when a network chunk ends between their two bytes. */
+async function* eventText(body) {
+    let trailingCR = "";
+    for await (const chunk of text(body)) {
+        const next = trailingCR + chunk;
+        trailingCR = next.endsWith("\r") ? "\r" : "";
+        yield (trailingCR ? next.slice(0, -1) : next).replace(/\r\n?/g, "\n");
+    }
+    if (trailingCR)
+        yield "\n";
+}
+/** Decode a bounded response body as text chunks. */
+async function* text(body) {
+    const reader = body.getReader();
+    const decoder = new TextDecoder();
+    let bytes = 0;
+    try {
+        while (true) {
+            const chunk = await reader.read();
+            if (chunk.done)
+                break;
+            bytes += chunk.value.byteLength;
+            if (bytes > MAX_MESSAGE_BYTES)
+                throw new Error("MCP response exceeds 16 MiB");
+            yield decoder.decode(chunk.value, { stream: true });
+        }
+        yield decoder.decode();
+    }
+    finally {
+        await reader.cancel().catch(() => { });
+        reader.releaseLock();
+    }
+}
+/** Yield the JSON-RPC messages carried by a JSON body or by `data` fields of an event stream. */
+async function* messages(response) {
+    if (!response.body)
+        return;
+    if (!(response.headers.get("content-type") ?? "").includes("text/event-stream")) {
+        let body = "";
+        for await (const chunk of text(response.body))
+            body += chunk;
+        if (body.trim())
+            yield parseMessage(body);
+        return;
+    }
+    let buffer = "";
+    for await (const chunk of eventText(response.body)) {
+        buffer += chunk;
+        let boundary;
+        while ((boundary = buffer.indexOf("\n\n")) >= 0) {
+            const data = buffer
+                .slice(0, boundary)
+                .split("\n")
+                .filter((line) => line.startsWith("data:"))
+                .map((line) => line.slice(line.startsWith("data: ") ? 6 : 5))
+                .join("\n");
+            buffer = buffer.slice(boundary + 2);
+            if (data)
+                yield parseMessage(data);
+        }
+    }
+}
+/** Streamable HTTP: each message is a POST whose JSON or event-stream body carries replies. */
+export function httpTransport(label, options, events) {
+    const url = new URL(options.url);
+    if (!["https:", "http:"].includes(url.protocol))
+        throw new Error(`MCP server ${label} requires an HTTP or HTTPS URL`);
+    const lifetime = new AbortController();
+    let closing;
+    let session;
+    let version;
+    const headers = () => ({
+        ...options.headers,
+        Accept: "application/json, text/event-stream",
+        "Content-Type": "application/json",
+        ...(session === undefined ? {} : { "Mcp-Session-Id": session }),
+        ...(version === undefined ? {} : { "MCP-Protocol-Version": version }),
+    });
+    return {
+        async send(message, signal) {
+            if (lifetime.signal.aborted)
+                throw new Error(`MCP server ${label} is closed`);
+            const response = await fetch(url, {
+                method: "POST",
+                headers: headers(),
+                body: JSON.stringify(message),
+                signal: AbortSignal.any([signal, lifetime.signal]),
+            });
+            if (!response.ok) {
+                await response.body?.cancel().catch(() => { });
+                throw new Error(`MCP server ${label} failed (HTTP ${response.status})`);
+            }
+            session = response.headers.get("mcp-session-id") ?? session;
+            let answered = message.id === undefined;
+            for await (const reply of messages(response)) {
+                if (reply.id === message.id && reply.method === undefined) {
+                    answered = true;
+                    // Later requests carry the version this initialize response negotiated.
+                    if (message.method === "initialize" && isRecord(reply.result))
+                        version = String(reply.result.protocolVersion);
+                }
+                events.receive(reply);
+                if (answered && message.id !== undefined)
+                    break;
+            }
+            if (!answered)
+                throw new Error(`MCP server ${label} closed the stream without a response`);
+        },
+        close() {
+            closing ??= (async () => {
+                lifetime.abort();
+                if (session === undefined)
+                    return;
+                // Servers may refuse explicit termination with 405; the session then expires on its own.
+                await fetch(url, {
+                    method: "DELETE",
+                    headers: headers(),
+                    signal: AbortSignal.timeout(5_000),
+                })
+                    .then((response) => response.body?.cancel())
+                    .catch(() => { });
+                session = undefined;
+            })();
+            return closing;
+        },
+    };
+}
+//# sourceMappingURL=mcp-http.js.map

package/dist/agent/mcp-http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-http.js","sourceRoot":"","sources":["../../src/agent/mcp-http.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  isRecord,\n  MAX_MESSAGE_BYTES,\n  parseMessage,\n  type McpTransport,\n  type McpTransportEvents,\n} from \"./mcp-session.js\";\n\n/** A remote server reached over Streamable HTTP. */\nexport interface McpHttpOptions {\n  readonly url: string | URL;\n  /** Sent with every request, for example an Authorization header. */\n  readonly headers?: Readonly<Record<string, string>>;\n}\n\n/** Preserve CRLF pairs when a network chunk ends between their two bytes. */\nasync function* eventText(body: ReadableStream<Uint8Array>) {\n  let trailingCR = \"\";\n  for await (const chunk of text(body)) {\n    const next = trailingCR + chunk;\n    trailingCR = next.endsWith(\"\\r\") ? \"\\r\" : \"\";\n    yield (trailingCR ? next.slice(0, -1) : next).replace(/\\r\\n?/g, \"\\n\");\n  }\n  if (trailingCR) yield \"\\n\";\n}\n\n/** Decode a bounded response body as text chunks. */\nasync function* text(body: ReadableStream<Uint8Array>) {\n  const reader = body.getReader();\n  const decoder = new TextDecoder();\n  let bytes = 0;\n  try {\n    while (true) {\n      const chunk = await reader.read();\n      if (chunk.done) break;\n      bytes += chunk.value.byteLength;\n      if (bytes > MAX_MESSAGE_BYTES) throw new Error(\"MCP response exceeds 16 MiB\");\n      yield decoder.decode(chunk.value, { stream: true });\n    }\n    yield decoder.decode();\n  } finally {\n    await reader.cancel().catch(() => {});\n    reader.releaseLock();\n  }\n}\n\n/** Yield the JSON-RPC messages carried by a JSON body or by `data` fields of an event stream. */\nasync function* messages(response: Response) {\n  if (!response.body) return;\n  if (!(response.headers.get(\"content-type\") ?? \"\").includes(\"text/event-stream\")) {\n    let body = \"\";\n    for await (const chunk of text(response.body)) body += chunk;\n    if (body.trim()) yield parseMessage(body);\n    return;\n  }\n  let buffer = \"\";\n  for await (const chunk of eventText(response.body)) {\n    buffer += chunk;\n    let boundary: number;\n    while ((boundary = buffer.indexOf(\"\\n\\n\")) >= 0) {\n      const data = buffer\n        .slice(0, boundary)\n        .split(\"\\n\")\n        .filter((line) => line.startsWith(\"data:\"))\n        .map((line) => line.slice(line.startsWith(\"data: \") ? 6 : 5))\n        .join(\"\\n\");\n      buffer = buffer.slice(boundary + 2);\n      if (data) yield parseMessage(data);\n    }\n  }\n}\n\n/** Streamable HTTP: each message is a POST whose JSON or event-stream body carries replies. */\nexport function httpTransport(\n  label: string,\n  options: McpHttpOptions,\n  events: Pick<McpTransportEvents, \"receive\">\n): McpTransport {\n  const url = new URL(options.url);\n  if (![\"https:\", \"http:\"].includes(url.protocol))\n    throw new Error(`MCP server ${label} requires an HTTP or HTTPS URL`);\n  const lifetime = new AbortController();\n  let closing: Promise<void> | undefined;\n  let session: string | undefined;\n  let version: string | undefined;\n  const headers = () => ({\n    ...options.headers,\n    Accept: \"application/json, text/event-stream\",\n    \"Content-Type\": \"application/json\",\n    ...(session === undefined ? {} : { \"Mcp-Session-Id\": session }),\n    ...(version === undefined ? {} : { \"MCP-Protocol-Version\": version }),\n  });\n  return {\n    async send(message, signal) {\n      if (lifetime.signal.aborted) throw new Error(`MCP server ${label} is closed`);\n      const response = await fetch(url, {\n        method: \"POST\",\n        headers: headers(),\n        body: JSON.stringify(message),\n        signal: AbortSignal.any([signal, lifetime.signal]),\n      });\n      if (!response.ok) {\n        await response.body?.cancel().catch(() => {});\n        throw new Error(`MCP server ${label} failed (HTTP ${response.status})`);\n      }\n      session = response.headers.get(\"mcp-session-id\") ?? session;\n      let answered = message.id === undefined;\n      for await (const reply of messages(response)) {\n        if (reply.id === message.id && reply.method === undefined) {\n          answered = true;\n          // Later requests carry the version this initialize response negotiated.\n          if (message.method === \"initialize\" && isRecord(reply.result))\n            version = String(reply.result.protocolVersion);\n        }\n        events.receive(reply);\n        if (answered && message.id !== undefined) break;\n      }\n      if (!answered) throw new Error(`MCP server ${label} closed the stream without a response`);\n    },\n    close() {\n      closing ??= (async () => {\n        lifetime.abort();\n        if (session === undefined) return;\n        // Servers may refuse explicit termination with 405; the session then expires on its own.\n        await fetch(url, {\n          method: \"DELETE\",\n          headers: headers(),\n          signal: AbortSignal.timeout(5_000),\n        })\n          .then((response) => response.body?.cancel())\n          .catch(() => {});\n        session = undefined;\n      })();\n      return closing;\n    },\n  };\n}\n"]}

package/dist/agent/mcp-schema.d.ts

@@ -0,0 +1,12 @@
+import type { StandardSchemaV1 } from "../core/pipeline-types.js";
+/** Adapt an MCP tool input schema to a strict model descriptor and an argument decoder. */
+export declare function mcpInputSchema(inputSchema: unknown): StandardSchemaV1<Record<string, unknown>>;
+/** Content and optional structured data returned by an MCP tool call. */
+export interface McpToolResult {
+    readonly content: readonly Readonly<Record<string, unknown> & {
+        type: string;
+    }>[];
+    readonly structuredContent?: Readonly<Record<string, unknown>>;
+}
+/** Validate a raw `tools/call` result into the content the agent observes. */
+export declare const mcpResultSchema: StandardSchemaV1<unknown, McpToolResult>;

package/dist/agent/mcp-schema.js

@@ -0,0 +1,264 @@
+import { canonicalJsonValue } from "../utilities/canonical-json.js";
+import { isRecord } from "./mcp-session.js";
+/** Charge source data and every expanded copy before retaining its descriptor. */
+function expansionBudget() {
+    let nodes = 0;
+    let characters = 0;
+    const charge = (value, depth) => {
+        if (++nodes > 10_000 || depth > 64)
+            throw new Error("MCP input schema exceeds expansion limits");
+        if (typeof value === "string") {
+            characters += value.length;
+            if (characters > 1_048_576)
+                throw new Error("MCP input schema exceeds expansion limits");
+        }
+        else if (Array.isArray(value)) {
+            for (const child of value)
+                charge(child, depth + 1);
+        }
+        else if (isRecord(value)) {
+            for (const [key, child] of Object.entries(value)) {
+                charge(key, depth + 1);
+                charge(child, depth + 1);
+            }
+        }
+    };
+    return charge;
+}
+const jsonEqual = (left, right) => JSON.stringify(canonicalJsonValue(left)) === JSON.stringify(canonicalJsonValue(right));
+const objectSchema = (schema) => schema.type === "object" ||
+    (Array.isArray(schema.type) && schema.type.includes("object")) ||
+    Object.hasOwn(schema, "properties");
+// These constructs cannot be rewritten and decoded with the same structural rules.
+const UNSUPPORTED = [
+    "oneOf",
+    "allOf",
+    "prefixItems",
+    "not",
+    "if",
+    "then",
+    "else",
+    "contains",
+    "additionalItems",
+    "patternProperties",
+    "dependentSchemas",
+    "dependencies",
+    "unevaluatedProperties",
+    "unevaluatedItems",
+    "$dynamicRef",
+    "$recursiveRef",
+];
+const REFERENCE_ANNOTATIONS = [
+    "title",
+    "description",
+    "default",
+    "examples",
+    "deprecated",
+    "readOnly",
+    "writeOnly",
+    "$comment",
+    "$schema",
+    "$defs",
+    "definitions",
+];
+/** Inline references and rewrite supported schema positions in one traversal. */
+function strict(schema, context, seen = [], depth = 0) {
+    const { root, optional, charge } = context;
+    charge(null, depth);
+    if (!isRecord(schema))
+        throw new Error("MCP input schemas must be JSON Schema objects");
+    for (const keyword of UNSUPPORTED)
+        if (Object.hasOwn(schema, keyword))
+            throw new Error(`Unsupported MCP schema keyword ${keyword}`);
+    if (schema.additionalProperties !== undefined && schema.additionalProperties !== false)
+        throw new Error("MCP input schemas do not support free-form objects");
+    if (Array.isArray(schema.items))
+        throw new Error("MCP input schemas do not support tuple items");
+    const { $ref, ...rest } = schema;
+    if (typeof $ref === "string") {
+        if (Object.keys(rest).some((key) => !REFERENCE_ANNOTATIONS.includes(key)))
+            throw new Error("MCP schema references do not support validation siblings");
+        const match = /^#\/(\$defs|definitions)\/(.+)$/.exec($ref);
+        let target = root;
+        for (const part of $ref.slice(2).split("/")) {
+            const key = part.replace(/~1/g, "/").replace(/~0/g, "~");
+            target = isRecord(target) && Object.hasOwn(target, key) ? target[key] : undefined;
+        }
+        if (!match || !isRecord(target))
+            throw new Error(`Unsupported MCP schema reference ${$ref}`);
+        if (seen.includes($ref))
+            throw new Error(`Recursive MCP schema reference ${$ref}`);
+        return strict({ ...target, ...rest }, context, [...seen, $ref], depth + 1);
+    }
+    const { $defs: _defs, definitions: _definitions, $schema: _dialect, ...body } = rest;
+    const { properties: _properties, items: _items, anyOf: _anyOf, ...literals } = body;
+    charge(literals, depth);
+    const result = { ...body };
+    if (schema.items !== undefined)
+        result.items = strict(schema.items, context, seen, depth + 1);
+    if (Array.isArray(schema.anyOf))
+        result.anyOf = schema.anyOf.map((child) => strict(child, context, seen, depth + 1));
+    if (!objectSchema(schema))
+        return result;
+    const properties = isRecord(schema.properties) ? schema.properties : {};
+    const required = schema.required ?? [];
+    if (!Array.isArray(required) ||
+        required.some((name) => typeof name !== "string" || !Object.hasOwn(properties, name)))
+        throw new Error("MCP required names must be declared in properties");
+    result.properties = Object.fromEntries(Object.entries(properties).map(([name, child]) => {
+        charge(name, depth + 1);
+        const field = strict(child, context, seen, depth + 1);
+        if (required.includes(name))
+            return [name, field];
+        if (acceptsNull(field, optional))
+            throw new Error(`Optional MCP property ${name} already accepts null; omission would be ambiguous`);
+        const wrapper = { anyOf: [field, { type: "null" }] };
+        optional.add(wrapper);
+        return [name, wrapper];
+    }));
+    result.required = Object.keys(properties);
+    result.additionalProperties = false;
+    return result;
+}
+function typeMatches(type, value) {
+    if (Array.isArray(type))
+        return type.some((option) => typeMatches(option, value));
+    switch (type) {
+        case "object":
+            return isRecord(value);
+        case "array":
+            return Array.isArray(value);
+        case "string":
+            return typeof value === "string";
+        case "integer":
+            return Number.isSafeInteger(value);
+        case "number":
+            return typeof value === "number" && Number.isFinite(value);
+        case "boolean":
+            return typeof value === "boolean";
+        case "null":
+            return value === null;
+        default:
+            return true;
+    }
+}
+/**
+ * Check structure against the strict descriptor and drop the nulls it substitutes for
+ * omitted optional properties. The MCP server remains the authority for its full schema.
+ */
+function decode(schema, value, path, optional) {
+    if (!isRecord(schema))
+        return value;
+    if (schema.type !== undefined && !typeMatches(schema.type, value))
+        throw new Error(`${path} must be ${JSON.stringify(schema.type)}`);
+    if (Array.isArray(schema.enum) && !schema.enum.some((option) => jsonEqual(option, value)))
+        throw new Error(`${path} must be one of ${JSON.stringify(schema.enum)}`);
+    if (Object.hasOwn(schema, "const") && !jsonEqual(schema.const, value))
+        throw new Error(`${path} must be ${JSON.stringify(schema.const)}`);
+    // Sibling constraints must see the original input, before any branch removes placeholders.
+    let decoded = value;
+    if (Array.isArray(value)) {
+        decoded = value.map((item, index) => decode(schema.items, item, `${path}[${index}]`, optional));
+    }
+    else if (isRecord(value) && objectSchema(schema)) {
+        const properties = isRecord(schema.properties) ? schema.properties : {};
+        for (const name of Array.isArray(schema.required) ? schema.required : [])
+            if (!Object.hasOwn(value, name))
+                throw new Error(`${path}.${name} is required`);
+        const entries = [];
+        for (const [name, child] of Object.entries(value)) {
+            const property = properties[name];
+            if (!Object.hasOwn(properties, name)) {
+                if (schema.additionalProperties === false)
+                    throw new Error(`${path}.${name} is not allowed`);
+                entries.push([name, child]);
+            }
+            else if (!(child === null && isRecord(property) && optional.has(property)))
+                entries.push([name, decode(property, child, `${path}.${name}`, optional)]);
+        }
+        decoded = Object.fromEntries(entries);
+    }
+    if (!Array.isArray(schema.anyOf))
+        return decoded;
+    const alternative = decodeAny(schema.anyOf, value, path, optional);
+    if (objectSchema(schema) || (Array.isArray(value) && schema.items !== undefined)) {
+        if (!jsonEqual(decoded, alternative))
+            throw new Error(`${path} has conflicting anyOf decoding`);
+        return decoded;
+    }
+    return alternative;
+}
+function decodeAny(options, value, path, optional) {
+    const matches = [];
+    for (const option of options) {
+        try {
+            const decoded = decode(option, value, path, optional);
+            matches.push(decoded);
+        }
+        catch {
+            // Try the next alternative.
+        }
+    }
+    if (matches.length === 0)
+        throw new Error(`${path} matches no allowed schema`);
+    if (matches.some((match) => !jsonEqual(match, matches[0])))
+        throw new Error(`${path} has ambiguous anyOf decoding`);
+    return matches[0];
+}
+function acceptsNull(schema, optional) {
+    try {
+        decode(schema, null, "input", optional);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Adapt an MCP tool input schema to a strict model descriptor and an argument decoder. */
+export function mcpInputSchema(inputSchema) {
+    if (!isRecord(inputSchema) || inputSchema.type !== "object")
+        throw new Error("MCP tool inputSchema must be a JSON Schema object");
+    const optional = new WeakSet();
+    const charge = expansionBudget();
+    charge(inputSchema, 0);
+    const descriptor = strict(inputSchema, { root: inputSchema, optional, charge });
+    return {
+        "~standard": {
+            version: 1,
+            vendor: "tubeless-mcp",
+            jsonSchema: { input: () => descriptor },
+            validate(value) {
+                try {
+                    // SAFETY: the descriptor's root is an object schema, so decoding yields a record.
+                    return { value: decode(descriptor, value, "input", optional) };
+                }
+                catch (error) {
+                    return { issues: [{ message: error instanceof Error ? error.message : String(error) }] };
+                }
+            },
+        },
+    };
+}
+/** Validate a raw `tools/call` result into the content the agent observes. */
+export const mcpResultSchema = {
+    "~standard": {
+        version: 1,
+        vendor: "tubeless-mcp",
+        validate(value) {
+            if (!isRecord(value) ||
+                !Array.isArray(value.content) ||
+                !value.content.every((item) => isRecord(item) && typeof item.type === "string") ||
+                (value.structuredContent !== undefined && !isRecord(value.structuredContent)))
+                return { issues: [{ message: "MCP tool returned an invalid result" }] };
+            return {
+                value: {
+                    content: value.content,
+                    ...(value.structuredContent === undefined
+                        ? {}
+                        : { structuredContent: value.structuredContent }),
+                },
+            };
+        },
+    },
+};
+//# sourceMappingURL=mcp-schema.js.map

package/dist/agent/mcp-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-schema.js","sourceRoot":"","sources":["../../src/agent/mcp-schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAU5C,kFAAkF;AAClF,SAAS,eAAe;IACtB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,MAAM,MAAM,GAAG,CAAC,KAAc,EAAE,KAAa,EAAQ,EAAE;QACrD,IAAI,EAAE,KAAK,GAAG,MAAM,IAAI,KAAK,GAAG,EAAE;YAChC,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,UAAU,IAAI,KAAK,CAAC,MAAM,CAAC;YAC3B,IAAI,UAAU,GAAG,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC3F,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,KAAK,MAAM,KAAK,IAAI,KAAK;gBAAE,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QACtD,CAAC;aAAM,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjD,MAAM,CAAC,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;gBACvB,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,SAAS,GAAG,CAAC,IAAa,EAAE,KAAc,EAAE,EAAE,CAClD,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;AAEzF,MAAM,YAAY,GAAG,CAAC,MAAY,EAAE,EAAE,CACpC,MAAM,CAAC,IAAI,KAAK,QAAQ;IACxB,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC9D,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAEtC,mFAAmF;AACnF,MAAM,WAAW,GAAG;IAClB,OAAO;IACP,OAAO;IACP,aAAa;IACb,KAAK;IACL,IAAI;IACJ,MAAM;IACN,MAAM;IACN,UAAU;IACV,iBAAiB;IACjB,mBAAmB;IACnB,kBAAkB;IAClB,cAAc;IACd,uBAAuB;IACvB,kBAAkB;IAClB,aAAa;IACb,eAAe;CAChB,CAAC;AAEF,MAAM,qBAAqB,GAAG;IAC5B,OAAO;IACP,aAAa;IACb,SAAS;IACT,UAAU;IACV,YAAY;IACZ,UAAU;IACV,WAAW;IACX,UAAU;IACV,SAAS;IACT,OAAO;IACP,aAAa;CACd,CAAC;AAEF,iFAAiF;AACjF,SAAS,MAAM,CACb,MAAe,EACf,OAAsB,EACtB,IAAI,GAAsB,EAAE,EAC5B,KAAK,GAAG,CAAC;IAET,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC3C,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACpB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACxF,KAAK,MAAM,OAAO,IAAI,WAAW;QAC/B,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,kCAAkC,OAAO,EAAE,CAAC,CAAC;IACjE,IAAI,MAAM,CAAC,oBAAoB,KAAK,SAAS,IAAI,MAAM,CAAC,oBAAoB,KAAK,KAAK;QACpF,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IACjG,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IACjC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,qBAAqB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YACvE,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;QAC9E,MAAM,KAAK,GAAG,iCAAiC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3D,IAAI,MAAM,GAAY,IAAI,CAAC;QAC3B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACzD,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACpF,CAAC;QACD,IAAI,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,IAAI,EAAE,CAAC,CAAC;QAC7F,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,EAAE,CAAC,CAAC;QACnF,OAAO,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;IAC7E,CAAC;IACD,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;IACrF,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,GAAG,IAAI,CAAC;IACpF,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACxB,MAAM,MAAM,GAA4B,EAAE,GAAG,IAAI,EAAE,CAAC;IACpD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;QAAE,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;IAC9F,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QAC7B,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;IACtF,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IACzC,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;IACvC,IACE,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;QACxB,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAErF,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,WAAW,CACpC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE;QAC/C,MAAM,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QACxB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QACtD,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAClD,IAAI,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC;YAC9B,MAAM,IAAI,KAAK,CACb,yBAAyB,IAAI,oDAAoD,CAClF,CAAC;QACJ,MAAM,OAAO,GAAG,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QACrD,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACtB,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACzB,CAAC,CAAC,CACH,CAAC;IACF,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC1C,MAAM,CAAC,oBAAoB,GAAG,KAAK,CAAC;IACpC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,WAAW,CAAC,IAAa,EAAE,KAAc;IAChD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IAClF,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC;QACzB,KAAK,OAAO;YACV,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC9B,KAAK,QAAQ;YACX,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;QACnC,KAAK,SAAS;YACZ,OAAO,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACrC,KAAK,QAAQ;YACX,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC7D,KAAK,SAAS;YACZ,OAAO,OAAO,KAAK,KAAK,SAAS,CAAC;QACpC,KAAK,MAAM;YACT,OAAO,KAAK,KAAK,IAAI,CAAC;QACxB;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,MAAM,CAAC,MAAe,EAAE,KAAc,EAAE,IAAY,EAAE,QAAyB;IACtF,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IACpC,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,YAAY,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpE,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACvF,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,mBAAmB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3E,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,YAAY,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACrE,2FAA2F;IAC3F,IAAI,OAAO,GAAY,KAAK,CAAC;IAC7B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;IAClG,CAAC;SAAM,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;YACtE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,IAAI,IAAI,cAAc,CAAC,CAAC;QAClF,MAAM,OAAO,GAAwB,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAClD,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;YAClC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,CAAC;gBACrC,IAAI,MAAM,CAAC,oBAAoB,KAAK,KAAK;oBACvC,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,IAAI,IAAI,iBAAiB,CAAC,CAAC;gBACpD,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;YAC9B,CAAC;iBAAM,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBAC1E,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,IAAI,IAAI,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC/E,CAAC;QACD,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACjD,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IACnE,IAAI,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,EAAE,CAAC;QACjF,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,WAAW,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,iCAAiC,CAAC,CAAC;QAChG,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,SAAS,SAAS,CAAC,OAAkB,EAAE,KAAc,EAAE,IAAY,EAAE,QAAyB;IAC5F,MAAM,OAAO,GAAc,EAAE,CAAC;IAC9B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;YACtD,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;QAAC,MAAM,CAAC;YACP,4BAA4B;QAC9B,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,4BAA4B,CAAC,CAAC;IAC/E,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,+BAA+B,CAAC,CAAC;IAC1D,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC;AAED,SAAS,WAAW,CAAC,MAAY,EAAE,QAAyB;IAC1D,IAAI,CAAC;QACH,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,cAAc,CAAC,WAAoB;IACjD,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,WAAW,CAAC,IAAI,KAAK,QAAQ;QACzD,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAU,CAAC;IACvC,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IACjC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IACvB,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IAChF,OAAO;QACL,WAAW,EAAE;YACX,OAAO,EAAE,CAAC;YACV,MAAM,EAAE,cAAc;YACtB,UAAU,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE;YACvC,QAAQ,CAAC,KAAK;gBACZ,IAAI,CAAC;oBACH,kFAAkF;oBAClF,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAA4B,EAAE,CAAC;gBAC5F,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC3F,CAAC;YACH,CAAC;SACF;KACF,CAAC;AACJ,CAAC;AAQD,8EAA8E;AAC9E,MAAM,CAAC,MAAM,eAAe,GAA6C;IACvE,WAAW,EAAE;QACX,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,cAAc;QACtB,QAAQ,CAAC,KAAK;YACZ,IACE,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAChB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;gBAC7B,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC;gBAC/E,CAAC,KAAK,CAAC,iBAAiB,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;gBAE7E,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC,EAAE,CAAC;YAC1E,OAAO;gBACL,KAAK,EAAE;oBACL,OAAO,EAAE,KAAK,CAAC,OAAmC;oBAClD,GAAG,CAAC,KAAK,CAAC,iBAAiB,KAAK,SAAS;wBACvC,CAAC,CAAC,EAAE;wBACJ,CAAC,CAAC,EAAE,iBAAiB,EAAE,KAAK,CAAC,iBAAyB,EAAE,CAAC;iBAC5D;aACF,CAAC;QACJ,CAAC;KACF;CACF,CAAC","sourcesContent":["import type { StandardSchemaV1 } from \"../core/pipeline-types.js\";\nimport { canonicalJsonValue } from \"../utilities/canonical-json.js\";\nimport { isRecord } from \"./mcp-session.js\";\n\ntype Json = Readonly<Record<string, unknown>>;\n\ninterface SchemaContext {\n  readonly root: Json;\n  readonly optional: WeakSet<object>;\n  charge(value: unknown, depth: number): void;\n}\n\n/** Charge source data and every expanded copy before retaining its descriptor. */\nfunction expansionBudget() {\n  let nodes = 0;\n  let characters = 0;\n  const charge = (value: unknown, depth: number): void => {\n    if (++nodes > 10_000 || depth > 64)\n      throw new Error(\"MCP input schema exceeds expansion limits\");\n    if (typeof value === \"string\") {\n      characters += value.length;\n      if (characters > 1_048_576) throw new Error(\"MCP input schema exceeds expansion limits\");\n    } else if (Array.isArray(value)) {\n      for (const child of value) charge(child, depth + 1);\n    } else if (isRecord(value)) {\n      for (const [key, child] of Object.entries(value)) {\n        charge(key, depth + 1);\n        charge(child, depth + 1);\n      }\n    }\n  };\n  return charge;\n}\n\nconst jsonEqual = (left: unknown, right: unknown) =>\n  JSON.stringify(canonicalJsonValue(left)) === JSON.stringify(canonicalJsonValue(right));\n\nconst objectSchema = (schema: Json) =>\n  schema.type === \"object\" ||\n  (Array.isArray(schema.type) && schema.type.includes(\"object\")) ||\n  Object.hasOwn(schema, \"properties\");\n\n// These constructs cannot be rewritten and decoded with the same structural rules.\nconst UNSUPPORTED = [\n  \"oneOf\",\n  \"allOf\",\n  \"prefixItems\",\n  \"not\",\n  \"if\",\n  \"then\",\n  \"else\",\n  \"contains\",\n  \"additionalItems\",\n  \"patternProperties\",\n  \"dependentSchemas\",\n  \"dependencies\",\n  \"unevaluatedProperties\",\n  \"unevaluatedItems\",\n  \"$dynamicRef\",\n  \"$recursiveRef\",\n];\n\nconst REFERENCE_ANNOTATIONS = [\n  \"title\",\n  \"description\",\n  \"default\",\n  \"examples\",\n  \"deprecated\",\n  \"readOnly\",\n  \"writeOnly\",\n  \"$comment\",\n  \"$schema\",\n  \"$defs\",\n  \"definitions\",\n];\n\n/** Inline references and rewrite supported schema positions in one traversal. */\nfunction strict(\n  schema: unknown,\n  context: SchemaContext,\n  seen: readonly string[] = [],\n  depth = 0\n): Json {\n  const { root, optional, charge } = context;\n  charge(null, depth);\n  if (!isRecord(schema)) throw new Error(\"MCP input schemas must be JSON Schema objects\");\n  for (const keyword of UNSUPPORTED)\n    if (Object.hasOwn(schema, keyword))\n      throw new Error(`Unsupported MCP schema keyword ${keyword}`);\n  if (schema.additionalProperties !== undefined && schema.additionalProperties !== false)\n    throw new Error(\"MCP input schemas do not support free-form objects\");\n  if (Array.isArray(schema.items)) throw new Error(\"MCP input schemas do not support tuple items\");\n  const { $ref, ...rest } = schema;\n  if (typeof $ref === \"string\") {\n    if (Object.keys(rest).some((key) => !REFERENCE_ANNOTATIONS.includes(key)))\n      throw new Error(\"MCP schema references do not support validation siblings\");\n    const match = /^#\\/(\\$defs|definitions)\\/(.+)$/.exec($ref);\n    let target: unknown = root;\n    for (const part of $ref.slice(2).split(\"/\")) {\n      const key = part.replace(/~1/g, \"/\").replace(/~0/g, \"~\");\n      target = isRecord(target) && Object.hasOwn(target, key) ? target[key] : undefined;\n    }\n    if (!match || !isRecord(target)) throw new Error(`Unsupported MCP schema reference ${$ref}`);\n    if (seen.includes($ref)) throw new Error(`Recursive MCP schema reference ${$ref}`);\n    return strict({ ...target, ...rest }, context, [...seen, $ref], depth + 1);\n  }\n  const { $defs: _defs, definitions: _definitions, $schema: _dialect, ...body } = rest;\n  const { properties: _properties, items: _items, anyOf: _anyOf, ...literals } = body;\n  charge(literals, depth);\n  const result: Record<string, unknown> = { ...body };\n  if (schema.items !== undefined) result.items = strict(schema.items, context, seen, depth + 1);\n  if (Array.isArray(schema.anyOf))\n    result.anyOf = schema.anyOf.map((child) => strict(child, context, seen, depth + 1));\n  if (!objectSchema(schema)) return result;\n  const properties = isRecord(schema.properties) ? schema.properties : {};\n  const required = schema.required ?? [];\n  if (\n    !Array.isArray(required) ||\n    required.some((name) => typeof name !== \"string\" || !Object.hasOwn(properties, name))\n  )\n    throw new Error(\"MCP required names must be declared in properties\");\n  result.properties = Object.fromEntries(\n    Object.entries(properties).map(([name, child]) => {\n      charge(name, depth + 1);\n      const field = strict(child, context, seen, depth + 1);\n      if (required.includes(name)) return [name, field];\n      if (acceptsNull(field, optional))\n        throw new Error(\n          `Optional MCP property ${name} already accepts null; omission would be ambiguous`\n        );\n      const wrapper = { anyOf: [field, { type: \"null\" }] };\n      optional.add(wrapper);\n      return [name, wrapper];\n    })\n  );\n  result.required = Object.keys(properties);\n  result.additionalProperties = false;\n  return result;\n}\n\nfunction typeMatches(type: unknown, value: unknown): boolean {\n  if (Array.isArray(type)) return type.some((option) => typeMatches(option, value));\n  switch (type) {\n    case \"object\":\n      return isRecord(value);\n    case \"array\":\n      return Array.isArray(value);\n    case \"string\":\n      return typeof value === \"string\";\n    case \"integer\":\n      return Number.isSafeInteger(value);\n    case \"number\":\n      return typeof value === \"number\" && Number.isFinite(value);\n    case \"boolean\":\n      return typeof value === \"boolean\";\n    case \"null\":\n      return value === null;\n    default:\n      return true;\n  }\n}\n\n/**\n * Check structure against the strict descriptor and drop the nulls it substitutes for\n * omitted optional properties. The MCP server remains the authority for its full schema.\n */\nfunction decode(schema: unknown, value: unknown, path: string, optional: WeakSet<object>): unknown {\n  if (!isRecord(schema)) return value;\n  if (schema.type !== undefined && !typeMatches(schema.type, value))\n    throw new Error(`${path} must be ${JSON.stringify(schema.type)}`);\n  if (Array.isArray(schema.enum) && !schema.enum.some((option) => jsonEqual(option, value)))\n    throw new Error(`${path} must be one of ${JSON.stringify(schema.enum)}`);\n  if (Object.hasOwn(schema, \"const\") && !jsonEqual(schema.const, value))\n    throw new Error(`${path} must be ${JSON.stringify(schema.const)}`);\n  // Sibling constraints must see the original input, before any branch removes placeholders.\n  let decoded: unknown = value;\n  if (Array.isArray(value)) {\n    decoded = value.map((item, index) => decode(schema.items, item, `${path}[${index}]`, optional));\n  } else if (isRecord(value) && objectSchema(schema)) {\n    const properties = isRecord(schema.properties) ? schema.properties : {};\n    for (const name of Array.isArray(schema.required) ? schema.required : [])\n      if (!Object.hasOwn(value, name)) throw new Error(`${path}.${name} is required`);\n    const entries: [string, unknown][] = [];\n    for (const [name, child] of Object.entries(value)) {\n      const property = properties[name];\n      if (!Object.hasOwn(properties, name)) {\n        if (schema.additionalProperties === false)\n          throw new Error(`${path}.${name} is not allowed`);\n        entries.push([name, child]);\n      } else if (!(child === null && isRecord(property) && optional.has(property)))\n        entries.push([name, decode(property, child, `${path}.${name}`, optional)]);\n    }\n    decoded = Object.fromEntries(entries);\n  }\n  if (!Array.isArray(schema.anyOf)) return decoded;\n  const alternative = decodeAny(schema.anyOf, value, path, optional);\n  if (objectSchema(schema) || (Array.isArray(value) && schema.items !== undefined)) {\n    if (!jsonEqual(decoded, alternative)) throw new Error(`${path} has conflicting anyOf decoding`);\n    return decoded;\n  }\n  return alternative;\n}\n\nfunction decodeAny(options: unknown[], value: unknown, path: string, optional: WeakSet<object>) {\n  const matches: unknown[] = [];\n  for (const option of options) {\n    try {\n      const decoded = decode(option, value, path, optional);\n      matches.push(decoded);\n    } catch {\n      // Try the next alternative.\n    }\n  }\n  if (matches.length === 0) throw new Error(`${path} matches no allowed schema`);\n  if (matches.some((match) => !jsonEqual(match, matches[0])))\n    throw new Error(`${path} has ambiguous anyOf decoding`);\n  return matches[0];\n}\n\nfunction acceptsNull(schema: Json, optional: WeakSet<object>): boolean {\n  try {\n    decode(schema, null, \"input\", optional);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/** Adapt an MCP tool input schema to a strict model descriptor and an argument decoder. */\nexport function mcpInputSchema(inputSchema: unknown): StandardSchemaV1<Record<string, unknown>> {\n  if (!isRecord(inputSchema) || inputSchema.type !== \"object\")\n    throw new Error(\"MCP tool inputSchema must be a JSON Schema object\");\n  const optional = new WeakSet<object>();\n  const charge = expansionBudget();\n  charge(inputSchema, 0);\n  const descriptor = strict(inputSchema, { root: inputSchema, optional, charge });\n  return {\n    \"~standard\": {\n      version: 1,\n      vendor: \"tubeless-mcp\",\n      jsonSchema: { input: () => descriptor },\n      validate(value) {\n        try {\n          // SAFETY: the descriptor's root is an object schema, so decoding yields a record.\n          return { value: decode(descriptor, value, \"input\", optional) as Record<string, unknown> };\n        } catch (error) {\n          return { issues: [{ message: error instanceof Error ? error.message : String(error) }] };\n        }\n      },\n    },\n  };\n}\n\n/** Content and optional structured data returned by an MCP tool call. */\nexport interface McpToolResult {\n  readonly content: readonly Readonly<Record<string, unknown> & { type: string }>[];\n  readonly structuredContent?: Readonly<Record<string, unknown>>;\n}\n\n/** Validate a raw `tools/call` result into the content the agent observes. */\nexport const mcpResultSchema: StandardSchemaV1<unknown, McpToolResult> = {\n  \"~standard\": {\n    version: 1,\n    vendor: \"tubeless-mcp\",\n    validate(value) {\n      if (\n        !isRecord(value) ||\n        !Array.isArray(value.content) ||\n        !value.content.every((item) => isRecord(item) && typeof item.type === \"string\") ||\n        (value.structuredContent !== undefined && !isRecord(value.structuredContent))\n      )\n        return { issues: [{ message: \"MCP tool returned an invalid result\" }] };\n      return {\n        value: {\n          content: value.content as McpToolResult[\"content\"],\n          ...(value.structuredContent === undefined\n            ? {}\n            : { structuredContent: value.structuredContent as Json }),\n        },\n      };\n    },\n  },\n};\n"]}

package/dist/agent/mcp-session.d.ts

@@ -0,0 +1,38 @@
+export interface McpMessage {
+    readonly jsonrpc: "2.0";
+    readonly id?: number | string;
+    readonly method?: string;
+    readonly params?: unknown;
+    readonly result?: unknown;
+    readonly error?: {
+        readonly code: number;
+        readonly message: string;
+    };
+}
+/** Inbound traffic: every received message, or a failure that ends the connection. */
+export interface McpTransportEvents {
+    receive(message: McpMessage): void;
+    fail(error: Error): void;
+}
+/** Carries JSON-RPC messages; the session owns ids, deadlines, replies and lifecycle. */
+export interface McpTransport {
+    /** Deliver one message; any replies arrive through `receive`. */
+    send(message: McpMessage, signal: AbortSignal): Promise<void>;
+    close(): Promise<void>;
+}
+export type OpenMcpTransport = (events: McpTransportEvents) => Promise<McpTransport>;
+/** A JSON-RPC error returned by the server; the connection remains usable. */
+export declare class McpRpcError extends Error {
+    readonly code: number;
+    constructor(code: number, message: string);
+}
+export declare const MAX_MESSAGE_BYTES = 16777216;
+export declare function isRecord(value: unknown): value is Readonly<Record<string, unknown>>;
+/** Parse one inbound message, rejecting shapes that cannot be JSON-RPC. */
+export declare function parseMessage(text: string): McpMessage;
+export interface McpSession {
+    request(method: string, params: object, signal?: AbortSignal): Promise<unknown>;
+    close(): Promise<void>;
+}
+/** Initialize a session: version negotiation, the initialized notification, then requests. */
+export declare function openMcpSession(open: OpenMcpTransport, label: string, timeoutMs: number, signal?: AbortSignal): Promise<McpSession>;

package/dist/agent/mcp-session.js

@@ -0,0 +1,123 @@
+import { createAbortError, throwIfAborted } from "../utilities/abort.js";
+/** A JSON-RPC error returned by the server; the connection remains usable. */
+export class McpRpcError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "McpRpcError";
+    }
+}
+export const MAX_MESSAGE_BYTES = 16_777_216;
+const PROTOCOL_VERSIONS = ["2025-06-18", "2025-03-26", "2024-11-05"];
+export function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+/** Parse one inbound message, rejecting shapes that cannot be JSON-RPC. */
+export function parseMessage(text) {
+    let message;
+    try {
+        message = JSON.parse(text);
+    }
+    catch {
+        throw new Error("MCP server sent invalid JSON");
+    }
+    if (!isRecord(message) || message.jsonrpc !== "2.0")
+        throw new Error("MCP server sent an invalid JSON-RPC message");
+    // SAFETY: the version guard identifies JSON-RPC; fields are checked where they are consumed.
+    return message;
+}
+/** This client declares no capabilities: answer pings and refuse every other server request. */
+function reply(request) {
+    return request.method === "ping"
+        ? { jsonrpc: "2.0", id: request.id, result: {} }
+        : {
+            jsonrpc: "2.0",
+            id: request.id,
+            error: { code: -32601, message: `Unsupported method ${request.method}` },
+        };
+}
+/** Initialize a session: version negotiation, the initialized notification, then requests. */
+export async function openMcpSession(open, label, timeoutMs, signal) {
+    const pending = new Map();
+    let failure;
+    let nextId = 1;
+    const fail = (error) => {
+        failure ??= error;
+        for (const settle of pending.values())
+            settle(failure);
+        pending.clear();
+    };
+    const transport = await open({
+        receive(message) {
+            if (message.id === undefined)
+                return;
+            if (message.method !== undefined)
+                void transport
+                    .send(reply({ ...message, id: message.id }), AbortSignal.timeout(timeoutMs))
+                    .catch(() => { });
+            else
+                pending.get(message.id)?.(message);
+        },
+        fail,
+    });
+    const notify = (method, params) => transport.send({ jsonrpc: "2.0", method, params }, AbortSignal.timeout(timeoutMs));
+    const request = async (method, params, caller) => {
+        if (failure)
+            throw failure;
+        throwIfAborted(caller, `MCP ${method}`);
+        const id = nextId++;
+        const timeout = AbortSignal.timeout(timeoutMs);
+        const deadline = caller ? AbortSignal.any([caller, timeout]) : timeout;
+        const response = new Promise((resolve, reject) => {
+            const settle = (outcome) => {
+                pending.delete(id);
+                deadline.removeEventListener("abort", abort);
+                if (outcome instanceof Error)
+                    reject(outcome);
+                else
+                    resolve(outcome);
+            };
+            const abort = () => {
+                // Best effort: tell the server to stop work this client will never observe.
+                notify("notifications/cancelled", { requestId: id }).catch(() => { });
+                settle(caller?.aborted
+                    ? createAbortError(caller, `MCP ${method}`)
+                    : new Error(`MCP server ${label} timed out after ${timeoutMs} ms during ${method}`));
+            };
+            if (deadline.aborted)
+                return abort();
+            deadline.addEventListener("abort", abort, { once: true });
+            pending.set(id, settle);
+        });
+        transport
+            .send({ jsonrpc: "2.0", id, method, params }, deadline)
+            .catch((error) => pending.get(id)?.(error));
+        const { result, error } = await response;
+        if (error)
+            throw new McpRpcError(typeof error.code === "number" ? error.code : -32603, String(error.message ?? "Unknown error").slice(0, 4096));
+        return result;
+    };
+    const close = async () => {
+        fail(new Error(`MCP server ${label} is closed`));
+        await transport.close();
+    };
+    try {
+        const result = await request("initialize", {
+            protocolVersion: PROTOCOL_VERSIONS[0],
+            capabilities: {},
+            clientInfo: { name: "tubeless", version: "unversioned" },
+        }, signal);
+        if (!isRecord(result) ||
+            typeof result.protocolVersion !== "string" ||
+            !PROTOCOL_VERSIONS.includes(result.protocolVersion))
+            throw new Error(`MCP server ${label} requires an unsupported protocol version`);
+        await notify("notifications/initialized");
+    }
+    catch (error) {
+        await close().catch(() => { });
+        throw error;
+    }
+    return { request, close };
+}
+//# sourceMappingURL=mcp-session.js.map