@tangle-network/browser-agent-driver 0.33.3 → 0.35.0

package/dist/runner/effect-verify.js

@@ -0,0 +1,42 @@
+/**
+ * Per-action effect verification: the helper the runner loop calls after each
+ * executed action to decide whether the expected effect actually landed.
+ *
+ * Extracted from runner.ts via the delegate + host-interface pattern. The
+ * BrowserAgent class keeps a thin delegator (`verifyEffect`); this free
+ * function holds the method body verbatim and reads runner state through
+ * {@link RunnerEffectVerifyHost}, which BrowserAgent `implements` so tsc proves
+ * the host surface is complete. Behavior is byte-identical to the inlined
+ * version — same settle-wait conditions, timing, and verifier call.
+ */
+import { verifyExpectedEffect } from './effect-verification.js';
+export async function verifyEffectImpl(self, expectedEffect, preActionState, actionType) {
+    // Only pause for actions that mutate the page in flight (navigation,
+    // clicks that may trigger XHR/route transitions, form submits). For
+    // pure reads, scrolls, hovers, and waits the page state is already
+    // settled by the time execute returns. The previous unconditional
+    // 100ms wait was pure dead time on every turn.
+    const needsSettleWait = actionType === 'click'
+        || actionType === 'navigate'
+        || actionType === 'press'
+        || actionType === 'select';
+    // Kick observe off immediately and let the settle wait race against it.
+    // observe() polls waitForLoadState internally, so the 50ms settle is
+    // really only there to let click handlers schedule their first XHR; we
+    // don't need to *block* on it before starting observe.
+    const observePromise = self.driver.observe().catch(() => preActionState);
+    if (needsSettleWait) {
+        await Promise.all([
+            observePromise,
+            new Promise(r => setTimeout(r, 50)),
+        ]);
+    }
+    const postState = await observePromise;
+    self.cachedPostState = postState;
+    return verifyExpectedEffect({
+        expectedEffect,
+        preActionState,
+        postActionState: postState,
+    });
+}
+//# sourceMappingURL=effect-verify.js.map

package/dist/runner/effect-verify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-verify.js","sourceRoot":"","sources":["../../src/runner/effect-verify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAahE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAA4B,EAC5B,cAAsB,EACtB,cAAyB,EACzB,UAA6B;IAE7B,qEAAqE;IACrE,oEAAoE;IACpE,mEAAmE;IACnE,kEAAkE;IAClE,+CAA+C;IAC/C,MAAM,eAAe,GAAG,UAAU,KAAK,OAAO;WACzC,UAAU,KAAK,UAAU;WACzB,UAAU,KAAK,OAAO;WACtB,UAAU,KAAK,QAAQ,CAAC;IAC7B,wEAAwE;IACxE,qEAAqE;IACrE,uEAAuE;IACvE,uDAAuD;IACvD,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,CAAC;IACzE,IAAI,eAAe,EAAE,CAAC;QACpB,MAAM,OAAO,CAAC,GAAG,CAAC;YAChB,cAAc;YACd,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;SACpC,CAAC,CAAC;IACL,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC;IACvC,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;IACjC,OAAO,oBAAoB,CAAC;QAC1B,cAAc;QACd,cAAc;QACd,eAAe,EAAE,SAAS;KAC3B,CAAC,CAAC;AACL,CAAC"}

