@geohar/pi-mcp-combiner 0.13.3 → 0.14.0

package/dist/client/config-ladder.js

@@ -0,0 +1,162 @@
+// Shared-MCP-config reading for the combiner entry — the `.pi/mcp.json` interplay.
+//
+// The extension READS the standard MCP files (pi-mcp-adapter's ladder, mirrored here)
+// but never writes them. It recognizes "its" entry (`mcp-combiner` by name,
+// `x-combiner: true`, or a url whose origin matches the resolved combiner origin) and
+// honors:
+//   - `url` (incl. an explicit path token like /mcp/pi-<name>, which wins over our
+//     minted per-session token)
+//   - `auth`/`bearerTokenEnv` (compat keys; we only ever send a static bearer)
+//   - a namespaced `combiner` block for per-project exposure knobs:
+//       { "servers": { "allow": [...] | "deny": [...] }, "exposeResources": bool, "prompts": bool }
+//     Unknown keys pass through pi-mcp-adapter's lenient validator untouched, so this
+//     file stays valid for both readers simultaneously.
+//
+// Later files win (adapter precedence order). Server DEFINITIONS stay global in the
+// combiner's servers.json — the ladder only shapes connection + exposure.
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { agentDir } from "./settings.js";
+/** The ladder, lowest precedence first. Mirrors pi-mcp-adapter's documented order. */
+export function ladderPaths(cwd) {
+    return [
+        join(homedir(), ".config", "mcp", "mcp.json"),
+        join(homedir(), ".agents", "mcp.json"),
+        join(homedir(), ".agents", "mcp", "mcp.json"),
+        join(agentDir(), "mcp.json"),
+        join(cwd, ".mcp.json"),
+        join(cwd, ".pi", "mcp.json"),
+    ];
+}
+/** Origin (scheme://host:port) of a URL string, or undefined when unparseable. */
+function origin(url) {
+    try {
+        return new URL(url).origin;
+    }
+    catch {
+        return undefined;
+    }
+}
+function isRecord(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function stringArray(v) {
+    return Array.isArray(v) && v.every((x) => typeof x === "string") ? v : undefined;
+}
+/** Recognize "our" entry: explicit name, explicit marker, or url origin match. */
+export function isCombinerEntry(name, entry, combinerOrigin) {
+    if (name === "mcp-combiner")
+        return true;
+    if (entry["x-combiner"] === true)
+        return true;
+    const url = typeof entry.url === "string" ? entry.url : undefined;
+    if (url && combinerOrigin && origin(url) === combinerOrigin)
+        return true;
+    return false;
+}
+/** Parse one file's contribution: the combiner entry (if recognized) + other names. */
+function readOne(path, combinerOrigin) {
+    let doc;
+    try {
+        doc = JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return { others: [] }; // absent or malformed → contributes nothing
+    }
+    if (!isRecord(doc))
+        return { others: [] };
+    const servers = doc.mcpServers ?? doc["mcp-servers"];
+    if (!isRecord(servers))
+        return { others: [] };
+    let entry;
+    const others = [];
+    for (const [name, raw] of Object.entries(servers)) {
+        if (!isRecord(raw))
+            continue;
+        if (isCombinerEntry(name, raw, combinerOrigin)) {
+            // Later ladder files replace (not deep-merge) the entry, matching the
+            // adapter's later-wins semantics; the `combiner` block merges per-key.
+            const prev = entry;
+            const block = { ...(prev?.combiner ?? {}) };
+            const rawBlock = isRecord(raw.combiner) ? raw.combiner : undefined;
+            if (rawBlock) {
+                const serversBlock = isRecord(rawBlock.servers) ? rawBlock.servers : undefined;
+                if (serversBlock) {
+                    block.servers = {
+                        allow: stringArray(serversBlock.allow) ?? block.servers?.allow,
+                        deny: stringArray(serversBlock.deny) ?? block.servers?.deny,
+                    };
+                }
+                if (typeof rawBlock.exposeResources === "boolean")
+                    block.exposeResources = rawBlock.exposeResources;
+                if (typeof rawBlock.prompts === "boolean")
+                    block.prompts = rawBlock.prompts;
+                if (rawBlock.directTools === "search")
+                    block.directTools = "search";
+                else if (stringArray(rawBlock.directTools)?.length)
+                    block.directTools = stringArray(rawBlock.directTools);
+            }
+            entry = {
+                url: typeof raw.url === "string" && raw.url ? raw.url : prev?.url,
+                bearerTokenEnv: typeof raw.bearerTokenEnv === "string" && raw.bearerTokenEnv
+                    ? raw.bearerTokenEnv
+                    : prev?.bearerTokenEnv,
+                combiner: Object.keys(block).length ? block : prev?.combiner,
+            };
+        }
+        else {
+            others.push(name);
+        }
+    }
+    return { entry, others };
+}
+/** Walk the ladder (cwd-relative project files included) and merge. */
+export function readLadder(cwd, combinerOrigin) {
+    const out = { entry: {}, otherServers: [], sources: [] };
+    for (const path of ladderPaths(cwd)) {
+        if (!existsSync(path))
+            continue;
+        out.sources.push(path);
+        const { entry, others } = readOne(path, combinerOrigin);
+        if (entry)
+            out.entry = entry;
+        for (const name of others)
+            if (!out.otherServers.includes(name))
+                out.otherServers.push(name);
+    }
+    return out;
+}
+/** Extract an explicit /mcp/<token> path token from a URL, if present. */
+export function urlTokenOf(url) {
+    const m = url.match(/\/mcp\/([^/?#]+)/);
+    return m?.[1];
+}
+/** Normalize a URL back to bare /mcp (strip any token path). */
+export function stripUrlToken(url) {
+    return url.replace(/(\/mcp)\/[^/?#]+/, "$1");
+}
+function originOf(url) {
+    try {
+        return new URL(url).origin;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Resolve the full per-session config. Pure — no env or settings reads inside. */
+export function resolveSessionConfig(opts) {
+    const ladder = readLadder(opts.cwd, originOf(opts.defaultUrl));
+    const url = opts.envUrl ?? opts.settingsUrl ?? ladder.entry.url ?? opts.defaultUrl;
+    return {
+        baseUrl: stripUrlToken(url),
+        bearerTokenEnv: ladder.entry.bearerTokenEnv,
+        urlToken: urlTokenOf(url),
+        serverFilter: ladder.entry.combiner?.servers,
+        directSpec: ladder.entry.combiner?.directTools,
+        entry: ladder.entry,
+        otherServers: ladder.otherServers,
+        sources: ladder.sources,
+    };
+}
+//# sourceMappingURL=config-ladder.js.map

package/dist/client/config-ladder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-ladder.js","sourceRoot":"","sources":["../../src/client/config-ladder.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,EAAE;AACF,sFAAsF;AACtF,4EAA4E;AAC5E,sFAAsF;AACtF,UAAU;AACV,mFAAmF;AACnF,gCAAgC;AAChC,+EAA+E;AAC/E,oEAAoE;AACpE,oGAAoG;AACpG,sFAAsF;AACtF,wDAAwD;AACxD,EAAE;AACF,oFAAoF;AACpF,0EAA0E;AAE1E,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AA8BxC,sFAAsF;AACtF,MAAM,UAAU,WAAW,CAAC,GAAW;IACnC,OAAO;QACH,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,CAAC;QAC7C,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC;QACtC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,CAAC;QAC7C,IAAI,CAAC,QAAQ,EAAE,EAAE,UAAU,CAAC;QAC5B,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC;QACtB,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,UAAU,CAAC;KAC/B,CAAA;AACL,CAAC;AAED,kFAAkF;AAClF,SAAS,MAAM,CAAC,GAAW;IACvB,IAAI,CAAC;QACD,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,CAAA;IAC9B,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,SAAS,CAAA;IACpB,CAAC;AACL,CAAC;AAED,SAAS,QAAQ,CAAC,CAAU;IACxB,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;AACnE,CAAC;AAED,SAAS,WAAW,CAAC,CAAU;IAC3B,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAE,CAAc,CAAC,CAAC,CAAC,SAAS,CAAA;AAClG,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,eAAe,CAC3B,IAAY,EACZ,KAA8B,EAC9B,cAAkC;IAElC,IAAI,IAAI,KAAK,cAAc;QAAE,OAAO,IAAI,CAAA;IACxC,IAAI,KAAK,CAAC,YAAY,CAAC,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IAC7C,MAAM,GAAG,GAAG,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAA;IACjE,IAAI,GAAG,IAAI,cAAc,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,cAAc;QAAE,OAAO,IAAI,CAAA;IACxE,OAAO,KAAK,CAAA;AAChB,CAAC;AAED,uFAAuF;AACvF,SAAS,OAAO,CAAC,IAAY,EAAE,cAAkC;IAC7D,IAAI,GAAY,CAAA;IAChB,IAAI,CAAC;QACD,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAA;IAChD,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAA,CAAC,4CAA4C;IACtE,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAA;IACzC,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,aAAa,CAAC,CAAA;IACpD,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAA;IAE7C,IAAI,KAAgC,CAAA;IACpC,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,SAAQ;QAC5B,IAAI,eAAe,CAAC,IAAI,EAAE,GAAG,EAAE,cAAc,CAAC,EAAE,CAAC;YAC7C,sEAAsE;YACtE,uEAAuE;YACvE,MAAM,IAAI,GAAG,KAAK,CAAA;YAClB,MAAM,KAAK,GAAkB,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,IAAI,EAAE,CAAC,EAAE,CAAA;YAC1D,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAA;YAClE,IAAI,QAAQ,EAAE,CAAC;gBACX,MAAM,YAAY,GAAG,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;gBAC9E,IAAI,YAAY,EAAE,CAAC;oBACf,KAAK,CAAC,OAAO,GAAG;wBACZ,KAAK,EAAE,WAAW,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,KAAK;wBAC9D,IAAI,EAAE,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,IAAI;qBAC9D,CAAA;gBACL,CAAC;gBACD,IAAI,OAAO,QAAQ,CAAC,eAAe,KAAK,SAAS;oBAAE,KAAK,CAAC,eAAe,GAAG,QAAQ,CAAC,eAAe,CAAA;gBACnG,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,SAAS;oBAAE,KAAK,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAA;gBAC3E,IAAI,QAAQ,CAAC,WAAW,KAAK,QAAQ;oBAAE,KAAK,CAAC,WAAW,GAAG,QAAQ,CAAA;qBAC9D,IAAI,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM;oBAC9C,KAAK,CAAC,WAAW,GAAG,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;YAC7D,CAAC;YACD,KAAK,GAAG;gBACJ,GAAG,EAAE,OAAO,GAAG,CAAC,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG;gBACjE,cAAc,EACV,OAAO,GAAG,CAAC,cAAc,KAAK,QAAQ,IAAI,GAAG,CAAC,cAAc;oBACxD,CAAC,CAAC,GAAG,CAAC,cAAc;oBACpB,CAAC,CAAC,IAAI,EAAE,cAAc;gBAC9B,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ;aAC/D,CAAA;QACL,CAAC;aAAM,CAAC;YACJ,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACrB,CAAC;IACL,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAA;AAC5B,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,cAAkC;IACtE,MAAM,GAAG,GAAiB,EAAE,KAAK,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAA;IACtE,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;QAClC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAQ;QAC/B,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACtB,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,cAAc,CAAC,CAAA;QACvD,IAAI,KAAK;YAAE,GAAG,CAAC,KAAK,GAAG,KAAK,CAAA;QAC5B,KAAK,MAAM,IAAI,IAAI,MAAM;YAAE,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAAE,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAChG,CAAC;IACD,OAAO,GAAG,CAAA;AACd,CAAC;AAiCD,0EAA0E;AAC1E,MAAM,UAAU,UAAU,CAAC,GAAW;IAClC,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAA;IACvC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,aAAa,CAAC,GAAW;IACrC,OAAO,GAAG,CAAC,OAAO,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAA;AAChD,CAAC;AAED,SAAS,QAAQ,CAAC,GAAW;IACzB,IAAI,CAAC;QACD,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,CAAA;IAC9B,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,SAAS,CAAA;IACpB,CAAC;AACL,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,oBAAoB,CAAC,IAAiC;IAClE,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAA;IAC9D,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,WAAW,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,UAAU,CAAA;IAClF,OAAO;QACH,OAAO,EAAE,aAAa,CAAC,GAAG,CAAC;QAC3B,cAAc,EAAE,MAAM,CAAC,KAAK,CAAC,cAAc;QAC3C,QAAQ,EAAE,UAAU,CAAC,GAAG,CAAC;QACzB,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO;QAC5C,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,WAAW;QAC9C,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,OAAO,EAAE,MAAM,CAAC,OAAO;KAC1B,CAAA;AACL,CAAC"}

package/dist/client/connection.d.ts

@@ -0,0 +1,113 @@
+import { Client } from "@modelcontextprotocol/client";
+import { type ElicitUi } from "./elicitation.js";
+import type { ServerFilter } from "./config-ladder.js";
+export type LogFn = (level: "info" | "warn" | "error", message: string) => void;
+export type ResolvedConnection = {
+    /** Base URL including /mcp, WITHOUT any token path (e.g. http://127.0.0.1:9741/mcp). */
+    baseUrl: string;
+    /** Env var holding the inbound bearer token (read at connect time), if any. */
+    bearerTokenEnv?: string;
+    /** Explicit token already present in the configured URL path (user override). */
+    urlToken?: string;
+};
+export type ConnectionState = "disconnected" | "connecting" | "connected" | "failed";
+export type ToolSummary = {
+    name: string;
+    description?: string;
+    inputSchema?: unknown;
+};
+export type PromptArgument = {
+    name: string;
+    description?: string;
+    required?: boolean;
+};
+export type PromptSummary = {
+    name: string;
+    title?: string;
+    description?: string;
+    arguments?: PromptArgument[];
+};
+export type ResourceSummary = {
+    uri: string;
+    name?: string;
+    description?: string;
+    mimeType?: string;
+    _meta?: Record<string, unknown>;
+};
+/** Optional callbacks fired by the connection (set from index.ts wiring). */
+export type ConnectionHooks = {
+    /** tools/list_changed arrived — caches invalidated; refresh derived surfaces. */
+    onToolsChanged?: () => void;
+    /** connection state transitioned — refresh footer/status surfaces. */
+    onStateChange?: (state: ConnectionState) => void;
+    /** Stage 2: the combiner announced a widget UI URL while an agent tool call
+     *  is held in flight — the client should open it (gated by uiAutoOpen). */
+    onWidgetUrl?: (url: string) => void;
+};
+/** Build the tokened endpoint URL: <origin>/mcp/<token> (combiner's URL form). */
+export declare function tokenedUrl(baseUrl: string, token: string): string;
+export declare class CombinerConnection {
+    private conn;
+    private readonly log;
+    /** Latest dialog-capable UI, refreshed each session_start. */
+    private elicitUi;
+    private prompts;
+    private promptsFetchedAt;
+    private resources;
+    private resourcesFetchedAt;
+    private token;
+    private client;
+    private connecting;
+    private tools;
+    private toolsFetchedAt;
+    private hooks;
+    state: ConnectionState;
+    lastError: string | undefined;
+    constructor(conn: ResolvedConnection, log: LogFn);
+    /** Bind lifecycle hooks (tools changed / state transitions). */
+    setHooks(hooks: ConnectionHooks): void;
+    /** Effective grouping token for this session (explicit URL token wins). */
+    get sessionToken(): string | undefined;
+    /** Bind the UI slice used by elicitation (called from session_start). */
+    bindUi(ui: ElicitUi): void;
+    /** Swap connection inputs (base URL / bearer env) when a session re-resolves a
+     *  different combiner URL (e.g. a worktree branch pinning its own combiner).
+     *  No-op when nothing changed; otherwise drops the client for a fresh connect. */
+    rebind(conn: ResolvedConnection): boolean;
+    /** Set the grouping token for this session; resets any open connection. */
+    setToken(token: string): void;
+    /** Drop the connection + caches (session reset / shutdown). Never throws. */
+    reset(reason: string): Promise<void>;
+    /** Effective token: explicit URL token wins over the minted session token. */
+    private effectiveToken;
+    /** Connect (idempotent, single-flight). Throws with a human message on failure. */
+    ensureConnected(): Promise<Client>;
+    /** tools/list, cached until invalidated (list_changed / reset / reconnect). */
+    listTools(force?: boolean): Promise<ToolSummary[]>;
+    /** prompts/list, cached alongside tools (combiner namespaces `<server>_<name>`). */
+    listPrompts(force?: boolean): Promise<PromptSummary[]>;
+    /** prompts/get through the combiner. */
+    getPrompt(name: string, args: Record<string, string>): Promise<unknown>;
+    /** resources/list, cached alongside tools/prompts. */
+    listResources(force?: boolean): Promise<ResourceSummary[]>;
+    /** resources/read through the combiner. */
+    readResource(uri: string): Promise<unknown>;
+    /** callTool with a single stale-session retry: on transport/stale errors we reset
+     *  and reconnect once (the combiner may have bounced; handover keeps our token). */
+    callTool(name: string, args: Record<string, unknown> | undefined): Promise<unknown>;
+    /** Control-plane origin for the combiner's REST routes (/health, /sessions/*). */
+    controlOrigin(): string;
+    /** The interactive-UI URL for a resource (the combiner's UI host serves the
+     *  widget for THIS session's token), or empty when no token is set. */
+    uiUrlFor(resourceUri: string): string;
+    /** Headers for control-plane calls: the same inbound bearer as /mcp (the combiner
+     *  gates its mutating routes — /sessions*, /handover* — with it; /health is open
+     *  but presenting anyway is harmless). */
+    private controlHeaders;
+    /** POST the project-derived server filter for our token. The combiner accepts
+     *  pending filters pre-connect, so this is safe before the first connect. */
+    applyFilter(filter: ServerFilter): Promise<void>;
+    /** GET /health — the control-plane health snapshot. */
+    health(): Promise<unknown>;
+}
+//# sourceMappingURL=connection.d.ts.map

package/dist/client/connection.d.ts.map

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

package/dist/client/connection.js

@@ -0,0 +1,332 @@
+// The combiner MCP client: one streamable-HTTP connection, one token, reconnect.
+//
+// This is the piece that makes the extension the adapter: it owns the Client +
+// StreamableHTTPClientTransport pair against the combiner's /mcp endpoint, mints the
+// per-Pi-session grouping token into the URL path (URL form beats headers combiner-
+// side, so the token rides the path), sends the optional inbound bearer, bridges
+// elicitation to Pi's UI, and keeps a tools/list cache fresh via tools/list_changed.
+//
+// Lifecycle: lazy by default (connect on first mcp() call), `eager` connects at
+// session_start. A session reset (new/resume/fork/reload) rebinds the token and
+// drops the client; a transport close or stale-session 404 triggers a one-shot
+// reconnect-and-retry on the next call. The combiner's handover means the same token
+// resumes its parked isolated upstream sessions after a combiner restart.
+import { Client, StreamableHTTPClientTransport } from "@modelcontextprotocol/client";
+import { handleElicitation } from "./elicitation.js";
+const CLIENT_INFO = { name: "pi-mcp-combiner", version: "0.1.0" };
+const CONNECT_TIMEOUT_MS = 8_000;
+function isRecord(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+/** Pull {message, requestedSchema} out of an elicitation/create request params,
+ *  tolerating both form-mode and legacy shapes. Returns undefined when unusable. */
+function toElicitParams(raw) {
+    const p = isRecord(raw) ? raw : undefined;
+    if (!p)
+        return undefined;
+    const out = {};
+    if (typeof p.message === "string")
+        out.message = p.message;
+    if (isRecord(p.requestedSchema))
+        out.requestedSchema = p.requestedSchema;
+    return out;
+}
+/** Build the tokened endpoint URL: <origin>/mcp/<token> (combiner's URL form). */
+export function tokenedUrl(baseUrl, token) {
+    try {
+        const u = new URL(baseUrl);
+        // Normalize to bare /mcp (strip any existing path segments below it), append token.
+        const path = u.pathname.replace(/\/mcp(?:\/[^/]*)*\/?$/, "/mcp");
+        u.pathname = `${path.replace(/\/$/, "")}/${encodeURIComponent(token)}`;
+        return u.toString();
+    }
+    catch {
+        return baseUrl;
+    }
+}
+export class CombinerConnection {
+    conn;
+    log;
+    /** Latest dialog-capable UI, refreshed each session_start. */
+    elicitUi = { hasUI: false };
+    prompts;
+    promptsFetchedAt = 0;
+    resources;
+    resourcesFetchedAt = 0;
+    token;
+    client;
+    connecting;
+    tools;
+    toolsFetchedAt = 0;
+    hooks = {};
+    state = "disconnected";
+    lastError;
+    constructor(conn, log) {
+        this.conn = conn;
+        this.log = log;
+    }
+    /** Bind lifecycle hooks (tools changed / state transitions). */
+    setHooks(hooks) {
+        this.hooks = hooks;
+    }
+    /** Effective grouping token for this session (explicit URL token wins). */
+    get sessionToken() {
+        return this.effectiveToken();
+    }
+    /** Bind the UI slice used by elicitation (called from session_start). */
+    bindUi(ui) {
+        this.elicitUi = ui;
+    }
+    /** Swap connection inputs (base URL / bearer env) when a session re-resolves a
+     *  different combiner URL (e.g. a worktree branch pinning its own combiner).
+     *  No-op when nothing changed; otherwise drops the client for a fresh connect. */
+    rebind(conn) {
+        if (conn.baseUrl === this.conn.baseUrl &&
+            conn.bearerTokenEnv === this.conn.bearerTokenEnv &&
+            conn.urlToken === this.conn.urlToken) {
+            return false;
+        }
+        this.conn = conn;
+        void this.reset("connection rebound (session config changed)");
+        return true;
+    }
+    /** Set the grouping token for this session; resets any open connection. */
+    setToken(token) {
+        if (this.token === token)
+            return;
+        this.token = token;
+        void this.reset("token changed");
+    }
+    /** Drop the connection + caches (session reset / shutdown). Never throws. */
+    async reset(reason) {
+        const client = this.client;
+        this.client = undefined;
+        this.connecting = undefined;
+        this.tools = undefined;
+        this.state = "disconnected";
+        try {
+            await client?.close();
+        }
+        catch {
+            // best-effort
+        }
+        if (reason)
+            this.log("info", `connection reset (${reason})`);
+    }
+    /** Effective token: explicit URL token wins over the minted session token. */
+    effectiveToken() {
+        return this.conn.urlToken ?? this.token;
+    }
+    /** Connect (idempotent, single-flight). Throws with a human message on failure. */
+    async ensureConnected() {
+        if (this.client)
+            return this.client;
+        if (this.connecting)
+            return this.connecting;
+        const token = this.effectiveToken();
+        if (!token)
+            throw new Error("no grouping token set (session not started)");
+        const url = tokenedUrl(this.conn.baseUrl, token);
+        let endpoint;
+        try {
+            endpoint = new URL(url);
+        }
+        catch {
+            throw new Error(`combiner URL "${url}" is not parseable; set a valid url (…/mcp) in settings or mcp.json`);
+        }
+        const bearer = this.conn.bearerTokenEnv ? process.env[this.conn.bearerTokenEnv] : undefined;
+        this.state = "connecting";
+        this.connecting = (async () => {
+            const client = new Client(CLIENT_INFO, { capabilities: { elicitation: {} } });
+            const transport = new StreamableHTTPClientTransport(endpoint, {
+                authProvider: bearer ? { token: async () => bearer } : undefined,
+            });
+            // Elicitation bridge — the combiner's permission gate depends on it.
+            client.setRequestHandler("elicitation/create", (req) => {
+                const params = toElicitParams(isRecord(req) ? req.params : undefined);
+                if (!params)
+                    return { action: "decline" };
+                return handleElicitation(params, this.elicitUi);
+            });
+            client.setNotificationHandler("notifications/tools/list_changed", () => {
+                this.tools = undefined; // refetch on next list
+                this.prompts = undefined;
+                this.resources = undefined;
+                try {
+                    this.hooks.onToolsChanged?.();
+                }
+                catch {
+                    // hook errors must never break the notification path
+                }
+            });
+            client.setNotificationHandler("notifications/resources/list_changed", () => {
+                this.resources = undefined;
+                try {
+                    this.hooks.onToolsChanged?.();
+                }
+                catch {
+                    // hook errors must never break the notification path
+                }
+            });
+            // Stage 2: the widget hold announces its UI URL via a log
+            // notification ("Interactive UI ready: <url>") while the agent's
+            // call is in flight — open it so the user sees the widget at once.
+            client.setNotificationHandler("notifications/message", (n) => {
+                const data = n.params?.data;
+                if (typeof data !== "string")
+                    return;
+                const m = data.match(/Interactive UI ready: (\S+)/);
+                if (m) {
+                    try {
+                        this.hooks.onWidgetUrl?.(m[1]);
+                    }
+                    catch {
+                        // hook errors must never break the notification path
+                    }
+                }
+            });
+            client.onclose = () => {
+                if (this.client === client) {
+                    this.client = undefined;
+                    this.state = "disconnected";
+                }
+            };
+            await Promise.race([
+                client.connect(transport),
+                new Promise((_, reject) => setTimeout(() => reject(new Error("connect timeout")), CONNECT_TIMEOUT_MS)),
+            ]);
+            this.client = client;
+            this.state = "connected";
+            this.lastError = undefined;
+            this.hooks.onStateChange?.(this.state);
+            return client;
+        })();
+        try {
+            return await this.connecting;
+        }
+        catch (e) {
+            this.state = "failed";
+            this.lastError = e instanceof Error ? e.message : String(e);
+            this.log("warn", `combiner connect failed (${this.lastError})`);
+            this.hooks.onStateChange?.(this.state);
+            throw new Error(`cannot reach the combiner at ${this.conn.baseUrl}: ${this.lastError}`);
+        }
+        finally {
+            this.connecting = undefined;
+        }
+    }
+    /** tools/list, cached until invalidated (list_changed / reset / reconnect). */
+    async listTools(force = false) {
+        if (!force && this.tools && Date.now() - this.toolsFetchedAt < 5_000)
+            return this.tools;
+        const client = await this.ensureConnected();
+        const res = await client.listTools();
+        this.tools = (res.tools ?? []);
+        this.toolsFetchedAt = Date.now();
+        return this.tools;
+    }
+    /** prompts/list, cached alongside tools (combiner namespaces `<server>_<name>`). */
+    async listPrompts(force = false) {
+        if (!force && this.prompts && Date.now() - this.promptsFetchedAt < 5_000)
+            return this.prompts;
+        const client = await this.ensureConnected();
+        const res = await client.listPrompts();
+        this.prompts = (res.prompts ?? []);
+        this.promptsFetchedAt = Date.now();
+        return this.prompts;
+    }
+    /** prompts/get through the combiner. */
+    async getPrompt(name, args) {
+        const client = await this.ensureConnected();
+        return client.getPrompt({ name, arguments: args });
+    }
+    /** resources/list, cached alongside tools/prompts. */
+    async listResources(force = false) {
+        if (!force && this.resources && Date.now() - this.resourcesFetchedAt < 5_000)
+            return this.resources;
+        const client = await this.ensureConnected();
+        const res = await client.listResources();
+        this.resources = (res.resources ?? []);
+        this.resourcesFetchedAt = Date.now();
+        return this.resources;
+    }
+    /** resources/read through the combiner. */
+    async readResource(uri) {
+        const client = await this.ensureConnected();
+        return client.readResource({ uri });
+    }
+    /** callTool with a single stale-session retry: on transport/stale errors we reset
+     *  and reconnect once (the combiner may have bounced; handover keeps our token). */
+    async callTool(name, args) {
+        const attempt = async () => {
+            const client = await this.ensureConnected();
+            return client.callTool({ name, arguments: args ?? {} });
+        };
+        try {
+            return await attempt();
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            const stale = /404|stale|session|not found|closed|fetch failed/i.test(msg);
+            if (!stale)
+                throw e;
+            this.log("info", `call "${name}" went stale (${msg}); reconnecting once`);
+            await this.reset("stale session");
+            return await attempt();
+        }
+    }
+    /** Control-plane origin for the combiner's REST routes (/health, /sessions/*). */
+    controlOrigin() {
+        try {
+            return new URL(this.conn.baseUrl).origin;
+        }
+        catch {
+            return this.conn.baseUrl;
+        }
+    }
+    /** The interactive-UI URL for a resource (the combiner's UI host serves the
+     *  widget for THIS session's token), or empty when no token is set. */
+    uiUrlFor(resourceUri) {
+        const token = this.effectiveToken();
+        if (!token || !resourceUri)
+            return "";
+        return `${this.controlOrigin()}/ui/${encodeURIComponent(token)}/?resource=${encodeURIComponent(resourceUri)}`;
+    }
+    /** Headers for control-plane calls: the same inbound bearer as /mcp (the combiner
+     *  gates its mutating routes — /sessions*, /handover* — with it; /health is open
+     *  but presenting anyway is harmless). */
+    controlHeaders() {
+        const token = this.conn.bearerTokenEnv ? process.env[this.conn.bearerTokenEnv] : undefined;
+        return token ? { authorization: `Bearer ${token}` } : {};
+    }
+    /** POST the project-derived server filter for our token. The combiner accepts
+     *  pending filters pre-connect, so this is safe before the first connect. */
+    async applyFilter(filter) {
+        const token = this.effectiveToken();
+        if (!token)
+            throw new Error("no grouping token set (session not started)");
+        const body = {};
+        if (filter.allow?.length)
+            body.allowed_servers = filter.allow;
+        else if (filter.deny?.length)
+            body.disabled_servers = filter.deny;
+        else
+            return;
+        const res = await fetch(`${this.controlOrigin()}/sessions/token/${encodeURIComponent(token)}/filter`, {
+            method: "POST",
+            headers: { "content-type": "application/json", ...this.controlHeaders() },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok)
+            throw new Error(`filter apply failed: ${res.status} ${await res.text().catch(() => "")}`);
+        this.log("info", `session server filter applied (${filter.allow ? "allow" : "deny"}-list)`);
+    }
+    /** GET /health — the control-plane health snapshot. */
+    async health() {
+        const res = await fetch(`${this.controlOrigin()}/health`, { headers: this.controlHeaders() });
+        if (!res.ok)
+            throw new Error(`/health returned ${res.status}`);
+        return res.json();
+    }
+}
+//# sourceMappingURL=connection.js.map

package/dist/client/connection.js.map

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