@copilotkit/react-core 1.68.2 → 1.68.3-canary.1787220377

package/dist/{copilotkit-Bocmlr37.cjs → copilotkit-EFunREg5.cjs}

@@ -4643,6 +4643,75 @@ function useAgent({ agentId, threadId, runtimeAgentId, updates, throttleMs } = {
 	};
 }
 
+//#endregion
+//#region src/v2/hooks/use-subagent.tsx
+const warnedAmbiguousNames = /* @__PURE__ */ new Set();
+function resolveSubagent(subagents, subagentRunId, subagentName) {
+	if (subagentRunId) {
+		const match = subagents[subagentRunId];
+		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({ subagentRunId: message.subagentRunId });
+* // sub?.name, sub?.description, sub?.status
+*/
+function useSubagent(params) {
+	const { subagentRunId, subagentName, agentId } = params;
+	const { copilotkit } = (0, _copilotkit_react_core_v2_context.useCopilotKit)();
+	const config = useCopilotChatConfiguration();
+	const resolvedAgentId = (0, react.useMemo)(() => agentId ?? config?.agentId ?? _copilotkit_shared.DEFAULT_AGENT_ID, [agentId, config?.agentId]);
+	const [subagent, setSubagent] = (0, react.useState)(() => resolveSubagent(copilotkit.getSubagents(resolvedAgentId), subagentRunId, subagentName));
+	(0, react.useEffect)(() => {
+		setSubagent(resolveSubagent(copilotkit.getSubagents(resolvedAgentId), subagentRunId, subagentName));
+	}, [
+		copilotkit,
+		resolvedAgentId,
+		subagentRunId,
+		subagentName
+	]);
+	(0, react.useEffect)(() => {
+		const subscription = copilotkit.subscribe({ onSubagentsChanged: ({ agentId: changedAgentId, subagents }) => {
+			if (changedAgentId !== resolvedAgentId) return;
+			setSubagent(resolveSubagent(subagents, subagentRunId, subagentName));
+		} });
+		return () => {
+			subscription.unsubscribe();
+		};
+	}, [
+		copilotkit,
+		resolvedAgentId,
+		subagentRunId,
+		subagentName
+	]);
+	(0, react.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 subagentRunId for a stable reference.`);
+	}, [
+		subagentName,
+		subagent?.isAmbiguous,
+		subagent?.matchCount
+	]);
+	return subagent;
+}
+
 //#endregion
 //#region src/v2/hooks/use-capabilities.tsx
 /**
@@ -12440,6 +12509,12 @@ Object.defineProperty(exports, 'useSandboxFunctions', {
     return useSandboxFunctions;
   }
 });
+Object.defineProperty(exports, 'useSubagent', {
+  enumerable: true,
+  get: function () {
+    return useSubagent;
+  }
+});
 Object.defineProperty(exports, 'useSuggestions', {
   enumerable: true,
   get: function () {
@@ -12470,4 +12545,4 @@ Object.defineProperty(exports, 'ɵrunMcpFollowUp', {
     return ɵrunMcpFollowUp;
   }
 });
-//# sourceMappingURL=copilotkit-Bocmlr37.cjs.map
+//# sourceMappingURL=copilotkit-EFunREg5.cjs.map