@geohar/pi-mcp-combiner 0.13.3 → 0.14.0

package/dist/client/control.d.ts

@@ -0,0 +1,17 @@
+import type { CombinerConnection } from "./connection.js";
+export type HealthServer = {
+    name?: string;
+    status?: string;
+    state?: string;
+    transport?: string;
+};
+export type HealthSnapshot = {
+    servers?: Array<Record<string, unknown>>;
+    tool_count?: number;
+    [k: string]: unknown;
+};
+/** `status` verb: health glyph table + our session's tool view. */
+export declare function statusText(connection: CombinerConnection, cwd: string): Promise<string>;
+/** `enable` / `disable` / `restart-server` verbs via the combiner meta-tools. */
+export declare function metaToolCall(connection: CombinerConnection, verb: "enable" | "disable" | "restart-server", server: string): Promise<string>;
+//# sourceMappingURL=control.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"control.d.ts","sourceRoot":"","sources":["../../src/client/control.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAEzD,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAEjG,MAAM,MAAM,cAAc,GAAG;IACzB,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IACxC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB,CAAA;AAkBD,mEAAmE;AACnE,wBAAsB,UAAU,CAAC,UAAU,EAAE,kBAAkB,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAwC7F;AAED,iFAAiF;AACjF,wBAAsB,YAAY,CAC9B,UAAU,EAAE,kBAAkB,EAC9B,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,gBAAgB,EAC7C,MAAM,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAajB"}

package/dist/client/control.js

