@sema-agent/core 7.5.2 → 7.6.1

package/dist/core/runner/terminal-projection.d.ts

@@ -0,0 +1,22 @@
+import type { CheckpointGate, CheckpointToken } from "../checkpoint-store.js";
+import type { TaskResult, TaskStatus, TerminalCause } from "../types.js";
+/** The plane words a {@link TerminalCause} reads as — one derivation, called by the faces that speak
+ *  them. The paused arm's `status` is its gate kind's registry row (`suspended` for an approval,
+ *  a resource slice or a platform pause; `needs_review` for a plan or dry-run review, which also
+ *  carries the `review.pending` code the review consumers key on). */
+export declare function terminalProjection(terminal: TerminalCause): {
+    status: TaskStatus;
+    errorCode?: string;
+    errorMessage?: string;
+    blockedReason?: string;
+    checkpointToken?: CheckpointToken;
+    checkpointId?: string;
+    checkpointGate?: CheckpointGate;
+    workspaceRestoreMode?: "snapshot" | "park_only";
+};
+/**
+ * A compensation that changes WHY a settled result ended (a resume leg's approval reopened / could not
+ * be reopened) amends the CAUSE — the one record there is. The code fills only an empty seat (the leg's
+ * own terminal code, when it had one, still names the ending); the message is extended, not replaced.
+ */
+export declare function amendTerminal(result: TaskResult, code: string, message: (prior: string | undefined) => string): void;

package/dist/core/runner/terminal-projection.js

@@ -0,0 +1,28 @@
+import { PAUSE_REGISTRY } from "../pause-registry.js";
+export function terminalProjection(terminal) {
+    switch (terminal.kind) {
+        case "completed":
+            return { status: "completed" };
+        case "failed":
+            return { status: "failed", errorCode: terminal.code, errorMessage: terminal.message };
+        case "blocked":
+            return { status: "blocked", blockedReason: terminal.reason };
+        case "paused": {
+            const status = PAUSE_REGISTRY[terminal.gate.kind].taskStatus;
+            return {
+                status,
+                ...(status === "needs_review" ? { errorCode: "review.pending" } : {}),
+                checkpointToken: terminal.token,
+                checkpointId: terminal.checkpointId,
+                checkpointGate: terminal.gate,
+                workspaceRestoreMode: terminal.restoreMode,
+            };
+        }
+    }
+}
+export function amendTerminal(result, code, message) {
+    const t = result.terminal;
+    if (t.kind !== "failed")
+        return;
+    result.terminal = { ...t, code: t.code ?? code, message: message(t.message) };
+}