package/dist/runner/execute-plan.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Deterministic plan execution: the runner loop's replan path hands a Plan to
+ * this helper, which drives each step through the driver and verifies the
+ * post-condition without re-entering the LLM between steps.
+ *
+ * Extracted from runner.ts via the delegate + host-interface pattern. The
+ * BrowserAgent class keeps a thin delegator (`executePlan`); this free function
+ * holds the method body verbatim and reads runner state through
+ * {@link RunnerExecuteHost}, which BrowserAgent `implements` so tsc proves the
+ * host surface is complete. Behavior is byte-identical to the inlined version —
+ * same ordering, event emissions, auto-pass list, verification thresholds, and
+ * fall-through reasons.
+ */
+import type { Driver } from '../drivers/types.js';
+import type { AgentConfig, PageState, Plan, Scenario, Turn } from '../types.js';
+import { RunState } from '../run-state.js';
+import type { TurnEventBus } from './events.js';
+/**
+ * The slice of runner state plan execution reads. The BrowserAgent class
+ * declares `implements RunnerExecuteHost`, so a missing or mistyped member is a
+ * compile error — this interface IS the safety gate for the extraction. All
+ * members are public on BrowserAgent by construction.
+ */
+export interface RunnerExecuteHost {
+    driver: Driver;
+    config: AgentConfig;
+    bus: TurnEventBus;
+    onTurn?: (turn: Turn) => void;
+    cachedPostState: PageState | undefined;
+}
+export declare function executePlanImpl(self: RunnerExecuteHost, plan: Plan, scenario: Scenario, runId: string, turns: Turn[], runState: RunState, startingTurnIndex: number, 
+/**
+ * Token usage from the Brain.plan() LLM call that produced this plan.
+ * The plan call's tokens are NOT attached to any per-step turn — there's
+ * one plan call per N steps. To make the run-level cost tally honest,
+ * we attribute the plan call to the FIRST step's Turn artifact so the
+ * downstream sum (in baseline-summary.json / report.json) reflects the
+ * real LLM spend.
+ */
+planCallTokens?: {
+    tokensUsed?: number;
+    inputTokens?: number;
+    outputTokens?: number;
+    cacheReadInputTokens?: number;
+    cacheCreationInputTokens?: number;
+}): Promise<{
+    kind: 'completed';
+    lastState: PageState;
+    finalResult?: string;
+    turnsConsumed: number;
+} | {
+    kind: 'deviated';
+    lastState: PageState;
+    failedStepIndex: number;
+    reason: string;
+    turnsConsumed: number;
+}>;
+//# sourceMappingURL=execute-plan.d.ts.map

package/dist/runner/execute-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-plan.d.ts","sourceRoot":"","sources":["../../src/runner/execute-plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAMhD;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,WAAW,CAAC;IACpB,GAAG,EAAE,YAAY,CAAC;IAClB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IAC9B,eAAe,EAAE,SAAS,GAAG,SAAS,CAAC;CACxC;AAED,wBAAsB,eAAe,CACnC,IAAI,EAAE,iBAAiB,EACvB,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,IAAI,EAAE,EACb,QAAQ,EAAE,QAAQ,EAClB,iBAAiB,EAAE,MAAM;AACzB;;;;;;;GAOG;AACH,cAAc,CAAC,EAAE;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,wBAAwB,CAAC,EAAE,MAAM,CAAA;CAClC,GACA,OAAO,CACN;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,SAAS,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GACxF;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,SAAS,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAC7G,CA2aA"}

package/dist/runner/execute-plan.js

