@vgai/sdk 0.5.18 → 0.5.20

package/package.json

@@ -2,7 +2,7 @@
   "name": "@vgai/sdk",
   "author": "Volter AI, Inc.",
   "license": "Apache-2.0",
-  "version": "0.5.18",
+  "version": "0.5.20",
   "type": "module",
   "repository": {
     "type": "git",
@@ -30,7 +30,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
-    "@vgai/engine": "0.5.18",
+    "@vgai/engine": "0.5.20",
     "playwright": "^1.58.2",
     "zod": "^4.3.6"
   }

package/src/project/session-journal.ts

@@ -102,6 +102,29 @@ export type SessionJournalEvent =
       readonly name: string | null;
       readonly logFile: string | null;
     }
+  /**
+   * A relayed command ran out of budget, and WHICH PLAY-BOOT STEP the page was
+   * inside when it did.
+   *
+   * The row exists because its absence was the defect. Measured 2026-08-20 at
+   * N=20000 on the canvas lane: `play` (120s), `screenshot` (15s) and `stop`
+   * (30s) all expired against a tab whose WORKER heartbeat kept beating at
+   * 0.4s, and the journal's whole account of it was three `command-result`
+   * lines saying "the tab is present … and did not respond" — true, and about
+   * the tab rather than the page. `phase` is the page's own last word before it
+   * went quiet (`editor/src/play-boot-phase.ts`); `null` means no play boot was
+   * in flight, which is itself an answer.
+   */
+  | {
+      readonly kind: 'play-stall';
+      readonly command: string;
+      readonly requestId8: string;
+      readonly phase: string | null;
+      /** How long the page had been in that phase. `null` with a null phase. */
+      readonly phaseAgeMs: number | null;
+      /** The budget the command actually waited out. */
+      readonly waitedMs: number;
+    }
   /**
    * THE TRANSPORT ARM. Everything below is one line per transport or
    * presence fact, and it exists because the journal was BLIND to all of
@@ -469,6 +492,14 @@ export function formatJournalLine(line: SessionJournalLine): string {
       return `journal: ${at} validation ${line.ok ? 'ok' : 'FAILED'} ${line.path}`;
     case 'play':
       return `journal: ${at} play ${line.action}${line.name === null ? '' : ` [${line.name}]`}`;
+    case 'play-stall':
+      return (
+        `journal: ${at} play-stall ${line.command} ${line.requestId8} after ` +
+        `${Math.round(line.waitedMs / 1000)}s — ` +
+        (line.phase === null
+          ? 'no play boot was in flight'
+          : `stuck in "${line.phase}" for ${Math.round((line.phaseAgeMs ?? 0) / 1000)}s`)
+      );
     case 'session-started':
       return `journal: ${at} session-started pid ${line.pid}`;
     case 'project-opened':