@plurnk/plurnk-mcp 1.6.1 → 1.7.0

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EACH,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,WAAW,GACd,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EACH,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,wBAAwB,EACxB,sBAAsB,EACtB,8BAA8B,GACjC,MAAM,eAAe,CAAC;AACvB,OAAO,EACH,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,kBAAkB,GACrB,MAAM,aAAa,CAAC"}

package/dist/inputRequired.d.ts

@@ -0,0 +1,36 @@
+import { type CallToolRequest, type CallToolResult, type GetPromptRequest, type GetPromptResult, type InputRequiredResult, type InputResponse, type Progress, type ReadResourceRequest, type ReadResourceResult } from "@modelcontextprotocol/client";
+import type { ClientInteractionRequest, ClientInteractionResolution } from "@plurnk/plurnk-contracts";
+export type ClientInteractionHandler = (request: ClientInteractionRequest) => Promise<ClientInteractionResolution>;
+type InputRequiredMethod = "tools/call" | "resources/read" | "prompts/get" | "tasks/update";
+type CoreInputRequiredParams = CallToolRequest["params"] | ReadResourceRequest["params"] | GetPromptRequest["params"];
+type InputRequiredCompleteResult = CallToolResult | ReadResourceResult | GetPromptResult;
+interface InputRequiredLegOptions {
+    readonly signal?: AbortSignal;
+    readonly timeout: number;
+    readonly maxTotalTimeout: number;
+    readonly allowInputRequired: true;
+    readonly onprogress?: (progress: Progress) => void;
+}
+type InputRequiredLeg<T, P extends object> = (params: P, options: InputRequiredLegOptions, retry: boolean) => Promise<T | InputRequiredResult>;
+interface InputRequiredRequestOptions<T, P extends object> {
+    readonly server: string;
+    readonly operation: InputRequiredMethod;
+    readonly originalParams: P;
+    readonly signal?: AbortSignal;
+    readonly onProgress?: (progress: Progress) => void;
+    readonly interact?: ClientInteractionHandler;
+    readonly timeout: number;
+    readonly requestLeg: InputRequiredLeg<T, P>;
+}
+interface ResolveInputRequestsOptions {
+    readonly server: string;
+    readonly operation: InputRequiredMethod;
+    readonly inputRequests: Readonly<Record<string, unknown>>;
+    readonly interact?: ClientInteractionHandler;
+    readonly arguments?: Readonly<Record<string, unknown>>;
+}
+export declare const INPUT_REQUIRED_MAX_ROUNDS = 10;
+export declare const resolveInputRequests: ({ server, operation, inputRequests, interact, arguments: args, }: ResolveInputRequestsOptions) => Promise<Record<string, InputResponse>>;
+export declare const runInputRequiredRequest: <T = InputRequiredCompleteResult, P extends object = CoreInputRequiredParams>({ server, operation, originalParams, signal, onProgress, interact, timeout, requestLeg, }: InputRequiredRequestOptions<T, P>) => Promise<T>;
+export {};
+//# sourceMappingURL=inputRequired.d.ts.map

package/dist/inputRequired.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputRequired.d.ts","sourceRoot":"","sources":["../src/inputRequired.ts"],"names":[],"mappings":"AAAA,OAAO,EAMH,KAAK,eAAe,EACpB,KAAK,cAAc,EAGnB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAElB,KAAK,QAAQ,EACb,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EAC1B,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EACR,wBAAwB,EACxB,2BAA2B,EAC9B,MAAM,0BAA0B,CAAC;AAGlC,MAAM,MAAM,wBAAwB,GAAG,CACnC,OAAO,EAAE,wBAAwB,KAChC,OAAO,CAAC,2BAA2B,CAAC,CAAC;AAE1C,KAAK,mBAAmB,GAAG,YAAY,GAAG,gBAAgB,GAAG,aAAa,GAAG,cAAc,CAAC;AAC5F,KAAK,uBAAuB,GAAG,eAAe,CAAC,QAAQ,CAAC,GAClD,mBAAmB,CAAC,QAAQ,CAAC,GAC7B,gBAAgB,CAAC,QAAQ,CAAC,CAAC;AACjC,KAAK,2BAA2B,GAAG,cAAc,GAAG,kBAAkB,GAAG,eAAe,CAAC;AAEzF,UAAU,uBAAuB;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,kBAAkB,EAAE,IAAI,CAAC;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;CACtD;AAED,KAAK,gBAAgB,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI,CACzC,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,uBAAuB,EAChC,KAAK,EAAE,OAAO,KACb,OAAO,CAAC,CAAC,GAAG,mBAAmB,CAAC,CAAC;AAEtC,UAAU,2BAA2B,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM;IACrD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAC;IACxC,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;IACnD,QAAQ,CAAC,QAAQ,CAAC,EAAE,wBAAwB,CAAC;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CAC/C;AAED,UAAU,2BAA2B;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,QAAQ,CAAC,QAAQ,CAAC,EAAE,wBAAwB,CAAC;IAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC1D;AAED,eAAO,MAAM,yBAAyB,KAAK,CAAC;AA8F5C,eAAO,MAAM,oBAAoB,qEAM9B,2BAA2B,KAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAUrE,CAAC;AAyCF,eAAO,MAAM,uBAAuB,GAChC,CAAC,GAAG,2BAA2B,EAC/B,CAAC,SAAS,MAAM,GAAG,uBAAuB,6FAU3C,2BAA2B,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,OAAO,CAAC,CAAC,CAyE/C,CAAC"}