@@ -0,0 +1,426 @@
+/**
+ * Deterministic plan execution: the runner loop's replan path hands a Plan to
+ * this helper, which drives each step through the driver and verifies the
+ * post-condition without re-entering the LLM between steps.
+ *
+ * Extracted from runner.ts via the delegate + host-interface pattern. The
+ * BrowserAgent class keeps a thin delegator (`executePlan`); this free function
+ * holds the method body verbatim and reads runner state through
+ * {@link RunnerExecuteHost}, which BrowserAgent `implements` so tsc proves the
+ * host surface is complete. Behavior is byte-identical to the inlined version —
+ * same ordering, event emissions, auto-pass list, verification thresholds, and
+ * fall-through reasons.
+ */
+import { hasPlaceholderPattern, isMeaningfulRunScriptOutput } from './completion-policy.js';
+import { pushGoalVerificationEvidence } from './utils.js';
+import { verifyExpectedEffect } from './effect-verification.js';
+export async function executePlanImpl(self, plan, scenario, runId, turns, runState, startingTurnIndex, 
+/**
+ * Token usage from the Brain.plan() LLM call that produced this plan.
+ * The plan call's tokens are NOT attached to any per-step turn — there's
+ * one plan call per N steps. To make the run-level cost tally honest,
+ * we attribute the plan call to the FIRST step's Turn artifact so the
+ * downstream sum (in baseline-summary.json / report.json) reflects the
+ * real LLM spend.
+ */
+planCallTokens) {
+    let currentTurnIndex = startingTurnIndex;
+    let lastState = turns[turns.length - 1]?.state
+        ?? { url: '', title: '', snapshot: '' };
+    // Track the last successful runScript output so placeholder complete
+    // results can be substituted with the real script output.
+    let lastRunScriptOutput = null;
+    // Track extractWithIndex matches for per-action fallback; the LLM must
+    // read the list and pick by index.
+    let lastExtractOutput = null;
+    for (let stepIdx = 0; stepIdx < plan.steps.length; stepIdx++) {
+        if (scenario.signal?.aborted) {
+            return {
+                kind: 'deviated',
+                lastState,
+                failedStepIndex: stepIdx,
+                reason: scenario.signal.reason || 'Cancelled',
+                turnsConsumed: stepIdx,
+            };
+        }
+        const step = plan.steps[stepIdx];
+        const stepStartedAt = Date.now();
+        const turnNumber = currentTurnIndex + 1;
+        currentTurnIndex++;
+        // Refresh the snapshot before EVERY step. The plan was built from a
+        // single observe() call at turn 1; later steps may target a different
+        // page entirely (after navigate / click "Next"). The first observe
+        // here is also what verify-against will eventually consume.
+        const preStepState = await self.driver.observe().catch(() => lastState);
+        lastState = preStepState;
+        // Wrap each plan step in a Turn artifact so post-run analysis (the
+        // viewer, the events.jsonl persistence, the metrics) sees a unified
+        // timeline regardless of whether the runner used the planner or the
+        // per-action loop.
+        //
+        // Token attribution: the first step carries the Brain.plan() LLM call's
+        // token usage so run-level cost includes planning.
+        const isFirstStep = stepIdx === 0;
+        const turn = {
+            turn: turnNumber,
+            state: preStepState,
+            action: step.action,
+            reasoning: step.rationale ?? `Plan step ${stepIdx + 1}/${plan.steps.length}`,
+            expectedEffect: step.expectedEffect,
+            plan: plan.steps.map((s) => s.rationale ?? s.action.action),
+            currentStep: stepIdx,
+            durationMs: 0,
+            ...(isFirstStep && planCallTokens?.tokensUsed !== undefined ? { tokensUsed: planCallTokens.tokensUsed } : {}),
+            ...(isFirstStep && planCallTokens?.inputTokens !== undefined ? { inputTokens: planCallTokens.inputTokens } : {}),
+            ...(isFirstStep && planCallTokens?.outputTokens !== undefined ? { outputTokens: planCallTokens.outputTokens } : {}),
+            ...(isFirstStep && planCallTokens?.cacheReadInputTokens !== undefined ? { cacheReadInputTokens: planCallTokens.cacheReadInputTokens } : {}),
+            ...(isFirstStep && planCallTokens?.cacheCreationInputTokens !== undefined ? { cacheCreationInputTokens: planCallTokens.cacheCreationInputTokens } : {}),
+        };
+        // Terminal actions: complete and abort don't go through driver.execute
+        // — the runner handles them as the end of the plan.
+        if (step.action.action === 'complete') {
+            // Substitute placeholder complete results with prior runScript output.
+            let resolvedResult = step.action.result;
+            if (lastRunScriptOutput
+                && typeof resolvedResult === 'string'
+                && hasPlaceholderPattern(resolvedResult)) {
+                if (self.config.debug) {
+                    console.log(`[Runner] Substituting placeholder complete.result with runScript output (${lastRunScriptOutput.length} chars)`);
+                }
+                resolvedResult = lastRunScriptOutput;
+                turn.reasoning = `${turn.reasoning ?? ''} [substituted runScript output]`.trim();
+            }
+            turn.durationMs = Date.now() - stepStartedAt;
+            turns.push(turn);
+            self.onTurn?.(turn);
+            self.bus.emitNow({
+                type: 'plan-step-executed',
+                runId,
+                turn: turnNumber,
+                stepIndex: stepIdx + 1,
+                totalSteps: plan.steps.length,
+                action: step.action,
+                executeSuccess: true,
+                verified: true,
+                durationMs: turn.durationMs,
+            });
+            return {
+                kind: 'completed',
+                lastState,
+                finalResult: resolvedResult,
+                turnsConsumed: stepIdx + 1,
+            };
+        }
+        if (step.action.action === 'abort') {
+            turn.durationMs = Date.now() - stepStartedAt;
+            turns.push(turn);
+            self.onTurn?.(turn);
+            self.bus.emitNow({
+                type: 'plan-deviated',
+                runId,
+                turn: turnNumber,
+                stepIndex: stepIdx + 1,
+                totalSteps: plan.steps.length,
+                reason: `plan aborted: ${step.action.reason}`,
+            });
+            return {
+                kind: 'deviated',
+                lastState,
+                failedStepIndex: stepIdx,
+                reason: `plan aborted: ${step.action.reason}`,
+                turnsConsumed: stepIdx + 1,
+            };
+        }
+        // Execute the action via the existing driver path. This emits
+        // execute-started / execute-completed events on the bus exactly
+        // like the per-action loop does.
+        //
+        // Cap each plan step at 10s so missing selectors fail quickly and hand
+        // control back to per-action mode.
+        self.bus.emitNow({ type: 'execute-started', runId, turn: turnNumber, action: step.action });
+        const execStartedAt = Date.now();
+        const planStepTimeoutMs = 10_000;
+        let execResult;
+        try {
+            execResult = await Promise.race([
+                self.driver.execute(step.action),
+                new Promise((resolve) => setTimeout(() => resolve({ success: false, error: `plan step wall-clock timeout after ${planStepTimeoutMs}ms` }), planStepTimeoutMs)),
+            ]);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            execResult = { success: false, error: message };
+        }
+        const execDurationMs = Date.now() - execStartedAt;
+        self.bus.emitNow({
+            type: 'execute-completed',
+            runId,
+            turn: turnNumber,
+            action: step.action,
+            success: execResult.success,
+            ...(execResult.error ? { error: execResult.error } : {}),
+            ...(execResult.bounds ? { bounds: execResult.bounds } : {}),
+            durationMs: execDurationMs,
+        });
+        if (!execResult.success) {
+            turn.error = execResult.error;
+            turn.durationMs = Date.now() - stepStartedAt;
+            turn.verified = false;
+            turn.verificationFailure = `execute failed: ${execResult.error}`;
+            turns.push(turn);
+            self.onTurn?.(turn);
+            runState.recordError();
+            self.bus.emitNow({
+                type: 'plan-step-executed',
+                runId,
+                turn: turnNumber,
+                stepIndex: stepIdx + 1,
+                totalSteps: plan.steps.length,
+                action: step.action,
+                executeSuccess: false,
+                verified: false,
+                durationMs: Date.now() - stepStartedAt,
+                ...(execResult.error ? { verifyReason: execResult.error } : {}),
+            });
+            self.bus.emitNow({
+                type: 'plan-deviated',
+                runId,
+                turn: turnNumber,
+                stepIndex: stepIdx + 1,
+                totalSteps: plan.steps.length,
+                reason: `execute failed: ${execResult.error}`,
+            });
+            return {
+                kind: 'deviated',
+                lastState,
+                failedStepIndex: stepIdx,
+                reason: `execute failed at step ${stepIdx + 1}: ${execResult.error}`,
+                turnsConsumed: stepIdx + 1,
+            };
+        }
+        runState.clearConsecutiveErrors();
+        if (execResult.bounds)
+            turn.actionBounds = execResult.bounds;
+        // Capture runScript output for placeholder substitution and evidence.
+        if (step.action.action === 'runScript' && typeof execResult.data === 'string' && execResult.data.length > 0) {
+            lastRunScriptOutput = execResult.data;
+            if (execResult.data.length > 10) {
+                runState.recordEvidence(`EXTRACTED (turn ${currentTurnIndex}): ${execResult.data.slice(0, 500)}`);
+            }
+        }
+        // Capture extractWithIndex output for per-action fallback.
+        if (step.action.action === 'extractWithIndex' && typeof execResult.data === 'string' && execResult.data.length > 0) {
+            lastExtractOutput = execResult.data;
+            // Also push as goal verification evidence so the verifier sees what
+            // the agent extracted.
+            runState.firstSufficientEvidenceTurn ??= currentTurnIndex;
+            pushGoalVerificationEvidence(runState.goalVerificationEvidence, `EXTRACT RESULT:\n${execResult.data}`);
+            if (execResult.data.length > 10) {
+                runState.recordEvidence(`EXTRACTED (turn ${currentTurnIndex}): ${execResult.data.slice(0, 500)}`);
+            }
+        }
+        // Verify the post-condition. We re-observe to get the post-action
+        // state, then run the same verifyExpectedEffect helper the per-action
+        // loop uses. The fresh observe is also stashed in cachedPostState so
+        // the next step's pre-step observe can reuse it.
+        self.bus.emitNow({
+            type: 'verify-started',
+            runId,
+            turn: turnNumber,
+            expectedEffect: step.expectedEffect,
+        });
+        const verifyStartedAt = Date.now();
+        // Auto-pass list — these actions either don't observably mutate
+        // the page state OR they're self-verifying (the underlying Playwright
+        // call throws on real failure, so a successful return means the
+        // mutation actually happened). Strict expectedEffect verification
+        // would generate false negatives on the per-action loop fallback for
+        // these. Plan execution trusts the execute result.
+        //
+        // - wait / scroll / hover: don't mutate observable snapshot state
+        // - runScript / evaluate / verifyPreview: meta actions
+        // - fill / clickSequence: self-verifying (Playwright throws on miss),
+        //   AND input values don't always reflect in the ARIA snapshot, so
+        //   the permissive "did state change?" check would also miss them
+        const isAutoPass = step.action.action === 'wait'
+            || step.action.action === 'scroll'
+            || step.action.action === 'hover'
+            || step.action.action === 'runScript'
+            || step.action.action === 'extractWithIndex'
+            || step.action.action === 'evaluate'
+            || step.action.action === 'verifyPreview'
+            || step.action.action === 'fill'
+            || step.action.action === 'clickSequence';
+        // Settle wait for mutating actions, mirroring verifyEffect's logic
+        const needsSettleWait = step.action.action === 'click'
+            || step.action.action === 'navigate'
+            || step.action.action === 'press'
+            || step.action.action === 'select'
+            || step.action.action === 'fill'
+            || step.action.action === 'clickSequence';
+        const observePromise = self.driver.observe().catch(() => preStepState);
+        if (needsSettleWait) {
+            await Promise.all([
+                observePromise,
+                new Promise((r) => setTimeout(r, 50)),
+            ]);
+        }
+        const postStepState = await observePromise;
+        self.cachedPostState = postStepState;
+        lastState = postStepState;
+        // Plan verification is more permissive than per-action verification:
+        // a step passes if (a) it's a non-mutating action, OR (b) the strict
+        // verifier passes, OR (c) the snapshot/url changed in any meaningful
+        // way (the action did SOMETHING). Strict failure-on-no-change is
+        // appropriate for the per-action loop where the agent can recover,
+        // but plan execution needs to push forward unless there's positive
+        // evidence of failure.
+        let verifyResult;
+        if (isAutoPass) {
+            verifyResult = { verified: true };
+        }
+        else {
+            const strictResult = verifyExpectedEffect({
+                expectedEffect: step.expectedEffect,
+                preActionState: preStepState,
+                postActionState: postStepState,
+            });
+            if (strictResult.verified) {
+                verifyResult = strictResult;
+            }
+            else {
+                // Permissive fallback: did the page change at all?
+                const stateChanged = preStepState.url !== postStepState.url
+                    || preStepState.title !== postStepState.title
+                    || preStepState.snapshot !== postStepState.snapshot;
+                if (stateChanged) {
+                    verifyResult = { verified: true };
+                }
+                else {
+                    verifyResult = strictResult;
+                }
+            }
+        }
+        turn.verified = verifyResult.verified;
+        if (!verifyResult.verified) {
+            turn.verificationFailure = verifyResult.reason;
+        }
+        turn.durationMs = Date.now() - stepStartedAt;
+        turns.push(turn);
+        self.onTurn?.(turn);
+        self.bus.emitNow({
+            type: 'verify-completed',
+            runId,
+            turn: turnNumber,
+            verified: verifyResult.verified,
+            ...(verifyResult.reason ? { reason: verifyResult.reason } : {}),
+            durationMs: Date.now() - verifyStartedAt,
+        });
+        self.bus.emitNow({
+            type: 'plan-step-executed',
+            runId,
+            turn: turnNumber,
+            stepIndex: stepIdx + 1,
+            totalSteps: plan.steps.length,
+            action: step.action,
+            executeSuccess: true,
+            verified: verifyResult.verified,
+            durationMs: Date.now() - stepStartedAt,
+            ...(verifyResult.reason ? { verifyReason: verifyResult.reason } : {}),
+        });
+        if (!verifyResult.verified) {
+            self.bus.emitNow({
+                type: 'plan-deviated',
+                runId,
+                turn: turnNumber,
+                stepIndex: stepIdx + 1,
+                totalSteps: plan.steps.length,
+                reason: `verification failed at step ${stepIdx + 1}: ${verifyResult.reason ?? 'expected effect not observed'}`,
+            });
+            return {
+                kind: 'deviated',
+                lastState,
+                failedStepIndex: stepIdx,
+                reason: `verification failed at step ${stepIdx + 1}: ${verifyResult.reason ?? 'expected effect not observed'}`,
+                turnsConsumed: stepIdx + 1,
+            };
+        }
+    }
+    // Auto-complete when the plan ends with meaningful runScript output.
+    const lastStep = plan.steps[plan.steps.length - 1];
+    if (lastStep
+        && lastStep.action.action === 'runScript'
+        && isMeaningfulRunScriptOutput(lastRunScriptOutput)) {
+        const synthTurnNumber = currentTurnIndex + 1;
+        const synthTurn = {
+            turn: synthTurnNumber,
+            state: lastState,
+            action: { action: 'complete', result: lastRunScriptOutput },
+            reasoning: 'Auto-complete: plan ended after runScript, runner emitted complete with the runScript output',
+            durationMs: 0,
+        };
+        turns.push(synthTurn);
+        self.onTurn?.(synthTurn);
+        self.bus.emitNow({
+            type: 'plan-step-executed',
+            runId,
+            turn: synthTurnNumber,
+            stepIndex: plan.steps.length + 1,
+            totalSteps: plan.steps.length + 1,
+            action: synthTurn.action,
+            executeSuccess: true,
+            verified: true,
+            durationMs: 0,
+        });
+        if (self.config.debug) {
+            console.log(`[Runner] Auto-emitted complete with runScript output (${lastRunScriptOutput.length} chars) after plan exhausted`);
+        }
+        return {
+            kind: 'completed',
+            lastState,
+            finalResult: lastRunScriptOutput,
+            turnsConsumed: plan.steps.length + 1,
+        };
+    }
+    // If the plan produced extractWithIndex matches, fall through with the
+    // match list so the LLM can choose the correct index.
+    if (lastExtractOutput) {
+        return {
+            kind: 'deviated',
+            lastState,
+            failedStepIndex: plan.steps.length,
+            reason: `plan completed extractWithIndex but the LLM must read the matches and pick by index. Match list:\n${lastExtractOutput.slice(0, 4000)}\n\nPick the index whose text matches the goal, then emit complete with result: <picked text>`,
+            turnsConsumed: plan.steps.length,
+        };
+    }
+    // If the plan ends with runScript but output is empty or placeholder-like,
+    // fall through to per-action mode instead of completing with bad data.
+    if (lastStep
+        && lastStep.action.action === 'runScript'
+        && !isMeaningfulRunScriptOutput(lastRunScriptOutput)) {
+        if (self.config.debug) {
+            console.log(`[Runner] runScript returned no meaningful output (${JSON.stringify(lastRunScriptOutput).slice(0, 100)}); falling through to per-action loop for two-pass extraction`);
+        }
+        return {
+            kind: 'deviated',
+            lastState,
+            failedStepIndex: plan.steps.length - 1,
+            reason: `runScript returned no meaningful output (got: ${JSON.stringify(lastRunScriptOutput).slice(0, 200)}). The first-pass extraction failed — re-observe the page and try extractWithIndex with a wide query (e.g. 'p, span, dd, code') and a contains filter naming the expected text fragment. Pick-by-content beats pick-by-selector when the planner couldn't see the data at plan time.`,
+            turnsConsumed: plan.steps.length,
+        };
+    }
+    // All steps verified BUT the plan ended without an explicit complete/abort.
+    // This means the planner emitted a finite sequence of "work" steps and
+    // didn't terminate. The right behavior is NOT to fabricate a complete —
+    // we treat plan exhaustion as a deviation that triggers fallback to the
+    // per-action loop. The per-action loop will continue from the current
+    // state and emit `complete` when the goal is genuinely met.
+    return {
+        kind: 'deviated',
+        lastState,
+        failedStepIndex: plan.steps.length,
+        reason: 'plan exhausted without an explicit complete or abort step — falling through to per-action loop to finish the task',
+        turnsConsumed: plan.steps.length,
+    };
+}
+//# sourceMappingURL=execute-plan.js.map

