@execbox/core 0.1.0 → 0.2.0

package/README.md

@@ -56,10 +56,10 @@ Swap in `@execbox/remote` when you want the same API but a caller-managed remote
 
 ## Architecture Docs
 
-- [Execbox architecture overview](https://github.com/aallam/execbox/blob/main/docs/execbox/architecture/README.md)
-- [Execbox core architecture](https://github.com/aallam/execbox/blob/main/docs/execbox/architecture/execbox-core.md)
-- [Execbox executors](https://github.com/aallam/execbox/blob/main/docs/execbox/architecture/execbox-executors.md)
-- [Execbox MCP adapters and protocol](https://github.com/aallam/execbox/blob/main/docs/execbox/architecture/execbox-mcp-and-protocol.md)
+- [Execbox architecture overview](https://github.com/aallam/execbox/blob/main/docs/architecture/README.md)
+- [Execbox core architecture](https://github.com/aallam/execbox/blob/main/docs/architecture/execbox-core.md)
+- [Execbox executors](https://github.com/aallam/execbox/blob/main/docs/architecture/execbox-executors.md)
+- [Execbox MCP adapters and protocol](https://github.com/aallam/execbox/blob/main/docs/architecture/execbox-mcp-and-protocol.md)
 
 ## Exports
 
@@ -75,6 +75,8 @@ Swap in `@execbox/remote` when you want the same API but a caller-managed remote
   - `createMcpToolProvider`
   - `openMcpToolProvider`
   - `getMcpToolSourceServerInfo`
+  - `McpToolClientSource`
+  - `McpToolServerSource`
   - `codeMcpServer`
 
 ## Basic Usage
@@ -111,3 +113,7 @@ const result = await executor.execute(
 ## MCP Adapters
 
 Use `@execbox/core/mcp` when you want to wrap an MCP server or client into a tool provider, or expose code-execution tools from an MCP server. Wrapped tools preserve raw MCP `CallToolResult` envelopes so guest code can inspect `structuredContent` first and fall back to `content`.
+
+- `createMcpToolProvider({ client })` is the convenience API when the caller already owns the upstream MCP client lifecycle.
+- `openMcpToolProvider({ server | client })` returns an `McpToolProviderHandle` and is the required API when execbox owns a local `{ server }` connection.
+- `codeMcpServer()` owns any local wrapper connection it opens and releases it when the wrapper server closes.

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/executor/shared.ts","../src/identifier.ts","../src/normalize.ts","../src/sanitize.ts","../src/errors.ts","../src/provider/resolveProvider.ts","../src/typegen/jsonSchema.ts"],"sourcesContent":[],"mappings":";;;;;;AAyBA;AASgB,iBATA,uBAAA,CAS0B,KAAA,EAAA,OAAA,CAAA,EAAA,KAAA,IAP9B,gBAO8B;AAO1C;AAeA;AAkBA;AAkBgB,iBA1DA,0BAAA,CAAA,CA2DN,EAIP,MAAA;AAYH;AA8CA;;iBAlHgB,0BAAA,uBAA4C;;ACG5D;AAOA;AAOgB,iBDFA,sBAAA,CCEqB,KAAA,EAAA,OAAA,CAAA,EAAA,MAAA;AAYrC;AAsBA;;iBDlBgB,mBAAA;;AE5ChB;;iBF8DgB,sBAAA,SACN,oFAIP;;AG5FH;;iBHwGgB,YAAA;;AIxGhB;;AAMoB,iBJgJJ,iBAAA,CIhJI,MAAA,EAAA,OAAA,EAAA,CAAA,EAAA,MAAA;;;;;;AJcJ,iBCmBA,iBAAA,CDjBJ,KAAA,EAAA,MAAA,CAAA,EAAA,OAAgB;AAO5B;AAOA;AAeA;AAkBgB,iBCvBA,cAAA,CDuBmB,KAAA,EAAA,MAAA,CAAA,EAAA,OAAA;AAkBnC;AAiBA;AA8CA;iBCjGgB,qBAAA;;;AAdhB;AAOgB,iBAmBA,kBAAA,CAnBc,KAAA,EAAA,MAAA,CAAA,EAAA,MAAA;AAO9B;AAYA;AAsBA;iBAAgB,qBAAA;;;;;;ADnEA,iBEKA,aAAA,CFLuB,MAE3B,EAAA,MAAA,CAAA,EAAA,MAAgB;;;;;;AAFZ,iBGpBA,gBAAA,CHoBuB,IAE3B,EAAA,MAAA,CAAA,EAAA,MAAgB;;;;;AAF5B;AASgB,cI7BH,cAAA,SAAuB,KAAA,CJ6BM;EAO1B,IAAA,EInCR,gBJmCQ;EAeA;AAkBhB;AAkBA;EAiBgB,WAAA,CAAA,IAAY,EIlGR,gBJkGQ,EAAA,OAAA,EAAA,MAAA;AA8C5B;;;;AC/GgB,iBGvBA,gBAAA,CHuBiB,KAAA,EAAA,OAAA,CAAA,EAAA,KAAA,IGvB0B,cHuB1B;AAOjC;AAOA;AAYA;AAsBgB,iBGhEA,kBAAA,CHgEqB,KAAA,EAAA,OAAA,EAAA,MAAA,CAAA,EG9D7B,GH8D6B,CAAA,MAAA,CAAA,EAAA,IAAA,CAAA,EG7D/B,OH6D+B,CAAA,MAAA,CAAA,CAAA,EAAA,OAAA;;;;;ADnErC;AASgB,iBKUA,eAAA,CLV0B,QAAA,EKUA,YLVA,CAAA,EKUe,oBLVf;;;AAsB1C;AAkBA;AAkBA;AAiBgB,iBMLA,2BAAA,CNKY,YAAA,EAAA,MAAA,EAAA,KAAA,EMHnB,MNGmB,CAAA,MAAA,EMHJ,qBNGI,CAAA,CAAA,EAAA,MAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/executor/shared.ts","../src/identifier.ts","../src/normalize.ts","../src/sanitize.ts","../src/errors.ts","../src/provider/resolveProvider.ts","../src/typegen/jsonSchema.ts"],"sourcesContent":[],"mappings":";;;;;;AAyBA;AASgB,iBATA,uBAAA,CAS0B,KAAA,EAAA,OAAA,CAAA,EAAA,KAAA,IAP9B,gBAO8B;AAO1C;AAeA;AAkBA;AAkBgB,iBA1DA,0BAAA,CAAA,CA2DN,EAIP,MAAA;AAYH;AA8CA;;iBAlHgB,0BAAA,uBAA4C;;ACG5D;AAOA;AAOgB,iBDFA,sBAAA,CCEqB,KAAA,EAAA,OAAA,CAAA,EAAA,MAAA;AAYrC;AAsBA;;iBDlBgB,mBAAA;;AE5ChB;;iBF8DgB,sBAAA,SACN,oFAIP;;AG5FH;;iBHwGgB,YAAA;;AIxGhB;;AAMoB,iBJgJJ,iBAAA,CIhJI,MAAA,EAAA,OAAA,EAAA,CAAA,EAAA,MAAA;;;;;;AJcJ,iBCmBA,iBAAA,CDjBJ,KAAA,EAAA,MAAA,CAAA,EAAgB,OAAA;AAO5B;AAOA;AAeA;AAkBgB,iBCvBA,cAAA,CDuBmB,KAAA,EAAA,MAAA,CAAA,EAAA,OAAA;AAkBnC;AAiBA;AA8CA;iBCjGgB,qBAAA;;;AAdhB;AAOgB,iBAmBA,kBAAA,CAnBc,KAAA,EAAA,MAAA,CAAA,EAAA,MAAA;AAO9B;AAYA;AAsBA;iBAAgB,qBAAA;;;;;;ADnEA,iBEKA,aAAA,CFLuB,MAE3B,EAAA,MAAA,CAAA,EAAA,MAAgB;;;;;;AAFZ,iBGpBA,gBAAA,CHsBJ,IAAA,EAAA,MAAA,CAAA,EAAA,MAAgB;;;;;AAF5B;AASgB,cI7BH,cAAA,SAAuB,KAAA,CJ6BM;EAO1B,IAAA,EInCR,gBJmCQ;EAeA;AAkBhB;AAkBA;EAiBgB,WAAA,CAAA,IAAY,EIlGR,gBJkGQ,EAAA,OAAA,EAAA,MAAA;AA8C5B;;;;AC/GgB,iBGvBA,gBAAA,CHuBiB,KAAA,EAAA,OAAA,CAAA,EAAA,KAAA,IGvB0B,cHuB1B;AAOjC;AAOA;AAYA;AAsBgB,iBGhEA,kBAAA,CHgEqB,KAAA,EAAA,OAAA,EAAA,MAAA,CAAA,EG9D7B,GH8D6B,CAAA,MAAA,CAAA,EAAA,IAAA,CAAA,EG7D/B,OH6D+B,CAAA,MAAA,CAAA,CAAA,EAAA,OAAA;;;;;ADnErC;AASgB,iBKUA,eAAA,CLV0B,QAAA,EKUA,YLVA,CAAA,EKUe,oBLVf;;;AAsB1C;AAkBA;AAkBA;AAiBgB,iBMLA,2BAAA,CNKY,YAAA,EAAA,MAAA,EAAA,KAAA,EMHnB,MNGmB,CAAA,MAAA,EMHJ,qBNGI,CAAA,CAAA,EAAA,MAAA"}

package/dist/mcp/index.cjs

@@ -61,7 +61,15 @@ async function openMcpToolClient(source, clientInfo) {
 	const [clientTransport, serverTransport] = __modelcontextprotocol_sdk_inMemory_js.InMemoryTransport.createLinkedPair();
 	const client = new __modelcontextprotocol_sdk_client_index_js.Client(clientInfo);
 	let closePromise;
-	await Promise.all([source.server.connect(serverTransport), client.connect(clientTransport)]);
+	let serverConnected = false;
+	try {
+		await source.server.connect(serverTransport);
+		serverConnected = true;
+		await client.connect(clientTransport);
+	} catch (error) {
+		await Promise.allSettled([Promise.resolve().then(() => client.close()), serverConnected ? Promise.resolve().then(() => source.server.close()) : Promise.resolve()]);
+		throw error;
+	}
 	return {
 		client,
 		close: async () => {
@@ -107,9 +115,10 @@ async function openMcpToolProvider(source, options = {}) {
 	}
 }
 /**
-* Wraps MCP tools from a client or server as a resolved execution provider.
+* Wraps MCP tools from a caller-owned MCP client as a resolved execution provider.
 */
 async function createMcpToolProvider(source, options = {}) {
+	if ("server" in source) throw new Error("createMcpToolProvider() no longer accepts { server } sources. Use openMcpToolProvider() to receive a cleanup handle for owned local MCP server connections.");
 	return (await openMcpToolProvider(source, options)).provider;
 }
 

package/dist/mcp/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["renderDocComment","schemaToType","renderNamespaceDeclaration","InMemoryTransport","Client","closePromise: Promise<void> | undefined","provider: ToolProvider","resolveProvider","z","closePromise: Promise<void> | undefined","McpServer"],"sources":["../../src/mcp/mcpWrappedToolTypes.ts","../../src/mcp/createMcpToolProvider.ts","../../src/mcp/codeMcpServer.ts"],"sourcesContent":["import type { ResolvedToolProvider } from \"../types\";\nimport { schemaToType } from \"../typegen/jsonSchema\";\nimport {\n  renderDocComment,\n  renderNamespaceDeclaration,\n} from \"../typegen/render\";\n\nconst MCP_CALL_TOOL_RESULT_TYPE = [\n  \"type McpCallToolResult = {\",\n  \"  content: Array<{\",\n  \"    type: string;\",\n  \"    text?: string;\",\n  \"    data?: string;\",\n  \"    mimeType?: string;\",\n  \"    resource?: unknown;\",\n  \"    uri?: string;\",\n  \"    name?: string;\",\n  \"    description?: string;\",\n  \"  }>;\",\n  \"  structuredContent?: unknown;\",\n  \"  isError?: boolean;\",\n  \"  _meta?: Record<string, unknown>;\",\n  \"};\",\n].join(\"\\n\");\n\n/**\n * Generates the wrapped MCP tool namespace declarations exposed to guest code.\n */\nexport function generateMcpWrappedToolTypes(\n  provider: ResolvedToolProvider,\n): string {\n  const declarations = [MCP_CALL_TOOL_RESULT_TYPE];\n\n  for (const [safeName, tool] of Object.entries(provider.tools)) {\n    const comment = renderDocComment([\n      ...(tool.description ? [tool.description, \"\"] : []),\n      \"Wrapped MCP tool. Inspect structuredContent first, then fall back to content text items.\",\n    ]);\n\n    declarations.push(\n      [\n        comment,\n        `function ${safeName}(input: ${schemaToType(tool.inputSchema)}): Promise<McpCallToolResult>;`,\n      ]\n        .filter(Boolean)\n        .join(\"\\n\"),\n    );\n  }\n\n  return renderNamespaceDeclaration(provider.name, declarations);\n}\n","import { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport { InMemoryTransport } from \"@modelcontextprotocol/sdk/inMemory.js\";\nimport type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport type { Implementation } from \"@modelcontextprotocol/sdk/types.js\";\n\nimport { resolveProvider } from \"../provider/resolveProvider\";\nimport type { ResolvedToolProvider, ToolProvider } from \"../types\";\nimport { generateMcpWrappedToolTypes } from \"./mcpWrappedToolTypes\";\n\n/**\n * Source used to discover MCP tools for wrapping.\n */\nexport type McpToolSource =\n  | { client: Client; serverInfo?: Implementation }\n  | { server: McpServer; serverInfo?: Implementation };\n\nconst DEFAULT_MCP_TOOL_CLIENT_INFO = {\n  name: \"mcp-tool-client\",\n  version: \"0.0.0\",\n} satisfies Implementation;\n\n/**\n * Returns the upstream server identity when the source can provide one.\n */\nexport function getMcpToolSourceServerInfo(\n  source: McpToolSource,\n): Implementation | undefined {\n  if (source.serverInfo) {\n    return source.serverInfo;\n  }\n\n  if (\"client\" in source) {\n    return source.client.getServerVersion();\n  }\n\n  return undefined;\n}\n\n/**\n * Options for wrapping MCP tools into a code-execution provider.\n */\nexport interface CreateMcpToolProviderOptions {\n  /** Namespace exposed to guest code for the wrapped tools. */\n  namespace?: string;\n  /** Implementation metadata exposed to local `{ server }` sources as the client identity. */\n  clientInfo?: Implementation;\n}\n\n/**\n * Explicit handle for a wrapped MCP provider and any owned source connections.\n */\nexport interface McpToolProviderHandle {\n  /** Resolved provider exposed to the executor or wrapper server. */\n  provider: ResolvedToolProvider;\n  /** Best-effort upstream server identity when available. */\n  serverInfo?: Implementation;\n  /** Releases any internal MCP client/server connection opened for the provider. */\n  close: () => Promise<void>;\n}\n\ninterface OpenMcpToolClientResult {\n  client: Client;\n  close: () => Promise<void>;\n}\n\nasync function closeAll(closers: Array<() => Promise<void>>): Promise<void> {\n  const results = await Promise.allSettled(closers.map((close) => close()));\n  const rejected = results.find(\n    (result): result is PromiseRejectedResult => result.status === \"rejected\",\n  );\n\n  if (rejected) {\n    throw rejected.reason;\n  }\n}\n\nasync function openMcpToolClient(\n  source: McpToolSource,\n  clientInfo: Implementation,\n): Promise<OpenMcpToolClientResult> {\n  if (\"client\" in source) {\n    return {\n      client: source.client,\n      close: async () => {},\n    };\n  }\n\n  if (source.server.isConnected()) {\n    throw new Error(\"{ server } sources must be unconnected local MCP servers\");\n  }\n\n  const [clientTransport, serverTransport] =\n    InMemoryTransport.createLinkedPair();\n  const client = new Client(clientInfo);\n  let closePromise: Promise<void> | undefined;\n\n  await Promise.all([\n    source.server.connect(serverTransport),\n    client.connect(clientTransport),\n  ]);\n\n  return {\n    client,\n    close: async () => {\n      closePromise ??= closeAll([\n        () => client.close(),\n        () => source.server.close(),\n      ]);\n      return closePromise;\n    },\n  };\n}\n\n/**\n * Opens an MCP tool source as a resolved execution provider with explicit cleanup.\n */\nexport async function openMcpToolProvider(\n  source: McpToolSource,\n  options: CreateMcpToolProviderOptions = {},\n): Promise<McpToolProviderHandle> {\n  const connection = await openMcpToolClient(\n    source,\n    options.clientInfo ?? DEFAULT_MCP_TOOL_CLIENT_INFO,\n  );\n\n  try {\n    const toolsResponse = await connection.client.listTools();\n    const provider: ToolProvider = {\n      name: options.namespace ?? \"mcp\",\n      tools: {},\n    };\n\n    for (const tool of toolsResponse.tools) {\n      provider.tools[tool.name] = {\n        description: tool.description,\n        execute: async (input, context) => {\n          const argumentsObject =\n            typeof input === \"object\" && input !== null\n              ? (input as Record<string, unknown>)\n              : undefined;\n\n          return connection.client.callTool(\n            {\n              arguments: argumentsObject,\n              name: tool.name,\n            },\n            undefined,\n            { signal: context.signal },\n          );\n        },\n        inputSchema: tool.inputSchema,\n      };\n    }\n\n    const resolvedProvider = resolveProvider(provider);\n\n    return {\n      close: connection.close,\n      provider: {\n        ...resolvedProvider,\n        types: generateMcpWrappedToolTypes(resolvedProvider),\n      },\n      serverInfo: getMcpToolSourceServerInfo(source),\n    };\n  } catch (error) {\n    await connection.close().catch(() => {});\n    throw error;\n  }\n}\n\n/**\n * Wraps MCP tools from a client or server as a resolved execution provider.\n */\nexport async function createMcpToolProvider(\n  source: McpToolSource,\n  options: CreateMcpToolProviderOptions = {},\n): Promise<ResolvedToolProvider> {\n  const handle = await openMcpToolProvider(source, options);\n  return handle.provider;\n}\n","import { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport type { Implementation } from \"@modelcontextprotocol/sdk/types.js\";\nimport * as z from \"zod\";\n\nimport type { Executor } from \"../executor/executor\";\nimport type { ResolvedToolProvider } from \"../types\";\nimport {\n  openMcpToolProvider,\n  type CreateMcpToolProviderOptions,\n  type McpToolSource,\n} from \"./createMcpToolProvider\";\n\n/**\n * Options for exposing wrapped MCP tool execution through an MCP server.\n */\nexport interface CodeMcpServerOptions extends CreateMcpToolProviderOptions {\n  /** Executor used to run guest JavaScript against the wrapped provider. */\n  executor: Executor;\n  /** Implementation metadata exposed to downstream clients as the wrapper server identity. */\n  serverInfo?: Implementation;\n  /** Maximum number of text characters returned in text content blocks. */\n  maxTextChars?: number;\n  /** Wrapper tool layout to expose on the returned server. */\n  mode?: \"both\" | \"single\" | \"split\";\n  /** Optional custom names for the wrapper tools. */\n  names?: {\n    execute?: string;\n    search?: string;\n    single?: string;\n  };\n}\n\nconst DEFAULT_MAX_TEXT_CHARS = 24_000;\nconst DEFAULT_MCP_CODE_WRAPPER_SERVER_INFO = {\n  name: \"mcp-code-wrapper\",\n  version: \"0.0.0\",\n} satisfies Implementation;\n\nfunction truncateText(text: string, maxTextChars: number): string {\n  return text.length <= maxTextChars ? text : text.slice(0, maxTextChars);\n}\n\nfunction renderText(value: unknown, maxTextChars: number): string {\n  return truncateText(JSON.stringify(value, null, 2), maxTextChars);\n}\n\nfunction searchTools(\n  provider: ResolvedToolProvider,\n  query: string | undefined,\n  limit: number,\n): Record<string, unknown> {\n  const normalizedQuery = query?.toLowerCase().trim();\n  const matches = Object.entries(provider.tools)\n    .map(([safeName, descriptor]) => ({\n      description: descriptor.description,\n      inputSchema: descriptor.inputSchema,\n      originalName: descriptor.originalName,\n      outputSchema: descriptor.outputSchema,\n      safeName,\n    }))\n    .filter((tool) => {\n      if (!normalizedQuery) {\n        return true;\n      }\n\n      return [tool.originalName, tool.safeName, tool.description ?? \"\"].some(\n        (field) => field.toLowerCase().includes(normalizedQuery),\n      );\n    })\n    .slice(0, limit);\n\n  return {\n    namespace: provider.name,\n    originalToSafeName: provider.originalToSafeName,\n    safeToOriginalName: provider.safeToOriginalName,\n    tools: matches,\n    types: provider.types,\n  };\n}\n\nfunction registerExecuteTool(\n  server: McpServer,\n  name: string,\n  provider: ResolvedToolProvider,\n  executor: Executor,\n  maxTextChars: number,\n  description: string,\n): void {\n  const registerTool = server.registerTool.bind(server) as (\n    toolName: string,\n    config: {\n      description: string;\n      inputSchema: Record<string, z.ZodTypeAny>;\n    },\n    handler: (args: { code: string }) => Promise<{\n      content: Array<{ text: string; type: \"text\" }>;\n      isError: boolean;\n      structuredContent: Record<string, unknown>;\n    }>,\n  ) => void;\n\n  registerTool(\n    name,\n    {\n      description,\n      inputSchema: {\n        code: z.string(),\n      },\n    },\n    async (args: { code: string }) => {\n      const execution = await executor.execute(args.code, [provider]);\n\n      return {\n        content: [{ text: renderText(execution, maxTextChars), type: \"text\" }],\n        isError: !execution.ok,\n        structuredContent: execution as Record<string, unknown>,\n      };\n    },\n  );\n}\n\nfunction registerSearchTool(\n  server: McpServer,\n  name: string,\n  provider: ResolvedToolProvider,\n  maxTextChars: number,\n): void {\n  const registerTool = server.registerTool.bind(server) as (\n    toolName: string,\n    config: {\n      description: string;\n      inputSchema: Record<string, z.ZodTypeAny>;\n    },\n    handler: (args: { limit?: number; query?: string }) => Promise<{\n      content: Array<{ text: string; type: \"text\" }>;\n      structuredContent: Record<string, unknown>;\n    }>,\n  ) => void;\n\n  registerTool(\n    name,\n    {\n      description: `Search wrapped MCP tools exposed under the ${provider.name} namespace.`,\n      inputSchema: {\n        limit: z.number().int().optional(),\n        query: z.string().optional(),\n      },\n    },\n    async (args: { limit?: number; query?: string }) => {\n      const structuredContent = searchTools(\n        provider,\n        args.query,\n        args.limit ?? 20,\n      );\n      return {\n        content: [\n          { text: renderText(structuredContent, maxTextChars), type: \"text\" },\n        ],\n        structuredContent,\n      };\n    },\n  );\n}\n\nfunction attachOwnedClose(\n  server: McpServer,\n  closeOwnedResources: () => Promise<void>,\n): McpServer {\n  const originalClose = server.close.bind(server);\n  let closePromise: Promise<void> | undefined;\n\n  server.close = async () => {\n    closePromise ??= (async () => {\n      const results = await Promise.allSettled([\n        originalClose(),\n        closeOwnedResources(),\n      ]);\n      const rejected = results.find(\n        (result): result is PromiseRejectedResult =>\n          result.status === \"rejected\",\n      );\n\n      if (rejected) {\n        throw rejected.reason;\n      }\n    })();\n\n    return closePromise;\n  };\n\n  return server;\n}\n\n/**\n * Creates an MCP server that exposes code-execution tools for a wrapped MCP source.\n */\nexport async function codeMcpServer(\n  source: McpToolSource,\n  options: CodeMcpServerOptions,\n): Promise<McpServer> {\n  const maxTextChars = options.maxTextChars ?? DEFAULT_MAX_TEXT_CHARS;\n  const mode = options.mode ?? \"both\";\n  const names = {\n    execute: options.names?.execute ?? \"mcp_execute_code\",\n    search: options.names?.search ?? \"mcp_search_tools\",\n    single: options.names?.single ?? \"mcp_code\",\n  };\n  const handle = await openMcpToolProvider(source, {\n    clientInfo: options.clientInfo,\n    namespace: options.namespace ?? \"mcp\",\n  });\n  const provider = handle.provider;\n  const server = new McpServer(\n    options.serverInfo ??\n      handle.serverInfo ??\n      DEFAULT_MCP_CODE_WRAPPER_SERVER_INFO,\n  );\n\n  try {\n    if (mode === \"both\" || mode === \"split\") {\n      registerSearchTool(server, names.search, provider, maxTextChars);\n      registerExecuteTool(\n        server,\n        names.execute,\n        provider,\n        options.executor,\n        maxTextChars,\n        `Execute JavaScript against the wrapped ${provider.name} MCP tool namespace.`,\n      );\n    }\n\n    if (mode === \"both\" || mode === \"single\") {\n      registerExecuteTool(\n        server,\n        names.single,\n        provider,\n        options.executor,\n        maxTextChars,\n        `Execute JavaScript against the wrapped ${provider.name} MCP tool namespace.\\n\\n${provider.types}`,\n      );\n    }\n\n    return attachOwnedClose(server, handle.close);\n  } catch (error) {\n    await handle.close().catch(() => {});\n    throw error;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["renderDocComment","schemaToType","renderNamespaceDeclaration","InMemoryTransport","Client","closePromise: Promise<void> | undefined","provider: ToolProvider","resolveProvider","z","closePromise: Promise<void> | undefined","McpServer"],"sources":["../../src/mcp/mcpWrappedToolTypes.ts","../../src/mcp/createMcpToolProvider.ts","../../src/mcp/codeMcpServer.ts"],"sourcesContent":["import type { ResolvedToolProvider } from \"../types\";\nimport { schemaToType } from \"../typegen/jsonSchema\";\nimport {\n  renderDocComment,\n  renderNamespaceDeclaration,\n} from \"../typegen/render\";\n\nconst MCP_CALL_TOOL_RESULT_TYPE = [\n  \"type McpCallToolResult = {\",\n  \"  content: Array<{\",\n  \"    type: string;\",\n  \"    text?: string;\",\n  \"    data?: string;\",\n  \"    mimeType?: string;\",\n  \"    resource?: unknown;\",\n  \"    uri?: string;\",\n  \"    name?: string;\",\n  \"    description?: string;\",\n  \"  }>;\",\n  \"  structuredContent?: unknown;\",\n  \"  isError?: boolean;\",\n  \"  _meta?: Record<string, unknown>;\",\n  \"};\",\n].join(\"\\n\");\n\n/**\n * Generates the wrapped MCP tool namespace declarations exposed to guest code.\n */\nexport function generateMcpWrappedToolTypes(\n  provider: ResolvedToolProvider,\n): string {\n  const declarations = [MCP_CALL_TOOL_RESULT_TYPE];\n\n  for (const [safeName, tool] of Object.entries(provider.tools)) {\n    const comment = renderDocComment([\n      ...(tool.description ? [tool.description, \"\"] : []),\n      \"Wrapped MCP tool. Inspect structuredContent first, then fall back to content text items.\",\n    ]);\n\n    declarations.push(\n      [\n        comment,\n        `function ${safeName}(input: ${schemaToType(tool.inputSchema)}): Promise<McpCallToolResult>;`,\n      ]\n        .filter(Boolean)\n        .join(\"\\n\"),\n    );\n  }\n\n  return renderNamespaceDeclaration(provider.name, declarations);\n}\n","import { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport { InMemoryTransport } from \"@modelcontextprotocol/sdk/inMemory.js\";\nimport type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport type { Implementation } from \"@modelcontextprotocol/sdk/types.js\";\n\nimport { resolveProvider } from \"../provider/resolveProvider\";\nimport type { ResolvedToolProvider, ToolProvider } from \"../types\";\nimport { generateMcpWrappedToolTypes } from \"./mcpWrappedToolTypes\";\n\n/**\n * Caller-owned MCP client source used by the convenience wrapper API.\n */\nexport type McpToolClientSource = {\n  client: Client;\n  serverInfo?: Implementation;\n};\n\n/**\n * Local MCP server source that requires explicit lifecycle cleanup.\n */\nexport type McpToolServerSource = {\n  server: McpServer;\n  serverInfo?: Implementation;\n};\n\n/**\n * Source used to discover MCP tools for wrapping.\n */\nexport type McpToolSource = McpToolClientSource | McpToolServerSource;\n\nconst DEFAULT_MCP_TOOL_CLIENT_INFO = {\n  name: \"mcp-tool-client\",\n  version: \"0.0.0\",\n} satisfies Implementation;\n\n/**\n * Returns the upstream server identity when the source can provide one.\n */\nexport function getMcpToolSourceServerInfo(\n  source: McpToolSource,\n): Implementation | undefined {\n  if (source.serverInfo) {\n    return source.serverInfo;\n  }\n\n  if (\"client\" in source) {\n    return source.client.getServerVersion();\n  }\n\n  return undefined;\n}\n\n/**\n * Options for wrapping MCP tools into a code-execution provider.\n */\nexport interface CreateMcpToolProviderOptions {\n  /** Namespace exposed to guest code for the wrapped tools. */\n  namespace?: string;\n  /** Implementation metadata exposed to local `{ server }` sources as the client identity. */\n  clientInfo?: Implementation;\n}\n\n/**\n * Explicit handle for a wrapped MCP provider and any owned source connections.\n */\nexport interface McpToolProviderHandle {\n  /** Resolved provider exposed to the executor or wrapper server. */\n  provider: ResolvedToolProvider;\n  /** Best-effort upstream server identity when available. */\n  serverInfo?: Implementation;\n  /** Releases any internal MCP client/server connection opened for the provider. */\n  close: () => Promise<void>;\n}\n\ninterface OpenMcpToolClientResult {\n  client: Client;\n  close: () => Promise<void>;\n}\n\nasync function closeAll(closers: Array<() => Promise<void>>): Promise<void> {\n  const results = await Promise.allSettled(closers.map((close) => close()));\n  const rejected = results.find(\n    (result): result is PromiseRejectedResult => result.status === \"rejected\",\n  );\n\n  if (rejected) {\n    throw rejected.reason;\n  }\n}\n\nasync function openMcpToolClient(\n  source: McpToolSource,\n  clientInfo: Implementation,\n): Promise<OpenMcpToolClientResult> {\n  if (\"client\" in source) {\n    return {\n      client: source.client,\n      close: async () => {},\n    };\n  }\n\n  if (source.server.isConnected()) {\n    throw new Error(\"{ server } sources must be unconnected local MCP servers\");\n  }\n\n  const [clientTransport, serverTransport] =\n    InMemoryTransport.createLinkedPair();\n  const client = new Client(clientInfo);\n  let closePromise: Promise<void> | undefined;\n  let serverConnected = false;\n\n  try {\n    await source.server.connect(serverTransport);\n    serverConnected = true;\n    await client.connect(clientTransport);\n  } catch (error) {\n    await Promise.allSettled([\n      Promise.resolve().then(() => client.close()),\n      serverConnected\n        ? Promise.resolve().then(() => source.server.close())\n        : Promise.resolve(),\n    ]);\n    throw error;\n  }\n\n  return {\n    client,\n    close: async () => {\n      closePromise ??= closeAll([\n        () => client.close(),\n        () => source.server.close(),\n      ]);\n      return closePromise;\n    },\n  };\n}\n\n/**\n * Opens an MCP tool source as a resolved execution provider with explicit cleanup.\n */\nexport async function openMcpToolProvider(\n  source: McpToolSource,\n  options: CreateMcpToolProviderOptions = {},\n): Promise<McpToolProviderHandle> {\n  const connection = await openMcpToolClient(\n    source,\n    options.clientInfo ?? DEFAULT_MCP_TOOL_CLIENT_INFO,\n  );\n\n  try {\n    const toolsResponse = await connection.client.listTools();\n    const provider: ToolProvider = {\n      name: options.namespace ?? \"mcp\",\n      tools: {},\n    };\n\n    for (const tool of toolsResponse.tools) {\n      provider.tools[tool.name] = {\n        description: tool.description,\n        execute: async (input, context) => {\n          const argumentsObject =\n            typeof input === \"object\" && input !== null\n              ? (input as Record<string, unknown>)\n              : undefined;\n\n          return connection.client.callTool(\n            {\n              arguments: argumentsObject,\n              name: tool.name,\n            },\n            undefined,\n            { signal: context.signal },\n          );\n        },\n        inputSchema: tool.inputSchema,\n      };\n    }\n\n    const resolvedProvider = resolveProvider(provider);\n\n    return {\n      close: connection.close,\n      provider: {\n        ...resolvedProvider,\n        types: generateMcpWrappedToolTypes(resolvedProvider),\n      },\n      serverInfo: getMcpToolSourceServerInfo(source),\n    };\n  } catch (error) {\n    await connection.close().catch(() => {});\n    throw error;\n  }\n}\n\n/**\n * Wraps MCP tools from a caller-owned MCP client as a resolved execution provider.\n */\nexport async function createMcpToolProvider(\n  source: McpToolClientSource,\n  options: CreateMcpToolProviderOptions = {},\n): Promise<ResolvedToolProvider> {\n  if (\"server\" in (source as unknown as McpToolSource)) {\n    throw new Error(\n      \"createMcpToolProvider() no longer accepts { server } sources. Use openMcpToolProvider() to receive a cleanup handle for owned local MCP server connections.\",\n    );\n  }\n\n  const handle = await openMcpToolProvider(source, options);\n  return handle.provider;\n}\n","import { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport type { Implementation } from \"@modelcontextprotocol/sdk/types.js\";\nimport * as z from \"zod\";\n\nimport type { Executor } from \"../executor/executor\";\nimport type { ResolvedToolProvider } from \"../types\";\nimport {\n  openMcpToolProvider,\n  type CreateMcpToolProviderOptions,\n  type McpToolSource,\n} from \"./createMcpToolProvider\";\n\n/**\n * Options for exposing wrapped MCP tool execution through an MCP server.\n */\nexport interface CodeMcpServerOptions extends CreateMcpToolProviderOptions {\n  /** Executor used to run guest JavaScript against the wrapped provider. */\n  executor: Executor;\n  /** Implementation metadata exposed to downstream clients as the wrapper server identity. */\n  serverInfo?: Implementation;\n  /** Maximum number of text characters returned in text content blocks. */\n  maxTextChars?: number;\n  /** Wrapper tool layout to expose on the returned server. */\n  mode?: \"both\" | \"single\" | \"split\";\n  /** Optional custom names for the wrapper tools. */\n  names?: {\n    execute?: string;\n    search?: string;\n    single?: string;\n  };\n}\n\nconst DEFAULT_MAX_TEXT_CHARS = 24_000;\nconst DEFAULT_MCP_CODE_WRAPPER_SERVER_INFO = {\n  name: \"mcp-code-wrapper\",\n  version: \"0.0.0\",\n} satisfies Implementation;\n\nfunction truncateText(text: string, maxTextChars: number): string {\n  return text.length <= maxTextChars ? text : text.slice(0, maxTextChars);\n}\n\nfunction renderText(value: unknown, maxTextChars: number): string {\n  return truncateText(JSON.stringify(value, null, 2), maxTextChars);\n}\n\nfunction searchTools(\n  provider: ResolvedToolProvider,\n  query: string | undefined,\n  limit: number,\n): Record<string, unknown> {\n  const normalizedQuery = query?.toLowerCase().trim();\n  const matches = Object.entries(provider.tools)\n    .map(([safeName, descriptor]) => ({\n      description: descriptor.description,\n      inputSchema: descriptor.inputSchema,\n      originalName: descriptor.originalName,\n      outputSchema: descriptor.outputSchema,\n      safeName,\n    }))\n    .filter((tool) => {\n      if (!normalizedQuery) {\n        return true;\n      }\n\n      return [tool.originalName, tool.safeName, tool.description ?? \"\"].some(\n        (field) => field.toLowerCase().includes(normalizedQuery),\n      );\n    })\n    .slice(0, limit);\n\n  return {\n    namespace: provider.name,\n    originalToSafeName: provider.originalToSafeName,\n    safeToOriginalName: provider.safeToOriginalName,\n    tools: matches,\n    types: provider.types,\n  };\n}\n\nfunction registerExecuteTool(\n  server: McpServer,\n  name: string,\n  provider: ResolvedToolProvider,\n  executor: Executor,\n  maxTextChars: number,\n  description: string,\n): void {\n  // Cast required: McpServer.registerTool's generic signature doesn't support\n  // the narrow input/output shape we need for the code-execution tool.\n  const registerTool = server.registerTool.bind(server) as (\n    toolName: string,\n    config: {\n      description: string;\n      inputSchema: Record<string, z.ZodTypeAny>;\n    },\n    handler: (args: { code: string }) => Promise<{\n      content: Array<{ text: string; type: \"text\" }>;\n      isError: boolean;\n      structuredContent: Record<string, unknown>;\n    }>,\n  ) => void;\n\n  registerTool(\n    name,\n    {\n      description,\n      inputSchema: {\n        code: z.string(),\n      },\n    },\n    async (args: { code: string }) => {\n      const execution = await executor.execute(args.code, [provider]);\n\n      return {\n        content: [{ text: renderText(execution, maxTextChars), type: \"text\" }],\n        isError: !execution.ok,\n        // ExecuteResult is JSON-safe; cast satisfies the SDK's generic record type.\n        structuredContent: execution as Record<string, unknown>,\n      };\n    },\n  );\n}\n\nfunction registerSearchTool(\n  server: McpServer,\n  name: string,\n  provider: ResolvedToolProvider,\n  maxTextChars: number,\n): void {\n  // Cast required: same rationale as registerExecuteTool above.\n  const registerTool = server.registerTool.bind(server) as (\n    toolName: string,\n    config: {\n      description: string;\n      inputSchema: Record<string, z.ZodTypeAny>;\n    },\n    handler: (args: { limit?: number; query?: string }) => Promise<{\n      content: Array<{ text: string; type: \"text\" }>;\n      structuredContent: Record<string, unknown>;\n    }>,\n  ) => void;\n\n  registerTool(\n    name,\n    {\n      description: `Search wrapped MCP tools exposed under the ${provider.name} namespace.`,\n      inputSchema: {\n        limit: z.number().int().optional(),\n        query: z.string().optional(),\n      },\n    },\n    async (args: { limit?: number; query?: string }) => {\n      const structuredContent = searchTools(\n        provider,\n        args.query,\n        args.limit ?? 20,\n      );\n      return {\n        content: [\n          { text: renderText(structuredContent, maxTextChars), type: \"text\" },\n        ],\n        structuredContent,\n      };\n    },\n  );\n}\n\nfunction attachOwnedClose(\n  server: McpServer,\n  closeOwnedResources: () => Promise<void>,\n): McpServer {\n  const originalClose = server.close.bind(server);\n  let closePromise: Promise<void> | undefined;\n\n  server.close = async () => {\n    closePromise ??= (async () => {\n      const results = await Promise.allSettled([\n        originalClose(),\n        closeOwnedResources(),\n      ]);\n      const rejected = results.find(\n        (result): result is PromiseRejectedResult =>\n          result.status === \"rejected\",\n      );\n\n      if (rejected) {\n        throw rejected.reason;\n      }\n    })();\n\n    return closePromise;\n  };\n\n  return server;\n}\n\n/**\n * Creates an MCP server that exposes code-execution tools for a wrapped MCP source.\n */\nexport async function codeMcpServer(\n  source: McpToolSource,\n  options: CodeMcpServerOptions,\n): Promise<McpServer> {\n  const maxTextChars = options.maxTextChars ?? DEFAULT_MAX_TEXT_CHARS;\n  const mode = options.mode ?? \"both\";\n  const names = {\n    execute: options.names?.execute ?? \"mcp_execute_code\",\n    search: options.names?.search ?? \"mcp_search_tools\",\n    single: options.names?.single ?? \"mcp_code\",\n  };\n  const handle = await openMcpToolProvider(source, {\n    clientInfo: options.clientInfo,\n    namespace: options.namespace ?? \"mcp\",\n  });\n  const provider = handle.provider;\n  const server = new McpServer(\n    options.serverInfo ??\n      handle.serverInfo ??\n      DEFAULT_MCP_CODE_WRAPPER_SERVER_INFO,\n  );\n\n  try {\n    if (mode === \"both\" || mode === \"split\") {\n      registerSearchTool(server, names.search, provider, maxTextChars);\n      registerExecuteTool(\n        server,\n        names.execute,\n        provider,\n        options.executor,\n        maxTextChars,\n        `Execute JavaScript against the wrapped ${provider.name} MCP tool namespace.`,\n      );\n    }\n\n    if (mode === \"both\" || mode === \"single\") {\n      registerExecuteTool(\n        server,\n        names.single,\n        provider,\n        options.executor,\n        maxTextChars,\n        `Execute JavaScript against the wrapped ${provider.name} MCP tool namespace.\\n\\n${provider.types}`,\n      );\n    }\n\n    return attachOwnedClose(server, handle.close);\n  } catch (error) {\n    await handle.close().catch(() => {});\n    throw error;\n  }\n}\n"],"mappings":"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"}

package/dist/mcp/index.d.cts

@@ -6,15 +6,23 @@ import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 //#region src/mcp/createMcpToolProvider.d.ts
 
 /**
- * Source used to discover MCP tools for wrapping.
+ * Caller-owned MCP client source used by the convenience wrapper API.
  */
-type McpToolSource = {
+type McpToolClientSource = {
   client: Client;
   serverInfo?: Implementation;
-} | {
+};
+/**
+ * Local MCP server source that requires explicit lifecycle cleanup.
+ */
+type McpToolServerSource = {
   server: McpServer;
   serverInfo?: Implementation;
 };
+/**
+ * Source used to discover MCP tools for wrapping.
+ */
+type McpToolSource = McpToolClientSource | McpToolServerSource;
 /**
  * Returns the upstream server identity when the source can provide one.
  */
@@ -44,9 +52,9 @@ interface McpToolProviderHandle {
  */
 declare function openMcpToolProvider(source: McpToolSource, options?: CreateMcpToolProviderOptions): Promise<McpToolProviderHandle>;
 /**
- * Wraps MCP tools from a client or server as a resolved execution provider.
+ * Wraps MCP tools from a caller-owned MCP client as a resolved execution provider.
  */
-declare function createMcpToolProvider(source: McpToolSource, options?: CreateMcpToolProviderOptions): Promise<ResolvedToolProvider>;
+declare function createMcpToolProvider(source: McpToolClientSource, options?: CreateMcpToolProviderOptions): Promise<ResolvedToolProvider>;
 //#endregion
 //#region src/mcp/codeMcpServer.d.ts
 /**
@@ -73,5 +81,5 @@ interface CodeMcpServerOptions extends CreateMcpToolProviderOptions {
  */
 declare function codeMcpServer(source: McpToolSource, options: CodeMcpServerOptions): Promise<McpServer>;
 //#endregion
-export { type CodeMcpServerOptions, type CreateMcpToolProviderOptions, type McpToolProviderHandle, type McpToolSource, codeMcpServer, createMcpToolProvider, getMcpToolSourceServerInfo, openMcpToolProvider };
+export { type CodeMcpServerOptions, type CreateMcpToolProviderOptions, type McpToolClientSource, type McpToolProviderHandle, type McpToolServerSource, type McpToolSource, codeMcpServer, createMcpToolProvider, getMcpToolSourceServerInfo, openMcpToolProvider };
 //# sourceMappingURL=index.d.cts.map

package/dist/mcp/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/mcp/createMcpToolProvider.ts","../../src/mcp/codeMcpServer.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAYA;AACc,KADF,aAAA,GACE;EAAqB,MAAA,EAArB,MAAqB;EACrB,UAAA,CAAA,EADqB,cACrB;CAAwB,GAAA;EAAc,MAAA,EAAtC,SAAsC;EAUpC,UAAA,CAAA,EAVsB,cAUtB;AAiBhB,CAAA;AAUA;;;AAMe,iBAjCC,0BAAA,CAiCD,MAAA,EAhCL,aAgCK,CAAA,EA/BZ,cA+BY,GAAA,SAAA;;AA2Df;;AAEW,UA7EM,4BAAA,CA6EN;EACA;EAAR,SAAA,CAAA,EAAA,MAAA;EAAO;EAsDY,UAAA,CAAA,EAhIP,cAgI4B;;;;;AAGjC,UA7HO,qBAAA,CA6HP;;YA3HE;;ECtCK,UAAA,CAAA,EDwCF,cCxCuB;EAE1B;EAEG,KAAA,EAAA,GAAA,GDsCA,OCtCA,CAAA,IAAA,CAAA;;;AAiLf;;AAEW,iBDlFW,mBAAA,CCkFX,MAAA,EDjFD,aCiFC,EAAA,OAAA,CAAA,EDhFA,4BCgFA,CAAA,ED/ER,OC+EQ,CD/EA,qBC+EA,CAAA;;;;iBDzBW,qBAAA,SACZ,yBACC,+BACR,QAAQ;;;;;AApKX;AACc,UCEG,oBAAA,SAA6B,4BDFhC,CAAA;EAAqB;EACrB,QAAA,ECGF,QDHE;EAAwB;EAAc,UAAA,CAAA,ECKrC,cDLqC;EAUpC;EAiBC,YAAA,CAAA,EAAA,MAAA;EAUA;EAEL,IAAA,CAAA,EAAA,MAAA,GAAA,QAAA,GAAA,OAAA;EAEG;EAEA,KAAA,CAAA,EAAA;IAAO,OAAA,CAAA,EAAA,MAAA;IA2DA,MAAA,CAAA,EAAA,MAAA;IACZ,MAAA,CAAA,EAAA,MAAA;EACC,CAAA;;;;AAuDX;AACU,iBCsBY,aAAA,CDtBZ,MAAA,ECuBA,aDvBA,EAAA,OAAA,ECwBC,oBDxBD,CAAA,ECyBP,ODzBO,CCyBC,SDzBD,CAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/mcp/createMcpToolProvider.ts","../../src/mcp/codeMcpServer.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAYA;AAQY,KARA,mBAAA,GAQmB;EAQnB,MAAA,EAfF,MAeE;EAUI,UAAA,CAAA,EAxBD,cAwBC;AAiBhB,CAAA;AAUA;;;AAMe,KAnDH,mBAAA,GAmDG;EAAO,MAAA,EAlDZ,SAkDY;EAqEA,UAAA,CAAA,EAtHP,cAsH0B;CAC/B;;;;AAEA,KAnHE,aAAA,GAAgB,mBAmHlB,GAnHwC,mBAmHxC;AAsDV;;;AAGW,iBAlKK,0BAAA,CAkKL,MAAA,EAjKD,aAiKC,CAAA,EAhKR,cAgKQ,GAAA,SAAA;;;;UAjJM,4BAAA;;ECxCA,SAAA,CAAA,EAAA,MAAA;EAEL;EAEG,UAAA,CAAA,EDwCA,cCxCA;;;AAqLf;;AAEW,UDzIM,qBAAA,CCyIN;EACA;EAAR,QAAA,EDxIS,oBCwIT;EAAO;eDtIK;;eAEA;;;;;iBAqEO,mBAAA,SACZ,yBACC,+BACR,QAAQ;;;;iBAsDW,qBAAA,SACZ,+BACC,+BACR,QAAQ;;;;;AA5LX;AAQY,UCLK,oBAAA,SAA6B,4BDOjB,CAAA;EAMjB;EAUI,QAAA,ECrBJ,QDqBI;EAiBC;EAUA,UAAA,CAAA,EC9CF,cD8CuB;EAE1B;EAEG,YAAA,CAAA,EAAA,MAAA;EAEA;EAAO,IAAA,CAAA,EAAA,MAAA,GAAA,QAAA,GAAA,OAAA;EAqEA;EACZ,KAAA,CAAA,EAAA;IACC,OAAA,CAAA,EAAA,MAAA;IACA,MAAA,CAAA,EAAA,MAAA;IAAR,MAAA,CAAA,EAAA,MAAA;EAAO,CAAA;AAsDV;;;;AAGG,iBCAmB,aAAA,CDAnB,MAAA,ECCO,aDDP,EAAA,OAAA,ECEQ,oBDFR,CAAA,ECGA,ODHA,CCGQ,SDHR,CAAA"}

package/dist/mcp/index.d.ts

@@ -6,15 +6,23 @@ import { Implementation } from "@modelcontextprotocol/sdk/types.js";
 //#region src/mcp/createMcpToolProvider.d.ts
 
 /**
- * Source used to discover MCP tools for wrapping.
+ * Caller-owned MCP client source used by the convenience wrapper API.
  */
-type McpToolSource = {
+type McpToolClientSource = {
   client: Client;
   serverInfo?: Implementation;
-} | {
+};
+/**
+ * Local MCP server source that requires explicit lifecycle cleanup.
+ */
+type McpToolServerSource = {
   server: McpServer;
   serverInfo?: Implementation;
 };
+/**
+ * Source used to discover MCP tools for wrapping.
+ */
+type McpToolSource = McpToolClientSource | McpToolServerSource;
 /**
  * Returns the upstream server identity when the source can provide one.
  */
@@ -44,9 +52,9 @@ interface McpToolProviderHandle {
  */
 declare function openMcpToolProvider(source: McpToolSource, options?: CreateMcpToolProviderOptions): Promise<McpToolProviderHandle>;
 /**
- * Wraps MCP tools from a client or server as a resolved execution provider.
+ * Wraps MCP tools from a caller-owned MCP client as a resolved execution provider.
  */
-declare function createMcpToolProvider(source: McpToolSource, options?: CreateMcpToolProviderOptions): Promise<ResolvedToolProvider>;
+declare function createMcpToolProvider(source: McpToolClientSource, options?: CreateMcpToolProviderOptions): Promise<ResolvedToolProvider>;
 //#endregion
 //#region src/mcp/codeMcpServer.d.ts
 /**
@@ -73,5 +81,5 @@ interface CodeMcpServerOptions extends CreateMcpToolProviderOptions {
  */
 declare function codeMcpServer(source: McpToolSource, options: CodeMcpServerOptions): Promise<McpServer>;
 //#endregion
-export { type CodeMcpServerOptions, type CreateMcpToolProviderOptions, type McpToolProviderHandle, type McpToolSource, codeMcpServer, createMcpToolProvider, getMcpToolSourceServerInfo, openMcpToolProvider };
+export { type CodeMcpServerOptions, type CreateMcpToolProviderOptions, type McpToolClientSource, type McpToolProviderHandle, type McpToolServerSource, type McpToolSource, codeMcpServer, createMcpToolProvider, getMcpToolSourceServerInfo, openMcpToolProvider };
 //# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/mcp/createMcpToolProvider.ts","../../src/mcp/codeMcpServer.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAYA;AACc,KADF,aAAA,GACE;EAAqB,MAAA,EAArB,MAAqB;EACrB,UAAA,CAAA,EADqB,cACrB;CAAwB,GAAA;EAAc,MAAA,EAAtC,SAAsC;EAUpC,UAAA,CAAA,EAVsB,cAUtB;AAiBhB,CAAA;AAUA;;;AAMe,iBAjCC,0BAAA,CAiCD,MAAA,EAhCL,aAgCK,CAAA,EA/BZ,cA+BY,GAAA,SAAA;;AA2Df;;AAEW,UA7EM,4BAAA,CA6EN;EACA;EAAR,SAAA,CAAA,EAAA,MAAA;EAAO;EAsDY,UAAA,CAAA,EAhIP,cAgI4B;;;;;AAGjC,UA7HO,qBAAA,CA6HP;;YA3HE;;ECtCK,UAAA,CAAA,EDwCF,cCxCuB;EAE1B;EAEG,KAAA,EAAA,GAAA,GDsCA,OCtCA,CAAA,IAAA,CAAA;;;AAiLf;;AAEW,iBDlFW,mBAAA,CCkFX,MAAA,EDjFD,aCiFC,EAAA,OAAA,CAAA,EDhFA,4BCgFA,CAAA,ED/ER,OC+EQ,CD/EA,qBC+EA,CAAA;;;;iBDzBW,qBAAA,SACZ,yBACC,+BACR,QAAQ;;;;;AApKX;AACc,UCEG,oBAAA,SAA6B,4BDFhC,CAAA;EAAqB;EACrB,QAAA,ECGF,QDHE;EAAwB;EAAc,UAAA,CAAA,ECKrC,cDLqC;EAUpC;EAiBC,YAAA,CAAA,EAAA,MAAA;EAUA;EAEL,IAAA,CAAA,EAAA,MAAA,GAAA,QAAA,GAAA,OAAA;EAEG;EAEA,KAAA,CAAA,EAAA;IAAO,OAAA,CAAA,EAAA,MAAA;IA2DA,MAAA,CAAA,EAAA,MAAA;IACZ,MAAA,CAAA,EAAA,MAAA;EACC,CAAA;;;;AAuDX;AACU,iBCsBY,aAAA,CDtBZ,MAAA,ECuBA,aDvBA,EAAA,OAAA,ECwBC,oBDxBD,CAAA,ECyBP,ODzBO,CCyBC,SDzBD,CAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/mcp/createMcpToolProvider.ts","../../src/mcp/codeMcpServer.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAYA;AAQY,KARA,mBAAA,GAQmB;EAQnB,MAAA,EAfF,MAeE;EAUI,UAAA,CAAA,EAxBD,cAwBC;AAiBhB,CAAA;AAUA;;;AAMe,KAnDH,mBAAA,GAmDG;EAAO,MAAA,EAlDZ,SAkDY;EAqEA,UAAA,CAAA,EAtHP,cAsH0B;CAC/B;;;;AAEA,KAnHE,aAAA,GAAgB,mBAmHlB,GAnHwC,mBAmHxC;AAsDV;;;AAGW,iBAlKK,0BAAA,CAkKL,MAAA,EAjKD,aAiKC,CAAA,EAhKR,cAgKQ,GAAA,SAAA;;;;UAjJM,4BAAA;;ECxCA,SAAA,CAAA,EAAA,MAAA;EAEL;EAEG,UAAA,CAAA,EDwCA,cCxCA;;;AAqLf;;AAEW,UDzIM,qBAAA,CCyIN;EACA;EAAR,QAAA,EDxIS,oBCwIT;EAAO;eDtIK;;eAEA;;;;;iBAqEO,mBAAA,SACZ,yBACC,+BACR,QAAQ;;;;iBAsDW,qBAAA,SACZ,+BACC,+BACR,QAAQ;;;;;AA5LX;AAQY,UCLK,oBAAA,SAA6B,4BDOjB,CAAA;EAMjB;EAUI,QAAA,ECrBJ,QDqBI;EAiBC;EAUA,UAAA,CAAA,EC9CF,cD8CuB;EAE1B;EAEG,YAAA,CAAA,EAAA,MAAA;EAEA;EAAO,IAAA,CAAA,EAAA,MAAA,GAAA,QAAA,GAAA,OAAA;EAqEA;EACZ,KAAA,CAAA,EAAA;IACC,OAAA,CAAA,EAAA,MAAA;IACA,MAAA,CAAA,EAAA,MAAA;IAAR,MAAA,CAAA,EAAA,MAAA;EAAO,CAAA;AAsDV;;;;AAGG,iBCAmB,aAAA,CDAnB,MAAA,ECCO,aDDP,EAAA,OAAA,ECEQ,oBDFR,CAAA,ECGA,ODHA,CCGQ,SDHR,CAAA"}

package/dist/mcp/index.js

@@ -60,7 +60,15 @@ async function openMcpToolClient(source, clientInfo) {
 	const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
 	const client = new Client(clientInfo);
 	let closePromise;
-	await Promise.all([source.server.connect(serverTransport), client.connect(clientTransport)]);
+	let serverConnected = false;
+	try {
+		await source.server.connect(serverTransport);
+		serverConnected = true;
+		await client.connect(clientTransport);
+	} catch (error) {
+		await Promise.allSettled([Promise.resolve().then(() => client.close()), serverConnected ? Promise.resolve().then(() => source.server.close()) : Promise.resolve()]);
+		throw error;
+	}
 	return {
 		client,
 		close: async () => {
@@ -106,9 +114,10 @@ async function openMcpToolProvider(source, options = {}) {
 	}
 }
 /**
-* Wraps MCP tools from a client or server as a resolved execution provider.
+* Wraps MCP tools from a caller-owned MCP client as a resolved execution provider.
 */
 async function createMcpToolProvider(source, options = {}) {
+	if ("server" in source) throw new Error("createMcpToolProvider() no longer accepts { server } sources. Use openMcpToolProvider() to receive a cleanup handle for owned local MCP server connections.");
 	return (await openMcpToolProvider(source, options)).provider;
 }
 

package/dist/mcp/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["closePromise: Promise<void> | undefined","provider: ToolProvider","closePromise: Promise<void> | undefined"],"sources":["../../src/mcp/mcpWrappedToolTypes.ts","../../src/mcp/createMcpToolProvider.ts","../../src/mcp/codeMcpServer.ts"],"sourcesContent":["import type { ResolvedToolProvider } from \"../types\";\nimport { schemaToType } from \"../typegen/jsonSchema\";\nimport {\n  renderDocComment,\n  renderNamespaceDeclaration,\n} from \"../typegen/render\";\n\nconst MCP_CALL_TOOL_RESULT_TYPE = [\n  \"type McpCallToolResult = {\",\n  \"  content: Array<{\",\n  \"    type: string;\",\n  \"    text?: string;\",\n  \"    data?: string;\",\n  \"    mimeType?: string;\",\n  \"    resource?: unknown;\",\n  \"    uri?: string;\",\n  \"    name?: string;\",\n  \"    description?: string;\",\n  \"  }>;\",\n  \"  structuredContent?: unknown;\",\n  \"  isError?: boolean;\",\n  \"  _meta?: Record<string, unknown>;\",\n  \"};\",\n].join(\"\\n\");\n\n/**\n * Generates the wrapped MCP tool namespace declarations exposed to guest code.\n */\nexport function generateMcpWrappedToolTypes(\n  provider: ResolvedToolProvider,\n): string {\n  const declarations = [MCP_CALL_TOOL_RESULT_TYPE];\n\n  for (const [safeName, tool] of Object.entries(provider.tools)) {\n    const comment = renderDocComment([\n      ...(tool.description ? [tool.description, \"\"] : []),\n      \"Wrapped MCP tool. Inspect structuredContent first, then fall back to content text items.\",\n    ]);\n\n    declarations.push(\n      [\n        comment,\n        `function ${safeName}(input: ${schemaToType(tool.inputSchema)}): Promise<McpCallToolResult>;`,\n      ]\n        .filter(Boolean)\n        .join(\"\\n\"),\n    );\n  }\n\n  return renderNamespaceDeclaration(provider.name, declarations);\n}\n","import { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport { InMemoryTransport } from \"@modelcontextprotocol/sdk/inMemory.js\";\nimport type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport type { Implementation } from \"@modelcontextprotocol/sdk/types.js\";\n\nimport { resolveProvider } from \"../provider/resolveProvider\";\nimport type { ResolvedToolProvider, ToolProvider } from \"../types\";\nimport { generateMcpWrappedToolTypes } from \"./mcpWrappedToolTypes\";\n\n/**\n * Source used to discover MCP tools for wrapping.\n */\nexport type McpToolSource =\n  | { client: Client; serverInfo?: Implementation }\n  | { server: McpServer; serverInfo?: Implementation };\n\nconst DEFAULT_MCP_TOOL_CLIENT_INFO = {\n  name: \"mcp-tool-client\",\n  version: \"0.0.0\",\n} satisfies Implementation;\n\n/**\n * Returns the upstream server identity when the source can provide one.\n */\nexport function getMcpToolSourceServerInfo(\n  source: McpToolSource,\n): Implementation | undefined {\n  if (source.serverInfo) {\n    return source.serverInfo;\n  }\n\n  if (\"client\" in source) {\n    return source.client.getServerVersion();\n  }\n\n  return undefined;\n}\n\n/**\n * Options for wrapping MCP tools into a code-execution provider.\n */\nexport interface CreateMcpToolProviderOptions {\n  /** Namespace exposed to guest code for the wrapped tools. */\n  namespace?: string;\n  /** Implementation metadata exposed to local `{ server }` sources as the client identity. */\n  clientInfo?: Implementation;\n}\n\n/**\n * Explicit handle for a wrapped MCP provider and any owned source connections.\n */\nexport interface McpToolProviderHandle {\n  /** Resolved provider exposed to the executor or wrapper server. */\n  provider: ResolvedToolProvider;\n  /** Best-effort upstream server identity when available. */\n  serverInfo?: Implementation;\n  /** Releases any internal MCP client/server connection opened for the provider. */\n  close: () => Promise<void>;\n}\n\ninterface OpenMcpToolClientResult {\n  client: Client;\n  close: () => Promise<void>;\n}\n\nasync function closeAll(closers: Array<() => Promise<void>>): Promise<void> {\n  const results = await Promise.allSettled(closers.map((close) => close()));\n  const rejected = results.find(\n    (result): result is PromiseRejectedResult => result.status === \"rejected\",\n  );\n\n  if (rejected) {\n    throw rejected.reason;\n  }\n}\n\nasync function openMcpToolClient(\n  source: McpToolSource,\n  clientInfo: Implementation,\n): Promise<OpenMcpToolClientResult> {\n  if (\"client\" in source) {\n    return {\n      client: source.client,\n      close: async () => {},\n    };\n  }\n\n  if (source.server.isConnected()) {\n    throw new Error(\"{ server } sources must be unconnected local MCP servers\");\n  }\n\n  const [clientTransport, serverTransport] =\n    InMemoryTransport.createLinkedPair();\n  const client = new Client(clientInfo);\n  let closePromise: Promise<void> | undefined;\n\n  await Promise.all([\n    source.server.connect(serverTransport),\n    client.connect(clientTransport),\n  ]);\n\n  return {\n    client,\n    close: async () => {\n      closePromise ??= closeAll([\n        () => client.close(),\n        () => source.server.close(),\n      ]);\n      return closePromise;\n    },\n  };\n}\n\n/**\n * Opens an MCP tool source as a resolved execution provider with explicit cleanup.\n */\nexport async function openMcpToolProvider(\n  source: McpToolSource,\n  options: CreateMcpToolProviderOptions = {},\n): Promise<McpToolProviderHandle> {\n  const connection = await openMcpToolClient(\n    source,\n    options.clientInfo ?? DEFAULT_MCP_TOOL_CLIENT_INFO,\n  );\n\n  try {\n    const toolsResponse = await connection.client.listTools();\n    const provider: ToolProvider = {\n      name: options.namespace ?? \"mcp\",\n      tools: {},\n    };\n\n    for (const tool of toolsResponse.tools) {\n      provider.tools[tool.name] = {\n        description: tool.description,\n        execute: async (input, context) => {\n          const argumentsObject =\n            typeof input === \"object\" && input !== null\n              ? (input as Record<string, unknown>)\n              : undefined;\n\n          return connection.client.callTool(\n            {\n              arguments: argumentsObject,\n              name: tool.name,\n            },\n            undefined,\n            { signal: context.signal },\n          );\n        },\n        inputSchema: tool.inputSchema,\n      };\n    }\n\n    const resolvedProvider = resolveProvider(provider);\n\n    return {\n      close: connection.close,\n      provider: {\n        ...resolvedProvider,\n        types: generateMcpWrappedToolTypes(resolvedProvider),\n      },\n      serverInfo: getMcpToolSourceServerInfo(source),\n    };\n  } catch (error) {\n    await connection.close().catch(() => {});\n    throw error;\n  }\n}\n\n/**\n * Wraps MCP tools from a client or server as a resolved execution provider.\n */\nexport async function createMcpToolProvider(\n  source: McpToolSource,\n  options: CreateMcpToolProviderOptions = {},\n): Promise<ResolvedToolProvider> {\n  const handle = await openMcpToolProvider(source, options);\n  return handle.provider;\n}\n","import { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport type { Implementation } from \"@modelcontextprotocol/sdk/types.js\";\nimport * as z from \"zod\";\n\nimport type { Executor } from \"../executor/executor\";\nimport type { ResolvedToolProvider } from \"../types\";\nimport {\n  openMcpToolProvider,\n  type CreateMcpToolProviderOptions,\n  type McpToolSource,\n} from \"./createMcpToolProvider\";\n\n/**\n * Options for exposing wrapped MCP tool execution through an MCP server.\n */\nexport interface CodeMcpServerOptions extends CreateMcpToolProviderOptions {\n  /** Executor used to run guest JavaScript against the wrapped provider. */\n  executor: Executor;\n  /** Implementation metadata exposed to downstream clients as the wrapper server identity. */\n  serverInfo?: Implementation;\n  /** Maximum number of text characters returned in text content blocks. */\n  maxTextChars?: number;\n  /** Wrapper tool layout to expose on the returned server. */\n  mode?: \"both\" | \"single\" | \"split\";\n  /** Optional custom names for the wrapper tools. */\n  names?: {\n    execute?: string;\n    search?: string;\n    single?: string;\n  };\n}\n\nconst DEFAULT_MAX_TEXT_CHARS = 24_000;\nconst DEFAULT_MCP_CODE_WRAPPER_SERVER_INFO = {\n  name: \"mcp-code-wrapper\",\n  version: \"0.0.0\",\n} satisfies Implementation;\n\nfunction truncateText(text: string, maxTextChars: number): string {\n  return text.length <= maxTextChars ? text : text.slice(0, maxTextChars);\n}\n\nfunction renderText(value: unknown, maxTextChars: number): string {\n  return truncateText(JSON.stringify(value, null, 2), maxTextChars);\n}\n\nfunction searchTools(\n  provider: ResolvedToolProvider,\n  query: string | undefined,\n  limit: number,\n): Record<string, unknown> {\n  const normalizedQuery = query?.toLowerCase().trim();\n  const matches = Object.entries(provider.tools)\n    .map(([safeName, descriptor]) => ({\n      description: descriptor.description,\n      inputSchema: descriptor.inputSchema,\n      originalName: descriptor.originalName,\n      outputSchema: descriptor.outputSchema,\n      safeName,\n    }))\n    .filter((tool) => {\n      if (!normalizedQuery) {\n        return true;\n      }\n\n      return [tool.originalName, tool.safeName, tool.description ?? \"\"].some(\n        (field) => field.toLowerCase().includes(normalizedQuery),\n      );\n    })\n    .slice(0, limit);\n\n  return {\n    namespace: provider.name,\n    originalToSafeName: provider.originalToSafeName,\n    safeToOriginalName: provider.safeToOriginalName,\n    tools: matches,\n    types: provider.types,\n  };\n}\n\nfunction registerExecuteTool(\n  server: McpServer,\n  name: string,\n  provider: ResolvedToolProvider,\n  executor: Executor,\n  maxTextChars: number,\n  description: string,\n): void {\n  const registerTool = server.registerTool.bind(server) as (\n    toolName: string,\n    config: {\n      description: string;\n      inputSchema: Record<string, z.ZodTypeAny>;\n    },\n    handler: (args: { code: string }) => Promise<{\n      content: Array<{ text: string; type: \"text\" }>;\n      isError: boolean;\n      structuredContent: Record<string, unknown>;\n    }>,\n  ) => void;\n\n  registerTool(\n    name,\n    {\n      description,\n      inputSchema: {\n        code: z.string(),\n      },\n    },\n    async (args: { code: string }) => {\n      const execution = await executor.execute(args.code, [provider]);\n\n      return {\n        content: [{ text: renderText(execution, maxTextChars), type: \"text\" }],\n        isError: !execution.ok,\n        structuredContent: execution as Record<string, unknown>,\n      };\n    },\n  );\n}\n\nfunction registerSearchTool(\n  server: McpServer,\n  name: string,\n  provider: ResolvedToolProvider,\n  maxTextChars: number,\n): void {\n  const registerTool = server.registerTool.bind(server) as (\n    toolName: string,\n    config: {\n      description: string;\n      inputSchema: Record<string, z.ZodTypeAny>;\n    },\n    handler: (args: { limit?: number; query?: string }) => Promise<{\n      content: Array<{ text: string; type: \"text\" }>;\n      structuredContent: Record<string, unknown>;\n    }>,\n  ) => void;\n\n  registerTool(\n    name,\n    {\n      description: `Search wrapped MCP tools exposed under the ${provider.name} namespace.`,\n      inputSchema: {\n        limit: z.number().int().optional(),\n        query: z.string().optional(),\n      },\n    },\n    async (args: { limit?: number; query?: string }) => {\n      const structuredContent = searchTools(\n        provider,\n        args.query,\n        args.limit ?? 20,\n      );\n      return {\n        content: [\n          { text: renderText(structuredContent, maxTextChars), type: \"text\" },\n        ],\n        structuredContent,\n      };\n    },\n  );\n}\n\nfunction attachOwnedClose(\n  server: McpServer,\n  closeOwnedResources: () => Promise<void>,\n): McpServer {\n  const originalClose = server.close.bind(server);\n  let closePromise: Promise<void> | undefined;\n\n  server.close = async () => {\n    closePromise ??= (async () => {\n      const results = await Promise.allSettled([\n        originalClose(),\n        closeOwnedResources(),\n      ]);\n      const rejected = results.find(\n        (result): result is PromiseRejectedResult =>\n          result.status === \"rejected\",\n      );\n\n      if (rejected) {\n        throw rejected.reason;\n      }\n    })();\n\n    return closePromise;\n  };\n\n  return server;\n}\n\n/**\n * Creates an MCP server that exposes code-execution tools for a wrapped MCP source.\n */\nexport async function codeMcpServer(\n  source: McpToolSource,\n  options: CodeMcpServerOptions,\n): Promise<McpServer> {\n  const maxTextChars = options.maxTextChars ?? DEFAULT_MAX_TEXT_CHARS;\n  const mode = options.mode ?? \"both\";\n  const names = {\n    execute: options.names?.execute ?? \"mcp_execute_code\",\n    search: options.names?.search ?? \"mcp_search_tools\",\n    single: options.names?.single ?? \"mcp_code\",\n  };\n  const handle = await openMcpToolProvider(source, {\n    clientInfo: options.clientInfo,\n    namespace: options.namespace ?? \"mcp\",\n  });\n  const provider = handle.provider;\n  const server = new McpServer(\n    options.serverInfo ??\n      handle.serverInfo ??\n      DEFAULT_MCP_CODE_WRAPPER_SERVER_INFO,\n  );\n\n  try {\n    if (mode === \"both\" || mode === \"split\") {\n      registerSearchTool(server, names.search, provider, maxTextChars);\n      registerExecuteTool(\n        server,\n        names.execute,\n        provider,\n        options.executor,\n        maxTextChars,\n        `Execute JavaScript against the wrapped ${provider.name} MCP tool namespace.`,\n      );\n    }\n\n    if (mode === \"both\" || mode === \"single\") {\n      registerExecuteTool(\n        server,\n        names.single,\n        provider,\n        options.executor,\n        maxTextChars,\n        `Execute JavaScript against the wrapped ${provider.name} MCP tool namespace.\\n\\n${provider.types}`,\n      );\n    }\n\n    return attachOwnedClose(server, handle.close);\n  } catch (error) {\n    await handle.close().catch(() => {});\n    throw error;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["closePromise: Promise<void> | undefined","provider: ToolProvider","closePromise: Promise<void> | undefined"],"sources":["../../src/mcp/mcpWrappedToolTypes.ts","../../src/mcp/createMcpToolProvider.ts","../../src/mcp/codeMcpServer.ts"],"sourcesContent":["import type { ResolvedToolProvider } from \"../types\";\nimport { schemaToType } from \"../typegen/jsonSchema\";\nimport {\n  renderDocComment,\n  renderNamespaceDeclaration,\n} from \"../typegen/render\";\n\nconst MCP_CALL_TOOL_RESULT_TYPE = [\n  \"type McpCallToolResult = {\",\n  \"  content: Array<{\",\n  \"    type: string;\",\n  \"    text?: string;\",\n  \"    data?: string;\",\n  \"    mimeType?: string;\",\n  \"    resource?: unknown;\",\n  \"    uri?: string;\",\n  \"    name?: string;\",\n  \"    description?: string;\",\n  \"  }>;\",\n  \"  structuredContent?: unknown;\",\n  \"  isError?: boolean;\",\n  \"  _meta?: Record<string, unknown>;\",\n  \"};\",\n].join(\"\\n\");\n\n/**\n * Generates the wrapped MCP tool namespace declarations exposed to guest code.\n */\nexport function generateMcpWrappedToolTypes(\n  provider: ResolvedToolProvider,\n): string {\n  const declarations = [MCP_CALL_TOOL_RESULT_TYPE];\n\n  for (const [safeName, tool] of Object.entries(provider.tools)) {\n    const comment = renderDocComment([\n      ...(tool.description ? [tool.description, \"\"] : []),\n      \"Wrapped MCP tool. Inspect structuredContent first, then fall back to content text items.\",\n    ]);\n\n    declarations.push(\n      [\n        comment,\n        `function ${safeName}(input: ${schemaToType(tool.inputSchema)}): Promise<McpCallToolResult>;`,\n      ]\n        .filter(Boolean)\n        .join(\"\\n\"),\n    );\n  }\n\n  return renderNamespaceDeclaration(provider.name, declarations);\n}\n","import { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport { InMemoryTransport } from \"@modelcontextprotocol/sdk/inMemory.js\";\nimport type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport type { Implementation } from \"@modelcontextprotocol/sdk/types.js\";\n\nimport { resolveProvider } from \"../provider/resolveProvider\";\nimport type { ResolvedToolProvider, ToolProvider } from \"../types\";\nimport { generateMcpWrappedToolTypes } from \"./mcpWrappedToolTypes\";\n\n/**\n * Caller-owned MCP client source used by the convenience wrapper API.\n */\nexport type McpToolClientSource = {\n  client: Client;\n  serverInfo?: Implementation;\n};\n\n/**\n * Local MCP server source that requires explicit lifecycle cleanup.\n */\nexport type McpToolServerSource = {\n  server: McpServer;\n  serverInfo?: Implementation;\n};\n\n/**\n * Source used to discover MCP tools for wrapping.\n */\nexport type McpToolSource = McpToolClientSource | McpToolServerSource;\n\nconst DEFAULT_MCP_TOOL_CLIENT_INFO = {\n  name: \"mcp-tool-client\",\n  version: \"0.0.0\",\n} satisfies Implementation;\n\n/**\n * Returns the upstream server identity when the source can provide one.\n */\nexport function getMcpToolSourceServerInfo(\n  source: McpToolSource,\n): Implementation | undefined {\n  if (source.serverInfo) {\n    return source.serverInfo;\n  }\n\n  if (\"client\" in source) {\n    return source.client.getServerVersion();\n  }\n\n  return undefined;\n}\n\n/**\n * Options for wrapping MCP tools into a code-execution provider.\n */\nexport interface CreateMcpToolProviderOptions {\n  /** Namespace exposed to guest code for the wrapped tools. */\n  namespace?: string;\n  /** Implementation metadata exposed to local `{ server }` sources as the client identity. */\n  clientInfo?: Implementation;\n}\n\n/**\n * Explicit handle for a wrapped MCP provider and any owned source connections.\n */\nexport interface McpToolProviderHandle {\n  /** Resolved provider exposed to the executor or wrapper server. */\n  provider: ResolvedToolProvider;\n  /** Best-effort upstream server identity when available. */\n  serverInfo?: Implementation;\n  /** Releases any internal MCP client/server connection opened for the provider. */\n  close: () => Promise<void>;\n}\n\ninterface OpenMcpToolClientResult {\n  client: Client;\n  close: () => Promise<void>;\n}\n\nasync function closeAll(closers: Array<() => Promise<void>>): Promise<void> {\n  const results = await Promise.allSettled(closers.map((close) => close()));\n  const rejected = results.find(\n    (result): result is PromiseRejectedResult => result.status === \"rejected\",\n  );\n\n  if (rejected) {\n    throw rejected.reason;\n  }\n}\n\nasync function openMcpToolClient(\n  source: McpToolSource,\n  clientInfo: Implementation,\n): Promise<OpenMcpToolClientResult> {\n  if (\"client\" in source) {\n    return {\n      client: source.client,\n      close: async () => {},\n    };\n  }\n\n  if (source.server.isConnected()) {\n    throw new Error(\"{ server } sources must be unconnected local MCP servers\");\n  }\n\n  const [clientTransport, serverTransport] =\n    InMemoryTransport.createLinkedPair();\n  const client = new Client(clientInfo);\n  let closePromise: Promise<void> | undefined;\n  let serverConnected = false;\n\n  try {\n    await source.server.connect(serverTransport);\n    serverConnected = true;\n    await client.connect(clientTransport);\n  } catch (error) {\n    await Promise.allSettled([\n      Promise.resolve().then(() => client.close()),\n      serverConnected\n        ? Promise.resolve().then(() => source.server.close())\n        : Promise.resolve(),\n    ]);\n    throw error;\n  }\n\n  return {\n    client,\n    close: async () => {\n      closePromise ??= closeAll([\n        () => client.close(),\n        () => source.server.close(),\n      ]);\n      return closePromise;\n    },\n  };\n}\n\n/**\n * Opens an MCP tool source as a resolved execution provider with explicit cleanup.\n */\nexport async function openMcpToolProvider(\n  source: McpToolSource,\n  options: CreateMcpToolProviderOptions = {},\n): Promise<McpToolProviderHandle> {\n  const connection = await openMcpToolClient(\n    source,\n    options.clientInfo ?? DEFAULT_MCP_TOOL_CLIENT_INFO,\n  );\n\n  try {\n    const toolsResponse = await connection.client.listTools();\n    const provider: ToolProvider = {\n      name: options.namespace ?? \"mcp\",\n      tools: {},\n    };\n\n    for (const tool of toolsResponse.tools) {\n      provider.tools[tool.name] = {\n        description: tool.description,\n        execute: async (input, context) => {\n          const argumentsObject =\n            typeof input === \"object\" && input !== null\n              ? (input as Record<string, unknown>)\n              : undefined;\n\n          return connection.client.callTool(\n            {\n              arguments: argumentsObject,\n              name: tool.name,\n            },\n            undefined,\n            { signal: context.signal },\n          );\n        },\n        inputSchema: tool.inputSchema,\n      };\n    }\n\n    const resolvedProvider = resolveProvider(provider);\n\n    return {\n      close: connection.close,\n      provider: {\n        ...resolvedProvider,\n        types: generateMcpWrappedToolTypes(resolvedProvider),\n      },\n      serverInfo: getMcpToolSourceServerInfo(source),\n    };\n  } catch (error) {\n    await connection.close().catch(() => {});\n    throw error;\n  }\n}\n\n/**\n * Wraps MCP tools from a caller-owned MCP client as a resolved execution provider.\n */\nexport async function createMcpToolProvider(\n  source: McpToolClientSource,\n  options: CreateMcpToolProviderOptions = {},\n): Promise<ResolvedToolProvider> {\n  if (\"server\" in (source as unknown as McpToolSource)) {\n    throw new Error(\n      \"createMcpToolProvider() no longer accepts { server } sources. Use openMcpToolProvider() to receive a cleanup handle for owned local MCP server connections.\",\n    );\n  }\n\n  const handle = await openMcpToolProvider(source, options);\n  return handle.provider;\n}\n","import { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport type { Implementation } from \"@modelcontextprotocol/sdk/types.js\";\nimport * as z from \"zod\";\n\nimport type { Executor } from \"../executor/executor\";\nimport type { ResolvedToolProvider } from \"../types\";\nimport {\n  openMcpToolProvider,\n  type CreateMcpToolProviderOptions,\n  type McpToolSource,\n} from \"./createMcpToolProvider\";\n\n/**\n * Options for exposing wrapped MCP tool execution through an MCP server.\n */\nexport interface CodeMcpServerOptions extends CreateMcpToolProviderOptions {\n  /** Executor used to run guest JavaScript against the wrapped provider. */\n  executor: Executor;\n  /** Implementation metadata exposed to downstream clients as the wrapper server identity. */\n  serverInfo?: Implementation;\n  /** Maximum number of text characters returned in text content blocks. */\n  maxTextChars?: number;\n  /** Wrapper tool layout to expose on the returned server. */\n  mode?: \"both\" | \"single\" | \"split\";\n  /** Optional custom names for the wrapper tools. */\n  names?: {\n    execute?: string;\n    search?: string;\n    single?: string;\n  };\n}\n\nconst DEFAULT_MAX_TEXT_CHARS = 24_000;\nconst DEFAULT_MCP_CODE_WRAPPER_SERVER_INFO = {\n  name: \"mcp-code-wrapper\",\n  version: \"0.0.0\",\n} satisfies Implementation;\n\nfunction truncateText(text: string, maxTextChars: number): string {\n  return text.length <= maxTextChars ? text : text.slice(0, maxTextChars);\n}\n\nfunction renderText(value: unknown, maxTextChars: number): string {\n  return truncateText(JSON.stringify(value, null, 2), maxTextChars);\n}\n\nfunction searchTools(\n  provider: ResolvedToolProvider,\n  query: string | undefined,\n  limit: number,\n): Record<string, unknown> {\n  const normalizedQuery = query?.toLowerCase().trim();\n  const matches = Object.entries(provider.tools)\n    .map(([safeName, descriptor]) => ({\n      description: descriptor.description,\n      inputSchema: descriptor.inputSchema,\n      originalName: descriptor.originalName,\n      outputSchema: descriptor.outputSchema,\n      safeName,\n    }))\n    .filter((tool) => {\n      if (!normalizedQuery) {\n        return true;\n      }\n\n      return [tool.originalName, tool.safeName, tool.description ?? \"\"].some(\n        (field) => field.toLowerCase().includes(normalizedQuery),\n      );\n    })\n    .slice(0, limit);\n\n  return {\n    namespace: provider.name,\n    originalToSafeName: provider.originalToSafeName,\n    safeToOriginalName: provider.safeToOriginalName,\n    tools: matches,\n    types: provider.types,\n  };\n}\n\nfunction registerExecuteTool(\n  server: McpServer,\n  name: string,\n  provider: ResolvedToolProvider,\n  executor: Executor,\n  maxTextChars: number,\n  description: string,\n): void {\n  // Cast required: McpServer.registerTool's generic signature doesn't support\n  // the narrow input/output shape we need for the code-execution tool.\n  const registerTool = server.registerTool.bind(server) as (\n    toolName: string,\n    config: {\n      description: string;\n      inputSchema: Record<string, z.ZodTypeAny>;\n    },\n    handler: (args: { code: string }) => Promise<{\n      content: Array<{ text: string; type: \"text\" }>;\n      isError: boolean;\n      structuredContent: Record<string, unknown>;\n    }>,\n  ) => void;\n\n  registerTool(\n    name,\n    {\n      description,\n      inputSchema: {\n        code: z.string(),\n      },\n    },\n    async (args: { code: string }) => {\n      const execution = await executor.execute(args.code, [provider]);\n\n      return {\n        content: [{ text: renderText(execution, maxTextChars), type: \"text\" }],\n        isError: !execution.ok,\n        // ExecuteResult is JSON-safe; cast satisfies the SDK's generic record type.\n        structuredContent: execution as Record<string, unknown>,\n      };\n    },\n  );\n}\n\nfunction registerSearchTool(\n  server: McpServer,\n  name: string,\n  provider: ResolvedToolProvider,\n  maxTextChars: number,\n): void {\n  // Cast required: same rationale as registerExecuteTool above.\n  const registerTool = server.registerTool.bind(server) as (\n    toolName: string,\n    config: {\n      description: string;\n      inputSchema: Record<string, z.ZodTypeAny>;\n    },\n    handler: (args: { limit?: number; query?: string }) => Promise<{\n      content: Array<{ text: string; type: \"text\" }>;\n      structuredContent: Record<string, unknown>;\n    }>,\n  ) => void;\n\n  registerTool(\n    name,\n    {\n      description: `Search wrapped MCP tools exposed under the ${provider.name} namespace.`,\n      inputSchema: {\n        limit: z.number().int().optional(),\n        query: z.string().optional(),\n      },\n    },\n    async (args: { limit?: number; query?: string }) => {\n      const structuredContent = searchTools(\n        provider,\n        args.query,\n        args.limit ?? 20,\n      );\n      return {\n        content: [\n          { text: renderText(structuredContent, maxTextChars), type: \"text\" },\n        ],\n        structuredContent,\n      };\n    },\n  );\n}\n\nfunction attachOwnedClose(\n  server: McpServer,\n  closeOwnedResources: () => Promise<void>,\n): McpServer {\n  const originalClose = server.close.bind(server);\n  let closePromise: Promise<void> | undefined;\n\n  server.close = async () => {\n    closePromise ??= (async () => {\n      const results = await Promise.allSettled([\n        originalClose(),\n        closeOwnedResources(),\n      ]);\n      const rejected = results.find(\n        (result): result is PromiseRejectedResult =>\n          result.status === \"rejected\",\n      );\n\n      if (rejected) {\n        throw rejected.reason;\n      }\n    })();\n\n    return closePromise;\n  };\n\n  return server;\n}\n\n/**\n * Creates an MCP server that exposes code-execution tools for a wrapped MCP source.\n */\nexport async function codeMcpServer(\n  source: McpToolSource,\n  options: CodeMcpServerOptions,\n): Promise<McpServer> {\n  const maxTextChars = options.maxTextChars ?? DEFAULT_MAX_TEXT_CHARS;\n  const mode = options.mode ?? \"both\";\n  const names = {\n    execute: options.names?.execute ?? \"mcp_execute_code\",\n    search: options.names?.search ?? \"mcp_search_tools\",\n    single: options.names?.single ?? \"mcp_code\",\n  };\n  const handle = await openMcpToolProvider(source, {\n    clientInfo: options.clientInfo,\n    namespace: options.namespace ?? \"mcp\",\n  });\n  const provider = handle.provider;\n  const server = new McpServer(\n    options.serverInfo ??\n      handle.serverInfo ??\n      DEFAULT_MCP_CODE_WRAPPER_SERVER_INFO,\n  );\n\n  try {\n    if (mode === \"both\" || mode === \"split\") {\n      registerSearchTool(server, names.search, provider, maxTextChars);\n      registerExecuteTool(\n        server,\n        names.execute,\n        provider,\n        options.executor,\n        maxTextChars,\n        `Execute JavaScript against the wrapped ${provider.name} MCP tool namespace.`,\n      );\n    }\n\n    if (mode === \"both\" || mode === \"single\") {\n      registerExecuteTool(\n        server,\n        names.single,\n        provider,\n        options.executor,\n        maxTextChars,\n        `Execute JavaScript against the wrapped ${provider.name} MCP tool namespace.\\n\\n${provider.types}`,\n      );\n    }\n\n    return attachOwnedClose(server, handle.close);\n  } catch (error) {\n    await handle.close().catch(() => {});\n    throw error;\n  }\n}\n"],"mappings":"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"}

package/dist/resolveProvider-CUxAvFCK.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolveProvider-CUxAvFCK.js","names":["isRecord","lines: string[]","originalToSafeName: Record<string, string>","safeToOriginalName: Record<string, string>","resolvedTools: Record<string, ResolvedToolDescriptor>","typegenTools: Record<string, TypegenToolDescriptor>"],"sources":["../src/identifier.ts","../src/sanitize.ts","../src/errors.ts","../src/schema/normalizeSchema.ts","../src/typegen/render.ts","../src/typegen/jsonSchema.ts","../src/provider/resolveProvider.ts"],"sourcesContent":["const RESERVED_WORDS = new Set([\n  \"await\",\n  \"break\",\n  \"case\",\n  \"catch\",\n  \"class\",\n  \"const\",\n  \"continue\",\n  \"debugger\",\n  \"default\",\n  \"delete\",\n  \"do\",\n  \"else\",\n  \"enum\",\n  \"export\",\n  \"extends\",\n  \"false\",\n  \"finally\",\n  \"for\",\n  \"function\",\n  \"if\",\n  \"import\",\n  \"in\",\n  \"instanceof\",\n  \"new\",\n  \"null\",\n  \"return\",\n  \"super\",\n  \"switch\",\n  \"this\",\n  \"throw\",\n  \"true\",\n  \"try\",\n  \"typeof\",\n  \"var\",\n  \"void\",\n  \"while\",\n  \"with\",\n  \"yield\",\n]);\n\n/**\n * Returns whether the value is a valid JavaScript identifier.\n */\nexport function isValidIdentifier(value: string): boolean {\n  return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(value);\n}\n\n/**\n * Returns whether the identifier is reserved in JavaScript source.\n */\nexport function isReservedWord(value: string): boolean {\n  return RESERVED_WORDS.has(value);\n}\n\n/**\n * Throws when the value cannot be used as a bare JavaScript identifier.\n */\nexport function assertValidIdentifier(\n  value: string,\n  label = \"identifier\",\n): void {\n  if (!isValidIdentifier(value) || isReservedWord(value)) {\n    throw new Error(`Invalid ${label}: ${value}`);\n  }\n}\n\n/**\n * Converts a raw identifier-like value into a safe JavaScript identifier.\n */\nexport function sanitizeIdentifier(value: string): string {\n  const sanitized = value\n    .trim()\n    .replace(/[^A-Za-z0-9_$]+/g, \"_\")\n    .replace(/^_+|_+$/g, \"\");\n\n  let safeName = sanitized.length > 0 ? sanitized : \"_\";\n\n  if (/^[0-9]/.test(safeName)) {\n    safeName = `_${safeName}`;\n  }\n\n  if (isReservedWord(safeName)) {\n    safeName = `${safeName}_`;\n  }\n\n  return safeName;\n}\n\n/**\n * Renders the name as a bare identifier when possible, otherwise as a string literal.\n */\nexport function serializePropertyName(name: string): string {\n  return isValidIdentifier(name) ? name : JSON.stringify(name);\n}\n","import { sanitizeIdentifier } from \"./identifier\";\n\n/**\n * Converts a raw tool name into a safe JavaScript identifier.\n */\nexport function sanitizeToolName(name: string): string {\n  return sanitizeIdentifier(name);\n}\n","import type { ExecuteErrorCode } from \"./types\";\n\n/**\n * Structured failure used internally to propagate executor and tool errors.\n */\nexport class ExecuteFailure extends Error {\n  code: ExecuteErrorCode;\n\n  /**\n   * Creates a structured failure with a trusted executor or tool error code.\n   */\n  constructor(code: ExecuteErrorCode, message: string) {\n    super(message);\n    this.code = code;\n    this.name = \"ExecuteFailure\";\n  }\n}\n\n/**\n * Returns whether a thrown value is an {@link ExecuteFailure}.\n */\nexport function isExecuteFailure(value: unknown): value is ExecuteFailure {\n  return value instanceof ExecuteFailure;\n}\n\n/**\n * Returns whether a value can be serialized through the JSON-only host/guest boundary.\n */\nexport function isJsonSerializable(\n  value: unknown,\n  active = new Set<object>(),\n  memo = new WeakSet<object>(),\n): boolean {\n  if (value === null) {\n    return true;\n  }\n\n  switch (typeof value) {\n    case \"string\":\n    case \"boolean\":\n      return true;\n    case \"number\":\n      return Number.isFinite(value);\n    case \"bigint\":\n    case \"function\":\n    case \"symbol\":\n    case \"undefined\":\n      return false;\n    case \"object\": {\n      const objectValue = value as object;\n\n      if (memo.has(objectValue)) {\n        return true;\n      }\n\n      if (active.has(objectValue)) {\n        return false;\n      }\n\n      active.add(objectValue);\n      let isSerializable = false;\n\n      try {\n        if (Array.isArray(value)) {\n          isSerializable = value.every((item) =>\n            isJsonSerializable(item, active, memo),\n          );\n          return isSerializable;\n        }\n\n        const prototype = Object.getPrototypeOf(value);\n        if (prototype !== Object.prototype && prototype !== null) {\n          return false;\n        }\n\n        isSerializable = Object.values(value).every((item) =>\n          isJsonSerializable(item, active, memo),\n        );\n        return isSerializable;\n      } finally {\n        active.delete(objectValue);\n        if (isSerializable) {\n          memo.add(objectValue);\n        }\n      }\n    }\n  }\n\n  return false;\n}\n","import * as zod from \"zod\";\nimport type { ZodRawShape, ZodTypeAny } from \"zod\";\n\nimport type { JsonSchema, ToolSchema } from \"../types\";\n\nconst z = \"z\" in zod && typeof zod.z === \"object\" ? zod.z : zod;\nconst toJsonSchema =\n  (\"toJSONSchema\" in zod ? zod.toJSONSchema : undefined) ??\n  (\"toJSONSchema\" in z ? z.toJSONSchema : undefined);\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction isZodSchema(value: unknown): value is ZodTypeAny {\n  return isRecord(value) && typeof value.safeParse === \"function\";\n}\n\nfunction isZodRawShape(value: unknown): value is ZodRawShape {\n  return (\n    isRecord(value) &&\n    Object.keys(value).length > 0 &&\n    Object.values(value).every(isZodSchema)\n  );\n}\n\nfunction normalizeZodSchema(schema: ZodTypeAny): JsonSchema {\n  if (typeof toJsonSchema !== \"function\") {\n    throw new Error(\"Installed zod package does not expose toJSONSchema\");\n  }\n\n  const jsonSchema = toJsonSchema(schema) as JsonSchema & {\n    $schema?: string;\n  };\n\n  if (\"$schema\" in jsonSchema) {\n    const { $schema: _ignored, ...rest } = jsonSchema;\n    return rest;\n  }\n\n  return jsonSchema;\n}\n\n/**\n * Normalizes supported tool schema inputs to the JSON Schema form used internally.\n */\nexport function normalizeToolSchema(\n  schema: ToolSchema | undefined,\n  phase: \"input\" | \"output\",\n  toolName: string,\n): JsonSchema | undefined {\n  if (schema === undefined) {\n    return undefined;\n  }\n\n  if (isZodSchema(schema)) {\n    return normalizeZodSchema(schema);\n  }\n\n  if (isZodRawShape(schema)) {\n    return normalizeZodSchema(z.object(schema));\n  }\n\n  if (isRecord(schema)) {\n    return schema;\n  }\n\n  throw new Error(\n    `Unsupported ${phase} schema for tool ${toolName}. Expected JSON Schema, a Zod schema, or an MCP-style Zod shape.`,\n  );\n}\n","/**\n * Indents each line of the given string by a specified number of levels.\n */\nexport function indent(value: string, level = 1): string {\n  return value\n    .split(\"\\n\")\n    .map((line) => `${\"  \".repeat(level)}${line}`)\n    .join(\"\\n\");\n}\n\n/**\n * Renders a short TSDoc-style block when documentation is available.\n */\nexport function renderDocComment(lines: string[]): string {\n  if (lines.length === 0) {\n    return \"\";\n  }\n\n  return [\"/**\", ...lines.map((line) => ` * ${line}`), \" */\"].join(\"\\n\");\n}\n\n/**\n * Renders a namespace declaration with optional members.\n */\nexport function renderNamespaceDeclaration(\n  name: string,\n  members: string[],\n): string {\n  if (members.length === 0) {\n    return `declare namespace ${name} {}`;\n  }\n\n  return `declare namespace ${name} {\\n${indent(members.join(\"\\n\\n\"))}\\n}`;\n}\n","import { isValidIdentifier, serializePropertyName } from \"../identifier\";\nimport type { JsonSchema, TypegenToolDescriptor } from \"../types\";\nimport { indent, renderDocComment, renderNamespaceDeclaration } from \"./render\";\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nexport { indent } from \"./render\";\n\n/**\n * Converts a supported JSON Schema fragment into a TypeScript type expression.\n */\nexport function schemaToType(\n  schema: JsonSchema | undefined,\n  level = 0,\n): string {\n  if (!schema) {\n    return \"unknown\";\n  }\n\n  if (\n    \"allOf\" in schema ||\n    \"anyOf\" in schema ||\n    \"oneOf\" in schema ||\n    \"$ref\" in schema ||\n    Array.isArray(schema.type)\n  ) {\n    return \"unknown\";\n  }\n\n  switch (schema.type) {\n    case \"string\":\n      return \"string\";\n    case \"number\":\n    case \"integer\":\n      return \"number\";\n    case \"boolean\":\n      return \"boolean\";\n    case \"null\":\n      return \"null\";\n    case \"array\": {\n      const itemType = schemaToType(\n        isRecord(schema.items) ? (schema.items as JsonSchema) : undefined,\n        level + 1,\n      );\n\n      if (isValidIdentifier(itemType)) {\n        return `${itemType}[]`;\n      }\n\n      return `Array<${itemType}>`;\n    }\n    case \"object\": {\n      const properties = isRecord(schema.properties) ? schema.properties : {};\n      const required = new Set(\n        Array.isArray(schema.required)\n          ? schema.required.filter(\n              (value): value is string => typeof value === \"string\",\n            )\n          : [],\n      );\n      const entries = Object.entries(properties);\n\n      if (entries.length === 0) {\n        return \"Record<string, unknown>\";\n      }\n\n      const lines = entries.map(([name, propertySchema]) => {\n        const propertyType = schemaToType(\n          isRecord(propertySchema) ? (propertySchema as JsonSchema) : undefined,\n          level + 1,\n        );\n        const optionalToken = required.has(name) ? \"\" : \"?\";\n        return `${serializePropertyName(name)}${optionalToken}: ${propertyType};`;\n      });\n\n      return `{\\n${indent(lines.join(\"\\n\"), level + 1)}\\n${\"  \".repeat(level)}}`;\n    }\n    default:\n      return \"unknown\";\n  }\n}\n\nfunction formatToolDeclaration(\n  name: string,\n  tool: TypegenToolDescriptor,\n): string {\n  const lines: string[] = [];\n  const comment = tool.description ? renderDocComment([tool.description]) : \"\";\n  if (comment) {\n    lines.push(comment);\n  }\n\n  const inputType = schemaToType(tool.inputSchema);\n  const outputType = schemaToType(tool.outputSchema);\n  lines.push(`function ${name}(input: ${inputType}): Promise<${outputType}>;`);\n\n  return lines.join(\"\\n\");\n}\n\n/**\n * Generates a namespace declaration for a provider's tool schemas.\n */\nexport function generateTypesFromJsonSchema(\n  providerName: string,\n  tools: Record<string, TypegenToolDescriptor>,\n): string {\n  return renderNamespaceDeclaration(\n    providerName,\n    Object.entries(tools).map(([name, tool]) =>\n      formatToolDeclaration(name, tool),\n    ),\n  );\n}\n","import Ajv, { type AnySchemaObject, type ValidateFunction } from \"ajv\";\n\nimport {\n  ExecuteFailure,\n  isExecuteFailure,\n  isJsonSerializable,\n} from \"../errors\";\nimport { assertValidIdentifier } from \"../identifier\";\nimport { sanitizeToolName } from \"../sanitize\";\nimport { normalizeToolSchema } from \"../schema/normalizeSchema\";\nimport { generateTypesFromJsonSchema } from \"../typegen/jsonSchema\";\nimport type {\n  JsonSchema,\n  ResolvedToolDescriptor,\n  ResolvedToolProvider,\n  ToolExecutionContext,\n  ToolProvider,\n  TypegenToolDescriptor,\n} from \"../types\";\n\nconst DEFAULT_PROVIDER_NAME = \"codemode\";\nfunction assertValidNamespace(name: string): void {\n  assertValidIdentifier(name, \"provider namespace\");\n}\n\nfunction compileValidator(\n  ajv: Ajv,\n  schema: JsonSchema | undefined,\n): ValidateFunction | undefined {\n  return schema ? ajv.compile(schema as AnySchemaObject) : undefined;\n}\n\nfunction formatValidationMessage(\n  ajv: Ajv,\n  phase: \"input\" | \"output\",\n  toolName: string,\n  validator: ValidateFunction,\n): string {\n  return `Invalid ${phase} for tool ${toolName}: ${ajv.errorsText(validator.errors)}`;\n}\n\n/**\n * Resolves a tool provider into the validated, sanitized shape consumed by executors.\n */\nexport function resolveProvider(provider: ToolProvider): ResolvedToolProvider {\n  const name = provider.name ?? DEFAULT_PROVIDER_NAME;\n  assertValidNamespace(name);\n\n  const ajv = new Ajv({\n    allErrors: true,\n    strict: false,\n  });\n\n  const originalToSafeName: Record<string, string> = {};\n  const safeToOriginalName: Record<string, string> = {};\n  const usedSafeNames = new Set<string>();\n  const resolvedTools: Record<string, ResolvedToolDescriptor> = {};\n  const typegenTools: Record<string, TypegenToolDescriptor> = {};\n\n  for (const [originalName, descriptor] of Object.entries(provider.tools)) {\n    const baseSafeName = sanitizeToolName(originalName);\n    let safeName = baseSafeName;\n    let suffix = 2;\n\n    while (usedSafeNames.has(safeName)) {\n      safeName = `${baseSafeName}__${suffix}`;\n      suffix += 1;\n    }\n\n    usedSafeNames.add(safeName);\n    originalToSafeName[originalName] = safeName;\n    safeToOriginalName[safeName] = originalName;\n\n    const inputSchema = normalizeToolSchema(\n      descriptor.inputSchema,\n      \"input\",\n      originalName,\n    );\n    const outputSchema = normalizeToolSchema(\n      descriptor.outputSchema,\n      \"output\",\n      originalName,\n    );\n    const inputValidator = compileValidator(ajv, inputSchema);\n    const outputValidator = compileValidator(ajv, outputSchema);\n\n    resolvedTools[safeName] = {\n      description: descriptor.description,\n      execute: async (\n        input: unknown,\n        context: ToolExecutionContext,\n      ): Promise<unknown> => {\n        if (inputValidator && !inputValidator(input)) {\n          throw new ExecuteFailure(\n            \"validation_error\",\n            formatValidationMessage(ajv, \"input\", originalName, inputValidator),\n          );\n        }\n\n        try {\n          const result = await descriptor.execute(input, context);\n\n          if (!isJsonSerializable(result)) {\n            throw new ExecuteFailure(\n              \"serialization_error\",\n              `Tool ${originalName} returned a non-serializable value`,\n            );\n          }\n\n          if (outputValidator && !outputValidator(result)) {\n            throw new ExecuteFailure(\n              \"validation_error\",\n              formatValidationMessage(\n                ajv,\n                \"output\",\n                originalName,\n                outputValidator,\n              ),\n            );\n          }\n\n          return result;\n        } catch (error) {\n          if (isExecuteFailure(error)) {\n            throw error;\n          }\n\n          throw new ExecuteFailure(\n            \"tool_error\",\n            error instanceof Error\n              ? error.message\n              : `Tool ${originalName} failed`,\n          );\n        }\n      },\n      inputSchema,\n      originalName,\n      outputSchema,\n      safeName,\n    };\n\n    typegenTools[safeName] = {\n      description: descriptor.description,\n      inputSchema,\n      outputSchema,\n    };\n  }\n\n  return {\n    name,\n    originalToSafeName,\n    safeToOriginalName,\n    tools: resolvedTools,\n    types: provider.types ?? generateTypesFromJsonSchema(name, typegenTools),\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"resolveProvider-CUxAvFCK.js","names":["isRecord","lines: string[]","originalToSafeName: Record<string, string>","safeToOriginalName: Record<string, string>","resolvedTools: Record<string, ResolvedToolDescriptor>","typegenTools: Record<string, TypegenToolDescriptor>"],"sources":["../src/identifier.ts","../src/sanitize.ts","../src/errors.ts","../src/schema/normalizeSchema.ts","../src/typegen/render.ts","../src/typegen/jsonSchema.ts","../src/provider/resolveProvider.ts"],"sourcesContent":["const RESERVED_WORDS = new Set([\n  \"await\",\n  \"break\",\n  \"case\",\n  \"catch\",\n  \"class\",\n  \"const\",\n  \"continue\",\n  \"debugger\",\n  \"default\",\n  \"delete\",\n  \"do\",\n  \"else\",\n  \"enum\",\n  \"export\",\n  \"extends\",\n  \"false\",\n  \"finally\",\n  \"for\",\n  \"function\",\n  \"if\",\n  \"import\",\n  \"in\",\n  \"instanceof\",\n  \"new\",\n  \"null\",\n  \"return\",\n  \"super\",\n  \"switch\",\n  \"this\",\n  \"throw\",\n  \"true\",\n  \"try\",\n  \"typeof\",\n  \"var\",\n  \"void\",\n  \"while\",\n  \"with\",\n  \"yield\",\n]);\n\n/**\n * Returns whether the value is a valid JavaScript identifier.\n */\nexport function isValidIdentifier(value: string): boolean {\n  return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(value);\n}\n\n/**\n * Returns whether the identifier is reserved in JavaScript source.\n */\nexport function isReservedWord(value: string): boolean {\n  return RESERVED_WORDS.has(value);\n}\n\n/**\n * Throws when the value cannot be used as a bare JavaScript identifier.\n */\nexport function assertValidIdentifier(\n  value: string,\n  label = \"identifier\",\n): void {\n  if (!isValidIdentifier(value) || isReservedWord(value)) {\n    throw new Error(`Invalid ${label}: ${value}`);\n  }\n}\n\n/**\n * Converts a raw identifier-like value into a safe JavaScript identifier.\n */\nexport function sanitizeIdentifier(value: string): string {\n  const sanitized = value\n    .trim()\n    .replace(/[^A-Za-z0-9_$]+/g, \"_\")\n    .replace(/^_+|_+$/g, \"\");\n\n  let safeName = sanitized.length > 0 ? sanitized : \"_\";\n\n  if (/^[0-9]/.test(safeName)) {\n    safeName = `_${safeName}`;\n  }\n\n  if (isReservedWord(safeName)) {\n    safeName = `${safeName}_`;\n  }\n\n  return safeName;\n}\n\n/**\n * Renders the name as a bare identifier when possible, otherwise as a string literal.\n */\nexport function serializePropertyName(name: string): string {\n  return isValidIdentifier(name) ? name : JSON.stringify(name);\n}\n","import { sanitizeIdentifier } from \"./identifier\";\n\n/**\n * Converts a raw tool name into a safe JavaScript identifier.\n */\nexport function sanitizeToolName(name: string): string {\n  return sanitizeIdentifier(name);\n}\n","import type { ExecuteErrorCode } from \"./types\";\n\n/**\n * Structured failure used internally to propagate executor and tool errors.\n */\nexport class ExecuteFailure extends Error {\n  code: ExecuteErrorCode;\n\n  /**\n   * Creates a structured failure with a trusted executor or tool error code.\n   */\n  constructor(code: ExecuteErrorCode, message: string) {\n    super(message);\n    this.code = code;\n    this.name = \"ExecuteFailure\";\n  }\n}\n\n/**\n * Returns whether a thrown value is an {@link ExecuteFailure}.\n */\nexport function isExecuteFailure(value: unknown): value is ExecuteFailure {\n  return value instanceof ExecuteFailure;\n}\n\n/**\n * Returns whether a value can be serialized through the JSON-only host/guest boundary.\n */\nexport function isJsonSerializable(\n  value: unknown,\n  active = new Set<object>(),\n  memo = new WeakSet<object>(),\n): boolean {\n  if (value === null) {\n    return true;\n  }\n\n  switch (typeof value) {\n    case \"string\":\n    case \"boolean\":\n      return true;\n    case \"number\":\n      return Number.isFinite(value);\n    case \"bigint\":\n    case \"function\":\n    case \"symbol\":\n    case \"undefined\":\n      return false;\n    case \"object\": {\n      const objectValue = value as object;\n\n      if (memo.has(objectValue)) {\n        return true;\n      }\n\n      if (active.has(objectValue)) {\n        return false;\n      }\n\n      active.add(objectValue);\n      let isSerializable = false;\n\n      try {\n        if (Array.isArray(value)) {\n          isSerializable = value.every((item) =>\n            isJsonSerializable(item, active, memo),\n          );\n          return isSerializable;\n        }\n\n        const prototype = Object.getPrototypeOf(value);\n        if (prototype !== Object.prototype && prototype !== null) {\n          return false;\n        }\n\n        isSerializable = Object.values(value).every((item) =>\n          isJsonSerializable(item, active, memo),\n        );\n        return isSerializable;\n      } finally {\n        active.delete(objectValue);\n        if (isSerializable) {\n          memo.add(objectValue);\n        }\n      }\n    }\n  }\n\n  return false;\n}\n","import * as zod from \"zod\";\nimport type { ZodRawShape, ZodTypeAny } from \"zod\";\n\nimport type { JsonSchema, ToolSchema } from \"../types\";\n\nconst z = \"z\" in zod && typeof zod.z === \"object\" ? zod.z : zod;\nconst toJsonSchema =\n  (\"toJSONSchema\" in zod ? zod.toJSONSchema : undefined) ??\n  (\"toJSONSchema\" in z ? z.toJSONSchema : undefined);\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction isZodSchema(value: unknown): value is ZodTypeAny {\n  return isRecord(value) && typeof value.safeParse === \"function\";\n}\n\nfunction isZodRawShape(value: unknown): value is ZodRawShape {\n  return (\n    isRecord(value) &&\n    Object.keys(value).length > 0 &&\n    Object.values(value).every(isZodSchema)\n  );\n}\n\nfunction normalizeZodSchema(schema: ZodTypeAny): JsonSchema {\n  if (typeof toJsonSchema !== \"function\") {\n    throw new Error(\"Installed zod package does not expose toJSONSchema\");\n  }\n\n  const jsonSchema = toJsonSchema(schema) as JsonSchema & {\n    $schema?: string;\n  };\n\n  if (\"$schema\" in jsonSchema) {\n    const { $schema: _ignored, ...rest } = jsonSchema;\n    return rest;\n  }\n\n  return jsonSchema;\n}\n\n/**\n * Normalizes supported tool schema inputs to the JSON Schema form used internally.\n */\nexport function normalizeToolSchema(\n  schema: ToolSchema | undefined,\n  phase: \"input\" | \"output\",\n  toolName: string,\n): JsonSchema | undefined {\n  if (schema === undefined) {\n    return undefined;\n  }\n\n  if (isZodSchema(schema)) {\n    return normalizeZodSchema(schema);\n  }\n\n  if (isZodRawShape(schema)) {\n    return normalizeZodSchema(z.object(schema));\n  }\n\n  if (isRecord(schema)) {\n    return schema;\n  }\n\n  throw new Error(\n    `Unsupported ${phase} schema for tool ${toolName}. Expected JSON Schema, a Zod schema, or an MCP-style Zod shape.`,\n  );\n}\n","/**\n * Indents each line of the given string by a specified number of levels.\n */\nexport function indent(value: string, level = 1): string {\n  return value\n    .split(\"\\n\")\n    .map((line) => `${\"  \".repeat(level)}${line}`)\n    .join(\"\\n\");\n}\n\n/**\n * Renders a short TSDoc-style block when documentation is available.\n */\nexport function renderDocComment(lines: string[]): string {\n  if (lines.length === 0) {\n    return \"\";\n  }\n\n  return [\"/**\", ...lines.map((line) => ` * ${line}`), \" */\"].join(\"\\n\");\n}\n\n/**\n * Renders a namespace declaration with optional members.\n */\nexport function renderNamespaceDeclaration(\n  name: string,\n  members: string[],\n): string {\n  if (members.length === 0) {\n    return `declare namespace ${name} {}`;\n  }\n\n  return `declare namespace ${name} {\\n${indent(members.join(\"\\n\\n\"))}\\n}`;\n}\n","import { isValidIdentifier, serializePropertyName } from \"../identifier\";\nimport type { JsonSchema, TypegenToolDescriptor } from \"../types\";\nimport { indent, renderDocComment, renderNamespaceDeclaration } from \"./render\";\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nexport { indent } from \"./render\";\n\n/**\n * Converts a supported JSON Schema fragment into a TypeScript type expression.\n */\nexport function schemaToType(\n  schema: JsonSchema | undefined,\n  level = 0,\n): string {\n  if (!schema) {\n    return \"unknown\";\n  }\n\n  if (\n    \"allOf\" in schema ||\n    \"anyOf\" in schema ||\n    \"oneOf\" in schema ||\n    \"$ref\" in schema ||\n    Array.isArray(schema.type)\n  ) {\n    return \"unknown\";\n  }\n\n  switch (schema.type) {\n    case \"string\":\n      return \"string\";\n    case \"number\":\n    case \"integer\":\n      return \"number\";\n    case \"boolean\":\n      return \"boolean\";\n    case \"null\":\n      return \"null\";\n    case \"array\": {\n      const itemType = schemaToType(\n        isRecord(schema.items) ? (schema.items as JsonSchema) : undefined,\n        level + 1,\n      );\n\n      if (isValidIdentifier(itemType)) {\n        return `${itemType}[]`;\n      }\n\n      return `Array<${itemType}>`;\n    }\n    case \"object\": {\n      const properties = isRecord(schema.properties) ? schema.properties : {};\n      const required = new Set(\n        Array.isArray(schema.required)\n          ? schema.required.filter(\n              (value): value is string => typeof value === \"string\",\n            )\n          : [],\n      );\n      const entries = Object.entries(properties);\n\n      if (entries.length === 0) {\n        return \"Record<string, unknown>\";\n      }\n\n      const lines = entries.map(([name, propertySchema]) => {\n        const propertyType = schemaToType(\n          isRecord(propertySchema) ? (propertySchema as JsonSchema) : undefined,\n          level + 1,\n        );\n        const optionalToken = required.has(name) ? \"\" : \"?\";\n        return `${serializePropertyName(name)}${optionalToken}: ${propertyType};`;\n      });\n\n      return `{\\n${indent(lines.join(\"\\n\"), level + 1)}\\n${\"  \".repeat(level)}}`;\n    }\n    default:\n      return \"unknown\";\n  }\n}\n\nfunction formatToolDeclaration(\n  name: string,\n  tool: TypegenToolDescriptor,\n): string {\n  const lines: string[] = [];\n  const comment = tool.description ? renderDocComment([tool.description]) : \"\";\n  if (comment) {\n    lines.push(comment);\n  }\n\n  const inputType = schemaToType(tool.inputSchema);\n  const outputType = schemaToType(tool.outputSchema);\n  lines.push(`function ${name}(input: ${inputType}): Promise<${outputType}>;`);\n\n  return lines.join(\"\\n\");\n}\n\n/**\n * Generates a namespace declaration for a provider's tool schemas.\n */\nexport function generateTypesFromJsonSchema(\n  providerName: string,\n  tools: Record<string, TypegenToolDescriptor>,\n): string {\n  return renderNamespaceDeclaration(\n    providerName,\n    Object.entries(tools).map(([name, tool]) =>\n      formatToolDeclaration(name, tool),\n    ),\n  );\n}\n","import Ajv, { type AnySchemaObject, type ValidateFunction } from \"ajv\";\n\nimport {\n  ExecuteFailure,\n  isExecuteFailure,\n  isJsonSerializable,\n} from \"../errors\";\nimport { assertValidIdentifier } from \"../identifier\";\nimport { sanitizeToolName } from \"../sanitize\";\nimport { normalizeToolSchema } from \"../schema/normalizeSchema\";\nimport { generateTypesFromJsonSchema } from \"../typegen/jsonSchema\";\nimport type {\n  JsonSchema,\n  ResolvedToolDescriptor,\n  ResolvedToolProvider,\n  ToolExecutionContext,\n  ToolProvider,\n  TypegenToolDescriptor,\n} from \"../types\";\n\nconst DEFAULT_PROVIDER_NAME = \"codemode\";\nfunction assertValidNamespace(name: string): void {\n  assertValidIdentifier(name, \"provider namespace\");\n}\n\nfunction compileValidator(\n  ajv: Ajv,\n  schema: JsonSchema | undefined,\n): ValidateFunction | undefined {\n  return schema ? ajv.compile(schema as AnySchemaObject) : undefined;\n}\n\nfunction formatValidationMessage(\n  ajv: Ajv,\n  phase: \"input\" | \"output\",\n  toolName: string,\n  validator: ValidateFunction,\n): string {\n  return `Invalid ${phase} for tool ${toolName}: ${ajv.errorsText(validator.errors)}`;\n}\n\n/**\n * Resolves a tool provider into the validated, sanitized shape consumed by executors.\n */\nexport function resolveProvider(provider: ToolProvider): ResolvedToolProvider {\n  const name = provider.name ?? DEFAULT_PROVIDER_NAME;\n  assertValidNamespace(name);\n\n  // strict: false allows schemas with extra keywords (e.g. Zod-generated $schema)\n  // that don't conform to the strict JSON Schema vocabulary.\n  const ajv = new Ajv({\n    allErrors: true,\n    strict: false,\n  });\n\n  const originalToSafeName: Record<string, string> = {};\n  const safeToOriginalName: Record<string, string> = {};\n  const usedSafeNames = new Set<string>();\n  const resolvedTools: Record<string, ResolvedToolDescriptor> = {};\n  const typegenTools: Record<string, TypegenToolDescriptor> = {};\n\n  for (const [originalName, descriptor] of Object.entries(provider.tools)) {\n    const baseSafeName = sanitizeToolName(originalName);\n    let safeName = baseSafeName;\n    let suffix = 2;\n\n    while (usedSafeNames.has(safeName)) {\n      safeName = `${baseSafeName}__${suffix}`;\n      suffix += 1;\n    }\n\n    usedSafeNames.add(safeName);\n    originalToSafeName[originalName] = safeName;\n    safeToOriginalName[safeName] = originalName;\n\n    const inputSchema = normalizeToolSchema(\n      descriptor.inputSchema,\n      \"input\",\n      originalName,\n    );\n    const outputSchema = normalizeToolSchema(\n      descriptor.outputSchema,\n      \"output\",\n      originalName,\n    );\n    const inputValidator = compileValidator(ajv, inputSchema);\n    const outputValidator = compileValidator(ajv, outputSchema);\n\n    resolvedTools[safeName] = {\n      description: descriptor.description,\n      execute: async (\n        input: unknown,\n        context: ToolExecutionContext,\n      ): Promise<unknown> => {\n        if (inputValidator && !inputValidator(input)) {\n          throw new ExecuteFailure(\n            \"validation_error\",\n            formatValidationMessage(ajv, \"input\", originalName, inputValidator),\n          );\n        }\n\n        try {\n          const result = await descriptor.execute(input, context);\n\n          if (!isJsonSerializable(result)) {\n            throw new ExecuteFailure(\n              \"serialization_error\",\n              `Tool ${originalName} returned a non-serializable value`,\n            );\n          }\n\n          if (outputValidator && !outputValidator(result)) {\n            throw new ExecuteFailure(\n              \"validation_error\",\n              formatValidationMessage(\n                ajv,\n                \"output\",\n                originalName,\n                outputValidator,\n              ),\n            );\n          }\n\n          return result;\n        } catch (error) {\n          if (isExecuteFailure(error)) {\n            throw error;\n          }\n\n          throw new ExecuteFailure(\n            \"tool_error\",\n            error instanceof Error\n              ? error.message\n              : `Tool ${originalName} failed`,\n          );\n        }\n      },\n      inputSchema,\n      originalName,\n      outputSchema,\n      safeName,\n    };\n\n    typegenTools[safeName] = {\n      description: descriptor.description,\n      inputSchema,\n      outputSchema,\n    };\n  }\n\n  return {\n    name,\n    originalToSafeName,\n    safeToOriginalName,\n    tools: resolvedTools,\n    types: provider.types ?? generateTypesFromJsonSchema(name, typegenTools),\n  };\n}\n"],"mappings":";;;;AAAA,MAAM,iBAAiB,IAAI,IAAI;CAC7B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;;;;AAKF,SAAgB,kBAAkB,OAAwB;AACxD,QAAO,6BAA6B,KAAK,MAAM;;;;;AAMjD,SAAgB,eAAe,OAAwB;AACrD,QAAO,eAAe,IAAI,MAAM;;;;;AAMlC,SAAgB,sBACd,OACA,QAAQ,cACF;AACN,KAAI,CAAC,kBAAkB,MAAM,IAAI,eAAe,MAAM,CACpD,OAAM,IAAI,MAAM,WAAW,MAAM,IAAI,QAAQ;;;;;AAOjD,SAAgB,mBAAmB,OAAuB;CACxD,MAAM,YAAY,MACf,MAAM,CACN,QAAQ,oBAAoB,IAAI,CAChC,QAAQ,YAAY,GAAG;CAE1B,IAAI,WAAW,UAAU,SAAS,IAAI,YAAY;AAElD,KAAI,SAAS,KAAK,SAAS,CACzB,YAAW,IAAI;AAGjB,KAAI,eAAe,SAAS,CAC1B,YAAW,GAAG,SAAS;AAGzB,QAAO;;;;;AAMT,SAAgB,sBAAsB,MAAsB;AAC1D,QAAO,kBAAkB,KAAK,GAAG,OAAO,KAAK,UAAU,KAAK;;;;;;;;ACxF9D,SAAgB,iBAAiB,MAAsB;AACrD,QAAO,mBAAmB,KAAK;;;;;;;;ACDjC,IAAa,iBAAb,cAAoC,MAAM;CACxC;;;;CAKA,YAAY,MAAwB,SAAiB;AACnD,QAAM,QAAQ;AACd,OAAK,OAAO;AACZ,OAAK,OAAO;;;;;;AAOhB,SAAgB,iBAAiB,OAAyC;AACxE,QAAO,iBAAiB;;;;;AAM1B,SAAgB,mBACd,OACA,yBAAS,IAAI,KAAa,EAC1B,uBAAO,IAAI,SAAiB,EACnB;AACT,KAAI,UAAU,KACZ,QAAO;AAGT,SAAQ,OAAO,OAAf;EACE,KAAK;EACL,KAAK,UACH,QAAO;EACT,KAAK,SACH,QAAO,OAAO,SAAS,MAAM;EAC/B,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,YACH,QAAO;EACT,KAAK,UAAU;GACb,MAAM,cAAc;AAEpB,OAAI,KAAK,IAAI,YAAY,CACvB,QAAO;AAGT,OAAI,OAAO,IAAI,YAAY,CACzB,QAAO;AAGT,UAAO,IAAI,YAAY;GACvB,IAAI,iBAAiB;AAErB,OAAI;AACF,QAAI,MAAM,QAAQ,MAAM,EAAE;AACxB,sBAAiB,MAAM,OAAO,SAC5B,mBAAmB,MAAM,QAAQ,KAAK,CACvC;AACD,YAAO;;IAGT,MAAM,YAAY,OAAO,eAAe,MAAM;AAC9C,QAAI,cAAc,OAAO,aAAa,cAAc,KAClD,QAAO;AAGT,qBAAiB,OAAO,OAAO,MAAM,CAAC,OAAO,SAC3C,mBAAmB,MAAM,QAAQ,KAAK,CACvC;AACD,WAAO;aACC;AACR,WAAO,OAAO,YAAY;AAC1B,QAAI,eACF,MAAK,IAAI,YAAY;;;;AAM7B,QAAO;;;;;ACnFT,MAAM,IAAI,OAAO,OAAO,OAAO,IAAI,MAAM,WAAW,IAAI,IAAI;AAC5D,MAAM,gBACH,kBAAkB,MAAM,IAAI,eAAe,YAC3C,kBAAkB,IAAI,EAAE,eAAe;AAE1C,SAASA,WAAS,OAAkD;AAClE,QAAO,OAAO,UAAU,YAAY,UAAU;;AAGhD,SAAS,YAAY,OAAqC;AACxD,QAAOA,WAAS,MAAM,IAAI,OAAO,MAAM,cAAc;;AAGvD,SAAS,cAAc,OAAsC;AAC3D,QACEA,WAAS,MAAM,IACf,OAAO,KAAK,MAAM,CAAC,SAAS,KAC5B,OAAO,OAAO,MAAM,CAAC,MAAM,YAAY;;AAI3C,SAAS,mBAAmB,QAAgC;AAC1D,KAAI,OAAO,iBAAiB,WAC1B,OAAM,IAAI,MAAM,qDAAqD;CAGvE,MAAM,aAAa,aAAa,OAAO;AAIvC,KAAI,aAAa,YAAY;EAC3B,MAAM,EAAE,SAAS,UAAU,GAAG,SAAS;AACvC,SAAO;;AAGT,QAAO;;;;;AAMT,SAAgB,oBACd,QACA,OACA,UACwB;AACxB,KAAI,WAAW,OACb;AAGF,KAAI,YAAY,OAAO,CACrB,QAAO,mBAAmB,OAAO;AAGnC,KAAI,cAAc,OAAO,CACvB,QAAO,mBAAmB,EAAE,OAAO,OAAO,CAAC;AAG7C,KAAIA,WAAS,OAAO,CAClB,QAAO;AAGT,OAAM,IAAI,MACR,eAAe,MAAM,mBAAmB,SAAS,kEAClD;;;;;;;;AClEH,SAAgB,OAAO,OAAe,QAAQ,GAAW;AACvD,QAAO,MACJ,MAAM,KAAK,CACX,KAAK,SAAS,GAAG,KAAK,OAAO,MAAM,GAAG,OAAO,CAC7C,KAAK,KAAK;;;;;AAMf,SAAgB,iBAAiB,OAAyB;AACxD,KAAI,MAAM,WAAW,EACnB,QAAO;AAGT,QAAO;EAAC;EAAO,GAAG,MAAM,KAAK,SAAS,MAAM,OAAO;EAAE;EAAM,CAAC,KAAK,KAAK;;;;;AAMxE,SAAgB,2BACd,MACA,SACQ;AACR,KAAI,QAAQ,WAAW,EACrB,QAAO,qBAAqB,KAAK;AAGnC,QAAO,qBAAqB,KAAK,MAAM,OAAO,QAAQ,KAAK,OAAO,CAAC,CAAC;;;;;AC5BtE,SAAS,SAAS,OAAkD;AAClE,QAAO,OAAO,UAAU,YAAY,UAAU;;;;;AAQhD,SAAgB,aACd,QACA,QAAQ,GACA;AACR,KAAI,CAAC,OACH,QAAO;AAGT,KACE,WAAW,UACX,WAAW,UACX,WAAW,UACX,UAAU,UACV,MAAM,QAAQ,OAAO,KAAK,CAE1B,QAAO;AAGT,SAAQ,OAAO,MAAf;EACE,KAAK,SACH,QAAO;EACT,KAAK;EACL,KAAK,UACH,QAAO;EACT,KAAK,UACH,QAAO;EACT,KAAK,OACH,QAAO;EACT,KAAK,SAAS;GACZ,MAAM,WAAW,aACf,SAAS,OAAO,MAAM,GAAI,OAAO,QAAuB,QACxD,QAAQ,EACT;AAED,OAAI,kBAAkB,SAAS,CAC7B,QAAO,GAAG,SAAS;AAGrB,UAAO,SAAS,SAAS;;EAE3B,KAAK,UAAU;GACb,MAAM,aAAa,SAAS,OAAO,WAAW,GAAG,OAAO,aAAa,EAAE;GACvE,MAAM,WAAW,IAAI,IACnB,MAAM,QAAQ,OAAO,SAAS,GAC1B,OAAO,SAAS,QACb,UAA2B,OAAO,UAAU,SAC9C,GACD,EAAE,CACP;GACD,MAAM,UAAU,OAAO,QAAQ,WAAW;AAE1C,OAAI,QAAQ,WAAW,EACrB,QAAO;AAYT,UAAO,MAAM,OATC,QAAQ,KAAK,CAAC,MAAM,oBAAoB;IACpD,MAAM,eAAe,aACnB,SAAS,eAAe,GAAI,iBAAgC,QAC5D,QAAQ,EACT;IACD,MAAM,gBAAgB,SAAS,IAAI,KAAK,GAAG,KAAK;AAChD,WAAO,GAAG,sBAAsB,KAAK,GAAG,cAAc,IAAI,aAAa;KACvE,CAEwB,KAAK,KAAK,EAAE,QAAQ,EAAE,CAAC,IAAI,KAAK,OAAO,MAAM,CAAC;;EAE1E,QACE,QAAO;;;AAIb,SAAS,sBACP,MACA,MACQ;CACR,MAAMC,QAAkB,EAAE;CAC1B,MAAM,UAAU,KAAK,cAAc,iBAAiB,CAAC,KAAK,YAAY,CAAC,GAAG;AAC1E,KAAI,QACF,OAAM,KAAK,QAAQ;CAGrB,MAAM,YAAY,aAAa,KAAK,YAAY;CAChD,MAAM,aAAa,aAAa,KAAK,aAAa;AAClD,OAAM,KAAK,YAAY,KAAK,UAAU,UAAU,aAAa,WAAW,IAAI;AAE5E,QAAO,MAAM,KAAK,KAAK;;;;;AAMzB,SAAgB,4BACd,cACA,OACQ;AACR,QAAO,2BACL,cACA,OAAO,QAAQ,MAAM,CAAC,KAAK,CAAC,MAAM,UAChC,sBAAsB,MAAM,KAAK,CAClC,CACF;;;;;AC7FH,MAAM,wBAAwB;AAC9B,SAAS,qBAAqB,MAAoB;AAChD,uBAAsB,MAAM,qBAAqB;;AAGnD,SAAS,iBACP,KACA,QAC8B;AAC9B,QAAO,SAAS,IAAI,QAAQ,OAA0B,GAAG;;AAG3D,SAAS,wBACP,KACA,OACA,UACA,WACQ;AACR,QAAO,WAAW,MAAM,YAAY,SAAS,IAAI,IAAI,WAAW,UAAU,OAAO;;;;;AAMnF,SAAgB,gBAAgB,UAA8C;CAC5E,MAAM,OAAO,SAAS,QAAQ;AAC9B,sBAAqB,KAAK;CAI1B,MAAM,MAAM,IAAI,IAAI;EAClB,WAAW;EACX,QAAQ;EACT,CAAC;CAEF,MAAMC,qBAA6C,EAAE;CACrD,MAAMC,qBAA6C,EAAE;CACrD,MAAM,gCAAgB,IAAI,KAAa;CACvC,MAAMC,gBAAwD,EAAE;CAChE,MAAMC,eAAsD,EAAE;AAE9D,MAAK,MAAM,CAAC,cAAc,eAAe,OAAO,QAAQ,SAAS,MAAM,EAAE;EACvE,MAAM,eAAe,iBAAiB,aAAa;EACnD,IAAI,WAAW;EACf,IAAI,SAAS;AAEb,SAAO,cAAc,IAAI,SAAS,EAAE;AAClC,cAAW,GAAG,aAAa,IAAI;AAC/B,aAAU;;AAGZ,gBAAc,IAAI,SAAS;AAC3B,qBAAmB,gBAAgB;AACnC,qBAAmB,YAAY;EAE/B,MAAM,cAAc,oBAClB,WAAW,aACX,SACA,aACD;EACD,MAAM,eAAe,oBACnB,WAAW,cACX,UACA,aACD;EACD,MAAM,iBAAiB,iBAAiB,KAAK,YAAY;EACzD,MAAM,kBAAkB,iBAAiB,KAAK,aAAa;AAE3D,gBAAc,YAAY;GACxB,aAAa,WAAW;GACxB,SAAS,OACP,OACA,YACqB;AACrB,QAAI,kBAAkB,CAAC,eAAe,MAAM,CAC1C,OAAM,IAAI,eACR,oBACA,wBAAwB,KAAK,SAAS,cAAc,eAAe,CACpE;AAGH,QAAI;KACF,MAAM,SAAS,MAAM,WAAW,QAAQ,OAAO,QAAQ;AAEvD,SAAI,CAAC,mBAAmB,OAAO,CAC7B,OAAM,IAAI,eACR,uBACA,QAAQ,aAAa,oCACtB;AAGH,SAAI,mBAAmB,CAAC,gBAAgB,OAAO,CAC7C,OAAM,IAAI,eACR,oBACA,wBACE,KACA,UACA,cACA,gBACD,CACF;AAGH,YAAO;aACA,OAAO;AACd,SAAI,iBAAiB,MAAM,CACzB,OAAM;AAGR,WAAM,IAAI,eACR,cACA,iBAAiB,QACb,MAAM,UACN,QAAQ,aAAa,SAC1B;;;GAGL;GACA;GACA;GACA;GACD;AAED,eAAa,YAAY;GACvB,aAAa,WAAW;GACxB;GACA;GACD;;AAGH,QAAO;EACL;EACA;EACA;EACA,OAAO;EACP,OAAO,SAAS,SAAS,4BAA4B,MAAM,aAAa;EACzE"}

package/dist/resolveProvider-CixOjPKp.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"resolveProvider-CixOjPKp.cjs","names":["isRecord","lines: string[]","ajv","Ajv","originalToSafeName: Record<string, string>","safeToOriginalName: Record<string, string>","resolvedTools: Record<string, ResolvedToolDescriptor>","typegenTools: Record<string, TypegenToolDescriptor>"],"sources":["../src/identifier.ts","../src/sanitize.ts","../src/errors.ts","../src/schema/normalizeSchema.ts","../src/typegen/render.ts","../src/typegen/jsonSchema.ts","../src/provider/resolveProvider.ts"],"sourcesContent":["const RESERVED_WORDS = new Set([\n  \"await\",\n  \"break\",\n  \"case\",\n  \"catch\",\n  \"class\",\n  \"const\",\n  \"continue\",\n  \"debugger\",\n  \"default\",\n  \"delete\",\n  \"do\",\n  \"else\",\n  \"enum\",\n  \"export\",\n  \"extends\",\n  \"false\",\n  \"finally\",\n  \"for\",\n  \"function\",\n  \"if\",\n  \"import\",\n  \"in\",\n  \"instanceof\",\n  \"new\",\n  \"null\",\n  \"return\",\n  \"super\",\n  \"switch\",\n  \"this\",\n  \"throw\",\n  \"true\",\n  \"try\",\n  \"typeof\",\n  \"var\",\n  \"void\",\n  \"while\",\n  \"with\",\n  \"yield\",\n]);\n\n/**\n * Returns whether the value is a valid JavaScript identifier.\n */\nexport function isValidIdentifier(value: string): boolean {\n  return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(value);\n}\n\n/**\n * Returns whether the identifier is reserved in JavaScript source.\n */\nexport function isReservedWord(value: string): boolean {\n  return RESERVED_WORDS.has(value);\n}\n\n/**\n * Throws when the value cannot be used as a bare JavaScript identifier.\n */\nexport function assertValidIdentifier(\n  value: string,\n  label = \"identifier\",\n): void {\n  if (!isValidIdentifier(value) || isReservedWord(value)) {\n    throw new Error(`Invalid ${label}: ${value}`);\n  }\n}\n\n/**\n * Converts a raw identifier-like value into a safe JavaScript identifier.\n */\nexport function sanitizeIdentifier(value: string): string {\n  const sanitized = value\n    .trim()\n    .replace(/[^A-Za-z0-9_$]+/g, \"_\")\n    .replace(/^_+|_+$/g, \"\");\n\n  let safeName = sanitized.length > 0 ? sanitized : \"_\";\n\n  if (/^[0-9]/.test(safeName)) {\n    safeName = `_${safeName}`;\n  }\n\n  if (isReservedWord(safeName)) {\n    safeName = `${safeName}_`;\n  }\n\n  return safeName;\n}\n\n/**\n * Renders the name as a bare identifier when possible, otherwise as a string literal.\n */\nexport function serializePropertyName(name: string): string {\n  return isValidIdentifier(name) ? name : JSON.stringify(name);\n}\n","import { sanitizeIdentifier } from \"./identifier\";\n\n/**\n * Converts a raw tool name into a safe JavaScript identifier.\n */\nexport function sanitizeToolName(name: string): string {\n  return sanitizeIdentifier(name);\n}\n","import type { ExecuteErrorCode } from \"./types\";\n\n/**\n * Structured failure used internally to propagate executor and tool errors.\n */\nexport class ExecuteFailure extends Error {\n  code: ExecuteErrorCode;\n\n  /**\n   * Creates a structured failure with a trusted executor or tool error code.\n   */\n  constructor(code: ExecuteErrorCode, message: string) {\n    super(message);\n    this.code = code;\n    this.name = \"ExecuteFailure\";\n  }\n}\n\n/**\n * Returns whether a thrown value is an {@link ExecuteFailure}.\n */\nexport function isExecuteFailure(value: unknown): value is ExecuteFailure {\n  return value instanceof ExecuteFailure;\n}\n\n/**\n * Returns whether a value can be serialized through the JSON-only host/guest boundary.\n */\nexport function isJsonSerializable(\n  value: unknown,\n  active = new Set<object>(),\n  memo = new WeakSet<object>(),\n): boolean {\n  if (value === null) {\n    return true;\n  }\n\n  switch (typeof value) {\n    case \"string\":\n    case \"boolean\":\n      return true;\n    case \"number\":\n      return Number.isFinite(value);\n    case \"bigint\":\n    case \"function\":\n    case \"symbol\":\n    case \"undefined\":\n      return false;\n    case \"object\": {\n      const objectValue = value as object;\n\n      if (memo.has(objectValue)) {\n        return true;\n      }\n\n      if (active.has(objectValue)) {\n        return false;\n      }\n\n      active.add(objectValue);\n      let isSerializable = false;\n\n      try {\n        if (Array.isArray(value)) {\n          isSerializable = value.every((item) =>\n            isJsonSerializable(item, active, memo),\n          );\n          return isSerializable;\n        }\n\n        const prototype = Object.getPrototypeOf(value);\n        if (prototype !== Object.prototype && prototype !== null) {\n          return false;\n        }\n\n        isSerializable = Object.values(value).every((item) =>\n          isJsonSerializable(item, active, memo),\n        );\n        return isSerializable;\n      } finally {\n        active.delete(objectValue);\n        if (isSerializable) {\n          memo.add(objectValue);\n        }\n      }\n    }\n  }\n\n  return false;\n}\n","import * as zod from \"zod\";\nimport type { ZodRawShape, ZodTypeAny } from \"zod\";\n\nimport type { JsonSchema, ToolSchema } from \"../types\";\n\nconst z = \"z\" in zod && typeof zod.z === \"object\" ? zod.z : zod;\nconst toJsonSchema =\n  (\"toJSONSchema\" in zod ? zod.toJSONSchema : undefined) ??\n  (\"toJSONSchema\" in z ? z.toJSONSchema : undefined);\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction isZodSchema(value: unknown): value is ZodTypeAny {\n  return isRecord(value) && typeof value.safeParse === \"function\";\n}\n\nfunction isZodRawShape(value: unknown): value is ZodRawShape {\n  return (\n    isRecord(value) &&\n    Object.keys(value).length > 0 &&\n    Object.values(value).every(isZodSchema)\n  );\n}\n\nfunction normalizeZodSchema(schema: ZodTypeAny): JsonSchema {\n  if (typeof toJsonSchema !== \"function\") {\n    throw new Error(\"Installed zod package does not expose toJSONSchema\");\n  }\n\n  const jsonSchema = toJsonSchema(schema) as JsonSchema & {\n    $schema?: string;\n  };\n\n  if (\"$schema\" in jsonSchema) {\n    const { $schema: _ignored, ...rest } = jsonSchema;\n    return rest;\n  }\n\n  return jsonSchema;\n}\n\n/**\n * Normalizes supported tool schema inputs to the JSON Schema form used internally.\n */\nexport function normalizeToolSchema(\n  schema: ToolSchema | undefined,\n  phase: \"input\" | \"output\",\n  toolName: string,\n): JsonSchema | undefined {\n  if (schema === undefined) {\n    return undefined;\n  }\n\n  if (isZodSchema(schema)) {\n    return normalizeZodSchema(schema);\n  }\n\n  if (isZodRawShape(schema)) {\n    return normalizeZodSchema(z.object(schema));\n  }\n\n  if (isRecord(schema)) {\n    return schema;\n  }\n\n  throw new Error(\n    `Unsupported ${phase} schema for tool ${toolName}. Expected JSON Schema, a Zod schema, or an MCP-style Zod shape.`,\n  );\n}\n","/**\n * Indents each line of the given string by a specified number of levels.\n */\nexport function indent(value: string, level = 1): string {\n  return value\n    .split(\"\\n\")\n    .map((line) => `${\"  \".repeat(level)}${line}`)\n    .join(\"\\n\");\n}\n\n/**\n * Renders a short TSDoc-style block when documentation is available.\n */\nexport function renderDocComment(lines: string[]): string {\n  if (lines.length === 0) {\n    return \"\";\n  }\n\n  return [\"/**\", ...lines.map((line) => ` * ${line}`), \" */\"].join(\"\\n\");\n}\n\n/**\n * Renders a namespace declaration with optional members.\n */\nexport function renderNamespaceDeclaration(\n  name: string,\n  members: string[],\n): string {\n  if (members.length === 0) {\n    return `declare namespace ${name} {}`;\n  }\n\n  return `declare namespace ${name} {\\n${indent(members.join(\"\\n\\n\"))}\\n}`;\n}\n","import { isValidIdentifier, serializePropertyName } from \"../identifier\";\nimport type { JsonSchema, TypegenToolDescriptor } from \"../types\";\nimport { indent, renderDocComment, renderNamespaceDeclaration } from \"./render\";\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nexport { indent } from \"./render\";\n\n/**\n * Converts a supported JSON Schema fragment into a TypeScript type expression.\n */\nexport function schemaToType(\n  schema: JsonSchema | undefined,\n  level = 0,\n): string {\n  if (!schema) {\n    return \"unknown\";\n  }\n\n  if (\n    \"allOf\" in schema ||\n    \"anyOf\" in schema ||\n    \"oneOf\" in schema ||\n    \"$ref\" in schema ||\n    Array.isArray(schema.type)\n  ) {\n    return \"unknown\";\n  }\n\n  switch (schema.type) {\n    case \"string\":\n      return \"string\";\n    case \"number\":\n    case \"integer\":\n      return \"number\";\n    case \"boolean\":\n      return \"boolean\";\n    case \"null\":\n      return \"null\";\n    case \"array\": {\n      const itemType = schemaToType(\n        isRecord(schema.items) ? (schema.items as JsonSchema) : undefined,\n        level + 1,\n      );\n\n      if (isValidIdentifier(itemType)) {\n        return `${itemType}[]`;\n      }\n\n      return `Array<${itemType}>`;\n    }\n    case \"object\": {\n      const properties = isRecord(schema.properties) ? schema.properties : {};\n      const required = new Set(\n        Array.isArray(schema.required)\n          ? schema.required.filter(\n              (value): value is string => typeof value === \"string\",\n            )\n          : [],\n      );\n      const entries = Object.entries(properties);\n\n      if (entries.length === 0) {\n        return \"Record<string, unknown>\";\n      }\n\n      const lines = entries.map(([name, propertySchema]) => {\n        const propertyType = schemaToType(\n          isRecord(propertySchema) ? (propertySchema as JsonSchema) : undefined,\n          level + 1,\n        );\n        const optionalToken = required.has(name) ? \"\" : \"?\";\n        return `${serializePropertyName(name)}${optionalToken}: ${propertyType};`;\n      });\n\n      return `{\\n${indent(lines.join(\"\\n\"), level + 1)}\\n${\"  \".repeat(level)}}`;\n    }\n    default:\n      return \"unknown\";\n  }\n}\n\nfunction formatToolDeclaration(\n  name: string,\n  tool: TypegenToolDescriptor,\n): string {\n  const lines: string[] = [];\n  const comment = tool.description ? renderDocComment([tool.description]) : \"\";\n  if (comment) {\n    lines.push(comment);\n  }\n\n  const inputType = schemaToType(tool.inputSchema);\n  const outputType = schemaToType(tool.outputSchema);\n  lines.push(`function ${name}(input: ${inputType}): Promise<${outputType}>;`);\n\n  return lines.join(\"\\n\");\n}\n\n/**\n * Generates a namespace declaration for a provider's tool schemas.\n */\nexport function generateTypesFromJsonSchema(\n  providerName: string,\n  tools: Record<string, TypegenToolDescriptor>,\n): string {\n  return renderNamespaceDeclaration(\n    providerName,\n    Object.entries(tools).map(([name, tool]) =>\n      formatToolDeclaration(name, tool),\n    ),\n  );\n}\n","import Ajv, { type AnySchemaObject, type ValidateFunction } from \"ajv\";\n\nimport {\n  ExecuteFailure,\n  isExecuteFailure,\n  isJsonSerializable,\n} from \"../errors\";\nimport { assertValidIdentifier } from \"../identifier\";\nimport { sanitizeToolName } from \"../sanitize\";\nimport { normalizeToolSchema } from \"../schema/normalizeSchema\";\nimport { generateTypesFromJsonSchema } from \"../typegen/jsonSchema\";\nimport type {\n  JsonSchema,\n  ResolvedToolDescriptor,\n  ResolvedToolProvider,\n  ToolExecutionContext,\n  ToolProvider,\n  TypegenToolDescriptor,\n} from \"../types\";\n\nconst DEFAULT_PROVIDER_NAME = \"codemode\";\nfunction assertValidNamespace(name: string): void {\n  assertValidIdentifier(name, \"provider namespace\");\n}\n\nfunction compileValidator(\n  ajv: Ajv,\n  schema: JsonSchema | undefined,\n): ValidateFunction | undefined {\n  return schema ? ajv.compile(schema as AnySchemaObject) : undefined;\n}\n\nfunction formatValidationMessage(\n  ajv: Ajv,\n  phase: \"input\" | \"output\",\n  toolName: string,\n  validator: ValidateFunction,\n): string {\n  return `Invalid ${phase} for tool ${toolName}: ${ajv.errorsText(validator.errors)}`;\n}\n\n/**\n * Resolves a tool provider into the validated, sanitized shape consumed by executors.\n */\nexport function resolveProvider(provider: ToolProvider): ResolvedToolProvider {\n  const name = provider.name ?? DEFAULT_PROVIDER_NAME;\n  assertValidNamespace(name);\n\n  const ajv = new Ajv({\n    allErrors: true,\n    strict: false,\n  });\n\n  const originalToSafeName: Record<string, string> = {};\n  const safeToOriginalName: Record<string, string> = {};\n  const usedSafeNames = new Set<string>();\n  const resolvedTools: Record<string, ResolvedToolDescriptor> = {};\n  const typegenTools: Record<string, TypegenToolDescriptor> = {};\n\n  for (const [originalName, descriptor] of Object.entries(provider.tools)) {\n    const baseSafeName = sanitizeToolName(originalName);\n    let safeName = baseSafeName;\n    let suffix = 2;\n\n    while (usedSafeNames.has(safeName)) {\n      safeName = `${baseSafeName}__${suffix}`;\n      suffix += 1;\n    }\n\n    usedSafeNames.add(safeName);\n    originalToSafeName[originalName] = safeName;\n    safeToOriginalName[safeName] = originalName;\n\n    const inputSchema = normalizeToolSchema(\n      descriptor.inputSchema,\n      \"input\",\n      originalName,\n    );\n    const outputSchema = normalizeToolSchema(\n      descriptor.outputSchema,\n      \"output\",\n      originalName,\n    );\n    const inputValidator = compileValidator(ajv, inputSchema);\n    const outputValidator = compileValidator(ajv, outputSchema);\n\n    resolvedTools[safeName] = {\n      description: descriptor.description,\n      execute: async (\n        input: unknown,\n        context: ToolExecutionContext,\n      ): Promise<unknown> => {\n        if (inputValidator && !inputValidator(input)) {\n          throw new ExecuteFailure(\n            \"validation_error\",\n            formatValidationMessage(ajv, \"input\", originalName, inputValidator),\n          );\n        }\n\n        try {\n          const result = await descriptor.execute(input, context);\n\n          if (!isJsonSerializable(result)) {\n            throw new ExecuteFailure(\n              \"serialization_error\",\n              `Tool ${originalName} returned a non-serializable value`,\n            );\n          }\n\n          if (outputValidator && !outputValidator(result)) {\n            throw new ExecuteFailure(\n              \"validation_error\",\n              formatValidationMessage(\n                ajv,\n                \"output\",\n                originalName,\n                outputValidator,\n              ),\n            );\n          }\n\n          return result;\n        } catch (error) {\n          if (isExecuteFailure(error)) {\n            throw error;\n          }\n\n          throw new ExecuteFailure(\n            \"tool_error\",\n            error instanceof Error\n              ? error.message\n              : `Tool ${originalName} failed`,\n          );\n        }\n      },\n      inputSchema,\n      originalName,\n      outputSchema,\n      safeName,\n    };\n\n    typegenTools[safeName] = {\n      description: descriptor.description,\n      inputSchema,\n      outputSchema,\n    };\n  }\n\n  return {\n    name,\n    originalToSafeName,\n    safeToOriginalName,\n    tools: resolvedTools,\n    types: provider.types ?? generateTypesFromJsonSchema(name, typegenTools),\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"resolveProvider-CixOjPKp.cjs","names":["isRecord","lines: string[]","ajv","Ajv","originalToSafeName: Record<string, string>","safeToOriginalName: Record<string, string>","resolvedTools: Record<string, ResolvedToolDescriptor>","typegenTools: Record<string, TypegenToolDescriptor>"],"sources":["../src/identifier.ts","../src/sanitize.ts","../src/errors.ts","../src/schema/normalizeSchema.ts","../src/typegen/render.ts","../src/typegen/jsonSchema.ts","../src/provider/resolveProvider.ts"],"sourcesContent":["const RESERVED_WORDS = new Set([\n  \"await\",\n  \"break\",\n  \"case\",\n  \"catch\",\n  \"class\",\n  \"const\",\n  \"continue\",\n  \"debugger\",\n  \"default\",\n  \"delete\",\n  \"do\",\n  \"else\",\n  \"enum\",\n  \"export\",\n  \"extends\",\n  \"false\",\n  \"finally\",\n  \"for\",\n  \"function\",\n  \"if\",\n  \"import\",\n  \"in\",\n  \"instanceof\",\n  \"new\",\n  \"null\",\n  \"return\",\n  \"super\",\n  \"switch\",\n  \"this\",\n  \"throw\",\n  \"true\",\n  \"try\",\n  \"typeof\",\n  \"var\",\n  \"void\",\n  \"while\",\n  \"with\",\n  \"yield\",\n]);\n\n/**\n * Returns whether the value is a valid JavaScript identifier.\n */\nexport function isValidIdentifier(value: string): boolean {\n  return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(value);\n}\n\n/**\n * Returns whether the identifier is reserved in JavaScript source.\n */\nexport function isReservedWord(value: string): boolean {\n  return RESERVED_WORDS.has(value);\n}\n\n/**\n * Throws when the value cannot be used as a bare JavaScript identifier.\n */\nexport function assertValidIdentifier(\n  value: string,\n  label = \"identifier\",\n): void {\n  if (!isValidIdentifier(value) || isReservedWord(value)) {\n    throw new Error(`Invalid ${label}: ${value}`);\n  }\n}\n\n/**\n * Converts a raw identifier-like value into a safe JavaScript identifier.\n */\nexport function sanitizeIdentifier(value: string): string {\n  const sanitized = value\n    .trim()\n    .replace(/[^A-Za-z0-9_$]+/g, \"_\")\n    .replace(/^_+|_+$/g, \"\");\n\n  let safeName = sanitized.length > 0 ? sanitized : \"_\";\n\n  if (/^[0-9]/.test(safeName)) {\n    safeName = `_${safeName}`;\n  }\n\n  if (isReservedWord(safeName)) {\n    safeName = `${safeName}_`;\n  }\n\n  return safeName;\n}\n\n/**\n * Renders the name as a bare identifier when possible, otherwise as a string literal.\n */\nexport function serializePropertyName(name: string): string {\n  return isValidIdentifier(name) ? name : JSON.stringify(name);\n}\n","import { sanitizeIdentifier } from \"./identifier\";\n\n/**\n * Converts a raw tool name into a safe JavaScript identifier.\n */\nexport function sanitizeToolName(name: string): string {\n  return sanitizeIdentifier(name);\n}\n","import type { ExecuteErrorCode } from \"./types\";\n\n/**\n * Structured failure used internally to propagate executor and tool errors.\n */\nexport class ExecuteFailure extends Error {\n  code: ExecuteErrorCode;\n\n  /**\n   * Creates a structured failure with a trusted executor or tool error code.\n   */\n  constructor(code: ExecuteErrorCode, message: string) {\n    super(message);\n    this.code = code;\n    this.name = \"ExecuteFailure\";\n  }\n}\n\n/**\n * Returns whether a thrown value is an {@link ExecuteFailure}.\n */\nexport function isExecuteFailure(value: unknown): value is ExecuteFailure {\n  return value instanceof ExecuteFailure;\n}\n\n/**\n * Returns whether a value can be serialized through the JSON-only host/guest boundary.\n */\nexport function isJsonSerializable(\n  value: unknown,\n  active = new Set<object>(),\n  memo = new WeakSet<object>(),\n): boolean {\n  if (value === null) {\n    return true;\n  }\n\n  switch (typeof value) {\n    case \"string\":\n    case \"boolean\":\n      return true;\n    case \"number\":\n      return Number.isFinite(value);\n    case \"bigint\":\n    case \"function\":\n    case \"symbol\":\n    case \"undefined\":\n      return false;\n    case \"object\": {\n      const objectValue = value as object;\n\n      if (memo.has(objectValue)) {\n        return true;\n      }\n\n      if (active.has(objectValue)) {\n        return false;\n      }\n\n      active.add(objectValue);\n      let isSerializable = false;\n\n      try {\n        if (Array.isArray(value)) {\n          isSerializable = value.every((item) =>\n            isJsonSerializable(item, active, memo),\n          );\n          return isSerializable;\n        }\n\n        const prototype = Object.getPrototypeOf(value);\n        if (prototype !== Object.prototype && prototype !== null) {\n          return false;\n        }\n\n        isSerializable = Object.values(value).every((item) =>\n          isJsonSerializable(item, active, memo),\n        );\n        return isSerializable;\n      } finally {\n        active.delete(objectValue);\n        if (isSerializable) {\n          memo.add(objectValue);\n        }\n      }\n    }\n  }\n\n  return false;\n}\n","import * as zod from \"zod\";\nimport type { ZodRawShape, ZodTypeAny } from \"zod\";\n\nimport type { JsonSchema, ToolSchema } from \"../types\";\n\nconst z = \"z\" in zod && typeof zod.z === \"object\" ? zod.z : zod;\nconst toJsonSchema =\n  (\"toJSONSchema\" in zod ? zod.toJSONSchema : undefined) ??\n  (\"toJSONSchema\" in z ? z.toJSONSchema : undefined);\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction isZodSchema(value: unknown): value is ZodTypeAny {\n  return isRecord(value) && typeof value.safeParse === \"function\";\n}\n\nfunction isZodRawShape(value: unknown): value is ZodRawShape {\n  return (\n    isRecord(value) &&\n    Object.keys(value).length > 0 &&\n    Object.values(value).every(isZodSchema)\n  );\n}\n\nfunction normalizeZodSchema(schema: ZodTypeAny): JsonSchema {\n  if (typeof toJsonSchema !== \"function\") {\n    throw new Error(\"Installed zod package does not expose toJSONSchema\");\n  }\n\n  const jsonSchema = toJsonSchema(schema) as JsonSchema & {\n    $schema?: string;\n  };\n\n  if (\"$schema\" in jsonSchema) {\n    const { $schema: _ignored, ...rest } = jsonSchema;\n    return rest;\n  }\n\n  return jsonSchema;\n}\n\n/**\n * Normalizes supported tool schema inputs to the JSON Schema form used internally.\n */\nexport function normalizeToolSchema(\n  schema: ToolSchema | undefined,\n  phase: \"input\" | \"output\",\n  toolName: string,\n): JsonSchema | undefined {\n  if (schema === undefined) {\n    return undefined;\n  }\n\n  if (isZodSchema(schema)) {\n    return normalizeZodSchema(schema);\n  }\n\n  if (isZodRawShape(schema)) {\n    return normalizeZodSchema(z.object(schema));\n  }\n\n  if (isRecord(schema)) {\n    return schema;\n  }\n\n  throw new Error(\n    `Unsupported ${phase} schema for tool ${toolName}. Expected JSON Schema, a Zod schema, or an MCP-style Zod shape.`,\n  );\n}\n","/**\n * Indents each line of the given string by a specified number of levels.\n */\nexport function indent(value: string, level = 1): string {\n  return value\n    .split(\"\\n\")\n    .map((line) => `${\"  \".repeat(level)}${line}`)\n    .join(\"\\n\");\n}\n\n/**\n * Renders a short TSDoc-style block when documentation is available.\n */\nexport function renderDocComment(lines: string[]): string {\n  if (lines.length === 0) {\n    return \"\";\n  }\n\n  return [\"/**\", ...lines.map((line) => ` * ${line}`), \" */\"].join(\"\\n\");\n}\n\n/**\n * Renders a namespace declaration with optional members.\n */\nexport function renderNamespaceDeclaration(\n  name: string,\n  members: string[],\n): string {\n  if (members.length === 0) {\n    return `declare namespace ${name} {}`;\n  }\n\n  return `declare namespace ${name} {\\n${indent(members.join(\"\\n\\n\"))}\\n}`;\n}\n","import { isValidIdentifier, serializePropertyName } from \"../identifier\";\nimport type { JsonSchema, TypegenToolDescriptor } from \"../types\";\nimport { indent, renderDocComment, renderNamespaceDeclaration } from \"./render\";\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nexport { indent } from \"./render\";\n\n/**\n * Converts a supported JSON Schema fragment into a TypeScript type expression.\n */\nexport function schemaToType(\n  schema: JsonSchema | undefined,\n  level = 0,\n): string {\n  if (!schema) {\n    return \"unknown\";\n  }\n\n  if (\n    \"allOf\" in schema ||\n    \"anyOf\" in schema ||\n    \"oneOf\" in schema ||\n    \"$ref\" in schema ||\n    Array.isArray(schema.type)\n  ) {\n    return \"unknown\";\n  }\n\n  switch (schema.type) {\n    case \"string\":\n      return \"string\";\n    case \"number\":\n    case \"integer\":\n      return \"number\";\n    case \"boolean\":\n      return \"boolean\";\n    case \"null\":\n      return \"null\";\n    case \"array\": {\n      const itemType = schemaToType(\n        isRecord(schema.items) ? (schema.items as JsonSchema) : undefined,\n        level + 1,\n      );\n\n      if (isValidIdentifier(itemType)) {\n        return `${itemType}[]`;\n      }\n\n      return `Array<${itemType}>`;\n    }\n    case \"object\": {\n      const properties = isRecord(schema.properties) ? schema.properties : {};\n      const required = new Set(\n        Array.isArray(schema.required)\n          ? schema.required.filter(\n              (value): value is string => typeof value === \"string\",\n            )\n          : [],\n      );\n      const entries = Object.entries(properties);\n\n      if (entries.length === 0) {\n        return \"Record<string, unknown>\";\n      }\n\n      const lines = entries.map(([name, propertySchema]) => {\n        const propertyType = schemaToType(\n          isRecord(propertySchema) ? (propertySchema as JsonSchema) : undefined,\n          level + 1,\n        );\n        const optionalToken = required.has(name) ? \"\" : \"?\";\n        return `${serializePropertyName(name)}${optionalToken}: ${propertyType};`;\n      });\n\n      return `{\\n${indent(lines.join(\"\\n\"), level + 1)}\\n${\"  \".repeat(level)}}`;\n    }\n    default:\n      return \"unknown\";\n  }\n}\n\nfunction formatToolDeclaration(\n  name: string,\n  tool: TypegenToolDescriptor,\n): string {\n  const lines: string[] = [];\n  const comment = tool.description ? renderDocComment([tool.description]) : \"\";\n  if (comment) {\n    lines.push(comment);\n  }\n\n  const inputType = schemaToType(tool.inputSchema);\n  const outputType = schemaToType(tool.outputSchema);\n  lines.push(`function ${name}(input: ${inputType}): Promise<${outputType}>;`);\n\n  return lines.join(\"\\n\");\n}\n\n/**\n * Generates a namespace declaration for a provider's tool schemas.\n */\nexport function generateTypesFromJsonSchema(\n  providerName: string,\n  tools: Record<string, TypegenToolDescriptor>,\n): string {\n  return renderNamespaceDeclaration(\n    providerName,\n    Object.entries(tools).map(([name, tool]) =>\n      formatToolDeclaration(name, tool),\n    ),\n  );\n}\n","import Ajv, { type AnySchemaObject, type ValidateFunction } from \"ajv\";\n\nimport {\n  ExecuteFailure,\n  isExecuteFailure,\n  isJsonSerializable,\n} from \"../errors\";\nimport { assertValidIdentifier } from \"../identifier\";\nimport { sanitizeToolName } from \"../sanitize\";\nimport { normalizeToolSchema } from \"../schema/normalizeSchema\";\nimport { generateTypesFromJsonSchema } from \"../typegen/jsonSchema\";\nimport type {\n  JsonSchema,\n  ResolvedToolDescriptor,\n  ResolvedToolProvider,\n  ToolExecutionContext,\n  ToolProvider,\n  TypegenToolDescriptor,\n} from \"../types\";\n\nconst DEFAULT_PROVIDER_NAME = \"codemode\";\nfunction assertValidNamespace(name: string): void {\n  assertValidIdentifier(name, \"provider namespace\");\n}\n\nfunction compileValidator(\n  ajv: Ajv,\n  schema: JsonSchema | undefined,\n): ValidateFunction | undefined {\n  return schema ? ajv.compile(schema as AnySchemaObject) : undefined;\n}\n\nfunction formatValidationMessage(\n  ajv: Ajv,\n  phase: \"input\" | \"output\",\n  toolName: string,\n  validator: ValidateFunction,\n): string {\n  return `Invalid ${phase} for tool ${toolName}: ${ajv.errorsText(validator.errors)}`;\n}\n\n/**\n * Resolves a tool provider into the validated, sanitized shape consumed by executors.\n */\nexport function resolveProvider(provider: ToolProvider): ResolvedToolProvider {\n  const name = provider.name ?? DEFAULT_PROVIDER_NAME;\n  assertValidNamespace(name);\n\n  // strict: false allows schemas with extra keywords (e.g. Zod-generated $schema)\n  // that don't conform to the strict JSON Schema vocabulary.\n  const ajv = new Ajv({\n    allErrors: true,\n    strict: false,\n  });\n\n  const originalToSafeName: Record<string, string> = {};\n  const safeToOriginalName: Record<string, string> = {};\n  const usedSafeNames = new Set<string>();\n  const resolvedTools: Record<string, ResolvedToolDescriptor> = {};\n  const typegenTools: Record<string, TypegenToolDescriptor> = {};\n\n  for (const [originalName, descriptor] of Object.entries(provider.tools)) {\n    const baseSafeName = sanitizeToolName(originalName);\n    let safeName = baseSafeName;\n    let suffix = 2;\n\n    while (usedSafeNames.has(safeName)) {\n      safeName = `${baseSafeName}__${suffix}`;\n      suffix += 1;\n    }\n\n    usedSafeNames.add(safeName);\n    originalToSafeName[originalName] = safeName;\n    safeToOriginalName[safeName] = originalName;\n\n    const inputSchema = normalizeToolSchema(\n      descriptor.inputSchema,\n      \"input\",\n      originalName,\n    );\n    const outputSchema = normalizeToolSchema(\n      descriptor.outputSchema,\n      \"output\",\n      originalName,\n    );\n    const inputValidator = compileValidator(ajv, inputSchema);\n    const outputValidator = compileValidator(ajv, outputSchema);\n\n    resolvedTools[safeName] = {\n      description: descriptor.description,\n      execute: async (\n        input: unknown,\n        context: ToolExecutionContext,\n      ): Promise<unknown> => {\n        if (inputValidator && !inputValidator(input)) {\n          throw new ExecuteFailure(\n            \"validation_error\",\n            formatValidationMessage(ajv, \"input\", originalName, inputValidator),\n          );\n        }\n\n        try {\n          const result = await descriptor.execute(input, context);\n\n          if (!isJsonSerializable(result)) {\n            throw new ExecuteFailure(\n              \"serialization_error\",\n              `Tool ${originalName} returned a non-serializable value`,\n            );\n          }\n\n          if (outputValidator && !outputValidator(result)) {\n            throw new ExecuteFailure(\n              \"validation_error\",\n              formatValidationMessage(\n                ajv,\n                \"output\",\n                originalName,\n                outputValidator,\n              ),\n            );\n          }\n\n          return result;\n        } catch (error) {\n          if (isExecuteFailure(error)) {\n            throw error;\n          }\n\n          throw new ExecuteFailure(\n            \"tool_error\",\n            error instanceof Error\n              ? error.message\n              : `Tool ${originalName} failed`,\n          );\n        }\n      },\n      inputSchema,\n      originalName,\n      outputSchema,\n      safeName,\n    };\n\n    typegenTools[safeName] = {\n      description: descriptor.description,\n      inputSchema,\n      outputSchema,\n    };\n  }\n\n  return {\n    name,\n    originalToSafeName,\n    safeToOriginalName,\n    tools: resolvedTools,\n    types: provider.types ?? generateTypesFromJsonSchema(name, typegenTools),\n  };\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@execbox/core",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Core execution contract, provider resolution, and MCP adapters.",
   "license": "MIT",
   "type": "module",