@copilotkit/runtime 2.0.0-next.1 → 2.0.0-rc.1

package/dist/runtime/handlers/handle-debug-events.mjs

@@ -0,0 +1,33 @@
+import { isDebugEventFeedEnabled } from "../core/debug-event-bus.mjs";
+
+//#region src/runtime/handlers/handle-debug-events.ts
+function handleDebugEvents({ runtime, request }) {
+	if (!isDebugEventFeedEnabled(runtime.debug)) return new Response("Not Found", { status: 404 });
+	if (!runtime.debugEventBus) return new Response("Debug event bus not available", { status: 503 });
+	const bus = runtime.debugEventBus;
+	const encoder = new TextEncoder();
+	const stream = new TransformStream();
+	const writer = stream.writable.getWriter();
+	writer.write(encoder.encode(": connected\n\n")).catch(() => {});
+	const unsubscribe = bus.subscribe((envelope) => {
+		if (request.signal.aborted) return;
+		const line = `data: ${JSON.stringify(envelope)}\n\n`;
+		writer.write(encoder.encode(line)).catch(() => {});
+	});
+	request.signal.addEventListener("abort", () => {
+		unsubscribe();
+		writer.close().catch(() => {});
+	});
+	return new Response(stream.readable, {
+		status: 200,
+		headers: {
+			"Content-Type": "text/event-stream",
+			"Cache-Control": "no-cache",
+			Connection: "keep-alive"
+		}
+	});
+}
+
+//#endregion
+export { handleDebugEvents };
+//# sourceMappingURL=handle-debug-events.mjs.map

package/dist/runtime/handlers/handle-debug-events.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-debug-events.mjs","names":[],"sources":["../../../src/runtime/handlers/handle-debug-events.ts"],"sourcesContent":["import type { CopilotRuntimeLike } from \"../core/runtime\";\nimport { isDebugEventFeedEnabled } from \"../core/debug-event-bus\";\nimport type { DebugEventEnvelope } from \"@copilotkit/shared\";\n\ninterface HandleDebugEventsParams {\n  runtime: CopilotRuntimeLike;\n  request: Request;\n}\n\nexport function handleDebugEvents({\n  runtime,\n  request,\n}: HandleDebugEventsParams): Response {\n  if (!isDebugEventFeedEnabled(runtime.debug)) {\n    return new Response(\"Not Found\", { status: 404 });\n  }\n\n  if (!runtime.debugEventBus) {\n    return new Response(\"Debug event bus not available\", { status: 503 });\n  }\n\n  const bus = runtime.debugEventBus;\n  const encoder = new TextEncoder();\n  const stream = new TransformStream();\n  const writer = stream.writable.getWriter();\n\n  // Send an SSE comment immediately to flush response headers to the client.\n  // Without this, some frameworks buffer the response until actual data is written,\n  // leaving the client stuck in \"connecting\" state.\n  writer.write(encoder.encode(\": connected\\n\\n\")).catch(() => {});\n\n  const unsubscribe = bus.subscribe((envelope: DebugEventEnvelope) => {\n    if (request.signal.aborted) return;\n    const line = `data: ${JSON.stringify(envelope)}\\n\\n`;\n    writer.write(encoder.encode(line)).catch(() => {\n      // Client disconnected, will be cleaned up by abort handler.\n    });\n  });\n\n  request.signal.addEventListener(\"abort\", () => {\n    unsubscribe();\n    writer.close().catch(() => {});\n  });\n\n  return new Response(stream.readable, {\n    status: 200,\n    headers: {\n      \"Content-Type\": \"text/event-stream\",\n      \"Cache-Control\": \"no-cache\",\n      Connection: \"keep-alive\",\n    },\n  });\n}\n"],"mappings":";;;AASA,SAAgB,kBAAkB,EAChC,SACA,WACoC;AACpC,KAAI,CAAC,wBAAwB,QAAQ,MAAM,CACzC,QAAO,IAAI,SAAS,aAAa,EAAE,QAAQ,KAAK,CAAC;AAGnD,KAAI,CAAC,QAAQ,cACX,QAAO,IAAI,SAAS,iCAAiC,EAAE,QAAQ,KAAK,CAAC;CAGvE,MAAM,MAAM,QAAQ;CACpB,MAAM,UAAU,IAAI,aAAa;CACjC,MAAM,SAAS,IAAI,iBAAiB;CACpC,MAAM,SAAS,OAAO,SAAS,WAAW;AAK1C,QAAO,MAAM,QAAQ,OAAO,kBAAkB,CAAC,CAAC,YAAY,GAAG;CAE/D,MAAM,cAAc,IAAI,WAAW,aAAiC;AAClE,MAAI,QAAQ,OAAO,QAAS;EAC5B,MAAM,OAAO,SAAS,KAAK,UAAU,SAAS,CAAC;AAC/C,SAAO,MAAM,QAAQ,OAAO,KAAK,CAAC,CAAC,YAAY,GAE7C;GACF;AAEF,SAAQ,OAAO,iBAAiB,eAAe;AAC7C,eAAa;AACb,SAAO,OAAO,CAAC,YAAY,GAAG;GAC9B;AAEF,QAAO,IAAI,SAAS,OAAO,UAAU;EACnC,QAAQ;EACR,SAAS;GACP,gBAAgB;GAChB,iBAAiB;GACjB,YAAY;GACb;EACF,CAAC"}

package/dist/runtime/handlers/handle-inspector-learning.cjs

@@ -0,0 +1,56 @@
+const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
+const require_learning = require('../core/learning.cjs');
+const require_client = require('../intelligence-platform/client.cjs');
+const require_resolve_intelligence_user = require('./shared/resolve-intelligence-user.cjs');
+const require_runtime$1 = require('../core/runtime.cjs');
+let _copilotkit_shared = require("@copilotkit/shared");
+
+//#region src/runtime/handlers/handle-inspector-learning.ts
+const headers = {
+	"Cache-Control": "no-store, private",
+	"Content-Type": "application/json"
+};
+const errorResponse = (status, message) => new Response(JSON.stringify({ error: message }), {
+	status,
+	headers
+});
+const queryPage = (value) => value === null ? void 0 : Number(value);
+/** Proxies a bounded Learning read through the runtime's server-held credential. */
+async function handleInspectorLearning({ runtime, request }) {
+	if (!require_runtime$1.isIntelligenceRuntime(runtime) || !require_learning.hasLearningContainerConfiguration(runtime)) return errorResponse(404, "Not found");
+	const user = await require_resolve_intelligence_user.resolveIntelligenceUser({
+		runtime,
+		request
+	});
+	if (user instanceof Response) return user;
+	const url = new URL(request.url);
+	if ([...url.searchParams.keys()].some((key) => ![
+		"agentId",
+		"skillsPage",
+		"insightsPage"
+	].includes(key))) return errorResponse(400, "Invalid Inspector Learning request");
+	const parsedRequest = (0, _copilotkit_shared.parseInspectorLearningRequestV1)({
+		agentId: url.searchParams.get("agentId") ?? void 0,
+		skillsPage: queryPage(url.searchParams.get("skillsPage")),
+		insightsPage: queryPage(url.searchParams.get("insightsPage"))
+	});
+	if (!parsedRequest) return errorResponse(400, "Invalid Inspector Learning request");
+	try {
+		const snapshot = (0, _copilotkit_shared.parseInspectorLearningSnapshotV1)(await runtime.intelligence.getInspectorLearning({
+			...parsedRequest,
+			...typeof runtime.learning?.containerId === "string" ? { runtimeContainerId: runtime.learning.containerId } : {}
+		}));
+		if (!snapshot) return errorResponse(502, "Invalid Inspector Learning response");
+		return new Response(JSON.stringify(snapshot), {
+			status: 200,
+			headers
+		});
+	} catch (error) {
+		if (error instanceof require_client.PlatformRequestError && error.status === 404) return errorResponse(404, "Not found");
+		return errorResponse(503, "Inspector Learning is temporarily unavailable");
+	}
+}
+
+//#endregion
+exports.handleInspectorLearning = handleInspectorLearning;
+//# sourceMappingURL=handle-inspector-learning.cjs.map

