@datalayer/agent-runtimes 1.5.52 → 1.5.53

package/lib/apps/embed/loader.js

@@ -3,7 +3,7 @@
  * Distributed under the terms of the Modified BSD License.
  */
 /**
- * The one script a host writes (LOOP D-08):
+ * The one script a host writes (D-08):
  *
  *   <script src="https://datalayer.app/embed/datalayer-app.js" async></script>
  *
@@ -33,7 +33,7 @@
     // ReferenceError unless the global exists, and the module's own body runs
     // after everything it imports, so it is declared here, before the import —
     // without it no application loads (`… did not load (__webpack_public_path__
-    // is not defined)`, seen with `loop apps run --web`, LOOP P-08).
+    // is not defined)`, seen with `loop apps run --web`, P-08).
     const globals = window;
     if (globals['__webpack_public_path__'] === undefined) {
         globals['__webpack_public_path__'] = '';

package/lib/apps/embed/visitorApp.d.ts

@@ -1,6 +1,6 @@
 /**
  * A public application in the element, for a visitor without an account
- * (STUDIO D-07, R-30).
+ * (D-07, R-30).
  *
  * `<datalayer-app app="…">` with no token names a public application. The
  * element reads what it is without anybody's credentials, as the landing's

package/lib/apps/index.d.ts

@@ -2,7 +2,7 @@
  * The LOOP workspace: contracts, shell, and the plugins that come with it.
  *
  * A host embeds the workspace through this surface — never by deep import — so
- * what is public is a decision rather than an accident of file layout (§3.5).
+ * what is public is a decision rather than an accident of file layout.
  *
  * @module apps
  */

package/lib/apps/index.js

@@ -6,7 +6,7 @@
  * The LOOP workspace: contracts, shell, and the plugins that come with it.
  *
  * A host embeds the workspace through this surface — never by deep import — so
- * what is public is a decision rather than an accident of file layout (§3.5).
+ * what is public is a decision rather than an accident of file layout.
  *
  * @module apps
  */
@@ -87,10 +87,10 @@ export { PromptPlugin, PROMPT_PLUGIN_NAME } from './plugins/prompt';
 // Loop, ready to drop into somebody else's page.
 export { LoopEmbed } from './embed/LoopEmbed';
 // An application in another product's page: the React component, the
-// `<datalayer-app>` element, and the snippet a host pastes (LOOP D-07 to D-09).
+// `<datalayer-app>` element, and the snippet a host pastes (D-07 to D-09).
 export { AppEmbed, AppFloating, embedAssistantCharacter, useEmbedSession, useHostBridge, } from './embed/AppEmbed';
 export { EMBED_SESSION_KEY_PREFIX, embedSessionKey, visitOfToken, } from './embed/embedSession';
-// The host page and an embedded application, talking (LOOP D-10).
+// The host page and an embedded application, talking (D-10).
 export { HOST_CONTEXT_COMMAND, HOST_CONTEXT_TOOL, HOST_TOOLS_BUNDLE, hostAgentTools, hostCommand, hostCommands, hostPlugin, hostNotAllowed, hostRefused, hostTool, hostToolsOf, hostUserRunProps, fetchUserToken, signedUser, } from './embed/hostBridge';
 export { defineDatalayerAppElement, } from './embed/element';
 export { EMBED_ATTRIBUTES, EMBED_HOST_VARIABLES, EMBED_TAG, embedLookOf, embedSnippetOf, floatingViewOf, languageOf, resumeOf, } from './embed/embedConfig';

package/lib/apps/plugins/a2ui/A2uiView.js

@@ -10,7 +10,7 @@ import { useSandboxService } from '../agents';
  * A2UI's basic catalog draws from inherited `--a2ui-*` custom properties, so a
  * surface follows the workspace's theme by inheriting rather than by being
  * told — which is what keeps a generated surface from being the one light card
