@copilotkit/react-core 1.62.2 → 1.62.3

package/dist/{copilotkit-lHheGQWt.cjs → copilotkit-5MptLWNR.cjs}

@@ -4382,57 +4382,58 @@ const ALL_UPDATES = [
 	UseAgentUpdate.OnRunStatusChanged
 ];
 function useAgent({ agentId, updates, throttleMs } = {}) {
-	agentId ??= _copilotkit_shared.DEFAULT_AGENT_ID;
+	const chatConfig = useCopilotChatConfiguration();
+	const resolvedAgentId = agentId ?? chatConfig?.agentId ?? _copilotkit_shared.DEFAULT_AGENT_ID;
 	const { copilotkit } = useCopilotKit();
 	const providerThrottleMs = copilotkit.defaultThrottleMs;
 	const [, forceUpdate] = (0, react.useReducer)((x) => x + 1, 0);
 	const updateFlags = (0, react.useMemo)(() => updates ?? ALL_UPDATES, [JSON.stringify(updates)]);
 	const provisionalAgentCache = (0, react.useRef)(/* @__PURE__ */ new Map());
 	const agent = (0, react.useMemo)(() => {
-		const existing = copilotkit.getAgent(agentId);
+		const existing = copilotkit.getAgent(resolvedAgentId);
 		if (existing) {
-			provisionalAgentCache.current.delete(agentId);
+			provisionalAgentCache.current.delete(resolvedAgentId);
 			return existing;
 		}
 		const isRuntimeConfigured = copilotkit.runtimeUrl !== void 0;
 		const status = copilotkit.runtimeConnectionStatus;
 		if (isRuntimeConfigured && (status === _copilotkit_core.CopilotKitCoreRuntimeConnectionStatus.Disconnected || status === _copilotkit_core.CopilotKitCoreRuntimeConnectionStatus.Connecting)) {
-			const cached = provisionalAgentCache.current.get(agentId);
+			const cached = provisionalAgentCache.current.get(resolvedAgentId);
 			if (cached) {
 				copilotkit.applyHeadersToAgent(cached);
 				return cached;
 			}
 			const provisional = new _copilotkit_core.ProxiedCopilotRuntimeAgent({
 				runtimeUrl: copilotkit.runtimeUrl,
-				agentId,
+				agentId: resolvedAgentId,
 				transport: copilotkit.runtimeTransport,
 				runtimeMode: "pending"
 			});
 			copilotkit.applyHeadersToAgent(provisional);
-			provisionalAgentCache.current.set(agentId, provisional);
+			provisionalAgentCache.current.set(resolvedAgentId, provisional);
 			return provisional;
 		}
 		if (isRuntimeConfigured && status === _copilotkit_core.CopilotKitCoreRuntimeConnectionStatus.Error) {
-			const cached = provisionalAgentCache.current.get(agentId);
+			const cached = provisionalAgentCache.current.get(resolvedAgentId);
 			if (cached) {
 				copilotkit.applyHeadersToAgent(cached);
 				return cached;
 			}
 			const provisional = new _copilotkit_core.ProxiedCopilotRuntimeAgent({
 				runtimeUrl: copilotkit.runtimeUrl,
-				agentId,
+				agentId: resolvedAgentId,
 				transport: copilotkit.runtimeTransport,
 				runtimeMode: "pending"
 			});
 			copilotkit.applyHeadersToAgent(provisional);
-			provisionalAgentCache.current.set(agentId, provisional);
+			provisionalAgentCache.current.set(resolvedAgentId, provisional);
 			return provisional;
 		}
 		const knownAgents = Object.keys(copilotkit.agents ?? {});
 		const runtimePart = isRuntimeConfigured ? `runtimeUrl=${copilotkit.runtimeUrl}` : "no runtimeUrl";
-		throw new Error(`useAgent: Agent '${agentId}' not found after runtime sync (${runtimePart}). ` + (knownAgents.length ? `Known agents: [${knownAgents.join(", ")}]` : "No agents registered.") + " Verify your runtime /info and/or agents__unsafe_dev_only.");
+		throw new Error(`useAgent: Agent '${resolvedAgentId}' not found after runtime sync (${runtimePart}). ` + (knownAgents.length ? `Known agents: [${knownAgents.join(", ")}]` : "No agents registered.") + " Verify your runtime /info and/or agents__unsafe_dev_only.");
 	}, [
-		agentId,
+		resolvedAgentId,
 		copilotkit.agents,
 		copilotkit.runtimeConnectionStatus,
 		copilotkit.runtimeUrl,
@@ -4477,7 +4478,6 @@ function useAgent({ agentId, updates, throttleMs } = {}) {
 	(0, react.useEffect)(() => {
 		if (agent instanceof _ag_ui_client.HttpAgent) copilotkit.applyHeadersToAgent(agent);
 	}, [agent, JSON.stringify(copilotkit.headers)]);
-	const chatConfig = useCopilotChatConfiguration();
 	const configThreadId = chatConfig?.threadId;
 	const configHasExplicitThreadId = chatConfig?.hasExplicitThreadId;
 	(0, react.useEffect)(() => {
@@ -4494,13 +4494,15 @@ function useAgent({ agentId, updates, throttleMs } = {}) {
 //#endregion
 //#region src/v2/hooks/use-capabilities.tsx
 /**
-* Returns the capabilities declared by the given agent (or the default agent).
+* Returns the capabilities declared by the given agent (or the agent resolved
+* from the surrounding chat configuration, falling back to the default agent).
 * Capabilities are populated from the runtime `/info` response at connection
 * time. The hook reads them synchronously from the agent instance — there is
 * no separate loading state, but the value will be `undefined` until the
 * runtime handshake completes.
 *
-* @param agentId - Optional agent ID. If omitted, uses the default agent.
+* @param agentId - Optional agent ID. If omitted, inherits the surrounding
+*          chat configuration's agent, falling back to the default agent.
 * @returns The agent's capabilities, or `undefined` if the agent doesn't
 *          declare capabilities.
 */
@@ -5073,6 +5075,7 @@ function useThreads$1({ agentId, includeArchived, limit, enabled = true }) {
 	})), [coreThreads]);
 	const storeIsLoading = useThreadStoreSelector(store, _copilotkit_core.ɵselectThreadsIsLoading);
 	const storeError = useThreadStoreSelector(store, _copilotkit_core.ɵselectThreadsError);
+	const fetchMoreError = useThreadStoreSelector(store, _copilotkit_core.ɵselectFetchMoreError);
 	const hasMoreThreads = useThreadStoreSelector(store, _copilotkit_core.ɵselectHasNextPage);
 	const isFetchingMoreThreads = useThreadStoreSelector(store, _copilotkit_core.ɵselectIsFetchingNextPage);
 	const isMutating = useThreadStoreSelector(store, _copilotkit_core.ɵselectIsMutating);
@@ -5178,6 +5181,7 @@ function useThreads$1({ agentId, includeArchived, limit, enabled = true }) {
 		isLoading,
 		error,
 		listError,
+		fetchMoreError,
 		hasMoreThreads,
 		isFetchingMoreThreads,
 		isMutating,
@@ -5194,6 +5198,70 @@ function useThreads$1({ agentId, includeArchived, limit, enabled = true }) {
 	};
 }
 
+//#endregion
+//#region src/v2/hooks/use-memories.tsx
+function useMemoryStoreSelector(store, selector) {
+	return (0, react.useSyncExternalStore)((0, react.useCallback)((onStoreChange) => {
+		const subscription = store.select(selector).subscribe(onStoreChange);
+		return () => subscription.unsubscribe();
+	}, [store, selector]), () => selector(store.getState()), () => selector(store.getServerState()));
+}
+/**
+* React hook for listing and managing platform memories.
+*
+* Reads the memory store owned and wired by `CopilotKitCore`. On mount the
+* hook exposes the live list plus stable `addMemory` / `updateMemory` /
+* `removeMemory` / `refresh` callbacks. Mutations are server-authoritative:
+* each resolves once the platform confirms the operation and rejects with an
+* `Error` on failure.
+*
+* Realtime updates are automatic: the core's memory store opens its own
+* `user_meta:memories:<joinCode>` channel and applies `memory_metadata` deltas
+* to the list. You can still call `refresh()` to re-pull the REST snapshot on
+* demand.
+*
+* @returns Memory list state and stable mutation callbacks.
+*
+* @example
+* ```tsx
+* import { useMemories } from "@copilotkit/react-core";
+*
+* function MemoryList() {
+*   const { memories, isLoading, isAvailable, addMemory, removeMemory } =
+*     useMemories();
+*
+*   if (!isAvailable) return null;
+*   if (isLoading) return <p>Loading…</p>;
+*
+*   return (
+*     <ul>
+*       {memories.map((m) => (
+*         <li key={m.id}>
+*           {m.content}
+*           <button onClick={() => removeMemory(m.id)}>Delete</button>
+*         </li>
+*       ))}
+*     </ul>
+*   );
+* }
+* ```
+*/
+function useMemories() {
+	const { copilotkit } = useCopilotKit();
+	const store = copilotkit.getMemoryStore();
+	return {
+		memories: useMemoryStoreSelector(store, _copilotkit_core.ɵselectMemories),
+		isLoading: useMemoryStoreSelector(store, _copilotkit_core.ɵselectMemoriesIsLoading),
+		error: useMemoryStoreSelector(store, _copilotkit_core.ɵselectMemoriesError),
+		isAvailable: useMemoryStoreSelector(store, _copilotkit_core.ɵselectMemoriesAvailable),
+		realtimeStatus: useMemoryStoreSelector(store, _copilotkit_core.ɵselectMemoriesRealtimeStatus),
+		refresh: (0, react.useCallback)(() => store.refresh(), [store]),
+		addMemory: (0, react.useCallback)((input) => store.addMemory(input), [store]),
+		updateMemory: (0, react.useCallback)((id, changes) => store.updateMemory(id, changes), [store]),
+		removeMemory: (0, react.useCallback)((id) => store.removeMemory(id), [store])
+	};
+}
+
 //#endregion
 //#region src/v2/lib/record-annotation.ts
 /**
@@ -9055,7 +9123,7 @@ function findChatInput(origin) {
 *   during prerender to avoid hydration mismatch).
 * - Feeds the element domain data: `threads`, `loading`, `error`,
 *   `activeThreadId`, `licensed`, fetch-more state.
-* - Routes the element's nine outbound events to core thread operations
+* - Routes the element's outbound events to core thread operations
 *   ({@link useThreads}) and chat-configuration changes.
 * - Registers with the surrounding chat configuration so the header
 *   thread-list launcher appears, and binds the element `open` state to the
@@ -9082,16 +9150,16 @@ function findChatInput(origin) {
 * </CopilotKitProvider>
 * ```
 */
-function CopilotThreadsDrawer({ agentId, onThreadSelect, onNewThread, onLicensed, licenseUrl, renderRow, label, limit, "data-testid": dataTestId = "copilot-threads-drawer" }) {
+function CopilotThreadsDrawer({ agentId, onThreadSelect, onNewThread, onLicensed, licenseUrl, renderRow, label, recentLabel, collapsible, onCollapseChange, limit, "data-testid": dataTestId = "copilot-threads-drawer" }) {
 	const configuration = useCopilotChatConfiguration();
 	const { status, checkFeature } = useLicenseContext();
 	const licensePresent = status === "valid" || status === "expiring";
 	const featureLicensed = checkFeature("threads");
 	const licensed = licensePresent && featureLicensed;
 	const licensePending = status === null;
-	const resolvedAgentId = agentId ?? configuration?.agentId ?? "default";
+	const resolvedAgentId = agentId ?? configuration?.agentId ?? _copilotkit_shared.DEFAULT_AGENT_ID;
 	const activeThreadId = configuration?.threadId ?? null;
-	const { threads, isLoading, listError, hasMoreThreads, isFetchingMoreThreads, archiveThread, unarchiveThread, deleteThread, fetchMoreThreads, refetchThreads, startNewThread } = useThreads$1({
+	const { threads, isLoading, listError, fetchMoreError, hasMoreThreads, isFetchingMoreThreads, archiveThread, unarchiveThread, deleteThread, fetchMoreThreads, refetchThreads, startNewThread } = useThreads$1({
 		agentId: resolvedAgentId,
 		includeArchived: true,
 		enabled: licensed,
@@ -9172,6 +9240,9 @@ function CopilotThreadsDrawer({ agentId, onThreadSelect, onNewThread, onLicensed
 	const handleLoadMore = (0, react.useCallback)(() => {
 		fetchMoreThreads();
 	}, [fetchMoreThreads]);
+	const handleCollapseChange = (0, react.useCallback)((collapsed) => {
+		onCollapseChange?.(collapsed);
+	}, [onCollapseChange]);
 	const handlersRef = (0, react.useRef)({
 		handleThreadSelected,
 		handleNewThread,
@@ -9182,7 +9253,8 @@ function CopilotThreadsDrawer({ agentId, onThreadSelect, onNewThread, onLicensed
 		handleRetry,
 		handleOpenChange,
 		handleLicensed,
-		handleLoadMore
+		handleLoadMore,
+		handleCollapseChange
 	});
 	handlersRef.current = {
 		handleThreadSelected,
@@ -9194,7 +9266,8 @@ function CopilotThreadsDrawer({ agentId, onThreadSelect, onNewThread, onLicensed
 		handleRetry,
 		handleOpenChange,
 		handleLicensed,
-		handleLoadMore
+		handleLoadMore,
+		handleCollapseChange
 	};
 	(0, react.useEffect)(() => {
 		const el = elementRef.current;
@@ -9229,6 +9302,10 @@ function CopilotThreadsDrawer({ agentId, onThreadSelect, onNewThread, onLicensed
 		};
 		const onLicensedEvent = () => handlersRef.current.handleLicensed();
 		const onLoadMore = () => handlersRef.current.handleLoadMore();
+		const onCollapseChangeEvent = (event) => {
+			const detail = event.detail;
+			handlersRef.current.handleCollapseChange(detail.collapsed);
+		};
 		el.addEventListener("thread-selected", onThreadSelected);
 		el.addEventListener("new-thread", onNewThreadEvent);
 		el.addEventListener("archive", onArchive);
@@ -9239,6 +9316,7 @@ function CopilotThreadsDrawer({ agentId, onThreadSelect, onNewThread, onLicensed
 		el.addEventListener("retry", onRetry);
 		el.addEventListener("licensed", onLicensedEvent);
 		el.addEventListener("load-more", onLoadMore);
+		el.addEventListener("collapse-change", onCollapseChangeEvent);
 		return () => {
 			el.removeEventListener("thread-selected", onThreadSelected);
 			el.removeEventListener("new-thread", onNewThreadEvent);
@@ -9250,6 +9328,7 @@ function CopilotThreadsDrawer({ agentId, onThreadSelect, onNewThread, onLicensed
 			el.removeEventListener("retry", onRetry);
 			el.removeEventListener("licensed", onLicensedEvent);
 			el.removeEventListener("load-more", onLoadMore);
+			el.removeEventListener("collapse-change", onCollapseChangeEvent);
 		};
 	}, [mounted]);
 	(0, react.useEffect)(() => {
@@ -9266,9 +9345,11 @@ function CopilotThreadsDrawer({ agentId, onThreadSelect, onNewThread, onLicensed
 		el.licensed = licensed || licensePending;
 		el.hasMore = hasMoreThreads;
 		el.fetchingMore = isFetchingMoreThreads;
+		el.fetchMoreError = fetchMoreError ? fetchMoreError.message : null;
 	}, [
 		isLoading,
 		listError,
+		fetchMoreError,
 		activeThreadId,
 		licensed,
 		licensePending,
@@ -9291,6 +9372,11 @@ function CopilotThreadsDrawer({ agentId, onThreadSelect, onNewThread, onLicensed
 		if (!el) return;
 		if (licenseUrl !== void 0) el.licenseUrl = licenseUrl;
 	}, [licenseUrl, mounted]);
+	(0, react.useEffect)(() => {
+		const el = elementRef.current;
+		if (!el) return;
+		if (collapsible !== void 0) el.collapsible = collapsible;
+	}, [collapsible, mounted]);
 	const rowChildren = (0, react.useMemo)(() => {
 		if (!renderRow) return null;
 		return drawerThreads.map((drawerThread) => {
@@ -9311,7 +9397,8 @@ function CopilotThreadsDrawer({ agentId, onThreadSelect, onNewThread, onLicensed
 	if (!mounted) return null;
 	return react.default.createElement(_copilotkit_web_components_threads_drawer.COPILOTKIT_THREADS_DRAWER_TAG, {
 		ref: elementRef,
-		"data-testid": dataTestId
+		"data-testid": dataTestId,
+		...recentLabel !== void 0 ? { "recent-label": recentLabel } : {}
 	}, rowChildren);
 }
 CopilotThreadsDrawer.displayName = "CopilotThreadsDrawer";
@@ -10964,8 +11051,18 @@ const usePredictStateSubscription = (agent) => {
 	}, [agent, getSubscriber]);
 };
 function CopilotListenersAgentSubscription() {
-	const resolvedAgentId = useCopilotChatConfiguration()?.agentId;
-	const { agent } = useAgent({ agentId: resolvedAgentId });
+	const { copilotkit } = useCopilotKit();
+	const configAgentId = useCopilotChatConfiguration()?.agentId;
+	const { agent } = useAgent({ agentId: (0, react.useMemo)(() => {
+		const requested = configAgentId ?? _copilotkit_shared.DEFAULT_AGENT_ID;
+		const registered = copilotkit.agents ?? {};
+		if (registered[requested]) return requested;
+		if (requested === _copilotkit_shared.DEFAULT_AGENT_ID) {
+			const firstRegistered = Object.keys(registered)[0];
+			if (firstRegistered) return firstRegistered;
+		}
+		return requested;
+	}, [configAgentId, copilotkit.agents]) });
 	usePredictStateSubscription(agent);
 	return null;
 }
@@ -11918,6 +12015,12 @@ Object.defineProperty(exports, 'useLearningContainersInCurrentThread', {
     return useLearningContainersInCurrentThread;
   }
 });
+Object.defineProperty(exports, 'useMemories', {
+  enumerable: true,
+  get: function () {
+    return useMemories;
+  }
+});
 Object.defineProperty(exports, 'useRenderActivityMessage', {
   enumerable: true,
   get: function () {
@@ -11972,4 +12075,4 @@ Object.defineProperty(exports, 'useToast', {
     return useToast;
   }
 });
-//# sourceMappingURL=copilotkit-lHheGQWt.cjs.map
+//# sourceMappingURL=copilotkit-5MptLWNR.cjs.map