@copilotkit/core 1.61.2 → 1.62.0

package/dist/index.cjs

@@ -1745,6 +1745,10 @@ var RunHandler = class {
 				if (incomingThreadId && typeof proxied.clearReplayCursor === "function") proxied.clearReplayCursor(incomingThreadId);
 			}
 			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),
@@ -1788,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 {
@@ -3589,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(),
@@ -3599,7 +3609,8 @@ const threadAdapterEvents = createActionGroup("Thread Adapter", {
 	renameRequested: props(),
 	archiveRequested: props(),
 	unarchiveRequested: props(),
-	deleteRequested: props()
+	deleteRequested: props(),
+	newThreadStarted: empty()
 });
 const threadRestEvents = createActionGroup("Thread REST", {
 	listRequested: props(),
@@ -3646,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: [],
@@ -3655,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 {
@@ -3697,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 {
@@ -3715,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,
@@ -3731,11 +3838,34 @@ 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;
@@ -3825,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))
 			} }));
@@ -3836,6 +3968,7 @@ function createThreadMutationObservable(environment, context, request) {
 	});
 }
 function createThreadStore(environment) {
+	const selectors = createThreadSelectors();
 	const store = createStore({
 		reducer: threadReducer,
 		effects: [
@@ -3902,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 = {
@@ -3933,11 +4070,13 @@ function createThreadStore(environment) {
 				}))), (0, rxjs_operators.takeUntil)(actions$.pipe(ofType(threadAdapterEvents.contextChanged, threadAdapterEvents.stopped))));
 			}))),
 			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")
 					} }));
@@ -3945,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: {
@@ -3954,12 +4094,14 @@ 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: {
@@ -3969,6 +4111,7 @@ function createThreadStore(environment) {
 				});
 				return createThreadMutationObservable(environment, context, {
 					requestId: action.requestId,
+					sessionId,
 					method: "DELETE",
 					path: `/threads/${encodeURIComponent(action.threadId)}`,
 					body: commonBody
@@ -3979,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) => {
@@ -3988,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) {
@@ -4005,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());
 		},
@@ -4036,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.
@@ -4053,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;
@@ -4080,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$;
@@ -4091,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;