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

package/dist/native/combiner-connection.js

@@ -0,0 +1,412 @@
+// NATIVE CONNECTION : the combiner MCP client rebuilt
+// on @earendil-works/pi-mcp (peer dependency on pi's own published MCP package) so the
+// connection is OURS and therefore the elicitation capability is OURS to declare:
+//
+//     capabilities: { elicitation: {} }          // advertised, because we CAN answer
+//     client.setRequestHandler("elicitation/create", …)   // elicitation.ts bridge
+//
+// Everything else falls through to pi-mcp: transports, reconnection of dropped SSE
+// streams, protocol negotiation, tool/resource listing with pagination, roots. We add
+// only what the combiner needs on top: the per-Pi-session grouping token in the URL
+// path, the optional inbound bearer, tools/prompts/resources caches, one stale-session
+// retry, and the widget log-notification tap.
+//
+// CONTRACT: this class matches client/connection.ts's public surface structurally, so
+// existing consumers (prompts.ts, resources.ts, footer.ts, panel.ts, control.ts) work
+// unchanged and index.ts's mode gate can pick either implementation. The model-facing
+// difference from the SDK client half is registration: see native/tool-surface.ts —
+// tools are declared to pi NATIVELY (pi.registerTool with exposure/namespace), there is
+// no mcp() proxy and no script tool.
+//
+// Why instantiate instead of wrapping: pi's built-in MCP extension owns its client
+// instances privately; no hook reaches them (verified 0.99→1.0). Owning the connection
+// is the only sanctioned way to advertise elicitation today. The two-switch upstream
+// design (per-server config + handler-availability negotiation) remains the ecosystem
+// endgame; this class is what the extension ships until and after that lands.
+import { appendFileSync } from "node:fs";
+import { McpClient, McpSessionExpiredError, StreamableHttpTransport } from "@earendil-works/pi-mcp";
+import { handleElicitation } from "../client/elicitation.js";
+function ncDbg(s) {
+    try {
+        appendFileSync("/tmp/pi-combiner-dbg.log", `${new Date().toISOString()} ${s}\n`);
+    }
+    catch {
+        // debug only
+    }
+}
+const CLIENT_INFO = { name: "pi-mcp-combiner", version: "0.14.3" };
+const CONNECT_TIMEOUT_MS = 8_000;
+const LIST_CACHE_MS = 5_000;
+function isRecord(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+/** Build the tokened endpoint URL: <origin>/mcp/<token> (identical to client/connection.ts). */
+export function tokenedUrl(baseUrl, token) {
+    try {
+        const u = new URL(baseUrl);
+        const path = u.pathname.replace(/\/mcp(?:\/[^/]*)*\/?$/, "/mcp");
+        u.pathname = `${path.replace(/\/$/, "")}/${encodeURIComponent(token)}`;
+        return u.toString();
+    }
+    catch {
+        return baseUrl;
+    }
+}
+export class NativeCombinerConnection {
+    conn;
+    log;
+    elicitUi = { hasUI: false };
+    token;
+    client;
+    connecting;
+    tools;
+    toolsFetchedAt = 0;
+    prompts;
+    promptsFetchedAt = 0;
+    resources;
+    resourcesFetchedAt = 0;
+    hooks = {};
+    state = "disconnected";
+    lastError;
+    constructor(conn, log) {
+        this.conn = conn;
+        this.log = log;
+    }
+    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); drops the client when changed. */
+    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.prompts = undefined;
+        this.resources = undefined;
+        this.state = "disconnected";
+        try {
+            await client?.close();
+        }
+        catch {
+            // best-effort
+        }
+        if (reason)
+            this.log("info", `connection reset (${reason})`);
+    }
+    effectiveToken() {
+        return this.conn.urlToken ?? this.token;
+    }
+    /** Connect (idempotent, single-flight). THE elicitation-relevant site: the
+     *  capability + request handler live HERE, on a client we own. */
+    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 endpoint = tokenedUrl(this.conn.baseUrl, token);
+        let url;
+        try {
+            url = new URL(endpoint);
+        }
+        catch {
+            throw new Error(`combiner URL "${endpoint}" 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 McpClient({
+                name: CLIENT_INFO.name,
+                version: CLIENT_INFO.version,
+                // Advertised elicitation — the combiner's permission gate depends on it,
+                // and our handler below CAN answer (decline when no dialog UI exists).
+                capabilities: { elicitation: {} },
+                // Widget holds keep a call in flight up to MCP_COMBINER_UI_HOLD_TIMEOUT
+                // (default 50s combiner-side); 90s headroom so the native call outlives it.
+                requestTimeoutMs: 90_000,
+            });
+            client.setRequestHandler("elicitation/create", async (raw, { signal }) => {
+                const params = isRecord(raw) ? raw : undefined;
+                const message = typeof params?.message === "string" ? params.message : undefined;
+                const requestedSchema = isRecord(params?.requestedSchema) ? params?.requestedSchema : undefined;
+                if (!message && !requestedSchema)
+                    return { action: "decline" };
+                const result = await handleElicitation({ message, requestedSchema }, this.elicitUi, signal);
+                return result;
+            });
+            // pi-mcp's onNotification listeners receive the notification PARAMS directly
+            // (not the raw envelope) — params shape for notifications/message is
+            // { level, logger, data }.
+            client.onNotification("notifications/tools/list_changed", () => {
+                this.tools = undefined;
+                this.prompts = undefined;
+                this.resources = undefined;
+                try {
+                    this.hooks.onToolsChanged?.();
+                }
+                catch {
+                    // hook errors must never break the notification path
+                }
+            });
+            client.onNotification("notifications/resources/list_changed", () => {
+                this.resources = undefined;
+                try {
+                    this.hooks.onToolsChanged?.();
+                }
+                catch {
+                    // hook errors must never break the notification path
+                }
+            });
+            // Widget hold announces its UI URL via a log notification mid-flight.
+            client.onNotification("notifications/message", (params) => {
+                const data = (isRecord(params) ? params.data : undefined);
+                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";
+                    this.hooks.onStateChange?.(this.state);
+                }
+            });
+            const transport = new StreamableHttpTransport({
+                url,
+                authProvider: bearer ? { token: async () => bearer } : undefined,
+            });
+            await Promise.race([
+                client.connect(transport),
+                new Promise((_, reject) => setTimeout(() => reject(new Error("connect timeout")), CONNECT_TIMEOUT_MS)),
+            ]);
+            this.client = client;
+            ncDbg(`ensureConnected: CONNECTED session=${client.sessionId ?? "?"} state=${client.transport?.sessionId ?? "?"}`);
+            this.state = "connected";
+            this.lastError = undefined;
+            // Catch-up after (re)connect — same rationale as client/connection.ts:
+            // MCP notifications are lossy for disconnected clients, so re-sync every
+            // surface the moment the stream is live again. Idempotent upstream.
+            try {
+                this.hooks.onToolsChanged?.();
+            }
+            catch {
+                // hook errors must never break the connect path
+            }
+            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} — the combiner may have restarted; this call did not run and is safe to retry (carried state: grants, filters, parked sessions survives restarts)`);
+        }
+        finally {
+            this.connecting = undefined;
+        }
+    }
+    /** One-shot stale-session retry shared by EVERY request method — a combiner
+     *  bounce invalidates the transport session, and the first operation to notice
+     *  can be any of them (the router's listTools lookup runs BEFORE callTool;
+     *  without this it surfaced raw McpSessionExpiredError and never reset the
+     *  client, wedging the connection until reload). Same classification as
+     *  callTool: the typed McpSessionExpiredError first, the message regex as belt. */
+    async withStaleRetry(label, op) {
+        const client = await this.ensureConnected();
+        try {
+            return await op(client);
+        }
+        catch (e) {
+            const typedStale = e instanceof McpSessionExpiredError;
+            const msg = e instanceof Error ? e.message : String(e);
+            ncDbg(`${label} THROW typed=${typedStale} ${msg.slice(0, 140)}`);
+            const stale = typedStale || /404|stale|session|not found|closed|fetch failed|illegal/i.test(msg);
+            if (!stale)
+                throw e;
+            ncDbg(`${label} stale-retry FIRED`);
+            this.log("info", `${label} went stale (${msg}); reconnecting once`);
+            await this.reset("stale session");
+            return await op(await this.ensureConnected());
+        }
+    }
+    /** tools/list, cached until invalidated (list_changed / reset / reconnect).
+     *  pi-mcp returns the tools array directly (pagination already resolved). */
+    async listTools(force = false) {
+        if (!force && this.tools && Date.now() - this.toolsFetchedAt < LIST_CACHE_MS)
+            return this.tools;
+        const client = await this.ensureConnected();
+        const tools = (await this.withStaleRetry("listTools", (c) => c.listTools())).map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: t.inputSchema,
+            annotations: t.annotations,
+        }));
+        this.tools = tools;
+        this.toolsFetchedAt = Date.now();
+        return tools;
+    }
+    /** prompts/list, cached alongside tools. pi-mcp has no prompts convenience (yet);
+     *  the generic request() is the sanctioned path for server-initiated methods the
+     *  client doesn't model. */
+    async listPrompts(force = false) {
+        if (!force && this.prompts && Date.now() - this.promptsFetchedAt < LIST_CACHE_MS)
+            return this.prompts;
+        const res = await this.withStaleRetry("listPrompts", (c) => c.request("prompts/list"));
+        this.prompts = res.prompts ?? [];
+        this.promptsFetchedAt = Date.now();
+        return this.prompts;
+    }
+    /** prompts/get through the combiner. */
+    async getPrompt(name, args) {
+        return this.withStaleRetry(`getPrompt ${name}`, (c) => c.request("prompts/get", { name, arguments: args }));
+    }
+    /** resources/list, cached alongside tools/prompts.
+     *  SAFETY: pi-mcp's Resource adds typed `_meta` variance the combiner surfaces as
+     *  Record<string, unknown> — the shapes agree on the fields we consume
+     *  (uri/name/description/mimeType), so the cast narrows only metadata typing. */
+    async listResources(force = false) {
+        if (!force && this.resources && Date.now() - this.resourcesFetchedAt < LIST_CACHE_MS)
+            return this.resources;
+        const resources = (await this.withStaleRetry("listResources", (c) => c.listResources()));
+        this.resources = resources;
+        this.resourcesFetchedAt = Date.now();
+        return resources;
+    }
+    /** resources/read through the combiner. */
+    async readResource(uri) {
+        return this.withStaleRetry(`readResource ${uri}`, (c) => c.readResource(uri));
+    }
+    /** callTool with one stale-session retry (combiner bounce; handover keeps token).
+     *  A server-marked error (CallToolResult.isError) THROWS so pi records the call
+     *  as a tool error — same convention the rest of the extension uses. */
+    async callTool(name, args) {
+        const attempt = async () => {
+            const client = await this.ensureConnected();
+            const result = await client.callTool(name, args);
+            if (result.isError) {
+                const text = (result.content ?? [])
+                    .map((b) => (isRecord(b) && b.type === "text" && typeof b.text === "string" ? b.text : JSON.stringify(b)))
+                    .filter(Boolean)
+                    .join("\n");
+                throw new Error(`combiner tool error (${name}): ${text}`);
+            }
+            return result;
+        };
+        try {
+            return await attempt();
+        }
+        catch (e) {
+            // pi-mcp raises a TYPED McpSessionExpiredError on 404-with-session-id (the
+            // combiner's stale-session 404) — catch it first-class, exactly like pi's
+            // own builtin does ("retry once on a new session; the old client is
+            // detached, not closed, so other in-flight calls get their own 404 and
+            // retry the same way"). The message regex stays as a belt for anything
+            // the transport doesn't classify.
+            const typedStale = e instanceof McpSessionExpiredError;
+            const msg = e instanceof Error ? e.message : String(e);
+            ncDbg(`callTool ${name} THROW typed=${typedStale} status=${e?.status} ${msg.slice(0, 140)}`);
+            const stale = typedStale || /404|stale|session|not found|closed|fetch failed|illegal/i.test(msg);
+            if (!stale)
+                throw e;
+            ncDbg(`callTool ${name} stale-retry FIRED`);
+            this.log("info", `call "${name}" went stale (${typedStale ? "session expired (typed)" : msg}); reconnecting once`);
+            await this.reset("stale session");
+            ncDbg(`callTool ${name} reset done; retrying`);
+            try {
+                const result = await attempt();
+                ncDbg(`callTool ${name} RETRY SUCCEEDED`);
+                return result;
+            }
+            catch (e2) {
+                ncDbg(`callTool ${name} RETRY FAILED: ${e2 instanceof Error ? e2.message : String(e2)}`);
+                throw e2;
+            }
+        }
+    }
+    // ── control plane (unchanged from client/connection.ts) ─────────────────────────
+    controlOrigin() {
+        try {
+            return new URL(this.conn.baseUrl).origin;
+        }
+        catch {
+            return this.conn.baseUrl;
+        }
+    }
+    uiUrlFor(resourceUri) {
+        const token = this.effectiveToken();
+        if (!token || !resourceUri)
+            return "";
+        return `${this.controlOrigin()}/ui/${encodeURIComponent(token)}/?resource=${encodeURIComponent(resourceUri)}`;
+    }
+    controlHeaders() {
+        const token = this.conn.bearerTokenEnv ? process.env[this.conn.bearerTokenEnv] : undefined;
+        return token ? { authorization: `Bearer ${token}` } : {};
+    }
+    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)`);
+    }
+    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=combiner-connection.js.map

package/dist/native/combiner-connection.js.map

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

package/dist/native/index.d.ts

@@ -0,0 +1,30 @@
+import type { ExtensionAPI, ExtensionContext } from "../pi.js";
+import type { ServerFilter } from "../client/config-ladder.js";
+import { NativeCombinerConnection } from "./combiner-connection.js";
+export { NativeCombinerConnection } from "./combiner-connection.js";
+export { activateNativeTools, type NativeToolSurfaceOptions } from "./tool-surface.js";
+export { tokenedUrl } from "./combiner-connection.js";
+export { activateNativeResources, filterInteractiveResources, type NativeResourceOptions } from "./resources.js";
+export type NativeActivationOptions = {
+    connection: NativeCombinerConnection;
+    directSpec?: string[] | "search";
+    serverFilter?: ServerFilter;
+    /** Register the interactive read_<resource> tools (index.ts's exposeResources
+     *  setting); default true. */
+    exposeResources?: boolean;
+    /** Auto-open widget URLs (index.ts's uiAutoOpen setting); default true. */
+    uiAutoOpen?: boolean;
+    /** Warn when the direct-exposure set grows large; settings kill-switch
+     *  warnLargeDirectExposure disables it (default true, i.e. warn). */
+    warnLargeDirectExposure?: boolean;
+    log: (level: "info" | "warn" | "error", message: string) => void;
+};
+/** Register the declared tool surface + interactive-resource read_* tools + the
+ *  list_changed re-registration handler. Called once at session_start; the
+ *  list_changed hook re-syncs both surfaces on the same names. */
+export declare function activateNativeMode(pi: ExtensionAPI, opts: NativeActivationOptions): {
+    run(): void;
+    dispose(): void;
+};
+export type { ExtensionContext };
+//# sourceMappingURL=index.d.ts.map

package/dist/native/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/native/index.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAA;AAInE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAA;AACnE,OAAO,EAAE,mBAAmB,EAAE,KAAK,wBAAwB,EAAE,MAAM,mBAAmB,CAAA;AACtF,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AACrD,OAAO,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,KAAK,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAEhH,MAAM,MAAM,uBAAuB,GAAG;IAClC,UAAU,EAAE,wBAAwB,CAAA;IACpC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAA;IAChC,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B;kCAC8B;IAC9B,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;yEACqE;IACrE,uBAAuB,CAAC,EAAE,OAAO,CAAA;IACjC,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACnE,CAAA;AAED;;kEAEkE;AAClE,wBAAgB,kBAAkB,CAC9B,EAAE,EAAE,YAAY,EAChB,IAAI,EAAE,uBAAuB,GAC9B;IAAE,GAAG,IAAI,IAAI,CAAC;IAAC,OAAO,IAAI,IAAI,CAAA;CAAE,CAwClC;AAaD,YAAY,EAAE,gBAAgB,EAAE,CAAA"}

package/dist/native/index.js

@@ -0,0 +1,61 @@
+// NATIVE MODE : activation entry for the
+// pi-mcp-based combiner connection + native tool surface. This file exists so the
+// wire-in stays a few lines in src/index.ts's mode gate while the shape is reviewed:
+//
+//   const native = settings.integration === "nativeTools"   // new tri-state member
+//   const conn = native ? new NativeCombinerConnection(…, clientLog)   // same contract
+//                        : new CombinerConnection(…, clientLog)
+//   if (native) void activateNativeTools(pi, { connection: conn, ... }) as needed
+//
+// Mode matrix (the native-migration plan item):: extension-owned connection (peer dep on @earendil-works/pi-mcp) + native
+// tool declaration via pi.registerTool(exposure/namespace/annotations) = native
+// exposure with elicitation STILL ANSWERED (capability advertised on the owned
+// connection) — no mcp() proxy, no script tool, no upstream PR required for v1.
+import { activateNativeTools } from "./tool-surface.js";
+import { activateNativeResources } from "./resources.js";
+export { NativeCombinerConnection } from "./combiner-connection.js";
+export { activateNativeTools } from "./tool-surface.js";
+export { tokenedUrl } from "./combiner-connection.js";
+export { activateNativeResources, filterInteractiveResources } from "./resources.js";
+/** Register the declared tool surface + interactive-resource read_* tools + the
+ *  list_changed re-registration handler. Called once at session_start; the
+ *  list_changed hook re-syncs both surfaces on the same names. */
+export function activateNativeMode(pi, opts) {
+    const resourceRegistered = new Set();
+    let active = true;
+    const resourceOpts = {
+        connection: opts.connection,
+        serverFilter: opts.serverFilter,
+        uiAutoOpen: opts.uiAutoOpen,
+        log: opts.log,
+    };
+    const run = () => {
+        if (!active)
+            return;
+        void activateNativeTools(pi, {
+            connection: opts.connection,
+            serverFilter: opts.serverFilter,
+            directSpec: opts.directSpec,
+            warnLargeDirectExposure: opts.warnLargeDirectExposure,
+            log: opts.log,
+        }).catch((e) => opts.log("warn", `native tool surface failed: ${e instanceof Error ? e.message : String(e)}`));
+        if (opts.exposeResources !== false) {
+            void activateNativeResources(pi, resourceOpts, resourceRegistered).catch((e) => opts.log("warn", `native resource surface failed: ${e instanceof Error ? e.message : String(e)}`));
+        }
+    };
+    // The FIRST run is the caller's to schedule: the grouping token only exists
+    // after session_start (the connection refuses to connect without it), so a
+    // factory-time run() would fail with "no grouping token set" — the startup
+    // warnings this signature used to emit. index.ts calls run() at
+    // session_start (post-setToken) and from its own onToolsChanged hook; we
+    // deliberately do NOT setHooks here — a second setHooks call from the
+    // wiring would replace ours wholesale (last-wins), so the re-sync lives in
+    // ONE hook set, index.ts's.
+    return {
+        run,
+        dispose() {
+            active = false;
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/native/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/native/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,kFAAkF;AAClF,qFAAqF;AACrF,EAAE;AACF,oFAAoF;AACpF,wFAAwF;AACxF,gEAAgE;AAChE,kFAAkF;AAClF,EAAE;AACF,0HAA0H;AAC1H,gFAAgF;AAChF,+EAA+E;AAC/E,gFAAgF;AAKhF,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAA;AAExD,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAA;AACnE,OAAO,EAAE,mBAAmB,EAAiC,MAAM,mBAAmB,CAAA;AACtF,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AACrD,OAAO,EAAE,uBAAuB,EAAE,0BAA0B,EAA8B,MAAM,gBAAgB,CAAA;AAiBhH;;kEAEkE;AAClE,MAAM,UAAU,kBAAkB,CAC9B,EAAgB,EAChB,IAA6B;IAE7B,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAU,CAAA;IAC5C,IAAI,MAAM,GAAG,IAAI,CAAA;IACjB,MAAM,YAAY,GAAG;QACjB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,GAAG,EAAE,IAAI,CAAC,GAAG;KAChB,CAAA;IACD,MAAM,GAAG,GAAG,GAAG,EAAE;QACb,IAAI,CAAC,MAAM;YAAE,OAAM;QACnB,KAAK,mBAAmB,CAAC,EAAE,EAAE;YACzB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,uBAAuB,EAAE,IAAI,CAAC,uBAAuB;YACrD,GAAG,EAAE,IAAI,CAAC,GAAG;SAChB,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CACX,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,+BAA+B,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAChG,CAAA;QACD,IAAI,IAAI,CAAC,eAAe,KAAK,KAAK,EAAE,CAAC;YACjC,KAAK,uBAAuB,CAAC,EAAE,EAAE,YAAY,EAAE,kBAAkB,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAC3E,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,mCAAmC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CACpG,CAAA;QACL,CAAC;IACL,CAAC,CAAA;IACD,4EAA4E;IAC5E,2EAA2E;IAC3E,2EAA2E;IAC3E,gEAAgE;IAChE,yEAAyE;IACzE,sEAAsE;IACtE,2EAA2E;IAC3E,4BAA4B;IAC5B,OAAO;QACH,GAAG;QACH,OAAO;YACH,MAAM,GAAG,KAAK,CAAA;QAClB,CAAC;KACJ,CAAA;AACL,CAAC"}

package/dist/native/resources.d.ts

@@ -0,0 +1,18 @@
+import type { ExtensionAPI } from "../pi.js";
+import type { NativeCombinerConnection, ResourceSummary } from "./combiner-connection.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 declare function filterInteractiveResources(resources: ResourceSummary[], filter: ServerFilter | undefined): ResourceSummary[];
+/** Register read_* tools for the interactive resources (idempotent, like legacy).
+ *  Returns the tool names registered this pass. */
+export declare function activateNativeResources(pi: ExtensionAPI, opts: NativeResourceOptions, registered: Set<string>): Promise<string[]>;
+//# sourceMappingURL=resources.d.ts.map

package/dist/native/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/native/resources.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,UAAU,CAAA;AAC5D,OAAO,KAAK,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAGzF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAE9D,MAAM,MAAM,qBAAqB,GAAG;IAChC,UAAU,EAAE,wBAAwB,CAAA;IACpC,2EAA2E;IAC3E,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,wEAAwE;IACxE,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACnE,CAAA;AAED;gFACgF;AAChF,wBAAgB,0BAA0B,CACtC,SAAS,EAAE,eAAe,EAAE,EAC5B,MAAM,EAAE,YAAY,GAAG,SAAS,GACjC,eAAe,EAAE,CAUnB;AAoCD;mDACmD;AACnD,wBAAsB,uBAAuB,CACzC,EAAE,EAAE,YAAY,EAChB,IAAI,EAAE,qBAAqB,EAC3B,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,GACxB,OAAO,CAAC,MAAM,EAAE,CAAC,CAkBnB"}