mindweave 0.0.1 → 2.1.2

package/dist/mcp/connection.js

@@ -0,0 +1,504 @@
+/**
+ * connection.ts — one MCP server, and what state it is in.
+ *
+ * The previous implementation had no notion of state: a server was in a map or it was
+ * not. That makes three ordinary situations indistinguishable — still starting, failed
+ * to start, and waiting on the user to authenticate — so nothing could report anything
+ * useful and a dead server stayed dead for the session.
+ *
+ * So a connection is a small state machine:
+ *
+ *   pending ──► connected ──► (dies) ──► pending ──► …
+ *      │                                    │
+ *      ├──► failed          (cap reached) ◄─┘
+ *      └──► needs-auth
+ *
+ * `needs-auth` is deliberately separate from `failed`. A 401 is not a broken server, it
+ * is a server waiting on the user, and collapsing the two would make the eventual auth
+ * flow look like an outage.
+ *
+ * Reconnection is capped at 3 consecutive failures, the same number used by the
+ * repeat-failure breaker in the engine. Past the cap we STOP and surface the state
+ * rather than retrying forever: a server that cannot start will not start on the
+ * fourth try, and quietly burning attempts is how a session ends up slow for a reason
+ * the user cannot see. `/mcp` can always retry by hand.
+ */
+import { appVersion } from "../cli/version.js";
+import { parseToolList } from "./catalog.js";
+import { paramHeaders } from "./paramHeaders.js";
+import { probe, UnsupportedProtocolVersionError } from "./discover.js";
+import { buildMeta, DEFAULT_CLIENT_CAPABILITIES, cacheDirectiveOf, readInputRequired } from "./protocol.js";
+import { hasPrompts, parsePromptList } from "./prompts.js";
+import { hasResources, parseResourceList, parseResourceRead, parseTemplateList, } from "./resources.js";
+import { HttpTransport } from "./transport/http.js";
+import { StdioTransport } from "./transport/stdio.js";
+import { RpcError } from "./transport/types.js";
+import { isPromptsChanged, isResourcesChanged, isToolsChanged, subscriptionsFor } from "./subscriptions.js";
+/** Consecutive failed connect attempts before we stop trying on our own. */
+export const MAX_CONNECT_ATTEMPTS = 3;
+/**
+ * Backoff between automatic reconnects, in ms.
+ *
+ * Deliberately short and deliberately finite. A server that dies mid-session is usually
+ * a crash or a restart, and getting it back within a few seconds is the difference
+ * between a blip and losing its tools for the rest of the session. But retrying forever
+ * is the pattern the repeat-failure breaker exists to prevent: a server that will not
+ * come back does not come back on the tenth attempt either, and quietly burning them is
+ * how a session gets slow for a reason the user cannot see. After the last one we stop
+ * and say so; `/mcp` can always retry by hand.
+ */
+export const RECONNECT_BACKOFF_MS = [1_000, 4_000, 10_000];
+/**
+ * How many extra round trips one MRTR call may take before we give up.
+ *
+ * A server is explicitly allowed to keep answering `input_required` "if they want to
+ * repeatedly prompt the user for information until they have what they need", so nothing
+ * on the server side ever has to stop. Terminating is therefore the client's job. Four
+ * is well past any ordinary exchange (which is one, occasionally two) and small enough
+ * that a server looping on us costs a moment rather than a session.
+ */
+export const MAX_INPUT_ROUNDS = 4;
+/** Is this error the server telling us it wants credentials? */
+export function isAuthError(error) {
+    const e = error;
+    if (typeof e?.code === "number" && e.code === -32001)
+        return true;
+    return typeof e?.message === "string" && /\b401\b|\b403\b|unauthor|forbidden/i.test(e.message);
+}
+export class McpConnection {
+    config;
+    transport = null;
+    negotiated = null;
+    toolDefs = [];
+    /** Tools dropped from the last catalog load, with the reason. Drained by the manager
+     *  into user-facing notices — a tool that silently does not exist is the failure mode
+     *  quarantine already taught us to avoid. */
+    toolWarnings = [];
+    promptDefs = [];
+    resourceDefs = [];
+    templateDefs = [];
+    cache = {};
+    toolsFetchedAt = 0;
+    /** When the resource listing was last fetched (0 = never). Resources are loaded lazily,
+     *  so this is the only thing standing between a curious model and a refetch per call. */
+    resourcesFetchedAt = 0;
+    resourceCache = {};
+    state;
+    lastError = "";
+    attempts = 0;
+    connecting = null;
+    retryTimer = null;
+    closed = false;
+    onChange = null;
+    constructor(config) {
+        this.config = config;
+        this.state = config.disabled ? "disabled" : "pending";
+    }
+    /** Told whenever this server's state or catalog moves, so the UI can repaint. */
+    setOnChange(handler) {
+        this.onChange = handler;
+    }
+    changed() {
+        this.onChange?.();
+    }
+    status() {
+        return {
+            name: this.config.name,
+            state: this.state,
+            toolCount: this.toolDefs.length,
+            promptCount: this.promptDefs.length,
+            offersResources: this.offersResources(),
+            attempts: this.attempts,
+            ...(this.lastError ? { error: this.lastError } : {}),
+            ...(this.negotiated ? { version: this.negotiated.version, legacy: this.negotiated.legacy } : {}),
+            ...(this.negotiated?.serverInfo ? { serverInfo: this.negotiated.serverInfo } : {}),
+        };
+    }
+    tools() {
+        return this.toolDefs;
+    }
+    /** This server's prompts, fetched at connect (they have to exist before the command
+     *  list is rendered, and there is no way to discover them lazily from a keystroke). */
+    prompts() {
+        return this.promptDefs;
+    }
+    isConnected() {
+        return this.state === "connected";
+    }
+    /**
+     * Connect, handshake or discover, and load the tool catalog.
+     *
+     * Concurrent callers share one attempt: the pool starts every server in parallel and
+     * a `/mcp` retry can land on top of that, and two transports for one server would
+     * leak a child process.
+     */
+    async connect() {
+        if (this.state === "disabled")
+            return;
+        if (this.state === "connected")
+            return;
+        if (this.connecting)
+            return this.connecting;
+        if (this.attempts >= MAX_CONNECT_ATTEMPTS && this.state !== "pending")
+            return;
+        this.connecting = this.attempt().finally(() => {
+            this.connecting = null;
+        });
+        return this.connecting;
+    }
+    /** Force a retry even past the cap — what `/mcp` reconnect does. */
+    async reconnect() {
+        this.clearRetry();
+        await this.closeTransport();
+        this.closed = false;
+        this.attempts = 0;
+        this.state = this.config.disabled ? "disabled" : "pending";
+        this.lastError = "";
+        await this.connect();
+    }
+    async attempt() {
+        this.attempts++;
+        this.state = "pending";
+        try {
+            const transport = this.open();
+            this.transport = transport;
+            // If the server dies later, drop back to pending so a future call can revive it
+            // instead of dispatching into a corpse.
+            void transport.closed.then(() => {
+                if (this.transport === transport)
+                    this.onDied();
+            });
+            const identity = { name: "mindweave", version: appVersion() };
+            this.negotiated = await probe({
+                request: (method, params) => this.raw(transport, method, params),
+                notify: (method, params) => transport.notify(method, params),
+            }, identity, DEFAULT_CLIENT_CAPABILITIES);
+            await this.loadTools();
+            // Prompts are eager, resources are not, and the difference is deliberate. A prompt
+            // has to exist before the user presses `/`, so there is no lazy moment to fetch it
+            // in. A resource listing is only ever wanted when the model goes looking, and
+            // fetching every server's on connect would slow every session down for a feature
+            // most projects never touch.
+            await this.loadPrompts();
+            transport.onNotification((note) => this.onNotify(note));
+            await this.subscribe(transport);
+            this.state = "connected";
+            this.lastError = "";
+            this.attempts = 0; // a success clears the budget for the next outage
+            this.changed();
+        }
+        catch (error) {
+            await this.closeTransport();
+            this.lastError = describeError(error);
+            // A server asking for credentials is waiting on the user, not broken — and
+            // retrying cannot help, so it does not consume the attempt budget's meaning.
+            this.state = isAuthError(error) ? "needs-auth" : "failed";
+            this.changed();
+        }
+    }
+    /**
+     * Opt into the change notifications we can actually act on.
+     *
+     * Best-effort by design: a server that does not support `subscriptions/listen` (every
+     * pre-2026 one) or refuses the request is still perfectly usable. Letting a failed
+     * subscription fail the whole connection would drop most servers in existence for the
+     * sake of an optimization.
+     *
+     * Be precise about what is lost, because an earlier version of this comment was not:
+     * there is NO periodic refresh. `ttlMs` is only ever read as permission to SKIP a
+     * refetch, never as a timer, so nothing polls. Without a subscription the catalog moves
+     * only when the server pushes `notifications/tools/list_changed` on its own (which
+     * stdio servers do regardless of dialect, and many pre-2026 ones send) or when the user
+     * reconnects it from `/mcp`. A poller is deliberately not built: it would re-fetch every
+     * server on a timer to catch a case the push path already covers, and each refresh that
+     * did find a change would cost a prompt-cache prefix.
+     */
+    async subscribe(transport) {
+        if (!this.negotiated || this.negotiated.dialect !== "stateless")
+            return;
+        const types = subscriptionsFor(this.negotiated.capabilities);
+        if (types.length === 0)
+            return;
+        try {
+            if (transport.openStream)
+                await transport.openStream("subscriptions/listen", { types });
+            else
+                await this.call("subscriptions/listen", { types });
+        }
+        catch {
+            // No subscription. The catalog is then whatever the server pushes unprompted, or
+            // what a `/mcp` reconnect fetches — see above.
+        }
+    }
+    /** A server telling us one of its lists moved. */
+    onNotify(note) {
+        // Force past the TTL in every case: the server just told us the cached answer is wrong.
+        const refresh = isToolsChanged(note.method)
+            ? this.loadTools(true)
+            : isPromptsChanged(note.method)
+                ? this.loadPrompts()
+                : isResourcesChanged(note.method)
+                    ? this.loadResources(true)
+                    : null;
+        if (!refresh)
+            return;
+        void refresh
+            .then(() => this.changed())
+            .catch(() => {
+            // A refresh that fails leaves the previous list in place, which is strictly
+            // better than dropping it because one notification could not be served.
+        });
+    }
+    open() {
+        if (this.config.type === "http") {
+            return new HttpTransport({ url: this.config.url, ...(this.config.headers ? { headers: this.config.headers } : {}) });
+        }
+        return new StdioTransport({
+            command: this.config.command,
+            args: this.config.args,
+            ...(this.config.env ? { env: this.config.env } : {}),
+        });
+    }
+    /** A request that has NOT yet negotiated a dialect (the probe itself). */
+    raw(transport, method, params) {
+        return transport.request(method, params);
+    }
+    /**
+     * A request on the negotiated dialect: `_meta` is attached on stateless servers and
+     * omitted on handshake ones, where it would be an unknown field.
+     */
+    /**
+     * A call that may take several round trips (MRTR, 2026-07-28).
+     *
+     * A server that cannot finish in one go does not hold a connection open and does not
+     * ask us a question over a side channel — both of those are gone. It returns
+     * `resultType: "input_required"` with an opaque `requestState`, and the client calls
+     * again, echoing that state back. Each attempt is a genuinely independent request with
+     * its own id; nothing on this side is resumed.
+     *
+     * Two rules of the echo are easy to get subtly wrong, so they are explicit below: the
+     * state is whatever THIS round returned, never a value carried over from an earlier
+     * one, and a round that returns no state must be retried with no state rather than
+     * with the last one we happened to hold.
+     *
+     * We answer no `inputRequests`, and that is a consequence of declaring no elicitation
+     * capability rather than an omission here — a conforming server is forbidden from
+     * sending them (see `ClientCapabilities`). If one arrives anyway we fail the call and
+     * say what was asked for. Returning the half-finished result instead, which is what
+     * happened before this existed, told the model the tool had answered.
+     */
+    async callMultiRound(method, params, mirrored) {
+        let requestState;
+        for (let round = 0; round <= MAX_INPUT_ROUNDS; round++) {
+            const body = requestState === undefined ? params : { ...params, requestState };
+            const result = await this.call(method, body, mirrored);
+            const pending = readInputRequired(result);
+            if (!pending)
+                return result;
+            const asked = Object.values(pending.inputRequests).map((r) => r.method);
+            if (asked.length > 0) {
+                throw new RpcError(-32603, `mcp server '${this.config.name}' asked for input this client cannot provide (${[...new Set(asked)].join(", ")}). ` +
+                    `Mindweave declares no elicitation capability, so a conforming server should not have requested it.`);
+            }
+            requestState = pending.requestState;
+        }
+        // A server MAY ask again on every attempt, so terminating is our job, not its own.
+        throw new RpcError(-32603, `mcp server '${this.config.name}' still needed more input after ${MAX_INPUT_ROUNDS + 1} attempts at ${method}`);
+    }
+    async call(method, params, mirrored) {
+        if (!this.transport || !this.negotiated)
+            throw new RpcError(-32603, `mcp server '${this.config.name}' is not connected`);
+        const meta = buildMeta(this.negotiated.dialect, this.negotiated.version, { name: "mindweave", version: appVersion() });
+        const body = meta ? { ...(params ?? {}), _meta: meta } : params;
+        return this.transport.request(method, body, mirrored);
+    }
+    /** Fetch (or refresh) the tool catalog, honouring the server's own `ttlMs`. */
+    async loadTools(force = false) {
+        if (!force && this.toolsFetchedAt && this.cache.ttlMs !== undefined) {
+            if (Date.now() - this.toolsFetchedAt < this.cache.ttlMs)
+                return; // still fresh
+        }
+        const result = await this.call("tools/list");
+        this.toolDefs = parseToolList(this.config.name, result, {
+            mirrorsHeaders: this.config.type === "http",
+            onReject: (tool, reason) => {
+                this.toolWarnings.push(`'${this.config.name}' tool '${tool}' was dropped: ${reason}`);
+            },
+        });
+        this.cache = cacheDirectiveOf(result);
+        this.toolsFetchedAt = Date.now();
+    }
+    /**
+     * Fetch this server's prompts, if it has any.
+     *
+     * Best-effort in both directions: a server that does not advertise prompts is not
+     * asked, and one that advertises them but fails the call simply has none. A broken
+     * `prompts/list` must not cost the user the server's tools, which are the main event.
+     */
+    async loadPrompts() {
+        if (!this.negotiated || !hasPrompts(this.negotiated.capabilities))
+            return;
+        try {
+            this.promptDefs = parsePromptList(this.config.name, await this.call("prompts/list"));
+        }
+        catch {
+            this.promptDefs = [];
+        }
+    }
+    /** Render one of this server's prompts. Rejects, because the caller is a command the
+     *  user just typed and silence would be worse than an error. */
+    async getPrompt(name, args) {
+        return this.callMultiRound("prompts/get", { name, ...(Object.keys(args).length > 0 ? { arguments: args } : {}) });
+    }
+    /**
+     * Fetch (or refresh) this server's resources and templates.
+     *
+     * Honours the server's own `ttlMs` the same way the tool catalog does, which matters
+     * more here: the model can call the listing tool repeatedly within one turn, and
+     * without the cache each call would be two round trips to every server.
+     */
+    async loadResources(force = false) {
+        if (!this.negotiated || !hasResources(this.negotiated.capabilities))
+            return;
+        if (!force && this.resourcesFetchedAt && this.resourceCache.ttlMs !== undefined) {
+            if (Date.now() - this.resourcesFetchedAt < this.resourceCache.ttlMs)
+                return;
+        }
+        try {
+            const listed = await this.call("resources/list");
+            this.resourceDefs = parseResourceList(this.config.name, listed);
+            this.resourceCache = cacheDirectiveOf(listed);
+            this.resourcesFetchedAt = Date.now();
+        }
+        catch {
+            this.resourceDefs = [];
+        }
+        try {
+            // Separate try: templates are optional even for a server that has resources, and a
+            // server that has never heard of `resources/templates/list` must not lose its list.
+            this.templateDefs = parseTemplateList(this.config.name, await this.call("resources/templates/list"));
+        }
+        catch {
+            this.templateDefs = [];
+        }
+    }
+    resources() {
+        return this.resourceDefs;
+    }
+    resourceTemplates() {
+        return this.templateDefs;
+    }
+    /** True when this server declared a resources capability at all. */
+    offersResources() {
+        return Boolean(this.negotiated && hasResources(this.negotiated.capabilities));
+    }
+    /** Read one resource by URI. */
+    async readResource(uri) {
+        return parseResourceRead(await this.callMultiRound("resources/read", { uri }));
+    }
+    /** Invoke a tool on this server.
+     *
+     *  Any parameter the server annotated with `x-mcp-header` is repeated in the headers.
+     *  Not an optimisation: a server MUST reject a call whose annotated value is in the
+     *  body but absent from the headers, so a tool with an annotation is simply uncallable
+     *  without this. The annotations were validated when the catalog was parsed, which is
+     *  why nothing here can fail. */
+    async callTool(name, args) {
+        const annotations = this.toolDefs.find((d) => d.name === name)?.paramHeaders;
+        const mirrored = annotations?.length ? paramHeaders(annotations, args) : undefined;
+        return this.callMultiRound("tools/call", { name, arguments: args }, mirrored);
+    }
+    /** Drain warnings about tools dropped from this server's catalog. One-shot. */
+    takeToolWarnings() {
+        const out = this.toolWarnings;
+        this.toolWarnings = [];
+        return out;
+    }
+    /**
+     * The server went away on its own. Drop the catalog and schedule a revival.
+     *
+     * Automatic, because the alternative is that a server which crashed once is gone for
+     * the rest of the session and the user has no way to know why their tools vanished.
+     * Bounded, because a server that cannot come back never does.
+     */
+    onDied() {
+        this.transport = null;
+        this.negotiated = null;
+        this.toolDefs = [];
+        this.promptDefs = [];
+        this.resourceDefs = [];
+        this.templateDefs = [];
+        this.toolsFetchedAt = 0;
+        this.resourcesFetchedAt = 0;
+        if (this.state === "connected") {
+            this.state = "pending";
+            this.lastError = "server exited";
+            this.attempts = 0; // this is a NEW outage, not a continuation of the last one
+            this.scheduleRetry();
+        }
+        this.changed();
+    }
+    scheduleRetry() {
+        if (this.closed || this.config.disabled)
+            return;
+        const delay = RECONNECT_BACKOFF_MS[this.attempts];
+        if (delay === undefined) {
+            // Out of automatic attempts. Say so plainly rather than sitting in `pending`
+            // forever, which reads as "still trying".
+            this.state = "failed";
+            this.lastError = `${this.lastError || "server exited"} (gave up after ${RECONNECT_BACKOFF_MS.length} reconnect attempts; /mcp to retry)`;
+            this.changed();
+            return;
+        }
+        this.clearRetry();
+        this.retryTimer = setTimeout(() => {
+            this.retryTimer = null;
+            void this.attempt().then(() => {
+                if (this.state !== "connected")
+                    this.scheduleRetry();
+            });
+        }, delay);
+        // Never hold the process open just to retry a background server.
+        this.retryTimer.unref?.();
+    }
+    clearRetry() {
+        if (this.retryTimer)
+            clearTimeout(this.retryTimer);
+        this.retryTimer = null;
+    }
+    /** Tear down the transport but keep this connection revivable.
+     *  `sync` is forwarded so an exit-handler teardown kills synchronously. */
+    async closeTransport(sync = false) {
+        const transport = this.transport;
+        this.transport = null;
+        this.negotiated = null;
+        this.toolDefs = [];
+        this.promptDefs = [];
+        this.resourceDefs = [];
+        this.templateDefs = [];
+        this.toolsFetchedAt = 0;
+        this.resourcesFetchedAt = 0;
+        if (transport)
+            await transport.close(sync).catch(() => { });
+    }
+    /**
+     * Shut down for good: no more retries, no more tools.
+     *
+     * `sync` must be set when closing from a process-exit handler. The kill that
+     * reaps a shelled server spawns `taskkill`, and an async spawn never reaches
+     * the OS during exit, so the server would outlive us.
+     */
+    async close(sync = false) {
+        this.closed = true;
+        this.clearRetry();
+        await this.closeTransport(sync);
+    }
+}
+function describeError(error) {
+    if (error instanceof UnsupportedProtocolVersionError)
+        return error.message;
+    if (error instanceof Error)
+        return error.message;
+    return String(error);
+}
+//# sourceMappingURL=connection.js.map

