@copilotkit/react-core 1.59.2 → 1.59.4

package/dist/{copilotkit-IQO0VDZb.cjs → copilotkit-LdQ8w20l.cjs}

@@ -234,9 +234,9 @@ const useCopilotChatConfiguration = () => {
 
 //#endregion
 //#region src/v2/lib/utils.ts
-const twMerge$7 = (0, tailwind_merge.extendTailwindMerge)({ prefix: "cpk" });
+const twMerge$8 = (0, tailwind_merge.extendTailwindMerge)({ prefix: "cpk" });
 function cn(...inputs) {
-	return twMerge$7((0, clsx.clsx)(inputs));
+	return twMerge$8((0, clsx.clsx)(inputs));
 }
 
 //#endregion
@@ -794,7 +794,7 @@ function CopilotChatInput({ mode = "input", onSubmitMessage, onStop, isRunning =
 		}
 		if (e.key === "Enter" && !e.shiftKey) {
 			e.preventDefault();
-			if (isProcessing) onStop?.();
+			if (isProcessing && !canSend) onStop?.();
 			else send();
 		}
 	};
@@ -4811,6 +4811,175 @@ function useThreads$1({ agentId, includeArchived, limit }) {
 	};
 }
 
+//#endregion
+//#region src/v2/lib/record-annotation.ts
+/**
+* Low-level function that posts an arbitrary annotation to the CopilotKit
+* runtime's general annotation endpoint (`POST /annotate`).
+*
+* This is the single transport entry point for all annotation types. Higher-
+* level hooks (e.g. `useLearnFromUserAction`) build the `type`/`payload` pair
+* for their specific annotation shape and delegate the HTTP call here.
+*
+* The function uses the same transport as `useLearnFromUserAction`:
+* - `runtimeUrl` from `copilotkit.runtimeUrl` (BFF proxies to the platform)
+* - `headers` from `copilotkit.headers` (customer auth forwarded to BFF)
+* - `clientEventId` auto-generated via `randomUUID()` when omitted
+* - `userId` is resolved server-side by the runtime; the client never sends it
+* - Errors propagate to the caller (fire-and-propagate, not fire-and-forget)
+*
+* @param args - Transport dependencies plus annotation fields.
+* @returns The platform result containing the annotation row `id` and a
+*          `duplicate` flag.
+* @throws When the network request fails or the runtime returns a non-2xx
+*         status. Callers that want fire-and-forget behavior should `.catch`
+*         at the call site.
+*/
+async function recordAnnotation(args) {
+	const { runtimeUrl, headers, type, payload, threadId, occurredAt } = args;
+	const body = {
+		type,
+		threadId,
+		clientEventId: args.clientEventId ?? (0, _copilotkit_shared.randomUUID)(),
+		...payload !== void 0 ? { payload } : {},
+		...occurredAt !== void 0 ? { occurredAt } : {}
+	};
+	const response = await fetch(`${runtimeUrl}/annotate`, {
+		method: "POST",
+		headers: {
+			"Content-Type": "application/json",
+			...headers
+		},
+		body: JSON.stringify(body)
+	});
+	if (!response.ok) {
+		const text = await response.text().catch(() => "");
+		throw new Error(`recordAnnotation: request failed (${response.status})${text ? `: ${text}` : ""}`);
+	}
+	const text = await response.text();
+	if (!text) throw new Error(`recordAnnotation: runtime ${runtimeUrl}/annotate returned ${response.status} with an empty body`);
+	try {
+		return JSON.parse(text);
+	} catch {
+		throw new Error(`recordAnnotation: runtime ${runtimeUrl}/annotate returned a non-JSON body (status ${response.status})`);
+	}
+}
+
+//#endregion
+//#region src/v2/hooks/use-learn-from-user-action.tsx
+/**
+* Record a user UI interaction in the Intelligence platform's user-actions
+* stream. The platform's auto-curated knowledge base agent reads these
+* (alongside finished agent runs) and writes free-form Obsidian-flavored
+* markdown to `/project`, where any agent in the same project can later
+* read it via the `copilotkit_knowledge_base_shell` MCP tool.
+*
+* The hook returns a stable function. Calling it issues a request to the
+* customer's CopilotKit runtime (`POST ${runtimeUrl}/annotate`), which
+* resolves the Intel user from the BFF's auth and forwards to the
+* platform — the Intel API key never reaches the browser.
+*
+* If `clientEventId` is omitted `recordAnnotation` generates a UUID per call,
+* so a naive double-call (e.g. React 18 strict-mode double-mount, or a retry
+* after a network blip on a fresh Promise) is naturally safe. Supply your
+* own key when a single semantic event must remain idempotent across
+* multiple `learnFromUserAction(...)` calls.
+*
+* @example
+* ```tsx
+* import { useLearnFromUserAction } from "@copilotkit/react-core";
+*
+* function SettingsPage({ threadId }) {
+*   const learnFromUserAction = useLearnFromUserAction();
+*
+*   const onRename = (oldName: string, newName: string) => {
+*     void learnFromUserAction({
+*       threadId,
+*       title: "Renamed project",
+*       data: { previous: { name: oldName }, next: { name: newName } },
+*     });
+*   };
+* }
+* ```
+*/
+function useLearnFromUserAction() {
+	const { copilotkit } = useCopilotKit();
+	return (0, react.useCallback)(async (input) => {
+		const runtimeUrl = copilotkit.runtimeUrl;
+		if (!runtimeUrl) throw new Error("useLearnFromUserAction: runtimeUrl is not configured. Set it on <CopilotKitProvider runtimeUrl=...>.");
+		const payload = {
+			...input.title !== void 0 ? { title: input.title } : {},
+			...input.description !== void 0 ? { description: input.description } : {},
+			...input.data !== void 0 ? { data: input.data } : {}
+		};
+		return recordAnnotation({
+			runtimeUrl,
+			headers: copilotkit.headers ?? {},
+			type: "user_action",
+			payload: Object.keys(payload).length > 0 ? payload : void 0,
+			threadId: input.threadId,
+			clientEventId: input.clientEventId,
+			occurredAt: input.occurredAt
+		});
+	}, [copilotkit]);
+}
+
+//#endregion
+//#region src/v2/hooks/use-learn-from-user-action-in-current-thread.tsx
+/**
+* Record a user UI interaction against the **current chat's** thread. The
+* `threadId` is sourced from the surrounding
+* `<CopilotChatConfigurationProvider>` (the same provider `<CopilotChat>`,
+* `<CopilotSidebar>`, and friends set up), so callers in a chat-aware
+* subtree don't need to thread an id through manually.
+*
+* Throws on **call** (not on mount) when there is no chat-config provider
+* in scope — matches the "throw on call when runtimeUrl is missing"
+* behavior of {@link useLearnFromUserAction}. Mounting the hook in a branch
+* that never fires is harmless.
+*
+* The recorder does NOT accept a `threadId` override. If you need to
+* record against an explicit thread, use {@link useLearnFromUserAction}
+* directly — two hooks, two crisp contracts, no mode confusion.
+*
+* This hook always uses `config.threadId`, regardless of whether the
+* surrounding chat config minted it internally or received one from
+* the caller. Auto-minted threads simply mean the action lands under
+* a thread the platform never saw — the writer agent still distills
+* user-action-only threads (it does not require the thread to exist
+* in `cpki.threads`), so the loop keeps learning.
+*
+* @example
+* ```tsx
+* import { useLearnFromUserActionInCurrentThread } from "@copilotkit/react-core";
+*
+* function SettingsPanel() {
+*   const learnFromUserAction = useLearnFromUserActionInCurrentThread();
+*
+*   const onRename = (oldName: string, newName: string) => {
+*     void learnFromUserAction({
+*       title: "Renamed project",
+*       data: { previous: { name: oldName }, next: { name: newName } },
+*     });
+*   };
+*
+*   // ...
+* }
+* ```
+*/
+function useLearnFromUserActionInCurrentThread() {
+	const config = useCopilotChatConfiguration();
+	const learnFromUserAction = useLearnFromUserAction();
+	return (0, react.useCallback)(async (input) => {
+		const threadId = config?.threadId;
+		if (!threadId) throw new Error("useLearnFromUserActionInCurrentThread: no CopilotChatConfigurationProvider in scope. Wrap the call site in <CopilotChat>, <CopilotSidebar>, or <CopilotChatConfigurationProvider>, or use `useLearnFromUserAction()` and pass `threadId` explicitly.");
+		return learnFromUserAction({
+			...input,
+			threadId
+		});
+	}, [config?.threadId, learnFromUserAction]);
+}
+
 //#endregion
 //#region src/v2/hooks/use-attachments.tsx
 /**
@@ -4969,6 +5138,153 @@ function useAttachments({ config }) {
 	};
 }
 
+//#endregion
+//#region src/v2/hooks/use-learning-containers.tsx
+/** The default learning containers value. Matches the backend default. */
+const DEFAULT_CONTAINERS = ["project"];
+/**
+* Declaratively keeps a thread's learning containers in sync by emitting
+* `set_learning_containers` annotations via the CopilotKit runtime annotate
+* endpoint (`POST ${runtimeUrl}/annotate`).
+*
+* **Emit rules:**
+* - On mount with `["project"]` (the backend default) → does NOT emit.
+*   Absence of an annotation equals the default, so the round-trip is skipped.
+* - On mount with any other value → emits immediately.
+* - On any subsequent content change (including a switch back to
+*   `["project"]`) → emits (a deliberate switch is always recorded).
+* - On unmount or threadId change → emits a reset to `["project"]`
+*   so the backend is left in a clean state for the next consumer.
+*   Changing `learningContainers` within the same thread does NOT reset the
+*   thread; only the new value is emitted.
+*
+* Content-equality is evaluated via `JSON.stringify` so a fresh array literal
+* with the same items does NOT trigger a redundant emit.
+*
+* If `runtimeUrl` is absent, all emits are silently skipped.
+*
+* @example
+* ```tsx
+* function ThreadPane({ threadId, userScope }: Props) {
+*   useLearningContainers({
+*     threadId,
+*     learningContainers: [userScope],
+*   });
+*   // ...
+* }
+* ```
+*/
+function useLearningContainers({ threadId, learningContainers }) {
+	const { copilotkit } = useCopilotKit();
+	/**
+	* Tracks the last-synced container list so content-identical rerenders
+	* (fresh array, same values) do not fire a redundant emit.
+	* `null` = nothing synced yet (initial state or after a threadId reset).
+	*/
+	const lastSyncedRef = (0, react.useRef)(null);
+	/** Guards the missing-runtimeUrl warning so it fires at most once per hook instance. */
+	const warnedMissingUrlRef = (0, react.useRef)(false);
+	const runtimeUrlRef = (0, react.useRef)(copilotkit.runtimeUrl);
+	const headersRef = (0, react.useRef)(copilotkit.headers ?? {});
+	runtimeUrlRef.current = copilotkit.runtimeUrl;
+	headersRef.current = copilotkit.headers ?? {};
+	const key = JSON.stringify(learningContainers);
+	const defaultKey = JSON.stringify(DEFAULT_CONTAINERS);
+	(0, react.useEffect)(() => {
+		const runtimeUrl = copilotkit.runtimeUrl;
+		const headers = copilotkit.headers ?? {};
+		/**
+		* Fire-and-forget emit; errors must not surface in render.
+		* Failures are logged as warnings so they are diagnosable without
+		* propagating into the React render cycle.
+		*/
+		const emit = (containers) => {
+			if (!runtimeUrl) {
+				if (!warnedMissingUrlRef.current) {
+					warnedMissingUrlRef.current = true;
+					console.warn("useLearningContainers: runtimeUrl not configured; learning-container sync disabled");
+				}
+				return;
+			}
+			recordAnnotation({
+				runtimeUrl,
+				headers,
+				type: "set_learning_containers",
+				payload: { containers },
+				threadId
+			}).catch((err) => {
+				console.warn("useLearningContainers: failed to record set_learning_containers", err);
+			});
+		};
+		if (lastSyncedRef.current === null) {
+			if (key === defaultKey) {
+				lastSyncedRef.current = learningContainers;
+				return;
+			}
+			emit(learningContainers);
+			lastSyncedRef.current = learningContainers;
+		} else if (key !== JSON.stringify(lastSyncedRef.current)) {
+			emit(learningContainers);
+			lastSyncedRef.current = learningContainers;
+		}
+	}, [threadId, key]);
+	(0, react.useEffect)(() => {
+		const capturedThreadId = threadId;
+		return () => {
+			const capturedRuntimeUrl = runtimeUrlRef.current;
+			const capturedHeaders = headersRef.current;
+			if (capturedRuntimeUrl) recordAnnotation({
+				runtimeUrl: capturedRuntimeUrl,
+				headers: capturedHeaders,
+				type: "set_learning_containers",
+				payload: { containers: DEFAULT_CONTAINERS },
+				threadId: capturedThreadId
+			}).catch((err) => {
+				console.warn("useLearningContainers: failed to record set_learning_containers", err);
+			});
+			lastSyncedRef.current = null;
+		};
+	}, [threadId]);
+}
+
+//#endregion
+//#region src/v2/hooks/use-learning-containers-in-current-thread.tsx
+/**
+* Declaratively keeps the **current chat thread's** learning containers in
+* sync. The `threadId` is sourced from the surrounding
+* `<CopilotChatConfigurationProvider>` (the same provider `<CopilotChat>`,
+* `<CopilotSidebar>`, and friends set up), so callers in a chat-aware
+* subtree don't need to thread an id through manually.
+*
+* **Throws on render** when there is no chat-config provider in scope or
+* when the provider does not yet have an active `threadId`. Mount the hook
+* inside a subtree that is guaranteed to have a thread context.
+*
+* If you need to manage an explicit thread, use {@link useLearningContainers}
+* directly — two hooks, two crisp contracts, no mode confusion.
+*
+* @throws When no `CopilotChatConfigurationProvider` is in scope or when the
+*         active `threadId` is absent/empty.
+*
+* @example
+* ```tsx
+* function ThreadPanel({ scope }: Props) {
+*   useLearningContainersInCurrentThread({
+*     learningContainers: [scope],
+*   });
+*   // ...
+* }
+* ```
+*/
+function useLearningContainersInCurrentThread({ learningContainers }) {
+	const threadId = useCopilotChatConfiguration()?.threadId;
+	if (!threadId) throw new Error("useLearningContainersInCurrentThread must be used within a thread context (no active threadId). Wrap the component in <CopilotChat>, <CopilotSidebar>, or <CopilotChatConfigurationProvider>, or use `useLearningContainers()` and pass `threadId` explicitly.");
+	useLearningContainers({
+		threadId,
+		learningContainers
+	});
+}
+
 //#endregion
 //#region src/v2/components/chat/CopilotChatToolCallsView.tsx
 function CopilotChatToolCallsView({ message, messages = [] }) {
@@ -5741,33 +6057,174 @@ CopilotChatSuggestionView.displayName = "CopilotChatSuggestionView";
 */
 const ScrollElementContext = react.default.createContext(null);
 
+//#endregion
+//#region src/v2/components/intelligence-indicator/IntelligenceIndicatorView.tsx
+/**
+* The presentational "CopilotKit Intelligence" face — the default
+* rendered by the {@link IntelligenceIndicator} brain and the default
+* value for the `intelligenceIndicator` slot.
+*
+* Single-element three-stage design:
+*  1. **In-progress.** Glassmorphism pill chrome around a 270° arc icon
+*     and the label. The arc has a single continuous visible stroke
+*     (one `stroke-dasharray` dash + one gap, summing to the path
+*     length) and the whole SVG rotates — so the viewer sees one
+*     C-shaped arc spinning around the visual center.
+*  2. **Icon morph (~250 ms).** On status flip the single icon path
+*     interpolates from the arc to a checkmark via CSS `d:` while the
+*     dashed stroke transitions to solid (filling in the gap that was
+*     the spinner's open portion). The SVG rotation animation is
+*     removed; the snap back to identity is masked by the simultaneous
+*     shape change. Chrome and text stay at full opacity throughout.
+*  3. **Settle (~400 ms, starts at +250 ms).** Chrome (background,
+*     border, shadow, backdrop-blur) fades to zero opacity. The label
+*     and icon stroke color transitions from saturated purple to a
+*     true-neutral gray at 0.8 alpha — no hue cast, reads as "settled
+*     history metadata." The label simultaneously skews to ~10° (a
+*     transform-based italic feel that interpolates smoothly with the
+*     color, rather than the discrete `font-style: italic` snap that
+*     would cause a layout pop). The label text stays put — only its
+*     color and slant change — so there is no "bump" where the brand
+*     text disappears and reappears.
+*
+* Hard sequence: stage 3 has a 250 ms transition-delay so it waits
+* for stage 2 to finish. Total settle time ~650 ms in production.
+*
+* Both shapes are 3-segment cubic Bézier paths with matched command
+* structure (one `M` plus three `C`s), which is what makes the d
+* morph interpolate as a continuous shape change rather than snapping.
+*
+* The label is identical in both states (default "CopilotKit
+* Intelligence"). The static check icon carries the "done" semantic;
+* the color + slant transition does the "settle" work without needing
+* any wording change.
+*
+* Customize via the `intelligenceIndicator` slot on `CopilotChat`:
+* a className string restyles the wrapper, a props object tweaks
+* the default (`{ label }`), and a component replaces it entirely
+* with full control over visuals and timing.
+*/
+function IntelligenceIndicatorView({ message, status, label, className, ...rest }) {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+		className: (0, tailwind_merge.twMerge)("cpk-intelligence-indicator", className),
+		role: "status",
+		"aria-live": "polite",
+		"data-testid": `cpk-intelligence-indicator-${message.id}`,
+		"data-status": status,
+		title: label,
+		...rest,
+		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+			className: "cpk-intelligence-indicator__chrome",
+			"aria-hidden": "true"
+		}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+			className: "cpk-intelligence-indicator__content",
+			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("svg", {
+				className: "cpk-intelligence-indicator__icon",
+				viewBox: "0 0 24 24",
+				width: "14",
+				height: "14",
+				"aria-hidden": "true",
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { className: "cpk-intelligence-indicator__icon-path" })
+			}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+				className: "cpk-intelligence-indicator__label",
+				children: label
+			})]
+		})]
+	});
+}
+
 //#endregion
 //#region src/v2/components/intelligence-indicator/IntelligenceIndicator.tsx
 /**
 * Grace window before showing the spinner. A matching tool call must
 * remain unresolved (no `tool`-role result message in `agent.messages`)
-* for at least this long before the pill appears. This filters out
-* history-replay flashes — during `connectAgent` replay, tool calls and
-* their results arrive back-to-back in sub-millisecond bursts, so the
-* timer is cancelled before it fires. Live runs cross the threshold
-* easily because the tool actually has to execute.
+* for at least this long before the indicator transitions out of
+* `hidden`. This filters out history-replay flashes — during
+* `connectAgent` replay, tool calls and their results arrive
+* back-to-back in sub-millisecond bursts, so the timer is cancelled
+* before it fires. Live runs cross the threshold easily because the
+* tool actually has to execute.
 */
 const PENDING_THRESHOLD_MS = 100;
