@datalayer/agent-runtimes 1.5.52 → 1.5.53

package/lib/api/runtimes/environments.d.ts

@@ -27,7 +27,7 @@ export type ListEnvironmentsPage = Omit<ListEnvironmentsResponse, 'environments'
     nextCursor?: string;
 };
 /**
- * The section 10 body of a refusal, from the error a call rejected with.
+ * The error body of a refusal, from the error a call rejected with.
  *
  * @param error - What an environments call rejected with
  * @returns The body, with its `code` and `correlationId`; `undefined` when the
@@ -168,7 +168,7 @@ export declare const updateEnvironmentVersion: (token: string, versionUid: strin
  */
 export declare const validateEnvironmentVersion: (token: string, versionUid: string, request?: IValidateEnvironmentVersionRequest, options?: IEnvironmentsRequestOptions, baseUrl?: string) => Promise<IEnvironmentValidationReport>;
 /**
- * Resolve a version into its lock. The service answers 501 until PLAN_ENV.md
+ * Resolve a version into its lock. The service answers 501 until
  * E1-04 builds the resolver, whose answer this resolves to.
  * @param token - Authentication token
  * @param versionUid - The version's uid

package/lib/api/runtimes/environments.js

@@ -6,8 +6,8 @@
  * Computing environments API functions for the Datalayer platform.
  *
  * `GET /environments` lists the platform's environments and the user
- * environments the caller may use. The registry beside it (PLAN_ENV.md,
- * section 9, served by Runtimes since E1-01) creates environments, their
+ * environments the caller may use. The registry beside it (served by Runtimes since E1-01)
+ * creates environments, their
  * versions, builds and artifacts, and serves build logs. The specification a
  * version carries is typed from the JSON Schema `code-sandboxes` exports
  * (D-14), in `models/environments.generated.ts`.
@@ -15,7 +15,7 @@
  * A conditional write names the record it replaces with `If-Match`, the
  * `etag` every record carries. A keyed create is replayed with the same
  * `Idempotency-Key`. Every call may carry the caller's `X-Correlation-Id`,
- * which a refusal answers in its section 10 body: `asEnvironmentsError` reads
+ * which a refusal answers in its error body: `asEnvironmentsError` reads
  * that body from the error a call rejects with.
  *
  * @module api/runtimes/environments
@@ -58,7 +58,7 @@ const send = (token, method, url, options, body) => {
     });
 };
 /**
- * The section 10 body of a refusal, from the error a call rejected with.
+ * The error body of a refusal, from the error a call rejected with.
  *
  * @param error - What an environments call rejected with
  * @returns The body, with its `code` and `correlationId`; `undefined` when the
@@ -255,7 +255,7 @@ export const validateEnvironmentVersion = async (token, versionUid, request = {}
     return send(token, 'POST', registryUrl(baseUrl, `/environment-versions/${segment(versionUid, 'Version UID')}/validate`), options, request);
 };
 /**
- * Resolve a version into its lock. The service answers 501 until PLAN_ENV.md
+ * Resolve a version into its lock. The service answers 501 until
  * E1-04 builds the resolver, whose answer this resolves to.
  * @param token - Authentication token
  * @param versionUid - The version's uid

package/lib/api/runtimes/runtimes.d.ts

@@ -135,7 +135,7 @@ export interface RuntimeMemory {
     scope?: string | null;
     created_at?: string | null;
     updated_at?: string | null;
-    /** Who corrected it, when it was corrected in place (LOOP R-34). */
+    /** Who corrected it, when it was corrected in place (R-34). */
     corrected_by?: string | null;
     /** When it was corrected (ISO). */
     corrected_at?: string | null;