- * in a dark workspace (§3.6).
+ * in a dark workspace.
  */
 const INHERIT_THEME = {
     ['--a2ui-color-surface']: 'var(--bgColor-muted)',

package/lib/apps/plugins/a2ui-surface/AnswerShows.d.ts

@@ -1,6 +1,6 @@
 /**
- * What an application's answer shows, drawn from its display (LOOP P-04,
- * REACTOR_UI RU-2): the A2UI surface in its data, and its buttons pressing
+ * What an application's answer shows, drawn from its display (P-04,
+ * RU-2): the A2UI surface in its data, and its buttons pressing
  * only the actions the display offered, each with the token the session
  * minted for it. The answer under its message and an element in a panel or
  * a page of its own are drawn by this one view.

package/lib/apps/plugins/a2ui-surface/AnswerShows.js

@@ -6,7 +6,7 @@ import { useOwnCatalog } from './ownComponents';
 import { answerPress, answerSurface } from './toolResult';
 export function AnswerShowsView({ display, send, }) {
     const parsed = useMemo(() => answerSurface(display, SURFACE_CATALOG_ID), [display]);
-    // With the components the application's developer wrote (LOOP P-17).
+    // With the components the application's developer wrote (P-17).
     const catalog = useOwnCatalog();
     const [said, setSaid] = useState(null);
     if (!parsed?.messages || parsed.messages.length === 0) {

package/lib/apps/plugins/a2ui-surface/InlineSurface.d.ts

@@ -44,7 +44,7 @@ export declare function InlineSurface({ messages, onAction, validationError, dat
     /**
      * Told of each surface once it is created, for a host that reads what a
      * person writes as they write it — a widget's page run again as an input
-     * changes (LOOP P-05) — rather than when a button is pressed.
+     * changes (P-05) — rather than when a button is pressed.
      */
     onSurface?: (surface: Surface) => void;
 }): JSX.Element | null;

package/lib/apps/plugins/a2ui-surface/SurfaceToolResult.js

@@ -12,7 +12,7 @@ export function SurfaceToolResult({ context, send, onRendered, onSubmitted, }) {
         : null, [context.status, context.result]);
     const title = parsed?.title ?? 'the form';
     const [validationError, setValidationError] = useState(null);
