@geohar/pi-mcp-combiner 0.14.2 → 0.16.0-dev.1

package/src/native/resources.ts

@@ -0,0 +1,112 @@
+// NATIVE RESOURCE TOOLS : read_* tools for
+// INTERACTIVE (mcp-app / ui://) resources — the parity half of legacy-client/
+// resources.ts that pi's built-in read_mcp_resource deliberately does NOT cover
+// (it skips ui:// listings and renders nothing).
+//
+// Parity contract with legacy read_<resource> tools:
+//   - SAME naming: read_<resourceNameToToolName(resource.name ?? uri)>
+//   - SAME attribution + project filtering: resourceServer() + `<server>_`/
+//     `<server>-` prefix matching against the per-project ServerFilter
+//   - SAME read behavior: connection.readResource(uri) → renderResourceResult
+//     (markup as text, json prettified, blobs as byte notes, 16KB guard)
+//   - SAME surfacing: append the combiner UI-host URL (this session's token),
+//     auto-open in the browser when a dialog-capable UI exists (uiAutoOpen)
+//   - idempotent registration; re-syncs on resources/list_changed (the
+//     connection's onToolsChanged hook covers both list-change notifications)
+//
+// TEXT/image resources are NOT re-registered here — pi's built-in
+// read_mcp_resource + tool_search discovery covers them in native mode; that is
+// the deliberate (documented) divergence from legacy, which registered one
+// zero-arg tool per resource of every kind.
+
+import type { ExtensionAPI, ToolDefinition } from "../pi.js"
+import type { NativeCombinerConnection, ResourceSummary } from "./combiner-connection.js"
+import { isInteractiveResource, openInBrowser, renderResourceResult } from "../client/widget-support.js"
+import { resourceNameToToolName, resourceServer } from "../client/resource-naming.js"
+import type { ServerFilter } from "../client/config-ladder.js"
+
+export type NativeResourceOptions = {
+    connection: NativeCombinerConnection
+    /** Per-project server filter, same semantics as legacy filterResources. */
+    serverFilter?: ServerFilter
+    /** Auto-open the widget URL on read (index.ts's uiAutoOpen setting). */
+    uiAutoOpen?: boolean
+    log: (level: "info" | "warn" | "error", message: string) => void
+}
+
+/** Project server filter for resources — mirrors legacy filterResources
+ *  attribution semantics (uri host first, `<server>_` name-prefix fallback). */
+export function filterInteractiveResources(
+    resources: ResourceSummary[],
+    filter: ServerFilter | undefined,
+): ResourceSummary[] {
+    const interactive = resources.filter(isInteractiveResource)
+    if (!filter) return interactive
+    const matches = (r: ResourceSummary, entry: string): boolean =>
+        resourceServer(r) === entry ||
+        (r.name ?? "").startsWith(`${entry}_`) ||
+        (r.name ?? "").startsWith(`${entry}-`)
+    if (filter.allow?.length) return interactive.filter((r) => filter.allow!.some((e) => matches(r, e)))
+    if (filter.deny?.length) return interactive.filter((r) => !filter.deny!.some((e) => matches(r, e)))
+    return interactive
+}
+
+function toReadTool(toolName: string, resource: ResourceSummary, opts: NativeResourceOptions): ToolDefinition {
+    const label = resource.name ?? resource.uri
+    const url = opts.connection.uiUrlFor(resource.uri)
+    return {
+        name: toolName,
+        label: `MCP resource: ${label}`,
+        description: [
+            resource.description ?? `Read MCP resource ${resource.uri}`,
+            `uri: ${resource.uri}`,
+            resource.mimeType ? `type: ${resource.mimeType}` : undefined,
+            "interactive app resource — markup as text; the interactive widget opens from the URL appended to results",
+        ]
+            .filter(Boolean)
+            .join(" | "),
+        promptSnippet: `Read MCP resource ${label}.`,
+        parameters: { type: "object", properties: {} },
+        exposure: "direct",
+        namespace: { name: "mcp_combiner", description: "mcp-combiner aggregated tools" },
+        execute: async (_toolCallId, _params, _signal, _onUpdate, ctx) => {
+            try {
+                const result = await opts.connection.readResource(resource.uri)
+                let text = renderResourceResult(result)
+                if (url) {
+                    text = `${text}\n\ninteractive: ${url}`
+                    if (opts.uiAutoOpen !== false && ctx?.hasUI) openInBrowser(url)
+                }
+                return { content: [{ type: "text", text }], details: { mode: "resource", uri: resource.uri, url: url || undefined } }
+            } catch (e) {
+                throw new Error(`${toolName}: resource read failed (${e instanceof Error ? e.message : String(e)})`)
+            }
+        },
+    }
+}
+
+/** Register read_* tools for the interactive resources (idempotent, like legacy).
+ *  Returns the tool names registered this pass. */
+export async function activateNativeResources(
+    pi: ExtensionAPI,
+    opts: NativeResourceOptions,
+    registered: Set<string>,
+): Promise<string[]> {
+    let resources: ResourceSummary[] = []
+    try {
+        resources = filterInteractiveResources(await opts.connection.listResources(true), opts.serverFilter)
+    } catch (e) {
+        opts.log("warn", `interactive resource discovery failed (${e instanceof Error ? e.message : String(e)})`)
+        return []
+    }
+    const added: string[] = []
+    for (const resource of resources) {
+        const toolName = `read_${resourceNameToToolName(resource.name ?? resource.uri)}`
+        if (registered.has(toolName)) continue
+        registered.add(toolName)
+        pi.registerTool(toReadTool(toolName, resource, opts))
+        added.push(toolName)
+    }
+    if (added.length) opts.log("info", `native resources: ${added.length} interactive resource tool(s) registered`)
+    return added
+}

