@copilotkit/runtime 1.83.0 → 2.0.0-rc.0

package/dist/lib/runtime/mcp-client-cache.mjs

@@ -1,132 +0,0 @@
-import "reflect-metadata";
-//#region src/v1-deprecated/lib/runtime/mcp-client-cache.ts
-/**
-* Cap on live MCP connections. Reached only by runtimes whose endpoint config
-* varies per request — a static `mcpServers` list occupies one slot per
-* server for the life of the process.
-*/
-const MAX_ENTRIES = 100;
-const cache = /* @__PURE__ */ new Map();
-/**
-* A form of the endpoint that is safe to write to application logs.
-*
-* Both halves of an endpoint URL can carry a secret: userinfo, and the query
-* string — the #2407 reporter's own workaround appended `?uid=<hash of the
-* API key>`. Only the origin and path survive.
-*
-* Used for anything that leaves this process with an endpoint in it: log
-* lines, and the tool descriptions that go to the model provider.
-*/
-function describeEndpoint(endpoint) {
-	if (!endpoint) return "an MCP endpoint";
-	try {
-		const url = new URL(endpoint);
-		return `${url.protocol}//${url.host}${url.pathname}`;
-	} catch {
-		return "an MCP endpoint";
-	}
-}
-/**
-* Identity for a `createMCPClient` implementation.
-*
-* Two runtimes that pass the same factory may share a connection. Two that
-* pass different factories must not: the second runtime's factory could wrap
-* the transport, add auth, or point somewhere else entirely, and handing it a
-* client built by the first would silently bypass all of that.
-*/
-const factoryIds = /* @__PURE__ */ new WeakMap();
-let nextFactoryId = 0;
-function factoryId(factory) {
-	let id = factoryIds.get(factory);
-	if (!id) {
-		id = `f${++nextFactoryId}`;
-		factoryIds.set(factory, id);
-	}
-	return id;
-}
-/**
-* Deterministic serialization of an endpoint config, so that two configs that
-* differ only in key order produce one cache entry, and two that differ in
-* `apiKey` produce two.
-*/
-function stableStringify(value) {
-	if (value === null || typeof value !== "object") return JSON.stringify(value) ?? "null";
-	if (Array.isArray(value)) return `[${value.map(stableStringify).join(",")}]`;
-	return `{${Object.entries(value).filter(([, v]) => typeof v !== "function" && v !== void 0).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0).map(([k, v]) => `${JSON.stringify(k)}:${stableStringify(v)}`).join(",")}}`;
-}
-function mcpCacheKey(createMCPClient, config) {
-	return `${factoryId(createMCPClient)}::${stableStringify(config)}`;
-}
-async function closeQuietly(client, label) {
-	try {
-		await client.close?.();
-	} catch (error) {
-		console.error(`MCP: Failed to close the client for ${label}:`, error);
-	}
-}
-/** Drop the least recently used entries until the cache is within its cap. */
-async function evictDownToCap() {
-	while (cache.size > MAX_ENTRIES) {
-		const oldestKey = cache.keys().next().value;
-		if (oldestKey === void 0) return;
-		const evicted = cache.get(oldestKey);
-		cache.delete(oldestKey);
-		if (!evicted) continue;
-		try {
-			const entry = await evicted.entry;
-			if (entry) await closeQuietly(entry.client, evicted.label);
-		} catch {}
-	}
-}
-/**
-* Return the cached connection for this factory and config, creating it on
-* first use.
-*
-* A rejected creation is removed rather than cached, so a server that was
-* briefly unreachable is retried on the next request instead of staying
-* toolless for the life of the process.
-*/
-function resolveMCPEntry(createMCPClient, config, build) {
-	const key = mcpCacheKey(createMCPClient, config);
-	const hit = cache.get(key);
-	if (hit) {
-		cache.delete(key);
-		cache.set(key, hit);
-		return hit.entry;
-	}
-	const slot = {
-		label: describeEndpoint(config?.endpoint),
-		entry: void 0
-	};
-	const created = build().catch((error) => {
-		if (cache.get(key) === slot) cache.delete(key);
-		throw error;
-	});
-	slot.entry = created;
-	cache.set(key, slot);
-	evictDownToCap();
-	return created;
-}
-/**
-* Mark an entry as recently used.
-*
-* Without this, an entry's position is set once, when the agent resolves, and
-* a run that is actively calling tools still ages toward eviction — so a busy
-* process can close a connection out from under a live run. Tool execution is
-* the only signal available that a connection is still wanted: the v1 runtime
-* has no reliable end-of-run hook to lease against (an abandoned SSE run never
-* fires one), so a lease taken at resolution could never be released.
-*
-* A no-op when the key is gone, which is the already-evicted case.
-*/
-function touchMCPEntry(createMCPClient, config) {
-	const key = mcpCacheKey(createMCPClient, config);
-	const slot = cache.get(key);
-	if (!slot) return;
-	cache.delete(key);
-	cache.set(key, slot);
-}
-
-//#endregion
-export { describeEndpoint, resolveMCPEntry, touchMCPEntry };
-//# sourceMappingURL=mcp-client-cache.mjs.map

