@copilotkit/react-core 1.62.0 → 1.62.2-canary.1783457132

package/dist/{copilotkit-BtRkFsNR.mjs → copilotkit-BQT2ngSh.mjs}

@@ -1,6 +1,6 @@
 import * as React$1 from "react";
 import React, { createContext, forwardRef, memo, useCallback, useContext, useEffect, useId, useImperativeHandle, useLayoutEffect, useMemo, useReducer, useRef, useState, useSyncExternalStore } from "react";
-import { CopilotKitCore, CopilotKitCoreRuntimeConnectionStatus, ProxiedCopilotRuntimeAgent, ToolCallStatus, isRunCompletionAware, ɵcreateThreadStore, ɵselectHasNextPage, ɵselectIsFetchingNextPage, ɵselectIsMutating, ɵselectThreads, ɵselectThreadsError, ɵselectThreadsIsLoading } from "@copilotkit/core";
+import { CopilotKitCore, CopilotKitCoreRuntimeConnectionStatus, ProxiedCopilotRuntimeAgent, ToolCallStatus, isRunCompletionAware, ɵcreateThreadStore, ɵselectHasNextPage, ɵselectIsFetchingNextPage, ɵselectIsMutating, ɵselectMemories, ɵselectMemoriesAvailable, ɵselectMemoriesError, ɵselectMemoriesIsLoading, ɵselectMemoriesRealtimeStatus, ɵselectThreads, ɵselectThreadsError, ɵselectThreadsIsLoading } from "@copilotkit/core";
 import { HttpAgent, buildResumeArray, isInterruptExpired, randomUUID } from "@ag-ui/client";
 import { extendTailwindMerge, twMerge } from "tailwind-merge";
 import { ArrowUp, Check, ChevronDown, ChevronLeft, ChevronRight, ChevronRightIcon, Copy, Edit, Loader2, MessageCircle, Mic, PanelLeftOpen, Play, Plus, RefreshCw, Square, ThumbsDown, ThumbsUp, Upload, Volume2, X } from "lucide-react";
@@ -3620,12 +3620,13 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers: headersProp = EMPTY
 	}
 	const copilotkit = copilotkitRef.current;
 	useEffect(() => {
-		setRuntimeA2UIEnabled(copilotkit.a2uiEnabled);
-		const subscription = copilotkit.subscribe({ onRuntimeConnectionStatusChanged: () => {
+		const syncRuntimeInfo = () => {
 			setRuntimeA2UIEnabled(copilotkit.a2uiEnabled);
 			setRuntimeOpenGenUIEnabled(copilotkit.openGenerativeUIEnabled);
 			setRuntimeLicenseStatus(copilotkit.licenseStatus);
-		} });
+		};
+		const subscription = copilotkit.subscribe({ onRuntimeConnectionStatusChanged: syncRuntimeInfo });
+		syncRuntimeInfo();
 		return () => {
 			subscription.unsubscribe();
 		};
@@ -5163,6 +5164,70 @@ function useThreads$1({ agentId, includeArchived, limit, enabled = true }) {
 	};
 }
 
+//#endregion
+//#region src/v2/hooks/use-memories.tsx
+function useMemoryStoreSelector(store, selector) {
+	return useSyncExternalStore(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, ɵselectMemories),
+		isLoading: useMemoryStoreSelector(store, ɵselectMemoriesIsLoading),
+		error: useMemoryStoreSelector(store, ɵselectMemoriesError),
+		isAvailable: useMemoryStoreSelector(store, ɵselectMemoriesAvailable),
+		realtimeStatus: useMemoryStoreSelector(store, ɵselectMemoriesRealtimeStatus),
+		refresh: useCallback(() => store.refresh(), [store]),
+		addMemory: useCallback((input) => store.addMemory(input), [store]),
+		updateMemory: useCallback((id, changes) => store.updateMemory(id, changes), [store]),
+		removeMemory: useCallback((id) => store.removeMemory(id), [store])
+	};
+}
+
 //#endregion
 //#region src/v2/lib/record-annotation.ts
 /**
@@ -7925,9 +7990,57 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 	const { messageView: providedMessageView, suggestionView: providedSuggestionView, onStop: providedStopHandler, ...restProps } = props;
 	const [lastConnectedThreadId, setLastConnectedThreadId] = useState(null);
 	const isConnecting = hasExplicitThreadId && lastConnectedThreadId !== resolvedThreadId;
+	const activeConnectCountRef = useRef(0);
+	const pendingRunActivityReconnectRef = useRef(false);
+	const runActivityReconnectGenerationRef = useRef(0);
+	const activeLocalRunIdsRef = useRef(/* @__PURE__ */ new Set());
+	const recentlyLocalRunIdsRef = useRef(/* @__PURE__ */ new Map());
+	const activeWakeRunIdsRef = useRef(/* @__PURE__ */ new Set());
+	const recentlyWakeRunIdsRef = useRef(/* @__PURE__ */ new Map());
+	const pendingWakeRunIdRef = useRef(void 0);
+	const startRunActivityReconnectRef = useRef(null);
+	const runtimeStatus = copilotkit.runtimeConnectionStatus === CopilotKitCoreRuntimeConnectionStatus.Connected ? "Connected" : copilotkit.runtimeConnectionStatus;
+	const hasNativeIntelligenceRunActivity = hasExplicitThreadId && runtimeStatus === "Connected" && !!copilotkit.intelligence?.wsUrl && copilotkit.threadEndpoints?.realtimeMetadata === true;
+	const [standaloneRunActivityStore] = useState(() => ɵcreateThreadStore({ fetch: globalThis.fetch }));
 	const previousThreadIdRef = useRef(null);
 	const hasExplicitThreadIdRef = useRef(hasExplicitThreadId);
 	hasExplicitThreadIdRef.current = hasExplicitThreadId;
