@copilotkit/react-core 1.56.5-canary.1777915231 → 1.56.5-canary.1777972218

package/dist/{copilotkit-BoiGcRsU.cjs → copilotkit-BGIsblrk.cjs}

@@ -5601,6 +5601,171 @@ CopilotChatSuggestionView.displayName = "CopilotChatSuggestionView";
 */
 const ScrollElementContext = react.default.createContext(null);
 
+//#endregion
+//#region src/v2/components/intelligence-indicator/IntelligenceIndicator.tsx
+/**
+* Brief debounce on `agent.isRunning` falling edges. Multi-step agent
+* runs can emit transient `RUN_FINISHED → RUN_STARTED` cycles between
+* LLM steps inside one user turn; without a small grace window the pill
+* would flicker spinner → check → spinner. 500 ms is well below
+* human-perceptible flash latency yet long enough to absorb step blips.
+*/
+const RUN_IDLE_DEBOUNCE_MS = 500;
+/** Hold the checkmark briefly before fading out. */
+const CHECK_HOLD_MS = 800;
+/**
+* Duration of the fade-out animation. Must match
+* `cpk-intelligence-pill-fade-out` keyframes in `v2/styles/globals.css`.
+*/
+const FADE_OUT_ANIMATION_MS = 480;
+/**
+* Polling interval for `agent.isRunning`. Background: AG-UI's `runAgent`
+* snapshots `[...this.subscribers]` at invocation time and threads that
+* snapshot through the entire run pipeline (including the `finalize`
+* block that fires `onRunFinalized` and flips `isRunning` off). A
+* subscriber added AFTER `runAgent` starts — which is always the case
+* here, because the renderer mounts when the matching message first
+* appears INSIDE the run — is missing from that snapshot and never
+* receives the falling edge.
+*
+* Re-renders driven by parent state still keep the pill alive while
+* messages stream, but `agent.isRunning` only flips off via the
+* snapshotted set. A 200 ms poll reads the live property and forces a
+* re-render when it changes, closing the gap.
+*/
+const ISRUNNING_POLL_MS = 200;
+/**
+* Tool-name regex patterns that trigger the indicator. Currently
+* hardcoded to the Intelligence MCP server's canonical tool name. If
+* we add per-instance customization later (e.g. a `CopilotKitProvider`
+* prop or a runtime-info field), this constant becomes the fallback.
+*/
+const DEFAULT_TOOL_PATTERNS = [/^bash$/];
+/**
+* The "Using CopilotKit Intelligence" pill. Auto-mounted by
+* `CopilotChatMessageView` for every message slot when
+* `copilotkit.intelligence` is configured — callers do not register
+* this themselves. Self-gates so only the canonical message renders a
+* pill.
+*
+* Render gates (all must hold):
+*   1. `copilotkit.intelligence !== undefined` (Intelligence runtime
+*      is configured; checked by the parent before mounting, and
+*      again here as a defence)
+*   2. The message is the last message of its run
+*   3. The message's run is the latest run on the thread
+*   4. The message has at least one tool call whose name matches
+*      {@link DEFAULT_TOOL_PATTERNS}
+*   5. The phase machine is not yet `hidden`
+*
+* Phase machine (per-instance, all timers local):
+*   - `spinner` while `agent.isRunning`
+*   - → `check` after `agent.isRunning` falls (debounced 500 ms to
+*     absorb step-boundary `RUN_FINISHED → RUN_STARTED` blips inside
+*     one user turn)
+*   - → `fading` after a brief hold ({@link CHECK_HOLD_MS})
+*   - → `hidden` after the fade animation
+*     ({@link FADE_OUT_ANIMATION_MS})
+*
+* The "exactly one pill at a time" guarantee is structural — only one
+* message at any moment satisfies gates 2–4 — so no shared coordination
+* state is required.
+*/
+function IntelligenceIndicator(props) {
+	const { message, agentId, label = "Using CopilotKit Intelligence" } = props;
+	const { copilotkit } = useCopilotKit();
+	const config = useCopilotChatConfiguration();
+	const { agent } = useAgent({
+		agentId,
+		updates: [UseAgentUpdate.OnRunStatusChanged, UseAgentUpdate.OnMessagesChanged]
+	});
+	const [, forceRender] = (0, react.useReducer)((n) => n + 1, 0);
+	const lastSeenIsRunningRef = (0, react.useRef)(agent.isRunning);
+	(0, react.useEffect)(() => {
+		const interval = setInterval(() => {
+			const live = agent.isRunning;
+			if (live !== lastSeenIsRunningRef.current) {
+				lastSeenIsRunningRef.current = live;
+				forceRender();
+			}
+		}, ISRUNNING_POLL_MS);
+		return () => clearInterval(interval);
+	}, [agent]);
+	const [phase, setPhase] = (0, react.useState)(agent.isRunning ? "spinner" : "check");
+	(0, react.useEffect)(() => {
+		if (agent.isRunning) {
+			setPhase("spinner");
+			return;
+		}
+		const t = setTimeout(() => setPhase("check"), RUN_IDLE_DEBOUNCE_MS);
+		return () => clearTimeout(t);
+	}, [agent.isRunning]);
+	(0, react.useEffect)(() => {
+		if (phase !== "check") return void 0;
+		const t = setTimeout(() => setPhase("fading"), CHECK_HOLD_MS);
+		return () => clearTimeout(t);
+	}, [phase]);
+	(0, react.useEffect)(() => {
+		if (phase !== "fading") return void 0;
+		const t = setTimeout(() => setPhase("hidden"), FADE_OUT_ANIMATION_MS);
+		return () => clearTimeout(t);
+	}, [phase]);
+	if (copilotkit.intelligence === void 0) return null;
+	if (!config) return null;
+	if (phase === "hidden") return null;
+	if (message.role !== "assistant") return null;
+	if (!(Array.isArray(message.toolCalls) ? message.toolCalls : []).some((tc) => {
+		const name = tc?.function?.name;
+		return typeof name === "string" && DEFAULT_TOOL_PATTERNS.some((p) => p.test(name));
+	})) return null;
+	const messageRunId = copilotkit.getRunIdForMessage(agentId, config.threadId, message.id);
+	if (!messageRunId) return null;
+	let latestRunId;
+	let lastMessageIdInThisRun;
+	for (let i = agent.messages.length - 1; i >= 0; i -= 1) {
+		const m = agent.messages[i];
+		const r = copilotkit.getRunIdForMessage(agentId, config.threadId, m.id);
+		if (latestRunId === void 0 && r) latestRunId = r;
+		if (lastMessageIdInThisRun === void 0 && r === messageRunId) lastMessageIdInThisRun = m.id;
+		if (latestRunId !== void 0 && lastMessageIdInThisRun !== void 0) break;
+	}
+	if (latestRunId !== messageRunId) return null;
+	if (lastMessageIdInThisRun !== message.id) return null;
+	const showSpinner = phase === "spinner";
+	const isFading = phase === "fading";
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+		className: "cpk-intelligence-pill" + (isFading ? " cpk-intelligence-pill--fading" : ""),
+		role: "status",
+		"aria-live": "polite",
+		"aria-hidden": isFading || void 0,
+		"data-testid": `cpk-intelligence-pill-${message.id}`,
+		title: label,
+		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("svg", {
+			className: "cpk-intelligence-pill__icon",
+			viewBox: "0 0 24 24",
+			width: "14",
+			height: "14",
+			"aria-hidden": "true",
+			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("circle", {
+				cx: "12",
+				cy: "12",
+				r: "9",
+				fill: "none",
+				strokeWidth: "2.5",
+				strokeLinecap: "round",
+				className: "cpk-intelligence-pill__ring" + (showSpinner ? "" : " cpk-intelligence-pill__ring--done")
+			}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", {
+				d: "M8 12.5l3 3 5-6",
+				fill: "none",
+				strokeWidth: "2.5",
+				strokeLinecap: "round",
+				strokeLinejoin: "round",
+				className: "cpk-intelligence-pill__check" + (showSpinner ? "" : " cpk-intelligence-pill__check--shown")
+			})]
+		}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: label })]
+	});
+}
+
 //#endregion
 //#region src/v2/components/chat/CopilotChatMessageView.tsx
 /**
@@ -5720,6 +5885,9 @@ const MemoizedCustomMessage = react.default.memo(function MemoizedCustomMessage(
 	if (prevProps.message.content !== nextProps.message.content) return false;
 	if (prevProps.message.role !== nextProps.message.role) return false;
 	if (JSON.stringify(prevProps.stateSnapshot) !== JSON.stringify(nextProps.stateSnapshot)) return false;
+	if (prevProps.numberOfMessagesInRun !== nextProps.numberOfMessagesInRun) return false;
+	if (prevProps.isInLatestRun !== nextProps.isInLatestRun) return false;
+	if (nextProps.isInLatestRun && prevProps.isRunning !== nextProps.isRunning) return false;
 	return true;
 });
 /**
@@ -5775,6 +5943,34 @@ function CopilotChatMessageView({ messages = [], assistantMessage, userMessage,
 		} });
 		return () => subscription.unsubscribe();
 	}, [copilotkit]);
+	const runMetadata = (0, react.useMemo)(() => {
+		if (!config) return null;
+		const runIdByMessageId = /* @__PURE__ */ new Map();
+		for (const msg of messages) {
+			const r = copilotkit.getRunIdForMessage(config.agentId, config.threadId, msg.id);
+			if (r) runIdByMessageId.set(msg.id, r);
+		}
+		const countByRunId = /* @__PURE__ */ new Map();
+		for (const r of runIdByMessageId.values()) countByRunId.set(r, (countByRunId.get(r) ?? 0) + 1);
+		let latestRunId;
+		for (let i = messages.length - 1; i >= 0; i--) {
+			const r = runIdByMessageId.get(messages[i].id);
+			if (r) {
+				latestRunId = r;
+				break;
+			}
+		}
+		return {
+			runIdByMessageId,
+			countByRunId,
+			latestRunId
+		};
+	}, [
+		messages,
+		config?.agentId,
+		config?.threadId,
+		copilotkit
+	]);
 	const getStateSnapshotForMessage = (messageId) => {
 		if (!config) return void 0;
 		const resolvedRunId = copilotkit.getRunIdForMessage(config.agentId, config.threadId, messageId) ?? copilotkit.getRunIdsForThread(config.agentId, config.threadId).slice(-1)[0];
@@ -5811,11 +6007,17 @@ function CopilotChatMessageView({ messages = [], assistantMessage, userMessage,
 	const renderMessageBlock = (message) => {
 		const elements = [];
 		const stateSnapshot = getStateSnapshotForMessage(message.id);
+		const messageRunId = runMetadata?.runIdByMessageId.get(message.id);
+		const numberOfMessagesInRun = messageRunId ? runMetadata?.countByRunId.get(messageRunId) : void 0;
+		const isInLatestRun = messageRunId === void 0 ? void 0 : messageRunId === runMetadata?.latestRunId;
 		if (renderCustomMessage) elements.push(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(MemoizedCustomMessage, {
 			message,
 			position: "before",
 			renderCustomMessage,
-			stateSnapshot
+			stateSnapshot,
+			numberOfMessagesInRun,
+			isInLatestRun,
+			isRunning
 		}, `${message.id}-custom-before`));
 		if (message.role === "assistant") elements.push(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(MemoizedAssistantMessage, {
 			message,
@@ -5844,8 +6046,15 @@ function CopilotChatMessageView({ messages = [], assistantMessage, userMessage,
 			message,
 			position: "after",
 			renderCustomMessage,
-			stateSnapshot
+			stateSnapshot,
+			numberOfMessagesInRun,
+			isInLatestRun,
+			isRunning
 		}, `${message.id}-custom-after`));
+		if (copilotkit.intelligence !== void 0 && message.role === "assistant") elements.push(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(IntelligenceIndicator, {
+			message,
+			agentId: config?.agentId ?? _copilotkit_shared.DEFAULT_AGENT_ID
+		}, `${message.id}-intelligence`));
 		return elements.filter(Boolean);
 	};
 	const messageElements = shouldVirtualize ? [] : deduplicatedMessages.flatMap(renderMessageBlock);
@@ -9968,6 +10177,12 @@ Object.defineProperty(exports, 'DefaultOpenIcon', {
     return DefaultOpenIcon;
   }
 });
+Object.defineProperty(exports, 'IntelligenceIndicator', {
+  enumerable: true,
+  get: function () {
+    return IntelligenceIndicator;
+  }
+});
 Object.defineProperty(exports, 'MCPAppsActivityContentSchema', {
   enumerable: true,
   get: function () {
@@ -10196,4 +10411,4 @@ Object.defineProperty(exports, 'useToast', {
     return useToast;
   }
 });
-//# sourceMappingURL=copilotkit-BoiGcRsU.cjs.map
+//# sourceMappingURL=copilotkit-BGIsblrk.cjs.map