@datalayer/agent-runtimes 1.5.52 → 1.5.54

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

@@ -32,7 +32,7 @@ export function ruleInWords(rule) {
 }
 /**
  * The rule or Gate an approval was asked under, as the runtime wrote it in
- * its arguments: `_rule` for a rule, `_check` for a Gate (LOOP U-19).
+ * its arguments: `_rule` for a rule, `_check` for a Gate (U-19).
  */
 export const ruleOfApproval = (approval) => {
     const said = approval.tool_args?._rule ?? approval.tool_args?._check;
@@ -41,7 +41,7 @@ export const ruleOfApproval = (approval) => {
 /**
  * The approvals of one application: those its agent asked under its id, and
  * those the runtime marked as its own (`_app`) — a deployment's agent, a
- * Gate's, or a review its drift asked (LOOP U-19). Answered anywhere, an
+ * Gate's, or a review its drift asked (U-19). Answered anywhere, an
  * approval leaves every list at once: each decision is broadcast to all the
  * person's pages over the same `/ws`.
  */
@@ -49,7 +49,7 @@ export function approvalsOfApp(approvals, appId) {
     return approvals.filter(approval => approval.agent_id === appId || approval.tool_args?._app === appId);
 }
 const PENDING = { status: 'pending' };
-/** A result it wants to keep, shown whole before it is (LOOP R-24). */
+/** A result it wants to keep, shown whole before it is (R-24). */
 export function DraftShown({ draft }) {
     return (_jsxs(Box, { "data-testid": "app-draft", mt: 1, children: [_jsx(Text, { as: "p", sx: { m: 0, fontSize: 0, color: 'fg.muted' }, children: SAVE_WORDS.where(draft.space) }), _jsx(Text, { as: "p", sx: { m: 0, fontWeight: 'semibold' }, children: draft.title }), _jsx(Box, { as: "pre", m: 0, mt: 1, p: 2, maxHeight: 240, overflow: "auto", whiteSpace: "pre-wrap", fontFamily: "inherit", fontSize: 0, bg: "canvas.subtle", borderRadius: 2, children: draft.content })] }));
 }
@@ -64,7 +64,7 @@ function Approvals({ app }) {
                 }) }))] }));
 }
 /**
- * The rules of the running session (SHIELD §6.3, SH-54): what decides it now,
+ * The rules of the running session (SH-54): what decides it now,
  * the rules the person added, and a rule to add — in force at once, gone with
  * the session, never below the organization's.
  */
@@ -107,13 +107,21 @@ export function SessionRules({ agentServerUrl, sessionUid, token, }) {
     };
     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 })] }));
 }
+/**
+ * The running session the card tightens: the conversation the host
+ * continued, else the thread the chat sent on — an application's thread is
+ * its session on the runtime. None before a message is sent.
+ */
+export function sessionUidOf(workspace) {
+    return workspace?.conversationId || workspace?.thread || undefined;
+}
 export function AppRulesCard({ app, workspace, }) {
     const token = useIAMStore(state => state.token) ?? '';
     const signedIn = Boolean(token);
     const agentServerUrl = workspace
         ? agentServerOf(workspace.sandbox, workspace.serverUrl)
         : undefined;
-    const sessionUid = workspace?.conversationId;
+    const sessionUid = sessionUidOf(workspace);
     return (_jsxs(Box, { "data-testid": "app-rules", mb: 4, children: [_jsx(Heading, { as: "h3", sx: { fontSize: 2, mb: 2 }, children: APP_RULES_WORDS.title }), app.rules.length === 0 ? (_jsx(Text, { as: "p", sx: { fontSize: 1, color: 'fg.muted', m: 0 }, children: APP_RULES_WORDS.none })) : (_jsx(Box, { as: "ul", listStyle: "none", p: 0, m: 0, children: app.rules.map(ruleInWords).map((rule, index) => (_jsxs(Box, { as: "li", py: 1, fontSize: 1, children: [_jsx(Text, { children: rule.action }), ' ', _jsx(Label, { title: rule.means, children: rule.says }), _jsx(Text, { as: "p", sx: { m: 0, color: 'fg.muted', fontSize: 0 }, children: rule.covers })] }, index))) })), _jsx(Text, { as: "p", sx: { fontSize: 0, color: 'fg.muted', mt: 1, mb: 0 }, children: APP_RULES_WORDS.byDefault }), signedIn ? (_jsx(Approvals, { app: app })) : (_jsx(Text, { as: "p", sx: { fontSize: 1, color: 'fg.muted', mt: 3, mb: 0 }, children: APP_RULES_WORDS.signedOut })), signedIn && agentServerUrl ? (sessionUid ? (_jsx(SessionRules, { agentServerUrl: agentServerUrl, sessionUid: sessionUid, token: token })) : (_jsx(Text, { as: "p", sx: { fontSize: 0, color: 'fg.muted', mt: 3, mb: 0 }, children: SESSION_RULES_WORDS.noSession }))) : null] }));
 }
 export default AppRulesCard;

