@tangle-network/browser-agent-driver 0.24.2 → 0.26.0

package/dist/runner/fan-out.js

@@ -0,0 +1,183 @@
+/**
+ * Gen 33 — mid-run parallel fan-out executor.
+ *
+ * When the agent emits a `fanOut` action in the middle of a run, this
+ * module spawns N sub-agents in fresh tabs of the same BrowserContext,
+ * runs them in parallel with bounded concurrency, collects their
+ * verdicts, and returns a formatted feedback string the parent runner
+ * injects back into the agent's next turn.
+ *
+ * Architecture:
+ *   - Same BrowserContext so cookies / localStorage / authenticated
+ *     session carry over to every branch
+ *   - Fresh Page per sub-agent so their DOM state doesn't collide with
+ *     the parent page
+ *   - PlaywrightDriver per sub-agent with showCursor OFF (the parent's
+ *     cursor overlay is the one the viewer sees; sub-tabs are invisible
+ *     to the recording)
+ *   - Hard cap of 8 concurrent sub-agents to prevent runaway spawning
+ *   - Each sub-agent times out at 60s × maxTurns(8) = 480s max; the
+ *     outer fanOut times out at 900s regardless
+ *   - Sub-agent failures are captured, never thrown to the parent —
+ *     the parent sees "BRANCH 3: error: …" as part of the structured
+ *     feedback and can choose to retry / ignore / incorporate
+ *
+ * This is different from Gen 21's parallel-runner.ts, which runs the
+ * ENTIRE run as parallel sub-goals decided up front. FanOut is called
+ * from inside a turn, with whatever sub-goals the agent synthesized on
+ * the fly from the current page's content.
+ */
+import { PlaywrightDriver } from '../drivers/playwright.js';
+import { BrowserAgent } from './runner.js';
+/** Hard cap on concurrent sub-agents. Beyond 8 is a footgun. */
+const MAX_CONCURRENT_SUBAGENTS = 8;
+/** Default max turns per sub-agent when the action doesn't specify. */
+const DEFAULT_SUB_MAX_TURNS = 8;
+/** Timeout budget for the whole fan-out, even if individual sub-agents are still running. */
+const FAN_OUT_TIMEOUT_MS = 900_000;
+/**
+ * Run a fanOut action. Returns structured per-branch results + a
+ * human-readable feedback string.
+ */
+export async function executeFanOut(action, opts) {
+    const startedAt = Date.now();
+    const subGoals = (action.subGoals ?? []).slice(0, MAX_CONCURRENT_SUBAGENTS);
+    if (subGoals.length === 0) {
+        return {
+            branches: [],
+            feedback: 'FAN-OUT ERROR: no subGoals specified.',
+            totalMs: 0,
+            tokensUsed: 0,
+        };
+    }
+    // Run all sub-agents concurrently. Every branch captures its own
+    // errors into the result record so one bad branch can't poison the
+    // whole fan-out.
+    const branches = await Promise.all(subGoals.map((sg, index) => runBranch(sg, index, opts))).catch((err) => {
+        // Shouldn't ever reach here — runBranch catches internally — but if
+        // Playwright throws a synchronous error from context.newPage we
+        // still want a structured shape back.
+        return subGoals.map((sg, index) => ({
+            index,
+            label: sg.label ?? `branch-${index + 1}`,
+            url: sg.url,
+            goal: sg.goal,
+            success: false,
+            verdict: `internal fan-out error: ${err.message}`,
+            turnsUsed: 0,
+            durationMs: 0,
+        }));
+    });
+    const totalMs = Date.now() - startedAt;
+    const tokensUsed = branches.reduce((s, b) => s + (b.tokensUsed ?? 0), 0);
+    return {
+        branches,
+        feedback: formatFeedback(branches, action.summarize),
+        totalMs,
+        tokensUsed,
+    };
+}
+async function runBranch(sg, index, opts) {
+    const label = sg.label ?? `branch-${index + 1}`;
+    const url = sg.url || opts.currentUrl || '';
+    const maxTurns = Math.max(1, Math.min(30, sg.maxTurns ?? DEFAULT_SUB_MAX_TURNS));
+    const startedAt = Date.now();
+    opts.onBranchStart?.(index, label);
+    let page;
+    try {
+        page = await opts.context.newPage();
+        const driver = new PlaywrightDriver(page, {
+            ...(opts.driverOptions ?? {}),
+            // Sub-tabs never show the cursor — the parent tab's overlay is
+            // the one the viewer sees. We don't want a phantom cursor fighting
+            // over which mouse position is "canonical" in the recording.
+            showCursor: false,
+        });
+        const subAgent = new BrowserAgent({
+            driver,
+            config: opts.config,
+            ...(opts.projectStore ? { projectStore: opts.projectStore } : {}),
+            ...(opts.macroPromptBlock ? { macroPromptBlock: opts.macroPromptBlock } : {}),
+        });
+        const scenario = {
+            goal: sg.goal,
+            startUrl: url,
+            maxTurns,
+        };
+        const perBranchTimeoutMs = Math.min(FAN_OUT_TIMEOUT_MS, 60_000 * maxTurns);
+        const result = await Promise.race([
+            subAgent.run(scenario),
+            new Promise((_, reject) => setTimeout(() => reject(new Error(`branch ${label} timed out after ${perBranchTimeoutMs}ms`)), perBranchTimeoutMs)),
+        ]);
+        const maybeTokens = result.totalTokensUsed;
+        const branchResult = {
+            index,
+            label,
+            url,
+            goal: sg.goal,
+            success: Boolean(result.success),
+            verdict: (result.reason ?? '').slice(0, 2000),
+            turnsUsed: result.turns?.length ?? 0,
+            durationMs: Date.now() - startedAt,
+            ...(typeof maybeTokens === 'number' ? { tokensUsed: maybeTokens } : {}),
+        };
+        opts.onBranchComplete?.(index, label, result);
+        return branchResult;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return {
+            index,
+            label,
+            url,
+            goal: sg.goal,
+            success: false,
+            verdict: `error: ${msg}`.slice(0, 2000),
+            turnsUsed: 0,
+            durationMs: Date.now() - startedAt,
+        };
+    }
+    finally {
+        if (page && !page.isClosed()) {
+            await page.close().catch(() => { });
+        }
+    }
+}
+/**
+ * Format branch results as a single human-readable feedback block the
+ * parent agent's Brain can consume on the next turn. JSON-serializable
+ * structure first (so the agent can parse verdicts mechanically), then
+ * a plaintext summary. The parent model is free to prefer either.
+ */
+export function formatFeedback(branches, summarize) {
+    const jsonPayload = branches.map((b) => ({
+        label: b.label,
+        success: b.success,
+        verdict: b.verdict,
+        turnsUsed: b.turnsUsed,
+        durationMs: b.durationMs,
+    }));
+    const lines = [];
+    lines.push(`FAN-OUT RESULTS (${branches.length} branches):`);
+    lines.push('```json');
+    lines.push(JSON.stringify(jsonPayload, null, 2));
+    lines.push('```');
+    if (summarize) {
+        lines.push('');
+        lines.push(`SUMMARIZATION HINT: ${summarize}`);
+    }
+    lines.push('');
+    lines.push('Branch details:');
+    for (const b of branches) {
+        const status = b.success ? '✓' : '✗';
+        lines.push(`  [${status}] ${b.label} (${b.turnsUsed} turns, ${Math.round(b.durationMs / 100) / 10}s): ${truncateOneLine(b.verdict, 200)}`);
+    }
+    return lines.join('\n');
+}
+function truncateOneLine(s, max) {
+    const oneLine = s.replace(/\s+/g, ' ').trim();
+    return oneLine.length > max ? oneLine.slice(0, max - 1) + '…' : oneLine;
+}
+/** Exposed for tests to pin the concurrency cap. */
+export const FAN_OUT_MAX_CONCURRENT = MAX_CONCURRENT_SUBAGENTS;
+//# sourceMappingURL=fan-out.js.map

