@datalayer/agent-runtimes 1.5.52 → 1.5.53

package/lib/examples/AssistantGalleryExample.d.ts

@@ -1,5 +1,5 @@
 /**
- * Every representation of the floating assistant, as a gallery (LOOP T-21
+ * Every representation of the floating assistant, as a gallery (T-21
  * to T-27): each character — Datalayer's four, the owl an example plugin
  * contributes to `loop.assistant.character`, a test sprite read through
  * the clippy.js reader, and, when asked, the characters clippy.js publishes,

package/lib/examples/AssistantGalleryExample.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.
  */
 /**
- * Every representation of the floating assistant, as a gallery (LOOP T-21
+ * Every representation of the floating assistant, as a gallery (T-21
  * to T-27): each character — Datalayer's four, the owl an example plugin
  * contributes to `loop.assistant.character`, a test sprite read through
  * the clippy.js reader, and, when asked, the characters clippy.js publishes,

package/lib/examples/LoopAppComputerExample.d.ts

@@ -1,5 +1,5 @@
 /**
- * An application's computer, beside its page (LOOP R-23).
+ * An application's computer, beside its page (R-23).
  *
  * An application whose browse, files and shell are on, drawn as the Studio's Preview
  * draws it — `AppRenderer` with its `sidebar` — on the Local target: its

package/lib/examples/LoopAppComputerExample.js

@@ -4,7 +4,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
  * Distributed under the terms of the Modified BSD License.
  */
 /**
- * An application's computer, beside its page (LOOP R-23).
+ * An application's computer, beside its page (R-23).
  *
  * An application whose browse, files and shell are on, drawn as the Studio's Preview
  * draws it — `AppRenderer` with its `sidebar` — on the Local target: its

package/lib/examples/ProtocolSignedRequestsExample.d.ts

@@ -1,5 +1,5 @@
 /**
- * Signed requests (Web Bot Auth) in the browser (AGENT_PROTOCOLS EX-10): a
+ * Signed requests (Web Bot Auth) in the browser (EX-10): a
  * key generated in the page signs one request; the page shows the three
  * headers, the signature base the key signed, and what a website's check
  * finds — verified, then the same request replayed and one with its path

package/lib/examples/ProtocolSignedRequestsExample.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.
  */
 /**
- * Signed requests (Web Bot Auth) in the browser (AGENT_PROTOCOLS EX-10): a
+ * Signed requests (Web Bot Auth) in the browser (EX-10): a
  * key generated in the page signs one request; the page shows the three
  * headers, the signature base the key signed, and what a website's check
  * finds — verified, then the same request replayed and one with its path

package/lib/examples/ProtocolUcpCheckoutExample.d.ts

@@ -1,5 +1,5 @@
 /**
- * A UCP checkout approved as a card (AGENT_PROTOCOLS EX-10, after EX-04):
+ * A UCP checkout approved as a card (EX-10, after EX-04):
  * the UCP client buys from *Example Store*, the local test merchant running
  * in the page. The exact purchase is proposed; completing it asks the
  * approver — the card below — once; approving buys once, and the same

package/lib/examples/ProtocolUcpCheckoutExample.js

@@ -4,7 +4,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * Distributed under the terms of the Modified BSD License.
  */
 /**
- * A UCP checkout approved as a card (AGENT_PROTOCOLS EX-10, after EX-04):
+ * A UCP checkout approved as a card (EX-10, after EX-04):
  * the UCP client buys from *Example Store*, the local test merchant running
  * in the page. The exact purchase is proposed; completing it asks the
  * approver — the card below — once; approving buys once, and the same

package/lib/examples/ScenesExample.d.ts

@@ -1,5 +1,5 @@
 /**
- * The scenes of the catalogue (agentspecs `scenes`, LOOP A-15), in tabs:
+ * The scenes of the catalogue (agentspecs `scenes`, A-15), in tabs:
  * each scene's face and name, its `assumes` line under them, its graph and
  * its transcript behind *Graph · Transcript* (`SceneView`), its members
  * standing where its stage directions put them (`positions`), the entry's

package/lib/examples/ScenesExample.js

@@ -208,7 +208,7 @@ function Scene({ scene }) {
                                 } }), _jsxs(Box, { display: "flex", gap: 2, mt: 2, children: [_jsx(Button, { variant: "primary", disabled: !team.ready || team.busy || !draft.trim(), onClick: () => send(draft), children: "Ask" }), team.busy && _jsx(Button, { onClick: team.stop, children: "Stop" })] }), _jsx(Box, { mt: 3, "data-team-conversation": "", children: team.turns.map((turn, index) => (_jsxs(Box, { p: 2, mb: 2, borderRadius: 2, bg: turn.role === 'user' ? 'accent.subtle' : 'canvas.subtle', children: [_jsx(Text, { sx: { fontSize: 0, color: 'fg.muted', display: 'block' }, children: turn.role === 'user' ? PERSON : entry.app.name }), _jsx(Streamdown, { children: turn.text })] }, index))) })] }), _jsxs(Box, { flex: "1 1 360px", minWidth: 0, children: [!team.notebook && stage.peers.length > 0 && (_jsxs(_Fragment, { children: [_jsx(Heading, { as: "h3", sx: { fontSize: 2, mb: 2 }, children: "The report" }), _jsx(Box, { p: 3, border: "1px solid", borderColor: "border.default", borderRadius: 2, minHeight: 120, "data-team-report": "", children: team.report ? (_jsx(Streamdown, { children: team.report })) : (_jsx(Text, { sx: { color: 'fg.muted' }, children: "What the last member asked returns appears here, as it returned it, or as a notebook to run when it gives one." })) })] })), scene.setup.length > 0 && (_jsxs(Box, { mt: 3, "data-scene-setup": "", children: [_jsx(Heading, { as: "h3", sx: { fontSize: 1, mb: 1 }, children: "What this scene needs" }), scene.setup.map(line => (_jsx(Text, { as: "p", sx: { fontSize: 0, color: 'fg.muted', m: 0 }, children: line }, line)))] }))] })] })] }));
 }
 function Scenes() {
-    // A scripted scene is played as written on its page (PAP_DATALAYER X-02): here, the teams staged live.
+    // A scripted scene is played as written on its page (X-02): here, the teams staged live.
     const scenes = useMemo(() => listSceneSpecs().filter(scene => scene.kind === 'team'), []);
     const [selected, setSelected] = useState(scenes[0]?.id ?? '');
     const scene = scenes.find(one => one.id === selected) ?? scenes[0];

package/lib/examples/ShieldHarnessExample.d.ts

@@ -1,5 +1,5 @@
 /**
- * A coding agent behind the Shield, in the web chat (SHIELD §4.3, SH-16; SH-23).
+ * A coding agent behind the Shield, in the web chat (SH-16, SH-23).
  *
  * The chat talks AG-UI to a local runtime whose agent is a harness: what the
  * agent changed is drawn as a **diff** in the file's language, what it ran

package/lib/examples/ShieldHarnessExample.js

@@ -4,7 +4,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * Distributed under the terms of the Modified BSD License.
  */
 /**
- * A coding agent behind the Shield, in the web chat (SHIELD §4.3, SH-16; SH-23).
+ * A coding agent behind the Shield, in the web chat (SH-16, SH-23).
  *
  * The chat talks AG-UI to a local runtime whose agent is a harness: what the
  * agent changed is drawn as a **diff** in the file's language, what it ran

package/lib/examples/ShieldPolicyExample.d.ts

@@ -1,5 +1,5 @@
 /**
- * The Shield's policy, from TypeScript (SHIELD §5.1, SH-53; SH-23).
+ * The Shield's policy, from TypeScript (SH-53, SH-23).
  *
  * An organization's document typed by `@datalayer/agent-shield` (the types
  * generated from the schema the Python package publishes), what it decides

package/lib/examples/ShieldPolicyExample.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.
  */
 /**
- * The Shield's policy, from TypeScript (SHIELD §5.1, SH-53; SH-23).
+ * The Shield's policy, from TypeScript (SH-53, SH-23).
  *
  * An organization's document typed by `@datalayer/agent-shield` (the types
  * generated from the schema the Python package publishes), what it decides

package/lib/examples/VoiceChatExample.d.ts

@@ -1,5 +1,5 @@
 /**
- * A voice chat with the floating assistant (VOICE.md V1).
+ * A voice chat with the floating assistant (V1).
  *
  * Click the microphone and speak: the words are written in the composer as
  * they are heard — Moonshine for English, Whisper for French, Silero VAD

package/lib/examples/VoiceChatExample.js

@@ -4,7 +4,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * Distributed under the terms of the Modified BSD License.
  */
 /**
- * A voice chat with the floating assistant (VOICE.md V1).
+ * A voice chat with the floating assistant (V1).
  *
  * Click the microphone and speak: the words are written in the composer as
  * they are heard — Moonshine for English, Whisper for French, Silero VAD

package/lib/examples/example-selector.js

@@ -114,8 +114,8 @@ export const EXAMPLE_ENTRIES = [
     // the shell hides the one in its header rather than showing two controls
     // for one sandbox — and a second one that would not agree with the first.
     ['example', 'loop', 'workspace', 'sandbox', 'owns-sandbox-control']),
-    makeEntry('LoopAppComputerExample', () => import('./LoopAppComputerExample'), 'An application beside its computer: what its agent ran on its sandbox, its files, and Take over and Hand back (LOOP R-23).', ['example', 'loop', 'app', 'computer', 'sandbox', 'owns-sandbox-control']),
-    makeEntry('ScenesExample', () => import('./ScenesExample'), 'The scenes of the catalogue in tabs — Sales & Accounting, Month-end Close, Crop Monitoring, Disaster Assessment — each its graph and transcript, its cues as suggestions, played against the local servers (LOOP A-15).', ['example', 'loop', 'scenes', 'a2a', 'agentspecs', 'team']),
+    makeEntry('LoopAppComputerExample', () => import('./LoopAppComputerExample'), 'An application beside its computer: what its agent ran on its sandbox, its files, and Take over and Hand back (R-23).', ['example', 'loop', 'app', 'computer', 'sandbox', 'owns-sandbox-control']),
+    makeEntry('ScenesExample', () => import('./ScenesExample'), 'The scenes of the catalogue in tabs — Sales & Accounting, Month-end Close, Crop Monitoring, Disaster Assessment — each its graph and transcript, its cues as suggestions, played against the local servers (A-15).', ['example', 'loop', 'scenes', 'a2a', 'agentspecs', 'team']),
     makeEntry('LoopShellExample', () => import('./LoopShellExample'), 'The Loop shell at its most naked: a blank canvas, a floating draggable prompt, and an editor selector in the corner — none, notebook or document.', 
     // `owns-sandbox-control`: the shell is pinned to the browser sandbox, so
     // the page's selector would offer three targets it cannot move to.
@@ -133,7 +133,7 @@ export const EXAMPLE_ENTRIES = [
     makeEntry('AgentA2ATeamExample', () => import('./AgentA2ATeamExample'), 'Two applications as a team over A2A: Sales in the browser (@a2a-js/sdk) asks Accounting on a runtime (fasta2a, Odoo read only), each an Office Assistant character.'),
     makeEntry('ProtocolSignedRequestsExample', () => import('./ProtocolSignedRequestsExample'), 'Web Bot Auth in the browser: a key made in the page signs a request — its three headers and the signature base — verified, then a replay and a changed path refused.'),
     makeEntry('ProtocolUcpCheckoutExample', () => import('./ProtocolUcpCheckoutExample'), 'A UCP checkout at a test store in the page: the exact purchase proposed, approved on a card once, bought once.'),
-    // The Shield (SHIELD.md SH-23): a coding agent behind it, and its policy's types.
+    // The Shield (SH-23): a coding agent behind it, and its policy's types.
     makeEntry('ShieldHarnessExample', () => import('./ShieldHarnessExample'), 'A coding agent behind the Shield in the web chat: its changes as diffs, its commands as terminals, what a rule asks first in the approval banner. Needs `python examples/shield/harness_on_the_runtime.py --serve` (the fake agent, no key).', ['example', 'shield', 'harness', 'acp', 'ag-ui', 'chat']),
     makeEntry('ShieldPolicyExample', () => import('./ShieldPolicyExample'), 'The Shield’s policy from TypeScript: an organization’s document typed by @datalayer/agent-shield, what it decides by class, the tool kinds classed, the limits soft then hard, decisions in describeDecision’s words.', ['example', 'shield', 'policy']),
     makeEntry('PapCompanyDiscoveryExample', () => import('./PapCompanyDiscoveryExample'), 'Validate a PAP company document and reduce it to the public capabilities safe for an agent or UI.'),

package/lib/examples/exampleGroups.js

@@ -27,7 +27,7 @@ export const EXAMPLE_GROUP_ORDER = [
 ];
 export const getExampleGroup = (id) => {
     // The library of specs, the Loop shells, and the scenes of the catalogue
-    // (LOOP A-15): the applications and what is staged with them.
+    // (A-15): the applications and what is staged with them.
     if (id === 'AgentspecsExample' ||
         id === 'ScenesExample' ||
         id.startsWith('Loop') ||
@@ -41,10 +41,10 @@ export const getExampleGroup = (id) => {
         return 'A2A';
     if (id.startsWith('Pap'))
         return 'Personal Agent Protocol';
-    // The other agent protocols' examples: signed requests, commerce (AGENT_PROTOCOLS EX-10).
+    // The other agent protocols' examples: signed requests, commerce (EX-10).
     if (id.startsWith('Protocol'))
         return 'Agent protocols';
-    // The Shield: a coding agent behind it, and its policy (SHIELD.md SH-23).
+    // The Shield: a coding agent behind it, and its policy (SH-23).
     if (id.startsWith('Shield'))
         return 'Shield';
     if (id.startsWith('AgUi'))

package/lib/examples/pap/PapSignInDisplayView.d.ts

@@ -1,5 +1,5 @@
 /**
- * The sign-in card as a display (REACTOR_UI RU-1), drawn as the chat draws it.
+ * The sign-in card as a display (RU-1), drawn as the chat draws it.
  *
  * A tool that starts a sign-in answers with a `PapSignIn` display
  * (`application/vnd.datalayer.pap.sign-in+json`). Agent Runtimes gives the

package/lib/examples/pap/PapSignInDisplayView.js

@@ -4,7 +4,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * Distributed under the terms of the Modified BSD License.
  */
 /**
- * The sign-in card as a display (REACTOR_UI RU-1), drawn as the chat draws it.
+ * The sign-in card as a display (RU-1), drawn as the chat draws it.
  *
  * A tool that starts a sign-in answers with a `PapSignIn` display
  * (`application/vnd.datalayer.pap.sign-in+json`). Agent Runtimes gives the

package/lib/examples/pap/papSignInCases.js

@@ -3,7 +3,7 @@
  * Distributed under the terms of the Modified BSD License.
  */
 /**
- * The results a page receives for a sign-in (REACTOR_UI RU-1), as Agent
+ * The results a page receives for a sign-in (RU-1), as Agent
  * Runtimes sends them: a display's model view with the whole display beside
  * it in `_meta`, or a plain `pap_sign_in` answer. Fictional company, no
  * credential.

package/lib/examples/protocols/signedRequestsDemo.d.ts

@@ -1,5 +1,5 @@
 /**
- * The *Signed requests* gallery example's work (AGENT_PROTOCOLS EX-10): a
+ * The *Signed requests* gallery example's work (EX-10): a
  * fresh Ed25519 key generated in the page, one request signed with it
  * (`signRequest`), the three headers and the signature base the signer was
  * handed, then the request verified against the key's directory — and the

package/lib/examples/protocols/signedRequestsDemo.js

@@ -3,7 +3,7 @@
  * Distributed under the terms of the Modified BSD License.
  */
 /**
- * The *Signed requests* gallery example's work (AGENT_PROTOCOLS EX-10): a
+ * The *Signed requests* gallery example's work (EX-10): a
  * fresh Ed25519 key generated in the page, one request signed with it
  * (`signRequest`), the three headers and the signature base the signer was
  * handed, then the request verified against the key's directory — and the

package/lib/examples/protocols/ucpCheckoutDemo.d.ts

@@ -1,5 +1,5 @@
 /**
- * The *UCP checkout* gallery example's work (AGENT_PROTOCOLS EX-10, after
+ * The *UCP checkout* gallery example's work (EX-10, after
  * EX-04): the UCP client buying from *Example Store*, the local test
  * merchant running in the page (`protocols/ucp/merchant`). A checkout is
  * proposed as an exact, revisioned purchase; completing it asks the host's

package/lib/examples/protocols/ucpCheckoutDemo.js

@@ -3,7 +3,7 @@
  * Distributed under the terms of the Modified BSD License.
  */
 /**
- * The *UCP checkout* gallery example's work (AGENT_PROTOCOLS EX-10, after
+ * The *UCP checkout* gallery example's work (EX-10, after
  * EX-04): the UCP client buying from *Example Store*, the local test
  * merchant running in the page (`protocols/ucp/merchant`). A checkout is
  * proposed as an exact, revisioned purchase; completing it asks the host's

package/lib/examples/shield/shieldHarness.d.ts

@@ -1,5 +1,5 @@
 /**
- * What `ShieldHarnessExample` connects to and offers (SHIELD SH-23).
+ * What `ShieldHarnessExample` connects to and offers (SH-23).
  *
  * `examples/shield/harness_on_the_runtime.py --serve` names the harness's
  * agent `chat`, as `loop --harness` does with `AGENT_RUNTIMES_AGENT_NAME`;

package/lib/examples/shield/shieldPolicyDemo.d.ts

@@ -1,5 +1,5 @@
 /**
- * What `ShieldPolicyExample` draws, as data (SHIELD §5.1, SH-53; SH-23).
+ * What `ShieldPolicyExample` draws, as data (SH-53, SH-23).
  *
  * `@datalayer/agent-shield` is the Shield's TypeScript: the policy
  * document's types generated from the schema the Python package publishes,
@@ -65,7 +65,7 @@ export declare function classRows(shield: AgentShieldPolicyModule, policy?: Poli
     actionClass: string;
     says: string;
 }>;
-/** ACP's tool kinds and the class each is decided as (§4.5). */
+/** ACP's tool kinds and the class each is decided as. */
 export declare function kindRows(shield: AgentShieldPolicyModule): Array<{
     kind: string;
     actionClass: string;

package/lib/examples/shield/shieldPolicyDemo.js

@@ -53,7 +53,7 @@ export function classRows(shield, policy = ORGANIZATION_POLICY) {
         };
     });
 }
