@blocksdiy/react-common 1.51.0 → 1.52.1

package/dist/components/new-agent-chat.d.ts

@@ -1,12 +1,14 @@
 import { type Message, ToolMessage, type UserMessage } from "@ag-ui/client";
 import { useRenderToolCall } from "@copilotkit/react-core/v2";
 import { ReactNode, SetStateAction } from "react";
+import { type ApprovalCardView, type ApprovalDecision } from "../utils/agui-interrupts.js";
 import { type RenderProp } from "../utils/compose-render.js";
 import { type ComposerMessageMeta } from "../utils/composer-message.js";
 import { type MessageRunIds, type RunStartedAt } from "../utils/message-run-ids.js";
 export { useTextGrowthAnimating } from "../hooks/text-growth-animation.js";
 export { type ComposerMessageMeta, FEEDBACK_MESSAGE_NAME, type FeedbackDraft, type FeedbackRate, feedbackComposerMeta, feedbackDraftOf, feedbackMessage, feedbackThreadId, isFeedbackMessage, isFeedbackTag, parseFeedbackContent, parseFeedbackTag, type ParsedFeedback, } from "../utils/composer-message.js";
 export { MESSAGE_RUN_IDS_EVENT_NAME, messageIdsOfRun, type MessageRunIds, type RunStartedAt, } from "../utils/message-run-ids.js";