@@ -0,0 +1,80 @@
+// /mcp-combiner control verbs: inspect and drive the combiner from a Pi session.
+//
+// The read side hits the combiner's control plane directly (GET /health, token
+// filter routes); the write side drives the combiner__* meta-tools through our own
+// MCP client — one auth path, no second protocol.
+const GLYPHS = {
+    ready: "✓",
+    connected: "✓",
+    starting: "…",
+    connecting: "…",
+    failed: "✗",
+    error: "✗",
+    disabled: "–",
+    idle: "○",
+};
+function glyph(state) {
+    if (!state)
+        return "?";
+    return GLYPHS[state.toLowerCase()] ?? "?";
+}
+/** `status` verb: health glyph table + our session's tool view. */
+export async function statusText(connection, cwd) {
+    const lines = [];
+    lines.push(`connection: ${connection.state}${connection.lastError ? ` (${connection.lastError})` : ""}`);
+    try {
+        const health = (await connection.health());
+        // The combiner ships `servers` as an object keyed by name; tolerate arrays too.
+        const raw = health.servers;
+        const entries = [];
+        if (Array.isArray(raw)) {
+            for (const s of raw) {
+                if (typeof s === "object" && s !== null) {
+                    const rec = s;
+                    entries.push([typeof rec.name === "string" ? rec.name : "?", rec]);
+                }
+            }
+        }
+        else if (typeof raw === "object" && raw !== null) {
+            for (const [name, s] of Object.entries(raw)) {
+                if (typeof s === "object" && s !== null)
+                    entries.push([name, s]);
+            }
+        }
+        for (const [name, s] of entries) {
+            const state = typeof (s.status ?? s.state) === "string" ? String(s.status ?? s.state) : undefined;
+            const transport = typeof s.transport === "string" ? ` [${s.transport}]` : "";
+            const dis = s.disabled === true ? " (disabled)" : "";
+            lines.push(`${glyph(state)} ${name}${transport} (${state ?? "unknown"})${dis}`);
+        }
+    }
+    catch (e) {
+        lines.push(`/health unreachable: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    try {
+        const tools = await connection.listTools();
+        const servers = [...new Set(tools.map((t) => t.name.split("_", 1)[0] ?? ""))].filter(Boolean).sort();
+        lines.push(`visible to this session: ${tools.length} tools across ${servers.length} servers (${servers.join(", ")})`);
+    }
+    catch {
+        // connection state already reported above
+    }
+    lines.push(`cwd: ${cwd}`);
+    return lines.join("\n");
+}
+/** `enable` / `disable` / `restart-server` verbs via the combiner meta-tools. */
+export async function metaToolCall(connection, verb, server) {
+    const map = {
+        enable: "combiner__enable_server",
+        disable: "combiner__disable_server",
+        "restart-server": "combiner__restart_server",
+    };
+    const tool = map[verb];
+    const result = (await connection.callTool(tool, { server_name: server }));
+    const text = (result?.content ?? [])
+        .map((b) => b.text ?? "")
+        .join("\n")
+        .trim();
+    return text || `${verb} ${server}: done`;
+}
+//# sourceMappingURL=control.js.map

package/dist/client/control.js.map

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

package/dist/client/direct-tools.d.ts

@@ -0,0 +1,41 @@
+import type { ToolDefinition } from "../pi.js";
+import type { CombinerConnection, ToolSummary } from "./connection.js";
+export type DirectToolsSpec = string[] | "search";
+/** Names that must never be shadowed by a promoted tool (pi builtins). Callers add
+ *  their own tool names on top. */
+export declare const RESERVED_TOOL_NAMES: readonly ["read", "bash", "edit", "write", "grep", "find", "ls", "mcp", "glob"];
+/** Apply a server allow/deny filter to a combined tool list. Server names may
+ *  contain underscores (gws_georgeharker), so matching is by PREFIX — a tool
+ *  belongs to entry E iff its name starts `E_` (subsumes first-segment equality). */
+export declare function toolServerMatches(toolName: string, serverEntry: string): boolean;
+/** Apply a server allow/deny filter to a combined tool list (`<server>_` prefix,
+ *  underscore-safe via toolServerMatches). */
+export declare function applyServerFilter(tools: ToolSummary[], filter: {
+    allow?: string[];
+    deny?: string[];
+} | undefined): ToolSummary[];
+/** fnmatch-lite: `*` → any run, `?` → one char, everything else literal. */
+export declare function globToRegExp(pattern: string): RegExp;
+export declare function matchesGlob(name: string, pattern: string): boolean;
+/** Resolve the allowlist spec against the combined tool list (server filter applied
+ *  by the caller). Returns matching tools in list order. */
+export declare function resolveAllowlist(tools: ToolSummary[], patterns: string[]): ToolSummary[];
+export type DirectToolDeps = {
+    connection: CombinerConnection;
+    /** Names already registered (shared across syncs + search activation). */
+    registered: Set<string>;
+    /** Reserved names to refuse (builtins + this extension's own tool names). */
+    reserved: Set<string>;
+    register: (tool: ToolDefinition) => void;
+    log: (level: "info" | "warn" | "error", message: string) => void;
+};
+/** Build the Pi tool definition for one promoted combiner tool. */
+export declare function buildDirectTool(tool: ToolSummary, deps: DirectToolDeps): ToolDefinition;
+/** Register one tool if new and not reserved. Returns the name, or undefined when skipped. */
+export declare function registerDirectTool(tool: ToolSummary, deps: DirectToolDeps): string | undefined;
+/** Allowlist sync: register every matching, not-yet-registered tool. */
+export declare function syncAllowlistTools(tools: ToolSummary[], patterns: string[], deps: DirectToolDeps): number;
+/** Search-mode activation: register matched tools (bounded per activation). Returns
+ *  the newly activated names — empty when everything matched was already live. */
+export declare function activateFromSearch(matches: ToolSummary[], deps: DirectToolDeps, max?: number): string[];
+//# sourceMappingURL=direct-tools.d.ts.map

package/dist/client/direct-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-tools.d.ts","sourceRoot":"","sources":["../../src/client/direct-tools.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAItE,MAAM,MAAM,eAAe,GAAG,MAAM,EAAE,GAAG,QAAQ,CAAA;AAEjD;mCACmC;AACnC,eAAO,MAAM,mBAAmB,iFAAkF,CAAA;AAElH;;qFAEqF;AACrF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAEhF;AAED;8CAC8C;AAC9C,wBAAgB,iBAAiB,CAC7B,KAAK,EAAE,WAAW,EAAE,EACpB,MAAM,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,SAAS,GAC1D,WAAW,EAAE,CASf;AAED,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMpD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAElE;AAED;4DAC4D;AAC5D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,CAGxF;AAWD,MAAM,MAAM,cAAc,GAAG;IACzB,UAAU,EAAE,kBAAkB,CAAA;IAC9B,0EAA0E;IAC1E,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACvB,6EAA6E;IAC7E,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACrB,QAAQ,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,CAAA;IACxC,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACnE,CAAA;AAED,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,cAAc,GAAG,cAAc,CAcvF;AAED,8FAA8F;AAC9F,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAU9F;AAED,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,cAAc,GAAG,MAAM,CAczG;AAED;kFACkF;AAClF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,SAAK,GAAG,MAAM,EAAE,CAQnG"}

package/dist/client/direct-tools.js

@@ -0,0 +1,122 @@
+// Direct tool promotion: allowlist + search-mode, per the agreed design
+// (docs/adapter-design.md §Now/Later). Behavior follows pi-mcp-adapter's
+// directTools modes (MIT, © 2026 Nico Bailon).
+//
+// `combiner.directTools` on the shared-file entry is either a glob allowlist over
+// combined tool names — registered once at session start, cache-stable — or
+// "search": nothing registered upfront; the first mcp({search}) match activates
+// those tools as first-class Pi tools for the rest of the session (the adapter's
+// directTools:"search" semantics, on our own mid-session registerTool path).
+//
+// `directTools: true` is deliberately NOT offered: at combiner scale (hundreds of
+// tools) it burns the context window the proxy exists to save. Allowlists larger
+// than ~50 tools draw a loud warning and still register — an explicit list is the
+// user's call.
+import { renderToolResult, textResult } from "./render.js";
+import { directToolRenderers } from "./renderers.js";
+/** Names that must never be shadowed by a promoted tool (pi builtins). Callers add
+ *  their own tool names on top. */
+export const RESERVED_TOOL_NAMES = ["read", "bash", "edit", "write", "grep", "find", "ls", "mcp", "glob"];
+/** Apply a server allow/deny filter to a combined tool list. Server names may
+ *  contain underscores (gws_georgeharker), so matching is by PREFIX — a tool
+ *  belongs to entry E iff its name starts `E_` (subsumes first-segment equality). */
+export function toolServerMatches(toolName, serverEntry) {
+    return toolName.startsWith(`${serverEntry}_`);
+}
+/** Apply a server allow/deny filter to a combined tool list (`<server>_` prefix,
+ *  underscore-safe via toolServerMatches). */
+export function applyServerFilter(tools, filter) {
+    if (!filter)
+        return tools;
+    if (filter.allow?.length) {
+        return tools.filter((t) => filter.allow.some((e) => toolServerMatches(t.name, e)));
+    }
+    if (filter.deny?.length) {
+        return tools.filter((t) => !filter.deny.some((e) => toolServerMatches(t.name, e)));
+    }
+    return tools;
+}
+/** fnmatch-lite: `*` → any run, `?` → one char, everything else literal. */
+export function globToRegExp(pattern) {
+    const escaped = pattern
+        .replace(/[.+^${}()|[\]\\]/g, "\\$&")
+        .replace(/\*/g, ".*")
+        .replace(/\?/g, ".");
+    return new RegExp(`^${escaped}$`, "i");
+}
+export function matchesGlob(name, pattern) {
+    return globToRegExp(pattern).test(name);
+}
+/** Resolve the allowlist spec against the combined tool list (server filter applied
+ *  by the caller). Returns matching tools in list order. */
+export function resolveAllowlist(tools, patterns) {
+    const regexes = patterns.map(globToRegExp);
+    return tools.filter((t) => regexes.some((re) => re.test(t.name)));
+}
+/** Ensure a usable parameters object: pass the advertised JSON schema through when it
+ *  is an object; repair anything else to an empty object schema. */
+function normalizeInputSchema(schema) {
+    if (typeof schema === "object" && schema !== null && !Array.isArray(schema)) {
+        return schema;
+    }
+    return { type: "object", properties: {} };
+}
+/** Build the Pi tool definition for one promoted combiner tool. */
+export function buildDirectTool(tool, deps) {
+    return {
+        name: tool.name,
+        label: `MCP: ${tool.name}`,
+        description: tool.description ?? `Combiner tool ${tool.name}`,
+        parameters: normalizeInputSchema(tool.inputSchema),
+        ...directToolRenderers(tool.name),
+        execute: async () => {
+            const result = await deps.connection.callTool(tool.name, undefined);
+            const text = renderToolResult(result);
+            if (result?.isError)
+                throw new Error(text);
+            return textResult(text);
+        },
+    };
+}
+/** Register one tool if new and not reserved. Returns the name, or undefined when skipped. */
+export function registerDirectTool(tool, deps) {
+    if (deps.registered.has(tool.name))
+        return undefined;
+    if (deps.reserved.has(tool.name)) {
+        deps.log("warn", `directTools: refusing to register "${tool.name}" — reserved name`);
+        deps.registered.add(tool.name); // don't re-warn on every sync
+        return undefined;
+    }
+    deps.registered.add(tool.name);
+    deps.register(buildDirectTool(tool, deps));
+    return tool.name;
+}
+/** Allowlist sync: register every matching, not-yet-registered tool. */
+export function syncAllowlistTools(tools, patterns, deps) {
+    const matches = resolveAllowlist(tools, patterns);
+    if (matches.length > 50) {
+        deps.log("warn", `directTools: allowlist promotes ${matches.length} tools — every schema rides in every ` +
+            "request. Consider trimming (the mcp() proxy covers the rest).");
+    }
+    let added = 0;
+    for (const tool of matches) {
+        if (registerDirectTool(tool, deps))
+            added++;
+    }
+    return added;
+}
+/** Search-mode activation: register matched tools (bounded per activation). Returns
+ *  the newly activated names — empty when everything matched was already live. */
+export function activateFromSearch(matches, deps, max = 10) {
+    const activated = [];
+    for (const tool of matches) {
+        if (activated.length >= max)
+            break;
+        if (deps.registered.has(tool.name))
+            continue;
+        if (registerDirectTool(tool, deps))
+            activated.push(tool.name);
+    }
+    return activated;
+}
+//# sourceMappingURL=direct-tools.js.map

package/dist/client/direct-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-tools.js","sourceRoot":"","sources":["../../src/client/direct-tools.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,yEAAyE;AACzE,+CAA+C;AAC/C,EAAE;AACF,kFAAkF;AAClF,4EAA4E;AAC5E,gFAAgF;AAChF,iFAAiF;AACjF,6EAA6E;AAC7E,EAAE;AACF,kFAAkF;AAClF,iFAAiF;AACjF,kFAAkF;AAClF,eAAe;AAIf,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAIpD;mCACmC;AACnC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAU,CAAA;AAElH;;qFAEqF;AACrF,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,WAAmB;IACnE,OAAO,QAAQ,CAAC,UAAU,CAAC,GAAG,WAAW,GAAG,CAAC,CAAA;AACjD,CAAC;AAED;8CAC8C;AAC9C,MAAM,UAAU,iBAAiB,CAC7B,KAAoB,EACpB,MAAyD;IAEzD,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAA;IACzB,IAAI,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,KAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;IACvF,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,IAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;IACvF,CAAC;IACD,OAAO,KAAK,CAAA;AAChB,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,YAAY,CAAC,OAAe;IACxC,MAAM,OAAO,GAAG,OAAO;SAClB,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC;SACpC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC;SACpB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;IACxB,OAAO,IAAI,MAAM,CAAC,IAAI,OAAO,GAAG,EAAE,GAAG,CAAC,CAAA;AAC1C,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,OAAe;IACrD,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC3C,CAAC;AAED;4DAC4D;AAC5D,MAAM,UAAU,gBAAgB,CAAC,KAAoB,EAAE,QAAkB;IACrE,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;IAC1C,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACrE,CAAC;AAED;oEACoE;AACpE,SAAS,oBAAoB,CAAC,MAAe;IACzC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1E,OAAO,MAAiC,CAAA;IAC5C,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,CAAA;AAC7C,CAAC;AAYD,mEAAmE;AACnE,MAAM,UAAU,eAAe,CAAC,IAAiB,EAAE,IAAoB;IACnE,OAAO;QACH,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,QAAQ,IAAI,CAAC,IAAI,EAAE;QAC1B,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,iBAAiB,IAAI,CAAC,IAAI,EAAE;QAC7D,UAAU,EAAE,oBAAoB,CAAC,IAAI,CAAC,WAAW,CAAC;QAClD,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC;QACjC,OAAO,EAAE,KAAK,IAAI,EAAE;YAChB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;YACnE,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAA;YACrC,IAAK,MAAgC,EAAE,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,CAAA;YACrE,OAAO,UAAU,CAAC,IAAI,CAAC,CAAA;QAC3B,CAAC;KACJ,CAAA;AACL,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,kBAAkB,CAAC,IAAiB,EAAE,IAAoB;IACtE,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAA;IACpD,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,sCAAsC,IAAI,CAAC,IAAI,mBAAmB,CAAC,CAAA;QACpF,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA,CAAC,8BAA8B;QAC7D,OAAO,SAAS,CAAA;IACpB,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC9B,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAA;IAC1C,OAAO,IAAI,CAAC,IAAI,CAAA;AACpB,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,kBAAkB,CAAC,KAAoB,EAAE,QAAkB,EAAE,IAAoB;IAC7F,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;IACjD,IAAI,OAAO,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACtB,IAAI,CAAC,GAAG,CACJ,MAAM,EACN,mCAAmC,OAAO,CAAC,MAAM,uCAAuC;YACpF,+DAA+D,CACtE,CAAA;IACL,CAAC;IACD,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QACzB,IAAI,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC;YAAE,KAAK,EAAE,CAAA;IAC/C,CAAC;IACD,OAAO,KAAK,CAAA;AAChB,CAAC;AAED;kFACkF;AAClF,MAAM,UAAU,kBAAkB,CAAC,OAAsB,EAAE,IAAoB,EAAE,GAAG,GAAG,EAAE;IACrF,MAAM,SAAS,GAAa,EAAE,CAAA;IAC9B,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QACzB,IAAI,SAAS,CAAC,MAAM,IAAI,GAAG;YAAE,MAAK;QAClC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,SAAQ;QAC5C,IAAI,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC;YAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACjE,CAAC;IACD,OAAO,SAAS,CAAA;AACpB,CAAC"}

package/dist/client/elicitation.d.ts

@@ -0,0 +1,22 @@
+import type { ExtensionUIContext } from "../pi.js";
+export type ElicitUi = {
+    hasUI: boolean;
+    ui?: ExtensionUIContext;
+};
+export type ElicitRequest = {
+    message?: string;
+    requestedSchema?: unknown;
+};
+export type ElicitResponse = {
+    action: "accept";
+    content: Record<string, ElicitValue>;
+} | {
+    action: "decline" | "cancel";
+};
+/** Primitive value an elicitation form can collect (the SDK's accepted value set,
+ *  incl. string[] for array-typed form fields). */
+export type ElicitValue = string | number | boolean | string[];
+/** Handle an elicitation request against Pi's UI. Never throws — a UI that can't
+ *  answer declines, and the combiner applies its elicitUnavailable policy. */
+export declare function handleElicitation(req: ElicitRequest, elicitUi: ElicitUi): Promise<ElicitResponse>;
+//# sourceMappingURL=elicitation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"elicitation.d.ts","sourceRoot":"","sources":["../../src/client/elicitation.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAElD,MAAM,MAAM,QAAQ,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,EAAE,CAAC,EAAE,kBAAkB,CAAA;CAAE,CAAA;AAElE,MAAM,MAAM,aAAa,GAAG;IACxB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,eAAe,CAAC,EAAE,OAAO,CAAA;CAC5B,CAAA;AAED,MAAM,MAAM,cAAc,GACtB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAA;CAAE,CAAA;AAIjG;mDACmD;AACnD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAA;AAiD9D;8EAC8E;AAC9E,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,CA2BvG"}

package/dist/client/elicitation.js

@@ -0,0 +1,93 @@
+// Elicitation bridge: MCP server→client elicitation → Pi's ctx.ui dialogs.
+//
+// The structured dialogs (select/confirm/input) are the right model: each mode
+// (interactive, RPC, print) provides its own implementation, so a gate question
+// renders as a native TUI dialog locally AND extends over the wire as
+// extension_ui_request frames in RPC mode — remote clients (e.g. un-bien's
+// paired app) render them natively. Custom TUI overlays would be interactive-
+// mode-only and would not reach remote clients; pi-ask's flow is a separate
+// protocol we deliberately don't couple to.
+//
+// Load-bearing for the combiner's permissions gate, which elicits
+// (Allow once / Allow for session / Deny) for tools whose policy resolves to elicit;
+// its secure fallback is elicitUnavailable: deny. So when no dialog-capable UI exists
+// we return "decline" rather than hanging — the combiner then denies the call.
+//
+// Simplified from pi-mcp-adapter's elicitation-handler.ts (MIT, © 2026 Nico Bailon):
+// form schemas map to sequential per-property dialogs (enum→select, boolean→confirm,
+// string/number→input); there is no URL-elicitation mode (no OAuth here).
+// Options are returned VERBATIM — the combiner string-matches the gate choice.
+const REFUSE = { action: "decline" };
+function isRecord(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+/** Coerce raw dialog input to the declared primitive; undefined when it doesn't fit. */
+function coerce(raw, type) {
+    if (type === "number" || type === "integer") {
+        const n = Number(raw);
+        if (!Number.isFinite(n))
+            return undefined;
+        return type === "integer" ? Math.trunc(n) : n;
+    }
+    return raw;
+}
+/** Present one property's dialog; returns the value or undefined (cancelled/invalid). */
+async function askProperty(ui, label, prop) {
+    const type = typeof prop.type === "string" ? prop.type : "string";
+    const desc = typeof prop.description === "string" && prop.description ? ` — ${prop.description}` : "";
+    if (Array.isArray(prop.enum) && prop.enum.every((v) => typeof v === "string")) {
+        const options = prop.enum;
+        const picked = await ui.select?.(`${label}${desc}`, options);
+        return picked;
+    }
+    if (type === "boolean") {
+        return await ui.confirm?.(label, `${prop.description ?? "Allow this request?"}`, undefined);
+    }
+    if (type === "array") {
+        // Best-effort arrays: comma-separated input (v1 — no repeat-prompt loop yet).
+        const raw = await ui.input?.(`${label}${desc}`, "a,b,c (comma-separated)");
+        if (raw === undefined)
+            return undefined;
+        const items = raw
+            .split(",")
+            .map((s) => s.trim())
+            .filter((s) => s.length > 0);
+        return items;
+    }
+    const raw = await ui.input?.(`${label}${desc}`, type === "string" ? "string" : type);
+    if (raw === undefined)
+        return undefined;
+    const value = coerce(raw, type);
+    return value;
+}
+/** Handle an elicitation request against Pi's UI. Never throws — a UI that can't
+ *  answer declines, and the combiner applies its elicitUnavailable policy. */
+export async function handleElicitation(req, elicitUi) {
+    if (!elicitUi.hasUI || !elicitUi.ui?.select || !elicitUi.ui.input)
+        return REFUSE;
+    const schema = isRecord(req.requestedSchema) ? req.requestedSchema : undefined;
+    const props = schema && isRecord(schema.properties) ? schema.properties : undefined;
+    const header = typeof req.message === "string" && req.message ? req.message : "MCP server request";
+    // No schema → boolean-shaped consent question (covers plain allow/deny elicits).
+    if (!props || Object.keys(props).length === 0) {
+        const ok = await elicitUi.ui.confirm?.(header, "Allow?", undefined);
+        if (ok === undefined)
+            return REFUSE;
+        return ok ? { action: "accept", content: {} } : REFUSE;
+    }
+    // Sequential per-property dialogs — each element rides the mode-implemented
+    // UI surface, so multi-property forms work over the wire too. A single-
+    // property form (the consent-gate shape) asks under the bare message; only
+    // multi-property forms prefix the property name.
+    const entries = Object.entries(props).filter(([, v]) => isRecord(v));
+    const content = {};
+    for (const [name, raw] of entries) {
+        const label = entries.length === 1 ? header : `${header}: ${name}`;
+        const value = await askProperty(elicitUi.ui, label, raw);
+        if (value === undefined)
+            return REFUSE;
+        content[name] = value;
+    }
+    return { action: "accept", content };
+}
+//# sourceMappingURL=elicitation.js.map

package/dist/client/elicitation.js.map

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

package/dist/client/footer.d.ts

@@ -0,0 +1,17 @@
+import type { CombinerConnection } from "./connection.js";
+import type { ExtensionUIContext } from "../pi.js";
+import type { FooterStatus } from "./settings.js";
+export type FooterCounts = {
+    enabled: number;
+    ready: number;
+    disabled: number;
+};
+/** Derive enabled/ready/disabled counts from a /health snapshot. Tolerates both
+ *  the object-keyed shape (what the combiner serves) and an array (defensive). */
+export declare function countsFromHealth(health: unknown): FooterCounts;
+/** Render the footer text for a mode (undefined = clear the slot). */
+export declare function footerText(mode: FooterStatus, counts: FooterCounts, connectionState: string, toolCount?: number): string | undefined;
+/** Refresh the footer from live health + this session's tool view. Never throws;
+ *  logs (once) when the UI cannot take a status so a dead label is diagnosable. */
+export declare function updateFooter(connection: CombinerConnection, ui: ExtensionUIContext | undefined, key: string, mode: FooterStatus): Promise<void>;
+//# sourceMappingURL=footer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"footer.d.ts","sourceRoot":"","sources":["../../src/client/footer.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAajD,MAAM,MAAM,YAAY,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAA;AAE/E;kFACkF;AAClF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,YAAY,CAyB9D;AAED,sEAAsE;AACtE,wBAAgB,UAAU,CACtB,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,YAAY,EACpB,eAAe,EAAE,MAAM,EACvB,SAAS,CAAC,EAAE,MAAM,GACnB,MAAM,GAAG,SAAS,CAWpB;AAID;mFACmF;AACnF,wBAAsB,YAAY,CAC9B,UAAU,EAAE,kBAAkB,EAC9B,EAAE,EAAE,kBAAkB,GAAG,SAAS,EAClC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,YAAY,GACnB,OAAO,CAAC,IAAI,CAAC,CA2Bf"}

package/dist/client/footer.js

@@ -0,0 +1,99 @@
+// Footer status line for enabled MCP servers, compatible with pi-mcp-adapter's
+// mcpFooterStatus setting: "full" (default) = "N servers enabled (M ready) · T tools",
+// "compact" = "MCP M/N", "off" = none. Published via ctx.ui.setStatus under the key
+// `mcp` (default, overridable via the mcpFooterKey setting) — the slot
+// pi-mcp-adapter wrote and oh-my-posh-style footers aggregate into PI_STATUS.
+/** Health entry server states we count as "ready" (combiner /health semantics). */
+const READY_STATES = new Set(["ready", "connected"]);
+/** nf-fa-plug (U+F1E6), emitted directly — a nerd-font codepoint, never an emoji,
+ *  so the glyph renders in any nerd-font terminal and passes through footer
+ *  translation layers (oh-my-posh's ICON_MAP) untouched. */
+const PLUG = "\uF1E6";
+/** Derive enabled/ready/disabled counts from a /health snapshot. Tolerates both
+ *  the object-keyed shape (what the combiner serves) and an array (defensive). */
+export function countsFromHealth(health) {
+    const raw = health?.servers;
+    const entries = [];
+    if (Array.isArray(raw)) {
+        for (const s of raw)
+            if (typeof s === "object" && s !== null)
+                entries.push(["", s]);
+    }
+    else if (typeof raw === "object" && raw !== null) {
+        for (const [name, s] of Object.entries(raw)) {
+            if (typeof s === "object" && s !== null)
+                entries.push([name, s]);
+        }
+    }
+    else {
+        return { enabled: 0, ready: 0, disabled: 0 };
+    }
+    let enabled = 0;
+    let ready = 0;
+    let disabled = 0;
+    for (const [, s] of entries) {
+        if (s.disabled) {
+            disabled++;
+            continue;
+        }
+        enabled++;
+        const state = (s.state ?? s.status ?? "").toLowerCase();
+        if (READY_STATES.has(state))
+            ready++;
+    }
+    return { enabled, ready, disabled };
+}
+/** Render the footer text for a mode (undefined = clear the slot). */
+export function footerText(mode, counts, connectionState, toolCount) {
+    if (mode === "off")
+        return undefined;
+    if (mode === "compact")
+        return `${PLUG} MCP ${counts.ready}/${counts.enabled}`;
+    let text = `${PLUG} ${counts.enabled} ${counts.enabled === 1 ? "server" : "servers"} enabled`;
+    if (counts.ready > 0)
+        text += ` (${counts.ready} ready)`;
+    if (counts.disabled > 0)
+        text += ` (${counts.disabled} disabled)`;
+    if (typeof toolCount === "number" && toolCount > 0)
+        text += ` · ${toolCount} tools`;
+    if (connectionState !== "connected" && connectionState !== "disconnected") {
+        text += ` — ${connectionState}`;
+    }
+    return text;
+}
+let warnedNoSetStatus = false;
+/** Refresh the footer from live health + this session's tool view. Never throws;
+ *  logs (once) when the UI cannot take a status so a dead label is diagnosable. */
+export async function updateFooter(connection, ui, key, mode) {
+    if (mode === "off")
+        return;
+    const setStatus = ui?.setStatus;
+    if (!setStatus) {
+        if (!warnedNoSetStatus) {
+            warnedNoSetStatus = true;
+            // Headless/print modes have no footer — fine — but a TUI session with no
+            // setStatus deserves one log line rather than a silently missing label.
+            if (ui)
+                console.error(`mcp-combiner: footer unavailable (ctx.ui has no setStatus)`);
+        }
+        return;
+    }
+    let text;
+    try {
+        const [health, tools] = await Promise.all([connection.health(), connection.listTools().catch(() => undefined)]);
+        const toolCount = tools?.length;
+        text = footerText(mode, countsFromHealth(health), connection.state, toolCount);
+    }
+    catch {
+        // Combiner unreachable: report our connection state honestly, still occupying
+        // the slot so the label never silently vanishes.
+        text = footerText(mode, { enabled: 0, ready: 0, disabled: 0 }, connection.state);
+    }
+    try {
+        setStatus(key, text);
+    }
+    catch (e) {
+        console.error(`mcp-combiner: footer setStatus failed (${e instanceof Error ? e.message : String(e)})`);
+    }
+}
+//# sourceMappingURL=footer.js.map

package/dist/client/footer.js.map

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

package/dist/client/panel.d.ts

@@ -0,0 +1,16 @@
+import type { CombinerConnection } from "./connection.js";
+export type PanelDeps = {
+    connection: CombinerConnection;
+    toolName: string;
+    /** This session's grouping token (identity row). */
+    getToken: () => string | undefined;
+    /** This session's project server filter, if any ([session off] labels). */
+    getFilter: () => {
+        allow?: string[];
+        deny?: string[];
+    } | undefined;
+    notify: (message: string, level?: "info" | "warn" | "error") => void;
+};
+/** Open the panel as a centered overlay; resolves when closed. */
+export declare function openCombinerPanel(deps: PanelDeps, ui: unknown): Promise<void>;
+//# sourceMappingURL=panel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"panel.d.ts","sourceRoot":"","sources":["../../src/client/panel.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,kBAAkB,EAA+C,MAAM,iBAAiB,CAAA;AAQtG,MAAM,MAAM,SAAS,GAAG;IACpB,UAAU,EAAE,kBAAkB,CAAA;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,MAAM,GAAG,SAAS,CAAA;IAClC,2EAA2E;IAC3E,SAAS,EAAE,MAAM;QAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,SAAS,CAAA;IAClE,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,KAAK,IAAI,CAAA;CACvE,CAAA;AA6aD,kEAAkE;AAClE,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBnF"}