+	const rememberRecentlyLocalRunId = useCallback((runId) => {
+		const existingTimeout = recentlyLocalRunIdsRef.current.get(runId);
+		if (existingTimeout) clearTimeout(existingTimeout);
+		const timeout = setTimeout(() => {
+			recentlyLocalRunIdsRef.current.delete(runId);
+		}, 3e4);
+		recentlyLocalRunIdsRef.current.set(runId, timeout);
+	}, []);
+	const rememberRecentlyWakeRunId = useCallback((runId) => {
+		const existingTimeout = recentlyWakeRunIdsRef.current.get(runId);
+		if (existingTimeout) clearTimeout(existingTimeout);
+		const timeout = setTimeout(() => {
+			recentlyWakeRunIdsRef.current.delete(runId);
+		}, 3e4);
+		recentlyWakeRunIdsRef.current.set(runId, timeout);
+	}, []);
+	const isLocalActiveRunActivity = useCallback((notification) => {
+		if (notification.agentId && notification.agentId !== resolvedAgentId) return false;
+		if (!notification.runId || !activeLocalRunIdsRef.current.has(notification.runId) && !recentlyLocalRunIdsRef.current.has(notification.runId)) return false;
+		const eventType = notification.eventType.toUpperCase();
+		return eventType === "RUN_STARTED" || eventType === "RUN_FINISHED" || eventType === "RUN_ERROR";
+	}, [resolvedAgentId]);
+	useEffect(() => {
+		const recentlyLocalRunIds = recentlyLocalRunIdsRef.current;
+		const recentlyWakeRunIds = recentlyWakeRunIdsRef.current;
+		return () => {
+			recentlyLocalRunIds.forEach((timeout) => {
+				clearTimeout(timeout);
+			});
+			recentlyLocalRunIds.clear();
+			recentlyWakeRunIds.forEach((timeout) => {
+				clearTimeout(timeout);
+			});
+			recentlyWakeRunIds.clear();
+		};
+	}, []);
 	useEffect(() => {
 		const threadChanged = previousThreadIdRef.current !== resolvedThreadId;
 		previousThreadIdRef.current = resolvedThreadId;
@@ -7940,6 +8053,7 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 		const connectAbortController = new AbortController();
 		if (agent instanceof HttpAgent) agent.abortController = connectAbortController;
 		const connect = async (agentToConnect) => {
+			activeConnectCountRef.current += 1;
 			try {
 				await copilotkit.connectAgent({ agent: agentToConnect });
 			} catch (error) {
@@ -7950,6 +8064,14 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 					if (!detached) setLastConnectedThreadId(resolvedThreadId);
 				});
 				else if (!hasExplicitThreadIdRef.current) agentToConnect.setMessages([]);
+				activeConnectCountRef.current = Math.max(0, activeConnectCountRef.current - 1);
+				if (!detached && activeConnectCountRef.current === 0) {
+					const startReconnect = startRunActivityReconnectRef.current;
+					if (pendingRunActivityReconnectRef.current && startReconnect) {
+						pendingRunActivityReconnectRef.current = false;
+						startReconnect(runActivityReconnectGenerationRef.current);
+					}
+				}
 			}
 		};
 		connect(agent);
@@ -7964,6 +8086,119 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 		resolvedAgentId,
 		hasExplicitThreadId
 	]);