-/** ACP's tool kinds and the class each is decided as (§4.5). */
+/** ACP's tool kinds and the class each is decided as. */
 export function kindRows(shield) {
     return shield.TOOL_KINDS.map(kind => ({
         kind,

package/lib/examples/utils/assistantGallery.d.ts

@@ -1,5 +1,5 @@
 /**
- * What the floating assistant's gallery shows (LOOP T-21 to T-27): every
+ * What the floating assistant's gallery shows (T-21 to T-27): every
  * state a character acts (T-22), and stepped aside (T-27), with the balloon
  * each one says — the agent's latest saying (T-23), an approval to answer,
  * or that it is paused. Static data only: no agent, no server.

package/lib/examples/utils/clippyJsCharacters.js

@@ -9,8 +9,8 @@
  * clippy.js reader a person's files go through.
  *
  * Nothing of them is in this repository: clippy.js's licence covers its code
- * only, and the characters, their names and their drawings are Microsoft's
- * (§6.9). The page fetches them when asked and keeps them in memory.
+ * only, and the characters, their names and their drawings are Microsoft's.
+ * The page fetches them when asked and keeps them in memory.
  *
  * The package ships each character as ES modules: `agent.mjs` exports the
  * character's data, `map.mjs` its sprite sheet as a data URL. Both are read as

package/lib/examples/utils/testSpriteCharacter.js

@@ -3,11 +3,11 @@
  * Distributed under the terms of the Modified BSD License.
  */
 /**
- * A small character of our own in the clippy.js shape (LOOP T-26), for the
+ * A small character of our own in the clippy.js shape (T-26), for the
  * floating assistant's gallery: an `agent.js` and a `map.png` sprite sheet
  * of ten 48×48 cells, read through the same reader a person's files go
  * through (`readClippyCharacter`). It is a test sprite drawn for Datalayer —
- * no file of Microsoft's is in the repository (§6.9).
+ * no file of Microsoft's is in the repository.
  *
  * Its animations carry the names the Office characters use, so the reader's
  * `stateAnimations` gives every state of the assistant one of its own:

package/lib/hooks/ownRoutes.d.ts

@@ -1,6 +1,6 @@
 /**
  * The runtime routes a page calls besides an application's own, and when it
- * does not (PAP_DATALAYER's release gates, decided 14 October 2026).
+ * does not (the release gates, decided 14 October 2026).
  *
  * A runtime that serves a deployment — kept always on, or launched by its
  * hosted page — and the visitors' runtime answer only the application's own

package/lib/hooks/useAgentRuntimes.d.ts

@@ -50,7 +50,7 @@ export interface UseAgentOptions {
      */
     runtimeConnection?: AgentRuntimeConnectionOptions;
     /**
-     * The application the runtime is launched for (STUDIO R-19): its Appspec,
+     * The application the runtime is launched for (R-19): its Appspec,
      * and the saved application and deployment it runs for. Sent with the
      * launch, as `RuntimesClient.create` sends it in Python, so the runtime is
      * given the secrets its connections declare before its agent is made.

package/lib/hooks/useChat.js

@@ -66,7 +66,7 @@ export function useChat() {
     const getTools = useChatStore(state => state.getTools);
     /**
      * Send a user message and get the AI's response. The conversation is
-     * `reduceConversation`'s (MOBILE M-030), as in ChatBase and on the phone:
+     * `reduceConversation`'s (M-030), as in ChatBase and on the phone:
      * every adapter event read by `conversationEventsOf`, an inference
      * provider's deltas as AG-UI text events, and the store's messages drawn
      * from it.

package/lib/index.js

@@ -14,5 +14,5 @@ export * from './config';
 export * from './specs';
 // The LOOP workspace and its plugins, for hosts that embed it: the Datalayer
 // application at /loop, and later the JupyterLab panel. Exported through one
-// surface rather than by deep import (§3.5).
+// surface rather than by deep import.
 export * from './apps';

package/lib/loop-example-main.js

@@ -7,7 +7,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
  * Entry point for the workspace example.
  *
  * Owns the providers, as every entry point does — the workspace mounts none of
- * its own (§3.5).
+ * its own.
  *
  * @module apps-example-main
  */

package/lib/models/Environment.d.ts

@@ -6,7 +6,7 @@ import type { CreateRuntimeResponse } from './RuntimeDTO';
 /**
  * The Environment specification, `environments.datalayer.io/v1alpha1`,
  * generated from the JSON Schema `code-sandboxes` exports from its pydantic
- * models (PLAN_ENV.md, D-14). Regenerated by `npm run generate:environments`.
+ * models (D-14). Regenerated by `npm run generate:environments`.
  */
 export * as EnvironmentSchema from './environments.generated';
 /** An Environment document: `apiVersion`, `kind`, `metadata` and `spec`. */
@@ -46,7 +46,7 @@ export type EnvironmentOwnerType = 'user' | 'organization';
  */
 export type EnvironmentVisibility = 'private' | 'organization' | 'public';
 /**
- * Where a version stands (section 4.2), as `VersionState` of
+ * Where a version stands, as `VersionState` of
  * `code_sandboxes.environments.lifecycle` names it.
  */
 export type EnvironmentVersionStatus = 'draft' | 'resolving' | 'resolved' | 'building' | 'validating' | 'ready' | 'partially_ready' | 'failed' | 'deprecated';
@@ -87,7 +87,7 @@ export interface IDatalayerEnvironment {
      *
      * A platform entry names one. A user environment does not: what it runs is
      * an artifact of its promoted version, pinned by digest and resolved by the
-     * platform at launch, and never shown to a client (PLAN_ENV.md, E1-11).
+     * platform at launch, and never shown to a client (E1-11).
      */
     dockerImage?: string;
     /**
@@ -178,7 +178,7 @@ export interface IDatalayerEnvironment {
     label?: string;
 }
 /**
- * A refusal, as every registry route answers one (section 10): a code, a
+ * A refusal, as every registry route answers one: a code, a
  * message and the correlation id; the field at fault, the detail, and for a
  * code of the taxonomy whether a retry can succeed and what the user does.
  */
@@ -240,7 +240,7 @@ export interface IEnvironmentVersionRecord {
     /**
      * Every variant's Appendix B check 5 (its installed package versions), as
      * `{ variant: { package: version } }`, once a variant's smoke test has
-     * reported it (PLAN_ENV E2-08). Absent from a Runtimes before E1-29 and
+     * reported it (E2-08). Absent from a Runtimes before E1-29 and
      * `{}` until the first variant reports.
      */
     packageReport?: Record<string, Record<string, string>>;
@@ -308,7 +308,7 @@ export interface IEnvironmentPromotionConflict {
     /** What the refused acknowledgement named. */
     acknowledgedUnavailableVariants?: string[];
 }
-/** The artifact a runtime was started from, as its answer names it (section 7.6, E1-11). */
+/** The artifact a runtime was started from, as its answer names it (E1-11). */
 export interface ILaunchedEnvironmentArtifact {
     uid: string;
     variant: string;
@@ -370,7 +370,7 @@ export interface IEnvironmentBuildStep {
     status: 'running' | 'succeeded' | 'failed' | 'skipped';
     startedAt?: string;
     finishedAt?: string;
-    /** For a failure: its section 10 code. */
+    /** For a failure: its error code. */
     code?: string;
     message?: string;
     /**
@@ -396,7 +396,7 @@ export interface IEnvironmentBuildRecord {
     attempt: number;
     /**
      * What this build is for: `build`, or `resolve` — a build that stops once
-     * the version has its lock (PLAN_ENVS.md E1-26). Absent from a Runtimes
+     * the version has its lock (E1-26). Absent from a Runtimes
      * before that, and from every build recorded before the term existed, each
      * of which is a build.
      */
@@ -408,14 +408,14 @@ export interface IEnvironmentBuildRecord {
     errorCode: string;
     errorDetail: string;
     /**
-     * The smoke test's per-check conformance report (PLAN_ENV E1-29). Absent
+     * The smoke test's per-check conformance report (E1-29). Absent
      * from a Runtimes before E1-29 and `{}` until the build's smoke test ran; a
      * report with `passed: false` names the checks that failed and why.
      */
     conformanceReport?: IEnvironmentConformanceReport | Record<string, never>;
     /**
      * Whether the retry route takes this build: cancelled, or failed under a
-     * code another attempt can pass (section 10). Said by Runtimes with the
+     * code another attempt can pass. Said by Runtimes with the
      * build, so a page offers Retry only where it would be taken (E2-19).
      * Absent from a Runtimes before 1.0.36.
      */
@@ -703,7 +703,7 @@ export interface IEnvironmentBuildLogPage {
     complete: boolean;
 }
 export default IEnvironment;
-/** Section 13's preview limits, per owner. */
+/** The preview limits, per owner. */
 export interface IEnvironmentQuotaLimits {
     concurrentBuilds: number;
     buildMinutesPerDay: number;

package/lib/models/Environment.js

@@ -5,7 +5,7 @@
 /**
  * The Environment specification, `environments.datalayer.io/v1alpha1`,
  * generated from the JSON Schema `code-sandboxes` exports from its pydantic
- * models (PLAN_ENV.md, D-14). Regenerated by `npm run generate:environments`.
+ * models (D-14). Regenerated by `npm run generate:environments`.
  */
 export * as EnvironmentSchema from './environments.generated';
 /** The build statuses nothing more happens to. Any other status is still to run or running. */

package/lib/models/RuntimeDTO.d.ts

@@ -47,7 +47,7 @@ export interface CreateRuntimeRequest {
     environment: {
         /**
          * A platform environment by its name, or a user environment as
-         * `<account-handle>/<name>` or by its uid (PLAN_ENV.md, D-2).
+         * `<account-handle>/<name>` or by its uid (D-2).
          */
         name: string;
         /**

package/lib/portable/activity.d.ts

@@ -3,7 +3,7 @@ export type RecordKind = 'session'
  | 'run' | 'tool_call' | 'decision' | 'check' | 'approval' | 'output' | 'feedback'
 /** A turn of a conversation: what was asked, what it answered (V-16). */
  | 'turn'
-/** What it did, step by step (P-16); a harness's session, turn and plan events (SHIELD §6.4). */
+/** What it did, step by step (P-16); a harness's session, turn and plan events. */
  | 'step'
 /** What one of its channels was sent, or why not: `{channel, event, delivery, detail}` (R-37). */
  | 'notification';
@@ -68,7 +68,7 @@ export declare const ACTIVITY_WORDS: {
     readonly wakes: "It also starts on its own when something happens:";
     readonly nothing: "Nothing yet.";
 };
-/** What happens that starts it on its own, in words (LOOP W-03): its event triggers. */
+/** What happens that starts it on its own, in words (W-03): its event triggers. */
 export declare const wakesOn: (triggers: ReadonlyArray<{
     type: string;
     event?: string;

package/lib/portable/activity.js

@@ -3,10 +3,10 @@
  * Distributed under the terms of the Modified BSD License.
  */
 /**
- * What an application is doing (LOOP R-15), as ai-agents answers
+ * What an application is doing (R-15), as ai-agents answers
  * `/api/ai-agents/v1/apps/activity`, and its record's entries
  * (`/apps/sessions`, `/apps/records`): read and said the same by the Studio
- * and Datalayer Mobile (MOBILE M-015b). Pure: each client fetches with its own
+ * and Datalayer Mobile (M-015b). Pure: each client fetches with its own
  * authentication and hands the body here.
  *
  * @module portable/activity
@@ -120,7 +120,7 @@ export const ACTIVITY_WORDS = {
     wakes: 'It also starts on its own when something happens:',
     nothing: 'Nothing yet.',
 };
-/** What happens that starts it on its own, in words (LOOP W-03): its event triggers. */
+/** What happens that starts it on its own, in words (W-03): its event triggers. */
 export const wakesOn = (triggers) => (triggers ?? [])
     .filter(trigger => trigger.type === 'event' && (trigger.description || trigger.event))
     .map(trigger => trigger.description ||

package/lib/portable/adapterEvents.d.ts

@@ -1,6 +1,6 @@
 /**
  * What every protocol adapter says, as the conversation reducer reads it
- * (MOBILE M-030): the web chat's message state is `reduceConversation`'s,
+ * (M-030): the web chat's message state is `reduceConversation`'s,
  * whatever protocol its agent speaks.
  *
  * ## What the adapters say (the inventory)

package/lib/portable/agUiRefusal.d.ts

@@ -1,5 +1,5 @@
 /**
- * Why an AG-UI run was not answered, in the page's own words (LOOP F-15).
+ * Why an AG-UI run was not answered, in the page's own words (F-15).
  *
  * What a person met before was `AG-UI request failed: 404` — the status and
  * nothing else. A 404 at an agent's AG-UI address has one meaning: the agent

package/lib/portable/agUiRefusal.js

@@ -3,7 +3,7 @@
  * Distributed under the terms of the Modified BSD License.
  */
 /**
- * Why an AG-UI run was not answered, in the page's own words (LOOP F-15).
+ * Why an AG-UI run was not answered, in the page's own words (F-15).
  *
  * What a person met before was `AG-UI request failed: 404` — the status and
  * nothing else. A 404 at an agent's AG-UI address has one meaning: the agent

package/lib/portable/agui.d.ts

@@ -18,13 +18,13 @@ export type AgUiEvent = {
 export declare const RUN_CUT_SHORT = "The run stopped before it finished, without an answer or an error: send it again.";
 /**
  * The name of `reactor.ui` (Reactor's `AGUI_NAME`): its ops come over the
- * conversation's ui socket, never a run stream (REACTOR_UI RU-W). Held here
+ * conversation's ui socket, never a run stream (RU-W). Held here
  * so that a reader of a run needs no Reactor module; a test holds it to
  * Reactor's.
  */
 export declare const REACTOR_UI_NAME = "reactor.ui";
 /** What the page says when a `reactor.ui` op comes on a run stream. */
-export declare const UI_ON_RUN = "A reactor.ui op came on the run stream: it comes over the ui socket (REACTOR_UI RU-W).";
+export declare const UI_ON_RUN = "A reactor.ui op came on the run stream: it comes over the ui socket (RU-W).";
 /** What is said when the `fetch` given cannot read a response as it streams. */
 export declare const NOT_STREAMING = "This fetch does not stream a response: give one whose response body has getReader (expo/fetch on a phone).";
 /** Whether an event ends a run: the run said how it ended. */

package/lib/portable/agui.js

@@ -6,13 +6,13 @@
 export const RUN_CUT_SHORT = 'The run stopped before it finished, without an answer or an error: send it again.';
 /**
  * The name of `reactor.ui` (Reactor's `AGUI_NAME`): its ops come over the
- * conversation's ui socket, never a run stream (REACTOR_UI RU-W). Held here
+ * conversation's ui socket, never a run stream (RU-W). Held here
  * so that a reader of a run needs no Reactor module; a test holds it to
  * Reactor's.
  */
 export const REACTOR_UI_NAME = 'reactor.ui';
 /** What the page says when a `reactor.ui` op comes on a run stream. */
-export const UI_ON_RUN = 'A reactor.ui op came on the run stream: it comes over the ui socket (REACTOR_UI RU-W).';
+export const UI_ON_RUN = 'A reactor.ui op came on the run stream: it comes over the ui socket (RU-W).';
 /** What is said when the `fetch` given cannot read a response as it streams. */
 export const NOT_STREAMING = 'This fetch does not stream a response: give one whose response body has getReader (expo/fetch on a phone).';
 /** Whether an event ends a run: the run said how it ended. */

package/lib/portable/approvalCard.d.ts

@@ -1,5 +1,5 @@
 /**
- * An approval as every card says it (MOBILE M-016): the shared controller
+ * An approval as every card says it (M-016): the shared controller
  * and prop contract under the web's *Waiting for you* and Datalayer Mobile's
  * Inbox and detail. A message to send is shown whole — its recipients,
  * subject and body — and anything else is every argument the tool gave,