package/dist/runtime/handlers/handle-inspector-learning.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-inspector-learning.cjs","names":["isIntelligenceRuntime","hasLearningContainerConfiguration","resolveIntelligenceUser","PlatformRequestError"],"sources":["../../../src/runtime/handlers/handle-inspector-learning.ts"],"sourcesContent":["import {\n  parseInspectorLearningRequestV1,\n  parseInspectorLearningSnapshotV1,\n} from \"@copilotkit/shared\";\nimport type { CopilotRuntimeLike } from \"../core/runtime\";\nimport { hasLearningContainerConfiguration } from \"../core/learning\";\nimport { isIntelligenceRuntime } from \"../core/runtime\";\nimport { PlatformRequestError } from \"../intelligence-platform/client\";\nimport { resolveIntelligenceUser } from \"./shared/resolve-intelligence-user\";\n\nconst headers = {\n  \"Cache-Control\": \"no-store, private\",\n  \"Content-Type\": \"application/json\",\n} as const;\n\nconst errorResponse = (status: number, message: string) =>\n  new Response(JSON.stringify({ error: message }), { status, headers });\n\nconst queryPage = (value: string | null): number | undefined =>\n  value === null ? undefined : Number(value);\n\n/** Proxies a bounded Learning read through the runtime's server-held credential. */\nexport async function handleInspectorLearning({\n  runtime,\n  request,\n}: {\n  readonly runtime: CopilotRuntimeLike;\n  readonly request: Request;\n}): Promise<Response> {\n  if (\n    !isIntelligenceRuntime(runtime) ||\n    !hasLearningContainerConfiguration(runtime)\n  ) {\n    return errorResponse(404, \"Not found\");\n  }\n  const user = await resolveIntelligenceUser({ runtime, request });\n  if (user instanceof Response) return user;\n  const url = new URL(request.url);\n  if (\n    [...url.searchParams.keys()].some(\n      (key) => ![\"agentId\", \"skillsPage\", \"insightsPage\"].includes(key),\n    )\n  ) {\n    return errorResponse(400, \"Invalid Inspector Learning request\");\n  }\n  const parsedRequest = parseInspectorLearningRequestV1({\n    agentId: url.searchParams.get(\"agentId\") ?? undefined,\n    skillsPage: queryPage(url.searchParams.get(\"skillsPage\")),\n    insightsPage: queryPage(url.searchParams.get(\"insightsPage\")),\n  });\n  if (!parsedRequest)\n    return errorResponse(400, \"Invalid Inspector Learning request\");\n\n  try {\n    const snapshot = parseInspectorLearningSnapshotV1(\n      await runtime.intelligence.getInspectorLearning({\n        ...parsedRequest,\n        ...(typeof runtime.learning?.containerId === \"string\"\n          ? { runtimeContainerId: runtime.learning.containerId }\n          : {}),\n      }),\n    );\n    if (!snapshot)\n      return errorResponse(502, \"Invalid Inspector Learning response\");\n    return new Response(JSON.stringify(snapshot), { status: 200, headers });\n  } catch (error) {\n    if (error instanceof PlatformRequestError && error.status === 404) {\n      return errorResponse(404, \"Not found\");\n    }\n    return errorResponse(503, \"Inspector Learning is temporarily unavailable\");\n  }\n}\n"],"mappings":";;;;;;;;AAUA,MAAM,UAAU;CACd,iBAAiB;CACjB,gBAAgB;CACjB;AAED,MAAM,iBAAiB,QAAgB,YACrC,IAAI,SAAS,KAAK,UAAU,EAAE,OAAO,SAAS,CAAC,EAAE;CAAE;CAAQ;CAAS,CAAC;AAEvE,MAAM,aAAa,UACjB,UAAU,OAAO,SAAY,OAAO,MAAM;;AAG5C,eAAsB,wBAAwB,EAC5C,SACA,WAIoB;AACpB,KACE,CAACA,wCAAsB,QAAQ,IAC/B,CAACC,mDAAkC,QAAQ,CAE3C,QAAO,cAAc,KAAK,YAAY;CAExC,MAAM,OAAO,MAAMC,0DAAwB;EAAE;EAAS;EAAS,CAAC;AAChE,KAAI,gBAAgB,SAAU,QAAO;CACrC,MAAM,MAAM,IAAI,IAAI,QAAQ,IAAI;AAChC,KACE,CAAC,GAAG,IAAI,aAAa,MAAM,CAAC,CAAC,MAC1B,QAAQ,CAAC;EAAC;EAAW;EAAc;EAAe,CAAC,SAAS,IAAI,CAClE,CAED,QAAO,cAAc,KAAK,qCAAqC;CAEjE,MAAM,wEAAgD;EACpD,SAAS,IAAI,aAAa,IAAI,UAAU,IAAI;EAC5C,YAAY,UAAU,IAAI,aAAa,IAAI,aAAa,CAAC;EACzD,cAAc,UAAU,IAAI,aAAa,IAAI,eAAe,CAAC;EAC9D,CAAC;AACF,KAAI,CAAC,cACH,QAAO,cAAc,KAAK,qCAAqC;AAEjE,KAAI;EACF,MAAM,oEACJ,MAAM,QAAQ,aAAa,qBAAqB;GAC9C,GAAG;GACH,GAAI,OAAO,QAAQ,UAAU,gBAAgB,WACzC,EAAE,oBAAoB,QAAQ,SAAS,aAAa,GACpD,EAAE;GACP,CAAC,CACH;AACD,MAAI,CAAC,SACH,QAAO,cAAc,KAAK,sCAAsC;AAClE,SAAO,IAAI,SAAS,KAAK,UAAU,SAAS,EAAE;GAAE,QAAQ;GAAK;GAAS,CAAC;UAChE,OAAO;AACd,MAAI,iBAAiBC,uCAAwB,MAAM,WAAW,IAC5D,QAAO,cAAc,KAAK,YAAY;AAExC,SAAO,cAAc,KAAK,gDAAgD"}

package/dist/runtime/handlers/handle-inspector-learning.mjs

@@ -0,0 +1,55 @@
+import { hasLearningContainerConfiguration } from "../core/learning.mjs";
+import { PlatformRequestError } from "../intelligence-platform/client.mjs";
+import { resolveIntelligenceUser } from "./shared/resolve-intelligence-user.mjs";
+import { isIntelligenceRuntime } from "../core/runtime.mjs";
+import { parseInspectorLearningRequestV1, parseInspectorLearningSnapshotV1 } from "@copilotkit/shared";
+
+//#region src/runtime/handlers/handle-inspector-learning.ts
+const headers = {
+	"Cache-Control": "no-store, private",
+	"Content-Type": "application/json"
+};
+const errorResponse = (status, message) => new Response(JSON.stringify({ error: message }), {
+	status,
+	headers
+});
+const queryPage = (value) => value === null ? void 0 : Number(value);
+/** Proxies a bounded Learning read through the runtime's server-held credential. */
+async function handleInspectorLearning({ runtime, request }) {
+	if (!isIntelligenceRuntime(runtime) || !hasLearningContainerConfiguration(runtime)) return errorResponse(404, "Not found");
+	const user = await resolveIntelligenceUser({
+		runtime,
+		request
+	});
+	if (user instanceof Response) return user;
+	const url = new URL(request.url);
+	if ([...url.searchParams.keys()].some((key) => ![
+		"agentId",
+		"skillsPage",
+		"insightsPage"
+	].includes(key))) return errorResponse(400, "Invalid Inspector Learning request");
+	const parsedRequest = parseInspectorLearningRequestV1({
+		agentId: url.searchParams.get("agentId") ?? void 0,
+		skillsPage: queryPage(url.searchParams.get("skillsPage")),
+		insightsPage: queryPage(url.searchParams.get("insightsPage"))
+	});
+	if (!parsedRequest) return errorResponse(400, "Invalid Inspector Learning request");
+	try {
+		const snapshot = parseInspectorLearningSnapshotV1(await runtime.intelligence.getInspectorLearning({
+			...parsedRequest,
+			...typeof runtime.learning?.containerId === "string" ? { runtimeContainerId: runtime.learning.containerId } : {}
+		}));
+		if (!snapshot) return errorResponse(502, "Invalid Inspector Learning response");
+		return new Response(JSON.stringify(snapshot), {
+			status: 200,
+			headers
+		});
+	} catch (error) {
+		if (error instanceof PlatformRequestError && error.status === 404) return errorResponse(404, "Not found");
+		return errorResponse(503, "Inspector Learning is temporarily unavailable");
+	}
+}
+
+//#endregion
+export { handleInspectorLearning };
+//# sourceMappingURL=handle-inspector-learning.mjs.map

