comisai 1.0.44 → 1.0.46

package/node_modules/@comis/observability/dist/trajectory/translate-orchestration-payload.js

@@ -1,7 +1,7 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
- * Trajectory bridge payload translators for the v2.27 authoring / sub-agent
- * orchestration family (TELEM-01 + AUTHOR-01/02 + STEER-01).
+ * Trajectory bridge payload translators for the authoring / sub-agent
+ * orchestration family.
  *
  * Extracted from `translate-payload.ts` (which is at the file-size cap) — the
  * main `translatePayload` switch delegates these four cases here. No behavior
@@ -9,57 +9,63 @@
  * `translate-video-payload.ts` / `translate-vision-payload.ts` /
  * `translate-voice-payload.ts` splits document).
  *
- * CONTENT-FREE (§2.7 / H1): each arm forwards ONLY closed enums + numbers /
+ * CONTENT-FREE: each arm forwards ONLY closed enums + numbers /
  * booleans / a run id and STRIPS the envelope (agentId / sessionKey / timestamp).
  * NEVER a pipeline / graph body, a `type_config` value, a node task, the
  * synthesis INTENT TEXT (the highest-risk authoring leak), or the steer MESSAGE
- * BODY (the highest-risk steer leak). `pipeline:authored.repaired` is P1-inert.
+ * BODY (the highest-risk steer leak).
  *
  * @module
  */
 /**
- * Translate a v2.27 authoring / orchestration EventBus payload into the
+ * Translate an authoring / orchestration EventBus payload into the
  * content-free `data` of its trajectory event. The envelope keys are stripped
  * (they ride the trajectory envelope via the recorder, not `data`).
  */
 export function translateOrchestrationPayload(eventName, payload) {
     switch (eventName) {
         case "pipeline:authored":
-            // TELEM-01: closed enums + booleans ONLY — never a pipeline body / type_config value / node task. repaired is P1-inert.
+            // Closed enums + booleans ONLY — never a pipeline body / type_config value / node task.
             return { action: payload.action, capabilityClass: payload.capabilityClass, schemaValid: payload.schemaValid, repaired: payload.repaired };
         case "graph:repaired":
-            // AUTHOR-01: matched canonical template + repaired-graph nodeCount + tier.
+            // Matched canonical template + repaired-graph nodeCount + tier.
             return { pattern: payload.pattern, nodeCount: payload.nodeCount, capabilityClass: payload.capabilityClass };
         case "graph:synthesized_from_intent":
-            // AUTHOR-02: requested pattern + synthesized-graph nodeCount (no intent text).
+            // Requested pattern + synthesized-graph nodeCount (no intent text).
             return { pattern: payload.pattern, nodeCount: payload.nodeCount };
         case "subagent:steered":
-            // STEER-01 (175): the steered runId + the closed-union mode (steer|followup) ONLY — NEVER the steer message body (the highest-risk leak); agentId/timestamp are envelope-only and stripped (the graph:repaired precedent).
+            // The steered runId + the closed-union mode (steer|followup) ONLY — NEVER the steer message body (the highest-risk leak); agentId/timestamp are envelope-only and stripped (the graph:repaired precedent).
             return { runId: payload.runId, mode: payload.mode };
         case "security:sandbox_downgrade_refused":
-            // ORCH-OBS (SANDBOX-02): the violated sandbox DIMENSION labels ONLY (exec/filesystem/
+            // The violated sandbox DIMENSION labels ONLY (exec/filesystem/
             // network/uid) — NEVER the postures' fail-closed values or any path/host/uid-number
-            // that would leak the operator's sandbox topology (§2.7). parent/child agent ids +
+            // that would leak the operator's sandbox topology. parent/child agent ids +
             // timestamp are envelope-only and stripped.
             return { dimensions: payload.violatedDimensions };
         case "subagent:delivery_deadlettered":
-            // ORCH-OBS (DELIVERY-02): the dropped run id + the closed channelType + the transient
+            // The dropped run id + the closed channelType + the transient
             // (retries-exhausted vs immediate-permanent) tag ONLY — NEVER the announcement body or
-            // the error string (§2.7). timestamp envelope-only.
+            // the error string. timestamp envelope-only.
             return { runId: payload.runId, channelType: payload.channelType, transient: payload.transient };
+        case "subagent:delivery_retried":
+            // The self-healing transient retry — run id + closed channelType +
+            // the 1-based attempt count + the transient tag ONLY (the `explain` view wants the attempt
+            // number so an operator can see HOW MANY retries a completion took before it landed) —
+            // NEVER the announcement body or the error string. timestamp envelope-only.
+            return { runId: payload.runId, channelType: payload.channelType, attempt: payload.attempt, transient: payload.transient };
         case "subagent:budget_exceeded":
-            // ORCH-OBS (BUDGET-03): the per-incident breach view for `comis explain` — graphId/
-            // nodeId ids + the closed capSource + the two token NUMBERS (counts, §2.7-safe; the
+            // The per-incident breach view for `comis explain` — graphId/
+            // nodeId ids + the closed capSource + the two token NUMBERS (counts; the
             // explain view DOES want them, unlike the fleet aggregate) — NEVER a task or output.
             // agentId/timestamp envelope-only.
             return { graphId: payload.graphId, nodeId: payload.nodeId, capSource: payload.capSource, tokenBudget: payload.tokenBudget, tokensUsed: payload.tokensUsed };
         case "capability:audited":
-            // AUDIT-01 / TREE (215): the per-node spawn-tree source — capability + tool
+            // The per-node spawn-tree source — capability + tool
             // NAME + the closed-union decision + the lease/root ids ONLY. NEVER the
-            // tool.invoke args, a message body, or a secret name (the highest-risk leak,
-            // T-215-01 / Pitfall 5). agentId/timestamp/method are envelope-ish labels and
+            // tool.invoke args, a message body, or a secret name (the highest-risk leak).
+            // agentId/timestamp/method are envelope-ish labels and
             // are stripped (the subagent:steered/budget_exceeded precedent). leaseId/
-            // parentLeaseId/tool are honestly absent on the in-process record (no lease, G1).
+            // parentLeaseId/tool are honestly absent on the in-process record (no lease).
             return {
                 capability: payload.capability,
                 tool: payload.tool,
@@ -69,7 +75,7 @@ export function translateOrchestrationPayload(eventName, payload) {
                 rootRunId: payload.rootRunId,
             };
         case "graph:node_spawned":
-            // TREE-01 (finding D): the per-graph-node spawn-tree leaf — graph/node ids +
+            // The per-graph-node spawn-tree leaf — graph/node ids +
             // the node's CHILD agentId + the tree-stable rootRunId + the per-node token cap
             // ONLY. NEVER the node task or output. The child agentId rides `data` as
             // `nodeAgentId` (NOT the correlation key `agentId`, which would be stripped to
@@ -83,6 +89,33 @@ export function translateOrchestrationPayload(eventName, payload) {
                 rootRunId: payload.rootRunId,
                 tokenBudget: payload.tokenBudget,
             };
+        case "orchestrate:run_summary":
+            // The per-run summary — ids + the closed failureClass enum + counts +
+            // token estimates + the bounded content-free toolSequence (the pre-flight
+            // ordered call-site sequence + counts — order + repeats preserved VERBATIM,
+            // NOT sorted/deduped) ONLY. rootRunId is the self-attribution key (forwarded
+            // into data, the capability:audited precedent); agentId/sessionKey/
+            // timestamp are envelope-only and stripped (the daemon-shared bus fans out
+            // to every session bridge — data self-attributes via rootRunId, never the
+            // envelope sessionKey). The turn traceId is deliberately NOT forwarded (the
+            // trajectory record is already traceId-keyed). The stderr tail / script body
+            // / tool params are NEVER on the payload and are not forwarded here.
+            return {
+                runId: payload.runId,
+                leaseId: payload.leaseId,
+                rootRunId: payload.rootRunId,
+                language: payload.language,
+                durationMs: payload.durationMs,
+                exitCode: payload.exitCode,
+                failureClass: payload.failureClass,
+                stdoutBytesRaw: payload.stdoutBytesRaw,
+                stdoutCharsReentered: payload.stdoutCharsReentered,
+                resultRefCount: payload.resultRefCount,
+                resultRefBytes: payload.resultRefBytes,
+                estSavedTokens: payload.estSavedTokens,
+                savedRatio: payload.savedRatio,
+                toolSequence: payload.toolSequence,
+            };
         default: {
             // Exhaustiveness — the switch covers every OrchestrationBridgedEventName.
             const _exhaustive = eventName;

package/node_modules/@comis/observability/dist/trajectory/translate-payload.js

@@ -51,8 +51,11 @@ export function translatePayload(eventName, rawPayload) {
                 success: payload.success,
                 ...(payload.errorKind !== undefined ? { errorKind: payload.errorKind } : {}),
                 ...(payload.errorMessage !== undefined ? { errorMessage: payload.errorMessage } : {}),
+                // The bounded+redacted failed-call arguments (emit-site gated to
+                // failures only; obs.explain surfaces it on failures[]).
+                ...(payload.argsPreview !== undefined ? { argsPreview: payload.argsPreview } : {}),
                 ...(payload.truncated !== undefined ? { truncated: payload.truncated } : {}),
-                // D1 provenance forwarding (Phase 153 obs.explain reads it).
+                // Provenance forwarding (obs.explain reads it).
                 // matchedToken is already sanitized+bounded at the emit (pi-event-bridge),
                 // so every field is forwarded verbatim here.
                 ...(payload.classifiedFailureBy !== undefined ? { classifiedFailureBy: payload.classifiedFailureBy } : {}),
@@ -62,7 +65,7 @@ export function translatePayload(eventName, rawPayload) {
                 ...(payload.matchedToken !== undefined ? { matchedToken: payload.matchedToken } : {}),
                 ...(payload.resultBytes !== undefined ? { resultBytes: payload.resultBytes } : {}),
                 ...(payload.resultDigest !== undefined ? { resultDigest: payload.resultDigest } : {}),
-                // F-OBS-2: content-free web_search/web_fetch grounding summary (count +
+                // Content-free web_search/web_fetch grounding summary (count +
                 // source hosts only) so grounding is verifiable from the trajectory.
                 ...(payload.resultCount !== undefined ? { resultCount: payload.resultCount } : {}),
                 ...(payload.domains !== undefined ? { domains: payload.domains } : {}),
@@ -80,7 +83,7 @@ export function translatePayload(eventName, rawPayload) {
             };
         case "tool:breaker_opened":
             // ids/counts/typed-reason only — errorTag is the breaker's normalized
-            // tag, never raw error text (§2.7 / T-151-01).
+            // tag, never raw error text.
             return {
                 toolName: payload.toolName,
                 consecutiveFailures: payload.consecutiveFailures,
@@ -96,7 +99,7 @@ export function translatePayload(eventName, rawPayload) {
             };
         case "tool:result_offloaded":
             // ids/counts + the WORKSPACE-RELATIVE pointer only — never the offloaded
-            // result body and never the absolute host path (§2.7 / T-151-05/06).
+            // result body and never the absolute host path.
             return {
                 toolName: payload.toolName,
                 toolCallId: payload.toolCallId,
@@ -165,16 +168,16 @@ export function translatePayload(eventName, rawPayload) {
                 invokedBy: payload.invokedBy,
                 args: payload.args,
             };
-        // IMP-3 / PD-OBS-1: the per-turn used-skill attribution (inline-surfaced reuse credit). IDS + COUNT
-        // ONLY — opaque skill ids (same id-class as skill.prompt_invoked.skillName), never a procedure body
-        // (§2.7 / SEC-01). The fold (accumulateSkillUsedRecord) reads usedSkillIds into explain.skillsUsed.
+        // The per-turn used-skill attribution (inline-surfaced reuse credit). IDS + COUNT
+        // ONLY — opaque skill ids (same id-class as skill.prompt_invoked.skillName), never a procedure body.
+        // The fold (accumulateSkillUsedRecord) reads usedSkillIds into explain.skillsUsed.
         case "memory:skill_used":
             return {
                 usedSkillIds: payload.usedSkillIds,
                 usedCount: payload.usedCount,
             };
-        // Finding A: the per-turn topic-match reuse census. Content-free — skill NAMES (id-class) +
-        // coverage/sharedCount NUMBERS + credited/hasTopicTokens flags; never a procedure body (SEC-01).
+        // The per-turn topic-match reuse census. Content-free — skill NAMES (id-class) +
+        // coverage/sharedCount NUMBERS + credited/hasTopicTokens flags; never a procedure body.
         // The fold (accumulateSkillSurfacedRecord) reads the uncredited-with-overlap entries into
         // explain.learning.skillsSurfacedButUncredited.
         case "memory:skill_surfaced":
@@ -208,7 +211,7 @@ export function translatePayload(eventName, rawPayload) {
             };
         case "session:summary":
             // Counts/flags ONLY — agentId/sessionKey/traceId are envelope
-            // correlation ids handled separately, never in the record data (§2.7).
+            // correlation ids handled separately, never in the record data.
             return {
                 degraded: payload.degraded,
                 turnCount: payload.turnCount,
@@ -223,9 +226,9 @@ export function translatePayload(eventName, rawPayload) {
                 trustTags: payload.trustTags,
             };
         case "memory:recalled":
-            // RECALL-01: per-recall lane/candidate/final counts (the #1 blind spot, now on
-            // the explain/trace timeline). Counts/booleans ONLY — never query text or memory
-            // bodies; agentId/sessionKey/traceId are envelope correlation ids (§2.7 / H1).
+            // Per-recall lane/candidate/final counts, on the explain/trace timeline.
+            // Counts/booleans ONLY — never query text or memory
+            // bodies; agentId/sessionKey/traceId are envelope correlation ids.
             return {
                 lanes: payload.lanes,
                 ftsCandidates: payload.ftsCandidates,
@@ -236,8 +239,8 @@ export function translatePayload(eventName, rawPayload) {
                 durationMs: payload.durationMs,
             };
         case "memory:reranked":
-            // RECALL-01: rerank candidate/hit counts + the graceful-degradation flags
-            // (timedOut/fellBack) — counts/booleans ONLY (§2.7 / H1).
+            // Rerank candidate/hit counts + the graceful-degradation flags
+            // (timedOut/fellBack) — counts/booleans ONLY.
             return {
                 candidateCount: payload.candidateCount,
                 hitCount: payload.hitCount,
@@ -247,9 +250,9 @@ export function translatePayload(eventName, rawPayload) {
                 durationMs: payload.durationMs,
             };
         case "memory:generation_quality":
-            // GENQ-01: which pass + the source/output dominant scripts + the issue flags.
+            // Which pass + the source/output dominant scripts + the issue flags.
             // Closed enums + booleans ONLY — never the source or generated body; agentId/
-            // sessionKey are envelope correlation ids (§2.7 / H1).
+            // sessionKey are envelope correlation ids.
             return {
                 pass: payload.pass,
                 sourceScript: payload.sourceScript,
@@ -258,51 +261,50 @@ export function translatePayload(eventName, rawPayload) {
                 emptyOutput: payload.emptyOutput,
                 formatViolation: payload.formatViolation,
             };
-        // PERSIST-01 (+AUDIT-05 est-$): content-free reason/counts/digest + computed est-$;
+        // Content-free reason/counts/digest + computed est-$;
         // delegated to translate-cache-break-payload.ts (file-size split).
         case "observability:cache_break":
             return translateCacheBreakPayload(payload);
-        // ---- v2.27 authoring / sub-agent orchestration (TELEM-01 + AUTHOR-01/02 + STEER-01) ---- delegated to translate-orchestration-payload.ts (file-size split, Phase 175; content-free + envelope-stripped — closed enums + numbers/booleans + a run id ONLY, never a graph body, the synthesis INTENT TEXT, or the steer MESSAGE BODY; §2.7 / H1).
-        // ORCH-OBS appends three previously-dark sub-agent-lifecycle events (sandbox-downgrade
-        // refusal / dead-lettered delivery / per-node budget breach) to the SAME content-free,
+        // ---- Authoring / sub-agent orchestration ---- delegated to translate-orchestration-payload.ts (file-size split; content-free + envelope-stripped — closed enums + numbers/booleans + a run id ONLY, never a graph body, the synthesis INTENT TEXT, or the steer MESSAGE BODY).
+        // Three sub-agent-lifecycle events (sandbox-downgrade
+        // refusal / dead-lettered delivery / per-node budget breach) join the SAME content-free,
         // orchestration-translator-delegated group.
-        // AUDIT-01 / TREE (215): capability:audited joins the orchestration-translator group (content-free: caps/tool-NAME/decision/lease-root ids ONLY, never args/body/secret).
-        // TREE-01 (finding D): graph:node_spawned joins it too (content-free: graph/node ids + child agentId + rootRunId + token cap).
+        // capability:audited joins the orchestration-translator group (content-free: caps/tool-NAME/decision/lease-root ids ONLY, never args/body/secret).
+        // graph:node_spawned joins it too (content-free: graph/node ids + child agentId + rootRunId + token cap).
         case "pipeline:authored":
         case "graph:repaired":
         case "graph:synthesized_from_intent":
         case "subagent:steered":
         case "security:sandbox_downgrade_refused":
         case "subagent:delivery_deadlettered":
+        case "subagent:delivery_retried": // The self-healing transient retry (sibling of delivery_deadlettered) — content-free {runId, channelType, attempt, transient}
         case "subagent:budget_exceeded":
         case "capability:audited":
         case "graph:node_spawned":
+        case "orchestrate:run_summary": // A completed orchestrate run's content-free per-run summary — ids + the closed failureClass enum + counts + token estimates ONLY, never a stderr tail / script body / tool params.
             return translateOrchestrationPayload(eventName, payload);
-        case "learning:outcome_observed": // OUTCOME-08: trajectoryId + closed-enum outcome/source + numeric confidence ONLY (no body/alpha/recalled ids; agentId/sessionKey/traceId envelope-only — §2.7 / SEC-01).
+        case "learning:outcome_observed": // trajectoryId + closed-enum outcome/source + numeric confidence ONLY (no body/alpha/recalled ids; agentId/sessionKey/traceId envelope-only).
             return { trajectoryId: payload.trajectoryId, outcome: payload.outcome, source: payload.source, confidence: payload.confidence };
         case "learning:memory_demoted":
         case "learning:memory_evicted":
-        case "learning:memory_failure_attributed": // OBS-4b: corroborated-failure accrual COUNT ONLY — the eviction-causation precursor (never a memory id-list/body, SEC-01).
-        case "reflect:admitted": // REFLECT (Phase 226): admitted COUNT ONLY (renamed from learning:skill_synthesized)
-        case "learning:skill_promoted": // SURFACE-06: counts ONLY (SEC-01)
-            // FORGET-06 / REFLECT / SURFACE-06: the soft-eviction / failure-accrual / admitted / promoted COUNT ONLY — never an id-list, procedure body, or script (§2.7 / SEC-01); the record TYPE conveys which transition.
+        case "learning:memory_failure_attributed": // Corroborated-failure accrual COUNT ONLY — the eviction-causation precursor (never a memory id-list/body).
+        case "reflect:admitted": // Admitted COUNT ONLY.
+        case "learning:skill_promoted": // Counts ONLY.
+            // The soft-eviction / failure-accrual / admitted / promoted COUNT ONLY — never an id-list, procedure body, or script; the record TYPE conveys which transition.
             return { count: payload.count };
         case "learning:skill_demoted":
-            // SURFACE-06 + finding C: count + the demoted skill NAMES (id-class, same as
+            // Count + the demoted skill NAMES (id-class, same as
             // skill.prompt_invoked.skillName) + the trigger trajectory id, so `explain` answers "which
-            // skill demoted and why" in one call (was count-only). NAMES/ids ONLY — never a body (SEC-01).
+            // skill demoted and why" in one call. NAMES/ids ONLY — never a body.
             return {
                 count: payload.count,
                 ...(Array.isArray(payload.demotedSkillNames) ? { demotedSkillNames: payload.demotedSkillNames } : {}),
                 ...(typeof payload.triggerTrajectoryId === "string" ? { triggerTrajectoryId: payload.triggerTrajectoryId } : {}),
             };
-        case "reflect:funnel": // REFLECT (Phase 226, renamed from the old synthesis funnel): the reflection FUNNEL COUNTS + the acute admissionOutcome verdict (RC-4) — never a procedure body/script (SEC-01). Answers "why 0 admitted" from the trajectory in ONE field. OBS-1: the funnel MAGNITUDES (untrustedDrops / source counts) ride too — all counts, never bodies.
+        case "reflect:funnel": // The reflection FUNNEL COUNTS + the acute admissionOutcome verdict — never a procedure body/script. Answers "why 0 admitted" from the trajectory in ONE field. The funnel MAGNITUDES (untrustedDrops / source counts) ride too — all counts, never bodies.
             return { synthesized: payload.synthesized, validated: payload.validated, admitted: payload.admitted, maxClusterCardinality: payload.maxClusterCardinality, distinctTopicKeys: payload.distinctTopicKeys, untrustedDrops: payload.untrustedDrops, nameLengthRejections: payload.nameLengthRejections, skipped: payload.skipped, sourceTrajectoryCount: payload.sourceTrajectoryCount, totalSourceChars: payload.totalSourceChars, admissionOutcome: payload.admissionOutcome };
-        // Phase 226 SIMPLIFY-04: the 3 vestigial translator cases (sandbox-validation + user-rep-revision
-        // + generalization) were DELETED with their 0-emit events (sandbox deleted in 223; the other two
-        // folded into the reflection engine in 225).
-        // T2.2 (F9): closed ids + durationMs ONLY — agentId/origin are envelope ids; no result/
-        // error body crosses the bus (§2.7 / H1); the record TYPE conveys promoted/completed/failed.
+        // Background task lifecycle: closed ids + durationMs ONLY — agentId/origin are envelope ids; no result/
+        // error body crosses the bus; the record TYPE conveys promoted/completed/failed.
         case "background_task:promoted":
             return { taskId: payload.taskId, toolName: payload.toolName };
         case "background_task:completed":
@@ -310,10 +312,16 @@ export function translatePayload(eventName, rawPayload) {
         case "background_task:failed":
             return { taskId: payload.taskId, toolName: payload.toolName, durationMs: payload.durationMs };
         case "terminal:drive_promoted":
-            // DRIVE-02 → trajectory (was daemon-log-only). Content-free: the reason enum
+            // Terminal drive promotion → trajectory. Content-free: the reason enum
             // ONLY. The terminal sessionId, agentId, and raw timestamp are envelope/
             // correlation ids (the recorder envelope carries the agent session) — never echoed.
             return { reason: payload.reason };
+        case "terminal:session_evicted":
+            // Terminal drive eviction → trajectory. Content-free: the closed cap
+            // reason enum + durationMs (the session's total lifetime at eviction) ONLY. The
+            // terminal sessionId, agentId, and raw timestamp are envelope/correlation ids
+            // (the recorder envelope carries the agent session) — never echoed.
+            return { reason: payload.reason, durationMs: payload.durationMs };
         case "delivery:enqueued":
             return {
                 entryId: payload.entryId,
@@ -321,6 +329,31 @@ export function translatePayload(eventName, rawPayload) {
                 channelId: payload.channelId,
                 origin: payload.origin,
             };
+        case "delivery:aborted":
+            // Counts + the closed abort reason only. chunksDelivered: 0 with a
+            // non-zero totalChunks is the "reply never sent" signature explain's
+            // deliverySkipped section folds.
+            return {
+                channelType: payload.channelType,
+                channelId: payload.channelId,
+                reason: payload.reason,
+                chunksDelivered: payload.chunksDelivered,
+                totalChunks: payload.totalChunks,
+                durationMs: payload.durationMs,
+                origin: payload.origin,
+            };
+        case "activity:turn_finalized":
+            // The terminal user-surface state: closed outcome kind + closed
+            // ErrorKind + the fixed named-constant reason + the strategy name.
+            return {
+                channelType: payload.channelType,
+                strategy: payload.strategy,
+                outcome: payload.outcome,
+                ...(payload.errorKind !== undefined ? { errorKind: payload.errorKind } : {}),
+                ...(payload.reason !== undefined ? { reason: payload.reason } : {}),
+                reclassified: payload.reclassified,
+                failedEventCount: payload.failedEventCount,
+            };
         case "delivery:complete": {
             const totalChunks = payload.totalChunks ?? 0;
             const deliveredChunks = payload.deliveredChunks ?? 0;
@@ -402,7 +435,7 @@ export function translatePayload(eventName, rawPayload) {
         case "execution:aborted":
             return {
                 reason: payload.reason,
-                // OBS-3: the per-root autonomy.budget limb + numbers (content-free: closed-enum
+                // The per-root autonomy.budget limb + numbers (content-free: closed-enum
                 // limb/unit strings + 2 numbers) so `explain` names the exact tripped knob.
                 ...(payload.perRootBudget !== undefined ? { perRootBudget: payload.perRootBudget } : {}),
             };
@@ -413,9 +446,9 @@ export function translatePayload(eventName, rawPayload) {
                 projectedCallsLeft: payload.projectedCallsLeft,
             };
         case "execution:prompt_timeout":
-            // LAT-04 (177): stall/makespan attribution fields forward verbatim — content-free
+            // Stall/makespan attribution fields forward verbatim — content-free
             // (numbers + closed enums + the config-KEY bindingKnob string, never delta text or env
-            // values; I7). The signals reader safeParses the row wholesale so the explain verdict
+            // values). The signals reader safeParses the row wholesale so the explain verdict
             // names the binding knob with actual numbers. agentId/sessionKey/timestamp stripped.
             return {
                 timeoutMs: payload.timeoutMs,
@@ -432,6 +465,12 @@ export function translatePayload(eventName, rawPayload) {
                 originalMaxTokens: payload.originalMaxTokens,
                 escalatedMaxTokens: payload.escalatedMaxTokens,
             };
+        case "execution:recovery_attempted":
+            // Closed recovery reason + a boolean — content-free.
+            return {
+                reason: payload.reason,
+                succeeded: payload.succeeded,
+            };
         case "execution:signed_replay_recovered":
             return {
                 blocksRemoved: payload.blocksRemoved,
@@ -439,8 +478,8 @@ export function translatePayload(eventName, rawPayload) {
                 succeeded: payload.succeeded,
             };
         case "execution:tool_schema_unsupported":
-            // GBNF-02 strip-retry self-heal. Content-free (tool + keyword NAMES only, never schema
-            // bodies — I7), so all five diagnostic fields forward verbatim — `reason` (WR-05) is the
+            // GBNF strip-retry self-heal. Content-free (tool + keyword NAMES only, never schema
+            // bodies), so all five diagnostic fields forward verbatim — `reason` is the
             // closed branch discriminator (stripped | nothing_to_strip | gate_closed).
             // agentId/sessionKey/timestamp are envelope-only and stripped.
             return {
@@ -644,7 +683,7 @@ export function translatePayload(eventName, rawPayload) {
                 skillsInjected: payload.skillsInjected,
                 overflowStripped: payload.overflowStripped,
             };
-        // OBS-01 (Phase 180): the multilingual signals. Closed ScriptClass/lane
+        // The multilingual signals. Closed ScriptClass/lane
         // enums + identifiers ONLY — never query text or summary bodies. agentId +
         // sessionKey are envelope-only and stripped (the budget_computed precedent);
         // conversationId is the DAG conversation identifier (an id, not content) and
@@ -701,34 +740,34 @@ export function translatePayload(eventName, rawPayload) {
                 count: payload.count,
                 windowMs: payload.windowMs,
             };
-        // ---- Spend kill-switch (WR-4, 177-obs-loop) ---- delegated to
+        // ---- Spend kill-switch ---- delegated to
         // translate-spend-payload.ts (file-size split; content-free + envelope-stripped:
         // the closed SpendScopeKind enum + dollar amounts as NUMBERS + provider/model
-        // CONFIG ids ONLY, never a message/prompt/query body — §2.7 / H1, the milestone
+        // CONFIG ids ONLY, never a message/prompt/query body — the load-bearing
         // invariant). agentId/sessionKey/timestamp are envelope-only and stripped.
         case "observability:spend_warning":
         case "observability:spend_exceeded":
         case "observability:spend_unpriceable":
             return translateSpendPayload(eventName, payload);
-        // ---- Image generation (OBS-04, Phase 186) ---- delegated to translate-image-payload.ts (file-size split; content-free + envelope-stripped, the precedent the vision/video/voice arms below mirror — image was the last media lifecycle still inline).
+        // ---- Image generation ---- delegated to translate-image-payload.ts (file-size split; content-free + envelope-stripped, the precedent the vision/video/voice arms below mirror — image was the last media lifecycle still inline).
         case "image:requested":
         case "image:generated":
         case "image:delivered":
         case "image:failed":
             return translateImagePayload(eventName, payload);
-        // ---- Vision analysis (VIS-04, Phase 187) ---- delegated to translate-vision-payload.ts (file-size split, Phase 196; content-free + envelope-stripped, mirroring the image:* arms above + the video:* delegation below). The `path` label is VIS-03's "which path" signal; `costUsd` rides media.vision:completed (VIS-04 Route a).
+        // ---- Vision analysis ---- delegated to translate-vision-payload.ts (file-size split; content-free + envelope-stripped, mirroring the image:* arms above + the video:* delegation below). The `path` label is the "which path" signal; `costUsd` rides media.vision:completed.
         case "media.vision:requested":
         case "media.vision:completed":
         case "media.vision:failed":
             return translateVisionPayload(eventName, payload);
-        // ---- Video generation (OBS-04, Phase 192) ---- delegated to translate-video-payload.ts (file-size split; content-free + envelope-stripped, mirroring the image:*/media.vision:* arms above).
+        // ---- Video generation ---- delegated to translate-video-payload.ts (file-size split; content-free + envelope-stripped, mirroring the image:*/media.vision:* arms above).
         case "video:requested":
         case "video:submitted":
         case "video:generated":
         case "video:delivered":
         case "video:failed":
             return translateVideoPayload(eventName, payload);
-        // ---- Voice STT/TTS (OBS-02/03, Phase 196) ---- delegated to translate-voice-payload.ts (file-size split; content-free + envelope-stripped, mirroring the image:*/media.vision:*/video:* arms above). media.*:completed carries costUsd (keyless = 0 explicit — OBS-05 Route a); media.*:requested carries the onSkip reasons (OBS-03).
+        // ---- Voice STT/TTS ---- delegated to translate-voice-payload.ts (file-size split; content-free + envelope-stripped, mirroring the image:*/media.vision:*/video:* arms above). media.*:completed carries costUsd (keyless = 0 explicit); media.*:requested carries the onSkip reasons.
         case "media.stt:requested":
         case "media.stt:completed":
         case "media.stt:failed":

package/node_modules/@comis/observability/dist/trajectory/translate-spend-payload.d.ts

@@ -1,5 +1,5 @@
 /**
- * Spend kill-switch trajectory payload translators (WR-4, 177-obs-loop).
+ * Spend kill-switch trajectory payload translators.
  *
  * The three `observability:spend_*` events → `spend.warning` / `spend.exceeded` /
  * `spend.unpriceable` trajectory records. Extracted from `translate-payload.ts` to
@@ -7,7 +7,7 @@
  * same per-event delegation pattern as `translate-cache-break-payload.ts` /
  * `translate-orchestration-payload.ts` etc.
  *
- * CONTENT-FREE (the milestone's load-bearing invariant, §2.7 / H1): the closed
+ * CONTENT-FREE (the load-bearing invariant): the closed
  * {@link SpendScopeKind} enum + dollar amounts as NUMBERS + provider/model CONFIG
  * ids ONLY. A message/prompt/query body never crosses the bus on these payloads,
  * so the translator omission is the PRIMARY control (sanitizeForPersistence is a

package/node_modules/@comis/observability/dist/trajectory/translate-spend-payload.js

@@ -1,6 +1,6 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
- * Spend kill-switch trajectory payload translators (WR-4, 177-obs-loop).
+ * Spend kill-switch trajectory payload translators.
  *
  * The three `observability:spend_*` events → `spend.warning` / `spend.exceeded` /
  * `spend.unpriceable` trajectory records. Extracted from `translate-payload.ts` to
@@ -8,7 +8,7 @@
  * same per-event delegation pattern as `translate-cache-break-payload.ts` /
  * `translate-orchestration-payload.ts` etc.
  *
- * CONTENT-FREE (the milestone's load-bearing invariant, §2.7 / H1): the closed
+ * CONTENT-FREE (the load-bearing invariant): the closed
  * {@link SpendScopeKind} enum + dollar amounts as NUMBERS + provider/model CONFIG
  * ids ONLY. A message/prompt/query body never crosses the bus on these payloads,
  * so the translator omission is the PRIMARY control (sanitizeForPersistence is a
@@ -42,7 +42,7 @@ export function translateSpendPayload(eventName, payload) {
         case "observability:spend_unpriceable":
             // provider/model are config ids (a model id is a config value, NOT user
             // content — the events-agent.ts spend_unpriceable doc), forwarded so the
-            // explain timeline can name the ffe11736-class unpriceable model.
+            // explain timeline can name an unpriceable model (one with no known pricing).
             return {
                 provider: payload.provider,
                 model: payload.model,

package/node_modules/@comis/observability/dist/trajectory/translate-video-payload.d.ts

@@ -1,6 +1,5 @@
 /**
- * Trajectory bridge payload translators for the `video:*` lifecycle (OBS-04,
- * Phase 192).
+ * Trajectory bridge payload translators for the `video:*` lifecycle.
  *
  * Extracted from `translate-payload.ts` (which is at the file-size cap) — the
  * main `translatePayload` switch delegates its five `video:*` cases here. No
@@ -8,13 +7,13 @@
  * translate-payload.ts header documents the same split rationale for the bridge
  * table itself).
  *
- * CONTENT-FREE (T-192-01): each arm forwards ONLY content-free ids / labels /
+ * CONTENT-FREE: each arm forwards ONLY content-free ids / labels /
  * numbers / `outcome` / `errorKind` / booleans and STRIPS the envelope
  * (agentId / sessionKey / timestamp) — NEVER the prompt, the video bytes, a
  * credential, or the Veo keyed-download-URL. `costUsd` rides `video:generated`
- * (OBS-03 Route a — the image:generated cost-carry precedent); it + model +
+ * (the image:generated cost-carry precedent); it + model +
  * sizeBytes + durationSecs spread presence-conditionally (FAL reports no actual
- * cost — Pitfall 4 — so an absent value never appears as an `undefined` key).
+ * cost, so an absent value never appears as an `undefined` key).
  *
  * @module
  */

package/node_modules/@comis/observability/dist/trajectory/translate-video-payload.js

@@ -1,7 +1,6 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
- * Trajectory bridge payload translators for the `video:*` lifecycle (OBS-04,
- * Phase 192).
+ * Trajectory bridge payload translators for the `video:*` lifecycle.
  *
  * Extracted from `translate-payload.ts` (which is at the file-size cap) — the
  * main `translatePayload` switch delegates its five `video:*` cases here. No
@@ -9,13 +8,13 @@
  * translate-payload.ts header documents the same split rationale for the bridge
  * table itself).
  *
- * CONTENT-FREE (T-192-01): each arm forwards ONLY content-free ids / labels /
+ * CONTENT-FREE: each arm forwards ONLY content-free ids / labels /
  * numbers / `outcome` / `errorKind` / booleans and STRIPS the envelope
  * (agentId / sessionKey / timestamp) — NEVER the prompt, the video bytes, a
  * credential, or the Veo keyed-download-URL. `costUsd` rides `video:generated`
- * (OBS-03 Route a — the image:generated cost-carry precedent); it + model +
+ * (the image:generated cost-carry precedent); it + model +
  * sizeBytes + durationSecs spread presence-conditionally (FAL reports no actual
- * cost — Pitfall 4 — so an absent value never appears as an `undefined` key).
+ * cost, so an absent value never appears as an `undefined` key).
  *
  * @module
  */

package/node_modules/@comis/observability/dist/trajectory/translate-vision-payload.d.ts

@@ -1,22 +1,22 @@
 /**
  * Trajectory bridge payload translators for the vision-analysis
- * (`media.vision:*`) lifecycle (VIS-04, Phase 187).
+ * (`media.vision:*`) lifecycle.
  *
  * Extracted from `translate-payload.ts` (which is at the file-size cap) — the
  * main `translatePayload` switch delegates its three `media.vision:*` cases here.
- * BEHAVIOR-NEUTRAL move (Phase 196 file-size split): the returned shapes are
+ * BEHAVIOR-NEUTRAL move (file-size split): the returned shapes are
  * byte-identical to the previously-inline arms, pinned by the existing
  * `media.vision:*` arm tests in `translate-payload.test.ts` + the `never`
  * exhaustiveness check below. This is the EXACT precedent that produced
  * `translate-video-payload.ts`.
  *
- * CONTENT-FREE (T-187-12): each arm forwards ONLY content-free ids / labels /
+ * CONTENT-FREE: each arm forwards ONLY content-free ids / labels /
  * the `path` / numbers / `outcome` / `errorKind` and STRIPS the envelope
  * (`agentId` / `sessionKey` / `timestamp`) — NEVER the image bytes, the analysis
  * prompt, the model's answer, or a credential. `costUsd` rides
- * `media.vision:completed` (VIS-04 Route a — the image:generated cost-carry
+ * `media.vision:completed` (the image:generated cost-carry
  * precedent); it + `model` spread presence-conditionally (the registry/
- * gemini-video tiers return no cost — Pitfall 4 — so an absent value never
+ * gemini-video tiers return no cost, so an absent value never
  * appears as an `undefined` key).
  *
  * @module

package/node_modules/@comis/observability/dist/trajectory/translate-vision-payload.js

@@ -1,23 +1,23 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
  * Trajectory bridge payload translators for the vision-analysis
- * (`media.vision:*`) lifecycle (VIS-04, Phase 187).
+ * (`media.vision:*`) lifecycle.
  *
  * Extracted from `translate-payload.ts` (which is at the file-size cap) — the
  * main `translatePayload` switch delegates its three `media.vision:*` cases here.
- * BEHAVIOR-NEUTRAL move (Phase 196 file-size split): the returned shapes are
+ * BEHAVIOR-NEUTRAL move (file-size split): the returned shapes are
  * byte-identical to the previously-inline arms, pinned by the existing
  * `media.vision:*` arm tests in `translate-payload.test.ts` + the `never`
  * exhaustiveness check below. This is the EXACT precedent that produced
  * `translate-video-payload.ts`.
  *
- * CONTENT-FREE (T-187-12): each arm forwards ONLY content-free ids / labels /
+ * CONTENT-FREE: each arm forwards ONLY content-free ids / labels /
  * the `path` / numbers / `outcome` / `errorKind` and STRIPS the envelope
  * (`agentId` / `sessionKey` / `timestamp`) — NEVER the image bytes, the analysis
  * prompt, the model's answer, or a credential. `costUsd` rides
- * `media.vision:completed` (VIS-04 Route a — the image:generated cost-carry
+ * `media.vision:completed` (the image:generated cost-carry
  * precedent); it + `model` spread presence-conditionally (the registry/
- * gemini-video tiers return no cost — Pitfall 4 — so an absent value never
+ * gemini-video tiers return no cost, so an absent value never
  * appears as an `undefined` key).
  *
  * @module