@copilotkit/core 1.61.1 → 1.62.0

package/dist/index.umd.js

@@ -193,16 +193,6 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			_defineProperty(this, "activeChannel", null);
 			_defineProperty(this, "canonicalRunId", null);
 			_defineProperty(this, "sharedState", void 0);
-			_defineProperty(
-				this,
-				/**
-				* Resolves when the active run's pipeline finalizes; `undefined` between runs.
-				* Set/cleared inside {@link connectAgent}'s observable lifecycle. Declared
-				* here so {@link RunCompletionAware} consumers can read it without a cast.
-				*/
-				"activeRunCompletionPromise",
-				void 0
-			);
 			this.config = config;
 			this.sharedState = sharedState;
 		}
@@ -247,7 +237,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 				const previousMessageIds = new Set(this.messages.map((m) => m.id));
 				const subscribers = [
 					{ onRunFinishedEvent: (event) => {
-						result = event.result;
+						if (event.outcome === "success") result = event.result;
 					} },
 					...this.subscribers,
 					subscriber !== null && subscriber !== void 0 ? subscriber : {}
@@ -255,10 +245,10 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 				await this.onInitialize(input, subscribers);
 				self.activeRunDetach$ = new rxjs.Subject();
 				let resolveCompletion;
-				this.activeRunCompletionPromise = new Promise((resolve) => {
+				self.activeRunCompletionPromise = new Promise((resolve) => {
 					resolveCompletion = resolve;
 				});
-				const source$ = (0, rxjs.defer)(() => this.connect(input)).pipe((0, _ag_ui_client.transformChunks)(this.debug), (0, rxjs_operators.takeUntil)(self.activeRunDetach$));
+				const source$ = (0, rxjs.defer)(() => this.connect(input)).pipe((0, _ag_ui_client.transformChunks)(this.debugLogger), (0, rxjs_operators.takeUntil)(self.activeRunDetach$));
 				const applied$ = this.apply(input, source$, subscribers);
 				await (0, rxjs.lastValueFrom)(this.processApplyEvents(input, applied$, subscribers).pipe((0, rxjs_operators.catchError)((error) => {
 					this.isRunning = false;
@@ -268,7 +258,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 					this.onFinalize(input, subscribers);
 					resolveCompletion === null || resolveCompletion === void 0 || resolveCompletion();
 					resolveCompletion = void 0;
-					this.activeRunCompletionPromise = void 0;
+					self.activeRunCompletionPromise = void 0;
 					self.activeRunDetach$ = void 0;
 				})), { defaultValue: void 0 });
 				const newMessages = (0, _ag_ui_client.structuredClone_)(this.messages).filter((m) => !previousMessageIds.has(m.id));
@@ -810,8 +800,9 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			cloned.setState(this.state);
 			cloned.setMessages(this.messages);
 			if (this.delegate) {
-				cloned.delegate = this.delegate.clone();
-				cloned.syncDelegate(cloned.delegate);
+				const clonedDelegate = this.delegate.clone();
+				cloned.delegate = clonedDelegate;
+				cloned.syncDelegate(clonedDelegate);
 			}
 			return cloned;
 		}
@@ -1000,6 +991,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			_defineProperty(this, "_openGenerativeUIEnabled", false);
 			_defineProperty(this, "_licenseStatus", void 0);
 			_defineProperty(this, "_telemetryDisabled", false);
+			_defineProperty(this, "agentOwnHeaders", /* @__PURE__ */ new WeakMap());
 		}
 		/**
 		* Get all agents as a readonly record
@@ -1170,10 +1162,19 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			console.warn(`Agent ${id} not found`);
 		}
 		/**
-		* Apply current headers to an agent
+		* Apply current core headers to an agent, merged ON TOP of the agent's own
+		* construction-time headers (the per-agent baseline in `agentOwnHeaders`).
+		* Core wins on a key conflict. Non-`HttpAgent` agents are left untouched
+		* because only `HttpAgent` carries a `headers` field. See #5635.
 		*/
 		applyHeadersToAgent(agent) {
-			if (agent instanceof _ag_ui_client.HttpAgent) agent.headers = { ...this.core.headers };
+			if (agent instanceof _ag_ui_client.HttpAgent) {
+				if (!this.agentOwnHeaders.has(agent)) this.agentOwnHeaders.set(agent, { ...agent.headers });
+				agent.headers = {
+					...this.agentOwnHeaders.get(agent),
+					...this.core.headers
+				};
+			}
 		}
 		/**
 		* Apply current headers to all agents
@@ -1852,7 +1853,14 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 					const proxied = agent;
 					if (incomingThreadId && typeof proxied.clearReplayCursor === "function") proxied.clearReplayCursor(incomingThreadId);
 				}
-				if (agent instanceof _ag_ui_client.HttpAgent) agent.headers = { ...this._internal.headers };
+				this._internal.applyHeadersToAgent(agent);
+				await this._internal.notifySubscribers((subscriber) => {
+					var _subscriber$onAgentRu;
+					return (_subscriber$onAgentRu = subscriber.onAgentRunStarted) === null || _subscriber$onAgentRu === void 0 ? void 0 : _subscriber$onAgentRu.call(subscriber, {
+						copilotkit: this.core,
+						agent
+					});
+				}, "Subscriber onAgentRunStarted error:");
 				const runAgentResult = await agent.connectAgent({
 					forwardedProps: this._internal.properties,
 					tools: this.buildFrontendTools(agent.agentId),
@@ -1873,15 +1881,18 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 						context
 					});
 				}
-				return { newMessages: [] };
+				return {
+					result: void 0,
+					newMessages: []
+				};
 			}
 		}
 		/**
 		* Run an agent
 		*/
-		async runAgent({ agent, forwardedProps }) {
+		async runAgent({ agent, forwardedProps, resume }) {
 			if (agent.agentId) this._internal.suggestionEngine.clearSuggestions(agent.agentId);
-			if (agent instanceof _ag_ui_client.HttpAgent) agent.headers = { ...this._internal.headers };
+			this._internal.applyHeadersToAgent(agent);
 			if (agent.detachActiveRun) await agent.detachActiveRun();
 			const isTopLevel = this._runDepth === 0;
 			let originalAbortRun;
@@ -1893,6 +1904,13 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 					controller.abort();
 					originalAbortRun();
 				};
+				await this._internal.notifySubscribers((subscriber) => {
+					var _subscriber$onAgentRu2;
+					return (_subscriber$onAgentRu2 = subscriber.onAgentRunStarted) === null || _subscriber$onAgentRu2 === void 0 ? void 0 : _subscriber$onAgentRu2.call(subscriber, {
+						copilotkit: this.core,
+						agent
+					});
+				}, "Subscriber onAgentRunStarted error:");
 			}
 			this._runDepth++;
 			try {
@@ -1901,6 +1919,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 						...this._internal.properties,
 						...forwardedProps
 					},
+					...resume !== void 0 ? { resume } : {},
 					tools: this.buildFrontendTools(agent.agentId),
 					context: this._internal.getContextForAgent(agent.agentId)
 				}, this.createAgentErrorSubscriber(agent));