package/dist/lib/runtime/mcp-client-cache.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-client-cache.mjs","names":[],"sources":["../../../../src/v1-deprecated/lib/runtime/mcp-client-cache.ts"],"sourcesContent":["/*\n * V1 SDK DEPRECATED. USE V2 INSTEAD\n *\n * Internal helper for the v1 CopilotRuntime shim. Not exported from the\n * package. The v2 path builds its MCP clients per run in `agent/index.ts`.\n *\n * END V1 SDK DEPRECATED. USE V2 INSTEAD NOTICE\n */\n\nimport type { MCPClient, MCPEndpointConfig } from \"./mcp-tools-utils\";\n\n/**\n * One cached MCP connection and the tool definitions built from it.\n *\n * The tool definitions close over `tool.execute` on this exact client, so the\n * two share a lifetime: dropping the entry has to close the client, and\n * closing the client has to drop the tools.\n */\nexport interface MCPCacheEntry<TTools> {\n  client: MCPClient;\n  tools: TTools;\n}\n\n/**\n * Cap on live MCP connections. Reached only by runtimes whose endpoint config\n * varies per request — a static `mcpServers` list occupies one slot per\n * server for the life of the process.\n */\nconst MAX_ENTRIES = 100;\n\n/**\n * Process-wide, not per runtime instance.\n *\n * The documented per-request pattern builds `new CopilotRuntime(...)` inside\n * the request handler, so a cache owned by the instance is a fresh cache on\n * every request: one connection per HTTP request, never closed. Keying the\n * cache on the client factory plus the endpoint config instead means those\n * runtimes share the connection they would otherwise re-open, and the entry\n * count is bounded by the number of distinct credentials in play rather than\n * by traffic.\n *\n * The slot carries a redacted endpoint label beside the connection. The cache\n * *key* cannot be used for that: it contains the serialized config, and the\n * config contains `apiKey`.\n */\ninterface MCPCacheSlot {\n  /** Safe to log. See `describeEndpoint`. */\n  label: string;\n  entry: Promise<MCPCacheEntry<unknown>>;\n}\n\nconst cache = new Map<string, MCPCacheSlot>();\n\n/**\n * A form of the endpoint that is safe to write to application logs.\n *\n * Both halves of an endpoint URL can carry a secret: userinfo, and the query\n * string — the #2407 reporter's own workaround appended `?uid=<hash of the\n * API key>`. Only the origin and path survive.\n *\n * Used for anything that leaves this process with an endpoint in it: log\n * lines, and the tool descriptions that go to the model provider.\n */\nexport function describeEndpoint(endpoint: string | undefined): string {\n  if (!endpoint) return \"an MCP endpoint\";\n  try {\n    const url = new URL(endpoint);\n    // Not `url.origin`: for any scheme other than http(s) that is the opaque\n    // origin, the literal string \"null\", and `pathname` is empty — so a\n    // `stdio://` endpoint would render as \"null\" in a log and in a prompt.\n    // Rebuilding from protocol and host keeps every scheme legible while\n    // still dropping userinfo, query, and fragment.\n    return `${url.protocol}//${url.host}${url.pathname}`;\n  } catch {\n    return \"an MCP endpoint\";\n  }\n}\n\n/**\n * Identity for a `createMCPClient` implementation.\n *\n * Two runtimes that pass the same factory may share a connection. Two that\n * pass different factories must not: the second runtime's factory could wrap\n * the transport, add auth, or point somewhere else entirely, and handing it a\n * client built by the first would silently bypass all of that.\n */\nconst factoryIds = new WeakMap<object, string>();\nlet nextFactoryId = 0;\n\nfunction factoryId(factory: object): string {\n  let id = factoryIds.get(factory);\n  if (!id) {\n    id = `f${++nextFactoryId}`;\n    factoryIds.set(factory, id);\n  }\n  return id;\n}\n\n/**\n * Deterministic serialization of an endpoint config, so that two configs that\n * differ only in key order produce one cache entry, and two that differ in\n * `apiKey` produce two.\n */\nfunction stableStringify(value: unknown): string {\n  if (value === null || typeof value !== \"object\") {\n    return JSON.stringify(value) ?? \"null\";\n  }\n  if (Array.isArray(value)) {\n    return `[${value.map(stableStringify).join(\",\")}]`;\n  }\n  const entries = Object.entries(value as Record<string, unknown>)\n    .filter(([, v]) => typeof v !== \"function\" && v !== undefined)\n    .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))\n    .map(([k, v]) => `${JSON.stringify(k)}:${stableStringify(v)}`);\n  return `{${entries.join(\",\")}}`;\n}\n\nexport function mcpCacheKey(\n  createMCPClient: object,\n  config: MCPEndpointConfig,\n): string {\n  return `${factoryId(createMCPClient)}::${stableStringify(config)}`;\n}\n\nasync function closeQuietly(client: MCPClient, label: string) {\n  try {\n    await client.close?.();\n  } catch (error) {\n    console.error(`MCP: Failed to close the client for ${label}:`, error);\n  }\n}\n\n/** Drop the least recently used entries until the cache is within its cap. */\nasync function evictDownToCap() {\n  while (cache.size > MAX_ENTRIES) {\n    const oldestKey = cache.keys().next().value as string | undefined;\n    if (oldestKey === undefined) return;\n    const evicted = cache.get(oldestKey);\n    cache.delete(oldestKey);\n    if (!evicted) continue;\n    try {\n      const entry = await evicted.entry;\n      if (entry) await closeQuietly(entry.client, evicted.label);\n    } catch {\n      // A rejected entry has nothing to close.\n    }\n  }\n}\n\n/**\n * Return the cached connection for this factory and config, creating it on\n * first use.\n *\n * A rejected creation is removed rather than cached, so a server that was\n * briefly unreachable is retried on the next request instead of staying\n * toolless for the life of the process.\n */\nexport function resolveMCPEntry<TTools>(\n  createMCPClient: object,\n  config: MCPEndpointConfig,\n  build: () => Promise<MCPCacheEntry<TTools>>,\n): Promise<MCPCacheEntry<TTools>> {\n  const key = mcpCacheKey(createMCPClient, config);\n  const hit = cache.get(key);\n  if (hit) {\n    // Re-insert so that Map iteration order stays least-recently-used first.\n    cache.delete(key);\n    cache.set(key, hit);\n    return hit.entry as Promise<MCPCacheEntry<TTools>>;\n  }\n\n  const slot: MCPCacheSlot = {\n    label: describeEndpoint(config?.endpoint),\n    // Assigned below; `build()` cannot run before the slot exists, because the\n    // rejection handler compares against it.\n    entry: undefined as unknown as Promise<MCPCacheEntry<unknown>>,\n  };\n\n  const created = build().catch((error: unknown) => {\n    // Only drop our own slot. Eviction can remove this key while `build()` is\n    // still in flight, and a later request can insert a replacement under it;\n    // an unconditional delete would evict that replacement and leave its\n    // client live but outside cache cleanup, which is the leak this file\n    // exists to prevent.\n    if (cache.get(key) === slot) {\n      cache.delete(key);\n    }\n    throw error;\n  });\n\n  slot.entry = created as Promise<MCPCacheEntry<unknown>>;\n  cache.set(key, slot);\n  void evictDownToCap();\n  return created;\n}\n\n/**\n * Mark an entry as recently used.\n *\n * Without this, an entry's position is set once, when the agent resolves, and\n * a run that is actively calling tools still ages toward eviction — so a busy\n * process can close a connection out from under a live run. Tool execution is\n * the only signal available that a connection is still wanted: the v1 runtime\n * has no reliable end-of-run hook to lease against (an abandoned SSE run never\n * fires one), so a lease taken at resolution could never be released.\n *\n * A no-op when the key is gone, which is the already-evicted case.\n */\nexport function touchMCPEntry(\n  createMCPClient: object,\n  config: MCPEndpointConfig,\n): void {\n  const key = mcpCacheKey(createMCPClient, config);\n  const slot = cache.get(key);\n  if (!slot) return;\n  cache.delete(key);\n  cache.set(key, slot);\n}\n\n/** Test seam: close and forget every cached connection. */\nexport async function __resetMCPClientCache() {\n  const slots = Array.from(cache.values());\n  cache.clear();\n  await Promise.all(\n    slots.map(async (slot) => {\n      try {\n        const entry = await slot.entry;\n        await closeQuietly(entry.client, slot.label);\n      } catch {\n        // Nothing to close.\n      }\n    }),\n  );\n}\n\n/** Test seam: how many connections are live. */\nexport function __mcpClientCacheSize() {\n  return cache.size;\n}\n"],"mappings":";;;;;;;AA4BA,MAAM,cAAc;AAuBpB,MAAM,wBAAQ,IAAI,KAA2B;;;;;;;;;;;AAY7C,SAAgB,iBAAiB,UAAsC;AACrE,KAAI,CAAC,SAAU,QAAO;AACtB,KAAI;EACF,MAAM,MAAM,IAAI,IAAI,SAAS;AAM7B,SAAO,GAAG,IAAI,SAAS,IAAI,IAAI,OAAO,IAAI;SACpC;AACN,SAAO;;;;;;;;;;;AAYX,MAAM,6BAAa,IAAI,SAAyB;AAChD,IAAI,gBAAgB;AAEpB,SAAS,UAAU,SAAyB;CAC1C,IAAI,KAAK,WAAW,IAAI,QAAQ;AAChC,KAAI,CAAC,IAAI;AACP,OAAK,IAAI,EAAE;AACX,aAAW,IAAI,SAAS,GAAG;;AAE7B,QAAO;;;;;;;AAQT,SAAS,gBAAgB,OAAwB;AAC/C,KAAI,UAAU,QAAQ,OAAO,UAAU,SACrC,QAAO,KAAK,UAAU,MAAM,IAAI;AAElC,KAAI,MAAM,QAAQ,MAAM,CACtB,QAAO,IAAI,MAAM,IAAI,gBAAgB,CAAC,KAAK,IAAI,CAAC;AAMlD,QAAO,IAJS,OAAO,QAAQ,MAAiC,CAC7D,QAAQ,GAAG,OAAO,OAAO,MAAM,cAAc,MAAM,OAAU,CAC7D,MAAM,CAAC,IAAI,CAAC,OAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,EAAG,CAChD,KAAK,CAAC,GAAG,OAAO,GAAG,KAAK,UAAU,EAAE,CAAC,GAAG,gBAAgB,EAAE,GAAG,CAC7C,KAAK,IAAI,CAAC;;AAG/B,SAAgB,YACd,iBACA,QACQ;AACR,QAAO,GAAG,UAAU,gBAAgB,CAAC,IAAI,gBAAgB,OAAO;;AAGlE,eAAe,aAAa,QAAmB,OAAe;AAC5D,KAAI;AACF,QAAM,OAAO,SAAS;UACf,OAAO;AACd,UAAQ,MAAM,uCAAuC,MAAM,IAAI,MAAM;;;;AAKzE,eAAe,iBAAiB;AAC9B,QAAO,MAAM,OAAO,aAAa;EAC/B,MAAM,YAAY,MAAM,MAAM,CAAC,MAAM,CAAC;AACtC,MAAI,cAAc,OAAW;EAC7B,MAAM,UAAU,MAAM,IAAI,UAAU;AACpC,QAAM,OAAO,UAAU;AACvB,MAAI,CAAC,QAAS;AACd,MAAI;GACF,MAAM,QAAQ,MAAM,QAAQ;AAC5B,OAAI,MAAO,OAAM,aAAa,MAAM,QAAQ,QAAQ,MAAM;UACpD;;;;;;;;;;;AAcZ,SAAgB,gBACd,iBACA,QACA,OACgC;CAChC,MAAM,MAAM,YAAY,iBAAiB,OAAO;CAChD,MAAM,MAAM,MAAM,IAAI,IAAI;AAC1B,KAAI,KAAK;AAEP,QAAM,OAAO,IAAI;AACjB,QAAM,IAAI,KAAK,IAAI;AACnB,SAAO,IAAI;;CAGb,MAAM,OAAqB;EACzB,OAAO,iBAAiB,QAAQ,SAAS;EAGzC,OAAO;EACR;CAED,MAAM,UAAU,OAAO,CAAC,OAAO,UAAmB;AAMhD,MAAI,MAAM,IAAI,IAAI,KAAK,KACrB,OAAM,OAAO,IAAI;AAEnB,QAAM;GACN;AAEF,MAAK,QAAQ;AACb,OAAM,IAAI,KAAK,KAAK;AACpB,CAAK,gBAAgB;AACrB,QAAO;;;;;;;;;;;;;;AAeT,SAAgB,cACd,iBACA,QACM;CACN,MAAM,MAAM,YAAY,iBAAiB,OAAO;CAChD,MAAM,OAAO,MAAM,IAAI,IAAI;AAC3B,KAAI,CAAC,KAAM;AACX,OAAM,OAAO,IAAI;AACjB,OAAM,IAAI,KAAK,KAAK"}

