@mushinjs/plugin-mcp 0.0.0-stage → 0.2.0-next.20261112165327

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Setobox
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/client.d.ts

@@ -0,0 +1,110 @@
+/** The protocol version this client asks for; servers answer with the one they speak. */
+export declare const PROTOCOL_VERSION = "2025-06-18";
+export interface McpTool {
+  name: string;
+  title?: string;
+  description?: string;
+  inputSchema: Record<string, any>;
+  annotations?: {
+    readOnlyHint?: boolean;
+    destructiveHint?: boolean;
+    title?: string;
+  };
+}
+export interface McpCallResult {
+  content?: {
+    type: string;
+    text?: string;
+    [key: string]: unknown;
+  }[];
+  structuredContent?: unknown;
+  isError?: boolean;
+}
+interface JsonRpcMessage {
+  jsonrpc: '2.0';
+  id?: number | string;
+  method?: string;
+  params?: any;
+  result?: any;
+  error?: {
+    code: number;
+    message: string;
+    data?: unknown;
+  };
+}
+/** Sends JSON-RPC messages to an MCP server and hands back what it sends. */
+interface Transport {
+  start(onMessage: (message: JsonRpcMessage) => void, onClose: (error?: Error) => void): Promise<void>;
+  /** Sends a message; an HTTP transport may answer it directly. */
+  send(message: JsonRpcMessage): Promise<void>;
+  close(): Promise<void>;
+  /** Lines the server wrote to stderr, for the status page. */
+  stderr?: string[];
+}
+export interface StdioOptions {
+  command: string;
+  args?: string[];
+  env?: Record<string, string>;
+  cwd?: string;
+}
+/** Runs the server as a child process and talks over stdin and stdout, one JSON message per line. */
+export declare class StdioTransport implements Transport {
+  private options;
+  private child?;
+  stderr: string[];
+  constructor(options: StdioOptions);
+  start(onMessage: (message: JsonRpcMessage) => void, onClose: (error?: Error) => void): Promise<void>;
+  private note;
+  send(message: JsonRpcMessage): Promise<void>;
+  close(): Promise<void>;
+}
+export interface HttpOptions {
+  url: string;
+  headers?: Record<string, string>;
+}
+/** Streamable HTTP: every message is a POST; the answer is JSON or a short event stream. */
+export declare class HttpTransport implements Transport {
+  private options;
+  private session?;
+  private version?;
+  private onMessage?;
+  private aborts;
+  constructor(options: HttpOptions);
+  start(onMessage: (message: JsonRpcMessage) => void): Promise<void>;
+  /** Sets the protocol version header after initialization. */
+  setVersion(version: string): void;
+  send(message: JsonRpcMessage): Promise<void>;
+  /** Reads server-sent events until the answer to `id` arrives. */
+  private readEvents;
+  close(): Promise<void>;
+}
+/** One connection to an MCP server: initialize, list tools, call tools. */
+export declare class McpClient {
+  private transport;
+  private hooks;
+  private timeoutMs;
+  private next;
+  private pending;
+  server?: {
+    name?: string;
+    version?: string;
+  };
+  instructions?: string;
+  closed: boolean;
+  constructor(transport: Transport, hooks?: {
+    onToolsChanged?: () => void;
+    onClose?: (error?: Error) => void;
+  }, timeoutMs?: number);
+  get stderr(): string[];
+  connect(): Promise<void>;
+  listTools(): Promise<McpTool[]>;
+  callTool(name: string, args: unknown, signal?: AbortSignal): Promise<McpCallResult>;
+  close(): Promise<void>;
+  private request;
+  private receive;
+  private fail;
+  private rejectAll;
+}
+/** The text of a tool result, for the Agent: text parts joined, other parts summarized. */
+export declare function resultText(result: McpCallResult): string;
+export {};

package/dist/client.js

