@copilotkit/react-core 1.83.0 → 2.0.0-rc.0

package/dist/{v2/headless.cjs → headless.cjs}

@@ -26,7 +26,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 
 //#endregion
-let _copilotkit_react_core_v2_context = require("@copilotkit/react-core/v2/context");
+let _copilotkit_react_core_context = require("@copilotkit/react-core/context");
 let react = require("react");
 react = __toESM(react);
 let _copilotkit_shared = require("@copilotkit/shared");
@@ -36,7 +36,7 @@ let _ag_ui_client = require("@ag-ui/client");
 let zod = require("zod");
 let _ag_ui_core = require("@ag-ui/core");
 
-//#region src/v2/lib/shallow-stable-ref.ts
+//#region src/lib/shallow-stable-ref.ts
 /**
 * Shallow equality comparison for objects.
 */
@@ -78,7 +78,7 @@ function useShallowStableRef(value) {
 }
 
 //#endregion
-//#region src/v2/providers/CopilotChatConfigurationProvider.tsx
+//#region src/providers/CopilotChatConfigurationProvider.tsx
 const CopilotChatDefaultLabels = {
 	chatInputPlaceholder: "Type a message...",
 	chatInputToolbarStartTranscribeButtonLabel: "Transcribe",
@@ -152,7 +152,7 @@ const CopilotChatConfigurationProvider = ({ children, labels, agentId, threadId,
 		...parentConfig?.labels,
 		...stableLabels
 	}), [stableLabels, parentConfig?.labels]);
-	const providerAgentId = (0, _copilotkit_react_core_v2_context.useDefaultAgentId)();
+	const providerAgentId = (0, _copilotkit_react_core_context.useDefaultAgentId)();
 	const resolvedAgentId = agentId ?? parentConfig?.agentId ?? providerAgentId ?? _copilotkit_shared.DEFAULT_AGENT_ID;
 	const threadIdPropIsAuthoritative = threadId !== void 0 && hasExplicitThreadId !== false;
 	const isThreadIdControlled = threadIdPropIsAuthoritative;
@@ -169,7 +169,7 @@ const CopilotChatConfigurationProvider = ({ children, labels, agentId, threadId,
 		parentConfig?.threadId,
 		activeThreadOverride
 	]);
-	const copilotkit = (0, react.useContext)(_copilotkit_react_core_v2_context.CopilotKitContext)?.copilotkit;
+	const copilotkit = (0, react.useContext)(_copilotkit_react_core_context.CopilotKitContext)?.copilotkit;
 	const openThreadRef = (0, react.useRef)(null);
 	const latestThreadIdRef = (0, react.useRef)(resolvedThreadId);
 	latestThreadIdRef.current = resolvedThreadId;
