@copilotkit/core 1.79.1 → 1.79.2-canary.1792172552

package/dist/index.cjs

@@ -26,6 +26,15 @@ function ɵisHttpAgent(agent) {
 
 //#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) {
+	return connectRunErrorPhases.get(event) ?? "unknown";
+}
 /**
 * Runs an agent's `connect()` stream through the AbstractAgent apply pipeline
 * with the `verifyEvents` step omitted.
@@ -80,6 +89,7 @@ async function ɵconnectWithoutEventVerification(agent, parameters, subscriber,
 		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 = [
 			{
@@ -127,15 +137,19 @@ async function ɵconnectWithoutEventVerification(agent, parameters, subscriber,
 		};
 		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) => {
@@ -302,6 +316,20 @@ var AgentThreadLockedError = class extends Error {
 	}
 };
 /**
+* 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 {
+	code = "INTELLIGENCE_REPLAY_FAILED";
+	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;
+		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
@@ -627,6 +655,7 @@ var IntelligenceAgent = class IntelligenceAgent extends _ag_ui_client.AbstractAg
 			};
 			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)(() => {
 				replayFinished = true;
@@ -3451,6 +3480,17 @@ var WebMCPRegistry = class {
 * 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) {
 	return !!(discardOnAbort && signal?.aborted && !(liveHITLStops.get(signal)?.() && errorMessage));
 }
@@ -3787,7 +3827,7 @@ var RunHandler = class {
 				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.threadId ?? null) !== incomingThreadId) return runAgentResult;
 			const controller = new AbortController();
 			const replay = this._interactionAbortControllers.get(agent) ?? {
@@ -3878,7 +3918,7 @@ var RunHandler = class {
 		this._runDepth++;
 		try {
 			let logicalRunId = resumedRunId ?? runId;
-			const agentSubscriber = this.createAgentErrorSubscriber(agent);
+			const agentSubscriber = this.createAgentErrorSubscriber(agent, "run");
 			let started = false;
 			const onRunStartedEvent = agentSubscriber.onRunStartedEvent;
 			const onRunInitialized = agentSubscriber.onRunInitialized;
@@ -3965,7 +4005,7 @@ var RunHandler = class {
 				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) {
 				executing.add(executionKey);
@@ -4135,7 +4175,7 @@ var RunHandler = class {
 				toolCallId: toolCall.id,
 				content: handlerResult.content
 			};
-			agent.messages.splice(insertAt, 0, toolMessage);
+			editAgentMessages(agent, (messages) => messages.splice(insertAt, 0, toolMessage));
 			if (!handlerResult.error && tool?.followUp !== false) return true;
 		}
 		return false;
@@ -4228,7 +4268,7 @@ var RunHandler = class {
 				toolCallId: toolCall.id,
 				content: toolCallResult
 			};
-			agent.messages.splice(insertAt, 0, toolMessage);
+			editAgentMessages(agent, (messages) => messages.splice(insertAt, 0, toolMessage));
 			if (!errorMessage && wildcardTool?.followUp !== false) return true;
 		}
 		return false;
@@ -4282,7 +4322,7 @@ var RunHandler = class {
 			content: "",
 			toolCalls: [assistantToolCall]
 		};
-		agent.messages.push(assistantMessage);
+		editAgentMessages(agent, (messages) => messages.push(assistantMessage));
 		let handlerResult = {
 			content: "",
 			result: "",
@@ -4304,8 +4344,8 @@ var RunHandler = class {
 			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 = {
@@ -4313,7 +4353,7 @@ var RunHandler = class {
 					role: "user",
 					content: followUp
 				};
-				agent.messages.push(userMessage);
+				editAgentMessages(agent, (messages) => messages.push(userMessage));
 			}
 			await this._internal.waitForPendingFrameworkUpdates();
 			await this.runAgent({ agent });
@@ -4383,7 +4423,7 @@ var RunHandler = class {
 	/**
 	* 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;
@@ -4406,7 +4446,8 @@ var RunHandler = class {
 				await emitAgentError(rawError, CopilotKitCoreErrorCode.AGENT_RUN_ERROR_EVENT, {
 					source: "onRunErrorEvent",
 					event,
-					runtimeErrorCode: event?.code
+					runtimeErrorCode: event?.code,
+					phase: stream === "run" ? "live" : ɵgetConnectRunErrorPhase(event)
 				});
 			}
 		};
@@ -6771,6 +6812,12 @@ let CopilotKitCoreErrorCode = /* @__PURE__ */ function(CopilotKitCoreErrorCode)
 	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";
@@ -8841,6 +8888,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;