@@ -0,0 +1,322 @@
+import { spawn } from "node:child_process";
+// src/client.ts
+/** The protocol version this client asks for; servers answer with the one they speak. */
+const PROTOCOL_VERSION = "2025-06-18";
+/** Runs the server as a child process and talks over stdin and stdout, one JSON message per line. */
+var StdioTransport = class {
+	options;
+	child;
+	stderr = [];
+	constructor(options) {
+		this.options = options;
+	}
+	start(onMessage, onClose) {
+		return new Promise((resolve, reject) => {
+			const child = spawn(this.options.command, this.options.args ?? [], {
+				cwd: this.options.cwd || void 0,
+				env: {
+					...process.env,
+					...this.options.env
+				},
+				stdio: [
+					"pipe",
+					"pipe",
+					"pipe"
+				],
+				shell: process.platform === "win32",
+				windowsHide: true
+			});
+			this.child = child;
+			let buffer = "";
+			child.stdout.setEncoding("utf8");
+			child.stdout.on("data", (chunk) => {
+				buffer += chunk;
+				let index;
+				while ((index = buffer.indexOf("\n")) >= 0) {
+					const line = buffer.slice(0, index).trim();
+					buffer = buffer.slice(index + 1);
+					if (!line) continue;
+					try {
+						onMessage(JSON.parse(line));
+					} catch {
+						this.note(`not JSON on stdout: ${line.slice(0, 200)}`);
+					}
+				}
+			});
+			child.stderr.setEncoding("utf8");
+			child.stderr.on("data", (chunk) => {
+				for (const line of chunk.split("\n")) if (line.trim()) this.note(line);
+			});
+			child.once("spawn", () => resolve());
+			child.once("error", (error) => {
+				reject(error);
+				onClose(error);
+			});
+			child.once("exit", (code, signal) => onClose(/* @__PURE__ */ new Error(`the server exited (${signal ?? `code ${code}`})`)));
+		});
+	}
+	note(line) {
+		this.stderr.push(line.slice(0, 500));
+		if (this.stderr.length > 50) this.stderr.shift();
+	}
+	async send(message) {
+		if (!this.child?.stdin?.writable) throw new Error("the server is not running");
+		this.child.stdin.write(`${JSON.stringify(message)}\n`);
+	}
+	async close() {
+		const child = this.child;
+		this.child = void 0;
+		if (!child || child.exitCode !== null) return;
+		child.stdin?.end();
+		const exited = new Promise((resolve) => child.once("exit", () => resolve()));
+		const timer = setTimeout(() => child.kill(), 2e3);
+		await exited;
+		clearTimeout(timer);
+	}
+};
+/** Streamable HTTP: every message is a POST; the answer is JSON or a short event stream. */
+var HttpTransport = class {
+	options;
+	session;
+	version;
+	onMessage;
+	aborts = /* @__PURE__ */ new Set();
+	constructor(options) {
+		this.options = options;
+	}
+	async start(onMessage) {
+		this.onMessage = onMessage;
+	}
+	/** Sets the protocol version header after initialization. */
+	setVersion(version) {
+		this.version = version;
+	}
+	async send(message) {
+		const abort = new AbortController();
+		this.aborts.add(abort);
+		try {
+			const response = await fetch(this.options.url, {
+				method: "POST",
+				headers: {
+					...this.options.headers,
+					"content-type": "application/json",
+					accept: "application/json, text/event-stream",
+					...this.session ? { "mcp-session-id": this.session } : {},
+					...this.version ? { "mcp-protocol-version": this.version } : {}
+				},
+				body: JSON.stringify(message),
+				signal: abort.signal
+			});
+			const session = response.headers.get("mcp-session-id");
+			if (session) this.session = session;
+			if (response.status === 202 || response.status === 204) return;
+			if (!response.ok) {
+				const text = await response.text().catch(() => "");
+				throw new Error(`HTTP ${response.status}${text ? `: ${text.slice(0, 200)}` : ""}`);
+			}
+			const type = response.headers.get("content-type") ?? "";
+			if (type.includes("text/event-stream")) await this.readEvents(response, message.id);
+			else if (type.includes("application/json")) {
+				const body = await response.json();
+				for (const item of Array.isArray(body) ? body : [body]) this.onMessage?.(item);
+			}
+		} finally {
+			this.aborts.delete(abort);
+		}
+	}
+	/** Reads server-sent events until the answer to `id` arrives. */
+	async readEvents(response, id) {
+		const reader = response.body.pipeThrough(new TextDecoderStream()).getReader();
+		let buffer = "";
+		try {
+			while (true) {
+				const { value, done } = await reader.read();
+				if (done) return;
+				buffer += value.replace(/\r\n/g, "\n");
+				let index;
+				while ((index = buffer.indexOf("\n\n")) >= 0) {
+					const block = buffer.slice(0, index);
+					buffer = buffer.slice(index + 2);
+					const data = block.split("\n").filter((line) => line.startsWith("data:")).map((line) => line.slice(5).trimStart()).join("\n");
+					if (!data) continue;
+					const message = JSON.parse(data);
+					this.onMessage?.(message);
+					if (id !== void 0 && message.id === id && !message.method) return;
+				}
+			}
+		} finally {
+			reader.cancel().catch(() => {});
+		}
+	}
+	async close() {
+		for (const abort of this.aborts) abort.abort();
+		if (this.session) await fetch(this.options.url, {
+			method: "DELETE",
+			headers: {
+				...this.options.headers,
+				"mcp-session-id": this.session
+			}
+		}).catch(() => {});
+	}
+};
+/** One connection to an MCP server: initialize, list tools, call tools. */
+var McpClient = class {
+	transport;
+	hooks;
+	timeoutMs;
+	next = 1;
+	pending = /* @__PURE__ */ new Map();
+	server;
+	instructions;
+	closed = false;
+	constructor(transport, hooks = {}, timeoutMs = 6e4) {
+		this.transport = transport;
+		this.hooks = hooks;
+		this.timeoutMs = timeoutMs;
+	}
+	get stderr() {
+		return this.transport.stderr ?? [];
+	}
+	async connect() {
+		await this.transport.start((message) => this.receive(message), (error) => this.fail(error));
+		const result = await this.request("initialize", {
+			protocolVersion: PROTOCOL_VERSION,
+			capabilities: {},
+			clientInfo: {
+				name: "mushin",
+				title: "Mushin.js",
+				version: "0.1.0"
+			}
+		});
+		this.server = result?.serverInfo;
+		this.instructions = result?.instructions;
+		if (this.transport instanceof HttpTransport) this.transport.setVersion(result?.protocolVersion ?? "2025-06-18");
+		await this.transport.send({
+			jsonrpc: "2.0",
+			method: "notifications/initialized"
+		});
+	}
+	async listTools() {
+		const tools = [];
+		let cursor;
+		do {
+			const page = await this.request("tools/list", cursor ? { cursor } : {});
+			tools.push(...page?.tools ?? []);
+			cursor = page?.nextCursor;
+		} while (cursor);
+		return tools;
+	}
+	callTool(name, args, signal) {
+		return this.request("tools/call", {
+			name,
+			arguments: args ?? {}
+		}, signal);
+	}
+	async close() {
+		if (this.closed) return;
+		this.closed = true;
+		await this.transport.close().catch(() => {});
+		this.rejectAll(/* @__PURE__ */ new Error("the connection was closed"));
+	}
+	request(method, params, signal) {
+		if (this.closed) return Promise.reject(/* @__PURE__ */ new Error("the connection is closed"));
+		const id = this.next++;
+		return new Promise((resolve, reject) => {
+			const timer = setTimeout(() => {
+				this.pending.delete(id);
+				this.transport.send({
+					jsonrpc: "2.0",
+					method: "notifications/cancelled",
+					params: {
+						requestId: id,
+						reason: "timeout"
+					}
+				}).catch(() => {});
+				reject(/* @__PURE__ */ new Error(`${method} timed out after ${Math.round(this.timeoutMs / 1e3)}s`));
+			}, this.timeoutMs);
+			this.pending.set(id, {
+				resolve,
+				reject,
+				timer
+			});
+			signal?.addEventListener("abort", () => {
+				const entry = this.pending.get(id);
+				if (!entry) return;
+				clearTimeout(entry.timer);
+				this.pending.delete(id);
+				this.transport.send({
+					jsonrpc: "2.0",
+					method: "notifications/cancelled",
+					params: {
+						requestId: id,
+						reason: "cancelled"
+					}
+				}).catch(() => {});
+				reject(/* @__PURE__ */ new Error("cancelled"));
+			}, { once: true });
+			this.transport.send({
+				jsonrpc: "2.0",
+				id,
+				method,
+				params
+			}).catch((error) => {
+				const entry = this.pending.get(id);
+				if (!entry) return;
+				clearTimeout(entry.timer);
+				this.pending.delete(id);
+				reject(error);
+			});
+		});
+	}
+	receive(message) {
+		if (message.method) {
+			if (message.id !== void 0) {
+				const reply = message.method === "ping" ? {
+					jsonrpc: "2.0",
+					id: message.id,
+					result: {}
+				} : {
+					jsonrpc: "2.0",
+					id: message.id,
+					error: {
+						code: -32601,
+						message: `${message.method} is not supported`
+					}
+				};
+				this.transport.send(reply).catch(() => {});
+			} else if (message.method === "notifications/tools/list_changed") this.hooks.onToolsChanged?.();
+			return;
+		}
+		const entry = typeof message.id === "number" ? this.pending.get(message.id) : void 0;
+		if (!entry) return;
+		clearTimeout(entry.timer);
+		this.pending.delete(message.id);
+		if (message.error) entry.reject(new Error(message.error.message || `error ${message.error.code}`));
+		else entry.resolve(message.result);
+	}
+	fail(error) {
+		if (this.closed) return;
+		this.closed = true;
+		this.rejectAll(error ?? /* @__PURE__ */ new Error("the connection was closed"));
+		this.hooks.onClose?.(error);
+	}
+	rejectAll(error) {
+		for (const entry of this.pending.values()) {
+			clearTimeout(entry.timer);
+			entry.reject(error);
+		}
+		this.pending.clear();
+	}
+};
+/** The text of a tool result, for the Agent: text parts joined, other parts summarized. */
+function resultText(result) {
+	return (result.content ?? []).map((part) => {
+		if (part.type === "text") return part.text ?? "";
+		if (part.type === "resource" && typeof part.resource?.text === "string") return part.resource.text;
+		if (part.type === "resource_link") return `[${part.name ?? "resource"}](${part.uri})`;
+		return `[${part.type}${part.mimeType ? ` ${part.mimeType}` : ""}]`;
+	}).join("\n");
+}
+export { HttpTransport, McpClient, PROTOCOL_VERSION, StdioTransport, resultText };
+
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","names":[],"sources":["../src/client.ts"],"sourcesContent":["import { type ChildProcess, spawn } from 'node:child_process'\r\n\r\n/** The protocol version this client asks for; servers answer with the one they speak. */\r\nexport const PROTOCOL_VERSION = '2025-06-18'\r\n\r\nexport interface McpTool {\r\n  name: string\r\n  title?: string\r\n  description?: string\r\n  inputSchema: Record<string, any>\r\n  annotations?: { readOnlyHint?: boolean; destructiveHint?: boolean; title?: string }\r\n}\r\n\r\nexport interface McpCallResult {\r\n  content?: { type: string; text?: string; [key: string]: unknown }[]\r\n  structuredContent?: unknown\r\n  isError?: boolean\r\n}\r\n\r\ninterface JsonRpcMessage {\r\n  jsonrpc: '2.0'\r\n  id?: number | string\r\n  method?: string\r\n  params?: any\r\n  result?: any\r\n  error?: { code: number; message: string; data?: unknown }\r\n}\r\n\r\n/** Sends JSON-RPC messages to an MCP server and hands back what it sends. */\r\ninterface Transport {\r\n  start(onMessage: (message: JsonRpcMessage) => void, onClose: (error?: Error) => void): Promise<void>\r\n  /** Sends a message; an HTTP transport may answer it directly. */\r\n  send(message: JsonRpcMessage): Promise<void>\r\n  close(): Promise<void>\r\n  /** Lines the server wrote to stderr, for the status page. */\r\n  stderr?: string[]\r\n}\r\n\r\nexport interface StdioOptions {\r\n  command: string\r\n  args?: string[]\r\n  env?: Record<string, string>\r\n  cwd?: string\r\n}\r\n\r\n/** Runs the server as a child process and talks over stdin and stdout, one JSON message per line. */\r\nexport class StdioTransport implements Transport {\r\n  private child?: ChildProcess\r\n  stderr: string[] = []\r\n\r\n  constructor(private options: StdioOptions) {}\r\n\r\n  start(onMessage: (message: JsonRpcMessage) => void, onClose: (error?: Error) => void) {\r\n    return new Promise<void>((resolve, reject) => {\r\n      const child = spawn(this.options.command, this.options.args ?? [], {\r\n        cwd: this.options.cwd || undefined,\r\n        env: { ...process.env, ...this.options.env },\r\n        stdio: ['pipe', 'pipe', 'pipe'],\r\n        shell: process.platform === 'win32',\r\n        windowsHide: true,\r\n      })\r\n      this.child = child\r\n      let buffer = ''\r\n      child.stdout!.setEncoding('utf8')\r\n      child.stdout!.on('data', (chunk: string) => {\r\n        buffer += chunk\r\n        let index: number\r\n        while ((index = buffer.indexOf('\\n')) >= 0) {\r\n          const line = buffer.slice(0, index).trim()\r\n          buffer = buffer.slice(index + 1)\r\n          if (!line) continue\r\n          try {\r\n            onMessage(JSON.parse(line))\r\n          } catch {\r\n            this.note(`not JSON on stdout: ${line.slice(0, 200)}`)\r\n          }\r\n        }\r\n      })\r\n      child.stderr!.setEncoding('utf8')\r\n      child.stderr!.on('data', (chunk: string) => {\r\n        for (const line of chunk.split('\\n')) if (line.trim()) this.note(line)\r\n      })\r\n      child.once('spawn', () => resolve())\r\n      child.once('error', (error) => {\r\n        reject(error)\r\n        onClose(error)\r\n      })\r\n      child.once('exit', (code, signal) => onClose(new Error(`the server exited (${signal ?? `code ${code}`})`)))\r\n    })\r\n  }\r\n\r\n  private note(line: string) {\r\n    this.stderr.push(line.slice(0, 500))\r\n    if (this.stderr.length > 50) this.stderr.shift()\r\n  }\r\n\r\n  async send(message: JsonRpcMessage) {\r\n    if (!this.child?.stdin?.writable) throw new Error('the server is not running')\r\n    this.child.stdin.write(`${JSON.stringify(message)}\\n`)\r\n  }\r\n\r\n  async close() {\r\n    const child = this.child\r\n    this.child = undefined\r\n    if (!child || child.exitCode !== null) return\r\n    child.stdin?.end()\r\n    const exited = new Promise<void>((resolve) => child.once('exit', () => resolve()))\r\n    const timer = setTimeout(() => child.kill(), 2000)\r\n    await exited\r\n    clearTimeout(timer)\r\n  }\r\n}\r\n\r\nexport interface HttpOptions {\r\n  url: string\r\n  headers?: Record<string, string>\r\n}\r\n\r\n/** Streamable HTTP: every message is a POST; the answer is JSON or a short event stream. */\r\nexport class HttpTransport implements Transport {\r\n  private session?: string\r\n  private version?: string\r\n  private onMessage?: (message: JsonRpcMessage) => void\r\n  private aborts = new Set<AbortController>()\r\n\r\n  constructor(private options: HttpOptions) {}\r\n\r\n  async start(onMessage: (message: JsonRpcMessage) => void) {\r\n    this.onMessage = onMessage\r\n  }\r\n\r\n  /** Sets the protocol version header after initialization. */\r\n  setVersion(version: string) {\r\n    this.version = version\r\n  }\r\n\r\n  async send(message: JsonRpcMessage) {\r\n    const abort = new AbortController()\r\n    this.aborts.add(abort)\r\n    try {\r\n      const response = await fetch(this.options.url, {\r\n        method: 'POST',\r\n        headers: {\r\n          ...this.options.headers,\r\n          'content-type': 'application/json',\r\n          accept: 'application/json, text/event-stream',\r\n          ...(this.session ? { 'mcp-session-id': this.session } : {}),\r\n          ...(this.version ? { 'mcp-protocol-version': this.version } : {}),\r\n        },\r\n        body: JSON.stringify(message),\r\n        signal: abort.signal,\r\n      })\r\n      const session = response.headers.get('mcp-session-id')\r\n      if (session) this.session = session\r\n      if (response.status === 202 || response.status === 204) return\r\n      if (!response.ok) {\r\n        const text = await response.text().catch(() => '')\r\n        throw new Error(`HTTP ${response.status}${text ? `: ${text.slice(0, 200)}` : ''}`)\r\n      }\r\n      const type = response.headers.get('content-type') ?? ''\r\n      if (type.includes('text/event-stream')) {\r\n        await this.readEvents(response, message.id)\r\n      } else if (type.includes('application/json')) {\r\n        const body = await response.json()\r\n        for (const item of Array.isArray(body) ? body : [body]) this.onMessage?.(item)\r\n      }\r\n    } finally {\r\n      this.aborts.delete(abort)\r\n    }\r\n  }\r\n\r\n  /** Reads server-sent events until the answer to `id` arrives. */\r\n  private async readEvents(response: Response, id: JsonRpcMessage['id']) {\r\n    const reader = response.body!.pipeThrough(new TextDecoderStream()).getReader()\r\n    let buffer = ''\r\n    try {\r\n      while (true) {\r\n        const { value, done } = await reader.read()\r\n        if (done) return\r\n        buffer += value.replace(/\\r\\n/g, '\\n')\r\n        let index: number\r\n        while ((index = buffer.indexOf('\\n\\n')) >= 0) {\r\n          const block = buffer.slice(0, index)\r\n          buffer = buffer.slice(index + 2)\r\n          const data = block.split('\\n').filter((line) => line.startsWith('data:')).map((line) => line.slice(5).trimStart()).join('\\n')\r\n          if (!data) continue\r\n          const message = JSON.parse(data) as JsonRpcMessage\r\n          this.onMessage?.(message)\r\n          if (id !== undefined && message.id === id && !message.method) return\r\n        }\r\n      }\r\n    } finally {\r\n      reader.cancel().catch(() => {})\r\n    }\r\n  }\r\n\r\n  async close() {\r\n    for (const abort of this.aborts) abort.abort()\r\n    if (this.session) {\r\n      await fetch(this.options.url, { method: 'DELETE', headers: { ...this.options.headers, 'mcp-session-id': this.session } }).catch(() => {})\r\n    }\r\n  }\r\n}\r\n\r\n/** One connection to an MCP server: initialize, list tools, call tools. */\r\nexport class McpClient {\r\n  private next = 1\r\n  private pending = new Map<number, { resolve: (value: any) => void; reject: (error: Error) => void; timer: ReturnType<typeof setTimeout> }>()\r\n  server?: { name?: string; version?: string }\r\n  instructions?: string\r\n  closed = false\r\n\r\n  constructor(\r\n    private transport: Transport,\r\n    private hooks: { onToolsChanged?: () => void; onClose?: (error?: Error) => void } = {},\r\n    private timeoutMs = 60_000,\r\n  ) {}\r\n\r\n  get stderr() {\r\n    return this.transport.stderr ?? []\r\n  }\r\n\r\n  async connect() {\r\n    await this.transport.start((message) => this.receive(message), (error) => this.fail(error))\r\n    const result = await this.request('initialize', {\r\n      protocolVersion: PROTOCOL_VERSION,\r\n      capabilities: {},\r\n      clientInfo: { name: 'mushin', title: 'Mushin.js', version: '0.1.0' },\r\n    })\r\n    this.server = result?.serverInfo\r\n    this.instructions = result?.instructions\r\n    if (this.transport instanceof HttpTransport) this.transport.setVersion(result?.protocolVersion ?? PROTOCOL_VERSION)\r\n    await this.transport.send({ jsonrpc: '2.0', method: 'notifications/initialized' })\r\n  }\r\n\r\n  async listTools() {\r\n    const tools: McpTool[] = []\r\n    let cursor: string | undefined\r\n    do {\r\n      const page = await this.request('tools/list', cursor ? { cursor } : {})\r\n      tools.push(...page?.tools ?? [])\r\n      cursor = page?.nextCursor\r\n    } while (cursor)\r\n    return tools\r\n  }\r\n\r\n  callTool(name: string, args: unknown, signal?: AbortSignal): Promise<McpCallResult> {\r\n    return this.request('tools/call', { name, arguments: args ?? {} }, signal)\r\n  }\r\n\r\n  async close() {\r\n    if (this.closed) return\r\n    this.closed = true\r\n    await this.transport.close().catch(() => {})\r\n    this.rejectAll(new Error('the connection was closed'))\r\n  }\r\n\r\n  private request(method: string, params: unknown, signal?: AbortSignal) {\r\n    if (this.closed) return Promise.reject(new Error('the connection is closed'))\r\n    const id = this.next++\r\n    return new Promise<any>((resolve, reject) => {\r\n      const timer = setTimeout(() => {\r\n        this.pending.delete(id)\r\n        this.transport.send({ jsonrpc: '2.0', method: 'notifications/cancelled', params: { requestId: id, reason: 'timeout' } }).catch(() => {})\r\n        reject(new Error(`${method} timed out after ${Math.round(this.timeoutMs / 1000)}s`))\r\n      }, this.timeoutMs)\r\n      this.pending.set(id, { resolve, reject, timer })\r\n      signal?.addEventListener('abort', () => {\r\n        const entry = this.pending.get(id)\r\n        if (!entry) return\r\n        clearTimeout(entry.timer)\r\n        this.pending.delete(id)\r\n        this.transport.send({ jsonrpc: '2.0', method: 'notifications/cancelled', params: { requestId: id, reason: 'cancelled' } }).catch(() => {})\r\n        reject(new Error('cancelled'))\r\n      }, { once: true })\r\n      this.transport.send({ jsonrpc: '2.0', id, method, params }).catch((error) => {\r\n        const entry = this.pending.get(id)\r\n        if (!entry) return\r\n        clearTimeout(entry.timer)\r\n        this.pending.delete(id)\r\n        reject(error)\r\n      })\r\n    })\r\n  }\r\n\r\n  private receive(message: JsonRpcMessage) {\r\n    if (message.method) {\r\n      if (message.id !== undefined) {\r\n        // Requests from the server: answer pings, decline the rest (no sampling, roots or elicitation).\r\n        const reply = message.method === 'ping'\r\n          ? { jsonrpc: '2.0' as const, id: message.id, result: {} }\r\n          : { jsonrpc: '2.0' as const, id: message.id, error: { code: -32601, message: `${message.method} is not supported` } }\r\n        this.transport.send(reply).catch(() => {})\r\n      } else if (message.method === 'notifications/tools/list_changed') {\r\n        this.hooks.onToolsChanged?.()\r\n      }\r\n      return\r\n    }\r\n    const entry = typeof message.id === 'number' ? this.pending.get(message.id) : undefined\r\n    if (!entry) return\r\n    clearTimeout(entry.timer)\r\n    this.pending.delete(message.id as number)\r\n    if (message.error) entry.reject(new Error(message.error.message || `error ${message.error.code}`))\r\n    else entry.resolve(message.result)\r\n  }\r\n\r\n  private fail(error?: Error) {\r\n    if (this.closed) return\r\n    this.closed = true\r\n    this.rejectAll(error ?? new Error('the connection was closed'))\r\n    this.hooks.onClose?.(error)\r\n  }\r\n\r\n  private rejectAll(error: Error) {\r\n    for (const entry of this.pending.values()) {\r\n      clearTimeout(entry.timer)\r\n      entry.reject(error)\r\n    }\r\n    this.pending.clear()\r\n  }\r\n}\r\n\r\n/** The text of a tool result, for the Agent: text parts joined, other parts summarized. */\r\nexport function resultText(result: McpCallResult) {\r\n  const parts = (result.content ?? []).map((part) => {\r\n    if (part.type === 'text') return part.text ?? ''\r\n    if (part.type === 'resource' && typeof (part as any).resource?.text === 'string') return (part as any).resource.text\r\n    if (part.type === 'resource_link') return `[${(part as any).name ?? 'resource'}](${(part as any).uri})`\r\n    return `[${part.type}${(part as any).mimeType ? ` ${(part as any).mimeType}` : ''}]`\r\n  })\r\n  return parts.join('\\n')\r\n}\r\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,264 @@
+import { HttpOptions, HttpTransport, McpCallResult, McpClient, McpTool, PROTOCOL_VERSION, StdioOptions, StdioTransport, resultText } from "./client.js";
+import { Context, Risk, Service, z } from "@mushinjs/core";
+declare module '@mushinjs/core' {
+  interface Context {
+    mcp: Mcp;
+  }
+  interface Events {
+    'mcp/changed'(): void;
+  }
+}
+export interface McpServerRecord {
+  /** Part of each tool's action name, `mcp.<id>.<tool>`. */
+  id: string;
+  name: string;
+  transport: 'stdio' | 'http';
+  command?: string;
+  args?: string[];
+  env?: Record<string, string>;
+  cwd?: string;
+  url?: string;
+  headers?: Record<string, string>;
+  enabled: boolean;
+  /** Tools not offered as actions. */
+  disabledTools: string[];
+  /** Risk per tool, overriding what the server's hints suggest. */
+  risk?: Record<string, Risk>;
+  createdAt: number;
+}
+export type McpStatus = 'stopped' | 'connecting' | 'connected' | 'error';
+/** `read_file` → `readFile`, so the name fits an action name segment. */
+export declare function actionSegment(name: string): string;
+/** Risk from the tool's hints: read-only tools read, destructive ones are dangerous, the rest write. */
+export declare function toolRisk(tool: McpTool): Risk;
+declare const serverFields: {
+  name: z.ZodString;
+  transport: z.ZodEnum<{
+    stdio: "stdio";
+    http: "http";
+  }>;
+  command: z.ZodOptional<z.ZodString>;
+  args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+  cwd: z.ZodOptional<z.ZodString>;
+  url: z.ZodOptional<z.ZodString>;
+  headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+  enabled: z.ZodOptional<z.ZodBoolean>;
+};
+/** Connects to MCP servers and offers each of their tools as an action, so the Agent and flows can use them. */
+export declare class Mcp extends Service {
+  static inject: string[];
+  private home;
+  private servers;
+  private runtimes;
+  private disposed;
+  constructor(ctx: Context);
+  [Service.init](): AsyncGenerator<() => void, void, unknown>;
+  private changed;
+  get(id: string): McpServerRecord;
+  /** A server as the dashboard and the Agent see it: secrets masked, with status and tools. */
+  describe(server: McpServerRecord): {
+    env: {
+      [k: string]: string;
+    } | undefined;
+    headers: {
+      [k: string]: string;
+    } | undefined;
+    status: McpStatus;
+    error: string | undefined;
+    serverInfo: {
+      name?: string;
+      version?: string;
+    } | undefined;
+    stderr: string[];
+    tools: {
+      name: string;
+      title: string | undefined;
+      description: string | undefined;
+      action: string;
+      risk: Risk;
+      enabled: boolean;
+    }[];
+    /** Part of each tool's action name, `mcp.<id>.<tool>`. */
+    id: string;
+    name: string;
+    transport: "stdio" | "http";
+    command?: string;
+    args?: string[];
+    cwd?: string;
+    url?: string;
+    enabled: boolean;
+    /** Tools not offered as actions. */
+    disabledTools: string[];
+    /** Risk per tool, overriding what the server's hints suggest. */
+    risk?: Record<string, Risk>;
+    createdAt: number;
+  };
+  list(): {
+    env: {
+      [k: string]: string;
+    } | undefined;
+    headers: {
+      [k: string]: string;
+    } | undefined;
+    status: McpStatus;
+    error: string | undefined;
+    serverInfo: {
+      name?: string;
+      version?: string;
+    } | undefined;
+    stderr: string[];
+    tools: {
+      name: string;
+      title: string | undefined;
+      description: string | undefined;
+      action: string;
+      risk: Risk;
+      enabled: boolean;
+    }[];
+    /** Part of each tool's action name, `mcp.<id>.<tool>`. */
+    id: string;
+    name: string;
+    transport: "stdio" | "http";
+    command?: string;
+    args?: string[];
+    cwd?: string;
+    url?: string;
+    enabled: boolean;
+    /** Tools not offered as actions. */
+    disabledTools: string[];
+    /** Risk per tool, overriding what the server's hints suggest. */
+    risk?: Record<string, Risk>;
+    createdAt: number;
+  }[];
+  private save;
+  private check;
+  create(input: z.infer<z.ZodObject<typeof serverFields>> & {
+    id?: string;
+  }): Promise<{
+    env: {
+      [k: string]: string;
+    } | undefined;
+    headers: {
+      [k: string]: string;
+    } | undefined;
+    status: McpStatus;
+    error: string | undefined;
+    serverInfo: {
+      name?: string;
+      version?: string;
+    } | undefined;
+    stderr: string[];
+    tools: {
+      name: string;
+      title: string | undefined;
+      description: string | undefined;
+      action: string;
+      risk: Risk;
+      enabled: boolean;
+    }[];
+    /** Part of each tool's action name, `mcp.<id>.<tool>`. */
+    id: string;
+    name: string;
+    transport: "stdio" | "http";
+    command?: string;
+    args?: string[];
+    cwd?: string;
+    url?: string;
+    enabled: boolean;
+    /** Tools not offered as actions. */
+    disabledTools: string[];
+    /** Risk per tool, overriding what the server's hints suggest. */
+    risk?: Record<string, Risk>;
+    createdAt: number;
+  }>;
+  update(id: string, patch: Partial<z.infer<z.ZodObject<typeof serverFields>>>): Promise<{
+    env: {
+      [k: string]: string;
+    } | undefined;
+    headers: {
+      [k: string]: string;
+    } | undefined;
+    status: McpStatus;
+    error: string | undefined;
+    serverInfo: {
+      name?: string;
+      version?: string;
+    } | undefined;
+    stderr: string[];
+    tools: {
+      name: string;
+      title: string | undefined;
+      description: string | undefined;
+      action: string;
+      risk: Risk;
+      enabled: boolean;
+    }[];
+    /** Part of each tool's action name, `mcp.<id>.<tool>`. */
+    id: string;
+    name: string;
+    transport: "stdio" | "http";
+    command?: string;
+    args?: string[];
+    cwd?: string;
+    url?: string;
+    enabled: boolean;
+    /** Tools not offered as actions. */
+    disabledTools: string[];
+    /** Risk per tool, overriding what the server's hints suggest. */
+    risk?: Record<string, Risk>;
+    createdAt: number;
+  }>;
+  remove(id: string): Promise<{
+    deleted: string;
+  }>;
+  setTool(id: string, tool: string, patch: {
+    enabled?: boolean;
+    risk?: Risk | null;
+  }): Promise<{
+    env: {
+      [k: string]: string;
+    } | undefined;
+    headers: {
+      [k: string]: string;
+    } | undefined;
+    status: McpStatus;
+    error: string | undefined;
+    serverInfo: {
+      name?: string;
+      version?: string;
+    } | undefined;
+    stderr: string[];
+    tools: {
+      name: string;
+      title: string | undefined;
+      description: string | undefined;
+      action: string;
+      risk: Risk;
+      enabled: boolean;
+    }[];
+    /** Part of each tool's action name, `mcp.<id>.<tool>`. */
+    id: string;
+    name: string;
+    transport: "stdio" | "http";
+    command?: string;
+    args?: string[];
+    cwd?: string;
+    url?: string;
+    enabled: boolean;
+    /** Tools not offered as actions. */
+    disabledTools: string[];
+    /** Risk per tool, overriding what the server's hints suggest. */
+    risk?: Record<string, Risk>;
+    createdAt: number;
+  }>;
+  /** Connects to a server and registers its tools. */
+  start(id: string): Promise<void>;
+  stop(id: string): Promise<void>;
+  private refreshTools;
+  private unregister;
+  /** (Re)registers the enabled tools of a connected server as actions. */
+  private register;
+  private defineActions;
+}
+export { HttpOptions, HttpTransport, Mcp as default, McpCallResult, McpClient, McpTool, PROTOCOL_VERSION, StdioOptions, StdioTransport, resultText };

package/dist/index.js

@@ -0,0 +1,336 @@
+import { HttpTransport, McpClient, PROTOCOL_VERSION, StdioTransport, resultText } from "./client.js";
+import { MushinError, Service, isMasked, mask, z } from "@mushinjs/core";
+// src/index.ts
+const SERVERS = "mcp/servers";
+/** `read_file` → `readFile`, so the name fits an action name segment. */
+function actionSegment(name) {
+	const camel = name.replace(/([a-z0-9])([A-Z])/g, "$1 $2").split(/[^A-Za-z0-9]+/).filter(Boolean).map((word, index) => index ? word[0].toUpperCase() + word.slice(1).toLowerCase() : word.toLowerCase()).join("");
+	return /^[a-z]/.test(camel) ? camel : `t${camel}`;
+}
+/** Risk from the tool's hints: read-only tools read, destructive ones are dangerous, the rest write. */
+function toolRisk(tool) {
+	if (tool.annotations?.readOnlyHint) return "read";
+	if (tool.annotations?.destructiveHint) return "dangerous";
+	return "write";
+}
+const record = z.record(z.string(), z.string());
+const serverFields = {
+	name: z.string().trim().min(1).max(60),
+	transport: z.enum(["stdio", "http"]).describe("stdio runs a local command; http connects to a Streamable HTTP endpoint"),
+	command: z.string().optional().describe("stdio: the command, e.g. npx"),
+	args: z.array(z.string()).optional().describe("stdio: its arguments, e.g. [\"-y\", \"@modelcontextprotocol/server-filesystem\", \"/data\"]"),
+	env: record.optional().describe("stdio: extra environment variables, e.g. API keys"),
+	cwd: z.string().optional(),
+	url: z.string().url().optional().describe("http: the endpoint URL"),
+	headers: record.optional().describe("http: extra headers, e.g. Authorization"),
+	enabled: z.boolean().optional()
+};
+/** Connects to MCP servers and offers each of their tools as an action, so the Agent and flows can use them. */
+var Mcp = class extends Service {
+	static inject = ["actions", "storage"];
+	home;
+	servers = /* @__PURE__ */ new Map();
+	runtimes = /* @__PURE__ */ new Map();
+	disposed = false;
+	constructor(ctx) {
+		super(ctx, "mcp");
+		this.home = ctx;
+	}
+	async *[Service.init]() {
+		for (const key of await this.home.storage.list(SERVERS)) {
+			const server = await this.home.storage.get(key);
+			if (server?.id) this.servers.set(server.id, server);
+		}
+		yield* this.defineActions();
+		yield () => {
+			this.disposed = true;
+			for (const id of this.runtimes.keys()) this.stop(id).catch(() => {});
+		};
+		for (const server of this.servers.values()) if (server.enabled) this.start(server.id).catch(() => {});
+	}
+	changed() {
+		if (!this.disposed) this.home.emit("mcp/changed");
+	}
+	get(id) {
+		const server = this.servers.get(id);
+		if (!server) throw new MushinError("not_found", `No MCP server "${id}"`);
+		return server;
+	}
+	/** A server as the dashboard and the Agent see it: secrets masked, with status and tools. */
+	describe(server) {
+		const runtime = this.runtimes.get(server.id);
+		const masked = (values) => values && Object.fromEntries(Object.entries(values).map(([key, value]) => [key, mask(value)]));
+		return {
+			...server,
+			env: masked(server.env),
+			headers: masked(server.headers),
+			status: runtime?.status ?? "stopped",
+			error: runtime?.error,
+			serverInfo: runtime?.client?.server,
+			stderr: runtime?.client?.stderr.slice(-20) ?? [],
+			tools: (runtime?.tools ?? []).map((tool) => ({
+				name: tool.name,
+				title: tool.title ?? tool.annotations?.title,
+				description: tool.description,
+				action: `mcp.${server.id}.${actionSegment(tool.name)}`,
+				risk: server.risk?.[tool.name] ?? toolRisk(tool),
+				enabled: !server.disabledTools.includes(tool.name)
+			}))
+		};
+	}
+	list() {
+		return [...this.servers.values()].sort((a, b) => a.createdAt - b.createdAt).map((server) => this.describe(server));
+	}
+	async save(server) {
+		this.servers.set(server.id, server);
+		await this.home.storage.set(`${SERVERS}/${server.id}`, server);
+		this.changed();
+	}
+	check(server) {
+		if (server.transport === "stdio" && !server.command?.trim()) throw new MushinError("invalid_input", "A stdio server needs a command");
+		if (server.transport === "http" && !server.url) throw new MushinError("invalid_input", "An HTTP server needs a URL");
+	}
+	async create(input) {
+		this.check(input);
+		let id = input.id ?? actionSegment(input.name.normalize("NFKD").replace(/[^\x20-\x7e]/g, "")) ?? "server";
+		if (id === "t") id = "server";
+		if (this.servers.has(id)) {
+			if (input.id) throw new MushinError("conflict", `An MCP server with id "${id}" already exists`);
+			let n = 2;
+			while (this.servers.has(`${id}${n}`)) n++;
+			id = `${id}${n}`;
+		}
+		const server = {
+			...input,
+			id,
+			enabled: input.enabled !== false,
+			disabledTools: [],
+			createdAt: Date.now()
+		};
+		await this.save(server);
+		if (server.enabled) await this.start(id).catch(() => {});
+		return this.describe(this.get(id));
+	}
+	async update(id, patch) {
+		const current = this.get(id);
+		const merge = (next, old) => next && Object.fromEntries(Object.entries(next).map(([key, value]) => [key, isMasked(value) && old?.[key] ? old[key] : value]));
+		const server = {
+			...current,
+			...patch,
+			env: patch.env ? merge(patch.env, current.env) : current.env,
+			headers: patch.headers ? merge(patch.headers, current.headers) : current.headers
+		};
+		this.check(server);
+		await this.save(server);
+		await this.stop(id);
+		if (server.enabled) await this.start(id).catch(() => {});
+		return this.describe(this.get(id));
+	}
+	async remove(id) {
+		this.get(id);
+		await this.stop(id);
+		this.servers.delete(id);
+		this.runtimes.delete(id);
+		await this.home.storage.delete(`${SERVERS}/${id}`);
+		this.changed();
+		return { deleted: id };
+	}
+	async setTool(id, tool, patch) {
+		const server = this.get(id);
+		const next = {
+			...server,
+			disabledTools: [...server.disabledTools],
+			risk: { ...server.risk }
+		};
+		if (patch.enabled !== void 0) next.disabledTools = patch.enabled ? next.disabledTools.filter((name) => name !== tool) : [.../* @__PURE__ */ new Set([...next.disabledTools, tool])];
+		if (patch.risk === null) delete next.risk[tool];
+		else if (patch.risk) next.risk[tool] = patch.risk;
+		await this.save(next);
+		this.register(id);
+		return this.describe(next);
+	}
+	/** Connects to a server and registers its tools. */
+	async start(id) {
+		const server = this.get(id);
+		await this.stop(id);
+		const runtime = {
+			status: "connecting",
+			tools: [],
+			unregister: []
+		};
+		this.runtimes.set(id, runtime);
+		this.changed();
+		const transport = server.transport === "stdio" ? new StdioTransport({
+			command: server.command,
+			args: server.args,
+			env: server.env,
+			cwd: server.cwd
+		}) : new HttpTransport({
+			url: server.url,
+			headers: server.headers
+		});
+		const client = new McpClient(transport, {
+			onToolsChanged: () => this.refreshTools(id, runtime).catch(() => {}),
+			onClose: (error) => {
+				if (this.runtimes.get(id) !== runtime) return;
+				this.unregister(runtime);
+				runtime.status = "error";
+				runtime.error = error?.message ?? "the connection was closed";
+				this.home.logger("mcp").warn("MCP server %s stopped: %s", server.name, runtime.error);
+				this.changed();
+			}
+		});
+		runtime.client = client;
+		try {
+			await client.connect();
+			if (this.runtimes.get(id) !== runtime) return;
+			await this.refreshTools(id, runtime);
+			runtime.status = "connected";
+			runtime.error = void 0;
+			this.home.logger("mcp").info("connected to MCP server %s: %d tool(s)", server.name, runtime.tools.length);
+		} catch (error) {
+			await client.close();
+			if (this.runtimes.get(id) !== runtime) return;
+			runtime.status = "error";
+			runtime.error = error instanceof Error ? error.message : String(error);
+			this.home.logger("mcp").warn("cannot connect to MCP server %s: %s", server.name, runtime.error);
+			throw new MushinError("unavailable", `Cannot connect to ${server.name}: ${runtime.error}`);
+		} finally {
+			this.changed();
+		}
+	}
+	async stop(id) {
+		const runtime = this.runtimes.get(id);
+		if (!runtime) return;
+		this.runtimes.set(id, {
+			...runtime,
+			client: void 0,
+			status: "stopped",
+			error: void 0,
+			tools: [],
+			unregister: []
+		});
+		this.unregister(runtime);
+		await runtime.client?.close();
+		this.changed();
+	}
+	async refreshTools(id, runtime) {
+		if (!runtime.client) return;
+		runtime.tools = await runtime.client.listTools();
+		this.register(id);
+	}
+	unregister(runtime) {
+		for (const dispose of runtime.unregister.splice(0)) try {
+			dispose();
+		} catch {}
+	}
+	/** (Re)registers the enabled tools of a connected server as actions. */
+	register(id) {
+		const runtime = this.runtimes.get(id);
+		const server = this.servers.get(id);
+		if (!runtime?.client || !server || this.disposed) return;
+		this.unregister(runtime);
+		const client = runtime.client;
+		const used = /* @__PURE__ */ new Set();
+		for (const tool of runtime.tools) {
+			if (server.disabledTools.includes(tool.name)) continue;
+			let segment = actionSegment(tool.name);
+			while (used.has(segment)) segment += "2";
+			used.add(segment);
+			const schema = tool.inputSchema?.type === "object" ? tool.inputSchema : {
+				type: "object",
+				properties: {}
+			};
+			runtime.unregister.push(this.home.actions.define({
+				name: `mcp.${server.id}.${segment}`,
+				description: `[MCP ${server.name}] ${tool.description ?? tool.title ?? tool.name}`.slice(0, 1024),
+				risk: server.risk?.[tool.name] ?? toolRisk(tool),
+				input: z.record(z.string(), z.unknown()),
+				inputSchema: schema,
+				handler: async (input) => {
+					const result = await client.callTool(tool.name, input);
+					const text = resultText(result);
+					if (result.isError) throw new MushinError("failed", text || `${tool.name} failed`);
+					return {
+						text,
+						...result.structuredContent !== void 0 ? { structured: result.structuredContent } : {}
+					};
+				}
+			}));
+		}
+		this.changed();
+	}
+	*defineActions() {
+		const actions = this.home.actions;
+		const idInput = z.object({ id: z.string().describe("MCP server id from mcp.servers.list") });
+		yield actions.define({
+			name: "mcp.servers.list",
+			description: "List MCP servers with their connection status and tools. Each enabled tool of a connected server is an action named mcp.<server id>.<tool>.",
+			risk: "read",
+			input: z.object({}),
+			handler: () => this.list()
+		});
+		yield actions.define({
+			name: "mcp.servers.create",
+			description: "Add an MCP server and connect to it: a local command over stdio (e.g. npx -y @modelcontextprotocol/server-filesystem <dir>) or a Streamable HTTP URL. Its tools become actions for new Agent conversations.",
+			risk: "dangerous",
+			input: z.object({
+				...serverFields,
+				id: z.string().regex(/^[a-z][a-zA-Z0-9]{0,30}$/).optional().describe("Short id used in action names; made from the name when omitted")
+			}),
+			handler: (input) => this.create(input)
+		});
+		yield actions.define({
+			name: "mcp.servers.update",
+			description: "Change an MCP server and reconnect. Masked secrets sent back unchanged keep their stored value.",
+			risk: "dangerous",
+			input: idInput.extend({
+				name: serverFields.name.optional(),
+				transport: serverFields.transport.optional(),
+				command: serverFields.command,
+				args: serverFields.args,
+				env: serverFields.env,
+				cwd: serverFields.cwd,
+				url: serverFields.url,
+				headers: serverFields.headers,
+				enabled: serverFields.enabled
+			}),
+			handler: ({ id, ...patch }) => this.update(id, patch)
+		});
+		yield actions.define({
+			name: "mcp.servers.delete",
+			description: "Remove an MCP server and its tools.",
+			risk: "dangerous",
+			input: idInput,
+			handler: ({ id }) => this.remove(id)
+		});
+		yield actions.define({
+			name: "mcp.servers.restart",
+			description: "Reconnect to an MCP server and reload its tools.",
+			risk: "write",
+			input: idInput,
+			handler: async ({ id }) => {
+				await this.start(id);
+				return this.describe(this.get(id));
+			}
+		});
+		yield actions.define({
+			name: "mcp.tools.update",
+			description: "Turn one tool of an MCP server on or off, or set its risk (read, write, dangerous; null for the server's hint).",
+			risk: "write",
+			input: idInput.extend({
+				tool: z.string().describe("The tool name as the server gives it"),
+				enabled: z.boolean().optional(),
+				risk: z.enum([
+					"read",
+					"write",
+					"dangerous"
+				]).nullable().optional()
+			}),
+			handler: ({ id, tool, ...patch }) => this.setTool(id, tool, patch)
+		});
+	}
+};
+export { HttpTransport, Mcp, Mcp as default, McpClient, PROTOCOL_VERSION, StdioTransport, actionSegment, resultText, toolRisk };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { Context, isMasked, mask, MushinError, type Risk, Service, z } from '@mushinjs/core'\r\nimport type {} from '@mushinjs/plugin-storage'\r\nimport { HttpTransport, McpClient, type McpTool, resultText, StdioTransport } from './client'\r\n\r\nexport * from './client'\r\n\r\ndeclare module '@mushinjs/core' {\r\n  interface Context {\r\n    mcp: Mcp\r\n  }\r\n\r\n  interface Events {\r\n    'mcp/changed'(): void\r\n  }\r\n}\r\n\r\nconst SERVERS = 'mcp/servers'\r\n\r\nexport interface McpServerRecord {\r\n  /** Part of each tool's action name, `mcp.<id>.<tool>`. */\r\n  id: string\r\n  name: string\r\n  transport: 'stdio' | 'http'\r\n  command?: string\r\n  args?: string[]\r\n  env?: Record<string, string>\r\n  cwd?: string\r\n  url?: string\r\n  headers?: Record<string, string>\r\n  enabled: boolean\r\n  /** Tools not offered as actions. */\r\n  disabledTools: string[]\r\n  /** Risk per tool, overriding what the server's hints suggest. */\r\n  risk?: Record<string, Risk>\r\n  createdAt: number\r\n}\r\n\r\nexport type McpStatus = 'stopped' | 'connecting' | 'connected' | 'error'\r\n\r\ninterface Runtime {\r\n  client?: McpClient\r\n  status: McpStatus\r\n  error?: string\r\n  tools: McpTool[]\r\n  /** Removes the tool actions. */\r\n  unregister: (() => void)[]\r\n}\r\n\r\n/** `read_file` → `readFile`, so the name fits an action name segment. */\r\nexport function actionSegment(name: string) {\r\n  const words = name.replace(/([a-z0-9])([A-Z])/g, '$1 $2').split(/[^A-Za-z0-9]+/).filter(Boolean)\r\n  const camel = words.map((word, index) => (index ? word[0].toUpperCase() + word.slice(1).toLowerCase() : word.toLowerCase())).join('')\r\n  return /^[a-z]/.test(camel) ? camel : `t${camel}`\r\n}\r\n\r\n/** Risk from the tool's hints: read-only tools read, destructive ones are dangerous, the rest write. */\r\nexport function toolRisk(tool: McpTool): Risk {\r\n  if (tool.annotations?.readOnlyHint) return 'read'\r\n  if (tool.annotations?.destructiveHint) return 'dangerous'\r\n  return 'write'\r\n}\r\n\r\nconst record = z.record(z.string(), z.string())\r\n\r\nconst serverFields = {\r\n  name: z.string().trim().min(1).max(60),\r\n  transport: z.enum(['stdio', 'http']).describe('stdio runs a local command; http connects to a Streamable HTTP endpoint'),\r\n  command: z.string().optional().describe('stdio: the command, e.g. npx'),\r\n  args: z.array(z.string()).optional().describe('stdio: its arguments, e.g. [\"-y\", \"@modelcontextprotocol/server-filesystem\", \"/data\"]'),\r\n  env: record.optional().describe('stdio: extra environment variables, e.g. API keys'),\r\n  cwd: z.string().optional(),\r\n  url: z.string().url().optional().describe('http: the endpoint URL'),\r\n  headers: record.optional().describe('http: extra headers, e.g. Authorization'),\r\n  enabled: z.boolean().optional(),\r\n}\r\n\r\n/** Connects to MCP servers and offers each of their tools as an action, so the Agent and flows can use them. */\r\nexport class Mcp extends Service {\r\n  static inject = ['actions', 'storage']\r\n\r\n  private home: Context\r\n  private servers = new Map<string, McpServerRecord>()\r\n  private runtimes = new Map<string, Runtime>()\r\n  private disposed = false\r\n\r\n  constructor(ctx: Context) {\r\n    super(ctx, 'mcp')\r\n    this.home = ctx\r\n  }\r\n\r\n  async *[Service.init]() {\r\n    for (const key of await this.home.storage.list(SERVERS)) {\r\n      const server = await this.home.storage.get<McpServerRecord>(key)\r\n      if (server?.id) this.servers.set(server.id, server)\r\n    }\r\n    yield* this.defineActions()\r\n    yield () => {\r\n      this.disposed = true\r\n      for (const id of this.runtimes.keys()) this.stop(id).catch(() => {})\r\n    }\r\n    for (const server of this.servers.values()) {\r\n      if (server.enabled) this.start(server.id).catch(() => {})\r\n    }\r\n  }\r\n\r\n  private changed() {\r\n    if (!this.disposed) this.home.emit('mcp/changed')\r\n  }\r\n\r\n  get(id: string) {\r\n    const server = this.servers.get(id)\r\n    if (!server) throw new MushinError('not_found', `No MCP server \"${id}\"`)\r\n    return server\r\n  }\r\n\r\n  /** A server as the dashboard and the Agent see it: secrets masked, with status and tools. */\r\n  describe(server: McpServerRecord) {\r\n    const runtime = this.runtimes.get(server.id)\r\n    const masked = (values?: Record<string, string>) => values && Object.fromEntries(Object.entries(values).map(([key, value]) => [key, mask(value)]))\r\n    return {\r\n      ...server,\r\n      env: masked(server.env),\r\n      headers: masked(server.headers),\r\n      status: runtime?.status ?? 'stopped',\r\n      error: runtime?.error,\r\n      serverInfo: runtime?.client?.server,\r\n      stderr: runtime?.client?.stderr.slice(-20) ?? [],\r\n      tools: (runtime?.tools ?? []).map((tool) => ({\r\n        name: tool.name,\r\n        title: tool.title ?? tool.annotations?.title,\r\n        description: tool.description,\r\n        action: `mcp.${server.id}.${actionSegment(tool.name)}`,\r\n        risk: server.risk?.[tool.name] ?? toolRisk(tool),\r\n        enabled: !server.disabledTools.includes(tool.name),\r\n      })),\r\n    }\r\n  }\r\n\r\n  list() {\r\n    return [...this.servers.values()].sort((a, b) => a.createdAt - b.createdAt).map((server) => this.describe(server))\r\n  }\r\n\r\n  private async save(server: McpServerRecord) {\r\n    this.servers.set(server.id, server)\r\n    await this.home.storage.set(`${SERVERS}/${server.id}`, server)\r\n    this.changed()\r\n  }\r\n\r\n  private check(server: Pick<McpServerRecord, 'transport' | 'command' | 'url'>) {\r\n    if (server.transport === 'stdio' && !server.command?.trim()) throw new MushinError('invalid_input', 'A stdio server needs a command')\r\n    if (server.transport === 'http' && !server.url) throw new MushinError('invalid_input', 'An HTTP server needs a URL')\r\n  }\r\n\r\n  async create(input: z.infer<z.ZodObject<typeof serverFields>> & { id?: string }) {\r\n    this.check(input)\r\n    let id = input.id ?? actionSegment(input.name.normalize('NFKD').replace(/[^\\x20-\\x7e]/g, '')) ?? 'server'\r\n    if (id === 't') id = 'server'\r\n    if (this.servers.has(id)) {\r\n      if (input.id) throw new MushinError('conflict', `An MCP server with id \"${id}\" already exists`)\r\n      let n = 2\r\n      while (this.servers.has(`${id}${n}`)) n++\r\n      id = `${id}${n}`\r\n    }\r\n    const server: McpServerRecord = { ...input, id, enabled: input.enabled !== false, disabledTools: [], createdAt: Date.now() }\r\n    await this.save(server)\r\n    if (server.enabled) await this.start(id).catch(() => {})\r\n    return this.describe(this.get(id))\r\n  }\r\n\r\n  async update(id: string, patch: Partial<z.infer<z.ZodObject<typeof serverFields>>>) {\r\n    const current = this.get(id)\r\n    // Masked values come back unchanged from forms: keep the stored secret.\r\n    const merge = (next: Record<string, string> | undefined, old: Record<string, string> | undefined) => next && Object.fromEntries(Object.entries(next).map(([key, value]) => [key, isMasked(value) && old?.[key] ? old[key] : value]))\r\n    const server: McpServerRecord = {\r\n      ...current,\r\n      ...patch,\r\n      env: patch.env ? merge(patch.env, current.env) : current.env,\r\n      headers: patch.headers ? merge(patch.headers, current.headers) : current.headers,\r\n    }\r\n    this.check(server)\r\n    await this.save(server)\r\n    await this.stop(id)\r\n    if (server.enabled) await this.start(id).catch(() => {})\r\n    return this.describe(this.get(id))\r\n  }\r\n\r\n  async remove(id: string) {\r\n    this.get(id)\r\n    await this.stop(id)\r\n    this.servers.delete(id)\r\n    this.runtimes.delete(id)\r\n    await this.home.storage.delete(`${SERVERS}/${id}`)\r\n    this.changed()\r\n    return { deleted: id }\r\n  }\r\n\r\n  async setTool(id: string, tool: string, patch: { enabled?: boolean; risk?: Risk | null }) {\r\n    const server = this.get(id)\r\n    const next: McpServerRecord = { ...server, disabledTools: [...server.disabledTools], risk: { ...server.risk } }\r\n    if (patch.enabled !== undefined) {\r\n      next.disabledTools = patch.enabled ? next.disabledTools.filter((name) => name !== tool) : [...new Set([...next.disabledTools, tool])]\r\n    }\r\n    if (patch.risk === null) delete next.risk![tool]\r\n    else if (patch.risk) next.risk![tool] = patch.risk\r\n    await this.save(next)\r\n    this.register(id)\r\n    return this.describe(next)\r\n  }\r\n\r\n  /** Connects to a server and registers its tools. */\r\n  async start(id: string) {\r\n    const server = this.get(id)\r\n    await this.stop(id)\r\n    const runtime: Runtime = { status: 'connecting', tools: [], unregister: [] }\r\n    this.runtimes.set(id, runtime)\r\n    this.changed()\r\n    const transport = server.transport === 'stdio'\r\n      ? new StdioTransport({ command: server.command!, args: server.args, env: server.env, cwd: server.cwd })\r\n      : new HttpTransport({ url: server.url!, headers: server.headers })\r\n    const client = new McpClient(transport, {\r\n      onToolsChanged: () => this.refreshTools(id, runtime).catch(() => {}),\r\n      onClose: (error) => {\r\n        if (this.runtimes.get(id) !== runtime) return\r\n        this.unregister(runtime)\r\n        runtime.status = 'error'\r\n        runtime.error = error?.message ?? 'the connection was closed'\r\n        this.home.logger('mcp').warn('MCP server %s stopped: %s', server.name, runtime.error)\r\n        this.changed()\r\n      },\r\n    })\r\n    runtime.client = client\r\n    try {\r\n      await client.connect()\r\n      if (this.runtimes.get(id) !== runtime) return\r\n      await this.refreshTools(id, runtime)\r\n      runtime.status = 'connected'\r\n      runtime.error = undefined\r\n      this.home.logger('mcp').info('connected to MCP server %s: %d tool(s)', server.name, runtime.tools.length)\r\n    } catch (error) {\r\n      await client.close()\r\n      if (this.runtimes.get(id) !== runtime) return\r\n      runtime.status = 'error'\r\n      runtime.error = error instanceof Error ? error.message : String(error)\r\n      this.home.logger('mcp').warn('cannot connect to MCP server %s: %s', server.name, runtime.error)\r\n      throw new MushinError('unavailable', `Cannot connect to ${server.name}: ${runtime.error}`)\r\n    } finally {\r\n      this.changed()\r\n    }\r\n  }\r\n\r\n  async stop(id: string) {\r\n    const runtime = this.runtimes.get(id)\r\n    if (!runtime) return\r\n    this.runtimes.set(id, { ...runtime, client: undefined, status: 'stopped', error: undefined, tools: [], unregister: [] })\r\n    this.unregister(runtime)\r\n    await runtime.client?.close()\r\n    this.changed()\r\n  }\r\n\r\n  private async refreshTools(id: string, runtime: Runtime) {\r\n    if (!runtime.client) return\r\n    runtime.tools = await runtime.client.listTools()\r\n    this.register(id)\r\n  }\r\n\r\n  private unregister(runtime: Runtime) {\r\n    for (const dispose of runtime.unregister.splice(0)) {\r\n      try {\r\n        dispose()\r\n      } catch {}\r\n    }\r\n  }\r\n\r\n  /** (Re)registers the enabled tools of a connected server as actions. */\r\n  private register(id: string) {\r\n    const runtime = this.runtimes.get(id)\r\n    const server = this.servers.get(id)\r\n    if (!runtime?.client || !server || this.disposed) return\r\n    this.unregister(runtime)\r\n    const client = runtime.client\r\n    const used = new Set<string>()\r\n    for (const tool of runtime.tools) {\r\n      if (server.disabledTools.includes(tool.name)) continue\r\n      let segment = actionSegment(tool.name)\r\n      while (used.has(segment)) segment += '2'\r\n      used.add(segment)\r\n      const schema = tool.inputSchema?.type === 'object' ? tool.inputSchema : { type: 'object', properties: {} }\r\n      runtime.unregister.push(this.home.actions.define({\r\n        name: `mcp.${server.id}.${segment}`,\r\n        description: `[MCP ${server.name}] ${tool.description ?? tool.title ?? tool.name}`.slice(0, 1024),\r\n        risk: server.risk?.[tool.name] ?? toolRisk(tool),\r\n        input: z.record(z.string(), z.unknown()),\r\n        inputSchema: schema,\r\n        handler: async (input) => {\r\n          const result = await client.callTool(tool.name, input)\r\n          const text = resultText(result)\r\n          if (result.isError) throw new MushinError('failed', text || `${tool.name} failed`)\r\n          return { text, ...(result.structuredContent !== undefined ? { structured: result.structuredContent } : {}) }\r\n        },\r\n      }))\r\n    }\r\n    this.changed()\r\n  }\r\n\r\n  private *defineActions() {\r\n    const actions = this.home.actions\r\n    const idInput = z.object({ id: z.string().describe('MCP server id from mcp.servers.list') })\r\n\r\n    yield actions.define({\r\n      name: 'mcp.servers.list',\r\n      description: 'List MCP servers with their connection status and tools. Each enabled tool of a connected server is an action named mcp.<server id>.<tool>.',\r\n      risk: 'read',\r\n      input: z.object({}),\r\n      handler: () => this.list(),\r\n    })\r\n\r\n    yield actions.define({\r\n      name: 'mcp.servers.create',\r\n      description: 'Add an MCP server and connect to it: a local command over stdio (e.g. npx -y @modelcontextprotocol/server-filesystem <dir>) or a Streamable HTTP URL. Its tools become actions for new Agent conversations.',\r\n      risk: 'dangerous',\r\n      input: z.object({ ...serverFields, id: z.string().regex(/^[a-z][a-zA-Z0-9]{0,30}$/).optional().describe('Short id used in action names; made from the name when omitted') }),\r\n      handler: (input) => this.create(input),\r\n    })\r\n\r\n    yield actions.define({\r\n      name: 'mcp.servers.update',\r\n      description: 'Change an MCP server and reconnect. Masked secrets sent back unchanged keep their stored value.',\r\n      risk: 'dangerous',\r\n      input: idInput.extend({\r\n        name: serverFields.name.optional(),\r\n        transport: serverFields.transport.optional(),\r\n        command: serverFields.command,\r\n        args: serverFields.args,\r\n        env: serverFields.env,\r\n        cwd: serverFields.cwd,\r\n        url: serverFields.url,\r\n        headers: serverFields.headers,\r\n        enabled: serverFields.enabled,\r\n      }),\r\n      handler: ({ id, ...patch }) => this.update(id, patch),\r\n    })\r\n\r\n    yield actions.define({\r\n      name: 'mcp.servers.delete',\r\n      description: 'Remove an MCP server and its tools.',\r\n      risk: 'dangerous',\r\n      input: idInput,\r\n      handler: ({ id }) => this.remove(id),\r\n    })\r\n\r\n    yield actions.define({\r\n      name: 'mcp.servers.restart',\r\n      description: 'Reconnect to an MCP server and reload its tools.',\r\n      risk: 'write',\r\n      input: idInput,\r\n      handler: async ({ id }) => {\r\n        await this.start(id)\r\n        return this.describe(this.get(id))\r\n      },\r\n    })\r\n\r\n    yield actions.define({\r\n      name: 'mcp.tools.update',\r\n      description: 'Turn one tool of an MCP server on or off, or set its risk (read, write, dangerous; null for the server\\'s hint).',\r\n      risk: 'write',\r\n      input: idInput.extend({\r\n        tool: z.string().describe('The tool name as the server gives it'),\r\n        enabled: z.boolean().optional(),\r\n        risk: z.enum(['read', 'write', 'dangerous']).nullable().optional(),\r\n      }),\r\n      handler: ({ id, tool, ...patch }) => this.setTool(id, tool, patch),\r\n    })\r\n  }\r\n}\r\n\r\nexport default Mcp\r\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,53 @@
 {
   "name": "@mushinjs/plugin-mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0-next.20261112165327",
+  "description": "Connects to MCP servers and offers their tools as actions for the Agent and flows",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mushinjs/mushin.git",
+    "directory": "packages/plugin-mcp"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "mushin-plugin"
+  ],
+  "mushin": {
+    "kind": "app",
+    "category": "ai",
+    "displayName": {
+      "en": "MCP",
+      "zh-CN": "MCP 工具"
+    },
+    "description": {
+      "en": "Connect MCP servers (a local command over stdio, or Streamable HTTP); each of their tools becomes an action the Agent can use",
+      "zh-CN": "接入 MCP 服务器（本地命令 stdio 或 Streamable HTTP），它们的每个工具都成为智能体可以使用的操作"
+    },
+    "provides": [
+      "mcp"
+    ],
+    "requires": {
+      "mushin": ">=0.1.0",
+      "plugins": {
+        "@mushinjs/plugin-storage": "*"
+      }
+    }
+  },
+  "dependencies": {
+    "@mushinjs/core": "0.2.0-next.20261112165327",
+    "@mushinjs/plugin-storage": "0.2.0-next.20261112165327"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.