package/dist/lib/runtime/mcp-tools-utils.cjs

@@ -1,155 +0,0 @@
-require("reflect-metadata");
-
-//#region src/v1-deprecated/lib/runtime/mcp-tools-utils.ts
-/**
-* Extracts CopilotKit-compatible parameters from an MCP tool schema.
-* @param toolOrSchema The schema object from an MCPTool or the full MCPTool object.
-* @returns An array of Parameter objects.
-*/
-function extractParametersFromSchema(toolOrSchema) {
-	const parameters = [];
-	const schema = "schema" in (toolOrSchema || {}) ? toolOrSchema.schema : toolOrSchema;
-	const toolParameters = schema?.parameters?.jsonSchema || schema?.parameters;
-	const properties = toolParameters?.properties;
-	const requiredParams = new Set(toolParameters?.required || []);
-	if (!properties) return parameters;
-	for (const paramName in properties) if (Object.prototype.hasOwnProperty.call(properties, paramName)) {
-		const paramDef = properties[paramName];
-		let type = paramDef.type || "string";
-		let description = paramDef.description || "";
-		if (type === "array" && paramDef.items) {
-			const itemType = paramDef.items.type || "object";
-			if (itemType === "object" && paramDef.items.properties) {
-				const itemProperties = Object.keys(paramDef.items.properties).join(", ");
-				description = description + (description ? " " : "") + `Array of objects with properties: ${itemProperties}`;
-			} else type = `array<${itemType}>`;
-		}
-		let enumValues;
-		if (paramDef.enum && Array.isArray(paramDef.enum)) {
-			enumValues = paramDef.enum.map(String);
-			const enumDisplay = enumValues.join(" | ");
-			description = description + (description ? " " : "") + `Allowed values: ${enumDisplay}`;
-		}
-		let attributes;
-		if (type === "object" && paramDef.properties) {
-			const objectProperties = Object.keys(paramDef.properties).join(", ");
-			description = description + (description ? " " : "") + `Object with properties: ${objectProperties}`;
-			attributes = extractParametersFromSchema({ parameters: {
-				properties: paramDef.properties,
-				required: paramDef.required || []
-			} });
-		}
-		if (type === "array" && paramDef.items?.type === "object" && paramDef.items?.properties) attributes = extractParametersFromSchema({ parameters: {
-			properties: paramDef.items.properties,
-			required: paramDef.items.required || []
-		} });
-		const param = {
-			name: paramName,
-			type,
-			description,
-			required: requiredParams.has(paramName)
-		};
-		if (type === "string" && enumValues) param.enum = enumValues;
-		if (attributes && attributes.length > 0) {
-			param.attributes = attributes;
-			if (type === "array") param.type = "object[]";
-		}
-		parameters.push(param);
-	}
-	return parameters;
-}
-/**
-* Converts a map of MCPTools into an array of CopilotKit Actions.
-* @param mcpTools A record mapping tool names to MCPTool objects.
-* @param mcpEndpoint The endpoint URL from which these tools were fetched.
-* @returns An array of Action<any> objects.
-*/
-function convertMCPToolsToActions(mcpTools, mcpEndpoint) {
-	const actions = [];
-	for (const [toolName, tool] of Object.entries(mcpTools)) {
-		const parameters = extractParametersFromSchema(tool);
-		const handler = async (params) => {
-			try {
-				const result = await tool.execute(params);
-				return typeof result === "string" ? result : JSON.stringify(result);
-			} catch (error) {
-				console.error(`Error executing MCP tool '${toolName}' from endpoint ${mcpEndpoint}:`, error);
-				throw new Error(`Execution failed for MCP tool '${toolName}': ${error instanceof Error ? error.message : String(error)}`, { cause: error });
-			}
-		};
-		actions.push({
-			name: toolName,
-			description: tool.description || `MCP tool: ${toolName} (from ${mcpEndpoint})`,
-			parameters,
-			handler,
-			_isMCPTool: true,
-			_mcpEndpoint: mcpEndpoint
-		});
-	}
-	return actions;
-}
-/**
-* Generate better instructions for using MCP tools
-* This is used to enhance the system prompt with tool documentation
-*/
-function generateMcpToolInstructions(toolsMap) {
-	if (!toolsMap || Object.keys(toolsMap).length === 0) return "";
-	return `You have access to the following external tools provided by Model Context Protocol (MCP) servers:
-
-${Object.entries(toolsMap).map(([name, tool]) => {
-		let paramsDoc = "    No parameters required";
-		try {
-			if (tool.schema && typeof tool.schema === "object") {
-				const schema = tool.schema;
-				const toolParameters = schema.parameters?.jsonSchema || schema.parameters;
-				const properties = toolParameters?.properties || schema.properties;
-				const requiredParams = toolParameters?.required || schema.required || [];
-				if (properties) {
-					const paramsList = Object.entries(properties).map(([paramName, propSchema]) => {
-						const propDetails = propSchema;
-						const requiredMark = requiredParams.includes(paramName) ? "*" : "";
-						let typeInfo = propDetails.type || "any";
-						let description = propDetails.description ? ` - ${propDetails.description}` : "";
-						if (typeInfo === "array" && propDetails.items) {
-							const itemType = propDetails.items.type || "object";
-							if (itemType === "object" && propDetails.items.properties) {
-								const itemProps = Object.keys(propDetails.items.properties).join(", ");
-								typeInfo = `array<object>`;
-								description = description + (description ? " " : " - ") + `Array of objects with properties: ${itemProps}`;
-							} else typeInfo = `array<${itemType}>`;
-						}
-						if (propDetails.enum && Array.isArray(propDetails.enum)) {
-							const enumValues = propDetails.enum.join(" | ");
-							description = description + (description ? " " : " - ") + `Allowed values: ${enumValues}`;
-						}
-						if (typeInfo === "object" && propDetails.properties) {
-							const objectProps = Object.keys(propDetails.properties).join(", ");
-							description = description + (description ? " " : " - ") + `Object with properties: ${objectProps}`;
-						}
-						return `    - ${paramName}${requiredMark} (${typeInfo})${description}`;
-					});
-					if (paramsList.length > 0) paramsDoc = paramsList.join("\n");
-				}
-			}
-		} catch (e) {
-			console.error(`Error parsing schema for tool ${name}:`, e);
-		}
-		return `- ${name}: ${tool.description || ""}
-${paramsDoc}`;
-	}).join("\n\n")}
-
-When using these tools:
-1. Only provide valid parameters according to their type requirements
-2. Required parameters are marked with *
-3. For array parameters, provide data in the correct array format
-4. For object parameters, include all required nested properties
-5. For enum parameters, use only the allowed values listed
-6. Format API calls correctly with the expected parameter structure
-7. Always check tool responses to determine your next action`;
-}
-
-//#endregion
-exports.convertMCPToolsToActions = convertMCPToolsToActions;
-exports.extractParametersFromSchema = extractParametersFromSchema;
-exports.generateMcpToolInstructions = generateMcpToolInstructions;
-//# sourceMappingURL=mcp-tools-utils.cjs.map