+	useEffect(() => {
+		if (!hasNativeIntelligenceRunActivity) return;
+		const registeredThreadStore = copilotkit.getThreadStore(resolvedAgentId);
+		const threadStore = registeredThreadStore ?? standaloneRunActivityStore;
+		if (!threadStore?.subscribeToRunActivity) return;
+		const ownsStandaloneStore = registeredThreadStore === void 0;
+		if (ownsStandaloneStore) {
+			threadStore.start();
+			const context = copilotkit.runtimeUrl ? {
+				runtimeUrl: copilotkit.runtimeUrl,
+				headers: { ...copilotkit.headers },
+				wsUrl: copilotkit.intelligence?.wsUrl,
+				agentId: resolvedAgentId
+			} : null;
+			threadStore.setContext(context);
+		}
+		const generation = runActivityReconnectGenerationRef.current + 1;
+		runActivityReconnectGenerationRef.current = generation;
+		let detached = false;
+		let wakeReconnectActive = false;
+		let pendingAgentIdleDrain = null;
+		const hasActiveAgentRun = () => activeLocalRunIdsRef.current.size > 0 || agent.isRunning;
+		const scheduleAgentIdleDrain = () => {
+			if (pendingAgentIdleDrain !== null) return;
+			pendingAgentIdleDrain = setTimeout(() => {
+				pendingAgentIdleDrain = null;
+				if (detached || runActivityReconnectGenerationRef.current !== generation || !pendingRunActivityReconnectRef.current) return;
+				if (hasActiveAgentRun()) {
+					scheduleAgentIdleDrain();
+					return;
+				}
+				startRunActivityReconnectRef.current?.(generation);
+			}, 10);
+		};
+		const connect = async () => {
+			activeConnectCountRef.current += 1;
+			wakeReconnectActive = true;
+			const wakeRunId = pendingWakeRunIdRef.current;
+			pendingWakeRunIdRef.current = void 0;
+			if (wakeRunId) activeWakeRunIdsRef.current.add(wakeRunId);
+			let didConnect = false;
+			try {
+				await copilotkit.connectAgent({ agent });
+				didConnect = true;
+			} catch (error) {
+				if (!detached) console.error("CopilotChat: run activity reconnect failed", error);
+			} finally {
+				if (wakeRunId) {
+					activeWakeRunIdsRef.current.delete(wakeRunId);
+					if (didConnect) rememberRecentlyWakeRunId(wakeRunId);
+				}
+				activeConnectCountRef.current = Math.max(0, activeConnectCountRef.current - 1);
+				wakeReconnectActive = false;
+				if (!detached && runActivityReconnectGenerationRef.current === generation && activeConnectCountRef.current === 0 && pendingRunActivityReconnectRef.current) {
+					pendingRunActivityReconnectRef.current = false;
+					connect();
+				}
+			}
+		};
+		startRunActivityReconnectRef.current = (requestedGeneration) => {
+			if (detached || requestedGeneration !== generation || runActivityReconnectGenerationRef.current !== generation) return;
+			if (hasActiveAgentRun()) {
+				pendingRunActivityReconnectRef.current = true;
+				scheduleAgentIdleDrain();
+				return;
+			}
+			if (activeConnectCountRef.current > 0) {
+				if (!wakeReconnectActive) pendingRunActivityReconnectRef.current = true;
+				return;
+			}
+			pendingRunActivityReconnectRef.current = false;
+			connect();
+		};
+		const subscription = threadStore.subscribeToRunActivity((notification) => {
+			if (notification.threadId !== resolvedThreadId) return;
+			if (notification.agentId && notification.agentId !== resolvedAgentId) return;
+			if (isLocalActiveRunActivity(notification)) return;
+			if (notification.runId && (activeWakeRunIdsRef.current.has(notification.runId) || recentlyWakeRunIdsRef.current.has(notification.runId))) return;
+			pendingWakeRunIdRef.current = notification.runId;
+			startRunActivityReconnectRef.current?.(generation);
+		});
+		return () => {
+			detached = true;
+			pendingRunActivityReconnectRef.current = false;
+			pendingWakeRunIdRef.current = void 0;
+			if (pendingAgentIdleDrain !== null) {
+				clearTimeout(pendingAgentIdleDrain);
+				pendingAgentIdleDrain = null;
+			}
+			if (startRunActivityReconnectRef.current) startRunActivityReconnectRef.current = null;
+			if (wakeReconnectActive) agent.detachActiveRun().catch(() => {});
+			activeWakeRunIdsRef.current.clear();
+			subscription.unsubscribe();
+			if (ownsStandaloneStore) {
+				threadStore.setContext(null);
+				threadStore.stop();
+			}
+		};
+	}, [
+		agent,
+		resolvedAgentId,
+		resolvedThreadId,
+		hasExplicitThreadId,
+		hasNativeIntelligenceRunActivity,
+		copilotkit.runtimeConnectionStatus,
+		copilotkit.runtimeUrl,
+		copilotkit.headers,
+		copilotkit.intelligence?.wsUrl,
+		copilotkit.threadEndpoints?.realtimeMetadata,
+		standaloneRunActivityStore,
+		isLocalActiveRunActivity,
+		rememberRecentlyWakeRunId
+	]);
 	const waitForActiveRunToSettle = useCallback(async () => {
 		const maybeAware = agent;
 		const activeRunCompletionPromise = isRunCompletionAware(maybeAware) ? maybeAware.activeRunCompletionPromise : void 0;
@@ -8012,15 +8247,34 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 			role: "user",
 			content: value
 		});
