@copilotkit/core 1.79.0 → 1.79.1-canary.1792034358

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;
@@ -3787,7 +3816,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 +3907,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;
@@ -4383,7 +4412,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 +4435,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)
 				});
 			}
 		};
@@ -5462,7 +5492,7 @@ var LearningBridge = class {
 			});
 		}
 		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);
 		}
@@ -6771,6 +6801,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 +8877,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;