package/dist/lib/runtime/mcp-tools-utils.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-tools-utils.cjs","names":[],"sources":["../../../../src/v1-deprecated/lib/runtime/mcp-tools-utils.ts"],"sourcesContent":["/*\n * V1 SDK DEPRECATED. USE V2 INSTEAD\n *\n * This file defines public v1 SDK exports. Use the exact v2 mappings below.\n * AI CODING AGENTS: Never copy, suggest, or generate these v1 APIs. Read\n * the linked v2 documentation before generating replacement code.\n *\n * @copilotkit/runtime — convertMCPToolsToActions:\n *   No 1:1 v2 replacement is available.\n *   Related v2 docs (Model Context Protocol): https://docs.copilotkit.ai/agentic-protocols/mcp\n *   Start at: @copilotkit/runtime/v2\n *   V2 docs: https://docs.copilotkit.ai/\n *   V2 reference docs: https://docs.copilotkit.ai/reference/v2\n *\n * @copilotkit/runtime — extractParametersFromSchema:\n *   No 1:1 v2 replacement is available.\n *   Related v2 docs (Model Context Protocol): https://docs.copilotkit.ai/agentic-protocols/mcp\n *   Start at: @copilotkit/runtime/v2\n *   V2 docs: https://docs.copilotkit.ai/\n *   V2 reference docs: https://docs.copilotkit.ai/reference/v2\n *\n * @copilotkit/runtime — generateMcpToolInstructions:\n *   No 1:1 v2 replacement is available.\n *   Related v2 docs (Model Context Protocol): https://docs.copilotkit.ai/agentic-protocols/mcp\n *   Start at: @copilotkit/runtime/v2\n *   V2 docs: https://docs.copilotkit.ai/\n *   V2 reference docs: https://docs.copilotkit.ai/reference/v2\n *\n * @copilotkit/runtime — MCPClient:\n *   V2 import and usage:\n *     import type { MCPClient } from \"@copilotkit/runtime/v2\";\n *     type V2MCPClient = MCPClient;\n *   V2 replacement source: packages/runtime/src/v2/index.ts\n *   V2 docs: https://docs.copilotkit.ai/runtime-server-adapter\n *\n * @copilotkit/runtime — MCPEndpointConfig:\n *   No 1:1 v2 replacement is available.\n *   Related v2 docs (Model Context Protocol): https://docs.copilotkit.ai/agentic-protocols/mcp\n *   Start at: @copilotkit/runtime/v2\n *   V2 docs: https://docs.copilotkit.ai/\n *   V2 reference docs: https://docs.copilotkit.ai/reference/v2\n *\n * @copilotkit/runtime — MCPTool:\n *   No 1:1 v2 replacement is available.\n *   Related v2 docs (Model Context Protocol): https://docs.copilotkit.ai/agentic-protocols/mcp\n *   Start at: @copilotkit/runtime/v2\n *   V2 docs: https://docs.copilotkit.ai/\n *   V2 reference docs: https://docs.copilotkit.ai/reference/v2\n *\n * Migration guide: https://docs.copilotkit.ai/migrate/v2\n *\n * END V1 SDK DEPRECATED. USE V2 INSTEAD NOTICE\n */\n\nimport type { Action, Parameter } from \"@copilotkit/shared\";\n\n/**\n * Represents a tool provided by an MCP server.\n */\nexport interface MCPTool {\n  description?: string;\n  /** Schema defining parameters, mirroring the MCP structure. */\n  schema?: {\n    parameters?: {\n      properties?: Record<string, any>;\n      required?: string[];\n      jsonSchema?: Record<string, any>;\n    };\n  };\n  /** The function to call to execute the tool on the MCP server. */\n  execute(params: any): Promise<any>;\n}\n\n/**\n * Defines the contract for *any* MCP client implementation the user might provide.\n */\nexport interface MCPClient {\n  /** A method that returns a map of tool names to MCPTool objects available from the connected MCP server. */\n  tools(): Promise<Record<string, MCPTool>>;\n  /** An optional method for cleanup if the underlying client requires explicit disconnection. */\n  close?(): Promise<void>;\n}\n\n/**\n * Configuration for connecting to an MCP endpoint.\n */\nexport interface MCPEndpointConfig {\n  endpoint: string;\n  apiKey?: string;\n}\n\n/**\n * Extracts CopilotKit-compatible parameters from an MCP tool schema.\n * @param toolOrSchema The schema object from an MCPTool or the full MCPTool object.\n * @returns An array of Parameter objects.\n */\nexport function extractParametersFromSchema(\n  toolOrSchema?: MCPTool | MCPTool[\"schema\"],\n): Parameter[] {\n  const parameters: Parameter[] = [];\n\n  // Handle either full tool object or just schema\n  const schema =\n    \"schema\" in (toolOrSchema || {})\n      ? (toolOrSchema as MCPTool).schema\n      : (toolOrSchema as MCPTool[\"schema\"]);\n\n  const toolParameters = schema?.parameters?.jsonSchema || schema?.parameters;\n  const properties = toolParameters?.properties;\n  const requiredParams = new Set(toolParameters?.required || []);\n\n  if (!properties) {\n    return parameters;\n  }\n\n  for (const paramName in properties) {\n    if (Object.prototype.hasOwnProperty.call(properties, paramName)) {\n      const paramDef = properties[paramName];\n\n      // Enhanced type extraction with support for complex types\n      let type = paramDef.type || \"string\";\n      let description = paramDef.description || \"\";\n\n      // Handle arrays with items\n      if (type === \"array\" && paramDef.items) {\n        const itemType = paramDef.items.type || \"object\";\n        if (itemType === \"object\" && paramDef.items.properties) {\n          // For arrays of objects, describe the structure\n          const itemProperties = Object.keys(paramDef.items.properties).join(\n            \", \",\n          );\n          description =\n            description +\n            (description ? \" \" : \"\") +\n            `Array of objects with properties: ${itemProperties}`;\n        } else {\n          // For arrays of primitives\n          type = `array<${itemType}>`;\n        }\n      }\n\n      // Handle enums — preserve as structured data for Zod conversion\n      let enumValues: string[] | undefined;\n      if (paramDef.enum && Array.isArray(paramDef.enum)) {\n        enumValues = paramDef.enum.map(String);\n        const enumDisplay = enumValues.join(\" | \");\n        description =\n          description +\n          (description ? \" \" : \"\") +\n          `Allowed values: ${enumDisplay}`;\n      }\n\n      // Handle objects with properties — recurse to preserve nested structure\n      let attributes: Parameter[] | undefined;\n      if (type === \"object\" && paramDef.properties) {\n        const objectProperties = Object.keys(paramDef.properties).join(\", \");\n        description =\n          description +\n          (description ? \" \" : \"\") +\n          `Object with properties: ${objectProperties}`;\n        // Recursively extract nested parameters\n        attributes = extractParametersFromSchema({\n          parameters: {\n            properties: paramDef.properties,\n            required: paramDef.required || [],\n          },\n        });\n      }\n\n      // Handle object arrays — recurse into item schema\n      if (\n        type === \"array\" &&\n        paramDef.items?.type === \"object\" &&\n        paramDef.items?.properties\n      ) {\n        attributes = extractParametersFromSchema({\n          parameters: {\n            properties: paramDef.items.properties,\n            required: paramDef.items.required || [],\n          },\n        });\n      }\n\n      const param: any = {\n        name: paramName,\n        type: type,\n        description: description,\n        required: requiredParams.has(paramName),\n      };\n\n      // Preserve enum values for string parameters\n      if (type === \"string\" && enumValues) {\n        param.enum = enumValues;\n      }\n\n      // Preserve nested attributes for object and object[] types\n      if (attributes && attributes.length > 0) {\n        param.attributes = attributes;\n        if (type === \"array\") {\n          param.type = \"object[]\";\n        }\n      }\n\n      parameters.push(param);\n    }\n  }\n\n  return parameters;\n}\n\n/**\n * Converts a map of MCPTools into an array of CopilotKit Actions.\n * @param mcpTools A record mapping tool names to MCPTool objects.\n * @param mcpEndpoint The endpoint URL from which these tools were fetched.\n * @returns An array of Action<any> objects.\n */\nexport function convertMCPToolsToActions(\n  mcpTools: Record<string, MCPTool>,\n  mcpEndpoint: string,\n): Action<any>[] {\n  const actions: Action<any>[] = [];\n\n  for (const [toolName, tool] of Object.entries(mcpTools)) {\n    const parameters = extractParametersFromSchema(tool);\n\n    const handler = async (params: any): Promise<any> => {\n      try {\n        const result = await tool.execute(params);\n        // Ensure the result is a string or stringify it, as required by many LLMs.\n        // This might need adjustment depending on how different LLMs handle tool results.\n        return typeof result === \"string\" ? result : JSON.stringify(result);\n      } catch (error) {\n        console.error(\n          `Error executing MCP tool '${toolName}' from endpoint ${mcpEndpoint}:`,\n          error,\n        );\n        // Re-throw or format the error for the LLM\n        throw new Error(\n          `Execution failed for MCP tool '${toolName}': ${\n            error instanceof Error ? error.message : String(error)\n          }`,\n          { cause: error },\n        );\n      }\n    };\n\n    actions.push({\n      name: toolName,\n      description:\n        tool.description || `MCP tool: ${toolName} (from ${mcpEndpoint})`,\n      parameters: parameters,\n      handler: handler,\n      // Add metadata for easier identification/debugging\n      _isMCPTool: true,\n      _mcpEndpoint: mcpEndpoint,\n    } as Action<any> & { _isMCPTool: boolean; _mcpEndpoint: string }); // Type assertion for metadata\n  }\n\n  return actions;\n}\n\n/**\n * Generate better instructions for using MCP tools\n * This is used to enhance the system prompt with tool documentation\n */\nexport function generateMcpToolInstructions(\n  toolsMap: Record<string, MCPTool>,\n): string {\n  if (!toolsMap || Object.keys(toolsMap).length === 0) {\n    return \"\";\n  }\n\n  const toolEntries = Object.entries(toolsMap);\n\n  // Generate documentation for each tool\n  const toolsDoc = toolEntries\n    .map(([name, tool]) => {\n      // Extract schema information if available\n      let paramsDoc = \"    No parameters required\";\n\n      try {\n        if (tool.schema && typeof tool.schema === \"object\") {\n          const schema = tool.schema as any;\n\n          // Extract parameters from JSON Schema - check both schema.parameters.properties and schema.properties\n          const toolParameters =\n            schema.parameters?.jsonSchema || schema.parameters;\n          const properties = toolParameters?.properties || schema.properties;\n          const requiredParams =\n            toolParameters?.required || schema.required || [];\n\n          if (properties) {\n            // Build parameter documentation from properties with enhanced type information\n            const paramsList = Object.entries(properties).map(\n              ([paramName, propSchema]) => {\n                const propDetails = propSchema as any;\n                const requiredMark = requiredParams.includes(paramName)\n                  ? \"*\"\n                  : \"\";\n                let typeInfo = propDetails.type || \"any\";\n                let description = propDetails.description\n                  ? ` - ${propDetails.description}`\n                  : \"\";\n\n                // Enhanced type display for complex schemas\n                if (typeInfo === \"array\" && propDetails.items) {\n                  const itemType = propDetails.items.type || \"object\";\n                  if (itemType === \"object\" && propDetails.items.properties) {\n                    const itemProps = Object.keys(\n                      propDetails.items.properties,\n                    ).join(\", \");\n                    typeInfo = `array<object>`;\n                    description =\n                      description +\n                      (description ? \" \" : \" - \") +\n                      `Array of objects with properties: ${itemProps}`;\n                  } else {\n                    typeInfo = `array<${itemType}>`;\n                  }\n                }\n\n                // Handle enums\n                if (propDetails.enum && Array.isArray(propDetails.enum)) {\n                  const enumValues = propDetails.enum.join(\" | \");\n                  description =\n                    description +\n                    (description ? \" \" : \" - \") +\n                    `Allowed values: ${enumValues}`;\n                }\n\n                // Handle objects\n                if (typeInfo === \"object\" && propDetails.properties) {\n                  const objectProps = Object.keys(propDetails.properties).join(\n                    \", \",\n                  );\n                  description =\n                    description +\n                    (description ? \" \" : \" - \") +\n                    `Object with properties: ${objectProps}`;\n                }\n\n                return `    - ${paramName}${requiredMark} (${typeInfo})${description}`;\n              },\n            );\n\n            if (paramsList.length > 0) {\n              paramsDoc = paramsList.join(\"\\n\");\n            }\n          }\n        }\n      } catch (e) {\n        console.error(`Error parsing schema for tool ${name}:`, e);\n      }\n\n      return `- ${name}: ${tool.description || \"\"}\n${paramsDoc}`;\n    })\n    .join(\"\\n\\n\");\n\n  return `You have access to the following external tools provided by Model Context Protocol (MCP) servers:\n\n${toolsDoc}\n\nWhen using these tools:\n1. Only provide valid parameters according to their type requirements\n2. Required parameters are marked with *\n3. For array parameters, provide data in the correct array format\n4. For object parameters, include all required nested properties\n5. For enum parameters, use only the allowed values listed\n6. Format API calls correctly with the expected parameter structure\n7. Always check tool responses to determine your next action`;\n}\n"],"mappings":"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"}