package/dist/runtime/handlers/handle-inspector-learning.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-inspector-learning.mjs","names":[],"sources":["../../../src/runtime/handlers/handle-inspector-learning.ts"],"sourcesContent":["import {\n  parseInspectorLearningRequestV1,\n  parseInspectorLearningSnapshotV1,\n} from \"@copilotkit/shared\";\nimport type { CopilotRuntimeLike } from \"../core/runtime\";\nimport { hasLearningContainerConfiguration } from \"../core/learning\";\nimport { isIntelligenceRuntime } from \"../core/runtime\";\nimport { PlatformRequestError } from \"../intelligence-platform/client\";\nimport { resolveIntelligenceUser } from \"./shared/resolve-intelligence-user\";\n\nconst headers = {\n  \"Cache-Control\": \"no-store, private\",\n  \"Content-Type\": \"application/json\",\n} as const;\n\nconst errorResponse = (status: number, message: string) =>\n  new Response(JSON.stringify({ error: message }), { status, headers });\n\nconst queryPage = (value: string | null): number | undefined =>\n  value === null ? undefined : Number(value);\n\n/** Proxies a bounded Learning read through the runtime's server-held credential. */\nexport async function handleInspectorLearning({\n  runtime,\n  request,\n}: {\n  readonly runtime: CopilotRuntimeLike;\n  readonly request: Request;\n}): Promise<Response> {\n  if (\n    !isIntelligenceRuntime(runtime) ||\n    !hasLearningContainerConfiguration(runtime)\n  ) {\n    return errorResponse(404, \"Not found\");\n  }\n  const user = await resolveIntelligenceUser({ runtime, request });\n  if (user instanceof Response) return user;\n  const url = new URL(request.url);\n  if (\n    [...url.searchParams.keys()].some(\n      (key) => ![\"agentId\", \"skillsPage\", \"insightsPage\"].includes(key),\n    )\n  ) {\n    return errorResponse(400, \"Invalid Inspector Learning request\");\n  }\n  const parsedRequest = parseInspectorLearningRequestV1({\n    agentId: url.searchParams.get(\"agentId\") ?? undefined,\n    skillsPage: queryPage(url.searchParams.get(\"skillsPage\")),\n    insightsPage: queryPage(url.searchParams.get(\"insightsPage\")),\n  });\n  if (!parsedRequest)\n    return errorResponse(400, \"Invalid Inspector Learning request\");\n\n  try {\n    const snapshot = parseInspectorLearningSnapshotV1(\n      await runtime.intelligence.getInspectorLearning({\n        ...parsedRequest,\n        ...(typeof runtime.learning?.containerId === \"string\"\n          ? { runtimeContainerId: runtime.learning.containerId }\n          : {}),\n      }),\n    );\n    if (!snapshot)\n      return errorResponse(502, \"Invalid Inspector Learning response\");\n    return new Response(JSON.stringify(snapshot), { status: 200, headers });\n  } catch (error) {\n    if (error instanceof PlatformRequestError && error.status === 404) {\n      return errorResponse(404, \"Not found\");\n    }\n    return errorResponse(503, \"Inspector Learning is temporarily unavailable\");\n  }\n}\n"],"mappings":";;;;;;;AAUA,MAAM,UAAU;CACd,iBAAiB;CACjB,gBAAgB;CACjB;AAED,MAAM,iBAAiB,QAAgB,YACrC,IAAI,SAAS,KAAK,UAAU,EAAE,OAAO,SAAS,CAAC,EAAE;CAAE;CAAQ;CAAS,CAAC;AAEvE,MAAM,aAAa,UACjB,UAAU,OAAO,SAAY,OAAO,MAAM;;AAG5C,eAAsB,wBAAwB,EAC5C,SACA,WAIoB;AACpB,KACE,CAAC,sBAAsB,QAAQ,IAC/B,CAAC,kCAAkC,QAAQ,CAE3C,QAAO,cAAc,KAAK,YAAY;CAExC,MAAM,OAAO,MAAM,wBAAwB;EAAE;EAAS;EAAS,CAAC;AAChE,KAAI,gBAAgB,SAAU,QAAO;CACrC,MAAM,MAAM,IAAI,IAAI,QAAQ,IAAI;AAChC,KACE,CAAC,GAAG,IAAI,aAAa,MAAM,CAAC,CAAC,MAC1B,QAAQ,CAAC;EAAC;EAAW;EAAc;EAAe,CAAC,SAAS,IAAI,CAClE,CAED,QAAO,cAAc,KAAK,qCAAqC;CAEjE,MAAM,gBAAgB,gCAAgC;EACpD,SAAS,IAAI,aAAa,IAAI,UAAU,IAAI;EAC5C,YAAY,UAAU,IAAI,aAAa,IAAI,aAAa,CAAC;EACzD,cAAc,UAAU,IAAI,aAAa,IAAI,eAAe,CAAC;EAC9D,CAAC;AACF,KAAI,CAAC,cACH,QAAO,cAAc,KAAK,qCAAqC;AAEjE,KAAI;EACF,MAAM,WAAW,iCACf,MAAM,QAAQ,aAAa,qBAAqB;GAC9C,GAAG;GACH,GAAI,OAAO,QAAQ,UAAU,gBAAgB,WACzC,EAAE,oBAAoB,QAAQ,SAAS,aAAa,GACpD,EAAE;GACP,CAAC,CACH;AACD,MAAI,CAAC,SACH,QAAO,cAAc,KAAK,sCAAsC;AAClE,SAAO,IAAI,SAAS,KAAK,UAAU,SAAS,EAAE;GAAE,QAAQ;GAAK;GAAS,CAAC;UAChE,OAAO;AACd,MAAI,iBAAiB,wBAAwB,MAAM,WAAW,IAC5D,QAAO,cAAc,KAAK,YAAY;AAExC,SAAO,cAAc,KAAK,gDAAgD"}

package/dist/runtime/handlers/handle-inspector-metadata.cjs

@@ -0,0 +1,36 @@
+const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
+const require_runtime$1 = require('../core/runtime.cjs');
+let _copilotkit_shared = require("@copilotkit/shared");
+
+//#region src/runtime/handlers/handle-inspector-metadata.ts
+const PRIVATE_NO_STORE_HEADERS = { "Cache-Control": "no-store, private" };
+function emptyInspectorMetadataResponse() {
+	return new Response(null, {
+		status: 204,
+		headers: PRIVATE_NO_STORE_HEADERS
+	});
+}
+/**
+* Returns trusted, sanitized Inspector metadata without exposing provider
+* failures or forwarding any browser request credentials to Intelligence.
+*/
+async function handleInspectorMetadata({ runtime }) {
+	if (!require_runtime$1.isIntelligenceRuntime(runtime)) return emptyInspectorMetadataResponse();
+	try {
+		const metadata = (0, _copilotkit_shared.parseInspectorMetadataV1)(await runtime.intelligence.getInspectorMetadata());
+		if (metadata === void 0) return emptyInspectorMetadataResponse();
+		return new Response(JSON.stringify(metadata), {
+			status: 200,
+			headers: {
+				...PRIVATE_NO_STORE_HEADERS,
+				"Content-Type": "application/json"
+			}
+		});
+	} catch {
+		return emptyInspectorMetadataResponse();
+	}
+}
+
+//#endregion
+exports.handleInspectorMetadata = handleInspectorMetadata;
+//# sourceMappingURL=handle-inspector-metadata.cjs.map

