@copilotkit/runtime 1.72.1-canary.sp-longthread-perf → 1.73.1

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

@@ -0,0 +1,135 @@
+require("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
+exports.describeEndpoint = describeEndpoint;
+exports.resolveMCPEntry = resolveMCPEntry;
+exports.touchMCPEntry = touchMCPEntry;
+//# sourceMappingURL=mcp-client-cache.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-client-cache.cjs","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-client-cache.mjs

@@ -0,0 +1,132 @@
+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

@@ -0,0 +1 @@
+{"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/telemetry-agent-runner.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry-agent-runner.cjs","names":["InMemoryAgentRunner","telemetry"],"sources":["../../../../src/v1-deprecated/lib/runtime/telemetry-agent-runner.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 — TelemetryAgentRunner:\n *   No 1:1 v2 replacement is available.\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 — TelemetryAgentRunnerConfig:\n *   No 1:1 v2 replacement is available.\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\n/**\n * TelemetryAgentRunner - A wrapper around AgentRunner that adds telemetry\n * for agent execution streams.\n *\n * This captures the following telemetry events:\n * - oss.runtime.agent_execution_stream_started - when an agent execution starts\n * - oss.runtime.agent_execution_stream_ended - when an agent execution completes\n * - oss.runtime.agent_execution_stream_errored - when an agent execution fails\n */\n\nimport { InMemoryAgentRunner } from \"../../../v2/runtime\";\nimport type { AgentRunner } from \"../../../v2/runtime\";\nimport { createHash } from \"node:crypto\";\nimport { tap, catchError, finalize } from \"rxjs\";\nimport telemetry from \"../telemetry-client\";\nimport type { AgentExecutionResponseInfo } from \"@copilotkit/shared/src/telemetry/events\";\nimport type { TelemetryCapture } from \"@copilotkit/shared\";\n\n/**\n * Configuration options for TelemetryAgentRunner\n */\nexport interface TelemetryAgentRunnerConfig {\n  /**\n   * The underlying runner to delegate to\n   * If not provided, defaults to InMemoryAgentRunner\n   */\n  runner?: AgentRunner;\n\n  /**\n   * Optional LangSmith API key (will be hashed for telemetry)\n   */\n  langsmithApiKey?: string;\n\n  /** Runtime-bound telemetry capture. Defaults to the legacy singleton. */\n  telemetry?: TelemetryCapture;\n}\n\n/**\n * An AgentRunner wrapper that adds telemetry tracking for agent executions.\n *\n * Usage:\n * ```ts\n * const runtime = new CopilotRuntime({\n *   runner: new TelemetryAgentRunner(),\n *   // or with custom runner:\n *   runner: new TelemetryAgentRunner({ runner: customRunner }),\n * });\n * ```\n */\nexport class TelemetryAgentRunner implements AgentRunner {\n  private readonly _runner: AgentRunner;\n  private readonly hashedLgcKey: string | undefined;\n  private readonly telemetry: TelemetryCapture;\n\n  constructor(config?: TelemetryAgentRunnerConfig) {\n    this._runner = config?.runner ?? new InMemoryAgentRunner();\n    this.telemetry = config?.telemetry ?? telemetry;\n    this.hashedLgcKey = config?.langsmithApiKey\n      ? createHash(\"sha256\").update(config.langsmithApiKey).digest(\"hex\")\n      : undefined;\n  }\n\n  /**\n   * Runs an agent with telemetry tracking.\n   * Wraps the underlying runner's Observable stream with telemetry events.\n   */\n  run(...args: Parameters<AgentRunner[\"run\"]>): ReturnType<AgentRunner[\"run\"]> {\n    const streamInfo: AgentExecutionResponseInfo = {\n      hashedLgcKey: this.hashedLgcKey,\n    };\n    let streamErrored = false;\n\n    // Capture stream started event\n    this.telemetry.capture(\"oss.runtime.agent_execution_stream_started\", {\n      hashedLgcKey: this.hashedLgcKey,\n    });\n\n    // Delegate to the underlying runner and wrap with telemetry\n    return this._runner.run(...args).pipe(\n      // Extract metadata from events if available\n      tap((event) => {\n        // Try to extract provider/model info from raw events\n        const rawEvent = (\n          event as {\n            rawEvent?: {\n              metadata?: Record<string, unknown>;\n              data?: Record<string, unknown>;\n            };\n          }\n        ).rawEvent;\n        if (rawEvent?.data) {\n          const data = rawEvent.data as { output?: { model?: string } };\n          if (data?.output?.model) {\n            streamInfo.model = data.output.model;\n            streamInfo.provider = data.output.model;\n          }\n        }\n        if (rawEvent?.metadata) {\n          const metadata = rawEvent.metadata as {\n            langgraph_host?: string;\n            langgraph_version?: string;\n          };\n          if (metadata?.langgraph_host) {\n            streamInfo.langGraphHost = metadata.langgraph_host;\n          }\n          if (metadata?.langgraph_version) {\n            streamInfo.langGraphVersion = metadata.langgraph_version;\n          }\n        }\n      }),\n      catchError((error) => {\n        // Capture stream error event\n        streamErrored = true;\n        this.telemetry.capture(\"oss.runtime.agent_execution_stream_errored\", {\n          ...streamInfo,\n          error: error instanceof Error ? error.message : String(error),\n        });\n        throw error;\n      }),\n      finalize(() => {\n        // Capture stream ended event (only if not errored)\n        if (!streamErrored) {\n          this.telemetry.capture(\n            \"oss.runtime.agent_execution_stream_ended\",\n            streamInfo,\n          );\n        }\n      }),\n    );\n  }\n\n  /**\n   * Delegates to the underlying runner's connect method\n   */\n  connect(\n    ...args: Parameters<AgentRunner[\"connect\"]>\n  ): ReturnType<AgentRunner[\"connect\"]> {\n    return this._runner.connect(...args);\n  }\n\n  /**\n   * Delegates to the underlying runner's isRunning method\n   */\n  isRunning(\n    ...args: Parameters<AgentRunner[\"isRunning\"]>\n  ): ReturnType<AgentRunner[\"isRunning\"]> {\n    return this._runner.isRunning(...args);\n  }\n\n  /**\n   * Delegates to the underlying runner's stop method\n   */\n  stop(\n    ...args: Parameters<AgentRunner[\"stop\"]>\n  ): ReturnType<AgentRunner[\"stop\"]> {\n    return this._runner.stop(...args);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyEA,IAAa,uBAAb,MAAyD;CAKvD,YAAY,QAAqC;AAC/C,OAAK,UAAU,QAAQ,UAAU,IAAIA,uCAAqB;AAC1D,OAAK,YAAY,QAAQ,aAAaC;AACtC,OAAK,eAAe,QAAQ,8CACb,SAAS,CAAC,OAAO,OAAO,gBAAgB,CAAC,OAAO,MAAM,GACjE;;;;;;CAON,IAAI,GAAG,MAAsE;EAC3E,MAAM,aAAyC,EAC7C,cAAc,KAAK,cACpB;EACD,IAAI,gBAAgB;AAGpB,OAAK,UAAU,QAAQ,8CAA8C,EACnE,cAAc,KAAK,cACpB,CAAC;AAGF,SAAO,KAAK,QAAQ,IAAI,GAAG,KAAK,CAAC,oBAE1B,UAAU;GAEb,MAAM,WACJ,MAMA;AACF,OAAI,UAAU,MAAM;IAClB,MAAM,OAAO,SAAS;AACtB,QAAI,MAAM,QAAQ,OAAO;AACvB,gBAAW,QAAQ,KAAK,OAAO;AAC/B,gBAAW,WAAW,KAAK,OAAO;;;AAGtC,OAAI,UAAU,UAAU;IACtB,MAAM,WAAW,SAAS;AAI1B,QAAI,UAAU,eACZ,YAAW,gBAAgB,SAAS;AAEtC,QAAI,UAAU,kBACZ,YAAW,mBAAmB,SAAS;;IAG3C,wBACU,UAAU;AAEpB,mBAAgB;AAChB,QAAK,UAAU,QAAQ,8CAA8C;IACnE,GAAG;IACH,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;IAC9D,CAAC;AACF,SAAM;IACN,2BACa;AAEb,OAAI,CAAC,cACH,MAAK,UAAU,QACb,4CACA,WACD;IAEH,CACH;;;;;CAMH,QACE,GAAG,MACiC;AACpC,SAAO,KAAK,QAAQ,QAAQ,GAAG,KAAK;;;;;CAMtC,UACE,GAAG,MACmC;AACtC,SAAO,KAAK,QAAQ,UAAU,GAAG,KAAK;;;;;CAMxC,KACE,GAAG,MAC8B;AACjC,SAAO,KAAK,QAAQ,KAAK,GAAG,KAAK"}
+{"version":3,"file":"telemetry-agent-runner.cjs","names":["InMemoryAgentRunner","telemetry"],"sources":["../../../../src/v1-deprecated/lib/runtime/telemetry-agent-runner.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 — TelemetryAgentRunner:\n *   No 1:1 v2 replacement is available.\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 — TelemetryAgentRunnerConfig:\n *   No 1:1 v2 replacement is available.\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\n/**\n * TelemetryAgentRunner - A wrapper around AgentRunner that adds telemetry\n * for agent execution streams.\n *\n * This captures the following telemetry events:\n * - oss.runtime.agent_execution_stream_started - when an agent execution starts\n * - oss.runtime.agent_execution_stream_ended - when an agent execution completes\n * - oss.runtime.agent_execution_stream_errored - when an agent execution fails\n */\n\nimport { InMemoryAgentRunner } from \"../../../v2/runtime/runner\";\nimport type { AgentRunner } from \"../../../v2/runtime/runner\";\nimport { createHash } from \"node:crypto\";\nimport { tap, catchError, finalize } from \"rxjs\";\nimport telemetry from \"../telemetry-client\";\nimport type { AgentExecutionResponseInfo } from \"@copilotkit/shared/src/telemetry/events\";\nimport type { TelemetryCapture } from \"@copilotkit/shared\";\n\n/**\n * Configuration options for TelemetryAgentRunner\n */\nexport interface TelemetryAgentRunnerConfig {\n  /**\n   * The underlying runner to delegate to\n   * If not provided, defaults to InMemoryAgentRunner\n   */\n  runner?: AgentRunner;\n\n  /**\n   * Optional LangSmith API key (will be hashed for telemetry)\n   */\n  langsmithApiKey?: string;\n\n  /** Runtime-bound telemetry capture. Defaults to the legacy singleton. */\n  telemetry?: TelemetryCapture;\n}\n\n/**\n * An AgentRunner wrapper that adds telemetry tracking for agent executions.\n *\n * Usage:\n * ```ts\n * const runtime = new CopilotRuntime({\n *   runner: new TelemetryAgentRunner(),\n *   // or with custom runner:\n *   runner: new TelemetryAgentRunner({ runner: customRunner }),\n * });\n * ```\n */\nexport class TelemetryAgentRunner implements AgentRunner {\n  private readonly _runner: AgentRunner;\n  private readonly hashedLgcKey: string | undefined;\n  private readonly telemetry: TelemetryCapture;\n\n  constructor(config?: TelemetryAgentRunnerConfig) {\n    this._runner = config?.runner ?? new InMemoryAgentRunner();\n    this.telemetry = config?.telemetry ?? telemetry;\n    this.hashedLgcKey = config?.langsmithApiKey\n      ? createHash(\"sha256\").update(config.langsmithApiKey).digest(\"hex\")\n      : undefined;\n  }\n\n  /**\n   * Runs an agent with telemetry tracking.\n   * Wraps the underlying runner's Observable stream with telemetry events.\n   */\n  run(...args: Parameters<AgentRunner[\"run\"]>): ReturnType<AgentRunner[\"run\"]> {\n    const streamInfo: AgentExecutionResponseInfo = {\n      hashedLgcKey: this.hashedLgcKey,\n    };\n    let streamErrored = false;\n\n    // Capture stream started event\n    this.telemetry.capture(\"oss.runtime.agent_execution_stream_started\", {\n      hashedLgcKey: this.hashedLgcKey,\n    });\n\n    // Delegate to the underlying runner and wrap with telemetry\n    return this._runner.run(...args).pipe(\n      // Extract metadata from events if available\n      tap((event) => {\n        // Try to extract provider/model info from raw events\n        const rawEvent = (\n          event as {\n            rawEvent?: {\n              metadata?: Record<string, unknown>;\n              data?: Record<string, unknown>;\n            };\n          }\n        ).rawEvent;\n        if (rawEvent?.data) {\n          const data = rawEvent.data as { output?: { model?: string } };\n          if (data?.output?.model) {\n            streamInfo.model = data.output.model;\n            streamInfo.provider = data.output.model;\n          }\n        }\n        if (rawEvent?.metadata) {\n          const metadata = rawEvent.metadata as {\n            langgraph_host?: string;\n            langgraph_version?: string;\n          };\n          if (metadata?.langgraph_host) {\n            streamInfo.langGraphHost = metadata.langgraph_host;\n          }\n          if (metadata?.langgraph_version) {\n            streamInfo.langGraphVersion = metadata.langgraph_version;\n          }\n        }\n      }),\n      catchError((error) => {\n        // Capture stream error event\n        streamErrored = true;\n        this.telemetry.capture(\"oss.runtime.agent_execution_stream_errored\", {\n          ...streamInfo,\n          error: error instanceof Error ? error.message : String(error),\n        });\n        throw error;\n      }),\n      finalize(() => {\n        // Capture stream ended event (only if not errored)\n        if (!streamErrored) {\n          this.telemetry.capture(\n            \"oss.runtime.agent_execution_stream_ended\",\n            streamInfo,\n          );\n        }\n      }),\n    );\n  }\n\n  /**\n   * Delegates to the underlying runner's connect method\n   */\n  connect(\n    ...args: Parameters<AgentRunner[\"connect\"]>\n  ): ReturnType<AgentRunner[\"connect\"]> {\n    return this._runner.connect(...args);\n  }\n\n  /**\n   * Delegates to the underlying runner's isRunning method\n   */\n  isRunning(\n    ...args: Parameters<AgentRunner[\"isRunning\"]>\n  ): ReturnType<AgentRunner[\"isRunning\"]> {\n    return this._runner.isRunning(...args);\n  }\n\n  /**\n   * Delegates to the underlying runner's stop method\n   */\n  stop(\n    ...args: Parameters<AgentRunner[\"stop\"]>\n  ): ReturnType<AgentRunner[\"stop\"]> {\n    return this._runner.stop(...args);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyEA,IAAa,uBAAb,MAAyD;CAKvD,YAAY,QAAqC;AAC/C,OAAK,UAAU,QAAQ,UAAU,IAAIA,uCAAqB;AAC1D,OAAK,YAAY,QAAQ,aAAaC;AACtC,OAAK,eAAe,QAAQ,8CACb,SAAS,CAAC,OAAO,OAAO,gBAAgB,CAAC,OAAO,MAAM,GACjE;;;;;;CAON,IAAI,GAAG,MAAsE;EAC3E,MAAM,aAAyC,EAC7C,cAAc,KAAK,cACpB;EACD,IAAI,gBAAgB;AAGpB,OAAK,UAAU,QAAQ,8CAA8C,EACnE,cAAc,KAAK,cACpB,CAAC;AAGF,SAAO,KAAK,QAAQ,IAAI,GAAG,KAAK,CAAC,oBAE1B,UAAU;GAEb,MAAM,WACJ,MAMA;AACF,OAAI,UAAU,MAAM;IAClB,MAAM,OAAO,SAAS;AACtB,QAAI,MAAM,QAAQ,OAAO;AACvB,gBAAW,QAAQ,KAAK,OAAO;AAC/B,gBAAW,WAAW,KAAK,OAAO;;;AAGtC,OAAI,UAAU,UAAU;IACtB,MAAM,WAAW,SAAS;AAI1B,QAAI,UAAU,eACZ,YAAW,gBAAgB,SAAS;AAEtC,QAAI,UAAU,kBACZ,YAAW,mBAAmB,SAAS;;IAG3C,wBACU,UAAU;AAEpB,mBAAgB;AAChB,QAAK,UAAU,QAAQ,8CAA8C;IACnE,GAAG;IACH,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;IAC9D,CAAC;AACF,SAAM;IACN,2BACa;AAEb,OAAI,CAAC,cACH,MAAK,UAAU,QACb,4CACA,WACD;IAEH,CACH;;;;;CAMH,QACE,GAAG,MACiC;AACpC,SAAO,KAAK,QAAQ,QAAQ,GAAG,KAAK;;;;;CAMtC,UACE,GAAG,MACmC;AACtC,SAAO,KAAK,QAAQ,UAAU,GAAG,KAAK;;;;;CAMxC,KACE,GAAG,MAC8B;AACjC,SAAO,KAAK,QAAQ,KAAK,GAAG,KAAK"}

package/dist/lib/runtime/telemetry-agent-runner.d.cts

@@ -1,6 +1,6 @@
 
 import { AgentRunner } from "../../v2/runtime/runner/agent-runner.cjs";
-import "../../v2/runtime/index.cjs";
+import "../../v2/runtime/runner/index.cjs";
 import { TelemetryCapture } from "@copilotkit/shared";
 
 //#region src/v1-deprecated/lib/runtime/telemetry-agent-runner.d.ts

package/dist/lib/runtime/telemetry-agent-runner.d.mts

@@ -1,6 +1,6 @@
 
 import { AgentRunner } from "../../v2/runtime/runner/agent-runner.mjs";
-import "../../v2/runtime/index.mjs";
+import "../../v2/runtime/runner/index.mjs";
 import { TelemetryCapture } from "@copilotkit/shared";
 
 //#region src/v1-deprecated/lib/runtime/telemetry-agent-runner.d.ts

package/dist/lib/runtime/telemetry-agent-runner.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry-agent-runner.mjs","names":["telemetry"],"sources":["../../../../src/v1-deprecated/lib/runtime/telemetry-agent-runner.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 — TelemetryAgentRunner:\n *   No 1:1 v2 replacement is available.\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 — TelemetryAgentRunnerConfig:\n *   No 1:1 v2 replacement is available.\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\n/**\n * TelemetryAgentRunner - A wrapper around AgentRunner that adds telemetry\n * for agent execution streams.\n *\n * This captures the following telemetry events:\n * - oss.runtime.agent_execution_stream_started - when an agent execution starts\n * - oss.runtime.agent_execution_stream_ended - when an agent execution completes\n * - oss.runtime.agent_execution_stream_errored - when an agent execution fails\n */\n\nimport { InMemoryAgentRunner } from \"../../../v2/runtime\";\nimport type { AgentRunner } from \"../../../v2/runtime\";\nimport { createHash } from \"node:crypto\";\nimport { tap, catchError, finalize } from \"rxjs\";\nimport telemetry from \"../telemetry-client\";\nimport type { AgentExecutionResponseInfo } from \"@copilotkit/shared/src/telemetry/events\";\nimport type { TelemetryCapture } from \"@copilotkit/shared\";\n\n/**\n * Configuration options for TelemetryAgentRunner\n */\nexport interface TelemetryAgentRunnerConfig {\n  /**\n   * The underlying runner to delegate to\n   * If not provided, defaults to InMemoryAgentRunner\n   */\n  runner?: AgentRunner;\n\n  /**\n   * Optional LangSmith API key (will be hashed for telemetry)\n   */\n  langsmithApiKey?: string;\n\n  /** Runtime-bound telemetry capture. Defaults to the legacy singleton. */\n  telemetry?: TelemetryCapture;\n}\n\n/**\n * An AgentRunner wrapper that adds telemetry tracking for agent executions.\n *\n * Usage:\n * ```ts\n * const runtime = new CopilotRuntime({\n *   runner: new TelemetryAgentRunner(),\n *   // or with custom runner:\n *   runner: new TelemetryAgentRunner({ runner: customRunner }),\n * });\n * ```\n */\nexport class TelemetryAgentRunner implements AgentRunner {\n  private readonly _runner: AgentRunner;\n  private readonly hashedLgcKey: string | undefined;\n  private readonly telemetry: TelemetryCapture;\n\n  constructor(config?: TelemetryAgentRunnerConfig) {\n    this._runner = config?.runner ?? new InMemoryAgentRunner();\n    this.telemetry = config?.telemetry ?? telemetry;\n    this.hashedLgcKey = config?.langsmithApiKey\n      ? createHash(\"sha256\").update(config.langsmithApiKey).digest(\"hex\")\n      : undefined;\n  }\n\n  /**\n   * Runs an agent with telemetry tracking.\n   * Wraps the underlying runner's Observable stream with telemetry events.\n   */\n  run(...args: Parameters<AgentRunner[\"run\"]>): ReturnType<AgentRunner[\"run\"]> {\n    const streamInfo: AgentExecutionResponseInfo = {\n      hashedLgcKey: this.hashedLgcKey,\n    };\n    let streamErrored = false;\n\n    // Capture stream started event\n    this.telemetry.capture(\"oss.runtime.agent_execution_stream_started\", {\n      hashedLgcKey: this.hashedLgcKey,\n    });\n\n    // Delegate to the underlying runner and wrap with telemetry\n    return this._runner.run(...args).pipe(\n      // Extract metadata from events if available\n      tap((event) => {\n        // Try to extract provider/model info from raw events\n        const rawEvent = (\n          event as {\n            rawEvent?: {\n              metadata?: Record<string, unknown>;\n              data?: Record<string, unknown>;\n            };\n          }\n        ).rawEvent;\n        if (rawEvent?.data) {\n          const data = rawEvent.data as { output?: { model?: string } };\n          if (data?.output?.model) {\n            streamInfo.model = data.output.model;\n            streamInfo.provider = data.output.model;\n          }\n        }\n        if (rawEvent?.metadata) {\n          const metadata = rawEvent.metadata as {\n            langgraph_host?: string;\n            langgraph_version?: string;\n          };\n          if (metadata?.langgraph_host) {\n            streamInfo.langGraphHost = metadata.langgraph_host;\n          }\n          if (metadata?.langgraph_version) {\n            streamInfo.langGraphVersion = metadata.langgraph_version;\n          }\n        }\n      }),\n      catchError((error) => {\n        // Capture stream error event\n        streamErrored = true;\n        this.telemetry.capture(\"oss.runtime.agent_execution_stream_errored\", {\n          ...streamInfo,\n          error: error instanceof Error ? error.message : String(error),\n        });\n        throw error;\n      }),\n      finalize(() => {\n        // Capture stream ended event (only if not errored)\n        if (!streamErrored) {\n          this.telemetry.capture(\n            \"oss.runtime.agent_execution_stream_ended\",\n            streamInfo,\n          );\n        }\n      }),\n    );\n  }\n\n  /**\n   * Delegates to the underlying runner's connect method\n   */\n  connect(\n    ...args: Parameters<AgentRunner[\"connect\"]>\n  ): ReturnType<AgentRunner[\"connect\"]> {\n    return this._runner.connect(...args);\n  }\n\n  /**\n   * Delegates to the underlying runner's isRunning method\n   */\n  isRunning(\n    ...args: Parameters<AgentRunner[\"isRunning\"]>\n  ): ReturnType<AgentRunner[\"isRunning\"]> {\n    return this._runner.isRunning(...args);\n  }\n\n  /**\n   * Delegates to the underlying runner's stop method\n   */\n  stop(\n    ...args: Parameters<AgentRunner[\"stop\"]>\n  ): ReturnType<AgentRunner[\"stop\"]> {\n    return this._runner.stop(...args);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyEA,IAAa,uBAAb,MAAyD;CAKvD,YAAY,QAAqC;AAC/C,OAAK,UAAU,QAAQ,UAAU,IAAI,qBAAqB;AAC1D,OAAK,YAAY,QAAQ,aAAaA;AACtC,OAAK,eAAe,QAAQ,kBACxB,WAAW,SAAS,CAAC,OAAO,OAAO,gBAAgB,CAAC,OAAO,MAAM,GACjE;;;;;;CAON,IAAI,GAAG,MAAsE;EAC3E,MAAM,aAAyC,EAC7C,cAAc,KAAK,cACpB;EACD,IAAI,gBAAgB;AAGpB,OAAK,UAAU,QAAQ,8CAA8C,EACnE,cAAc,KAAK,cACpB,CAAC;AAGF,SAAO,KAAK,QAAQ,IAAI,GAAG,KAAK,CAAC,KAE/B,KAAK,UAAU;GAEb,MAAM,WACJ,MAMA;AACF,OAAI,UAAU,MAAM;IAClB,MAAM,OAAO,SAAS;AACtB,QAAI,MAAM,QAAQ,OAAO;AACvB,gBAAW,QAAQ,KAAK,OAAO;AAC/B,gBAAW,WAAW,KAAK,OAAO;;;AAGtC,OAAI,UAAU,UAAU;IACtB,MAAM,WAAW,SAAS;AAI1B,QAAI,UAAU,eACZ,YAAW,gBAAgB,SAAS;AAEtC,QAAI,UAAU,kBACZ,YAAW,mBAAmB,SAAS;;IAG3C,EACF,YAAY,UAAU;AAEpB,mBAAgB;AAChB,QAAK,UAAU,QAAQ,8CAA8C;IACnE,GAAG;IACH,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;IAC9D,CAAC;AACF,SAAM;IACN,EACF,eAAe;AAEb,OAAI,CAAC,cACH,MAAK,UAAU,QACb,4CACA,WACD;IAEH,CACH;;;;;CAMH,QACE,GAAG,MACiC;AACpC,SAAO,KAAK,QAAQ,QAAQ,GAAG,KAAK;;;;;CAMtC,UACE,GAAG,MACmC;AACtC,SAAO,KAAK,QAAQ,UAAU,GAAG,KAAK;;;;;CAMxC,KACE,GAAG,MAC8B;AACjC,SAAO,KAAK,QAAQ,KAAK,GAAG,KAAK"}
+{"version":3,"file":"telemetry-agent-runner.mjs","names":["telemetry"],"sources":["../../../../src/v1-deprecated/lib/runtime/telemetry-agent-runner.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 — TelemetryAgentRunner:\n *   No 1:1 v2 replacement is available.\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 — TelemetryAgentRunnerConfig:\n *   No 1:1 v2 replacement is available.\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\n/**\n * TelemetryAgentRunner - A wrapper around AgentRunner that adds telemetry\n * for agent execution streams.\n *\n * This captures the following telemetry events:\n * - oss.runtime.agent_execution_stream_started - when an agent execution starts\n * - oss.runtime.agent_execution_stream_ended - when an agent execution completes\n * - oss.runtime.agent_execution_stream_errored - when an agent execution fails\n */\n\nimport { InMemoryAgentRunner } from \"../../../v2/runtime/runner\";\nimport type { AgentRunner } from \"../../../v2/runtime/runner\";\nimport { createHash } from \"node:crypto\";\nimport { tap, catchError, finalize } from \"rxjs\";\nimport telemetry from \"../telemetry-client\";\nimport type { AgentExecutionResponseInfo } from \"@copilotkit/shared/src/telemetry/events\";\nimport type { TelemetryCapture } from \"@copilotkit/shared\";\n\n/**\n * Configuration options for TelemetryAgentRunner\n */\nexport interface TelemetryAgentRunnerConfig {\n  /**\n   * The underlying runner to delegate to\n   * If not provided, defaults to InMemoryAgentRunner\n   */\n  runner?: AgentRunner;\n\n  /**\n   * Optional LangSmith API key (will be hashed for telemetry)\n   */\n  langsmithApiKey?: string;\n\n  /** Runtime-bound telemetry capture. Defaults to the legacy singleton. */\n  telemetry?: TelemetryCapture;\n}\n\n/**\n * An AgentRunner wrapper that adds telemetry tracking for agent executions.\n *\n * Usage:\n * ```ts\n * const runtime = new CopilotRuntime({\n *   runner: new TelemetryAgentRunner(),\n *   // or with custom runner:\n *   runner: new TelemetryAgentRunner({ runner: customRunner }),\n * });\n * ```\n */\nexport class TelemetryAgentRunner implements AgentRunner {\n  private readonly _runner: AgentRunner;\n  private readonly hashedLgcKey: string | undefined;\n  private readonly telemetry: TelemetryCapture;\n\n  constructor(config?: TelemetryAgentRunnerConfig) {\n    this._runner = config?.runner ?? new InMemoryAgentRunner();\n    this.telemetry = config?.telemetry ?? telemetry;\n    this.hashedLgcKey = config?.langsmithApiKey\n      ? createHash(\"sha256\").update(config.langsmithApiKey).digest(\"hex\")\n      : undefined;\n  }\n\n  /**\n   * Runs an agent with telemetry tracking.\n   * Wraps the underlying runner's Observable stream with telemetry events.\n   */\n  run(...args: Parameters<AgentRunner[\"run\"]>): ReturnType<AgentRunner[\"run\"]> {\n    const streamInfo: AgentExecutionResponseInfo = {\n      hashedLgcKey: this.hashedLgcKey,\n    };\n    let streamErrored = false;\n\n    // Capture stream started event\n    this.telemetry.capture(\"oss.runtime.agent_execution_stream_started\", {\n      hashedLgcKey: this.hashedLgcKey,\n    });\n\n    // Delegate to the underlying runner and wrap with telemetry\n    return this._runner.run(...args).pipe(\n      // Extract metadata from events if available\n      tap((event) => {\n        // Try to extract provider/model info from raw events\n        const rawEvent = (\n          event as {\n            rawEvent?: {\n              metadata?: Record<string, unknown>;\n              data?: Record<string, unknown>;\n            };\n          }\n        ).rawEvent;\n        if (rawEvent?.data) {\n          const data = rawEvent.data as { output?: { model?: string } };\n          if (data?.output?.model) {\n            streamInfo.model = data.output.model;\n            streamInfo.provider = data.output.model;\n          }\n        }\n        if (rawEvent?.metadata) {\n          const metadata = rawEvent.metadata as {\n            langgraph_host?: string;\n            langgraph_version?: string;\n          };\n          if (metadata?.langgraph_host) {\n            streamInfo.langGraphHost = metadata.langgraph_host;\n          }\n          if (metadata?.langgraph_version) {\n            streamInfo.langGraphVersion = metadata.langgraph_version;\n          }\n        }\n      }),\n      catchError((error) => {\n        // Capture stream error event\n        streamErrored = true;\n        this.telemetry.capture(\"oss.runtime.agent_execution_stream_errored\", {\n          ...streamInfo,\n          error: error instanceof Error ? error.message : String(error),\n        });\n        throw error;\n      }),\n      finalize(() => {\n        // Capture stream ended event (only if not errored)\n        if (!streamErrored) {\n          this.telemetry.capture(\n            \"oss.runtime.agent_execution_stream_ended\",\n            streamInfo,\n          );\n        }\n      }),\n    );\n  }\n\n  /**\n   * Delegates to the underlying runner's connect method\n   */\n  connect(\n    ...args: Parameters<AgentRunner[\"connect\"]>\n  ): ReturnType<AgentRunner[\"connect\"]> {\n    return this._runner.connect(...args);\n  }\n\n  /**\n   * Delegates to the underlying runner's isRunning method\n   */\n  isRunning(\n    ...args: Parameters<AgentRunner[\"isRunning\"]>\n  ): ReturnType<AgentRunner[\"isRunning\"]> {\n    return this._runner.isRunning(...args);\n  }\n\n  /**\n   * Delegates to the underlying runner's stop method\n   */\n  stop(\n    ...args: Parameters<AgentRunner[\"stop\"]>\n  ): ReturnType<AgentRunner[\"stop\"]> {\n    return this._runner.stop(...args);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyEA,IAAa,uBAAb,MAAyD;CAKvD,YAAY,QAAqC;AAC/C,OAAK,UAAU,QAAQ,UAAU,IAAI,qBAAqB;AAC1D,OAAK,YAAY,QAAQ,aAAaA;AACtC,OAAK,eAAe,QAAQ,kBACxB,WAAW,SAAS,CAAC,OAAO,OAAO,gBAAgB,CAAC,OAAO,MAAM,GACjE;;;;;;CAON,IAAI,GAAG,MAAsE;EAC3E,MAAM,aAAyC,EAC7C,cAAc,KAAK,cACpB;EACD,IAAI,gBAAgB;AAGpB,OAAK,UAAU,QAAQ,8CAA8C,EACnE,cAAc,KAAK,cACpB,CAAC;AAGF,SAAO,KAAK,QAAQ,IAAI,GAAG,KAAK,CAAC,KAE/B,KAAK,UAAU;GAEb,MAAM,WACJ,MAMA;AACF,OAAI,UAAU,MAAM;IAClB,MAAM,OAAO,SAAS;AACtB,QAAI,MAAM,QAAQ,OAAO;AACvB,gBAAW,QAAQ,KAAK,OAAO;AAC/B,gBAAW,WAAW,KAAK,OAAO;;;AAGtC,OAAI,UAAU,UAAU;IACtB,MAAM,WAAW,SAAS;AAI1B,QAAI,UAAU,eACZ,YAAW,gBAAgB,SAAS;AAEtC,QAAI,UAAU,kBACZ,YAAW,mBAAmB,SAAS;;IAG3C,EACF,YAAY,UAAU;AAEpB,mBAAgB;AAChB,QAAK,UAAU,QAAQ,8CAA8C;IACnE,GAAG;IACH,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;IAC9D,CAAC;AACF,SAAM;IACN,EACF,eAAe;AAEb,OAAI,CAAC,cACH,MAAK,UAAU,QACb,4CACA,WACD;IAEH,CACH;;;;;CAMH,QACE,GAAG,MACiC;AACpC,SAAO,KAAK,QAAQ,QAAQ,GAAG,KAAK;;;;;CAMtC,UACE,GAAG,MACmC;AACtC,SAAO,KAAK,QAAQ,UAAU,GAAG,KAAK;;;;;CAMxC,KACE,GAAG,MAC8B;AACjC,SAAO,KAAK,QAAQ,KAAK,GAAG,KAAK"}

package/dist/package.cjs

@@ -5,7 +5,7 @@ const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
 var require_package = /* @__PURE__ */ require_runtime.__commonJSMin(((exports, module) => {
 	module.exports = {
 		"name": "@copilotkit/runtime",
-		"version": "1.72.1-canary.sp-longthread-perf",
+		"version": "1.73.1",
 		"private": false,
 		"keywords": [
 			"ai",
@@ -41,6 +41,10 @@ var require_package = /* @__PURE__ */ require_runtime.__commonJSMin(((exports, m
 				"import": "./dist/index.mjs",
 				"require": "./dist/index.cjs"
 			},
+			"./internal/learned-skills": {
+				"import": "./dist/internal/learned-skills.mjs",
+				"require": "./dist/internal/learned-skills.cjs"
+			},
 			"./langgraph": {
 				"import": "./dist/langgraph.mjs",
 				"require": "./dist/langgraph.cjs"
@@ -73,7 +77,7 @@ var require_package = /* @__PURE__ */ require_runtime.__commonJSMin(((exports, m
 			"generate-graphql-schema": "node -e \"const fs=require('fs');fs.rmSync('__snapshots__',{recursive:true,force:true})\" && ts-node --transpile-only ./scripts/generate-gql-schema.ts",
 			"link:global": "pnpm link --global",
 			"unlink:global": "pnpm unlink --global",
-			"check-dts": "tsx ../../scripts/validate-dts-ambient.ts dist && tsx ../../scripts/validate-dts-imports.ts dist",
+			"check-dts": "tsx ../../scripts/validate-dts-ambient.ts dist && tsx ../../scripts/validate-dts-imports.ts dist && tsx ../../scripts/validate-optional-peer-entries.ts . && tsc --noEmit -p type-fixtures/express4/tsconfig.json && tsc --noEmit -p type-fixtures/express5/tsconfig.json",
 			"publint": "publint .",
 			"attw": "attw --pack . --profile node16"
 		},
@@ -102,13 +106,10 @@ var require_package = /* @__PURE__ */ require_runtime.__commonJSMin(((exports, m
 			"@scarf/scarf": "^1.3.0",
 			"@segment/analytics-node": "^2.1.2",
 			"@types/cors": "^2.8.17",
-			"@types/express": "^4.17.21",
 			"ai": "^6.0.104",
-			"clarinet": "^0.12.4",
 			"class-transformer": "^0.5.1",
 			"class-validator": "^0.14.1",
 			"cors": "^2.8.5",
-			"express": "^4.21.2",
 			"graphql": "^16.8.1",
 			"graphql-scalars": "^1.23.0",
 			"graphql-yoga": "^5.3.1",
@@ -123,13 +124,16 @@ var require_package = /* @__PURE__ */ require_runtime.__commonJSMin(((exports, m
 			"type-graphql": "2.0.0-rc.1",
 			"uuid": "^11.1.0",
 			"ws": "^8.18.0",
-			"zod": "^3.23.3"
+			"zod": "^3.23.3",
+			"yauzl": "2.10.0"
 		},
 		"devDependencies": {
 			"@copilotkit/aimock": "latest",
 			"@copilotkit/channels": "workspace:*",
 			"@swc/core": "1.5.28",
 			"@tanstack/intent": "^0.0.29",
+			"@types/express": "^4.17.21",
+			"@types/express-v5": "npm:@types/express@^5.0.0",
 			"@types/node": "^18.11.17",
 			"@types/phoenix": "^1.6.6",
 			"@valibot/to-json-schema": "^1.5.0",
@@ -138,6 +142,7 @@ var require_package = /* @__PURE__ */ require_runtime.__commonJSMin(((exports, m
 			"arktype": "^2.1.29",
 			"elysia": "^1.2.25",
 			"eslint": "^8.56.0",
+			"express": "^4.18.0 || ^5.0.0",
 			"nodemon": "^3.1.3",
 			"supertest": "^7.1.1",
 			"ts-node": "^10.9.2",
@@ -145,7 +150,8 @@ var require_package = /* @__PURE__ */ require_runtime.__commonJSMin(((exports, m
 			"tsdown": "^0.20.3",
 			"typescript": "^5.2.3",
 			"valibot": "^1.2.0",
-			"vitest": "^3.2.4"
+			"vitest": "^3.2.4",
+			"@types/yauzl": "2.10.3"
 		},
 		"peerDependencies": {
 			"@anthropic-ai/sdk": ">=0.57.0",
@@ -155,6 +161,7 @@ var require_package = /* @__PURE__ */ require_runtime.__commonJSMin(((exports, m
 			"@langchain/google-gauth": ">=0.1.0",
 			"@langchain/langgraph-sdk": ">=0.1.2",
 			"@langchain/openai": ">=0.4.2",
+			"express": "^4.18.0 || ^5.0.0",
 			"groq-sdk": ">=0.3.0 <1.0.0",
 			"langchain": ">=0.3.3",
 			"openai": "^4.85.1 || >=5.0.0"
@@ -166,6 +173,7 @@ var require_package = /* @__PURE__ */ require_runtime.__commonJSMin(((exports, m
 			"@langchain/google-gauth": { "optional": true },
 			"@langchain/langgraph-sdk": { "optional": true },
 			"@langchain/openai": { "optional": true },
+			"express": { "optional": true },
 			"groq-sdk": { "optional": true },
 			"langchain": { "optional": true },
 			"openai": { "optional": true }

package/dist/package.mjs

@@ -5,7 +5,7 @@ import { __commonJSMin } from "./_virtual/_rolldown/runtime.mjs";
 var require_package = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	module.exports = {
 		"name": "@copilotkit/runtime",
-		"version": "1.72.1-canary.sp-longthread-perf",
+		"version": "1.73.1",
 		"private": false,
 		"keywords": [
 			"ai",
@@ -41,6 +41,10 @@ var require_package = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 				"import": "./dist/index.mjs",
 				"require": "./dist/index.cjs"
 			},
+			"./internal/learned-skills": {
+				"import": "./dist/internal/learned-skills.mjs",
+				"require": "./dist/internal/learned-skills.cjs"
+			},
 			"./langgraph": {
 				"import": "./dist/langgraph.mjs",
 				"require": "./dist/langgraph.cjs"
@@ -73,7 +77,7 @@ var require_package = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 			"generate-graphql-schema": "node -e \"const fs=require('fs');fs.rmSync('__snapshots__',{recursive:true,force:true})\" && ts-node --transpile-only ./scripts/generate-gql-schema.ts",
 			"link:global": "pnpm link --global",
 			"unlink:global": "pnpm unlink --global",
-			"check-dts": "tsx ../../scripts/validate-dts-ambient.ts dist && tsx ../../scripts/validate-dts-imports.ts dist",
+			"check-dts": "tsx ../../scripts/validate-dts-ambient.ts dist && tsx ../../scripts/validate-dts-imports.ts dist && tsx ../../scripts/validate-optional-peer-entries.ts . && tsc --noEmit -p type-fixtures/express4/tsconfig.json && tsc --noEmit -p type-fixtures/express5/tsconfig.json",
 			"publint": "publint .",
 			"attw": "attw --pack . --profile node16"
 		},
@@ -102,13 +106,10 @@ var require_package = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 			"@scarf/scarf": "^1.3.0",
 			"@segment/analytics-node": "^2.1.2",
 			"@types/cors": "^2.8.17",
-			"@types/express": "^4.17.21",
 			"ai": "^6.0.104",
-			"clarinet": "^0.12.4",
 			"class-transformer": "^0.5.1",
 			"class-validator": "^0.14.1",
 			"cors": "^2.8.5",
-			"express": "^4.21.2",
 			"graphql": "^16.8.1",
 			"graphql-scalars": "^1.23.0",
 			"graphql-yoga": "^5.3.1",
@@ -123,13 +124,16 @@ var require_package = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 			"type-graphql": "2.0.0-rc.1",
 			"uuid": "^11.1.0",
 			"ws": "^8.18.0",
-			"zod": "^3.23.3"
+			"zod": "^3.23.3",
+			"yauzl": "2.10.0"
 		},
 		"devDependencies": {
 			"@copilotkit/aimock": "latest",
 			"@copilotkit/channels": "workspace:*",
 			"@swc/core": "1.5.28",
 			"@tanstack/intent": "^0.0.29",
+			"@types/express": "^4.17.21",
+			"@types/express-v5": "npm:@types/express@^5.0.0",
 			"@types/node": "^18.11.17",
 			"@types/phoenix": "^1.6.6",
 			"@valibot/to-json-schema": "^1.5.0",
@@ -138,6 +142,7 @@ var require_package = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 			"arktype": "^2.1.29",
 			"elysia": "^1.2.25",
 			"eslint": "^8.56.0",
+			"express": "^4.18.0 || ^5.0.0",
 			"nodemon": "^3.1.3",
 			"supertest": "^7.1.1",
 			"ts-node": "^10.9.2",
@@ -145,7 +150,8 @@ var require_package = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 			"tsdown": "^0.20.3",
 			"typescript": "^5.2.3",
 			"valibot": "^1.2.0",
-			"vitest": "^3.2.4"
+			"vitest": "^3.2.4",
+			"@types/yauzl": "2.10.3"
 		},
 		"peerDependencies": {
 			"@anthropic-ai/sdk": ">=0.57.0",
@@ -155,6 +161,7 @@ var require_package = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 			"@langchain/google-gauth": ">=0.1.0",
 			"@langchain/langgraph-sdk": ">=0.1.2",
 			"@langchain/openai": ">=0.4.2",
+			"express": "^4.18.0 || ^5.0.0",
 			"groq-sdk": ">=0.3.0 <1.0.0",
 			"langchain": ">=0.3.3",
 			"openai": "^4.85.1 || >=5.0.0"
@@ -166,6 +173,7 @@ var require_package = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 			"@langchain/google-gauth": { "optional": true },
 			"@langchain/langgraph-sdk": { "optional": true },
 			"@langchain/openai": { "optional": true },
+			"express": { "optional": true },
 			"groq-sdk": { "optional": true },
 			"langchain": { "optional": true },
 			"openai": { "optional": true }