@dxos/mcp-client 0.8.3 → 0.8.4-main.6fa680abb7

package/dist/lib/neutral/index.mjs

@@ -0,0 +1,104 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/McpToolkit.ts
+var McpToolkit_exports = {};
+__export(McpToolkit_exports, {
+  make: () => make3
+});
+import * as Tool from "@effect/ai/Tool";
+import * as Toolkit from "@effect/ai/Toolkit";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import { GenericToolkit } from "@dxos/ai";
+import { invariant } from "@dxos/invariant";
+var __dxlog_file = "/__w/dxos/dxos/packages/core/mcp-client/src/McpToolkit.ts";
+var make3 = (options) => Effect.gen(function* () {
+  const transport = createTransport(options.url, options.kind);
+  const client = new Client({
+    name: "@dxos/mcp-client",
+    version: "0.8.3"
+  });
+  yield* Effect.promise(() => client.connect(transport));
+  const { tools } = yield* Effect.promise(() => client.listTools());
+  if (tools.length === 0) {
+    return GenericToolkit.empty;
+  }
+  const effectTools = tools.map((mcpTool) => {
+    const parameters = {};
+    for (const [key, value] of Object.entries(mcpTool.inputSchema.properties ?? {})) {
+      if (mcpTool.inputSchema.required?.includes(key)) {
+        parameters[key] = Schema.Unknown.pipe(Schema.annotations({
+          jsonSchema: value
+        }));
+      } else {
+        parameters[key] = Schema.Unknown.pipe(Schema.annotations({
+          jsonSchema: value
+        })).pipe(Schema.optional);
+      }
+    }
+    return Tool.make(sanitizeToolName(mcpTool.name), {
+      description: mcpTool.description ?? `MCP tool: ${mcpTool.name}`,
+      parameters,
+      success: Schema.String,
+      failure: Schema.Never
+    });
+  });
+  const toolkit = Toolkit.make(...effectTools);
+  const handlers = Object.fromEntries(tools.map((mcpTool) => {
+    const toolName = sanitizeToolName(mcpTool.name);
+    return [
+      toolName,
+      Effect.fn(function* (args) {
+        const result = yield* Effect.promise(() => client.callTool({
+          name: mcpTool.name,
+          arguments: args
+        }));
+        return formatToolResult(result);
+      })
+    ];
+  }));
+  const layer = toolkit.toLayer(handlers);
+  return GenericToolkit.make(toolkit, layer);
+}).pipe(Effect.withSpan("McpToolkit.make"));
+var createTransport = (url, kind) => {
+  const urlObj = new URL(url);
+  switch (kind) {
+    case "sse":
+      return new SSEClientTransport(urlObj);
+    case "http":
+      return new StreamableHTTPClientTransport(urlObj);
+    default: {
+      const _exhaustive = kind;
+      return invariant(false, `Unsupported MCP transport kind: ${_exhaustive}`, {
+        F: __dxlog_file,
+        L: 107,
+        S: void 0,
+        A: [
+          "false",
+          "`Unsupported MCP transport kind: ${_exhaustive}`"
+        ]
+      });
+    }
+  }
+};
+var sanitizeToolName = (name) => name.replace(/\//g, "_");
+var formatToolResult = (result) => {
+  if ("toolResult" in result && result.toolResult !== void 0) {
+    return JSON.stringify(result.toolResult);
+  }
+  if ("content" in result && Array.isArray(result.content)) {
+    return result.content.filter((part) => part.type === "text").map((part) => part.text).join("\n");
+  }
+  return String(result);
+};
+export {
+  McpToolkit_exports as McpToolkit
+};
+//# sourceMappingURL=index.mjs.map

package/dist/lib/neutral/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/McpToolkit.ts"],
+  "sourcesContent": ["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Tool from '@effect/ai/Tool';\nimport * as Toolkit from '@effect/ai/Toolkit';\nimport { Client } from '@modelcontextprotocol/sdk/client/index.js';\nimport { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js';\nimport { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';\nimport * as Effect from 'effect/Effect';\nimport * as Schema from 'effect/Schema';\n\nimport { GenericToolkit } from '@dxos/ai';\nimport { invariant } from '@dxos/invariant';\n\nexport interface McpToolkitOptions {\n  url: string;\n  kind: 'sse' | 'http';\n}\n\n/**\n * Creates a GenericToolkit that connects to an MCP server and exposes its tools to the assistant.\n *\n * @param options MCP server URL and transport kind ('sse' for SSE, 'http' for Streamable HTTP).\n * @returns A GenericToolkit containing all tools from the MCP server.\n */\nexport const make = (options: McpToolkitOptions): Effect.Effect<GenericToolkit.GenericToolkit> =>\n  Effect.gen(function* () {\n    const transport = createTransport(options.url, options.kind);\n    const client = new Client({ name: '@dxos/mcp-client', version: '0.8.3' });\n    yield* Effect.promise(() => client.connect(transport));\n\n    const { tools } = yield* Effect.promise(() => client.listTools());\n\n    if (tools.length === 0) {\n      return GenericToolkit.empty;\n    }\n\n    const effectTools = tools.map((mcpTool) => {\n      const parameters: any = {};\n      for (const [key, value] of Object.entries(mcpTool.inputSchema.properties ?? {})) {\n        if (mcpTool.inputSchema.required?.includes(key)) {\n          parameters[key] = Schema.Unknown.pipe(\n            Schema.annotations({\n              jsonSchema: value,\n            }),\n          );\n        } else {\n          parameters[key] = Schema.Unknown.pipe(\n            Schema.annotations({\n              jsonSchema: value,\n            }),\n          ).pipe(Schema.optional);\n        }\n      }\n\n      return Tool.make(sanitizeToolName(mcpTool.name), {\n        description: mcpTool.description ?? `MCP tool: ${mcpTool.name}`,\n        parameters,\n        success: Schema.String,\n        failure: Schema.Never,\n      });\n    });\n\n    const toolkit = Toolkit.make(...effectTools);\n\n    const handlers = Object.fromEntries(\n      tools.map((mcpTool) => {\n        const toolName = sanitizeToolName(mcpTool.name);\n        return [\n          toolName,\n          Effect.fn(function* (args: unknown) {\n            const result = yield* Effect.promise(() =>\n              client.callTool({\n                name: mcpTool.name,\n                arguments: args as any,\n              }),\n            );\n            return formatToolResult(result);\n          }),\n        ];\n      }),\n    ) as any;\n\n    const layer = toolkit.toLayer(handlers);\n\n    return GenericToolkit.make(toolkit, layer);\n  }).pipe(Effect.withSpan('McpToolkit.make'));\n\n/**\n * Creates a transport for the given MCP server URL and kind.\n */\nconst createTransport = (\n  url: string,\n  kind: McpToolkitOptions['kind'],\n): SSEClientTransport | StreamableHTTPClientTransport => {\n  const urlObj = new URL(url);\n  switch (kind) {\n    case 'sse':\n      return new SSEClientTransport(urlObj);\n    case 'http':\n      return new StreamableHTTPClientTransport(urlObj);\n    default: {\n      const _exhaustive: never = kind;\n      return invariant(false, `Unsupported MCP transport kind: ${_exhaustive}`) as never;\n    }\n  }\n};\n\n/**\n * Sanitizes MCP tool names for use as Effect tool names (replaces / with _).\n */\nconst sanitizeToolName = (name: string): string => name.replace(/\\//g, '_');\n\n/**\n * Formats MCP callTool result content for the assistant.\n */\nconst formatToolResult = (result: Awaited<ReturnType<Client['callTool']>>): string => {\n  if ('toolResult' in result && result.toolResult !== undefined) {\n    return JSON.stringify(result.toolResult);\n  }\n  if ('content' in result && Array.isArray(result.content)) {\n    return result.content\n      .filter((part): part is { type: 'text'; text: string } => part.type === 'text')\n      .map((part) => part.text)\n      .join('\\n');\n  }\n  return String(result);\n};\n"],
+  "mappings": "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",
+  "names": ["make", "Tool", "Toolkit", "Client", "SSEClientTransport", "StreamableHTTPClientTransport", "Effect", "Schema", "GenericToolkit", "invariant", "options", "gen", "transport", "createTransport", "url", "kind", "client", "name", "version", "promise", "connect", "tools", "listTools", "length", "empty", "effectTools", "map", "mcpTool", "parameters", "key", "value", "Object", "entries", "inputSchema", "properties", "required", "includes", "Unknown", "pipe", "annotations", "jsonSchema", "optional", "sanitizeToolName", "description", "success", "String", "failure", "Never", "toolkit", "handlers", "fromEntries", "toolName", "fn", "args", "result", "callTool", "arguments", "formatToolResult", "layer", "toLayer", "withSpan", "urlObj", "URL", "_exhaustive", "replace", "toolResult", "undefined", "JSON", "stringify", "Array", "isArray", "content", "filter", "part", "type", "text", "join"]
+}

