@copilotkit/runtime 1.80.0 → 1.82.0

package/dist/v2/runtime/generative-ui/surface-writer.mjs

@@ -0,0 +1,85 @@
+import "reflect-metadata";
+import { GENERATIVE_UI_ACTIVITY_TYPE, GENERATIVE_UI_ROOT_ID, generativeUISurfaceMessageId } from "@copilotkit/shared";
+import { EventType } from "@ag-ui/client";
+
+//#region src/v2/runtime/generative-ui/surface-writer.ts
+/**
+* Experimental. Programmatic façade for custom agents and workflows: emits the
+* same `generative-ui-surface` activity events as `render_ui`, one per call.
+* Every operation is A2UI v1.0.
+* Does not validate against the browser manifest; the client still validates
+* every operation before applying it.
+*/
+function createSurfaceWriter(emit) {
+	return { openSurface({ target, surfaceId, catalog }) {
+		const messageId = generativeUISurfaceMessageId(surfaceId);
+		const patch = (ops) => emit({
+			type: EventType.ACTIVITY_DELTA,
+			messageId,
+			activityType: GENERATIVE_UI_ACTIVITY_TYPE,
+			patch: ops
+		});
+		const append = (op) => patch([{
+			op: "add",
+			path: "/operations/-",
+			value: op
+		}]);
+		const content = {
+			surfaceId,
+			target,
+			catalogId: catalog,
+			operations: [{
+				version: "v1.0",
+				createSurface: {
+					surfaceId,
+					catalogId: catalog
+				}
+			}],
+			status: "streaming",
+			rejected: []
+		};
+		emit({
+			type: EventType.ACTIVITY_SNAPSHOT,
+			messageId,
+			activityType: GENERATIVE_UI_ACTIVITY_TYPE,
+			content,
+			replace: true
+		});
+		return {
+			setRoot: (node) => append({
+				version: "v1.0",
+				updateComponents: {
+					surfaceId,
+					components: [{
+						...node,
+						id: GENERATIVE_UI_ROOT_ID
+					}]
+				}
+			}),
+			upsert: (...nodes) => append({
+				version: "v1.0",
+				updateComponents: {
+					surfaceId,
+					components: nodes
+				}
+			}),
+			updateData: (path, value) => append({
+				version: "v1.0",
+				updateDataModel: {
+					surfaceId,
+					path,
+					value
+				}
+			}),
+			close: () => patch([{
+				op: "replace",
+				path: "/status",
+				value: "ready"
+			}])
+		};
+	} };
+}
+
+//#endregion
+export { createSurfaceWriter };
+//# sourceMappingURL=surface-writer.mjs.map

package/dist/v2/runtime/generative-ui/surface-writer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-writer.mjs","names":[],"sources":["../../../../src/v2/runtime/generative-ui/surface-writer.ts"],"sourcesContent":["import { EventType } from \"@ag-ui/client\";\nimport type { BaseEvent } from \"@ag-ui/client\";\nimport {\n  GENERATIVE_UI_ACTIVITY_TYPE,\n  GENERATIVE_UI_ROOT_ID,\n  generativeUISurfaceMessageId,\n} from \"@copilotkit/shared\";\nimport type {\n  A2UIComponentNode,\n  A2UIOperation,\n  GenerativeUISurfaceContent,\n} from \"@copilotkit/shared\";\n\nexport interface GenerativeUISurfaceWriter {\n  setRoot(node: Omit<A2UIComponentNode, \"id\">): void;\n  upsert(...nodes: A2UIComponentNode[]): void;\n  /** Sets `value` at `path`. A `null` value deletes the key at `path`. */\n  updateData(path: string, value: unknown): void;\n  close(): void;\n}\n\n/**\n * Experimental. Programmatic façade for custom agents and workflows: emits the\n * same `generative-ui-surface` activity events as `render_ui`, one per call.\n * Every operation is A2UI v1.0.\n * Does not validate against the browser manifest; the client still validates\n * every operation before applying it.\n */\nexport function createSurfaceWriter(emit: (event: BaseEvent) => void) {\n  return {\n    openSurface({\n      target,\n      surfaceId,\n      catalog,\n    }: {\n      target: string;\n      surfaceId: string;\n      catalog: string;\n    }): GenerativeUISurfaceWriter {\n      const messageId = generativeUISurfaceMessageId(surfaceId);\n      const patch = (ops: unknown[]) =>\n        emit({\n          type: EventType.ACTIVITY_DELTA,\n          messageId,\n          activityType: GENERATIVE_UI_ACTIVITY_TYPE,\n          patch: ops,\n        });\n      const append = (op: A2UIOperation) =>\n        patch([{ op: \"add\", path: \"/operations/-\", value: op }]);\n      const content: GenerativeUISurfaceContent = {\n        surfaceId,\n        target,\n        catalogId: catalog,\n        operations: [\n          { version: \"v1.0\", createSurface: { surfaceId, catalogId: catalog } },\n        ],\n        status: \"streaming\",\n        rejected: [],\n      };\n      emit({\n        type: EventType.ACTIVITY_SNAPSHOT,\n        messageId,\n        activityType: GENERATIVE_UI_ACTIVITY_TYPE,\n        content,\n        replace: true,\n      });\n      return {\n        setRoot: (node) =>\n          append({\n            version: \"v1.0\",\n            updateComponents: {\n              surfaceId,\n              components: [\n                { ...node, id: GENERATIVE_UI_ROOT_ID } as A2UIComponentNode,\n              ],\n            },\n          }),\n        upsert: (...nodes) =>\n          append({\n            version: \"v1.0\",\n            updateComponents: { surfaceId, components: nodes },\n          }),\n        updateData: (path, value) =>\n          append({\n            version: \"v1.0\",\n            updateDataModel: { surfaceId, path, value },\n          }),\n        close: () =>\n          patch([{ op: \"replace\", path: \"/status\", value: \"ready\" }]),\n      };\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;AA4BA,SAAgB,oBAAoB,MAAkC;AACpE,QAAO,EACL,YAAY,EACV,QACA,WACA,WAK4B;EAC5B,MAAM,YAAY,6BAA6B,UAAU;EACzD,MAAM,SAAS,QACb,KAAK;GACH,MAAM,UAAU;GAChB;GACA,cAAc;GACd,OAAO;GACR,CAAC;EACJ,MAAM,UAAU,OACd,MAAM,CAAC;GAAE,IAAI;GAAO,MAAM;GAAiB,OAAO;GAAI,CAAC,CAAC;EAC1D,MAAM,UAAsC;GAC1C;GACA;GACA,WAAW;GACX,YAAY,CACV;IAAE,SAAS;IAAQ,eAAe;KAAE;KAAW,WAAW;KAAS;IAAE,CACtE;GACD,QAAQ;GACR,UAAU,EAAE;GACb;AACD,OAAK;GACH,MAAM,UAAU;GAChB;GACA,cAAc;GACd;GACA,SAAS;GACV,CAAC;AACF,SAAO;GACL,UAAU,SACR,OAAO;IACL,SAAS;IACT,kBAAkB;KAChB;KACA,YAAY,CACV;MAAE,GAAG;MAAM,IAAI;MAAuB,CACvC;KACF;IACF,CAAC;GACJ,SAAS,GAAG,UACV,OAAO;IACL,SAAS;IACT,kBAAkB;KAAE;KAAW,YAAY;KAAO;IACnD,CAAC;GACJ,aAAa,MAAM,UACjB,OAAO;IACL,SAAS;IACT,iBAAiB;KAAE;KAAW;KAAM;KAAO;IAC5C,CAAC;GACJ,aACE,MAAM,CAAC;IAAE,IAAI;IAAW,MAAM;IAAW,OAAO;IAAS,CAAC,CAAC;GAC9D;IAEJ"}

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

@@ -1,11 +1,13 @@
 require("reflect-metadata");
+const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
 const require_telemetry_client = require('../telemetry/telemetry-client.cjs');
 const require_runtime_error_reporter = require('../core/runtime-error-reporter.cjs');