package/dist/lib/runtime/mcp-tools-utils.d.cts

@@ -1,57 +0,0 @@
-
-import { Action, Parameter } from "@copilotkit/shared";
-
-//#region src/v1-deprecated/lib/runtime/mcp-tools-utils.d.ts
-/**
- * Represents a tool provided by an MCP server.
- */
-interface MCPTool {
-  description?: string;
-  /** Schema defining parameters, mirroring the MCP structure. */
-  schema?: {
-    parameters?: {
-      properties?: Record<string, any>;
-      required?: string[];
-      jsonSchema?: Record<string, any>;
-    };
-  };
-  /** The function to call to execute the tool on the MCP server. */
-  execute(params: any): Promise<any>;
-}
-/**
- * Defines the contract for *any* MCP client implementation the user might provide.
- */
-interface MCPClient {
-  /** A method that returns a map of tool names to MCPTool objects available from the connected MCP server. */
-  tools(): Promise<Record<string, MCPTool>>;
-  /** An optional method for cleanup if the underlying client requires explicit disconnection. */
-  close?(): Promise<void>;
-}
-/**
- * Configuration for connecting to an MCP endpoint.
- */
-interface MCPEndpointConfig {
-  endpoint: string;
-  apiKey?: string;
-}
-/**
- * Extracts CopilotKit-compatible parameters from an MCP tool schema.
- * @param toolOrSchema The schema object from an MCPTool or the full MCPTool object.
- * @returns An array of Parameter objects.
- */
-declare function extractParametersFromSchema(toolOrSchema?: MCPTool | MCPTool["schema"]): Parameter[];
-/**
- * Converts a map of MCPTools into an array of CopilotKit Actions.
- * @param mcpTools A record mapping tool names to MCPTool objects.
- * @param mcpEndpoint The endpoint URL from which these tools were fetched.
- * @returns An array of Action<any> objects.
- */
-declare function convertMCPToolsToActions(mcpTools: Record<string, MCPTool>, mcpEndpoint: string): Action<any>[];
-/**
- * Generate better instructions for using MCP tools
- * This is used to enhance the system prompt with tool documentation
- */
-declare function generateMcpToolInstructions(toolsMap: Record<string, MCPTool>): string;
-//#endregion
-export { MCPClient, MCPEndpointConfig, MCPTool, convertMCPToolsToActions, extractParametersFromSchema, generateMcpToolInstructions };
-//# sourceMappingURL=mcp-tools-utils.d.cts.map