package/dist/runner/execute-plan.js.map

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

package/dist/runner/max-turns-extension.d.ts

@@ -0,0 +1,19 @@
+/**
+ * One-time max-turns extension decision.
+ *
+ * Pure: given the current turn and progress signals, decide whether to grant
+ * the single budget extension and to what new cap. The caller (the run loop)
+ * keeps the side effects — emitting the recovery event and mutating the live
+ * cap — so this stays a testable predicate over the loop's budget signals.
+ */
+export declare function decideMaxTurnsExtension(params: {
+    turn: number;
+    maxTurns: number;
+    extensionGranted: boolean;
+    isVisionMode: boolean;
+    lastProgressTurn: number;
+}): {
+    extendedMax: number;
+    extra: number;
+} | null;
+//# sourceMappingURL=max-turns-extension.d.ts.map

package/dist/runner/max-turns-extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"max-turns-extension.d.ts","sourceRoot":"","sources":["../../src/runner/max-turns-extension.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,YAAY,EAAE,OAAO,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAiBhD"}

package/dist/runner/max-turns-extension.js

@@ -0,0 +1,25 @@
+/**
+ * One-time max-turns extension decision.
+ *
+ * Pure: given the current turn and progress signals, decide whether to grant
+ * the single budget extension and to what new cap. The caller (the run loop)
+ * keeps the side effects — emitting the recovery event and mutating the live
+ * cap — so this stays a testable predicate over the loop's budget signals.
+ */
+import { EXTENSION_TURNS_GRANTED, EXTENSION_HARD_CAP, EXTENSION_PROGRESS_LOOKBACK } from './constants.js';
+export function decideMaxTurnsExtension(params) {
+    const { turn, maxTurns, extensionGranted, isVisionMode, lastProgressTurn } = params;
+    if (!(turn === maxTurns
+        && !extensionGranted
+        && !isVisionMode
+        && maxTurns < EXTENSION_HARD_CAP
+        && lastProgressTurn >= maxTurns - EXTENSION_PROGRESS_LOOKBACK)) {
+        return null;
+    }
+    const extendedMax = Math.min(maxTurns + EXTENSION_TURNS_GRANTED, EXTENSION_HARD_CAP);
+    const extra = extendedMax - maxTurns;
+    if (extra <= 0)
+        return null;
+    return { extendedMax, extra };
+}
+//# sourceMappingURL=max-turns-extension.js.map