@@ -189,7 +189,7 @@ export interface ForgetRuntimeMemoriesResponse {
     forgotten: number;
 }
 /**
- * Forget one of the caller's own persisted memories (LOOP R-18).
+ * Forget one of the caller's own persisted memories (R-18).
  *
  * Somebody else's is not found (404), whoever asks: forgetting is the
  * person's own.
@@ -203,7 +203,7 @@ export interface CorrectRuntimeMemoryResponse {
     memory: RuntimeMemory;
 }
 /**
- * Correct one of the caller's own persisted memories in place (LOOP R-34):
+ * Correct one of the caller's own persisted memories in place (R-34):
  * its words become `text`, kept with who corrected it and when.
  *
  * Somebody else's is not found (404), whoever asks; empty words, more than
@@ -214,11 +214,11 @@ export declare const correctRuntimeMemory: (token: string, memoryId: string, tex
  * Forget everything one agent — an application, by its key `app:<uid>` —
  * remembers of the caller, no more than `count`: the number the person was
  * shown and confirmed. When it remembers more now, nothing is forgotten and
- * the service refuses (409) in a sentence (LOOP R-18).
+ * the service refuses (409) in a sentence (R-18).
  */
 export declare const forgetRuntimeMemories: (token: string, agentId: string, count: number, baseUrl?: string) => Promise<ForgetRuntimeMemoriesResponse>;
 /**
- * One allowance of a person (LOOP R-35): `reader` uses what `source`
+ * One allowance of a person (R-35): `reader` uses what `source`
  * remembers of them, both applications by their key `app:<uid>`.
  */
 export interface RuntimeMemoryShare {
@@ -236,13 +236,13 @@ export declare const listRuntimeMemoryShares: (token: string, filter: {
     reader?: string;
 }, baseUrl?: string) => Promise<RuntimeMemoryShare[]>;
 /**
- * Allow `reader` to use what `source` remembers of the caller (LOOP R-35).
+ * Allow `reader` to use what `source` remembers of the caller (R-35).
  * Allowed again, it is kept as it was.
  */
 export declare const allowRuntimeMemoryShare: (token: string, source: string, reader: string, baseUrl?: string) => Promise<RuntimeMemoryShare>;
 /**
  * Stop sharing what `source` remembers of the caller with `reader`
- * (LOOP R-35); the service refuses (404) what was never allowed.
+ * (R-35); the service refuses (404) what was never allowed.
  */
 export declare const stopRuntimeMemoryShare: (token: string, source: string, reader: string, baseUrl?: string) => Promise<void>;
 /**

package/lib/api/runtimes/runtimes.js

@@ -259,7 +259,7 @@ export const getRuntimeMemory = async (token, memoryId, baseUrl = DEFAULT_SERVIC
     };
 };
 /**
- * Forget one of the caller's own persisted memories (LOOP R-18).
+ * Forget one of the caller's own persisted memories (R-18).
  *
  * Somebody else's is not found (404), whoever asks: forgetting is the
  * person's own.
@@ -278,7 +278,7 @@ export const forgetRuntimeMemory = async (token, memoryId, baseUrl = DEFAULT_SER
     };
 };
 /**
- * Correct one of the caller's own persisted memories in place (LOOP R-34):
+ * Correct one of the caller's own persisted memories in place (R-34):
  * its words become `text`, kept with who corrected it and when.
  *
  * Somebody else's is not found (404), whoever asks; empty words, more than
@@ -303,7 +303,7 @@ export const correctRuntimeMemory = async (token, memoryId, text, baseUrl = DEFA
  * Forget everything one agent — an application, by its key `app:<uid>` —
  * remembers of the caller, no more than `count`: the number the person was
  * shown and confirmed. When it remembers more now, nothing is forgotten and
- * the service refuses (409) in a sentence (LOOP R-18).
+ * the service refuses (409) in a sentence (R-18).
  */
 export const forgetRuntimeMemories = async (token, agentId, count, baseUrl = DEFAULT_SERVICE_URLS.RUNTIMES) => {
     validateToken(token);
@@ -346,7 +346,7 @@ export const listRuntimeMemoryShares = async (token, filter, baseUrl = DEFAULT_S
     return Array.isArray(response?.shares) ? response.shares : [];
 };
 /**
- * Allow `reader` to use what `source` remembers of the caller (LOOP R-35).
+ * Allow `reader` to use what `source` remembers of the caller (R-35).
  * Allowed again, it is kept as it was.
  */
 export const allowRuntimeMemoryShare = async (token, source, reader, baseUrl = DEFAULT_SERVICE_URLS.RUNTIMES) => {
@@ -363,7 +363,7 @@ export const allowRuntimeMemoryShare = async (token, source, reader, baseUrl = D
 };
 /**
  * Stop sharing what `source` remembers of the caller with `reader`
- * (LOOP R-35); the service refuses (404) what was never allowed.
+ * (R-35); the service refuses (404) what was never allowed.
  */
 export const stopRuntimeMemoryShare = async (token, source, reader, baseUrl = DEFAULT_SERVICE_URLS.RUNTIMES) => {
     validateToken(token);

package/lib/apps/__tests__/fixtures/sceneCheckCases.json

@@ -1,5 +1,5 @@
 {
-  "says": "What `loop` refuses of a scene, recorded from agentspecs (plans/STUDIO.md S-10).",
+  "says": "What `loop` refuses of a scene, recorded from agentspecs (S-10).",
   "recordedWith": "scripts/record-scene-checks.py",
   "cases": [
     {

package/lib/apps/apps/AppBrowserSandbox.js

@@ -3,7 +3,7 @@
  * Distributed under the terms of the Modified BSD License.
  */
 /**
- * An application's code in the page's sandbox (STUDIO E-11): the tool its
+ * An application's code in the page's sandbox (E-11): the tool its
  * agent runs its code with when it turns in the page — `execute_code`,
  * Python in this browser — and its documents put there before its first run
  * (`browserSandbox`).

package/lib/apps/apps/AppComposer.d.ts

@@ -1,5 +1,5 @@
 /**
- * An application's commands and modes in the composer (LOOP P-19).
+ * An application's commands and modes in the composer (P-19).
  *
  * - Each of its **commands** is a workspace command (`LoopCommand`), listed
  *   in the composer's `/` menu (`composer`): picking it writes `/<name> `,
@@ -9,13 +9,13 @@
  *   one menu each; the option picked goes with every run as
  *   `forwardedProps.loop.modes` (`LoopRunProps`), and the runtime tells the
  *   agent its instructions, on the model it names, for that run.
- * - What a person may **send** without being asked (LOOP P-21,
+ * - What a person may **send** without being asked (P-21,
  *   `interface.uploads`): a paper clip beside the composer takes images,
  *   files and recordings of the kinds and sizes the Appspec says — one it
  *   does not take is refused in a sentence and never read — and the files
  *   held go with the next message as `forwardedProps.loop.files`, then are
  *   let go. The runtime refuses again what was sent all the same.
- * - Its **profiles** (LOOP P-20, `interface.profiles`): a picker beside the
+ * - Its **profiles** (P-20, `interface.profiles`): a picker beside the
  *   composer, on the first unless another is picked. The profile picked goes
  *   with every run as `forwardedProps.loop.profile`, and its starters (else
  *   the application's) are what the empty chat offers, by category

package/lib/apps/apps/AppComposer.js

@@ -4,7 +4,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
  * Distributed under the terms of the Modified BSD License.
  */
 /**
- * An application's commands and modes in the composer (LOOP P-19).
+ * An application's commands and modes in the composer (P-19).
  *
  * - Each of its **commands** is a workspace command (`LoopCommand`), listed
  *   in the composer's `/` menu (`composer`): picking it writes `/<name> `,
@@ -14,13 +14,13 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
  *   one menu each; the option picked goes with every run as
  *   `forwardedProps.loop.modes` (`LoopRunProps`), and the runtime tells the
  *   agent its instructions, on the model it names, for that run.
- * - What a person may **send** without being asked (LOOP P-21,
+ * - What a person may **send** without being asked (P-21,
  *   `interface.uploads`): a paper clip beside the composer takes images,
  *   files and recordings of the kinds and sizes the Appspec says — one it
  *   does not take is refused in a sentence and never read — and the files
  *   held go with the next message as `forwardedProps.loop.files`, then are
  *   let go. The runtime refuses again what was sent all the same.
- * - Its **profiles** (LOOP P-20, `interface.profiles`): a picker beside the
+ * - Its **profiles** (P-20, `interface.profiles`): a picker beside the
  *   composer, on the first unless another is picked. The profile picked goes
  *   with every run as `forwardedProps.loop.profile`, and its starters (else
  *   the application's) are what the empty chat offers, by category

package/lib/apps/apps/AppFeedback.d.ts

@@ -1,5 +1,5 @@
 /**
- * The feedback strip above an application's prompt (LOOP V-18): once an
+ * The feedback strip above an application's prompt (V-18): once an
  * answer is in, a thumb up or down and a comment, kept in the application's
  * record under the conversation it was about.
  *

package/lib/apps/apps/AppKept.d.ts

@@ -1,6 +1,6 @@
 /**
  * What a hosted or embedded application keeps, said under its prompt before
- * the first message (LOOP R-31) — in every layout, since the composer draws
+ * the first message (R-31) — in every layout, since the composer draws
  * what is hung on `LoopPromptPanel` wherever it stands. Gone once a message
  * is sent: what it keeps was said before anything was.
  *

package/lib/apps/apps/AppKept.js

@@ -16,7 +16,7 @@ export function AppKept({ says }) {
     }
     return (
     // Clear of the floating assistant in its corner, at a phone's width too
-    // (REVIEWS Q-08).
+    // (Q-08).
     _jsx("div", { role: "note", style: { padding: `4px var(${ASSISTANT_CLEARANCE_VAR}, 8px) 4px 8px` }, children: _jsx(Text, { sx: { fontSize: 0, color: 'fg.muted' }, children: says }) }));
 }
 /**

package/lib/apps/apps/AppRenderer.d.ts

@@ -1,6 +1,6 @@
 /**
  * An application, rendered: the LOOP workspace configured from an Appspec
- * (LOOP R-01).
+ * (R-01).
  *
  * One renderer for every place an application appears — the Studio's
  * Preview, its hosted page, an embed, the home page — so that what a builder
@@ -28,7 +28,7 @@
  *   address and embedded;
  * - its **frame**, when the host asks (`frame`): the `window-frame` plugin's
  *   window, its title the application's face and name;
- * - its **language** (LOOP P-26): what a person reads of it — its name,
+ * - its **language** (P-26): what a person reads of it — its name,
  *   welcome, starters, settings, commands, modes and profiles — in the first
  *   language they prefer that its Appspec is translated into (`language`,
  *   else the browser's), its own words otherwise (`translatedAppspec`);
@@ -59,7 +59,7 @@ export declare const agentIdOf: (app: Pick<AppSpec, "agent" | "team">) => string
 /**
  * The plugin that makes a LOOP workspace run an application.
  *
- * Its page plugin of the pair (LOOP F-15): named `loop-app-<id>`, as its
+ * Its page plugin of the pair (F-15): named `loop-app-<id>`, as its
  * runtime's plugin is, and requiring it — so that it stands down while its
  * runtime does not hold the application, and comes back when it does
  * (`AppRuntimePlugins` follows the runtime).
@@ -78,10 +78,10 @@ export declare function defineAppPlugin(app: AppSpec, shown?: AppSpec): ReactorP
  * The application on the page: its plugins delivered as one extension named
  * as its plugin pair is, `loop-app-<id>` — the extension its runtime's plugin
  * says too, so that Reactor's manager ("Delivered by") and graph show the
- * page's plugins and the runtime's as one application (LOOP F-15).
+ * page's plugins and the runtime's as one application (F-15).
  */
 export declare function appExtension(app: AppSpec, shown: AppSpec, plugins: PluginRef[]): ReactorExtension;
-/** Which instance of an application runs, as the platform knows it (LOOP R-07). */
+/** Which instance of an application runs, as the platform knows it (R-07). */
 export type AppInstance = {
     /** Its `app` item. */
     appUid?: string;
@@ -91,7 +91,7 @@ export type AppInstance = {
     version?: number;
     /**
      * The organization it belongs to: its agent keeps to that organization's
-     * contexts, read by the runtime from IAM (LOOP U-31); unsaid for an
+     * contexts, read by the runtime from IAM (U-31); unsaid for an
      * application of nobody's organization.
      */
     organizationUid?: string;
@@ -108,7 +108,7 @@ export type AppRendererProps = Omit<LoopEmbedProps, 'agentId'> & {
      */
     onPresence?: (state: PresenceState) => void;
     /**
-     * Its deployment is paused (LOOP R-17), as its host knows it: its chat
+     * Its deployment is paused (R-17), as its host knows it: its chat
      * says *Paused* beside its face and its assistant dozes (T-08, T-22).
      */
     paused?: boolean;
@@ -153,11 +153,11 @@ export type AppRendererProps = Omit<LoopEmbedProps, 'agentId'> & {
     /**
      * The language the person reads it in, as BCP 47 tags it (`fr`, `pt-BR`):
      * the platform's setting when the host knows it. The browser's languages
-     * when unsaid (LOOP P-26).
+     * when unsaid (P-26).
      */
     language?: string;
     /**
-     * Where its voice runs, as its host knows it (VOICE.md VO-49): the speech
+     * Where its voice runs, as its host knows it (VO-49): the speech
      * service's origin and the token it is asked with, and the browser's
      * models (Datalayer's CDN when unsaid). Given, an application whose
      * `interface.voice` is on has the microphone in its composer and its
@@ -168,7 +168,7 @@ export type AppRendererProps = Omit<LoopEmbedProps, 'agentId'> & {
 /** What `interface.layout` sets on the workspace. */
 export type AppLayoutOptions = Pick<LoopPresetOptions, 'editors' | 'showViewSelector' | 'defaultEditor' | 'pageLayout' | 'pageLayoutArrangement' | 'pageLayoutPrompt' | 'pageLayoutPromptAnchor' | 'pageLayoutTurnPanelFooter'>;
 /**
- * The workspace an application's layout asks for (LOOP T-07).
+ * The workspace an application's layout asks for (T-07).
  *
  * - `chat`: the conversation alone — no editor, no page, no strip.
  * - `page`: the page layout — its page (or, without one, the editors) on the
@@ -189,7 +189,7 @@ export type AppPreset = {
 };
 /**
  * The plugins an application's kind needs, and how its workspace is laid
- * out (LOOP R-01): the preset per kind, as `loopPlugins` is for the examples.
+ * out (R-01): the preset per kind, as `loopPlugins` is for the examples.
  *
  * - a **chat**, a **widget**, a **worker**: its agent (`defineAppPlugin`);
  *   its page (`app-page`) when it has one, with the Canvas's block plugins
@@ -238,7 +238,7 @@ export declare function appPreset(app: AppSpec, options?: {
  * What an application's agent is created with on a Datalayer runtime: under
  * the application's id, over AG-UI, with the application's own document —
  * so that the runtime registers it and decides every tool call by its rules
- * (LOOP R-03, R-05), as `loop apps run --cloud` does. One payload for every
+ * (R-03, R-05), as `loop apps run --cloud` does. One payload for every
  * place it runs, all of them the workspace (`AppRenderer`): the Studio's
  * Preview, the hosted page, and the embed inline and floating.
  */
@@ -254,7 +254,7 @@ export declare function appDatalayerCreatePayload(app: AppSpec, instance?: AppIn
 export declare const DATALAYER_BOOTSTRAP_AGENTSPEC = "example-simple";
 /**
  * The application's accent over the theme its conversation wears, in both
- * modes (LOOP T-05): its bubbles and its one button in its own colour, and
+ * modes (T-05): its bubbles and its one button in its own colour, and
  * not in the theme's default — the chat sets its theme again inside it, so
  * what the page around it set does not reach in. The accents are the theme
  * system's: laid over whatever theme it wears (T-30; decided 2026-10-07).
@@ -262,7 +262,7 @@ export declare const DATALAYER_BOOTSTRAP_AGENTSPEC = "example-simple";
  */
 export declare function appThemeOverrides(app: AppSpec): ThemeOverrides | undefined;
 /**
- * The agent an application's chat speaks to (STUDIO D-15): its own, made
+ * The agent an application's chat speaks to (D-15): its own, made
  * under its id — or, for a visitor without an account, the one of the
  * visitors' runtime their token reaches (`visitorAgentOf`): an example's by
  * its id, an application at its address by `at-<slug>`. A token for another

package/lib/apps/apps/AppRenderer.js

@@ -5,7 +5,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
  */
 /**
  * An application, rendered: the LOOP workspace configured from an Appspec
- * (LOOP R-01).
+ * (R-01).
  *
  * One renderer for every place an application appears — the Studio's
  * Preview, its hosted page, an embed, the home page — so that what a builder
@@ -33,7 +33,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
  *   address and embedded;
  * - its **frame**, when the host asks (`frame`): the `window-frame` plugin's
  *   window, its title the application's face and name;
- * - its **language** (LOOP P-26): what a person reads of it — its name,
+ * - its **language** (P-26): what a person reads of it — its name,
  *   welcome, starters, settings, commands, modes and profiles — in the first
  *   language they prefer that its Appspec is translated into (`language`,
  *   else the browser's), its own words otherwise (`translatedAppspec`);
@@ -88,7 +88,7 @@ export const agentIdOf = (app) => {
 /**
  * The plugin that makes a LOOP workspace run an application.
  *
- * Its page plugin of the pair (LOOP F-15): named `loop-app-<id>`, as its
+ * Its page plugin of the pair (F-15): named `loop-app-<id>`, as its
  * runtime's plugin is, and requiring it — so that it stands down while its
  * runtime does not hold the application, and comes back when it does
  * (`AppRuntimePlugins` follows the runtime).
@@ -121,7 +121,7 @@ export function defineAppPlugin(app, shown = app) {
             name: app.id,
             app_spec: dumpAppspec(app),
             // Its shell is its code: Codemode's `execute_code`, only when it is on
-            // (LOOP R-23), as on Datalayer (`appDatalayerCreatePayload`).
+            // (R-23), as on Datalayer (`appDatalayerCreatePayload`).
             enable_codemode: Boolean(app.permissions?.computer?.shell),
             ...(app.model ? { model: app.model } : {}),
         },
@@ -132,12 +132,12 @@ export function defineAppPlugin(app, shown = app) {
         // spec's prompt, then the application's instructions; on the
         // application's model when it names one (`apps/apps/agent`). An agent
         // that computes in code is told where its code runs there, and where its
-        // documents are (STUDIO E-11, `browserSandbox`).
+        // documents are (E-11, `browserSandbox`).
         instructions: runsCodeInSandbox(app)
             ? [app.instructions, browserSandboxNote(app)].filter(Boolean).join('\n\n')
             : app.instructions,
         model: app.model,
-        // Its modes and its profiles (LOOP P-19, P-20), as the session API
+        // Its modes and its profiles (P-19, P-20), as the session API
         // applies them: the profile's instructions and those of the options
         // chosen, and the model one names, for the run they are sent with.
         ...((app.interface.modes ?? []).length > 0 ||
@@ -152,7 +152,7 @@ export function defineAppPlugin(app, shown = app) {
  * The application on the page: its plugins delivered as one extension named
  * as its plugin pair is, `loop-app-<id>` — the extension its runtime's plugin
  * says too, so that Reactor's manager ("Delivered by") and graph show the
- * page's plugins and the runtime's as one application (LOOP F-15).
+ * page's plugins and the runtime's as one application (F-15).
  */
 export function appExtension(app, shown, plugins) {
     return defineExtension({
@@ -165,7 +165,7 @@ export function appExtension(app, shown, plugins) {
     });
 }
 /**
- * The workspace an application's layout asks for (LOOP T-07).
+ * The workspace an application's layout asks for (T-07).
  *
  * - `chat`: the conversation alone — no editor, no page, no strip.
  * - `page`: the page layout — its page (or, without one, the editors) on the
@@ -197,7 +197,7 @@ export function appLayoutOptions(app) {
 }
 /**
  * The plugins an application's kind needs, and how its workspace is laid
- * out (LOOP R-01): the preset per kind, as `loopPlugins` is for the examples.
+ * out (R-01): the preset per kind, as `loopPlugins` is for the examples.
  *
  * - a **chat**, a **widget**, a **worker**: its agent (`defineAppPlugin`);
  *   its page (`app-page`) when it has one, with the Canvas's block plugins
@@ -246,18 +246,17 @@ export function appPreset(app, options = {}) {
             // (P-29).
             defineAppRuntimePlugin(app.id, { pageSide: hasFolderModules(app) }),
             // Its code in the browser's sandbox, when it turns in the page and
-            // computes in code (STUDIO E-11): `execute_code`, its documents there.
+            // computes in code (E-11): `execute_code`, its documents there.
             ...(runsCodeInSandbox(app) ? [defineAppBrowserSandboxPlugin(app)] : []),
             ...(withPage ? [defineAppPagePlugin(shown), ...blocks] : []),
-            // The components its developer wrote (LOOP P-17): blocks of its page
+            // The components its developer wrote (P-17): blocks of its page
             // and renderers of its page, its elements and its answers — its own.
             ...(hasCustomComponents(app) ? [defineAppComponentsPlugin(app)] : []),
             // Its commands in the composer's `/` menu, its modes and its profiles
-            // beside the composer (LOOP P-19, P-20) and what a person may attach
+            // beside the composer (P-19, P-20) and what a person may attach
             // there (P-21): only for an application that has some.
             ...(needsAppComposer(app) ? [defineAppComposerPlugin(shown)] : []),
-            // A thumb and a comment on each answer, kept in its record (LOOP
-            // V-18): only for an application whose record keeps feedback.
+            // A thumb and a comment on each answer, kept in its record (V-18): only for an application whose record keeps feedback.
             ...(keepsFeedback(app) ? [defineAppFeedbackPlugin(app)] : []),
             // What it keeps, and for how long, before anything is said (R-31).
             ...(options.kept
@@ -275,7 +274,7 @@ export function appPreset(app, options = {}) {
                 : options.computer
                     ? [defineAppComputerPlugin(app)]
                     : []),
-            // What its code opens beside the conversation (LOOP P-18): a side
+            // What its code opens beside the conversation (P-18): a side
             // panel, a page of its own; nothing drawn while nothing is open.
             AppElementsPlugin,
         ],
@@ -286,7 +285,7 @@ export function appPreset(app, options = {}) {
  * What an application's agent is created with on a Datalayer runtime: under
  * the application's id, over AG-UI, with the application's own document —
  * so that the runtime registers it and decides every tool call by its rules
- * (LOOP R-03, R-05), as `loop apps run --cloud` does. One payload for every
+ * (R-03, R-05), as `loop apps run --cloud` does. One payload for every
  * place it runs, all of them the workspace (`AppRenderer`): the Studio's
  * Preview, the hosted page, and the embed inline and floating.
  */
@@ -328,7 +327,7 @@ export const DATALAYER_BOOTSTRAP_AGENTSPEC = 'example-simple';
 const NO_PLUGINS = [];
 /**
  * The application's accent over the theme its conversation wears, in both
- * modes (LOOP T-05): its bubbles and its one button in its own colour, and
+ * modes (T-05): its bubbles and its one button in its own colour, and
  * not in the theme's default — the chat sets its theme again inside it, so
  * what the page around it set does not reach in. The accents are the theme
  * system's: laid over whatever theme it wears (T-30; decided 2026-10-07).
@@ -344,7 +343,7 @@ export function appThemeOverrides(app) {
         : undefined;
 }
 /**
- * The agent an application's chat speaks to (STUDIO D-15): its own, made
+ * The agent an application's chat speaks to (D-15): its own, made
  * under its id — or, for a visitor without an account, the one of the
  * visitors' runtime their token reaches (`visitorAgentOf`): an example's by
  * its id, an application at its address by `at-<slug>`. A token for another
@@ -429,8 +428,7 @@ export function AppRenderer({ app, plugins = NO_PLUGINS, instance, onPresence, o
     /*
      * On Datalayer, the application runs on a runtime: allocated with a plain
      * agentspec, its agent created there with the application's spec — so that
-     * the runtime registers it and decides every tool call by its rules (LOOP
-     * R-03, R-05), as `loop apps run --cloud` does.
+     * the runtime registers it and decides every tool call by its rules (R-03, R-05), as `loop apps run --cloud` does.
      */
     const conversation = !('problem' in preset) && preset.workspace.conversation !== false;
     const datalayerCreatePayload = useMemo(() => (conversation ? appDatalayerCreatePayload(app, instance) : undefined), 

package/lib/apps/apps/AppRuntimePlugins.js

@@ -4,8 +4,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
  * Distributed under the terms of the Modified BSD License.
  */
 /**
- * The page told which of an application's plugins its runtime holds (LOOP
- * F-15).
+ * The page told which of an application's plugins its runtime holds (F-15).
  *
  * The application's page plugin requires the runtime's plugin of the same
  * name (`requiredBackendPlugins`). Reactor stands such a plugin down while
@@ -23,7 +22,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
  *   its own runtime, and the pair is whole: nothing stands down, nothing is
  *   blank.
  *
- * An application whose components are files of its folder (LOOP P-29) has
+ * An application whose components are files of its folder (P-29) has
  * its page side in its package, installed beside the server that runs it:
  * once on a runtime, the page reads it there with Reactor's
  * `bootstrapExtensions` (`<base>/plugins/frontend-extensions`) and installs

package/lib/apps/apps/agent.js

@@ -3,7 +3,7 @@
  * Distributed under the terms of the Modified BSD License.
  */
 /**
- * The agent an application runs, as the page turns it (LOOP H-01, E-11).
+ * The agent an application runs, as the page turns it (H-01, E-11).
  *
  * On a runtime, an application's agent is its agent's spec — an agent of the
  * catalogue, or a Cog's, which is an agent equipped with Frames, their

package/lib/apps/apps/appspec.d.ts

@@ -27,23 +27,23 @@
 import type { AppAccent, AppThemeMode, AppThemeVariant, AppAssistantCharacter, AppEmbedMode, PapProfile, AppCustomComponentSpec, AppVoiceSpec, AppKind, AppLayout, AppPageOutputComponent, AppSpec, UiChoice } from '../../types/agentspecs';
 /** The version of the spec itself. */
 export declare const APP_SCHEMA = "loop.app/v1";
-/** The language an application's own words are in, unless it says (LOOP P-26). */
+/** The language an application's own words are in, unless it says (P-26). */
 export declare const DEFAULT_LANGUAGE = "en";
 /** The face of an application that has not chosen one. */
 export declare const DEFAULT_EMOJI = "\uD83D\uDC40";
 export declare const APP_KINDS: AppKind[];
 export declare const APP_ACCENTS: AppAccent[];
 /**
- * The themes an application may run in (LOOP T-30): Appearance's, as
+ * The themes an application may run in (T-30): Appearance's, as
  * primer-addons lists them (`themeVariants`), in its order.
  */
 export declare const APP_THEME_VARIANTS: AppThemeVariant[];
 /** The colour modes a theme is worn in. */
 export declare const APP_THEME_MODES: AppThemeMode[];
-/** The four ways an application sits in another product's page (LOOP D-07). */
+/** The four ways an application sits in another product's page (D-07). */
 export declare const APP_EMBED_MODES: AppEmbedMode[];
 /**
- * How an Appspec names the character of its floating assistant (LOOP T-24):
+ * How an Appspec names the character of its floating assistant (T-24):
  * the id a plugin contributes it under, `paperclip` or `acme-owl` — as
  * agentspecs' `ASSISTANT_CHARACTER_ID`. Which ids exist is what the enabled
  * plugins contribute (`assistantCharacterNamed`), not the spec's to say.
@@ -67,7 +67,7 @@ export interface AppUiFacts {
     ownComponents?: boolean;
 }
 /**
- * The UI plugins an application is drawn with (AGENTIC_UI R8), as its `ui`
+ * The UI plugins an application is drawn with (R8), as its `ui`
  * lists them: what `appPreset` mounts for it. A decision: its page alone,
  * drawn by its host. Every other kind: the conversation — `chat`, which
  * stands for the conversation base the runtime mounts — then the A2UI
@@ -90,7 +90,7 @@ type Data = Record<string, unknown>;
 export declare function retentionDays(keepFor: string): number;
 /** An application with nothing said: what *Start blank* opens. */
 export declare function emptyAppspec(kind?: AppKind): AppSpec;
-/** The Personal Agent Protocol profiles Datalayer speaks, as agentspecs' `PAP_PROFILES` (PAP_DATALAYER S-03). */
+/** The Personal Agent Protocol profiles Datalayer speaks, as agentspecs' `PAP_PROFILES` (S-03). */
 export declare const PAP_PROFILES: readonly PapProfile[];
 /** The profile a `pap` block is written for when the Studio or a builder starts one. */
 export declare const PAP_PROFILE: PapProfile;
@@ -99,9 +99,9 @@ export declare const PAP_PROFILE: PapProfile;
  * (`pap_profile_problem`); `undefined` when it is one Datalayer speaks.
  */
 export declare function papProfileProblem(value: unknown): string | undefined;
-/** An application's voice (VOICE.md VO-41): off unless said. */
+/** An application's voice (VO-41): off unless said. */
 export declare const DEFAULT_VOICE: AppVoiceSpec;
-/** What a page's output may be drawn with (LOOP P-05), and the property of each that shows its value. */
+/** What a page's output may be drawn with (P-05), and the property of each that shows its value. */
 export declare const PAGE_OUTPUT_SHOWS: Record<AppPageOutputComponent, string>;
 /** The height of a component its developer wrote (P-17), unless it says. */
 export declare const DEFAULT_CUSTOM_HEIGHT = 240;
@@ -127,7 +127,7 @@ export interface ParsedAppspec {
  */
 export declare function parseAppspec(document: unknown): ParsedAppspec;
 /**
- * What is wrong with the UI plugins an application names (AGENTIC_UI R8), in
+ * What is wrong with the UI plugins an application names (R8), in
  * the sentences agentspecs says (`ui_choices_problems`): a plugin the
  * catalogue does not have or said twice — a renderer named as a plugin is
  * refused —, a renderer the catalogue does not have or the plugin may not be
@@ -136,7 +136,7 @@ export declare function parseAppspec(document: unknown): ParsedAppspec;
 export declare function uiProblems(app: Pick<AppSpec, 'ui' | 'enabled'>): string[];
 /**
  * What is wrong with the protocols an application says it speaks
- * (AGENT_PROTOCOLS PS-02), as agentspecs says it: an id the catalogue does not
+ * (PS-02), as agentspecs says it: an id the catalogue does not
  * know or said twice, a planned protocol while it is offered, and a `pap`,
  * `pact`, `a2a` or `signed_fetch` block configuring a protocol it does not list.
  */