@plurnk/plurnk-mcp 1.6.1 → 1.8.0

package/dist/extensionChannel.js

@@ -0,0 +1,195 @@
+import { CLIENT_CAPABILITIES_META_KEY, CLIENT_INFO_META_KEY, PROTOCOL_VERSION_META_KEY, ProtocolError, SdkError, SdkErrorCode, } from "@modelcontextprotocol/client";
+const REQUEST_ID_PREFIX = "plurnk-extension:";
+const asRecord = (value) => value !== null && typeof value === "object" && !Array.isArray(value)
+    ? value
+    : undefined;
+const asError = (cause) => cause instanceof Error
+    ? cause
+    : new Error(String(cause));
+export default class ExtensionChannel {
+    #transport;
+    #options;
+    #pending = new Map();
+    #taskHandlers = new Set();
+    #priorMessage;
+    #priorClose;
+    #messageHandler;
+    #closeHandler;
+    #nextId = 0;
+    #closed = false;
+    constructor(transport, options) {
+        this.#transport = transport;
+        this.#options = options;
+        this.#priorMessage = transport.onmessage;
+        this.#priorClose = transport.onclose;
+        this.#messageHandler = (message) => this.#receive(message);
+        this.#closeHandler = () => {
+            this.#rejectAll(new SdkError(SdkErrorCode.ConnectionClosed, "MCP extension channel closed."));
+            this.#priorClose?.();
+        };
+        transport.onmessage = this.#messageHandler;
+        transport.onclose = this.#closeHandler;
+    }
+    onTaskNotification(handler) {
+        if (this.#closed)
+            throw new Error("MCP extension channel is closed.");
+        this.#taskHandlers.add(handler);
+        return () => this.#taskHandlers.delete(handler);
+    }
+    async request(method, params, options) {
+        if (this.#closed)
+            throw new Error("MCP extension channel is closed.");
+        options.signal?.throwIfAborted();
+        const id = `${REQUEST_ID_PREFIX}${this.#nextId += 1}`;
+        const requestAbort = new AbortController();
+        const result = new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.#settle(id, new SdkError(SdkErrorCode.RequestTimeout, `MCP extension request '${method}' exceeded its ${options.timeout}ms timeout.`, { method, timeout: options.timeout }));
+                requestAbort.abort(new Error(`MCP extension request '${method}' timed out.`));
+                if (options.cancelRequestOnSharedTransport === true
+                    && this.#transport.hasPerRequestStream !== true) {
+                    void this.#cancelSharedRequest(id);
+                }
+            }, options.timeout);
+            timer.unref();
+            const onAbort = options.signal === undefined
+                ? undefined
+                : () => {
+                    const reason = options.signal?.reason ?? new Error("MCP extension request aborted.");
+                    this.#settle(id, reason);
+                    requestAbort.abort(reason);
+                    if (options.cancelRequestOnSharedTransport === true
+                        && this.#transport.hasPerRequestStream !== true) {
+                        void this.#cancelSharedRequest(id);
+                    }
+                };
+            this.#pending.set(id, {
+                resolve,
+                reject,
+                requestAbort,
+                timer,
+                signal: options.signal,
+                onAbort,
+                onProgress: options.onProgress,
+            });
+            options.signal?.addEventListener("abort", onAbort, { once: true });
+        });
+        const message = {
+            jsonrpc: "2.0",
+            id,
+            method,
+            params: {
+                ...params,
+                _meta: {
+                    [PROTOCOL_VERSION_META_KEY]: this.#options.protocolVersion,
+                    [CLIENT_INFO_META_KEY]: this.#options.clientInfo,
+                    [CLIENT_CAPABILITIES_META_KEY]: this.#options.clientCapabilities,
+                    ...(options.onProgress === undefined ? {} : { progressToken: id }),
+                    ...asRecord(params._meta),
+                },
+            },
+        };
+        void this.#transport.send(message, {
+            requestSignal: requestAbort.signal,
+            headers: options.headers,
+            onRequestStreamEnd: () => this.#settle(id, new SdkError(SdkErrorCode.ConnectionClosed, `MCP extension request '${method}' stream ended before its response.`)),
+        }).catch((cause) => this.#settle(id, cause));
+        return result;
+    }
+    async #cancelSharedRequest(id) {
+        try {
+            await this.#options.cancelRequest(id);
+        }
+        catch (cause) {
+            this.#options.onError?.(asError(cause));
+        }
+    }
+    #receive(message) {
+        const record = asRecord(message);
+        if (record === undefined) {
+            this.#priorMessage?.(message);
+            return;
+        }
+        const id = record.id;
+        if (typeof id === "string" && id.startsWith(REQUEST_ID_PREFIX)) {
+            const pending = this.#pending.get(id);
+            if (pending === undefined)
+                return;
+            if ("error" in record) {
+                const error = asRecord(record.error);
+                this.#settle(id, ProtocolError.fromError(typeof error?.code === "number" ? error.code : -32603, typeof error?.message === "string" ? error.message : "MCP extension request failed.", error?.data));
+                return;
+            }
+            if (!("result" in record)) {
+                this.#settle(id, new ProtocolError(-32600, "MCP extension response omitted its result."));
+                return;
+            }
+            this.#settle(id, undefined, record.result);
+            return;
+        }
+        if (record.method === "notifications/tasks") {
+            for (const handler of this.#taskHandlers) {
+                try {
+                    handler(record.params);
+                }
+                catch (cause) {
+                    this.#options.onError?.(asError(cause));
+                }
+            }
+            return;
+        }
+        if (record.method === "notifications/progress") {
+            const params = asRecord(record.params);
+            const token = params?.progressToken;
+            if (typeof token === "string" && token.startsWith(REQUEST_ID_PREFIX)) {
+                const pending = this.#pending.get(token);
+                if (pending === undefined)
+                    return;
+                if (params !== undefined && typeof params.progress === "number") {
+                    pending.onProgress?.({
+                        progress: params.progress,
+                        ...(typeof params.total === "number" ? { total: params.total } : {}),
+                        ...(typeof params.message === "string" ? { message: params.message } : {}),
+                    });
+                }
+                else {
+                    this.#options.onError?.(new Error("MCP extension progress omitted numeric progress."));
+                }
+                return;
+            }
+        }
+        this.#priorMessage?.(message);
+    }
+    #settle(id, error, value) {
+        const pending = this.#pending.get(id);
+        if (pending === undefined)
+            return;
+        this.#pending.delete(id);
+        clearTimeout(pending.timer);
+        if (pending.onAbort !== undefined) {
+            pending.signal?.removeEventListener("abort", pending.onAbort);
+        }
+        if (error === undefined)
+            pending.resolve(value);
+        else
+            pending.reject(error);
+    }
+    #rejectAll(error) {
+        for (const id of [...this.#pending.keys()])
+            this.#settle(id, error);
+    }
+    close() {
+        if (this.#closed)
+            return;
+        this.#closed = true;
+        this.#taskHandlers.clear();
+        this.#rejectAll(new SdkError(SdkErrorCode.ConnectionClosed, "MCP extension channel closed."));
+        if (this.#transport.onmessage === this.#messageHandler) {
+            this.#transport.onmessage = this.#priorMessage;
+        }
+        if (this.#transport.onclose === this.#closeHandler) {
+            this.#transport.onclose = this.#priorClose;
+        }
+    }
+}
+//# sourceMappingURL=extensionChannel.js.map

package/dist/extensionChannel.js.map

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

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { default as Module } from "./Module.ts";
 export { default } from "./Module.ts";
-export { MCP_PROTOCOL_VERSION } from "./client.ts";
-export { connectTimeoutMs, requestTimeoutMs, serverConfig, serverNames, } from "./config.ts";
-export type { HttpServerConfig, ServerConfig, StdioServerConfig, } from "./config.ts";
+export { MCP_CLIENT_VERSION, MCP_CONFORMANCE_VERSION, MCP_PROTOCOL_VERSION, MCP_SPECIFICATION_COMMIT, MCP_TASKS_EXTENSION_ID, MCP_TASKS_SPECIFICATION_COMMIT, } from "./protocol.ts";
+export { connectTimeoutMs, expandReferences, requestTimeoutMs, serverDefinition, serverNames, serviceDefinitions, serviceEnabledNames, } from "./config.ts";
+export type { ToolPolicy } from "./config.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","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;AACrB,YAAY,EACR,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,GACpB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","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,EAClB,mBAAmB,GACtB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -1,5 +1,5 @@
 export { default as Module } from "./Module.js";
 export { default } from "./Module.js";
-export { MCP_PROTOCOL_VERSION } from "./client.js";
-export { connectTimeoutMs, requestTimeoutMs, serverConfig, serverNames, } from "./config.js";
+export { MCP_CLIENT_VERSION, MCP_CONFORMANCE_VERSION, MCP_PROTOCOL_VERSION, MCP_SPECIFICATION_COMMIT, MCP_TASKS_EXTENSION_ID, MCP_TASKS_SPECIFICATION_COMMIT, } from "./protocol.js";
+export { connectTimeoutMs, expandReferences, requestTimeoutMs, serverDefinition, serverNames, serviceDefinitions, serviceEnabledNames, } from "./config.js";
 //# sourceMappingURL=index.js.map

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,EAClB,mBAAmB,GACtB,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":"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"}

package/dist/mcp-watchdog.mjs

@@ -0,0 +1,106 @@
+#!/usr/bin/env node
+// {§mcp-stdio-process-ownership} — the parent-death watchdog wrapper.
+// plurnk-mcp spawns stdio servers through this wrapper so no server (or its
+// grandchildren, e.g. chromium) can outlive the daemon:
+//
+//   - the real server is spawned DETACHED (its own process group), so the
+//     wrapper can group-kill the whole tree, grandchildren included;
+//   - ordinary transport closure forwards EOF and gives the server a bounded
+//     graceful exit; parent death or an expired grace group-SIGKILLs the tree;
+//   - a ppid poll covers SIGKILL of the daemon, where close() never runs;
+//   - stdio is forwarded verbatim, so the MCP protocol is untouched.
+//
+// Usage (internal): mcp-watchdog.mjs <ppid> -- <command> [args...]
+// The wrapper is a process-lifecycle tool, not a protocol participant.
+import { spawn } from "node:child_process";
+
+const args = process.argv.slice(2);
+const sep = args.indexOf("--");
+if (sep < 1) {
+    process.stderr.write("mcp-watchdog: usage: mcp-watchdog.mjs <ppid> -- <command> [args...]\n");
+    process.exit(64);
+}
+const parentPid = Number(args[0]);
+const command = args[sep + 1];
+const rest = args.slice(sep + 2);
+if (!Number.isSafeInteger(parentPid) || parentPid <= 1 || typeof command !== "string" || command.length === 0) {
+    process.stderr.write("mcp-watchdog: invalid invocation\n");
+    process.exit(64);
+}
+
+const SHUTDOWN_GRACE_MS = 2_000;
+
+const child = spawn(command, rest, {
+    stdio: ["pipe", "pipe", "inherit"],
+    env: process.env,
+    detached: true, // own process group: kill(-pid) reaches grandchildren
+});
+const killChildGroup = () => {
+    if (child.pid === undefined) return;
+    try { process.kill(-child.pid, "SIGKILL"); } catch { /* already gone */ }
+};
+let state = "running";
+let grace;
+const die = (reason, code = 0) => {
+    if (state === "exited") return;
+    state = "exited";
+    clearTimeout(grace);
+    killChildGroup();
+    process.stderr.write(`mcp-watchdog: exiting (${reason})\n`);
+    process.exit(code);
+};
+
+const alive = () => {
+    try { process.kill(parentPid, 0); return true; } catch { return false; }
+};
+const closeInput = () => {
+    if (state !== "running") return;
+    if (!alive()) {
+        die("parent gone");
+        return;
+    }
+    state = "closing";
+    child.stdin.end();
+    grace = setTimeout(() => die("graceful shutdown deadline"), SHUTDOWN_GRACE_MS);
+};
+
+// The daemon owns our stdin. Ordinary transport shutdown closes it while the
+// daemon remains alive; parent death closes it after the owner disappears.
+process.stdin.on("end", closeInput);
+process.stdin.on("close", closeInput);
+process.stdin.resume();
+
+// Parent-death signal 2: poll the ppid. Covers a reparented-but-open-fd edge
+// (e.g. a grandchild accidentally inheriting our stdin) at 2s granularity.
+const poll = setInterval(() => {
+    if (!alive()) die("parent gone");
+}, 2_000);
+poll.unref();
+
+// Forward the protocol verbatim.
+process.stdin.on("data", (chunk) => {
+    if (state === "running") child.stdin.write(chunk);
+});
+child.stdout.on("data", (chunk) => process.stdout.write(chunk));
+child.stdout.on("end", () => { if (state !== "exited") process.stdout.end(); });
+child.stdin.on("error", (error) => {
+    if (state === "closing" && error.code === "EPIPE") return;
+    die(`server stdin failed: ${error.message}`, 66);
+});
+
+child.on("exit", (code, signal) => {
+    clearInterval(poll);
+    if (state === "exited") return;
+    state = "exited";
+    clearTimeout(grace);
+    // A server that exits does not get to strand descendants in its group.
+    killChildGroup();
+    process.exit(code ?? (signal === null ? 0 : 1));
+});
+child.on("error", (error) => {
+    die(`spawn failed: ${error.message}`, 66);
+});
+
+for (const signal of ["SIGINT", "SIGHUP", "SIGTERM"]) {
+    process.on(signal, () => die(`received ${signal}`, 128));
+}

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"}