-/** 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`.
+* Tool-name regex patterns that trigger the indicator. Matches any tool
+* name *containing* the Intelligence MCP server's canonical tool name, so
+* both the bare `copilotkit_knowledge_base_shell` and the namespaced
+* `mcp__<server>__copilotkit_knowledge_base_shell` form (emitted by
+* `@ag-ui/mcp-middleware`) light up the pill. If we add per-instance
+* customization later (e.g. a `CopilotKitProvider` prop or a runtime-info
+* field), this constant becomes the fallback.
 */
-const FADE_OUT_ANIMATION_MS = 480;
+const DEFAULT_TOOL_PATTERNS = [/copilotkit_knowledge_base_shell/];
 /**
-* 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.
+* Phase to start in when an indicator first mounts. A turn that is already
+* complete at mount jumps straight to `finished` — no `hidden` flash, no
+* spinner blip — which is what makes scrolled-back / replayed history render
+* its indicators directly in the finished state.
+*
+* Pure and timing-free on purpose: the grace window ({@link
+* PENDING_THRESHOLD_MS}) only controls *when* the live transition is applied;
+* these functions decide *what* it resolves to, so the decision can be unit
+* tested deterministically without any timers.
 */
-const DEFAULT_TOOL_PATTERNS = [/^copilotkit_knowledge_base_shell$/];
+function initialIndicatorPhase(turnComplete) {
+	return turnComplete ? "finished" : "hidden";
+}
+/**
+* Phase the grace window resolves to once it elapses:
+*   - completed turn → `finished` (replay-flash suppression: a tool whose
+*     result lands within the window skips the spinner entirely),
+*   - a still-pending matching tool call → `spinner`,
+*   - otherwise stay `hidden` (the matching tool call hasn't landed yet).
+*/
+function resolveGracePhase(turnComplete, hasPending) {
+	if (turnComplete) return "finished";
+	if (hasPending) return "spinner";
+	return "hidden";
+}
 const isMatchingToolCallName = (name) => typeof name === "string" && DEFAULT_TOOL_PATTERNS.some((p) => p.test(name));
