@copilotkit/core 1.79.1 → 1.79.2-canary.1792172552

package/dist/index.mjs

@@ -25,6 +25,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.
@@ -79,6 +88,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 = [
 			{
@@ -126,15 +136,19 @@ async function ɵconnectWithoutEventVerification(agent, parameters, subscriber,
 		};
 		const lifecycle = {
 			onReplayStarted: () => {
+				reportsReplayPhase = true;
 				isReplaying = true;
 				agent.isRunning = true;
 			},
 			onReplayFinished: () => {
+				reportsReplayPhase = true;
 				isReplaying = false;
 			}
 		};
 		const source$ = defer(() => new CompatibilityBoundary().run(input, { run: () => connect ? connect(input, lifecycle) : self.connect(input) })).pipe(tap((event) => {
-			if (!isReplaying && event.type === EventType.RUN_ERROR) liveErrors.add(event);
+			if (event.type !== EventType.RUN_ERROR) return;
+			if (!isReplaying) liveErrors.add(event);
+			if (reportsReplayPhase) connectRunErrorPhases.set(event, isReplaying ? "replay" : "live");
 		}), transformChunks(self.debugLogger), takeUntil(activeRunDetach$));
 		const applied$ = self.apply(input, source$, subscribers);
 		await lastValueFrom(self.processApplyEvents(input, applied$, subscribers).pipe(catchError((error) => {
@@ -301,6 +315,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
@@ -626,6 +654,7 @@ var IntelligenceAgent = class IntelligenceAgent extends AbstractAgent {
 			};
 			const replayFailed$ = channel$.pipe(switchMap$1(({ channel }) => this.observeChannelEvent$(channel, REPLAY_FAILED_EVENT)), 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(tap(() => {
 				replayFinished = true;
@@ -3450,6 +3479,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));
 }
@@ -3786,7 +3826,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) ?? {
@@ -3877,7 +3917,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;
@@ -3964,7 +4004,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);
@@ -4134,7 +4174,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;
@@ -4227,7 +4267,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;
@@ -4281,7 +4321,7 @@ var RunHandler = class {
 			content: "",
 			toolCalls: [assistantToolCall]
 		};
-		agent.messages.push(assistantMessage);
+		editAgentMessages(agent, (messages) => messages.push(assistantMessage));
 		let handlerResult = {
 			content: "",
 			result: "",
@@ -4303,8 +4343,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 = {
@@ -4312,7 +4352,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 });
@@ -4382,7 +4422,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;
@@ -4405,7 +4445,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)
 				});
 			}
 		};
@@ -6770,6 +6811,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";
@@ -8831,5 +8878,5 @@ function onInspectorViewThreadResult(handler) {
 }
 
 //#endregion
-export { AgentRegistry, AgentThreadLockedError, ContextStore, CopilotKitCore, CopilotKitCoreErrorCode, CopilotKitCoreRuntimeConnectionStatus, CopilotKitHeaderResolutionError, INSPECTOR_THREAD_BRIDGE_PLUGIN_ID, IntelligenceAgent, MEMORY_ERROR_REGISTRY, MemoryError, ProxiedCopilotRuntimeAgent, RunHandler, StateManager, SuggestionEngine, ToolCallStatus, WebMCPRegistry, completePartialMarkdown, createActionGroup, createEffect, createInspectorThreadRequestId, createReducer, createSelector, createStore, emitInspectorActiveThread, emitInspectorStopViewing, emitInspectorViewThread, emitInspectorViewThreadResult, empty, ensureObjectArgs, getWebMCPModelContext, isAbortError, isInspectorThreadBridgeEnabled, isRunCompletionAware, ofType, on, onInspectorActiveThread, onInspectorStopViewing, onInspectorViewThread, onInspectorViewThreadResult, parseToolArguments, props, select, ɵCOPILOTKIT_FEATURES, ɵInterruptState, ɵMAX_SOCKET_RETRIES, ɵRUNTIME_PROBE_TIMEOUT_MS, ɵTHREAD_REQUEST_TIMEOUT_MS, createMemoryStore as ɵcreateMemoryStore, ɵcreateThreadSelectors, createThreadStore as ɵcreateThreadStore, ɵisCopilotKitFeature, ɵisHttpAgent, isRetryableStatus as ɵisRetryableMemoryStatus, ɵjoinPhoenixChannel$, ɵmapMemoryMetadataEvent, ɵmemoryAdapterEvents, ɵmemoryDomainEvents, ɵmemoryReducer, ɵmemoryRestEvents, ɵobservePhoenixEvent$, ɵobservePhoenixJoinOutcome$, ɵobservePhoenixSocketHealth$, ɵobservePhoenixSocketSignals$, ɵphoenixChannel$, ɵphoenixSocket$, ɵselectFetchMoreError, ɵselectHasNextPage, ɵselectIsFetchingNextPage, ɵselectIsMutating, ɵselectMemories, ɵselectMemoriesAvailable, ɵselectMemoriesError, ɵselectMemoriesIsLoading, ɵselectMemoriesIsMutating, ɵselectMemoriesRealtimeStatus, ɵselectThreads, ɵselectThreadsError, ɵselectThreadsIsLoading, ɵthreadAdapterEvents, ɵwithHeaderDefaults };
+export { AgentRegistry, AgentThreadLockedError, ContextStore, CopilotKitCore, CopilotKitCoreErrorCode, CopilotKitCoreRuntimeConnectionStatus, CopilotKitHeaderResolutionError, INSPECTOR_THREAD_BRIDGE_PLUGIN_ID, IntelligenceAgent, IntelligenceReplayFailedError, MEMORY_ERROR_REGISTRY, MemoryError, ProxiedCopilotRuntimeAgent, RunHandler, StateManager, SuggestionEngine, ToolCallStatus, WebMCPRegistry, completePartialMarkdown, createActionGroup, createEffect, createInspectorThreadRequestId, createReducer, createSelector, createStore, emitInspectorActiveThread, emitInspectorStopViewing, emitInspectorViewThread, emitInspectorViewThreadResult, empty, ensureObjectArgs, getWebMCPModelContext, isAbortError, isInspectorThreadBridgeEnabled, isRunCompletionAware, ofType, on, onInspectorActiveThread, onInspectorStopViewing, onInspectorViewThread, onInspectorViewThreadResult, parseToolArguments, props, select, ɵCOPILOTKIT_FEATURES, ɵInterruptState, ɵMAX_SOCKET_RETRIES, ɵRUNTIME_PROBE_TIMEOUT_MS, ɵTHREAD_REQUEST_TIMEOUT_MS, createMemoryStore as ɵcreateMemoryStore, ɵcreateThreadSelectors, createThreadStore as ɵcreateThreadStore, ɵisCopilotKitFeature, ɵisHttpAgent, isRetryableStatus as ɵisRetryableMemoryStatus, ɵjoinPhoenixChannel$, ɵmapMemoryMetadataEvent, ɵmemoryAdapterEvents, ɵmemoryDomainEvents, ɵmemoryReducer, ɵmemoryRestEvents, ɵobservePhoenixEvent$, ɵobservePhoenixJoinOutcome$, ɵobservePhoenixSocketHealth$, ɵobservePhoenixSocketSignals$, ɵphoenixChannel$, ɵphoenixSocket$, ɵselectFetchMoreError, ɵselectHasNextPage, ɵselectIsFetchingNextPage, ɵselectIsMutating, ɵselectMemories, ɵselectMemoriesAvailable, ɵselectMemoriesError, ɵselectMemoriesIsLoading, ɵselectMemoriesIsMutating, ɵselectMemoriesRealtimeStatus, ɵselectThreads, ɵselectThreadsError, ɵselectThreadsIsLoading, ɵthreadAdapterEvents, ɵwithHeaderDefaults };
 //# sourceMappingURL=index.mjs.map