package/dist/inputRequired.js

@@ -0,0 +1,171 @@
+import { fromJsonSchema, isInputRequiredResult, SdkError, SdkErrorCode, specTypeSchemas, } from "@modelcontextprotocol/client";
+import { setTimeout as delay } from "node:timers/promises";
+export const INPUT_REQUIRED_MAX_ROUNDS = 10;
+const REQUEST_STATE_ONLY_PACING_MS = 250;
+const INPUT_REQUIRED_TOOL = "mcp_input_required";
+const formatValidationIssues = (issues) => issues.map((issue) => issue.path?.length
+    ? `${issue.path.map(String).join(".")}: ${issue.message}`
+    : issue.message).join(", ");
+const elicitationResponseSchema = (request) => {
+    const params = request.params;
+    if (params.mode === "url") {
+        return {
+            type: "object",
+            required: ["action"],
+            additionalProperties: false,
+            properties: {
+                action: { enum: ["accept", "decline", "cancel"] },
+            },
+        };
+    }
+    return {
+        oneOf: [
+            {
+                type: "object",
+                required: ["action", "content"],
+                additionalProperties: false,
+                properties: {
+                    action: { const: "accept" },
+                    content: params.requestedSchema,
+                },
+            },
+            {
+                type: "object",
+                required: ["action"],
+                additionalProperties: false,
+                properties: {
+                    action: { enum: ["decline", "cancel"] },
+                },
+            },
+        ],
+    };
+};
+const supportedElicitations = (server, operation, inputRequests) => Object.entries(inputRequests).map(([key, candidate]) => {
+    const request = candidate;
+    if (request.method !== "elicitation/create") {
+        throw new Error(`MCP server '${server}' requested unsupported embedded input method '${String(request.method)}' during '${operation}'; Plurnk advertises only elicitation form and URL modes.`);
+    }
+    const parsed = specTypeSchemas.ElicitRequest["~standard"].validate(candidate);
+    if (parsed.issues !== undefined) {
+        throw new Error(`MCP server '${server}' supplied invalid elicitation '${key}' during '${operation}': ${formatValidationIssues(parsed.issues)}.`);
+    }
+    return [key, parsed.value];
+});
+const interactionRequest = (server, operation, entries, args = {}) => {
+    const properties = Object.fromEntries(entries.map(([key, request]) => [
+        key,
+        elicitationResponseSchema(request),
+    ]));
+    return {
+        toolName: INPUT_REQUIRED_TOOL,
+        arguments: {
+            server,
+            operation,
+            ...args,
+            requests: Object.fromEntries(entries),
+        },
+        message: entries.length === 1
+            ? entries[0][1].params.message
+            : `MCP server '${server}' requires ${entries.length} responses to continue '${operation}'.`,
+        responseSchema: {
+            type: "object",
+            required: entries.map(([key]) => key),
+            additionalProperties: false,
+            properties,
+        },
+    };
+};
+export const resolveInputRequests = async ({ server, operation, inputRequests, interact, arguments: args, }) => {
+    const entries = supportedElicitations(server, operation, inputRequests);
+    if (entries.length === 0)
+        return {};
+    if (interact === undefined) {
+        throw new Error(`MCP server '${server}' requires client input during '${operation}', but this operation has no client interaction owner.`);
+    }
+    const request = interactionRequest(server, operation, entries, args);
+    return resolvedInputResponses(request, await interact(request));
+};
+const cancelledInputResponses = (entries) => Object.fromEntries(entries.map(([key]) => [
+    key,
+    { action: "cancel" },
+]));
+const resolvedInputResponses = async (request, resolution) => {
+    if (resolution.status === "cancelled") {
+        const entries = Object.entries(request.arguments.requests);
+        return cancelledInputResponses(entries);
+    }
+    const validator = fromJsonSchema(request.responseSchema);
+    const validation = await validator["~standard"].validate(resolution.payload);
+    if (validation.issues !== undefined) {
+        throw new Error(`MCP client interaction response is invalid: ${formatValidationIssues(validation.issues)}.`);
+    }
+    const responses = {};
+    for (const [key, value] of Object.entries(validation.value)) {
+        const parsed = specTypeSchemas.ElicitResult["~standard"].validate(value);
+        if (parsed.issues !== undefined) {
+            throw new Error(`MCP client interaction response '${key}' is invalid: ${formatValidationIssues(parsed.issues)}.`);
+        }
+        responses[key] = parsed.value;
+    }
+    return responses;
+};
+export const runInputRequiredRequest = async ({ server, operation, originalParams, signal, onProgress, interact, timeout, requestLeg, }) => {
+    const startedAt = Date.now();
+    const options = {
+        signal,
+        timeout,
+        maxTotalTimeout: timeout,
+        allowInputRequired: true,
+        ...(onProgress === undefined ? {} : { onprogress: onProgress }),
+    };
+    let result = await requestLeg(originalParams, options, false);
+    let round = 0;
+    while (isInputRequiredResult(result)) {
+        round += 1;
+        if (round > INPUT_REQUIRED_MAX_ROUNDS) {
+            throw new SdkError(SdkErrorCode.InputRequiredRoundsExceeded, `Multi-round-trip request '${operation}' still required input after ${INPUT_REQUIRED_MAX_ROUNDS} rounds.`, {
+                rounds: INPUT_REQUIRED_MAX_ROUNDS,
+                lastResult: result,
+            });
+        }
+        onProgress?.({
+            progress: round,
+            message: `Fulfilling input required by '${operation}' (round ${round})`,
+        });
+        let inputResponses;
+        const inputRequests = result.inputRequests ?? {};
+        if (Object.keys(inputRequests).length === 0) {
+            await delay(REQUEST_STATE_ONLY_PACING_MS, undefined, signal === undefined ? {} : { signal });
+        }
+        else {
+            inputResponses = await resolveInputRequests({
+                server,
+                operation,
+                inputRequests,
+                interact,
+            });
+            signal?.throwIfAborted();
+        }
+        const elapsed = Date.now() - startedAt;
+        const remaining = timeout - elapsed;
+        if (remaining <= 0) {
+            throw new SdkError(SdkErrorCode.RequestTimeout, `MCP '${operation}' exceeded its ${timeout}ms operation timeout.`, { maxTotalTimeout: timeout, totalElapsed: elapsed });
+        }
+        const retryParams = {
+            ...originalParams,
+            ...(inputResponses === undefined || Object.keys(inputResponses).length === 0
+                ? {}
+                : { inputResponses }),
+            ...(result.requestState === undefined
+                ? {}
+                : { requestState: result.requestState }),
+        };
+        result = await requestLeg(retryParams, {
+            ...options,
+            timeout: Math.min(timeout, remaining),
+            maxTotalTimeout: remaining,
+        }, true);
+    }
+    return result;
+};
+//# sourceMappingURL=inputRequired.js.map