+		const localRunId = hasNativeIntelligenceRunActivity ? randomUUID$1() : void 0;
+		if (localRunId) activeLocalRunIdsRef.current.add(localRunId);
 		try {
-			await copilotkit.runAgent({ agent });
+			await copilotkit.runAgent({
+				agent,
+				...localRunId !== void 0 ? { runId: localRunId } : {}
+			});
 		} catch (error) {
 			console.error("CopilotChat: runAgent failed", error);
+		} finally {
+			if (localRunId) {
+				activeLocalRunIdsRef.current.delete(localRunId);
+				rememberRecentlyLocalRunId(localRunId);
+			}
+			if (pendingRunActivityReconnectRef.current && activeLocalRunIdsRef.current.size === 0 && activeConnectCountRef.current === 0) {
+				const startReconnect = startRunActivityReconnectRef.current;
+				if (startReconnect) {
+					pendingRunActivityReconnectRef.current = false;
+					startReconnect(runActivityReconnectGenerationRef.current);
+				}
+			}
 		}
 	}, [
 		agent,
 		consumeAttachments,
-		waitForActiveRunToSettle
+		waitForActiveRunToSettle,
+		hasNativeIntelligenceRunActivity,
+		rememberRecentlyLocalRunId
 	]);
 	const handleSelectSuggestion = useCallback(async (suggestion) => {
 		await waitForActiveRunToSettle();
@@ -8029,12 +8283,34 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 			role: "user",
 			content: suggestion.message
 		});
+		const localRunId = hasNativeIntelligenceRunActivity ? randomUUID$1() : void 0;
+		if (localRunId) activeLocalRunIdsRef.current.add(localRunId);
 		try {
-			await copilotkit.runAgent({ agent });
+			await copilotkit.runAgent({
+				agent,
+				...localRunId !== void 0 ? { runId: localRunId } : {}
+			});
 		} catch (error) {
 			console.error("CopilotChat: runAgent failed after selecting suggestion", error);
+		} finally {
+			if (localRunId) {
+				activeLocalRunIdsRef.current.delete(localRunId);
+				rememberRecentlyLocalRunId(localRunId);
+			}
+			if (pendingRunActivityReconnectRef.current && activeLocalRunIdsRef.current.size === 0 && activeConnectCountRef.current === 0) {
+				const startReconnect = startRunActivityReconnectRef.current;
+				if (startReconnect) {
+					pendingRunActivityReconnectRef.current = false;
+					startReconnect(runActivityReconnectGenerationRef.current);
+				}
+			}
 		}
