@herbertgao/pi-extensions 2026.9.11 → 2026.9.13

package/node_modules/pi-mcp-adapter/dist/mcp-tasks.js

@@ -0,0 +1,369 @@
+import { ProtocolError } from "@modelcontextprotocol/client";
+import { createApplicationInputHandler, createTaskSessionEndpointId, createTaskSessionFromClient, DispatchError, JsonRpcResponseError, resultFromTaskOutcome, TaskCancelledError, TaskFailedError, } from "@modelcontextprotocol/ext-tasks/client";
+import { logger } from "./logger.js";
+export const TASKS_EXTENSION_ID = "io.modelcontextprotocol/tasks";
+const RAW_REQUEST_ID_PREFIX = "pi-mcp-tasks-";
+const DEFAULT_RAW_REQUEST_TIMEOUT_MS = 60_000;
+const LATE_TASK_HANDLE_GRACE_MS = 60_000;
+function abortError(signal) {
+    return signal.reason instanceof Error
+        ? signal.reason
+        : new DOMException("This operation was aborted", "AbortError");
+}
+function isJsonRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+/**
+ * Raw JSON-RPC request channel chained onto a connected transport. Raw
+ * requests use string ids with a reserved prefix, which cannot collide with
+ * the SDK's numeric ids; their responses are consumed before the SDK client
+ * sees them. All other traffic passes through unchanged.
+ *
+ * Attach only after Client.connect has installed its transport handlers:
+ * attach() reads the current onmessage/onclose (through any wrapper
+ * accessors) and chains in front of them.
+ */
+export class RawRequestChannel {
+    transport;
+    pending = new Map();
+    requestCounter = 0;
+    defaultTimeoutMs;
+    attached = false;
+    constructor(transport, defaultTimeoutMs) {
+        this.transport = transport;
+        this.defaultTimeoutMs = defaultTimeoutMs ?? DEFAULT_RAW_REQUEST_TIMEOUT_MS;
+    }
+    attach() {
+        if (this.attached)
+            return;
+        this.attached = true;
+        const previousOnMessage = this.transport.onmessage;
+        this.transport.onmessage = (message, extra) => {
+            if (this.consumeRawResponse(message))
+                return;
+            previousOnMessage?.(message, extra);
+        };
+        const previousOnClose = this.transport.onclose;
+        this.transport.onclose = () => {
+            this.rejectAll("MCP connection closed");
+            previousOnClose?.();
+        };
+    }
+    /** Sends a raw JSON-RPC request and resolves with its correlated response. */
+    rawDispatch = (request, options) => {
+        if (!isJsonRecord(request) || typeof request.method !== "string") {
+            return Promise.reject(new Error("Raw MCP request must be a JSON object with a string method"));
+        }
+        const params = request.params;
+        if (params !== undefined && !isJsonRecord(params)) {
+            return Promise.reject(new Error("Raw MCP request params must be a JSON object"));
+        }
+        const signal = options?.signal;
+        if (signal?.aborted)
+            return Promise.reject(abortError(signal));
+        const id = `${RAW_REQUEST_ID_PREFIX}${++this.requestCounter}`;
+        const message = {
+            jsonrpc: "2.0",
+            id,
+            method: request.method,
+            ...(params === undefined ? {} : { params }),
+        };
+        const timeoutMs = options?.context?.requestTimeoutMs ?? this.defaultTimeoutMs;
+        return new Promise((resolve, reject) => {
+            const entry = {
+                id,
+                resolve,
+                reject,
+                state: "pending",
+                ...(signal === undefined ? {} : { signal }),
+                ...(message.method === "tools/call" ? { observationController: new AbortController() } : {}),
+            };
+            entry.requestTimer = setTimeout(() => {
+                this.terminateLocalWait(entry, new Error(`MCP task request "${message.method}" timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+            this.pending.set(id, entry);
+            if (signal) {
+                entry.onAbort = () => {
+                    this.terminateLocalWait(entry, abortError(signal));
+                };
+                signal.addEventListener("abort", entry.onAbort, { once: true });
+            }
+            const fail = (error) => {
+                if (this.pending.get(id) !== entry)
+                    return;
+                const wasPending = entry.state === "pending";
+                this.finishRequest(entry, true);
+                if (wasPending)
+                    reject(error instanceof Error ? error : new Error(String(error)));
+            };
+            // ext-tasks supplies the SEP-2663 Mcp-Name routing header (and any
+            // host headers) via context.headers. A task-producing tools/call owns
+            // its transport observation independently from the caller's wait.
+            try {
+                Promise.resolve(this.transport.send(message, {
+                    ...(options?.context?.headers === undefined ? {} : { headers: options.context.headers }),
+                    ...(entry.observationController !== undefined
+                        ? { requestSignal: entry.observationController.signal }
+                        : signal === undefined ? {} : { requestSignal: signal }),
+                })).catch(fail);
+            }
+            catch (error) {
+                fail(error);
+            }
+        });
+    };
+    consumeRawResponse(message) {
+        if (!("id" in message) || typeof message.id !== "string")
+            return false;
+        if (!message.id.startsWith(RAW_REQUEST_ID_PREFIX))
+            return false;
+        // A server request may choose any string ID, including our client-side
+        // prefix. Method-bearing frames still belong to the SDK request handler.
+        if ("method" in message)
+            return false;
+        const entry = this.pending.get(message.id);
+        if (!entry)
+            return true; // ours, but already completed or its bounded observation expired
+        const wasObserving = entry.state === "observing";
+        this.finishRequest(entry, true);
+        if (wasObserving) {
+            this.cancelLateTask(message);
+            return true;
+        }
+        if ("error" in message) {
+            const { code, message: errorMessage, data } = message.error;
+            entry.resolve({ kind: "error", error: { code, message: errorMessage, ...(data === undefined ? {} : { data }) } });
+        }
+        else if ("result" in message) {
+            entry.resolve({ kind: "result", result: message.result });
+        }
+        else {
+            entry.reject(new Error("MCP task response frame carried neither result nor error"));
+        }
+        return true;
+    }
+    terminateLocalWait(entry, error) {
+        if (this.pending.get(entry.id) !== entry || entry.state !== "pending")
+            return;
+        if (entry.observationController === undefined) {
+            this.finishRequest(entry, false);
+        }
+        else {
+            entry.state = "observing";
+            this.clearLocalWait(entry);
+            entry.observationTimer = setTimeout(() => {
+                this.finishRequest(entry, true);
+            }, LATE_TASK_HANDLE_GRACE_MS);
+        }
+        entry.reject(error);
+    }
+    clearLocalWait(entry) {
+        if (entry.requestTimer !== undefined)
+            clearTimeout(entry.requestTimer);
+        delete entry.requestTimer;
+        if (entry.signal !== undefined && entry.onAbort !== undefined) {
+            entry.signal.removeEventListener("abort", entry.onAbort);
+        }
+        delete entry.onAbort;
+    }
+    finishRequest(entry, abortObservation) {
+        if (this.pending.get(entry.id) !== entry)
+            return;
+        this.clearLocalWait(entry);
+        if (entry.observationTimer !== undefined)
+            clearTimeout(entry.observationTimer);
+        delete entry.observationTimer;
+        this.pending.delete(entry.id);
+        if (abortObservation)
+            entry.observationController?.abort();
+    }
+    cancelLateTask(message) {
+        if (!("result" in message) || !isJsonRecord(message.result))
+            return;
+        if (message.result.resultType !== "task" || typeof message.result.taskId !== "string")
+            return;
+        const taskId = message.result.taskId;
+        void this.rawDispatch({ method: "tasks/cancel", params: { taskId } }, { context: { headers: { "Mcp-Name": taskId } } }).catch(() => { });
+    }
+    rejectAll(reason) {
+        const entries = [...this.pending.values()];
+        for (const entry of entries) {
+            const wasPending = entry.state === "pending";
+            this.finishRequest(entry, true);
+            if (wasPending)
+                entry.reject(new Error(reason));
+        }
+    }
+}
+/**
+ * Whether a connected 2026-07-28 server advertises the tasks extension.
+ * ext-tasks requires the exact empty-object declaration; anything else
+ * downgrades the session, so mirror its check here.
+ *
+ * Legacy (2025-11-25) task servers are intentionally out of scope: driving
+ * their opt-in `task` parameter requires per-tool taskSupport declarations,
+ * which this integration does not supply.
+ */
+export function serverAdvertisesTasks(client) {
+    if (client.getProtocolEra?.() !== "modern")
+        return false;
+    const capabilities = client.getServerCapabilities();
+    const extension = capabilities?.extensions?.[TASKS_EXTENSION_ID];
+    return isJsonRecord(extension) && Object.keys(extension).length === 0;
+}
+/** Missing-handler errors carry the SDK's capability shape so call sites can classify them. */
+function capabilityNotSupportedError(serverName, method, inputKey) {
+    const error = new Error(`MCP server ${serverName} requested ${method} during a task, but this session has no handler for it`);
+    Object.assign(error, {
+        code: "CAPABILITY_NOT_SUPPORTED",
+        data: { key: inputKey ?? "unknown", method },
+    });
+    return error;
+}
+/**
+ * Attaches an ext-tasks requester session to a connected client when the
+ * server advertises task support. Returns undefined otherwise, leaving the
+ * plain callTool path untouched.
+ */
+export async function attachTaskSession(options) {
+    const { client, serverName, definition } = options;
+    if (!serverAdvertisesTasks(client))
+        return undefined;
+    const protocolVersion = client.getNegotiatedProtocolVersion?.();
+    if (protocolVersion === undefined)
+        return undefined;
+    const endpointId = await createTaskSessionEndpointId("pi-mcp-adapter", {
+        server: serverName,
+        ...(definition.command !== undefined
+            ? { transport: { type: "stdio", command: definition.command, args: definition.args ?? [] } }
+            : definition.url !== undefined
+                ? { transport: { type: "http", url: definition.url } }
+                : { transport: { type: "unix-socket", socket: definition.socket ?? null } }),
+    });
+    const onInputRequest = createApplicationInputHandler({
+        elicitation: async (request, context) => {
+            if (options.onElicitation === undefined) {
+                throw capabilityNotSupportedError(serverName, "elicitation/create", context.inputId);
+            }
+            const result = await options.onElicitation({ method: "elicitation/create", params: request.params }, context.signal);
+            return {
+                action: result.action,
+                ...(result.content === undefined
+                    ? {}
+                    : { content: result.content }),
+            };
+        },
+        sampling: async (request, context) => {
+            if (options.onSampling === undefined) {
+                throw capabilityNotSupportedError(serverName, "sampling/createMessage", context.inputId);
+            }
+            const result = await options.onSampling({ method: "sampling/createMessage", params: request.params }, context.signal);
+            return {
+                model: result.model,
+                role: result.role,
+                content: result.content,
+            };
+        },
+        roots: async () => ({ roots: [] }),
+    });
+    const channel = new RawRequestChannel(options.transport, options.requestTimeoutMs);
+    channel.attach();
+    const session = createTaskSessionFromClient(client, {
+        endpointId,
+        rawDispatch: channel.rawDispatch,
+        v2RequestFraming: {
+            protocolVersion,
+            clientInfo: options.clientInfo,
+            clientCapabilities: options.clientCapabilities,
+        },
+        // Tool declarations only add per-tool taskSupport hints; the adapter's
+        // cached tools/list is not threaded through here, and a miss is harmless.
+        tools: { currentTool: () => undefined },
+        onInputRequest,
+        onError: (error) => logger.warn(`ext-tasks background error for ${serverName}: ${String(error)}`),
+    });
+    // A downgraded session (server capability mismatch) would silently route
+    // plain tool calls through the generic request path, skipping callTool's
+    // output-schema validation. Refuse it and keep the plain path instead.
+    if (!session.capabilities.execution) {
+        await session.close().catch(() => { });
+        channel.rejectAll("Task session downgraded");
+        return undefined;
+    }
+    return { session, channel };
+}
+/**
+ * Preserves error-shape parity with Client.callTool: JSON-RPC failures —
+ * immediate (JsonRpcResponseError) or terminal task errors (TaskFailedError
+ * with a code) — become the typed ProtocolError subclass for their code, so
+ * call-site handling (session recovery, URL elicitation) keeps working.
+ * Local failures rethrow their original cause instead of being relabeled.
+ */
+function toCallToolError(error, signal) {
+    if (error instanceof TaskCancelledError && signal?.aborted === true) {
+        return abortError(signal);
+    }
+    if (error instanceof JsonRpcResponseError) {
+        return ProtocolError.fromError(error.code, error.message, error.data);
+    }
+    if (error instanceof TaskFailedError && error.code !== undefined) {
+        return ProtocolError.fromError(error.code, error.message, error.data);
+    }
+    if (error instanceof DispatchError) {
+        return error.cause ?? error;
+    }
+    return error;
+}
+/**
+ * Calls a tool through a task session and blocks until settlement, preserving
+ * the plain callTool contract: an immediate result returns as-is, a
+ * task-backed execution is polled to completion, a failed task throws the
+ * underlying JSON-RPC error, and aborting cancels the remote task.
+ */
+export async function callToolViaTaskSession(session, options) {
+    const { signal } = options;
+    let execution;
+    try {
+        execution = await session.callTool(options.name, options.args, {
+            ...(options.meta === undefined ? {} : { metadata: options.meta }),
+            ...(signal === undefined ? {} : { signal }),
+            ...(options.requestTimeoutMs === undefined ? {} : { requestTimeoutMs: options.requestTimeoutMs }),
+        });
+    }
+    catch (error) {
+        throw toCallToolError(error, signal);
+    }
+    let onAbort;
+    if (signal !== undefined && execution.kind === "task") {
+        // settle({ signal }) only stops waiting locally; propagate the abort as a
+        // cooperative remote cancellation so the server can stop the work. The
+        // signal may have aborted while callTool was resolving, so fire directly
+        // for an abort the listener would miss.
+        onAbort = () => {
+            void execution.cancel().catch(() => { });
+        };
+        if (signal.aborted)
+            onAbort();
+        else
+            signal.addEventListener("abort", onAbort, { once: true });
+    }
+    try {
+        const settlement = await execution.settle(signal === undefined ? {} : { signal });
+        const result = resultFromTaskOutcome(settlement.outcome);
+        if (!isJsonRecord(result)) {
+            throw new Error(`Task-backed tool ${options.name} settled with a non-object result`);
+        }
+        // Match Client.callTool's lifted shape, which strips the wire-only discriminator.
+        const { resultType: _resultType, ...lifted } = result;
+        return lifted;
+    }
+    catch (error) {
+        throw toCallToolError(error, signal);
+    }
+    finally {
+        if (signal !== undefined && onAbort !== undefined)
+            signal.removeEventListener("abort", onAbort);
+        await execution.close().catch(() => { });
+    }
+}
+//# sourceMappingURL=mcp-tasks.js.map

package/node_modules/pi-mcp-adapter/dist/mcp-tasks.js.map

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

package/node_modules/pi-mcp-adapter/dist/mcp-trace.d.ts

@@ -0,0 +1,95 @@
+import type { Transport } from "@modelcontextprotocol/client";
+import type { JSONRPCMessage } from "@modelcontextprotocol/client";
+export declare const MCP_TRACE_SCHEMA_VERSION = 1;
+export declare const DEFAULT_MCP_TRACE_MAX_BYTES: number;
+export declare const DEFAULT_MCP_TRACE_MAX_EVENTS = 10000;
+export type McpTraceDirection = "outbound" | "inbound";
+export type McpTraceTransport = "stdio" | "unix-socket" | "sse" | "streamable-http" | "unknown";
+export type McpTraceMessageKind = "request" | "response" | "notification";
+export interface McpTraceSettings {
+    /** Enable metadata-only protocol tracing for all servers unless overridden. */
+    enabled?: boolean;
+    /** JSONL destination. Relative paths are resolved from the session cwd. */
+    file?: string;
+    /** Maximum bytes retained in the per-session JSONL file. */
+    maxBytes?: number;
+    /** Maximum events retained in the per-session JSONL file. */
+    maxEvents?: number;
+}
+export interface McpTraceEvent {
+    version: typeof MCP_TRACE_SCHEMA_VERSION;
+    timestamp: string;
+    direction: McpTraceDirection;
+    server: string;
+    transport: McpTraceTransport;
+    kind: McpTraceMessageKind;
+    status: "sent" | "received" | "error";
+    method?: string;
+    id?: string | number | null;
+    relatedRequestId?: string | number;
+    errorCode?: number | string;
+    bytes?: number;
+    durationMs?: number;
+}
+export interface McpTraceWriterOptions {
+    filePath: string;
+    maxBytes?: number;
+    maxEvents?: number;
+    appendFile?: (path: string, data: string, options: {
+        encoding: "utf8";
+    }) => Promise<void>;
+    writeFile?: (path: string, data: string, options: {
+        encoding: "utf8";
+    }) => Promise<void>;
+    mkdir?: (path: string, options: {
+        recursive: true;
+    }) => Promise<string | undefined>;
+}
+/** Redact strings before they can become durable trace metadata. */
+export declare function redactTraceText(value: string, maxLength?: number): string;
+export declare function createMcpTraceEvent(direction: McpTraceDirection, server: string, transport: McpTraceTransport, message: JSONRPCMessage, status: "sent" | "received" | "error", options?: {
+    relatedRequestId?: unknown;
+    durationMs?: number;
+}): McpTraceEvent;
+export declare class McpTraceWriter {
+    private readonly options;
+    private readonly maxBytes;
+    private readonly maxEvents;
+    private readonly append;
+    private readonly resetFile;
+    private readonly makeDirectory;
+    private bytesWritten;
+    private eventsWritten;
+    private queue;
+    private disabled;
+    private initializationFailed;
+    private readonly fileReady;
+    constructor(options: McpTraceWriterOptions);
+    get filePath(): string;
+    get isDisabled(): boolean;
+    get stats(): {
+        bytes: number;
+        events: number;
+    };
+    write(event: McpTraceEvent): void;
+    flush(): Promise<void>;
+}
+export declare function createMcpTraceWriter(sessionCwd: string | undefined, settings?: McpTraceSettings, randomSuffix?: string): McpTraceWriter;
+export interface McpTraceObserver {
+    record(event: McpTraceEvent): void;
+}
+export declare function isMcpTraceEnabled(definition: {
+    trace?: boolean;
+}, settings?: McpTraceSettings): boolean;
+/**
+ * Compose the SDK's transport callbacks in place instead of replacing the
+ * transport object. SDK v2 detects its base stdio transport before connect so
+ * it can run `server/discover` on a disposable sibling process; returning a
+ * wrapper hides that identity and makes tracing change negotiation behavior.
+ */
+export declare function wrapTransportWithMcpTrace(transport: Transport, server: string, transportKind: McpTraceTransport, observer: McpTraceObserver): Transport;
+export declare function traceTransportKind(definition: {
+    command?: string;
+    url?: string;
+    socket?: string;
+}, transport: Transport): McpTraceTransport;