@truefoundry/trueforge-core 0.0.0 → 0.1.0

package/dist/core/mcp/convertMCPServers.mjs

@@ -0,0 +1,64 @@
+// src/core/mcp/convertMCPServers.ts
+import { isAuthRequired } from "./IMCPServer.mjs";
+import { getUniqueSanitizedToolName } from "./toolNames.mjs";
+async function convertMCPServersToTools(params) {
+  const { tfyManagedServers, userServers } = params;
+  const tools = [];
+  const toolMapping = /* @__PURE__ */ new Map();
+  const initializationInfo = [];
+  const authRequirementInfo = [];
+  const registeredNames = /* @__PURE__ */ new Set();
+  const filteredUserServers = userServers.filter((s) => s.preload || s.hasPreloadedTools);
+  const sortedTfyServers = [...tfyManagedServers].sort((a, b) => a.name > b.name ? 1 : -1);
+  const sortedUserServers = [...filteredUserServers].sort((a, b) => a.name > b.name ? 1 : -1);
+  const allServers = [...sortedTfyServers, ...sortedUserServers];
+  const listResults = await Promise.all(
+    allServers.map(async (server) => ({ serverName: server.name, response: await server.listTools() }))
+  );
+  for (let i = 0; i < allServers.length; i++) {
+    const listResult = listResults[i];
+    if (!listResult) continue;
+    const { serverName, response: listResponse } = listResult;
+    if (isAuthRequired(listResponse)) {
+      authRequirementInfo.push(listResponse.authRequired);
+      continue;
+    }
+    const { result: mcpTools, wasInitialized } = listResponse;
+    if (wasInitialized) {
+      initializationInfo.push(wasInitialized);
+    }
+    const toolSet = allServers[i];
+    if (toolSet === void 0) {
+      throw new Error(`Unreachable: missing tool set at index ${String(i)}`);
+    }
+    const sortedTools = [...mcpTools.tools].sort((a, b) => a.name > b.name ? 1 : -1);
+    for (const mcpTool of sortedTools) {
+      if (!mcpTool.preload) continue;
+      const { name: toolName } = getUniqueSanitizedToolName(mcpTool.name, registeredNames);
+      registeredNames.add(toolName);
+      const description = `mcp server: ${serverName}
+${mcpTool.description ?? ""}`;
+      tools.push({
+        type: "function",
+        function: {
+          name: toolName,
+          description,
+          parameters: {
+            type: "object",
+            properties: mcpTool.inputSchema.properties ?? {},
+            required: mcpTool.inputSchema.required ?? []
+          }
+        }
+      });
+      toolMapping.set(toolName, {
+        toolSet,
+        originalToolName: mcpTool.name
+      });
+    }
+  }
+  return { convertedTools: { tools, toolMapping }, initializationInfo, authRequirementInfo };
+}
+export {
+  convertMCPServersToTools
+};
+//# sourceMappingURL=convertMCPServers.mjs.map