package/lib/apps/plugins/assistant/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * The floating assistant in the LOOP workspace (LOOP T-24): the character a
+ * The floating assistant in the LOOP workspace (T-24): the character a
  * page draws over its workspace, chosen from what the enabled plugins
  * contribute to `loop.assistant.character` — the application's own
  * (`interface.assistant`) when its Appspec names one, else the person's
@@ -13,7 +13,7 @@
  * the runtime to ask (`decisions`), its balloon offers *Ask a decision*: a
  * typed decision asked of Jev through the runtime, answered there.
  *
- * Its balloon shows the conversation as `balloon` says (LOOP T-23; the
+ * Its balloon shows the conversation as `balloon` says (T-23; the
  * Appspec's `interface.balloon`): a peek of the newest words (`history`, the
  * default), or the one thing being said or done now (`current`). Either way
  * what the agent is doing while a tool runs — the turn's `activity` — is said

package/lib/apps/plugins/assistant-characters/index.d.ts

@@ -1,6 +1,6 @@
 /**
  * Datalayer's own characters for the floating assistant, contributed
- * (LOOP T-24, T-25): the paper clip, the wizard, the cat and the L👀P eyes.
+ * (T-24, T-25): the paper clip, the wizard, the cat and the L👀P eyes.
  * Disabled, they leave the catalogue; another plugin may contribute others.
  *
  * @module apps/plugins/assistant-characters
@@ -18,7 +18,7 @@ type ContributionsReader = {
 export declare const ASSISTANT_CHARACTERS_PLUGIN_NAME = "@datalayer/loop-plugin-assistant-characters";
 export declare const AssistantCharactersPlugin: ReactorPlugin<Record<string, never>, unknown, unknown>;
 /**
- * A plugin contributing one character (LOOP T-24, T-26): a character a
+ * A plugin contributing one character (T-24, T-26): a character a
  * person brought — a `.acs` or a clippy.js character read in their page —
  * offered beside the contributed ones under the id it is chosen by. The
  * character stays in the page: the plugin only says it is there.

package/lib/apps/plugins/assistant-characters/index.js

@@ -4,7 +4,7 @@
  */
 /**
  * Datalayer's own characters for the floating assistant, contributed
- * (LOOP T-24, T-25): the paper clip, the wizard, the cat and the L👀P eyes.
+ * (T-24, T-25): the paper clip, the wizard, the cat and the L👀P eyes.
  * Disabled, they leave the catalogue; another plugin may contribute others.
  *
  * @module apps/plugins/assistant-characters
@@ -21,7 +21,7 @@ export const AssistantCharactersPlugin = definePlugin({
     contributes: ASSISTANT_CHARACTERS.map(character => contribution(LoopAssistantCharacter, { id: character.id, character }, { id: character.id })),
 });
 /**
- * A plugin contributing one character (LOOP T-24, T-26): a character a
+ * A plugin contributing one character (T-24, T-26): a character a
  * person brought — a `.acs` or a clippy.js character read in their page —
  * offered beside the contributed ones under the id it is chosen by. The
  * character stays in the page: the plugin only says it is there.

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

@@ -1,5 +1,5 @@
 /**
- * The Canvas's palette as a Contribution Point (LOOP C-12): each UI plugin
+ * The Canvas's palette as a Contribution Point (C-12): each UI plugin
  * of the catalogue that renders components (`agentspecs/ui`, C-13 — the
  * A2UI surfaces, `a2ui-surface`) has its components contributed to
  * `loop.canvas.block` by a Reactor plugin of its own, one per UI spec. The

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

@@ -3,7 +3,7 @@
  * Distributed under the terms of the Modified BSD License.
  */
 /**
- * The Canvas's palette as a Contribution Point (LOOP C-12): each UI plugin
+ * The Canvas's palette as a Contribution Point (C-12): each UI plugin
  * of the catalogue that renders components (`agentspecs/ui`, C-13 — the
  * A2UI surfaces, `a2ui-surface`) has its components contributed to
  * `loop.canvas.block` by a Reactor plugin of its own, one per UI spec. The

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

@@ -1,5 +1,5 @@
 /**
- * The agent's toolbox, contributed (LOOP C-20): one plugin per source of
+ * The agent's toolbox, contributed (C-20): one plugin per source of
  * parts — the servers of the catalogue a connection reaches, its skills, its
  * models, and the rules, tests and events an agent answers to — each
  * contributing to `loop.canvas.part`. The toolbox is what the enabled
@@ -19,7 +19,7 @@ export declare const CANVAS_PART_SOURCES: readonly ["agents", "connections", "sk
 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
+ * The catalogue's harnesses as the agent (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;
@@ -38,14 +38,14 @@ export declare const RULE_PARTS: CanvasPartContribution[];
 export declare const TEST_PARTS: CanvasPartContribution[];
 /** The events an application answers (C-21): on a schedule, on an event, once. */
 export declare const EVENT_PARTS: CanvasPartContribution[];
-/** Each protocol of the catalogue (AGENT_PROTOCOLS PS-04): a planned one offered, not enabled. */
+/** Each protocol of the catalogue (PS-04): a planned one offered, not enabled. */
 export declare const PROTOCOL_PARTS: CanvasPartContribution[];
 /**
- * Each UI plugin of the catalogue (AGENTIC_UI R8): a part of the agent's
+ * Each UI plugin of the catalogue (R8): a part of the agent's
  * interface, dropped on it, then exposed through a renderer it may be.
  */
 export declare const UI_PARTS: CanvasPartContribution[];
-/** Datalayer's characters for its floating assistant, dropped on the agent (AGENT_PROTOCOLS PS-05). */
+/** Datalayer's characters for its floating assistant, dropped on the agent (PS-05). */
 export declare const CHARACTER_PARTS: CanvasPartContribution[];
 export declare const CANVAS_PART_PLUGINS: ReactorPlugin<Record<string, never>, unknown, unknown>[];
 /** The toolbox's reactor, its named plugins disabled; a name no plugin has is refused. */

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

@@ -3,7 +3,7 @@
  * Distributed under the terms of the Modified BSD License.
  */
 /**
- * The agent's toolbox, contributed (LOOP C-20): one plugin per source of
+ * The agent's toolbox, contributed (C-20): one plugin per source of
  * parts — the servers of the catalogue a connection reaches, its skills, its
  * models, and the rules, tests and events an agent answers to — each
  * contributing to `loop.canvas.part`. The toolbox is what the enabled
@@ -43,7 +43,7 @@ const partsPlugin = (source, displayName, parts) => definePlugin({
     contributes: parts.map(part => contribution(LoopCanvasPart, part, { id: part.id })),
 });
 /**
- * The catalogue's harnesses as the agent (SHIELD SH-43): each harness an
+ * The catalogue's harnesses as the agent (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;
@@ -205,7 +205,7 @@ export const EVENT_PARTS = [
         enabled: true,
     },
 ];
-/** Each protocol of the catalogue (AGENT_PROTOCOLS PS-04): a planned one offered, not enabled. */
+/** Each protocol of the catalogue (PS-04): a planned one offered, not enabled. */
 export const PROTOCOL_PARTS = listProtocolSpecs().map(protocol => ({
     id: `protocol:${protocol.id}`,
     kind: 'protocol',
@@ -215,7 +215,7 @@ export const PROTOCOL_PARTS = listProtocolSpecs().map(protocol => ({
     enabled: protocol.status === 'shipped',
 }));
 /**
- * Each UI plugin of the catalogue (AGENTIC_UI R8): a part of the agent's
+ * Each UI plugin of the catalogue (R8): a part of the agent's
  * interface, dropped on it, then exposed through a renderer it may be.
  */
 export const UI_PARTS = listUI().map(ui => ({
@@ -227,7 +227,7 @@ export const UI_PARTS = listUI().map(ui => ({
     example: { plugin: ui.id },
     enabled: true,
 }));
-/** Datalayer's characters for its floating assistant, dropped on the agent (AGENT_PROTOCOLS PS-05). */
+/** Datalayer's characters for its floating assistant, dropped on the agent (PS-05). */
 export const CHARACTER_PARTS = ASSISTANT_CHARACTERS.map(character => ({
     id: `character:${character.id}`,
     kind: 'character',

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

@@ -69,7 +69,7 @@ const NO_SURFACE = '';
 const FULLSCREEN_HINT_PERIOD_MS = 1400;
 /**
  * An application's face in the empty state: the page's size of the three a
- * face is drawn at (LOOP T-19, `--loop-face-large`, 72px).
+ * face is drawn at (T-19, `--loop-face-large`, 72px).
  */
 const FACE_LARGE = parseInt(loopShapeVars['--loop-face-large'], 10);
 export default function ChatView({ workspace }) {
@@ -80,6 +80,20 @@ export default function ChatView({ workspace }) {
     const palette = useColorPalette();
     const controlsRef = useRef(null);
     const { setViewControls } = workspace;
+    /*
+     * Say the thread a message goes on to the workspace: an application's
+     * thread is its session on the runtime, which the Rules card's *This
+     * session* reads (SH-54). Through a ref, as the senders below are built once.
+     */
+    const setThreadRef = useRef(workspace.setThread);
+    setThreadRef.current = workspace.setThread;
+    const sayThread = useCallback(() => {
+        const thread = controlsRef.current?.thread();
+        if (thread) {
+            setThreadRef.current?.(thread);
+        }
+        return thread;
+    }, []);
     const [transient, setTransient] = useState(null);
     // Read from the reactor rather than taken as a prop: the placeholder and the
     // default editor are the chat plugin's own configuration, so a host sets them
@@ -207,7 +221,7 @@ export default function ChatView({ workspace }) {
      */
     const [busy, setBusy] = useState(false);
     const [sendReady, setSendReady] = useState(false);
-    // The agent's voice speaks (VOICE.md VO-10): the composer's *Stop speaking*.
+    // The agent's voice speaks (VO-10): the composer's *Stop speaking*.
     const [speaking, setSpeaking] = useState(false);
     const [presenceTool, setPresenceTool] = useState({
         open: false,
@@ -222,7 +236,7 @@ export default function ChatView({ workspace }) {
         turnFeedRef.current?.setPresence(presenceNow);
     }, [onPresence, presenceNow]);
     // What it last said, for a host that says it outside the conversation —
-    // the embed's floating chrome (LOOP R-01): its balloon and its blink.
+    // the embed's floating chrome (R-01): its balloon and its blink.
     // Through a ref: the handler below is made once.
     const onSayingRef = useRef(config?.presence?.onSaying);
     onSayingRef.current = config?.presence?.onSaying;
@@ -367,7 +381,7 @@ export default function ChatView({ workspace }) {
     const inPageRef = useRef(false);
     /**
      * The page's sandbox, when the agent turned in the page runs its code
-     * there (`execute_code`, STUDIO E-11): what a file given on the page is
+     * there (`execute_code`, E-11): what a file given on the page is
      * put in. Read by `sendNow`, set below.
      */
     const pageSandboxRef = useRef(undefined);
@@ -377,7 +391,7 @@ export default function ChatView({ workspace }) {
      * stopped deployment, a visitor's turns all taken. Set below.
      */
     const hostClosedRef = useRef(undefined);
-    /** What goes with every run (an application's modes, LOOP P-19), read when it is sent. */
+    /** What goes with every run (an application's modes, P-19), read when it is sent. */
     // How the words in the composer were heard, when they were said (VO-27).
     const spokenRef = useRef(undefined);
     const runProps = useContributions(LoopRunProps);
@@ -390,12 +404,12 @@ export default function ChatView({ workspace }) {
      * begins its turn, and a page reading the turn sees it asked and answered.
      *
      * What the page did besides the message goes with it as AG-UI's
-     * `forwardedProps` (`loop`, LOOP R-04): the application's session takes a
+     * `forwardedProps` (`loop`, R-04): the application's session takes a
      * file there. An agent turned in this page has no session: one that runs
      * its code in the page's sandbox has the files put there, and the message
-     * names them (STUDIO E-11); to any other no file is handed — said, rather
+     * names them (E-11); to any other no file is handed — said, rather
      * than dropped. What the workspace's plugins send with every run
-     * (`LoopRunProps`: the modes the person is in, LOOP P-19) goes under it —
+     * (`LoopRunProps`: the modes the person is in, P-19) goes under it —
      * and an agent turned in this page applies the modes itself (`modeEffect`,
      * `BrowserAgentAdapter`).
      */
@@ -404,11 +418,11 @@ export default function ChatView({ workspace }) {
             return hostClosedRef.current;
         }
         // Said into the composer, then sent: how it was heard rides on the
-        // run, and the chat marks the message spoken (VOICE.md VO-27).
+        // run, and the chat marks the message spoken (VO-27).
         const spoken = spokenRef.current;
         spokenRef.current = undefined;
         const forwardedProps = runForwardedProps(runPropsRef.current.map(entry => entry.value), spoken ? { ...(given ?? {}), voice: spoken } : given);
-        // The page's files, or those attached in the composer (LOOP P-21).
+        // The page's files, or those attached in the composer (P-21).
         const loop = forwardedProps?.loop;
         if (inPageRef.current && loop?.files && loop.files.length > 0) {
             const sandbox = pageSandboxRef.current;
@@ -440,14 +454,14 @@ export default function ChatView({ workspace }) {
             return;
         }
         // A new turn: whatever the panel showed is gone, this message is it.
-        turnFeedRef.current?.begin(message, controlsRef.current?.thread());
+        turnFeedRef.current?.begin(message, sayThread());
         const send = controlsRef.current?.send;
         if (!send) {
             heldForAdapter.current.push([message, forwardedProps]);
             return;
         }
         send(message, forwardedProps);
-    }, []);
+    }, [sayThread]);
     // One writer, so neither fact can erase the other.
     useEffect(() => {
         setViewControls(sendReady
@@ -481,9 +495,10 @@ export default function ChatView({ workspace }) {
         }
         const held = heldForAdapter.current.splice(0, heldForAdapter.current.length);
         for (const [message, forwardedProps] of held) {
+            sayThread();
             controlsRef.current?.send(message, forwardedProps);
         }
-    }, [sendReady]);
+    }, [sendReady, sayThread]);
     /*
      * Fired once, on the first real send, for the life of this mounted chat —
      * a ref rather than a signal, because nothing here needs to re-render when
@@ -501,7 +516,7 @@ export default function ChatView({ workspace }) {
          */
         setTransient(null);
         /*
-         * Words that go elsewhere than the agent (`sendInstead`, PAP_DATALAYER
+         * Words that go elsewhere than the agent (`sendInstead`,
          * P-08): a Direct Conversation with a company, the person's own words
          * sent as theirs. Neither a command nor a turn, and never the model's;
          * refused, the words stay where they were typed and the reason is said.
@@ -789,7 +804,7 @@ export default function ChatView({ workspace }) {
     /*
      * An agent of the catalogue or a Cog's, as a runtime resolves it: an
      * application on a Cog looked up among the agentspecs alone was turned in
-     * the page with no instructions at all (LOOP H-01).
+     * the page with no instructions at all (H-01).
      */
     const spec = resolveAgentspec(member?.specId ?? agentId) ??
         (blueprintSpecId ? resolveAgentspec(blueprintSpecId) : undefined);
@@ -840,7 +855,7 @@ export default function ChatView({ workspace }) {
         const hidden = new Set(hiddenOpeners ?? []);
         const offered = (items) => hidden.size === 0 ? items : items.filter(item => !hidden.has(item.text));
         // What a plugin offers live (an application's profile's starters,
-        // LOOP P-20) wins over what was contributed when the reactor was built.
+        // P-20) wins over what was contributed when the reactor was built.
         if (liveOpeners) {
             return offered(liveOpeners);
         }
@@ -1013,7 +1028,7 @@ export default function ChatView({ workspace }) {
     }, [notebookTools, commandTools]);
     /*
      * The page's own tools for an agent on a server: a host example's, and
-     * the tools of the `AgentTools` bundles its extras name (REACTOR_UI RU-7:
+     * the tools of the `AgentTools` bundles its extras name (RU-7:
      * the host page's functions, `host_<name>`, each running its command on
      * this reactor). An in-page agent has every bundle already (above).
      */
@@ -1057,7 +1072,7 @@ export default function ChatView({ workspace }) {
      */
     /*
      * The commands the composer lists while `/` is typed: those contributed for
-     * it, an application's (LOOP P-19). Picking one writes `/<name> `, and the
+     * it, an application's (P-19). Picking one writes `/<name> `, and the
      * workspace runs it when the message is sent.
      */
     const commands = useContributions(LoopCommand);
@@ -1136,7 +1151,7 @@ export default function ChatView({ workspace }) {
     /*
      * What its host said of whether there is anything to talk to
      * (`ChatAvailabilityProvider`): an application whose model is not offered
-     * or not served (LOOP R-27) is switched off with the reason, by the
+     * or not served (R-27) is switched off with the reason, by the
      * Studio's Preview and the hosted page, rather than left unanswered.
      */
     const ambient = useChatAvailability();
@@ -1144,7 +1159,7 @@ export default function ChatView({ workspace }) {
         ? ambient.disableReason || 'This conversation is closed here.'
         : undefined;
     /*
-     * No agent to talk to: a Datalayer runtime not assigned (STUDIO P-24,
+     * No agent to talk to: a Datalayer runtime not assigned (P-24,
      * round 9). Said in a sentence — why, when its launch was refused — and
      * nothing is sent; the header does not say *Ready*.
      */
@@ -1175,7 +1190,7 @@ export default function ChatView({ workspace }) {
      */
     const [draft, setDraft] = useState('');
     /*
-     * Its voice (VOICE.md VO-10, VO-11, VO-49): the microphone in the
+     * Its voice (VO-10, VO-11, VO-49): the microphone in the
      * workspace's composer, which this view holds — the words written in it as
      * they are heard. The chat speaks its answers itself (`voice` below).
      */
@@ -1292,7 +1307,7 @@ export default function ChatView({ workspace }) {
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [suggestion]);
     /*
-     * An application's session checks who is calling (LOOP R-32, R-04): its
+     * An application's session checks who is calling (R-32, R-04): its
      * chat says so with the person's token. The embed hands its own.
      */
     /*
@@ -1300,7 +1315,7 @@ export default function ChatView({ workspace }) {
      * whether the application's plugin is up: while its runtime does not hold
      * it, its page plugin stands down (F-15), and its chat is then never sent
      * to the runtime's bare agent route — on the visitors' runtime one that is
-     * not published (STUDIO D-15). It speaks to the application's session API,
+     * not published (D-15). It speaks to the application's session API,
      * whose refusal says why.
      */
     const hostCreatePayload = reactor.getConfig(AGENTS_PLUGIN_NAME)?.datalayerCreatePayload;
@@ -1309,24 +1324,24 @@ export default function ChatView({ workspace }) {
     const deploymentUid = deploymentOfPayload(hostCreatePayload);
     const memberToken = useIAMStore(state => state.token);
     /*
-     * Without an account (LOOP R-30) the application runs on the visitors'
+     * Without an account (R-30) the application runs on the visitors'
      * runtime, which answers a visitor's token for it and nobody signed in.
      */
     const visitors = reactor.getConfig(AGENTS_PLUGIN_NAME)?.datalayerVisitors;
     const visitor = useVisitorToken(visitors);
     // An embedded application's own token, for a visitor the platform does
-    // not know (LOOP R-20): it runs a session of its deployment, and no more.
+    // not know (R-20): it runs a session of its deployment, and no more.
     const embedToken = reactor.getConfig(AGENTS_PLUGIN_NAME)?.embedToken;
     const iamToken = visitors ? visitor.token : embedToken || memberToken;
     /*
      * Its voice asked of the speech service as this chat speaks to its runtime
-     * (VOICE.md VO-37, VO-19): the host's token, else this one — a visitor's,
-     * an embed's or the person's; an embed's names its deployment (decision 16).
+     * (VO-37, VO-19): the host's token, else this one — a visitor's,
+     * an embed's or the person's; an embed's names its deployment.
      */
     const askedVoice = useMemo(() => voiceAskedAs(config?.voice, iamToken || undefined), [config?.voice, iamToken]);
     /*
      * A deployment's runtime, and the visitors', answer only the application's
-     * own routes (OwnRoutesOnly, PAP_DATALAYER's release gates): its chat calls
+     * own routes (OwnRoutesOnly, the release gates): its chat calls
      * nothing else — Stop is its session's, no monitoring stream, no sandbox
      * socket, no runtime-wide model switch. A Preview runs on the Maker's.
      */
@@ -1335,7 +1350,7 @@ export default function ChatView({ workspace }) {
         throw new Error('A deployment’s page runs its application: its host gave no app_spec.');
     }
     /*
-     * A thread opened from the person's history (LOOP P-24): its conversation
+     * A thread opened from the person's history (P-24): its conversation
      * read from the runtime once it answers — held there, else resumed from
      * its record — then drawn and gone on with on the same thread. One that
      * cannot be opened is said, and a new one starts.
@@ -1436,7 +1451,7 @@ export default function ChatView({ workspace }) {
             // server's monitoring stream fills, so the side panel and the
             // composer's pulse draw an in-page delegation like any other.
             onSubagentEvent: event => agentRuntimeStore.getState().appendSubagentEvent(event),
-            // An application's modes (LOOP P-19): the options sent with a
+            // An application's modes (P-19): the options sent with a
             // run tell it their instructions, on the model one names, as
             // its session API does on a runtime.
             modeEffect: blueprintTurn?.modeEffect,
@@ -1445,14 +1460,14 @@ export default function ChatView({ workspace }) {
             ? {
                 type: 'ag-ui',
                 // An application's agent is spoken to through its session API
-                // (LOOP R-04): each thread a session, recorded under its uid,
+                // (R-04): each thread a session, recorded under its uid,
                 // run in the name the application runs in, and taking what the
                 // page did besides the message — the same AG-UI events back.
                 endpoint: runsApp
                     ? `${agentServerUrl}/api/v1/apps/agents/${encodeURIComponent(agentId)}/ag-ui/`
                     : `${agentServerUrl}/api/v1/ag-ui/${agentId}/`,
                 ...(runsApp && iamToken ? { authToken: iamToken } : {}),
-                // Its session's ui channel (REACTOR_UI RU-W): what its answers
+                // Its session's ui channel (RU-W): what its answers
                 // show, its steps and its elements, beside the run's text.
                 ...(runsApp
                     ? {
@@ -1701,6 +1716,8 @@ export default function ChatView({ workspace }) {
                     // The chat's own speaker, never a second one: the microphone
                     // opening stops it, and *Stop speaking* while it speaks.
                     speaking: speaking, onStopSpeaking: () => controlsRef.current?.stopSpeaking?.(), 
+                    // Barge-in gated on how loud that speaker plays (VO-13).
+                    playbackLevel: () => controlsRef.current?.voiceLevel?.() ?? 0, 
                     // Hands-free (VO-12, VO-13): the run in progress, stopped when
                     // the person speaks over it, and the answer marked interrupted.
                     running: busy, onStopRun: () => controlsRef.current?.stop?.(), onInterrupted: () => controlsRef.current?.markInterrupted(), onInterimChange: setVoiceInterim, 
@@ -1717,7 +1734,7 @@ export default function ChatView({ workspace }) {
         /*
           An application's conversation keeps none of the session's controls
           under its composer — the agents, the model, the tools and their servers,
-          the skills (LOOP T-17, T-18): a person using an application is not
+          the skills (T-17, T-18): a person using an application is not
           choosing them, and its builder chose them in its spec. An agent's chat
           keeps them.
         */
@@ -1833,8 +1850,8 @@ export default function ChatView({ workspace }) {
                     , { 
                         // The theme it wears, when the host names one (an application's).
                         themeVariant: config?.themeVariant, themeOverrides: config?.themeOverrides, colorMode: config?.colorMode, thread: chatThread, 
-                        // Its voice, when its host gives one (an application's
-                        // `interface.voice`, VOICE.md VO-49): the microphone in the
+                        // Its voice, when its host gives one (an application's `interface.voice`, VO-49):
+                        // the microphone in the
                         // composer, its answers heard.
                         voice: askedVoice, 
                         // The header says why, beside the title, for the same reason the
@@ -1842,7 +1859,7 @@ export default function ChatView({ workspace }) {
                         // than an absent one.
                         disabled: chatDisabled, disableReason: disabledReason, protocol: protocol, 
                         /*
-                          The page's own tools — a host page's functions (LOOP D-10), an
+                          The page's own tools — a host page's functions (D-10), an
                           example's client tool — run by this chat when the agent is on a
                           server: sent with each run and executed here when it calls
                           one. An in-page agent is handed them in its protocol instead
@@ -1888,7 +1905,7 @@ export default function ChatView({ workspace }) {
                         // Not *Ready* with no runtime: the header says why instead.
                         presence && !noRuntime ? (_jsx(PresenceLine, { state: presenceNow })) : undefined, emptyState: {
                             // An application's own face, at the page's size of the three
-                            // (LOOP T-08, T-19): the thing a person's eye lands on first.
+                            // (T-08, T-19): the thing a person's eye lands on first.
                             icon: presence?.face ? (_jsx("span", { "aria-hidden": true, style: { fontSize: FACE_LARGE, lineHeight: 1 }, children: _jsx(FaceDrawing, { face: presence.face, size: FACE_LARGE }) })) : (_jsx(BrandIcon, { size: 48 })),
                             // `ChatEmptyState` reads its heading from here and nowhere
                             // else — the `title` above reaches the header only — so

package/lib/apps/plugins/chat/index.d.ts

@@ -11,7 +11,7 @@ export interface ChatPresence {
     /** What it says before anyone writes. */
     welcome?: string;
     /**
-     * Its deployment is paused (LOOP R-17): it says so beside its face, and
+     * Its deployment is paused (R-17): it says so beside its face, and
      * its assistant dozes (T-08, T-22), whatever its last turn left behind.
      */
     paused?: boolean;
@@ -25,7 +25,7 @@ export interface ChatPresence {
     /**
      * Told what it last said, and whether its newest words are an answer, as
      * they change — for a host that says them outside the conversation, as the
-     * embed's floating chrome does in its balloon and its blink (LOOP R-01).
+     * embed's floating chrome does in its balloon and its blink (R-01).
      * Read once, when the workspace is built: pass a stable function, such as
      * a state setter.
      */
@@ -41,12 +41,12 @@ export type ChatSaid = {
 export type ChatPluginConfig = {
     /**
      * The theme the conversation wears, by name: the person's unless said. An
-     * application says `loop` (LOOP T-06, T-12) — the conversation then takes
+     * application says `loop` (T-06, T-12) — the conversation then takes
      * the theme's bubbles, pills and colours whatever the page around it wears.
      */
     themeVariant?: string;
     /**
-     * Laid over that theme, by mode: an application's accent (LOOP T-05), so
+     * Laid over that theme, by mode: an application's accent (T-05), so
      * that its bubbles and its one button wear its colour and not the theme's.
      */
     themeOverrides?: ThemeOverrides;
@@ -58,13 +58,13 @@ export type ChatPluginConfig = {
      */
     colorMode?: 'light' | 'dark';
     /**
-     * Who is answering, as the person meets them (LOOP T-08): a name, a face
+     * Who is answering, as the person meets them (T-08): a name, a face
      * and a welcome, in place of the agent's id and a generic icon. An
      * application sets its own.
      */
     presence?: ChatPresence;
     /**
-     * The conversation to go on with (LOOP D-13): an embedded application's
+     * The conversation to go on with (D-13): an embedded application's
      * session, reattached after its page reloaded, and what it holds.
      */
     thread?: ResumedThread;
@@ -74,7 +74,7 @@ export type ChatPluginConfig = {
      */
     showTokenUsage?: boolean;
     /**
-     * Its voice (VOICE.md VO-10, VO-20, VO-49): a microphone in the composer,
+     * Its voice (VO-10, VO-20, VO-49): a microphone in the composer,
      * the words written in it as they are heard, and the answers said by
      * Datalayer's speech service — an application's `interface.voice`
      * (`chatVoiceOf`). None unless said.
@@ -86,7 +86,7 @@ export type ChatPluginConfig = {
      * Configured on the plugin rather than passed to the workspace: the prompt
      * belongs to the chat, and a shell that has no chat plugin has no prompt to
      * put a placeholder in. A host that wants different words says so where the
-     * words are. Empty, the chat's own, in the person's language (LOOP P-26).
+     * words are. Empty, the chat's own, in the person's language (P-26).
      */
     placeholder: string;
     /**

package/lib/apps/plugins/document/DocumentView.js

@@ -42,10 +42,10 @@ export default function DocumentView({ workspace, }) {
         undefined;
     return (_jsx(Box, { height: "100%", minHeight: 0, children: _jsx(EphemeralDocument
         // The entry point owns the theme; a second provider here would fight
-        // it over BaseStyles and font tokens (§3.5, §3.6).
+        // it over BaseStyles and font tokens.
         , { 
             // The entry point owns the theme; a second provider here would fight
-            // it over BaseStyles and font tokens (§3.5, §3.6).
+            // it over BaseStyles and font tokens.
             inheritTheme: true, documentId: documentId, content: opening, autoFocus: autoFocus, serviceManager: browserManager, showToolbar: toolbar.present, toolbarExtraItems: toolbar.items, 
             // Join the sandbox's kernel rather than starting a rival one.
             kernelId: browserManager ? snapshot.kernelId : undefined, runtimeOverride: !browserManager && snapshot.jupyterUrl

package/lib/apps/plugins/notebook/NotebookView.js

@@ -166,7 +166,7 @@ export default function NotebookView({ workspace, }) {
             */
             nbformat: opening, 
             // The entry point owns the theme; a second provider here would fight
-            // it over BaseStyles and font tokens (§3.5, §3.6).
+            // it over BaseStyles and font tokens.
             inheritTheme: true, notebookId: notebookId, serviceManager: browserManager, 
             // Join the sandbox's kernel rather than starting a rival one.
             kernelId: browserManager ? snapshot.kernelId : undefined, showToolbar: toolbar.present, toolbarExtraItems: toolbar.items, runtimeOverride: !browserManager && snapshot.jupyterUrl

package/lib/apps/plugins/page-layout/SplitLayout.d.ts

@@ -1,6 +1,6 @@
 /**
  * The split: the conversation and the work side by side, one hairline
- * between them that a person drags (LOOP T-07, an Appspec's `layout: split`).
+ * between them that a person drags (T-07, an Appspec's `layout: split`).
  *
  * The page layout's other arrangement. Where `page` puts the work on a sheet
  * and the conversation in a panel that opens when wanted, `split` keeps both

package/lib/apps/plugins/pap-sign-in/PapSignInCard.d.ts

@@ -1,5 +1,5 @@
 /**
- * *Sign in at a company*, in the chat (AGENT_PROTOCOLS PI-56): where the
+ * *Sign in at a company*, in the chat (PI-56): where the
  * gateway's `pap_sign_in` answers, the company's page as a button opening a
  * new tab, the code large and copyable with a code to scan for Device
  * Sign-In, Datalayer's own page for Mediated Sign-In (where the person types