@@ -381,7 +381,7 @@ const ControlledModalOpenScope = ({ children, open, onOpenChange }) => {
 ControlledModalOpenScope.displayName = "ControlledModalOpenScope";
 
 //#endregion
-//#region src/v2/hooks/use-agent.tsx
+//#region src/hooks/use-agent.tsx
 let UseAgentUpdate = /* @__PURE__ */ function(UseAgentUpdate) {
 	UseAgentUpdate["OnMessagesChanged"] = "OnMessagesChanged";
 	UseAgentUpdate["OnStateChanged"] = "OnStateChanged";
@@ -398,9 +398,9 @@ function useAgent({ agentId, threadId, runtimeAgentId, updates, throttleMs } = {
 	if (runtimeAgentId != null && threadId == null) throw new Error(`useAgent: \`runtimeAgentId\` requires \`threadId\`. A proxied agent exists to scope a thread to a private instance; without a threadId it behaves like the shared agent while adding a registration and a local agentId to keep unique. Either pass the thread, e.g. useAgent({ agentId: "${agentId ?? "chat-1"}", runtimeAgentId: "${runtimeAgentId}", threadId }), or bind to the agent directly with useAgent({ agentId: "${runtimeAgentId}" }).`);
 	if (runtimeAgentId != null && agentId == null) throw new Error(`useAgent: \`runtimeAgentId\` requires an explicit \`agentId\`. The proxied agent is registered under \`agentId\`, and the usual fallbacks (chat configuration, then "${_copilotkit_shared.DEFAULT_AGENT_ID}") name agents that already exist — registering over one throws or shadows it. Pick a local id for this hook, e.g. useAgent({ agentId: "chat-1", runtimeAgentId: "${runtimeAgentId}", threadId }).`);
 	const chatConfig = useCopilotChatConfiguration();
-	const providerAgentId = (0, _copilotkit_react_core_v2_context.useDefaultAgentId)();
+	const providerAgentId = (0, _copilotkit_react_core_context.useDefaultAgentId)();
 	const resolvedAgentId = agentId ?? chatConfig?.agentId ?? providerAgentId ?? _copilotkit_shared.DEFAULT_AGENT_ID;
-	const { copilotkit } = (0, _copilotkit_react_core_v2_context.useCopilotKit)();
+	const { copilotkit } = (0, _copilotkit_react_core_context.useCopilotKit)();
 	const providerThrottleMs = copilotkit.defaultThrottleMs;
 	const [, forceUpdate] = (0, react.useReducer)((x) => x + 1, 0);
 	const updateFlags = (0, react.useMemo)(() => updates ?? ALL_UPDATES, [JSON.stringify(updates)]);
@@ -579,7 +579,7 @@ function useAgent({ agentId, threadId, runtimeAgentId, updates, throttleMs } = {
 }
 
 //#endregion
-//#region src/v2/hooks/tool-registration.ts
+//#region src/hooks/tool-registration.ts
 /**
 * Deps comparison shared by `useFrontendTool` (and through it
 * `useHumanInTheLoop` and `useComponent`) and `useRenderTool`. Not part of the
@@ -654,9 +654,9 @@ function useDepsVersion(deps) {
 }
 
 //#endregion
-//#region src/v2/hooks/use-frontend-tool.tsx
+//#region src/hooks/use-frontend-tool.tsx
 function useFrontendTool(tool, deps) {
-	const { copilotkit } = (0, _copilotkit_react_core_v2_context.useCopilotKit)();
+	const { copilotkit } = (0, _copilotkit_react_core_context.useCopilotKit)();
 	const depsVersion = useDepsVersion(deps);
 	(0, react.useLayoutEffect)(() => {
 		const name = tool.name;
@@ -687,7 +687,7 @@ function useFrontendTool(tool, deps) {
 }
 
 //#endregion
-//#region src/v2/hooks/use-frontend-tools.tsx
+//#region src/hooks/use-frontend-tools.tsx
 const EMPTY_DEPS = [];
 const EMPTY_TOOLS = [];
 /**
@@ -740,7 +740,7 @@ const EMPTY_TOOLS = [];
 * ```
 */
 function useFrontendTools(tools, deps) {
-	const { copilotkit } = (0, _copilotkit_react_core_v2_context.useCopilotKit)();
+	const { copilotkit } = (0, _copilotkit_react_core_context.useCopilotKit)();
 	const toolList = tools ?? EMPTY_TOOLS;
 	const extraDeps = deps ?? EMPTY_DEPS;
 	(0, react.useLayoutEffect)(() => {
@@ -784,7 +784,7 @@ function useFrontendTools(tools, deps) {
 }
 
 //#endregion
-//#region src/v2/hooks/use-component.tsx
+//#region src/hooks/use-component.tsx
 /**
 * Registers a React component as a frontend tool renderer in chat.
 *
@@ -852,11 +852,11 @@ function useComponent(config, deps) {
 }
 
 //#endregion
-//#region src/v2/hooks/use-human-in-the-loop.tsx
+//#region src/hooks/use-human-in-the-loop.tsx
 /** Registration name of a catch-all tool: handles any otherwise-unhandled call. */
 const WILDCARD_TOOL_NAME = "*";
 function useHumanInTheLoop(tool, deps) {
-	const { copilotkit } = (0, _copilotkit_react_core_v2_context.useCopilotKit)();
+	const { copilotkit } = (0, _copilotkit_react_core_context.useCopilotKit)();
 	const resolvePromiseRef = (0, react.useRef)(null);
 	const cleanupAbortRef = (0, react.useRef)(null);
 	const respond = (0, react.useCallback)(async (result) => {
@@ -945,12 +945,13 @@ function useHumanInTheLoop(tool, deps) {
 }
 
 //#endregion
-//#region src/v2/types/interrupt.ts
+//#region src/types/interrupt.ts
 /** Name of the legacy custom event agents emit to signal an interrupt. */
 const INTERRUPT_EVENT_NAME = "on_interrupt";
 
 //#endregion
-//#region src/v2/hooks/use-interrupt.tsx
+//#region src/hooks/use-interrupt.tsx
+/** Recognize thenables returned by interrupt preprocessing handlers. */
 function isPromiseLike(value) {
 	return (typeof value === "object" || typeof value === "function") && value !== null && typeof Reflect.get(value, "then") === "function";
 }
@@ -990,7 +991,7 @@ function toLegacyEvent(pending) {
 * ```
 */
 function useInterrupt(config) {
-	const { copilotkit } = (0, _copilotkit_react_core_v2_context.useCopilotKit)();
+	const { copilotkit } = (0, _copilotkit_react_core_context.useCopilotKit)();
 	const { agent } = useAgent({
 		agentId: config.agentId,
 		updates: []
@@ -1001,7 +1002,6 @@ function useInterrupt(config) {
 	const [handlerResult, setHandlerResult] = (0, react.useState)(null);
 	const interruptStateRef = (0, react.useRef)(new _copilotkit_core.ɵInterruptState());
 	(0, react.useEffect)(() => {
-		const interruptState = interruptStateRef.current;
 		let localLegacy = null;
 		let localStandard = null;
 		const subscription = agent.subscribe({
@@ -1014,19 +1014,21 @@ function useInterrupt(config) {
 			onRunFinishedEvent: (params) => {
 				if (params.outcome === "interrupt") localStandard = params.interrupts;
 			},
-			onRunStartedEvent: () => {
+			onRunStartedEvent: (params) => {
+				if (!agent.pendingInterrupts?.length || params?.input?.resume !== void 0) (0, _copilotkit_core.ɵclearAgentInterruptState)(agent);
 				localLegacy = null;
 				localStandard = null;
-				interruptState.clear();
+				interruptStateRef.current = new _copilotkit_core.ɵInterruptState();
 				setPending(null);
 			},
 			onRunFinalized: () => {
 				if (localStandard && localStandard.length > 0) {
-					interruptState.setStandard(localStandard);
-					setPending(interruptState.pending);
+					interruptStateRef.current = (0, _copilotkit_core.ɵgetAgentInterruptState)(agent, localStandard);
+					setPending(interruptStateRef.current.pending);
 				} else if (localLegacy) {
-					interruptState.setLegacy(localLegacy);
-					setPending(interruptState.pending);
+					interruptStateRef.current = new _copilotkit_core.ɵInterruptState();
+					interruptStateRef.current.setLegacy(localLegacy);
+					setPending(interruptStateRef.current.pending);
 				}
 				localLegacy = null;
 				localStandard = null;
@@ -1034,20 +1036,27 @@ function useInterrupt(config) {
 			onRunFailed: () => {
 				localLegacy = null;
 				localStandard = null;
-				interruptState.clear();
+				interruptStateRef.current = new _copilotkit_core.ɵInterruptState();
 				setPending(null);
 			}
 		});
+		interruptStateRef.current = agent.pendingInterrupts?.length ? (0, _copilotkit_core.ɵgetAgentInterruptState)(agent) : new _copilotkit_core.ɵInterruptState();
+		setPending(interruptStateRef.current.pending);
 		return () => {
 			subscription.unsubscribe();
-			interruptState.clear();
+			interruptStateRef.current = new _copilotkit_core.ɵInterruptState();
 		};
 	}, [agent]);
+	/** Record an explicit answer and resume once the complete batch is addressed. */
 	const resolve = (0, react.useCallback)(async (payload, interruptId) => {
 		const current = pendingRef.current;
 		if (!current) return;
 		if (current.kind === "standard" && current.interrupts.length > 1 && interruptId === void 0) console.warn(`[CopilotKit] useInterrupt: resolve()/cancel() called without an interruptId while ${current.interrupts.length} interrupts are open; defaulting to the first. Pass an interruptId to address a specific interrupt.`);
-		const decision = interruptStateRef.current.resolve(payload, interruptId);
+		if (interruptStateRef.current.isCompletedToolCall(interruptId, agent.messages)) {
+			console.warn("[CopilotKit] useInterrupt: ignoring an answer for an already completed frontend tool call.");
+			return;
+		}
+		const decision = interruptStateRef.current.resolve(payload, interruptId, agent.messages);
 		if (decision.kind === "legacy-resume") try {
 			return await copilotkit.runAgent({
 				agent,
@@ -1063,7 +1072,7 @@ function useInterrupt(config) {
 		}
 		if (decision.kind === "expired") {
 			console.error(`[CopilotKit] useInterrupt: interrupt ${decision.interrupt.id} expired at ${decision.interrupt.expiresAt}; not resuming.`);
-			interruptStateRef.current.clear();
+			interruptStateRef.current = new _copilotkit_core.ɵInterruptState();
 			setPending(null);
 			return;
 		}
@@ -1081,25 +1090,30 @@ function useInterrupt(config) {
 			});
 		} catch (err) {
 			console.error("[CopilotKit] useInterrupt resolve: runAgent rejected; clearing pending + rethrowing", err);
-			interruptStateRef.current.clear();
+			interruptStateRef.current = new _copilotkit_core.ɵInterruptState();
 			setPending(null);
 			throw err;
 		}
 	}, [agent, copilotkit]);
+	/** Cancel a standard interrupt or dismiss a legacy interrupt locally. */
 	const cancel = (0, react.useCallback)(async (interruptId) => {
 		const current = pendingRef.current;
 		if (!current) return;
 		if (current.kind === "standard" && current.interrupts.length > 1 && interruptId === void 0) console.warn(`[CopilotKit] useInterrupt: resolve()/cancel() called without an interruptId while ${current.interrupts.length} interrupts are open; defaulting to the first. Pass an interruptId to address a specific interrupt.`);
-		const decision = interruptStateRef.current.cancel(interruptId);
+		if (interruptStateRef.current.isCompletedToolCall(interruptId, agent.messages)) {
+			console.warn("[CopilotKit] useInterrupt: ignoring an answer for an already completed frontend tool call.");
+			return;
+		}
+		const decision = interruptStateRef.current.cancel(interruptId, agent.messages);
 		if (decision.kind === "dismiss") {
 			console.warn("[CopilotKit] useInterrupt: cancel() is not supported for legacy on_interrupt interrupts; dismissing.");
-			interruptStateRef.current.clear();
+			interruptStateRef.current = new _copilotkit_core.ɵInterruptState();
 			setPending(null);
 			return;
 		}
 		if (decision.kind === "expired") {
 			console.error(`[CopilotKit] useInterrupt: interrupt ${decision.interrupt.id} expired at ${decision.interrupt.expiresAt}; not resuming.`);
-			interruptStateRef.current.clear();
+			interruptStateRef.current = new _copilotkit_core.ɵInterruptState();
 			setPending(null);
 			return;
 		}
@@ -1117,7 +1131,7 @@ function useInterrupt(config) {
 			});
 		} catch (err) {
 			console.error("[CopilotKit] useInterrupt resolve: runAgent rejected; clearing pending + rethrowing", err);
-			interruptStateRef.current.clear();
+			interruptStateRef.current = new _copilotkit_core.ɵInterruptState();
 			setPending(null);
 			throw err;
 		}
@@ -1132,6 +1146,7 @@ function useInterrupt(config) {
 	resolveRef.current = resolve;
 	const cancelRef = (0, react.useRef)(cancel);
 	cancelRef.current = cancel;
+	/** Evaluate the consumer filter, logging failures and disabling their UI. */
 	const isEnabled = (event) => {
 		const predicate = enabledRef.current;
 		if (!predicate) return true;
@@ -1221,11 +1236,11 @@ function useInterrupt(config) {
 }
 
 //#endregion
-//#region src/v2/hooks/use-suggestions.tsx
+//#region src/hooks/use-suggestions.tsx
 function useSuggestions({ agentId } = {}) {
-	const { copilotkit } = (0, _copilotkit_react_core_v2_context.useCopilotKit)();
+	const { copilotkit } = (0, _copilotkit_react_core_context.useCopilotKit)();
 	const config = useCopilotChatConfiguration();
-	const providerAgentId = (0, _copilotkit_react_core_v2_context.useDefaultAgentId)();
+	const providerAgentId = (0, _copilotkit_react_core_context.useDefaultAgentId)();
 	const resolvedAgentId = (0, react.useMemo)(() => agentId ?? config?.agentId ?? providerAgentId ?? _copilotkit_shared.DEFAULT_AGENT_ID, [
 		agentId,
 		config?.agentId,
@@ -1279,9 +1294,9 @@ function useSuggestions({ agentId } = {}) {
 }
 
 //#endregion
-//#region src/v2/hooks/use-configure-suggestions.tsx
+//#region src/hooks/use-configure-suggestions.tsx
 function useConfigureSuggestions(config, deps) {
-	const { copilotkit } = (0, _copilotkit_react_core_v2_context.useCopilotKit)();
+	const { copilotkit } = (0, _copilotkit_react_core_context.useCopilotKit)();
 	const chatConfig = useCopilotChatConfiguration();
 	const extraDeps = deps ?? [];
 	const resolvedConsumerAgentId = (0, react.useMemo)(() => chatConfig?.agentId ?? _copilotkit_shared.DEFAULT_AGENT_ID, [chatConfig?.agentId]);
@@ -1438,10 +1453,10 @@ function normalizeStaticSuggestions(suggestions) {
 }
 
 //#endregion
-//#region src/v2/hooks/use-agent-context.tsx
+//#region src/hooks/use-agent-context.tsx
 function useAgentContext(context) {
 	const { description, value } = context;
-	const { copilotkit } = (0, _copilotkit_react_core_v2_context.useCopilotKit)();
+	const { copilotkit } = (0, _copilotkit_react_core_context.useCopilotKit)();
 	const stringValue = (0, react.useMemo)(() => {
 		if (typeof value === "string") return value;
 		return JSON.stringify(value);
@@ -1463,7 +1478,7 @@ function useAgentContext(context) {
 }
 
 //#endregion
-//#region src/v2/hooks/use-threads.tsx
+//#region src/hooks/use-threads.tsx
 function useThreadStoreSelector(store, selector) {
 	return (0, react.useSyncExternalStore)((0, react.useCallback)((onStoreChange) => {
 		const subscription = store.select(selector).subscribe(onStoreChange);
@@ -1512,7 +1527,7 @@ function useThreadStoreSelector(store, selector) {
 * ```
 */
 function useThreads({ agentId, includeArchived, limit, enabled = true }) {
-	const { copilotkit } = (0, _copilotkit_react_core_v2_context.useCopilotKit)();
+	const { copilotkit } = (0, _copilotkit_react_core_context.useCopilotKit)();
 	const [store] = (0, react.useState)(() => (0, _copilotkit_core.ɵcreateThreadStore)({ fetch: copilotkit.ɵruntimeFetch }));
 	const coreThreads = useThreadStoreSelector(store, _copilotkit_core.ɵselectThreads);
 	const threads = (0, react.useMemo)(() => coreThreads.map(({ id, agentId, name, archived, createdAt, updatedAt, lastRunAt }) => ({
@@ -1647,7 +1662,7 @@ function useThreads({ agentId, includeArchived, limit, enabled = true }) {
 }
 
 //#endregion
-//#region src/v2/types/defineToolCallRenderer.ts
+//#region src/types/defineToolCallRenderer.ts
 function defineToolCallRenderer(def) {
 	const argsSchema = def.name === "*" && !def.args ? zod.z.any() : def.args;
 	return {
@@ -1660,7 +1675,7 @@ function defineToolCallRenderer(def) {
 }
 
 //#endregion
-//#region src/v2/hooks/use-render-tool.tsx
+//#region src/hooks/use-render-tool.tsx
 /**
 * Registers a renderer entry in CopilotKit's `renderToolCalls` registry.
 *
@@ -1703,7 +1718,7 @@ function defineToolCallRenderer(def) {
 * ```
 */
 function useRenderTool(config, deps) {
-	const { copilotkit } = (0, _copilotkit_react_core_v2_context.useCopilotKit)();
+	const { copilotkit } = (0, _copilotkit_react_core_context.useCopilotKit)();
 	const depsVersion = useDepsVersion(deps);
 	(0, react.useEffect)(() => {
 		const renderer = config.name === "*" && !config.parameters ? defineToolCallRenderer({
@@ -1744,7 +1759,7 @@ function useRenderTool(config, deps) {
 }
 
 //#endregion
-//#region src/v2/hooks/use-render-tool-call.tsx
+//#region src/hooks/use-render-tool-call.tsx
 /**
 * Memoized component that renders a single tool call.
 * This prevents unnecessary re-renders when parent components update
@@ -1811,7 +1826,7 @@ function warnAboutUnrenderedToolCalls(toolNames, registered, alreadyWarned) {
 * @internal
 */
 function useToolCallRenderers() {
-	const { copilotkit } = (0, _copilotkit_react_core_v2_context.useCopilotKit)();
+	const { copilotkit } = (0, _copilotkit_react_core_context.useCopilotKit)();
 	return (0, react.useSyncExternalStore)((callback) => copilotkit.subscribe({ onRenderToolCallsChanged: callback }).unsubscribe, () => copilotkit.renderToolCalls, () => copilotkit.renderToolCalls);
 }
 /**
@@ -1821,7 +1836,7 @@ function useToolCallRenderers() {
 * @returns A function that takes a tool call and optional tool message and returns the rendered component
 */
 function useRenderToolCall() {
-	const { copilotkit, executingToolCallIds } = (0, _copilotkit_react_core_v2_context.useCopilotKit)();
+	const { copilotkit, executingToolCallIds } = (0, _copilotkit_react_core_context.useCopilotKit)();
 	const agentId = useCopilotChatConfiguration()?.agentId ?? _copilotkit_shared.DEFAULT_AGENT_ID;
 	const unrenderedToolNames = (0, react.useRef)(/* @__PURE__ */ new Set());
 	const warnedToolNames = (0, react.useRef)(/* @__PURE__ */ new Set());
@@ -1859,7 +1874,7 @@ function useRenderToolCall() {
 }
 
 //#endregion
-//#region src/v2/hooks/use-capabilities.tsx
+//#region src/hooks/use-capabilities.tsx
 /**
 * Returns the capabilities declared by the given agent (or the agent resolved
 * from the surrounding chat configuration, falling back to the default agent).
@@ -1884,7 +1899,7 @@ exports.CopilotChatDefaultLabels = CopilotChatDefaultLabels;
 Object.defineProperty(exports, 'CopilotKitCoreReact', {
   enumerable: true,
   get: function () {
-    return _copilotkit_react_core_v2_context.CopilotKitCoreReact;
+    return _copilotkit_react_core_context.CopilotKitCoreReact;
   }
 });
 exports.UseAgentUpdate = UseAgentUpdate;
@@ -1898,7 +1913,7 @@ exports.useCopilotChatConfiguration = useCopilotChatConfiguration;
 Object.defineProperty(exports, 'useCopilotKit', {
   enumerable: true,
   get: function () {
-    return _copilotkit_react_core_v2_context.useCopilotKit;
+    return _copilotkit_react_core_context.useCopilotKit;
   }
 });
 exports.useFrontendTool = useFrontendTool;