@blocksdiy/react-common 1.48.0 → 1.49.0

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

@@ -2,8 +2,10 @@ import { type Message, ToolMessage, type UserMessage } from "@ag-ui/client";
 import { useRenderToolCall } from "@copilotkit/react-core/v2";
 import { ReactNode, SetStateAction } from "react";
 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 Message, type AssistantMessage, type UserMessage } from "@ag-ui/client";
 export { useRenderTool, useDefaultRenderTool, useHumanInTheLoop, useFrontendTool, ToolCallStatus, } from "@copilotkit/react-core/v2";
@@ -43,6 +45,7 @@ export interface Agent {
     voiceId?: string;
     harness?: string;
 }
+export type OnUserMessageSent = (text: string, message: Omit<UserMessage, "id" | "role">) => void;
 export interface AgentChatContextValue {
     messages: Message[];
     attachments: Attachment[];
@@ -60,40 +63,14 @@ export interface AgentChatContextValue {
         role: "assistant" | "user";
     }[];
     messageById: Map<string, Message>;
-    /**
-     * The agent run (turn) that produced each message — the `agentRunId` the rows it wrote
-     * carry. Replayed messages come attributed by the connect replay, live ones by the run
-     * that streams them; messages from before run attribution have no entry. Optional so
-     * contexts a host builds by hand (previews, stubs) need not state it; absent reads as
-     * "no run known".
-     */
     runIdByMessageId?: MessageRunIds;
-    /**
-     * When each run in `runIdByMessageId` started (epoch ms) — the time of a turn, which is
-     * what a chat shows under a message. A live run is stamped as it starts; a replayed
-     * one comes with the server's time. Runs from before run times have no entry.
-     */
     runStartedAt?: RunStartedAt;
     toolMessages: ToolMessage[];
     renderToolCall: ReturnType<typeof useRenderToolCall>;
     sendMessage: (message: Omit<UserMessage, "id" | "role">) => Promise<void>;
     sendFromInputs: () => Promise<void>;
-    /**
-     * Replay this conversation's transcript from the server, in place.
-     *
-     * The same round-trip a fresh mount does — the connect endpoint reads the checkpoint and
-     * answers with a MESSAGES_SNAPSHOT, which replaces the mirrored list. For turns that ran
-     * SERVER-SIDE, which no client streamed and so no client has: without this they appear only
-     * after a reload or a conversation switch.
-     *
-     * A no-op while a run is in flight: that run's own stream is the authoritative view of the
-     * conversation, and replacing the list underneath it would fight the events still arriving.
-     */
     reloadMessages: () => Promise<void>;
-    /** Resumes a run parked on a server-side interrupt. Rejects if the resume fails. */
-    /** Resolves false when a run was already in flight, so nothing was sent. */
     resolveInterrupt: (resume: unknown) => Promise<boolean>;
-    /** Answers one parked card; resumes once every card of the turn is answered. */
     answerInterrupt: (answer: {
         toolCallId: string;
         answer: unknown;
@@ -106,6 +83,10 @@ export interface AgentChatContextValue {
     setAttachments: React.Dispatch<SetStateAction<Attachment[]>>;
     setIsDraggingFiles: React.Dispatch<SetStateAction<boolean>>;
     setCurrentThreadId: (currentThreadId: string) => void;
+    /** Arms the next send; cleared by send and conversation switch. */
+    composerMessageMeta?: ComposerMessageMeta | null;
+    setComposerMessageMeta?: (meta: ComposerMessageMeta | null) => void;
+    setRunningElsewhere?: (runId: string | null) => void;
 }
 export declare const AgentChatContext: import("react").Context<AgentChatContextValue | null>;
 export declare const useAgentChat: () => AgentChatContextValue;
@@ -147,9 +128,11 @@ export interface AgentChatRootProps {
      * Fires once a user send has been added to the conversation, with its text (empty
      * string for attachment-only sends) — the seam for ChatGPT-style optimistic thread
      * listing: hosts pair it with useAgentThreads' notifyThreadActivity. Covers sends
-     * routed through `sendMessage`, not the auto-sent `initialPrompt`.
+     * routed through `sendMessage`, not the auto-sent `initialPrompt`. The second argument
+     * is the message as sent, for hosts that treat a protocol send (one carrying a `name`)
+     * differently from an ordinary turn.
      */
-    onUserMessageSent?: (text: string) => void;
+    onUserMessageSent?: OnUserMessageSent;
     /**
      * Skip the agent-chat block's `initialPrompt` auto-send. For surfaces that mint a fresh
      * thread per conversation (an inbox's "New chat"): the auto-send fires once PER THREAD,

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

@@ -6,8 +6,10 @@ 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 { 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 { useRenderTool, useDefaultRenderTool, useHumanInTheLoop, useFrontendTool, ToolCallStatus, } from "@copilotkit/react-core/v2";
 // Client-only `useLayoutEffect`, falls back to `useEffect` during SSR.
@@ -173,9 +175,9 @@ const uploadAttachments = async ({ attachments, appId, token, }) => {
         };
     }));
 };
-const hasSendableInput = (prompt, attachments) => {
-    return prompt.trim().length > 0 || attachments.length > 0;
-};
+// An armed send needs text: the composer is the comment path — a rating alone goes out as
+// `feedbackMessage` — and an unrated marker on its own is an ordinary turn on the server.
+const hasSendableInput = (prompt, attachments, meta) => prompt.trim().length > 0 || (!meta && attachments.length > 0);
 const isRecord = (value) => {
     return typeof value === "object" && value !== null;
 };
@@ -311,19 +313,10 @@ const ChatInitializer = ({ agentBlock, agentChatBlock, chatId, token, appId, com
         });
         return groups;
     }, [copilotMessages]);
-    // Which run produced each message, and when it started (see utils/message-run-ids).
-    // Replayed messages: the connect replay sends both as one CUSTOM event, and its word is
-    // final — it overwrites what the session recorded. Live messages: RUN_STARTED names the
-    // run (the server mints the id, so the one in the event, not the one we sent), times it,
-    // and shows the transcript as it stood — the run's input is what sits after the last
-    // reply. All of that is recorded with the FIRST message the run streams, and each
-    // message it streams is its; first claim wins, as on the server. A run that streams
-    // nothing leaves no trace: connect (a reconnect sees the whole transcript, and must not
-    // adopt an old unanswered message), or a run that fails before its first token. Cleared
-    // with the transcript on a swap.
     const [runIdByMessageId, setRunIdByMessageId] = useState(EMPTY_MESSAGE_RUN_IDS);
     const [runStartedAt, setRunStartedAt] = useState(EMPTY_RUN_STARTED_AT);
     const liveRunRef = useRef(null);
+    const ownRunIdsRef = useRef(new Set());
     useEffect(() => {
         if (!copilotAgent) {
             return;
@@ -349,10 +342,9 @@ const ChatInitializer = ({ agentBlock, agentChatBlock, chatId, token, appId, com
         const { unsubscribe } = copilotAgent.subscribe({
             onRunStartedEvent: ({ event, messages }) => {
                 liveRunRef.current = { runId: event.runId, startedAt: event.timestamp ?? Date.now(), input: messages };
+                ownRunIdsRef.current.add(event.runId);
             },
             onTextMessageStartEvent: ({ event }) => claimLive(event.messageId),
-            // A tool-call-only reply is created by its first tool call, under `parentMessageId`
-            // when the server names one and the tool call's own id otherwise (the client's rule).
             onToolCallStartEvent: ({ event }) => claimLive(event.parentMessageId ?? event.toolCallId),
             onRunFinalized: () => {
                 liveRunRef.current = null;
@@ -370,8 +362,6 @@ const ChatInitializer = ({ agentBlock, agentChatBlock, chatId, token, appId, com
         });
         return () => {
             unsubscribe();
-            // A run in flight on the agent we leave finalizes without us; it must not claim
-            // the next agent's messages.
             liveRunRef.current = null;
         };
     }, [copilotAgent]);
@@ -393,11 +383,13 @@ const ChatInitializer = ({ agentBlock, agentChatBlock, chatId, token, appId, com
     }, [copilotAgent, currentThreadId]);
     const [prompt, setPrompt] = useState("");
     const [attachments, setAttachments] = useState([]);
-    // Conversation identity. When a mounted chat is pointed at another conversation, the
-    // reconnect replay takes a round-trip — clear the previous transcript and composer
-    // immediately so the old conversation never lingers on screen (same visual contract as
-    // a remount). Deliberately NOT keyed on `initKey`: that also changes when the block
-    // configs finish loading, and clearing then would wipe a freshly replayed transcript.
+    const [composerMessageMeta, setComposerMessageMeta] = useState(null);
+    // setRunningElsewhere: a run elsewhere reads as this chat's own; own runs match RUN_STARTED id; refused at send time via ref (upload awaits).
+    const [runningElsewhereRunId, setRunningElsewhere] = useState(null);
+    const [ownRunInFlight, setOwnRunInFlight] = useState(false);
+    const isRunningElsewhere = runningElsewhereRunId !== null && !ownRunInFlight && !ownRunIdsRef.current.has(runningElsewhereRunId);
+    const isRunningElsewhereRef = useRef(isRunningElsewhere);
+    isRunningElsewhereRef.current = isRunningElsewhere;
     const conversationKey = `${chatId ?? ""}|${currentThreadId ?? ""}`;
     const prevConversationKeyRef = useRef(conversationKey);
     useIsomorphicLayoutEffect(() => {
@@ -410,14 +402,8 @@ const ChatInitializer = ({ agentBlock, agentChatBlock, chatId, token, appId, com
         setRunStartedAt(EMPTY_RUN_STARTED_AT);
         setPrompt("");
         setAttachments([]);
-        // The clear above runs in the layout phase, but the previous conversation's run is
-        // detached in passive effects — and even past detach, events already buffered in the
-        // apply pipeline keep applying, each reassigning `agent.messages` WHOLESALE. One late
-        // chunk would resurrect the entire previous transcript (and re-arm its auto-executing
-        // tool-call follow-ups) under the new conversation's header. Detach here too and
-        // re-clear once the drain settles; the reconnect that follows replays on top of the
-        // (guaranteed-empty) mirror. On threadId switches the core's fresh-restore re-clears
-        // as well — harmless overlap — but on chatId-only switches this is the only re-clear.
+        setComposerMessageMeta(null);
+        setOwnRunInFlight(false);
         const detachable = copilotAgent;
         const drained = detachable?.detachActiveRun?.();
         if (drained) {
@@ -429,15 +415,6 @@ const ChatInitializer = ({ agentBlock, agentChatBlock, chatId, token, appId, com
             });
         }
     }, [conversationKey]);
-    // CopilotKit reconnects only when its threadId changes — but a conversation is the
-    // (chatId, threadId) PAIR, and rows written by surfaces that use the fixed default
-    // thread id differ only by chatId. On such a chatId-only switch the library's connect
-    // effect sees unchanged deps and does nothing, which would leave the (just cleared)
-    // transcript empty forever. Reconnect manually, replicating the core's fresh-restore
-    // steps: reset state and drop the replay cursor — cursors are keyed by threadId, so
-    // the shared id makes the previous conversation's cursor actively wrong here — then
-    // connect (the core detaches any in-flight run itself). The core reads `properties`
-    // after an await, so the new chatId is already synced by the time the request builds.
     const prevConnectionRef = useRef({ chatId, threadId: currentThreadId });
     useEffect(() => {
         const previous = prevConnectionRef.current;
@@ -449,23 +426,16 @@ const ChatInitializer = ({ agentBlock, agentChatBlock, chatId, token, appId, com
         }
         copilotAgent.setState?.({});
         copilotAgent.clearReplayCursor?.(currentThreadId);
-        // Same guard convention as the composer send path: a failed reconnect already
-        // surfaces through the availability state; the rejection carries no extra signal.
         void copilotkit.connectAgent({ agent: copilotAgent }).catch(() => undefined);
     }, [chatId, currentThreadId, copilotAgent, copilotkit]);
     const [isDraggingFiles, setIsDraggingFiles] = useState(false);
     const attachmentsEnabled = agentChat ? agentChat.disableAttachments !== true : false;
-    const canSendMessage = Boolean(agentChatBlock && agentChat && agent && isConfigLoaded && isAgentReady && !isAgentRunning);
+    const canSendMessage = Boolean(agentChatBlock && agentChat && agent && isConfigLoaded && isAgentReady && !isAgentRunning && !isRunningElsewhere);
     const isFetchingMessages = !isConfigLoaded || (!isAgentReady && copilotMessages.length === 0);
-    // CopilotKit reports `isLoading` during connect/replay as well as real runs. Only expose
-    // thinking once the bootstrap connect phase has completed — and that needs the readiness
-    // latch, not just `isFetchingMessages`, which goes false as soon as ONE replayed message
-    // exists: without `isAgentReady`, thinking leaks true for the tail of every replay, and
-    // every load or thread switch flashes the typing dots under the transcript. Real runs are
-    // unaffected — sending requires readiness (canSendMessage), so the latch is already set.
-    const isThinking = isAgentRunning && !isFetchingMessages && isAgentReady;
+    const isThinking = (isAgentRunning || isRunningElsewhere) && !isFetchingMessages && isAgentReady;
     const runAgentWithRetry = useCallback(async (agentToRun, messageCountAtRunStart, forwardedProps) => {
-        if (agentToRun.isRunning) {
+        // A run elsewhere is on this conversation's checkpoint too: ours would race it.
+        if (agentToRun.isRunning || isRunningElsewhereRef.current) {
             return false;
         }
         const runAgentAndThrowError = async () => {
@@ -488,8 +458,13 @@ const ChatInitializer = ({ agentBlock, agentChatBlock, chatId, token, appId, com
                 unsubscribe();
             }
         };
+        // In flight until the run ends, whichever way (see `runningElsewhereRunId`) — unless
+        // the conversation switched under it, which resets this itself.
+        const ranOn = prevConversationKeyRef.current;
+        setOwnRunInFlight(true);
         try {
             await runAgentAndThrowError();
+            return true;
         }
         catch (error) {
             const hasAgentStartedResponding = agentToRun.messages.length > messageCountAtRunStart;
@@ -500,24 +475,19 @@ const ChatInitializer = ({ agentBlock, agentChatBlock, chatId, token, appId, com
             }
             throw error;
         }
-        return true;
+        finally {
+            if (prevConversationKeyRef.current === ranOn) {
+                setOwnRunInFlight(false);
+            }
+        }
     }, [copilotkit]);
     const sendMessage = useCallback(async (message) => {
-        if (!canSendMessage || !copilotAgent || copilotAgent.isRunning) {
+        if (!canSendMessage || !copilotAgent || copilotAgent.isRunning || isRunningElsewhereRef.current) {
             return;
         }
         copilotAgent.addMessage({ ...message, id: generateId(), role: "user" });
-        // The send seam, fired once the message is IN the conversation, so hosts can react
-        // to it (e.g. list the thread optimistically). Covers every send routed through
-        // `sendMessage` — composer, empty-state heroes, user-generated chat components —
-        // but deliberately NOT the auto-sent `initialPrompt` below, whose hidden variant is
-        // a primer rather than something the user wrote.
         if (onUserMessageSent) {
-            const { content } = message;
-            const textPart = Array.isArray(content)
-                ? content.find((part) => part.type === "text")
-                : undefined;
-            onUserMessageSent(typeof content === "string" ? content : (textPart?.text ?? ""));
+            onUserMessageSent(userTextOfContent(message.content), message);
         }
         await runAgentWithRetry(copilotAgent, copilotAgent.messages.length);
     }, [canSendMessage, copilotAgent, runAgentWithRetry, onUserMessageSent]);
@@ -525,14 +495,7 @@ const ChatInitializer = ({ agentBlock, agentChatBlock, chatId, token, appId, com
         if (!copilotAgent || copilotAgent.isRunning) {
             return;
         }
-        // Replay cursors are keyed by threadId and record what has already been replayed, so a
-        // stale one makes connect a no-op — exactly the case here, where the thread is unchanged
-        // and only the server-side content moved. Messages are NOT cleared first: connect answers
-        // with a full snapshot that replaces them, and clearing would blank the transcript for the
-        // round-trip.
         copilotAgent.clearReplayCursor?.(currentThreadId);
-        // Same guard convention as the composer send path: a failed reconnect already surfaces
-        // through the availability state; the rejection carries no extra signal.
         await copilotkit.connectAgent({ agent: copilotAgent }).catch(() => undefined);
     }, [copilotAgent, copilotkit, currentThreadId]);
     // Not sourced from `useInterrupt`: that hook only hands `resolve` to its own
@@ -735,17 +698,44 @@ const ChatInitializer = ({ agentBlock, agentChatBlock, chatId, token, appId, com
         return contentArray;
     };
     const sendFromInputs = async () => {
-        if (!canSendMessage || !hasSendableInput(prompt, attachments)) {
+        const currentMeta = composerMessageMeta;
+        if (!canSendMessage || !hasSendableInput(prompt, attachments, currentMeta)) {
             return;
         }
         const currentPrompt = prompt;
-        const currentAttachments = attachments;
-        const uploadedAttachments = await uploadAttachments({
-            attachments: currentAttachments,
-            appId,
-            token,
-        });
-        const messageContent = buildMessageContentFromInput(currentPrompt, uploadedAttachments ?? []);
+        const composedOn = prevConversationKeyRef.current;
+        if (currentMeta) {
+            setComposerMessageMeta(null);
+        }
+        let uploadedAttachments;
+        try {
+            uploadedAttachments = await uploadAttachments({
+                attachments,
+                appId,
+                token,
+            });
+        }
+        catch (error) {
+            // Failed upload: re-arm unless the conversation switched.
+            if (currentMeta && prevConversationKeyRef.current === composedOn) {
+                setComposerMessageMeta((armed) => armed ?? currentMeta);
+            }
+            throw error;
+        }
+        // Post-upload: conversation switch → stop; run elsewhere → keep input and re-arm; failed upload handled above.
+        if (prevConversationKeyRef.current !== composedOn) {
+            return;
+        }
+        if (isRunningElsewhereRef.current || copilotAgent?.isRunning) {
+            if (currentMeta) {
+                setComposerMessageMeta((armed) => armed ?? currentMeta);
+            }
+            return;
+        }
+        const composed = buildMessageContentFromInput(currentPrompt, uploadedAttachments ?? []);
+        const messageContent = currentMeta
+            ? buildArmedMessageContent(currentMeta, composed)
+            : composed;
         setPrompt("");
         setAttachments([]);
         // Auto-skip any frontend user-choice tool call that's still waiting.
@@ -791,7 +781,7 @@ const ChatInitializer = ({ agentBlock, agentChatBlock, chatId, token, appId, com
                 });
             }
         }
-        await sendMessage({ content: messageContent }).catch(() => undefined);
+        await sendMessage(currentMeta?.name ? { content: messageContent, name: currentMeta.name } : { content: messageContent }).catch(() => undefined);
     };
     const addAttachments = (attachments) => {
         if (!attachmentsEnabled) {
@@ -841,6 +831,9 @@ const ChatInitializer = ({ agentBlock, agentChatBlock, chatId, token, appId, com
             setAttachments: setChatAttachments,
             setIsDraggingFiles: setChatIsDraggingFiles,
             setCurrentThreadId,
+            composerMessageMeta,
+            setComposerMessageMeta,
+            setRunningElsewhere,
             isDraggingFiles,
             isFetchingMessages,
             isThinking,
@@ -1106,10 +1099,10 @@ export function AgentChatFetching({ asChild = false, render, ...props }) {
     return (_jsx(ComposeRender, { render: render, asChild: asChild, defaultTag: "div", "data-state": isFetchingMessages ? "open" : "closed", "data-slot": "agent-chat-fetching", ...props }));
 }
 export function AgentChatInput({ asChild = false, render, onChange, onKeyDown, onPaste, onDragOver, onDragLeave, onDrop, onSubmit, ...props }) {
-    const { setIsDraggingFiles, addAttachments, attachments, prompt, setPrompt, sendFromInputs, isThinking, isAgentReady, isFetchingMessages, agentChat, } = useAgentChat();
+    const { setIsDraggingFiles, addAttachments, attachments, prompt, setPrompt, sendFromInputs, isThinking, isAgentReady, isFetchingMessages, agentChat, composerMessageMeta, } = useAgentChat();
     const attachmentsEnabled = agentChat ? agentChat.disableAttachments !== true : false;
     const isDisabled = props.disabled || isThinking || !isAgentReady || isFetchingMessages;
-    const isSubmitDisabled = isDisabled || !hasSendableInput(prompt, attachmentsEnabled ? attachments : []);
+    const isSubmitDisabled = isDisabled || !hasSendableInput(prompt, attachmentsEnabled ? attachments : [], composerMessageMeta);
     const handleDragOver = useCallback((e) => {
         if (!attachmentsEnabled) {
             return;
@@ -1199,10 +1192,14 @@ export function AgentChatInput({ asChild = false, render, onChange, onKeyDown, o
             : onDrop, "data-slot": "agent-chat-input", ...props }));
 }
 export function AgentChatSendTrigger({ asChild = false, render, onClick, disabled, ...props }) {
-    const { attachments, prompt, isThinking, isAgentReady, isFetchingMessages, sendFromInputs,
+    const { attachments, prompt, isThinking, isAgentReady, isFetchingMessages, sendFromInputs, composerMessageMeta,
     /* , stopGeneration */
      } = useAgentChat();
-    const isDisabled = Boolean(disabled || isThinking || !isAgentReady || isFetchingMessages || !hasSendableInput(prompt, attachments));
+    const isDisabled = Boolean(disabled ||
+        isThinking ||
+        !isAgentReady ||
+        isFetchingMessages ||
+        !hasSendableInput(prompt, attachments, composerMessageMeta));
     return (_jsx(ComposeRender, { render: render, asChild: asChild, defaultTag: "button", onClick: (e) => {
             if (isDisabled) {
                 e.preventDefault();

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

@@ -0,0 +1,32 @@
+import { type ReactNode } from "react";
+import type { AgentThreadItem } from "./agent-thread-live-update.js";
+import { type AgentConversationChat, type AgentConversationRef, type UseAgentConversationResult } from "./use-agent-conversation.js";
+import { type UseAgentThreadsOptions, type UseAgentThreadsResult } from "./use-agent-threads.js";
+export type AgentThreadFilters = Pick<UseAgentThreadsOptions, "status" | "source">;
+export interface AgentConversationContextValue {
+    agentId: string;
+    conversation: AgentConversationRef;
+    /** The new chat, nothing sent on it yet. */
+    isDraft: boolean;
+    /** The index under `filters`; its `renameThread` also keeps the open conversation's remembered title current. */
+    threads: UseAgentThreadsResult;
+    /** The open conversation's row: listed, else the last listed, else a stand-in (`isStandIn`). */
+    row: AgentThreadItem;
+    isStandIn: boolean;
+    filters: AgentThreadFilters;
+    setFilters: (filters: AgentThreadFilters) => void;
+    hasActiveFilters: boolean;
+    /** After this client sends on the conversation (the chat root's onUserMessageSent). */
+    notifyMessageSent: UseAgentConversationResult["notifyMessageSent"];
+}
+export interface AgentConversationProviderProps extends Pick<UseAgentThreadsOptions, "token" | "headers" | "baseUrl"> {
+    agentId: string;
+    conversation: AgentConversationRef;
+    isDraft: boolean;
+    /** The chat runtime's side of the bridge (react-common's useAgentChat). */
+    chat: AgentConversationChat;
+    children?: ReactNode;
+}
+export declare function AgentConversationProvider({ agentId, conversation, isDraft, chat, token, headers, baseUrl, children, }: AgentConversationProviderProps): import("react").JSX.Element;
+export declare const useAgentConversationContext: () => AgentConversationContextValue;
+//# sourceMappingURL=agent-conversation-context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-conversation-context.d.ts","sourceRoot":"","sources":["../../src/hooks/agent-conversation-context.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAiB,KAAK,SAAS,EAAwB,MAAM,OAAO,CAAC;AAE5E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAEzB,KAAK,0BAA0B,EAChC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAmB,KAAK,sBAAsB,EAAE,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE/G,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,sBAAsB,EAAE,QAAQ,GAAG,QAAQ,CAAC,CAAC;AAEnF,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,oBAAoB,CAAC;IACnC,4CAA4C;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,iHAAiH;IACjH,OAAO,EAAE,qBAAqB,CAAC;IAC/B,gGAAgG;IAChG,GAAG,EAAE,eAAe,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,UAAU,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAClD,gBAAgB,EAAE,OAAO,CAAC;IAC1B,uFAAuF;IACvF,iBAAiB,EAAE,0BAA0B,CAAC,mBAAmB,CAAC,CAAC;CACpE;AAID,MAAM,WAAW,8BAA+B,SAAQ,IAAI,CAAC,sBAAsB,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IACnH,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,oBAAoB,CAAC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,2EAA2E;IAC3E,IAAI,EAAE,qBAAqB,CAAC;IAC5B,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,wBAAgB,yBAAyB,CAAC,EACxC,OAAO,EACP,YAAY,EACZ,OAAO,EACP,IAAI,EACJ,KAAK,EACL,OAAO,EACP,OAAO,EACP,QAAQ,GACT,EAAE,8BAA8B,+BA4BhC;AAED,eAAO,MAAM,2BAA2B,QAAO,6BAM9C,CAAC"}

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

@@ -0,0 +1,39 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// The headless Root of an agent conversation surface: one provider that owns the conversation
+// index (useAgentThreads) under the surface's filters and the open conversation's bridge to the
+// chat (useAgentConversation), for parts to read through useAgentConversationContext. The
+// agent-layout registry item renders it; a custom UI over the same behaviour can too.
+import { createContext, useContext, useState } from "react";
+import { useAgentConversation, } from "./use-agent-conversation.js";
+import { useAgentThreads } from "./use-agent-threads.js";
+const AgentConversationContext = createContext(null);
+export function AgentConversationProvider({ agentId, conversation, isDraft, chat, token, headers, baseUrl, children, }) {
+    const [filters, setFilters] = useState({});
+    const threads = useAgentThreads({ agentId, status: filters.status, source: filters.source, token, headers, baseUrl });
+    const { row, isStandIn, renameThread, notifyMessageSent } = useAgentConversation({
+        threads,
+        agentId,
+        conversation,
+        isDraft,
+        chat,
+    });
+    return (_jsx(AgentConversationContext.Provider, { value: {
+            agentId,
+            conversation,
+            isDraft,
+            threads: { ...threads, renameThread },
+            row,
+            isStandIn,
+            filters,
+            setFilters,
+            hasActiveFilters: Boolean(filters.status ?? filters.source),
+            notifyMessageSent,
+        }, children: children }));
+}
+export const useAgentConversationContext = () => {
+    const context = useContext(AgentConversationContext);
+    if (!context) {
+        throw new Error("useAgentConversationContext must be used within <AgentConversationProvider>.");
+    }
+    return context;
+};

package/dist/hooks/agent-thread-live-update.d.ts

@@ -1,94 +1,65 @@
-export type AgentThreadStatus = "idle" | "interrupted" | "error";
-export type AgentThreadSource = "direct_chat" | "agent_call" | "send_message" | "feedback" | "unknown";
+declare const THREAD_STATUSES: readonly ["idle", "interrupted", "waiting_on_agent", "busy", "error"];
+export type AgentThreadStatus = (typeof THREAD_STATUSES)[number];
+declare const THREAD_SOURCES: readonly ["direct_chat", "send_message", "feedback", "self_config_resume", "unknown"];
+export type AgentThreadSource = (typeof THREAD_SOURCES)[number] | "agent_call";
 export interface AgentThreadItem {
     agentId: string | null;
-    /** Never null — pass back verbatim to open the conversation. */
     chatId: string;
-    /** Never null — pass back verbatim to open the conversation. */
     chatThreadId: string;
     source: AgentThreadSource;
     status: AgentThreadStatus;
     title: string | null;
     turnCount: number;
-    /**
-     * What KIND of conversation this is — `"feedback"` for a thread opened by a feedback send,
-     * absent/null for an ordinary chat. Optional in the type, not on the wire: a server that
-     * predates it sends nothing, and `undefined` must read as "an ordinary chat", not as a
-     * missing field to work around.
-     */
     type?: string | null;
-    /**
-     * For a thread spawned from another conversation: that conversation's `chatThreadId` — pass
-     * it back verbatim to open the source, exactly like `chatThreadId` itself. Null when the
-     * source predates this field; a UI must then say where the thread came from without linking.
-     */
     fromSourceChatThreadId?: string | null;
-    /** The message the feedback was about, when it was about one rather than the conversation. */
     fromSourceMessageId?: string | null;
-    /** First seen by the index — NOT thread creation time. */
     firstSeenAt: string;
     lastActivityAt: string;
+    runningSince?: string | null;
+    runningRunId?: string | null;
 }
-/** The (chatId, chatThreadId) pair — the only stable identity of a thread row. */
 export declare const agentThreadKey: (thread: Pick<AgentThreadItem, "chatId" | "chatThreadId">) => string;
-/**
- * Whether a realtime payload's `thread` is a complete list-item row. The server
- * serializes the exact item shape into every event, so this normally passes; when
- * it doesn't (contract drift), the consumer falls back to the getOne endpoint.
- */
 export declare const isAgentThreadItem: (value: unknown) => value is AgentThreadItem;
-/**
- * Provisional row title from the prompt that started a conversation (ChatGPT-style):
- * one line, whitespace collapsed, capped like the server's generated titles. Null when
- * there's nothing usable (attachment-only sends) — the UI keeps its id-based fallback.
- */
 export declare const provisionalThreadTitle: (prompt: string | undefined) => string | null;
-/**
- * The optimistic row for a user send on `thread`, replacing `previous` (its current
- * optimistic entry, if any): the same identity, its recency bumped to `now`, and a title
- * that never regresses — the provisional title already shown, else the row's own, else
- * one from this prompt (null when the prompt has nothing usable).
- */
 export declare const optimisticThreadAfterSend: (thread: AgentThreadItem, previous: AgentThreadItem | undefined, prompt: string | undefined, now: string) => AgentThreadItem;
+export type RemovedAgentThread = Pick<AgentThreadItem, "chatId" | "chatThreadId" | "runningRunId">;
+export declare const removeAgentThread: (threads: AgentThreadItem[], optimistic: ReadonlyMap<string, AgentThreadItem>, removed: RemovedAgentThread) => {
+    threads: AgentThreadItem[];
+    optimistic: ReadonlyMap<string, AgentThreadItem>;
+} | null;
 export interface AgentThreadLiveUpdateOptions {
-    /** Active server-side filters — an updated row that stops matching leaves the list. */
     status?: AgentThreadStatus;
     source?: AgentThreadSource;
     chatId?: string;
-    /** Active sort, mirroring the endpoint's defaults (lastActivity, desc). */
     sort?: "lastActivity" | "firstSeen";
     order?: "asc" | "desc";
-    /** True when more pages exist server-side beyond the loaded window. */
     hasMore?: boolean;
 }
-/**
- * Merge one realtime thread update into a loaded list. Pure; returns the input array
- * untouched when the event is stale, filtered out, or out of the loaded window.
- *
- * - Out-of-order delivery can't regress a row: events older than the loaded row (by
- *   lastActivityAt) are dropped — checked FIRST, so a stale event can't evict a
- *   still-current row through the filter check below either. Renames keep
- *   lastActivityAt, so equal passes.
- * - A row that stops matching the active filters is removed; a matching one is upserted
- *   and the list re-sorted by the active sort (stable, so ties keep their server order).
- * - A NEW row sorting past every loaded row while more pages exist may belong beyond the
- *   loaded window; it's skipped so the list stays contiguous with the pagination cursor
- *   (unreachable under the default lastActivity-desc sort, where fresh activity sorts first).
- */
-/** Whether a row passes the list's active server-side filters. */
 export declare const matchesAgentThreadFilters: (item: AgentThreadItem, options?: AgentThreadLiveUpdateOptions) => boolean;
 export declare const applyAgentThreadUpdate: (threads: AgentThreadItem[], incoming: AgentThreadItem, options?: AgentThreadLiveUpdateOptions) => AgentThreadItem[];
-/**
- * Overlay optimistic rows (conversations the user just acted on, ChatGPT-style) onto the
- * loaded list. Each row goes through the same merge as a realtime event, so filters and
- * sorting apply — except that a server row still untitled borrows the optimistic
- * (prompt-derived) title until the generated one lands. Pure; returns `threads` untouched
- * when nothing changes.
- *
- * An entry steps aside once the loaded row has recorded MORE turns than it did: turnCount
- * is server-monotonic, so the handover can't be held off by a client clock running ahead
- * of the server (the entry's lastActivityAt is stamped locally, and the merge's staleness
- * guard compares it against server timestamps).
- */
+/** Parked removal for an in-flight refresh walk (see reconcileWalkWithLive). */
+export interface ParkedRemoval {
+    removed: RemovedAgentThread;
+}
+export declare const reconcileWalkWithLive: (items: AgentThreadItem[], live: ReadonlyMap<string, AgentThreadItem | ParkedRemoval>, options?: AgentThreadLiveUpdateOptions) => AgentThreadItem[];
 export declare const overlayOptimisticThreads: (threads: AgentThreadItem[], optimistic: ReadonlyMap<string, AgentThreadItem>, options?: AgentThreadLiveUpdateOptions) => AgentThreadItem[];
+export declare const retireOptimisticThreadsTakenOver: (optimistic: ReadonlyMap<string, AgentThreadItem>, threads: AgentThreadItem[]) => ReadonlyMap<string, AgentThreadItem>;
+/** The server's cap on a title a person sets (RENAME_TITLE_MAX_CHARS in wf-actions-py). */
+export declare const RENAME_TITLE_MAX_CHARS = 255;
+/** Conversation-index groups, in display order; a row's group follows its write-once `source`. */
+export declare const AGENT_THREAD_GROUPS: readonly ["chats", "workflows", "feedback"];
+export type AgentThreadGroup = (typeof AGENT_THREAD_GROUPS)[number];
+/** Where a row files; a source this copy predates files under chats, so a row never renders nowhere. */
+export declare const agentThreadGroup: (source: AgentThreadSource) => AgentThreadGroup;
+export interface AgentThreadGroupRows {
+    group: AgentThreadGroup;
+    rows: AgentThreadItem[];
+}
+/** Rows by group in group order, each group in input order; empty groups dropped. */
+export declare const groupAgentThreads: (threads: readonly AgentThreadItem[]) => AgentThreadGroupRows[];
+/** A thread the agent opened to act on feedback — by `type`, or by `source` for rows from before the column. */
+export declare const isFeedbackThread: (row: Pick<AgentThreadItem, "type" | "source">) => boolean;
+/** The conversation a feedback thread was opened from, when `threads` lists it (same chat, the row's pointer). */
+export declare const feedbackSourceThread: (row: AgentThreadItem, threads: readonly AgentThreadItem[]) => AgentThreadItem | undefined;
+export {};
 //# sourceMappingURL=agent-thread-live-update.d.ts.map