@@ -1917,7 +1936,10 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 					code: CopilotKitCoreErrorCode.AGENT_RUN_FAILED,
 					context
 				});
-				return { newMessages: [] };
+				return {
+					result: void 0,
+					newMessages: []
+				};
 			} finally {
 				this._runDepth--;
 				if (isTopLevel && originalAbortRun) agent.abortRun = originalAbortRun;
@@ -2203,18 +2225,19 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 				throw error;
 			}
 			const toolCallId = (0, _copilotkit_shared.randomUUID)();
+			const assistantToolCall = {
+				id: toolCallId,
+				type: "function",
+				function: {
+					name,
+					arguments: JSON.stringify(parameters)
+				}
+			};
 			const assistantMessage = {
 				id: (0, _copilotkit_shared.randomUUID)(),
 				role: "assistant",
 				content: "",
-				toolCalls: [{
-					id: toolCallId,
-					type: "function",
-					function: {
-						name,
-						arguments: JSON.stringify(parameters)
-					}
-				}]
+				toolCalls: [assistantToolCall]
 			};
 			agent.messages.push(assistantMessage);
 			let handlerResult = {
@@ -2224,7 +2247,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			};
 			if (tool.handler) handlerResult = await this.executeToolHandler({
 				tool,
-				toolCall: assistantMessage.toolCalls[0],
+				toolCall: assistantToolCall,
 				agent,
 				agentId: resolvedAgentId,
 				handlerArgs: parameters,
@@ -2314,9 +2337,9 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 	*/
 	function createToolSchema(tool) {
 		if (!tool.parameters) return { ...EMPTY_TOOL_SCHEMA };
-		const rawSchema = (0, _copilotkit_shared.schemaToJsonSchema)(tool.parameters, { zodToJsonSchema: zod_to_json_schema.zodToJsonSchema });
+		const rawSchema = (0, _copilotkit_shared.schemaToJsonSchema)(tool.parameters, { zodToJsonSchema: (schema, options) => (0, zod_to_json_schema.zodToJsonSchema)(schema, options) });
 		if (!rawSchema || typeof rawSchema !== "object") return { ...EMPTY_TOOL_SCHEMA };
-		const { $schema, ...schema } = rawSchema;
+		const { $schema: _$schema, ...schema } = rawSchema;
 		if (typeof schema.type !== "string") schema.type = "object";
 		if (typeof schema.properties !== "object" || schema.properties === null) schema.properties = {};
 		stripAdditionalProperties(schema);
@@ -2915,9 +2938,19 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		* });
 		* ```
 		*
-		* The resulting header set is also re-applied to every registered
-		* `HttpAgent`-derived agent (replacing its `headers`) and `onHeadersChanged`
-		* subscribers are notified.
+		* The resulting header set is also re-applied to every agent in the registry
+		* and `onHeadersChanged` subscribers are notified. These headers are merged
+		* ON TOP of the headers each `HttpAgent` was constructed with, so per-agent
+		* headers (e.g. an `Authorization` for a self-hosted backend) are preserved;
+		* on a key conflict the core-level value wins.
+		*
+		* Because the agent's construction-time headers form the merge baseline, this
+		* method can override a per-agent header but cannot REMOVE one: clearing a
+		* core key here only drops the core-level override, after which the agent's
+		* own value (if any) re-surfaces. To change a header an agent was constructed
+		* with, set it at the provider/core level instead of on the agent, or update
+		* it on the agent directly. The clear-on-logout pattern above is for
+		* core-level headers.
 		*/
 		setHeaders(headers) {
 			this._headers = normalizeHeaders(headers);
@@ -2982,6 +3015,23 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			return this.agentRegistry.getAgent(id);
 		}
 		/**
+		* Re-apply the current headers to a single agent (delegated to
+		* AgentRegistry). Core headers are merged on top of the agent's own
+		* construction-time headers rather than replacing them, so headers
+		* configured directly on an `HttpAgent` (e.g. an `Authorization` for a
+		* self-hosted backend) survive header updates instead of being silently
+		* dropped (see #5635). On a key conflict the core-level value wins.
+		*
+		* The merge baseline is the agent's headers as captured the first time the
+		* agent is applied (at registration), so the way to change headers
+		* afterwards is `setHeaders` (which re-applies to every agent), not mutating
+		* `agent.headers` directly — a direct mutation is overwritten on the next
+		* re-apply.
+		*/
+		applyHeadersToAgent(agent) {
+			this.agentRegistry.applyHeadersToAgent(agent);
+		}
+		/**
 		* Context management (delegated to ContextStore).
 		* Pass `agentIds` to restrict the entry to runs of specific agents;
 		* omit it for context every agent should receive.
@@ -3701,7 +3751,9 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		sessionId: 0,
 		metadataCredentialsRequested: false,
 		metadataJoinCode: null,
-		nextCursor: null
+		nextCursor: null,
+		inFlightMutationCount: 0,
+		pendingDeletes: {}
 	};
 	const threadAdapterEvents = createActionGroup("Thread Adapter", {
 		started: empty(),
@@ -3710,7 +3762,9 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		fetchNextPageRequested: empty(),
 		renameRequested: props(),
 		archiveRequested: props(),
-		deleteRequested: props()
+		unarchiveRequested: props(),
+		deleteRequested: props(),
+		newThreadStarted: empty()
 	});
 	const threadRestEvents = createActionGroup("Thread REST", {
 		listRequested: props(),
@@ -3758,7 +3812,9 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		error: null,
 		metadataCredentialsRequested: false,
 		metadataJoinCode: null,
-		nextCursor: null
+		nextCursor: null,
+		inFlightMutationCount: 0,
+		pendingDeletes: {}
 	})), on(threadAdapterEvents.stopped, (state) => ({
 		...state,
 		threads: [],
@@ -3767,7 +3823,9 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		error: null,
 		metadataCredentialsRequested: false,
 		metadataJoinCode: null,
-		nextCursor: null
+		nextCursor: null,
+		inFlightMutationCount: 0,
+		pendingDeletes: {}
 	})), on(threadRestEvents.listRequested, (state, { sessionId }) => {
 		if (sessionId !== state.sessionId || !state.context) return state;
 		return {
@@ -3809,12 +3867,9 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			isFetchingNextPage: false,
 			error
 		};
-	}), on(threadRestEvents.metadataCredentialsFailed, (state, { sessionId, error }) => {
+	}), on(threadRestEvents.metadataCredentialsFailed, (state, { sessionId }) => {
 		if (sessionId !== state.sessionId) return state;
-		return {
-			...state,
-			error
-		};
+		return state;
 	}), on(threadRestEvents.metadataCredentialsRequested, (state, { sessionId }) => {
 		if (sessionId !== state.sessionId) return state;
 		return {
@@ -3827,10 +3882,106 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			...state,
 			isFetchingNextPage: true
 		};
-	}), on(threadRestEvents.mutationFinished, (state, { outcome }) => ({
+	}), on(threadAdapterEvents.renameRequested, (state, { threadId, name }) => {
+		const existing = state.threads.find((thread) => thread.id === threadId);
+		const inFlightMutationCount = state.inFlightMutationCount + 1;
+		if (!existing) return {
+			...state,
+			inFlightMutationCount
+		};
+		return {
+			...state,
+			threads: upsertThread(state.threads, {
+				...existing,
+				name
+			}),
+			inFlightMutationCount
+		};
+	}), on(threadAdapterEvents.archiveRequested, (state, { threadId }) => {
+		var _state$context;
+		const existing = state.threads.find((thread) => thread.id === threadId);
+		const inFlightMutationCount = state.inFlightMutationCount + 1;
+		if (!existing) return {
+			...state,
+			inFlightMutationCount
+		};
+		if (!((_state$context = state.context) === null || _state$context === void 0 ? void 0 : _state$context.includeArchived)) return {
+			...state,
+			threads: state.threads.filter((thread) => thread.id !== threadId),
+			inFlightMutationCount
+		};
+		return {
+			...state,
+			threads: upsertThread(state.threads, {
+				...existing,
+				archived: true
+			}),
+			inFlightMutationCount
+		};
+	}), on(threadAdapterEvents.unarchiveRequested, (state, { threadId }) => {
+		const existing = state.threads.find((thread) => thread.id === threadId);
+		const inFlightMutationCount = state.inFlightMutationCount + 1;
+		if (!existing) return {
+			...state,
+			inFlightMutationCount
+		};
+		return {
+			...state,
+			threads: upsertThread(state.threads, {
+				...existing,
+				archived: false
+			}),
+			inFlightMutationCount
+		};
+	}), on(threadAdapterEvents.deleteRequested, (state, { requestId, threadId }) => {
+		const existing = state.threads.find((thread) => thread.id === threadId);
+		const inFlightMutationCount = state.inFlightMutationCount + 1;
+		if (!existing) return {
+			...state,
+			inFlightMutationCount
+		};
+		return {
+			...state,
+			threads: state.threads.filter((thread) => thread.id !== threadId),
+			pendingDeletes: {
+				...state.pendingDeletes,
+				[requestId]: existing
+			},
+			inFlightMutationCount
+		};
+	}), on(threadAdapterEvents.newThreadStarted, (state) => ({
 		...state,
-		error: outcome.ok ? state.error : outcome.error
-	})), on(threadDomainEvents.threadUpserted, (state, { sessionId, thread }) => {
+		error: null
+	})), on(threadRestEvents.mutationFinished, (state, { outcome }) => {
+		if (outcome.sessionId !== state.sessionId) return state;
+		const inFlightMutationCount = Math.max(0, state.inFlightMutationCount - 1);
+		if (outcome.ok) {
+			if (state.pendingDeletes[outcome.requestId] === void 0) return {
+				...state,
+				inFlightMutationCount
+			};
+			const { [outcome.requestId]: _settled, ...rest } = state.pendingDeletes;
+			return {
+				...state,
+				inFlightMutationCount,
+				pendingDeletes: rest
+			};
+		}
+		const rolledBack = state.pendingDeletes[outcome.requestId];
+		if (rolledBack === void 0) return {
+			...state,
+			inFlightMutationCount,
+			error: outcome.error
+		};
+		const { [outcome.requestId]: _restored, ...rest } = state.pendingDeletes;
+		return {
+			...state,
+			threads: upsertThread(state.threads, rolledBack),
+			pendingDeletes: rest,
+			inFlightMutationCount,
+			error: outcome.error
+		};
+	}), on(threadDomainEvents.threadUpserted, (state, { sessionId, thread }) => {
 		if (sessionId !== state.sessionId) return state;
 		return {
 			...state,
@@ -3843,23 +3994,49 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			threads: state.threads.filter((thread) => thread.id !== threadId)
 		};
 	}));
-	const selectThreads = createSelector((state) => state.threads);
-	const selectThreadsIsLoading = createSelector((state) => state.isLoading);
-	const selectThreadsError = createSelector((state) => state.error);
-	const selectHasNextPage = createSelector((state) => state.nextCursor != null);
-	const selectIsFetchingNextPage = createSelector((state) => state.isFetchingNextPage);
+	/**
+	* Builds a fresh set of memoized thread selectors.
+	*
+	* Each `createSelector` closure owns a private one-entry cache. Sharing a
+	* single module-level selector instance across multiple concurrent stores
+	* (e.g. a `<CopilotThreadsDrawer>` plus an independent `useThreads`) makes every
+	* cross-store emission a cache miss, defeating memoization and risking
+	* emission instability for any future selector that allocates a new
+	* object/array. Creating a per-store instance keeps each store's cache
+	* isolated so concurrent stores never thrash one another.
+	*/
+	function createThreadSelectors() {
+		return {
+			threads: createSelector((state) => state.threads),
+			isLoading: createSelector((state) => state.isLoading),
+			error: createSelector((state) => state.error),
+			hasNextPage: createSelector((state) => state.nextCursor != null),
+			isFetchingNextPage: createSelector((state) => state.isFetchingNextPage),
+			isMutating: createSelector((state) => state.inFlightMutationCount > 0)
+		};
+	}
+	const standaloneSelectors = createThreadSelectors();
+	const selectThreads = standaloneSelectors.threads;
+	const selectThreadsIsLoading = standaloneSelectors.isLoading;
+	const selectThreadsError = standaloneSelectors.error;
+	const selectHasNextPage = standaloneSelectors.hasNextPage;
+	const selectIsFetchingNextPage = standaloneSelectors.isFetchingNextPage;
+	const selectIsMutating = standaloneSelectors.isMutating;
 	let threadRequestId = 0;
 	function createThreadRequestId() {
 		threadRequestId += 1;
 		return `thread-request-${threadRequestId}`;
 	}
+	function threadFromFetch(input, init) {
+		return (0, rxjs_fetch.fromFetch)(input, init);
+	}
 	function createThreadFetchObservable(environment, context, sessionId) {
 		return (0, rxjs.defer)(() => {
 			const params = { agentId: context.agentId };
 			if (context.includeArchived) params.includeArchived = "true";
 			if (context.limit != null) params.limit = String(context.limit);
 			const qs = new URLSearchParams(params);
-			return (0, rxjs_fetch.fromFetch)(`${context.runtimeUrl}/threads?${qs.toString()}`, {
+			return threadFromFetch(`${context.runtimeUrl}/threads?${qs.toString()}`, {
 				selector: (response) => {
 					if (!response.ok) throw new Error(`Failed to fetch threads: ${response.status}`);
 					return response.json();
@@ -3890,7 +4067,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 	}
 	function createThreadMetadataCredentialsObservable(environment, context, sessionId) {
 		return (0, rxjs.defer)(() => {
-			return (0, rxjs_fetch.fromFetch)(`${context.runtimeUrl}${THREAD_SUBSCRIBE_PATH}`, {
+			return threadFromFetch(`${context.runtimeUrl}${THREAD_SUBSCRIBE_PATH}`, {
 				selector: async (response) => {
 					if (!response.ok) throw new Error(`Failed to fetch thread metadata credentials: ${response.status}`);
 					return response.json();
@@ -3923,7 +4100,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 	}
 	function createThreadMutationObservable(environment, context, request) {
 		return (0, rxjs.defer)(() => {
-			return (0, rxjs_fetch.fromFetch)(`${context.runtimeUrl}${request.path}`, {
+			return threadFromFetch(`${context.runtimeUrl}${request.path}`, {
 				selector: async (response) => {
 					if (!response.ok) throw new Error(`Request failed: ${response.status}`);
 					return null;
@@ -3937,10 +4114,12 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 				body: JSON.stringify(request.body)
 			}).pipe((0, rxjs_operators.map)(() => threadRestEvents.mutationFinished({ outcome: {
 				requestId: request.requestId,
+				sessionId: request.sessionId,
 				ok: true
 			} })), (0, rxjs_operators.catchError)((error) => {
 				return (0, rxjs.of)(threadRestEvents.mutationFinished({ outcome: {
 					requestId: request.requestId,
+					sessionId: request.sessionId,
 					ok: false,
 					error: error instanceof Error ? error : new Error(String(error))
 				} }));
@@ -3948,6 +4127,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		});
 	}
 	function createThreadStore(environment) {
+		const selectors = createThreadSelectors();
 		const store = createStore({
 			reducer: threadReducer,
 			effects: [
@@ -3957,16 +4137,16 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 					context
 				})), (0, rxjs_operators.takeUntil)(actions$.pipe(ofType(threadAdapterEvents.contextChanged, threadAdapterEvents.stopped))), (0, rxjs_operators.switchMap)(({ action: currentAction, context }) => createThreadFetchObservable(environment, context, currentAction.sessionId)))))),
 				createEffect((actions$, state$) => actions$.pipe(ofType(threadRestEvents.listSucceeded), (0, rxjs_operators.withLatestFrom)(state$), (0, rxjs_operators.filter)(([action, state]) => {
-					var _state$context;
-					return action.sessionId === state.sessionId && !state.metadataCredentialsRequested && Boolean((_state$context = state.context) === null || _state$context === void 0 ? void 0 : _state$context.wsUrl) && Boolean(state.metadataJoinCode);
+					var _state$context2;
+					return action.sessionId === state.sessionId && !state.metadataCredentialsRequested && Boolean((_state$context2 = state.context) === null || _state$context2 === void 0 ? void 0 : _state$context2.wsUrl) && Boolean(state.metadataJoinCode);
 				}), (0, rxjs_operators.map)(([action]) => threadRestEvents.metadataCredentialsRequested({ sessionId: action.sessionId })))),
 				createEffect((actions$, state$) => actions$.pipe(ofType(threadRestEvents.metadataCredentialsRequested), (0, rxjs_operators.switchMap)((action) => state$.pipe((0, rxjs_operators.map)((state) => state.context), (0, rxjs_operators.filter)((context) => Boolean(context)), (0, rxjs_operators.take)(1), (0, rxjs_operators.map)((context) => ({
 					action,
 					context
 				})), (0, rxjs_operators.takeUntil)(actions$.pipe(ofType(threadAdapterEvents.contextChanged, threadAdapterEvents.stopped))), (0, rxjs_operators.switchMap)(({ action: currentAction, context }) => createThreadMetadataCredentialsObservable(environment, context, currentAction.sessionId)))))),
 				createEffect((actions$, state$) => actions$.pipe(ofType(threadRestEvents.metadataCredentialsSucceeded), (0, rxjs_operators.withLatestFrom)(state$), (0, rxjs_operators.filter)(([action, state]) => {
-					var _state$context2;
-					return action.sessionId === state.sessionId && Boolean((_state$context2 = state.context) === null || _state$context2 === void 0 ? void 0 : _state$context2.wsUrl);
+					var _state$context3;
+					return action.sessionId === state.sessionId && Boolean((_state$context3 = state.context) === null || _state$context3 === void 0 ? void 0 : _state$context3.wsUrl);
 				}), (0, rxjs_operators.switchMap)(([action, state]) => {
 					const context = state.context;
 					const joinToken = action.joinToken;
@@ -4003,12 +4183,12 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 					});
 				}))),
 				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]) => {
-					var _state$context3;
+					var _state$context4;
 					if (action.payload.operation === "deleted") return threadDomainEvents.threadDeleted({
 						sessionId: action.sessionId,
 						threadId: action.payload.deleted.id
 					});
-					if (action.payload.operation === "archived" && !((_state$context3 = state.context) === null || _state$context3 === void 0 ? void 0 : _state$context3.includeArchived)) return threadDomainEvents.threadDeleted({
+					if (action.payload.operation === "archived" && !((_state$context4 = state.context) === null || _state$context4 === void 0 ? void 0 : _state$context4.includeArchived)) return threadDomainEvents.threadDeleted({
 						sessionId: action.sessionId,
 						threadId: action.payload.threadId
 					});
@@ -4017,6 +4197,10 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 						thread: action.payload.thread
 					});
 				}))),
+				createEffect((actions$, state$) => actions$.pipe(ofType(threadSocketEvents.joinFailed, threadSocketEvents.joinTimedOut, threadSocketEvents.errored, threadRestEvents.metadataCredentialsFailed), (0, rxjs_operators.withLatestFrom)(state$), (0, rxjs_operators.filter)(([action, state]) => action.sessionId === state.sessionId), (0, rxjs_operators.tap)(([action]) => {
+					const reason = threadSocketEvents.joinTimedOut.match(action) ? "channel join timed out" : threadSocketEvents.joinFailed.match(action) ? "channel join was rejected" : threadRestEvents.metadataCredentialsFailed.match(action) ? "metadata credentials fetch failed" : "socket errored";
+					console.warn(`[threads] realtime ${reason}; the thread list may be stale until reconnect`);
+				})), { dispatch: false }),
 				createEffect((actions$, state$) => actions$.pipe(ofType(threadAdapterEvents.fetchNextPageRequested), (0, rxjs_operators.withLatestFrom)(state$), (0, rxjs_operators.filter)(([, state]) => Boolean(state.context) && Boolean(state.nextCursor)), (0, rxjs_operators.switchMap)(([, state]) => {
 					const context = state.context;
 					const params = {
@@ -4025,7 +4209,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 					};
 					if (context.includeArchived) params.includeArchived = "true";
 					if (context.limit != null) params.limit = String(context.limit);
-					return (0, rxjs_fetch.fromFetch)(`${context.runtimeUrl}/threads?${new URLSearchParams(params).toString()}`, {
+					return threadFromFetch(`${context.runtimeUrl}/threads?${new URLSearchParams(params).toString()}`, {
 						selector: (response) => {
 							if (!response.ok) throw new Error(`Failed to fetch next page: ${response.status}`);
 							return response.json();
@@ -4050,12 +4234,14 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 						error: error instanceof Error ? error : new Error(String(error))
 					}))), (0, rxjs_operators.takeUntil)(actions$.pipe(ofType(threadAdapterEvents.contextChanged, threadAdapterEvents.stopped))));
 				}))),
-				createEffect((actions$, state$) => actions$.pipe(ofType(threadAdapterEvents.renameRequested, threadAdapterEvents.archiveRequested, threadAdapterEvents.deleteRequested), (0, rxjs_operators.withLatestFrom)(state$), (0, rxjs_operators.mergeMap)(([action, state]) => {
+				createEffect((actions$, state$) => actions$.pipe(ofType(threadAdapterEvents.renameRequested, threadAdapterEvents.archiveRequested, threadAdapterEvents.unarchiveRequested, threadAdapterEvents.deleteRequested), (0, rxjs_operators.withLatestFrom)(state$), (0, rxjs_operators.mergeMap)(([action, state]) => {
+					const sessionId = state.sessionId;
 					const context = state.context;
 					if (!(context === null || context === void 0 ? void 0 : context.runtimeUrl)) {
 						const requestId = action.requestId;
 						return (0, rxjs.of)(threadRestEvents.mutationFinished({ outcome: {
 							requestId,
+							sessionId,
 							ok: false,
 							error: /* @__PURE__ */ new Error("Runtime URL is not configured")
 						} }));
@@ -4063,6 +4249,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 					const commonBody = { agentId: context.agentId };
 					if (threadAdapterEvents.renameRequested.match(action)) return createThreadMutationObservable(environment, context, {
 						requestId: action.requestId,
+						sessionId,
 						method: "PATCH",
 						path: `/threads/${encodeURIComponent(action.threadId)}`,
 						body: {
@@ -4072,12 +4259,24 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 					});
 					if (threadAdapterEvents.archiveRequested.match(action)) return createThreadMutationObservable(environment, context, {
 						requestId: action.requestId,
+						sessionId,
 						method: "POST",
 						path: `/threads/${encodeURIComponent(action.threadId)}/archive`,
 						body: commonBody
 					});
+					if (threadAdapterEvents.unarchiveRequested.match(action)) return createThreadMutationObservable(environment, context, {
+						requestId: action.requestId,
+						sessionId,
+						method: "PATCH",
+						path: `/threads/${encodeURIComponent(action.threadId)}`,
+						body: {
+							...commonBody,
+							archived: false
+						}
+					});
 					return createThreadMutationObservable(environment, context, {
 						requestId: action.requestId,
+						sessionId,
 						method: "DELETE",
 						path: `/threads/${encodeURIComponent(action.threadId)}`,
 						body: commonBody
@@ -4088,6 +4287,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		function trackMutation(dispatchAction) {
 			const resultPromise = (0, rxjs.firstValueFrom)((0, rxjs.merge)(store.actions$.pipe(ofType(threadRestEvents.mutationFinished), (0, rxjs_operators.filter)((action) => action.outcome.requestId === dispatchAction.requestId), (0, rxjs_operators.map)((action) => action.outcome)), store.actions$.pipe(ofType(threadAdapterEvents.stopped), (0, rxjs_operators.map)(() => ({
 				requestId: dispatchAction.requestId,
+				sessionId: store.getState().sessionId,
 				ok: false,
 				error: /* @__PURE__ */ new Error("Thread store stopped before mutation completed")
 			})))).pipe((0, rxjs_operators.take)(1))).then((outcome) => {
@@ -4097,13 +4297,26 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			store.dispatch(dispatchAction);
 			return resultPromise;
 		}
+		let errorSubscription = null;
+		const subscribeErrors = () => {
+			if (!environment.onError || errorSubscription) return;
+			errorSubscription = store.actions$.pipe(ofType(threadRestEvents.mutationFinished), (0, rxjs_operators.filter)((action) => !action.outcome.ok && action.outcome.sessionId === store.getState().sessionId)).subscribe((action) => {
+				if (!action.outcome.ok) {
+					var _environment$onError;
+					(_environment$onError = environment.onError) === null || _environment$onError === void 0 || _environment$onError.call(environment, action.outcome.error);
+				}
+			});
+		};
 		return {
 			start() {
 				store.init();
+				subscribeErrors();
 				store.dispatch(threadAdapterEvents.started());
 			},
 			stop() {
 				store.dispatch(threadAdapterEvents.stopped());
+				errorSubscription === null || errorSubscription === void 0 || errorSubscription.unsubscribe();
+				errorSubscription = null;
 				store.stop();
 			},
 			setContext(context) {
@@ -4114,6 +4327,14 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 				if (!context) return;
 				store.dispatch(threadRestEvents.listRequested({ sessionId }));
 			},
+			refetchThreads() {
+				const { sessionId, context } = store.getState();
+				if (!context) return;
+				store.dispatch(threadRestEvents.listRequested({ sessionId }));
+			},
+			startNewThread() {
+				store.dispatch(threadAdapterEvents.newThreadStarted());
+			},
 			fetchNextPage() {
 				store.dispatch(threadAdapterEvents.fetchNextPageRequested());
 			},
@@ -4130,6 +4351,12 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 					threadId
 				}));
 			},
+			unarchiveThread(threadId) {
+				return trackMutation(threadAdapterEvents.unarchiveRequested({
+					requestId: createThreadRequestId(),
+					threadId
+				}));
+			},
 			deleteThread(threadId) {
 				return trackMutation(threadAdapterEvents.deleteRequested({
 					requestId: createThreadRequestId(),
@@ -4139,15 +4366,21 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			getState() {
 				return store.getState();
 			},
-			select: store.select.bind(store)
+			getServerState() {
+				return initialThreadState;
+			},
+			select: store.select.bind(store),
+			selectors
 		};
 	}
 	const ɵthreadAdapterEvents = threadAdapterEvents;
+	const ɵcreateThreadSelectors = createThreadSelectors;
 	const ɵselectThreads = selectThreads;
 	const ɵselectThreadsIsLoading = selectThreadsIsLoading;
 	const ɵselectThreadsError = selectThreadsError;
 	const ɵselectHasNextPage = selectHasNextPage;
 	const ɵselectIsFetchingNextPage = selectIsFetchingNextPage;
+	const ɵselectIsMutating = selectIsMutating;
 	/**
 	* Number of consecutive WebSocket connection failures after which the
 	* threads channel tears itself down rather than retrying indefinitely.
@@ -4156,6 +4389,51 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 	*/
 	const ɵMAX_SOCKET_RETRIES = MAX_SOCKET_RETRIES;
 
+//#endregion
+//#region src/features.ts
+/**
+	* Central registry of CopilotKit feature names.
+	*
+	* Feature names are the strings passed to a license context's `checkFeature`
+	* (see `@copilotkit/shared`'s `LicenseContextValue`). Historically the only
+	* features referenced by literal were the chat surfaces (`chat`, `sidebar`,
+	* `popup`); this module makes the set explicit and typed so new surfaces —
+	* such as the threads drawer — register a real, discoverable feature name
+	* rather than an ad-hoc string scattered across components.
+	*
+	* `checkFeature` itself still accepts any `string` for backward compatibility;
+	* this registry simply documents and types the names CopilotKit recognises.
+	*/
+	/**
+	* The set of feature names CopilotKit recognises.
+	*
+	* Frozen so the array cannot be mutated at runtime. Add new surfaces here when
+	* they begin gating behaviour on `checkFeature`.
+	*/
+	const ɵCOPILOTKIT_FEATURES = Object.freeze([
+		"chat",
+		"sidebar",
+		"popup",
+		"threads"
+	]);
+	const FEATURE_SET = new Set(ɵCOPILOTKIT_FEATURES);
+	/**
+	* Type guard: returns `true` when `name` is a recognised CopilotKit feature.
+	*
+	* @param name - Candidate feature name.
+	* @returns Whether `name` is a registered feature.
+	*
+	* @example
+	* ```ts
+	* if (ɵisCopilotKitFeature("threads")) {
+	*   // narrowed to ɵCopilotKitFeature
+	* }
+	* ```
+	*/
+	function ɵisCopilotKitFeature(name) {
+		return FEATURE_SET.has(name);
+	}
+
 //#endregion
 exports.AgentRegistry = AgentRegistry;
 exports.AgentThreadLockedError = AgentThreadLockedError;
@@ -4183,8 +4461,11 @@ exports.on = on;
 exports.parseToolArguments = parseToolArguments;
 exports.props = props;
 exports.select = select;
+exports.ɵCOPILOTKIT_FEATURES = ɵCOPILOTKIT_FEATURES;
 exports.ɵMAX_SOCKET_RETRIES = ɵMAX_SOCKET_RETRIES;
+exports.ɵcreateThreadSelectors = ɵcreateThreadSelectors;
 exports.ɵcreateThreadStore = createThreadStore;
+exports.ɵisCopilotKitFeature = ɵisCopilotKitFeature;
 exports.ɵjoinPhoenixChannel$ = ɵjoinPhoenixChannel$;
 exports.ɵobservePhoenixEvent$ = ɵobservePhoenixEvent$;
 exports.ɵobservePhoenixJoinOutcome$ = ɵobservePhoenixJoinOutcome$;
@@ -4194,6 +4475,7 @@ exports.ɵphoenixChannel$ = ɵphoenixChannel$;
 exports.ɵphoenixSocket$ = ɵphoenixSocket$;
 exports.ɵselectHasNextPage = ɵselectHasNextPage;
 exports.ɵselectIsFetchingNextPage = ɵselectIsFetchingNextPage;
+exports.ɵselectIsMutating = ɵselectIsMutating;
 exports.ɵselectThreads = ɵselectThreads;
 exports.ɵselectThreadsError = ɵselectThreadsError;
 exports.ɵselectThreadsIsLoading = ɵselectThreadsIsLoading;