+const messageHasMatchingToolCall = (m) => {
+	if (m.role !== "assistant") return false;
+	return (Array.isArray(m.toolCalls) ? m.toolCalls : []).some((tc) => isMatchingToolCallName(tc?.function?.name));
+};
+/**
+* Stable turn id for the messages that precede the first user message (a turn
+* with no opening user message of its own). Used as the React key so the
+* indicator for that turn never collides with a real user-message id.
+*/
+const INTELLIGENCE_TURN_HEAD = "__cpk_turn_head__";
+/**
+* Map each Intelligence-using turn to its anchor message — the FIRST bash-using
+* assistant message of the turn — and a stable turn id (the id of the user
+* message that opened the turn, or {@link INTELLIGENCE_TURN_HEAD} for the
+* pre-first-user turn). Returns `Map<anchorMessageId, turnId>`.
+*
+* Anchoring to the FIRST (not last) bash-using message keeps the indicator
+* fixed in place for the whole turn: later bash steps don't reposition it, so
+* the spinner never abruptly jumps mid-turn (bug 1). `CopilotChatMessageView`
+* emits exactly one `IntelligenceIndicator` per entry, keyed by the turn id and
+* positioned at the anchor; the per-turn key also lets every past turn keep its
+* own indicator in scroll-back.
+*/
+function getIntelligenceTurnAnchors(messages) {
+	const anchors = /* @__PURE__ */ new Map();
+	let turnId = INTELLIGENCE_TURN_HEAD;
+	let anchorId = null;
+	const commit = () => {
+		if (anchorId !== null) anchors.set(anchorId, turnId);
+		anchorId = null;
+	};
+	for (const m of messages) {
+		if (m.role === "user") {
+			commit();
+			turnId = m.id;
+			continue;
+		}
+		if (anchorId === null && messageHasMatchingToolCall(m)) anchorId = m.id;
+	}
+	commit();
+	return anchors;
+}
 /**
 * "Tool-call-like" messages do NOT count as a real follow-up: tool
 * result messages, assistant messages that carry tool calls, and
@@ -5786,45 +6243,51 @@ const isToolCallLikeMessage = (m) => {
 	return false;
 };
 /**
-* 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.
+* The "Using CopilotKit Intelligence" indicator brain. Auto-mounted by
+* `CopilotChatMessageView` — once per Intelligence-using turn, at that
+* turn's anchor message and keyed by the turn id (see
+* {@link getIntelligenceTurnAnchors}). Callers do not register this
+* themselves. It owns the run subscription and the phase machine and
+* renders its swappable face via the `intelligenceIndicator` slot.
+*
+* Placement (which message anchors the turn) is decided by the view, so
+* this component does not self-gate its own placement; it only derives
+* in-progress/finished for the turn it was mounted on.
 *
 * Render gates (all must hold):
 *   1. `copilotkit.intelligence !== undefined`
-*   2. The message is an assistant message with at least one tool call
-*      whose name matches {@link DEFAULT_TOOL_PATTERNS}
-*   3. The message is the *latest* such matching-assistant message in
-*      `agent.messages` — tool-result messages and prose-only assistant
-*      messages don't invalidate the slot, so the pill stays
-*      continuously through a multi-step tool chain.
-*   4. The phase machine is past `idle` (the pending-grace timer fired)
-*      and not yet `hidden`.
+*   2. The (anchor) message is an assistant message with at least one
+*      tool call whose name matches {@link DEFAULT_TOOL_PATTERNS}.
+*   3. The phase machine is past `hidden`.
+*
+* Because the view keys each indicator by its turn id, the instance moves
+* with the anchor across a hand-off (no remount, no spinner restart), and
+* every prior Intelligence-using turn keeps its own persistent indicator
+* in chat history.
 *
 * Phase machine (per-instance, all timers local):
-*   - Starts in `idle` — nothing rendered.
-*   - `idle → spinner` once a matching tool call has been pending
+*   - Starts in `hidden`, unless the message mounts onto an
+*     already-completed turn (no pending work, agent stopped or a
+*     real follow-up already present), in which case the lazy
+*     `useState` initializer starts directly in `finished`. This is
+*     what avoids a "hidden flash" on history replay.
+*   - `hidden → spinner` once a matching tool call has been pending
 *     (no `tool`-role result with a matching `toolCallId`) for
 *     {@link PENDING_THRESHOLD_MS}. Replay flashes (tool call + result
 *     in the same tick) never cross this threshold.
-*   - `spinner → check` as soon as EITHER `agent.isRunning` flips
+*   - `hidden → finished` if after the grace window the turn is
+*     already complete (no pending work AND
+*     `sawRealFollowup || !agent.isRunning`). Handles very fast tools
+*     whose result lands within the grace window.
+*   - `spinner → finished` as soon as EITHER `agent.isRunning` flips
 *     false OR a non-tool-call-like message appears later in
-*     `agent.messages` (i.e. the agent has produced a "real"
-*     follow-up — prose answer or a new user turn).
-*   - `check → fading` after {@link CHECK_HOLD_MS}.
-*   - `fading → hidden` after {@link FADE_OUT_ANIMATION_MS}.
-*
-* Once `hidden`, the phase is sticky — a finished pill never re-spawns
-* on the same message. New runs mount fresh indicator instances on
-* their own assistant messages.
-*
-* The "exactly one pill at a time" guarantee is structural: only one
-* message satisfies the latest-matching-assistant gate at any moment.
+*     `agent.messages` (i.e. the agent produced a "real" follow-up —
+*     prose answer or a new user turn).
+*   - `finished` is terminal: the indicator settles into its
+*     persistent tag form and stays mounted.
 */
 function IntelligenceIndicator(props) {
-	const { message, agentId, label = "Using CopilotKit Intelligence" } = props;
+	const { message, agentId, label = "CopilotKit Intelligence", intelligenceIndicator } = props;
 	const { copilotkit } = useCopilotKit();
 	const config = useCopilotChatConfiguration();
 	const { agent } = useAgent({
@@ -5844,84 +6307,37 @@ function IntelligenceIndicator(props) {
 		for (const m of agent.messages) if (m.role === "tool" && m.toolCallId) resolved.add(m.toolCallId);
 		return matchingToolCallIds.some((id) => !resolved.has(id));
 	}, [matchingToolCallIds, agent.messages]);
-	const sawRealFollowup = (0, react.useMemo)(() => {
+	const turnComplete = (0, react.useMemo)(() => {
 		const idx = agent.messages.findIndex((m) => m.id === message.id);
 		if (idx < 0) return false;
 		for (let i = idx + 1; i < agent.messages.length; i += 1) if (!isToolCallLikeMessage(agent.messages[i])) return true;
 		return false;
-	}, [agent.messages, message.id]);
-	const [phase, setPhase] = (0, react.useState)("idle");
+	}, [agent.messages, message.id]) || !agent.isRunning;
+	const [phase, setPhase] = (0, react.useState)(() => initialIndicatorPhase(turnComplete));
 	(0, react.useEffect)(() => {
-		if (phase !== "idle") return void 0;
-		if (!hasPending) return void 0;
-		const t = setTimeout(() => setPhase("spinner"), PENDING_THRESHOLD_MS);
+		if (phase !== "hidden") return void 0;
+		const t = setTimeout(() => {
+			setPhase(resolveGracePhase(turnComplete, hasPending));
+		}, PENDING_THRESHOLD_MS);
 		return () => clearTimeout(t);
-	}, [phase, hasPending]);
-	(0, react.useEffect)(() => {
-		if (phase !== "spinner") return void 0;
-		if (!agent.isRunning || sawRealFollowup) setPhase("check");
 	}, [
 		phase,
-		agent.isRunning,
-		sawRealFollowup
+		hasPending,
+		turnComplete
 	]);
 	(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 (phase !== "spinner") return void 0;
+		if (turnComplete) setPhase("finished");
+	}, [phase, turnComplete]);
 	if (copilotkit.intelligence === void 0) return null;
 	if (!config) return null;
-	if (phase === "idle" || phase === "hidden") return null;
+	if (phase === "hidden") return null;
 	if (message.role !== "assistant") return null;
-	if (!(Array.isArray(message.toolCalls) ? message.toolCalls : []).some((tc) => isMatchingToolCallName(tc?.function?.name))) return null;
-	let latestMatchingAssistantId;
-	for (let i = agent.messages.length - 1; i >= 0; i -= 1) {
-		const m = agent.messages[i];
-		if (m.role !== "assistant") continue;
-		if ((Array.isArray(m.toolCalls) ? m.toolCalls : []).some((tc) => isMatchingToolCallName(tc?.function?.name))) {
-			latestMatchingAssistantId = m.id;
-			break;
-		}
-	}
-	if (latestMatchingAssistantId !== 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 })]
+	if (!messageHasMatchingToolCall(message)) return null;
+	return renderSlot(intelligenceIndicator, IntelligenceIndicatorView, {
+		message,
+		status: phase === "finished" ? "finished" : "in-progress",
+		label
 	});
 }
 
