waygraph 0.15.37 → 0.15.38

package/dist/auto-session/session.d.ts

@@ -72,6 +72,8 @@ export declare class AutoSession {
      * fallback when a Block's own `resolve()` doesn't set `__state` - same
      * behavior `applyPick` always had, just factored out, not changed.
      */
+    /** Paint + log a Block's authored waygraph overlay fixtures (same as demo does), best-effort. */
+    private paintStubPhase;
     private runNamedBlock;
     /** Applies exactly one pick: runs at most one Block, returns the resulting state. */
     applyPick(raw: string): Promise<ApplyPickResult>;

package/dist/auto-session/session.js

@@ -1,12 +1,13 @@
 // Split out of the former 1,078-line auto-session.ts (see src/ARCHITECTURE.md). Behavior unchanged.
 import { CONSOLE_LOG_MAX_ENTRIES, FULL_MODE_DEFAULT_DEPTH, FULL_MODE_MAX_NODES, FULL_MODE_MAX_TEXT_LENGTH, TRACE_MAX_STEPS, buildSessionSnapshot, parsePick, stubFilePath, stubPhaseHasContent, walkFullDom } from "./helpers.js";
-import { instrumentPilotActions, installPersistentPilotOverlay, showPilotActivity, showPilotFixtures, showPilotVision, updatePilotOverlay } from "../pilot-overlay.js";
+import { instrumentPilotActions, installPersistentPilotOverlay, showPilotActivity, showPilotFixtures, showPilotVision, phaseToOverlayFixtures, describeOverlayFixtures, updatePilotOverlay } from "../pilot-overlay.js";
 import { buildExploreContext, buildExploreMenu } from "../auto-explore.js";
 import { MemPage } from "../mem-page.js";
 import { Engine } from "../engine.js";
 import { detectHere, ensureLivePage, ensureMem, resolveBaseUrl, runOneBlock, seedDefaultMem } from "../auto-explore-run.js";
 import { collectKnownInteractionSelectors, unmappedInteractionsPageScript } from "../coverage-gap.js";
 import { runStubPhase } from "../highlights.js";
+import { verboseLog } from "../verbose-log.js";
 import { findBlockPathDetailed } from "../graph.js";
 /**
  * Non-interactive explore session: same graph/library/mem/browser setup
@@ -328,9 +329,19 @@ export class AutoSession {
      * fallback when a Block's own `resolve()` doesn't set `__state` - same
      * behavior `applyPick` always had, just factored out, not changed.
      */
+    /** Paint + log a Block's authored waygraph overlay fixtures (same as demo does), best-effort. */
+    async paintStubPhase(tag, phase, holdMs) {
+        if (!this.page || !stubPhaseHasContent(phase))
+            return;
+        const fixtures = phaseToOverlayFixtures(phase, holdMs);
+        for (const line of describeOverlayFixtures(tag, fixtures))
+            verboseLog("pilot", line);
+        await showPilotFixtures(this.page, fixtures).catch(() => { });
+    }
     async runNamedBlock(entry, expectedTo, instanceOption) {
         const from = this.here;
         const stubBeforeResult = await runStubPhase(entry.block, "stubBefore");
+        await this.paintStubPhase("stub.before", stubBeforeResult, 6000);
         const stepBase = {
             block: entry.block.name,
             from,
@@ -348,6 +359,7 @@ export class AutoSession {
             this.here = result.__state ?? expectedTo;
             this.lastRunNote = `${entry.block.name} -> ${this.here}`;
             const stubAfterResult = await runStubPhase(entry.block, "stubAfter", { out: result });
+            await this.paintStubPhase("stub.after", stubAfterResult, 6000);
             this.pushTrace({
                 ...stepBase,
                 to: this.here,
@@ -358,6 +370,7 @@ export class AutoSession {
             this.lastRunNote = `${entry.block.name} failed`;
             const message = err instanceof Error ? err.message : String(err);
             const stubOnErrorResult = await runStubPhase(entry.block, "stubOnError", { error: err });
+            await this.paintStubPhase("stub.error", stubOnErrorResult, 8000);
             this.pushTrace({
                 ...stepBase,
                 error: message,
@@ -588,6 +601,8 @@ export class AutoSession {
         // Same bottom-left activity toast as Running (Dom)/(Block) - agent narration.
         await showPilotActivity(this.page, `Highlighting: ${detail}`);
         try {
+            for (const line of describeOverlayFixtures("highlight", fixtures))
+                verboseLog("pilot", line);
             const { painted, missing } = await showPilotFixtures(this.page, fixtures);
             const menu = await this.currentMenu();
             this.lastRunNote = fixtures.clear

package/dist/pilot-overlay/overlay-fixtures.d.ts

@@ -7,3 +7,12 @@ import type { PilotHighlightFixtures } from "./fixtures.js";
  * Not Playwright test fixtures - these describe what the waygraph overlay paints on the page under test.
  */
 export declare function overlayFixturesToPhase(f: PilotHighlightFixtures): Promise<StubPhaseResult>;
+/**
+ * The reverse: a resolved stub phase (what `runStubPhase` returns for a Block's stubBefore/After/OnError)
+ * -> what the Pilot painter takes. Lets `auto/browser/pilot send` paint a Block's authored waygraph overlay
+ * fixtures (rings, todos, device, zoom, title/banner) the way `waygraph demo` does, instead of only recording
+ * them in the trace.
+ */
+export declare function phaseToOverlayFixtures(phase: StubPhaseResult, holdMs?: number): PilotHighlightFixtures;
+/** One verbose line per authored overlay fixture - same wording on every surface so a log reader (or an AI with no eyes) can tell what was painted. */
+export declare function describeOverlayFixtures(tag: string, f: PilotHighlightFixtures): string[];

package/dist/pilot-overlay/overlay-fixtures.js

@@ -43,3 +43,63 @@ export async function overlayFixturesToPhase(f) {
     };
     return runStubPhase({ name: "overlay-fixtures", stubBefore: lifecycle }, "stubBefore");
 }
+/**
+ * The reverse: a resolved stub phase (what `runStubPhase` returns for a Block's stubBefore/After/OnError)
+ * -> what the Pilot painter takes. Lets `auto/browser/pilot send` paint a Block's authored waygraph overlay
+ * fixtures (rings, todos, device, zoom, title/banner) the way `waygraph demo` does, instead of only recording
+ * them in the trace.
+ */
+export function phaseToOverlayFixtures(phase, holdMs = 6000) {
+    const items = phase.todoDock?.groups[0]?.items ?? phase.todos;
+    const idx = items.findIndex((t) => t.current) >= 0 ? items.findIndex((t) => t.current) : items.findIndex((t) => !t.done);
+    return {
+        rings: phase.highlights.map((h) => ({
+            selector: h.selector,
+            label: h.label ?? "",
+            ...(h.detail ? { detail: h.detail } : {}),
+            ...(h.tag ? { tag: h.tag } : {}),
+            ...(h.tone ? { tone: h.tone } : {}),
+            ...(h.size ? { size: h.size } : {}),
+            ...(h.weight ? { weight: h.weight } : {}),
+            ...(h.color ? { color: h.color } : {}),
+            ...(h.zoom !== undefined ? { zoom: h.zoom } : {}),
+            ...(h.zoomOut !== undefined ? { zoomOut: h.zoomOut } : {}),
+            ...(h.focus ? { focus: true } : {}),
+        })),
+        ...(phase.todoSync === "set" && items.length
+            ? {
+                todos: items.map((t) => t.text),
+                todoIndex: idx < 0 ? items.length : idx,
+                ...(phase.todoDock?.groups[0]?.title ? { todoTitle: phase.todoDock.groups[0].title } : {}),
+                ...(phase.todoPos ? { todoPos: phase.todoPos } : {}),
+            }
+            : {}),
+        ...(phase.todoDockUi ? { todoDockUi: phase.todoDockUi } : {}),
+        ...(phase.deviceSync === "set" && phase.device ? { device: phase.device } : {}),
+        ...(phase.zoom !== undefined ? { zoom: phase.zoom } : {}),
+        ...(phase.zoomOut !== undefined ? { zoomOut: phase.zoomOut } : {}),
+        ...(phase.title ? { title: phase.title } : {}),
+        ...(phase.titlePos ? { titlePos: phase.titlePos } : {}),
+        ...(phase.bannerUi ? { bannerUi: phase.bannerUi } : {}),
+        holdMs,
+    };
+}
+/** One verbose line per authored overlay fixture - same wording on every surface so a log reader (or an AI with no eyes) can tell what was painted. */
+export function describeOverlayFixtures(tag, f) {
+    const out = [];
+    if (f.title)
+        out.push(`${tag} ctx.title(${JSON.stringify(f.title)})${f.titlePos ? ` pos=${f.titlePos}` : ""}`);
+    if (f.bannerUi)
+        out.push(`${tag} ctx.bannerUi(${JSON.stringify(f.bannerUi)})`);
+    if (f.todos?.length)
+        out.push(`${tag} ctx.todos n=${f.todos.length} index=${f.todoIndex ?? 0}${f.todoPos ? ` pos=${f.todoPos}` : ""}`);
+    if (f.todoDockUi ?? f.todoUi)
+        out.push(`${tag} ctx.todoDockUi(${JSON.stringify(f.todoDockUi ?? f.todoUi)})`);
+    if (f.device)
+        out.push(`${tag} ctx.device(${typeof f.device === "string" ? f.device : f.device.preset ?? "custom"})`);
+    if (f.zoom)
+        out.push(`${tag} ctx.zoom(${f.zoom})`);
+    for (const r of f.rings ?? [])
+        out.push(`${tag} ring ${r.selector} tone=${r.tone ?? "planned"} label=${JSON.stringify(r.label)}`);
+    return out;
+}

package/examples/saucedemo/.waygraph-auto/2b831907.log

@@ -0,0 +1,6 @@
+[21:45:47.529] waygraph pilot: stub.before ctx.title("Signing in · mobile")
+[21:45:47.529] waygraph pilot: stub.before ctx.todos n=6 index=0
+[21:45:47.529] waygraph pilot: stub.before ctx.device(mobile)
+[21:45:47.529] waygraph pilot: stub.before ctx.zoom(1.35)
+[21:45:47.529] waygraph pilot: stub.before ring #user-name tone=info label="Username"
+[21:45:47.633] waygraph pilot: stub.after ctx.todos n=6 index=1

package/examples/saucedemo/.waygraph-auto/3c1e5fe0.log

@@ -0,0 +1,22 @@
+[21:46:29.741] waygraph pilot: stub.before ctx.title("Signing in · mobile")
+[21:46:29.741] waygraph pilot: stub.before ctx.todos n=6 index=0
+[21:46:29.741] waygraph pilot: stub.before ctx.device(mobile)
+[21:46:29.741] waygraph pilot: stub.before ctx.zoom(1.35)
+[21:46:29.741] waygraph pilot: stub.before ring #user-name tone=info label="Username"
+[21:46:29.866] waygraph pilot: stub.after ctx.todos n=6 index=1
+[21:46:31.935] waygraph pilot: stub.before ring #password tone=planned label="Password"
+[21:46:31.998] waygraph pilot: stub.after ctx.todos n=6 index=2
+[21:46:33.773] waygraph pilot: stub.before ring #login-button tone=warning label="Login"
+[21:46:33.961] waygraph pilot: stub.after ctx.title("Inventory · landscape")
+[21:46:33.961] waygraph pilot: stub.after ctx.todos n=6 index=3
+[21:46:33.961] waygraph pilot: stub.after ctx.device(mobile)
+[21:46:33.961] waygraph pilot: stub.after ring .inventory_list tone=success label="Product shelf"
+[21:46:37.277] waygraph pilot: stub.before ctx.title("Pick a product · tablet")
+[21:46:37.277] waygraph pilot: stub.before ctx.todos n=6 index=3
+[21:46:37.277] waygraph pilot: stub.before ctx.device(tablet)
+[21:46:37.277] waygraph pilot: stub.before ctx.zoom(1.35)
+[21:46:37.277] waygraph pilot: stub.before ring div.inventory_item:has(button[data-test="add-to-cart-sauce-labs-backpack"], button[data-test="remove-sauce-labs-backpack"]) .inventory_item_name tone=info label="Sauce Labs Backpack"
+[21:46:37.277] waygraph pilot: stub.before ring [data-test="add-to-cart-sauce-labs-backpack"] tone=success label="Add to cart"
+[21:46:37.375] waygraph pilot: stub.after ctx.title("In the cart")
+[21:46:37.376] waygraph pilot: stub.after ctx.todos n=6 index=4
+[21:46:37.376] waygraph pilot: stub.after ring .shopping_cart_badge tone=success label="Cart badge"

package/examples/saucedemo/.waygraph-auto/7b226350.log

@@ -0,0 +1,5 @@
+[21:46:10.717] waygraph pilot: highlight ctx.todos n=3 index=0
+[21:46:10.717] waygraph pilot: highlight ring #user-name tone=planned label="Username"
+[21:46:10.717] waygraph pilot: highlight ring #password tone=info label="Password"
+[21:46:12.774] waygraph pilot: highlight ring #no-such-element-waygraph tone=danger label="Gone"
+[21:46:14.903] waygraph pilot: highlight ring #login-button tone=success label="Login"

package/examples/saucedemo/.waygraph-auto/7effd5b2.log

@@ -0,0 +1,20 @@
+[21:46:24.561] waygraph pilot: stub.before ctx.title("Signing in · mobile")
+[21:46:24.562] waygraph pilot: stub.before ctx.todos n=6 index=0
+[21:46:24.562] waygraph pilot: stub.before ctx.device(mobile)
+[21:46:24.562] waygraph pilot: stub.before ctx.zoom(1.35)
+[21:46:24.562] waygraph pilot: stub.before ring #user-name tone=info label="Username"
+[21:46:24.751] waygraph pilot: stub.after ctx.todos n=6 index=1
+[21:46:25.895] waygraph pilot: stub.before ring #password tone=planned label="Password"
+[21:46:25.977] waygraph pilot: stub.after ctx.todos n=6 index=2
+[21:46:27.278] waygraph pilot: stub.before ring #login-button tone=warning label="Login"
+[21:46:27.476] waygraph pilot: stub.after ctx.title("Inventory · landscape")
+[21:46:27.476] waygraph pilot: stub.after ctx.todos n=6 index=3
+[21:46:27.476] waygraph pilot: stub.after ctx.device(mobile)
+[21:46:27.476] waygraph pilot: stub.after ring .inventory_list tone=success label="Product shelf"
+[21:46:28.988] waygraph pilot: stub.before ctx.title("Open cart · landscape")
+[21:46:28.988] waygraph pilot: stub.before ctx.todos n=6 index=5
+[21:46:28.988] waygraph pilot: stub.before ctx.device(mobile)
+[21:46:28.988] waygraph pilot: stub.before ctx.zoom(1.4)
+[21:46:28.988] waygraph pilot: stub.before ring .shopping_cart_link tone=planned label="Cart"
+[21:46:29.115] waygraph pilot: stub.after ctx.title("Your cart · desktop")
+[21:46:29.116] waygraph pilot: stub.after ring .cart_item tone=success label="Cart items"

package/examples/saucedemo/.waygraph-auto/9761c4c4.log

@@ -0,0 +1,6 @@
+[21:46:28.846] waygraph pilot: stub.before ctx.title("Signing in · mobile")
+[21:46:28.846] waygraph pilot: stub.before ctx.todos n=6 index=0
+[21:46:28.846] waygraph pilot: stub.before ctx.device(mobile)
+[21:46:28.847] waygraph pilot: stub.before ctx.zoom(1.35)
+[21:46:28.847] waygraph pilot: stub.before ring #user-name tone=info label="Username"
+[21:46:29.003] waygraph pilot: stub.after ctx.todos n=6 index=1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "waygraph",
-  "version": "0.15.37",
+  "version": "0.15.38",
   "type": "module",
   "description": "A typed graph of reusable Blocks for driving a browser through E2E flows.",
   "license": "MIT",