-    // With the components the application's developer wrote (LOOP P-17).
+    // With the components the application's developer wrote (P-17).
     const catalog = useOwnCatalog();
     // Told once per result, when it is there to be told about.
     useEffect(() => {
@@ -32,7 +32,7 @@ export function SurfaceToolResult({ context, send, onRendered, onSubmitted, }) {
         if (action.name !== 'submit_a2ui_form') {
             // A tool's surface submits its form, and nothing else: the buttons
             // of what an application's answer shows are its display's
-            // (`AnswerShowsView`, REACTOR_UI RU-2).
+            // (`AnswerShowsView`, RU-2).
             return;
         }
         const values = (action.context ?? {});

package/lib/apps/plugins/a2ui-surface/index.js

@@ -76,7 +76,7 @@ export function createA2uiSurfacePlugin(options = {}) {
         }
         return (_jsx(SurfaceToolResult, { context: context, send: send, onRendered: options.onRendered, onSubmitted: options.onSubmitted }, context.toolCallId));
     }
-    // What an application's answer shows (REACTOR_UI RU-2): its buttons press
+    // What an application's answer shows (RU-2): its buttons press
     // what the display offered, through the workspace's chat.
     function Answer({ display }) {
         return _jsx(AnswerShowsView, { display: display, send: send });

package/lib/apps/plugins/a2ui-surface/ownComponents.js

@@ -4,7 +4,7 @@
  */
 /**
  * The components the application of this workspace adds to the catalog it
- * is drawn with (LOOP P-17, `loop.a2ui.component`): what its answers, its
+ * is drawn with (P-17, `loop.a2ui.component`): what its answers, its
  * elements and its page draw beside Datalayer's catalog. None outside an
  * application's workspace, or in one whose developer wrote none.
  *

package/lib/apps/plugins/a2ui-surface/toolResult.d.ts

@@ -52,8 +52,8 @@ export declare function validateA2uiField(rule: A2uiFieldRule, value: unknown):
 /** Every rule's complaint about a submission; empty when it passes. */
 export declare function validateA2uiSubmission(rules: A2uiFieldRule[], values: Record<string, unknown>): string[];
 /**
- * The display type of what an application's answer shows (LOOP P-04,
- * REACTOR_UI RU-2): `AnswerShows` in `agent_runtimes.loop.apps.components`.
+ * The display type of what an application's answer shows (P-04,
+ * RU-2): `AnswerShows` in `agent_runtimes.loop.apps.components`.
  */
 export declare const ANSWER_DISPLAY_TYPE = "application/vnd.datalayer.loop.answer+json";
 /** A button pressed on what an answer shows, as the chat sends it on. */

package/lib/apps/plugins/a2ui-surface/toolResult.js

@@ -105,8 +105,8 @@ export function validateA2uiSubmission(rules, values) {
         .filter((message) => message !== null);
 }
 /**
- * The display type of what an application's answer shows (LOOP P-04,
- * REACTOR_UI RU-2): `AnswerShows` in `agent_runtimes.loop.apps.components`.
+ * The display type of what an application's answer shows (P-04,
+ * RU-2): `AnswerShows` in `agent_runtimes.loop.apps.components`.
  */
 export const ANSWER_DISPLAY_TYPE = 'application/vnd.datalayer.loop.answer+json';
 /** The A2UI surface an answer's display draws, or `null` for a display that has none. */

package/lib/apps/plugins/agent-capacity/index.d.ts

@@ -38,11 +38,11 @@ export type AgentCapacityOptions = {
     instructions?: string;
     /** The model it runs on in the page, in place of its spec's. */
     model?: string;
-    /** What its modes tell a run turned in the page (LOOP P-19). */
+    /** What its modes tell a run turned in the page (P-19). */
     modeEffect?: AgentBlueprintContribution['modeEffect'];
     /**
      * Its own name in place of `@datalayer/loop-plugin-agent-<key>`: an
-     * application's, the name its runtime's plugin has too (LOOP F-15).
+     * application's, the name its runtime's plugin has too (F-15).
      */
     name?: string;
     /** The runtime plugins it cannot work without (Reactor's cross-tier declaration). */

package/lib/apps/plugins/agents/DatalayerAgentBridge.js

@@ -16,10 +16,10 @@ export function DatalayerAgentBridge() {
     const agentsConfig = reactor.getConfig(AGENTS_PLUGIN_NAME);
     const agentSpecId = agentsConfig?.datalayerAgentSpecId ?? DEFAULT_DATALAYER_AGENTSPEC;
     const createPayload = agentsConfig?.datalayerCreatePayload;
-    // A conversation without an account (LOOP R-30): the agent is already on
+    // A conversation without an account (R-30): the agent is already on
     // the visitors' runtime, kept warm there; nothing is allocated or made.
     const visitors = agentsConfig?.datalayerVisitors;
-    // A deployment kept on a runtime of its own (LOOP R-33): its agent was made
+    // A deployment kept on a runtime of its own (R-33): its agent was made
     // there from the deployment record as the runtime started; nothing is
     // allocated or made either.
     const kept = agentsConfig?.datalayerKept;
@@ -29,7 +29,7 @@ export function DatalayerAgentBridge() {
     const onDatalayer = target === 'datalayer';
     /*
      * On the visitors' runtime, the application's agent made before the page
-     * follows it (STUDIO D-15): an application at its address has none until
+     * follows it (D-15): an application at its address has none until
      * a visitor opens it, and its runtime holds no plugin of it until then —
      * so the page's plugin of the pair (F-15) would stand down and its chat
      * have nothing to speak to. Asked with a visitor's token, the runtime
@@ -116,7 +116,7 @@ export function DatalayerAgentBridge() {
         ...(createPayload ? { createPayload } : {}),
     }), [agentSpecId, agentName, protocol, createPayload]);
     /*
-     * The application the runtime is launched for (STUDIO R-19): its Appspec
+     * The application the runtime is launched for (R-19): its Appspec
      * and where it runs, read from the payload its agent is created with — the
      * Studio's Preview, the hosted page signed in. Sent with the launch, so the
      * runtime is given the secrets its connections declare before its agent is

package/lib/apps/plugins/agents/appLaunch.d.ts

@@ -1,5 +1,5 @@
 /**
- * What an application's runtime is launched with (STUDIO R-19).
+ * What an application's runtime is launched with (R-19).
  *
  * Pure, so it is read without the agent hook's runtime stack.
  *

package/lib/apps/plugins/agents/plugin.d.ts

@@ -104,17 +104,17 @@ export type AgentsConfig = {
     /**
      * What the agent created on that runtime is created with besides its spec:
      * an application's `app_spec`, so that the runtime runs the application and
-     * decides its tool calls by its rules (LOOP R-05, R-03).
+     * decides its tool calls by its rules (R-05, R-03).
      */
     datalayerCreatePayload?: Record<string, unknown>;
     /**
-     * A conversation without an account (LOOP R-30): the application's agent
+     * A conversation without an account (R-30): the application's agent
      * is already on the visitors' runtime, so nothing is allocated or created,
      * and the chat speaks to it with a visitor's token for the application.
      */
     datalayerVisitors?: DatalayerVisitors;
     /**
-     * A deployment kept on a runtime of its own (LOOP R-33): its agent is
+     * A deployment kept on a runtime of its own (R-33): its agent is
      * already there, made from the deployment record when the runtime started,
      * so nothing is allocated or created, and the chat speaks to it with the
      * person's own token. `url` is the runtime's agent-runtimes address.
@@ -123,7 +123,7 @@ export type AgentsConfig = {
         url: string;
     };
     /**
-     * An embed token for the application (LOOP R-20): what an embedded
+     * An embed token for the application (R-20): what an embedded
      * application's chat speaks to its session with, for a visitor the platform
      * does not know — it runs a session of the application's deployment, and
      * reaches nothing else.

package/lib/apps/plugins/agents/switchable.js

@@ -54,7 +54,7 @@ export const SANDBOX_TARGETS = [
  */
 export function heldTargetReason(target, serverUrl) {
     // A host that names its own agent-runtimes server — `app.mount`, `loop apps
-    // run --web` (LOOP P-08, P-25) — is not asking for the reader's machine:
+    // run --web` (P-08, P-25) — is not asking for the reader's machine:
     // Local is that server, and it is offered. Held, every message of a page
     // served by its own server went to the visitors' runtime instead
     // (seen 2026-10-10 on 1.3.96).

package/lib/apps/plugins/app-activity/AppActivity.d.ts

@@ -1,5 +1,5 @@
 /**
- * What an application did, beside its page (LOOP R-01b, R-15, U-20): its
+ * What an application did, beside its page (R-01b, R-15, U-20): its
  * sessions, newest first, each in a sentence, opened on what it did step by
  * step — tool calls, the rules' decisions, the checks that stopped a step,
  * the approvals, the answer. Read from the record ai-agents keeps (R-07),

package/lib/apps/plugins/app-components/index.d.ts

@@ -1,6 +1,5 @@
 /**
- * `app-components` — the components an application's developer wrote (LOOP
- * P-17), registered as that application's A2UI contributions: each a block
+ * `app-components` — the components an application's developer wrote (P-17), registered as that application's A2UI contributions: each a block
  * of its Canvas's palette (`loop.canvas.block`, as a UI's components
  * are) and a renderer of the catalog its page, its elements and its answers
  * are drawn with (`loop.a2ui.component`). One plugin per application, in its

package/lib/apps/plugins/app-components/index.js

@@ -3,8 +3,7 @@
  * Distributed under the terms of the Modified BSD License.
  */
 /**
- * `app-components` — the components an application's developer wrote (LOOP
- * P-17), registered as that application's A2UI contributions: each a block
+ * `app-components` — the components an application's developer wrote (P-17), registered as that application's A2UI contributions: each a block
  * of its Canvas's palette (`loop.canvas.block`, as a UI's components
  * are) and a renderer of the catalog its page, its elements and its answers
  * are drawn with (`loop.a2ui.component`). One plugin per application, in its

package/lib/apps/plugins/app-computer/AppComputer.d.ts

@@ -1,5 +1,5 @@
 /**
- * An application's computer, beside its page (LOOP R-23, R-01b): the sandbox
+ * An application's computer, beside its page (R-23, R-01b): the sandbox
  * its agent runs on, live.
  *
  * - its **parts** — browse, files, shell — on or off, as its permissions say;

package/lib/apps/plugins/app-computer/AppComputer.js

@@ -29,7 +29,7 @@ function Terminal({ conversation, }) {
 }
 function save(blob, name) {
     // A file of its computer is saved, never opened: its address on this page's
-    // origin carries no type a browser would draw (STUDIO D-22).
+    // origin carries no type a browser would draw (D-22).
     const url = URL.createObjectURL(new Blob([blob], { type: 'application/octet-stream' }));
     const anchor = document.createElement('a');
     anchor.href = url;
@@ -215,7 +215,7 @@ export function AppComputer({ app, workspace, }) {
     const agentId = workspace?.agentId || app.id;
     const [state, setState] = useState();
     /*
-     * Where its files come from (STUDIO D-22).
+     * Where its files come from (D-22).
      *
      * The runtime says it when the plane keeps a host for what applications
      * serve (`servedFrom`, `DATALAYER_USER_APPS_URL`): a file is then fetched

package/lib/apps/plugins/app-elements/AppElements.d.ts

@@ -1,6 +1,5 @@
 /**
- * The elements an application's code opened beside the conversation (LOOP
- * P-18): a side panel on the trailing edge, and a page of its own over the
+ * The elements an application's code opened beside the conversation (P-18): a side panel on the trailing edge, and a page of its own over the
  * workspace — each drawn from its display as an answer is (`AnswerShowsView`),
  * its buttons pressing the actions the display offered, and closed with its
  * own button.

package/lib/apps/plugins/app-elements/AppElements.js

@@ -17,7 +17,7 @@ export function elementsByPlace(open) {
 }
 function ElementBody({ element, send, }) {
     // What its code shows, drawn as an answer's display is: its buttons press
-    // what the display offered (LOOP P-04, REACTOR_UI RU-2).
+    // what the display offered (P-04, RU-2).
     return (_jsx(AnswerShowsView, { display: element.shows, send: (message, forwardedProps) => send !== undefined && !send(message, forwardedProps) }));
 }
 function ElementHeader({ element }) {

package/lib/apps/plugins/app-elements/QuestionView.d.ts

@@ -1,6 +1,5 @@
 /**
- * What an application's code asks, drawn from its display (REACTOR_UI
- * RU-4): `application/vnd.datalayer.loop.question+json`, shown under the
+ * What an application's code asks, drawn from its display (RU-4): `application/vnd.datalayer.loop.question+json`, shown under the
  * message that asks it in words. A choice is its buttons — a rule's prompt
  * is Allow and Refuse — the words a field, a form its fields; each press of
  * it is `reactor.answer`, through the display's `act`, which the chat sends

package/lib/apps/plugins/app-elements/QuestionView.js

@@ -61,7 +61,7 @@ export function QuestionView({ display, act, upload, }) {
                         return;
                     }
                     setSaid(null);
-                    // Uploaded first: the answer is its ref (REACTOR_UI RU-6).
+                    // Uploaded first: the answer is its ref (RU-6).
                     void upload(chosen)
                         .then(ref => answer(ref))
                         .catch((failure) => setSaid(failure instanceof Error ? failure.message : String(failure)));

package/lib/apps/plugins/app-elements/index.d.ts

@@ -1,12 +1,12 @@
 /**
  * `app-elements` — what an application's code opens beside the
- * conversation (LOOP P-18): `session.show(..., where="panel")` a side panel,
+ * conversation (P-18): `session.show(..., where="panel")` a side panel,
  * `where="page"` a page of its own over the workspace, each closed by the
  * code (`session.close`) or by the person. Inline, an element is a message,
  * which the chat draws (P-04); this plugin draws the other two.
  *
  * The chat keeps what is open (`chat/base/loopElement`), from the session's
- * ui socket (REACTOR_UI RU-3, RU-W); this plugin draws it from the
+ * ui socket (RU-3, RU-W); this plugin draws it from the
  * workspace's root slot, positioned against the workspace, so that nothing
  * is laid out while nothing is open. It also contributes the renderer of
  * what the code asks (`QuestionView`, RU-4), drawn under the message that

package/lib/apps/plugins/app-elements/index.js

@@ -4,13 +4,13 @@
  */
 /**
  * `app-elements` — what an application's code opens beside the
- * conversation (LOOP P-18): `session.show(..., where="panel")` a side panel,
+ * conversation (P-18): `session.show(..., where="panel")` a side panel,
  * `where="page"` a page of its own over the workspace, each closed by the
  * code (`session.close`) or by the person. Inline, an element is a message,
  * which the chat draws (P-04); this plugin draws the other two.
  *
  * The chat keeps what is open (`chat/base/loopElement`), from the session's
- * ui socket (REACTOR_UI RU-3, RU-W); this plugin draws it from the
+ * ui socket (RU-3, RU-W); this plugin draws it from the
  * workspace's root slot, positioned against the workspace, so that nothing
  * is laid out while nothing is open. It also contributes the renderer of
  * what the code asks (`QuestionView`, RU-4), drawn under the message that

package/lib/apps/plugins/app-page/AppPage.d.ts

@@ -3,16 +3,16 @@
  * the workspace's own renderer (`InlineSurface`), fed by the chat's current
  * turn and its conversation, its buttons — and a Chat block's message, a File
  * upload's files — answered through the chat's controls, what the page did
- * going with the chat's run to the application's session (LOOP R-04).
+ * going with the chat's run to the application's session (R-04).
  *
  * It draws the blocks the workspace's plugins contribute to the Canvas's
  * palette (`loop.canvas.block`, R-01b) and nothing else, so that what the
  * Canvas can place and what the page can draw are one list: a page that
  * uses a block no enabled plugin contributes says so, in place of the page.
- * The components its developer wrote (LOOP P-17) are among them, contributed
+ * The components its developer wrote (P-17) are among them, contributed
  * by its own plugin (`app-components`) with their renderers.
  *
- * A widget's page written in its code (LOOP P-05) runs in a session of its
+ * A widget's page written in its code (P-05) runs in a session of its
  * own, beside the conversation: as an input changes, the page sends them all
  * to the session's `page` action and shows what its code answered at
  * `/outputs/<name>`, in place — no message is sent (`./pageRun`).

package/lib/apps/plugins/app-page/appPageModel.d.ts

@@ -1,6 +1,6 @@
 /**
  * An application's page, as data: what it publishes to its surface by path,
- * what it takes from it, and what a button on it does (LOOP R-01, R-01b,
+ * what it takes from it, and what a button on it does (R-01, R-01b,
  * C-04).
  *
  * A chat, a widget or a worker runs as its conversation. Its page is its
@@ -12,7 +12,7 @@
  * answer stopped, the conversation started over. Nothing here is a server
  * API: what a button did besides its message — the block's action, the files
  * given, the settings — goes with the chat's own run to the application's
- * session (LOOP R-04, `forwardedProps.loop`), which puts a file where the
+ * session (R-04, `forwardedProps.loop`), which puts a file where the
  * application reads it; a setting also reaches a written application in the
  * words of its message.
  *
@@ -140,7 +140,7 @@ export type GivenFile = {
  * cannot go: what was given is not files as File upload gives them, or one
  * is larger than a session takes. What becomes of each — put in the
  * application's sandbox, or its text in the message — is the session's to
- * decide (LOOP R-04).
+ * decide (R-04).
  */
 export declare function givenFiles(files: unknown): {
     files: GivenFile[];
@@ -165,9 +165,9 @@ export declare function pageInputsOf(app: Pick<AppSpec, 'kind' | 'interface'>, i
  * What the page did besides its message, for the session API: the files
  * given with it, the settings it holds. Sent with the chat's own run (AG-UI's
  * `forwardedProps.loop`), so that what it answers streams in the
- * conversation (LOOP R-04). A block sends a message, never an action of its
+ * conversation (R-04). A block sends a message, never an action of its
  * own: an action of the application's code is pressed with the token its
- * session offered, up the ui socket (REACTOR_UI RU-5).
+ * session offered, up the ui socket (RU-5).
  */
 export type AppPageLoop = {
     files?: GivenFile[];

package/lib/apps/plugins/app-page/appPageModel.js

@@ -366,7 +366,7 @@ export const MAX_FILE_BYTES = 25 * 1024 * 1024;
  * cannot go: what was given is not files as File upload gives them, or one
  * is larger than a session takes. What becomes of each — put in the
  * application's sandbox, or its text in the message — is the session's to
- * decide (LOOP R-04).
+ * decide (R-04).
  */
 export function givenFiles(files) {
     if (files === undefined || files === null) {

package/lib/apps/plugins/app-page/index.d.ts

@@ -1,6 +1,6 @@
 /**
  * `@datalayer/loop-plugin-app-page` — an application's page, as a plugin
- * (LOOP R-01, R-01b).
+ * (R-01, R-01b).
  *
  * A chat, a widget or a worker runs as its conversation; its page — its
  * A2UI surface, or the default page of its kind when none is composed — is
@@ -14,7 +14,7 @@
  * its host's (the Studio's run page, its hosted address, its embed) — is
  * contributed by the host through `defineAppHostPagePlugin`, as the
  * workspace's one view (`LoopViewType`), in a workspace without a
- * conversation (LOOP R-02).
+ * conversation (R-02).
  *
  * @module apps/plugins/app-page
  */
@@ -33,7 +33,7 @@ export type AppHostPageProps = {
     workspace: LoopWorkspaceContext;
 };
 /**
- * The plugin that makes a host's page the workspace's view (LOOP R-02): the
+ * The plugin that makes a host's page the workspace's view (R-02): the
  * page a host draws for an application whose kind the workspace has no page
  * for — a decision's. The workspace opens on it; it is ordered before every
  * other view.

package/lib/apps/plugins/app-page/index.js

@@ -32,7 +32,7 @@ export function defineAppPagePlugin(app) {
 /** The view an application's page is, when its host draws it. */
 export const APP_HOST_PAGE_VIEW = 'app-page';
 /**
- * The plugin that makes a host's page the workspace's view (LOOP R-02): the
+ * The plugin that makes a host's page the workspace's view (R-02): the
  * page a host draws for an application whose kind the workspace has no page
  * for — a decision's. The workspace opens on it; it is ordered before every
  * other view.

package/lib/apps/plugins/app-page/pageRun.d.ts

@@ -1,10 +1,10 @@
 /**
- * A widget's page written in its code, run on its inputs (LOOP P-05).
+ * A widget's page written in its code, run on its inputs (P-05).
  *
  * The page opens a session of the application's agent on its runtime
  * (`POST /api/v1/apps/sessions`), then, each time an input changes, sends
  * them all to its page (`POST …/sessions/{uid}/page`, `{inputs}`) — not an
- * action of its code (REACTOR_UI RU-5). The runtime checks them against the
+ * action of its code (RU-5). The runtime checks them against the
  * page's form — refused with 422 and a sentence — runs its code's
  * `@app.page` on them, and answers its outputs as a `CUSTOM` event named
  * `loop.page`, `{inputs, outputs}`, which the page shows in place. Nothing is

package/lib/apps/plugins/app-page/pageRun.js

@@ -3,12 +3,12 @@
  * Distributed under the terms of the Modified BSD License.
  */
 /**
- * A widget's page written in its code, run on its inputs (LOOP P-05).
+ * A widget's page written in its code, run on its inputs (P-05).
  *
  * The page opens a session of the application's agent on its runtime
  * (`POST /api/v1/apps/sessions`), then, each time an input changes, sends
  * them all to its page (`POST …/sessions/{uid}/page`, `{inputs}`) — not an
- * action of its code (REACTOR_UI RU-5). The runtime checks them against the
+ * action of its code (RU-5). The runtime checks them against the
  * page's form — refused with 422 and a sentence — runs its code's
  * `@app.page` on them, and answers its outputs as a `CUSTOM` event named
  * `loop.page`, `{inputs, outputs}`, which the page shows in place. Nothing is

package/lib/apps/plugins/app-rules/AppRulesCard.d.ts

@@ -1,6 +1,6 @@
 /**
  * An application's rules, and the approvals it waits on, beside its page
- * (LOOP R-01b, U-19).
+ * (R-01b, U-19).
  *
  * The rules in words — each action, what it covers, what it does about it —
  * and, under them, what is waiting for the person's yes: the approvals its
@@ -36,23 +36,23 @@ export declare function ruleInWords(rule: AppRuleSpec): {
 };
 /**
  * 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 declare const ruleOfApproval: (approval: ApprovalRecord) => string;
 /**
  * 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`.
  */
 export declare function approvalsOfApp(approvals: ApprovalRecord[], appId: string): ApprovalRecord[];
-/** 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 declare function DraftShown({ draft }: {
     draft: Draft;
 }): JSX.Element;
 /**
- * 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.
  */

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.
  */

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