@@ -6074,7 +6490,7 @@ function deduplicateMessages(messages) {
 	return [...acc.values()];
 }
 const VIRTUALIZE_THRESHOLD = 50;
-function CopilotChatMessageView({ messages = [], assistantMessage, userMessage, reasoningMessage, cursor, isRunning = false, children, className, ...props }) {
+function CopilotChatMessageView({ messages = [], assistantMessage, userMessage, reasoningMessage, cursor, intelligenceIndicator, isRunning = false, children, className, ...props }) {
 	const renderCustomMessage = useRenderCustomMessages();
 	const { renderActivityMessage } = useRenderActivityMessage();
 	const { copilotkit } = useCopilotKit();
@@ -6132,6 +6548,7 @@ function CopilotChatMessageView({ messages = [], assistantMessage, userMessage,
 		if (!shouldVirtualize || !deduplicatedMessages.length) return;
 		virtualizer.scrollToIndex(deduplicatedMessages.length - 1, { align: "end" });
 	}, [shouldVirtualize, firstMessageId]);
+	const intelligenceTurnAnchors = (0, react.useMemo)(() => getIntelligenceTurnAnchors(deduplicatedMessages), [deduplicatedMessages]);
 	const renderMessageBlock = (message) => {
 		const elements = [];
 		const stateSnapshot = getStateSnapshotForMessage(message.id);
@@ -6170,10 +6587,12 @@ function CopilotChatMessageView({ messages = [], assistantMessage, userMessage,
 			renderCustomMessage,
 			stateSnapshot
 		}, `${message.id}-custom-after`));
-		if (copilotkit.intelligence !== void 0 && message.role === "assistant") elements.push(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(IntelligenceIndicator, {
+		const intelligenceTurnId = intelligenceTurnAnchors.get(message.id);
+		if (intelligenceTurnId !== void 0) elements.push(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(IntelligenceIndicator, {
 			message,
-			agentId: config?.agentId ?? _copilotkit_shared.DEFAULT_AGENT_ID
-		}, `${message.id}-intelligence`));
+			agentId: config?.agentId ?? _copilotkit_shared.DEFAULT_AGENT_ID,
+			intelligenceIndicator
+		}, `intelligence-${intelligenceTurnId}`));
 		return elements.filter(Boolean);
 	};
 	const messageElements = shouldVirtualize ? [] : deduplicatedMessages.flatMap(renderMessageBlock);
@@ -6610,7 +7029,7 @@ function DropOverlay() {
 		})
 	});
 }
