mcp-playbook 0.1.0

package/dist/server/connector.js

@@ -0,0 +1,142 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/server/connector.ts
+var connector_exports = {};
+__export(connector_exports, {
+  discoverAllServers: () => discoverAllServers,
+  executeTool: () => executeTool
+});
+module.exports = __toCommonJS(connector_exports);
+var import_client = require("@modelcontextprotocol/sdk/client/index.js");
+var import_stdio = require("@modelcontextprotocol/sdk/client/stdio.js");
+var import_sse = require("@modelcontextprotocol/sdk/client/sse.js");
+var import_streamableHttp = require("@modelcontextprotocol/sdk/client/streamableHttp.js");
+async function discoverAllServers(servers, extraExamples = {}, tags = {}) {
+  const toolTagMap = {};
+  for (const [tag, tools] of Object.entries(tags)) {
+    for (const tool of tools) {
+      if (!toolTagMap[tool]) toolTagMap[tool] = [];
+      toolTagMap[tool].push(tag);
+    }
+  }
+  const results = await Promise.allSettled(
+    servers.map(
+      (server, i) => connectToServer(server, i, extraExamples, toolTagMap)
+    )
+  );
+  return results.map((result, i) => {
+    if (result.status === "fulfilled") {
+      return result.value;
+    } else {
+      return {
+        id: `server-${i}`,
+        name: servers[i].name,
+        url: servers[i].url || `${servers[i].command} ${(servers[i].args || []).join(" ")}`,
+        status: "error",
+        version: "unknown",
+        tools: [],
+        error: result.reason?.message || "Connection failed"
+      };
+    }
+  });
+}
+async function connectToServer(config, index, extraExamples, toolTagMap) {
+  const client = new import_client.Client(
+    { name: "mcp-playbook", version: "0.1.0" },
+    { capabilities: {} }
+  );
+  let transport;
+  if (config.transport === "stdio") {
+    if (!config.command) throw new Error(`Server "${config.name}" needs a command for stdio transport`);
+    transport = new import_stdio.StdioClientTransport({
+      command: config.command,
+      args: config.args || [],
+      env: config.env || {},
+      cwd: config.cwd || process.cwd()
+    });
+  } else if (config.transport === "http") {
+    if (!config.url) throw new Error(`Server "${config.name}" needs a url for http transport`);
+    transport = new import_streamableHttp.StreamableHTTPClientTransport(new URL(config.url), {
+      requestInit: { headers: config.headers || {} }
+    });
+  } else if (config.transport === "sse") {
+    if (!config.url) throw new Error(`Server "${config.name}" needs a url for sse transport`);
+    transport = new import_sse.SSEClientTransport(new URL(config.url), {
+      requestInit: { headers: config.headers || {} }
+    });
+  } else {
+    throw new Error(`Unknown transport: ${config.transport}`);
+  }
+  await client.connect(transport);
+  const { tools } = await client.listTools();
+  const serverInfo = client.getServerVersion();
+  const discoveredTools = tools.map((tool) => ({
+    name: tool.name,
+    description: tool.description || "",
+    inputSchema: tool.inputSchema,
+    examples: extraExamples[tool.name] || [],
+    tags: toolTagMap[tool.name] || []
+  }));
+  return {
+    id: `server-${index}`,
+    name: config.name,
+    url: config.url || `${config.command} ${(config.args || []).join(" ")}`,
+    status: "connected",
+    version: serverInfo?.version || "1.0.0",
+    tools: discoveredTools
+  };
+}
+async function executeTool(serverConfig, toolName, input) {
+  const start = Date.now();
+  try {
+    const client = new import_client.Client(
+      { name: "mcp-playbook", version: "0.1.0" },
+      { capabilities: {} }
+    );
+    let transport;
+    if (serverConfig.transport === "stdio") {
+      transport = new import_stdio.StdioClientTransport({
+        command: serverConfig.command,
+        args: serverConfig.args || []
+      });
+    } else {
+      transport = new import_streamableHttp.StreamableHTTPClientTransport(new URL(serverConfig.url));
+    }
+    await client.connect(transport);
+    const result = await client.callTool({ name: toolName, arguments: input });
+    await client.close();
+    return {
+      result,
+      duration_ms: Date.now() - start
+    };
+  } catch (err) {
+    return {
+      result: null,
+      duration_ms: Date.now() - start,
+      error: err.message
+    };
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  discoverAllServers,
+  executeTool
+});
+//# sourceMappingURL=connector.js.map

