@datalayer/agent-runtimes 1.5.43 → 1.5.45

package/lib/apps/plugins/chat/ChatView.js

@@ -1702,8 +1702,8 @@ export default function ChatView({ workspace }) {
                     // opening stops it, and *Stop speaking* while it speaks.
                     speaking: speaking, onStopSpeaking: () => controlsRef.current?.stopSpeaking?.(), 
                     // Hands-free (VO-12, VO-13): the run in progress, stopped when
-                    // the person speaks over it.
-                    running: busy, onStopRun: () => controlsRef.current?.stop?.(), onInterimChange: setVoiceInterim, 
+                    // the person speaks over it, and the answer marked interrupted.
+                    running: busy, onStopRun: () => controlsRef.current?.stop?.(), onInterrupted: () => controlsRef.current?.markInterrupted(), onInterimChange: setVoiceInterim, 
                     // The menu offers when answers are heard where the
                     // application lets them be (VO-21, VO-30).
                     answers: Boolean(config?.voice?.output &&

package/lib/chat/ChatFloating.js

@@ -1030,7 +1030,7 @@ export function ChatFloating({ endpoint, protocol: protocolProp, useStore: useSt
                     ...poweredByProps,
                 }, description: description, onStateUpdate: onStateUpdate, onNewChat: onNewChat, suggestions: suggestions, submitOnSuggestionClick: submitOnSuggestionClick, hideMessagesAfterToolUI: hideMessagesAfterToolUI, avatarConfig: {
                     showAvatars: true,
-                }, placeholder: "Type a message...", backgroundColor: "canvas.subtle", frontendTools: frontendTools, showModelSelector: showModelSelector, availableModels: availableModels, showToolsMenu: showToolsMenu, showSkillsMenu: showSkillsMenu, showTokenUsage: showTokenUsage, showContextRing: showContextRing, runtimeId: runtimeId, historyEndpoint: historyEndpoint, historyAuthToken: historyAuthToken, pendingPrompt: pendingPrompt ?? suggestionPrompt, inspector: inspector, showInformation: showInformation, onInformationClick: onInformationClick, onToolCallStart: onToolCallStart, onToolCallComplete: onToolCallComplete, showToolApprovalBanner: showToolApprovalBanner, pendingApprovals: pendingApprovals, onApproveApproval: onApproveApproval, onRejectApproval: onRejectApproval, voice: voice, voiceSpeaking: speakerState.speaking, onStopSpeaking: speaker ? stopSpeaking : undefined, onReadAloud: speaker ? readAnswerAloud : undefined, ...panelProps, ...assistantChat, onLoadingChange: handleLoadingChange, onDisplayItemsChange: handleDisplayItemsChange, onSendReady: handleSendReady, children: conversationBalloon && currentOpen ? (
+                }, placeholder: "Type a message...", backgroundColor: "canvas.subtle", frontendTools: frontendTools, showModelSelector: showModelSelector, availableModels: availableModels, showToolsMenu: showToolsMenu, showSkillsMenu: showSkillsMenu, showTokenUsage: showTokenUsage, showContextRing: showContextRing, runtimeId: runtimeId, historyEndpoint: historyEndpoint, historyAuthToken: historyAuthToken, pendingPrompt: pendingPrompt ?? suggestionPrompt, inspector: inspector, showInformation: showInformation, onInformationClick: onInformationClick, onToolCallStart: onToolCallStart, onToolCallComplete: onToolCallComplete, showToolApprovalBanner: showToolApprovalBanner, pendingApprovals: pendingApprovals, onApproveApproval: onApproveApproval, onRejectApproval: onRejectApproval, voice: voice, voiceSpeaking: speakerState.speaking, voiceSentence: speakerState.sentence, onStopSpeaking: speaker ? stopSpeaking : undefined, onReadAloud: speaker ? readAnswerAloud : undefined, ...panelProps, ...assistantChat, onLoadingChange: handleLoadingChange, onDisplayItemsChange: handleDisplayItemsChange, onSendReady: handleSendReady, children: conversationBalloon && currentOpen ? (
                 // Current: the one thing said or done now, over the composer.
                 _jsx(Box, { px: 3, pt: 3, pb: 2, overflow: "hidden", children: _jsx(CurrentBalloonBody, { text: toolSaid ? undefined : (currentWords ?? description), fullText: toolSaid ? undefined : currentWhole, tool: toolSaid, busy: atWork, speaking: answering && atWork, waiting: atWork && !answering }) })) : (children) }))] }));
     /*

package/lib/chat/ChatInline.js

@@ -6,7 +6,18 @@ import { CopyIcon, ArrowLeftIcon, SyncIcon, TrashIcon, CheckIcon, PlusIcon, Penc
 import { SparklesIcon } from '@datalayer/icons-react';
 import { AGUIAdapter } from '../protocols';
 import { generateMessageId } from '../types/messages';
-import { sanitizeAssistantContent } from '../utils';
+import { BROWSER_LIMITS, emptyConversation, reduceConversation, } from '../portable/conversation';
+import { conversationEventsOf } from '../portable/adapterEvents';
+/** The answer so far: the newest assistant message of the conversation. */
+function answerOf(state) {
+    for (let index = state.items.length - 1; index >= 0; index -= 1) {
+        const item = state.items[index];
+        if (item.kind === 'message' && item.role === 'assistant') {
+            return item.text;
+        }
+    }
+    return '';
+}
 /**
  * Pre-defined AI action groups
  */