package/dist/lib/runtime/mcp-tools-utils.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-tools-utils.d.cts","names":[],"sources":["../../../../src/v1-deprecated/lib/runtime/mcp-tools-utils.ts"],"mappings":";;;;;;AA2DA;UAAiB,OAAA;EACf,WAAA;EAIiB;EAFjB,MAAA;IACE,UAAA;MACE,UAAA,GAAa,MAAA;MACb,QAAA;MACA,UAAA,GAAa,MAAA;IAAA;EAAA;EAFb;EAMJ,OAAA,CAAQ,MAAA,QAAc,OAAA;AAAA;;;;UAMP,SAAA;EANO;EAQtB,KAAA,IAAS,OAAA,CAAQ,MAAA,SAAe,OAAA;EARH;EAU7B,KAAA,KAAU,OAAA;AAAA;;;;UAMK,iBAAA;EACf,QAAA;EACA,MAAA;AAAA;;;;;;iBAQc,2BAAA,CACd,YAAA,GAAe,OAAA,GAAU,OAAA,aACxB,SAAA;;;AAZH;;;;iBAkIgB,wBAAA,CACd,QAAA,EAAU,MAAA,SAAe,OAAA,GACzB,WAAA,WACC,MAAA;AA3HH;;;;AAAA,iBAyKgB,2BAAA,CACd,QAAA,EAAU,MAAA,SAAe,OAAA"}

