@blocksdiy/react-common 1.50.1 → 1.52.0

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/hooks/use-agent-threads.d.ts

@@ -1,5 +1,6 @@
 import { type AgentThreadItem, type AgentThreadSource, type AgentThreadStatus } from "./agent-thread-live-update.js";
 export * from "./agent-thread-live-update.js";
+export { type AgentAdminCaller, BUILD_PERMISSION, isAgentAdmin, readAgentAdminRoles } from "../utils/agent-admin.js";
 export { type AgentConversationChat, type AgentConversationRef, type AgentConversationUrlTarget, agentThreadStandIn, nextRunStaleAt, RUN_STALE_MS, useAgentConversation, type UseAgentConversationOptions, type UseAgentConversationResult, useAgentConversationSelection, type UseAgentConversationSelectionOptions, type UseAgentConversationSelectionResult, } from "./use-agent-conversation.js";
 export { type AgentConversationContextValue, AgentConversationProvider, type AgentConversationProviderProps, type AgentThreadFilters, useAgentConversationContext, } from "./agent-conversation-context.js";
 export interface AgentThreadsPage {

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

@@ -1 +1 @@
-{"version":3,"file":"use-agent-threads.d.ts","sourceRoot":"","sources":["../../src/hooks/use-agent-threads.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,eAAe,EAEpB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EAUvB,MAAM,4BAA4B,CAAC;AAEpC,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAC/B,6BAA6B,EAC7B,KAAK,oCAAoC,EACzC,KAAK,mCAAmC,GACzC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,6BAA6B,EAClC,yBAAyB,EACzB,KAAK,8BAA8B,EACnC,KAAK,kBAAkB,EACvB,2BAA2B,GAC5B,MAAM,8BAA8B,CAAC;AAItC,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,cAAc,GAAG,WAAW,CAAC;IACpC,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,oBAAoB,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACzE,YAAY,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,cAAc,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzG,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,eAAO,MAAM,uBAAuB,iBAAiB,CAAC;AACtD,eAAO,MAAM,gBAAgB,GAAI,SAAS,MAAM,KAAG,MAAgD,CAAC;AAEpG,eAAO,MAAM,qBAAqB,GAAI,QAAQ,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,cAAc,CAAC,KAAG,MAIhG,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,QAAQ,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,cAAc,GAAG,OAAO,CAAC,KAAG,MACpD,CAAC;AAuC1D,0FAA0F;AAC1F,eAAO,MAAM,eAAe,GAAI,SAAS,sBAAsB,KAAG,qBA6UjE,CAAC;AAEF,eAAe,eAAe,CAAC"}
+{"version":3,"file":"use-agent-threads.d.ts","sourceRoot":"","sources":["../../src/hooks/use-agent-threads.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,eAAe,EAEpB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EAUvB,MAAM,4BAA4B,CAAC;AAEpC,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EAAE,KAAK,gBAAgB,EAAE,gBAAgB,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAClH,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAC/B,6BAA6B,EAC7B,KAAK,oCAAoC,EACzC,KAAK,mCAAmC,GACzC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,6BAA6B,EAClC,yBAAyB,EACzB,KAAK,8BAA8B,EACnC,KAAK,kBAAkB,EACvB,2BAA2B,GAC5B,MAAM,8BAA8B,CAAC;AAItC,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,cAAc,GAAG,WAAW,CAAC;IACpC,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,oBAAoB,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACzE,YAAY,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,cAAc,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzG,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,eAAO,MAAM,uBAAuB,iBAAiB,CAAC;AACtD,eAAO,MAAM,gBAAgB,GAAI,SAAS,MAAM,KAAG,MAAgD,CAAC;AAEpG,eAAO,MAAM,qBAAqB,GAAI,QAAQ,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,cAAc,CAAC,KAAG,MAIhG,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,QAAQ,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,cAAc,GAAG,OAAO,CAAC,KAAG,MACpD,CAAC;AAuC1D,0FAA0F;AAC1F,eAAO,MAAM,eAAe,GAAI,SAAS,sBAAsB,KAAG,qBA6UjE,CAAC;AAEF,eAAe,eAAe,CAAC"}

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

@@ -3,6 +3,7 @@ import { websocketsService } from "@blocksdiy/blocks-client-api/websocketService
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { agentThreadKey, applyAgentThreadUpdate, isAgentThreadItem, matchesAgentThreadFilters, optimisticThreadAfterSend, overlayOptimisticThreads, reconcileWalkWithLive, removeAgentThread, retireOptimisticThreadsTakenOver, } from "./agent-thread-live-update.js";
 export * from "./agent-thread-live-update.js";
+export { BUILD_PERMISSION, isAgentAdmin, readAgentAdminRoles } from "../utils/agent-admin.js";
 export { agentThreadStandIn, nextRunStaleAt, RUN_STALE_MS, useAgentConversation, useAgentConversationSelection, } from "./use-agent-conversation.js";
 export { AgentConversationProvider, useAgentConversationContext, } from "./agent-conversation-context.js";
 const AGENT_THREAD_UPDATED = "AGENT_THREAD_UPDATED";

package/dist/utils/agent-admin.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Who is an admin of an agent — the client twin of wf-actions-py `agent_admin.py`.
+ *
+ * A caller is an agent admin when they are signed in AND (they are a builder of the app, OR the
+ * agent restricts nothing — `adminRoles` unset or empty — OR their role is one of `adminRoles`,
+ * matched by trimmed name, case-sensitive). Anything else is not an admin (fail closed).
+ *
+ * This is "is this caller an admin of this agent", NOT "does this chat have the admin
+ * experience on" (`AgentChat.isAdmin`). The admin experience needs both. The client verdict is
+ * display-only; the server decides independently every turn.
+ */
+export interface AgentAdminCaller {
+    isAuthenticated?: boolean;
+    permission?: string;
+    role?: string;
+}
+export declare const BUILD_PERMISSION = "build";
+/**
+ * `adminRoles`: `undefined` or empty = no restriction; `null` = present but malformed, which makes
+ * nobody an admin (the server reads it the same way — garbage must not mean "no restriction").
+ */
+export declare const isAgentAdmin: (user: AgentAdminCaller | null | undefined, adminRoles: readonly string[] | null | undefined) => boolean;
+/**
+ * The agent block's `adminRoles` as trimmed, non-blank names; `undefined` when unset, `null` when
+ * present but not a list. Mirrors `normalize_admin_roles` in wf-actions-py `agent_admin.py`.
+ */
+export declare const readAgentAdminRoles: (value: unknown) => string[] | null | undefined;
+//# sourceMappingURL=agent-admin.d.ts.map

package/dist/utils/agent-admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-admin.d.ts","sourceRoot":"","sources":["../../src/utils/agent-admin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,gBAAgB,UAAU,CAAC;AAExC;;;GAGG;AACH,eAAO,MAAM,YAAY,GACvB,MAAM,gBAAgB,GAAG,IAAI,GAAG,SAAS,EACzC,YAAY,SAAS,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,KAC/C,OAeF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAI,OAAO,OAAO,KAAG,MAAM,EAAE,GAAG,IAAI,GAAG,SAWtE,CAAC"}

package/dist/utils/agent-admin.js

@@ -0,0 +1,48 @@
+/**
+ * Who is an admin of an agent — the client twin of wf-actions-py `agent_admin.py`.
+ *
+ * A caller is an agent admin when they are signed in AND (they are a builder of the app, OR the
+ * agent restricts nothing — `adminRoles` unset or empty — OR their role is one of `adminRoles`,
+ * matched by trimmed name, case-sensitive). Anything else is not an admin (fail closed).
+ *
+ * This is "is this caller an admin of this agent", NOT "does this chat have the admin
+ * experience on" (`AgentChat.isAdmin`). The admin experience needs both. The client verdict is
+ * display-only; the server decides independently every turn.
+ */
+export const BUILD_PERMISSION = "build";
+/**
+ * `adminRoles`: `undefined` or empty = no restriction; `null` = present but malformed, which makes
+ * nobody an admin (the server reads it the same way — garbage must not mean "no restriction").
+ */
+export const isAgentAdmin = (user, adminRoles) => {
+    if (user?.isAuthenticated !== true || adminRoles === null) {
+        return false;
+    }
+    if (user.permission === BUILD_PERMISSION) {
+        return true;
+    }
+    if (!adminRoles || adminRoles.length === 0) {
+        return true;
+    }
+    const role = typeof user.role === "string" ? user.role.trim() : "";
+    if (!role) {
+        return false;
+    }
+    return adminRoles.some((adminRole) => typeof adminRole === "string" && adminRole.trim() === role);
+};
+/**
+ * The agent block's `adminRoles` as trimmed, non-blank names; `undefined` when unset, `null` when
+ * present but not a list. Mirrors `normalize_admin_roles` in wf-actions-py `agent_admin.py`.
+ */
+export const readAgentAdminRoles = (value) => {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    if (!Array.isArray(value)) {
+        return null;
+    }
+    return value
+        .filter((role) => typeof role === "string")
+        .map((role) => role.trim())
+        .filter((role) => role.length > 0);
+};

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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"}