@datalayer/agent-runtimes 1.5.51 → 1.5.53

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 }) {
@@ -207,7 +207,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 +222,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 +367,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 +377,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 +390,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 +404,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;
@@ -501,7 +501,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 +789,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 +840,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 +1013,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 +1057,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 +1136,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 +1144,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 +1175,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 +1292,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 +1300,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 +1309,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 +1335,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 +1436,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 +1445,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 +1701,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 +1719,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 +1835,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 +1844,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 +1890,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

package/lib/apps/plugins/pap-sign-in/PapSignInCard.js

@@ -11,7 +11,7 @@ export function PapSignInCard({ context, send, }) {
     const [returned, setReturned] = useState(null);
     const read = context.status === 'complete' ? readPapSignIn(context.result) : null;
     // A Direct Sign-In: Datalayer's `/pap/signed-in`, in the tab the company sent the person
-    // back to, says how it came back (PAP_DATALAYER P-04); the conversation goes on here.
+    // back to, says how it came back (P-04); the conversation goes on here.
     const company = read && !('refused' in read) && read.mode === 'direct'
         ? (read.company ?? '')
         : '';

package/lib/apps/plugins/pap-sign-in/index.js

@@ -4,7 +4,7 @@
  */
 /**
  * `@datalayer/loop-plugin-pap-sign-in` — *Sign in at a company*, drawn where
- * the gateway's `pap_sign_in` answers (AGENT_PROTOCOLS PI-56).
+ * the gateway's `pap_sign_in` answers (PI-56).
  *
  * Its own renderer, for its own display type
  * (`application/vnd.datalayer.pap.sign-in+json`, typed in Python as

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

@@ -1,6 +1,6 @@
 /**
  * What the gateway's `pap_sign_in` answers, read and checked: kept in
- * `portable/signIn`, which Datalayer Mobile reads too (MOBILE M-037).
+ * `portable/signIn`, which Datalayer Mobile reads too (M-037).
  *
  * @module apps/plugins/pap-sign-in/signIn
  */

package/lib/apps/plugins/pap-sign-in/signIn.js

@@ -4,7 +4,7 @@
  */
 /**
  * What the gateway's `pap_sign_in` answers, read and checked: kept in
- * `portable/signIn`, which Datalayer Mobile reads too (MOBILE M-037).
+ * `portable/signIn`, which Datalayer Mobile reads too (M-037).
  *
  * @module apps/plugins/pap-sign-in/signIn
  */

package/lib/apps/plugins/plugins-panel/index.d.ts

@@ -13,7 +13,7 @@ export declare const SIDEBAR_WIDTH = 420;
  * The generic graph plugin, which the loop's own adapter wraps: by its name
  * (`GraphPlugin.name`), not its module — importing `@datalayer/reactor-graph`
  * for a string would bring ECharts to every workspace with this panel, and
- * to every one built by the preset, embedded applications too (STUDIO D-08).
+ * to every one built by the preset, embedded applications too (D-08).
  * `plugins-panel.test` holds it to the plugin's own name.
  */
 export declare const REACTOR_GRAPH_PLUGIN_NAME = "@datalayer/reactor-graph";

package/lib/apps/plugins/plugins-panel/index.js

@@ -40,7 +40,7 @@ export const SIDEBAR_WIDTH = 420;
  * The generic graph plugin, which the loop's own adapter wraps: by its name
  * (`GraphPlugin.name`), not its module — importing `@datalayer/reactor-graph`
  * for a string would bring ECharts to every workspace with this panel, and
- * to every one built by the preset, embedded applications too (STUDIO D-08).
+ * to every one built by the preset, embedded applications too (D-08).
  * `plugins-panel.test` holds it to the plugin's own name.
  */
 export const REACTOR_GRAPH_PLUGIN_NAME = '@datalayer/reactor-graph';

package/lib/apps/plugins/shield-displays/DiffCard.d.ts

@@ -1,6 +1,6 @@
 /**
- * What a coding agent changed in one file, as a unified diff (SHIELD §4.3,
- * SH-16): the path and the count in the header, each line signed and
+ * What a coding agent changed in one file, as a unified diff (SH-16):
+ * the path and the count in the header, each line signed and
  * coloured, the file's language on the block for a highlighter. What it
  * reads is `portable/displays`' (`protocolDisplayOf`, `unifiedDiffLines`),
  * so the phone draws the same thing from the same contract.

package/lib/apps/plugins/shield-displays/TerminalCard.d.ts

@@ -1,5 +1,5 @@
 /**
- * What a coding agent ran (SHIELD §4.3, SH-16): the command in the header,
+ * What a coding agent ran (SH-16): the command in the header,
  * the output kept after the terminal was released, and how it ended — the
  * exit code, or *running* while it runs. What it reads is
  * `portable/displays`' (`protocolDisplayOf`), the phone's contract too.

package/lib/apps/plugins/shield-displays/index.js

@@ -4,17 +4,17 @@
  */
 /**
  * `@datalayer/loop-plugin-shield-displays` — a coding agent's *diff* and
- * *terminal*, drawn where its tool results carry them (SHIELD §4.3, SH-16).
+ * *terminal*, drawn where its tool results carry them (SH-16).
  *
  * The runtime sends each beside the tool's result in
  * `_meta["reactor.ui/display"]`, as every protocol display travels
- * (REACTOR_UI RU-1): `application/vnd.datalayer.shield.diff+json` and
+ * (RU-1): `application/vnd.datalayer.shield.diff+json` and
  * `application/vnd.datalayer.shield.terminal+json`, typed in Python as
  * `agent_runtimes.adapters.harness_displays`. This plugin contributes one
  * renderer per type; it binds no tool, since a harness names its tools as it
  * likes (*Edit hello.py*, *Run pytest*) and the display is what says what
  * it is. The web chat and the embed mount it through the preset; the phone
- * reads the same contract from `portable/displays` (MOBILE M-037).
+ * reads the same contract from `portable/displays` (M-037).
  *
  * @module apps/plugins/shield-displays
  */