@datalayer/agent-runtimes 1.5.51 → 1.5.53

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

@@ -1,11 +1,10 @@
 /**
- * Liveness and readiness (SLACK §10, S-101; DISCORD §10): `/healthz` says the
+ * Liveness and readiness (S-101): `/healthz` says the
  * process answers; `/readyz` says it can take durable work now — its store
  * and its queue answer — and never asks the host or Datalayer, so a
  * transient outage of either does not take the pods out of service: accepted
  * work waits in the queue instead. And the window a signed host request's
- * timestamp must fall in. Moved from the Slack service (plans/DISCORD.md
- * DC-004).
+ * timestamp must fall in. Moved from the Slack service (DC-004).
  *
  * @module portable/hosts/health
  */
@@ -25,7 +24,7 @@ export declare const HEALTH_PATHS: readonly ["/healthz", "/readyz"];
 export declare function answerHealth(checks: ReadinessChecks, request: IncomingMessage, response: ServerResponse): boolean;
 /** A worker's own server: its health and readiness only (no host route). */
 export declare function healthServer(checks: ReadinessChecks): Server;
-/** How far a signed host request's timestamp may be from now, either way (SLACK §7.1, 1; DISCORD §7.1, 1). */
+/** How far a signed host request's timestamp may be from now, either way. */
 export declare const REQUEST_WINDOW_SECONDS: number;
 /**
  * Whether a request's timestamp header (Slack's `X-Slack-Request-Timestamp`,

package/lib/portable/hosts/health.js

@@ -3,13 +3,12 @@
  * Distributed under the terms of the Modified BSD License.
  */
 /**
- * Liveness and readiness (SLACK §10, S-101; DISCORD §10): `/healthz` says the
+ * Liveness and readiness (S-101): `/healthz` says the
  * process answers; `/readyz` says it can take durable work now — its store
  * and its queue answer — and never asks the host or Datalayer, so a
  * transient outage of either does not take the pods out of service: accepted
  * work waits in the queue instead. And the window a signed host request's
- * timestamp must fall in. Moved from the Slack service (plans/DISCORD.md
- * DC-004).
+ * timestamp must fall in. Moved from the Slack service (DC-004).
  *
  * @module portable/hosts/health
  */
@@ -78,7 +77,7 @@ export function healthServer(checks) {
         }
     });
 }
-/** How far a signed host request's timestamp may be from now, either way (SLACK §7.1, 1; DISCORD §7.1, 1). */
+/** How far a signed host request's timestamp may be from now, either way. */
 export const REQUEST_WINDOW_SECONDS = 5 * 60;
 /**
  * Whether a request's timestamp header (Slack's `X-Slack-Request-Timestamp`,

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

@@ -4,7 +4,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/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
  */
@@ -40,6 +40,13 @@ export interface WorkQueue<T> {
 /** In-process development queue. A durable adapter is required in production. */
 export declare class MemoryWorkQueue<T> implements WorkQueue<T> {
     #private;
+    readonly onFailure: (error: unknown, item: T) => void;
+    /**
+     * A job that throws is reported here and dropped, and the next one is
+     * worked: one failure never stops the queue, nor the process with an
+     * unhandled rejection. The durable queue retries and dead-letters instead.
+     */
+    constructor(onFailure?: (error: unknown, item: T) => void);
     enqueue(item: T, idempotencyKey?: string): Promise<boolean>;
     ready(): Promise<boolean>;
     start(handler: (item: T) => Promise<void>): void;

package/lib/portable/hosts/queue.js

@@ -11,10 +11,21 @@ export function tablePrefixOf(prefix) {
 }
 /** In-process development queue. A durable adapter is required in production. */
 export class MemoryWorkQueue {
+    onFailure;
     #items = [];
     #keys = new Set();
     #handler;
     #running = false;
+    /**
+     * A job that throws is reported here and dropped, and the next one is
+     * worked: one failure never stops the queue, nor the process with an
+     * unhandled rejection. The durable queue retries and dead-letters instead.
+     */
+    constructor(onFailure = error => {
+        console.error(`A job failed and was dropped: ${error instanceof Error ? error.message : String(error)}`);
+    }) {
+        this.onFailure = onFailure;
+    }
     async enqueue(item, idempotencyKey) {
         if (idempotencyKey) {
             if (this.#keys.has(idempotencyKey)) {
@@ -52,7 +63,12 @@ export class MemoryWorkQueue {
                 }
                 const item = this.#items.shift();
                 if (item !== undefined) {
-                    await handler(item);
+                    try {
+                        await handler(item);
+                    }
+                    catch (error) {
+                        this.onFailure(error, item);
+                    }
                 }
             }
         }

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.