@copilotkit/core 1.79.0 → 1.79.1-canary.1792089208

package/dist/index.umd.js

@@ -23,7 +23,17 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
 //#endregion
 //#region src/utils/connect-replay.ts
-/**
+	const connectRunErrorPhases = /* @__PURE__ */ new WeakMap();
+	/**
+	* The phase in which a connection received `event`, as recorded when it
+	* arrived. Events that did not come through a connection with replay
+	* boundaries report `unknown`.
+	*/
+	function ɵgetConnectRunErrorPhase(event) {
+		var _connectRunErrorPhase;
+		return (_connectRunErrorPhase = connectRunErrorPhases.get(event)) !== null && _connectRunErrorPhase !== void 0 ? _connectRunErrorPhase : "unknown";
+	}
+	/**
 	* Runs an agent's `connect()` stream through the AbstractAgent apply pipeline
 	* with the `verifyEvents` step omitted.
 	*
@@ -78,6 +88,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			let result;
 			const previousMessageIds = new Set(agent.messages.map((m) => m.id));
 			let isReplaying = true;
+			let reportsReplayPhase = false;
 			const liveErrors = /* @__PURE__ */ new WeakSet();
 			const subscribers = [
 				{
@@ -125,15 +136,19 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			};
 			const lifecycle = {
 				onReplayStarted: () => {
+					reportsReplayPhase = true;
 					isReplaying = true;
 					agent.isRunning = true;
 				},
 				onReplayFinished: () => {
+					reportsReplayPhase = true;
 					isReplaying = false;
 				}
 			};
 			const source$ = (0, rxjs.defer)(() => new _ag_ui_client.CompatibilityBoundary().run(input, { run: () => connect ? connect(input, lifecycle) : self.connect(input) })).pipe((0, rxjs_operators.tap)((event) => {
-				if (!isReplaying && event.type === _ag_ui_client.EventType.RUN_ERROR) liveErrors.add(event);
+				if (event.type !== _ag_ui_client.EventType.RUN_ERROR) return;
+				if (!isReplaying) liveErrors.add(event);
+				if (reportsReplayPhase) connectRunErrorPhases.set(event, isReplaying ? "replay" : "live");
 			}), (0, _ag_ui_client.transformChunks)(self.debugLogger), (0, rxjs_operators.takeUntil)(activeRunDetach$));
 			const applied$ = self.apply(input, source$, subscribers);
 			await (0, rxjs.lastValueFrom)(self.processApplyEvents(input, applied$, subscribers).pipe((0, rxjs_operators.catchError)((error) => {
@@ -342,6 +357,20 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		}
 	};
 	/**
+	* The gateway could not replay a live run's events, so the client cannot
+	* verify the run it is following. The run itself may still be going on the
+	* server; reconnecting to the thread shows its real state.
+	*/
+	var IntelligenceReplayFailedError = class extends Error {
+		constructor(threadId, runId) {
+			super("The run's events could not be replayed. Reconnect to the thread to check the run's status.");
+			this.threadId = threadId;
+			this.runId = runId;
+			_defineProperty(this, "code", "INTELLIGENCE_REPLAY_FAILED");
+			this.name = "IntelligenceReplayFailedError";
+		}
+	};
+	/**
 	* Type guard for {@link RunCompletionAware}. Returns true when `agent` exposes
 	* an `activeRunCompletionPromise` property, so callers can await an in-flight
 	* run without an `as unknown as` cast. Returns false for agents that don't
@@ -672,6 +701,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 				};
 				const replayFailed$ = channel$.pipe((0, rxjs_operators.switchMap)(({ channel }) => this.observeChannelEvent$(channel, REPLAY_FAILED_EVENT)), (0, rxjs_operators.tap)(() => {
 					controlCursor.replayFailed = true;
+					if (options.streamMode === "run") throw new IntelligenceReplayFailedError(credentials.threadId, credentials.runId);
 				}));
 				const replayComplete$ = this.observeControlEvent$(input.threadId, channel$, REPLAY_COMPLETE_EVENT, controlCursor).pipe((0, rxjs_operators.tap)(() => {
 					var _options$lifecycle2, _options$lifecycle2$o;
@@ -3873,7 +3903,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 					forwardedProps: this._internal.properties,
 					tools: this.buildFrontendTools(agent.agentId),
 					context: this._internal.getContextForAgent(agent.agentId)
-				}, this.createAgentErrorSubscriber(agent));
+				}, this.createAgentErrorSubscriber(agent, "connect"));
 				if (this._connectionGenerations.get(agent) !== connection || ((_agent$threadId4 = agent.threadId) !== null && _agent$threadId4 !== void 0 ? _agent$threadId4 : null) !== incomingThreadId) return runAgentResult;
 				const controller = new AbortController();
 				const replay = (_this$_interactionAbo = this._interactionAbortControllers.get(agent)) !== null && _this$_interactionAbo !== void 0 ? _this$_interactionAbo : {
@@ -3967,7 +3997,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			this._runDepth++;
 			try {
 				let logicalRunId = resumedRunId !== null && resumedRunId !== void 0 ? resumedRunId : runId;
-				const agentSubscriber = this.createAgentErrorSubscriber(agent);
+				const agentSubscriber = this.createAgentErrorSubscriber(agent, "run");
 				let started = false;
 				const onRunStartedEvent = agentSubscriber.onRunStartedEvent;
 				const onRunInitialized = agentSubscriber.onRunInitialized;
@@ -4501,7 +4531,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		/**
 		* Create an agent error subscriber
 		*/
-		createAgentErrorSubscriber(agent) {
+		createAgentErrorSubscriber(agent, stream) {
 			const emitAgentError = async (error, code, extraContext = {}) => {
 				const context = { ...extraContext };
 				if (agent.agentId) context.agentId = agent.agentId;
@@ -4525,7 +4555,8 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 					await emitAgentError(rawError, CopilotKitCoreErrorCode.AGENT_RUN_ERROR_EVENT, {
 						source: "onRunErrorEvent",
 						event,
-						runtimeErrorCode: event === null || event === void 0 ? void 0 : event.code
+						runtimeErrorCode: event === null || event === void 0 ? void 0 : event.code,
+						phase: stream === "run" ? "live" : ɵgetConnectRunErrorPhase(event)
 					});
 				}
 			};
@@ -5641,7 +5672,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 				});
 			}
 			if (config.sink === void 0) {
-				if (options.learningContainerIds !== void 0) console.warn("[CopilotKit] learningContainerIds is supported only with a custom sink. Authenticated Trajectory capture does not assign Learning Containers; remove learningContainerIds from the capture options.");
+				if (options.learningContainerIds !== void 0) console.warn("[CopilotKit] learningContainerIds is supported only with a custom sink. Authenticated Trajectory capture ignores it; assign Learning Spaces on the server with getTrajectoryLearningContainerIds on CopilotKitIntelligence, and remove learningContainerIds from the capture options.");
 				this.stopLegacy();
 				return this.connection.start(options.trajectoryId, config);
 			}
@@ -6969,6 +7000,12 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		CopilotKitCoreErrorCode["AGENT_CONNECT_FAILED"] = "agent_connect_failed";
 		CopilotKitCoreErrorCode["AGENT_RUN_FAILED"] = "agent_run_failed";
 		CopilotKitCoreErrorCode["AGENT_RUN_FAILED_EVENT"] = "agent_run_failed_event";
+		/**
+		* An agent emitted RUN_ERROR. `context.phase` (`RunErrorPhase`) is
+		* `"replay"` when the error belongs to stored thread history replayed on
+		* connect, `"live"` when the run is happening now, and `"unknown"` when the
+		* transport cannot tell. Show a live-failure notice only for `"live"`.
+		*/
 		CopilotKitCoreErrorCode["AGENT_RUN_ERROR_EVENT"] = "agent_run_error_event";
 		CopilotKitCoreErrorCode["TOOL_ARGUMENT_PARSE_FAILED"] = "tool_argument_parse_failed";
 		CopilotKitCoreErrorCode["TOOL_HANDLER_FAILED"] = "tool_handler_failed";
@@ -9093,6 +9130,7 @@ exports.CopilotKitCoreRuntimeConnectionStatus = CopilotKitCoreRuntimeConnectionS
 exports.CopilotKitHeaderResolutionError = CopilotKitHeaderResolutionError;
 exports.INSPECTOR_THREAD_BRIDGE_PLUGIN_ID = INSPECTOR_THREAD_BRIDGE_PLUGIN_ID;
 exports.IntelligenceAgent = IntelligenceAgent;
+exports.IntelligenceReplayFailedError = IntelligenceReplayFailedError;
 exports.MEMORY_ERROR_REGISTRY = MEMORY_ERROR_REGISTRY;
 exports.MemoryError = MemoryError;
 exports.ProxiedCopilotRuntimeAgent = ProxiedCopilotRuntimeAgent;