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

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

@@ -1,13 +1,13 @@
-import { CopilotKitContext, CopilotKitCoreReact, useCopilotKit, useCopilotKit as useCopilotKit$1, useDefaultAgentId } from "@copilotkit/react-core/v2/context";
+import { CopilotKitContext, CopilotKitCoreReact, useCopilotKit, useCopilotKit as useCopilotKit$1, useDefaultAgentId } from "@copilotkit/react-core/context";
 import React, { createContext, useCallback, useContext, useEffect, useLayoutEffect, useMemo, useReducer, useRef, useState, useSyncExternalStore } from "react";
 import { DEFAULT_AGENT_ID, partialJSONParse, randomUUID } from "@copilotkit/shared";
 import { Fragment, jsx } from "react/jsx-runtime";
-import { CopilotKitCoreRuntimeConnectionStatus, ProxiedCopilotRuntimeAgent, ToolCallStatus, ɵInterruptState, ɵcreateThreadStore, ɵisHttpAgent, ɵselectFetchMoreError, ɵselectHasNextPage, ɵselectIsFetchingNextPage, ɵselectIsMutating, ɵselectThreads, ɵselectThreadsError, ɵselectThreadsIsLoading } from "@copilotkit/core";
+import { CopilotKitCoreRuntimeConnectionStatus, ProxiedCopilotRuntimeAgent, ToolCallStatus, ɵInterruptState, ɵclearAgentInterruptState, ɵcreateThreadStore, ɵgetAgentInterruptState, ɵisHttpAgent, ɵselectFetchMoreError, ɵselectHasNextPage, ɵselectIsFetchingNextPage, ɵselectIsMutating, ɵselectThreads, ɵselectThreadsError, ɵselectThreadsIsLoading } from "@copilotkit/core";
 import { randomUUID as randomUUID$1 } from "@ag-ui/client";
 import { z } from "zod";
 import { contentToText } from "@ag-ui/core";
 
-//#region src/v2/lib/shallow-stable-ref.ts
+//#region src/lib/shallow-stable-ref.ts
 /**
 * Shallow equality comparison for objects.
 */
@@ -49,7 +49,7 @@ function useShallowStableRef(value) {
 }
 
 //#endregion
-//#region src/v2/providers/CopilotChatConfigurationProvider.tsx
+//#region src/providers/CopilotChatConfigurationProvider.tsx
 const CopilotChatDefaultLabels = {
 	chatInputPlaceholder: "Type a message...",
 	chatInputToolbarStartTranscribeButtonLabel: "Transcribe",
@@ -352,7 +352,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";
@@ -550,7 +550,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
@@ -625,7 +625,7 @@ 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 } = useCopilotKit$1();
 	const depsVersion = useDepsVersion(deps);
@@ -658,7 +658,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 = [];
 /**
@@ -755,7 +755,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.
 *
@@ -823,7 +823,7 @@ 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) {
@@ -916,12 +916,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";
 }
@@ -972,7 +973,6 @@ function useInterrupt(config) {
 	const [handlerResult, setHandlerResult] = useState(null);
 	const interruptStateRef = useRef(new ɵInterruptState());
 	useEffect(() => {
-		const interruptState = interruptStateRef.current;
 		let localLegacy = null;
 		let localStandard = null;
 		const subscription = agent.subscribe({
@@ -985,19 +985,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) ɵclearAgentInterruptState(agent);
 				localLegacy = null;
 				localStandard = null;
-				interruptState.clear();
+				interruptStateRef.current = new ɵInterruptState();
 				setPending(null);
 			},
 			onRunFinalized: () => {
 				if (localStandard && localStandard.length > 0) {
-					interruptState.setStandard(localStandard);
-					setPending(interruptState.pending);
+					interruptStateRef.current = ɵgetAgentInterruptState(agent, localStandard);
+					setPending(interruptStateRef.current.pending);
 				} else if (localLegacy) {
-					interruptState.setLegacy(localLegacy);
-					setPending(interruptState.pending);
+					interruptStateRef.current = new ɵInterruptState();
+					interruptStateRef.current.setLegacy(localLegacy);
+					setPending(interruptStateRef.current.pending);
 				}
 				localLegacy = null;
 				localStandard = null;
@@ -1005,20 +1007,27 @@ function useInterrupt(config) {
 			onRunFailed: () => {
 				localLegacy = null;
 				localStandard = null;
-				interruptState.clear();
+				interruptStateRef.current = new ɵInterruptState();
 				setPending(null);
 			}
 		});
+		interruptStateRef.current = agent.pendingInterrupts?.length ? ɵgetAgentInterruptState(agent) : new ɵInterruptState();
+		setPending(interruptStateRef.current.pending);
 		return () => {
 			subscription.unsubscribe();
-			interruptState.clear();
+			interruptStateRef.current = new ɵInterruptState();
 		};
 	}, [agent]);
+	/** Record an explicit answer and resume once the complete batch is addressed. */
 	const resolve = 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,
@@ -1034,7 +1043,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 ɵInterruptState();
 			setPending(null);
 			return;
 		}
@@ -1052,25 +1061,30 @@ function useInterrupt(config) {
 			});
 		} catch (err) {
 			console.error("[CopilotKit] useInterrupt resolve: runAgent rejected; clearing pending + rethrowing", err);
-			interruptStateRef.current.clear();
+			interruptStateRef.current = new ɵInterruptState();
 			setPending(null);
 			throw err;
 		}
 	}, [agent, copilotkit]);
+	/** Cancel a standard interrupt or dismiss a legacy interrupt locally. */
 	const cancel = 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 ɵ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 ɵInterruptState();
 			setPending(null);
 			return;
 		}
@@ -1088,7 +1102,7 @@ function useInterrupt(config) {
 			});
 		} catch (err) {
 			console.error("[CopilotKit] useInterrupt resolve: runAgent rejected; clearing pending + rethrowing", err);
-			interruptStateRef.current.clear();
+			interruptStateRef.current = new ɵInterruptState();
 			setPending(null);
 			throw err;
 		}
@@ -1103,6 +1117,7 @@ function useInterrupt(config) {
 	resolveRef.current = resolve;
 	const cancelRef = 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;
@@ -1192,7 +1207,7 @@ function useInterrupt(config) {
 }
 
 //#endregion
-//#region src/v2/hooks/use-suggestions.tsx
+//#region src/hooks/use-suggestions.tsx
 function useSuggestions({ agentId } = {}) {
 	const { copilotkit } = useCopilotKit$1();
 	const config = useCopilotChatConfiguration();
@@ -1250,7 +1265,7 @@ 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 } = useCopilotKit$1();
 	const chatConfig = useCopilotChatConfiguration();
@@ -1409,7 +1424,7 @@ 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 } = useCopilotKit$1();
@@ -1434,7 +1449,7 @@ function useAgentContext(context) {
 }
 
 //#endregion
-//#region src/v2/hooks/use-threads.tsx
+//#region src/hooks/use-threads.tsx
 function useThreadStoreSelector(store, selector) {
 	return useSyncExternalStore(useCallback((onStoreChange) => {
 		const subscription = store.select(selector).subscribe(onStoreChange);
@@ -1618,7 +1633,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 ? z.any() : def.args;
 	return {
@@ -1631,7 +1646,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.
 *
@@ -1715,7 +1730,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
@@ -1830,7 +1845,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).