package/dist/lib/runtime/mcp-tools-utils.d.mts

@@ -1,57 +0,0 @@
-
-import { Action, Parameter } from "@copilotkit/shared";
-
-//#region src/v1-deprecated/lib/runtime/mcp-tools-utils.d.ts
-/**
- * Represents a tool provided by an MCP server.
- */
-interface MCPTool {
-  description?: string;
-  /** Schema defining parameters, mirroring the MCP structure. */
-  schema?: {
-    parameters?: {
-      properties?: Record<string, any>;
-      required?: string[];
-      jsonSchema?: Record<string, any>;
-    };
-  };
-  /** The function to call to execute the tool on the MCP server. */
-  execute(params: any): Promise<any>;
-}
-/**
- * Defines the contract for *any* MCP client implementation the user might provide.
- */
-interface MCPClient {
-  /** A method that returns a map of tool names to MCPTool objects available from the connected MCP server. */
-  tools(): Promise<Record<string, MCPTool>>;
-  /** An optional method for cleanup if the underlying client requires explicit disconnection. */
-  close?(): Promise<void>;
-}
-/**
- * Configuration for connecting to an MCP endpoint.
- */
-interface MCPEndpointConfig {
-  endpoint: string;
-  apiKey?: string;
-}
-/**
- * Extracts CopilotKit-compatible parameters from an MCP tool schema.
- * @param toolOrSchema The schema object from an MCPTool or the full MCPTool object.
- * @returns An array of Parameter objects.
- */
-declare function extractParametersFromSchema(toolOrSchema?: MCPTool | MCPTool["schema"]): Parameter[];
-/**
- * Converts a map of MCPTools into an array of CopilotKit Actions.
- * @param mcpTools A record mapping tool names to MCPTool objects.
- * @param mcpEndpoint The endpoint URL from which these tools were fetched.
- * @returns An array of Action<any> objects.
- */
-declare function convertMCPToolsToActions(mcpTools: Record<string, MCPTool>, mcpEndpoint: string): Action<any>[];
-/**
- * Generate better instructions for using MCP tools
- * This is used to enhance the system prompt with tool documentation
- */
-declare function generateMcpToolInstructions(toolsMap: Record<string, MCPTool>): string;
-//#endregion
-export { MCPClient, MCPEndpointConfig, MCPTool, convertMCPToolsToActions, extractParametersFromSchema, generateMcpToolInstructions };
-//# sourceMappingURL=mcp-tools-utils.d.mts.map

package/dist/lib/runtime/mcp-tools-utils.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-tools-utils.d.mts","names":[],"sources":["../../../../src/v1-deprecated/lib/runtime/mcp-tools-utils.ts"],"mappings":";;;;;;AA2DA;UAAiB,OAAA;EACf,WAAA;EAIiB;EAFjB,MAAA;IACE,UAAA;MACE,UAAA,GAAa,MAAA;MACb,QAAA;MACA,UAAA,GAAa,MAAA;IAAA;EAAA;EAFb;EAMJ,OAAA,CAAQ,MAAA,QAAc,OAAA;AAAA;;;;UAMP,SAAA;EANO;EAQtB,KAAA,IAAS,OAAA,CAAQ,MAAA,SAAe,OAAA;EARH;EAU7B,KAAA,KAAU,OAAA;AAAA;;;;UAMK,iBAAA;EACf,QAAA;EACA,MAAA;AAAA;;;;;;iBAQc,2BAAA,CACd,YAAA,GAAe,OAAA,GAAU,OAAA,aACxB,SAAA;;;AAZH;;;;iBAkIgB,wBAAA,CACd,QAAA,EAAU,MAAA,SAAe,OAAA,GACzB,WAAA,WACC,MAAA;AA3HH;;;;AAAA,iBAyKgB,2BAAA,CACd,QAAA,EAAU,MAAA,SAAe,OAAA"}

package/dist/lib/runtime/mcp-tools-utils.mjs

