@datalayer/agent-runtimes 1.5.52 → 1.5.53

package/lib/chat/base/ChatBase.js

@@ -72,7 +72,7 @@ const EphemeralDocument = React.lazy(() => import('../document/EphemeralDocument
 // The agent's details (its context charts draw with ECharts) and the
 // companion notebook (JupyterLab's notebook) are opened by a click, not drawn
 // with the conversation: each is its own chunk, fetched when first shown, so
-// a chat — and an embedded application (STUDIO D-08) — loads without them.
+// a chat — and an embedded application (D-08) — loads without them.
 // A chunk that cannot load says so where the view would be.
 const loadAgentDetails = () => import('../../agents/AgentDetails').then(m => ({ default: m.AgentDetails }));
 const loadEphemeralNotebook = () => import('../notebook/EphemeralNotebook').then(m => ({
@@ -426,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, 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, 
+brandIcon, avatarConfig, headerButtons, showPoweredBy = false, poweredByProps, emptyState, renderHeader, showTurnFooter = true, notebookToolSurfacesId, footerContent, welcome, trailingContent, voice, voiceSpeaking = false, voiceSentence, onStopSpeaking, voiceLevel, 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
@@ -1083,7 +1083,7 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
     const isA2AProtocol = protocol?.type === 'a2a';
     // ---- Component state ----
     /*
-     * The conversation (MOBILE M-030): `reduceConversation`'s, as on the phone,
+     * The conversation (M-030): `reduceConversation`'s, as on the phone,
      * whatever protocol the agent speaks — its adapter's events normalised by
      * `conversationEventsOf`. Kept in a ref as each change lands, so the events
      * of one network chunk each read the last, and drawn on the next render
@@ -1186,7 +1186,7 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
     const [historyRefreshTick, setHistoryRefreshTick] = useState(0);
     const historyRetryAttemptsRef = useRef(new Map());
     // The steps of an application's code shown so far, as displays (patched
-    // as they stream), and the elements it showed (REACTOR_UI RU-3).
+    // as they stream), and the elements it showed (RU-3).
     const uiStepsRef = useRef(emptyUiModel());
     const uiElementsRef = useRef(new Set());
     // Adapter-ready flag — flipped to true once the protocol adapter is initialised
@@ -1559,7 +1559,7 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
     hideMessagesAfterToolUIRef.current = hideMessagesAfterToolUI;
     const threadIdRef = useRef(thread?.id || generateMessageId());
     /*
-     * The thread a host gave, kept as it was given at mount (LOOP D-13), and
+     * The thread a host gave, kept as it was given at mount (D-13), and
      * told when a message is first sent on a thread: the host keeps it.
      */
     const threadGivenRef = useRef(thread);
@@ -1572,7 +1572,7 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
         }
     }, []);
     /*
-     * The conversation's ui channel (REACTOR_UI RU-W): one WebSocket per
+     * The conversation's ui channel (RU-W): one WebSocket per
      * conversation, its thread the scope, opened once its session is there
      * (the first event of its first run, or a thread reopened). What its
      * messages show, its steps, its elements, its authors and its window
@@ -1587,7 +1587,7 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
     const uiSocketTokenRef = useRef(protocol?.authToken);
     uiSocketTokenRef.current = protocol?.authToken;
     /*
-     * Its files (REACTOR_UI RU-6): uploaded to its runtime before the run or
+     * Its files (RU-6): uploaded to its runtime before the run or
      * the press that names them, the conversation's thread their scope; the
      * run carries the ref, never the bytes.
      */
@@ -1678,11 +1678,11 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
         uiStepsRef.current = next.steps;
         const routed = next.routed;
         if (routed.to === 'window') {
-            // For the page it sits in, outside the conversation (LOOP P-25).
+            // For the page it sits in, outside the conversation (P-25).
             tellLoopWindow(routed.data);
         }
         else if (routed.to === 'step') {
-            // A step of its code, drawn as it runs (LOOP P-16).
+            // A step of its code, drawn as it runs (P-16).
             const step = routed.step;
             changeLayer(kept => {
                 const anchors = new Map(kept.steps.map(row => [row.item.id, row.after]));
@@ -1700,7 +1700,7 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
             });
         }
         else if (routed.to === 'element') {
-            // In a side panel or on a page of its own (LOOP P-18).
+            // In a side panel or on a page of its own (P-18).
             uiElementsRef.current.add(routed.change.id);
             applyLoopElement(routed.change);
         }
@@ -1822,7 +1822,7 @@ 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).
+    // A line the agent says aloud, from a run's `voice.say` (VO-35).
     const voiceSayRef = useRef(undefined);
     const handleRespondRef = useRef(null);
     // A decision made outside the chat — a host page's own approval banner —
@@ -2367,7 +2367,7 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
         if (!historyScopeId)
             return;
         /*
-         * A thread the host gave (LOOP D-13): its session's conversation, drawn
+         * A thread the host gave (D-13): its session's conversation, drawn
          * once, and never replaced by the runtime's snapshot, which is its
          * agent's — every session's — not this one's.
          */
@@ -2804,7 +2804,7 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
                     break;
                 case 'activity':
                     // What the server says besides the conversation's text comes on
-                    // the ui socket (REACTOR_UI RU-W); the run's own — `loop.session`
+                    // the ui socket (RU-W); the run's own — `loop.session`
                     // among them — are the conversation's.
                     if (event.activity) {
                         voiceSayRef.current?.(event.activity);
@@ -2958,7 +2958,7 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
     // ========================================================================
     // handleSend
     // ========================================================================
-    // Voice (VOICE.md V1): what was said and put in the composer, until sent.
+    // Voice (V1): what was said and put in the composer, until sent.
     const spokenRef = useRef(undefined);
     // Its voice with what it leaves unsaid filled in: Datalayer's models and packages.
     // The person's own settings, followed as the voice menu changes them (VO-30).
@@ -3005,7 +3005,7 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
             setVoiceSaid('');
         }
     }, [isLoading]);