package/dist/runtime/handlers/handle-inspector-metadata.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-inspector-metadata.cjs","names":["isIntelligenceRuntime"],"sources":["../../../src/runtime/handlers/handle-inspector-metadata.ts"],"sourcesContent":["import { parseInspectorMetadataV1 } from \"@copilotkit/shared\";\nimport type { CopilotRuntimeLike } from \"../core/runtime\";\nimport { isIntelligenceRuntime } from \"../core/runtime\";\n\nconst PRIVATE_NO_STORE_HEADERS = {\n  \"Cache-Control\": \"no-store, private\",\n} as const;\n\ninterface HandleInspectorMetadataParameters {\n  runtime: CopilotRuntimeLike;\n  request: Request;\n}\n\nfunction emptyInspectorMetadataResponse(): Response {\n  return new Response(null, {\n    status: 204,\n    headers: PRIVATE_NO_STORE_HEADERS,\n  });\n}\n\n/**\n * Returns trusted, sanitized Inspector metadata without exposing provider\n * failures or forwarding any browser request credentials to Intelligence.\n */\nexport async function handleInspectorMetadata({\n  runtime,\n}: HandleInspectorMetadataParameters): Promise<Response> {\n  if (!isIntelligenceRuntime(runtime)) {\n    return emptyInspectorMetadataResponse();\n  }\n\n  try {\n    const metadata = parseInspectorMetadataV1(\n      await runtime.intelligence.getInspectorMetadata(),\n    );\n    if (metadata === undefined) {\n      return emptyInspectorMetadataResponse();\n    }\n\n    return new Response(JSON.stringify(metadata), {\n      status: 200,\n      headers: {\n        ...PRIVATE_NO_STORE_HEADERS,\n        \"Content-Type\": \"application/json\",\n      },\n    });\n  } catch {\n    return emptyInspectorMetadataResponse();\n  }\n}\n"],"mappings":";;;;;AAIA,MAAM,2BAA2B,EAC/B,iBAAiB,qBAClB;AAOD,SAAS,iCAA2C;AAClD,QAAO,IAAI,SAAS,MAAM;EACxB,QAAQ;EACR,SAAS;EACV,CAAC;;;;;;AAOJ,eAAsB,wBAAwB,EAC5C,WACuD;AACvD,KAAI,CAACA,wCAAsB,QAAQ,CACjC,QAAO,gCAAgC;AAGzC,KAAI;EACF,MAAM,4DACJ,MAAM,QAAQ,aAAa,sBAAsB,CAClD;AACD,MAAI,aAAa,OACf,QAAO,gCAAgC;AAGzC,SAAO,IAAI,SAAS,KAAK,UAAU,SAAS,EAAE;GAC5C,QAAQ;GACR,SAAS;IACP,GAAG;IACH,gBAAgB;IACjB;GACF,CAAC;SACI;AACN,SAAO,gCAAgC"}

package/dist/runtime/handlers/handle-inspector-metadata.mjs

@@ -0,0 +1,35 @@
+import { isIntelligenceRuntime } from "../core/runtime.mjs";
+import { parseInspectorMetadataV1 } from "@copilotkit/shared";
+
+//#region src/runtime/handlers/handle-inspector-metadata.ts
+const PRIVATE_NO_STORE_HEADERS = { "Cache-Control": "no-store, private" };
+function emptyInspectorMetadataResponse() {
+	return new Response(null, {
+		status: 204,
+		headers: PRIVATE_NO_STORE_HEADERS
+	});
+}
+/**
+* Returns trusted, sanitized Inspector metadata without exposing provider
+* failures or forwarding any browser request credentials to Intelligence.
+*/
+async function handleInspectorMetadata({ runtime }) {
+	if (!isIntelligenceRuntime(runtime)) return emptyInspectorMetadataResponse();
+	try {
+		const metadata = parseInspectorMetadataV1(await runtime.intelligence.getInspectorMetadata());
+		if (metadata === void 0) return emptyInspectorMetadataResponse();
+		return new Response(JSON.stringify(metadata), {
+			status: 200,
+			headers: {
+				...PRIVATE_NO_STORE_HEADERS,
+				"Content-Type": "application/json"
+			}
+		});
+	} catch {
+		return emptyInspectorMetadataResponse();
+	}
+}
+
+//#endregion
+export { handleInspectorMetadata };
+//# sourceMappingURL=handle-inspector-metadata.mjs.map

package/dist/runtime/handlers/handle-inspector-metadata.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-inspector-metadata.mjs","names":[],"sources":["../../../src/runtime/handlers/handle-inspector-metadata.ts"],"sourcesContent":["import { parseInspectorMetadataV1 } from \"@copilotkit/shared\";\nimport type { CopilotRuntimeLike } from \"../core/runtime\";\nimport { isIntelligenceRuntime } from \"../core/runtime\";\n\nconst PRIVATE_NO_STORE_HEADERS = {\n  \"Cache-Control\": \"no-store, private\",\n} as const;\n\ninterface HandleInspectorMetadataParameters {\n  runtime: CopilotRuntimeLike;\n  request: Request;\n}\n\nfunction emptyInspectorMetadataResponse(): Response {\n  return new Response(null, {\n    status: 204,\n    headers: PRIVATE_NO_STORE_HEADERS,\n  });\n}\n\n/**\n * Returns trusted, sanitized Inspector metadata without exposing provider\n * failures or forwarding any browser request credentials to Intelligence.\n */\nexport async function handleInspectorMetadata({\n  runtime,\n}: HandleInspectorMetadataParameters): Promise<Response> {\n  if (!isIntelligenceRuntime(runtime)) {\n    return emptyInspectorMetadataResponse();\n  }\n\n  try {\n    const metadata = parseInspectorMetadataV1(\n      await runtime.intelligence.getInspectorMetadata(),\n    );\n    if (metadata === undefined) {\n      return emptyInspectorMetadataResponse();\n    }\n\n    return new Response(JSON.stringify(metadata), {\n      status: 200,\n      headers: {\n        ...PRIVATE_NO_STORE_HEADERS,\n        \"Content-Type\": \"application/json\",\n      },\n    });\n  } catch {\n    return emptyInspectorMetadataResponse();\n  }\n}\n"],"mappings":";;;;AAIA,MAAM,2BAA2B,EAC/B,iBAAiB,qBAClB;AAOD,SAAS,iCAA2C;AAClD,QAAO,IAAI,SAAS,MAAM;EACxB,QAAQ;EACR,SAAS;EACV,CAAC;;;;;;AAOJ,eAAsB,wBAAwB,EAC5C,WACuD;AACvD,KAAI,CAAC,sBAAsB,QAAQ,CACjC,QAAO,gCAAgC;AAGzC,KAAI;EACF,MAAM,WAAW,yBACf,MAAM,QAAQ,aAAa,sBAAsB,CAClD;AACD,MAAI,aAAa,OACf,QAAO,gCAAgC;AAGzC,SAAO,IAAI,SAAS,KAAK,UAAU,SAAS,EAAE;GAC5C,QAAQ;GACR,SAAS;IACP,GAAG;IACH,gBAAgB;IACjB;GACF,CAAC;SACI;AACN,SAAO,gCAAgC"}

package/dist/runtime/handlers/handle-run.cjs