-const require_runtime = require('../core/runtime.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/v2/runtime/handlers/handle-run.ts
 async function handleRunAgent({ runtime, request, agentId }) {
@@ -23,12 +25,15 @@ async function handleRunAgent({ runtime, request, agentId }) {
 		agent.agentId = agentId;
 		const input = await require_agent_utils.parseRunRequest(request);
 		if (input instanceof Response) return input;
+		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: input.forwardedProps?.a2uiCatalogAvailable === true,
+			providerA2UIHasCatalog,
+			providerGenerativeUITransport,
 			isMcpProxyRequest: Object.prototype.hasOwnProperty.call(input.forwardedProps ?? {}, "__proxiedMCPRequest")
 		});
 		const memoryResponse = await require_agent_utils.attachIntelligenceEnterpriseLearning({
@@ -44,7 +49,7 @@ async function handleRunAgent({ runtime, request, agentId }) {
 			agentName: agentId,
 			threadId: input.threadId
 		}, "Agent run started");
-		if (require_runtime.isIntelligenceRuntime(runtime)) return require_run.handleIntelligenceRun({
+		if (require_runtime$1.isIntelligenceRuntime(runtime)) return require_run.handleIntelligenceRun({
 			runtime,
 			request,
 			agentId,

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

@@ -1 +1 @@
-{"version":3,"file":"handle-run.cjs","names":["telemetry","readGuardrailsEnabled","cloneAgentForRequest","parseRunRequest","attachIntelligenceEnterpriseLearning","isIntelligenceRuntime","handleIntelligenceRun","handleSseRun"],"sources":["../../../../src/v2/runtime/handlers/handle-run.ts"],"sourcesContent":["import { 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\";\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: the request is single-read,\n    // and middleware configuration needs the A2UI catalog signal the React\n    // provider forwards (see `a2uiCatalogAvailable` below). Middleware is applied\n    // to the agent here; the run itself is kicked off later, so this is safe.\n    const input = await parseRunRequest(request);\n    if (input instanceof Response) {\n      return input;\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\n    configureAgentForRequest({\n      runtime,\n      request,\n      agentId,\n      agent,\n      providerA2UIHasCatalog,\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    });\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":";;;;;;;;;;AAcA,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;EAMhB,MAAM,QAAQ,MAAMC,oCAAgB,QAAQ;AAC5C,MAAI,iBAAiB,SACnB,QAAO;AAUT,+CAAyB;GACvB;GACA;GACA;GACA;GACA,wBARC,MAAM,gBACH,yBAAyB;GAQ7B,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,MAAIC,sCAAsB,QAAQ,CAChC,QAAOC,kCAAsB;GAC3B;GACA;GACA;GACA;GACA;GACA;GACD,CAAC;AAGJ,SAAOC,2BAAa;GAClB;GACA;GACA;GACA;GACA;GACA,OAAO,QAAQ;GACf,QAAQ,QAAQ;GAChB;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"}
+{"version":3,"file":"handle-run.cjs","names":["telemetry","readGuardrailsEnabled","cloneAgentForRequest","parseRunRequest","attachIntelligenceEnterpriseLearning","isIntelligenceRuntime","handleIntelligenceRun","handleSseRun"],"sources":["../../../../src/v2/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\";\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: the request is single-read,\n    // and middleware configuration needs the A2UI catalog signal the React\n    // provider forwards (see `a2uiCatalogAvailable` below). Middleware is applied\n    // to the agent here; the run itself is kicked off later, so this is safe.\n    const input = await parseRunRequest(request);\n    if (input instanceof Response) {\n      return input;\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    });\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":";;;;;;;;;;;;AAeA,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;EAMhB,MAAM,QAAQ,MAAMC,oCAAgB,QAAQ;AAC5C,MAAI,iBAAiB,SACnB,QAAO;EAMT,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,MAAIC,wCAAsB,QAAQ,CAChC,QAAOC,kCAAsB;GAC3B;GACA;GACA;GACA;GACA;GACA;GACD,CAAC;AAGJ,SAAOC,2BAAa;GAClB;GACA;GACA;GACA;GACA;GACA,OAAO,QAAQ;GACf,QAAQ,QAAQ;GAChB;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/v2/runtime/handlers/handle-run.mjs

@@ -6,6 +6,7 @@ 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/v2/runtime/handlers/handle-run.ts
 async function handleRunAgent({ runtime, request, agentId }) {
@@ -23,12 +24,15 @@ async function handleRunAgent({ runtime, request, agentId }) {
 		agent.agentId = agentId;
 		const input = await parseRunRequest(request);
 		if (input instanceof Response) return input;
+		const providerA2UIHasCatalog = input.forwardedProps?.a2uiCatalogAvailable === true;
+		const providerGenerativeUITransport = readCopilotKitUIEnvelope(input.forwardedProps)?.metadata.extensions.copilotkit_transport;
 		configureAgentForRequest({
 			runtime,
 			request,
 			agentId,
 			agent,
-			providerA2UIHasCatalog: input.forwardedProps?.a2uiCatalogAvailable === true,
+			providerA2UIHasCatalog,
+			providerGenerativeUITransport,
 			isMcpProxyRequest: Object.prototype.hasOwnProperty.call(input.forwardedProps ?? {}, "__proxiedMCPRequest")
 		});
 		const memoryResponse = await attachIntelligenceEnterpriseLearning({

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

@@ -1 +1 @@
-{"version":3,"file":"handle-run.mjs","names":[],"sources":["../../../../src/v2/runtime/handlers/handle-run.ts"],"sourcesContent":["import { 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\";\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: the request is single-read,\n    // and middleware configuration needs the A2UI catalog signal the React\n    // provider forwards (see `a2uiCatalogAvailable` below). Middleware is applied\n    // to the agent here; the run itself is kicked off later, so this is safe.\n    const input = await parseRunRequest(request);\n    if (input instanceof Response) {\n      return input;\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\n    configureAgentForRequest({\n      runtime,\n      request,\n      agentId,\n      agent,\n      providerA2UIHasCatalog,\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    });\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":";;;;;;;;;;AAcA,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;EAMhB,MAAM,QAAQ,MAAM,gBAAgB,QAAQ;AAC5C,MAAI,iBAAiB,SACnB,QAAO;AAUT,2BAAyB;GACvB;GACA;GACA;GACA;GACA,wBARC,MAAM,gBACH,yBAAyB;GAQ7B,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;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"}
+{"version":3,"file":"handle-run.mjs","names":[],"sources":["../../../../src/v2/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\";\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: the request is single-read,\n    // and middleware configuration needs the A2UI catalog signal the React\n    // provider forwards (see `a2uiCatalogAvailable` below). Middleware is applied\n    // to the agent here; the run itself is kicked off later, so this is safe.\n    const input = await parseRunRequest(request);\n    if (input instanceof Response) {\n      return input;\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    });\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":";;;;;;;;;;;AAeA,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;EAMhB,MAAM,QAAQ,MAAM,gBAAgB,QAAQ;AAC5C,MAAI,iBAAiB,SACnB,QAAO;EAMT,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;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/v2/runtime/handlers/intelligence/run.cjs

@@ -38,6 +38,8 @@ async function handleIntelligenceRun({ runtime, request, agentId, agent, input,
 	const userId = user.id;
 	const proxyRequest = input.forwardedProps?.__proxiedMCPRequest;
 	const isDirectResourceRead = input.forwardedProps?.__copilotkitMcpResourceReadOnly === true && proxyRequest && typeof proxyRequest === "object" && proxyRequest.method === "resources/read";
+	const forwardedRequestId = input.forwardedProps?.__copilotkitRequestId;
+	const requestId = typeof forwardedRequestId === "string" && forwardedRequestId.length > 0 ? forwardedRequestId : void 0;
 	let learningContainerId;
 	try {
 		const selector = runtime.intelligence.ɵgetLearningContainerId?.();
@@ -118,6 +120,7 @@ async function handleIntelligenceRun({ runtime, request, agentId, agent, input,
 			userId,
 			agentId,
 			...learningContainerId !== void 0 ? { learningContainerId } : {},
+			...requestId !== void 0 ? { requestId } : {},
 			...runtime.lockKeyPrefix !== void 0 ? { lockKeyPrefix: runtime.lockKeyPrefix } : {},
 			ttlSeconds: runtime.lockTtlSeconds
 		});

package/dist/v2/runtime/handlers/intelligence/run.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"run.cjs","names":["telemetry","resolveIntelligenceUser","isHandlerResponse","resolveLearningContainerSelector","resolveLearningContainerId","generateThreadNameForNewThread","getPlatformErrorStatus","startThreadLockHeartbeat","getRuntimeErrorReporter","EventType"],"sources":["../../../../../src/v2/runtime/handlers/intelligence/run.ts"],"sourcesContent":["import type {\n  AbstractAgent,\n  BaseEvent,\n  Message,\n  RunAgentInput,\n} from \"@ag-ui/client\";\nimport { EventType } from \"@ag-ui/client\";\nimport type { CopilotIntelligenceRuntimeLike } from \"../../core/runtime\";\nimport { generateThreadNameForNewThread } from \"./thread-names\";\nimport { logger } from \"@copilotkit/shared\";\nimport { telemetry } from \"../../telemetry\";\nimport { resolveIntelligenceUser } from \"../shared/resolve-intelligence-user\";\nimport { isHandlerResponse } from \"../shared/json-response\";\nimport type { AgentRunnerRunRequest } from \"../../runner/agent-runner\";\nimport type { Observable } from \"rxjs\";\nimport { getRuntimeErrorReporter } from \"../../core/runtime-error-reporter\";\nimport type { RuntimeErrorPhase } from \"../../core/runtime-error-reporter\";\nimport {\n  resolveLearningContainerId,\n  resolveLearningContainerSelector,\n} from \"../../core/learning\";\nimport { getPlatformErrorStatus } from \"../shared/intelligence-utils\";\nimport { startThreadLockHeartbeat } from \"../../intelligence-platform/thread-lock-heartbeat\";\nimport type { ThreadSummary } from \"../../intelligence-platform\";\n\n/**\n * Builds browser-facing realtime connection metadata owned by the runtime.\n */\nfunction buildRealtimeConnectionInfo(params: {\n  clientUrl: string;\n  threadId: string;\n}): { clientUrl: string; topic: string } {\n  return {\n    clientUrl: params.clientUrl,\n    topic: `thread:${params.threadId}`,\n  };\n}\n\ninterface RunnerStartupBoundary {\n  events: Observable<BaseEvent>;\n  startup: Promise<void>;\n}\n\ninterface RunnerWithStartupBoundary {\n  runWithStartupBoundary(request: AgentRunnerRunRequest): RunnerStartupBoundary;\n}\n\nfunction hasRunnerStartupBoundary(\n  runner: CopilotIntelligenceRuntimeLike[\"runner\"],\n): runner is CopilotIntelligenceRuntimeLike[\"runner\"] &\n  RunnerWithStartupBoundary {\n  const candidate = runner as { runWithStartupBoundary?: unknown };\n\n  return (\n    typeof candidate.runWithStartupBoundary === \"function\" &&\n    (Object.prototype.hasOwnProperty.call(runner, \"runWithStartupBoundary\") ||\n      Object.prototype.hasOwnProperty.call(runner, \"threads\"))\n  );\n}\n\ninterface HandleIntelligenceRunParams {\n  runtime: CopilotIntelligenceRuntimeLike;\n  request: Request;\n  agentId: string;\n  agent: AbstractAgent;\n  input: RunAgentInput;\n  startTime?: number;\n}\n\nexport async function handleIntelligenceRun({\n  runtime,\n  request,\n  agentId,\n  agent,\n  input,\n  startTime,\n}: HandleIntelligenceRunParams): Promise<Response> {\n  const runtimeTelemetry = runtime.telemetry ?? telemetry;\n\n  if (!runtime.intelligence) {\n    return Response.json(\n      {\n        error: \"Intelligence not configured\",\n        message: \"Intelligence mode requires a CopilotKitIntelligence\",\n      },\n      { status: 500 },\n    );\n  }\n\n  const user = await resolveIntelligenceUser({ runtime, request });\n  if (isHandlerResponse(user)) {\n    return user;\n  }\n  const userId = user.id;\n\n  const proxyRequest = (\n    input.forwardedProps as Record<string, unknown> | undefined\n  )?.__proxiedMCPRequest;\n  const isDirectResourceRead =\n    input.forwardedProps?.__copilotkitMcpResourceReadOnly === true &&\n    proxyRequest &&\n    typeof proxyRequest === \"object\" &&\n    (proxyRequest as { method?: unknown }).method === \"resources/read\";\n\n  let learningContainerId: string | undefined;\n  try {\n    const selector = runtime.intelligence.ɵgetLearningContainerId?.();\n    learningContainerId = selector\n      ? await resolveLearningContainerSelector(selector, {\n          surface: \"web\",\n          user,\n          agentId,\n          input,\n        })\n      : await resolveLearningContainerId(runtime.learning, {\n          surface: \"web\",\n          request,\n          threadId: input.threadId,\n          runId: input.runId,\n          agentId,\n          userId,\n        });\n  } catch (error) {\n    logger.error(\"Failed to resolve Learning Container:\", error);\n    return Response.json(\n      { error: \"Failed to resolve Learning Container\" },\n      { status: 500 },\n    );\n  }\n\n  let thread: ThreadSummary;\n  try {\n    const initialized = await runtime.intelligence.getOrCreateThread({\n      threadId: input.threadId,\n      userId,\n      agentId,\n      ...(learningContainerId !== undefined ? { learningContainerId } : {}),\n    });\n    thread = initialized.thread;\n    const { created } = initialized;\n\n    if (created && runtime.generateThreadNames && !thread.name?.trim()) {\n      void generateThreadNameForNewThread({\n        runtime,\n        request,\n        agentId,\n        sourceInput: input,\n        thread,\n        userId,\n      }).catch((nameError) => {\n        logger.error(\"Failed to generate thread name:\", nameError);\n      });\n    }\n  } catch (error) {\n    logger.error(\"Failed to get or create thread:\", error);\n    const platformStatus = getPlatformErrorStatus(error);\n    return Response.json(\n      {\n        error: \"Failed to initialize thread\",\n      },\n      {\n        status:\n          platformStatus !== undefined &&\n          platformStatus >= 400 &&\n          platformStatus < 500\n            ? platformStatus\n            : 502,\n      },\n    );\n  }\n\n  // MCP App resources are presentation data. Initialize the thread through the\n  // usual path, then fetch without claiming its mutation lock so an approval\n  // can continue while the resource server is still answering.\n  if (isDirectResourceRead) {\n    try {\n      if (thread.agentId && thread.agentId !== agentId) {\n        return Response.json(\n          { error: \"Thread belongs to another agent\" },\n          { status: 403 },\n        );\n      }\n      agent.threadId = thread.id;\n      const run = await agent.runAgent({\n        runId: input.runId,\n        tools: input.tools,\n        context: input.context,\n        forwardedProps: input.forwardedProps,\n      });\n      return Response.json({\n        kind: \"mcp-resource-read\",\n        threadId: thread.id,\n        runId: input.runId,\n        result: run.result ?? null,\n      });\n    } catch (error) {\n      logger.error(\"MCP resource read failed:\", error);\n      const status = getPlatformErrorStatus(error);\n      return Response.json(\n        { error: \"MCP resource read failed\" },\n        { status: status && status >= 400 && status < 500 ? status : 502 },\n      );\n    }\n  }\n\n  let canonicalThreadId = input.threadId;\n  let canonicalRunId = input.runId;\n  let joinToken: string | undefined;\n  let backendThreadId: string | undefined;\n  let lockTtlSeconds: number | undefined;\n  let lockRequestedAt = 0;\n  try {\n    // The platform starts the lock's TTL when it handles the request, so time\n    // the lifetime from the send rather than from the response.\n    lockRequestedAt = Date.now();\n    const lockResult = await runtime.intelligence.ɵacquireThreadLock({\n      supportsBackendThreadId: true,\n      threadId: input.threadId,\n      runId: input.runId,\n      userId,\n      agentId,\n      ...(learningContainerId !== undefined ? { learningContainerId } : {}),\n      ...(runtime.lockKeyPrefix !== undefined\n        ? { lockKeyPrefix: runtime.lockKeyPrefix }\n        : {}),\n      ttlSeconds: runtime.lockTtlSeconds,\n    });\n    canonicalThreadId = lockResult.threadId;\n    canonicalRunId = lockResult.runId;\n    joinToken = lockResult.joinToken;\n    backendThreadId = lockResult.backendThreadId;\n    lockTtlSeconds = lockResult.ttlSeconds;\n  } catch (error) {\n    logger.error(\"Thread lock denied:\", error);\n    const platformStatus = getPlatformErrorStatus(error);\n    return Response.json(\n      {\n        error: \"Thread lock denied\",\n      },\n      {\n        status: platformStatus === 409 ? 409 : 502,\n      },\n    );\n  }\n\n  const cleanupLock = (reason: string): Promise<void> =>\n    runtime.intelligence\n      .ɵcleanupThreadLock({\n        threadId: canonicalThreadId || input.threadId,\n        runId: canonicalRunId || input.runId,\n      })\n      .catch((cleanupError) => {\n        logger.error(\n          { err: cleanupError, reason },\n          \"Failed to cleanup thread lock\",\n        );\n      });\n\n  if (!canonicalThreadId || !canonicalRunId || !joinToken) {\n    await cleanupLock(\"malformed-lock-response\");\n    return Response.json(\n      {\n        error: \"Run connection credentials not available\",\n        message:\n          \"Intelligence platform did not return canonical threadId, runId, and joinToken\",\n      },\n      { status: 502 },\n    );\n  }\n\n  const canonicalInput: RunAgentInput = {\n    ...input,\n    threadId: canonicalThreadId,\n    runId: canonicalRunId,\n  };\n\n  let persistedInputMessages: Message[] | undefined;\n  if (Array.isArray(input.messages)) {\n    try {\n      const historicMessageIds = new Set(\n        await runtime.intelligence.ɵgetThreadMessageIds({\n          threadId: canonicalThreadId,\n          userId,\n        }),\n      );\n      persistedInputMessages = input.messages.filter(\n        (message) => !historicMessageIds.has(message.id),\n      );\n    } catch (error) {\n      logger.error(\"Thread history lookup failed:\", error);\n      await cleanupLock(\"thread-history-lookup-failed\");\n      return Response.json(\n        {\n          error: \"Thread history lookup failed\",\n        },\n        { status: 502 },\n      );\n    }\n  }\n\n  runtimeTelemetry.capture(\"oss.runtime.agent_execution_stream_started\", {});\n\n  // Keep the thread lock alive while the run executes. Transient renewal\n  // failures are retried within the lock's remaining TTL; only a lost lock\n  // (or running out of time) aborts the run.\n  const heartbeat = startThreadLockHeartbeat({\n    renew: (signal) =>\n      runtime.intelligence.ɵrenewThreadLock({\n        threadId: canonicalThreadId,\n        runId: canonicalRunId,\n        ttlSeconds: runtime.lockTtlSeconds,\n        ...(runtime.lockKeyPrefix !== undefined\n          ? { lockKeyPrefix: runtime.lockKeyPrefix }\n          : {}),\n        signal,\n      }),\n    intervalMs: runtime.lockHeartbeatIntervalSeconds * 1_000,\n    fallbackTtlSeconds: runtime.lockTtlSeconds,\n    // The acquire round trip and the history lookup above both run between\n    // the lock request and now, so pass the lifetime the platform set minus\n    // the time already spent.\n    initialTtlSeconds:\n      lockTtlSeconds === undefined\n        ? undefined\n        : lockTtlSeconds - (Date.now() - lockRequestedAt) / 1_000,\n    onLost: (err) => {\n      logger.error(\"Failed to renew thread lock:\", err);\n      try {\n        agent.abortRun();\n      } catch (abortError) {\n        logger.error(\n          \"Failed to abort agent after lock renewal failure:\",\n          abortError,\n        );\n      }\n    },\n  });\n\n  const clearHeartbeat = () => {\n    heartbeat.stop();\n  };\n\n  const runStarted = { current: false };\n  let immediateStartupErrorMessage: string | undefined;\n  let immediateStartupCleanup: Promise<void> | undefined;\n\n  const runRequest: AgentRunnerRunRequest = {\n    threadId: canonicalThreadId,\n    ...(backendThreadId === undefined ? {} : { backendThreadId }),\n    agent,\n    input: canonicalInput,\n    ...(persistedInputMessages !== undefined ? { persistedInputMessages } : {}),\n  };\n\n  const runtimeErrorReporter = getRuntimeErrorReporter(runtime);\n  let agentErrorReported = false;\n  const reportAgentError = (error: unknown, phase: RuntimeErrorPhase) => {\n    if (agentErrorReported) return;\n    agentErrorReported = true;\n    // Analytics describes the outcome; only the application-owned reporter\n    // receives diagnostics that may contain customer or upstream content.\n    runtimeTelemetry.capture(\"oss.runtime.agent_execution_stream_errored\", {\n      error: \"AGENT_EXECUTION_FAILED\",\n    });\n    runtimeErrorReporter?.report({\n      request,\n      error,\n      operation: \"agent.run\",\n      agentId,\n      threadId: canonicalThreadId,\n      runId: canonicalRunId,\n      phase,\n      startTime,\n    });\n  };\n\n  try {\n    const runStart = hasRunnerStartupBoundary(runtime.runner)\n      ? runtime.runner.runWithStartupBoundary(runRequest)\n      : {\n          events: runtime.runner.run(runRequest),\n          startup: Promise.resolve(),\n        };\n\n    runStart.events.subscribe({\n      next: (event: BaseEvent) => {\n        if (event.type === EventType.RUN_STARTED) {\n          runStarted.current = true;\n        }\n        if (event.type === EventType.RUN_ERROR) {\n          const message =\n            \"message\" in event && typeof event.message === \"string\"\n              ? event.message\n              : \"Runner failed before the run started\";\n          reportAgentError(\n            new Error(message),\n            runStarted.current\n              ? \"intelligence.subscription\"\n              : \"intelligence.startup\",\n          );\n          if (!runStarted.current) {\n            clearHeartbeat();\n            immediateStartupErrorMessage = message;\n            immediateStartupCleanup = cleanupLock(\"runner-start-failed\");\n          }\n        }\n      },\n      error: (error) => {\n        reportAgentError(\n          error,\n          runStarted.current\n            ? \"intelligence.subscription\"\n            : \"intelligence.startup\",\n        );\n        clearHeartbeat();\n        if (!runStarted.current) {\n          immediateStartupErrorMessage =\n            error instanceof Error ? error.message : String(error);\n          immediateStartupCleanup = cleanupLock(\"runner-start-error\");\n        } else {\n          cleanupLock(\"runner-error\");\n        }\n        logger.error(\"Error running agent:\", error);\n      },\n      complete: () => {\n        clearHeartbeat();\n        // Preserve the existing completion count even when the stream contains\n        // RUN_ERROR. Failure reporting is separate and carries only a safe code.\n        runtimeTelemetry.capture(\n          \"oss.runtime.agent_execution_stream_ended\",\n          {},\n        );\n      },\n    });\n\n    await runStart.startup;\n  } catch (error) {\n    reportAgentError(error, \"intelligence.startup\");\n    clearHeartbeat();\n    await (immediateStartupCleanup ?? cleanupLock(\"runner-start-threw\"));\n    logger.error(\"Error starting agent runner:\", error);\n    return Response.json(\n      {\n        error: \"Failed to start runner\",\n        message: error instanceof Error ? error.message : String(error),\n      },\n      { status: 502 },\n    );\n  }\n\n  if (immediateStartupErrorMessage) {\n    await immediateStartupCleanup;\n    return Response.json(\n      {\n        error: \"Failed to start runner\",\n        message: immediateStartupErrorMessage,\n      },\n      { status: 502 },\n    );\n  }\n\n  // IntelligenceAgentRunner resolves this boundary after Phoenix channel join.\n  // Other runner implementations fall back to construction/subscription errors.\n  return Response.json(\n    {\n      threadId: canonicalThreadId,\n      runId: canonicalRunId,\n      joinToken,\n      realtime: buildRealtimeConnectionInfo({\n        clientUrl: runtime.intelligence.ɵgetClientWsUrl(),\n        threadId: canonicalThreadId,\n      }),\n    },\n    {\n      headers: { \"Cache-Control\": \"no-cache\" },\n    },\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"run.cjs","names":["telemetry","resolveIntelligenceUser","isHandlerResponse","resolveLearningContainerSelector","resolveLearningContainerId","generateThreadNameForNewThread","getPlatformErrorStatus","startThreadLockHeartbeat","getRuntimeErrorReporter","EventType"],"sources":["../../../../../src/v2/runtime/handlers/intelligence/run.ts"],"sourcesContent":["import type {\n  AbstractAgent,\n  BaseEvent,\n  Message,\n  RunAgentInput,\n} from \"@ag-ui/client\";\nimport { EventType } from \"@ag-ui/client\";\nimport type { CopilotIntelligenceRuntimeLike } from \"../../core/runtime\";\nimport { generateThreadNameForNewThread } from \"./thread-names\";\nimport { logger } from \"@copilotkit/shared\";\nimport { telemetry } from \"../../telemetry\";\nimport { resolveIntelligenceUser } from \"../shared/resolve-intelligence-user\";\nimport { isHandlerResponse } from \"../shared/json-response\";\nimport type { AgentRunnerRunRequest } from \"../../runner/agent-runner\";\nimport type { Observable } from \"rxjs\";\nimport { getRuntimeErrorReporter } from \"../../core/runtime-error-reporter\";\nimport type { RuntimeErrorPhase } from \"../../core/runtime-error-reporter\";\nimport {\n  resolveLearningContainerId,\n  resolveLearningContainerSelector,\n} from \"../../core/learning\";\nimport { getPlatformErrorStatus } from \"../shared/intelligence-utils\";\nimport { startThreadLockHeartbeat } from \"../../intelligence-platform/thread-lock-heartbeat\";\nimport type { ThreadSummary } from \"../../intelligence-platform\";\n\n/**\n * Builds browser-facing realtime connection metadata owned by the runtime.\n */\nfunction buildRealtimeConnectionInfo(params: {\n  clientUrl: string;\n  threadId: string;\n}): { clientUrl: string; topic: string } {\n  return {\n    clientUrl: params.clientUrl,\n    topic: `thread:${params.threadId}`,\n  };\n}\n\ninterface RunnerStartupBoundary {\n  events: Observable<BaseEvent>;\n  startup: Promise<void>;\n}\n\ninterface RunnerWithStartupBoundary {\n  runWithStartupBoundary(request: AgentRunnerRunRequest): RunnerStartupBoundary;\n}\n\nfunction hasRunnerStartupBoundary(\n  runner: CopilotIntelligenceRuntimeLike[\"runner\"],\n): runner is CopilotIntelligenceRuntimeLike[\"runner\"] &\n  RunnerWithStartupBoundary {\n  const candidate = runner as { runWithStartupBoundary?: unknown };\n\n  return (\n    typeof candidate.runWithStartupBoundary === \"function\" &&\n    (Object.prototype.hasOwnProperty.call(runner, \"runWithStartupBoundary\") ||\n      Object.prototype.hasOwnProperty.call(runner, \"threads\"))\n  );\n}\n\ninterface HandleIntelligenceRunParams {\n  runtime: CopilotIntelligenceRuntimeLike;\n  request: Request;\n  agentId: string;\n  agent: AbstractAgent;\n  input: RunAgentInput;\n  startTime?: number;\n}\n\nexport async function handleIntelligenceRun({\n  runtime,\n  request,\n  agentId,\n  agent,\n  input,\n  startTime,\n}: HandleIntelligenceRunParams): Promise<Response> {\n  const runtimeTelemetry = runtime.telemetry ?? telemetry;\n\n  if (!runtime.intelligence) {\n    return Response.json(\n      {\n        error: \"Intelligence not configured\",\n        message: \"Intelligence mode requires a CopilotKitIntelligence\",\n      },\n      { status: 500 },\n    );\n  }\n\n  const user = await resolveIntelligenceUser({ runtime, request });\n  if (isHandlerResponse(user)) {\n    return user;\n  }\n  const userId = user.id;\n\n  const proxyRequest = (\n    input.forwardedProps as Record<string, unknown> | undefined\n  )?.__proxiedMCPRequest;\n  const isDirectResourceRead =\n    input.forwardedProps?.__copilotkitMcpResourceReadOnly === true &&\n    proxyRequest &&\n    typeof proxyRequest === \"object\" &&\n    (proxyRequest as { method?: unknown }).method === \"resources/read\";\n\n  // CopilotKit core sends one request ID across a request's follow-up runs\n  // and resumes. Older clients send none, and the platform then uses the run ID.\n  const forwardedRequestId = input.forwardedProps?.__copilotkitRequestId;\n  const requestId =\n    typeof forwardedRequestId === \"string\" && forwardedRequestId.length > 0\n      ? forwardedRequestId\n      : undefined;\n\n  let learningContainerId: string | undefined;\n  try {\n    const selector = runtime.intelligence.ɵgetLearningContainerId?.();\n    learningContainerId = selector\n      ? await resolveLearningContainerSelector(selector, {\n          surface: \"web\",\n          user,\n          agentId,\n          input,\n        })\n      : await resolveLearningContainerId(runtime.learning, {\n          surface: \"web\",\n          request,\n          threadId: input.threadId,\n          runId: input.runId,\n          agentId,\n          userId,\n        });\n  } catch (error) {\n    logger.error(\"Failed to resolve Learning Container:\", error);\n    return Response.json(\n      { error: \"Failed to resolve Learning Container\" },\n      { status: 500 },\n    );\n  }\n\n  let thread: ThreadSummary;\n  try {\n    const initialized = await runtime.intelligence.getOrCreateThread({\n      threadId: input.threadId,\n      userId,\n      agentId,\n      ...(learningContainerId !== undefined ? { learningContainerId } : {}),\n    });\n    thread = initialized.thread;\n    const { created } = initialized;\n\n    if (created && runtime.generateThreadNames && !thread.name?.trim()) {\n      void generateThreadNameForNewThread({\n        runtime,\n        request,\n        agentId,\n        sourceInput: input,\n        thread,\n        userId,\n      }).catch((nameError) => {\n        logger.error(\"Failed to generate thread name:\", nameError);\n      });\n    }\n  } catch (error) {\n    logger.error(\"Failed to get or create thread:\", error);\n    const platformStatus = getPlatformErrorStatus(error);\n    return Response.json(\n      {\n        error: \"Failed to initialize thread\",\n      },\n      {\n        status:\n          platformStatus !== undefined &&\n          platformStatus >= 400 &&\n          platformStatus < 500\n            ? platformStatus\n            : 502,\n      },\n    );\n  }\n\n  // MCP App resources are presentation data. Initialize the thread through the\n  // usual path, then fetch without claiming its mutation lock so an approval\n  // can continue while the resource server is still answering.\n  if (isDirectResourceRead) {\n    try {\n      if (thread.agentId && thread.agentId !== agentId) {\n        return Response.json(\n          { error: \"Thread belongs to another agent\" },\n          { status: 403 },\n        );\n      }\n      agent.threadId = thread.id;\n      const run = await agent.runAgent({\n        runId: input.runId,\n        tools: input.tools,\n        context: input.context,\n        forwardedProps: input.forwardedProps,\n      });\n      return Response.json({\n        kind: \"mcp-resource-read\",\n        threadId: thread.id,\n        runId: input.runId,\n        result: run.result ?? null,\n      });\n    } catch (error) {\n      logger.error(\"MCP resource read failed:\", error);\n      const status = getPlatformErrorStatus(error);\n      return Response.json(\n        { error: \"MCP resource read failed\" },\n        { status: status && status >= 400 && status < 500 ? status : 502 },\n      );\n    }\n  }\n\n  let canonicalThreadId = input.threadId;\n  let canonicalRunId = input.runId;\n  let joinToken: string | undefined;\n  let backendThreadId: string | undefined;\n  let lockTtlSeconds: number | undefined;\n  let lockRequestedAt = 0;\n  try {\n    // The platform starts the lock's TTL when it handles the request, so time\n    // the lifetime from the send rather than from the response.\n    lockRequestedAt = Date.now();\n    const lockResult = await runtime.intelligence.ɵacquireThreadLock({\n      supportsBackendThreadId: true,\n      threadId: input.threadId,\n      runId: input.runId,\n      userId,\n      agentId,\n      ...(learningContainerId !== undefined ? { learningContainerId } : {}),\n      ...(requestId !== undefined ? { requestId } : {}),\n      ...(runtime.lockKeyPrefix !== undefined\n        ? { lockKeyPrefix: runtime.lockKeyPrefix }\n        : {}),\n      ttlSeconds: runtime.lockTtlSeconds,\n    });\n    canonicalThreadId = lockResult.threadId;\n    canonicalRunId = lockResult.runId;\n    joinToken = lockResult.joinToken;\n    backendThreadId = lockResult.backendThreadId;\n    lockTtlSeconds = lockResult.ttlSeconds;\n  } catch (error) {\n    logger.error(\"Thread lock denied:\", error);\n    const platformStatus = getPlatformErrorStatus(error);\n    return Response.json(\n      {\n        error: \"Thread lock denied\",\n      },\n      {\n        status: platformStatus === 409 ? 409 : 502,\n      },\n    );\n  }\n\n  const cleanupLock = (reason: string): Promise<void> =>\n    runtime.intelligence\n      .ɵcleanupThreadLock({\n        threadId: canonicalThreadId || input.threadId,\n        runId: canonicalRunId || input.runId,\n      })\n      .catch((cleanupError) => {\n        logger.error(\n          { err: cleanupError, reason },\n          \"Failed to cleanup thread lock\",\n        );\n      });\n\n  if (!canonicalThreadId || !canonicalRunId || !joinToken) {\n    await cleanupLock(\"malformed-lock-response\");\n    return Response.json(\n      {\n        error: \"Run connection credentials not available\",\n        message:\n          \"Intelligence platform did not return canonical threadId, runId, and joinToken\",\n      },\n      { status: 502 },\n    );\n  }\n\n  const canonicalInput: RunAgentInput = {\n    ...input,\n    threadId: canonicalThreadId,\n    runId: canonicalRunId,\n  };\n\n  let persistedInputMessages: Message[] | undefined;\n  if (Array.isArray(input.messages)) {\n    try {\n      const historicMessageIds = new Set(\n        await runtime.intelligence.ɵgetThreadMessageIds({\n          threadId: canonicalThreadId,\n          userId,\n        }),\n      );\n      persistedInputMessages = input.messages.filter(\n        (message) => !historicMessageIds.has(message.id),\n      );\n    } catch (error) {\n      logger.error(\"Thread history lookup failed:\", error);\n      await cleanupLock(\"thread-history-lookup-failed\");\n      return Response.json(\n        {\n          error: \"Thread history lookup failed\",\n        },\n        { status: 502 },\n      );\n    }\n  }\n\n  runtimeTelemetry.capture(\"oss.runtime.agent_execution_stream_started\", {});\n\n  // Keep the thread lock alive while the run executes. Transient renewal\n  // failures are retried within the lock's remaining TTL; only a lost lock\n  // (or running out of time) aborts the run.\n  const heartbeat = startThreadLockHeartbeat({\n    renew: (signal) =>\n      runtime.intelligence.ɵrenewThreadLock({\n        threadId: canonicalThreadId,\n        runId: canonicalRunId,\n        ttlSeconds: runtime.lockTtlSeconds,\n        ...(runtime.lockKeyPrefix !== undefined\n          ? { lockKeyPrefix: runtime.lockKeyPrefix }\n          : {}),\n        signal,\n      }),\n    intervalMs: runtime.lockHeartbeatIntervalSeconds * 1_000,\n    fallbackTtlSeconds: runtime.lockTtlSeconds,\n    // The acquire round trip and the history lookup above both run between\n    // the lock request and now, so pass the lifetime the platform set minus\n    // the time already spent.\n    initialTtlSeconds:\n      lockTtlSeconds === undefined\n        ? undefined\n        : lockTtlSeconds - (Date.now() - lockRequestedAt) / 1_000,\n    onLost: (err) => {\n      logger.error(\"Failed to renew thread lock:\", err);\n      try {\n        agent.abortRun();\n      } catch (abortError) {\n        logger.error(\n          \"Failed to abort agent after lock renewal failure:\",\n          abortError,\n        );\n      }\n    },\n  });\n\n  const clearHeartbeat = () => {\n    heartbeat.stop();\n  };\n\n  const runStarted = { current: false };\n  let immediateStartupErrorMessage: string | undefined;\n  let immediateStartupCleanup: Promise<void> | undefined;\n\n  const runRequest: AgentRunnerRunRequest = {\n    threadId: canonicalThreadId,\n    ...(backendThreadId === undefined ? {} : { backendThreadId }),\n    agent,\n    input: canonicalInput,\n    ...(persistedInputMessages !== undefined ? { persistedInputMessages } : {}),\n  };\n\n  const runtimeErrorReporter = getRuntimeErrorReporter(runtime);\n  let agentErrorReported = false;\n  const reportAgentError = (error: unknown, phase: RuntimeErrorPhase) => {\n    if (agentErrorReported) return;\n    agentErrorReported = true;\n    // Analytics describes the outcome; only the application-owned reporter\n    // receives diagnostics that may contain customer or upstream content.\n    runtimeTelemetry.capture(\"oss.runtime.agent_execution_stream_errored\", {\n      error: \"AGENT_EXECUTION_FAILED\",\n    });\n    runtimeErrorReporter?.report({\n      request,\n      error,\n      operation: \"agent.run\",\n      agentId,\n      threadId: canonicalThreadId,\n      runId: canonicalRunId,\n      phase,\n      startTime,\n    });\n  };\n\n  try {\n    const runStart = hasRunnerStartupBoundary(runtime.runner)\n      ? runtime.runner.runWithStartupBoundary(runRequest)\n      : {\n          events: runtime.runner.run(runRequest),\n          startup: Promise.resolve(),\n        };\n\n    runStart.events.subscribe({\n      next: (event: BaseEvent) => {\n        if (event.type === EventType.RUN_STARTED) {\n          runStarted.current = true;\n        }\n        if (event.type === EventType.RUN_ERROR) {\n          const message =\n            \"message\" in event && typeof event.message === \"string\"\n              ? event.message\n              : \"Runner failed before the run started\";\n          reportAgentError(\n            new Error(message),\n            runStarted.current\n              ? \"intelligence.subscription\"\n              : \"intelligence.startup\",\n          );\n          if (!runStarted.current) {\n            clearHeartbeat();\n            immediateStartupErrorMessage = message;\n            immediateStartupCleanup = cleanupLock(\"runner-start-failed\");\n          }\n        }\n      },\n      error: (error) => {\n        reportAgentError(\n          error,\n          runStarted.current\n            ? \"intelligence.subscription\"\n            : \"intelligence.startup\",\n        );\n        clearHeartbeat();\n        if (!runStarted.current) {\n          immediateStartupErrorMessage =\n            error instanceof Error ? error.message : String(error);\n          immediateStartupCleanup = cleanupLock(\"runner-start-error\");\n        } else {\n          cleanupLock(\"runner-error\");\n        }\n        logger.error(\"Error running agent:\", error);\n      },\n      complete: () => {\n        clearHeartbeat();\n        // Preserve the existing completion count even when the stream contains\n        // RUN_ERROR. Failure reporting is separate and carries only a safe code.\n        runtimeTelemetry.capture(\n          \"oss.runtime.agent_execution_stream_ended\",\n          {},\n        );\n      },\n    });\n\n    await runStart.startup;\n  } catch (error) {\n    reportAgentError(error, \"intelligence.startup\");\n    clearHeartbeat();\n    await (immediateStartupCleanup ?? cleanupLock(\"runner-start-threw\"));\n    logger.error(\"Error starting agent runner:\", error);\n    return Response.json(\n      {\n        error: \"Failed to start runner\",\n        message: error instanceof Error ? error.message : String(error),\n      },\n      { status: 502 },\n    );\n  }\n\n  if (immediateStartupErrorMessage) {\n    await immediateStartupCleanup;\n    return Response.json(\n      {\n        error: \"Failed to start runner\",\n        message: immediateStartupErrorMessage,\n      },\n      { status: 502 },\n    );\n  }\n\n  // IntelligenceAgentRunner resolves this boundary after Phoenix channel join.\n  // Other runner implementations fall back to construction/subscription errors.\n  return Response.json(\n    {\n      threadId: canonicalThreadId,\n      runId: canonicalRunId,\n      joinToken,\n      realtime: buildRealtimeConnectionInfo({\n        clientUrl: runtime.intelligence.ɵgetClientWsUrl(),\n        threadId: canonicalThreadId,\n      }),\n    },\n    {\n      headers: { \"Cache-Control\": \"no-cache\" },\n    },\n  );\n}\n"],"mappings":"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"}

package/dist/v2/runtime/handlers/intelligence/run.mjs

@@ -37,6 +37,8 @@ async function handleIntelligenceRun({ runtime, request, agentId, agent, input,
 	const userId = user.id;
 	const proxyRequest = input.forwardedProps?.__proxiedMCPRequest;
 	const isDirectResourceRead = input.forwardedProps?.__copilotkitMcpResourceReadOnly === true && proxyRequest && typeof proxyRequest === "object" && proxyRequest.method === "resources/read";
+	const forwardedRequestId = input.forwardedProps?.__copilotkitRequestId;
+	const requestId = typeof forwardedRequestId === "string" && forwardedRequestId.length > 0 ? forwardedRequestId : void 0;
 	let learningContainerId;
 	try {
 		const selector = runtime.intelligence.ɵgetLearningContainerId?.();
@@ -117,6 +119,7 @@ async function handleIntelligenceRun({ runtime, request, agentId, agent, input,
 			userId,
 			agentId,
 			...learningContainerId !== void 0 ? { learningContainerId } : {},
+			...requestId !== void 0 ? { requestId } : {},
 			...runtime.lockKeyPrefix !== void 0 ? { lockKeyPrefix: runtime.lockKeyPrefix } : {},
 			ttlSeconds: runtime.lockTtlSeconds
 		});

package/dist/v2/runtime/handlers/intelligence/run.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"run.mjs","names":[],"sources":["../../../../../src/v2/runtime/handlers/intelligence/run.ts"],"sourcesContent":["import type {\n  AbstractAgent,\n  BaseEvent,\n  Message,\n  RunAgentInput,\n} from \"@ag-ui/client\";\nimport { EventType } from \"@ag-ui/client\";\nimport type { CopilotIntelligenceRuntimeLike } from \"../../core/runtime\";\nimport { generateThreadNameForNewThread } from \"./thread-names\";\nimport { logger } from \"@copilotkit/shared\";\nimport { telemetry } from \"../../telemetry\";\nimport { resolveIntelligenceUser } from \"../shared/resolve-intelligence-user\";\nimport { isHandlerResponse } from \"../shared/json-response\";\nimport type { AgentRunnerRunRequest } from \"../../runner/agent-runner\";\nimport type { Observable } from \"rxjs\";\nimport { getRuntimeErrorReporter } from \"../../core/runtime-error-reporter\";\nimport type { RuntimeErrorPhase } from \"../../core/runtime-error-reporter\";\nimport {\n  resolveLearningContainerId,\n  resolveLearningContainerSelector,\n} from \"../../core/learning\";\nimport { getPlatformErrorStatus } from \"../shared/intelligence-utils\";\nimport { startThreadLockHeartbeat } from \"../../intelligence-platform/thread-lock-heartbeat\";\nimport type { ThreadSummary } from \"../../intelligence-platform\";\n\n/**\n * Builds browser-facing realtime connection metadata owned by the runtime.\n */\nfunction buildRealtimeConnectionInfo(params: {\n  clientUrl: string;\n  threadId: string;\n}): { clientUrl: string; topic: string } {\n  return {\n    clientUrl: params.clientUrl,\n    topic: `thread:${params.threadId}`,\n  };\n}\n\ninterface RunnerStartupBoundary {\n  events: Observable<BaseEvent>;\n  startup: Promise<void>;\n}\n\ninterface RunnerWithStartupBoundary {\n  runWithStartupBoundary(request: AgentRunnerRunRequest): RunnerStartupBoundary;\n}\n\nfunction hasRunnerStartupBoundary(\n  runner: CopilotIntelligenceRuntimeLike[\"runner\"],\n): runner is CopilotIntelligenceRuntimeLike[\"runner\"] &\n  RunnerWithStartupBoundary {\n  const candidate = runner as { runWithStartupBoundary?: unknown };\n\n  return (\n    typeof candidate.runWithStartupBoundary === \"function\" &&\n    (Object.prototype.hasOwnProperty.call(runner, \"runWithStartupBoundary\") ||\n      Object.prototype.hasOwnProperty.call(runner, \"threads\"))\n  );\n}\n\ninterface HandleIntelligenceRunParams {\n  runtime: CopilotIntelligenceRuntimeLike;\n  request: Request;\n  agentId: string;\n  agent: AbstractAgent;\n  input: RunAgentInput;\n  startTime?: number;\n}\n\nexport async function handleIntelligenceRun({\n  runtime,\n  request,\n  agentId,\n  agent,\n  input,\n  startTime,\n}: HandleIntelligenceRunParams): Promise<Response> {\n  const runtimeTelemetry = runtime.telemetry ?? telemetry;\n\n  if (!runtime.intelligence) {\n    return Response.json(\n      {\n        error: \"Intelligence not configured\",\n        message: \"Intelligence mode requires a CopilotKitIntelligence\",\n      },\n      { status: 500 },\n    );\n  }\n\n  const user = await resolveIntelligenceUser({ runtime, request });\n  if (isHandlerResponse(user)) {\n    return user;\n  }\n  const userId = user.id;\n\n  const proxyRequest = (\n    input.forwardedProps as Record<string, unknown> | undefined\n  )?.__proxiedMCPRequest;\n  const isDirectResourceRead =\n    input.forwardedProps?.__copilotkitMcpResourceReadOnly === true &&\n    proxyRequest &&\n    typeof proxyRequest === \"object\" &&\n    (proxyRequest as { method?: unknown }).method === \"resources/read\";\n\n  let learningContainerId: string | undefined;\n  try {\n    const selector = runtime.intelligence.ɵgetLearningContainerId?.();\n    learningContainerId = selector\n      ? await resolveLearningContainerSelector(selector, {\n          surface: \"web\",\n          user,\n          agentId,\n          input,\n        })\n      : await resolveLearningContainerId(runtime.learning, {\n          surface: \"web\",\n          request,\n          threadId: input.threadId,\n          runId: input.runId,\n          agentId,\n          userId,\n        });\n  } catch (error) {\n    logger.error(\"Failed to resolve Learning Container:\", error);\n    return Response.json(\n      { error: \"Failed to resolve Learning Container\" },\n      { status: 500 },\n    );\n  }\n\n  let thread: ThreadSummary;\n  try {\n    const initialized = await runtime.intelligence.getOrCreateThread({\n      threadId: input.threadId,\n      userId,\n      agentId,\n      ...(learningContainerId !== undefined ? { learningContainerId } : {}),\n    });\n    thread = initialized.thread;\n    const { created } = initialized;\n\n    if (created && runtime.generateThreadNames && !thread.name?.trim()) {\n      void generateThreadNameForNewThread({\n        runtime,\n        request,\n        agentId,\n        sourceInput: input,\n        thread,\n        userId,\n      }).catch((nameError) => {\n        logger.error(\"Failed to generate thread name:\", nameError);\n      });\n    }\n  } catch (error) {\n    logger.error(\"Failed to get or create thread:\", error);\n    const platformStatus = getPlatformErrorStatus(error);\n    return Response.json(\n      {\n        error: \"Failed to initialize thread\",\n      },\n      {\n        status:\n          platformStatus !== undefined &&\n          platformStatus >= 400 &&\n          platformStatus < 500\n            ? platformStatus\n            : 502,\n      },\n    );\n  }\n\n  // MCP App resources are presentation data. Initialize the thread through the\n  // usual path, then fetch without claiming its mutation lock so an approval\n  // can continue while the resource server is still answering.\n  if (isDirectResourceRead) {\n    try {\n      if (thread.agentId && thread.agentId !== agentId) {\n        return Response.json(\n          { error: \"Thread belongs to another agent\" },\n          { status: 403 },\n        );\n      }\n      agent.threadId = thread.id;\n      const run = await agent.runAgent({\n        runId: input.runId,\n        tools: input.tools,\n        context: input.context,\n        forwardedProps: input.forwardedProps,\n      });\n      return Response.json({\n        kind: \"mcp-resource-read\",\n        threadId: thread.id,\n        runId: input.runId,\n        result: run.result ?? null,\n      });\n    } catch (error) {\n      logger.error(\"MCP resource read failed:\", error);\n      const status = getPlatformErrorStatus(error);\n      return Response.json(\n        { error: \"MCP resource read failed\" },\n        { status: status && status >= 400 && status < 500 ? status : 502 },\n      );\n    }\n  }\n\n  let canonicalThreadId = input.threadId;\n  let canonicalRunId = input.runId;\n  let joinToken: string | undefined;\n  let backendThreadId: string | undefined;\n  let lockTtlSeconds: number | undefined;\n  let lockRequestedAt = 0;\n  try {\n    // The platform starts the lock's TTL when it handles the request, so time\n    // the lifetime from the send rather than from the response.\n    lockRequestedAt = Date.now();\n    const lockResult = await runtime.intelligence.ɵacquireThreadLock({\n      supportsBackendThreadId: true,\n      threadId: input.threadId,\n      runId: input.runId,\n      userId,\n      agentId,\n      ...(learningContainerId !== undefined ? { learningContainerId } : {}),\n      ...(runtime.lockKeyPrefix !== undefined\n        ? { lockKeyPrefix: runtime.lockKeyPrefix }\n        : {}),\n      ttlSeconds: runtime.lockTtlSeconds,\n    });\n    canonicalThreadId = lockResult.threadId;\n    canonicalRunId = lockResult.runId;\n    joinToken = lockResult.joinToken;\n    backendThreadId = lockResult.backendThreadId;\n    lockTtlSeconds = lockResult.ttlSeconds;\n  } catch (error) {\n    logger.error(\"Thread lock denied:\", error);\n    const platformStatus = getPlatformErrorStatus(error);\n    return Response.json(\n      {\n        error: \"Thread lock denied\",\n      },\n      {\n        status: platformStatus === 409 ? 409 : 502,\n      },\n    );\n  }\n\n  const cleanupLock = (reason: string): Promise<void> =>\n    runtime.intelligence\n      .ɵcleanupThreadLock({\n        threadId: canonicalThreadId || input.threadId,\n        runId: canonicalRunId || input.runId,\n      })\n      .catch((cleanupError) => {\n        logger.error(\n          { err: cleanupError, reason },\n          \"Failed to cleanup thread lock\",\n        );\n      });\n\n  if (!canonicalThreadId || !canonicalRunId || !joinToken) {\n    await cleanupLock(\"malformed-lock-response\");\n    return Response.json(\n      {\n        error: \"Run connection credentials not available\",\n        message:\n          \"Intelligence platform did not return canonical threadId, runId, and joinToken\",\n      },\n      { status: 502 },\n    );\n  }\n\n  const canonicalInput: RunAgentInput = {\n    ...input,\n    threadId: canonicalThreadId,\n    runId: canonicalRunId,\n  };\n\n  let persistedInputMessages: Message[] | undefined;\n  if (Array.isArray(input.messages)) {\n    try {\n      const historicMessageIds = new Set(\n        await runtime.intelligence.ɵgetThreadMessageIds({\n          threadId: canonicalThreadId,\n          userId,\n        }),\n      );\n      persistedInputMessages = input.messages.filter(\n        (message) => !historicMessageIds.has(message.id),\n      );\n    } catch (error) {\n      logger.error(\"Thread history lookup failed:\", error);\n      await cleanupLock(\"thread-history-lookup-failed\");\n      return Response.json(\n        {\n          error: \"Thread history lookup failed\",\n        },\n        { status: 502 },\n      );\n    }\n  }\n\n  runtimeTelemetry.capture(\"oss.runtime.agent_execution_stream_started\", {});\n\n  // Keep the thread lock alive while the run executes. Transient renewal\n  // failures are retried within the lock's remaining TTL; only a lost lock\n  // (or running out of time) aborts the run.\n  const heartbeat = startThreadLockHeartbeat({\n    renew: (signal) =>\n      runtime.intelligence.ɵrenewThreadLock({\n        threadId: canonicalThreadId,\n        runId: canonicalRunId,\n        ttlSeconds: runtime.lockTtlSeconds,\n        ...(runtime.lockKeyPrefix !== undefined\n          ? { lockKeyPrefix: runtime.lockKeyPrefix }\n          : {}),\n        signal,\n      }),\n    intervalMs: runtime.lockHeartbeatIntervalSeconds * 1_000,\n    fallbackTtlSeconds: runtime.lockTtlSeconds,\n    // The acquire round trip and the history lookup above both run between\n    // the lock request and now, so pass the lifetime the platform set minus\n    // the time already spent.\n    initialTtlSeconds:\n      lockTtlSeconds === undefined\n        ? undefined\n        : lockTtlSeconds - (Date.now() - lockRequestedAt) / 1_000,\n    onLost: (err) => {\n      logger.error(\"Failed to renew thread lock:\", err);\n      try {\n        agent.abortRun();\n      } catch (abortError) {\n        logger.error(\n          \"Failed to abort agent after lock renewal failure:\",\n          abortError,\n        );\n      }\n    },\n  });\n\n  const clearHeartbeat = () => {\n    heartbeat.stop();\n  };\n\n  const runStarted = { current: false };\n  let immediateStartupErrorMessage: string | undefined;\n  let immediateStartupCleanup: Promise<void> | undefined;\n\n  const runRequest: AgentRunnerRunRequest = {\n    threadId: canonicalThreadId,\n    ...(backendThreadId === undefined ? {} : { backendThreadId }),\n    agent,\n    input: canonicalInput,\n    ...(persistedInputMessages !== undefined ? { persistedInputMessages } : {}),\n  };\n\n  const runtimeErrorReporter = getRuntimeErrorReporter(runtime);\n  let agentErrorReported = false;\n  const reportAgentError = (error: unknown, phase: RuntimeErrorPhase) => {\n    if (agentErrorReported) return;\n    agentErrorReported = true;\n    // Analytics describes the outcome; only the application-owned reporter\n    // receives diagnostics that may contain customer or upstream content.\n    runtimeTelemetry.capture(\"oss.runtime.agent_execution_stream_errored\", {\n      error: \"AGENT_EXECUTION_FAILED\",\n    });\n    runtimeErrorReporter?.report({\n      request,\n      error,\n      operation: \"agent.run\",\n      agentId,\n      threadId: canonicalThreadId,\n      runId: canonicalRunId,\n      phase,\n      startTime,\n    });\n  };\n\n  try {\n    const runStart = hasRunnerStartupBoundary(runtime.runner)\n      ? runtime.runner.runWithStartupBoundary(runRequest)\n      : {\n          events: runtime.runner.run(runRequest),\n          startup: Promise.resolve(),\n        };\n\n    runStart.events.subscribe({\n      next: (event: BaseEvent) => {\n        if (event.type === EventType.RUN_STARTED) {\n          runStarted.current = true;\n        }\n        if (event.type === EventType.RUN_ERROR) {\n          const message =\n            \"message\" in event && typeof event.message === \"string\"\n              ? event.message\n              : \"Runner failed before the run started\";\n          reportAgentError(\n            new Error(message),\n            runStarted.current\n              ? \"intelligence.subscription\"\n              : \"intelligence.startup\",\n          );\n          if (!runStarted.current) {\n            clearHeartbeat();\n            immediateStartupErrorMessage = message;\n            immediateStartupCleanup = cleanupLock(\"runner-start-failed\");\n          }\n        }\n      },\n      error: (error) => {\n        reportAgentError(\n          error,\n          runStarted.current\n            ? \"intelligence.subscription\"\n            : \"intelligence.startup\",\n        );\n        clearHeartbeat();\n        if (!runStarted.current) {\n          immediateStartupErrorMessage =\n            error instanceof Error ? error.message : String(error);\n          immediateStartupCleanup = cleanupLock(\"runner-start-error\");\n        } else {\n          cleanupLock(\"runner-error\");\n        }\n        logger.error(\"Error running agent:\", error);\n      },\n      complete: () => {\n        clearHeartbeat();\n        // Preserve the existing completion count even when the stream contains\n        // RUN_ERROR. Failure reporting is separate and carries only a safe code.\n        runtimeTelemetry.capture(\n          \"oss.runtime.agent_execution_stream_ended\",\n          {},\n        );\n      },\n    });\n\n    await runStart.startup;\n  } catch (error) {\n    reportAgentError(error, \"intelligence.startup\");\n    clearHeartbeat();\n    await (immediateStartupCleanup ?? cleanupLock(\"runner-start-threw\"));\n    logger.error(\"Error starting agent runner:\", error);\n    return Response.json(\n      {\n        error: \"Failed to start runner\",\n        message: error instanceof Error ? error.message : String(error),\n      },\n      { status: 502 },\n    );\n  }\n\n  if (immediateStartupErrorMessage) {\n    await immediateStartupCleanup;\n    return Response.json(\n      {\n        error: \"Failed to start runner\",\n        message: immediateStartupErrorMessage,\n      },\n      { status: 502 },\n    );\n  }\n\n  // IntelligenceAgentRunner resolves this boundary after Phoenix channel join.\n  // Other runner implementations fall back to construction/subscription errors.\n  return Response.json(\n    {\n      threadId: canonicalThreadId,\n      runId: canonicalRunId,\n      joinToken,\n      realtime: buildRealtimeConnectionInfo({\n        clientUrl: runtime.intelligence.ɵgetClientWsUrl(),\n        threadId: canonicalThreadId,\n      }),\n    },\n    {\n      headers: { \"Cache-Control\": \"no-cache\" },\n    },\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;AA4BA,SAAS,4BAA4B,QAGI;AACvC,QAAO;EACL,WAAW,OAAO;EAClB,OAAO,UAAU,OAAO;EACzB;;AAYH,SAAS,yBACP,QAE0B;AAG1B,QACE,OAHgB,OAGC,2BAA2B,eAC3C,OAAO,UAAU,eAAe,KAAK,QAAQ,yBAAyB,IACrE,OAAO,UAAU,eAAe,KAAK,QAAQ,UAAU;;AAa7D,eAAsB,sBAAsB,EAC1C,SACA,SACA,SACA,OACA,OACA,aACiD;CACjD,MAAM,mBAAmB,QAAQ,aAAa;AAE9C,KAAI,CAAC,QAAQ,aACX,QAAO,SAAS,KACd;EACE,OAAO;EACP,SAAS;EACV,EACD,EAAE,QAAQ,KAAK,CAChB;CAGH,MAAM,OAAO,MAAM,wBAAwB;EAAE;EAAS;EAAS,CAAC;AAChE,KAAI,kBAAkB,KAAK,CACzB,QAAO;CAET,MAAM,SAAS,KAAK;CAEpB,MAAM,eACJ,MAAM,gBACL;CACH,MAAM,uBACJ,MAAM,gBAAgB,oCAAoC,QAC1D,gBACA,OAAO,iBAAiB,YACvB,aAAsC,WAAW;CAEpD,IAAI;AACJ,KAAI;EACF,MAAM,WAAW,QAAQ,aAAa,2BAA2B;AACjE,wBAAsB,WAClB,MAAM,iCAAiC,UAAU;GAC/C,SAAS;GACT;GACA;GACA;GACD,CAAC,GACF,MAAM,2BAA2B,QAAQ,UAAU;GACjD,SAAS;GACT;GACA,UAAU,MAAM;GAChB,OAAO,MAAM;GACb;GACA;GACD,CAAC;UACC,OAAO;AACd,SAAO,MAAM,yCAAyC,MAAM;AAC5D,SAAO,SAAS,KACd,EAAE,OAAO,wCAAwC,EACjD,EAAE,QAAQ,KAAK,CAChB;;CAGH,IAAI;AACJ,KAAI;EACF,MAAM,cAAc,MAAM,QAAQ,aAAa,kBAAkB;GAC/D,UAAU,MAAM;GAChB;GACA;GACA,GAAI,wBAAwB,SAAY,EAAE,qBAAqB,GAAG,EAAE;GACrE,CAAC;AACF,WAAS,YAAY;EACrB,MAAM,EAAE,YAAY;AAEpB,MAAI,WAAW,QAAQ,uBAAuB,CAAC,OAAO,MAAM,MAAM,CAChE,CAAK,+BAA+B;GAClC;GACA;GACA;GACA,aAAa;GACb;GACA;GACD,CAAC,CAAC,OAAO,cAAc;AACtB,UAAO,MAAM,mCAAmC,UAAU;IAC1D;UAEG,OAAO;AACd,SAAO,MAAM,mCAAmC,MAAM;EACtD,MAAM,iBAAiB,uBAAuB,MAAM;AACpD,SAAO,SAAS,KACd,EACE,OAAO,+BACR,EACD,EACE,QACE,mBAAmB,UACnB,kBAAkB,OAClB,iBAAiB,MACb,iBACA,KACP,CACF;;AAMH,KAAI,qBACF,KAAI;AACF,MAAI,OAAO,WAAW,OAAO,YAAY,QACvC,QAAO,SAAS,KACd,EAAE,OAAO,mCAAmC,EAC5C,EAAE,QAAQ,KAAK,CAChB;AAEH,QAAM,WAAW,OAAO;EACxB,MAAM,MAAM,MAAM,MAAM,SAAS;GAC/B,OAAO,MAAM;GACb,OAAO,MAAM;GACb,SAAS,MAAM;GACf,gBAAgB,MAAM;GACvB,CAAC;AACF,SAAO,SAAS,KAAK;GACnB,MAAM;GACN,UAAU,OAAO;GACjB,OAAO,MAAM;GACb,QAAQ,IAAI,UAAU;GACvB,CAAC;UACK,OAAO;AACd,SAAO,MAAM,6BAA6B,MAAM;EAChD,MAAM,SAAS,uBAAuB,MAAM;AAC5C,SAAO,SAAS,KACd,EAAE,OAAO,4BAA4B,EACrC,EAAE,QAAQ,UAAU,UAAU,OAAO,SAAS,MAAM,SAAS,KAAK,CACnE;;CAIL,IAAI,oBAAoB,MAAM;CAC9B,IAAI,iBAAiB,MAAM;CAC3B,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI,kBAAkB;AACtB,KAAI;AAGF,oBAAkB,KAAK,KAAK;EAC5B,MAAM,aAAa,MAAM,QAAQ,aAAa,mBAAmB;GAC/D,yBAAyB;GACzB,UAAU,MAAM;GAChB,OAAO,MAAM;GACb;GACA;GACA,GAAI,wBAAwB,SAAY,EAAE,qBAAqB,GAAG,EAAE;GACpE,GAAI,QAAQ,kBAAkB,SAC1B,EAAE,eAAe,QAAQ,eAAe,GACxC,EAAE;GACN,YAAY,QAAQ;GACrB,CAAC;AACF,sBAAoB,WAAW;AAC/B,mBAAiB,WAAW;AAC5B,cAAY,WAAW;AACvB,oBAAkB,WAAW;AAC7B,mBAAiB,WAAW;UACrB,OAAO;AACd,SAAO,MAAM,uBAAuB,MAAM;EAC1C,MAAM,iBAAiB,uBAAuB,MAAM;AACpD,SAAO,SAAS,KACd,EACE,OAAO,sBACR,EACD,EACE,QAAQ,mBAAmB,MAAM,MAAM,KACxC,CACF;;CAGH,MAAM,eAAe,WACnB,QAAQ,aACL,mBAAmB;EAClB,UAAU,qBAAqB,MAAM;EACrC,OAAO,kBAAkB,MAAM;EAChC,CAAC,CACD,OAAO,iBAAiB;AACvB,SAAO,MACL;GAAE,KAAK;GAAc;GAAQ,EAC7B,gCACD;GACD;AAEN,KAAI,CAAC,qBAAqB,CAAC,kBAAkB,CAAC,WAAW;AACvD,QAAM,YAAY,0BAA0B;AAC5C,SAAO,SAAS,KACd;GACE,OAAO;GACP,SACE;GACH,EACD,EAAE,QAAQ,KAAK,CAChB;;CAGH,MAAM,iBAAgC;EACpC,GAAG;EACH,UAAU;EACV,OAAO;EACR;CAED,IAAI;AACJ,KAAI,MAAM,QAAQ,MAAM,SAAS,CAC/B,KAAI;EACF,MAAM,qBAAqB,IAAI,IAC7B,MAAM,QAAQ,aAAa,qBAAqB;GAC9C,UAAU;GACV;GACD,CAAC,CACH;AACD,2BAAyB,MAAM,SAAS,QACrC,YAAY,CAAC,mBAAmB,IAAI,QAAQ,GAAG,CACjD;UACM,OAAO;AACd,SAAO,MAAM,iCAAiC,MAAM;AACpD,QAAM,YAAY,+BAA+B;AACjD,SAAO,SAAS,KACd,EACE,OAAO,gCACR,EACD,EAAE,QAAQ,KAAK,CAChB;;AAIL,kBAAiB,QAAQ,8CAA8C,EAAE,CAAC;CAK1E,MAAM,YAAY,yBAAyB;EACzC,QAAQ,WACN,QAAQ,aAAa,iBAAiB;GACpC,UAAU;GACV,OAAO;GACP,YAAY,QAAQ;GACpB,GAAI,QAAQ,kBAAkB,SAC1B,EAAE,eAAe,QAAQ,eAAe,GACxC,EAAE;GACN;GACD,CAAC;EACJ,YAAY,QAAQ,+BAA+B;EACnD,oBAAoB,QAAQ;EAI5B,mBACE,mBAAmB,SACf,SACA,kBAAkB,KAAK,KAAK,GAAG,mBAAmB;EACxD,SAAS,QAAQ;AACf,UAAO,MAAM,gCAAgC,IAAI;AACjD,OAAI;AACF,UAAM,UAAU;YACT,YAAY;AACnB,WAAO,MACL,qDACA,WACD;;;EAGN,CAAC;CAEF,MAAM,uBAAuB;AAC3B,YAAU,MAAM;;CAGlB,MAAM,aAAa,EAAE,SAAS,OAAO;CACrC,IAAI;CACJ,IAAI;CAEJ,MAAM,aAAoC;EACxC,UAAU;EACV,GAAI,oBAAoB,SAAY,EAAE,GAAG,EAAE,iBAAiB;EAC5D;EACA,OAAO;EACP,GAAI,2BAA2B,SAAY,EAAE,wBAAwB,GAAG,EAAE;EAC3E;CAED,MAAM,uBAAuB,wBAAwB,QAAQ;CAC7D,IAAI,qBAAqB;CACzB,MAAM,oBAAoB,OAAgB,UAA6B;AACrE,MAAI,mBAAoB;AACxB,uBAAqB;AAGrB,mBAAiB,QAAQ,8CAA8C,EACrE,OAAO,0BACR,CAAC;AACF,wBAAsB,OAAO;GAC3B;GACA;GACA,WAAW;GACX;GACA,UAAU;GACV,OAAO;GACP;GACA;GACD,CAAC;;AAGJ,KAAI;EACF,MAAM,WAAW,yBAAyB,QAAQ,OAAO,GACrD,QAAQ,OAAO,uBAAuB,WAAW,GACjD;GACE,QAAQ,QAAQ,OAAO,IAAI,WAAW;GACtC,SAAS,QAAQ,SAAS;GAC3B;AAEL,WAAS,OAAO,UAAU;GACxB,OAAO,UAAqB;AAC1B,QAAI,MAAM,SAAS,UAAU,YAC3B,YAAW,UAAU;AAEvB,QAAI,MAAM,SAAS,UAAU,WAAW;KACtC,MAAM,UACJ,aAAa,SAAS,OAAO,MAAM,YAAY,WAC3C,MAAM,UACN;AACN,sBACE,IAAI,MAAM,QAAQ,EAClB,WAAW,UACP,8BACA,uBACL;AACD,SAAI,CAAC,WAAW,SAAS;AACvB,sBAAgB;AAChB,qCAA+B;AAC/B,gCAA0B,YAAY,sBAAsB;;;;GAIlE,QAAQ,UAAU;AAChB,qBACE,OACA,WAAW,UACP,8BACA,uBACL;AACD,oBAAgB;AAChB,QAAI,CAAC,WAAW,SAAS;AACvB,oCACE,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AACxD,+BAA0B,YAAY,qBAAqB;UAE3D,aAAY,eAAe;AAE7B,WAAO,MAAM,wBAAwB,MAAM;;GAE7C,gBAAgB;AACd,oBAAgB;AAGhB,qBAAiB,QACf,4CACA,EAAE,CACH;;GAEJ,CAAC;AAEF,QAAM,SAAS;UACR,OAAO;AACd,mBAAiB,OAAO,uBAAuB;AAC/C,kBAAgB;AAChB,SAAO,2BAA2B,YAAY,qBAAqB;AACnE,SAAO,MAAM,gCAAgC,MAAM;AACnD,SAAO,SAAS,KACd;GACE,OAAO;GACP,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;GAChE,EACD,EAAE,QAAQ,KAAK,CAChB;;AAGH,KAAI,8BAA8B;AAChC,QAAM;AACN,SAAO,SAAS,KACd;GACE,OAAO;GACP,SAAS;GACV,EACD,EAAE,QAAQ,KAAK,CAChB;;AAKH,QAAO,SAAS,KACd;EACE,UAAU;EACV,OAAO;EACP;EACA,UAAU,4BAA4B;GACpC,WAAW,QAAQ,aAAa,iBAAiB;GACjD,UAAU;GACX,CAAC;EACH,EACD,EACE,SAAS,EAAE,iBAAiB,YAAY,EACzC,CACF"}
+{"version":3,"file":"run.mjs","names":[],"sources":["../../../../../src/v2/runtime/handlers/intelligence/run.ts"],"sourcesContent":["import type {\n  AbstractAgent,\n  BaseEvent,\n  Message,\n  RunAgentInput,\n} from \"@ag-ui/client\";\nimport { EventType } from \"@ag-ui/client\";\nimport type { CopilotIntelligenceRuntimeLike } from \"../../core/runtime\";\nimport { generateThreadNameForNewThread } from \"./thread-names\";\nimport { logger } from \"@copilotkit/shared\";\nimport { telemetry } from \"../../telemetry\";\nimport { resolveIntelligenceUser } from \"../shared/resolve-intelligence-user\";\nimport { isHandlerResponse } from \"../shared/json-response\";\nimport type { AgentRunnerRunRequest } from \"../../runner/agent-runner\";\nimport type { Observable } from \"rxjs\";\nimport { getRuntimeErrorReporter } from \"../../core/runtime-error-reporter\";\nimport type { RuntimeErrorPhase } from \"../../core/runtime-error-reporter\";\nimport {\n  resolveLearningContainerId,\n  resolveLearningContainerSelector,\n} from \"../../core/learning\";\nimport { getPlatformErrorStatus } from \"../shared/intelligence-utils\";\nimport { startThreadLockHeartbeat } from \"../../intelligence-platform/thread-lock-heartbeat\";\nimport type { ThreadSummary } from \"../../intelligence-platform\";\n\n/**\n * Builds browser-facing realtime connection metadata owned by the runtime.\n */\nfunction buildRealtimeConnectionInfo(params: {\n  clientUrl: string;\n  threadId: string;\n}): { clientUrl: string; topic: string } {\n  return {\n    clientUrl: params.clientUrl,\n    topic: `thread:${params.threadId}`,\n  };\n}\n\ninterface RunnerStartupBoundary {\n  events: Observable<BaseEvent>;\n  startup: Promise<void>;\n}\n\ninterface RunnerWithStartupBoundary {\n  runWithStartupBoundary(request: AgentRunnerRunRequest): RunnerStartupBoundary;\n}\n\nfunction hasRunnerStartupBoundary(\n  runner: CopilotIntelligenceRuntimeLike[\"runner\"],\n): runner is CopilotIntelligenceRuntimeLike[\"runner\"] &\n  RunnerWithStartupBoundary {\n  const candidate = runner as { runWithStartupBoundary?: unknown };\n\n  return (\n    typeof candidate.runWithStartupBoundary === \"function\" &&\n    (Object.prototype.hasOwnProperty.call(runner, \"runWithStartupBoundary\") ||\n      Object.prototype.hasOwnProperty.call(runner, \"threads\"))\n  );\n}\n\ninterface HandleIntelligenceRunParams {\n  runtime: CopilotIntelligenceRuntimeLike;\n  request: Request;\n  agentId: string;\n  agent: AbstractAgent;\n  input: RunAgentInput;\n  startTime?: number;\n}\n\nexport async function handleIntelligenceRun({\n  runtime,\n  request,\n  agentId,\n  agent,\n  input,\n  startTime,\n}: HandleIntelligenceRunParams): Promise<Response> {\n  const runtimeTelemetry = runtime.telemetry ?? telemetry;\n\n  if (!runtime.intelligence) {\n    return Response.json(\n      {\n        error: \"Intelligence not configured\",\n        message: \"Intelligence mode requires a CopilotKitIntelligence\",\n      },\n      { status: 500 },\n    );\n  }\n\n  const user = await resolveIntelligenceUser({ runtime, request });\n  if (isHandlerResponse(user)) {\n    return user;\n  }\n  const userId = user.id;\n\n  const proxyRequest = (\n    input.forwardedProps as Record<string, unknown> | undefined\n  )?.__proxiedMCPRequest;\n  const isDirectResourceRead =\n    input.forwardedProps?.__copilotkitMcpResourceReadOnly === true &&\n    proxyRequest &&\n    typeof proxyRequest === \"object\" &&\n    (proxyRequest as { method?: unknown }).method === \"resources/read\";\n\n  // CopilotKit core sends one request ID across a request's follow-up runs\n  // and resumes. Older clients send none, and the platform then uses the run ID.\n  const forwardedRequestId = input.forwardedProps?.__copilotkitRequestId;\n  const requestId =\n    typeof forwardedRequestId === \"string\" && forwardedRequestId.length > 0\n      ? forwardedRequestId\n      : undefined;\n\n  let learningContainerId: string | undefined;\n  try {\n    const selector = runtime.intelligence.ɵgetLearningContainerId?.();\n    learningContainerId = selector\n      ? await resolveLearningContainerSelector(selector, {\n          surface: \"web\",\n          user,\n          agentId,\n          input,\n        })\n      : await resolveLearningContainerId(runtime.learning, {\n          surface: \"web\",\n          request,\n          threadId: input.threadId,\n          runId: input.runId,\n          agentId,\n          userId,\n        });\n  } catch (error) {\n    logger.error(\"Failed to resolve Learning Container:\", error);\n    return Response.json(\n      { error: \"Failed to resolve Learning Container\" },\n      { status: 500 },\n    );\n  }\n\n  let thread: ThreadSummary;\n  try {\n    const initialized = await runtime.intelligence.getOrCreateThread({\n      threadId: input.threadId,\n      userId,\n      agentId,\n      ...(learningContainerId !== undefined ? { learningContainerId } : {}),\n    });\n    thread = initialized.thread;\n    const { created } = initialized;\n\n    if (created && runtime.generateThreadNames && !thread.name?.trim()) {\n      void generateThreadNameForNewThread({\n        runtime,\n        request,\n        agentId,\n        sourceInput: input,\n        thread,\n        userId,\n      }).catch((nameError) => {\n        logger.error(\"Failed to generate thread name:\", nameError);\n      });\n    }\n  } catch (error) {\n    logger.error(\"Failed to get or create thread:\", error);\n    const platformStatus = getPlatformErrorStatus(error);\n    return Response.json(\n      {\n        error: \"Failed to initialize thread\",\n      },\n      {\n        status:\n          platformStatus !== undefined &&\n          platformStatus >= 400 &&\n          platformStatus < 500\n            ? platformStatus\n            : 502,\n      },\n    );\n  }\n\n  // MCP App resources are presentation data. Initialize the thread through the\n  // usual path, then fetch without claiming its mutation lock so an approval\n  // can continue while the resource server is still answering.\n  if (isDirectResourceRead) {\n    try {\n      if (thread.agentId && thread.agentId !== agentId) {\n        return Response.json(\n          { error: \"Thread belongs to another agent\" },\n          { status: 403 },\n        );\n      }\n      agent.threadId = thread.id;\n      const run = await agent.runAgent({\n        runId: input.runId,\n        tools: input.tools,\n        context: input.context,\n        forwardedProps: input.forwardedProps,\n      });\n      return Response.json({\n        kind: \"mcp-resource-read\",\n        threadId: thread.id,\n        runId: input.runId,\n        result: run.result ?? null,\n      });\n    } catch (error) {\n      logger.error(\"MCP resource read failed:\", error);\n      const status = getPlatformErrorStatus(error);\n      return Response.json(\n        { error: \"MCP resource read failed\" },\n        { status: status && status >= 400 && status < 500 ? status : 502 },\n      );\n    }\n  }\n\n  let canonicalThreadId = input.threadId;\n  let canonicalRunId = input.runId;\n  let joinToken: string | undefined;\n  let backendThreadId: string | undefined;\n  let lockTtlSeconds: number | undefined;\n  let lockRequestedAt = 0;\n  try {\n    // The platform starts the lock's TTL when it handles the request, so time\n    // the lifetime from the send rather than from the response.\n    lockRequestedAt = Date.now();\n    const lockResult = await runtime.intelligence.ɵacquireThreadLock({\n      supportsBackendThreadId: true,\n      threadId: input.threadId,\n      runId: input.runId,\n      userId,\n      agentId,\n      ...(learningContainerId !== undefined ? { learningContainerId } : {}),\n      ...(requestId !== undefined ? { requestId } : {}),\n      ...(runtime.lockKeyPrefix !== undefined\n        ? { lockKeyPrefix: runtime.lockKeyPrefix }\n        : {}),\n      ttlSeconds: runtime.lockTtlSeconds,\n    });\n    canonicalThreadId = lockResult.threadId;\n    canonicalRunId = lockResult.runId;\n    joinToken = lockResult.joinToken;\n    backendThreadId = lockResult.backendThreadId;\n    lockTtlSeconds = lockResult.ttlSeconds;\n  } catch (error) {\n    logger.error(\"Thread lock denied:\", error);\n    const platformStatus = getPlatformErrorStatus(error);\n    return Response.json(\n      {\n        error: \"Thread lock denied\",\n      },\n      {\n        status: platformStatus === 409 ? 409 : 502,\n      },\n    );\n  }\n\n  const cleanupLock = (reason: string): Promise<void> =>\n    runtime.intelligence\n      .ɵcleanupThreadLock({\n        threadId: canonicalThreadId || input.threadId,\n        runId: canonicalRunId || input.runId,\n      })\n      .catch((cleanupError) => {\n        logger.error(\n          { err: cleanupError, reason },\n          \"Failed to cleanup thread lock\",\n        );\n      });\n\n  if (!canonicalThreadId || !canonicalRunId || !joinToken) {\n    await cleanupLock(\"malformed-lock-response\");\n    return Response.json(\n      {\n        error: \"Run connection credentials not available\",\n        message:\n          \"Intelligence platform did not return canonical threadId, runId, and joinToken\",\n      },\n      { status: 502 },\n    );\n  }\n\n  const canonicalInput: RunAgentInput = {\n    ...input,\n    threadId: canonicalThreadId,\n    runId: canonicalRunId,\n  };\n\n  let persistedInputMessages: Message[] | undefined;\n  if (Array.isArray(input.messages)) {\n    try {\n      const historicMessageIds = new Set(\n        await runtime.intelligence.ɵgetThreadMessageIds({\n          threadId: canonicalThreadId,\n          userId,\n        }),\n      );\n      persistedInputMessages = input.messages.filter(\n        (message) => !historicMessageIds.has(message.id),\n      );\n    } catch (error) {\n      logger.error(\"Thread history lookup failed:\", error);\n      await cleanupLock(\"thread-history-lookup-failed\");\n      return Response.json(\n        {\n          error: \"Thread history lookup failed\",\n        },\n        { status: 502 },\n      );\n    }\n  }\n\n  runtimeTelemetry.capture(\"oss.runtime.agent_execution_stream_started\", {});\n\n  // Keep the thread lock alive while the run executes. Transient renewal\n  // failures are retried within the lock's remaining TTL; only a lost lock\n  // (or running out of time) aborts the run.\n  const heartbeat = startThreadLockHeartbeat({\n    renew: (signal) =>\n      runtime.intelligence.ɵrenewThreadLock({\n        threadId: canonicalThreadId,\n        runId: canonicalRunId,\n        ttlSeconds: runtime.lockTtlSeconds,\n        ...(runtime.lockKeyPrefix !== undefined\n          ? { lockKeyPrefix: runtime.lockKeyPrefix }\n          : {}),\n        signal,\n      }),\n    intervalMs: runtime.lockHeartbeatIntervalSeconds * 1_000,\n    fallbackTtlSeconds: runtime.lockTtlSeconds,\n    // The acquire round trip and the history lookup above both run between\n    // the lock request and now, so pass the lifetime the platform set minus\n    // the time already spent.\n    initialTtlSeconds:\n      lockTtlSeconds === undefined\n        ? undefined\n        : lockTtlSeconds - (Date.now() - lockRequestedAt) / 1_000,\n    onLost: (err) => {\n      logger.error(\"Failed to renew thread lock:\", err);\n      try {\n        agent.abortRun();\n      } catch (abortError) {\n        logger.error(\n          \"Failed to abort agent after lock renewal failure:\",\n          abortError,\n        );\n      }\n    },\n  });\n\n  const clearHeartbeat = () => {\n    heartbeat.stop();\n  };\n\n  const runStarted = { current: false };\n  let immediateStartupErrorMessage: string | undefined;\n  let immediateStartupCleanup: Promise<void> | undefined;\n\n  const runRequest: AgentRunnerRunRequest = {\n    threadId: canonicalThreadId,\n    ...(backendThreadId === undefined ? {} : { backendThreadId }),\n    agent,\n    input: canonicalInput,\n    ...(persistedInputMessages !== undefined ? { persistedInputMessages } : {}),\n  };\n\n  const runtimeErrorReporter = getRuntimeErrorReporter(runtime);\n  let agentErrorReported = false;\n  const reportAgentError = (error: unknown, phase: RuntimeErrorPhase) => {\n    if (agentErrorReported) return;\n    agentErrorReported = true;\n    // Analytics describes the outcome; only the application-owned reporter\n    // receives diagnostics that may contain customer or upstream content.\n    runtimeTelemetry.capture(\"oss.runtime.agent_execution_stream_errored\", {\n      error: \"AGENT_EXECUTION_FAILED\",\n    });\n    runtimeErrorReporter?.report({\n      request,\n      error,\n      operation: \"agent.run\",\n      agentId,\n      threadId: canonicalThreadId,\n      runId: canonicalRunId,\n      phase,\n      startTime,\n    });\n  };\n\n  try {\n    const runStart = hasRunnerStartupBoundary(runtime.runner)\n      ? runtime.runner.runWithStartupBoundary(runRequest)\n      : {\n          events: runtime.runner.run(runRequest),\n          startup: Promise.resolve(),\n        };\n\n    runStart.events.subscribe({\n      next: (event: BaseEvent) => {\n        if (event.type === EventType.RUN_STARTED) {\n          runStarted.current = true;\n        }\n        if (event.type === EventType.RUN_ERROR) {\n          const message =\n            \"message\" in event && typeof event.message === \"string\"\n              ? event.message\n              : \"Runner failed before the run started\";\n          reportAgentError(\n            new Error(message),\n            runStarted.current\n              ? \"intelligence.subscription\"\n              : \"intelligence.startup\",\n          );\n          if (!runStarted.current) {\n            clearHeartbeat();\n            immediateStartupErrorMessage = message;\n            immediateStartupCleanup = cleanupLock(\"runner-start-failed\");\n          }\n        }\n      },\n      error: (error) => {\n        reportAgentError(\n          error,\n          runStarted.current\n            ? \"intelligence.subscription\"\n            : \"intelligence.startup\",\n        );\n        clearHeartbeat();\n        if (!runStarted.current) {\n          immediateStartupErrorMessage =\n            error instanceof Error ? error.message : String(error);\n          immediateStartupCleanup = cleanupLock(\"runner-start-error\");\n        } else {\n          cleanupLock(\"runner-error\");\n        }\n        logger.error(\"Error running agent:\", error);\n      },\n      complete: () => {\n        clearHeartbeat();\n        // Preserve the existing completion count even when the stream contains\n        // RUN_ERROR. Failure reporting is separate and carries only a safe code.\n        runtimeTelemetry.capture(\n          \"oss.runtime.agent_execution_stream_ended\",\n          {},\n        );\n      },\n    });\n\n    await runStart.startup;\n  } catch (error) {\n    reportAgentError(error, \"intelligence.startup\");\n    clearHeartbeat();\n    await (immediateStartupCleanup ?? cleanupLock(\"runner-start-threw\"));\n    logger.error(\"Error starting agent runner:\", error);\n    return Response.json(\n      {\n        error: \"Failed to start runner\",\n        message: error instanceof Error ? error.message : String(error),\n      },\n      { status: 502 },\n    );\n  }\n\n  if (immediateStartupErrorMessage) {\n    await immediateStartupCleanup;\n    return Response.json(\n      {\n        error: \"Failed to start runner\",\n        message: immediateStartupErrorMessage,\n      },\n      { status: 502 },\n    );\n  }\n\n  // IntelligenceAgentRunner resolves this boundary after Phoenix channel join.\n  // Other runner implementations fall back to construction/subscription errors.\n  return Response.json(\n    {\n      threadId: canonicalThreadId,\n      runId: canonicalRunId,\n      joinToken,\n      realtime: buildRealtimeConnectionInfo({\n        clientUrl: runtime.intelligence.ɵgetClientWsUrl(),\n        threadId: canonicalThreadId,\n      }),\n    },\n    {\n      headers: { \"Cache-Control\": \"no-cache\" },\n    },\n  );\n}\n"],"mappings":"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"}

package/dist/v2/runtime/handlers/shared/agent-utils.cjs

@@ -3,6 +3,7 @@ const require_runtime = require('../../../../_virtual/_rolldown/runtime.cjs');
 const require_header_utils = require('../header-utils.cjs');
 const require_runtime$1 = require('../../core/runtime.cjs');
 const require_client = require('../../intelligence-platform/client.cjs');
+const require_generative_ui_middleware = require('../../generative-ui/generative-ui-middleware.cjs');
 const require_mcp_apps_servers = require('./mcp-apps-servers.cjs');
 const require_json_response = require('./json-response.cjs');
 const require_resolve_intelligence_user = require('./resolve-intelligence-user.cjs');
@@ -67,6 +68,12 @@ function configureAgentForRequest(params) {
 		const targetAgents = typeof config === "object" ? config.agents : void 0;
 		if ((!targetAgents || targetAgents.includes(agentId)) && typeof agent.use === "function") agent.use(new _copilotkit_shared_event_transforms.OpenGenerativeUIMiddleware());
 	}
+	const generativeUI = runtime.generativeUI;
+	const transport = params.providerGenerativeUITransport;
+	if ((transport === "tool" || transport !== "markdown" && !!generativeUI) && generativeUI !== false && typeof agent.use === "function") {
+		const targetAgents = typeof generativeUI === "object" ? generativeUI.agents : void 0;
+		if (!targetAgents || targetAgents.includes(agentId)) agent.use(new require_generative_ui_middleware.GenerativeUIMiddleware());
+	}
 	agent.headers = require_header_utils.mergeForwardableHeaders(agent.headers, request, runtime.forwardHeadersPolicy ?? require_header_utils.resolveForwardHeadersPolicy(void 0));
 }
 /**