package/dist/inputRequired.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputRequired.js","sourceRoot":"","sources":["../src/inputRequired.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,cAAc,EACd,qBAAqB,EACrB,QAAQ,EACR,YAAY,EACZ,eAAe,GAalB,MAAM,8BAA8B,CAAC;AAKtC,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAC;AA6C3D,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,CAAC;AAC5C,MAAM,4BAA4B,GAAG,GAAG,CAAC;AACzC,MAAM,mBAAmB,GAAG,oBAAoB,CAAC;AAEjD,MAAM,sBAAsB,GAAG,CAAC,MAAiE,EAAU,EAAE,CACzG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM;IACpC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE;IACzD,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEpC,MAAM,yBAAyB,GAAG,CAAC,OAAsB,EAA2B,EAAE;IAClF,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC9B,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QACxB,OAAO;YACH,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC,QAAQ,CAAC;YACpB,oBAAoB,EAAE,KAAK;YAC3B,UAAU,EAAE;gBACR,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE;aACpD;SACJ,CAAC;IACN,CAAC;IACD,OAAO;QACH,KAAK,EAAE;YACH;gBACI,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;gBAC/B,oBAAoB,EAAE,KAAK;gBAC3B,UAAU,EAAE;oBACR,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE;oBAC3B,OAAO,EAAE,MAAM,CAAC,eAAe;iBAClC;aACJ;YACD;gBACI,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,CAAC,QAAQ,CAAC;gBACpB,oBAAoB,EAAE,KAAK;gBAC3B,UAAU,EAAE;oBACR,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE;iBAC1C;aACJ;SACJ;KACJ,CAAC;AACN,CAAC,CAAC;AAEF,MAAM,qBAAqB,GAAG,CAC1B,MAAc,EACd,SAA8B,EAC9B,aAAgD,EACvB,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,EAAE;IACnF,MAAM,OAAO,GAAG,SAAiC,CAAC;IAClD,IAAI,OAAO,CAAC,MAAM,KAAK,oBAAoB,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CACX,eAAe,MAAM,kDAAkD,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,SAAS,2DAA2D,CACjL,CAAC;IACN,CAAC;IACD,MAAM,MAAM,GAAG,eAAe,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC9E,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACX,eAAe,MAAM,mCAAmC,GAAG,aAAa,SAAS,MAAM,sBAAsB,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAClI,CAAC;IACN,CAAC;IACD,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC,CAAC,CAAC;AAEH,MAAM,kBAAkB,GAAG,CACvB,MAAc,EACd,SAA8B,EAC9B,OAA2C,EAC3C,IAAI,GAAsC,EAAE,EACpB,EAAE;IAC1B,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC;QAClE,GAAG;QACH,yBAAyB,CAAC,OAAO,CAAC;KACrC,CAAC,CAAC,CAAC;IACJ,OAAO;QACH,QAAQ,EAAE,mBAAmB;QAC7B,SAAS,EAAE;YACP,MAAM;YACN,SAAS;YACT,GAAG,IAAI;YACP,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC;SACxC;QACD,OAAO,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC;YACzB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO;YAC/B,CAAC,CAAC,eAAe,MAAM,cAAc,OAAO,CAAC,MAAM,2BAA2B,SAAS,IAAI;QAC/F,cAAc,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC;YACrC,oBAAoB,EAAE,KAAK;YAC3B,UAAU;SACb;KACJ,CAAC;AACN,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EAAE,EACvC,MAAM,EACN,SAAS,EACT,aAAa,EACb,QAAQ,EACR,SAAS,EAAE,IAAI,GACW,EAA0C,EAAE;IACtE,MAAM,OAAO,GAAG,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;IACxE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACX,eAAe,MAAM,mCAAmC,SAAS,wDAAwD,CAC5H,CAAC;IACN,CAAC;IACD,MAAM,OAAO,GAAG,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACrE,OAAO,sBAAsB,CAAC,OAAO,EAAE,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AACpE,CAAC,CAAC;AAEF,MAAM,uBAAuB,GAAG,CAC5B,OAA2C,EACf,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;IACzE,GAAG;IACH,EAAE,MAAM,EAAE,QAAQ,EAAE;CACvB,CAAC,CAAC,CAAC;AAEJ,MAAM,sBAAsB,GAAG,KAAK,EAChC,OAAiC,EACjC,UAAuC,EACD,EAAE;IACxC,IAAI,UAAU,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAC1B,OAAO,CAAC,SAAS,CAAC,QAAyC,CAC9D,CAAC;QACF,OAAO,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IACD,MAAM,SAAS,GAAG,cAAc,CAC5B,OAAO,CAAC,cAAgC,CAC3C,CAAC;IACF,MAAM,UAAU,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAC7E,IAAI,UAAU,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CACX,+CAA+C,sBAAsB,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAC9F,CAAC;IACN,CAAC;IACD,MAAM,SAAS,GAAkC,EAAE,CAAC;IACpD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1D,MAAM,MAAM,GAAG,eAAe,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACzE,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CACX,oCAAoC,GAAG,iBAAiB,sBAAsB,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CACnG,CAAC;QACN,CAAC;QACD,SAAS,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;IAClC,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,EAG1C,EACE,MAAM,EACN,SAAS,EACT,cAAc,EACd,MAAM,EACN,UAAU,EACV,QAAQ,EACR,OAAO,EACP,UAAU,GACsB,EAAc,EAAE;IAChD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG;QACZ,MAAM;QACN,OAAO;QACP,eAAe,EAAE,OAAO;QACxB,kBAAkB,EAAE,IAAa;QACjC,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC;KAClE,CAAC;IACF,IAAI,MAAM,GAAG,MAAM,UAAU,CAAC,cAAc,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC9D,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,OAAO,qBAAqB,CAAC,MAAM,CAAC,EAAE,CAAC;QACnC,KAAK,IAAI,CAAC,CAAC;QACX,IAAI,KAAK,GAAG,yBAAyB,EAAE,CAAC;YACpC,MAAM,IAAI,QAAQ,CACd,YAAY,CAAC,2BAA2B,EACxC,6BAA6B,SAAS,gCAAgC,yBAAyB,UAAU,EACzG;gBACI,MAAM,EAAE,yBAAyB;gBACjC,UAAU,EAAE,MAAM;aACrB,CACJ,CAAC;QACN,CAAC;QACD,UAAU,EAAE,CAAC;YACT,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,iCAAiC,SAAS,YAAY,KAAK,GAAG;SAC1E,CAAC,CAAC;QACH,IAAI,cAAyD,CAAC;QAC9D,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,IAAI,EAAE,CAAC;QACjD,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1C,MAAM,KAAK,CACP,4BAA4B,EAC5B,SAAS,EACT,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CACzC,CAAC;QACN,CAAC;aAAM,CAAC;YACJ,cAAc,GAAG,MAAM,oBAAoB,CAAC;gBACxC,MAAM;gBACN,SAAS;gBACT,aAAa;gBACb,QAAQ;aACX,CAAC,CAAC;YACH,MAAM,EAAE,cAAc,EAAE,CAAC;QAC7B,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QACvC,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;QACpC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;YACjB,MAAM,IAAI,QAAQ,CACd,YAAY,CAAC,cAAc,EAC3B,QAAQ,SAAS,kBAAkB,OAAO,uBAAuB,EACjE,EAAE,eAAe,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,CACtD,CAAC;QACN,CAAC;QACD,MAAM,WAAW,GAAG;YAChB,GAAG,cAAc;YACjB,GAAG,CAAC,cAAc,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,MAAM,KAAK,CAAC;gBACxE,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC;YACzB,GAAG,CAAC,MAAM,CAAC,YAAY,KAAK,SAAS;gBACjC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;SAC1C,CAAC;QACP,MAAM,GAAG,MAAM,UAAU,CACrB,WAAW,EACX;YACI,GAAG,OAAO;YACV,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC;YACrC,eAAe,EAAE,SAAS;SAC7B,EACD,IAAI,CACP,CAAC;IACN,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC,CAAC"}