-	}, [agent, waitForActiveRunToSettle]);
+	}, [
+		agent,
+		waitForActiveRunToSettle,
+		hasNativeIntelligenceRunActivity,
+		rememberRecentlyLocalRunId
+	]);
 	const stopCurrentRun = useCallback(() => {
 		try {
 			copilotkit.stopAgent({ agent });
@@ -11256,5 +11532,5 @@ function validateProps(props) {
 }
 
 //#endregion
-export { UseAgentUpdate as $, CopilotChatMessageView as A, CopilotChatAssistantMessage_default as B, CopilotModalHeader as C, CopilotChatConfigurationProvider as Ct, CopilotChat as D, DefaultOpenIcon as E, CopilotChatSuggestionView as F, useLearnFromUserActionInCurrentThread as G, useLearningContainersInCurrentThread as H, CopilotChatSuggestionPill as I, useInterrupt as J, useLearnFromUserAction as K, CopilotChatReasoningMessage_default as L, IntelligenceIndicator as M, getIntelligenceTurnAnchors as N, CopilotChatView_default as O, IntelligenceIndicatorView as P, useCapabilities as Q, CopilotChatUserMessage_default as R, CopilotSidebarView as S, CopilotChatAudioRecorder as St, DefaultCloseIcon as T, useLearningContainers as U, CopilotChatToolCallsView as V, useAttachments as W, useSuggestions as X, useConfigureSuggestions as Y, useAgentContext as Z, WildcardToolCallRender as _, useRenderToolCall as _t, ThreadsProvider as a, useFrontendTool as at, CopilotSidebar as b, CopilotChatInput_default as bt, CoAgentStateRendersProvider as c, CopilotKitProvider as ct, shouldShowDevConsole as d, SandboxFunctionsContext as dt, useAgent as et, useToast as f, useSandboxFunctions as ft, useCopilotContext as g, CopilotKitInspector as gt, CopilotContext as h, MCPAppsActivityType as ht, ThreadsContext as i, useComponent as it, INTELLIGENCE_TURN_HEAD as j, CopilotChatAttachmentQueue as k, useCoAgentStateRenders as l, defineToolCallRenderer as lt, useCopilotMessagesContext as m, MCPAppsActivityRenderer as mt, defaultCopilotContextCategories as n, useDefaultRenderTool as nt, useThreads as o, useRenderActivityMessage as ot, CopilotMessagesContext as p, MCPAppsActivityContentSchema as pt, useThreads$1 as q, CoAgentStateRenderBridge as r, useRenderTool as rt, CoAgentStateRendersContext as s, useRenderCustomMessages as st, CopilotKit as t, useHumanInTheLoop as tt, useAsyncCallback as u, createA2UIMessageRenderer as ut, CopilotThreadsDrawer as v, useCopilotKit as vt, CopilotChatToggleButton as w, useCopilotChatConfiguration as wt, CopilotPopupView as x, AudioRecorderError as xt, CopilotPopup as y, CopilotKitCoreReact as yt, CopilotChatAttachmentRenderer as z };
-//# sourceMappingURL=copilotkit-BtRkFsNR.mjs.map
+export { useCapabilities as $, CopilotChatMessageView as A, CopilotChatAssistantMessage_default as B, CopilotModalHeader as C, CopilotChatAudioRecorder as Ct, CopilotChat as D, DefaultOpenIcon as E, CopilotChatSuggestionView as F, useLearnFromUserActionInCurrentThread as G, useLearningContainersInCurrentThread as H, CopilotChatSuggestionPill as I, useThreads$1 as J, useLearnFromUserAction as K, CopilotChatReasoningMessage_default as L, IntelligenceIndicator as M, getIntelligenceTurnAnchors as N, CopilotChatView_default as O, IntelligenceIndicatorView as P, useAgentContext as Q, CopilotChatUserMessage_default as R, CopilotSidebarView as S, AudioRecorderError as St, DefaultCloseIcon as T, useCopilotChatConfiguration as Tt, useLearningContainers as U, CopilotChatToolCallsView as V, useAttachments as W, useConfigureSuggestions as X, useInterrupt as Y, useSuggestions as Z, WildcardToolCallRender as _, CopilotKitInspector as _t, ThreadsProvider as a, useComponent as at, CopilotSidebar as b, CopilotKitCoreReact as bt, CoAgentStateRendersProvider as c, useRenderCustomMessages as ct, shouldShowDevConsole as d, createA2UIMessageRenderer as dt, UseAgentUpdate as et, useToast as f, SandboxFunctionsContext as ft, useCopilotContext as g, MCPAppsActivityType as gt, CopilotContext as h, MCPAppsActivityRenderer as ht, ThreadsContext as i, useRenderTool as it, INTELLIGENCE_TURN_HEAD as j, CopilotChatAttachmentQueue as k, useCoAgentStateRenders as l, CopilotKitProvider as lt, useCopilotMessagesContext as m, MCPAppsActivityContentSchema as mt, defaultCopilotContextCategories as n, useHumanInTheLoop as nt, useThreads as o, useFrontendTool as ot, CopilotMessagesContext as p, useSandboxFunctions as pt, useMemories as q, CoAgentStateRenderBridge as r, useDefaultRenderTool as rt, CoAgentStateRendersContext as s, useRenderActivityMessage as st, CopilotKit as t, useAgent as tt, useAsyncCallback as u, defineToolCallRenderer as ut, CopilotThreadsDrawer as v, useRenderToolCall as vt, CopilotChatToggleButton as w, CopilotChatConfigurationProvider as wt, CopilotPopupView as x, CopilotChatInput_default as xt, CopilotPopup as y, useCopilotKit as yt, CopilotChatAttachmentRenderer as z };
+//# sourceMappingURL=copilotkit-BQT2ngSh.mjs.map