-function CopilotChatView({ messageView, input, scrollView, suggestionView, welcomeScreen, messages = [], autoScroll = true, isRunning = false, suggestions, suggestionLoadingIndexes, onSelectSuggestion, onSubmitMessage, onStop, inputMode, inputValue, onInputChange, onStartTranscribe, onCancelTranscribe, onFinishTranscribe, onFinishTranscribeWithAudio, attachments, onRemoveAttachment, onAddFile, dragOver, onDragOver, onDragLeave, onDrop, isConnecting = false, hasExplicitThreadId = false, disclaimer, children, className, ...props }) {
+function CopilotChatView({ messageView, input, scrollView, suggestionView, welcomeScreen, messages = [], autoScroll = true, isRunning = false, suggestions, suggestionLoadingIndexes, onSelectSuggestion, onSubmitMessage, onStop, inputMode, inputValue, onInputChange, onStartTranscribe, onCancelTranscribe, onFinishTranscribe, onFinishTranscribeWithAudio, attachments, onRemoveAttachment, onAddFile, dragOver, onDragOver, onDragLeave, onDrop, isConnecting = false, hasExplicitThreadId = false, disclaimer, intelligenceIndicator, children, className, ...props }) {
 	const [inputContainerEl, setInputContainerEl] = (0, react.useState)(null);
 	const [inputContainerHeight, setInputContainerHeight] = (0, react.useState)(0);
 	const [isResizing, setIsResizing] = (0, react.useState)(false);
@@ -6647,7 +7066,8 @@ function CopilotChatView({ messageView, input, scrollView, suggestionView, welco
 	}, [inputContainerEl]);
 	const BoundMessageView = renderSlot(messageView, CopilotChatMessageView, {
 		messages,
-		isRunning
+		isRunning,
+		intelligenceIndicator
 	});
 	const BoundInput = renderSlot(input, CopilotChatInput_default, {
 		onSubmitMessage,
@@ -7153,6 +7573,10 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 	const [transcriptionError, setTranscriptionError] = (0, react.useState)(null);
 	const [isTranscribing, setIsTranscribing] = (0, react.useState)(false);
 	const { attachments: selectedAttachments, enabled: attachmentsEnabled, dragOver, fileInputRef, containerRef: chatContainerRef, handleFileUpload, handleDragOver, handleDragLeave, handleDrop, removeAttachment, consumeAttachments } = useAttachments({ config: attachmentsConfig });
+	const selectedAttachmentsRef = (0, react.useRef)(selectedAttachments);
+	(0, react.useEffect)(() => {
+		selectedAttachmentsRef.current = selectedAttachments;
+	}, [selectedAttachments]);
 	const isTranscriptionEnabled = copilotkit.audioFileTranscriptionEnabled;
 	const isMediaRecorderSupported = typeof window !== "undefined" && typeof MediaRecorder !== "undefined";
 	const { messageView: providedMessageView, suggestionView: providedSuggestionView, onStop: providedStopHandler, ...restProps } = props;
@@ -7188,9 +7612,25 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 		resolvedAgentId,
 		hasExplicitThreadId
 	]);
+	const waitForActiveRunToSettle = (0, react.useCallback)(async () => {
+		if (agent.isRunning && (0, _copilotkit_core.isRunCompletionAware)(agent) && agent.activeRunCompletionPromise) try {
+			await agent.activeRunCompletionPromise;
+		} catch (error) {
+			console.error("CopilotChat: in-flight run rejected while queuing send", error);
+		}
+	}, [agent]);
 	const onSubmitInput = (0, react.useCallback)(async (value) => {
-		if (selectedAttachments.some((a) => a.status === "uploading")) {
-			console.error("[CopilotKit] Cannot send while attachments are uploading");
+		if (selectedAttachmentsRef.current.some((a) => a.status === "uploading")) {
+			console.error("[CopilotKit] Cannot send while attachments are uploading (pre-await guard)");
+			setTranscriptionError("Cannot send while attachments are uploading.");
+			return;
+		}
+		setInputValue("");
+		await waitForActiveRunToSettle();
+		if (selectedAttachmentsRef.current.some((a) => a.status === "uploading")) {
+			console.error("[CopilotKit] Cannot send while attachments are uploading (post-await re-check)");
+			setTranscriptionError("Cannot send while attachments are uploading.");
+			setInputValue(value);
 			return;
 		}
 		const readyAttachments = consumeAttachments();
@@ -7218,7 +7658,6 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 			role: "user",
 			content: value
 		});
-		setInputValue("");
 		try {
 			await copilotkit.runAgent({ agent });
 		} catch (error) {
@@ -7226,10 +7665,11 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 		}
 	}, [
 		agent,
-		selectedAttachments,
-		consumeAttachments
+		consumeAttachments,
+		waitForActiveRunToSettle
 	]);
 	const handleSelectSuggestion = (0, react.useCallback)(async (suggestion) => {
+		await waitForActiveRunToSettle();
 		agent.addMessage({
 			id: (0, _copilotkit_shared.randomUUID)(),
 			role: "user",
@@ -7240,7 +7680,7 @@ function CopilotChat({ agentId, threadId, labels, chatView, isModalDefaultOpen,
 		} catch (error) {
 			console.error("CopilotChat: runAgent failed after selecting suggestion", error);
 		}
-	}, [agent]);
+	}, [agent, waitForActiveRunToSettle]);
 	const stopCurrentRun = (0, react.useCallback)(() => {
 		try {
 			copilotkit.stopAgent({ agent });
@@ -10308,12 +10748,24 @@ Object.defineProperty(exports, 'DefaultOpenIcon', {
     return DefaultOpenIcon;
   }
 });
+Object.defineProperty(exports, 'INTELLIGENCE_TURN_HEAD', {
+  enumerable: true,
+  get: function () {
+    return INTELLIGENCE_TURN_HEAD;
+  }
+});
 Object.defineProperty(exports, 'IntelligenceIndicator', {
   enumerable: true,
   get: function () {
     return IntelligenceIndicator;
   }
 });
+Object.defineProperty(exports, 'IntelligenceIndicatorView', {
+  enumerable: true,
+  get: function () {
+    return IntelligenceIndicatorView;
+  }
+});
 Object.defineProperty(exports, 'MCPAppsActivityContentSchema', {
   enumerable: true,
   get: function () {
@@ -10386,6 +10838,12 @@ Object.defineProperty(exports, 'defineToolCallRenderer', {
     return defineToolCallRenderer;
   }
 });
+Object.defineProperty(exports, 'getIntelligenceTurnAnchors', {
+  enumerable: true,
+  get: function () {
+    return getIntelligenceTurnAnchors;
+  }
+});
 Object.defineProperty(exports, 'shouldShowDevConsole', {
   enumerable: true,
   get: function () {
@@ -10488,6 +10946,30 @@ Object.defineProperty(exports, 'useInterrupt', {
     return useInterrupt;
   }
 });
+Object.defineProperty(exports, 'useLearnFromUserAction', {
+  enumerable: true,
+  get: function () {
+    return useLearnFromUserAction;
+  }
+});
+Object.defineProperty(exports, 'useLearnFromUserActionInCurrentThread', {
+  enumerable: true,
+  get: function () {
+    return useLearnFromUserActionInCurrentThread;
+  }
+});
+Object.defineProperty(exports, 'useLearningContainers', {
+  enumerable: true,
+  get: function () {
+    return useLearningContainers;
+  }
+});
+Object.defineProperty(exports, 'useLearningContainersInCurrentThread', {
+  enumerable: true,
+  get: function () {
+    return useLearningContainersInCurrentThread;
+  }
+});
 Object.defineProperty(exports, 'useRenderActivityMessage', {
   enumerable: true,
   get: function () {
@@ -10542,4 +11024,4 @@ Object.defineProperty(exports, 'useToast', {
     return useToast;
   }
 });
-//# sourceMappingURL=copilotkit-IQO0VDZb.cjs.map
+//# sourceMappingURL=copilotkit-LdQ8w20l.cjs.map