package/dist/runner/max-turns-extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"max-turns-extension.js","sourceRoot":"","sources":["../../src/runner/max-turns-extension.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAE1G,MAAM,UAAU,uBAAuB,CAAC,MAMvC;IACC,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,gBAAgB,EAAE,YAAY,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAAC;IACpF,IACE,CAAC,CACC,IAAI,KAAK,QAAQ;WACd,CAAC,gBAAgB;WACjB,CAAC,YAAY;WACb,QAAQ,GAAG,kBAAkB;WAC7B,gBAAgB,IAAI,QAAQ,GAAG,2BAA2B,CAC9D,EACD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,uBAAuB,EAAE,kBAAkB,CAAC,CAAC;IACrF,MAAM,KAAK,GAAG,WAAW,GAAG,QAAQ,CAAC;IACrC,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5B,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;AAChC,CAAC"}

package/dist/runner/micro-plan.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Micro-plan follow-up selection — given the primary action the LLM chose and
+ * the optional `nextActions` it proposed, pick the safe subset to chain in the
+ * same turn, bounded by the configured per-turn action cap.
+ */
+import type { Action } from '../types.js';
+export declare function selectMicroPlanFollowUps(primaryAction: Action, nextActions: Action[] | undefined, microPlanConfig: {
+    enabled?: boolean;
+    maxActionsPerTurn?: number;
+} | undefined): Action[];
+//# sourceMappingURL=micro-plan.d.ts.map

package/dist/runner/micro-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"micro-plan.d.ts","sourceRoot":"","sources":["../../src/runner/micro-plan.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EAAE,GAAG,SAAS,EACjC,eAAe,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,GAC7E,MAAM,EAAE,CAwBV"}