package/dist/mcp/connection.js.map

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

package/dist/mcp/deferred.js

@@ -0,0 +1,104 @@
+import { mcpToolName } from "./catalog.js";
+/**
+ * Catalogs at or below this many tools are advertised in full.
+ *
+ * Below the threshold, deferral is strictly WORSE: the model pays a search round trip
+ * to reach tools it could simply have been shown, and a small catalog costs little to
+ * send. The point is to fix the many-tools case, not to hide three tools behind a menu.
+ */
+export const DEFER_THRESHOLD = 25;
+/** How many results one search returns. Enough to choose from, few enough to read. */
+export const MAX_SEARCH_RESULTS = 8;
+/** Should this catalog be held back behind search? */
+export function shouldDefer(toolCount, threshold = DEFER_THRESHOLD) {
+    return toolCount > threshold;
+}
+/** Split a tool name into lowercase parts: `mcp__github__create_issue` → github, create, issue. */
+export function nameParts(def) {
+    return `${def.server} ${def.name}`
+        .toLowerCase()
+        .split(/[^a-z0-9]+/)
+        .filter(Boolean);
+}
+/**
+ * Score one tool against the query terms (pure).
+ *
+ * Weights are deliberately blunt. This is keyword matching, not retrieval: the model
+ * already knows roughly what it wants and usually queries with a server name ("github"),
+ * an action ("create issue"), or the tool name itself. Precision matters less than never
+ * returning nothing useful for a reasonable query.
+ */
+export function scoreTool(def, terms) {
+    const parts = nameParts(def);
+    const description = def.description.toLowerCase();
+    let score = 0;
+    for (const term of terms) {
+        if (parts.includes(term))
+            score += 10; // whole word in the name: the strongest signal
+        else if (parts.some((p) => p.includes(term)))
+            score += 5;
+        // A description match is weak on its own — descriptions are long and mention a lot.
+        if (description.includes(term))
+            score += 2;
+    }
+    return score;
+}
+/**
+ * Find tools matching a query (pure).
+ *
+ * The two special cases at the top are not politeness, they are the failure modes this
+ * kind of search actually hits. A model that already knows the exact tool name will
+ * pass it verbatim rather than describing it, and a model that knows the server will
+ * pass `mcp__server`. Both look like zero-scoring queries to a keyword ranker and would
+ * return nothing, which reads to the model as "that tool does not exist" — so it stops
+ * asking and guesses instead. Handling them is what keeps search from being a dead end.
+ */
+export function searchCatalog(query, defs, max = MAX_SEARCH_RESULTS) {
+    const q = query.toLowerCase().trim();
+    if (!q)
+        return [];
+    // Exact advertised name, or exact bare name.
+    const exact = defs.find((d) => mcpToolName(d.server, d.name).toLowerCase() === q || d.name.toLowerCase() === q);
+    if (exact)
+        return [exact];
+    // A server prefix: give back that server's tools.
+    if (q.startsWith("mcp__")) {
+        const prefixed = defs.filter((d) => mcpToolName(d.server, d.name).toLowerCase().startsWith(q));
+        if (prefixed.length > 0)
+            return prefixed.slice(0, max);
+    }
+    // A bare server name: same idea, without the prefix.
+    const byServer = defs.filter((d) => d.server.toLowerCase() === q);
+    if (byServer.length > 0)
+        return byServer.slice(0, max);
+    const terms = q.split(/[^a-z0-9]+/).filter(Boolean);
+    if (terms.length === 0)
+        return [];
+    const scored = defs
+        .map((def) => ({ def, score: scoreTool(def, terms) }))
+        .filter((s) => s.score > 0)
+        // Ties break on name so results are stable between identical searches.
+        .sort((a, b) => b.score - a.score || mcpToolName(a.def.server, a.def.name).localeCompare(mcpToolName(b.def.server, b.def.name)));
+    return scored.slice(0, max).map((s) => s.def);
+}
+/**
+ * Render search results for the model: each match's full callable definition.
+ *
+ * The FULL schema, not a summary line, and that is what makes deferral pay. A summary
+ * only tells the model a tool exists; it then has to be added to the advertised `tools`
+ * array before it can be called, and that rewrites the provider's cached prefix — tools,
+ * system and messages — at full price. Delivered here instead, the schema rides in an
+ * appended message: every earlier byte is untouched, the cache survives, and the schema
+ * is itself cached from the next call onward. Dispatch resolves against the catalog
+ * rather than against what was advertised, so a name and a schema is all it takes.
+ */
+export function renderResults(defs) {
+    return defs
+        .map((d) => `<function>${JSON.stringify({
+        name: mcpToolName(d.server, d.name),
+        description: d.description,
+        parameters: d.inputSchema,
+    })}</function>`)
+        .join("\n");
+}
+//# sourceMappingURL=deferred.js.map

package/dist/mcp/deferred.js.map

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