@datalayer/agent-runtimes 1.5.52 → 1.5.53

package/lib/types/agentspecs.d.ts

@@ -75,7 +75,7 @@ export interface AgentCapability {
     tags?: string[];
 }
 /**
- * A visual component a UI plugin renders (LOOP C-13), named as a surface names
+ * A visual component a UI plugin renders (C-13), named as a surface names
  * it. A standard one's properties are its protocol's own; Datalayer's own
  * carry theirs as a JSON Schema, from which its properties form is drawn (C-14).
  */
@@ -106,7 +106,7 @@ export interface ComponentSpec {
     example?: Record<string, unknown>;
 }
 /**
- * A UI plugin (`agentspecs/ui`, AGENTIC_UI R8): one Reactor plugin of this
+ * A UI plugin (`agentspecs/ui`, R8): one Reactor plugin of this
  * package a Maker composes an interface with, read from its registration, and
  * the UI renderers it may be exposed through. An agent's or an application's
  * `ui` names plugins, each with its renderer.
@@ -146,11 +146,11 @@ export interface UISpec {
     renderers: string[];
     /** The catalog its components are written in. */
     catalog: string;
-    /** The visual components it renders (LOOP C-13). */
+    /** The visual components it renders (C-13). */
     components: ComponentSpec[];
 }
 /**
- * A UI renderer (`agentspecs/ui-renderers`, AGENTIC_UI R8): how a UI plugin's
+ * A UI renderer (`agentspecs/ui-renderers`, R8): how a UI plugin's
  * interface reaches a host that is not Datalayer's own page.
  */
 export interface UiRendererSpec {
@@ -171,10 +171,10 @@ export interface UiChoice {
     /** The UI renderer of `agentspecs/ui-renderers` it is exposed through, by id. */
     renderer?: string;
 }
-/** The layer of an agent's visit a protocol answers (AGENT_PROTOCOLS §1). */
+/** The layer of an agent's visit a protocol answers. */
 export type ProtocolLayer = 'transport' | 'consent' | 'identity' | 'commerce' | 'ui';
 /**
- * An agent protocol Datalayer targets (`agentspecs/protocols`, AGENT_PROTOCOLS
+ * An agent protocol Datalayer targets (`agentspecs/protocols`,
  * PS-01). An agent spec's or an application's `protocols` names the ones it speaks.
  */
 export interface ProtocolSpec {
@@ -204,7 +204,7 @@ export interface ProtocolSpec {
     /** The Appspec block it configures, if any: refused unless `protocols` lists it. */
     appspecBlock?: 'pap' | 'pact' | 'a2a' | 'signed_fetch';
 }
-/** How a harness is launched and driven over ACP (SHIELD.md §3.1). */
+/** How a harness is launched and driven over ACP. */
 export interface HarnessAcpSpec {
     /** The executable, as the runtime image has it. */
     command: string;
@@ -222,13 +222,13 @@ export interface HarnessAcpSpec {
 }
 /**
  * An agent program driven over the Agent Client Protocol
- * (`agentspecs/harnesses`, SHIELD.md SH-01). An agent spec's `harness:` names
+ * (`agentspecs/harnesses`, SH-01). An agent spec's `harness:` names
  * one beside `pydantic-ai` and `vercel-ai`; the Datalayer runtime serves it
- * through its ACP adapter, `ACPAgent` (SHIELD SH-10), never the browser.
+ * through its ACP adapter, `ACPAgent` (SH-10), never the browser.
  */
 /**
- * A Shield policy document the platform ships or shows (`agentspecs/policies`,
- * SHIELD.md SH-50): the catalogue's fields around a document of
+ * A Shield policy document the platform ships or shows (`agentspecs/policies`, SH-50):
+ * the catalogue's fields around a document of
  * `@datalayer/agent-shield`'s `Policy`, whose schema agentspecs carries verbatim.
  */
 export interface PolicySpec {
@@ -267,7 +267,7 @@ export interface PolicySpec {
             admit?: string[];
             credentials?: 'account' | 'platform' | 'either';
         };
-        /** The classes that need an authorizer's allow beside the Rules (SHIELD §6.11). */
+        /** The classes that need an authorizer's allow beside the Rules. */
         authorize?: Array<'read' | 'write' | 'send' | 'buy' | 'delete' | 'execute'>;
         /** The standalone Shield's decision point: exactly one of these. */
         authorizer?: {
@@ -332,8 +332,8 @@ export interface StandardControl {
     coverage_note?: string;
 }
 /**
- * A standard a conformance report answers (`agentspecs/standards`, SHIELD.md
- * SH-60, §6.9): its version, domains and controls, carried whole.
+ * A standard a conformance report answers (`agentspecs/standards`, SH-60):
+ * its version, domains and controls, carried whole.
  */
 export interface StandardSpec {
     id: string;
@@ -347,7 +347,7 @@ export interface StandardSpec {
     url: string;
     releasedOn: string;
     nextReleaseOn: string | null;
-    /** The day the spec was read from the published pages (decision 16). */
+    /** The day the spec was read from the published pages. */
     readOn: string;
     certificateValidMonths: number;
     mapsTo: string | null;
@@ -361,7 +361,7 @@ export interface StandardSpec {
     controls: StandardControl[];
 }
 /**
- * A harness of the register's *listed* tier (SHIELD SH-57): known to speak ACP,
+ * A harness of the register's *listed* tier (SH-57): known to speak ACP,
  * its documented command, licence, terms and credential read and cited; not
  * drilled, so offered by nothing — naming one is refused *listed, not drilled yet*.
  */
@@ -398,13 +398,13 @@ export interface HarnessSpec {
         secrets: string[];
         binaries: string[];
     };
-    /** The terms it is served under, as the register says them (§3.3). */
+    /** The terms it is served under, as the register says them. */
     terms: {
         servedToThirdParties: 'api_key_only' | 'permitted' | 'refused' | 'organizations_own';
         licence: string;
         tierRestrictions?: string;
     };
-    /** Where the Shield writes an application's skills for it (§4.10). */
+    /** Where the Shield writes an application's skills for it. */
     skills: {
         format: 'skill-md' | 'none';
         dir: string;
@@ -674,7 +674,7 @@ export interface ServerActionsSpec {
     tools: Record<string, ActionClass[]>;
     /** What an argument makes a tool do besides, by tool. */
     conditions: Record<string, ActionConditionSpec[]>;
-    /** The argument carrying what a tool sends, signed with the application's byline (LOOP I-10), by tool. */
+    /** The argument carrying what a tool sends, signed with the application's byline (I-10), by tool. */
     signs?: Record<string, string>;
 }
 /** What kind of application it is: what its user meets. */
@@ -690,12 +690,12 @@ export type AppBehaviour = 'do_it' | 'if_asked' | 'ask_first' | 'leave_to_me';
 export type AppLayout = 'chat' | 'page' | 'split';
 /** The one colour of an application; everything else is neutral. */
 export type AppAccent = 'green' | 'rose' | 'sky' | 'lime' | 'sun' | 'violet';
-/** A theme of Appearance's, which an application may run in (LOOP T-30). */
+/** A theme of Appearance's, which an application may run in (T-30). */
 export type AppThemeVariant = 'datalayer' | 'spatial' | 'lovely' | 'matrix' | 'earth' | 'sand' | 'ivory' | 'sun' | 'loop';
 /** The colour mode it is worn in: `auto` follows the device. */
 export type AppThemeMode = 'light' | 'dark' | 'auto';
 /**
- * The theme an application runs in by default (LOOP T-30): at its address,
+ * The theme an application runs in by default (T-30): at its address,
  * embedded, in the Studio's Preview and as an example. The person's own
  * when unsaid; the mode, when unsaid, is the person's.
  */
@@ -704,16 +704,16 @@ export interface AppThemeSpec {
     mode?: AppThemeMode;
 }
 /**
- * The character an application's floating assistant shows (LOOP T-24): the id
+ * The character an application's floating assistant shows (T-24): the id
  * an enabled plugin contributes it under to `loop.assistant.character` —
  * Datalayer's are `paperclip`, `wizard`, `cat` and `eyes`. The spec checks
  * its shape (`APP_ASSISTANT_CHARACTER_ID`); whether a plugin gives it is
  * known only where the plugins are.
  */
 export type AppAssistantCharacter = string;
-/** How a floating assistant's balloon shows the conversation (LOOP T-23). */
+/** How a floating assistant's balloon shows the conversation (T-23). */
 export type AppBalloonDisplay = 'history' | 'current';
-/** How an application sits in another product's page (LOOP D-07). */
+/** How an application sits in another product's page (D-07). */
 export type AppEmbedMode = 'inline' | 'bubble' | 'panel' | 'assistant';
 /** Something an application reaches. */
 export interface AppConnectionSpec {
@@ -731,7 +731,7 @@ export type PapInterface = 'agent' | 'openapi' | 'mcp' | 'web';
 export type PapSignIn = 'direct' | 'device' | 'mediated';
 /**
  * A company the application works with as a personal agent
- * (PAP_DATALAYER S-01): named by its domain, nothing else; what discovery
+ * (S-01): named by its domain, nothing else; what discovery
  * verifies is the deployment's, never the spec's.
  */
 export interface AppPapConnectionSpec {
@@ -749,7 +749,7 @@ export interface AppPapConnectionSpec {
     signIn: PapSignIn[];
     extensions: string[];
 }
-/** The application as a company personal agents work with (PAP_DATALAYER U-04). */
+/** The application as a company personal agents work with (U-04). */
 export interface AppPapCompanySpec {
     /** Whether it publishes itself as a company at Ship. */
     enabled: boolean;
@@ -763,13 +763,13 @@ export interface AppPapCompanySpec {
     /** The personal agents it accepts when `registered` only, by `client_id` URL. */
     registeredAgents: string[];
     /**
-     * What it does for the person once they confirm (PAP_DATALAYER B-04, the
+     * What it does for the person once they confirm (B-04, the
      * `operations` extension): each action and each tool once.
      */
     operations: AppPapOperationSpec[];
 }
 /**
- * One bound of a standing permission (PAP_DATALAYER R-07): a term of the other
+ * One bound of a standing permission (R-07): a term of the other
  * company's operations, by its dotted path, bounded by a term of this one —
  * its maximum, or the one value allowed (one of the two).
  */
@@ -779,7 +779,7 @@ export interface AppPapStandingLimitSpec {
     allowed?: string;
 }
 /**
- * What an operation gives instead of calling a tool (PAP_DATALAYER R-07, the
+ * What an operation gives instead of calling a tool (R-07, the
  * Ledgerly pattern): once the person confirms it, the application may confirm,
  * at one of its own company connections and in their account there, what stays
  * within these bounds — recorded as the approval in advance they would give in
@@ -799,7 +799,7 @@ export interface AppPapStandingSpec {
 }
 /**
  * Something a personal agent may ask the application to do for the person,
- * done only once they confirm its exact terms (PAP_DATALAYER B-04): the call
+ * done only once they confirm its exact terms (B-04): the call
  * of `tool` is proposed instead of made, its arguments the terms — or, for one
  * that `allows`, a standing permission given (R-07).
  */
@@ -817,7 +817,7 @@ export interface AppPapOperationSpec {
 }
 /**
  * A Personal Agent Protocol profile Datalayer speaks: a draft the PAP SDK
- * implements (`draft-01` is its `PROTOCOL_PROFILE` 0.1; PAP_DATALAYER S-03).
+ * implements (`draft-01` is its `PROTOCOL_PROFILE` 0.1; S-03).
  */
 export type PapProfile = 'draft-01';
 /** Personal Agent Protocol: the companies it works with, and whether it is one. */
@@ -829,7 +829,7 @@ export interface AppPapSpec {
 }
 /**
  * A business the application asks for each person over PACT 1.0
- * (AGENT_PROTOCOLS PI-01): its domain, and the audience its Provider
+ * (PI-01): its domain, and the audience its Provider
  * assigned. Always in each person's own name; never a credential.
  */
 export interface AppPactConnectionSpec {
@@ -852,7 +852,7 @@ export interface AppPactRegisteredAgentSpec {
     jwksUri: string;
 }
 /**
- * The application as a PACT business (AGENT_PROTOCOLS PR-13, PI-32): its card
+ * The application as a PACT business (PR-13, PI-32): its card
  * names Datalayer as the Provider and its owner as the Brand; it accepts the
  * personal agents its Maker registered, and a person delegates the scopes it
  * offers through their Datalayer sign-in.
@@ -872,7 +872,7 @@ export interface AppPactSpec {
     /** As a business (PR-13): absent or not `enabled`, it is none. Read, it is always said. */
     business?: AppPactBusinessSpec;
 }
-/** The most one purchase may cost at a merchant (AGENT_PROTOCOLS PI-22). */
+/** The most one purchase may cost at a merchant (PI-22). */
 export interface AppSpendLimitSpec {
     /** As written: `50`, `12.50`. */
     amount: string;
@@ -881,7 +881,7 @@ export interface AppSpendLimitSpec {
 }
 /**
  * A merchant the application shops at for each person, over UCP or ACP
- * (AGENT_PROTOCOLS PI-01). Test merchants only, every purchase asked of the
+ * (PI-01). Test merchants only, every purchase asked of the
  * person (decided 2026-10-13). Never a credential.
  */
 export interface AppCommerceMerchantSpec {
@@ -901,7 +901,7 @@ export interface AppCommerceSpec {
 }
 /**
  * A website the application reads pages of, each request signed with its
- * own Web Bot Auth key (AGENT_PROTOCOLS EX-11, decided 2026-10-13): the
+ * own Web Bot Auth key (EX-11, decided 2026-10-13): the
  * gateway's `signed-fetch` toolset reads there with GET only. Never a
  * credential.
  */
@@ -917,7 +917,7 @@ export interface AppSignedFetchSpec {
 }
 /**
  * One of a pair of examples, a PACT business and the personal agent that
- * asks it (AGENT_PROTOCOLS PR-13; decided 2026-10-13): when a person has
+ * asks it (PR-13; decided 2026-10-13): when a person has
  * copied both, the Studio registers the personal agent's copy with the
  * business's copy and points the personal agent there.
  */
@@ -929,7 +929,7 @@ export interface AppPairSpec {
 }
 /**
  * An A2A extension the application's Agent Card advertises, beside the
- * runtime's own (AGENT_PROTOCOLS PR-02). Its params are public: never a
+ * runtime's own (PR-02). Its params are public: never a
  * credential.
  */
 export interface AppA2AExtensionSpec {
@@ -972,13 +972,13 @@ export interface AppStarterSpec {
     label: string;
     message: string;
     /**
-     * The heading it is offered under (LOOP P-20): the starters of one
+     * The heading it is offered under (P-20): the starters of one
      * category together, those without one first. Absent when unsaid.
      */
     category?: string;
 }
 /**
- * One of several assistants in one application (LOOP P-20): picked before
+ * One of several assistants in one application (P-20): picked before
  * the conversation starts — the first unless another is — and kept to its
  * end. Its instructions are told in every run, its model run in place of the
  * application's (a mode's wins over it), its starters offered in place of
@@ -993,7 +993,7 @@ export interface AppProfileSpec {
     starters: AppStarterSpec[];
 }
 /**
- * What a person reads of an application in another language (LOOP P-26):
+ * What a person reads of an application in another language (P-26):
  * each part keyed by what names it in the spec — a starter by its label, a
  * category by its words, a setting by its field, a command by its name, a
  * mode and a profile by their ids. Every key present; empty is untranslated.
@@ -1025,7 +1025,7 @@ export interface AppTranslationSpec {
         description: string;
     }>;
 }
-/** A slash command the user picks in the composer (LOOP P-19). */
+/** A slash command the user picks in the composer (P-19). */
 export interface AppCommandSpec {
     /** What follows the slash: lower-case letters, digits and hyphens. */
     name: string;
@@ -1035,7 +1035,7 @@ export interface AppCommandSpec {
     prompt: string;
 }
 /**
- * An action of its code a person presses (REACTOR_UI RU-5): `@app.action`,
+ * An action of its code a person presses (RU-5): `@app.action`,
  * typed — the JSON Schema of its payload, written from the pydantic model its
  * code declares; none when it takes nothing. The runtime offers it with a
  * token and refuses a press of anything else, or with anything else.
@@ -1047,7 +1047,7 @@ export interface AppActionSpec {
     /** The JSON Schema of its payload, an object; none when it takes nothing. */
     payload?: Record<string, unknown>;
 }
-/** One position of a mode switch (LOOP P-19). */
+/** One position of a mode switch (P-19). */
 export interface AppModeOptionSpec {
     id: string;
     label: string;
@@ -1057,7 +1057,7 @@ export interface AppModeOptionSpec {
     /** The model a run in this mode runs on, in place of the application's. */
     model?: string | null;
 }
-/** A mode switch in the composer (LOOP P-19). */
+/** A mode switch in the composer (P-19). */
 export interface AppModeSpec {
     id: string;
     label: string;
@@ -1067,8 +1067,7 @@ export interface AppModeSpec {
     default?: string | null;
 }
 /**
- * What a run in the modes chosen is told, and the model it runs on (LOOP
- * P-19): agentspecs' `ModeEffect`.
+ * What a run in the modes chosen is told, and the model it runs on (P-19): agentspecs' `ModeEffect`.
  */
 export interface AppModeEffect {
     /** The instructions of the options chosen, in the order of the modes. */
@@ -1077,7 +1076,7 @@ export interface AppModeEffect {
     model?: string;
 }
 /**
- * One field of a form (LOOP C-16): its JSON Schema — a `type`, the `title` a
+ * One field of a form (C-16): its JSON Schema — a `type`, the `title` a
  * person reads, its `default`, and what it takes (`enum`, `minimum`,
  * `maximum`…).
  */
@@ -1092,7 +1091,7 @@ export type AppFormField = {
     [keyword: string]: unknown;
 };
 /**
- * The JSON Schema of a form (LOOP C-16): an object of named fields, drawn with
+ * The JSON Schema of a form (C-16): an object of named fields, drawn with
  * `@datalayer/primer-rjsf` and checked by the runtime against the same schema.
  * An application's settings are one (`interface.settings`), as a Form block's
  * schema is.
@@ -1114,10 +1113,10 @@ export interface AppSurfaceSpec {
     composedBy: string;
     composedAt: string;
 }
-/** What a page's output is drawn with of the catalog (LOOP P-05). */
+/** What a page's output is drawn with of the catalog (P-05). */
 export type AppPageOutputComponent = 'Text' | 'Image' | 'Table' | 'Chart';
 /**
- * A component its developer wrote (LOOP P-17), of one application only: the
+ * A component its developer wrote (P-17), of one application only: the
  * catalog grows for it, it does not open. Reviewed as the catalog's own — its
  * properties a JSON Schema, what it shows and sends bindings — and drawn in a
  * sandboxed frame of no origin from the built ES module at `source`.
@@ -1142,7 +1141,7 @@ export interface AppCustomComponentSpec {
     /** A configuration its schema accepts: what the palette previews. */
     example?: Record<string, unknown>;
 }
-/** One thing a widget's page shows for its inputs (LOOP P-05), at `/outputs/<name>`. */
+/** One thing a widget's page shows for its inputs (P-05), at `/outputs/<name>`. */
 export interface AppPageOutputSpec {
     name: string;
     /** What a person reads above it; none when empty. */
@@ -1157,7 +1156,7 @@ export interface AppPageOutputSpec {
     props: Record<string, unknown>;
 }
 /**
- * A widget's page written in its code (LOOP P-05, `@app.page`): its inputs a
+ * A widget's page written in its code (P-05, `@app.page`): its inputs a
  * form, drawn at `/inputs/<name>`; its outputs values, shown at
  * `/outputs/<name>`. As an input changes, the function its code names runs
  * again on all of them, and the outputs change in place.
@@ -1173,7 +1172,7 @@ export interface AppPageSpec {
     live: boolean;
 }
 /**
- * An application's voice (VOICE.md VO-41), off unless said: whether a person
+ * An application's voice (VO-41), off unless said: whether a person
  * may talk to it, whether its answers are heard, with which voice of the
  * catalogue (`specs/voices`), in which language (BCP 47) and where its
  * speech runs.
@@ -1188,7 +1187,7 @@ export interface AppVoiceSpec {
     where: 'auto' | 'device' | 'server';
 }
 /**
- * A kind of file a person may send, and how large (LOOP P-21): a media type
+ * A kind of file a person may send, and how large (P-21): a media type
  * (`application/pdf`), a family (`image/*`, `audio/*`) or an extension
  * (`.csv`), lowercase.
  */
@@ -1198,7 +1197,7 @@ export interface AppUploadKindSpec {
     maxMb: number;
 }
 /**
- * What a person may send in the composer without being asked (LOOP P-21):
+ * What a person may send in the composer without being asked (P-21):
  * the kinds it takes, each with its largest size, and how many at once.
  */
 export interface AppUploadsSpec {
@@ -1223,7 +1222,7 @@ export interface AppInterfaceSpec {
     /** Mode switches in the composer, the option picked going with every run (P-19). */
     modes: AppModeSpec[];
     /**
-     * The actions of its code a person presses, typed (REACTOR_UI RU-5):
+     * The actions of its code a person presses, typed (RU-5):
      * written by its code (`@app.action`); absent from a spec without code.
      */
     actions?: AppActionSpec[];
@@ -1313,7 +1312,7 @@ export interface AppTestCaseSpec {
     turns?: AppTestTurnSpec[];
     expect: string;
     /**
-     * The function of its code that decides the case, by name (LOOP P-06:
+     * The function of its code that decides the case, by name (P-06:
      * `@app.test`); `expect` still says it in words, and decides it without
      * the file. Empty, or absent, for a case in words alone.
      */
@@ -1325,7 +1324,7 @@ export interface AppTestCaseSpec {
     files?: AppTestFileSpec[];
 }
 /**
- * What was verified, and how, each in a sentence a person reads (LOOP E-14):
+ * What was verified, and how, each in a sentence a person reads (E-14):
  * what was tried live, what runs on recorded data, what is not verified yet.
  */
 export interface AppVerifiedSpec {
@@ -1349,14 +1348,14 @@ export interface AppRecordSpec {
     retentionDays: number;
     include: string[];
     /**
-     * Whether its conversations may be used to suggest tests (LOOP V-16): off
+     * Whether its conversations may be used to suggest tests (V-16): off
      * unless said, and only those kept while it is on are sampled.
      */
     suggestTests: boolean;
 }
-/** Where a check of an application's code runs (LOOP P-06). */
+/** Where a check of an application's code runs (P-06). */
 export type AppCheckStage = 'answer' | 'tool_call';
-/** A check written in an application's code (LOOP P-06: `@app.check`). */
+/** A check written in an application's code (P-06: `@app.check`). */
 export interface AppCodeCheckSpec {
     /** The function of its code that checks. */
     name: string;
@@ -1370,11 +1369,11 @@ export interface AppChecksSpec {
     guards: string[];
     gates: string[];
     track: string;
-    /** Checks written in its code (LOOP P-06); absent when it has none. */
+    /** Checks written in its code (P-06); absent when it has none. */
     code?: AppCodeCheckSpec[];
 }
 /**
- * A tool of an application's own, written in its code (LOOP P-06:
+ * A tool of an application's own, written in its code (P-06:
  * `@app.tool`): its agent calls it, and the rules decide each call by what
  * it `does`, or by a rule that names it by its name alone.
  */
@@ -1387,7 +1386,7 @@ export interface AppToolSpec {
     /** What it does, by class of action: `read`, `write`, `send`… */
     does: string[];
 }
-/** A function of the host page the application's agent may call (LOOP D-10). */
+/** A function of the host page the application's agent may call (D-10). */
 export interface AppHostFunctionSpec {
     /** Lower-case words joined by `_`: called as the tool `host_<name>`. */
     name: string;
@@ -1397,8 +1396,7 @@ export interface AppHostFunctionSpec {
     parameters: Record<string, unknown>;
 }
 /**
- * What the host page and an embedded application say to each other (LOOP
- * D-10): the host's values it reads (`user`, `page`, or the host's own),
+ * What the host page and an embedded application say to each other (D-10): the host's values it reads (`user`, `page`, or the host's own),
  * through the tool `host_context`, and the host's functions it may call,
  * each through `host_<name>` — every one of them decided by a rule that
  * names it.
@@ -1407,20 +1405,20 @@ export interface AppHostBridgeSpec {
     context: string[];
     functions: AppHostFunctionSpec[];
     /**
-     * Who its user is (LOOP D-21): `claimed`, what the page says (unless
+     * Who its user is (D-21): `claimed`, what the page says (unless
      * said); `signed`, only a token the host's server signed with the
      * deployment's secret — the unsigned one refused.
      */
     user?: AppHostUser;
 }
-/** What the host page's word on its visitor is worth (LOOP D-21). */
+/** What the host page's word on its visitor is worth (D-21). */
 export type AppHostUser = 'claimed' | 'signed';
 export interface AppDeploymentSpec {
     hosted?: {
         visibility: 'private' | 'invited' | 'organization' | 'link' | 'public';
         slug: string;
         /**
-         * At its address, only its character (LOOP T-21): the conversation
+         * At its address, only its character (T-21): the conversation
          * opens in its balloon, as when it is shipped as `assistant`. Off
          * unless said.
          */
@@ -1429,7 +1427,7 @@ export interface AppDeploymentSpec {
     embedded?: {
         mode: AppEmbedMode;
         origins: string[];
-        /** What the host page passes it and the functions of the host it may call (LOOP D-10). */
+        /** What the host page passes it and the functions of the host it may call (D-10). */
         host?: AppHostBridgeSpec;
     };
 }
@@ -1482,7 +1480,7 @@ export interface AppSampleAlternativeSpec {
     metrics: Record<string, number>;
 }
 /**
- * What it is tried on before it is anybody's (STUDIO E-06, E-11): published
+ * What it is tried on before it is anybody's (E-06, E-11): published
  * with it by Datalayer, read only — what a visitor without an account
  * computes from, or decides on, in the browser.
  */
@@ -1514,7 +1512,7 @@ export interface AppSpec {
     skills: string[];
     /** Backend tools (agentspecs/backend-tools) it adds to its agent's. */
     backendTools: string[];
-    /** Tools of its own, written in its code (LOOP P-06); absent when it has none. */
+    /** Tools of its own, written in its code (P-06); absent when it has none. */
     tools?: AppToolSpec[];
     /** The Frames it works under. */
     context: string[];
@@ -1522,24 +1520,23 @@ export interface AppSpec {
     contents: string[];
     connections: AppConnectionSpec[];
     /**
-     * The agent protocols it speaks, ids of `agentspecs/protocols` (AGENT_PROTOCOLS
-     * PS-02): its `pap`, `pact` and `a2a` blocks are refused unless their protocol
+     * The agent protocols it speaks, ids of `agentspecs/protocols` (PS-02): its `pap`, `pact` and `a2a` blocks are refused unless their protocol
      * is listed, and a planned one only while it is not offered.
      */
     protocols: string[];
-    /** Its UI plugins, each with the renderer it is exposed through, when it is (AGENTIC_UI R8). */
+    /** Its UI plugins, each with the renderer it is exposed through, when it is (R8). */
     ui: UiChoice[];
     /** Personal Agent Protocol; absent, the application has none. */
     pap?: AppPapSpec;
-    /** PACT: the businesses it asks for each person (AGENT_PROTOCOLS PI-01). */
+    /** PACT: the businesses it asks for each person (PI-01). */
     pact?: AppPactSpec;
-    /** UCP and ACP: the merchants it shops at for each person (AGENT_PROTOCOLS PI-01). */
+    /** UCP and ACP: the merchants it shops at for each person (PI-01). */
     commerce?: AppCommerceSpec;
-    /** Signed fetch: the sites it reads pages of, each request signed (AGENT_PROTOCOLS EX-11). */
+    /** Signed fetch: the sites it reads pages of, each request signed (EX-11). */
     signed_fetch?: AppSignedFetchSpec;
     /** One of a pair of examples: a PACT business, or the personal agent that asks it (PR-13). */
     pair?: AppPairSpec;
-    /** A2A: the extensions its Agent Card advertises (AGENT_PROTOCOLS PR-02). */
+    /** A2A: the extensions its Agent Card advertises (PR-02). */
     a2a?: AppA2ASpec;
     rules: AppRuleSpec[];
     permissions: AppPermissionsSpec;
@@ -1646,7 +1643,7 @@ export interface Agentspec {
     /** User-facing objective for the agent */
     goal?: string;
     /**
-     * What work this agent can be delegated (ORCHESTRATOR.md, O2-07).
+     * What work this agent can be delegated (O2-07).
      *
      * `protocol` below says how a client and an agent talk; this says what it
      * is worth handing the agent. Ids come from a closed vocabulary, because
@@ -1662,11 +1659,10 @@ export interface Agentspec {
     /** Communication protocol (e.g., 'ag-ui', 'acp', 'a2a', 'vercel-ai') */
     protocol?: string;
     /**
-     * The agent protocols it speaks, ids of `agentspecs/protocols` (AGENT_PROTOCOLS
-     * PS-02). `protocol` says how a page reaches it; this, what it speaks to the world.
+     * The agent protocols it speaks, ids of `agentspecs/protocols` (PS-02). `protocol` says how a page reaches it; this, what it speaks to the world.
      */
     protocols?: string[];
-    /** Its UI plugins, each with the renderer it is exposed through, when it is (AGENTIC_UI R8). */
+    /** Its UI plugins, each with the renderer it is exposed through, when it is (R8). */
     ui?: UiChoice[];
     /** Trigger configuration (type, cron, event source, prompt) */
     trigger?: AgentTriggerConfig;
@@ -1708,7 +1704,7 @@ export interface Agentspec {
     /** Subagent delegation configuration. */
     subagents?: SubAgentsConfig;
     /**
-     * Its voice, for an agent that is not an application (VOICE.md VO-41):
+     * Its voice, for an agent that is not an application (VO-41):
      * the fields an Appspec says under `interface.voice`; absent when unsaid.
      */
     voice?: AppVoiceSpec;