package/dist/server/connector.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/server/connector.ts"],"sourcesContent":["/**\n * src/server/connector.ts\n *\n * Connects to MCP servers and discovers their tools.\n * This is the bridge between the user's MCP servers and\n * the Playbook UI.\n *\n * Supports:\n *   - stdio transport (spawn a process, talk over stdin/stdout)\n *   - HTTP / SSE transport (connect to a running server)\n *\n * Returns a unified DiscoveredServer[] with all tool schemas.\n */\n\nimport { Client } from '@modelcontextprotocol/sdk/client/index.js'\nimport { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js'\nimport { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js'\nimport { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js'\nimport type { ServerConfig, ToolExample } from '../config.js'\n\nexport interface DiscoveredTool {\n  name:        string\n  description: string\n  inputSchema: Record<string, unknown>\n  examples:    ToolExample[]\n  tags:        string[]\n}\n\nexport interface DiscoveredServer {\n  id:       string\n  name:     string\n  url:      string\n  status:   'connected' | 'disconnected' | 'error'\n  version:  string\n  tools:    DiscoveredTool[]\n  error?:   string\n}\n\n/**\n * Connect to all configured servers and discover their tools.\n * Runs all connections in parallel — slow servers don't block fast ones.\n */\nexport async function discoverAllServers(\n  servers: ServerConfig[],\n  extraExamples: Record<string, ToolExample[]> = {},\n  tags: Record<string, string[]> = {}\n): Promise<DiscoveredServer[]> {\n\n  // Build a reverse lookup: tool name → tag names\n  const toolTagMap: Record<string, string[]> = {}\n  for (const [tag, tools] of Object.entries(tags)) {\n    for (const tool of tools) {\n      if (!toolTagMap[tool]) toolTagMap[tool] = []\n      toolTagMap[tool].push(tag)\n    }\n  }\n\n  // Connect to all servers in parallel\n  const results = await Promise.allSettled(\n    servers.map((server, i) =>\n      connectToServer(server, i, extraExamples, toolTagMap)\n    )\n  )\n\n  return results.map((result, i) => {\n    if (result.status === 'fulfilled') {\n      return result.value\n    } else {\n      return {\n        id:      `server-${i}`,\n        name:    servers[i].name,\n        url:     servers[i].url || `${servers[i].command} ${(servers[i].args || []).join(' ')}`,\n        status:  'error' as const,\n        version: 'unknown',\n        tools:   [],\n        error:   result.reason?.message || 'Connection failed'\n      }\n    }\n  })\n}\n\nasync function connectToServer(\n  config: ServerConfig,\n  index: number,\n  extraExamples: Record<string, ToolExample[]>,\n  toolTagMap: Record<string, string[]>\n): Promise<DiscoveredServer> {\n\n  const client = new Client(\n    { name: 'mcp-playbook', version: '0.1.0' },\n    { capabilities: {} }\n  )\n\n  // Create the right transport based on config\n  let transport\n\n  if (config.transport === 'stdio') {\n    if (!config.command) throw new Error(`Server \"${config.name}\" needs a command for stdio transport`)\n    transport = new StdioClientTransport({\n      command: config.command,\n      args:    config.args    || [],\n      env:     config.env     || {},\n      cwd:     config.cwd     || process.cwd()\n    })\n  } else if (config.transport === 'http') {\n    if (!config.url) throw new Error(`Server \"${config.name}\" needs a url for http transport`)\n    transport = new StreamableHTTPClientTransport(new URL(config.url), {\n      requestInit: { headers: config.headers || {} }\n    })\n  } else if (config.transport === 'sse') {\n    if (!config.url) throw new Error(`Server \"${config.name}\" needs a url for sse transport`)\n    transport = new SSEClientTransport(new URL(config.url), {\n      requestInit: { headers: config.headers || {} }\n    })\n  } else {\n    throw new Error(`Unknown transport: ${(config as any).transport}`)\n  }\n\n  await client.connect(transport)\n\n  // Fetch tools from the server\n  const { tools } = await client.listTools()\n\n  // Fetch server info if available\n  const serverInfo = client.getServerVersion()\n\n  // Map tools to our format\n  const discoveredTools: DiscoveredTool[] = tools.map(tool => ({\n    name:        tool.name,\n    description: tool.description || '',\n    inputSchema: tool.inputSchema as Record<string, unknown>,\n    examples:    extraExamples[tool.name] || [],\n    tags:        toolTagMap[tool.name]    || []\n  }))\n\n  return {\n    id:      `server-${index}`,\n    name:    config.name,\n    url:     config.url || `${config.command} ${(config.args || []).join(' ')}`,\n    status:  'connected',\n    version: serverInfo?.version || '1.0.0',\n    tools:   discoveredTools\n  }\n}\n\n/**\n * Execute a tool call against a specific server.\n * Used by the Try tab in the UI.\n */\nexport async function executeTool(\n  serverConfig: ServerConfig,\n  toolName: string,\n  input: Record<string, unknown>\n): Promise<{ result: unknown; duration_ms: number; error?: string }> {\n\n  const start = Date.now()\n\n  try {\n    const client = new Client(\n      { name: 'mcp-playbook', version: '0.1.0' },\n      { capabilities: {} }\n    )\n\n    let transport\n    if (serverConfig.transport === 'stdio') {\n      transport = new StdioClientTransport({\n        command: serverConfig.command!,\n        args:    serverConfig.args || [],\n      })\n    } else {\n      transport = new StreamableHTTPClientTransport(new URL(serverConfig.url!))\n    }\n\n    await client.connect(transport)\n\n    const result = await client.callTool({ name: toolName, arguments: input })\n    await client.close()\n\n    return {\n      result,\n      duration_ms: Date.now() - start\n    }\n  } catch (err: any) {\n    return {\n      result:      null,\n      duration_ms: Date.now() - start,\n      error:       err.message\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/server/connector.mjs

@@ -0,0 +1,116 @@
+// src/server/connector.ts
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+async function discoverAllServers(servers, extraExamples = {}, tags = {}) {
+  const toolTagMap = {};
+  for (const [tag, tools] of Object.entries(tags)) {
+    for (const tool of tools) {
+      if (!toolTagMap[tool]) toolTagMap[tool] = [];
+      toolTagMap[tool].push(tag);
+    }
+  }
+  const results = await Promise.allSettled(
+    servers.map(
+      (server, i) => connectToServer(server, i, extraExamples, toolTagMap)
+    )
+  );
+  return results.map((result, i) => {
+    if (result.status === "fulfilled") {
+      return result.value;
+    } else {
+      return {
+        id: `server-${i}`,
+        name: servers[i].name,
+        url: servers[i].url || `${servers[i].command} ${(servers[i].args || []).join(" ")}`,
+        status: "error",
+        version: "unknown",
+        tools: [],
+        error: result.reason?.message || "Connection failed"
+      };
+    }
+  });
+}
+async function connectToServer(config, index, extraExamples, toolTagMap) {
+  const client = new Client(
+    { name: "mcp-playbook", version: "0.1.0" },
+    { capabilities: {} }
+  );
+  let transport;
+  if (config.transport === "stdio") {
+    if (!config.command) throw new Error(`Server "${config.name}" needs a command for stdio transport`);
+    transport = new StdioClientTransport({
+      command: config.command,
+      args: config.args || [],
+      env: config.env || {},
+      cwd: config.cwd || process.cwd()
+    });
+  } else if (config.transport === "http") {
+    if (!config.url) throw new Error(`Server "${config.name}" needs a url for http transport`);
+    transport = new StreamableHTTPClientTransport(new URL(config.url), {
+      requestInit: { headers: config.headers || {} }
+    });
+  } else if (config.transport === "sse") {
+    if (!config.url) throw new Error(`Server "${config.name}" needs a url for sse transport`);
+    transport = new SSEClientTransport(new URL(config.url), {
+      requestInit: { headers: config.headers || {} }
+    });
+  } else {
+    throw new Error(`Unknown transport: ${config.transport}`);
+  }
+  await client.connect(transport);
+  const { tools } = await client.listTools();
+  const serverInfo = client.getServerVersion();
+  const discoveredTools = tools.map((tool) => ({
+    name: tool.name,
+    description: tool.description || "",
+    inputSchema: tool.inputSchema,
+    examples: extraExamples[tool.name] || [],
+    tags: toolTagMap[tool.name] || []
+  }));
+  return {
+    id: `server-${index}`,
+    name: config.name,
+    url: config.url || `${config.command} ${(config.args || []).join(" ")}`,
+    status: "connected",
+    version: serverInfo?.version || "1.0.0",
+    tools: discoveredTools
+  };
+}
+async function executeTool(serverConfig, toolName, input) {
+  const start = Date.now();
+  try {
+    const client = new Client(
+      { name: "mcp-playbook", version: "0.1.0" },
+      { capabilities: {} }
+    );
+    let transport;
+    if (serverConfig.transport === "stdio") {
+      transport = new StdioClientTransport({
+        command: serverConfig.command,
+        args: serverConfig.args || []
+      });
+    } else {
+      transport = new StreamableHTTPClientTransport(new URL(serverConfig.url));
+    }
+    await client.connect(transport);
+    const result = await client.callTool({ name: toolName, arguments: input });
+    await client.close();
+    return {
+      result,
+      duration_ms: Date.now() - start
+    };
+  } catch (err) {
+    return {
+      result: null,
+      duration_ms: Date.now() - start,
+      error: err.message
+    };
+  }
+}
+export {
+  discoverAllServers,
+  executeTool
+};
+//# sourceMappingURL=connector.mjs.map

package/dist/server/connector.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/server/connector.ts"],"sourcesContent":["/**\n * src/server/connector.ts\n *\n * Connects to MCP servers and discovers their tools.\n * This is the bridge between the user's MCP servers and\n * the Playbook UI.\n *\n * Supports:\n *   - stdio transport (spawn a process, talk over stdin/stdout)\n *   - HTTP / SSE transport (connect to a running server)\n *\n * Returns a unified DiscoveredServer[] with all tool schemas.\n */\n\nimport { Client } from '@modelcontextprotocol/sdk/client/index.js'\nimport { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js'\nimport { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js'\nimport { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js'\nimport type { ServerConfig, ToolExample } from '../config.js'\n\nexport interface DiscoveredTool {\n  name:        string\n  description: string\n  inputSchema: Record<string, unknown>\n  examples:    ToolExample[]\n  tags:        string[]\n}\n\nexport interface DiscoveredServer {\n  id:       string\n  name:     string\n  url:      string\n  status:   'connected' | 'disconnected' | 'error'\n  version:  string\n  tools:    DiscoveredTool[]\n  error?:   string\n}\n\n/**\n * Connect to all configured servers and discover their tools.\n * Runs all connections in parallel — slow servers don't block fast ones.\n */\nexport async function discoverAllServers(\n  servers: ServerConfig[],\n  extraExamples: Record<string, ToolExample[]> = {},\n  tags: Record<string, string[]> = {}\n): Promise<DiscoveredServer[]> {\n\n  // Build a reverse lookup: tool name → tag names\n  const toolTagMap: Record<string, string[]> = {}\n  for (const [tag, tools] of Object.entries(tags)) {\n    for (const tool of tools) {\n      if (!toolTagMap[tool]) toolTagMap[tool] = []\n      toolTagMap[tool].push(tag)\n    }\n  }\n\n  // Connect to all servers in parallel\n  const results = await Promise.allSettled(\n    servers.map((server, i) =>\n      connectToServer(server, i, extraExamples, toolTagMap)\n    )\n  )\n\n  return results.map((result, i) => {\n    if (result.status === 'fulfilled') {\n      return result.value\n    } else {\n      return {\n        id:      `server-${i}`,\n        name:    servers[i].name,\n        url:     servers[i].url || `${servers[i].command} ${(servers[i].args || []).join(' ')}`,\n        status:  'error' as const,\n        version: 'unknown',\n        tools:   [],\n        error:   result.reason?.message || 'Connection failed'\n      }\n    }\n  })\n}\n\nasync function connectToServer(\n  config: ServerConfig,\n  index: number,\n  extraExamples: Record<string, ToolExample[]>,\n  toolTagMap: Record<string, string[]>\n): Promise<DiscoveredServer> {\n\n  const client = new Client(\n    { name: 'mcp-playbook', version: '0.1.0' },\n    { capabilities: {} }\n  )\n\n  // Create the right transport based on config\n  let transport\n\n  if (config.transport === 'stdio') {\n    if (!config.command) throw new Error(`Server \"${config.name}\" needs a command for stdio transport`)\n    transport = new StdioClientTransport({\n      command: config.command,\n      args:    config.args    || [],\n      env:     config.env     || {},\n      cwd:     config.cwd     || process.cwd()\n    })\n  } else if (config.transport === 'http') {\n    if (!config.url) throw new Error(`Server \"${config.name}\" needs a url for http transport`)\n    transport = new StreamableHTTPClientTransport(new URL(config.url), {\n      requestInit: { headers: config.headers || {} }\n    })\n  } else if (config.transport === 'sse') {\n    if (!config.url) throw new Error(`Server \"${config.name}\" needs a url for sse transport`)\n    transport = new SSEClientTransport(new URL(config.url), {\n      requestInit: { headers: config.headers || {} }\n    })\n  } else {\n    throw new Error(`Unknown transport: ${(config as any).transport}`)\n  }\n\n  await client.connect(transport)\n\n  // Fetch tools from the server\n  const { tools } = await client.listTools()\n\n  // Fetch server info if available\n  const serverInfo = client.getServerVersion()\n\n  // Map tools to our format\n  const discoveredTools: DiscoveredTool[] = tools.map(tool => ({\n    name:        tool.name,\n    description: tool.description || '',\n    inputSchema: tool.inputSchema as Record<string, unknown>,\n    examples:    extraExamples[tool.name] || [],\n    tags:        toolTagMap[tool.name]    || []\n  }))\n\n  return {\n    id:      `server-${index}`,\n    name:    config.name,\n    url:     config.url || `${config.command} ${(config.args || []).join(' ')}`,\n    status:  'connected',\n    version: serverInfo?.version || '1.0.0',\n    tools:   discoveredTools\n  }\n}\n\n/**\n * Execute a tool call against a specific server.\n * Used by the Try tab in the UI.\n */\nexport async function executeTool(\n  serverConfig: ServerConfig,\n  toolName: string,\n  input: Record<string, unknown>\n): Promise<{ result: unknown; duration_ms: number; error?: string }> {\n\n  const start = Date.now()\n\n  try {\n    const client = new Client(\n      { name: 'mcp-playbook', version: '0.1.0' },\n      { capabilities: {} }\n    )\n\n    let transport\n    if (serverConfig.transport === 'stdio') {\n      transport = new StdioClientTransport({\n        command: serverConfig.command!,\n        args:    serverConfig.args || [],\n      })\n    } else {\n      transport = new StreamableHTTPClientTransport(new URL(serverConfig.url!))\n    }\n\n    await client.connect(transport)\n\n    const result = await client.callTool({ name: toolName, arguments: input })\n    await client.close()\n\n    return {\n      result,\n      duration_ms: Date.now() - start\n    }\n  } catch (err: any) {\n    return {\n      result:      null,\n      duration_ms: Date.now() - start,\n      error:       err.message\n    }\n  }\n}\n"],"mappings":";AAcA,SAAS,cAAc;AACvB,SAAS,4BAA4B;AACrC,SAAS,0BAA0B;AACnC,SAAS,qCAAqC;AAyB9C,eAAsB,mBACpB,SACA,gBAA+C,CAAC,GAChD,OAAiC,CAAC,GACL;AAG7B,QAAM,aAAuC,CAAC;AAC9C,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,IAAI,GAAG;AAC/C,eAAW,QAAQ,OAAO;AACxB,UAAI,CAAC,WAAW,IAAI,EAAG,YAAW,IAAI,IAAI,CAAC;AAC3C,iBAAW,IAAI,EAAE,KAAK,GAAG;AAAA,IAC3B;AAAA,EACF;AAGA,QAAM,UAAU,MAAM,QAAQ;AAAA,IAC5B,QAAQ;AAAA,MAAI,CAAC,QAAQ,MACnB,gBAAgB,QAAQ,GAAG,eAAe,UAAU;AAAA,IACtD;AAAA,EACF;AAEA,SAAO,QAAQ,IAAI,CAAC,QAAQ,MAAM;AAChC,QAAI,OAAO,WAAW,aAAa;AACjC,aAAO,OAAO;AAAA,IAChB,OAAO;AACL,aAAO;AAAA,QACL,IAAS,UAAU,CAAC;AAAA,QACpB,MAAS,QAAQ,CAAC,EAAE;AAAA,QACpB,KAAS,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC,EAAE,OAAO,KAAK,QAAQ,CAAC,EAAE,QAAQ,CAAC,GAAG,KAAK,GAAG,CAAC;AAAA,QACrF,QAAS;AAAA,QACT,SAAS;AAAA,QACT,OAAS,CAAC;AAAA,QACV,OAAS,OAAO,QAAQ,WAAW;AAAA,MACrC;AAAA,IACF;AAAA,EACF,CAAC;AACH;AAEA,eAAe,gBACb,QACA,OACA,eACA,YAC2B;AAE3B,QAAM,SAAS,IAAI;AAAA,IACjB,EAAE,MAAM,gBAAgB,SAAS,QAAQ;AAAA,IACzC,EAAE,cAAc,CAAC,EAAE;AAAA,EACrB;AAGA,MAAI;AAEJ,MAAI,OAAO,cAAc,SAAS;AAChC,QAAI,CAAC,OAAO,QAAS,OAAM,IAAI,MAAM,WAAW,OAAO,IAAI,uCAAuC;AAClG,gBAAY,IAAI,qBAAqB;AAAA,MACnC,SAAS,OAAO;AAAA,MAChB,MAAS,OAAO,QAAW,CAAC;AAAA,MAC5B,KAAS,OAAO,OAAW,CAAC;AAAA,MAC5B,KAAS,OAAO,OAAW,QAAQ,IAAI;AAAA,IACzC,CAAC;AAAA,EACH,WAAW,OAAO,cAAc,QAAQ;AACtC,QAAI,CAAC,OAAO,IAAK,OAAM,IAAI,MAAM,WAAW,OAAO,IAAI,kCAAkC;AACzF,gBAAY,IAAI,8BAA8B,IAAI,IAAI,OAAO,GAAG,GAAG;AAAA,MACjE,aAAa,EAAE,SAAS,OAAO,WAAW,CAAC,EAAE;AAAA,IAC/C,CAAC;AAAA,EACH,WAAW,OAAO,cAAc,OAAO;AACrC,QAAI,CAAC,OAAO,IAAK,OAAM,IAAI,MAAM,WAAW,OAAO,IAAI,iCAAiC;AACxF,gBAAY,IAAI,mBAAmB,IAAI,IAAI,OAAO,GAAG,GAAG;AAAA,MACtD,aAAa,EAAE,SAAS,OAAO,WAAW,CAAC,EAAE;AAAA,IAC/C,CAAC;AAAA,EACH,OAAO;AACL,UAAM,IAAI,MAAM,sBAAuB,OAAe,SAAS,EAAE;AAAA,EACnE;AAEA,QAAM,OAAO,QAAQ,SAAS;AAG9B,QAAM,EAAE,MAAM,IAAI,MAAM,OAAO,UAAU;AAGzC,QAAM,aAAa,OAAO,iBAAiB;AAG3C,QAAM,kBAAoC,MAAM,IAAI,WAAS;AAAA,IAC3D,MAAa,KAAK;AAAA,IAClB,aAAa,KAAK,eAAe;AAAA,IACjC,aAAa,KAAK;AAAA,IAClB,UAAa,cAAc,KAAK,IAAI,KAAK,CAAC;AAAA,IAC1C,MAAa,WAAW,KAAK,IAAI,KAAQ,CAAC;AAAA,EAC5C,EAAE;AAEF,SAAO;AAAA,IACL,IAAS,UAAU,KAAK;AAAA,IACxB,MAAS,OAAO;AAAA,IAChB,KAAS,OAAO,OAAO,GAAG,OAAO,OAAO,KAAK,OAAO,QAAQ,CAAC,GAAG,KAAK,GAAG,CAAC;AAAA,IACzE,QAAS;AAAA,IACT,SAAS,YAAY,WAAW;AAAA,IAChC,OAAS;AAAA,EACX;AACF;AAMA,eAAsB,YACpB,cACA,UACA,OACmE;AAEnE,QAAM,QAAQ,KAAK,IAAI;AAEvB,MAAI;AACF,UAAM,SAAS,IAAI;AAAA,MACjB,EAAE,MAAM,gBAAgB,SAAS,QAAQ;AAAA,MACzC,EAAE,cAAc,CAAC,EAAE;AAAA,IACrB;AAEA,QAAI;AACJ,QAAI,aAAa,cAAc,SAAS;AACtC,kBAAY,IAAI,qBAAqB;AAAA,QACnC,SAAS,aAAa;AAAA,QACtB,MAAS,aAAa,QAAQ,CAAC;AAAA,MACjC,CAAC;AAAA,IACH,OAAO;AACL,kBAAY,IAAI,8BAA8B,IAAI,IAAI,aAAa,GAAI,CAAC;AAAA,IAC1E;AAEA,UAAM,OAAO,QAAQ,SAAS;AAE9B,UAAM,SAAS,MAAM,OAAO,SAAS,EAAE,MAAM,UAAU,WAAW,MAAM,CAAC;AACzE,UAAM,OAAO,MAAM;AAEnB,WAAO;AAAA,MACL;AAAA,MACA,aAAa,KAAK,IAAI,IAAI;AAAA,IAC5B;AAAA,EACF,SAAS,KAAU;AACjB,WAAO;AAAA,MACL,QAAa;AAAA,MACb,aAAa,KAAK,IAAI,IAAI;AAAA,MAC1B,OAAa,IAAI;AAAA,IACnB;AAAA,EACF;AACF;","names":[]}

package/dist/server/dev-server.d.mts

@@ -0,0 +1,16 @@
+import * as http from 'http';
+
+/**
+ * src/server/dev-server.ts
+ *
+ * The development server.
+ * Serves the React UI + REST API + WebSocket hot reload.
+ */
+interface DevServerOptions {
+    port: number;
+    configPath: string;
+    open: boolean;
+}
+declare function startDevServer(options: DevServerOptions): Promise<http.Server<typeof http.IncomingMessage, typeof http.ServerResponse>>;
+
+export { startDevServer };

package/dist/server/dev-server.d.ts

@@ -0,0 +1,16 @@
+import * as http from 'http';
+
+/**
+ * src/server/dev-server.ts
+ *
+ * The development server.
+ * Serves the React UI + REST API + WebSocket hot reload.
+ */
+interface DevServerOptions {
+    port: number;
+    configPath: string;
+    open: boolean;
+}
+declare function startDevServer(options: DevServerOptions): Promise<http.Server<typeof http.IncomingMessage, typeof http.ServerResponse>>;
+
+export { startDevServer };

package/dist/server/dev-server.js

@@ -0,0 +1,315 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/server/dev-server.ts
+var dev_server_exports = {};
+__export(dev_server_exports, {
+  startDevServer: () => startDevServer
+});
+module.exports = __toCommonJS(dev_server_exports);
+var import_express = __toESM(require("express"));
+var import_http = require("http");
+var import_ws = require("ws");
+var import_path = __toESM(require("path"));
+var import_fs = __toESM(require("fs"));
+var import_chalk = __toESM(require("chalk"));
+var import_chokidar = __toESM(require("chokidar"));
+var import_open = __toESM(require("open"));
+
+// src/server/connector.ts
+var import_client = require("@modelcontextprotocol/sdk/client/index.js");
+var import_stdio = require("@modelcontextprotocol/sdk/client/stdio.js");
+var import_sse = require("@modelcontextprotocol/sdk/client/sse.js");
+var import_streamableHttp = require("@modelcontextprotocol/sdk/client/streamableHttp.js");
+async function discoverAllServers(servers, extraExamples = {}, tags = {}) {
+  const toolTagMap = {};
+  for (const [tag, tools] of Object.entries(tags)) {
+    for (const tool of tools) {
+      if (!toolTagMap[tool]) toolTagMap[tool] = [];
+      toolTagMap[tool].push(tag);
+    }
+  }
+  const results = await Promise.allSettled(
+    servers.map(
+      (server, i) => connectToServer(server, i, extraExamples, toolTagMap)
+    )
+  );
+  return results.map((result, i) => {
+    if (result.status === "fulfilled") {
+      return result.value;
+    } else {
+      return {
+        id: `server-${i}`,
+        name: servers[i].name,
+        url: servers[i].url || `${servers[i].command} ${(servers[i].args || []).join(" ")}`,
+        status: "error",
+        version: "unknown",
+        tools: [],
+        error: result.reason?.message || "Connection failed"
+      };
+    }
+  });
+}
+async function connectToServer(config, index, extraExamples, toolTagMap) {
+  const client = new import_client.Client(
+    { name: "mcp-playbook", version: "0.1.0" },
+    { capabilities: {} }
+  );
+  let transport;
+  if (config.transport === "stdio") {
+    if (!config.command) throw new Error(`Server "${config.name}" needs a command for stdio transport`);
+    transport = new import_stdio.StdioClientTransport({
+      command: config.command,
+      args: config.args || [],
+      env: config.env || {},
+      cwd: config.cwd || process.cwd()
+    });
+  } else if (config.transport === "http") {
+    if (!config.url) throw new Error(`Server "${config.name}" needs a url for http transport`);
+    transport = new import_streamableHttp.StreamableHTTPClientTransport(new URL(config.url), {
+      requestInit: { headers: config.headers || {} }
+    });
+  } else if (config.transport === "sse") {
+    if (!config.url) throw new Error(`Server "${config.name}" needs a url for sse transport`);
+    transport = new import_sse.SSEClientTransport(new URL(config.url), {
+      requestInit: { headers: config.headers || {} }
+    });
+  } else {
+    throw new Error(`Unknown transport: ${config.transport}`);
+  }
+  await client.connect(transport);
+  const { tools } = await client.listTools();
+  const serverInfo = client.getServerVersion();
+  const discoveredTools = tools.map((tool) => ({
+    name: tool.name,
+    description: tool.description || "",
+    inputSchema: tool.inputSchema,
+    examples: extraExamples[tool.name] || [],
+    tags: toolTagMap[tool.name] || []
+  }));
+  return {
+    id: `server-${index}`,
+    name: config.name,
+    url: config.url || `${config.command} ${(config.args || []).join(" ")}`,
+    status: "connected",
+    version: serverInfo?.version || "1.0.0",
+    tools: discoveredTools
+  };
+}
+async function executeTool(serverConfig, toolName, input) {
+  const start = Date.now();
+  try {
+    const client = new import_client.Client(
+      { name: "mcp-playbook", version: "0.1.0" },
+      { capabilities: {} }
+    );
+    let transport;
+    if (serverConfig.transport === "stdio") {
+      transport = new import_stdio.StdioClientTransport({
+        command: serverConfig.command,
+        args: serverConfig.args || []
+      });
+    } else {
+      transport = new import_streamableHttp.StreamableHTTPClientTransport(new URL(serverConfig.url));
+    }
+    await client.connect(transport);
+    const result = await client.callTool({ name: toolName, arguments: input });
+    await client.close();
+    return {
+      result,
+      duration_ms: Date.now() - start
+    };
+  } catch (err) {
+    return {
+      result: null,
+      duration_ms: Date.now() - start,
+      error: err.message
+    };
+  }
+}
+
+// src/server/dev-server.ts
+function resolveClientDist() {
+  const fromCompiled = import_path.default.join(__dirname, "../client");
+  if (import_fs.default.existsSync(fromCompiled)) return fromCompiled;
+  const fromRoot = import_path.default.join(__dirname, "../../dist/client");
+  if (import_fs.default.existsSync(fromRoot)) return fromRoot;
+  return fromCompiled;
+}
+function fallbackHTML(port) {
+  return `<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="UTF-8"/>
+  <title>MCP Playbook</title>
+  <style>
+    body { font-family: monospace; background: #080808; color: #e2e0d8;
+           display: flex; align-items: center; justify-content: center;
+           height: 100vh; margin: 0; flex-direction: column; gap: 12px; }
+    code { background: #1a1a2e; color: #a39cf0; padding: 4px 10px;
+           border-radius: 4px; font-size: 14px; }
+    p    { color: #5a5856; font-size: 13px; }
+  </style>
+</head>
+<body>
+  <div style="font-size:32px">\u26A1</div>
+  <h2 style="margin:0">MCP Playbook API is running</h2>
+  <p>The React UI bundle was not found at <code>dist/client/</code></p>
+  <p>Run <code>npm run build:client</code> inside the mcp-playbook library to build it.</p>
+  <p>API available at <code>http://localhost:${port}/api/servers</code></p>
+</body>
+</html>`;
+}
+async function startDevServer(options) {
+  const app = (0, import_express.default)();
+  const server = (0, import_http.createServer)(app);
+  const wss = new import_ws.WebSocketServer({ server });
+  app.use(import_express.default.json());
+  const clientDist = resolveClientDist();
+  const hasClient = import_fs.default.existsSync(import_path.default.join(clientDist, "index.html"));
+  if (hasClient) {
+    app.use(import_express.default.static(clientDist));
+    console.log(import_chalk.default.dim(`  Client: serving from ${clientDist}`));
+  } else {
+    console.log(import_chalk.default.yellow(`  Warning: client bundle not found at ${clientDist}`));
+    console.log(import_chalk.default.dim("  API is available but UI will show a placeholder"));
+  }
+  async function loadConfig() {
+    const key = require.resolve(options.configPath);
+    delete require.cache[key];
+    try {
+      return require(options.configPath).default;
+    } catch {
+      const jsPath = options.configPath.replace(/\.ts$/, ".js");
+      if (import_fs.default.existsSync(jsPath)) {
+        delete require.cache[require.resolve(jsPath)];
+        return require(jsPath).default;
+      }
+      throw new Error(
+        `Cannot load config: ${options.configPath}
+  Make sure ts-node is installed: npm install -D ts-node
+  Or compile your config to JS first.`
+      );
+    }
+  }
+  let cachedServers = [];
+  let cachedConfig = null;
+  async function refreshServers() {
+    try {
+      const config = await loadConfig();
+      cachedConfig = config;
+      cachedServers = await discoverAllServers(
+        config.servers,
+        config.examples || {},
+        config.tags || {}
+      );
+      const connected = cachedServers.filter((s) => s.status === "connected").length;
+      const tools = cachedServers.reduce((acc, s) => acc + s.tools.length, 0);
+      console.log(import_chalk.default.green(`  \u2713 ${connected}/${cachedServers.length} servers \xB7 ${tools} tools`));
+      broadcastToClients({ type: "reload" });
+    } catch (err) {
+      console.error(import_chalk.default.red(`  \u2717 ${err.message}`));
+    }
+  }
+  function broadcastToClients(data) {
+    const msg = JSON.stringify(data);
+    wss.clients.forEach((c) => {
+      if (c.readyState === 1) c.send(msg);
+    });
+  }
+  app.get("/api/servers", async (_req, res) => {
+    try {
+      res.json({
+        title: cachedConfig?.title || "MCP Playbook",
+        description: cachedConfig?.description || "",
+        theme: cachedConfig?.theme || {},
+        servers: cachedServers
+      });
+    } catch (err) {
+      res.status(500).json({ error: err.message });
+    }
+  });
+  app.post("/api/refresh", async (_req, res) => {
+    await refreshServers();
+    res.json({ ok: true });
+  });
+  app.post("/api/execute", async (req, res) => {
+    const { serverId, toolName, input } = req.body;
+    if (!cachedConfig) return res.status(503).json({ error: "Config not loaded" });
+    const idx = parseInt(serverId.replace("server-", ""));
+    const serverConfig = cachedConfig.servers[idx];
+    if (!serverConfig) return res.status(404).json({ error: `Server not found: ${serverId}` });
+    const result = await executeTool(serverConfig, toolName, input || {});
+    res.json(result);
+  });
+  app.get("*", (_req, res) => {
+    const indexPath = import_path.default.join(clientDist, "index.html");
+    if (import_fs.default.existsSync(indexPath)) {
+      res.sendFile(indexPath);
+    } else {
+      res.send(fallbackHTML(options.port));
+    }
+  });
+  wss.on("connection", (ws) => {
+    ws.send(JSON.stringify({ type: "connected" }));
+  });
+  const watcher = import_chokidar.default.watch(options.configPath, { ignoreInitial: true });
+  watcher.on("change", () => {
+    console.log(import_chalk.default.dim("\n  Config changed \u2014 refreshing..."));
+    refreshServers();
+  });
+  await new Promise((resolve, reject) => {
+    server.on("error", (err) => {
+      if (err.code === "EADDRINUSE") {
+        reject(new Error(`Port ${options.port} is already in use. Try: --port ${options.port + 1}`));
+      } else {
+        reject(err);
+      }
+    });
+    server.listen(options.port, () => resolve());
+  });
+  await refreshServers();
+  const url = `http://localhost:${options.port}`;
+  console.log(import_chalk.default.dim(`
+  Local:   `) + import_chalk.default.cyan(url));
+  console.log(import_chalk.default.dim(`  Config:  ${options.configPath}
+`));
+  if (options.open && hasClient) {
+    try {
+      await (0, import_open.default)(url);
+    } catch {
+    }
+  }
+  return server;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  startDevServer
+});
+//# sourceMappingURL=dev-server.js.map