-    // Answers spoken over, hands-free (VOICE.md VO-13): marked *interrupted*.
+    // Answers spoken over, hands-free (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([]);
@@ -3016,12 +3016,14 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
         }
     }, []);
     const stopSpeaking = onStopSpeaking ?? (ownVoice.speaker ? ownVoice.stop : undefined);
+    // How loud the answer plays: the host's speaker's, or the chat's own (VO-13).
+    const playbackLevel = hostSpeaks ? voiceLevel : ownVoice.level;
     const readAnswerAloud = onReadAloud ?? (ownVoice.speaker ? ownVoice.read : undefined);
     const handleSend = useCallback(async (messageOverride, 
     // AG-UI's: what goes with the run besides the conversation — an
-    // application's page says there what it did (LOOP R-04).
+    // application's page says there what it did (R-04).
     forwardedPropsGiven, 
-    // How the message was heard, when it was said (VOICE.md VO-27).
+    // How the message was heard, when it was said (VO-27).
     spokenGiven) => {
         const messageContent = (messageOverride ?? input).trim();
         if (!messageContent || isLoading)
@@ -3039,7 +3041,7 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
             }
         }
         // A press of what a display offered goes up the ui socket, checked
-        // there; the run that answers it names it only (REACTOR_UI RU-W).
+        // there; the run that answers it names it only (RU-W).
         const pressed = displayPressOf(forwardedPropsGiven);
         if (pressed && forwardedPropsGiven) {
             const socket = uiSocketRef.current?.socket;
@@ -3313,7 +3315,7 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
         protocol?.agentId,
     ]);
     /*
-     * How a message's display presses what it offered (REACTOR_UI RU-4,
+     * How a message's display presses what it offered (RU-4,
      * RU-W): with the token of the offer, as the run's press — which
      * `handleSend` sends up the ui socket before the run, the run naming it
      * only. An answer is the person's words in the conversation; any other
@@ -3384,6 +3386,8 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
             thread: () => threadIdRef.current,
             // Its speaker, for a host whose composer holds the microphone (VO-10).
             stopSpeaking,
+            // How loud it plays, for a host's hands-free barge-in (VO-13).
+            voiceLevel: playbackLevel,
             // The answer spoken over, marked for a host's own composer (VO-13).
             markInterrupted,
         });
@@ -3398,6 +3402,7 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
         handleStop,
         handleNewChat,
         stopSpeaking,
+        playbackLevel,
         markInterrupted,
     ]);
     // Streaming state, for a host that draws the prompt.
@@ -3768,7 +3773,7 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
     shownItemsRef.current = welcomedItems;
     const saidId = saidMessageId(welcomedItems, sentenceSaid);
     /*
-     * *Read aloud* under each answer the agent has finished (VOICE.md VO-21),
+     * *Read aloud* under each answer the agent has finished (VO-21),
      * when the host reads answers aloud on request.
      */
     const writingId = isLoading || isStreaming
