@copilotkit/core 1.61.1 → 1.62.0

package/dist/index.cjs

@@ -152,12 +152,6 @@ var IntelligenceAgent = class IntelligenceAgent extends _ag_ui_client.AbstractAg
 	activeChannel = null;
 	canonicalRunId = null;
 	sharedState;
-	/**
-	* 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;
 	constructor(config, sharedState = { lastSeenEventIds: /* @__PURE__ */ new Map() }) {
 		super();
 		this.config = config;
@@ -203,7 +197,7 @@ var IntelligenceAgent = class IntelligenceAgent extends _ag_ui_client.AbstractAg
 			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 ?? {}
@@ -211,10 +205,10 @@ var IntelligenceAgent = class IntelligenceAgent extends _ag_ui_client.AbstractAg
 			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;
@@ -224,7 +218,7 @@ var IntelligenceAgent = class IntelligenceAgent extends _ag_ui_client.AbstractAg
 				this.onFinalize(input, subscribers);
 				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));
@@ -726,8 +720,9 @@ var ProxiedCopilotRuntimeAgent = class ProxiedCopilotRuntimeAgent extends _ag_ui
 		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;
 	}
@@ -882,6 +877,17 @@ var AgentRegistry = class {
 	_openGenerativeUIEnabled = false;
 	_licenseStatus;
 	_telemetryDisabled = false;
+	/**
+	* The headers each HttpAgent was constructed with, captured on the first
+	* `applyHeadersToAgent` call for that agent (which, for agents the registry
+	* owns, happens at registration before any core headers are applied). Core
+	* headers are merged ON TOP of this baseline so that headers configured
+	* directly on an agent (e.g. an `Authorization` for a self-hosted backend)
+	* survive registration instead of being silently replaced. The baseline is
+	* captured once and never re-captured, so a later direct mutation of
+	* `agent.headers` is not folded into it. See #5635.
+	*/
+	agentOwnHeaders = /* @__PURE__ */ new WeakMap();
 	constructor(core) {
 		this.core = core;
 	}
@@ -1054,10 +1060,19 @@ var AgentRegistry = class {
 		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
@@ -1729,7 +1744,11 @@ var RunHandler = class {
 				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) => subscriber.onAgentRunStarted?.({
+				copilotkit: this.core,
+				agent
+			}), "Subscriber onAgentRunStarted error:");
 			const runAgentResult = await agent.connectAgent({
 				forwardedProps: this._internal.properties,
 				tools: this.buildFrontendTools(agent.agentId),
@@ -1750,15 +1769,18 @@ var RunHandler = class {
 					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;
@@ -1770,6 +1792,10 @@ var RunHandler = class {
 				controller.abort();
 				originalAbortRun();
 			};
+			await this._internal.notifySubscribers((subscriber) => subscriber.onAgentRunStarted?.({
+				copilotkit: this.core,
+				agent
+			}), "Subscriber onAgentRunStarted error:");
 		}
 		this._runDepth++;
 		try {
@@ -1778,6 +1804,7 @@ var RunHandler = class {
 					...this._internal.properties,
 					...forwardedProps
 				},
+				...resume !== void 0 ? { resume } : {},
 				tools: this.buildFrontendTools(agent.agentId),
 				context: this._internal.getContextForAgent(agent.agentId)
 			}, this.createAgentErrorSubscriber(agent));
@@ -1794,7 +1821,10 @@ var RunHandler = class {
 				code: CopilotKitCoreErrorCode.AGENT_RUN_FAILED,
 				context
 			});
-			return { newMessages: [] };
+			return {
+				result: void 0,
+				newMessages: []
+			};
 		} finally {
 			this._runDepth--;
 			if (isTopLevel && originalAbortRun) agent.abortRun = originalAbortRun;
@@ -2066,18 +2096,19 @@ var RunHandler = class {
 			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 = {
@@ -2087,7 +2118,7 @@ var RunHandler = class {
 		};
 		if (tool.handler) handlerResult = await this.executeToolHandler({
 			tool,
-			toolCall: assistantMessage.toolCalls[0],
+			toolCall: assistantToolCall,
 			agent,
 			agentId: resolvedAgentId,
 			handlerArgs: parameters,
@@ -2173,9 +2204,9 @@ const EMPTY_TOOL_SCHEMA = {
 */
 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);
@@ -2762,9 +2793,19 @@ var CopilotKitCore = class {
 	* });
 	* ```
 	*
-	* 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);
@@ -2823,6 +2864,23 @@ var CopilotKitCore = class {
 		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.
@@ -3539,7 +3597,9 @@ const initialThreadState = {
 	sessionId: 0,
 	metadataCredentialsRequested: false,
 	metadataJoinCode: null,
-	nextCursor: null
+	nextCursor: null,
+	inFlightMutationCount: 0,
+	pendingDeletes: {}
 };
 const threadAdapterEvents = createActionGroup("Thread Adapter", {
 	started: empty(),
@@ -3548,7 +3608,9 @@ const threadAdapterEvents = createActionGroup("Thread Adapter", {
 	fetchNextPageRequested: empty(),
 	renameRequested: props(),
 	archiveRequested: props(),
-	deleteRequested: props()
+	unarchiveRequested: props(),
+	deleteRequested: props(),
+	newThreadStarted: empty()
 });
 const threadRestEvents = createActionGroup("Thread REST", {
 	listRequested: props(),
@@ -3595,7 +3657,9 @@ const threadReducer = createReducer(initialThreadState, on(threadAdapterEvents.c
 	error: null,
 	metadataCredentialsRequested: false,
 	metadataJoinCode: null,
-	nextCursor: null
+	nextCursor: null,
+	inFlightMutationCount: 0,
+	pendingDeletes: {}
 })), on(threadAdapterEvents.stopped, (state) => ({
 	...state,
 	threads: [],
@@ -3604,7 +3668,9 @@ const threadReducer = createReducer(initialThreadState, on(threadAdapterEvents.c
 	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 {
@@ -3646,12 +3712,9 @@ const threadReducer = createReducer(initialThreadState, on(threadAdapterEvents.c
 		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 {
@@ -3664,10 +3727,105 @@ const threadReducer = createReducer(initialThreadState, on(threadAdapterEvents.c
 		...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 }) => {
+	const existing = state.threads.find((thread) => thread.id === threadId);
+	const inFlightMutationCount = state.inFlightMutationCount + 1;
+	if (!existing) return {
+		...state,
+		inFlightMutationCount
+	};
+	if (!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,
@@ -3680,23 +3838,49 @@ const threadReducer = createReducer(initialThreadState, on(threadAdapterEvents.c
 		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();
@@ -3724,7 +3908,7 @@ function createThreadFetchObservable(environment, context, sessionId) {
 }
 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();
@@ -3757,7 +3941,7 @@ function createThreadMetadataCredentialsObservable(environment, context, session
 }
 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;
@@ -3771,10 +3955,12 @@ function createThreadMutationObservable(environment, context, request) {
 			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))
 			} }));
@@ -3782,6 +3968,7 @@ function createThreadMutationObservable(environment, context, request) {
 	});
 }
 function createThreadStore(environment) {
+	const selectors = createThreadSelectors();
 	const store = createStore({
 		reducer: threadReducer,
 		effects: [
@@ -3848,6 +4035,10 @@ function createThreadStore(environment) {
 					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 = {
@@ -3856,7 +4047,7 @@ function createThreadStore(environment) {
 				};
 				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();
@@ -3878,12 +4069,14 @@ function createThreadStore(environment) {
 					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?.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")
 					} }));
@@ -3891,6 +4084,7 @@ function createThreadStore(environment) {
 				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: {
@@ -3900,12 +4094,24 @@ function createThreadStore(environment) {
 				});
 				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
@@ -3916,6 +4122,7 @@ function createThreadStore(environment) {
 	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) => {
@@ -3925,13 +4132,23 @@ function createThreadStore(environment) {
 		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) environment.onError?.(action.outcome.error);
+		});
+	};
 	return {
 		start() {
 			store.init();
+			subscribeErrors();
 			store.dispatch(threadAdapterEvents.started());
 		},
 		stop() {
 			store.dispatch(threadAdapterEvents.stopped());
+			errorSubscription?.unsubscribe();
+			errorSubscription = null;
 			store.stop();
 		},
 		setContext(context) {
@@ -3942,6 +4159,14 @@ function createThreadStore(environment) {
 			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());
 		},
@@ -3958,6 +4183,12 @@ function createThreadStore(environment) {
 				threadId
 			}));
 		},
+		unarchiveThread(threadId) {
+			return trackMutation(threadAdapterEvents.unarchiveRequested({
+				requestId: createThreadRequestId(),
+				threadId
+			}));
+		},
 		deleteThread(threadId) {
 			return trackMutation(threadAdapterEvents.deleteRequested({
 				requestId: createThreadRequestId(),
@@ -3967,15 +4198,21 @@ function createThreadStore(environment) {
 		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.
@@ -3984,6 +4221,51 @@ const ɵselectIsFetchingNextPage = selectIsFetchingNextPage;
 */
 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;
@@ -4011,8 +4293,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$;
@@ -4022,6 +4307,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;