@datalayer/agent-runtimes 1.5.42 → 1.5.44

package/lib/apps/apps/sessionRules.d.ts

@@ -61,8 +61,21 @@ export declare const SESSION_RULES_WORDS: {
     readonly goneWithSession: "In force at once, for this session only; gone when it ends.";
     readonly unavailable: (sentence: string) => string;
 };
-/** A rule in words: *writing, sending: leave it to me*. */
+/** Where a file rule holds, in words (SHIELD decision 5). */
+export declare const WHERE_WORDS: Record<'inside' | 'outside', string>;
+/**
+ * A rule in words: *writing, sending: leave it to me*; with decision 5's file
+ * and shell wording when it says where or what (SHIELD SH-43) — *writing
+ * inside the workspace (src/**): do it*, *running `git push`: ask me first*.
+ */
 export declare function sessionRuleInWords(rule: SessionRule): string;
+/**
+ * Decision 5's file and shell rules, offered on a running session in the
+ * Shield's own words: each one a rule a person adds as it stands, and the
+ * runtime refuses one that would loosen what the organization says
+ * (SHIELD §6.2, §6.3).
+ */
+export declare const FILE_AND_SHELL_RULES: readonly SessionRule[];
 /** What the person typed, as the rule the runtime takes; a sentence when it cannot be one. */
 export declare function sessionRuleOf(input: {
     name: string;

package/lib/apps/apps/sessionRules.js

@@ -54,12 +54,78 @@ export const SESSION_RULES_WORDS = {
     goneWithSession: 'In force at once, for this session only; gone when it ends.',
     unavailable: (sentence) => `Nothing is decided right now: ${sentence}`,
 };
-/** A rule in words: *writing, sending: leave it to me*. */
+/** Where a file rule holds, in words (SHIELD decision 5). */
+export const WHERE_WORDS = {
+    inside: 'inside the workspace',
+    outside: 'outside the workspace',
+};
+/**
+ * A rule in words: *writing, sending: leave it to me*; with decision 5's file
+ * and shell wording when it says where or what (SHIELD SH-43) — *writing
+ * inside the workspace (src/**): do it*, *running `git push`: ask me first*.
+ */
 export function sessionRuleInWords(rule) {
     const classes = (rule.classes ?? []).map(item => SESSION_RULES_WORDS.classes[item] ?? item);
-    const covers = classes.length > 0 ? classes.join(', ') : 'everything';
+    let covers = classes.length > 0 ? classes.join(', ') : 'everything';
+    if (rule.where === 'inside' || rule.where === 'outside') {
+        covers = `${covers} ${WHERE_WORDS[rule.where]}`;
+    }
+    if (rule.paths && rule.paths.length > 0) {
+        covers = `${covers} (${rule.paths.join(', ')})`;
+    }
+    if (rule.commands && rule.commands.length > 0) {
+        covers = `${covers} matching ${rule.commands.map(command => `\`${command}\``).join(' or ')}`;
+    }
     return `${covers}: ${SESSION_RULES_WORDS.decisions[rule.decision]}`;
 }
+/**
+ * Decision 5's file and shell rules, offered on a running session in the
+ * Shield's own words: each one a rule a person adds as it stands, and the
+ * runtime refuses one that would loosen what the organization says
+ * (SHIELD §6.2, §6.3).
+ */
+export const FILE_AND_SHELL_RULES = [
+    {
+        name: 'Edit inside the workspace',
+        decision: 'allow',
+        classes: ['write'],
+        where: 'inside',
+    },
+    {
+        name: 'Ask before deleting a file',
+        decision: 'ask',
+        classes: ['delete'],
+    },
+    {
+        name: 'Ask before running a command',
+        decision: 'ask',
+        classes: ['execute'],
+    },
+    {
+        name: 'Leave files outside the workspace to me',
+        decision: 'deny',
+        classes: ['read', 'write', 'delete'],
+        where: 'outside',
+    },
+    {
+        name: 'Ask before git push',
+        decision: 'ask',
+        classes: ['execute'],
+        commands: ['^git\\s+push\\b'],
+    },
+    {
+        name: 'Ask before installing a package',
+        decision: 'ask',
+        classes: ['execute'],
+        commands: ['\\b(pip|npm|uv|yarn|apt(-get)?)\\s+(install|add)\\b'],
+    },
+    {
+        name: 'Leave sudo to me',
+        decision: 'deny',
+        classes: ['execute'],
+        commands: ['^sudo\\b'],
+    },
+];
 /** What the person typed, as the rule the runtime takes; a sentence when it cannot be one. */
 export function sessionRuleOf(input) {
     const name = input.name.trim();

package/lib/apps/core/canvasParts.d.ts

@@ -1,5 +1,5 @@
 /** The kinds of part an agent is built from on the Canvas. */
-export type CanvasPartKind = 'connection' | 'rule' | 'skill' | 'test' | 'event' | 'model' | 'protocol' | 'ui' | 'character';
+export type CanvasPartKind = 'agent' | 'connection' | 'rule' | 'skill' | 'test' | 'event' | 'model' | 'protocol' | 'ui' | 'character';
 /**
  * A part of an agent the Canvas may place (LOOP C-20): a connection to a
  * server of the catalogue, a skill, a model, a rule, a test, an event, a
@@ -18,6 +18,12 @@ export type CanvasPartContribution = {
     /** One line of what it is. */
     says: string;
     emoji?: string;
+    /**
+     * The harness it runs on, for an agent part (SHIELD SH-43): the catalogue
+     * harness's id, whose terms, credential and what it honours the Properties
+     * panel reads from `specs/harnesses`.
+     */
+    harness?: string;
     /**
      * What it arrives with, spelled as the Appspec's text spells it: a
      * connection's, a rule's, a test's or an event's object, a skill's, a

package/lib/apps/plugins/app-rules/AppRulesCard.js

@@ -5,7 +5,7 @@ import { Box } from '@datalayer/primer-addons';
 import { useIAMStore } from '@datalayer/core/lib/state/substates/IAMState';
 import { agentServerOf } from '../../core';
 import { BEHAVIOUR_WORDS, coverOf } from '../../apps/rules';
-import { SESSION_RULES_WORDS, SESSION_RULE_CLASSES, SESSION_RULE_DECISIONS, addSessionRule, readSessionRules, removeSessionRule, sessionRuleInWords, sessionRuleOf, } from '../../apps/sessionRules';
+import { FILE_AND_SHELL_RULES, SESSION_RULES_WORDS, SESSION_RULE_CLASSES, SESSION_RULE_DECISIONS, addSessionRule, readSessionRules, removeSessionRule, sessionRuleInWords, sessionRuleOf, } from '../../apps/sessionRules';
 import { SAVE_WORDS, draftOfApproval } from '../../apps/saved';
 import { useApproveToolRequest, useRejectToolRequest, useToolApprovalsQuery, } from '../../../hooks/useToolApprovals';
 /** What the card says. */
@@ -105,7 +105,7 @@ export function SessionRules({ agentServerUrl, sessionUid, token, }) {
         }
         void act(() => addSessionRule(agentServerUrl, token, sessionUid, rule)).then(() => setName(''));
     };
-    return (_jsxs(Box, { "data-testid": "session-rules", mt: 3, children: [_jsx(Heading, { as: "h4", sx: { fontSize: 1, mb: 1 }, children: SESSION_RULES_WORDS.title }), inForce?.unavailable ? (_jsx(Text, { as: "p", role: "alert", sx: { fontSize: 0, m: 0, mb: 1 }, children: SESSION_RULES_WORDS.unavailable(inForce.unavailable) })) : null, inForce && inForce.session_rules.length === 0 ? (_jsx(Text, { as: "p", sx: { fontSize: 1, color: 'fg.muted', m: 0 }, children: SESSION_RULES_WORDS.none })) : (_jsx(Box, { as: "ul", listStyle: "none", p: 0, m: 0, children: (inForce?.session_rules ?? []).map(rule => (_jsxs(Box, { as: "li", py: 1, fontSize: 1, display: "flex", gap: 2, alignItems: "center", children: [_jsx(Text, { sx: { fontWeight: 'semibold' }, children: rule.name }), _jsx(Text, { sx: { color: 'fg.muted', fontSize: 0 }, children: sessionRuleInWords(rule) }), _jsx(Button, { size: "small", variant: "invisible", disabled: busy, onClick: () => void act(() => removeSessionRule(agentServerUrl, token, sessionUid, rule.name)), children: SESSION_RULES_WORDS.remove })] }, rule.name))) })), _jsxs(Box, { display: "flex", gap: 1, mt: 1, flexWrap: "wrap", alignItems: "center", children: [_jsx(TextInput, { size: "small", value: name, placeholder: SESSION_RULES_WORDS.namePlaceholder, "aria-label": "The rule's name", onChange: event => setName(event.target.value) }), _jsx(Select, { size: "small", value: kind, "aria-label": "What it covers", onChange: event => setKind(event.target.value), children: SESSION_RULE_CLASSES.map(item => (_jsx(Select.Option, { value: item, children: SESSION_RULES_WORDS.classes[item] }, item))) }), _jsx(Select, { size: "small", value: decision, "aria-label": "What it says", onChange: event => setDecision(event.target.value), children: SESSION_RULE_DECISIONS.map(item => (_jsx(Select.Option, { value: item, children: SESSION_RULES_WORDS.decisions[item] }, item))) }), _jsx(Button, { size: "small", disabled: busy, onClick: add, children: SESSION_RULES_WORDS.add })] }), problem ? (_jsx(Text, { as: "p", role: "alert", sx: { fontSize: 0, m: 0, mt: 1 }, children: problem })) : null, _jsx(Text, { as: "p", sx: { fontSize: 0, color: 'fg.muted', mt: 1, mb: 0 }, children: SESSION_RULES_WORDS.goneWithSession })] }));
+    return (_jsxs(Box, { "data-testid": "session-rules", mt: 3, children: [_jsx(Heading, { as: "h4", sx: { fontSize: 1, mb: 1 }, children: SESSION_RULES_WORDS.title }), inForce?.unavailable ? (_jsx(Text, { as: "p", role: "alert", sx: { fontSize: 0, m: 0, mb: 1 }, children: SESSION_RULES_WORDS.unavailable(inForce.unavailable) })) : null, inForce && inForce.session_rules.length === 0 ? (_jsx(Text, { as: "p", sx: { fontSize: 1, color: 'fg.muted', m: 0 }, children: SESSION_RULES_WORDS.none })) : (_jsx(Box, { as: "ul", listStyle: "none", p: 0, m: 0, children: (inForce?.session_rules ?? []).map(rule => (_jsxs(Box, { as: "li", py: 1, fontSize: 1, display: "flex", gap: 2, alignItems: "center", children: [_jsx(Text, { sx: { fontWeight: 'semibold' }, children: rule.name }), _jsx(Text, { sx: { color: 'fg.muted', fontSize: 0 }, children: sessionRuleInWords(rule) }), _jsx(Button, { size: "small", variant: "invisible", disabled: busy, onClick: () => void act(() => removeSessionRule(agentServerUrl, token, sessionUid, rule.name)), children: SESSION_RULES_WORDS.remove })] }, rule.name))) })), _jsxs(Box, { display: "flex", gap: 1, mt: 1, flexWrap: "wrap", alignItems: "center", children: [_jsx(TextInput, { size: "small", value: name, placeholder: SESSION_RULES_WORDS.namePlaceholder, "aria-label": "The rule's name", onChange: event => setName(event.target.value) }), _jsx(Select, { size: "small", value: kind, "aria-label": "What it covers", onChange: event => setKind(event.target.value), children: SESSION_RULE_CLASSES.map(item => (_jsx(Select.Option, { value: item, children: SESSION_RULES_WORDS.classes[item] }, item))) }), _jsx(Select, { size: "small", value: decision, "aria-label": "What it says", onChange: event => setDecision(event.target.value), children: SESSION_RULE_DECISIONS.map(item => (_jsx(Select.Option, { value: item, children: SESSION_RULES_WORDS.decisions[item] }, item))) }), _jsx(Button, { size: "small", disabled: busy, onClick: add, children: SESSION_RULES_WORDS.add })] }), _jsx(Box, { display: "flex", gap: 1, mt: 1, flexWrap: "wrap", "data-testid": "session-rules-file-and-shell", children: FILE_AND_SHELL_RULES.map(rule => (_jsx(Button, { size: "small", variant: "invisible", disabled: busy, title: sessionRuleInWords(rule), onClick: () => void act(() => addSessionRule(agentServerUrl, token, sessionUid, rule)), children: rule.name }, rule.name))) }), problem ? (_jsx(Text, { as: "p", role: "alert", sx: { fontSize: 0, m: 0, mt: 1 }, children: problem })) : null, _jsx(Text, { as: "p", sx: { fontSize: 0, color: 'fg.muted', mt: 1, mb: 0 }, children: SESSION_RULES_WORDS.goneWithSession })] }));
 }
 export function AppRulesCard({ app, workspace, }) {
     const token = useIAMStore(state => state.token) ?? '';

package/lib/apps/plugins/canvas-parts/index.d.ts

@@ -15,9 +15,17 @@ type PartsReader = {
     }>;
 };
 /** The short ids an organization turns off, and the plugin each names. */
-export declare const CANVAS_PART_SOURCES: readonly ["connections", "skills", "models", "rules", "tests", "events", "protocols", "ui", "characters"];
+export declare const CANVAS_PART_SOURCES: readonly ["agents", "connections", "skills", "models", "rules", "tests", "events", "protocols", "ui", "characters"];
 export type CanvasPartSource = (typeof CANVAS_PART_SOURCES)[number];
 export declare const canvasPartsPluginName: (source: CanvasPartSource) => string;
+/**
+ * The catalogue's harnesses as the agent (SHIELD SH-43): each harness an
+ * agent program over ACP behind the Shield, offered by the catalogue agent
+ * that runs on it — dropped on the surface, it is the application's agent.
+ * A harness no agent of the catalogue runs yet is offered off, and says so;
+ * `custom` is an organization's own and never offered here.
+ */
+export declare const AGENT_PARTS: CanvasPartContribution[];
 /** A connection to each server of the catalogue: read-only, as its owner, every tool. */
 export declare const CONNECTION_PARTS: CanvasPartContribution[];
 /** Each skill of the catalogue. */

package/lib/apps/plugins/canvas-parts/index.js

@@ -13,6 +13,8 @@
  */
 import { buildReactorFromPlugins, contribution, definePlugin, } from '@datalayer/reactor';
 import { MCP_SERVER_LIBRARY } from '../../../specs/mcpServers';
+import { listAgentspecs } from '../../../specs/agents';
+import { listHarnesses } from '../../../specs/harnesses';
 import { listChatModels } from '../../../specs/models';
 import { getSkillSpecs } from '../../../specs/skills';
 import { listProtocolSpecs } from '../../../specs/protocols';
@@ -21,6 +23,7 @@ import { ASSISTANT_CHARACTERS } from '../../../chat/assistant/characters';
 import { LoopCanvasPart, } from '../../core/canvasParts';
 /** The short ids an organization turns off, and the plugin each names. */
 export const CANVAS_PART_SOURCES = [
+    'agents',
     'connections',
     'skills',
     'models',
@@ -39,6 +42,30 @@ const partsPlugin = (source, displayName, parts) => definePlugin({
     octicon: 'package',
     contributes: parts.map(part => contribution(LoopCanvasPart, part, { id: part.id })),
 });
+/**
+ * The catalogue's harnesses as the agent (SHIELD SH-43): each harness an
+ * agent program over ACP behind the Shield, offered by the catalogue agent
+ * that runs on it — dropped on the surface, it is the application's agent.
+ * A harness no agent of the catalogue runs yet is offered off, and says so;
+ * `custom` is an organization's own and never offered here.
+ */
+export const AGENT_PARTS = listHarnesses()
+    .filter(harness => harness.id !== 'custom')
+    .map(harness => {
+    const agent = listAgentspecs().find(spec => spec.harness === harness.id);
+    return {
+        id: `agent:${harness.id}`,
+        kind: 'agent',
+        label: harness.name,
+        says: agent
+            ? `${agent.name}: ${harness.description}`
+            : `${harness.description} No agent of the catalogue runs on it yet.`,
+        emoji: '🛡️',
+        harness: harness.id,
+        example: agent?.id ?? '',
+        enabled: Boolean(agent) && harness.enabled,
+    };
+});
 /** A connection to each server of the catalogue: read-only, as its owner, every tool. */
 export const CONNECTION_PARTS = Object.values(MCP_SERVER_LIBRARY).map(server => ({
     id: `connection:${server.id}`,
@@ -210,6 +237,7 @@ export const CHARACTER_PARTS = ASSISTANT_CHARACTERS.map(character => ({
     enabled: true,
 }));
 export const CANVAS_PART_PLUGINS = [
+    partsPlugin('agents', 'Agents', AGENT_PARTS),
     partsPlugin('connections', 'Connections', CONNECTION_PARTS),
     partsPlugin('skills', 'Skills', SKILL_PARTS),
     partsPlugin('models', 'Models', MODEL_PARTS),

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';
@@ -57,6 +57,7 @@ import { settledVoice } from '../../voice/chatVoice';
 import { useVoiceSettings } from '../../voice/useVoiceSettings';
 import { useVoiceSpeaker } from '../../voice/useVoiceSpeaker';
 import { useSpokenAnswers } from '../../voice/useSpokenAnswers';
+import { lineToSay } from '../../voice/sayAloud';
 import { isFloatingChatViewMode } from '../viewModes';
 import { ToolApprovalBanner, ToolApprovalDialog, } from '../tools';
 import { initialModelId, isOffered, offeredModels as offeredModelsFor, } from './modelChoice';
@@ -1819,6 +1820,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 +2804,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,6 +2974,31 @@ 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;
+    /*
+     * 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());
     const stopSpeaking = onStopSpeaking ?? (ownVoice.speaker ? ownVoice.stop : undefined);
@@ -3762,7 +3793,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/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).