package/dist/lib/neutral/meta.json

@@ -0,0 +1 @@
+{"inputs":{"src/McpToolkit.ts":{"bytes":14532,"imports":[{"path":"@effect/ai/Tool","kind":"import-statement","external":true},{"path":"@effect/ai/Toolkit","kind":"import-statement","external":true},{"path":"@modelcontextprotocol/sdk/client/index.js","kind":"import-statement","external":true},{"path":"@modelcontextprotocol/sdk/client/sse.js","kind":"import-statement","external":true},{"path":"@modelcontextprotocol/sdk/client/streamableHttp.js","kind":"import-statement","external":true},{"path":"effect/Effect","kind":"import-statement","external":true},{"path":"effect/Schema","kind":"import-statement","external":true},{"path":"@dxos/ai","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true}],"format":"esm"},"src/index.ts":{"bytes":527,"imports":[{"path":"src/McpToolkit.ts","kind":"import-statement","original":"./McpToolkit"}],"format":"esm"}},"outputs":{"dist/lib/neutral/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":7367},"dist/lib/neutral/index.mjs":{"imports":[{"path":"@effect/ai/Tool","kind":"import-statement","external":true},{"path":"@effect/ai/Toolkit","kind":"import-statement","external":true},{"path":"@modelcontextprotocol/sdk/client/index.js","kind":"import-statement","external":true},{"path":"@modelcontextprotocol/sdk/client/sse.js","kind":"import-statement","external":true},{"path":"@modelcontextprotocol/sdk/client/streamableHttp.js","kind":"import-statement","external":true},{"path":"effect/Effect","kind":"import-statement","external":true},{"path":"effect/Schema","kind":"import-statement","external":true},{"path":"@dxos/ai","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true}],"exports":["McpToolkit"],"entryPoint":"src/index.ts","inputs":{"src/McpToolkit.ts":{"bytesInOutput":3270},"src/index.ts":{"bytesInOutput":0}},"bytes":3541}}}