@@ -0,0 +1,111 @@
+const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
+const require_agent_runner = require('../runner/agent-runner.cjs');
+const require_thread_access = require('./shared/thread-access.cjs');
+const require_telemetry_client = require('../telemetry/telemetry-client.cjs');
+const require_runtime_error_reporter = require('../core/runtime-error-reporter.cjs');
+const require_runtime$1 = require('../core/runtime.cjs');
+const require_cloud_telemetry = require('./shared/cloud-telemetry.cjs');
+const require_agent_utils = require('./shared/agent-utils.cjs');
+const require_run = require('./intelligence/run.cjs');
+const require_run$1 = require('./sse/run.cjs');
+let _copilotkit_shared = require("@copilotkit/shared");
+
+//#region src/runtime/handlers/handle-run.ts
+async function handleRunAgent({ runtime, request, agentId }) {
+	const startTime = Date.now();
+	const publicApiKey = request.headers.get("x-copilotcloud-public-api-key");
+	(runtime.telemetry ?? require_telemetry_client.default).capture("oss.runtime.copilot_request_created", {
+		"cloud.guardrails.enabled": await require_cloud_telemetry.readGuardrailsEnabled(request),
+		requestType: "run",
+		"cloud.api_key_provided": !!publicApiKey,
+		...publicApiKey ? { "cloud.public_api_key": publicApiKey } : {}
+	});
+	try {
+		const agent = await require_agent_utils.cloneAgentForRequest(runtime, agentId, request);
+		if (agent instanceof Response) return agent;
+		agent.agentId = agentId;
+		const input = await require_agent_utils.parseRunRequest(request.clone());
+		if (input instanceof Response) return input;
+		let ownerId;
+		if (!require_runtime$1.isIntelligenceRuntime(runtime)) {
+			const owner = await require_thread_access.resolveLocalThreadOwner({
+				runtime,
+				request,
+				operation: "run"
+			});
+			if (owner instanceof Response) return owner;
+			if (require_agent_runner.enforcesThreadOwnership(runtime.runner) && !await runtime.runner.isThreadAccessible(input.threadId, { ownerId: owner })) return require_thread_access.threadAccessDeniedResponse();
+			ownerId = owner;
+		}
+		const providerA2UIHasCatalog = input.forwardedProps?.a2uiCatalogAvailable === true;
+		const providerGenerativeUITransport = (0, _copilotkit_shared.readCopilotKitUIEnvelope)(input.forwardedProps)?.metadata.extensions.copilotkit_transport;
+		require_agent_utils.configureAgentForRequest({
+			runtime,
+			request,
+			agentId,
+			agent,
+			providerA2UIHasCatalog,
+			providerGenerativeUITransport,
+			isMcpProxyRequest: Object.prototype.hasOwnProperty.call(input.forwardedProps ?? {}, "__proxiedMCPRequest")
+		});
+		const memoryResponse = await require_agent_utils.attachIntelligenceEnterpriseLearning({
+			runtime,
+			request,
+			agent
+		});
+		if (memoryResponse instanceof Response) return memoryResponse;
+		agent.setMessages(input.messages);
+		agent.setState(input.state);
+		agent.threadId = input.threadId;
+		if (runtime.debug?.lifecycle && runtime.debugLogger) runtime.debugLogger.debug({
+			agentName: agentId,
+			threadId: input.threadId
+		}, "Agent run started");
+		if (require_runtime$1.isIntelligenceRuntime(runtime)) return require_run.handleIntelligenceRun({
+			runtime,
+			request,
+			agentId,
+			agent,
+			input,
+			startTime
+		});
+		return require_run$1.handleSseRun({
+			runtime,
+			request,
+			agent,
+			input,
+			agentId,
+			debug: runtime.debug,
+			logger: runtime.debugLogger,
+			startTime,
+			ownerId
+		});
+	} catch (error) {
+		require_runtime_error_reporter.getRuntimeErrorReporter(runtime)?.report({
+			request,
+			error,
+			operation: "agent.run",
+			agentId,
+			phase: "common",
+			startTime
+		});
+		console.error("Error running agent:", error);
+		console.error("Error stack:", error instanceof Error ? error.stack : "No stack trace");
+		console.error("Error details:", {
+			name: error instanceof Error ? error.name : "Unknown",
+			message: error instanceof Error ? error.message : String(error),
+			cause: error instanceof Error ? error.cause : void 0
+		});
+		return new Response(JSON.stringify({
+			error: "Failed to run agent",
+			message: error instanceof Error ? error.message : "Unknown error"
+		}), {
+			status: 500,
+			headers: { "Content-Type": "application/json" }
+		});
+	}
+}
+
+//#endregion
+exports.handleRunAgent = handleRunAgent;
+//# sourceMappingURL=handle-run.cjs.map

