@yaag/tui 0.1.4 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yaag/tui",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "publishConfig": {
     "access": "public"
   },
@@ -19,6 +19,6 @@
   },
   "dependencies": {
     "@earendil-works/pi-tui": "^0.84.0",
-    "@yaag/runtime": "0.1.4"
+    "@yaag/runtime": "0.2.0"
   }
 }

package/src/snapshot-render.ts

@@ -1,3 +1,4 @@
+import type { RunSummary } from "@yaag/runtime";
 import { compactAgentLine, compactHeaderLine } from "./compact-render.ts";
 import { renderNodeTable } from "./node-table.ts";
 import { sanitizeTerminalLine } from "./terminal-text.ts";
@@ -16,9 +17,10 @@ export interface SnapshotRenderOptions {
 }
 
 /**
- * Renders the model-facing snapshot frame: one Run header line, then one line
- * per Agent with that Agent's Nested Node table, then the Result block when
- * the Run settled with a value.
+ * Renders the model-facing snapshot frame: one Run header line, one warning
+ * line when the Run lost its Checkpoint, then one line per Agent with that
+ * Agent's Nested Node table, then the Result block when the Run settled with a
+ * value.
  *
  * It draws no key footer and reads no input, so every line is content a model
  * can parse. Pure over the state; every untrusted string is sanitized and
@@ -30,6 +32,8 @@ export function renderSnapshot(
 ): readonly string[] {
   const header = { now: options.now, width: options.width, ...labelOf(options) };
   const lines: string[] = [compactHeaderLine(state, header)];
+  const warning = checkpointLostLine(state.summary, options.width);
+  if (warning !== undefined) lines.push(warning);
   const agents = buildTree(state, { now: options.now });
   const names = state.agentOrder.filter((name) => state.summary.agents[name] !== undefined);
   agents.forEach((agent, index) => {
@@ -46,6 +50,15 @@ export function renderSnapshot(
   ];
 }
 
+/**
+ * One warning line for a Run that asked for a Checkpoint and lost it. The Run's
+ * own error is reported elsewhere; this line reports only the missing artifact.
+ */
+function checkpointLostLine(summary: RunSummary, width: number): string | undefined {
+  if (summary.runState !== "ended" || summary.checkpointLost === undefined) return undefined;
+  return clamp(sanitizeTerminalLine(`! checkpoint lost: ${summary.checkpointLost}`), width);
+}
+
 function labelOf(options: SnapshotRenderOptions): { readonly label?: string } {
   return options.label === undefined ? {} : { label: options.label };
 }