@@ -3798,6 +3803,9 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
                 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, 
+        // Barge-in gated on how loud the answer plays (VO-13): the host's
+        // speaker, or the chat's own.
+        playbackLevel: playbackLevel, 
         // 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: markInterrupted, onInterimChange: setVoiceInterim, 

package/lib/chat/base/conversationItems.d.ts

@@ -1,9 +1,9 @@
 /**
- * What the web chat draws of its conversation (MOBILE M-030): the rows of
+ * What the web chat draws of its conversation (M-030): the rows of
  * `reduceConversation`'s state as the `DisplayItem`s `ChatMessageList`
  * renders, with what only the web holds beside them — what a message showed
- * and who said it (Reactor UI ops, REACTOR_UI RU-W), the steps of an
- * application's code (LOOP P-16), and what a message carried that the
+ * and who said it (Reactor UI ops, RU-W), the steps of an
+ * application's code (P-16), and what a message carried that the
  * conversation does not keep (when it was said, a voice's metadata).
  *
  * The conversation is the reducer's; this only draws it. A turn that ended

package/lib/chat/base/loopElement.d.ts

@@ -1,11 +1,11 @@
 /**
- * Where an element of an application's code shows (LOOP P-18): in a side
+ * Where an element of an application's code shows (P-18): in a side
  * panel beside the conversation, or on a page of its own over it. Inline,
  * an element is a message, and the chat draws it as one (P-04).
  *
  * The session API shows it as a `reactor.ui` display that says where it
  * shows in its data (`where: "panel" | "page"`, with its `title`) — an
- * answer's display (REACTOR_UI RU-2) — and closes it with a `remove` of its
+ * answer's display (RU-2) — and closes it with a `remove` of its
  * id (RU-3). The chat does not draw it: it keeps what is open here, and
  * whoever draws panels and pages (the `app-elements` plugin) listens. One
  * store per page, as there is one chat per application on it.

package/lib/chat/base/loopStep.d.ts

@@ -1,13 +1,13 @@
 /**
  * A step of an application's code, shown in the conversation as it runs
- * (LOOP P-16): the chain of thought.
+ * (P-16): the chain of thought.
  *
  * AG-UI's `STEP_STARTED` and `STEP_FINISHED` carry a step's name only; the
  * session API shows the step whole beside them as a `reactor.ui` display of
- * type `application/vnd.datalayer.loop.step+json` (REACTOR_UI RU-3) — its
+ * type `application/vnd.datalayer.loop.step+json` (RU-3) — its
  * data `{name, kind, parent_id, input, output, error, started_at,
  * ended_at}`, its id the step's — shown as it starts and again as it ends,
- * its output patched in as it streams (LOOP P-31). A step is drawn as the
+ * its output patched in as it streams (P-31). A step is drawn as the
  * chat draws a tool call: one row, collapsed, its input and output inside,
  * running until it ends; a nested step says the step it is in.
  */