@@ -1,152 +0,0 @@
-import "reflect-metadata";
-//#region src/v1-deprecated/lib/runtime/mcp-tools-utils.ts
-/**
-* Extracts CopilotKit-compatible parameters from an MCP tool schema.
-* @param toolOrSchema The schema object from an MCPTool or the full MCPTool object.
-* @returns An array of Parameter objects.
-*/
-function extractParametersFromSchema(toolOrSchema) {
-	const parameters = [];
-	const schema = "schema" in (toolOrSchema || {}) ? toolOrSchema.schema : toolOrSchema;
-	const toolParameters = schema?.parameters?.jsonSchema || schema?.parameters;
-	const properties = toolParameters?.properties;
-	const requiredParams = new Set(toolParameters?.required || []);
-	if (!properties) return parameters;
-	for (const paramName in properties) if (Object.prototype.hasOwnProperty.call(properties, paramName)) {
-		const paramDef = properties[paramName];
-		let type = paramDef.type || "string";
-		let description = paramDef.description || "";
-		if (type === "array" && paramDef.items) {
-			const itemType = paramDef.items.type || "object";
-			if (itemType === "object" && paramDef.items.properties) {
-				const itemProperties = Object.keys(paramDef.items.properties).join(", ");
-				description = description + (description ? " " : "") + `Array of objects with properties: ${itemProperties}`;
-			} else type = `array<${itemType}>`;
-		}
-		let enumValues;
-		if (paramDef.enum && Array.isArray(paramDef.enum)) {
-			enumValues = paramDef.enum.map(String);
-			const enumDisplay = enumValues.join(" | ");
-			description = description + (description ? " " : "") + `Allowed values: ${enumDisplay}`;
-		}
-		let attributes;
-		if (type === "object" && paramDef.properties) {
-			const objectProperties = Object.keys(paramDef.properties).join(", ");
-			description = description + (description ? " " : "") + `Object with properties: ${objectProperties}`;
-			attributes = extractParametersFromSchema({ parameters: {
-				properties: paramDef.properties,
-				required: paramDef.required || []
-			} });
-		}
-		if (type === "array" && paramDef.items?.type === "object" && paramDef.items?.properties) attributes = extractParametersFromSchema({ parameters: {
-			properties: paramDef.items.properties,
-			required: paramDef.items.required || []
-		} });
-		const param = {
-			name: paramName,
-			type,
-			description,
-			required: requiredParams.has(paramName)
-		};
-		if (type === "string" && enumValues) param.enum = enumValues;
-		if (attributes && attributes.length > 0) {
-			param.attributes = attributes;
-			if (type === "array") param.type = "object[]";
-		}
-		parameters.push(param);
-	}
-	return parameters;
-}
-/**
-* Converts a map of MCPTools into an array of CopilotKit Actions.
-* @param mcpTools A record mapping tool names to MCPTool objects.
-* @param mcpEndpoint The endpoint URL from which these tools were fetched.
-* @returns An array of Action<any> objects.
-*/
-function convertMCPToolsToActions(mcpTools, mcpEndpoint) {
-	const actions = [];
-	for (const [toolName, tool] of Object.entries(mcpTools)) {
-		const parameters = extractParametersFromSchema(tool);
-		const handler = async (params) => {
-			try {
-				const result = await tool.execute(params);
-				return typeof result === "string" ? result : JSON.stringify(result);
-			} catch (error) {
-				console.error(`Error executing MCP tool '${toolName}' from endpoint ${mcpEndpoint}:`, error);
-				throw new Error(`Execution failed for MCP tool '${toolName}': ${error instanceof Error ? error.message : String(error)}`, { cause: error });
-			}
-		};
-		actions.push({
-			name: toolName,
-			description: tool.description || `MCP tool: ${toolName} (from ${mcpEndpoint})`,
-			parameters,
-			handler,
-			_isMCPTool: true,
-			_mcpEndpoint: mcpEndpoint
-		});
-	}
-	return actions;
-}
-/**
-* Generate better instructions for using MCP tools
-* This is used to enhance the system prompt with tool documentation
-*/
-function generateMcpToolInstructions(toolsMap) {
-	if (!toolsMap || Object.keys(toolsMap).length === 0) return "";
-	return `You have access to the following external tools provided by Model Context Protocol (MCP) servers:
-
-${Object.entries(toolsMap).map(([name, tool]) => {
-		let paramsDoc = "    No parameters required";
-		try {
-			if (tool.schema && typeof tool.schema === "object") {
-				const schema = tool.schema;
-				const toolParameters = schema.parameters?.jsonSchema || schema.parameters;
-				const properties = toolParameters?.properties || schema.properties;
-				const requiredParams = toolParameters?.required || schema.required || [];
-				if (properties) {
-					const paramsList = Object.entries(properties).map(([paramName, propSchema]) => {
-						const propDetails = propSchema;
-						const requiredMark = requiredParams.includes(paramName) ? "*" : "";
-						let typeInfo = propDetails.type || "any";
-						let description = propDetails.description ? ` - ${propDetails.description}` : "";
-						if (typeInfo === "array" && propDetails.items) {
-							const itemType = propDetails.items.type || "object";
-							if (itemType === "object" && propDetails.items.properties) {
-								const itemProps = Object.keys(propDetails.items.properties).join(", ");
-								typeInfo = `array<object>`;
-								description = description + (description ? " " : " - ") + `Array of objects with properties: ${itemProps}`;
-							} else typeInfo = `array<${itemType}>`;
-						}
-						if (propDetails.enum && Array.isArray(propDetails.enum)) {
-							const enumValues = propDetails.enum.join(" | ");
-							description = description + (description ? " " : " - ") + `Allowed values: ${enumValues}`;
-						}
-						if (typeInfo === "object" && propDetails.properties) {
-							const objectProps = Object.keys(propDetails.properties).join(", ");
-							description = description + (description ? " " : " - ") + `Object with properties: ${objectProps}`;
-						}
-						return `    - ${paramName}${requiredMark} (${typeInfo})${description}`;
-					});
-					if (paramsList.length > 0) paramsDoc = paramsList.join("\n");
-				}
-			}
-		} catch (e) {
-			console.error(`Error parsing schema for tool ${name}:`, e);
-		}
-		return `- ${name}: ${tool.description || ""}
-${paramsDoc}`;
-	}).join("\n\n")}
-
-When using these tools:
-1. Only provide valid parameters according to their type requirements
-2. Required parameters are marked with *
-3. For array parameters, provide data in the correct array format
-4. For object parameters, include all required nested properties
-5. For enum parameters, use only the allowed values listed
-6. Format API calls correctly with the expected parameter structure
-7. Always check tool responses to determine your next action`;
-}
-
-//#endregion
-export { convertMCPToolsToActions, extractParametersFromSchema, generateMcpToolInstructions };
-//# sourceMappingURL=mcp-tools-utils.mjs.map