@haikit/mcp 0.0.0-stage → 0.32.0

package/dist/index.js

@@ -0,0 +1,412 @@
+/**
+ * @haikit/mcp — call MCP servers' tools from inside your own tools.
+ *
+ * The model never sees an MCP tool. An app declares the server tools it calls,
+ * typed by schemas it owns, and calls them from a HaiKIT tool's `run` or an
+ * action handler, the way it would call a database: that code decides what the
+ * model hears of a result and what the browser shows. So nothing a third-party
+ * server says — its tools' names and descriptions, its instructions, its
+ * results — reaches the model unless app code puts it there.
+ *
+ * There is no way to make a HaiKIT `Tool` from an MCP tool here, on purpose:
+ * an `McpTool` has no `run`, so `createHai({ tools })` won't take one.
+ *
+ * Imports only @haikit/core, like the model adapters.
+ */
+import { createRequire } from "node:module";
+import { Client, ProtocolError, ProtocolErrorCode, SdkError, SdkErrorCode, } from "@modelcontextprotocol/client";
+import { McpError, McpToolError, isMcpError } from "./errors.js";
+export { McpError, McpToolError, isMcpError, isMcpToolError } from "./errors.js";
+export { textOf } from "./text.js";
+export { http, stdio } from "./transports.js";
+const { version: VERSION } = createRequire(import.meta.url)("../package.json");
+const TIMEOUT_MS = 30_000;
+/** Under the 120 s turn lease the stores default to, which isn't renewed while a tool runs. */
+const MAX_TOTAL_MS = 90_000;
+/** Past the longest timer Node keeps, it fires after about a millisecond. */
+const MAX_TIMER_MS = 2_147_483_647;
+/**
+ * The SDK's own checks of a tool's result against the output schema the
+ * server declared, as of @modelcontextprotocol/client 2.4: `callTool` throws
+ * these, with these codes and words, once the server has answered. A
+ * server's own error reads as one only if it has the same code and words.
+ */
+const OUTPUT_CHECKS = [
+    [ProtocolErrorCode.InvalidRequest, /^Tool .+ has an output schema but did not return structured content$/],
+    [ProtocolErrorCode.InvalidParams, /^Structured content does not match the tool's output schema: /],
+    [ProtocolErrorCode.InvalidParams, /^Failed to validate structured content: /],
+];
+/** The connection to an MCP server. Nothing connects until `connect()` or the first call. */
+export function mcpServer(options) {
+    return new Connection(options);
+}
+const MESSAGES = {
+    args: (who) => `${who} was not called: its args do not match the schema`,
+    result: (who) => `${who} returned a result that does not match the schema`,
+    timeout: (who) => `${who} did not answer in time`,
+    connection: (who) => `${who} could not be reached`,
+    protocol: (who) => `${who} was refused by the server`,
+    closed: (who) => `${who}: the connection was closed`,
+};
+class Connection {
+    name;
+    options;
+    timeoutMs;
+    maxTotalMs;
+    /** The connected client, or null between connections. */
+    client = null;
+    dialing = null;
+    /** While a connection is being made: its client, once there is one, so `close()` can stop it. */
+    connecting = null;
+    /** While `transport()` is pending: gives up on it, for `close()`. */
+    abandon = null;
+    closed = false;
+    /** The first `close()`, which the others wait for. */
+    closing = null;
+    /** Clients whose connection has gone. */
+    dropped = new WeakSet();
+    /** The server's tools at the last listing, by name. Null until a first connect passes the check. */
+    listed = null;
+    /** The tools `tool()` declared: the only ones that can be called. */
+    declared = new Set();
+    constructor(options) {
+        if (typeof options.name !== "string" || options.name === "") {
+            throw new TypeError("name must be a non-empty string");
+        }
+        if (typeof options.transport !== "function") {
+            throw new TypeError("transport must be a function that makes a Transport, such as http(url) or stdio({ command })");
+        }
+        this.name = options.name;
+        this.options = options;
+        this.timeoutMs = checkMs("timeoutMs", options.timeoutMs ?? TIMEOUT_MS);
+        this.maxTotalMs = checkMs("maxTotalMs", options.maxTotalMs ?? MAX_TOTAL_MS);
+    }
+    tool(name, def) {
+        if (typeof name !== "string" || name === "")
+            throw new TypeError("a tool's name must be a non-empty string");
+        if (typeof def?.args?.parse !== "function") {
+            throw new TypeError(`tool "${name}" needs an args schema: anything with a parse method`);
+        }
+        if (def.result !== undefined && typeof def.result.parse !== "function") {
+            throw new TypeError(`tool "${name}" has a result schema with no parse method`);
+        }
+        if (def.timeoutMs !== undefined)
+            checkMs("timeoutMs", def.timeoutMs);
+        if (def.maxTotalMs !== undefined)
+            checkMs("maxTotalMs", def.maxTotalMs);
+        if (this.listed) {
+            const problem = problemWith(name, this.listed);
+            if (problem)
+                throw new Error(`${this.name}: ${problem}`);
+        }
+        this.declared.add(name);
+        return Object.freeze({
+            server: this.name,
+            name,
+            call: (args, ctx) => this.call(name, def, args, ctx),
+        });
+    }
+    async connect() {
+        await this.open();
+    }
+    close() {
+        // every close() resolves once the first has closed everything
+        this.closing ??= this.shut();
+        return this.closing;
+    }
+    async shut() {
+        this.closed = true;
+        const client = this.client;
+        this.client = null;
+        // a connection still being made is stopped where it is, and sees `closed`
+        this.abandon?.();
+        await this.connecting?.close().catch(() => { });
+        await this.dialing?.catch(() => { });
+        await client?.close();
+    }
+    open() {
+        if (this.closed)
+            return Promise.reject(this.error("closed", undefined));
+        if (this.client)
+            return Promise.resolve(this.client);
+        // one connection at a time: calls that arrive meanwhile share it
+        this.dialing ??= this.dial().finally(() => {
+            this.dialing = null;
+            this.connecting = null;
+        });
+        return this.dialing;
+    }
+    /**
+     * What `transport()` makes, within `timeoutMs` and unless `close()` comes
+     * first. A transport made after that is closed when it comes.
+     */
+    async made() {
+        const making = Promise.resolve().then(() => this.options.transport());
+        let timer;
+        const cut = new Promise((_, reject) => {
+            timer = setTimeout(() => reject(new Error(`no transport within ${this.timeoutMs} ms`)), this.timeoutMs);
+            this.abandon = () => reject(new Error("closed while the transport was being made"));
+        });
+        try {
+            return await Promise.race([making, cut]);
+        }
+        catch (err) {
+            making.then((transport) => transport.close()).catch(() => { });
+            throw err;
+        }
+        finally {
+            clearTimeout(timer);
+            this.abandon = null;
+        }
+    }
+    async dial() {
+        let client;
+        try {
+            const transport = await this.made();
+            // close() may have come as it was made, with nothing yet to stop
+            if (this.closed) {
+                await transport.close().catch(() => { });
+                throw new Error("closed as the transport was made");
+            }
+            const self = new Client({ name: "haikit", version: VERSION }, {
+                // No capabilities are advertised, so a server has no reason to ask
+                // this client for input; one that does gets the call refused,
+                // rather than a reply nobody wrote.
+                inputRequired: { autoFulfill: false },
+                ...(this.options.versionNegotiation === undefined
+                    ? {}
+                    : { versionNegotiation: { mode: this.options.versionNegotiation } }),
+                listChanged: {
+                    tools: {
+                        onChanged: (error, tools) => {
+                            if (!error && tools && this.client === self)
+                                this.compare(tools);
+                        },
+                    },
+                },
+            });
+            client = self;
+            this.connecting = self;
+            self.onclose = () => {
+                this.dropped.add(self);
+                if (this.client === self)
+                    this.client = null;
+            };
+            await self.connect(transport, { timeout: this.timeoutMs });
+        }
+        catch (err) {
+            await client?.close().catch(() => { });
+            throw this.error(this.closed ? "closed" : "connection", undefined, { cause: err });
+        }
+        let tools;
+        try {
+            ({ tools } = await client.listTools(undefined, { timeout: this.timeoutMs }));
+        }
+        catch (err) {
+            await client.close().catch(() => { });
+            throw this.failure(err, undefined, client);
+        }
+        if (this.listed === null) {
+            const listing = new Map(tools.map((t) => [t.name, t]));
+            const problems = [...this.declared].flatMap((name) => problemWith(name, listing) ?? []);
+            if (problems.length) {
+                await client.close().catch(() => { });
+                throw new Error(`${this.name}: ${problems.join("; ")}`);
+            }
+            this.listed = listing;
+        }
+        else {
+            this.compare(tools);
+        }
+        if (this.closed) {
+            await client.close().catch(() => { });
+            throw this.error("closed", undefined);
+        }
+        if (this.dropped.has(client))
+            throw this.error("connection", undefined);
+        this.client = client;
+        return client;
+    }
+    /** Report what changed about the declared tools since the last listing, and keep this one. */
+    compare(tools) {
+        const before = this.listed ?? new Map();
+        const next = new Map(tools.map((t) => [t.name, t]));
+        this.listed = next;
+        const removed = [];
+        const changed = [];
+        for (const name of this.declared) {
+            const was = before.get(name);
+            const now = next.get(name);
+            if (!was)
+                continue;
+            if (!now)
+                removed.push(name);
+            else if (shape(was) !== shape(now))
+                changed.push(name);
+        }
+        if (!removed.length && !changed.length)
+            return;
+        try {
+            (this.options.onChange ?? warn)({ server: this.name, removed, changed });
+        }
+        catch (err) {
+            console.error(err);
+        }
+    }
+    async call(tool, def, args, ctx) {
+        let input;
+        try {
+            input = def.args.parse(args);
+        }
+        catch (err) {
+            throw this.error("args", tool, { cause: err });
+        }
+        if (typeof input !== "object" || input === null || Array.isArray(input)) {
+            throw new McpError("args", `${this.name}/${tool} was not called: its args must be an object`, {
+                server: this.name,
+                tool,
+            });
+        }
+        // maxTotalMs bounds the whole call, connecting included, and is ours to
+        // keep: the SDK checks its own maxTotalTimeout only when progress comes
+        const deadline = new AbortController();
+        const timer = setTimeout(() => deadline.abort(), def.maxTotalMs ?? this.maxTotalMs);
+        let result;
+        try {
+            let client;
+            try {
+                client = await this.until(deadline.signal, tool, this.open());
+            }
+            catch (err) {
+                // named again for this call, with what the server said; the
+                // declared-tool check throws as it is
+                if (!isMcpError(err) || err.tool === tool)
+                    throw err;
+                throw this.error(err.reason, tool, { cause: err.cause ?? err, text: err.text, code: err.code });
+            }
+            try {
+                result = await client.callTool({ name: tool, arguments: input }, {
+                    timeout: def.timeoutMs ?? this.timeoutMs,
+                    // cancels the request, and rejects it as a timeout
+                    signal: deadline.signal,
+                    // asked for whether or not anyone hears it, so progress always
+                    // keeps a long call alive
+                    resetTimeoutOnProgress: true,
+                    onprogress: (p) => {
+                        ctx?.progress?.({
+                            done: p.progress,
+                            ...(p.total === undefined ? {} : { total: p.total }),
+                            ...(p.message === undefined ? {} : { message: p.message }),
+                        });
+                    },
+                });
+            }
+            catch (err) {
+                throw this.failure(err, tool, client);
+            }
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        const content = result.content ?? [];
+        if (result.isError)
+            throw new McpToolError(this.name, tool, content);
+        if (!def.result) {
+            return result.structuredContent === undefined ? { content } : { content, structuredContent: result.structuredContent };
+        }
+        let value;
+        if (result.structuredContent !== undefined) {
+            value = result.structuredContent;
+        }
+        else {
+            const only = content.length === 1 ? content[0] : undefined;
+            if (only?.type !== "text") {
+                throw this.error("result", tool, {
+                    cause: new Error("the result has no structured content, and isn't one text block"),
+                });
+            }
+            try {
+                value = JSON.parse(only.text);
+            }
+            catch (err) {
+                throw this.error("result", tool, { cause: err });
+            }
+        }
+        try {
+            return def.result.parse(value);
+        }
+        catch (err) {
+            throw this.error("result", tool, { cause: err });
+        }
+    }
+    /** What `promise` resolves to, or a timeout for `tool` if `signal` aborts first. */
+    until(signal, tool, promise) {
+        return new Promise((resolve, reject) => {
+            const stop = () => reject(this.error("timeout", tool));
+            signal.addEventListener("abort", stop, { once: true });
+            promise.then(resolve, reject).finally(() => signal.removeEventListener("abort", stop));
+        });
+    }
+    /** An SDK error, as one of ours. */
+    failure(err, tool, client) {
+        if (isMcpError(err))
+            return err;
+        if (this.closed)
+            return this.error("closed", tool, { cause: err });
+        if (err instanceof ProtocolError) {
+            // The SDK's own check of a call's result throws one too: the server's
+            // result is at fault there, not the call. Only a call has a result.
+            const checked = tool !== undefined && OUTPUT_CHECKS.some(([code, words]) => err.code === code && words.test(err.message));
+            return this.error(checked ? "result" : "protocol", tool, { cause: err, text: err.message, code: err.code });
+        }
+        if (err instanceof SdkError) {
+            switch (err.code) {
+                case SdkErrorCode.RequestTimeout:
+                    return this.error("timeout", tool, { cause: err });
+                case SdkErrorCode.NotConnected:
+                case SdkErrorCode.ConnectionClosed:
+                case SdkErrorCode.SendFailed:
+                case SdkErrorCode.ClientHttpFailedToOpenStream:
+                    return this.error("connection", tool, { cause: err });
+                case SdkErrorCode.InvalidResult:
+                    // only a call has a result; a listing the SDK can't read is the server's fault
+                    if (tool !== undefined)
+                        return this.error("result", tool, { cause: err });
+                    return this.error("protocol", tool, { cause: err, text: err.message });
+                default:
+                    return this.error("protocol", tool, { cause: err, text: err.message });
+            }
+        }
+        // the SDK throws a plain Error for a call on a connection that has gone
+        return this.error(this.dropped.has(client) ? "connection" : "protocol", tool, { cause: err });
+    }
+    error(reason, tool, detail = {}) {
+        const who = tool === undefined ? this.name : `${this.name}/${tool}`;
+        return new McpError(reason, MESSAGES[reason](who), { server: this.name, tool, ...detail });
+    }
+}
+function checkMs(label, ms) {
+    if (typeof ms !== "number" || !Number.isInteger(ms) || ms <= 0 || ms > MAX_TIMER_MS) {
+        throw new RangeError(`${label} must be a whole number of milliseconds, from 1 to ${MAX_TIMER_MS} (got ${String(ms)})`);
+    }
+    return ms;
+}
+function problemWith(name, listing) {
+    const tool = listing.get(name);
+    if (!tool)
+        return `the server has no tool named "${name}"`;
+    if (tool.execution?.taskSupport === "required") {
+        return `tool "${name}" can only run as an MCP task, which @haikit/mcp does not support`;
+    }
+    return null;
+}
+/** What a change to a tool can break: its schemas, and whether it must run as a task. */
+const shape = (tool) => JSON.stringify([tool.inputSchema, tool.outputSchema ?? null, tool.execution?.taskSupport ?? null]);
+function warn(change) {
+    const parts = [
+        ...change.removed.map((name) => `tool "${name}" was removed`),
+        ...change.changed.map((name) => `tool "${name}" changed its schema`),
+    ];
+    console.warn(`@haikit/mcp: ${change.server}: ${parts.join("; ")}`);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/text.d.ts

@@ -0,0 +1,16 @@
+import type { McpResult } from "./index.js";
+export interface TextOptions {
+    /** The longest text returned, before the line saying it was cut. Default 8,000 (about 2,000 tokens). */
+    maxChars?: number;
+}
+/**
+ * A result as text, for a tool that decides to pass some of it on. Nothing
+ * calls this for you: what a result becomes is the tool's choice.
+ *
+ * Text blocks, and resources embedded as text, come as they are; anything
+ * else becomes one line saying what it was. With no content, the structured
+ * result as JSON. Longer than `maxChars`, it is cut, and a last line says so:
+ * a cut nobody mentions turns a cost problem into a correctness problem.
+ */
+export declare function textOf(result: McpResult, options?: TextOptions): string;
+//# sourceMappingURL=text.d.ts.map

package/dist/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../src/text.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,WAAW;IAC1B,wGAAwG;IACxG,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,GAAE,WAAgB,GAAG,MAAM,CAa3E"}

package/dist/text.js

@@ -0,0 +1,51 @@
+const MAX_CHARS = 8_000;
+/**
+ * A result as text, for a tool that decides to pass some of it on. Nothing
+ * calls this for you: what a result becomes is the tool's choice.
+ *
+ * Text blocks, and resources embedded as text, come as they are; anything
+ * else becomes one line saying what it was. With no content, the structured
+ * result as JSON. Longer than `maxChars`, it is cut, and a last line says so:
+ * a cut nobody mentions turns a cost problem into a correctness problem.
+ */
+export function textOf(result, options = {}) {
+    const maxChars = options.maxChars ?? MAX_CHARS;
+    if (!Number.isSafeInteger(maxChars) || maxChars < 0) {
+        throw new RangeError(`maxChars must be a whole number of characters, 0 or more (got ${String(maxChars)})`);
+    }
+    const text = result.content.length === 0
+        ? result.structuredContent === undefined
+            ? ""
+            : JSON.stringify(result.structuredContent)
+        : result.content.map(blockText).join("\n");
+    if (text.length <= maxChars)
+        return text;
+    return `${text.slice(0, maxChars)}\n[Cut at ${maxChars} of ${text.length} characters.]`;
+}
+function blockText(block) {
+    switch (block.type) {
+        case "text":
+            return block.text;
+        case "image":
+        case "audio":
+            return `[${block.type}: ${block.mimeType}, ${bytes(block.data)} bytes, not included]`;
+        case "resource_link":
+            return `[resource link: ${block.name} ${block.uri}]`;
+        case "resource": {
+            const r = block.resource;
+            if ("text" in r && typeof r.text === "string")
+                return r.text;
+            const blob = "blob" in r && typeof r.blob === "string" ? r.blob : "";
+            return `[resource: ${r.uri}${r.mimeType ? `, ${r.mimeType}` : ""}, ${bytes(blob)} bytes, not included]`;
+        }
+        default:
+            // a content type from a later protocol revision
+            return `[${String(block.type)} content, not included]`;
+    }
+}
+/** The size of what base64 `data` encodes, without decoding it. */
+function bytes(data) {
+    const padding = data.endsWith("==") ? 2 : data.endsWith("=") ? 1 : 0;
+    return Math.max(0, Math.floor((data.length * 3) / 4) - padding);
+}
+//# sourceMappingURL=text.js.map

package/dist/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../src/text.ts"],"names":[],"mappings":"AAQA,MAAM,SAAS,GAAG,KAAK,CAAC;AAExB;;;;;;;;GAQG;AACH,MAAM,UAAU,MAAM,CAAC,MAAiB,EAAE,UAAuB,EAAE;IACjE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,SAAS,CAAC;IAC/C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,UAAU,CAAC,iEAAiE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC7G,CAAC;IACD,MAAM,IAAI,GACR,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QACzB,CAAC,CAAC,MAAM,CAAC,iBAAiB,KAAK,SAAS;YACtC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,iBAAiB,CAAC;QAC5C,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,IAAI,CAAC;IACzC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,aAAa,QAAQ,OAAO,IAAI,CAAC,MAAM,eAAe,CAAC;AAC1F,CAAC;AAED,SAAS,SAAS,CAAC,KAAmB;IACpC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,MAAM;YACT,OAAO,KAAK,CAAC,IAAI,CAAC;QACpB,KAAK,OAAO,CAAC;QACb,KAAK,OAAO;YACV,OAAO,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,QAAQ,KAAK,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC;QACxF,KAAK,eAAe;YAClB,OAAO,mBAAmB,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,GAAG,CAAC;QACvD,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC;YACzB,IAAI,MAAM,IAAI,CAAC,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,CAAC,CAAC,IAAI,CAAC;YAC7D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,OAAO,cAAc,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC;QAC1G,CAAC;QACD;YACE,gDAAgD;YAChD,OAAO,IAAI,MAAM,CAAE,KAA4B,CAAC,IAAI,CAAC,yBAAyB,CAAC;IACnF,CAAC;AACH,CAAC;AAED,mEAAmE;AACnE,SAAS,KAAK,CAAC,IAAY;IACzB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC;AAClE,CAAC"}

package/dist/transports.d.ts

@@ -0,0 +1,20 @@
+import { type StreamableHTTPClientTransportOptions, type Transport } from "@modelcontextprotocol/client";
+import { type StdioServerParameters } from "@modelcontextprotocol/client/stdio";
+export interface HttpOptions extends StreamableHTTPClientTransportOptions {
+    /** Sent on every request, over any of the same name in `requestInit.headers`. */
+    headers?: Record<string, string>;
+}
+/**
+ * A server at `url`, over Streamable HTTP. Everything but `headers` is the
+ * SDK's own `StreamableHTTPClientTransportOptions`, such as an `authProvider`.
+ * The URL is checked now, so a bad one fails at startup.
+ */
+export declare function http(url: string | URL, options?: HttpOptions): () => Transport;
+/**
+ * A server this process starts, and talks to over its stdin and stdout. Each
+ * connection starts a new child; `close()` stops it. Unless `env` is given,
+ * the child gets only the SDK's short list of safe variables (such as `HOME`
+ * and `PATH`), not this process's environment and the secrets in it.
+ */
+export declare function stdio(params: StdioServerParameters): () => Transport;
+//# sourceMappingURL=transports.d.ts.map

package/dist/transports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transports.d.ts","sourceRoot":"","sources":["../src/transports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,KAAK,oCAAoC,EAAE,KAAK,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACxI,OAAO,EAAwB,KAAK,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAEtG,MAAM,WAAW,WAAY,SAAQ,oCAAoC;IACvE,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,EAAE,OAAO,GAAE,WAAgB,GAAG,MAAM,SAAS,CASlF;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,SAAS,CAEpE"}

package/dist/transports.js

@@ -0,0 +1,28 @@
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/client";
+import { StdioClientTransport } from "@modelcontextprotocol/client/stdio";
+/**
+ * A server at `url`, over Streamable HTTP. Everything but `headers` is the
+ * SDK's own `StreamableHTTPClientTransportOptions`, such as an `authProvider`.
+ * The URL is checked now, so a bad one fails at startup.
+ */
+export function http(url, options = {}) {
+    const target = new URL(url);
+    const { headers, ...rest } = options;
+    if (headers) {
+        const merged = new Headers(rest.requestInit?.headers);
+        for (const [name, value] of Object.entries(headers))
+            merged.set(name, value);
+        rest.requestInit = { ...rest.requestInit, headers: merged };
+    }
+    return () => new StreamableHTTPClientTransport(target, rest);
+}
+/**
+ * A server this process starts, and talks to over its stdin and stdout. Each
+ * connection starts a new child; `close()` stops it. Unless `env` is given,
+ * the child gets only the SDK's short list of safe variables (such as `HOME`
+ * and `PATH`), not this process's environment and the secrets in it.
+ */
+export function stdio(params) {
+    return () => new StdioClientTransport(params);
+}
+//# sourceMappingURL=transports.js.map

package/dist/transports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transports.js","sourceRoot":"","sources":["../src/transports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAA6D,MAAM,8BAA8B,CAAC;AACxI,OAAO,EAAE,oBAAoB,EAA8B,MAAM,oCAAoC,CAAC;AAOtG;;;;GAIG;AACH,MAAM,UAAU,IAAI,CAAC,GAAiB,EAAE,UAAuB,EAAE;IAC/D,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IACrC,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,MAAM,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACtD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC7E,IAAI,CAAC,WAAW,GAAG,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAC9D,CAAC;IACD,OAAO,GAAG,EAAE,CAAC,IAAI,6BAA6B,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,KAAK,CAAC,MAA6B;IACjD,OAAO,GAAG,EAAE,CAAC,IAAI,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAChD,CAAC"}

package/package.json

@@ -1,6 +1,54 @@
 {
   "name": "@haikit/mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.32.0",
+  "description": "Call MCP servers' tools from inside your haikit tools. The model never sees an MCP tool: your tool decides what it hears and what the browser shows. Imports only @haikit/core.",
+  "keywords": [
+    "haikit",
+    "mcp",
+    "model-context-protocol",
+    "llm",
+    "agent",
+    "agentic-ui",
+    "tool-use",
+    "ai"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "prepack": "npm --prefix ../.. run build"
+  },
+  "dependencies": {
+    "@haikit/core": "0.32.0",
+    "@modelcontextprotocol/client": "^2.4.0",
+    "@types/node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "homepage": "https://github.com/wfoxd/haikit/tree/main/packages/mcp#readme",
+  "bugs": {
+    "url": "https://github.com/wfoxd/haikit/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wfoxd/haikit.git",
+    "directory": "packages/mcp"
+  }
+}