package/dist/types/src/McpToolkit.d.ts

@@ -0,0 +1,14 @@
+import * as Effect from 'effect/Effect';
+import { GenericToolkit } from '@dxos/ai';
+export interface McpToolkitOptions {
+    url: string;
+    kind: 'sse' | 'http';
+}
+/**
+ * Creates a GenericToolkit that connects to an MCP server and exposes its tools to the assistant.
+ *
+ * @param options MCP server URL and transport kind ('sse' for SSE, 'http' for Streamable HTTP).
+ * @returns A GenericToolkit containing all tools from the MCP server.
+ */
+export declare const make: (options: McpToolkitOptions) => Effect.Effect<GenericToolkit.GenericToolkit>;
+//# sourceMappingURL=McpToolkit.d.ts.map

package/dist/types/src/McpToolkit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpToolkit.d.ts","sourceRoot":"","sources":["../../../src/McpToolkit.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG1C,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,eAAO,MAAM,IAAI,GAAI,SAAS,iBAAiB,KAAG,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,cAAc,CA6DhD,CAAC"}

package/dist/types/src/McpToolkit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=McpToolkit.test.d.ts.map

package/dist/types/src/McpToolkit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpToolkit.test.d.ts","sourceRoot":"","sources":["../../../src/McpToolkit.test.ts"],"names":[],"mappings":""}

package/dist/types/src/index.d.ts

@@ -0,0 +1,2 @@
+export * as McpToolkit from './McpToolkit';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC"}