package/dist/runner/fan-out.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fan-out.js","sourceRoot":"","sources":["../../src/runner/fan-out.ts"],"names":[],"mappings":"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"}

package/dist/runner/interrupt-controller.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Gen 32 — pause / resume / abort via keyboard in interactive runs.
+ *
+ * Registers a raw-mode stdin handler that maps three keys:
+ *
+ *   p   → pause the runner before the next turn
+ *   r   → resume a paused run
+ *   q   → abort (the same as Ctrl-C, but doesn't kill the TTY)
+ *
+ * The controller exposes a single `waitIfPaused()` the runner awaits at
+ * the top of every turn. When the user hits `p`, the next call blocks
+ * on a resume promise. On `r`, the promise resolves and the loop
+ * continues. On `q`, it throws an abort signal the runner treats as a
+ * graceful cancellation.
+ *
+ * Design notes:
+ *   - Raw mode only applies to a TTY. Non-interactive runs (CI,
+ *     `bad --cases ... --json`) never engage this controller.
+ *   - Keyboard capture is OPT-IN via `--interrupt`. Without it, the
+ *     stdin is untouched and this module is a no-op.
+ *   - Keyboard capture deliberately does NOT interfere with copy/paste
+ *     — we only listen for the specific bytes `p`, `r`, `q`, and let
+ *     everything else fall through unmodified.
+ */
+import { EventEmitter } from 'node:events';
+export declare class InterruptAborted extends Error {
+    constructor();
+}
+export interface InterruptControllerOptions {
+    /** stdin — overridable for tests. Default: process.stdin */
+    input?: NodeJS.ReadStream;
+    /** Called with user-facing status strings so the CLI can render them. */
+    onStatus?: (msg: string) => void;
+}
+export declare class InterruptController extends EventEmitter {
+    private paused;
+    private aborted;
+    private resumeResolvers;
+    private input;
+    private onStatus;
+    private attached;
+    private handler;
+    private prevRaw;
+    constructor(opts?: InterruptControllerOptions);
+    /**
+     * Start listening for keystrokes. Returns a detach function the
+     * caller MUST invoke when the run ends (even on error) — otherwise
+     * stdin stays in raw mode and the TTY is hosed.
+     */
+    attach(): () => void;
+    detach(): void;
+    /**
+     * Called from the runner at the top of each turn. If the run is paused,
+     * awaits resume. If aborted, throws `InterruptAborted`.
+     */
+    waitIfPaused(): Promise<void>;
+    /** Programmatically pause — useful from tests and SIGUSR1 handlers. */
+    pause(): void;
+    /** Programmatically resume. */
+    resume(): void;
+    /** Request a graceful abort. */
+    abort(): void;
+    get isPaused(): boolean;
+    get isAborted(): boolean;
+    private onKey;
+}
+//# sourceMappingURL=interrupt-controller.d.ts.map

package/dist/runner/interrupt-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interrupt-controller.d.ts","sourceRoot":"","sources":["../../src/runner/interrupt-controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C,qBAAa,gBAAiB,SAAQ,KAAK;;CAK1C;AAED,MAAM,WAAW,0BAA0B;IACzC,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACzB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CACjC;AAED,qBAAa,mBAAoB,SAAQ,YAAY;IACnD,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,eAAe,CAAwB;IAC/C,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,QAAQ,CAAqD;IACrE,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,OAAO,CAAyC;IACxD,OAAO,CAAC,OAAO,CAAQ;gBAEX,IAAI,GAAE,0BAA+B;IAMjD;;;;OAIG;IACH,MAAM,IAAI,MAAM,IAAI;IAYpB,MAAM,IAAI,IAAI;IAed;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAOnC,uEAAuE;IACvE,KAAK,IAAI,IAAI;IAOb,+BAA+B;IAC/B,MAAM,IAAI,IAAI;IASd,gCAAgC;IAChC,KAAK,IAAI,IAAI;IASb,IAAI,QAAQ,IAAI,OAAO,CAAuB;IAC9C,IAAI,SAAS,IAAI,OAAO,CAAwB;IAEhD,OAAO,CAAC,KAAK;CAYd"}

package/dist/runner/interrupt-controller.js

@@ -0,0 +1,142 @@
+/**
+ * Gen 32 — pause / resume / abort via keyboard in interactive runs.
+ *
+ * Registers a raw-mode stdin handler that maps three keys:
+ *
+ *   p   → pause the runner before the next turn
+ *   r   → resume a paused run
+ *   q   → abort (the same as Ctrl-C, but doesn't kill the TTY)
+ *
+ * The controller exposes a single `waitIfPaused()` the runner awaits at
+ * the top of every turn. When the user hits `p`, the next call blocks
+ * on a resume promise. On `r`, the promise resolves and the loop
+ * continues. On `q`, it throws an abort signal the runner treats as a
+ * graceful cancellation.
+ *
+ * Design notes:
+ *   - Raw mode only applies to a TTY. Non-interactive runs (CI,
+ *     `bad --cases ... --json`) never engage this controller.
+ *   - Keyboard capture is OPT-IN via `--interrupt`. Without it, the
+ *     stdin is untouched and this module is a no-op.
+ *   - Keyboard capture deliberately does NOT interfere with copy/paste
+ *     — we only listen for the specific bytes `p`, `r`, `q`, and let
+ *     everything else fall through unmodified.
+ */
+import { EventEmitter } from 'node:events';
+export class InterruptAborted extends Error {
+    constructor() {
+        super('run aborted by user (pressed q)');
+        this.name = 'InterruptAborted';
+    }
+}
+export class InterruptController extends EventEmitter {
+    paused = false;
+    aborted = false;
+    resumeResolvers = [];
+    input;
+    onStatus;
+    attached = false;
+    handler = (buf) => this.onKey(buf);
+    prevRaw = false;
+    constructor(opts = {}) {
+        super();
+        this.input = opts.input ?? process.stdin;
+        this.onStatus = opts.onStatus ?? (() => { });
+    }
+    /**
+     * Start listening for keystrokes. Returns a detach function the
+     * caller MUST invoke when the run ends (even on error) — otherwise
+     * stdin stays in raw mode and the TTY is hosed.
+     */
+    attach() {
+        if (this.attached)
+            return () => this.detach();
+        if (!this.input.isTTY)
+            return () => { };
+        this.prevRaw = this.input.isRaw;
+        this.input.setRawMode(true);
+        this.input.resume();
+        this.input.on('data', this.handler);
+        this.attached = true;
+        this.onStatus('interrupt keys: [p] pause · [r] resume · [q] abort');
+        return () => this.detach();
+    }
+    detach() {
+        if (!this.attached)
+            return;
+        try {
+            this.input.off('data', this.handler);
+            this.input.setRawMode(this.prevRaw);
+            if (!process.stdin.isTTY || !this.prevRaw) {
+                this.input.pause();
+            }
+        }
+        catch { /* best-effort on shutdown */ }
+        this.attached = false;
+        // Release any awaiters so the runner can unwind.
+        for (const r of this.resumeResolvers)
+            r();
+        this.resumeResolvers = [];
+    }
+    /**
+     * Called from the runner at the top of each turn. If the run is paused,
+     * awaits resume. If aborted, throws `InterruptAborted`.
+     */
+    async waitIfPaused() {
+        if (this.aborted)
+            throw new InterruptAborted();
+        if (!this.paused)
+            return;
+        await new Promise((resolve) => this.resumeResolvers.push(resolve));
+        if (this.aborted)
+            throw new InterruptAborted();
+    }
+    /** Programmatically pause — useful from tests and SIGUSR1 handlers. */
+    pause() {
+        if (this.paused || this.aborted)
+            return;
+        this.paused = true;
+        this.emit('pause');
+        this.onStatus('⏸  paused — press [r] to resume or [q] to abort');
+    }
+    /** Programmatically resume. */
+    resume() {
+        if (!this.paused || this.aborted)
+            return;
+        this.paused = false;
+        this.emit('resume');
+        this.onStatus('▶  resumed');
+        for (const r of this.resumeResolvers)
+            r();
+        this.resumeResolvers = [];
+    }
+    /** Request a graceful abort. */
+    abort() {
+        if (this.aborted)
+            return;
+        this.aborted = true;
+        this.emit('abort');
+        this.onStatus('■  aborting — run will stop at the end of this turn');
+        for (const r of this.resumeResolvers)
+            r();
+        this.resumeResolvers = [];
+    }
+    get isPaused() { return this.paused; }
+    get isAborted() { return this.aborted; }
+    onKey(buf) {
+        // Match a single byte for p/r/q; fall through for everything else.
+        // Ctrl-C (0x03) from raw mode — forward as abort, else the process stays alive.
+        if (buf.length === 1 && buf[0] === 0x03) {
+            this.abort();
+            return;
+        }
+        const ch = buf.toString('utf-8');
+        if (ch === 'p' || ch === 'P')
+            this.pause();
+        else if (ch === 'r' || ch === 'R')
+            this.resume();
+        else if (ch === 'q' || ch === 'Q')
+            this.abort();
+    }
+}
+//# sourceMappingURL=interrupt-controller.js.map

package/dist/runner/interrupt-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interrupt-controller.js","sourceRoot":"","sources":["../../src/runner/interrupt-controller.ts"],"names":[],"mappings":"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"}

package/dist/runner/overlay-narration.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Gen 32 — agent narration hooks for the cursor overlay.
+ *
+ * The runner emits `decide-completed` each turn with the LLM's raw
+ * reasoning text. That text carries three distinct signals the overlay
+ * wants to surface to a viewer:
+ *
+ *   1. **Current step** — a short phrase summarizing what the agent is
+ *      about to do. Extracted from the first sentence of `reasoning`.
+ *   2. **Progress** — turn N of maxTurns, plus any inline progress
+ *      ledger (`Done=[C-001, C-002, ...] Current=C-003`) the agent is
+ *      already using in OFAC/batch-style prompts.
+ *   3. **Verdict moments** — conclusions like "POSITIVE MATCH",
+ *      "CLEARED", "NEEDS REVIEW" that should fire a celebratory badge.
+ *
+ * These are pure functions — no I/O, no driver calls. The driver-facing
+ * hooks in runner.ts call them, then push results via
+ * `driver.setOverlayReasoning` / `setOverlayProgress` / `pushOverlayBadge`.
+ *
+ * Why a separate module: the runner is already 1500+ lines and dense;
+ * parsing logic belongs somewhere testable in isolation. Keeping this
+ * pure makes the overlay story auditable without standing up a browser.
+ */
+/**
+ * Pull the first sentence (or first ~140 chars) of reasoning as a
+ * display summary. The reasoning panel renders the full text; this is a
+ * hook for callers that want a preview (e.g., badge text).
+ */
+export declare function summarizeReasoning(reasoning: string | undefined): string;
+/**
+ * Parse a "Current=C-XXX" marker from the reasoning, if present. Used to
+ * enrich the progress label ("Turn 27 · C-003"). Returns undefined when
+ * the reasoning doesn't carry a ledger marker — NOT every run uses the
+ * ledger shape.
+ */
+export declare function extractCurrentMarker(reasoning: string | undefined): string | undefined;
+/**
+ * Parse a "Done=[...]" ledger from reasoning. Returns the count of
+ * completed items, or undefined when no ledger exists. Used to compute
+ * a second progress indicator (items done vs items total) orthogonal to
+ * turn-of-maxTurns.
+ */
+export declare function extractDoneCount(reasoning: string | undefined): number | undefined;
+export interface VerdictEvent {
+    kind: 'positive' | 'cleared' | 'review';
+    text: string;
+    /** Raw verdict substring so we can dedupe later in the session */
+    marker: string;
+}
+/**
+ * Scan reasoning + action text for new verdict-worthy moments. Returns
+ * an array (possibly empty) of events the driver should surface as
+ * badges. The caller is responsible for deduplication across turns —
+ * this function returns ALL verdict markers visible in the text.
+ *
+ * For a reasoning string like:
+ *   "C-003 PUTIN VLADIMIR: POSITIVE MATCH — Russia-EO14024 / SDN"
+ * emits: { kind: 'positive', text: 'C-003 PUTIN VLADIMIR · POSITIVE MATCH', marker: 'C-003:POSITIVE MATCH' }
+ */
+export declare function detectVerdicts(reasoning: string | undefined): VerdictEvent[];
+/**
+ * Stateful tracker that holds the set of verdict markers already
+ * surfaced this session, so we don't re-emit the same badge every turn
+ * for a verdict the agent keeps mentioning in its progress ledger.
+ */
+export declare class VerdictTracker {
+    private seen;
+    /**
+     * Given new reasoning text, return only the verdicts that are NEW
+     * (haven't been emitted before in this session).
+     */
+    accept(reasoning: string | undefined): VerdictEvent[];
+    reset(): void;
+}
+/**
+ * Build the progress label shown in the top-left chip of the overlay.
+ * Combines turn counter with an optional ledger marker.
+ *
+ *   buildProgressLabel(5, 65) → "Turn 5 · 65 max"
+ *   buildProgressLabel(5, 65, 'C-003') → "Turn 5 · C-003"
+ */
+export declare function buildProgressLabel(turn: number, maxTurns: number, marker?: string): string;
+//# sourceMappingURL=overlay-narration.d.ts.map

package/dist/runner/overlay-narration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-narration.d.ts","sourceRoot":"","sources":["../../src/runner/overlay-narration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAQH;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAQxE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAKtF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAQlF;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAA;IACvC,IAAI,EAAE,MAAM,CAAA;IACZ,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,EAAE,CA2C5E;AAED;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,IAAI,CAAoB;IAEhC;;;OAGG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,EAAE;IAWrD,KAAK,IAAI,IAAI;CAGd;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAGR"}

package/dist/runner/overlay-narration.js

@@ -0,0 +1,172 @@
+/**
+ * Gen 32 — agent narration hooks for the cursor overlay.
+ *
+ * The runner emits `decide-completed` each turn with the LLM's raw
+ * reasoning text. That text carries three distinct signals the overlay
+ * wants to surface to a viewer:
+ *
+ *   1. **Current step** — a short phrase summarizing what the agent is
+ *      about to do. Extracted from the first sentence of `reasoning`.
+ *   2. **Progress** — turn N of maxTurns, plus any inline progress
+ *      ledger (`Done=[C-001, C-002, ...] Current=C-003`) the agent is
+ *      already using in OFAC/batch-style prompts.
+ *   3. **Verdict moments** — conclusions like "POSITIVE MATCH",
+ *      "CLEARED", "NEEDS REVIEW" that should fire a celebratory badge.
+ *
+ * These are pure functions — no I/O, no driver calls. The driver-facing
+ * hooks in runner.ts call them, then push results via
+ * `driver.setOverlayReasoning` / `setOverlayProgress` / `pushOverlayBadge`.
+ *
+ * Why a separate module: the runner is already 1500+ lines and dense;
+ * parsing logic belongs somewhere testable in isolation. Keeping this
+ * pure makes the overlay story auditable without standing up a browser.
+ */
+const VERDICT_PATTERNS = [
+    { re: /\bPOSITIVE\s+MATCH\b/i, kind: 'positive' },
+    { re: /\bCLEARED\b/i, kind: 'cleared' },
+    { re: /\bNEEDS\s+REVIEW\b/i, kind: 'review' },
+];
+/**
+ * Pull the first sentence (or first ~140 chars) of reasoning as a
+ * display summary. The reasoning panel renders the full text; this is a
+ * hook for callers that want a preview (e.g., badge text).
+ */
+export function summarizeReasoning(reasoning) {
+    if (!reasoning)
+        return '';
+    const collapsed = reasoning.replace(/\s+/g, ' ').trim();
+    if (!collapsed)
+        return '';
+    // Cut at sentence boundary if short; otherwise hard-truncate.
+    const firstSentence = collapsed.match(/^(.+?[.!?])\s/);
+    if (firstSentence && firstSentence[1].length <= 180)
+        return firstSentence[1];
+    return collapsed.length > 180 ? collapsed.slice(0, 177).trimEnd() + '…' : collapsed;
+}
+/**
+ * Parse a "Current=C-XXX" marker from the reasoning, if present. Used to
+ * enrich the progress label ("Turn 27 · C-003"). Returns undefined when
+ * the reasoning doesn't carry a ledger marker — NOT every run uses the
+ * ledger shape.
+ */
+export function extractCurrentMarker(reasoning) {
+    if (!reasoning)
+        return undefined;
+    const m = reasoning.match(/Current\s*=\s*([A-Za-z0-9][\w-]*)/);
+    if (m)
+        return m[1];
+    return undefined;
+}
+/**
+ * Parse a "Done=[...]" ledger from reasoning. Returns the count of
+ * completed items, or undefined when no ledger exists. Used to compute
+ * a second progress indicator (items done vs items total) orthogonal to
+ * turn-of-maxTurns.
+ */
+export function extractDoneCount(reasoning) {
+    if (!reasoning)
+        return undefined;
+    const m = reasoning.match(/Done\s*=\s*\[([^\]]*)\]/);
+    if (!m)
+        return undefined;
+    const body = m[1].trim();
+    if (!body)
+        return 0;
+    // Count comma-separated entries, tolerate trailing commas
+    return body.split(',').filter((s) => s.trim().length > 0).length;
+}
+/**
+ * Scan reasoning + action text for new verdict-worthy moments. Returns
+ * an array (possibly empty) of events the driver should surface as
+ * badges. The caller is responsible for deduplication across turns —
+ * this function returns ALL verdict markers visible in the text.
+ *
+ * For a reasoning string like:
+ *   "C-003 PUTIN VLADIMIR: POSITIVE MATCH — Russia-EO14024 / SDN"
+ * emits: { kind: 'positive', text: 'C-003 PUTIN VLADIMIR · POSITIVE MATCH', marker: 'C-003:POSITIVE MATCH' }
+ */
+export function detectVerdicts(reasoning) {
+    if (!reasoning)
+        return [];
+    const out = [];
+    // Case: inline customer-ID prefix (OFAC-style)
+    //   "C-003 confirmed POSITIVE MATCH" / "C-003: CLEARED"
+    // Trailer is comma-bounded so enumerations like
+    //   "C-001 POSITIVE MATCH, C-002 CLEARED, C-003 NEEDS REVIEW"
+    // yield one event per customer, not one event for the whole line.
+    const inlineRe = /\b([A-Z]-\d{3,4})[^\w]{1,6}([^.,\n]*?(?:POSITIVE\s+MATCH|CLEARED|NEEDS\s+REVIEW)[^.,\n]*)/gi;
+    let m;
+    const seenInText = new Set();
+    while ((m = inlineRe.exec(reasoning)) !== null) {
+        const cid = m[1];
+        const snippet = m[2].replace(/\s+/g, ' ').trim();
+        const kind = snippet.match(/POSITIVE/i) ? 'positive' : snippet.match(/CLEARED/i) ? 'cleared' : 'review';
+        const marker = `${cid}:${kind.toUpperCase()}`;
+        // Dedupe within a single reasoning string — agent may restate
+        // "C-001 POSITIVE" later in the same line without intending a new event.
+        if (seenInText.has(marker))
+            continue;
+        seenInText.add(marker);
+        const shortSnippet = snippet.length > 60 ? snippet.slice(0, 57) + '…' : snippet;
+        out.push({
+            kind,
+            text: `${cid} · ${shortSnippet}`,
+            marker,
+        });
+    }
+    // Fallback: bare verdict without customer ID. Only emit ONE per reasoning
+    // string in this mode (multiple would be noise without context).
+    if (out.length === 0) {
+        for (const pat of VERDICT_PATTERNS) {
+            const vm = reasoning.match(pat.re);
+            if (vm) {
+                out.push({
+                    kind: pat.kind,
+                    text: vm[0].replace(/\s+/g, ' ').trim().toUpperCase(),
+                    marker: pat.kind.toUpperCase(),
+                });
+                break;
+            }
+        }
+    }
+    return out;
+}
+/**
+ * Stateful tracker that holds the set of verdict markers already
+ * surfaced this session, so we don't re-emit the same badge every turn
+ * for a verdict the agent keeps mentioning in its progress ledger.
+ */
+export class VerdictTracker {
+    seen = new Set();
+    /**
+     * Given new reasoning text, return only the verdicts that are NEW
+     * (haven't been emitted before in this session).
+     */
+    accept(reasoning) {
+        const found = detectVerdicts(reasoning);
+        const fresh = [];
+        for (const v of found) {
+            if (this.seen.has(v.marker))
+                continue;
+            this.seen.add(v.marker);
+            fresh.push(v);
+        }
+        return fresh;
+    }
+    reset() {
+        this.seen.clear();
+    }
+}
+/**
+ * Build the progress label shown in the top-left chip of the overlay.
+ * Combines turn counter with an optional ledger marker.
+ *
+ *   buildProgressLabel(5, 65) → "Turn 5 · 65 max"
+ *   buildProgressLabel(5, 65, 'C-003') → "Turn 5 · C-003"
+ */
+export function buildProgressLabel(turn, maxTurns, marker) {
+    if (marker)
+        return `Turn ${turn} · ${marker}`;
+    return `Turn ${turn} / ${maxTurns}`;
+}
+//# sourceMappingURL=overlay-narration.js.map