package/dist/runtime/handlers/handle-run.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-run.cjs","names":["telemetry","readGuardrailsEnabled","cloneAgentForRequest","parseRunRequest","isIntelligenceRuntime","resolveLocalThreadOwner","enforcesThreadOwnership","threadAccessDeniedResponse","attachIntelligenceEnterpriseLearning","handleIntelligenceRun","handleSseRun"],"sources":["../../../src/runtime/handlers/handle-run.ts"],"sourcesContent":["import { readCopilotKitUIEnvelope } from \"@copilotkit/shared\";\nimport { isIntelligenceRuntime } from \"../core/runtime\";\nimport { telemetry } from \"../telemetry\";\nimport { readGuardrailsEnabled } from \"./shared/cloud-telemetry\";\nimport type { RunAgentParameters } from \"./shared/agent-utils\";\nimport {\n  attachIntelligenceEnterpriseLearning,\n  cloneAgentForRequest,\n  configureAgentForRequest,\n  parseRunRequest,\n} from \"./shared/agent-utils\";\nimport { handleIntelligenceRun } from \"./intelligence/run\";\nimport { handleSseRun } from \"./sse/run\";\nimport { getRuntimeErrorReporter } from \"../core/runtime-error-reporter\";\nimport { enforcesThreadOwnership } from \"../runner/agent-runner\";\nimport {\n  resolveLocalThreadOwner,\n  threadAccessDeniedResponse,\n} from \"./shared/thread-access\";\n\nexport async function handleRunAgent({\n  runtime,\n  request,\n  agentId,\n}: RunAgentParameters) {\n  const startTime = Date.now();\n  const publicApiKey = request.headers.get(\"x-copilotcloud-public-api-key\");\n  (runtime.telemetry ?? telemetry).capture(\n    \"oss.runtime.copilot_request_created\",\n    {\n      \"cloud.guardrails.enabled\": await readGuardrailsEnabled(request),\n      requestType: \"run\",\n      \"cloud.api_key_provided\": !!publicApiKey,\n      ...(publicApiKey ? { \"cloud.public_api_key\": publicApiKey } : {}),\n    },\n  );\n\n  try {\n    const agent = await cloneAgentForRequest(runtime, agentId, request);\n    if (agent instanceof Response) {\n      return agent;\n    }\n\n    // Ensure the clone carries the registry key so InMemoryAgentRunner can\n    // tag historic runs with the correct agentId for filtering.\n    agent.agentId = agentId;\n\n    // Parse the body before configuring middleware: middleware configuration\n    // needs the A2UI catalog signal the React provider forwards (see\n    // `a2uiCatalogAvailable` below). Middleware is applied to the agent here;\n    // the run itself is kicked off later, so this is safe. The body is read\n    // from a clone, so `identifyUser` can still read the original request.\n    const input = await parseRunRequest(request.clone());\n    if (input instanceof Response) {\n      return input;\n    }\n\n    // A thread belongs to the identity of its first run. Running needs no\n    // configured identity (anonymous runs keep working), but nobody may add to\n    // a thread that another identity owns.\n    let ownerId: string | undefined;\n    if (!isIntelligenceRuntime(runtime)) {\n      const owner = await resolveLocalThreadOwner({\n        runtime,\n        request,\n        operation: \"run\",\n      });\n      if (owner instanceof Response) return owner;\n      if (\n        enforcesThreadOwnership(runtime.runner) &&\n        !(await runtime.runner.isThreadAccessible(input.threadId, {\n          ownerId: owner,\n        }))\n      ) {\n        return threadAccessDeniedResponse();\n      }\n      ownerId = owner;\n    }\n\n    // `<CopilotKit a2ui={{ catalog }}>` forwards this flag on every run. Its\n    // presence alone is enough to turn A2UI on end-to-end — no runtime-side\n    // `a2ui` config required.\n    const providerA2UIHasCatalog =\n      (input.forwardedProps as Record<string, unknown> | undefined)\n        ?.a2uiCatalogAvailable === true;\n    // The generative UI envelope (`forwardedProps.copilotkit.ui`) picks the\n    // transport of this run.\n    const providerGenerativeUITransport = readCopilotKitUIEnvelope(\n      input.forwardedProps,\n    )?.metadata.extensions.copilotkit_transport;\n\n    configureAgentForRequest({\n      runtime,\n      request,\n      agentId,\n      agent,\n      providerA2UIHasCatalog,\n      providerGenerativeUITransport,\n      isMcpProxyRequest: Object.prototype.hasOwnProperty.call(\n        input.forwardedProps ?? {},\n        \"__proxiedMCPRequest\",\n      ),\n    });\n    const memoryResponse = await attachIntelligenceEnterpriseLearning({\n      runtime,\n      request,\n      agent,\n    });\n    if (memoryResponse instanceof Response) return memoryResponse;\n\n    agent.setMessages(input.messages);\n    agent.setState(input.state);\n    agent.threadId = input.threadId;\n\n    if (runtime.debug?.lifecycle && runtime.debugLogger) {\n      runtime.debugLogger.debug(\n        { agentName: agentId, threadId: input.threadId },\n        \"Agent run started\",\n      );\n    }\n\n    if (isIntelligenceRuntime(runtime)) {\n      return handleIntelligenceRun({\n        runtime,\n        request,\n        agentId,\n        agent,\n        input,\n        startTime,\n      });\n    }\n\n    return handleSseRun({\n      runtime,\n      request,\n      agent,\n      input,\n      agentId,\n      debug: runtime.debug,\n      logger: runtime.debugLogger,\n      startTime,\n      ownerId,\n    });\n  } catch (error) {\n    getRuntimeErrorReporter(runtime)?.report({\n      request,\n      error,\n      operation: \"agent.run\",\n      agentId,\n      phase: \"common\",\n      startTime,\n    });\n    console.error(\"Error running agent:\", error);\n    console.error(\n      \"Error stack:\",\n      error instanceof Error ? error.stack : \"No stack trace\",\n    );\n    console.error(\"Error details:\", {\n      name: error instanceof Error ? error.name : \"Unknown\",\n      message: error instanceof Error ? error.message : String(error),\n      cause: error instanceof Error ? error.cause : undefined,\n    });\n\n    return new Response(\n      JSON.stringify({\n        error: \"Failed to run agent\",\n        message: error instanceof Error ? error.message : \"Unknown error\",\n      }),\n      {\n        status: 500,\n        headers: { \"Content-Type\": \"application/json\" },\n      },\n    );\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAoBA,eAAsB,eAAe,EACnC,SACA,SACA,WACqB;CACrB,MAAM,YAAY,KAAK,KAAK;CAC5B,MAAM,eAAe,QAAQ,QAAQ,IAAI,gCAAgC;AACzE,EAAC,QAAQ,aAAaA,kCAAW,QAC/B,uCACA;EACE,4BAA4B,MAAMC,8CAAsB,QAAQ;EAChE,aAAa;EACb,0BAA0B,CAAC,CAAC;EAC5B,GAAI,eAAe,EAAE,wBAAwB,cAAc,GAAG,EAAE;EACjE,CACF;AAED,KAAI;EACF,MAAM,QAAQ,MAAMC,yCAAqB,SAAS,SAAS,QAAQ;AACnE,MAAI,iBAAiB,SACnB,QAAO;AAKT,QAAM,UAAU;EAOhB,MAAM,QAAQ,MAAMC,oCAAgB,QAAQ,OAAO,CAAC;AACpD,MAAI,iBAAiB,SACnB,QAAO;EAMT,IAAI;AACJ,MAAI,CAACC,wCAAsB,QAAQ,EAAE;GACnC,MAAM,QAAQ,MAAMC,8CAAwB;IAC1C;IACA;IACA,WAAW;IACZ,CAAC;AACF,OAAI,iBAAiB,SAAU,QAAO;AACtC,OACEC,6CAAwB,QAAQ,OAAO,IACvC,CAAE,MAAM,QAAQ,OAAO,mBAAmB,MAAM,UAAU,EACxD,SAAS,OACV,CAAC,CAEF,QAAOC,kDAA4B;AAErC,aAAU;;EAMZ,MAAM,yBACH,MAAM,gBACH,yBAAyB;EAG/B,MAAM,iFACJ,MAAM,eACP,EAAE,SAAS,WAAW;AAEvB,+CAAyB;GACvB;GACA;GACA;GACA;GACA;GACA;GACA,mBAAmB,OAAO,UAAU,eAAe,KACjD,MAAM,kBAAkB,EAAE,EAC1B,sBACD;GACF,CAAC;EACF,MAAM,iBAAiB,MAAMC,yDAAqC;GAChE;GACA;GACA;GACD,CAAC;AACF,MAAI,0BAA0B,SAAU,QAAO;AAE/C,QAAM,YAAY,MAAM,SAAS;AACjC,QAAM,SAAS,MAAM,MAAM;AAC3B,QAAM,WAAW,MAAM;AAEvB,MAAI,QAAQ,OAAO,aAAa,QAAQ,YACtC,SAAQ,YAAY,MAClB;GAAE,WAAW;GAAS,UAAU,MAAM;GAAU,EAChD,oBACD;AAGH,MAAIJ,wCAAsB,QAAQ,CAChC,QAAOK,kCAAsB;GAC3B;GACA;GACA;GACA;GACA;GACA;GACD,CAAC;AAGJ,SAAOC,2BAAa;GAClB;GACA;GACA;GACA;GACA;GACA,OAAO,QAAQ;GACf,QAAQ,QAAQ;GAChB;GACA;GACD,CAAC;UACK,OAAO;AACd,yDAAwB,QAAQ,EAAE,OAAO;GACvC;GACA;GACA,WAAW;GACX;GACA,OAAO;GACP;GACD,CAAC;AACF,UAAQ,MAAM,wBAAwB,MAAM;AAC5C,UAAQ,MACN,gBACA,iBAAiB,QAAQ,MAAM,QAAQ,iBACxC;AACD,UAAQ,MAAM,kBAAkB;GAC9B,MAAM,iBAAiB,QAAQ,MAAM,OAAO;GAC5C,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;GAC/D,OAAO,iBAAiB,QAAQ,MAAM,QAAQ;GAC/C,CAAC;AAEF,SAAO,IAAI,SACT,KAAK,UAAU;GACb,OAAO;GACP,SAAS,iBAAiB,QAAQ,MAAM,UAAU;GACnD,CAAC,EACF;GACE,QAAQ;GACR,SAAS,EAAE,gBAAgB,oBAAoB;GAChD,CACF"}

package/dist/runtime/handlers/handle-run.mjs

@@ -0,0 +1,110 @@
+import { enforcesThreadOwnership } from "../runner/agent-runner.mjs";
+import { resolveLocalThreadOwner, threadAccessDeniedResponse } from "./shared/thread-access.mjs";
+import telemetry from "../telemetry/telemetry-client.mjs";
+import { getRuntimeErrorReporter } from "../core/runtime-error-reporter.mjs";
+import { isIntelligenceRuntime } from "../core/runtime.mjs";
+import { readGuardrailsEnabled } from "./shared/cloud-telemetry.mjs";
+import { attachIntelligenceEnterpriseLearning, cloneAgentForRequest, configureAgentForRequest, parseRunRequest } from "./shared/agent-utils.mjs";
+import { handleIntelligenceRun } from "./intelligence/run.mjs";
+import { handleSseRun } from "./sse/run.mjs";
+import { readCopilotKitUIEnvelope } from "@copilotkit/shared";
+
+//#region src/runtime/handlers/handle-run.ts
+async function handleRunAgent({ runtime, request, agentId }) {
+	const startTime = Date.now();
+	const publicApiKey = request.headers.get("x-copilotcloud-public-api-key");
+	(runtime.telemetry ?? telemetry).capture("oss.runtime.copilot_request_created", {
+		"cloud.guardrails.enabled": await readGuardrailsEnabled(request),
+		requestType: "run",
+		"cloud.api_key_provided": !!publicApiKey,
+		...publicApiKey ? { "cloud.public_api_key": publicApiKey } : {}
+	});
+	try {
+		const agent = await cloneAgentForRequest(runtime, agentId, request);
+		if (agent instanceof Response) return agent;
+		agent.agentId = agentId;
+		const input = await parseRunRequest(request.clone());
+		if (input instanceof Response) return input;
+		let ownerId;
+		if (!isIntelligenceRuntime(runtime)) {
+			const owner = await resolveLocalThreadOwner({
+				runtime,
+				request,
+				operation: "run"
+			});
+			if (owner instanceof Response) return owner;
+			if (enforcesThreadOwnership(runtime.runner) && !await runtime.runner.isThreadAccessible(input.threadId, { ownerId: owner })) return threadAccessDeniedResponse();
+			ownerId = owner;
+		}
+		const providerA2UIHasCatalog = input.forwardedProps?.a2uiCatalogAvailable === true;
+		const providerGenerativeUITransport = readCopilotKitUIEnvelope(input.forwardedProps)?.metadata.extensions.copilotkit_transport;
+		configureAgentForRequest({
+			runtime,
+			request,
+			agentId,
+			agent,
+			providerA2UIHasCatalog,
+			providerGenerativeUITransport,
+			isMcpProxyRequest: Object.prototype.hasOwnProperty.call(input.forwardedProps ?? {}, "__proxiedMCPRequest")
+		});
+		const memoryResponse = await attachIntelligenceEnterpriseLearning({
+			runtime,
+			request,
+			agent
+		});
+		if (memoryResponse instanceof Response) return memoryResponse;
+		agent.setMessages(input.messages);
+		agent.setState(input.state);
+		agent.threadId = input.threadId;
+		if (runtime.debug?.lifecycle && runtime.debugLogger) runtime.debugLogger.debug({
+			agentName: agentId,
+			threadId: input.threadId
+		}, "Agent run started");
+		if (isIntelligenceRuntime(runtime)) return handleIntelligenceRun({
+			runtime,
+			request,
+			agentId,
+			agent,
+			input,
+			startTime
+		});
+		return handleSseRun({
+			runtime,
+			request,
+			agent,
+			input,
+			agentId,
+			debug: runtime.debug,
+			logger: runtime.debugLogger,
+			startTime,
+			ownerId
+		});
+	} catch (error) {
+		getRuntimeErrorReporter(runtime)?.report({
+			request,
+			error,
+			operation: "agent.run",
+			agentId,
+			phase: "common",
+			startTime
+		});
+		console.error("Error running agent:", error);
+		console.error("Error stack:", error instanceof Error ? error.stack : "No stack trace");
+		console.error("Error details:", {
+			name: error instanceof Error ? error.name : "Unknown",
+			message: error instanceof Error ? error.message : String(error),
+			cause: error instanceof Error ? error.cause : void 0
+		});
+		return new Response(JSON.stringify({
+			error: "Failed to run agent",
+			message: error instanceof Error ? error.message : "Unknown error"
+		}), {
+			status: 500,
+			headers: { "Content-Type": "application/json" }
+		});
+	}
+}
+
+//#endregion
+export { handleRunAgent };
+//# sourceMappingURL=handle-run.mjs.map