@@ -79,8 +90,15 @@ export function ChatInline({ selectedText, protocol, onReplaceSelection, onInser
     const [input, setInput] = useState('');
     // AI state
     const [aiState, setAiState] = useState('initial');
-    // AI response content
-    const [aiResponse, setAiResponse] = useState('');
+    // The one-shot conversation (MOBILE M-030): `reduceConversation`'s, as in
+    // ChatBase and on the phone; the response is its newest assistant message.
+    const [conversation, setConversation] = useState(() => emptyConversation(BROWSER_LIMITS));
+    const conversationRef = useRef(conversation);
+    const changeConversation = useCallback((next) => {
+        conversationRef.current = next;
+        setConversation(next);
+    }, []);
+    const aiResponse = useMemo(() => answerOf(conversation), [conversation]);
     // Previous prompt for regeneration
     const [previousPrompt, setPreviousPrompt] = useState('');
     // Current page in options menu (for sub-menus like translate)
@@ -112,20 +130,23 @@ export function ChatInline({ selectedText, protocol, onReplaceSelection, onInser
         adapterRef.current = adapter;
         // Subscribe to events
         unsubscribeRef.current = adapter.subscribe((event) => {
-            switch (event.type) {
-                case 'message':
-                    if (event.message?.content) {
-                        const content = typeof event.message.content === 'string'
-                            ? sanitizeAssistantContent(event.message.content)
-                            : '';
-                        setAiResponse(content);
-                    }
-                    break;
-                case 'error':
-                    console.error('[ChatInline] Protocol error:', event.error);
-                    setError(event.error?.message || 'Unknown error');
-                    setAiState('initial');
-                    break;
+            if (event.type === 'error') {
+                console.error('[ChatInline] Protocol error:', event.error);
+                setError(event.error?.message || 'Unknown error');
+                setAiState('initial');
+                return;
+            }
+            // The event, as the conversation reads it: one reducer whatever the protocol.
+            try {
+                const inputs = conversationEventsOf(event, conversationRef.current);
+                if (inputs.length) {
+                    changeConversation(inputs.reduce((kept, input) => reduceConversation(kept, input), conversationRef.current));
+                }
+            }
+            catch (failure) {
+                console.error('[ChatInline] Protocol event not read:', failure);
+                setError(failure instanceof Error ? failure.message : String(failure));
+                setAiState('initial');
             }
         });
         // Connect
@@ -134,7 +155,7 @@ export function ChatInline({ selectedText, protocol, onReplaceSelection, onInser
             unsubscribeRef.current?.();
             adapterRef.current?.disconnect();
         };
-    }, [protocol]);
+    }, [protocol, changeConversation]);
     // Submit prompt to AI
     const submitPrompt = useCallback(async (prompt) => {
         if (!adapterRef.current) {
@@ -145,7 +166,7 @@ export function ChatInline({ selectedText, protocol, onReplaceSelection, onInser
         setInput('');
         setPreviousPrompt(prompt);
         setError(null);
-        setAiResponse('');
+        changeConversation(emptyConversation(BROWSER_LIMITS));
         // Build system message with selected text context
         const systemContext = `Do not surround your answer in quote marks. Only return the answer, nothing else. The user is selecting this text:
 
@@ -178,7 +199,7 @@ ${selectedText || ''}
             setError(err.message);
             setAiState('initial');
         }
-    }, [selectedText]);
+    }, [selectedText, changeConversation]);
     // Handle pending prompt from toolbar dropdown
     useEffect(() => {
         if (pendingPrompt && aiState === 'initial') {
@@ -235,8 +256,8 @@ ${selectedText || ''}
     // Handle back to options
     const handleBackToOptions = useCallback(() => {
         setAiState('initial');
-        setAiResponse('');
-    }, []);
+        changeConversation(emptyConversation(BROWSER_LIMITS));
+    }, [changeConversation]);
     // Handle discard
     const handleDiscard = useCallback(() => {
         onClose?.();

package/lib/chat/base/ChatBase.js

@@ -25,7 +25,7 @@ import { SkeletonText } from '@primer/react/experimental';
 import { SidebarExpandIcon } from '@primer/octicons-react';
 import { notebookStore, JupyterReactTheme } from '@datalayer/jupyter-react';
 import { Box, setupPrimerPortals, useThemeStore, getColorPalette, getThemeConfig, useSystemColorMode, } from '@datalayer/primer-addons';
-import { AlertIcon, PersonIcon } from '@primer/octicons-react';
+import { AlertIcon, PersonIcon, UnmuteIcon } from '@primer/octicons-react';
 import { AiAgentIcon } from '@datalayer/icons-react';
 import { QueryClientProvider, QueryClientContext } from '@tanstack/react-query';
 import { useCoreStore } from '@datalayer/core';
@@ -52,11 +52,14 @@ import { EphemeralSurfaceControl } from '../EphemeralSurfaceControl';
 import { ChatMessageList, } from '../messages/ChatMessageList';
 import { InputPrompt } from '../prompt/InputPrompt';
 import { ComposerVoice, spokenOf } from '../../voice/ComposerVoice';
+import { answerSpokenOver } from '../../voice/handsFree';
 import { ReadAloud, readsAloud } from '../../voice/ReadAloud';
 import { settledVoice } from '../../voice/chatVoice';
 import { useVoiceSettings } from '../../voice/useVoiceSettings';
 import { useVoiceSpeaker } from '../../voice/useVoiceSpeaker';
 import { useSpokenAnswers } from '../../voice/useSpokenAnswers';
+import { saidMessageId, useSaidSentence } from '../../voice/captions';
+import { lineToSay } from '../../voice/sayAloud';
 import { isFloatingChatViewMode } from '../viewModes';
 import { ToolApprovalBanner, ToolApprovalDialog, } from '../tools';
 import { initialModelId, isOffered, offeredModels as offeredModelsFor, } from './modelChoice';
@@ -423,7 +426,7 @@ function ChatBaseInner({ title, subtitle, showHeader = false, showTokenUsage = t
 // Mode selection
 useStore: useStoreMode = true, protocol: protocolRaw, onSendMessage, onSendReady, onLoadingChange, onSpeakingChange, onContextSnapshot, enableStreaming = false, 
 // Extended props
-brandIcon, avatarConfig, headerButtons, showPoweredBy = false, poweredByProps, emptyState, renderHeader, showTurnFooter = true, notebookToolSurfacesId, footerContent, welcome, trailingContent, voice, voiceSpeaking = false, onStopSpeaking, onReadAloud, showInformation = false, onInformationClick, headerContent, children, borderRadius, backgroundColor, border, boxShadow, compact = false, placeholder, description = 'Start a conversation with the AI agent.', onStateUpdate, onNewChat, onClear, onMessagesChange, onItemsChange, onDisplayItemsChange, autoFocus = false, suggestions, submitOnSuggestionClick = true, hideMessagesAfterToolUI = false, focusTrigger, frontendTools: frontendToolsProp, enableEphemeralNotebook = false, initialEphemeralNotebookOpen = true, onEphemeralNotebookOpenChange, enableEphemeralDocument = false, initialEphemeralSurfaceMode, onEphemeralSurfaceModeChange, collapsed = false, onExpandFromCollapsed, ephemeralNotebookToolbar, ephemeralNotebookToolbarExtraItems, ephemeralDocumentToolbarExtraItems, ephemeralNotebookCollaborationProvider, ephemeralNotebookCollaborationDocumentId, ephemeralDocumentCollaboration, ephemeralRuntimeOverride, 
+brandIcon, avatarConfig, headerButtons, showPoweredBy = false, poweredByProps, emptyState, renderHeader, showTurnFooter = true, notebookToolSurfacesId, footerContent, welcome, trailingContent, voice, voiceSpeaking = false, voiceSentence, onStopSpeaking, onReadAloud, showInformation = false, onInformationClick, headerContent, children, borderRadius, backgroundColor, border, boxShadow, compact = false, placeholder, description = 'Start a conversation with the AI agent.', onStateUpdate, onNewChat, onClear, onMessagesChange, onItemsChange, onDisplayItemsChange, autoFocus = false, suggestions, submitOnSuggestionClick = true, hideMessagesAfterToolUI = false, focusTrigger, frontendTools: frontendToolsProp, enableEphemeralNotebook = false, initialEphemeralNotebookOpen = true, onEphemeralNotebookOpenChange, enableEphemeralDocument = false, initialEphemeralSurfaceMode, onEphemeralSurfaceModeChange, collapsed = false, onExpandFromCollapsed, ephemeralNotebookToolbar, ephemeralNotebookToolbarExtraItems, ephemeralDocumentToolbarExtraItems, ephemeralNotebookCollaborationProvider, ephemeralNotebookCollaborationDocumentId, ephemeralDocumentCollaboration, ephemeralRuntimeOverride, 
 // Tool invocation hooks
 onToolCallStart, onToolCallComplete, inspector: inspectorGiven, 
 // Identity/Authorization props
@@ -1819,6 +1822,8 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
         recorderRef.current = null;
     }
     const inspectAnswerRef = useRef('');
+    // A line the agent says aloud, from a run's `voice.say` (VOICE.md VO-35).
+    const voiceSayRef = useRef(undefined);
     const handleRespondRef = useRef(null);
     // A decision made outside the chat — a host page's own approval banner —
     // is answered exactly as the tool card's buttons answer it: through the
@@ -2801,6 +2806,9 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
                     // What the server says besides the conversation's text comes on
                     // the ui socket (REACTOR_UI RU-W); the run's own — `loop.session`
                     // among them — are the conversation's.
+                    if (event.activity) {
+                        voiceSayRef.current?.(event.activity);
+                    }
                     read();
                     break;
                 case 'done':
@@ -2968,8 +2976,45 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
     const ownVoice = useVoiceSpeaker(settled, !hostSpeaks);
     useSpokenAnswers(displayItems, isLoading, !hostSpeaks && settled?.output === 'always', ownVoice.speaker);
     const speakingNow = voiceSpeaking || ownVoice.state.speaking;
+    // The sentence being said, marked in the conversation (VO-65).
+    const sentenceSaid = hostSpeaks ? voiceSentence : ownVoice.state.sentence;
+    const saidConversationRef = useRef(null);
+    useSaidSentence(saidConversationRef, sentenceSaid, displayItems);
+    /*
+     * A line the agent wants heard, not written (VO-35): a caption while the
+     * run goes on, said by the speaker where answers are said by themselves.
+     */
+    const [voiceSaid, setVoiceSaid] = useState('');
+    voiceSayRef.current = activity => {
+        const line = lineToSay(activity);
+        if (!line) {
+            return;
+        }
+        setVoiceSaid(line);
+        if (settled?.output === 'always') {
+            if (onReadAloud) {
+                onReadAloud(line);
+            }
+            else {
+                ownVoice.speaker?.say(line);
+            }
+        }
+    };
+    useEffect(() => {
+        if (!isLoading) {
+            setVoiceSaid('');
+        }
+    }, [isLoading]);
     // Answers spoken over, hands-free (VOICE.md VO-13): marked *interrupted*.
     const [interruptedIds, setInterruptedIds] = useState(() => new Set());
+    // The conversation as shown, read when the person speaks over an answer.
+    const shownItemsRef = useRef([]);
+    const markInterrupted = useCallback(() => {
+        const spokenOver = answerSpokenOver(shownItemsRef.current.filter((item) => !isToolCallMessage(item)));
+        if (spokenOver) {
+            setInterruptedIds(ids => new Set([...ids, spokenOver]));
+        }
+    }, []);
     const stopSpeaking = onStopSpeaking ?? (ownVoice.speaker ? ownVoice.stop : undefined);
     const readAnswerAloud = onReadAloud ?? (ownVoice.speaker ? ownVoice.read : undefined);
     const handleSend = useCallback(async (messageOverride, 
@@ -3339,6 +3384,8 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
             thread: () => threadIdRef.current,
             // Its speaker, for a host whose composer holds the microphone (VO-10).
             stopSpeaking,
+            // The answer spoken over, marked for a host's own composer (VO-13).
+            markInterrupted,
         });
         return () => {
             onSendReady(null);
@@ -3351,6 +3398,7 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
         handleStop,
         handleNewChat,
         stopSpeaking,
+        markInterrupted,
     ]);
     // Streaming state, for a host that draws the prompt.
     useEffect(() => {
@@ -3717,6 +3765,8 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
             ...displayItems,
         ]
         : displayItems;
+    shownItemsRef.current = welcomedItems;
+    const saidId = saidMessageId(welcomedItems, sentenceSaid);
     /*
      * *Read aloud* under each answer the agent has finished (VOICE.md VO-21),
      * when the host reads answers aloud on request.
@@ -3732,7 +3782,7 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
             return (_jsxs(_Fragment, { children: [interruptedIds.has(message.id) ? (_jsx(Text, { sx: { fontSize: 0, color: 'fg.muted', fontStyle: 'italic' }, "data-interrupted": "", children: "interrupted" })) : null, readAnswerAloud && readsAloud(message, text, writingId) ? (_jsx(ReadAloud, { onRead: () => readAnswerAloud(text) })) : null] }));
         }
         : undefined;
-    const messagesContent = children ? (children) : (_jsxs(Box, { display: "flex", flexDirection: "column", minHeight: 0, 
+    const messagesContent = children ? (children) : (_jsxs(Box, { ref: saidConversationRef, display: "flex", flexDirection: "column", minHeight: 0, 
         /*
             A reading column, not a full-bleed sheet.
   
@@ -3745,16 +3795,12 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
                 // Tool calls are drawn by the page's Reactor plugins; a named
                 // notebook's cell surfaces stand in for the default row of its tools,
                 // so every chat with a headless notebook gets the same transcript.
-                notebookToolSurfacesId: notebookToolSurfacesId, approvalConfig: approvalConfig, messagesEndRef: messagesEndRef, onRespond: handleRespond, showTurnFooters: showTurnFooter, renderMessageFooter: readAloudFooter, agentUsage: agentUsage, onRemoveItems: handleRemoveItems, mcpServers: filteredMcpServers, emptyContent: launching ? null : (_jsx(ChatEmptyState, { emptyState: emptyState, brandIcon: brandIcon, description: resolvedDescription, suggestions: resolvedSuggestions, submitOnSuggestionClick: submitOnSuggestionClick, onSuggestionSubmit: handleSuggestionSubmit, onSuggestionFill: handleSuggestionFill })) }), trailingContent] }));
+                notebookToolSurfacesId: notebookToolSurfacesId, approvalConfig: approvalConfig, messagesEndRef: messagesEndRef, onRespond: handleRespond, showTurnFooters: showTurnFooter, renderMessageFooter: readAloudFooter, saidMessageId: saidId, agentUsage: agentUsage, onRemoveItems: handleRemoveItems, mcpServers: filteredMcpServers, emptyContent: launching ? null : (_jsx(ChatEmptyState, { emptyState: emptyState, brandIcon: brandIcon, description: resolvedDescription, suggestions: resolvedSuggestions, submitOnSuggestionClick: submitOnSuggestionClick, onSuggestionSubmit: handleSuggestionSubmit, onSuggestionFill: handleSuggestionFill })) }), trailingContent] }));
     // The microphone, in the composer's footer (VO-10, VO-11).
     const voiceControl = settled && settled.input !== 'off' ? (_jsx(ComposerVoice, { voice: settled, input: input, setInput: setInput, disabled: disabled || launching, speaking: speakingNow, onStopSpeaking: stopSpeaking, 
         // Hands-free (VO-12, VO-13): the run in progress, stopped when the
         // person speaks over it, and the answer marked interrupted.
-        running: isLoading, onStopRun: handleStop, onInterrupted: () => {
-            if (writingId) {
-                setInterruptedIds(ids => new Set([...ids, writingId]));
-            }
-        }, onInterimChange: setVoiceInterim, 
+        running: isLoading, onStopRun: handleStop, onInterrupted: markInterrupted, onInterimChange: setVoiceInterim, 
         // The menu offers when answers are heard where the application
         // lets them be (VO-21, VO-30).
         answers: Boolean(voice?.output && voice.output !== 'off' && voice.speechUrl), onSpoken: metadata => {
@@ -3762,7 +3808,17 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
         }, send: (text, metadata) => void handleSend(text, undefined, metadata) })) : undefined;
     // Why an answer could not be heard, in a sentence, by the composer.
     const voiceRefused = !hostSpeaks && ownVoice.state.refused ? (_jsx(Text, { role: "alert", sx: { fontSize: 0, color: 'danger.fg', maxWidth: 260 }, "data-voice-refused": "", children: ownVoice.state.refused })) : null;
-    const inputToolbar = showInput ? (_jsx(InputPrompt, { footerExtras: voiceRefused ? (_jsxs(_Fragment, { children: [voiceRefused, voiceControl] })) : (voiceControl), interim: voiceInterim, input: input, setInput: setInput, isLoading: isLoading, kernelStatus: liveKernelStatus, connectionConfirmed: connectionConfirmed, placeholder: placeholder, 
+    // The line said aloud, written as it is said: captions always (VO-65).
+    const voiceSayCaption = voiceSaid ? (_jsxs(Text, { "aria-live": "polite", sx: {
+            fontSize: 0,
+            fontStyle: 'italic',
+            color: 'fg.muted',
+            maxWidth: 260,
+            display: 'inline-flex',
+            alignItems: 'center',
+            gap: 1,
+        }, "data-voice-say": "", children: [_jsx(UnmuteIcon, { size: 12, "aria-label": "Said aloud" }), voiceSaid] })) : null;
+    const inputToolbar = showInput ? (_jsx(InputPrompt, { footerExtras: voiceRefused || voiceSayCaption ? (_jsxs(_Fragment, { children: [voiceSayCaption, voiceRefused, voiceControl] })) : (voiceControl), interim: voiceInterim, input: input, setInput: setInput, isLoading: isLoading, kernelStatus: liveKernelStatus, connectionConfirmed: connectionConfirmed, placeholder: placeholder, 
         /*
           The same openers the empty state offers, typed into the box they would
           be typed into.

package/lib/chat/messages/ChatMessageList.d.ts

@@ -78,6 +78,12 @@ export interface ChatMessageListProps {
      * `note`, which has no footer of its own.
      */
     renderMessageFooter?: (message: ChatMessage) => ReactNode;
+    /**
+     * The answer a sentence is being said from (VOICE.md VO-65): its row is
+     * marked `aria-current` and `data-voice-saying`, with a bar beside it —
+     * the sentence itself is underlined by `useSaidSentence`.
+     */
+    saidMessageId?: string;
     /**
      * The MCP servers the agent has, with the tools each serves: a tool call is
      * drawn with the marks of the server it belongs to. Skills, frontend tools
@@ -109,5 +115,5 @@ export interface SubagentChatPanelProps {
  * approval decisions are sent over the shared monitoring socket.
  */
 export declare function SubagentChatPanel({ toolCallId, subagentName: subagentNameHint, height, avatarConfig, }: SubagentChatPanelProps): React.ReactElement | null;
-export declare function ChatMessageList({ displayItems, actOn, upload, isLoading, isStreaming, showLoadingIndicator, hideMessagesAfterToolUI, avatarConfig, padding, notebookToolSurfacesId, emptyContent, messagesEndRef, onRespond, approvalConfig, showTurnFooters, agentUsage, onRemoveItems, renderMessageFooter, mcpServers, density, }: ChatMessageListProps): import("react").JSX.Element;
+export declare function ChatMessageList({ displayItems, actOn, upload, isLoading, isStreaming, showLoadingIndicator, hideMessagesAfterToolUI, avatarConfig, padding, notebookToolSurfacesId, emptyContent, messagesEndRef, onRespond, approvalConfig, showTurnFooters, agentUsage, onRemoveItems, renderMessageFooter, saidMessageId, mcpServers, density, }: ChatMessageListProps): import("react").JSX.Element;
 export {};

package/lib/chat/messages/ChatMessageList.js

@@ -366,7 +366,7 @@ function DefaultToolCallRenderer({ item, onRespond, mcpServers, density, }) {
 // ---------------------------------------------------------------------------
 // Component
 // ---------------------------------------------------------------------------
-export function ChatMessageList({ displayItems, actOn, upload, isLoading, isStreaming, showLoadingIndicator, hideMessagesAfterToolUI, avatarConfig, padding, notebookToolSurfacesId, emptyContent, messagesEndRef, onRespond, approvalConfig, showTurnFooters = false, agentUsage, onRemoveItems, renderMessageFooter, mcpServers, density = 'comfortable', }) {
+export function ChatMessageList({ displayItems, actOn, upload, isLoading, isStreaming, showLoadingIndicator, hideMessagesAfterToolUI, avatarConfig, padding, notebookToolSurfacesId, emptyContent, messagesEndRef, onRespond, approvalConfig, showTurnFooters = false, agentUsage, onRemoveItems, renderMessageFooter, saidMessageId, mcpServers, density = 'comfortable', }) {
     /*
      * Who draws a tool call: the Reactor plugins of the page, when it has a
      * platform. Each plugin binds its own tools (`ToolBindings`) and renders its
@@ -541,7 +541,13 @@ export function ChatMessageList({ displayItems, actOn, upload, isLoading, isStre
         }
         // The host's footer, asked once: a row only when it draws something.
         const messageFooter = renderMessageFooter?.(message);
-        return (_jsx(Box, { "data-chat-message": message.role, display: "flex", flexDirection: "column", alignItems: isUser ? 'flex-end' : 'flex-start', px: padding, py: compact ? '2px' : 1, children: _jsxs(Box, { display: "flex", gap: 2, flexDirection: isUser ? 'row-reverse' : 'row', alignItems: "flex-start", 
+        // The answer being said (VO-65): marked by a bar and for assistive tech.
+        const said = saidMessageId !== undefined && message.id === saidMessageId;
+        return (_jsx(Box, { "data-chat-message": message.role, "data-voice-saying": said ? '' : undefined, "aria-current": said ? 'true' : undefined, sx: said
+                ? {
+                    boxShadow: 'inset 3px 0 0 var(--borderColor-accent-emphasis, #0969da)',
+                }
+                : undefined, display: "flex", flexDirection: "column", alignItems: isUser ? 'flex-end' : 'flex-start', px: padding, py: compact ? '2px' : 1, children: _jsxs(Box, { display: "flex", gap: 2, flexDirection: isUser ? 'row-reverse' : 'row', alignItems: "flex-start", 
                 /*
                         Full width, always.
       

package/lib/components/agents/AgentSummary.d.ts

@@ -1,28 +1,6 @@
 import React from 'react';
-export interface AgentSummaryData {
-    agentName: string;
-    location: string;
-    specId?: string;
-    /**
-     * The framework turning this agent's loop, as its spec declares it —
-     * `pydantic-ai` server-side, `vercel-ai` in the page.
-     */
-    harness?: string;
-    /**
-     * The runtime variant the host chose: `<location>-<harness>`.
-     *
-     * Shown next to the harness rather than instead of it, because they answer
-     * different questions and can disagree: the harness is what the spec asked
-     * for, the variant is what it actually got.
-     */
-    variant?: string;
-    status?: string;
-    baseUrl?: string;
-    sandboxBaseUrl?: string;
-    agentId?: string;
-    isReady?: boolean;
-    error?: string;
-}
+import { type AgentSummaryData } from '../../portable/runtimes';
+export type { AgentSummaryData } from '../../portable/runtimes';
 export interface AgentSummaryProps {
     summary: AgentSummaryData | null;
     title?: string;

package/lib/components/agents/AgentSummary.js

@@ -7,19 +7,7 @@ import { useEffect, useRef, useState } from 'react';
 import { Spinner } from '@primer/react';
 import { Box } from '@datalayer/primer-addons';
 import { strip } from '@datalayer/core/lib/utils';
-/**
- * Statuses that represent an agent actively being created/started. The spinner
- * only shows for these; app-navigation states ("selected", "switching") and
- * settled states ("ready", "running", ...) never spin.
- */
-const CREATING_STATUSES = new Set([
-    'creating',
-    'starting',
-    'launching',
-    'connecting',
-    'pending',
-    'resuming',
-]);
+import { isCreatingAgent, } from '../../portable/runtimes';
 const MAX_AGENT_NAME_LENGTH = 32;
 const toSandboxStatusUrl = (value) => {
     const raw = String(value || '').trim();
@@ -95,12 +83,8 @@ export const AgentSummary = ({ summary, title = 'Active Agent', }) => {
     if (!summary) {
         return null;
     }
-    const normalizedStatus = (summary.status || '').toLowerCase();
-    // Only show the spinner while the agent is genuinely being created: it is not
-    // ready, has no id yet, and its status is an active creation/startup state.
-    const isCreating = !summary.isReady &&
-        !summary.agentId &&
-        CREATING_STATUSES.has(normalizedStatus);
+    // Only show the spinner while the agent is genuinely being created.
+    const isCreating = isCreatingAgent(summary);
     const hasError = Boolean(summary.error);
     // The agent is optional: some examples run only a code sandbox. Show the
     // agent status when there is an agent (or one is being created).