@copilotkit/core 1.79.1 → 1.79.2-canary.1792172552

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;
@@ -3607,6 +3637,17 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 	* takes no reason and whose signals never expose one.
 	*/
 	const liveHITLStops = /* @__PURE__ */ new WeakMap();
+	/**
+	* Edits `agent.messages` by replacing the array instead of changing it in
+	* place. The current array may be the one the agent emitted with its last
+	* update, which subscribers and stored snapshots still hold. Like the in-place
+	* edit it replaces, this notifies no subscriber.
+	*/
+	function editAgentMessages(agent, edit) {
+		const messages = [...agent.messages];
+		edit(messages);
+		agent.messages = messages;
+	}
 	function discardAbortedResult(signal, discardOnAbort, errorMessage) {
 		var _liveHITLStops$get;
 		return !!(discardOnAbort && (signal === null || signal === void 0 ? void 0 : signal.aborted) && !(((_liveHITLStops$get = liveHITLStops.get(signal)) === null || _liveHITLStops$get === void 0 ? void 0 : _liveHITLStops$get()) && errorMessage));
@@ -3873,7 +3914,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 +4008,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;
@@ -4062,7 +4103,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 					if (existingResultIndex !== -1) newMessages.splice(existingResultIndex, 1);
 					existingResult = void 0;
 					const agentMsgIdx = agent.messages.findIndex((m) => m.role === "tool" && m.toolCallId === toolCall.id);
-					if (agentMsgIdx !== -1) agent.messages.splice(agentMsgIdx, 1);
+					if (agentMsgIdx !== -1) editAgentMessages(agent, (messages) => messages.splice(agentMsgIdx, 1));
 				}
 				if (!existingResult) {
 					var _this$_interactionAbo2, _interactionControlle;
@@ -4243,7 +4284,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 					toolCallId: toolCall.id,
 					content: handlerResult.content
 				};
-				agent.messages.splice(insertAt, 0, toolMessage);
+				editAgentMessages(agent, (messages) => messages.splice(insertAt, 0, toolMessage));
 				if (!handlerResult.error && (tool === null || tool === void 0 ? void 0 : tool.followUp) !== false) return true;
 			}
 			return false;
@@ -4343,7 +4384,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 					toolCallId: toolCall.id,
 					content: toolCallResult
 				};
-				agent.messages.splice(insertAt, 0, toolMessage);
+				editAgentMessages(agent, (messages) => messages.splice(insertAt, 0, toolMessage));
 				if (!errorMessage && (wildcardTool === null || wildcardTool === void 0 ? void 0 : wildcardTool.followUp) !== false) return true;
 			}
 			return false;
@@ -4397,7 +4438,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 				content: "",
 				toolCalls: [assistantToolCall]
 			};
-			agent.messages.push(assistantMessage);
+			editAgentMessages(agent, (messages) => messages.push(assistantMessage));
 			let handlerResult = {
 				content: "",
 				result: "",
@@ -4419,8 +4460,8 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 				content: handlerResult.content
 			};
 			const assistantIndex = agent.messages.findIndex((m) => m.id === assistantMessage.id);
-			if (assistantIndex !== -1) agent.messages.splice(assistantIndex + 1, 0, toolResultMessage);
-			else agent.messages.push(toolResultMessage);
+			if (assistantIndex !== -1) editAgentMessages(agent, (messages) => messages.splice(assistantIndex + 1, 0, toolResultMessage));
+			else editAgentMessages(agent, (messages) => messages.push(toolResultMessage));
 			if (!handlerResult.error && followUp !== false) {
 				if (typeof followUp === "string" && followUp !== "generate") {
 					const userMessage = {
@@ -4428,7 +4469,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 						role: "user",
 						content: followUp
 					};
-					agent.messages.push(userMessage);
+					editAgentMessages(agent, (messages) => messages.push(userMessage));
 				}
 				await this._internal.waitForPendingFrameworkUpdates();
 				await this.runAgent({ agent });
@@ -4501,7 +4542,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 +4566,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)
 					});
 				}
 			};
@@ -6969,6 +7011,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 +9141,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;