package/dist/runtime/handlers/handle-run.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-run.mjs","names":[],"sources":["../../../src/runtime/handlers/handle-run.ts"],"sourcesContent":["import { readCopilotKitUIEnvelope } from \"@copilotkit/shared\";\nimport { isIntelligenceRuntime } from \"../core/runtime\";\nimport { telemetry } from \"../telemetry\";\nimport { readGuardrailsEnabled } from \"./shared/cloud-telemetry\";\nimport type { RunAgentParameters } from \"./shared/agent-utils\";\nimport {\n  attachIntelligenceEnterpriseLearning,\n  cloneAgentForRequest,\n  configureAgentForRequest,\n  parseRunRequest,\n} from \"./shared/agent-utils\";\nimport { handleIntelligenceRun } from \"./intelligence/run\";\nimport { handleSseRun } from \"./sse/run\";\nimport { getRuntimeErrorReporter } from \"../core/runtime-error-reporter\";\nimport { enforcesThreadOwnership } from \"../runner/agent-runner\";\nimport {\n  resolveLocalThreadOwner,\n  threadAccessDeniedResponse,\n} from \"./shared/thread-access\";\n\nexport async function handleRunAgent({\n  runtime,\n  request,\n  agentId,\n}: RunAgentParameters) {\n  const startTime = Date.now();\n  const publicApiKey = request.headers.get(\"x-copilotcloud-public-api-key\");\n  (runtime.telemetry ?? telemetry).capture(\n    \"oss.runtime.copilot_request_created\",\n    {\n      \"cloud.guardrails.enabled\": await readGuardrailsEnabled(request),\n      requestType: \"run\",\n      \"cloud.api_key_provided\": !!publicApiKey,\n      ...(publicApiKey ? { \"cloud.public_api_key\": publicApiKey } : {}),\n    },\n  );\n\n  try {\n    const agent = await cloneAgentForRequest(runtime, agentId, request);\n    if (agent instanceof Response) {\n      return agent;\n    }\n\n    // Ensure the clone carries the registry key so InMemoryAgentRunner can\n    // tag historic runs with the correct agentId for filtering.\n    agent.agentId = agentId;\n\n    // Parse the body before configuring middleware: middleware configuration\n    // needs the A2UI catalog signal the React provider forwards (see\n    // `a2uiCatalogAvailable` below). Middleware is applied to the agent here;\n    // the run itself is kicked off later, so this is safe. The body is read\n    // from a clone, so `identifyUser` can still read the original request.\n    const input = await parseRunRequest(request.clone());\n    if (input instanceof Response) {\n      return input;\n    }\n\n    // A thread belongs to the identity of its first run. Running needs no\n    // configured identity (anonymous runs keep working), but nobody may add to\n    // a thread that another identity owns.\n    let ownerId: string | undefined;\n    if (!isIntelligenceRuntime(runtime)) {\n      const owner = await resolveLocalThreadOwner({\n        runtime,\n        request,\n        operation: \"run\",\n      });\n      if (owner instanceof Response) return owner;\n      if (\n        enforcesThreadOwnership(runtime.runner) &&\n        !(await runtime.runner.isThreadAccessible(input.threadId, {\n          ownerId: owner,\n        }))\n      ) {\n        return threadAccessDeniedResponse();\n      }\n      ownerId = owner;\n    }\n\n    // `<CopilotKit a2ui={{ catalog }}>` forwards this flag on every run. Its\n    // presence alone is enough to turn A2UI on end-to-end — no runtime-side\n    // `a2ui` config required.\n    const providerA2UIHasCatalog =\n      (input.forwardedProps as Record<string, unknown> | undefined)\n        ?.a2uiCatalogAvailable === true;\n    // The generative UI envelope (`forwardedProps.copilotkit.ui`) picks the\n    // transport of this run.\n    const providerGenerativeUITransport = readCopilotKitUIEnvelope(\n      input.forwardedProps,\n    )?.metadata.extensions.copilotkit_transport;\n\n    configureAgentForRequest({\n      runtime,\n      request,\n      agentId,\n      agent,\n      providerA2UIHasCatalog,\n      providerGenerativeUITransport,\n      isMcpProxyRequest: Object.prototype.hasOwnProperty.call(\n        input.forwardedProps ?? {},\n        \"__proxiedMCPRequest\",\n      ),\n    });\n    const memoryResponse = await attachIntelligenceEnterpriseLearning({\n      runtime,\n      request,\n      agent,\n    });\n    if (memoryResponse instanceof Response) return memoryResponse;\n\n    agent.setMessages(input.messages);\n    agent.setState(input.state);\n    agent.threadId = input.threadId;\n\n    if (runtime.debug?.lifecycle && runtime.debugLogger) {\n      runtime.debugLogger.debug(\n        { agentName: agentId, threadId: input.threadId },\n        \"Agent run started\",\n      );\n    }\n\n    if (isIntelligenceRuntime(runtime)) {\n      return handleIntelligenceRun({\n        runtime,\n        request,\n        agentId,\n        agent,\n        input,\n        startTime,\n      });\n    }\n\n    return handleSseRun({\n      runtime,\n      request,\n      agent,\n      input,\n      agentId,\n      debug: runtime.debug,\n      logger: runtime.debugLogger,\n      startTime,\n      ownerId,\n    });\n  } catch (error) {\n    getRuntimeErrorReporter(runtime)?.report({\n      request,\n      error,\n      operation: \"agent.run\",\n      agentId,\n      phase: \"common\",\n      startTime,\n    });\n    console.error(\"Error running agent:\", error);\n    console.error(\n      \"Error stack:\",\n      error instanceof Error ? error.stack : \"No stack trace\",\n    );\n    console.error(\"Error details:\", {\n      name: error instanceof Error ? error.name : \"Unknown\",\n      message: error instanceof Error ? error.message : String(error),\n      cause: error instanceof Error ? error.cause : undefined,\n    });\n\n    return new Response(\n      JSON.stringify({\n        error: \"Failed to run agent\",\n        message: error instanceof Error ? error.message : \"Unknown error\",\n      }),\n      {\n        status: 500,\n        headers: { \"Content-Type\": \"application/json\" },\n      },\n    );\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAoBA,eAAsB,eAAe,EACnC,SACA,SACA,WACqB;CACrB,MAAM,YAAY,KAAK,KAAK;CAC5B,MAAM,eAAe,QAAQ,QAAQ,IAAI,gCAAgC;AACzE,EAAC,QAAQ,aAAa,WAAW,QAC/B,uCACA;EACE,4BAA4B,MAAM,sBAAsB,QAAQ;EAChE,aAAa;EACb,0BAA0B,CAAC,CAAC;EAC5B,GAAI,eAAe,EAAE,wBAAwB,cAAc,GAAG,EAAE;EACjE,CACF;AAED,KAAI;EACF,MAAM,QAAQ,MAAM,qBAAqB,SAAS,SAAS,QAAQ;AACnE,MAAI,iBAAiB,SACnB,QAAO;AAKT,QAAM,UAAU;EAOhB,MAAM,QAAQ,MAAM,gBAAgB,QAAQ,OAAO,CAAC;AACpD,MAAI,iBAAiB,SACnB,QAAO;EAMT,IAAI;AACJ,MAAI,CAAC,sBAAsB,QAAQ,EAAE;GACnC,MAAM,QAAQ,MAAM,wBAAwB;IAC1C;IACA;IACA,WAAW;IACZ,CAAC;AACF,OAAI,iBAAiB,SAAU,QAAO;AACtC,OACE,wBAAwB,QAAQ,OAAO,IACvC,CAAE,MAAM,QAAQ,OAAO,mBAAmB,MAAM,UAAU,EACxD,SAAS,OACV,CAAC,CAEF,QAAO,4BAA4B;AAErC,aAAU;;EAMZ,MAAM,yBACH,MAAM,gBACH,yBAAyB;EAG/B,MAAM,gCAAgC,yBACpC,MAAM,eACP,EAAE,SAAS,WAAW;AAEvB,2BAAyB;GACvB;GACA;GACA;GACA;GACA;GACA;GACA,mBAAmB,OAAO,UAAU,eAAe,KACjD,MAAM,kBAAkB,EAAE,EAC1B,sBACD;GACF,CAAC;EACF,MAAM,iBAAiB,MAAM,qCAAqC;GAChE;GACA;GACA;GACD,CAAC;AACF,MAAI,0BAA0B,SAAU,QAAO;AAE/C,QAAM,YAAY,MAAM,SAAS;AACjC,QAAM,SAAS,MAAM,MAAM;AAC3B,QAAM,WAAW,MAAM;AAEvB,MAAI,QAAQ,OAAO,aAAa,QAAQ,YACtC,SAAQ,YAAY,MAClB;GAAE,WAAW;GAAS,UAAU,MAAM;GAAU,EAChD,oBACD;AAGH,MAAI,sBAAsB,QAAQ,CAChC,QAAO,sBAAsB;GAC3B;GACA;GACA;GACA;GACA;GACA;GACD,CAAC;AAGJ,SAAO,aAAa;GAClB;GACA;GACA;GACA;GACA;GACA,OAAO,QAAQ;GACf,QAAQ,QAAQ;GAChB;GACA;GACD,CAAC;UACK,OAAO;AACd,0BAAwB,QAAQ,EAAE,OAAO;GACvC;GACA;GACA,WAAW;GACX;GACA,OAAO;GACP;GACD,CAAC;AACF,UAAQ,MAAM,wBAAwB,MAAM;AAC5C,UAAQ,MACN,gBACA,iBAAiB,QAAQ,MAAM,QAAQ,iBACxC;AACD,UAAQ,MAAM,kBAAkB;GAC9B,MAAM,iBAAiB,QAAQ,MAAM,OAAO;GAC5C,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;GAC/D,OAAO,iBAAiB,QAAQ,MAAM,QAAQ;GAC/C,CAAC;AAEF,SAAO,IAAI,SACT,KAAK,UAAU;GACb,OAAO;GACP,SAAS,iBAAiB,QAAQ,MAAM,UAAU;GACnD,CAAC,EACF;GACE,QAAQ;GACR,SAAS,EAAE,gBAAgB,oBAAoB;GAChD,CACF"}