package/lib/chat/base/loopStep.js

@@ -40,7 +40,7 @@ export function stepItem(step, inside) {
             kind: step.kind,
             ...(step.input !== null ? { input: step.input } : {}),
         },
-        // Running, what it wrote so far — a step that streams (LOOP P-31).
+        // Running, what it wrote so far — a step that streams (P-31).
         ...(!step.error && step.output !== null ? { result: step.output } : {}),
         status: !step.ended ? 'executing' : step.error ? 'error' : 'complete',
         ...(step.error ? { error: step.error } : {}),

package/lib/chat/base/loopWindow.d.ts

@@ -1,9 +1,9 @@
 /**
- * Window messages (LOOP P-25): what an application's code tells the page it
+ * Window messages (P-25): what an application's code tells the page it
  * sits in, outside the conversation — ``session.send_window_message(data)``.
  *
  * The session says it with a `reactor.ui` `window` op named `message`, its
- * `args` `{data}` (REACTOR_UI RU-3), on the conversation's ui socket (RU-W). The chat does not draw it: it hands
+ * `args` `{data}` (RU-3), on the conversation's ui socket (RU-W). The chat does not draw it: it hands
  * it to whoever listens here — the embed's host bridge, which raises it on
  * the element as its `window-message` event. A window op of another name is
  * not one this page acts on: refused, it throws.
@@ -20,7 +20,7 @@ export declare function onLoopWindowMessage(listener: (data: unknown) => void):
 /**
  * Why the turn a window message posted by the page ran failed — its
  * `RUN_ERROR`'s sentence — or `null`. What its code tells the page back comes
- * on the conversation's ui socket (REACTOR_UI RU-W), never on this stream: a
+ * on the conversation's ui socket (RU-W), never on this stream: a
  * `reactor.ui` event here is refused.
  */
 export declare function windowTurnErrorOf(stream: string): string | null;

package/lib/chat/base/loopWindow.js