+export { type ApprovalCardView, type ApprovalDecision, toolStepVisibleBelowCards } from "../utils/agui-interrupts.js";
 export { type Message, type AssistantMessage, type UserMessage } from "@ag-ui/client";
 export { useRenderTool, useDefaultRenderTool, useHumanInTheLoop, useFrontendTool, ToolCallStatus, } from "@copilotkit/react-core/v2";
 export interface Attachment {
@@ -78,11 +80,20 @@ export interface AgentChatContextValue {
     sendMessage: (message: Omit<UserMessage, "id" | "role">) => Promise<void>;
     sendFromInputs: () => Promise<void>;
     reloadMessages: () => Promise<void>;
+    /** @deprecated Answer with `answerInterrupt`; kept for the frozen-copy contract. */
     resolveInterrupt: (resume: unknown) => Promise<boolean>;
     answerInterrupt: (answer: {
         toolCallId: string;
         answer: unknown;
     }) => Promise<void>;
+    /** Approve or reject one waiting request; resumes once every request of the pause has an answer. */
+    decideApproval?: (decision: {
+        interruptId: string;
+        index: number;
+        decision: ApprovalDecision;
+    }) => Promise<void>;
+    /** The approval cards on a transcript tool call: waiting, decided here, or recorded. */
+    approvalCardsFor?: (toolCallId: string) => ApprovalCardView[];
     stopGeneration: () => void;
     addAttachments: (attachments: Attachment[]) => void;
     removeAttachment: (url: string) => void;

package/dist/components/new-agent-chat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"new-agent-chat.d.ts","sourceRoot":"","sources":["../../src/components/new-agent-chat.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"new-agent-chat.d.ts","sourceRoot":"","sources":["../../src/components/new-agent-chat.tsx"],"names":[],"mappings":"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"}

package/dist/components/new-agent-chat.js

@@ -5,13 +5,16 @@ import { CopilotKit, useCopilotChatInternal } from "@copilotkit/react-core";
 import { useCopilotKit, useRenderToolCall } from "@copilotkit/react-core/v2";
 import { createContext, useCallback, useContext, useEffect, useLayoutEffect, useMemo, useRef, useState, } from "react";
 import { useStickToBottom } from "use-stick-to-bottom";
+import { AgentChatOwnRunsContext } from "../hooks/agent-chat-own-runs.js";
 import { readAgentAdminRoles } from "../utils/agent-admin.js";
+import { answerRouteOf, approvalCardsForToolCall, buildResumeEntries, cancelledResumeEntries, dropStamps, forgetOpenInterrupts, INTERRUPT_NOT_OPEN_ERROR, isApprovalRequest, localStampsByAnchor, mergeStamps, needsReconnectAfter, requestKey, requestsOf, respondMessageOf, singleInterruptResume, stampsAfterInterruptReset, toolCallOf, } from "../utils/agui-interrupts.js";
 import { ComposeRender } from "../utils/compose-render.js";
 import { buildArmedMessageContent, userTextOfContent } from "../utils/composer-message.js";
 import { claimRunInput, EMPTY_MESSAGE_RUN_IDS, EMPTY_RUN_STARTED_AT, findMessageGroupElement, mergeEntries, MESSAGE_IDS_ATTRIBUTE, messageIdsOfRun, readMessageRunIdsEvent, readRunStartedAtEvent, } from "../utils/message-run-ids.js";
 export { useTextGrowthAnimating } from "../hooks/text-growth-animation.js";
 export { FEEDBACK_MESSAGE_NAME, feedbackComposerMeta, feedbackDraftOf, feedbackMessage, feedbackThreadId, isFeedbackMessage, isFeedbackTag, parseFeedbackContent, parseFeedbackTag, } from "../utils/composer-message.js";
 export { MESSAGE_RUN_IDS_EVENT_NAME, messageIdsOfRun, } from "../utils/message-run-ids.js";
+export { toolStepVisibleBelowCards } from "../utils/agui-interrupts.js";
 export { useRenderTool, useDefaultRenderTool, useHumanInTheLoop, useFrontendTool, ToolCallStatus, } from "@copilotkit/react-core/v2";
 // Client-only `useLayoutEffect`, falls back to `useEffect` during SSR.
 // Needed so the `agent.threadId` mirror commits before CopilotKit's
@@ -53,35 +56,6 @@ const _collectPendingToolCalls = (messages) => {
     }
     return pending;
 };
-// Message order IS the order of the interrupt's `action_requests`, so decisions
-// pair with them by index and need no ids. Matched by name rather than by "has no
-// local handler", so a backend tool merely mid-flight is never taken for a pause.
-const _SERVER_PAUSE_TOOL_NAME = "ask_user";
-const _SERVER_PAUSE_TOOL_PREFIX = "ask-component-";
-const _isServerPause = (toolCall) => toolCall.function.name === _SERVER_PAUSE_TOOL_NAME || toolCall.function.name.startsWith(_SERVER_PAUSE_TOOL_PREFIX);
-// ONE assistant message's pauses, never the transcript's: the server batches a
-// turn's pauses into a single interrupt requiring exactly one decision each, and a
-// transcript can also hold pauses from a run that died before parking. Counting
-// those raises the count check — permanently, since the checkpoint never advances.
-const _collectServerPauses = (messages) => {
-    const answered = new Set();
-    for (const m of messages) {
-        if (m.role === "tool" && "toolCallId" in m && typeof m.toolCallId === "string") {
-            answered.add(m.toolCallId);
-        }
-    }
-    for (let i = messages.length - 1; i >= 0; i--) {
-        const m = messages[i];
-        if (m.role !== "assistant" || !("toolCalls" in m) || !m.toolCalls) {
-            continue;
-        }
-        const pauses = m.toolCalls.filter((toolCall) => !answered.has(toolCall.id) && _isServerPause(toolCall));
-        if (pauses.length > 0) {
-            return pauses;
-        }
-    }
-    return [];
-};
 // CopilotKit 1.60.x: `connectAgent()` awaits every replayed HITL tool call's
 // handler before resolving `isAvailable`, and a `useHumanInTheLoop` handler
 // only resolves on `respond()` — so a transcript replayed with an unanswered
@@ -91,6 +65,14 @@ const _collectServerPauses = (messages) => {
 const isConnectParkedOnPendingToolCall = (messages) => {
     return messages.length > 0 && _collectPendingToolCalls(messages).length > 0;
 };
+const EMPTY_INTERRUPTS = [];
+const EMPTY_ANSWERS = new Map();
+const EMPTY_STAMPS = new Map();
+const EMPTY_REQUESTS = [];
+// What @ag-ui/client tracks as open: the source of truth for what a send must
+// address. The chat writes the field only through `resetInterrupts`, its one writer:
+// on a thread swap and before every connect we start (CopilotKit 1.70.2 never clears it).
+const openInterruptsOf = (agent) => agent?.pendingInterrupts ?? EMPTY_INTERRUPTS;
 const validateAndConvertFiles = (files) => {
     if (files.length === 0) {
         return null;
@@ -318,6 +300,29 @@ const ChatInitializer = ({ agentBlock, agentChatBlock, chatId, token, appId, com
     const [runStartedAt, setRunStartedAt] = useState(EMPTY_RUN_STARTED_AT);
     const liveRunRef = useRef(null);
     const ownRunIdsRef = useRef(new Set());
+    // Paired once, when the pause arrives: while the next run streams, a sub-agent's own
+    // calls arrive as the parent's and would re-pair the request with them -- a second
+    // card on the parent's call.
+    const [interruptRequests, setInterruptRequests] = useState(EMPTY_REQUESTS);
+    // One answer per request (`requestKey`). The ref is the truth (two clicks in one
+    // tick); the state copy re-renders the cards.
+    const keyedAnswersRef = useRef(new Map());
+    const [interruptAnswers, setInterruptAnswers] = useState(EMPTY_ANSWERS);
+    const [localApprovals, setLocalApprovals] = useState(EMPTY_STAMPS);
+    // The agent's own `pendingInterrupts` too: CopilotKit 1.70.2 keeps it across a
+    // thread swap, and @ag-ui/client 0.0.59 would refuse the next connect.
+    // ONE source: @ag-ui/client writes the field on RUN_FINISHED and
+    // `onRunFinalized` pairs its requests into `interruptRequests`; this is the only place
+    // the chat writes it, and it clears the pairing in the same breath.
+    const resetInterrupts = useCallback(({ keepStamps = false } = {}) => {
+        forgetOpenInterrupts(copilotAgent);
+        setInterruptRequests(EMPTY_REQUESTS);
+        keyedAnswersRef.current.clear();
+        setInterruptAnswers(EMPTY_ANSWERS);
+        setLocalApprovals((previous) => stampsAfterInterruptReset(previous, { keepStamps }));
+    }, [copilotAgent]);
+    // Runs this chat started that no send accounted for (AgentChatOwnRunsContext).
+    const [ownRunsWithoutSend, setOwnRunsWithoutSend] = useState(0);
     useEffect(() => {
         if (!copilotAgent) {
             return;
@@ -349,6 +354,9 @@ const ChatInitializer = ({ agentBlock, agentChatBlock, chatId, token, appId, com
             onToolCallStartEvent: ({ event }) => claimLive(event.parentMessageId ?? event.toolCallId),
             onRunFinalized: () => {
                 liveRunRef.current = null;
+                // The agent's own field, which @ag-ui/client has set on RUN_FINISHED by now (pinned
+                // in agui-interrupts.spec) -- live runs and connects alike; a RUN_ERROR leaves it.
+                setInterruptRequests(requestsOf(openInterruptsOf(copilotAgent), copilotAgent.messages));
             },
             onCustomEvent: ({ event }) => {
                 const runIds = readMessageRunIdsEvent(event);
@@ -366,7 +374,6 @@ const ChatInitializer = ({ agentBlock, agentChatBlock, chatId, token, appId, com
             liveRunRef.current = null;
         };
     }, [copilotAgent]);
-    const interruptAnswersRef = useRef(new Map());
     // Mirror `currentThreadId` onto the agent instance — the `<CopilotKit>`
     // prop only feeds React context, but `agent.threadId` is what hits the
     // wire and the LangGraph checkpoint. `<CopilotChat>` does this for you;
@@ -380,8 +387,8 @@ const ChatInitializer = ({ agentBlock, agentChatBlock, chatId, token, appId, com
         }
         // Carrying answers across a thread swap would pair them with another
         // conversation's pause.
-        interruptAnswersRef.current.clear();
-    }, [copilotAgent, currentThreadId]);
+        resetInterrupts();
+    }, [copilotAgent, currentThreadId, resetInterrupts]);
     const [prompt, setPrompt] = useState("");
     const [attachments, setAttachments] = useState([]);
     const [composerMessageMeta, setComposerMessageMeta] = useState(null);
@@ -404,6 +411,7 @@ const ChatInitializer = ({ agentBlock, agentChatBlock, chatId, token, appId, com
         setPrompt("");
         setAttachments([]);
         setComposerMessageMeta(null);
+        resetInterrupts();
         setOwnRunInFlight(false);
         const detachable = copilotAgent;
         const drained = detachable?.detachActiveRun?.();
@@ -427,18 +435,25 @@ const ChatInitializer = ({ agentBlock, agentChatBlock, chatId, token, appId, com
         }
         copilotAgent.setState?.({});
         copilotAgent.clearReplayCursor?.(currentThreadId);
+        // Answers and decided-here stamps too; the connect re-sends what is open.
+        resetInterrupts();
         void copilotkit.connectAgent({ agent: copilotAgent }).catch(() => undefined);
-    }, [chatId, currentThreadId, copilotAgent, copilotkit]);
+    }, [chatId, currentThreadId, copilotAgent, copilotkit, resetInterrupts]);
     const [isDraggingFiles, setIsDraggingFiles] = useState(false);
     const attachmentsEnabled = agentChat ? agentChat.disableAttachments !== true : false;
     const canSendMessage = Boolean(agentChatBlock && agentChat && agent && isConfigLoaded && isAgentReady && !isAgentRunning && !isRunningElsewhere);
     const isFetchingMessages = !isConfigLoaded || (!isAgentReady && copilotMessages.length === 0);
     const isThinking = (isAgentRunning || isRunningElsewhere) && !isFetchingMessages && isAgentReady;
-    const runAgentWithRetry = useCallback(async (agentToRun, messageCountAtRunStart, forwardedProps) => {
+    const runAgentWithRetry = useCallback(async (agentToRun, messageCountAtRunStart, forwardedProps, resume, withoutSend = false) => {
         // A run elsewhere is on this conversation's checkpoint too: ours would race it.
         if (agentToRun.isRunning || isRunningElsewhereRef.current) {
             return false;
         }
+        // A turn on the server like any run; a send accounts for its own (onUserMessageSent).
+        if (withoutSend) {
+            setOwnRunsWithoutSend((count) => count + 1);
+        }
+        let finished = false;
         const runAgentAndThrowError = async () => {
             let runEventError;
             const { unsubscribe } = agentToRun.subscribe({
@@ -448,9 +463,12 @@ const ChatInitializer = ({ agentBlock, agentChatBlock, chatId, token, appId, com
                 onRunErrorEvent: (event) => {
                     runEventError = event;
                 },
+                onRunFinishedEvent: () => {
+                    finished = true;
+                },
             });
             try {
-                await copilotkit.runAgent({ agent: agentToRun, forwardedProps });
+                await copilotkit.runAgent({ agent: agentToRun, forwardedProps, ...(resume ? { resume } : {}) });
                 if (runEventError) {
                     throw runEventError;
                 }
@@ -462,26 +480,41 @@ const ChatInitializer = ({ agentBlock, agentChatBlock, chatId, token, appId, com
         // In flight until the run ends, whichever way (see `runningElsewhereRunId`) — unless
         // the conversation switched under it, which resets this itself.
         const ranOn = prevConversationKeyRef.current;
+        let reconnected = false;
         setOwnRunInFlight(true);
         try {
             await runAgentAndThrowError();
-            return true;
         }
         catch (error) {
             const hasAgentStartedResponding = agentToRun.messages.length > messageCountAtRunStart;
             const status = getAgentRunErrorStatus(error);
-            if (status !== undefined && status >= 500 && status < 600 && !hasAgentStartedResponding) {
+            // Never re-sent blind when it carried a resume: the server may already have consumed
+            // it. The reconnect below re-reads what is open instead.
+            if (!resume && status !== undefined && status >= 500 && status < 600 && !hasAgentStartedResponding) {
                 await runAgentAndThrowError();
-                return true;
             }
-            throw error;
+            else {
+                throw error;
+            }
         }
         finally {
-            if (prevConversationKeyRef.current === ranOn) {
+            const stillHere = prevConversationKeyRef.current === ranOn;
+            if (stillHere) {
                 setOwnRunInFlight(false);
             }
+            if (stillHere && needsReconnectAfter(Boolean(resume), finished)) {
+                // A RUN_ERROR, a stop or a dropped stream leaves @ag-ui/client's
+                // `pendingInterrupts` as they were, possibly consumed: every later send would be
+                // refused. Forget them and reconnect; the connect re-sends what is really open.
+                resetInterrupts();
+                agentToRun.clearReplayCursor?.(currentThreadId);
+                await copilotkit.connectAgent({ agent: agentToRun }).catch(() => undefined);
+                reconnected = true;
+            }
         }
-    }, [copilotkit]);
+        // A reconnected run did not take effect as sent: callers must not record it as done.
+        return !reconnected;
+    }, [copilotkit, currentThreadId, resetInterrupts]);
     const sendMessage = useCallback(async (message) => {
         if (!canSendMessage || !copilotAgent || copilotAgent.isRunning || isRunningElsewhereRef.current) {
             return;
@@ -490,71 +523,157 @@ const ChatInitializer = ({ agentBlock, agentChatBlock, chatId, token, appId, com
         if (onUserMessageSent) {
             onUserMessageSent(userTextOfContent(message.content), message);
         }
-        await runAgentWithRetry(copilotAgent, copilotAgent.messages.length);
+        // Typing while the turn is parked sends the message
+        // (already added above, with its own id and attachments) as a normal message,
+        // plus a payload-less `cancelled` entry for every open interrupt --
+        // @ag-ui/client refuses to send at all unless every open interrupt is
+        // addressed. The server rejects every waiting approval (one approved here but
+        // not yet sent included), skips every question with one fixed marker, and
+        // keeps the message after them. A send that fails reconnects (runAgentWithRetry).
+        const interrupts = openInterruptsOf(copilotAgent);
+        if (interrupts.length === 0) {
+            await runAgentWithRetry(copilotAgent, copilotAgent.messages.length);
+            return;
+        }
+        const requests = requestsOf(interrupts, copilotAgent.messages);
+        const rejected = new Map(requests.filter(isApprovalRequest).map((request) => [request.key, { type: "reject" }]));
+        // Shown as decided for the whole run, as a click is (see submitInterruptAnswers):
+        // approvals rejected, questions closed too (they get the skip marker), so no card
+        // reads "waiting for your decision on the other request". The ref stays empty so
+        // no card can send.
+        keyedAnswersRef.current.clear();
+        setInterruptAnswers(new Map(requests.map((request) => [request.key, rejected.get(request.key) ?? { type: "respond", message: null }])));
+        const decided = localStampsByAnchor(requests, rejected);
+        setLocalApprovals((previous) => mergeStamps(previous, decided));
+        let resumed = false;
+        try {
+            resumed = await runAgentWithRetry(copilotAgent, copilotAgent.messages.length, undefined, cancelledResumeEntries(interrupts));
+        }
+        finally {
+            if (!resumed) {
+                setLocalApprovals((previous) => dropStamps(previous, decided));
+            }
+            setInterruptAnswers(EMPTY_ANSWERS);
+        }
     }, [canSendMessage, copilotAgent, runAgentWithRetry, onUserMessageSent]);
     const reloadMessages = useCallback(async () => {
         if (!copilotAgent || copilotAgent.isRunning) {
             return;
         }
         copilotAgent.clearReplayCursor?.(currentThreadId);
+        // Answers too; the connect re-sends what is open. The decided-here stamps stay: on the
+        // same thread they bridge the card until the connect's snapshot brings the record.
+        resetInterrupts({ keepStamps: true });
         await copilotkit.connectAgent({ agent: copilotAgent }).catch(() => undefined);
-    }, [copilotAgent, copilotkit, currentThreadId]);
-    // Not sourced from `useInterrupt`: that hook only hands `resolve` to its own
-    // `render`, which it skips whenever nothing is pending — so after a reload there
-    // is no way to obtain it. `runAgentWithRetry`'s `isRunning` guard makes a
-    // double-click a no-op rather than a duplicate resume.
+    }, [copilotAgent, copilotkit, currentThreadId, resetInterrupts]);
+    // Deprecated: no renderer calls it, and ChatComponentPreview stubs
+    // it. The context field stays for the frozen-copy contract; a `{decisions}` payload now
+    // goes to the ONE open interrupt through the standard `resume[]`.
     const resolveInterrupt = useCallback(async (resume) => {
         if (!copilotAgent) {
             return false;
         }
-        return runAgentWithRetry(copilotAgent, copilotAgent.messages.length, { command: { resume } });
+        const entries = singleInterruptResume(openInterruptsOf(copilotAgent), resume);
+        if (!entries) {
+            throw new Error(INTERRUPT_NOT_OPEN_ERROR);
+        }
+        return runAgentWithRetry(copilotAgent, copilotAgent.messages.length, undefined, entries, true);
     }, [copilotAgent, runAgentWithRetry]);
-    // Resumes only once EVERY pause of the turn has an answer: a short decisions list
-    // fails `HumanInTheLoopMiddleware`'s count check, and the checkpoint never
-    // advances, so every later answer fails identically.
-    const answerInterrupt = useCallback(async ({ toolCallId, answer }) => {
+    // Resumes once EVERY request of every open interrupt has an answer: the server
+    // refuses a partial resume.
+    const submitInterruptAnswers = useCallback(async () => {
         if (!copilotAgent) {
             return;
         }
-        const pauses = _collectServerPauses(copilotAgent.messages);
-        // Thrown, never returned: a caller resets its submitting state on a rejection,
-        // while a silent return leaves the card locked with the answer discarded.
-        if (!pauses.some((toolCall) => toolCall.id === toolCallId)) {
-            throw new Error(`answerInterrupt: ${toolCallId} is not a pending pause of this turn`);
-        }
-        const answers = interruptAnswersRef.current;
-        answers.set(toolCallId, answer);
-        const unanswered = pauses.filter((toolCall) => !answers.has(toolCall.id));
-        if (unanswered.length > 0) {
+        const interrupts = openInterruptsOf(copilotAgent);
+        const requests = requestsOf(interrupts, copilotAgent.messages);
+        const answers = keyedAnswersRef.current;
+        const resume = buildResumeEntries(interrupts, requests, answers);
+        if (!resume) {
             return;
         }
-        const decisions = pauses.map((toolCall) => ({
-            type: "respond",
-            // `?? null` because a component may call `respond()` with no payload, and
-            // `JSON.stringify(undefined)` drops the key, which raises server-side.
-            message: JSON.stringify(answers.get(toolCall.id) ?? null),
-        }));
         const sent = new Map(answers);
         answers.clear();
-        const restore = () => sent.forEach((value, id) => answers.set(id, value));
+        // Stamped before the run: once the run streams, the call stops waiting and the live
+        // request no longer pairs with it, so without the stamp the card vanishes until the
+        // run ends and then comes back lower.
+        const decided = localStampsByAnchor(requests, sent);
+        setLocalApprovals((previous) => mergeStamps(previous, decided));
         let resumed = false;
         try {
-            // Every answer goes back, not just this call's, or a resume that never
-            // happened discards the rest of the turn's cards with it.
-            resumed = await resolveInterrupt({ decisions });
+            resumed = await runAgentWithRetry(copilotAgent, copilotAgent.messages.length, undefined, resume, true);
         }
         catch (error) {
-            restore();
+            // Sent and failed (a refused resume, a server error): runAgentWithRetry already
+            // reconnected, so the cards show what is really open.
+            // Restoring the answers would show "Approved" for a decision that never took
+            // effect.
+            setLocalApprovals((previous) => dropStamps(previous, decided));
+            setInterruptAnswers(EMPTY_ANSWERS);
             throw error;
         }
         if (!resumed) {
-            // A run was already in flight, so nothing was sent: `isThinking` lags
-            // `agent.isRunning` by a commit, which leaves `respond` live for a moment
-            // after a run starts.
-            restore();
-            throw new Error("answerInterrupt: a run was already in flight; answer kept for retry");
+            // Nothing was sent (a run already in flight), or the run did not finish and the
+            // chat reloaded what is open. Clear the answers, as on an error: restoring them
+            // would lock every card on "Approved"/"Rejected" with no way to resend until the
+            // user typed or reloaded. The cards go back to waiting, and the next click sends.
+            setLocalApprovals((previous) => dropStamps(previous, decided));
+            setInterruptAnswers(EMPTY_ANSWERS);
+            throw new Error("answerInterrupt: the answer did not go through; the chat shows what is still open");
+        }
+        setInterruptAnswers(EMPTY_ANSWERS);
+    }, [copilotAgent, runAgentWithRetry]);
+    const decideApproval = useCallback(async ({ interruptId, index, decision }) => {
+        keyedAnswersRef.current.set(requestKey(interruptId, index), { type: decision });
+        setInterruptAnswers(new Map(keyedAnswersRef.current));
+        await submitInterruptAnswers();
+    }, [submitInterruptAnswers]);
+    const approvalCardsFor = useCallback((toolCallId) => {
+        const call = toolCallOf(copilotMessages, toolCallId);
+        const toolMessage = toolMessages.find((message) => message.toolCallId === toolCallId);
+        return approvalCardsForToolCall({
+            toolCallId,
+            toolName: call?.name ?? "",
+            toolArgs: call?.args,
+            toolResult: typeof toolMessage?.content === "string" ? toolMessage.content : null,
+            toolMessage,
+            requests: interruptRequests,
+            answers: interruptAnswers,
+            localStamps: localApprovals,
+        });
+    }, [copilotMessages, toolMessages, interruptRequests, interruptAnswers, localApprovals]);
+    // One path for every question card. Every renderer -- the frozen registry copies
+    // included -- calls this with the same signature. The answer goes to the open request its
+    // card pairs with (by order) and resumes through `resume[]` once every request has one.
+    // The welcome seed, which has no interrupt,
+    // becomes its call's tool result and a normal run. Anything else throws, never falls
+    // back: the card resets and stays waiting, and typing still works.
+    const answerInterrupt = useCallback(async ({ toolCallId, answer }) => {
+        if (!copilotAgent) {
+            return;
+        }
+        const route = answerRouteOf(openInterruptsOf(copilotAgent), copilotAgent.messages, toolCallId);
+        if (route.kind === "respond") {
+            keyedAnswersRef.current.set(route.request.key, { type: "respond", message: answer });
+            setInterruptAnswers(new Map(keyedAnswersRef.current));
+            await submitInterruptAnswers();
+            return;
         }
-    }, [copilotAgent, resolveInterrupt]);
+        if (route.kind === "refuse") {
+            throw new Error(INTERRUPT_NOT_OPEN_ERROR);
+        }
+        // The welcome seed: the call's tool result, then an ordinary run --
+        // no resume, nothing parked on the server. A run that fails keeps the answer, like
+        // a typed message whose run failed.
+        const seedAnswerId = generateId();
+        copilotAgent.addMessage({ id: seedAnswerId, role: "tool", toolCallId, content: respondMessageOf(answer) });
+        const sent = await runAgentWithRetry(copilotAgent, copilotAgent.messages.length, undefined, undefined, true);
+        if (!sent) {
+            // Nothing went out (a run already in flight): take the answer back so the card can send again.
+            copilotAgent.setMessages?.(copilotAgent.messages.filter((message) => message.id !== seedAnswerId));
+            throw new Error("answerInterrupt: a run was already in flight; answer not sent");
+        }
+    }, [copilotAgent, runAgentWithRetry, submitInterruptAnswers]);
     const stopGeneration = useCallback(() => {
         copilotStopGeneration();
         copilotAgent?.abortRun?.();
@@ -825,6 +944,8 @@ const ChatInitializer = ({ agentBlock, agentChatBlock, chatId, token, appId, com
             reloadMessages,
             resolveInterrupt,
             answerInterrupt,
+            decideApproval,
+            approvalCardsFor,
             stopGeneration,
             addAttachments,
             removeAttachment,
@@ -845,7 +966,7 @@ const ChatInitializer = ({ agentBlock, agentChatBlock, chatId, token, appId, com
             components: components ?? [],
             componentsLoading,
             currentThreadId,
-        }, children: children }));
+        }, children: _jsx(AgentChatOwnRunsContext.Provider, { value: ownRunsWithoutSend, children: children }) }));
 };
 export const AgentChatRoot = ({ ...props
 // agentChatData,
@@ -1007,6 +1128,7 @@ export const AgentChatRoot = ({ ...props
             noPersistency,
             chatContext: chatContextStr,
             chatContextFiles,
+            supportsInterruptOutcome: true,
             ...(selfEditEnabled ? { selfEditEnabled: true } : {}),
             ...(supportsServerInterrupt ? { supportsServerInterrupt: true } : {}),
             ...(serverInterruptComponentIds.length ? { serverInterruptComponentIds } : {}),

package/dist/hooks/agent-chat-own-runs.d.ts

@@ -0,0 +1,3 @@
+/** Runs this chat started that no send accounted for; null outside a chat root. */
+export declare const AgentChatOwnRunsContext: import("react").Context<number | null>;
+//# sourceMappingURL=agent-chat-own-runs.d.ts.map

package/dist/hooks/agent-chat-own-runs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-chat-own-runs.d.ts","sourceRoot":"","sources":["../../src/hooks/agent-chat-own-runs.ts"],"names":[],"mappings":"AAQA,mFAAmF;AACnF,eAAO,MAAM,uBAAuB,wCAAqC,CAAC"}

package/dist/hooks/agent-chat-own-runs.js

@@ -0,0 +1,8 @@
+// The chat root → conversation bridge for runs no send accounts for. The server counts a turn
+// per run, the chat's send seam (onUserMessageSent) one per send; a resume (an approval, an
+// answered question) is a run with no send. The chat root provides how many such runs it has
+// started; useAgentConversation accounts each as this client's own turn. Its own module so
+// the threads entry does not pull in the chat runtime.
+import { createContext } from "react";
+/** Runs this chat started that no send accounted for; null outside a chat root. */
+export const AgentChatOwnRunsContext = createContext(null);

package/dist/hooks/use-agent-conversation.d.ts

@@ -67,6 +67,11 @@ export declare const accountedTurnsAfterRow: (accounted: AccountedTurns | null,
  * starts the count, so the row that lands for it is read as this send's, not a foreign turn.
  */
 export declare const accountedTurnsAfterOwnSend: (accounted: AccountedTurns | null, key: string, isDraft: boolean) => AccountedTurns | null;
+/**
+ * The accounting after this client starts `runs` runs on `key` that no send accounted for (a
+ * resume: an approval, an answered question). Each is a turn on the server, as a send is.
+ */
+export declare const accountedTurnsAfterOwnRuns: (accounted: AccountedTurns | null, key: string, isDraft: boolean, runs: number) => AccountedTurns | null;
 /** The chat runtime's side of the bridge — a subset of react-common's AgentChatContextValue. */
 export interface AgentConversationChat {
     isThinking: boolean;
@@ -97,7 +102,8 @@ export interface UseAgentConversationResult {
 /**
  * Keeps the index and the transcript agreeing for the open conversation:
  * - a run on it this client is not streaming (the listed row's `runningRunId`) reads as the chat's own;
- * - a turn this client did not send (`turnCount` ahead of what it accounted for) replays the transcript;
+ * - a turn this client did not make (`turnCount` ahead of what it accounted for: its sends, and
+ *   the runs the chat root started without one) replays the transcript;
  * - a run mark past the stale ceiling asks the server again (the settle publishes no event);
  * - refocus re-walks the list (realtime has no replay), throttled.
  */

package/dist/hooks/use-agent-conversation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-agent-conversation.d.ts","sourceRoot":"","sources":["../../src/hooks/use-agent-conversation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"use-agent-conversation.d.ts","sourceRoot":"","sources":["../../src/hooks/use-agent-conversation.ts"],"names":[],"mappings":"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"}

package/dist/hooks/use-agent-conversation.js

@@ -2,8 +2,9 @@
 // (useAgentThreads) and the chat runtime (useAgentChat): which conversation is selected and
 // how a draft becomes a thread; the conversation's row; and the bridge that keeps the index
 // and the transcript agreeing. UI-free — the agent-layout registry item renders it.
-import { useCallback, useEffect, useRef, useState } from "react";
+import { useCallback, useContext, useEffect, useRef, useState } from "react";
 import { FEEDBACK_MESSAGE_NAME } from "../utils/composer-message.js";
+import { AgentChatOwnRunsContext } from "./agent-chat-own-runs.js";
 import { agentThreadKey } from "./agent-thread-live-update.js";
 export const newDraftSelection = (chatId, draftThreadId = crypto.randomUUID()) => ({
     conversation: { chatId, chatThreadId: draftThreadId },
@@ -106,10 +107,22 @@ export const accountedTurnsAfterOwnSend = (accounted, key, isDraft) => {
     }
     return isDraft ? { key, turns: 1 } : accounted;
 };
+/**
+ * The accounting after this client starts `runs` runs on `key` that no send accounted for (a
+ * resume: an approval, an answered question). Each is a turn on the server, as a send is.
+ */
+export const accountedTurnsAfterOwnRuns = (accounted, key, isDraft, runs) => {
+    let next = accounted;
+    for (let run = 0; run < runs; run++) {
+        next = accountedTurnsAfterOwnSend(next, key, isDraft);
+    }
+    return next;
+};
 /**
  * Keeps the index and the transcript agreeing for the open conversation:
  * - a run on it this client is not streaming (the listed row's `runningRunId`) reads as the chat's own;
- * - a turn this client did not send (`turnCount` ahead of what it accounted for) replays the transcript;
+ * - a turn this client did not make (`turnCount` ahead of what it accounted for: its sends, and
+ *   the runs the chat root started without one) replays the transcript;
  * - a run mark past the stale ceiling asks the server again (the settle publishes no event);
  * - refocus re-walks the list (realtime has no replay), throttled.
  */
@@ -177,9 +190,20 @@ export const useAgentConversation = ({ threads, agentId, conversation, isDraft,
         window.addEventListener("focus", onFocus);
         return () => window.removeEventListener("focus", onFocus);
     }, [refresh]);
-    // Turns this client did not send (see accountedTurnsAfterRow). `isThinking` is a dependency,
+    // Turns this client did not make (see accountedTurnsAfterRow). `isThinking` is a dependency,
     // so this runs again the moment a run on the conversation settles.
     const accountedTurnsRef = useRef(null);
+    // The chat root's runs without a send, accounted before the row effect below reads a settle.
+    const ownRunsWithoutSend = useContext(AgentChatOwnRunsContext);
+    const seenOwnRunsRef = useRef(ownRunsWithoutSend);
+    useEffect(() => {
+        const seen = seenOwnRunsRef.current;
+        seenOwnRunsRef.current = ownRunsWithoutSend;
+        if (seen === null || ownRunsWithoutSend === null || ownRunsWithoutSend <= seen) {
+            return;
+        }
+        accountedTurnsRef.current = accountedTurnsAfterOwnRuns(accountedTurnsRef.current, conversationKey, isDraft, ownRunsWithoutSend - seen);
+    }, [ownRunsWithoutSend, conversationKey, isDraft]);
     useEffect(() => {
         if (!knownRow) {
             return;

package/dist/utils/agui-interrupts.d.ts

@@ -0,0 +1,179 @@
+/**
+ * What a parked agent turn waits on, and how the chat answers it.
+ *
+ * The server ends a parked run with the AG-UI standard `RUN_FINISHED.outcome`
+ * (`{type: "interrupt", interrupts}`), live and on connect. Each interrupt carries
+ * HumanInTheLoopMiddleware's requests in `metadata.langgraph.raw` -- name, args and
+ * description, no ids. One model step batches ask_user and approvals into ONE
+ * interrupt, and two paused sub-agents are two interrupts, so the chat collects one
+ * answer per request and resumes once with `resume[]`.
+ *
+ * Cards pair with tool calls BY ORDER, as ask_user cards already do:
+ * the middleware builds its requests in the waiting message's tool-call order, so
+ * the i-th request of a name is the i-th unanswered call of that name. A request
+ * with no such call belongs to a sub-agent, whose calls the parent transcript does
+ * not show: it hangs on the waiting `task` call. The server pairs the same way
+ * (wf-actions-py `hitl_pairing`). A wrong match can only misplace a card: the card
+ * draws the request's own name and args, and decisions stay positional.
+ *
+ * A past decision comes back on the tool message as `metadata["blocks.toolApprovals"]`.
+ * Who decided and when is a server-side audit record and is never shown.
+ */
+import type { Interrupt, Message, ResumeEntry } from "@ag-ui/client";
+export declare const TOOL_APPROVALS_METADATA_KEY = "blocks.toolApprovals";
+export declare const APPROVAL_STATUS_LINE: {
+    readonly waiting: "Waiting for approval";
+    readonly approved: "Approved";
+    readonly rejected: "Rejected";
+};
+/** Appended to a decided card's status while another request of the pause is open. */
+export declare const WAITING_FOR_OTHER_SUFFIX = " \u00B7 waiting for your decision on the other request";
+export type ApprovalDecision = "approve" | "reject";
+export type InterruptAnswer = {
+    type: "respond";
+    message: unknown;
+} | {
+    type: ApprovalDecision;
+};
+export interface InterruptRequest {
+    interruptId: string;
+    index: number;
+    key: string;
+    name: string;
+    args: Record<string, unknown>;
+    allowedDecisions: string[];
+    /** The parent transcript call this request paired with; null for a sub-agent's request. */
+    toolCallId: string | null;
+    /** The transcript call the card hangs on: the call itself, or the waiting `task` call. */
+    anchorToolCallId: string | null;
+    /** The tool's describe name (`InsertItemsToTasksTable`); `name` is lowercased for the model. */
+    displayName: string | null;
+}
+export interface ToolApprovalStamp {
+    toolCallId: string;
+    decision: ApprovalDecision;
+    toolName: string;
+    /** Absent on records written before display names. */
+    displayName?: string | null;
+    args: Record<string, unknown>;
+}
+export interface ApprovalCardView {
+    key: string;
+    title: string;
+    /** The tool input as given; the cards show it as YAML. */
+    args: Record<string, unknown>;
+    status: "waiting" | "approved" | "rejected";
+    statusLine: string;
+    /** Set only while this card can still be decided. */
+    request: {
+        interruptId: string;
+        index: number;
+    } | null;
+    /** Decided here but not sent yet: another card of the same pause is still open. */
+    waitingForOthers: boolean;
+}
+export declare const requestKey: (interruptId: string, index: number) => string;
+/**
+ * Every request of the open interrupts, in the order the server needs decisions,
+ * each paired with its transcript call by order.
+ */
+export declare const requestsOf: (interrupts: readonly Interrupt[], messages: readonly Message[]) => InterruptRequest[];
+export declare const isApprovalRequest: (request: InterruptRequest) => boolean;
+/** Thrown with fixed text when an answer pairs with no open interrupt and is not the welcome seed. */
+export declare const INTERRUPT_NOT_OPEN_ERROR = "answerInterrupt: nothing is waiting for this answer";
+/**
+ * A question's answer as HumanInTheLoopMiddleware's `respond` message -- and as the welcome
+ * seed's tool result, so both read the same. `?? null`: JSON.stringify(undefined) drops the
+ * key, which the server refuses.
+ */
+export declare const respondMessageOf: (answer: unknown) => string;
+/**
+ * The welcome seed (`initialUserChoices`): connect writes an ask_user call that no run made,
+ * so nothing is parked behind it. Its signature is the one the server used
+ * (`answer_orphan_pause`): no user message yet, and the call still waits on the newest
+ * assistant message.
+ */
+export declare const isWelcomeSeedCall: (messages: readonly Message[], toolCallId: string) => boolean;
+type AnswerRoute = {
+    kind: "respond";
+    request: InterruptRequest;
+} | {
+    kind: "seed";
+} | {
+    kind: "refuse";
+};
+/**
+ * Where a question card's answer goes: the open request it pairs with by order; the seed's
+ * tool result when nothing is open; otherwise nowhere -- the caller
+ * throws INTERRUPT_NOT_OPEN_ERROR. Never `command.resume`.
+ */
+export declare const answerRouteOf: (interrupts: readonly Interrupt[], messages: readonly Message[], toolCallId: string) => AnswerRoute;
+/**
+ * The deprecated `resolveInterrupt(resume)`: a `{decisions}` payload for the ONE
+ * open interrupt, as a standard resolved entry. Null when it cannot be routed.
+ */
+export declare const singleInterruptResume: (interrupts: readonly Interrupt[], payload: unknown) => ResumeEntry[] | null;
+/**
+ * After a run that carried `resume[]`: anything but RUN_FINISHED (a RUN_ERROR such as a refused
+ * resume, a stop, a dropped stream) may have consumed the resume on the server, while
+ * @ag-ui/client changes `pendingInterrupts` only on RUN_FINISHED. The chat then forgets them and
+ * reconnects; the connect re-sends what is really open.
+ */
+export declare const needsReconnectAfter: (sentResume: boolean, finished: boolean) => boolean;
+/** One `resolved` entry per open interrupt, or null while any request is unanswered. */
+export declare const buildResumeEntries: (interrupts: readonly Interrupt[], requests: readonly InterruptRequest[], answers: ReadonlyMap<string, InterruptAnswer>) => ResumeEntry[] | null;
+/**
+ * Typing while the turn is parked: the typed text goes out as a normal
+ * message, and each open interrupt gets the protocol's own `cancelled` entry, with no payload.
+ * The server rejects every waiting approval with the standard text, skips every question with
+ * one fixed marker, and appends the message after them.
+ */
+export declare const cancelledResumeEntries: (interrupts: readonly Interrupt[]) => ResumeEntry[];
+/**
+ * Forgets the agent's open interrupts. CopilotKit 1.70.2 keeps
+ * `pendingInterrupts` across a thread swap and a reconnect, and @ag-ui/client 0.0.59
+ * then refuses the next run AND connect ("Thread has N pending interrupt(s) not
+ * addressed by resume"). Call it on a thread swap and right before every connect
+ * the chat starts; the connect's own RUN_FINISHED re-sends what is still open.
+ */
+export declare const forgetOpenInterrupts: (agent: unknown) => void;
+/** This browser's own approval decisions, by anchor, until a reload brings the record. */
+export declare const localStampsByAnchor: (requests: readonly InterruptRequest[], answers: ReadonlyMap<string, InterruptAnswer>) => Map<string, ToolApprovalStamp[]>;
+export declare const mergeStamps: (previous: ReadonlyMap<string, ToolApprovalStamp[]>, next: ReadonlyMap<string, ToolApprovalStamp[]>) => ReadonlyMap<string, ToolApprovalStamp[]>;
+/**
+ * The decided-here stamps after the chat forgets what is open. A same-thread reload keeps them:
+ * the connect's snapshot brings the record, and until it lands nothing else draws the card. A
+ * thread or chat swap, or a reconnect after a failed run, clears them.
+ */
+export declare const stampsAfterInterruptReset: (previous: ReadonlyMap<string, ToolApprovalStamp[]>, { keepStamps }: {
+    keepStamps: boolean;
+}) => ReadonlyMap<string, ToolApprovalStamp[]>;
+/** Takes back exactly the stamps `mergeStamps` added (by identity), when their send did not go through. */
+export declare const dropStamps: (previous: ReadonlyMap<string, ToolApprovalStamp[]>, added: ReadonlyMap<string, ToolApprovalStamp[]>) => ReadonlyMap<string, ToolApprovalStamp[]>;
+export declare const toolApprovalsOf: (message: unknown) => ToolApprovalStamp[];
+/** `insert_items_in_orders` → `insert items in orders`. */
+export declare const toolWords: (name: string) => string;
+export declare const toolCallOf: (messages: readonly Message[], toolCallId: string) => {
+    name: string;
+    args: Record<string, unknown>;
+} | null;
+export declare const approvalCardsForToolCall: ({ toolCallId, toolName, toolArgs, toolResult, toolMessage, requests, answers, localStamps, }: {
+    toolCallId: string;
+    /** The transcript call the card hangs on (`task` for a sub-agent). */
+    toolName: string;
+    toolArgs: unknown;
+    toolResult: string | null;
+    toolMessage: unknown;
+    requests: readonly InterruptRequest[];
+    answers: ReadonlyMap<string, InterruptAnswer>;
+    localStamps: ReadonlyMap<string, readonly ToolApprovalStamp[]>;
+}) => ApprovalCardView[];
+/**
+ * Whether the tool's normal step renders under its cards: a sub-agent's `task` step
+ * always does; a parent call's only once approved AND sent (while waiting it has not
+ * run; a rejected call never runs; an approval waiting for the pause's other cards has
+ * not been sent yet).
+ */
+export declare const toolStepVisibleBelowCards: (toolName: string, cards: readonly ApprovalCardView[]) => boolean;
+export {};
+//# sourceMappingURL=agui-interrupts.d.ts.map

package/dist/utils/agui-interrupts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agui-interrupts.d.ts","sourceRoot":"","sources":["../../src/utils/agui-interrupts.ts"],"names":[],"mappings":"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"}

package/dist/utils/agui-interrupts.js

@@ -0,0 +1,351 @@
+export const TOOL_APPROVALS_METADATA_KEY = "blocks.toolApprovals";
+const SUBAGENT_TOOL_NAME = "task";
+/**
+ * A rejected call never ran; its result is the rejection. The server always uses
+ * HumanInTheLoopMiddleware's standard reject (the Reject button, typing, and a new
+ * Send Message). Used only when no record of the decision exists: a
+ * tool that failed also carries `error`.
+ */
+const REJECTED_RESULT_PREFIXES = ["User rejected the tool call for `"];
+export const APPROVAL_STATUS_LINE = {
+    waiting: "Waiting for approval",
+    approved: "Approved",
+    rejected: "Rejected",
+};
+/** Appended to a decided card's status while another request of the pause is open. */
+export const WAITING_FOR_OTHER_SUFFIX = " · waiting for your decision on the other request";
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const isString = (value) => typeof value === "string";
+const nonEmpty = (value) => (isString(value) && value ? value : null);
+const parseArgs = (raw) => {
+    try {
+        const parsed = JSON.parse(raw || "{}");
+        return isRecord(parsed) ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+};
+export const requestKey = (interruptId, index) => `${interruptId}#${index}`;
+/** The name the model sees for a describe name (wf-actions-py `model_tool_name`). */
+const modelToolName = (describeName) => describeName.replace(/[^a-zA-Z0-9_-]/g, "_").toLowerCase();
+/**
+ * The server arms each approval with its tool's describe name as the request's
+ * `description`. Trusted only when it maps back to the request's name: a pause armed
+ * without one (and every pause parked before) carries the middleware's default text.
+ */
+const displayNameOf = (name, description) => isString(description) && description && name && modelToolName(description) === name ? description : null;
+const rawOf = (interrupt) => {
+    const metadata = isRecord(interrupt.metadata) ? interrupt.metadata : {};
+    const langgraph = isRecord(metadata.langgraph) ? metadata.langgraph : {};
+    return isRecord(langgraph.raw) ? langgraph.raw : {};
+};
+const allowedOf = (configs, index, name) => {
+    const read = (config) => isRecord(config) && Array.isArray(config.allowed_decisions) ? config.allowed_decisions.filter(isString) : [];
+    // The middleware appends one request and one config per gated call, in step.
+    const positional = configs[index];
+    if (isRecord(positional) && (!name || positional.action_name == null || positional.action_name === name)) {
+        return read(positional);
+    }
+    const byName = configs.find((config) => isRecord(config) && config.action_name === name);
+    return byName ? read(byName) : read(positional);
+};
+/** The newest assistant message's calls that have no result yet, in order. */
+const waitingCalls = (messages) => {
+    const answered = new Set();
+    for (const message of messages) {
+        if (message.role === "tool" && "toolCallId" in message && isString(message.toolCallId)) {
+            answered.add(message.toolCallId);
+        }
+    }
+    for (let i = messages.length - 1; i >= 0; i -= 1) {
+        const message = messages[i];
+        if (message.role !== "assistant") {
+            continue;
+        }
+        const calls = "toolCalls" in message && Array.isArray(message.toolCalls) ? message.toolCalls : [];
+        return calls
+            .filter((call) => !answered.has(call.id))
+            .map((call) => ({ id: call.id, name: call.function.name, args: parseArgs(call.function.arguments) }));
+    }
+    return [];
+};
+/**
+ * Every request of the open interrupts, in the order the server needs decisions,
+ * each paired with its transcript call by order.
+ */
+export const requestsOf = (interrupts, messages) => {
+    const waiting = waitingCalls(messages);
+    const tasks = waiting.filter((call) => call.name === SUBAGENT_TOOL_NAME);
+    const own = waiting.filter((call) => call.name !== SUBAGENT_TOOL_NAME);
+    const host = tasks[0] ?? null;
+    const used = new Set();
+    const out = [];
+    for (const interrupt of interrupts) {
+        const raw = rawOf(interrupt);
+        const requests = Array.isArray(raw.action_requests) ? raw.action_requests : [];
+        const configs = Array.isArray(raw.review_configs) ? raw.review_configs : [];
+        requests.forEach((request, index) => {
+            const fields = isRecord(request) ? request : {};
+            const name = isString(fields.name) ? fields.name : "";
+            const match = own.find((call) => call.name === name && !used.has(call.id)) ?? null;
+            if (match) {
+                used.add(match.id);
+            }
+            out.push({
+                interruptId: interrupt.id,
+                index,
+                key: requestKey(interrupt.id, index),
+                name,
+                args: isRecord(fields.args) ? fields.args : {},
+                allowedDecisions: allowedOf(configs, index, name),
+                toolCallId: match?.id ?? null,
+                anchorToolCallId: match ? match.id : (host?.id ?? null),
+                displayName: displayNameOf(name, fields.description),
+            });
+        });
+    }
+    return out;
+};
+export const isApprovalRequest = (request) => request.allowedDecisions.includes("approve");
+/** Thrown with fixed text when an answer pairs with no open interrupt and is not the welcome seed. */
+export const INTERRUPT_NOT_OPEN_ERROR = "answerInterrupt: nothing is waiting for this answer";
+/**
+ * A question's answer as HumanInTheLoopMiddleware's `respond` message -- and as the welcome
+ * seed's tool result, so both read the same. `?? null`: JSON.stringify(undefined) drops the
+ * key, which the server refuses.
+ */
+export const respondMessageOf = (answer) => JSON.stringify(answer ?? null);
+const decisionOf = (answer) => answer.type === "respond" ? { type: "respond", message: respondMessageOf(answer.message) } : { type: answer.type };
+/**
+ * The welcome seed (`initialUserChoices`): connect writes an ask_user call that no run made,
+ * so nothing is parked behind it. Its signature is the one the server used
+ * (`answer_orphan_pause`): no user message yet, and the call still waits on the newest
+ * assistant message.
+ */
+export const isWelcomeSeedCall = (messages, toolCallId) => !messages.some((message) => message.role === "user") && waitingCalls(messages).some((call) => call.id === toolCallId);
+/**
+ * Where a question card's answer goes: the open request it pairs with by order; the seed's
+ * tool result when nothing is open; otherwise nowhere -- the caller
+ * throws INTERRUPT_NOT_OPEN_ERROR. Never `command.resume`.
+ */
+export const answerRouteOf = (interrupts, messages, toolCallId) => {
+    const request = requestsOf(interrupts, messages).find((candidate) => candidate.toolCallId === toolCallId && !isApprovalRequest(candidate));
+    if (request) {
+        return { kind: "respond", request };
+    }
+    if (interrupts.length === 0 && isWelcomeSeedCall(messages, toolCallId)) {
+        return { kind: "seed" };
+    }
+    return { kind: "refuse" };
+};
+/**
+ * The deprecated `resolveInterrupt(resume)`: a `{decisions}` payload for the ONE
+ * open interrupt, as a standard resolved entry. Null when it cannot be routed.
+ */
+export const singleInterruptResume = (interrupts, payload) => interrupts.length === 1 && isRecord(payload) && Array.isArray(payload.decisions)
+    ? [{ interruptId: interrupts[0].id, status: "resolved", payload: { decisions: payload.decisions } }]
+    : null;
+/**
+ * After a run that carried `resume[]`: anything but RUN_FINISHED (a RUN_ERROR such as a refused
+ * resume, a stop, a dropped stream) may have consumed the resume on the server, while
+ * @ag-ui/client changes `pendingInterrupts` only on RUN_FINISHED. The chat then forgets them and
+ * reconnects; the connect re-sends what is really open.
+ */
+export const needsReconnectAfter = (sentResume, finished) => sentResume && !finished;
+/** One `resolved` entry per open interrupt, or null while any request is unanswered. */
+export const buildResumeEntries = (interrupts, requests, answers) => {
+    if (interrupts.length === 0) {
+        return null;
+    }
+    const entries = [];
+    for (const interrupt of interrupts) {
+        const decisions = [];
+        for (const request of requests.filter((r) => r.interruptId === interrupt.id)) {
+            const answer = answers.get(request.key);
+            if (!answer) {
+                return null;
+            }
+            decisions.push(decisionOf(answer));
+        }
+        entries.push({ interruptId: interrupt.id, status: "resolved", payload: { decisions } });
+    }
+    return entries;
+};
+/**
+ * Typing while the turn is parked: the typed text goes out as a normal
+ * message, and each open interrupt gets the protocol's own `cancelled` entry, with no payload.
+ * The server rejects every waiting approval with the standard text, skips every question with
+ * one fixed marker, and appends the message after them.
+ */
+export const cancelledResumeEntries = (interrupts) => interrupts.map((interrupt) => ({ interruptId: interrupt.id, status: "cancelled" }));
+/**
+ * Forgets the agent's open interrupts. CopilotKit 1.70.2 keeps
+ * `pendingInterrupts` across a thread swap and a reconnect, and @ag-ui/client 0.0.59
+ * then refuses the next run AND connect ("Thread has N pending interrupt(s) not
+ * addressed by resume"). Call it on a thread swap and right before every connect
+ * the chat starts; the connect's own RUN_FINISHED re-sends what is still open.
+ */
+export const forgetOpenInterrupts = (agent) => {
+    if (agent) {
+        agent.pendingInterrupts = [];
+    }
+};
+/** This browser's own approval decisions, by anchor, until a reload brings the record. */
+export const localStampsByAnchor = (requests, answers) => {
+    const out = new Map();
+    for (const request of requests) {
+        const answer = answers.get(request.key);
+        if (!answer || answer.type === "respond" || !isApprovalRequest(request) || !request.anchorToolCallId) {
+            continue;
+        }
+        const list = out.get(request.anchorToolCallId) ?? [];
+        list.push({
+            // A sub-agent's call is not in this transcript; its request key stands in.
+            toolCallId: request.toolCallId ?? request.key,
+            decision: answer.type,
+            toolName: request.name,
+            displayName: request.displayName,
+            args: request.args,
+        });
+        out.set(request.anchorToolCallId, list);
+    }
+    return out;
+};
+export const mergeStamps = (previous, next) => {
+    if (next.size === 0) {
+        return previous;
+    }
+    const merged = new Map(previous);
+    next.forEach((stamps, anchor) => merged.set(anchor, [...(merged.get(anchor) ?? []), ...stamps]));
+    return merged;
+};
+/**
+ * The decided-here stamps after the chat forgets what is open. A same-thread reload keeps them:
+ * the connect's snapshot brings the record, and until it lands nothing else draws the card. A
+ * thread or chat swap, or a reconnect after a failed run, clears them.
+ */
+export const stampsAfterInterruptReset = (previous, { keepStamps }) => (keepStamps || previous.size === 0 ? previous : new Map());
+/** Takes back exactly the stamps `mergeStamps` added (by identity), when their send did not go through. */
+export const dropStamps = (previous, added) => {
+    if (added.size === 0) {
+        return previous;
+    }
+    const kept = new Map();
+    previous.forEach((stamps, anchor) => {
+        const drop = new Set(added.get(anchor) ?? []);
+        const rest = stamps.filter((stamp) => !drop.has(stamp));
+        if (rest.length > 0) {
+            kept.set(anchor, rest);
+        }
+    });
+    return kept;
+};
+export const toolApprovalsOf = (message) => {
+    if (!isRecord(message) || !isRecord(message.metadata)) {
+        return [];
+    }
+    const raw = message.metadata[TOOL_APPROVALS_METADATA_KEY];
+    if (!Array.isArray(raw)) {
+        return [];
+    }
+    return raw.flatMap((item) => isRecord(item) &&
+        (item.decision === "approve" || item.decision === "reject") &&
+        isString(item.toolName) &&
+        isString(item.toolCallId)
+        ? [
+            {
+                toolCallId: item.toolCallId,
+                decision: item.decision,
+                toolName: item.toolName,
+                displayName: nonEmpty(item.displayName),
+                args: isRecord(item.args) ? item.args : {},
+            },
+        ]
+        : []);
+};
+const rejectedByResult = (result) => isString(result) && REJECTED_RESULT_PREFIXES.some((prefix) => result.startsWith(prefix));
+/** `insert_items_in_orders` → `insert items in orders`. */
+export const toolWords = (name) => name
+    .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
+    .replace(/([A-Z]+)([A-Z][a-z])/g, "$1 $2")
+    .replace(/[_\s-]+/g, " ")
+    .trim()
+    .toLowerCase();
+export const toolCallOf = (messages, toolCallId) => {
+    for (const message of messages) {
+        if (message.role !== "assistant" || !("toolCalls" in message) || !Array.isArray(message.toolCalls)) {
+            continue;
+        }
+        const call = message.toolCalls.find((candidate) => candidate.id === toolCallId);
+        if (call) {
+            return { name: call.function.name, args: parseArgs(call.function.arguments) };
+        }
+    }
+    return null;
+};
+const titleOf = (toolName) => {
+    const words = toolWords(toolName);
+    return words.charAt(0).toUpperCase() + words.slice(1);
+};
+const statusOf = (decision) => decision === "approve" ? "approved" : "rejected";
+export const approvalCardsForToolCall = ({ toolCallId, toolName, toolArgs, toolResult, toolMessage, requests, answers, localStamps, }) => {
+    const live = requests.filter((request) => request.anchorToolCallId === toolCallId && isApprovalRequest(request));
+    if (live.length > 0) {
+        const othersOpen = requests.some((request) => !answers.has(request.key));
+        return live.map((request) => {
+            const answer = answers.get(request.key);
+            const status = answer && answer.type !== "respond" ? statusOf(answer.type) : "waiting";
+            const waitingForOthers = status !== "waiting" && othersOpen;
+            return {
+                key: request.key,
+                title: titleOf(request.displayName ?? request.name),
+                args: request.args,
+                status,
+                statusLine: waitingForOthers
+                    ? `${APPROVAL_STATUS_LINE[status]}${WAITING_FOR_OTHER_SUFFIX}`
+                    : APPROVAL_STATUS_LINE[status],
+                request: status === "waiting" ? { interruptId: request.interruptId, index: request.index } : null,
+                waitingForOthers,
+            };
+        });
+    }
+    // The server's record wins once a reload brought it; until then, this browser's own.
+    const recorded = toolApprovalsOf(toolMessage);
+    const decided = recorded.length > 0 ? recorded : (localStamps.get(toolCallId) ?? []);
+    if (decided.length > 0) {
+        return decided.map((stamp) => {
+            const status = statusOf(stamp.decision);
+            return {
+                key: `${toolCallId}#${stamp.toolCallId}`,
+                title: titleOf(stamp.displayName ?? stamp.toolName),
+                args: stamp.args,
+                status,
+                statusLine: APPROVAL_STATUS_LINE[status],
+                request: null,
+                waitingForOthers: false,
+            };
+        });
+    }
+    if (toolName !== SUBAGENT_TOOL_NAME && rejectedByResult(toolResult)) {
+        return [
+            {
+                key: `${toolCallId}#rejected`,
+                title: titleOf(toolName),
+                args: isRecord(toolArgs) ? toolArgs : {},
+                status: "rejected",
+                statusLine: APPROVAL_STATUS_LINE.rejected,
+                request: null,
+                waitingForOthers: false,
+            },
+        ];
+    }
+    return [];
+};
+/**
+ * Whether the tool's normal step renders under its cards: a sub-agent's `task` step
+ * always does; a parent call's only once approved AND sent (while waiting it has not
+ * run; a rejected call never runs; an approval waiting for the pause's other cards has
+ * not been sent yet).
+ */
+export const toolStepVisibleBelowCards = (toolName, cards) => toolName === SUBAGENT_TOOL_NAME || cards.every((card) => card.status === "approved" && !card.waitingForOthers);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blocksdiy/react-common",
-  "version": "1.51.0",
+  "version": "1.52.1",
   "type": "module",
   "description": "React common",
   "keywords": [],
@@ -39,7 +39,7 @@
     "penpal": "^8.0.0",
     "react": "^19.2.8",
     "use-stick-to-bottom": "1.1.4",
-    "@blocksdiy/blocks-client-api": "1.5.0"
+    "@blocksdiy/blocks-client-api": "1.25.2"
   },
   "devDependencies": {
     "@types/react": "^19.2.18",