package/dist/oauth.d.ts

@@ -0,0 +1,28 @@
+import type { OAuthClientInformationContext, OAuthClientMetadata, OAuthClientProvider, OAuthDiscoveryState, StoredOAuthClientInformation, StoredOAuthTokens } from "@modelcontextprotocol/client";
+export default class InteractiveOAuthProvider implements OAuthClientProvider {
+    #private;
+    readonly redirectUrl: string;
+    readonly clientMetadataUrl: string | undefined;
+    constructor({ redirectUrl, clientMetadataUrl, clientId, clientSecret, scope, }: {
+        redirectUrl: string;
+        clientMetadataUrl?: string;
+        clientId?: string;
+        clientSecret?: string;
+        scope?: string;
+    });
+    get clientMetadata(): OAuthClientMetadata;
+    state(): string;
+    clientInformation(context?: OAuthClientInformationContext): StoredOAuthClientInformation | undefined;
+    saveClientInformation(clientInformation: StoredOAuthClientInformation, context?: OAuthClientInformationContext): void;
+    tokens(context?: OAuthClientInformationContext): StoredOAuthTokens | undefined;
+    saveTokens(tokens: StoredOAuthTokens, context?: OAuthClientInformationContext): void;
+    redirectToAuthorization(authorizationUrl: URL): void;
+    takeAuthorizationUrl(): URL | undefined;
+    assertCallbackState(callback: URL): void;
+    saveCodeVerifier(codeVerifier: string): void;
+    codeVerifier(): string;
+    saveDiscoveryState(state: OAuthDiscoveryState): void;
+    discoveryState(): OAuthDiscoveryState | undefined;
+    invalidateCredentials(scope: "all" | "client" | "tokens" | "verifier" | "discovery"): void;
+}
+//# sourceMappingURL=oauth.d.ts.map

