@copilotkit/core 1.68.3 → 1.69.1

package/dist/index.umd.js

@@ -2143,6 +2143,30 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		}
 	};
 
+//#endregion
+//#region src/core/tool-result-content.ts
+/**
+	* Single authority for the forwarded-to-client sentinel used by StateManager
+	* and RunHandler.
+	*/
+	const FORWARDED_TO_CLIENT = "Forwarded to client";
+	function normalizeToolResultContent(content) {
+		if (typeof content === "string") return content.trim();
+		if (Array.isArray(content)) {
+			const text = content.flatMap((part) => {
+				if (typeof part === "string") return [part];
+				if (part && typeof part === "object" && "text" in part && typeof part.text === "string") return [part.text];
+				return [];
+			}).join("").trim();
+			return text.length > 0 ? text : null;
+		}
+		if (content && typeof content === "object" && "text" in content && typeof content.text === "string") return content.text.trim();
+		return null;
+	}
+	function isForwardedToClientPlaceholder(content) {
+		return normalizeToolResultContent(content) === FORWARDED_TO_CLIENT;
+	}
+
 //#endregion
 //#region src/core/run-handler.ts
 /**
@@ -2285,9 +2309,10 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		* Connect an agent (establish initial connection)
 		*/
 		async connectAgent({ agent }) {
+			var _agent$threadId;
+			const incomingThreadId = (_agent$threadId = agent.threadId) !== null && _agent$threadId !== void 0 ? _agent$threadId : null;
 			try {
-				var _agent$threadId, _this$_lastConnectedT;
-				const incomingThreadId = (_agent$threadId = agent.threadId) !== null && _agent$threadId !== void 0 ? _agent$threadId : null;
+				var _this$_lastConnectedT;
 				const restoreKey = this.getConnectRestoreKey(agent);
 				const isFreshRestore = incomingThreadId !== ((_this$_lastConnectedT = this._lastConnectedThreadIdsByAgent.get(restoreKey)) !== null && _this$_lastConnectedT !== void 0 ? _this$_lastConnectedT : null);
 				this._lastConnectedThreadIdsByAgent.set(restoreKey, incomingThreadId);
@@ -2324,6 +2349,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 				if (!(connectError.name === "AbortError" || connectError.message === "Fetch is aborted" || connectError.message === "signal is aborted without reason" || connectError.message === "component unmounted")) {
 					const context = {};
 					if (agent.agentId) context.agentId = agent.agentId;
+					if (incomingThreadId) context.threadId = incomingThreadId;
 					await this._internal.emitError({
 						error: connectError,
 						code: CopilotKitCoreErrorCode.AGENT_CONNECT_FAILED,
@@ -2474,21 +2500,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			return runAgentResult;
 		}
 		isFrontendPlaceholderResult(message) {
-			if (message.role !== "tool") return false;
-			return this.normalizeToolResultContent(message.content) === "Forwarded to client";
-		}
-		normalizeToolResultContent(content) {
-			if (typeof content === "string") return content.trim();
-			if (Array.isArray(content)) {
-				const text = content.flatMap((part) => {
-					if (typeof part === "string") return [part];
-					if (part && typeof part === "object" && "text" in part && typeof part.text === "string") return [part.text];
-					return [];
-				}).join("").trim();
-				return text.length > 0 ? text : null;
-			}
-			if (content && typeof content === "object" && "text" in content && typeof content.text === "string") return content.text.trim();
-			return null;
+			return message.role === "tool" && isForwardedToClientPlaceholder(message.content);
 		}
 		/**
 		* Shared handler execution logic used by executeSpecificTool, executeWildcardTool, and runTool.
@@ -2938,6 +2950,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			this.core = core;
 			_defineProperty(this, "stateByRun", /* @__PURE__ */ new Map());
 			_defineProperty(this, "messageToRun", /* @__PURE__ */ new Map());
+			_defineProperty(this, "rawEventByMessage", /* @__PURE__ */ new Map());
 			_defineProperty(this, "activeRun", /* @__PURE__ */ new Map());
 			_defineProperty(this, "agentSubscriptions", /* @__PURE__ */ new Map());
 			_defineProperty(this, "pendingContinuations", /* @__PURE__ */ new WeakMap());
@@ -2982,6 +2995,74 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			let revoked = false;
 			let subRunId;
 			let runFinished = false;
+			const pendingResults = /* @__PURE__ */ new WeakMap();
+			const reconcilePendingResults = (historyMessages, input) => {
+				const events = pendingResults.get(input);
+				if (!events) return void 0;
+				const messages = [...historyMessages];
+				let changed = false;
+				for (const event of events.values()) {
+					var _messages$insertIndex;
+					const ownerIndex = messages.findIndex((message) => {
+						var _message$toolCalls;
+						return message.role === "assistant" && ((_message$toolCalls = message.toolCalls) === null || _message$toolCalls === void 0 ? void 0 : _message$toolCalls.some((toolCall) => toolCall.id === event.toolCallId));
+					});
+					if (ownerIndex < 0) continue;
+					const matchingIndexes = messages.reduce((indexes, message, index) => {
+						if (message.role === "tool" && message.toolCallId === event.toolCallId) indexes.push(index);
+						return indexes;
+					}, []);
+					const realIndex = matchingIndexes.find((index) => {
+						var _messages$index;
+						return !isForwardedToClientPlaceholder((_messages$index = messages[index]) === null || _messages$index === void 0 ? void 0 : _messages$index.content);
+					});
+					if (realIndex !== void 0) {
+						for (const duplicateIndex of matchingIndexes.filter((candidateIndex) => candidateIndex !== realIndex).sort((a, b) => b - a)) {
+							messages.splice(duplicateIndex, 1);
+							changed = true;
+						}
+						continue;
+					}
+					const placeholderIndex = matchingIndexes.find((index) => {
+						var _messages$index2;
+						return isForwardedToClientPlaceholder((_messages$index2 = messages[index]) === null || _messages$index2 === void 0 ? void 0 : _messages$index2.content);
+					});
+					if (placeholderIndex !== void 0) {
+						if (isForwardedToClientPlaceholder(event.content)) {
+							for (const duplicateIndex of matchingIndexes.slice(1).sort((a, b) => b - a)) {
+								messages.splice(duplicateIndex, 1);
+								changed = true;
+							}
+							continue;
+						}
+						messages[placeholderIndex] = {
+							...messages[placeholderIndex],
+							id: event.messageId,
+							content: event.content
+						};
+						changed = true;
+						for (const duplicateIndex of matchingIndexes.filter((candidateIndex) => {
+							var _messages$candidateIn;
+							return candidateIndex !== placeholderIndex && isForwardedToClientPlaceholder((_messages$candidateIn = messages[candidateIndex]) === null || _messages$candidateIn === void 0 ? void 0 : _messages$candidateIn.content);
+						}).sort((a, b) => b - a)) messages.splice(duplicateIndex, 1);
+						continue;
+					}
+					const result = {
+						id: event.messageId,
+						role: "tool",
+						toolCallId: event.toolCallId,
+						content: event.content
+					};
+					let insertIndex = ownerIndex + 1;
+					while (((_messages$insertIndex = messages[insertIndex]) === null || _messages$insertIndex === void 0 ? void 0 : _messages$insertIndex.role) === "tool") insertIndex++;
+					messages.splice(insertIndex, 0, result);
+					changed = true;
+				}
+				return changed ? { messages } : void 0;
+			};
+			const clearPendingResults = (input) => {
+				pendingResults.delete(input);
+			};
 			const effectiveInput = (input) => {
 				var _subRunId;
 				return {
@@ -2990,28 +3071,52 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 				};
 			};
 			const { unsubscribe } = agent.subscribe({
-				onRunStartedEvent: ({ input, state }) => {
+				onRunStartedEvent: ({ event, input, state }) => {
 					if (revoked) return;
 					const pendingForAgent = this.pendingContinuations.get(agent);
 					const internalContinuation = [...pendingForAgent !== null && pendingForAgent !== void 0 ? pendingForAgent : []].find((pending) => pending.expectedInput === input);
 					internalContinuation === null || internalContinuation === void 0 || internalContinuation.cancel();
-					if (runFinished && input.runId === subRunId && !internalContinuation && !isContinuation(input)) subRunId = (0, _ag_ui_client.randomUUID)();
-					else {
-						var _internalContinuation;
-						subRunId = (_internalContinuation = internalContinuation === null || internalContinuation === void 0 ? void 0 : internalContinuation.expectedRunId) !== null && _internalContinuation !== void 0 ? _internalContinuation : input.runId;
-					}
+					if (internalContinuation) {
+						var _ref, _internalContinuation;
+						subRunId = (_ref = (_internalContinuation = internalContinuation.expectedRunId) !== null && _internalContinuation !== void 0 ? _internalContinuation : event.runId) !== null && _ref !== void 0 ? _ref : input.runId;
+					} else if (runFinished && input.runId === subRunId && !isContinuation(input) && (event.runId == null || event.runId === subRunId)) subRunId = (0, _ag_ui_client.randomUUID)();
+					else subRunId = event.runId || input.runId;
 					runFinished = false;
 					this.handleRunStarted(agent, effectiveInput(input), state);
 				},
-				onRunFinishedEvent: ({ input, state }) => {
+				onRunFinishedEvent: ({ input, state, messages }) => {
 					if (revoked) return;
 					runFinished = true;
-					this.handleRunFinished(agent, effectiveInput(input), state);
+					const effective = effectiveInput(input);
+					const mutation = reconcilePendingResults(messages, input);
+					clearPendingResults(input);
+					this.handleRunFinished(agent, effective, state);
+					return mutation;
 				},
-				onRunErrorEvent: ({ input, state }) => {
+				onRunErrorEvent: ({ input, state, messages }) => {
 					if (revoked) return;
 					runFinished = true;
-					this.handleRunFinished(agent, effectiveInput(input), state);
+					const effective = effectiveInput(input);
+					const mutation = reconcilePendingResults(messages, input);
+					this.handleRunFinished(agent, effective, state);
+					return mutation;
+				},
+				onRunFailed: ({ input, messages }) => {
+					if (revoked) return;
+					return reconcilePendingResults(messages, input);
+				},
+				onRunFinalized: ({ input }) => {
+					if (revoked) return;
+					clearPendingResults(input);
+				},
+				onToolCallResultEvent: ({ event, input }) => {
+					if (revoked) return;
+					let events = pendingResults.get(input);
+					if (!events) {
+						events = /* @__PURE__ */ new Map();
+						pendingResults.set(input, events);
+					}
+					events.set(event.toolCallId, event);
 				},
 				onStateSnapshotEvent: ({ event, input, state }) => {
 					if (revoked) return;
@@ -3021,13 +3126,22 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 					if (revoked) return;
 					this.handleStateDelta(agent, event, effectiveInput(input), state);
 				},
+				onTextMessageStartEvent: ({ event, input }) => {
+					if (revoked) return;
+					this.handleTextMessageStart(agent, event, effectiveInput(input));
+				},
 				onMessagesSnapshotEvent: ({ event, input, messages }) => {
 					if (revoked) return;
 					this.handleMessagesSnapshot(agent, event, effectiveInput(input), messages);
+					this.pruneRawEvents(agent.agentId, input.threadId, event.messages, effectiveInput(input));
 				},
 				onNewMessage: ({ message, input }) => {
 					if (revoked) return;
 					this.handleNewMessage(agent, message, input ? effectiveInput(input) : void 0);
+				},
+				onMessagesChanged: ({ messages, input }) => {
+					if (revoked) return;
+					if (!input) this.pruneRawEvents(agent.agentId, agent.threadId, messages);
 				}
 			});
 			this.agentSubscriptions.set(agentId, () => {
@@ -3045,6 +3159,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 				unsubscribe();
 				this.agentSubscriptions.delete(agentId);
 			}
+			this.rawEventByMessage.delete(agentId);
 		}
 		/**
 		* Get state for a specific run
@@ -3064,6 +3179,14 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			return (_this$messageToRun$ge = this.messageToRun.get(agentId)) === null || _this$messageToRun$ge === void 0 || (_this$messageToRun$ge = _this$messageToRun$ge.get(threadId)) === null || _this$messageToRun$ge === void 0 ? void 0 : _this$messageToRun$ge.get(messageId);
 		}
 		/**
+		* Get direct text-start metadata associated with a message.
+		*/
+		getRawEventForMessage(agentId, threadId, messageId) {
+			var _this$rawEventByMessa;
+			const rawEvent = (_this$rawEventByMessa = this.rawEventByMessage.get(agentId)) === null || _this$rawEventByMessa === void 0 || (_this$rawEventByMessa = _this$rawEventByMessa.get(threadId)) === null || _this$rawEventByMessa === void 0 ? void 0 : _this$rawEventByMessa.get(messageId);
+			return rawEvent === void 0 ? void 0 : (0, _ag_ui_client.structuredClone_)(rawEvent);
+		}
+		/**
 		* Get all states for an agent's thread
 		*/
 		getStatesForThread(agentId, threadId) {
@@ -3117,12 +3240,34 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			this.saveState(agent.agentId, threadId, runId, state);
 		}
 		/**
+		* Capture only defined metadata from a normalized direct text-start event.
+		*/
+		handleTextMessageStart(agent, event, input) {
+			if (!agent.agentId) return;
+			const { threadId } = input;
+			if (event.rawEvent === void 0) {
+				var _this$rawEventByMessa2, _this$rawEventByMessa4;
+				const threadEvents = (_this$rawEventByMessa2 = this.rawEventByMessage.get(agent.agentId)) === null || _this$rawEventByMessa2 === void 0 ? void 0 : _this$rawEventByMessa2.get(threadId);
+				threadEvents === null || threadEvents === void 0 || threadEvents.delete(event.messageId);
+				if ((threadEvents === null || threadEvents === void 0 ? void 0 : threadEvents.size) === 0) {
+					var _this$rawEventByMessa3;
+					(_this$rawEventByMessa3 = this.rawEventByMessage.get(agent.agentId)) === null || _this$rawEventByMessa3 === void 0 || _this$rawEventByMessa3.delete(threadId);
+				}
+				if (((_this$rawEventByMessa4 = this.rawEventByMessage.get(agent.agentId)) === null || _this$rawEventByMessa4 === void 0 ? void 0 : _this$rawEventByMessa4.size) === 0) this.rawEventByMessage.delete(agent.agentId);
+				return;
+			}
+			if (!this.rawEventByMessage.has(agent.agentId)) this.rawEventByMessage.set(agent.agentId, /* @__PURE__ */ new Map());
+			const agentEvents = this.rawEventByMessage.get(agent.agentId);
+			if (!agentEvents.has(threadId)) agentEvents.set(threadId, /* @__PURE__ */ new Map());
+			agentEvents.get(threadId).set(event.messageId, event.rawEvent);
+		}
+		/**
 		* Handle messages snapshot event
 		*/
-		handleMessagesSnapshot(agent, event, input, messages) {
+		handleMessagesSnapshot(agent, event, input, _messages) {
 			if (!agent.agentId) return;
 			const { threadId, runId } = input;
-			for (const message of event.messages) this.associateMessageWithRun(agent.agentId, threadId, message.id, runId);
+			for (const message of event.messages) if (this.getRunIdForMessage(agent.agentId, threadId, message.id) === void 0) this.associateMessageWithRun(agent.agentId, threadId, message.id, runId);
 		}
 		/**
 		* Handle new message event
@@ -3157,20 +3302,36 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			if (!agentMessages.has(threadId)) agentMessages.set(threadId, /* @__PURE__ */ new Map());
 			agentMessages.get(threadId).set(messageId, runId);
 		}
+		pruneRawEvents(agentId, fallbackThreadId, messages, input) {
+			var _input$threadId, _this$rawEventByMessa5, _this$rawEventByMessa7;
+			const threadId = (_input$threadId = input === null || input === void 0 ? void 0 : input.threadId) !== null && _input$threadId !== void 0 ? _input$threadId : fallbackThreadId;
+			if (!threadId) return;
+			const threadEvents = (_this$rawEventByMessa5 = this.rawEventByMessage.get(agentId)) === null || _this$rawEventByMessa5 === void 0 ? void 0 : _this$rawEventByMessa5.get(threadId);
+			if (!threadEvents) return;
+			const messageIds = new Set(messages.map((message) => message.id));
+			for (const messageId of threadEvents.keys()) if (!messageIds.has(messageId)) threadEvents.delete(messageId);
+			if (threadEvents.size === 0) {
+				var _this$rawEventByMessa6;
+				(_this$rawEventByMessa6 = this.rawEventByMessage.get(agentId)) === null || _this$rawEventByMessa6 === void 0 || _this$rawEventByMessa6.delete(threadId);
+			}
+			if (((_this$rawEventByMessa7 = this.rawEventByMessage.get(agentId)) === null || _this$rawEventByMessa7 === void 0 ? void 0 : _this$rawEventByMessa7.size) === 0) this.rawEventByMessage.delete(agentId);
+		}
 		/**
 		* Clear all state for an agent
 		*/
 		clearAgentState(agentId) {
 			this.stateByRun.delete(agentId);
 			this.messageToRun.delete(agentId);
+			this.rawEventByMessage.delete(agentId);
 		}
 		/**
 		* Clear all state for a thread
 		*/
 		clearThreadState(agentId, threadId) {
-			var _this$stateByRun$get4, _this$messageToRun$ge2;
+			var _this$stateByRun$get4, _this$messageToRun$ge2, _this$rawEventByMessa8;
 			(_this$stateByRun$get4 = this.stateByRun.get(agentId)) === null || _this$stateByRun$get4 === void 0 || _this$stateByRun$get4.delete(threadId);
 			(_this$messageToRun$ge2 = this.messageToRun.get(agentId)) === null || _this$messageToRun$ge2 === void 0 || _this$messageToRun$ge2.delete(threadId);
+			(_this$rawEventByMessa8 = this.rawEventByMessage.get(agentId)) === null || _this$rawEventByMessa8 === void 0 || _this$rawEventByMessa8.delete(threadId);
 		}
 	};
 
@@ -5016,6 +5177,9 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		getRunIdForMessage(agentId, threadId, messageId) {
 			return this.stateManager.getRunIdForMessage(agentId, threadId, messageId);
 		}
+		getRawEventForMessage(agentId, threadId, messageId) {
+			return this.stateManager.getRawEventForMessage(agentId, threadId, messageId);
+		}
 		getRunIdsForThread(agentId, threadId) {
 			return this.stateManager.getRunIdsForThread(agentId, threadId);
 		}
@@ -5045,6 +5209,67 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		async waitForPendingFrameworkUpdates() {}
 	};
 
+//#endregion
+//#region src/core/inspect-inject.ts
+	const REMINT_ID_KEYS = [
+		"messageId",
+		"parentMessageId",
+		"toolCallId",
+		"runId"
+	];
+	function newInspectorId() {
+		if (typeof crypto !== "undefined" && "randomUUID" in crypto) return crypto.randomUUID();
+		return `cpk-inject-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
+	}
+	function remintInspectorEventIds(events) {
+		const mapped = /* @__PURE__ */ new Map();
+		const idFor = (value) => {
+			const existing = mapped.get(value);
+			if (existing) return existing;
+			const next = newInspectorId();
+			mapped.set(value, next);
+			return next;
+		};
+		return events.map((event) => {
+			const copy = { ...event };
+			for (const key of REMINT_ID_KEYS) {
+				const value = copy[key];
+				if (typeof value === "string" && value.length > 0) copy[key] = idFor(value);
+			}
+			return copy;
+		});
+	}
+	/**
+	* Inspector-only helper. Apply AG-UI events to a live agent through the
+	* same runAgent path a real agent uses, so chat and frontend-tool handlers
+	* update. Not a documented product API.
+	*/
+	async function ɵinjectInspectorEvents(params) {
+		const { core, agent, events } = params;
+		if (agent.isRunning) throw new Error("The agent is running. Wait for the current run to end.");
+		if (events.length === 0) throw new Error("Snippet JSON must be an array of events.");
+		const before = new Set(agent.messages.map((message) => message.id));
+		const originalRun = agent.run;
+		const runEvents = remintInspectorEventIds(events);
+		agent.run = (_input) => (0, rxjs.from)(runEvents);
+		try {
+			await core.runAgent({ agent });
+		} finally {
+			agent.run = originalRun;
+		}
+		return { messageIds: agent.messages.filter((message) => !before.has(message.id)).map((message) => message.id) };
+	}
+	/**
+	* Remove messages created by the last Inspector inject. Does not undo
+	* frontend-tool handler side effects.
+	*/
+	function ɵresetInspectorInject(params) {
+		const drop = new Set(params.messageIds);
+		if (drop.size === 0) return;
+		const next = params.agent.messages.filter((message) => !drop.has(message.id));
+		params.agent.setMessages(next);
+	}
+
 //#endregion
 //#region src/types.ts
 /**
@@ -5301,6 +5526,16 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		return typeof value === "string" && value.length > 0 ? value : void 0;
 	}
 	/**
+	* REST `/threads` is agent-scoped. The Phoenix `user_meta` channel is not.
+	* Drop live upserts that belong to a different agent, or one Inspector
+	* `all-agents` flatten shows the same thread twice until a hard refresh.
+	*/
+	function threadMetadataTargetsAgent(payload, agentId) {
+		if (!agentId || payload.operation === "deleted") return true;
+		const threadAgentId = optionalString(payload.thread.agentId);
+		return !threadAgentId || threadAgentId === agentId;
+	}
+	/**
 	* Converts gateway run-activity payloads into the internal TypeScript shape.
 	*/
 	function normalizeThreadRunActivityNotification(payload) {
@@ -5733,13 +5968,16 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 						}))), ɵobservePhoenixJoinOutcome$(channel$).pipe((0, rxjs_operators.filter)((outcome) => outcome.type !== "joined"), (0, rxjs_operators.map)((outcome) => outcome.type === "timeout" ? threadSocketEvents.joinTimedOut({ sessionId: action.sessionId }) : threadSocketEvents.joinFailed({ sessionId: action.sessionId })))).pipe((0, rxjs_operators.takeUntil)((0, rxjs.merge)(shutdown$, fatalSocketShutdown$)));
 					});
 				}))),
-				createEffect((actions$, state$) => actions$.pipe(ofType(threadSocketEvents.metadataReceived), (0, rxjs_operators.withLatestFrom)(state$), (0, rxjs_operators.filter)(([action, state]) => action.sessionId === state.sessionId), (0, rxjs_operators.map)(([action, state]) => {
+				createEffect((actions$, state$) => actions$.pipe(ofType(threadSocketEvents.metadataReceived), (0, rxjs_operators.withLatestFrom)(state$), (0, rxjs_operators.filter)(([action, state]) => {
 					var _state$context4;
+					return action.sessionId === state.sessionId && threadMetadataTargetsAgent(action.payload, (_state$context4 = state.context) === null || _state$context4 === void 0 ? void 0 : _state$context4.agentId);
+				}), (0, rxjs_operators.map)(([action, state]) => {
+					var _state$context5;
 					if (action.payload.operation === "deleted") return threadDomainEvents.threadDeleted({
 						sessionId: action.sessionId,
 						threadId: action.payload.deleted.id
 					});
-					if (action.payload.operation === "archived" && !((_state$context4 = state.context) === null || _state$context4 === void 0 ? void 0 : _state$context4.includeArchived)) return threadDomainEvents.threadDeleted({
+					if (action.payload.operation === "archived" && !((_state$context5 = state.context) === null || _state$context5 === void 0 ? void 0 : _state$context5.includeArchived)) return threadDomainEvents.threadDeleted({
 						sessionId: action.sessionId,
 						threadId: action.payload.threadId
 					});
@@ -6121,6 +6359,102 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		};
 	}
 
+//#endregion
+//#region src/inspector-thread-bridge.ts
+	const INSPECTOR_THREAD_BRIDGE_PLUGIN_ID = "cpk-inspector-thread";
+	const EVENT_PREFIX = `copilotkit:${INSPECTOR_THREAD_BRIDGE_PLUGIN_ID}`;
+	function eventName(suffix) {
+		return `${EVENT_PREFIX}:${suffix}`;
+	}
+	function getEventTarget() {
+		var _sharedGlobal$__COPIL;
+		if (typeof window !== "undefined" && typeof window.addEventListener === "function") return window;
+		if (typeof EventTarget === "undefined") return null;
+		const sharedGlobal = globalThis;
+		(_sharedGlobal$__COPIL = sharedGlobal.__COPILOTKIT_INSPECTOR_THREAD_EVENT_TARGET__) !== null && _sharedGlobal$__COPIL !== void 0 || (sharedGlobal.__COPILOTKIT_INSPECTOR_THREAD_EVENT_TARGET__ = new EventTarget());
+		return sharedGlobal.__COPILOTKIT_INSPECTOR_THREAD_EVENT_TARGET__;
+	}
+	function createDetailEvent(name, detail) {
+		if (typeof CustomEvent !== "undefined") return new CustomEvent(name, { detail });
+		const event = new Event(name);
+		Object.defineProperty(event, "detail", { value: detail });
+		return event;
+	}
+	function detailFromEvent(event) {
+		return event.detail;
+	}
+	/** The Inspector thread bridge is development-only. */
+	function isInspectorThreadBridgeEnabled() {
+		return process.env.NODE_ENV !== "production";
+	}
+	function createInspectorThreadRequestId() {
+		if (typeof crypto !== "undefined" && "randomUUID" in crypto) return crypto.randomUUID();
+		return `inspector-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+	}
+	function dispatch(suffix, payload) {
+		if (!isInspectorThreadBridgeEnabled()) return;
+		const target = getEventTarget();
+		if (!target) return;
+		target.dispatchEvent(createDetailEvent(eventName(suffix), payload));
+	}
+	function on$1(suffix, handler) {
+		if (!isInspectorThreadBridgeEnabled()) return () => void 0;
+		const target = getEventTarget();
+		if (!target) return () => void 0;
+		const listener = (event) => {
+			handler(detailFromEvent(event));
+		};
+		const name = eventName(suffix);
+		target.addEventListener(name, listener);
+		return () => target.removeEventListener(name, listener);
+	}
+	/**
+	* Ask the first mounted official chat for the matching agent to load a thread.
+	* Returns false when no chat claims the request synchronously.
+	*/
+	function emitInspectorViewThread(payload) {
+		if (!isInspectorThreadBridgeEnabled()) return false;
+		const target = getEventTarget();
+		if (!target) return false;
+		const detail = {
+			payload,
+			claimed: false
+		};
+		target.dispatchEvent(createDetailEvent(eventName("view-thread"), detail));
+		return detail.claimed;
+	}
+	function emitInspectorStopViewing(payload) {
+		dispatch("stop-viewing", payload);
+	}
+	function emitInspectorActiveThread(payload) {
+		dispatch("active-thread", payload);
+	}
+	function emitInspectorViewThreadResult(payload) {
+		dispatch("view-thread-result", payload);
+	}
+	function onInspectorViewThread(handler) {
+		if (!isInspectorThreadBridgeEnabled()) return () => void 0;
+		const target = getEventTarget();
+		if (!target) return () => void 0;
+		const listener = (event) => {
+			const detail = detailFromEvent(event);
+			if (detail.claimed) return;
+			detail.claimed = handler(detail.payload);
+		};
+		const name = eventName("view-thread");
+		target.addEventListener(name, listener);
+		return () => target.removeEventListener(name, listener);
+	}
+	function onInspectorStopViewing(handler) {
+		return on$1("stop-viewing", handler);
+	}
+	function onInspectorActiveThread(handler) {
+		return on$1("active-thread", handler);
+	}
+	function onInspectorViewThreadResult(handler) {
+		return on$1("view-thread-result", handler);
+	}
+
 //#endregion
 exports.AgentRegistry = AgentRegistry;
 exports.AgentThreadLockedError = AgentThreadLockedError;
@@ -6128,6 +6462,7 @@ exports.ContextStore = ContextStore;
 exports.CopilotKitCore = CopilotKitCore;
 exports.CopilotKitCoreErrorCode = CopilotKitCoreErrorCode;
 exports.CopilotKitCoreRuntimeConnectionStatus = CopilotKitCoreRuntimeConnectionStatus;
+exports.INSPECTOR_THREAD_BRIDGE_PLUGIN_ID = INSPECTOR_THREAD_BRIDGE_PLUGIN_ID;
 exports.IntelligenceAgent = IntelligenceAgent;
 exports.MEMORY_ERROR_REGISTRY = MEMORY_ERROR_REGISTRY;
 exports.MemoryError = MemoryError;
@@ -6139,15 +6474,25 @@ exports.ToolCallStatus = ToolCallStatus;
 exports.completePartialMarkdown = completePartialMarkdown;
 exports.createActionGroup = createActionGroup;
 exports.createEffect = createEffect;
+exports.createInspectorThreadRequestId = createInspectorThreadRequestId;
 exports.createReducer = createReducer;
 exports.createSelector = createSelector;
 exports.createStore = createStore;
+exports.emitInspectorActiveThread = emitInspectorActiveThread;
+exports.emitInspectorStopViewing = emitInspectorStopViewing;
+exports.emitInspectorViewThread = emitInspectorViewThread;
+exports.emitInspectorViewThreadResult = emitInspectorViewThreadResult;
 exports.empty = empty;
 exports.ensureObjectArgs = ensureObjectArgs;
 exports.isAbortError = isAbortError;
+exports.isInspectorThreadBridgeEnabled = isInspectorThreadBridgeEnabled;
 exports.isRunCompletionAware = isRunCompletionAware;
 exports.ofType = ofType;
 exports.on = on;
+exports.onInspectorActiveThread = onInspectorActiveThread;
+exports.onInspectorStopViewing = onInspectorStopViewing;
+exports.onInspectorViewThread = onInspectorViewThread;
+exports.onInspectorViewThreadResult = onInspectorViewThreadResult;
 exports.parseToolArguments = parseToolArguments;
 exports.props = props;
 exports.select = select;
@@ -6157,6 +6502,7 @@ exports.ɵMAX_SOCKET_RETRIES = ɵMAX_SOCKET_RETRIES;
 exports.ɵcreateMemoryStore = createMemoryStore;
 exports.ɵcreateThreadSelectors = ɵcreateThreadSelectors;
 exports.ɵcreateThreadStore = createThreadStore;
+exports.ɵinjectInspectorEvents = ɵinjectInspectorEvents;
 exports.ɵisCopilotKitFeature = ɵisCopilotKitFeature;
 exports.ɵisRetryableMemoryStatus = isRetryableStatus;
 exports.ɵjoinPhoenixChannel$ = ɵjoinPhoenixChannel$;
@@ -6171,6 +6517,7 @@ exports.ɵobservePhoenixSocketHealth$ = ɵobservePhoenixSocketHealth$;
 exports.ɵobservePhoenixSocketSignals$ = ɵobservePhoenixSocketSignals$;
 exports.ɵphoenixChannel$ = ɵphoenixChannel$;
 exports.ɵphoenixSocket$ = ɵphoenixSocket$;
+exports.ɵresetInspectorInject = ɵresetInspectorInject;
 exports.ɵselectFetchMoreError = ɵselectFetchMoreError;
 exports.ɵselectHasNextPage = ɵselectHasNextPage;
 exports.ɵselectIsFetchingNextPage = ɵselectIsFetchingNextPage;