package/dist/core/mcp/convertMCPServers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/mcp/convertMCPServers.ts"],"sourcesContent":["import type { ChatCompletionTool } from 'openai/resources/chat';\nimport type { MCPServerInitInfo } from '../events/schema';\nimport type { MCPAuthRequired } from '../mcp/IMCPServer';\nimport { type IToolSet, isAuthRequired } from './IMCPServer';\nimport { getUniqueSanitizedToolName } from './toolNames';\n\nexport interface MappedMCPTool {\n  toolSet: IToolSet;\n  originalToolName: string;\n}\n\nexport interface ConvertToolsResult {\n  tools: ChatCompletionTool[];\n  toolMapping: Map<string, MappedMCPTool>;\n}\n\nexport interface ConvertMCPServersToToolsResult {\n  convertedTools: ConvertToolsResult;\n  initializationInfo: MCPServerInitInfo[];\n  authRequirementInfo: MCPAuthRequired[];\n}\n\nexport async function convertMCPServersToTools(params: {\n  tfyManagedServers: IToolSet[];\n  userServers: IToolSet[];\n}): Promise<ConvertMCPServersToToolsResult> {\n  const { tfyManagedServers, userServers } = params;\n  const tools: ChatCompletionTool[] = [];\n  const toolMapping = new Map<string, MappedMCPTool>();\n  const initializationInfo: MCPServerInitInfo[] = [];\n  const authRequirementInfo: MCPAuthRequired[] = [];\n  const registeredNames = new Set<string>();\n\n  // Skip non-preloaded servers that have no preloaded tools, to avoid unnecessary listTools() calls and OAuth triggers.\n  // Non-preloaded servers with some preloaded tools are kept so those tools can be registered.\n  const filteredUserServers = userServers.filter(s => s.preload || s.hasPreloadedTools);\n\n  // TFY-managed servers first so they claim their original tool names before user servers.\n  const sortedTfyServers = [...tfyManagedServers].sort((a, b) => (a.name > b.name ? 1 : -1));\n  const sortedUserServers = [...filteredUserServers].sort((a, b) => (a.name > b.name ? 1 : -1));\n  const allServers = [...sortedTfyServers, ...sortedUserServers];\n\n  const listResults = await Promise.all(\n    allServers.map(async server => ({ serverName: server.name, response: await server.listTools() })),\n  );\n\n  for (let i = 0; i < allServers.length; i++) {\n    const listResult = listResults[i];\n    if (!listResult) continue;\n    const { serverName, response: listResponse } = listResult;\n    if (isAuthRequired(listResponse)) {\n      authRequirementInfo.push(listResponse.authRequired);\n      continue;\n    }\n    const { result: mcpTools, wasInitialized } = listResponse;\n    if (wasInitialized) {\n      initializationInfo.push(wasInitialized);\n    }\n\n    const toolSet = allServers[i];\n    if (toolSet === undefined) {\n      throw new Error(`Unreachable: missing tool set at index ${String(i)}`);\n    }\n    const sortedTools = [...mcpTools.tools].sort((a, b) => (a.name > b.name ? 1 : -1));\n    for (const mcpTool of sortedTools) {\n      if (!mcpTool.preload) continue;\n      const { name: toolName } = getUniqueSanitizedToolName(mcpTool.name, registeredNames);\n      registeredNames.add(toolName);\n      const description = `mcp server: ${serverName}\\n${mcpTool.description ?? ''}`;\n      tools.push({\n        type: 'function',\n        function: {\n          name: toolName,\n          description: description,\n          parameters: {\n            type: 'object',\n            properties: mcpTool.inputSchema.properties ?? {},\n            required: mcpTool.inputSchema.required ?? [],\n          },\n        },\n      });\n\n      toolMapping.set(toolName, {\n        toolSet,\n        originalToolName: mcpTool.name,\n      });\n    }\n  }\n\n  return { convertedTools: { tools, toolMapping }, initializationInfo, authRequirementInfo };\n}\n"],"mappings":";AAGA,SAAwB,sBAAsB;AAC9C,SAAS,kCAAkC;AAkB3C,eAAsB,yBAAyB,QAGH;AAC1C,QAAM,EAAE,mBAAmB,YAAY,IAAI;AAC3C,QAAM,QAA8B,CAAC;AACrC,QAAM,cAAc,oBAAI,IAA2B;AACnD,QAAM,qBAA0C,CAAC;AACjD,QAAM,sBAAyC,CAAC;AAChD,QAAM,kBAAkB,oBAAI,IAAY;AAIxC,QAAM,sBAAsB,YAAY,OAAO,OAAK,EAAE,WAAW,EAAE,iBAAiB;AAGpF,QAAM,mBAAmB,CAAC,GAAG,iBAAiB,EAAE,KAAK,CAAC,GAAG,MAAO,EAAE,OAAO,EAAE,OAAO,IAAI,EAAG;AACzF,QAAM,oBAAoB,CAAC,GAAG,mBAAmB,EAAE,KAAK,CAAC,GAAG,MAAO,EAAE,OAAO,EAAE,OAAO,IAAI,EAAG;AAC5F,QAAM,aAAa,CAAC,GAAG,kBAAkB,GAAG,iBAAiB;AAE7D,QAAM,cAAc,MAAM,QAAQ;AAAA,IAChC,WAAW,IAAI,OAAM,YAAW,EAAE,YAAY,OAAO,MAAM,UAAU,MAAM,OAAO,UAAU,EAAE,EAAE;AAAA,EAClG;AAEA,WAAS,IAAI,GAAG,IAAI,WAAW,QAAQ,KAAK;AAC1C,UAAM,aAAa,YAAY,CAAC;AAChC,QAAI,CAAC,WAAY;AACjB,UAAM,EAAE,YAAY,UAAU,aAAa,IAAI;AAC/C,QAAI,eAAe,YAAY,GAAG;AAChC,0BAAoB,KAAK,aAAa,YAAY;AAClD;AAAA,IACF;AACA,UAAM,EAAE,QAAQ,UAAU,eAAe,IAAI;AAC7C,QAAI,gBAAgB;AAClB,yBAAmB,KAAK,cAAc;AAAA,IACxC;AAEA,UAAM,UAAU,WAAW,CAAC;AAC5B,QAAI,YAAY,QAAW;AACzB,YAAM,IAAI,MAAM,0CAA0C,OAAO,CAAC,CAAC,EAAE;AAAA,IACvE;AACA,UAAM,cAAc,CAAC,GAAG,SAAS,KAAK,EAAE,KAAK,CAAC,GAAG,MAAO,EAAE,OAAO,EAAE,OAAO,IAAI,EAAG;AACjF,eAAW,WAAW,aAAa;AACjC,UAAI,CAAC,QAAQ,QAAS;AACtB,YAAM,EAAE,MAAM,SAAS,IAAI,2BAA2B,QAAQ,MAAM,eAAe;AACnF,sBAAgB,IAAI,QAAQ;AAC5B,YAAM,cAAc,eAAe,UAAU;AAAA,EAAK,QAAQ,eAAe,EAAE;AAC3E,YAAM,KAAK;AAAA,QACT,MAAM;AAAA,QACN,UAAU;AAAA,UACR,MAAM;AAAA,UACN;AAAA,UACA,YAAY;AAAA,YACV,MAAM;AAAA,YACN,YAAY,QAAQ,YAAY,cAAc,CAAC;AAAA,YAC/C,UAAU,QAAQ,YAAY,YAAY,CAAC;AAAA,UAC7C;AAAA,QACF;AAAA,MACF,CAAC;AAED,kBAAY,IAAI,UAAU;AAAA,QACxB;AAAA,QACA,kBAAkB,QAAQ;AAAA,MAC5B,CAAC;AAAA,IACH;AAAA,EACF;AAEA,SAAO,EAAE,gBAAgB,EAAE,OAAO,YAAY,GAAG,oBAAoB,oBAAoB;AAC3F;","names":[]}

package/dist/core/mcp/executeToolCalls.d.ts

@@ -0,0 +1,31 @@
+import type { RegisteredPassthroughEvent } from '../events/PassthroughEvents';
+import type { ApprovalDecision, MCPServerInitInfo } from '../events/schema';
+import type { InternalEnrichedAssistantMessage, InternalEnrichedToolCall, LLMToolMessage } from '../llm/LLMTypes';
+import type { MCPAuthRequired } from '../mcp/IMCPServer';
+import type { AgentThreadCreateSubAgent } from '../runtime/AgentThread.types';
+import type { SandboxInfo } from '../sandbox/Sandbox';
+import type { MappedMCPTool } from './convertMCPServers';
+export interface ToolCallResult {
+    message: LLMToolMessage;
+    info?: MappedMCPTool | undefined;
+    failure: boolean;
+    isStructuredContent: boolean;
+    completedAt: string;
+}
+export interface ExecuteToolCallsResult {
+    toolCallResults: ToolCallResult[];
+    initializationInfo: MCPServerInitInfo[];
+    createThreadEvents: AgentThreadCreateSubAgent[];
+    sandboxCreated: SandboxInfo | undefined;
+    authRequirementInfo: MCPAuthRequired[];
+    approvalRequiredToolCalls: InternalEnrichedToolCall[];
+    clientSideToolCalls: InternalEnrichedToolCall[];
+    events: RegisteredPassthroughEvent[];
+}
+export declare function executeToolCalls({ assistantMessage, toolMapping, threadId, approvalDecisions, }: {
+    assistantMessage: InternalEnrichedAssistantMessage;
+    toolMapping: Map<string, MappedMCPTool>;
+    threadId: string;
+    approvalDecisions: Map<string, ApprovalDecision>;
+}): Promise<ExecuteToolCallsResult>;
+//# sourceMappingURL=executeToolCalls.d.ts.map

package/dist/core/mcp/executeToolCalls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executeToolCalls.d.ts","sourceRoot":"","sources":["../../../src/core/mcp/executeToolCalls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAC9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,KAAK,EAAE,gCAAgC,EAAE,wBAAwB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAClH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAE9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AASzD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,cAAc,CAAC;IAKxB,IAAI,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,kBAAkB,EAAE,iBAAiB,EAAE,CAAC;IACxC,kBAAkB,EAAE,yBAAyB,EAAE,CAAC;IAChD,cAAc,EAAE,WAAW,GAAG,SAAS,CAAC;IACxC,mBAAmB,EAAE,eAAe,EAAE,CAAC;IACvC,yBAAyB,EAAE,wBAAwB,EAAE,CAAC;IACtD,mBAAmB,EAAE,wBAAwB,EAAE,CAAC;IAChD,MAAM,EAAE,0BAA0B,EAAE,CAAC;CACtC;AAED,wBAAsB,gBAAgB,CAAC,EACrC,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,iBAAiB,GAClB,EAAE;IACD,gBAAgB,EAAE,gCAAgC,CAAC;IACnD,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAClD,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAkJlC"}

package/dist/core/mcp/executeToolCalls.js

@@ -0,0 +1,168 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/core/mcp/executeToolCalls.ts
+var executeToolCalls_exports = {};
+__export(executeToolCalls_exports, {
+  executeToolCalls: () => executeToolCalls
+});
+module.exports = __toCommonJS(executeToolCalls_exports);
+var import_AgentThread = require("../runtime/AgentThread.types.js");
+var import_IMCPServer = require("./IMCPServer.js");
+async function executeToolCalls({
+  assistantMessage,
+  toolMapping,
+  threadId,
+  approvalDecisions
+}) {
+  const toolMessages = [];
+  const initializationInfo = [];
+  const createThreadEvents = [];
+  const authRequirementInfo = [];
+  const approvalRequiredToolCalls = [];
+  const clientSideToolCalls = [];
+  const passthroughEvents = [];
+  let sandboxCreated;
+  if (!assistantMessage.tool_calls) {
+    return {
+      toolCallResults: toolMessages,
+      initializationInfo,
+      createThreadEvents,
+      sandboxCreated,
+      authRequirementInfo,
+      approvalRequiredToolCalls,
+      clientSideToolCalls,
+      events: passthroughEvents
+    };
+  }
+  const toolCallPromises = assistantMessage.tool_calls.map(async (toolCall) => {
+    const toolInfo = toolMapping.get(toolCall.function.name);
+    if (!toolInfo) {
+      return {
+        toolCall,
+        toolInfo,
+        response: (0, import_IMCPServer.toolResultResponse)({ text: `Tool ${toolCall.function.name} not found in tool mapping` }),
+        failure: true,
+        completedAt: (/* @__PURE__ */ new Date()).toISOString()
+      };
+    }
+    try {
+      const args = JSON.parse(toolCall.function.arguments || "{}");
+      const response = await toolInfo.toolSet.callTool(
+        {
+          name: toolInfo.originalToolName,
+          arguments: args
+        },
+        approvalDecisions.get(toolCall.id)
+      );
+      return { toolCall, toolInfo, response, failure: false, completedAt: (/* @__PURE__ */ new Date()).toISOString() };
+    } catch (error) {
+      return {
+        toolCall,
+        toolInfo,
+        response: (0, import_IMCPServer.toolResultResponse)({
+          text: JSON.stringify({ error: error instanceof Error ? error.message : "Tool execution failed" }),
+          isError: true
+        }),
+        failure: true,
+        completedAt: (/* @__PURE__ */ new Date()).toISOString()
+      };
+    }
+  });
+  const results = await Promise.all(toolCallPromises);
+  for (const { toolCall, toolInfo, response, failure, completedAt } of results) {
+    if ((0, import_IMCPServer.isCallToolResponseCreateSubAgent)(response)) {
+      createThreadEvents.push({
+        type: import_AgentThread.InternalEventType.AGENT_CREATE_SUBAGENT,
+        thread_id: threadId,
+        tool_call_id: toolCall.id,
+        agent_info: response.createSubAgent
+      });
+      continue;
+    }
+    if ((0, import_IMCPServer.isAuthRequired)(response)) {
+      authRequirementInfo.push(response.authRequired);
+      toolMessages.push({
+        message: {
+          role: "tool",
+          tool_call_id: toolCall.id,
+          content: "Waiting for user to authenticate. Please try again 1 time."
+        },
+        failure: true,
+        info: toolInfo,
+        isStructuredContent: false,
+        completedAt
+      });
+      continue;
+    }
+    if ((0, import_IMCPServer.isApprovalRequiredResponse)(response)) {
+      approvalRequiredToolCalls.push(toolCall);
+      continue;
+    }
+    if ((0, import_IMCPServer.isClientSideToolRequiredResponse)(response)) {
+      clientSideToolCalls.push(toolCall);
+      continue;
+    }
+    const { result, wasInitialized } = response;
+    let content;
+    let isStructuredContent = false;
+    if (result.isError) {
+      content = JSON.stringify({ error: result.content });
+    } else if (result.structuredContent) {
+      isStructuredContent = true;
+      content = JSON.stringify(result.structuredContent);
+    } else if (Array.isArray(result.content)) {
+      const textContent = result.content.filter((c) => c.type === "text").map((c) => c.text).join("\n");
+      content = textContent || JSON.stringify(result.content);
+    } else {
+      content = JSON.stringify(result.content);
+    }
+    toolMessages.push({
+      message: { role: "tool", tool_call_id: toolCall.id, content },
+      failure,
+      info: toolInfo,
+      isStructuredContent,
+      completedAt
+    });
+    if (wasInitialized) {
+      initializationInfo.push(wasInitialized);
+    }
+    if (response.sandboxCreated && response.sandboxInfo) {
+      sandboxCreated = response.sandboxInfo;
+    }
+    if (response.events?.length) {
+      passthroughEvents.push(...response.events);
+    }
+  }
+  return {
+    toolCallResults: toolMessages,
+    initializationInfo,
+    createThreadEvents,
+    sandboxCreated,
+    authRequirementInfo,
+    approvalRequiredToolCalls,
+    clientSideToolCalls,
+    events: passthroughEvents
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  executeToolCalls
+});
+//# sourceMappingURL=executeToolCalls.js.map

package/dist/core/mcp/executeToolCalls.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/mcp/executeToolCalls.ts"],"sourcesContent":["import type { RegisteredPassthroughEvent } from '../events/PassthroughEvents';\nimport type { ApprovalDecision, MCPServerInitInfo } from '../events/schema';\nimport type { InternalEnrichedAssistantMessage, InternalEnrichedToolCall, LLMToolMessage } from '../llm/LLMTypes';\nimport type { MCPAuthRequired } from '../mcp/IMCPServer';\nimport type { AgentThreadCreateSubAgent } from '../runtime/AgentThread.types';\nimport { InternalEventType } from '../runtime/AgentThread.types';\nimport type { SandboxInfo } from '../sandbox/Sandbox';\nimport type { MappedMCPTool } from './convertMCPServers';\nimport {\n  isApprovalRequiredResponse,\n  isAuthRequired,\n  isCallToolResponseCreateSubAgent,\n  isClientSideToolRequiredResponse,\n  toolResultResponse,\n} from './IMCPServer';\n\nexport interface ToolCallResult {\n  message: LLMToolMessage;\n  // Absent only for unknown-tool calls (LLM hallucinated a name not in toolMapping):\n  // there is no backing MCP server. Downstream consumers (e.g. LargeToolResponse)\n  // gate on `failure: false` before reading `info`, so the absence is naturally\n  // short-circuited on the success path.\n  info?: MappedMCPTool | undefined;\n  failure: boolean;\n  isStructuredContent: boolean;\n  completedAt: string;\n}\n\nexport interface ExecuteToolCallsResult {\n  toolCallResults: ToolCallResult[];\n  initializationInfo: MCPServerInitInfo[];\n  createThreadEvents: AgentThreadCreateSubAgent[];\n  sandboxCreated: SandboxInfo | undefined;\n  authRequirementInfo: MCPAuthRequired[];\n  approvalRequiredToolCalls: InternalEnrichedToolCall[];\n  clientSideToolCalls: InternalEnrichedToolCall[];\n  events: RegisteredPassthroughEvent[];\n}\n\nexport async function executeToolCalls({\n  assistantMessage,\n  toolMapping,\n  threadId,\n  approvalDecisions,\n}: {\n  assistantMessage: InternalEnrichedAssistantMessage;\n  toolMapping: Map<string, MappedMCPTool>;\n  threadId: string;\n  approvalDecisions: Map<string, ApprovalDecision>;\n}): Promise<ExecuteToolCallsResult> {\n  const toolMessages: ToolCallResult[] = [];\n  const initializationInfo: MCPServerInitInfo[] = [];\n  const createThreadEvents: AgentThreadCreateSubAgent[] = [];\n  const authRequirementInfo: MCPAuthRequired[] = [];\n  const approvalRequiredToolCalls: InternalEnrichedToolCall[] = [];\n  const clientSideToolCalls: InternalEnrichedToolCall[] = [];\n  const passthroughEvents: RegisteredPassthroughEvent[] = [];\n  let sandboxCreated: SandboxInfo | undefined;\n\n  if (!assistantMessage.tool_calls) {\n    return {\n      toolCallResults: toolMessages,\n      initializationInfo,\n      createThreadEvents,\n      sandboxCreated,\n      authRequirementInfo,\n      approvalRequiredToolCalls,\n      clientSideToolCalls,\n      events: passthroughEvents,\n    };\n  }\n\n  const toolCallPromises = assistantMessage.tool_calls.map(async toolCall => {\n    const toolInfo = toolMapping.get(toolCall.function.name);\n    if (!toolInfo) {\n      return {\n        toolCall,\n        toolInfo,\n        response: toolResultResponse({ text: `Tool ${toolCall.function.name} not found in tool mapping` }),\n        failure: true,\n        completedAt: new Date().toISOString(),\n      };\n    }\n\n    try {\n      const args: Record<string, unknown> = JSON.parse(toolCall.function.arguments || '{}') as Record<string, unknown>;\n      const response = await toolInfo.toolSet.callTool(\n        {\n          name: toolInfo.originalToolName,\n          arguments: args,\n        },\n        approvalDecisions.get(toolCall.id),\n      );\n      return { toolCall, toolInfo, response, failure: false, completedAt: new Date().toISOString() };\n    } catch (error) {\n      return {\n        toolCall,\n        toolInfo,\n        response: toolResultResponse({\n          text: JSON.stringify({ error: error instanceof Error ? error.message : 'Tool execution failed' }),\n          isError: true,\n        }),\n        failure: true,\n        completedAt: new Date().toISOString(),\n      };\n    }\n  });\n\n  const results = await Promise.all(toolCallPromises);\n  for (const { toolCall, toolInfo, response, failure, completedAt } of results) {\n    if (isCallToolResponseCreateSubAgent(response)) {\n      createThreadEvents.push({\n        type: InternalEventType.AGENT_CREATE_SUBAGENT,\n        thread_id: threadId,\n        tool_call_id: toolCall.id,\n        agent_info: response.createSubAgent,\n      });\n      continue;\n    }\n\n    if (isAuthRequired(response)) {\n      authRequirementInfo.push(response.authRequired);\n      // Must still emit a tool result so every tool_call in the assistant message has a\n      // matching tool_result in context; otherwise the LLM API rejects the conversation.\n      toolMessages.push({\n        message: {\n          role: 'tool',\n          tool_call_id: toolCall.id,\n          content: 'Waiting for user to authenticate. Please try again 1 time.',\n        },\n        failure: true,\n        info: toolInfo,\n        isStructuredContent: false,\n        completedAt,\n      });\n      continue;\n    }\n\n    if (isApprovalRequiredResponse(response)) {\n      approvalRequiredToolCalls.push(toolCall);\n      continue;\n    }\n\n    if (isClientSideToolRequiredResponse(response)) {\n      clientSideToolCalls.push(toolCall);\n      continue;\n    }\n\n    const { result, wasInitialized } = response;\n\n    let content: string;\n    let isStructuredContent = false;\n    if (result.isError) {\n      content = JSON.stringify({ error: result.content });\n    } else if (result.structuredContent) {\n      isStructuredContent = true;\n      content = JSON.stringify(result.structuredContent);\n    } else if (Array.isArray(result.content)) {\n      const textContent = result.content\n        .filter((c): c is { type: 'text'; text: string } => c.type === 'text')\n        .map(c => c.text)\n        .join('\\n');\n      content = textContent || JSON.stringify(result.content);\n    } else {\n      content = JSON.stringify(result.content);\n    }\n\n    toolMessages.push({\n      message: { role: 'tool' as const, tool_call_id: toolCall.id, content },\n      failure,\n      info: toolInfo,\n      isStructuredContent,\n      completedAt,\n    });\n    if (wasInitialized) {\n      initializationInfo.push(wasInitialized);\n    }\n    if (response.sandboxCreated && response.sandboxInfo) {\n      sandboxCreated = response.sandboxInfo;\n    }\n    if (response.events?.length) {\n      passthroughEvents.push(...response.events);\n    }\n  }\n\n  return {\n    toolCallResults: toolMessages,\n    initializationInfo,\n    createThreadEvents,\n    sandboxCreated,\n    authRequirementInfo,\n    approvalRequiredToolCalls,\n    clientSideToolCalls,\n    events: passthroughEvents,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/core/mcp/executeToolCalls.mjs

@@ -0,0 +1,149 @@
+// src/core/mcp/executeToolCalls.ts
+import { InternalEventType } from "../runtime/AgentThread.types.mjs";
+import {
+  isApprovalRequiredResponse,
+  isAuthRequired,
+  isCallToolResponseCreateSubAgent,
+  isClientSideToolRequiredResponse,
+  toolResultResponse
+} from "./IMCPServer.mjs";
+async function executeToolCalls({
+  assistantMessage,
+  toolMapping,
+  threadId,
+  approvalDecisions
+}) {
+  const toolMessages = [];
+  const initializationInfo = [];
+  const createThreadEvents = [];
+  const authRequirementInfo = [];
+  const approvalRequiredToolCalls = [];
+  const clientSideToolCalls = [];
+  const passthroughEvents = [];
+  let sandboxCreated;
+  if (!assistantMessage.tool_calls) {
+    return {
+      toolCallResults: toolMessages,
+      initializationInfo,
+      createThreadEvents,
+      sandboxCreated,
+      authRequirementInfo,
+      approvalRequiredToolCalls,
+      clientSideToolCalls,
+      events: passthroughEvents
+    };
+  }
+  const toolCallPromises = assistantMessage.tool_calls.map(async (toolCall) => {
+    const toolInfo = toolMapping.get(toolCall.function.name);
+    if (!toolInfo) {
+      return {
+        toolCall,
+        toolInfo,
+        response: toolResultResponse({ text: `Tool ${toolCall.function.name} not found in tool mapping` }),
+        failure: true,
+        completedAt: (/* @__PURE__ */ new Date()).toISOString()
+      };
+    }
+    try {
+      const args = JSON.parse(toolCall.function.arguments || "{}");
+      const response = await toolInfo.toolSet.callTool(
+        {
+          name: toolInfo.originalToolName,
+          arguments: args
+        },
+        approvalDecisions.get(toolCall.id)
+      );
+      return { toolCall, toolInfo, response, failure: false, completedAt: (/* @__PURE__ */ new Date()).toISOString() };
+    } catch (error) {
+      return {
+        toolCall,
+        toolInfo,
+        response: toolResultResponse({
+          text: JSON.stringify({ error: error instanceof Error ? error.message : "Tool execution failed" }),
+          isError: true
+        }),
+        failure: true,
+        completedAt: (/* @__PURE__ */ new Date()).toISOString()
+      };
+    }
+  });
+  const results = await Promise.all(toolCallPromises);
+  for (const { toolCall, toolInfo, response, failure, completedAt } of results) {
+    if (isCallToolResponseCreateSubAgent(response)) {
+      createThreadEvents.push({
+        type: InternalEventType.AGENT_CREATE_SUBAGENT,
+        thread_id: threadId,
+        tool_call_id: toolCall.id,
+        agent_info: response.createSubAgent
+      });
+      continue;
+    }
+    if (isAuthRequired(response)) {
+      authRequirementInfo.push(response.authRequired);
+      toolMessages.push({
+        message: {
+          role: "tool",
+          tool_call_id: toolCall.id,
+          content: "Waiting for user to authenticate. Please try again 1 time."
+        },
+        failure: true,
+        info: toolInfo,
+        isStructuredContent: false,
+        completedAt
+      });
+      continue;
+    }
+    if (isApprovalRequiredResponse(response)) {
+      approvalRequiredToolCalls.push(toolCall);
+      continue;
+    }
+    if (isClientSideToolRequiredResponse(response)) {
+      clientSideToolCalls.push(toolCall);
+      continue;
+    }
+    const { result, wasInitialized } = response;
+    let content;
+    let isStructuredContent = false;
+    if (result.isError) {
+      content = JSON.stringify({ error: result.content });
+    } else if (result.structuredContent) {
+      isStructuredContent = true;
+      content = JSON.stringify(result.structuredContent);
+    } else if (Array.isArray(result.content)) {
+      const textContent = result.content.filter((c) => c.type === "text").map((c) => c.text).join("\n");
+      content = textContent || JSON.stringify(result.content);
+    } else {
+      content = JSON.stringify(result.content);
+    }
+    toolMessages.push({
+      message: { role: "tool", tool_call_id: toolCall.id, content },
+      failure,
+      info: toolInfo,
+      isStructuredContent,
+      completedAt
+    });
+    if (wasInitialized) {
+      initializationInfo.push(wasInitialized);
+    }
+    if (response.sandboxCreated && response.sandboxInfo) {
+      sandboxCreated = response.sandboxInfo;
+    }
+    if (response.events?.length) {
+      passthroughEvents.push(...response.events);
+    }
+  }
+  return {
+    toolCallResults: toolMessages,
+    initializationInfo,
+    createThreadEvents,
+    sandboxCreated,
+    authRequirementInfo,
+    approvalRequiredToolCalls,
+    clientSideToolCalls,
+    events: passthroughEvents
+  };
+}
+export {
+  executeToolCalls
+};
+//# sourceMappingURL=executeToolCalls.mjs.map

package/dist/core/mcp/executeToolCalls.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/mcp/executeToolCalls.ts"],"sourcesContent":["import type { RegisteredPassthroughEvent } from '../events/PassthroughEvents';\nimport type { ApprovalDecision, MCPServerInitInfo } from '../events/schema';\nimport type { InternalEnrichedAssistantMessage, InternalEnrichedToolCall, LLMToolMessage } from '../llm/LLMTypes';\nimport type { MCPAuthRequired } from '../mcp/IMCPServer';\nimport type { AgentThreadCreateSubAgent } from '../runtime/AgentThread.types';\nimport { InternalEventType } from '../runtime/AgentThread.types';\nimport type { SandboxInfo } from '../sandbox/Sandbox';\nimport type { MappedMCPTool } from './convertMCPServers';\nimport {\n  isApprovalRequiredResponse,\n  isAuthRequired,\n  isCallToolResponseCreateSubAgent,\n  isClientSideToolRequiredResponse,\n  toolResultResponse,\n} from './IMCPServer';\n\nexport interface ToolCallResult {\n  message: LLMToolMessage;\n  // Absent only for unknown-tool calls (LLM hallucinated a name not in toolMapping):\n  // there is no backing MCP server. Downstream consumers (e.g. LargeToolResponse)\n  // gate on `failure: false` before reading `info`, so the absence is naturally\n  // short-circuited on the success path.\n  info?: MappedMCPTool | undefined;\n  failure: boolean;\n  isStructuredContent: boolean;\n  completedAt: string;\n}\n\nexport interface ExecuteToolCallsResult {\n  toolCallResults: ToolCallResult[];\n  initializationInfo: MCPServerInitInfo[];\n  createThreadEvents: AgentThreadCreateSubAgent[];\n  sandboxCreated: SandboxInfo | undefined;\n  authRequirementInfo: MCPAuthRequired[];\n  approvalRequiredToolCalls: InternalEnrichedToolCall[];\n  clientSideToolCalls: InternalEnrichedToolCall[];\n  events: RegisteredPassthroughEvent[];\n}\n\nexport async function executeToolCalls({\n  assistantMessage,\n  toolMapping,\n  threadId,\n  approvalDecisions,\n}: {\n  assistantMessage: InternalEnrichedAssistantMessage;\n  toolMapping: Map<string, MappedMCPTool>;\n  threadId: string;\n  approvalDecisions: Map<string, ApprovalDecision>;\n}): Promise<ExecuteToolCallsResult> {\n  const toolMessages: ToolCallResult[] = [];\n  const initializationInfo: MCPServerInitInfo[] = [];\n  const createThreadEvents: AgentThreadCreateSubAgent[] = [];\n  const authRequirementInfo: MCPAuthRequired[] = [];\n  const approvalRequiredToolCalls: InternalEnrichedToolCall[] = [];\n  const clientSideToolCalls: InternalEnrichedToolCall[] = [];\n  const passthroughEvents: RegisteredPassthroughEvent[] = [];\n  let sandboxCreated: SandboxInfo | undefined;\n\n  if (!assistantMessage.tool_calls) {\n    return {\n      toolCallResults: toolMessages,\n      initializationInfo,\n      createThreadEvents,\n      sandboxCreated,\n      authRequirementInfo,\n      approvalRequiredToolCalls,\n      clientSideToolCalls,\n      events: passthroughEvents,\n    };\n  }\n\n  const toolCallPromises = assistantMessage.tool_calls.map(async toolCall => {\n    const toolInfo = toolMapping.get(toolCall.function.name);\n    if (!toolInfo) {\n      return {\n        toolCall,\n        toolInfo,\n        response: toolResultResponse({ text: `Tool ${toolCall.function.name} not found in tool mapping` }),\n        failure: true,\n        completedAt: new Date().toISOString(),\n      };\n    }\n\n    try {\n      const args: Record<string, unknown> = JSON.parse(toolCall.function.arguments || '{}') as Record<string, unknown>;\n      const response = await toolInfo.toolSet.callTool(\n        {\n          name: toolInfo.originalToolName,\n          arguments: args,\n        },\n        approvalDecisions.get(toolCall.id),\n      );\n      return { toolCall, toolInfo, response, failure: false, completedAt: new Date().toISOString() };\n    } catch (error) {\n      return {\n        toolCall,\n        toolInfo,\n        response: toolResultResponse({\n          text: JSON.stringify({ error: error instanceof Error ? error.message : 'Tool execution failed' }),\n          isError: true,\n        }),\n        failure: true,\n        completedAt: new Date().toISOString(),\n      };\n    }\n  });\n\n  const results = await Promise.all(toolCallPromises);\n  for (const { toolCall, toolInfo, response, failure, completedAt } of results) {\n    if (isCallToolResponseCreateSubAgent(response)) {\n      createThreadEvents.push({\n        type: InternalEventType.AGENT_CREATE_SUBAGENT,\n        thread_id: threadId,\n        tool_call_id: toolCall.id,\n        agent_info: response.createSubAgent,\n      });\n      continue;\n    }\n\n    if (isAuthRequired(response)) {\n      authRequirementInfo.push(response.authRequired);\n      // Must still emit a tool result so every tool_call in the assistant message has a\n      // matching tool_result in context; otherwise the LLM API rejects the conversation.\n      toolMessages.push({\n        message: {\n          role: 'tool',\n          tool_call_id: toolCall.id,\n          content: 'Waiting for user to authenticate. Please try again 1 time.',\n        },\n        failure: true,\n        info: toolInfo,\n        isStructuredContent: false,\n        completedAt,\n      });\n      continue;\n    }\n\n    if (isApprovalRequiredResponse(response)) {\n      approvalRequiredToolCalls.push(toolCall);\n      continue;\n    }\n\n    if (isClientSideToolRequiredResponse(response)) {\n      clientSideToolCalls.push(toolCall);\n      continue;\n    }\n\n    const { result, wasInitialized } = response;\n\n    let content: string;\n    let isStructuredContent = false;\n    if (result.isError) {\n      content = JSON.stringify({ error: result.content });\n    } else if (result.structuredContent) {\n      isStructuredContent = true;\n      content = JSON.stringify(result.structuredContent);\n    } else if (Array.isArray(result.content)) {\n      const textContent = result.content\n        .filter((c): c is { type: 'text'; text: string } => c.type === 'text')\n        .map(c => c.text)\n        .join('\\n');\n      content = textContent || JSON.stringify(result.content);\n    } else {\n      content = JSON.stringify(result.content);\n    }\n\n    toolMessages.push({\n      message: { role: 'tool' as const, tool_call_id: toolCall.id, content },\n      failure,\n      info: toolInfo,\n      isStructuredContent,\n      completedAt,\n    });\n    if (wasInitialized) {\n      initializationInfo.push(wasInitialized);\n    }\n    if (response.sandboxCreated && response.sandboxInfo) {\n      sandboxCreated = response.sandboxInfo;\n    }\n    if (response.events?.length) {\n      passthroughEvents.push(...response.events);\n    }\n  }\n\n  return {\n    toolCallResults: toolMessages,\n    initializationInfo,\n    createThreadEvents,\n    sandboxCreated,\n    authRequirementInfo,\n    approvalRequiredToolCalls,\n    clientSideToolCalls,\n    events: passthroughEvents,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/core/mcp/pagination.d.ts

@@ -0,0 +1,11 @@
+import type { Logger } from 'winston';
+/**
+ * Walk an MCP cursor-paginated list to completion, guarding against servers that return a
+ * previously seen cursor (which would otherwise loop forever). If a repeated cursor is seen the
+ * loop stops and (when a logger is supplied) a warning is emitted naming the server.
+ */
+export declare function paginateWithCursorGuard<T>(fetchNext: (cursor: string | undefined) => Promise<{
+    items: T[];
+    nextCursor?: string | undefined;
+}>, serverIdentifier: string | undefined, logger?: Logger): Promise<T[]>;
+//# sourceMappingURL=pagination.d.ts.map

package/dist/core/mcp/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../../src/core/mcp/pagination.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEtC;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,CAAC,EAC7C,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC;IAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC,EACnG,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,CAAC,EAAE,CAAC,CAsBd"}

package/dist/core/mcp/pagination.js

@@ -0,0 +1,49 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/core/mcp/pagination.ts
+var pagination_exports = {};
+__export(pagination_exports, {
+  paginateWithCursorGuard: () => paginateWithCursorGuard
+});
+module.exports = __toCommonJS(pagination_exports);
+async function paginateWithCursorGuard(fetchNext, serverIdentifier, logger) {
+  const allItems = [];
+  const seenCursors = /* @__PURE__ */ new Set();
+  const serverName = serverIdentifier ?? "unknown";
+  const firstResult = await fetchNext(void 0);
+  allItems.push(...firstResult.items);
+  let cursor = firstResult.nextCursor;
+  while (cursor) {
+    if (seenCursors.has(cursor)) {
+      logger?.warn(`Detected repeated cursor "${cursor}" from server ${serverName}. Breaking pagination loop.`);
+      break;
+    }
+    seenCursors.add(cursor);
+    const result = await fetchNext(cursor);
+    allItems.push(...result.items);
+    cursor = result.nextCursor;
+  }
+  return allItems;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  paginateWithCursorGuard
+});
+//# sourceMappingURL=pagination.js.map

package/dist/core/mcp/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/mcp/pagination.ts"],"sourcesContent":["import type { Logger } from 'winston';\n\n/**\n * Walk an MCP cursor-paginated list to completion, guarding against servers that return a\n * previously seen cursor (which would otherwise loop forever). If a repeated cursor is seen the\n * loop stops and (when a logger is supplied) a warning is emitted naming the server.\n */\nexport async function paginateWithCursorGuard<T>(\n  fetchNext: (cursor: string | undefined) => Promise<{ items: T[]; nextCursor?: string | undefined }>,\n  serverIdentifier: string | undefined,\n  logger?: Logger,\n): Promise<T[]> {\n  const allItems: T[] = [];\n  const seenCursors = new Set<string>();\n  const serverName = serverIdentifier ?? 'unknown';\n\n  const firstResult = await fetchNext(undefined);\n  allItems.push(...firstResult.items);\n  let cursor = firstResult.nextCursor;\n\n  while (cursor) {\n    if (seenCursors.has(cursor)) {\n      logger?.warn(`Detected repeated cursor \"${cursor}\" from server ${serverName}. Breaking pagination loop.`);\n      break;\n    }\n    seenCursors.add(cursor);\n\n    const result = await fetchNext(cursor);\n    allItems.push(...result.items);\n    cursor = result.nextCursor;\n  }\n\n  return allItems;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,eAAsB,wBACpB,WACA,kBACA,QACc;AACd,QAAM,WAAgB,CAAC;AACvB,QAAM,cAAc,oBAAI,IAAY;AACpC,QAAM,aAAa,oBAAoB;AAEvC,QAAM,cAAc,MAAM,UAAU,MAAS;AAC7C,WAAS,KAAK,GAAG,YAAY,KAAK;AAClC,MAAI,SAAS,YAAY;AAEzB,SAAO,QAAQ;AACb,QAAI,YAAY,IAAI,MAAM,GAAG;AAC3B,cAAQ,KAAK,6BAA6B,MAAM,iBAAiB,UAAU,6BAA6B;AACxG;AAAA,IACF;AACA,gBAAY,IAAI,MAAM;AAEtB,UAAM,SAAS,MAAM,UAAU,MAAM;AACrC,aAAS,KAAK,GAAG,OAAO,KAAK;AAC7B,aAAS,OAAO;AAAA,EAClB;AAEA,SAAO;AACT;","names":[]}

package/dist/core/mcp/pagination.mjs

@@ -0,0 +1,24 @@
+// src/core/mcp/pagination.ts
+async function paginateWithCursorGuard(fetchNext, serverIdentifier, logger) {
+  const allItems = [];
+  const seenCursors = /* @__PURE__ */ new Set();
+  const serverName = serverIdentifier ?? "unknown";
+  const firstResult = await fetchNext(void 0);
+  allItems.push(...firstResult.items);
+  let cursor = firstResult.nextCursor;
+  while (cursor) {
+    if (seenCursors.has(cursor)) {
+      logger?.warn(`Detected repeated cursor "${cursor}" from server ${serverName}. Breaking pagination loop.`);
+      break;
+    }
+    seenCursors.add(cursor);
+    const result = await fetchNext(cursor);
+    allItems.push(...result.items);
+    cursor = result.nextCursor;
+  }
+  return allItems;
+}
+export {
+  paginateWithCursorGuard
+};
+//# sourceMappingURL=pagination.mjs.map

package/dist/core/mcp/pagination.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/mcp/pagination.ts"],"sourcesContent":["import type { Logger } from 'winston';\n\n/**\n * Walk an MCP cursor-paginated list to completion, guarding against servers that return a\n * previously seen cursor (which would otherwise loop forever). If a repeated cursor is seen the\n * loop stops and (when a logger is supplied) a warning is emitted naming the server.\n */\nexport async function paginateWithCursorGuard<T>(\n  fetchNext: (cursor: string | undefined) => Promise<{ items: T[]; nextCursor?: string | undefined }>,\n  serverIdentifier: string | undefined,\n  logger?: Logger,\n): Promise<T[]> {\n  const allItems: T[] = [];\n  const seenCursors = new Set<string>();\n  const serverName = serverIdentifier ?? 'unknown';\n\n  const firstResult = await fetchNext(undefined);\n  allItems.push(...firstResult.items);\n  let cursor = firstResult.nextCursor;\n\n  while (cursor) {\n    if (seenCursors.has(cursor)) {\n      logger?.warn(`Detected repeated cursor \"${cursor}\" from server ${serverName}. Breaking pagination loop.`);\n      break;\n    }\n    seenCursors.add(cursor);\n\n    const result = await fetchNext(cursor);\n    allItems.push(...result.items);\n    cursor = result.nextCursor;\n  }\n\n  return allItems;\n}\n"],"mappings":";AAOA,eAAsB,wBACpB,WACA,kBACA,QACc;AACd,QAAM,WAAgB,CAAC;AACvB,QAAM,cAAc,oBAAI,IAAY;AACpC,QAAM,aAAa,oBAAoB;AAEvC,QAAM,cAAc,MAAM,UAAU,MAAS;AAC7C,WAAS,KAAK,GAAG,YAAY,KAAK;AAClC,MAAI,SAAS,YAAY;AAEzB,SAAO,QAAQ;AACb,QAAI,YAAY,IAAI,MAAM,GAAG;AAC3B,cAAQ,KAAK,6BAA6B,MAAM,iBAAiB,UAAU,6BAA6B;AACxG;AAAA,IACF;AACA,gBAAY,IAAI,MAAM;AAEtB,UAAM,SAAS,MAAM,UAAU,MAAM;AACrC,aAAS,KAAK,GAAG,OAAO,KAAK;AAC7B,aAAS,OAAO;AAAA,EAClB;AAEA,SAAO;AACT;","names":[]}

package/dist/core/mcp/remoteMcpClient.d.ts

@@ -0,0 +1,36 @@
+import type { CallToolRequest, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { ToolSchema } from './IMCPServer';
+/** Networking for remote (url-based) MCP servers, kept separate so it can be mocked in tests. */
+export type RemoteMcpTransportType = 'streamable-http' | 'sse';
+export interface RemoteMcpConnection {
+    readonly transportType: RemoteMcpTransportType;
+    /** Session id for a stateful server, or null for a stateless one. */
+    readonly sessionId: string | null;
+    listTools(cursor?: string): Promise<{
+        tools: ToolSchema[];
+        nextCursor?: string | undefined;
+    }>;
+    callTool(params: CallToolRequest['params']): Promise<CallToolResult>;
+    close(): Promise<void>;
+}
+export declare function isSessionExpiredError(error: unknown): boolean;
+/**
+ * Connect to a remote MCP server, keeping the first transport that connects. `sessionId` is passed to
+ * every attempt so a stateful session resumes in place instead of opening a throwaway one.
+ *
+ * `knownTransportType` is a hint (from a prior connect / persisted state): it's tried first for a fast
+ * path, but on failure we still fall back to probing the remaining transports, so a stale or wrong
+ * hint (server switched transports, bad resume data) self-heals instead of failing every turn.
+ */
+export declare function connectRemoteMcp(params: {
+    url: string;
+    headers: Record<string, string>;
+    sessionId?: string | undefined;
+    knownTransportType?: RemoteMcpTransportType | undefined;
+    requestTimeoutMs: number;
+    connectTimeoutMs: number;
+    signal: AbortSignal;
+    onClose?: (() => void) | undefined;
+    onError?: ((error: Error) => void) | undefined;
+}): Promise<RemoteMcpConnection>;
+//# sourceMappingURL=remoteMcpClient.d.ts.map

package/dist/core/mcp/remoteMcpClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remoteMcpClient.d.ts","sourceRoot":"","sources":["../../../src/core/mcp/remoteMcpClient.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAI1F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,iGAAiG;AAEjG,MAAM,MAAM,sBAAsB,GAAG,iBAAiB,GAAG,KAAK,CAAC;AAE/D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,aAAa,EAAE,sBAAsB,CAAC;IAC/C,qEAAqE;IACrE,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,UAAU,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC,CAAC;IAC9F,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACrE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAoCD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAI7D;AA0DD;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,kBAAkB,CAAC,EAAE,sBAAsB,GAAG,SAAS,CAAC;IACxD,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IACnC,OAAO,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CAChD,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAwC/B"}