package/src/native/tool-surface.ts

@@ -0,0 +1,147 @@
+// NATIVE TOOL SURFACE : declares the combiner's tools
+// to Pi FIRST-CLASS, via pi.registerTool with exposure/namespace/annotations — the
+// replacement for client/proxy-tool.ts + client/script.ts + direct-tools.ts promotion.
+//
+// What this buys (the whole point of the native path):
+//
+//   - every tool is declared under its own name (`github_search_code`), one hop,
+//     no mcp() wrapper and no mcpScript
+//   - exposure IS pi's native mechanism: `direct` for the daily drivers (declared to
+//     the model verbatim), `codemode` for the rest (callable from codemode scripts,
+//     listed only as a namespace — 4%-token cost since pi 1.0), so the combiner's
+//     671 tools stay out of the declaration budget by default
+//   - annotations (readOnly/destructive hints) ride along, so pi-permission-system
+//     and other tool_call gates classify combiner calls without any adapter glue
+//   - tool_search / codemode searchTools() find undeclared ones by BM25, replacing
+//     directTools:"search" promotion with pi's own discovery
+//
+// Exposure mapping reuses the existing config vocabulary: the `combiner.directTools`
+// allowlist in the mcp.json ladder means "these are direct" here; everything else is
+// `codemode`. `directTools: "search"` degenerates to plain codemode (pi's tool_search
+// replaces it). Per-project allow/deny keeps flowing combiner-side via applyFilter.
+//
+// Wire shape: register once at session_start (tools list is stable modulo
+// list_changed, which re-registers on the same names). Tools the combiner offers
+// during a session surface via the connection's onToolsChanged hook → activate again.
+
+import type { ExtensionAPI, ToolDefinition, ToolParameters } from "../pi.js"
+import type { NativeCombinerConnection, ToolSummary } from "./combiner-connection.js"
+import { applyServerFilter, matchesGlob, RESERVED_TOOL_NAMES } from "../client/tool-matching.js"
+import type { ServerFilter } from "../client/config-ladder.js"
+
+function isRecord(v: unknown): v is Record<string, unknown> {
+    return typeof v === "object" && v !== null && !Array.isArray(v)
+}
+
+export type NativeToolSurfaceOptions = {
+    /** The resolved combiner connection (owns elicitation, filters, caches). */
+    connection: NativeCombinerConnection
+    /** The per-project server filter (same object index.ts passes to applyFilter);
+     *  applied defensively here too so a filter race never widens surface exposure. */
+    serverFilter?: ServerFilter
+    /** The combiner block's directTools spec, as resolved from the ladder: a glob
+     *  allowlist → "direct" exposure for matches; "search" → everything codemode. */
+    directSpec?: string[] | "search"
+    /** Warn when the direct-exposure set grows large (every declared schema rides in
+     *  every request). Settings kill-switch: warnLargeDirectExposure (default true). */
+    warnLargeDirectExposure?: boolean
+    /** Namespace shown in codemode's grouped listing (pi normalizes -/­_ alike). */
+    namespaceName?: string
+    /** Names that must never be shadowed by a combiner tool (pi builtins + ours). */
+    reserved?: readonly string[]
+    log: (level: "info" | "warn" | "error", message: string) => void
+}
+
+/** Map a CallToolResult content block to pi's text-block contract. pi tool results
+ *  are arrays of text blocks today; image/other blocks are summarized to text and the
+ *  full result rides `details` for renderers (same shape the SDK client half uses). */
+function textBlockOf(b: unknown): { type: "text"; text: string } {
+    const block = isRecord(b) ? b : undefined
+    if (block && block.type === "text") {
+        return { type: "text", text: String(block.text) }
+    }
+    const kind = block?.type ?? (block ? "content" : b)
+    return { type: "text", text: `[${String(kind)} block]` }
+}
+
+function toToolResult(call: { content?: unknown; structuredContent?: unknown }): {
+    content: { type: "text"; text: string }[]
+} {
+    const blocks = Array.isArray(call.content) ? call.content : []
+    return { content: blocks.map((b) => textBlockOf(b)) }
+}
+
+/** Register the combiner's tools natively. */
+const DIRECT_EXPOSURE_WARN_THRESHOLD = 50
+
+/** Turn one combiner ToolSummary into pi's ToolDefinition, plus the native-only fields
+ *  pi 1.0 accepts on registerTool (exposure/namespace/annotations). */
+function toNativeTool(sum: ToolSummary, conn: NativeCombinerConnection, exposure: ToolDefinition["exposure"]): ToolDefinition {
+    const name = sum.name
+    return {
+        name,
+        label: name,
+        description: sum.description ?? name,
+        parameters: (sum.inputSchema as ToolParameters) ?? { type: "object", properties: {} },
+        // NATIVE-ONLY fields (pi ≥ 1.0 host contract): exposure decides how the tool is
+        // declared; namespace groups it in codemode's listing; annotations feed
+        // pi-permission-system's classification. Kept optional on ToolDefinition so the
+        // extension stays load-compatible with pi 0.99.x where these fields are ignored.
+        exposure,
+        namespace: { name: "mcp_combiner", description: "mcp-combiner aggregated tools" },
+        annotations: sum.annotations,
+        execute: async (_toolCallId, params, signal) => {
+            // The abort signal rides into the transport; the combiner can cancel
+            // upstream work, and widget holds respect it (notifications/cancelled).
+            void signal
+            try {
+                const result = await conn.callTool(name, params)
+                return { ...toToolResult(result), details: result }
+            } catch (e) {
+                // pi's error convention: THROWING marks the call an error (no isError
+                // property on successful results).
+                throw e instanceof Error ? e : new Error(String(e))
+            }
+        },
+    }
+}
+
+/** Register the combiner's tools natively. Returns the names it registered (for
+ *  status/panel surfaces). Idempotent by name — pi.registerTool replaces by name with
+ *  a warning, so re-registration on list_changed must pass the same names. */
+export async function activateNativeTools(pi: ExtensionAPI, opts: NativeToolSurfaceOptions): Promise<string[]> {
+    const registered = [] as string[]
+    const cachedNames: string[] = registered
+    const tools = applyServerFilter(await opts.connection.listTools(true), opts.serverFilter)
+    const allowlist = Array.isArray(opts.directSpec) ? opts.directSpec : []
+    const reserved = new Set<string>([...(opts.reserved ?? []), ...RESERVED_TOOL_NAMES])
+
+    const directNames: string[] = []
+    for (const sum of tools) {
+        if (reserved.has(sum.name)) {
+            opts.log("warn", `skipping combiner tool "${sum.name}" — collides with a reserved name`)
+            continue
+        }
+        // Allowlist glob match → declared verbatim ("direct"); everything else rides
+        // codemode: callable from scripts, discoverable via tool_search/searchTools(),
+        // near-zero declaration cost. "search" degrades to the same codemode mapping
+        // (pi's tool_search replaces the adapter's search-promote semantics).
+        const exposure = allowlist.some((p) => matchesGlob(sum.name, p)) ? "direct" : "codemode"
+        if (exposure === "direct") directNames.push(sum.name)
+        pi.registerTool(toNativeTool(sum, opts.connection, exposure))
+        cachedNames.push(sum.name)
+    }
+    if (
+        directNames.length > DIRECT_EXPOSURE_WARN_THRESHOLD &&
+        opts.warnLargeDirectExposure !== false
+    ) {
+        opts.log(
+            "warn",
+            `native mode: ${directNames.length} tools declared "direct" — every schema rides in every ` +
+                `request. Consider trimming the allowlist (directTools) or disabling this warning ` +
+                `with "warnLargeDirectExposure": false in extensions/mcp-combiner.json.`,
+        )
+    }
+    opts.log("info", `native tool surface: ${cachedNames.length} tools registered`)
+    return cachedNames
+}

package/src/pi.ts

@@ -118,6 +118,22 @@ export type ToolDefinition = {
         theme: RenderTheme,
         context: { [key: string]: unknown },
     ) => TuiComponent
+    /** NATIVE-exposure fields (pi ≥ 1.0 host contract; optional so 0.99.x hosts ignore
+     *  them instead of erroring — unknown fields are dropped by the 0.99 loader):
+     *    exposure    — "direct" | "model-only" | "codemode" | "deferred" | "hidden":
+     *                  how the tool is declared to the model (codemode: callable from
+     *                  codemode scripts, listed as a namespace in the codemode tool's
+     *                  description — near-zero token cost as of pi 1.0)
+     *    namespace   — groups the tool in codemode's listing, like an MCP server
+     *    annotations — MCP tool hints; reach pi.getAllTools() for permission gates */
+    exposure?: "direct" | "model-only" | "codemode" | "deferred" | "hidden"
+    namespace?: { name: string; description: string }
+    annotations?: {
+        readOnlyHint?: boolean
+        destructiveHint?: boolean
+        idempotentHint?: boolean
+        openWorldHint?: boolean
+    }
 }
 
 export type CommandSpec = {

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

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

package/dist/client/connection.js

@@ -1,332 +0,0 @@
-// 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

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