package/dist/oauth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth.d.ts","sourceRoot":"","sources":["../src/oauth.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACR,6BAA6B,EAC7B,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,4BAA4B,EAC5B,iBAAiB,EACpB,MAAM,8BAA8B,CAAC;AAGtC,MAAM,CAAC,OAAO,OAAO,wBAAyB,YAAW,mBAAmB;;IACxE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;IAe/C,YAAY,EACR,WAAW,EACX,iBAAiB,EACjB,QAAQ,EACR,YAAY,EACZ,KAAK,GACR,EAAE;QACC,WAAW,EAAE,MAAM,CAAC;QACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,KAAK,CAAC,EAAE,MAAM,CAAC;KAClB,EAOA;IAED,IAAI,cAAc,IAAI,mBAAmB,CASxC;IAED,KAAK,IAAI,MAAM,CAGd;IAED,iBAAiB,CACb,OAAO,CAAC,EAAE,6BAA6B,GACxC,4BAA4B,GAAG,SAAS,CA0B1C;IAED,qBAAqB,CACjB,iBAAiB,EAAE,4BAA4B,EAC/C,OAAO,CAAC,EAAE,6BAA6B,GACxC,IAAI,CAON;IAED,MAAM,CAAC,OAAO,CAAC,EAAE,6BAA6B,GAAG,iBAAiB,GAAG,SAAS,CAO7E;IAED,UAAU,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,6BAA6B,GAAG,IAAI,CAWnF;IAED,uBAAuB,CAAC,gBAAgB,EAAE,GAAG,GAAG,IAAI,CAGnD;IAED,oBAAoB,IAAI,GAAG,GAAG,SAAS,CAItC;IAED,mBAAmB,CAAC,QAAQ,EAAE,GAAG,GAAG,IAAI,CAIvC;IAED,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAE3C;IAED,YAAY,IAAI,MAAM,CAKrB;IAED,kBAAkB,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAQnD;IAED,cAAc,IAAI,mBAAmB,GAAG,SAAS,CAMhD;IAED,qBAAqB,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,GAAG,IAAI,CAczF;CACJ"}

