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

package/dist/{copilotkit-BQT2ngSh.mjs → copilotkit-dtSVHJCs.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, ɵselectMemories, ɵselectMemoriesAvailable, ɵselectMemoriesError, ɵselectMemoriesIsLoading, ɵselectMemoriesRealtimeStatus, ɵselectThreads, ɵselectThreadsError, ɵselectThreadsIsLoading } from "@copilotkit/core";
+import { CopilotKitCore, CopilotKitCoreRuntimeConnectionStatus, ProxiedCopilotRuntimeAgent, ToolCallStatus, isRunCompletionAware, ɵcreateThreadStore, ɵselectFetchMoreError, ɵ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";
@@ -4352,57 +4352,58 @@ const ALL_UPDATES = [
 	UseAgentUpdate.OnRunStatusChanged
 ];
 function useAgent({ agentId, updates, throttleMs } = {}) {
-	agentId ??= DEFAULT_AGENT_ID;
+	const chatConfig = useCopilotChatConfiguration();
+	const resolvedAgentId = agentId ?? chatConfig?.agentId ?? DEFAULT_AGENT_ID;
 	const { copilotkit } = useCopilotKit();
 	const providerThrottleMs = copilotkit.defaultThrottleMs;
 	const [, forceUpdate] = useReducer((x) => x + 1, 0);
 	const updateFlags = useMemo(() => updates ?? ALL_UPDATES, [JSON.stringify(updates)]);
 	const provisionalAgentCache = useRef(/* @__PURE__ */ new Map());
 	const agent = 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 === CopilotKitCoreRuntimeConnectionStatus.Disconnected || status === CopilotKitCoreRuntimeConnectionStatus.Connecting)) {
-			const cached = provisionalAgentCache.current.get(agentId);
+			const cached = provisionalAgentCache.current.get(resolvedAgentId);
 			if (cached) {
 				copilotkit.applyHeadersToAgent(cached);
 				return cached;
 			}
 			const provisional = new 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 === CopilotKitCoreRuntimeConnectionStatus.Error) {
-			const cached = provisionalAgentCache.current.get(agentId);
+			const cached = provisionalAgentCache.current.get(resolvedAgentId);
 			if (cached) {
 				copilotkit.applyHeadersToAgent(cached);
 				return cached;
 			}
 			const provisional = new 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,
@@ -4447,7 +4448,6 @@ function useAgent({ agentId, updates, throttleMs } = {}) {
 	useEffect(() => {
 		if (agent instanceof HttpAgent) copilotkit.applyHeadersToAgent(agent);
 	}, [agent, JSON.stringify(copilotkit.headers)]);
-	const chatConfig = useCopilotChatConfiguration();
 	const configThreadId = chatConfig?.threadId;
 	const configHasExplicitThreadId = chatConfig?.hasExplicitThreadId;
 	useEffect(() => {
@@ -4461,16 +4461,87 @@ function useAgent({ agentId, updates, throttleMs } = {}) {
 	return { agent };
 }
 
+//#endregion
+//#region src/v2/hooks/use-subagent.tsx
+const warnedAmbiguousNames = /* @__PURE__ */ new Set();
+function resolveSubagent(subagents, subagentId, subagentName) {
+	if (subagentId) {
+		const match = subagents[subagentId];
+		return match ? { ...match } : void 0;
+	}
+	if (subagentName) {
+		const matches = Object.values(subagents).filter((s) => s.name === subagentName);
+		if (matches.length === 0) return;
+		const chosen = matches[matches.length - 1];
+		return matches.length > 1 ? {
+			...chosen,
+			isAmbiguous: true,
+			matchCount: matches.length
+		} : { ...chosen };
+	}
+}
+/**
+* Read a subagent's live lifecycle state (name, description, running status)
+* from the CopilotKit core subagent registry, by id or by declared name.
+*
+* @example
+* const sub = useSubagent({ subagentId: message.subagentId });
+* // sub?.name, sub?.description, sub?.status
+*/
+function useSubagent(params) {
+	const { subagentId, subagentName, agentId } = params;
+	const { copilotkit } = useCopilotKit();
+	const config = useCopilotChatConfiguration();
+	const resolvedAgentId = useMemo(() => agentId ?? config?.agentId ?? DEFAULT_AGENT_ID, [agentId, config?.agentId]);
+	const [subagent, setSubagent] = useState(() => resolveSubagent(copilotkit.getSubagents(resolvedAgentId), subagentId, subagentName));
+	useEffect(() => {
+		setSubagent(resolveSubagent(copilotkit.getSubagents(resolvedAgentId), subagentId, subagentName));
+	}, [
+		copilotkit,
+		resolvedAgentId,
+		subagentId,
+		subagentName
+	]);
+	useEffect(() => {
+		const subscription = copilotkit.subscribe({ onSubagentsChanged: ({ agentId: changedAgentId, subagents }) => {
+			if (changedAgentId !== resolvedAgentId) return;
+			setSubagent(resolveSubagent(subagents, subagentId, subagentName));
+		} });
+		return () => {
+			subscription.unsubscribe();
+		};
+	}, [
+		copilotkit,
+		resolvedAgentId,
+		subagentId,
+		subagentName
+	]);
+	useEffect(() => {
+		if (process.env.NODE_ENV === "production" || !subagentName || !subagent?.isAmbiguous) return;
+		const key = `${subagentName}:${subagent.matchCount}`;
+		if (warnedAmbiguousNames.has(key)) return;
+		warnedAmbiguousNames.add(key);
+		console.warn(`[CopilotKit] useSubagent({ subagentName: ${JSON.stringify(subagentName)} }) matched ${subagent.matchCount} subagents. Returning the most recently started one; pass a subagentId for a stable reference.`);
+	}, [
+		subagentName,
+		subagent?.isAmbiguous,
+		subagent?.matchCount
+	]);
+	return subagent;
+}
+
 //#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.
 */
@@ -5043,6 +5114,7 @@ function useThreads$1({ agentId, includeArchived, limit, enabled = true }) {
 	})), [coreThreads]);
 	const storeIsLoading = useThreadStoreSelector(store, ɵselectThreadsIsLoading);
 	const storeError = useThreadStoreSelector(store, ɵselectThreadsError);
+	const fetchMoreError = useThreadStoreSelector(store, ɵselectFetchMoreError);
 	const hasMoreThreads = useThreadStoreSelector(store, ɵselectHasNextPage);
 	const isFetchingMoreThreads = useThreadStoreSelector(store, ɵselectIsFetchingNextPage);
 	const isMutating = useThreadStoreSelector(store, ɵselectIsMutating);
@@ -5148,6 +5220,7 @@ function useThreads$1({ agentId, includeArchived, limit, enabled = true }) {
 		isLoading,
 		error,
 		listError,
+		fetchMoreError,
 		hasMoreThreads,
 		isFetchingMoreThreads,
 		isMutating,
@@ -9089,7 +9162,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
@@ -9116,16 +9189,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 ?? 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,
@@ -9206,6 +9279,9 @@ function CopilotThreadsDrawer({ agentId, onThreadSelect, onNewThread, onLicensed
 	const handleLoadMore = useCallback(() => {
 		fetchMoreThreads();
 	}, [fetchMoreThreads]);
+	const handleCollapseChange = useCallback((collapsed) => {
+		onCollapseChange?.(collapsed);
+	}, [onCollapseChange]);
 	const handlersRef = useRef({
 		handleThreadSelected,
 		handleNewThread,
@@ -9216,7 +9292,8 @@ function CopilotThreadsDrawer({ agentId, onThreadSelect, onNewThread, onLicensed
 		handleRetry,
 		handleOpenChange,
 		handleLicensed,
-		handleLoadMore
+		handleLoadMore,
+		handleCollapseChange
 	});
 	handlersRef.current = {
 		handleThreadSelected,
@@ -9228,7 +9305,8 @@ function CopilotThreadsDrawer({ agentId, onThreadSelect, onNewThread, onLicensed
 		handleRetry,
 		handleOpenChange,
 		handleLicensed,
-		handleLoadMore
+		handleLoadMore,
+		handleCollapseChange
 	};
 	useEffect(() => {
 		const el = elementRef.current;
@@ -9263,6 +9341,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);
@@ -9273,6 +9355,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);
@@ -9284,6 +9367,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]);
 	useEffect(() => {
@@ -9300,9 +9384,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,
@@ -9325,6 +9411,11 @@ function CopilotThreadsDrawer({ agentId, onThreadSelect, onNewThread, onLicensed
 		if (!el) return;
 		if (licenseUrl !== void 0) el.licenseUrl = licenseUrl;
 	}, [licenseUrl, mounted]);
+	useEffect(() => {
+		const el = elementRef.current;
+		if (!el) return;
+		if (collapsible !== void 0) el.collapsible = collapsible;
+	}, [collapsible, mounted]);
 	const rowChildren = useMemo(() => {
 		if (!renderRow) return null;
 		return drawerThreads.map((drawerThread) => {
@@ -9345,7 +9436,8 @@ function CopilotThreadsDrawer({ agentId, onThreadSelect, onNewThread, onLicensed
 	if (!mounted) return null;
 	return React.createElement(COPILOTKIT_THREADS_DRAWER_TAG, {
 		ref: elementRef,
-		"data-testid": dataTestId
+		"data-testid": dataTestId,
+		...recentLabel !== void 0 ? { "recent-label": recentLabel } : {}
 	}, rowChildren);
 }
 CopilotThreadsDrawer.displayName = "CopilotThreadsDrawer";
@@ -10998,8 +11090,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: useMemo(() => {
+		const requested = configAgentId ?? DEFAULT_AGENT_ID;
+		const registered = copilotkit.agents ?? {};
+		if (registered[requested]) return requested;
+		if (requested === DEFAULT_AGENT_ID) {
+			const firstRegistered = Object.keys(registered)[0];
+			if (firstRegistered) return firstRegistered;
+		}
+		return requested;
+	}, [configAgentId, copilotkit.agents]) });
 	usePredictStateSubscription(agent);
 	return null;
 }
@@ -11532,5 +11634,5 @@ function validateProps(props) {
 }
 
 //#endregion
-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
+export { useCapabilities as $, CopilotChatMessageView as A, CopilotChatAssistantMessage_default as B, CopilotModalHeader as C, AudioRecorderError as Ct, CopilotChat as D, DefaultOpenIcon as E, useCopilotChatConfiguration as Et, 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, CopilotChatInput_default as St, DefaultCloseIcon as T, CopilotChatConfigurationProvider as Tt, useLearningContainers as U, CopilotChatToolCallsView as V, useAttachments as W, useConfigureSuggestions as X, useInterrupt as Y, useSuggestions as Z, WildcardToolCallRender as _, MCPAppsActivityType as _t, ThreadsProvider as a, useRenderTool as at, CopilotSidebar as b, useCopilotKit as bt, CoAgentStateRendersProvider as c, useRenderActivityMessage as ct, shouldShowDevConsole as d, defineToolCallRenderer as dt, useSubagent as et, useToast as f, createA2UIMessageRenderer as ft, useCopilotContext as g, MCPAppsActivityRenderer as gt, CopilotContext as h, MCPAppsActivityContentSchema as ht, ThreadsContext as i, useDefaultRenderTool as it, INTELLIGENCE_TURN_HEAD as j, CopilotChatAttachmentQueue as k, useCoAgentStateRenders as l, useRenderCustomMessages as lt, useCopilotMessagesContext as m, useSandboxFunctions as mt, defaultCopilotContextCategories as n, useAgent as nt, useThreads as o, useComponent as ot, CopilotMessagesContext as p, SandboxFunctionsContext as pt, useMemories as q, CoAgentStateRenderBridge as r, useHumanInTheLoop as rt, CoAgentStateRendersContext as s, useFrontendTool as st, CopilotKit as t, UseAgentUpdate as tt, useAsyncCallback as u, CopilotKitProvider as ut, CopilotThreadsDrawer as v, CopilotKitInspector as vt, CopilotChatToggleButton as w, CopilotChatAudioRecorder as wt, CopilotPopupView as x, CopilotKitCoreReact as xt, CopilotPopup as y, useRenderToolCall as yt, CopilotChatAttachmentRenderer as z };
+//# sourceMappingURL=copilotkit-dtSVHJCs.mjs.map