@@ -3,11 +3,11 @@
  * Distributed under the terms of the Modified BSD License.
  */
 /**
- * Window messages (LOOP P-25): what an application's code tells the page it
+ * Window messages (P-25): what an application's code tells the page it
  * sits in, outside the conversation — ``session.send_window_message(data)``.
  *
  * The session says it with a `reactor.ui` `window` op named `message`, its
- * `args` `{data}` (REACTOR_UI RU-3), on the conversation's ui socket (RU-W). The chat does not draw it: it hands
+ * `args` `{data}` (RU-3), on the conversation's ui socket (RU-W). The chat does not draw it: it hands
  * it to whoever listens here — the embed's host bridge, which raises it on
  * the element as its `window-message` event. A window op of another name is
  * not one this page acts on: refused, it throws.
@@ -42,7 +42,7 @@ export function onLoopWindowMessage(listener) {
 /**
  * Why the turn a window message posted by the page ran failed — its
  * `RUN_ERROR`'s sentence — or `null`. What its code tells the page back comes
- * on the conversation's ui socket (REACTOR_UI RU-W), never on this stream: a
+ * on the conversation's ui socket (RU-W), never on this stream: a
  * `reactor.ui` event here is refused.
  */
 export function windowTurnErrorOf(stream) {

package/lib/chat/base/uiFiles.d.ts

@@ -1,5 +1,5 @@
 /**
- * A conversation's files as references (REACTOR_UI RU-6).
+ * A conversation's files as references (RU-6).
  *
  * What the page holds of a file it was given — File upload and the composer
  * read it as `{name, type, data_url}` — is uploaded to the application's

package/lib/chat/base/uiFiles.js

@@ -3,7 +3,7 @@
  * Distributed under the terms of the Modified BSD License.
  */
 /**
- * A conversation's files as references (REACTOR_UI RU-6).
+ * A conversation's files as references (RU-6).
  *
  * What the page holds of a file it was given — File upload and the composer
  * read it as `{name, type, data_url}` — is uploaded to the application's

package/lib/chat/base/uiOps.d.ts

@@ -1,6 +1,6 @@
 /**
  * What a server says to a conversation's page, as `reactor.ui` ops
- * (REACTOR_UI RU-2, RU-3), and what the page presses back (RU-W).
+ * (RU-2, RU-3), and what the page presses back (RU-W).
  *
  * The ops arrive on the conversation's ui socket (Reactor's `UiSocket`,
  * one per session, beside the run stream that carries the conversation's

package/lib/chat/base/uiOps.js

@@ -4,7 +4,7 @@
  */
 /**
  * What a server says to a conversation's page, as `reactor.ui` ops
- * (REACTOR_UI RU-2, RU-3), and what the page presses back (RU-W).
+ * (RU-2, RU-3), and what the page presses back (RU-W).
  *
  * The ops arrive on the conversation's ui socket (Reactor's `UiSocket`,
  * one per session, beside the run stream that carries the conversation's

package/lib/chat/index.js

@@ -85,6 +85,6 @@ export { ChatInline, } from './ChatInline';
 // Generic full-page chat surface for a live agent runtime (with launching state)
 export { AgentRuntimeChat, } from '../agents/AgentRuntimeChat';
 export * from './EphemeralSurfaceControl';
-// The chat's own words in the person's language (LOOP P-26)
+// The chat's own words in the person's language (P-26)
 export { ChatLanguage, useChatLanguage, useChatWords } from './ChatLanguage';
 export { CHAT_WORDS, ENGLISH_CHAT_WORDS, chatLanguage, chatWords, } from './words';

package/lib/chat/indicators/McpStatusIndicator.js

@@ -74,7 +74,7 @@ export function McpStatusIndicator({ data: wsData, apiBase, authToken, }) {
     const aggregate = useMemo(() => deriveAggregate(servers), [servers]);
     const tooltipText = useMemo(() => buildTooltipText(aggregate, servers), [aggregate, servers]);
     /*
-     * Nothing drawn when the agent has no MCP server (LOOP H-21): a control
+     * Nothing drawn when the agent has no MCP server (H-21): a control
      * that only says so was read out as *No MCP Server defined* in every
      * composer, an in-page agent's and an application's alike. When there are
      * some, it is named by their state, and the tooltip — its description —

package/lib/chat/indicators/SkillsStatusIndicator.js

@@ -60,7 +60,7 @@ export function SkillsStatusIndicator({ skillsCount, enabledCount, loading = fal
     useInjectKeyframes();
     const aggregate = useMemo(() => deriveAggregate(skillsCount, enabledCount, loading), [skillsCount, enabledCount, loading]);
     const tooltipText = useMemo(() => buildTooltip(aggregate, skillsCount, enabledCount), [aggregate, skillsCount, enabledCount]);
-    // Nothing drawn when the agent has no skill (LOOP H-21): a control that
+    // Nothing drawn when the agent has no skill (H-21): a control that
     // only says so was read out as *No Skills defined* in every composer.
     if (aggregate === 'none') {
         return null;

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

@@ -15,14 +15,13 @@ export interface ChatMessageListProps {
     /** All display items (messages + tool calls) */
     displayItems: DisplayItem[];
     /**
-     * How a message's display presses what it offered (REACTOR_UI RU-4, RU-W):
+     * How a message's display presses what it offered (RU-4, RU-W):
      * the chat sends it up the conversation's ui socket. Absent, its
      * displays offer nothing to press.
      */
     actOn?: (display: Display) => UiAct;
     /**
-     * How a message's display uploads a file the person chose (REACTOR_UI
-     * RU-6): its ref, to press with. Absent, nothing is uploaded.
+     * How a message's display uploads a file the person chose (RU-6): its ref, to press with. Absent, nothing is uploaded.
      */
     upload?: UiUpload;
     /** Whether the agent is loading */
@@ -79,7 +78,7 @@ export interface ChatMessageListProps {
      */
     renderMessageFooter?: (message: ChatMessage) => ReactNode;
     /**
-     * The answer a sentence is being said from (VOICE.md VO-65): its row is
+     * The answer a sentence is being said from (VO-65): its row is
      * marked `aria-current` and `data-voice-saying`, with a bar beside it —
      * the sentence itself is underlined by `useSaidSentence`.
      */

package/lib/chat/messages/ChatMessageList.js

@@ -588,9 +588,9 @@ export function ChatMessageList({ displayItems, actOn, upload, isLoading, isStre
                                                     fontSize: 1,
                                                     color: toneColorsOf(message.directedTo.tone).fg,
                                                 }, children: message.directedTo.name })] })) : speaker.role ? (_jsx(Label, { size: "small", children: speaker.role })) : null, message.createdAt ? (_jsx(RelativeTime, { datetime: message.createdAt.toISOString(), sx: { fontSize: 0, color: 'fg.muted' } })) : null] })) : null, _jsxs(Box, { p: compact ? 1 : 2, px: compact ? 2 : 2, overflowX: "auto", 
-                                // The theme's bubble (LOOP T-03, T-06): today's 6px elsewhere.
+                                // The theme's bubble (T-03, T-06): today's 6px elsewhere.
                                 borderRadius: "bubble", 
-                                // A message arriving, at the theme's pace (LOOP T-10): no
+                                // A message arriving, at the theme's pace (T-10): no
                                 // motion in a theme that sets none, nor when motion is reduced.
                                 animation: "chatMessageArrive var(--theme-motion-message) var(--theme-motion-easing) both", reducedMotion: { animation: 'none' }, backgroundColor: isUser
                                     ? 'accent.emphasis'

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

@@ -1,5 +1,5 @@
 /**
- * Markdown without markup (STUDIO D-22): what every renderer of an agent's
+ * Markdown without markup (D-22): what every renderer of an agent's
  * words hands Streamdown, so that no markup a model or an application writes
  * reaches the page.
  *

package/lib/chat/messages/markdownWithoutHtml.js

@@ -3,7 +3,7 @@
  * Distributed under the terms of the Modified BSD License.
  */
 /**
- * Markdown without markup (STUDIO D-22): what every renderer of an agent's
+ * Markdown without markup (D-22): what every renderer of an agent's
  * words hands Streamdown, so that no markup a model or an application writes
  * reaches the page.
  *

package/lib/chat/presence/Presence.d.ts

@@ -1,5 +1,5 @@
 /**
- * An application's presence in its chat (LOOP T-08): its face, with a quiet
+ * An application's presence in its chat (T-08): its face, with a quiet
  * motion around it while it thinks or works, and one line saying what it is
  * doing. The face is never redrawn; the motion is a soft ring in the accent,
  * still under `prefers-reduced-motion`, and the line changes at the theme's
@@ -13,7 +13,7 @@ import { type PresenceLineProps } from '../../portable/views';
 import type { PresenceState } from './presenceStatus';
 /**
  * A face at `size`: an emoji drawn in Fluent Emoji, the same on every
- * platform (LOOP T-20) — the system's, as text, only for one Datalayer ships
+ * platform (T-20) — the system's, as text, only for one Datalayer ships
  * no drawing of — or a host's own drawing, left as it is.
  */
 export declare function FaceDrawing({ face, size }: {

package/lib/chat/presence/Presence.js

@@ -6,7 +6,7 @@ import { presenceLine } from '../../portable/views';
 const ACCENT = 'var(--theme-accent)';
 /**
  * A face at `size`: an emoji drawn in Fluent Emoji, the same on every
- * platform (LOOP T-20) — the system's, as text, only for one Datalayer ships
+ * platform (T-20) — the system's, as text, only for one Datalayer ships
  * no drawing of — or a host's own drawing, left as it is.
  */
 export function FaceDrawing({ face, size }) {

package/lib/chat/presence/presenceStatus.d.ts

@@ -1,6 +1,6 @@
 /**
- * What an application is doing, in plain words (LOOP T-08): kept in
- * `portable/presence`, which Datalayer Mobile reads too (MOBILE M-030).
+ * What an application is doing, in plain words (T-08): kept in
+ * `portable/presence`, which Datalayer Mobile reads too (M-030).
  *
  * @module chat/presence/presenceStatus
  */

package/lib/chat/presence/presenceStatus.js

@@ -3,8 +3,8 @@
  * Distributed under the terms of the Modified BSD License.
  */
 /**
- * What an application is doing, in plain words (LOOP T-08): kept in
- * `portable/presence`, which Datalayer Mobile reads too (MOBILE M-030).
+ * What an application is doing, in plain words (T-08): kept in
+ * `portable/presence`, which Datalayer Mobile reads too (M-030).
  *
  * @module chat/presence/presenceStatus
  */

package/lib/chat/prompt/InputPrompt.d.ts

@@ -51,8 +51,8 @@ export interface InputPromptProps {
      */
     footerExtras?: ReactNode;
     /**
-     * The words in the box are still being heard by the microphone (VOICE.md
-     * VO-11): shown greyed, in italics, until they are final.
+     * The words in the box are still being heard by the microphone (VO-11):
+     * shown greyed, in italics, until they are final.
      */
     interim?: boolean;
     /**
@@ -117,7 +117,7 @@ export interface InputPromptProps {
     promptVariant?: InputPromptVariant;
     /** Agents the prompt may address by typing `@`. Lexical only. */
     mentionableAgents?: MentionableAgent[];
-    /** Commands listed while `/` is typed, before the prompt's own (LOOP P-19). Lexical only. */
+    /** Commands listed while `/` is typed, before the prompt's own (P-19). Lexical only. */
     promptCommands?: PromptCommand[];
     /**
      * What was sent to this agent before this page loaded, oldest first.

package/lib/chat/prompt/InputPromptBase.d.ts

@@ -76,7 +76,7 @@ export interface InputPromptBaseProps {
      * suggestion a person cannot see is worse than none.
      */
     mentionableAgents?: MentionableAgent[];
-    /** Commands listed while `/` is typed, before the prompt's own (LOOP P-19). Lexical only. */
+    /** Commands listed while `/` is typed, before the prompt's own (P-19). Lexical only. */
     promptCommands?: PromptCommand[];
     /**
      * What was sent to this agent before this composer mounted, oldest first.

package/lib/chat/prompt/InputPromptBase.js

@@ -201,7 +201,7 @@ export function InputPromptBase({ variant = 'lexical', placeholder = 'Ask anythi
                         setFocused(false);
                     }
                 }, border: "1px solid", 
-                // The theme's card (LOOP T-03, T-06): today's 6px elsewhere.
+                // The theme's card (T-03, T-06): today's 6px elsewhere.
                 borderRadius: "var(--theme-radius-card, 6px)", bg: "canvas.default", overflow: "hidden", transition: "border-color 0.2s ease", sx: {
                     borderColor: 'border.default',
                     '&:focus-within': {

package/lib/chat/prompt/InputPromptLexical.d.ts

@@ -33,7 +33,7 @@ export interface InputPromptLexicalProps {
     mentionableAgents?: MentionableAgent[];
     /**
      * Commands listed while `/` is typed, before the prompt's own: an
-     * application's (LOOP P-19).
+     * application's (P-19).
      */
     promptCommands?: PromptCommand[];
 }

package/lib/chat/styles/streamdownStyles.js

@@ -215,7 +215,7 @@ export const streamdownMarkdownStyles = {
         marginRight: 0,
         color: 'fg.muted',
     },
-    // A link reads as its theme says (LOOP T-06): in the accent, or plain —
+    // A link reads as its theme says (T-06): in the accent, or plain —
     // the colour of the words around it — and underlined in every theme.
     '& a': {
         color: 'var(--theme-message-link, var(--fgColor-accent, #0969da))',

package/lib/chat/useViewportDrag.d.ts

@@ -7,7 +7,7 @@ export interface ViewportDragOptions {
     /**
      * Keep the whole box inside the viewport, not only a margin of it: the
      * floating assistant's character, whose balloon and conversation open
-     * from where it stands (LOOP T-23).
+     * from where it stands (T-23).
      */
     whole?: boolean;
 }

package/lib/chat/viewModes.d.ts

@@ -26,7 +26,7 @@ export declare const CHAT_VIEW_MODES: readonly ChatViewModeOption[];
 /**
  * Why the assistant is greyed out, for its tooltip: it is drawn by the
  * floating chat (`ChatFloating`); a layout that places the chat itself, as
- * the page layout does, has no character to show (LOOP T-21).
+ * the page layout does, has no character to show (T-21).
  */
 export declare const ASSISTANT_NEEDS_A_FLOATING_CHAT = "The assistant is drawn by the floating chat, not by this layout";
 /** Why the sidebar option is greyed out, for its tooltip. */

package/lib/chat/viewModes.js

@@ -7,14 +7,14 @@ export const CHAT_VIEW_MODES = [
     { mode: 'floating', label: 'Full-height popup' },
     { mode: 'floating-small', label: 'Floating popup' },
     { mode: 'floating-draggable', label: 'Floating draggable' },
-    // A character on the page that speaks in a balloon (LOOP T-21).
+    // A character on the page that speaks in a balloon (T-21).
     { mode: 'assistant', label: 'Floating assistant' },
     { mode: 'sidebar', label: 'Sidebar panel' },
 ];
 /**
  * Why the assistant is greyed out, for its tooltip: it is drawn by the
  * floating chat (`ChatFloating`); a layout that places the chat itself, as
- * the page layout does, has no character to show (LOOP T-21).
+ * the page layout does, has no character to show (T-21).
  */
 export const ASSISTANT_NEEDS_A_FLOATING_CHAT = 'The assistant is drawn by the floating chat, not by this layout';
 /** Why the sidebar option is greyed out, for its tooltip. */

package/lib/chat/words.js

@@ -3,7 +3,7 @@
  * Distributed under the terms of the Modified BSD License.
  */
 /**
- * The chat's own words in the person's language (LOOP P-26): the composer's
+ * The chat's own words in the person's language (P-26): the composer's
  * placeholder and buttons, its error sentences, the tool lines and the tool
  * cards, the approvals, and the assistant's balloon — said in the six
  * languages the application's composer is said in (`interfaceWords`).

package/lib/client/mixins/RuntimesMixin.d.ts

@@ -8,7 +8,7 @@ import { HealthCheck } from '@datalayer/core/lib/models/HealthCheck';
 export interface CreateRuntimeOptions {
     /**
      * A platform environment by its name, or an environment somebody built,
-     * named `<account-handle>/<name>` or by its uid (PLAN_ENV.md, D-2).
+     * named `<account-handle>/<name>` or by its uid (D-2).
      */
     environmentName: string;
     /**
@@ -97,7 +97,7 @@ export declare function RuntimesMixin<TBase extends Constructor>(Base: TBase): {
          */
         forgetRuntimeMemory(memoryId: string): Promise<number>;
         /**
-         * Correct one of the caller's own memories in place (LOOP R-34): its
+         * Correct one of the caller's own memories in place (R-34): its
          * words become `text`, kept with who corrected it and when.
          */
         correctRuntimeMemory(memoryId: string, text: string): Promise<RuntimeMemory>;
@@ -108,7 +108,7 @@ export declare function RuntimesMixin<TBase extends Constructor>(Base: TBase): {
         forgetRuntimeMemories(agentId: string, count: number): Promise<number>;
         /**
          * The caller's allowances to share what an application remembers of
-         * them with another (LOOP R-35), by `source` or by `reader`.
+         * them with another (R-35), by `source` or by `reader`.
          */
         listRuntimeMemoryShares(filter: {
             source?: string;