@datalayer/agent-runtimes 1.5.52 → 1.5.53

package/lib/portable/hosts/index.js

@@ -8,7 +8,7 @@
  * semantic events a turn is reduced to, approval renderers, deliveries, the
  * turn's state, application resolution, the durable queue, quotas, secrets
  * at rest, observability, dead letters, health, the shared schema and the
- * forbidden-graph gate (plans/DISCORD.md §4.2, DC-004, DC-005).
+ * forbidden-graph gate (DC-004, DC-005).
  *
  * Imported as `@datalayer/agent-runtimes/lib/portable/hosts`, and only by a
  * Node service, which bundles it with esbuild. It reaches `src/portable/` and

package/lib/portable/hosts/observability.d.ts

@@ -34,7 +34,7 @@ export declare class Logger {
     warn(event: string, fields?: Record<string, unknown>): void;
     error(event: string, fields?: Record<string, unknown>): void;
     /**
-     * An identity audit event (SLACK S-103): who (pseudonymous), which installation
+     * An identity audit event (S-103): who (pseudonymous), which installation
      * (its hash), what happened, why. Never a code, a token or a principal's
      * name.
      */

package/lib/portable/hosts/observability.js

@@ -4,12 +4,11 @@
  */
 import { createHash } from 'node:crypto';
 /**
- * Logs, audit events and traces without secrets or words (SLACK §9, §12.2;
- * DISCORD §9, §12.2): every routine line is JSON whose fields pass `redact`;
+ * Logs, audit events and traces without secrets or words: every routine line is JSON whose fields pass `redact`;
  * host and Datalayer ids are pseudonymous (`pseudonym`), so a trace can be
  * followed `host event → job → installation hash → session → host message`
  * without naming an installation, a person or what they wrote. Moved from
- * the Slack service (plans/DISCORD.md DC-004).
+ * the Slack service (DC-004).
  *
  * @module portable/hosts/observability
  */
@@ -114,7 +113,7 @@ export class Logger {
         this.#write('error', event, fields);
     }
     /**
-     * An identity audit event (SLACK S-103): who (pseudonymous), which installation
+     * An identity audit event (S-103): who (pseudonymous), which installation
      * (its hash), what happened, why. Never a code, a token or a principal's
      * name.
      */

package/lib/portable/hosts/postgresQueue.d.ts

@@ -4,7 +4,7 @@
  * five attempts, an ingress claim and its job kept in one transaction. Its
  * tables are `<prefix>_jobs`, `<prefix>_event_claims` and
  * `<prefix>_job_replays` (`hostSchemaSql`). Moved from the Slack service
- * (plans/DISCORD.md DC-004).
+ * (DC-004).
  *
  * @module portable/hosts/postgresQueue
  */
@@ -42,7 +42,7 @@ export declare class PostgresWorkQueue<T> implements WorkQueue<T> {
     }>>;
     /**
      * Put a dead job back to work: once, by id, the replay kept with who asked
-     * in the same transaction (`<prefix>_job_replays`, SLACK S-405), refused or not.
+     * in the same transaction (`<prefix>_job_replays`, S-405), refused or not.
      */
     replay(id: string, operator: string): Promise<boolean>;
     /**

package/lib/portable/hosts/postgresQueue.js

@@ -8,7 +8,7 @@
  * five attempts, an ingress claim and its job kept in one transaction. Its
  * tables are `<prefix>_jobs`, `<prefix>_event_claims` and
  * `<prefix>_job_replays` (`hostSchemaSql`). Moved from the Slack service
- * (plans/DISCORD.md DC-004).
+ * (DC-004).
  *
  * @module portable/hosts/postgresQueue
  */
@@ -47,7 +47,7 @@ export class PostgresWorkQueue {
             await this.database.query(`INSERT INTO ${this.#jobs} (payload) VALUES ($1)`, [item]);
             return true;
         }
-        // The idempotency key and its job in one transaction (§7.1, 4).
+        // The idempotency key and its job in one transaction.
         const client = await this.database.connect();
         try {
             await client.query('BEGIN');
@@ -93,7 +93,7 @@ export class PostgresWorkQueue {
     }
     /**
      * Put a dead job back to work: once, by id, the replay kept with who asked
-     * in the same transaction (`<prefix>_job_replays`, SLACK S-405), refused or not.
+     * in the same transaction (`<prefix>_job_replays`, S-405), refused or not.
      */
     async replay(id, operator) {
         if (!/^\d+$/.test(id))

package/lib/portable/hosts/queue.d.ts

@@ -2,7 +2,7 @@
  * A host's durable work queue, its in-memory development stand-in, and the
  * structural Postgres connection every Postgres implementation here takes
  * (`pg.Pool` and `pg.PoolClient` satisfy it: no `pg` import). Moved from the
- * Slack service (plans/DISCORD.md DC-004).
+ * Slack service (DC-004).
  *
  * @module portable/hosts/queue
  */

package/lib/portable/hosts/quotas.d.ts

@@ -1,9 +1,9 @@
 /**
- * Quotas before costly work (SLACK §9, S-404; DISCORD DC-402): questions an
+ * Quotas before costly work (S-404, DC-402): questions an
  * hour per person, installation (a Slack workspace, a Discord server),
  * organization and application, taken atomically before a turn starts at
  * Datalayer. A refusal says which limit and when it resets. Moved from the
- * Slack service (plans/DISCORD.md DC-004).
+ * Slack service (DC-004).
  *
  * @module portable/hosts/quotas
  */

package/lib/portable/hosts/quotas.js

@@ -3,11 +3,11 @@
  * Distributed under the terms of the Modified BSD License.
  */
 /**
- * Quotas before costly work (SLACK §9, S-404; DISCORD DC-402): questions an
+ * Quotas before costly work (S-404, DC-402): questions an
  * hour per person, installation (a Slack workspace, a Discord server),
  * organization and application, taken atomically before a turn starts at
  * Datalayer. A refusal says which limit and when it resets. Moved from the
- * Slack service (plans/DISCORD.md DC-004).
+ * Slack service (DC-004).
  *
  * @module portable/hosts/quotas
  */

package/lib/portable/hosts/rateLimit.d.ts

@@ -2,7 +2,7 @@
  * The clock a host's rate limiter waits on: the system's, or a test's fake.
  * Each host keeps its own limiter (Slack's method spacing, Discord's
  * buckets), since what a 429 says differs by host. Moved from the Slack
- * service (plans/DISCORD.md DC-004).
+ * service (DC-004).
  *
  * @module portable/hosts/rateLimit
  */

package/lib/portable/hosts/resolution.d.ts

@@ -1,11 +1,11 @@
 /**
- * Which application a host's turn runs (SLACK §8, S-202; DISCORD §8): the
+ * Which application a host's turn runs (S-202): the
  * thread's own, else an explicit choice, else the one chosen for the
  * thread's next session, else the channel's, else the installation's
  * default; then that application allowed here and in this kind of
  * conversation. Datalayer's exchange checks the person may open it at every
  * turn: nothing here authorizes alone. The host says each refusal in its own
- * words. Moved from the Slack service (plans/DISCORD.md DC-004).
+ * words. Moved from the Slack service (DC-004).
  *
  * @module portable/hosts/resolution
  */

package/lib/portable/hosts/schema.d.ts

@@ -6,7 +6,7 @@
  * Their final shapes, as idempotent statements: a service applies them
  * before its own migrations, every time. TypeScript strings, since the npm
  * tarball ships no `.sql`. Moved from the Slack service's migrations 001,
- * 004 and 007 (plans/DISCORD.md DC-004).
+ * 004 and 007 (DC-004).
  *
  * @module portable/hosts/schema
  */

package/lib/portable/hosts/schema.js

@@ -10,7 +10,7 @@
  * Their final shapes, as idempotent statements: a service applies them
  * before its own migrations, every time. TypeScript strings, since the npm
  * tarball ships no `.sql`. Moved from the Slack service's migrations 001,
- * 004 and 007 (plans/DISCORD.md DC-004).
+ * 004 and 007 (DC-004).
  *
  * @module portable/hosts/schema
  */

package/lib/portable/hosts/secretCipher.d.ts

@@ -1,8 +1,8 @@
 /**
- * Secrets at rest (SLACK §9, DISCORD §9): AES-256-GCM, each value bound to
+ * Secrets at rest: AES-256-GCM, each value bound to
  * what it belongs to (its associated data, an installation's key), with the
  * key's version kept beside it. Moved from the Slack service
- * (plans/DISCORD.md DC-004).
+ * (DC-004).
  *
  * @module portable/hosts/secretCipher
  */

package/lib/portable/hosts/sessionUid.js

@@ -4,8 +4,7 @@
  */
 /**
  * One host thread is one Datalayer session: its uid, derived from where the
- * thread is, so that a retry names it again (SLACK §2 rule 2, DISCORD §2
- * rule 2). Moved from the Slack service (plans/DISCORD.md DC-004).
+ * thread is, so that a retry names it again. Moved from the Slack service (DC-004).
  *
  * @module portable/hosts/sessionUid
  */

package/lib/portable/hosts/turnState.d.ts

@@ -3,7 +3,7 @@
  * answer so far, the tools, the status line, the approvals waited on, the
  * question it ends on, and how it ended. Each host renders it in its own
  * blocks (Slack's Block Kit, Discord's components); nothing here is a
- * host's. Moved from the Slack service (plans/DISCORD.md DC-004).
+ * host's. Moved from the Slack service (DC-004).
  *
  * @module portable/hosts/turnState
  */

package/lib/portable/index.js

@@ -11,11 +11,11 @@
  * @module portable
  */
 export { messageOfApproval, normalizeApproval, whyAsked, } from './approvals';
-// An approval as every card says it (MOBILE M-016).
+// An approval as every card says it (M-016).
 export { actionOf, APPROVAL_CARD_WORDS, approvalCardOf, argumentsShown, } from './approvalCard';
 // A run's stream, read as every client reads it.
 export { AgUiFrames, endsRun, eventsOfStream, NOT_STREAMING, REACTOR_UI_NAME, readRunStream, RUN_CUT_SHORT, toolResultOf, UI_ON_RUN, } from './agui';
-// A run's stream reduced to what a chat host shows (DISCORD DC-005, SLACK S-205).
+// A run's stream reduced to what a chat host shows (DC-005, S-205).
 export { answerParts, isTerminal, SEMANTIC_EVENTS_VERSION, SEMANTIC_KINDS, } from './semantic';
 export { askQuestionOf, semanticOf, turnOf, } from './semanticOfAgUi';
 export { AG_UI_NOT_ALLOWED, AG_UI_NOT_ON_RUNTIME, agUiRefusal, refusalBody, refusalDetail, } from './agUiRefusal';
@@ -26,30 +26,30 @@ export { messagesOfThread, openThread, snapshotOfStream, THREAD_WORDS, } from '.
 export { BROWSER_LIMITS, CUT_MARK, DEVICE_LIMITS, DIAGNOSTIC_LIMIT, emptyConversation, formFieldsOf, ITEM_LIMIT, MESSAGE_TEXT_LIMIT, questionOf, questionWords, reduceConversation, TOOL_TEXT_LIMIT, withError, withoutItems, withPrompt, withTurnEnded, } from './conversation';
 // What every protocol adapter says, as the conversation reads it (M-030).
 export { conversationEventsOf, sanitizeAssistantContent, snapshotOfMessages, } from './adapterEvents';
-// What an application is doing, in the words beside its face (LOOP T-08).
+// What an application is doing, in the words beside its face (T-08).
 export { PRESENCE_LINES, presenceOfConversation, presenceState, presenceToolOf, } from './presence';
 // One contract for every renderer of a conversation's components.
 export { ANSWER_BELOW, ANSWER_COMPLETE, composerOf, droppedWords, ENDED_WORDS, messageLabel, OPENING_WORDS, presenceLine, showsQuestion, stepLine, TOOL_STATUS_WORDS, toolLabel, } from './views';
 export { activityFixture, conversationFixture } from './fixtures';
-// The protocol displays a run's tool results carry (MOBILE M-037).
+// The protocol displays a run's tool results carry (M-037).
 export { DISPLAY_META_KEY, displayLine, displayOfToolResult, PAP_CONFIRM_TYPE, PAP_HANDOFF_TOOL, PAP_OUTCOME_TYPE, PAP_REPLIES_TYPE, PAP_SIGN_IN_TYPE, protocolDisplayOf, replyAuthor, 
-// A coding agent's diff and terminal (SHIELD §4.3, SH-16).
+// A coding agent's diff and terminal (SH-16).
 DIFF_LINES_LIMIT, SHIELD_DIFF_TYPE, SHIELD_TERMINAL_TYPE, languageOf, unifiedDiffLines, unifiedDiffText, } from './displays';
 export { shieldDisplayFixtures } from './fixtures';
 export { isPapSignInTool, PAP_SIGN_IN_WORDS, readPapSignIn, safeSignInUrl, } from './signIn';
-// A Direct Conversation the person types in themselves (PAP_DATALAYER P-08, MOBILE M-038).
+// A Direct Conversation the person types in themselves (P-08, M-038).
 export { DIRECT_MAX, DIRECT_WORDS, directAnswerOf, directAuthor, directClient, openDirect, withDirectAnswer, } from './direct';
-// How a sign-in under way stands, asked by the person's own client (MOBILE M-039).
+// How a sign-in under way stands, asked by the person's own client (M-039).
 export { SIGN_IN_POLL_MS, SIGN_IN_STATUS_PATH, signInStandsOf, signInStatusClient, } from './signInStatus';
-// What a company asks the person to type in a mediated sign-in, sent with its one-use ticket (MOBILE M-039).
+// What a company asks the person to type in a mediated sign-in, sent with its one-use ticket (M-039).
 export { emptyFields, fieldProblems, MAX_VALUE_LENGTH, PROTECTED_INPUT_WORDS, protectedInputClient, protectedRequestOf, ProtectedRequestGone, sentWords, submitBody, submitWords, ticketComplete, ticketOfPage, } from './protectedInput';
-// How a streamed turn went, measured without its words (MOBILE M-036).
+// How a streamed turn went, measured without its words (M-036).
 export { failureOf, otlpMetricsOf, RunMeter, } from './runMeasures';
-// What an application is doing, and its record's entries (LOOP R-15, MOBILE M-015b).
+// What an application is doing, and its record's entries (R-15, M-015b).
 export { ACTIVITY_WORDS, activityOf, entryOf, entrySaid, mergeActivityPages, runEndOf, scheduledSays, sessionSentence, wakesOn, } from './activity';
-// A deployment's pause, resume and reset, and its recorded events (LOOP R-17, MOBILE M-041b).
+// A deployment's pause, resume and reset, and its recorded events (R-17, M-041b).
 export { deploymentEventLine, deploymentEventOf, notDeletedOf, resetBody, resetCountsOf, resetLines, stateChangeBody, stoppedWorkLine, stoppedWorkOf, } from './lifecycle';
-// A person's agent runtimes, and an agent's summary (MOBILE M-014b).
+// A person's agent runtimes, and an agent's summary (M-014b).
 export { agentRuntimesOf, agentSummaryOfRuntime, CREATING_STATUSES, isAgentRuntime, isCreatingAgent, runtimeOf, } from './runtimes';
 // The runtime's routes a native client drives.
 export { agentRunClient, agentRuntimesUrlOf, appSessionsClient, RuntimeRefusal, } from './sessions';

package/lib/portable/lifecycle.d.ts

@@ -1,8 +1,8 @@
 /**
- * A deployment's lifecycle as its owner drives it (LOOP R-17, D-04): pause
+ * A deployment's lifecycle as its owner drives it (R-17, D-04): pause
  * and resume one exact version, reset what it holds, and the events recorded
  * with who did each. The requests' bodies, the answers read and the words
- * said — the same in the Studio and Datalayer Mobile (MOBILE M-041b). Pure:
+ * said — the same in the Studio and Datalayer Mobile (M-041b). Pure:
  * each client sends them with its own authentication.
  *
  * @module portable/lifecycle
@@ -36,7 +36,7 @@ export type ResetCounts = {
     schedules: number;
     /**
      * Why its memories stay: they are its application's, not the
-     * deployment's (LOOP R-18) — forgotten under *What it remembers*.
+     * deployment's (R-18) — forgotten under *What it remembers*.
      */
     memoriesNote: string;
 };

package/lib/portable/presence.d.ts

@@ -1,14 +1,14 @@
 /**
- * What an application is doing, in plain words (LOOP T-08): the one line of
+ * What an application is doing, in plain words (T-08): the one line of
  * status beside its face — the same states and words in the web chat
- * (`chat/presence`) and on Datalayer Mobile (MOBILE M-030).
+ * (`chat/presence`) and on Datalayer Mobile (M-030).
  *
  * @module portable/presence
  */
 import type { ConversationState } from './conversation';
 /**
  * The states a person is told about. Paused is its deployment's: its owner
- * paused it (LOOP R-17), and it answers nobody until it is resumed.
+ * paused it (R-17), and it answers nobody until it is resumed.
  */
 export type PresenceState = 'idle' | 'thinking' | 'working' | 'waiting' | 'paused';
 /** The line each state is said by. */

package/lib/portable/protectedInput.d.ts

@@ -1,5 +1,5 @@
 /**
- * Mediated sign-in (PAP_DATALAYER P-03, MOBILE M-039): a personal agent signs
+ * Mediated sign-in (P-03, M-039): a personal agent signs
  * the person in at a company that asks for what only the person knows — a
  * name and a password, or a code the company sent them. The person types it
  * on a page of their own Datalayer client, signed in to Datalayer; it goes

package/lib/portable/records.d.ts

@@ -8,7 +8,7 @@
  */
 /**
  * How a run ended, in the `output` entry every run ends with, kept whatever
- * the application's `record.include` says (PAP_DATALAYER R-01): its words
+ * the application's `record.include` says (R-01): its words
  * only when it keeps `outputs`.
  */
 export declare const RUN_END_WORDS: Record<string, string>;
@@ -20,7 +20,7 @@ export declare const RUN_END_WORDS: Record<string, string>;
 export declare const ASKED_FOR_TAG = "asked-for";
 /**
  * What a person asked, as they are shown it: without what the runtime told
- * the application before their words (PAP_DATALAYER, decided 2026-10-14).
+ * the application before their words (decided 2026-10-14).
  * The record keeps it for the application's builder; the person never wrote
  * it, so *Your conversations* and a thread opened again leave it out.
  */

package/lib/portable/records.js

@@ -12,7 +12,7 @@
  */
 /**
  * How a run ended, in the `output` entry every run ends with, kept whatever
- * the application's `record.include` says (PAP_DATALAYER R-01): its words
+ * the application's `record.include` says (R-01): its words
  * only when it keeps `outputs`.
  */
 export const RUN_END_WORDS = {
@@ -28,7 +28,7 @@ export const RUN_END_WORDS = {
 export const ASKED_FOR_TAG = 'asked-for';
 /**
  * What a person asked, as they are shown it: without what the runtime told
- * the application before their words (PAP_DATALAYER, decided 2026-10-14).
+ * the application before their words (decided 2026-10-14).
  * The record keeps it for the application's builder; the person never wrote
  * it, so *Your conversations* and a thread opened again leave it out.
  */

package/lib/portable/runMeasures.d.ts

@@ -1,5 +1,5 @@
 /**
- * How a streamed turn went, measured without its words (MOBILE M-036, §10):
+ * How a streamed turn went, measured without its words (M-036):
  * the time to its first streamed token, to its complete answer, how long a
  * Stop took, the category of a stream that failed, and how often a lost
  * stream was read back. Never a prompt, an answer, a tool's arguments or an

package/lib/portable/runMeasures.js

@@ -3,7 +3,7 @@
  * Distributed under the terms of the Modified BSD License.
  */
 /**
- * How a streamed turn went, measured without its words (MOBILE M-036, §10):
+ * How a streamed turn went, measured without its words (M-036):
  * the time to its first streamed token, to its complete answer, how long a
  * Stop took, the category of a stream that failed, and how often a lost
  * stream was read back. Never a prompt, an answer, a tool's arguments or an

package/lib/portable/runtimes.d.ts

@@ -2,7 +2,7 @@
  * A person's agent runtimes as the runtimes service lists them
  * (`GET /api/runtimes/v1/runtimes`), and an agent's summary and status as
  * every client says them — the web's `AgentSummary` badge and Datalayer
- * Mobile's Agents (MOBILE M-014b). A raw runtime carries no application
+ * Mobile's Agents (M-014b). A raw runtime carries no application
  * capabilities: no Rules, Protocols or Activity are read from it.
  *
  * @module portable/runtimes

package/lib/portable/semantic-events.json

@@ -1,6 +1,6 @@
 {
   "version": 1,
-  "about": "The semantic agent events a chat host renders (Slack, Discord: plans/DISCORD.md DC-005, plans/SLACK.md S-004, S-205), and the AG-UI events of agent-runtimes' session API (agent_runtimes/routes/apps.py, agent_runtimes/loop/apps/sessions.py, agent_runtimes/loop/apps/external_turns.py) each reduces to. src/portable/semanticOfAgUi.ts reduces every case (src/portable/__tests__/semantic.unit.test.ts); agent_runtimes/tests/test_semantic_events_contract.py holds the cases to what the runtime emits.",
+  "about": "The semantic agent events a chat host renders (Slack, Discord:  DC-005, S-004, S-205), and the AG-UI events of agent-runtimes' session API (agent_runtimes/routes/apps.py, agent_runtimes/loop/apps/sessions.py, agent_runtimes/loop/apps/external_turns.py) each reduces to. src/portable/semanticOfAgUi.ts reduces every case (src/portable/__tests__/semantic.unit.test.ts); agent_runtimes/tests/test_semantic_events_contract.py holds the cases to what the runtime emits.",
   "kinds": [
     "text",
     "progress",

package/lib/portable/semantic.d.ts

@@ -6,7 +6,7 @@
  * (`__tests__/semantic.unit.test.ts`) and by the runtime that emits the
  * events (`agent_runtimes/tests/test_semantic_events_contract.py`).
  *
- * Moved from the Slack service (plans/DISCORD.md DC-005, SLACK S-004, S-205).
+ * Moved from the Slack service (DC-005, S-004, S-205).
  *
  * @module portable/semantic
  */

package/lib/portable/semantic.js

@@ -10,7 +10,7 @@
  * (`__tests__/semantic.unit.test.ts`) and by the runtime that emits the
  * events (`agent_runtimes/tests/test_semantic_events_contract.py`).
  *
- * Moved from the Slack service (plans/DISCORD.md DC-005, SLACK S-004, S-205).
+ * Moved from the Slack service (DC-005, S-004, S-205).
  *
  * @module portable/semantic
  */

package/lib/portable/semanticOfAgUi.d.ts

@@ -10,7 +10,7 @@
  * A question is read from `RUN_FINISHED.result.asking` only: the run stream
  * carries no `loop.ask` event (that is the record's word, `record.py`).
  *
- * Moved from the Slack service (plans/DISCORD.md DC-005, SLACK S-205).
+ * Moved from the Slack service (DC-005, S-205).
  *
  * @module portable/semanticOfAgUi
  */
@@ -28,7 +28,7 @@ export declare function turnOf(event: AgUiEvent): TurnInfo | undefined;
 /**
  * The question a turn ends on (`RUN_FINISHED.result.asking`), as
  * a host asks it, or `undefined` when the value is not a question. A kind a
- * host does not know is answered in Datalayer, as a form (SLACK S-307):
+ * host does not know is answered in Datalayer, as a form (S-307):
  * never guessed to be text. (`conversation.ts`'s `questionOf`, for a native
  * client, throws on such a kind instead.)
  */

package/lib/portable/semanticOfAgUi.js

@@ -37,7 +37,7 @@ function resultRecord(content) {
 /**
  * The question a turn ends on (`RUN_FINISHED.result.asking`), as
  * a host asks it, or `undefined` when the value is not a question. A kind a
- * host does not know is answered in Datalayer, as a form (SLACK S-307):
+ * host does not know is answered in Datalayer, as a form (S-307):
  * never guessed to be text. (`conversation.ts`'s `questionOf`, for a native
  * client, throws on such a kind instead.)
  */

package/lib/portable/signIn.d.ts

@@ -1,6 +1,6 @@
 /**
  * What the gateway's `pap_sign_in` tool answers, read and checked
- * (AGENT_PROTOCOLS PI-56, PAP_DATALAYER P-03): the person signs in at a
+ * (PI-56, P-03): the person signs in at a
  * company themselves — on the company's page (`direct`), by entering a
  * code there (`device`), or by typing what the company asks on Datalayer's
  * own page (`mediated`), never in the conversation. The chat shows the link,
@@ -10,7 +10,7 @@
  *
  * Pure: no React. A test reaches it without a chat around it.
  *
- * Kept in `portable/` (MOBILE M-037): Datalayer Mobile reads the same
+ * Kept in `portable/` (M-037): Datalayer Mobile reads the same
  * sign-in with the same checks; the web plugin re-exports it.
  *
  * @module portable/signIn
@@ -24,7 +24,7 @@ export type PapSignInWaiting = {
     host: string;
     /**
      * The company's domain, when the gateway names it: for a bound `direct`
-     * sign-in the page opened is Datalayer's start link (PAP_DATALAYER P-04),
+     * sign-in the page opened is Datalayer's start link (P-04),
      * which sends the person on to the company and takes them back only from it.
      */
     company?: string;
@@ -36,7 +36,7 @@ export type PapSignInWaiting = {
     expiresAt?: string;
     /**
      * What the company said it needs (its `authorization` event's scope,
-     * PAP_DATALAYER P-02): what the person is asked to allow there.
+     * P-02): what the person is asked to allow there.
      */
     needs?: string[];
 };
@@ -69,7 +69,7 @@ export declare const PAP_SIGN_IN_WORDS: {
 };
 /**
  * Where Datalayer's `/pap/signed-in` page says a Direct Sign-In came back
- * (PAP_DATALAYER P-04): the card waiting for that company hears it in the
+ * (P-04): the card waiting for that company hears it in the
  * person's tab, so the conversation goes on there.
  */
 export declare const PAP_SIGN_IN_CHANNEL = "datalayer-pap-sign-in";

package/lib/portable/signIn.js

@@ -31,7 +31,7 @@ export const PAP_SIGN_IN_WORDS = {
 };
 /**
  * Where Datalayer's `/pap/signed-in` page says a Direct Sign-In came back
- * (PAP_DATALAYER P-04): the card waiting for that company hears it in the
+ * (P-04): the card waiting for that company hears it in the
  * person's tab, so the conversation goes on there.
  */
 export const PAP_SIGN_IN_CHANNEL = 'datalayer-pap-sign-in';

package/lib/portable/signInStatus.d.ts

@@ -1,6 +1,5 @@
 /**
- * How a sign-in under way stands, asked by the person's own client (MOBILE
- * M-039): the gateway's `GET /api/mcp/v1/pap/sign-in?app_uid&company`, with
+ * How a sign-in under way stands, asked by the person's own client (M-039): the gateway's `GET /api/mcp/v1/pap/sign-in?app_uid&company`, with
  * the person's own sign-in, finishes what can be finished — a Direct return
  * IAM bound to their browser and the company asked, a Device code the
  * company confirmed — and says where it stands.

package/lib/portable/signInStatus.js

@@ -3,8 +3,7 @@
  * Distributed under the terms of the Modified BSD License.
  */
 /**
- * How a sign-in under way stands, asked by the person's own client (MOBILE
- * M-039): the gateway's `GET /api/mcp/v1/pap/sign-in?app_uid&company`, with
+ * How a sign-in under way stands, asked by the person's own client (M-039): the gateway's `GET /api/mcp/v1/pap/sign-in?app_uid&company`, with
  * the person's own sign-in, finishes what can be finished — a Direct return
  * IAM bound to their browser and the company asked, a Device code the
  * company confirmed — and says where it stands.

package/lib/portable/thread.d.ts

@@ -1,7 +1,7 @@
 /**
  * A person's conversation with an application, read again: the person-facing
  * projection of a session's thread, and the thread opened from the runtime
- * that holds it — or resumed from its record (LOOP P-24, D-13, R-04).
+ * that holds it — or resumed from its record (P-24, D-13, R-04).
  *
  * The web chat (`ChatView`, an embed after its page reloads) and Datalayer
  * Mobile open a thread with these, so that what a person reads of their own
@@ -21,7 +21,7 @@ export declare const THREAD_WORDS: {
  * was said and answered, in words. A turn a personal agent asked is shown
  * without what the runtime told the application before the person's words
  * (`askedOf`, decided 2026-10-14). What its messages showed comes on the
- * conversation's ui socket (REACTOR_UI RU-W), never here: a `reactor.ui`
+ * conversation's ui socket (RU-W), never here: a `reactor.ui`
  * activity in a thread is refused.
  */
 export declare function messagesOfThread(messages: unknown): ChatMessage[];

package/lib/portable/thread.js

@@ -15,7 +15,7 @@ export const THREAD_WORDS = {
  * was said and answered, in words. A turn a personal agent asked is shown
  * without what the runtime told the application before the person's words
  * (`askedOf`, decided 2026-10-14). What its messages showed comes on the
- * conversation's ui socket (REACTOR_UI RU-W), never here: a `reactor.ui`
+ * conversation's ui socket (RU-W), never here: a `reactor.ui`
  * activity in a thread is refused.
  */
 export function messagesOfThread(messages) {
@@ -29,7 +29,7 @@ export function messagesOfThread(messages) {
         }
         const { id, role, content, activityType } = message;
         if (role === 'activity' && activityType === REACTOR_UI_NAME) {
-            throw new Error(`Activity ${String(id)}: what a message showed comes on the ui socket (REACTOR_UI RU-W)`);
+            throw new Error(`Activity ${String(id)}: what a message showed comes on the ui socket (RU-W)`);
         }
         if ((role === 'user' || role === 'assistant') &&
             typeof id === 'string' &&

package/lib/portable/views.d.ts

@@ -1,6 +1,6 @@
 /**
- * The conversation's components, as one contract for every renderer (MOBILE
- * §4.1–4.2, M-032): the props each one takes, and what each says — to the
+ * The conversation's components, as one contract for every renderer (M-032):
+ * the props each one takes, and what each says — to the
  * eye and to a screen reader — computed here once, so that a native renderer
  * (Datalayer Mobile's `.native` views) and the web's draw the same rows with
  * the same words and states, over `reduceConversation`'s state.
@@ -60,10 +60,10 @@ export type QuestionCardProps = {
     onForm: (values: Record<string, unknown>) => void;
 };
 /**
- * A protocol display under its tool row (MOBILE M-037): what it shows is
+ * A protocol display under its tool row (M-037): what it shows is
  * `displayLine`'s and the display's own — a coding agent's `diff` as a
  * unified diff in the file's language (`unifiedDiffLines`), its `terminal`
- * as the command and the output kept (SHIELD §4.3); what the person does goes out
+ * as the command and the output kept; what the person does goes out
  * through the host — a sign-in page opened outside the conversation, an
  * operation answered where approvals are, *I have signed in* said as their
  * next message. Nothing is answered from the card itself.
@@ -78,7 +78,7 @@ export type ProtocolDisplayProps = {
     onSignedIn: (words: string) => void;
     /**
      * Open a Direct Conversation under the conversation a company answered in
-     * (`portable/direct`, MOBILE M-038); absent where none can be opened.
+     * (`portable/direct`, M-038); absent where none can be opened.
      */
     onOpenDirect?: (company: string, conversationId: string) => void;
 };

package/lib/protocols/A2AAdapter.d.ts

@@ -34,7 +34,7 @@ export declare class A2AAdapter extends BaseProtocolAdapter {
     private currentTaskId;
     /**
      * Whether the connected agent's card advertised the Datalayer
-     * orchestration extension (ORCHESTRATOR.md, O3-03). Set once, from
+     * orchestration extension (O3-03). Set once, from
      * `connect()`'s card fetch: neither side infers support from a
      * successful message (the extension's own negotiation rule), so this is
      * the one place that decides it, and every request either activates the

package/lib/protocols/A2AAdapter.js

@@ -98,7 +98,7 @@ export class A2AAdapter extends BaseProtocolAdapter {
     currentTaskId = null;
     /**
      * Whether the connected agent's card advertised the Datalayer
-     * orchestration extension (ORCHESTRATOR.md, O3-03). Set once, from
+     * orchestration extension (O3-03). Set once, from
      * `connect()`'s card fetch: neither side infers support from a
      * successful message (the extension's own negotiation rule), so this is
      * the one place that decides it, and every request either activates the
@@ -128,7 +128,7 @@ export class A2AAdapter extends BaseProtocolAdapter {
             // fetching it here 404s against every real worker, silently, since
             // a missing card is caught below and connect() still "succeeds" —
             // found live, against agent_teams.a2a.reference_worker
-            // (ORCHESTRATOR.md O3-04), not assumed: `supportsOrchestrationExtension`
+            // (O3-04), not assumed: `supportsOrchestrationExtension`
             // stayed false against a worker whose card plainly advertised it.
             const agentUrl = this.a2aConfig.agentUrl || this.a2aConfig.baseUrl;
             const wellKnownUrl = new URL('/.well-known/agent-card.json', agentUrl).toString();
@@ -434,7 +434,7 @@ export class A2AAdapter extends BaseProtocolAdapter {
             const state = task.status?.state;
             console.log('[A2AAdapter] Status update:', state, 'final:', task.final);
             // The agent's voice and the lines it says aloud, in a working status
-            // message's metadata (VOICE.md VO-36): activities the chat says and
+            // message's metadata (VO-36): activities the chat says and
             // captions, as AG-UI's `voice.settings` and `voice.say` custom events.
             const voice = task.status?.message?.metadata?.voice;
             if (voice?.settings) {