package/dist/runtime/handlers/handle-stop.cjs

@@ -0,0 +1,102 @@
+const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
+const require_json_response = require('./shared/json-response.cjs');
+const require_intelligence_utils = require('./shared/intelligence-utils.cjs');
+const require_resolve_intelligence_user = require('./shared/resolve-intelligence-user.cjs');
+const require_thread_access = require('./shared/thread-access.cjs');
+const require_runtime$1 = require('../core/runtime.cjs');
+let _ag_ui_client = require("@ag-ui/client");
+
+//#region src/runtime/handlers/handle-stop.ts
+/** Read `{ runId? }` from a stop request body; a 400 Response when the body is not a valid scope. */
+async function parseStopScope(request) {
+	try {
+		const raw = await request.text();
+		const body = raw.trim() ? JSON.parse(raw) : {};
+		if (typeof body !== "object" || body === null || Array.isArray(body)) return Response.json({ error: "Invalid stop request" }, { status: 400 });
+		if (Object.keys(body).some((key) => key !== "runId")) return Response.json({ error: "Invalid stop request" }, { status: 400 });
+		if (!("runId" in body)) return {};
+		if (typeof body.runId !== "string" || !body.runId.trim()) return Response.json({ error: "Invalid runId" }, { status: 400 });
+		return { runId: body.runId };
+	} catch {
+		return Response.json({ error: "Invalid stop request" }, { status: 400 });
+	}
+}
+/** Stop an active run after applying the runtime's application identity policy. */
+async function handleStopAgent({ runtime, request, agentId, threadId }) {
+	try {
+		const scope = await parseStopScope(request.clone());
+		if (require_json_response.isHandlerResponse(scope)) return scope;
+		const { runId } = scope;
+		let stopThreadId = threadId;
+		let ownerId;
+		if (!require_runtime$1.isIntelligenceRuntime(runtime)) {
+			const owner = await require_thread_access.resolveLocalThreadOwner({
+				runtime,
+				request,
+				operation: "stop"
+			});
+			if (require_json_response.isHandlerResponse(owner)) return owner;
+			ownerId = owner;
+		} else {
+			const user = await require_resolve_intelligence_user.resolveIntelligenceUser({
+				runtime,
+				request
+			});
+			if (require_json_response.isHandlerResponse(user)) return user;
+			try {
+				const thread = await runtime.intelligence.getThread({
+					threadId,
+					userId: user.id
+				});
+				if (!thread || typeof thread.id !== "string" || !thread.id.trim()) return Response.json({ error: "Invalid thread response" }, { status: 502 });
+				if (thread.agentId !== void 0 && thread.agentId !== agentId) return Response.json({ error: "Thread access denied" }, { status: 403 });
+				stopThreadId = thread.id;
+			} catch (error) {
+				const status = require_intelligence_utils.getPlatformErrorStatus(error);
+				return Response.json({ error: "Thread access denied" }, { status: status && status >= 400 && status < 500 ? status : 502 });
+			}
+		}
+		if (!(await require_runtime$1.resolveAgents(runtime.agents, request))[agentId]) return new Response(JSON.stringify({
+			error: "Agent not found",
+			message: `Agent '${agentId}' does not exist`
+		}), {
+			status: 404,
+			headers: { "Content-Type": "application/json" }
+		});
+		if (!await runtime.runner.stop({
+			threadId: stopThreadId,
+			...runId === void 0 ? {} : { runId },
+			...ownerId === void 0 ? {} : { ownerId }
+		})) return new Response(JSON.stringify({
+			stopped: false,
+			message: runId === void 0 ? `No active run for thread '${threadId}'.` : `Run '${runId}' is not the active run for thread '${threadId}'.`
+		}), {
+			status: 200,
+			headers: { "Content-Type": "application/json" }
+		});
+		return new Response(JSON.stringify({
+			stopped: true,
+			interrupt: {
+				type: _ag_ui_client.EventType.RUN_ERROR,
+				message: "Run stopped by user",
+				code: "STOPPED"
+			}
+		}), {
+			status: 200,
+			headers: { "Content-Type": "application/json" }
+		});
+	} catch (error) {
+		console.error("Error stopping agent run:", error);
+		return new Response(JSON.stringify({
+			error: "Failed to stop agent",
+			message: error instanceof Error ? error.message : "Unknown error"
+		}), {
+			status: 500,
+			headers: { "Content-Type": "application/json" }
+		});
+	}
+}
+
+//#endregion
+exports.handleStopAgent = handleStopAgent;
+//# sourceMappingURL=handle-stop.cjs.map