package/dist/oauth.js

@@ -0,0 +1,149 @@
+import { randomUUID } from "node:crypto";
+import packageJson from "../package.json" with { type: "json" };
+export default class InteractiveOAuthProvider {
+    redirectUrl;
+    clientMetadataUrl;
+    #scope;
+    #configuredClientInformation;
+    #clientInformation = new Map();
+    #tokens = new Map();
+    #configuredIssuer;
+    #activeIssuer;
+    #currentTokens;
+    #presentedToken = false;
+    #awaitingAuthorizationCallback = false;
+    #state;
+    #authorizationUrl;
+    #codeVerifier;
+    #discoveryState;
+    constructor({ redirectUrl, clientMetadataUrl, clientId, clientSecret, scope, }) {
+        this.redirectUrl = redirectUrl;
+        this.clientMetadataUrl = clientMetadataUrl;
+        this.#scope = scope;
+        this.#configuredClientInformation = clientId === undefined
+            ? undefined
+            : { client_id: clientId, ...(clientSecret === undefined ? {} : { client_secret: clientSecret }) };
+    }
+    get clientMetadata() {
+        return {
+            client_name: packageJson.name,
+            redirect_uris: [this.redirectUrl],
+            grant_types: ["authorization_code", "refresh_token"],
+            response_types: ["code"],
+            token_endpoint_auth_method: "none",
+            ...(this.#scope === undefined ? {} : { scope: this.#scope }),
+        };
+    }
+    state() {
+        this.#state = randomUUID();
+        return this.#state;
+    }
+    clientInformation(context) {
+        const issuer = context?.issuer ?? this.#activeIssuer;
+        if (issuer === undefined)
+            return undefined;
+        this.#activeIssuer = issuer;
+        const stored = this.#clientInformation.get(issuer);
+        if (stored !== undefined)
+            return stored;
+        if (this.#configuredClientInformation === undefined
+            || (this.#configuredIssuer !== undefined && this.#configuredIssuer !== issuer)) {
+            const metadata = this.#discoveryState?.authorizationServerMetadata;
+            const cimdAvailable = this.clientMetadataUrl !== undefined
+                && metadata?.client_id_metadata_document_supported === true;
+            if (!cimdAvailable && metadata?.registration_endpoint === undefined) {
+                throw new Error(`MCP authorization server '${issuer}' exposes no usable client registration: `
+                    + "configure pre-registration or advertised CIMD; its metadata does not advertise "
+                    + "a Dynamic Client Registration endpoint.");
+            }
+            return undefined;
+        }
+        this.#configuredIssuer = issuer;
+        const configured = { ...this.#configuredClientInformation, issuer };
+        this.#clientInformation.set(issuer, configured);
+        return configured;
+    }
+    saveClientInformation(clientInformation, context) {
+        const issuer = context?.issuer ?? clientInformation.issuer;
+        if (issuer === undefined) {
+            throw new Error("MCP OAuth client information is missing its authorization-server issuer.");
+        }
+        this.#activeIssuer = issuer;
+        this.#clientInformation.set(issuer, { ...clientInformation, issuer });
+    }
+    tokens(context) {
+        if (context === undefined) {
+            this.#presentedToken = this.#currentTokens !== undefined;
+            return this.#currentTokens;
+        }
+        this.#activeIssuer = context.issuer;
+        return this.#tokens.get(context.issuer);
+    }
+    saveTokens(tokens, context) {
+        const issuer = context?.issuer ?? tokens.issuer;
+        if (issuer === undefined) {
+            throw new Error("MCP OAuth tokens are missing their authorization-server issuer.");
+        }
+        const stored = { ...tokens, issuer };
+        this.#activeIssuer = issuer;
+        this.#currentTokens = stored;
+        this.#presentedToken = false;
+        this.#awaitingAuthorizationCallback = false;
+        this.#tokens.set(issuer, stored);
+    }
+    redirectToAuthorization(authorizationUrl) {
+        this.#awaitingAuthorizationCallback = true;
+        this.#authorizationUrl = authorizationUrl;
+    }
+    takeAuthorizationUrl() {
+        const authorizationUrl = this.#authorizationUrl;
+        this.#authorizationUrl = undefined;
+        return authorizationUrl;
+    }
+    assertCallbackState(callback) {
+        if (this.#state === undefined || callback.searchParams.get("state") !== this.#state) {
+            throw new Error("OAuth callback state does not match the pending authorization request.");
+        }
+    }
+    saveCodeVerifier(codeVerifier) {
+        this.#codeVerifier = codeVerifier;
+    }
+    codeVerifier() {
+        if (this.#codeVerifier === undefined) {
+            throw new Error("OAuth authorization has no pending PKCE verifier.");
+        }
+        return this.#codeVerifier;
+    }
+    saveDiscoveryState(state) {
+        if (state.authorizationServerMetadata === undefined) {
+            throw new Error("MCP OAuth requires validated authorization-server metadata; "
+                + "legacy endpoint inference is not supported.");
+        }
+        this.#discoveryState = state;
+    }
+    discoveryState() {
+        if (!this.#awaitingAuthorizationCallback && this.#presentedToken) {
+            this.#presentedToken = false;
+            this.#discoveryState = undefined;
+        }
+        return this.#discoveryState;
+    }
+    invalidateCredentials(scope) {
+        if ((scope === "all" || scope === "client") && this.#activeIssuer !== undefined) {
+            this.#clientInformation.delete(this.#activeIssuer);
+        }
+        if (scope === "all" || scope === "tokens") {
+            if (this.#activeIssuer !== undefined)
+                this.#tokens.delete(this.#activeIssuer);
+            this.#currentTokens = undefined;
+            this.#presentedToken = false;
+        }
+        if (scope === "all" || scope === "verifier") {
+            this.#codeVerifier = undefined;
+            this.#awaitingAuthorizationCallback = false;
+        }
+        if (scope === "all" || scope === "discovery")
+            this.#discoveryState = undefined;
+    }
+}
+//# sourceMappingURL=oauth.js.map

package/dist/oauth.js.map

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

package/dist/protocol.d.ts

@@ -0,0 +1,7 @@
+export declare const MCP_PROTOCOL_VERSION = "2026-07-28";
+export declare const MCP_SPECIFICATION_COMMIT = "5f5440bb26a62e2cf3440b92da5a667efa03b267";
+export declare const MCP_TASKS_EXTENSION_ID = "io.modelcontextprotocol/tasks";
+export declare const MCP_TASKS_SPECIFICATION_COMMIT = "2c1425d9a288b9b1f489430fe1e00bb392b47e48";
+export declare const MCP_CLIENT_VERSION = "2.0.0";
+export declare const MCP_CONFORMANCE_VERSION = "0.2.0-alpha.11";
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,eAAe,CAAC;AACjD,eAAO,MAAM,wBAAwB,6CAA6C,CAAC;AACnF,eAAO,MAAM,sBAAsB,kCAAkC,CAAC;AACtE,eAAO,MAAM,8BAA8B,6CAA6C,CAAC;AACzF,eAAO,MAAM,kBAAkB,UAAU,CAAC;AAC1C,eAAO,MAAM,uBAAuB,mBAAmB,CAAC"}

package/dist/protocol.js

@@ -0,0 +1,7 @@
+export const MCP_PROTOCOL_VERSION = "2026-07-28";
+export const MCP_SPECIFICATION_COMMIT = "5f5440bb26a62e2cf3440b92da5a667efa03b267";
+export const MCP_TASKS_EXTENSION_ID = "io.modelcontextprotocol/tasks";
+export const MCP_TASKS_SPECIFICATION_COMMIT = "2c1425d9a288b9b1f489430fe1e00bb392b47e48";
+export const MCP_CLIENT_VERSION = "2.0.0";
+export const MCP_CONFORMANCE_VERSION = "0.2.0-alpha.11";
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG,YAAY,CAAC;AACjD,MAAM,CAAC,MAAM,wBAAwB,GAAG,0CAA0C,CAAC;AACnF,MAAM,CAAC,MAAM,sBAAsB,GAAG,+BAA+B,CAAC;AACtE,MAAM,CAAC,MAAM,8BAA8B,GAAG,0CAA0C,CAAC;AACzF,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC;AAC1C,MAAM,CAAC,MAAM,uBAAuB,GAAG,gBAAgB,CAAC"}

package/dist/protocolHeaders.d.ts

@@ -0,0 +1,4 @@
+import type { Tool } from "@modelcontextprotocol/client";
+export declare const mcpRoutingHeaderValue: (value: string) => string;
+export declare const mcpParamHeaders: (tool: Tool, args: Record<string, unknown>) => Readonly<Record<string, string>>;
+//# sourceMappingURL=protocolHeaders.d.ts.map

package/dist/protocolHeaders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocolHeaders.d.ts","sourceRoot":"","sources":["../src/protocolHeaders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAoBzD,eAAO,MAAM,qBAAqB,UAAW,MAAM,KAAG,MAE3C,CAAC;AA8DZ,eAAO,MAAM,eAAe,SAClB,IAAI,QACJ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASjC,CAAC"}

package/dist/protocolHeaders.js

@@ -0,0 +1,87 @@
+const BASE64_PREFIX = "=?base64?";
+const BASE64_SUFFIX = "?=";
+const RFC9110_TOKEN = /^[!#$%&'*+\-.^_`|~0-9A-Za-z]+$/;
+const HEADER_TYPES = new Set(["string", "integer", "number", "boolean"]);
+const requiresEncoding = (value) => {
+    if (value.length === 0 || value !== value.trim())
+        return true;
+    if (value.startsWith(BASE64_PREFIX) && value.endsWith(BASE64_SUFFIX))
+        return true;
+    for (let index = 0; index < value.length; index += 1) {
+        const codePoint = value.codePointAt(index);
+        if (codePoint === 9 || (codePoint !== undefined && codePoint >= 32 && codePoint <= 126)) {
+            continue;
+        }
+        return true;
+    }
+    return false;
+};
+export const mcpRoutingHeaderValue = (value) => requiresEncoding(value)
+    ? `${BASE64_PREFIX}${Buffer.from(value, "utf8").toString("base64")}${BASE64_SUFFIX}`
+    : value;
+const headerDeclarations = (tool) => {
+    const declarations = [];
+    const seen = new Set();
+    const visit = (schema, path) => {
+        if (schema === null || typeof schema !== "object" || Array.isArray(schema))
+            return;
+        const node = schema;
+        const header = node["x-mcp-header"];
+        if (header !== undefined) {
+            if (path.length === 0
+                || typeof header !== "string"
+                || !RFC9110_TOKEN.test(header)
+                || typeof node.type !== "string"
+                || !HEADER_TYPES.has(node.type)) {
+                throw new Error(`MCP tool '${tool.name}' has an invalid x-mcp-header declaration.`);
+            }
+            const folded = header.toLowerCase();
+            if (seen.has(folded)) {
+                throw new Error(`MCP tool '${tool.name}' repeats x-mcp-header '${header}'.`);
+            }
+            seen.add(folded);
+            declarations.push({ name: header, path, type: node.type });
+        }
+        const properties = node.properties;
+        if (properties === null || typeof properties !== "object" || Array.isArray(properties))
+            return;
+        for (const [name, child] of Object.entries(properties)) {
+            visit(child, [...path, name]);
+        }
+    };
+    visit(tool.inputSchema, []);
+    return declarations;
+};
+const valueAt = (root, path) => {
+    let value = root;
+    for (const segment of path) {
+        if (value === null || typeof value !== "object" || Array.isArray(value))
+            return undefined;
+        value = value[segment];
+    }
+    return value;
+};
+const primitiveHeaderValue = (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" || !Number.isFinite(value))
+        return undefined;
+    if (Number.isInteger(value) && !Number.isSafeInteger(value))
+        return undefined;
+    if (type === "integer" && (!Number.isSafeInteger(value) || !Number.isInteger(value))) {
+        return undefined;
+    }
+    return String(value);
+};
+export const mcpParamHeaders = (tool, args) => Object.fromEntries(headerDeclarations(tool).flatMap((declaration) => {
+    const value = valueAt(args, declaration.path);
+    if (value === undefined || value === null)
+        return [];
+    const primitive = primitiveHeaderValue(value, declaration.type);
+    return primitive === undefined
+        ? []
+        : [[`Mcp-Param-${declaration.name}`, mcpRoutingHeaderValue(primitive)]];
+}));
+//# sourceMappingURL=protocolHeaders.js.map

package/dist/protocolHeaders.js.map

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

package/dist/subscriptions.d.ts

@@ -0,0 +1,15 @@
+import { type Client } from "@modelcontextprotocol/client";
+export interface SubscriptionOptions {
+    readonly timeout: number;
+    readonly tasks?: boolean;
+    readonly onError?: (error: Error) => void;
+}
+/** Owns the one current modern subscription filter for a server connection. */
+export default class Subscriptions {
+    #private;
+    constructor(client: Client, options: SubscriptionOptions);
+    selectTask(taskId: string): Promise<() => Promise<void>>;
+    selectResource(uri: string): Promise<void>;
+    retire(): Promise<void>;
+}
+//# sourceMappingURL=subscriptions.d.ts.map

package/dist/subscriptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.d.ts","sourceRoot":"","sources":["../src/subscriptions.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,MAAM,EAGd,MAAM,8BAA8B,CAAC;AAKtC,MAAM,WAAW,mBAAmB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAC7C;AAuCD,+EAA+E;AAC/E,MAAM,CAAC,OAAO,OAAO,aAAa;;IAY9B,YAAY,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,EASvD;IAEK,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAuB7D;IAWK,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAO/C;IAyFD,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAOtB;CACJ"}