@tangle-network/browser-agent-driver 0.33.2 → 0.34.0

package/dist/runner/replay/controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.js","sourceRoot":"","sources":["../../../src/runner/replay/controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAYH,SAAS,MAAM,CAAC,GAAY;IAC1B,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,eAAe,CAAC,GAAc,EAAE,IAAe;IACtD,OAAO,GAAG,CAAC,GAAG,KAAK,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,IAAI,GAAG,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,CAAC;AAC5F,CAAC;AAED,SAAS,SAAS,CAChB,UAAkB,EAClB,KAAgB,EAChB,IAAgB,EAChB,KAMC;IAED,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,KAAK;QACL,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,SAAS,EAAE,4BAA4B;QACvC,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,GAAG,CAAC,KAAK,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvF,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,GAAG,CAAC,KAAK,CAAC,mBAAmB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,KAAK,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtG,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7D,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,IAAgB,EAAE,UAAqB,EAAE,cAAsB;IACjF,OAAO,CACL,YAAY,cAAc,qDAAqD;QAC/E,mCAAmC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;QACtE,eAAe,UAAU,CAAC,GAAG,OAAO,UAAU,CAAC,KAAK,IAAI,CACzD,CAAC;AACJ,CAAC;AAED,iFAAiF;AACjF,MAAM,OAAO,2BAA2B;IACtC,KAAK,CAAC,MAAM,CAAC,IAAgB,EAAE,GAAkB;QAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;QACrC,MAAM,KAAK,GAAW,EAAE,CAAC;QAEzB,GAAG,CAAC,OAAO,EAAE,CAAC;YACZ,IAAI,EAAE,gBAAgB;YACtB,YAAY,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE;YAChC,UAAU;YACV,cAAc,EAAE,IAAI,CAAC,cAAc;SACpC,CAAC,CAAC;QAEH,wEAAwE;QACxE,2EAA2E;QAC3E,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;YACrB,MAAM,SAAS,GAAG,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;YAC1E,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,0BAA0B,CAAC,CAAC;QACrF,CAAC;QAED,IAAI,SAAgC,CAAC;QAErC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,UAAU,EAAE,KAAK,EAAE,EAAE,CAAC;YAChD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC/B,GAAG,CAAC,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YAEtF,kEAAkE;YAClE,IAAI,QAAmB,CAAC;YACxB,IAAI,CAAC;gBACH,QAAQ,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACxC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,OAAO,GAAG,SAAS,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;gBACpD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,8BAA8B,KAAK,GAAG,CAAC,KAAK,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACtH,CAAC;YACD,SAAS,GAAG,QAAQ,CAAC;YAErB,mEAAmE;YACnE,iCAAiC;YACjC,IAAI,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;gBACxB,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;gBAC3E,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;YACpE,CAAC;YAED,sDAAsD;YACtD,MAAM,WAAW,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC9F,IAAI,WAAW,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;gBACrC,GAAG,CAAC,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;gBACjF,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;YAChF,CAAC;YAED,gBAAgB;YAChB,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACjC,IAAI,SAA6B,CAAC;YAClC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACrD,IAAI,CAAC,MAAM,CAAC,OAAO;oBAAE,SAAS,GAAG,MAAM,CAAC,KAAK,IAAI,yBAAyB,CAAC;YAC7E,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YAC1B,CAAC;YACD,IAAI,SAAS,EAAE,CAAC;gBACd,qEAAqE;gBACrE,oEAAoE;gBACpE,gDAAgD;gBAChD,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE;oBACrD,QAAQ,EAAE,KAAK;oBACf,KAAK,EAAE,SAAS;oBAChB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa;oBACtC,GAAG,CAAC,IAAI,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACtF,CAAC,CAAC,CAAC;gBACJ,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,0BAA0B,KAAK,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC,CAAC;YACjH,CAAC;YAED,qEAAqE;YACrE,IAAI,SAAoB,CAAC;YACzB,IAAI,CAAC;gBACH,SAAS,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACzC,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS,GAAG,QAAQ,CAAC;YACvB,CAAC;YACD,SAAS,GAAG,SAAS,CAAC;YAEtB,IAAI,QAAiB,CAAC;YACtB,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;gBACxB,MAAM,EAAE,GAAG,GAAG,CAAC,YAAY,CAAC;oBAC1B,cAAc,EAAE,IAAI,CAAC,cAAc;oBACnC,cAAc,EAAE,QAAQ;oBACxB,eAAe,EAAE,SAAS;iBAC3B,CAAC,CAAC;gBACH,QAAQ,GAAG,EAAE,CAAC,QAAQ,CAAC;gBACvB,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC;oBACjB,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,IAAI,8BAA8B,CAAC;oBAC3D,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE;wBACrD,QAAQ,EAAE,KAAK;wBACf,cAAc,EAAE,IAAI,CAAC,cAAc;wBACnC,mBAAmB,EAAE,MAAM;wBAC3B,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa;qBACvC,CAAC,CAAC,CAAC;oBACJ,GAAG,CAAC,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,sBAAsB,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;oBAC/D,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,sCAAsC,KAAK,GAAG,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC;gBAC3H,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,8DAA8D;gBAC9D,mEAAmE;gBACnE,mEAAmE;gBACnE,uEAAuE;gBACvE,wDAAwD;gBACxD,QAAQ,GAAG,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAClD,CAAC;YAED,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE;gBACrD,QAAQ;gBACR,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa;gBACtC,GAAG,CAAC,IAAI,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACtF,CAAC,CAAC,CAAC;QACN,CAAC;QAED,gEAAgE;QAChE,MAAM,UAAU,GAAG,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,SAAS,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACxF,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;QAC7D,MAAM,gBAAgB,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,UAAU,EAAE,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QACjF,GAAG,CAAC,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,cAAc,EAAE,UAAU,EAAE,QAAQ,EAAE,gBAAgB,CAAC,QAAQ,EAAE,CAAC,CAAC;QAE7G,OAAO;YACL,IAAI,EAAE,WAAW;YACjB,cAAc,EAAE,UAAU;YAC1B,UAAU;YACV,YAAY,EAAE,CAAC;YACf,KAAK;YACL,SAAS,EAAE,UAAU;YACrB,gBAAgB;YAChB,WAAW;SACZ,CAAC;IACJ,CAAC;IAEO,IAAI,CACV,GAAkB,EAClB,KAAa,EACb,cAAsB,EACtB,UAAkB,EAClB,SAAoB,EACpB,MAAc;QAEd,GAAG,CAAC,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;QAC7E,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,yBAAyB,cAAc,IAAI,UAAU,WAAW,MAAM,EAAE,CAAC,CAAC;QACxF,CAAC;QACD,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,cAAc;YACd,UAAU;YACV,YAAY,EAAE,CAAC;YACf,KAAK;YACL,SAAS;YACT,MAAM;SACP,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,GAAkB;QAC1C,IAAI,CAAC;YACH,OAAO,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAEO,YAAY,CAAC,GAAkB;QACrC,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IACvE,CAAC;CACF;AAED,4EAA4E;AAC5E,MAAM,UAAU,sBAAsB;IACpC,OAAO,IAAI,2BAA2B,EAAE,CAAC;AAC3C,CAAC"}

package/dist/runner/replay/guard.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Workflow Replay — the pure pre-execution guard.
+ *
+ * Given a recorded {@link ReplayStep} and the current live observation (URL +
+ * snapshot text only), decide whether the step can still be replayed against
+ * the page in front of us. This module is PURE: no driver, no async, no IO. It
+ * unit-tests with plain literals.
+ *
+ * It gates on ACTION-PERFORMABILITY, not snapshot identity (see the module note
+ * in contracts.ts for why exact `snapshotHash` equality would heal on nearly
+ * every replay):
+ *   1. Origin consistency — the live page's origin must match the origin the
+ *      step was recorded at (when both resolve). A recorded click on origin A
+ *      must never fire while the live page sits on origin B.
+ *   2. Ref performability — for actions targeting `@ref` selectors, every
+ *      referenced element must still be present in the current snapshot (the
+ *      driver resolves `@ref` by locating its `[ref=…]` token; a vanished ref
+ *      can't be clicked/typed). Selectors the guard cannot statically resolve
+ *      (CSS, text=, role=) proceed and defer to execution + effect verification.
+ */
+import type { ReplayGuard, ReplayObservation, ReplayStep, StepGuardResult } from './contracts.js';
+/** Default {@link ReplayGuard}: origin consistency + `@ref` performability. */
+export declare class RefPerformabilityGuard implements ReplayGuard {
+    check(step: ReplayStep, current: ReplayObservation): StepGuardResult;
+}
+/** Convenience factory mirroring the controller's `createReplayController`. */
+export declare function createReplayGuard(): ReplayGuard;
+//# sourceMappingURL=guard.d.ts.map

package/dist/runner/replay/guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../../../src/runner/replay/guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AA8ClG,+EAA+E;AAC/E,qBAAa,sBAAuB,YAAW,WAAW;IACxD,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,iBAAiB,GAAG,eAAe;CA2BrE;AAED,+EAA+E;AAC/E,wBAAgB,iBAAiB,IAAI,WAAW,CAE/C"}

package/dist/runner/replay/guard.js

@@ -0,0 +1,100 @@
+/**
+ * Workflow Replay — the pure pre-execution guard.
+ *
+ * Given a recorded {@link ReplayStep} and the current live observation (URL +
+ * snapshot text only), decide whether the step can still be replayed against
+ * the page in front of us. This module is PURE: no driver, no async, no IO. It
+ * unit-tests with plain literals.
+ *
+ * It gates on ACTION-PERFORMABILITY, not snapshot identity (see the module note
+ * in contracts.ts for why exact `snapshotHash` equality would heal on nearly
+ * every replay):
+ *   1. Origin consistency — the live page's origin must match the origin the
+ *      step was recorded at (when both resolve). A recorded click on origin A
+ *      must never fire while the live page sits on origin B.
+ *   2. Ref performability — for actions targeting `@ref` selectors, every
+ *      referenced element must still be present in the current snapshot (the
+ *      driver resolves `@ref` by locating its `[ref=…]` token; a vanished ref
+ *      can't be clicked/typed). Selectors the guard cannot statically resolve
+ *      (CSS, text=, role=) proceed and defer to execution + effect verification.
+ */
+import { findElementForRef } from '../utils.js';
+const PROCEED = { decision: 'proceed' };
+function normalizeOrigin(url) {
+    if (!url)
+        return undefined;
+    try {
+        const origin = new URL(url).origin;
+        // Opaque origins (about:blank, data:, blob:) serialize to the string
+        // "null". Treat them as unresolvable so the gate defers rather than
+        // healing on a spurious "null" vs real-origin mismatch.
+        return origin && origin !== 'null' ? origin : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Collect every `@ref`-style selector an action targets. Actions whose targets
+ * are coordinates, labels, CSS/text selectors, or URLs contribute nothing —
+ * those are deferred to execution rather than statically gated.
+ */
+function collectRefSelectors(action) {
+    switch (action.action) {
+        case 'click':
+        case 'type':
+        case 'press':
+        case 'hover':
+        case 'select':
+            return [action.selector];
+        case 'scroll':
+            return action.selector ? [action.selector] : [];
+        case 'fill': {
+            const refs = [];
+            if (action.fields)
+                refs.push(...Object.keys(action.fields));
+            if (action.selects)
+                refs.push(...Object.keys(action.selects));
+            if (action.checks)
+                refs.push(...action.checks);
+            return refs;
+        }
+        case 'clickSequence':
+            return action.refs;
+        default:
+            return [];
+    }
+}
+/** Default {@link ReplayGuard}: origin consistency + `@ref` performability. */
+export class RefPerformabilityGuard {
+    check(step, current) {
+        // 1. Origin consistency. Only gate when BOTH origins resolve — an
+        //    unparseable recorded/current URL (about:blank, data:) is not evidence
+        //    of drift, so we defer rather than heal.
+        const recordedOrigin = normalizeOrigin(step.url);
+        const liveOrigin = normalizeOrigin(current.url);
+        if (recordedOrigin && liveOrigin && recordedOrigin !== liveOrigin) {
+            return {
+                decision: 'abort',
+                reason: `origin drift: step recorded on ${recordedOrigin} but live page is on ${liveOrigin}`,
+            };
+        }
+        // 2. Ref performability. Every `@ref` the action targets must still be
+        //    present (and named) in the live snapshot.
+        const refSelectors = collectRefSelectors(step.action).filter((s) => s.startsWith('@'));
+        for (const selector of refSelectors) {
+            if (findElementForRef(current.snapshot, selector) === undefined) {
+                return {
+                    decision: 'abort',
+                    reason: `target ${selector} for ${step.action.action} is no longer present in the live snapshot`,
+                };
+            }
+        }
+        return PROCEED;
+    }
+}
+/** Convenience factory mirroring the controller's `createReplayController`. */
+export function createReplayGuard() {
+    return new RefPerformabilityGuard();
+}
+//# sourceMappingURL=guard.js.map

package/dist/runner/replay/guard.js.map

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

package/dist/runner/runner.d.ts

@@ -9,34 +9,22 @@
  * - Recovery strategies: auto-triggered on failure patterns
  * - Plan tracking: detects when the agent repeats the same step
  */
+import { Brain } from '../brain/index.js';
 import type { Driver } from '../drivers/types.js';
 import type { Scenario, AgentConfig, AgentResult, Turn, PageState } from '../types.js';
 import type { ProjectStore } from '../memory/project-store.js';
+import type { RunnerScoutHost } from './scout-feedback.js';
+import type { RunnerDomainHost } from './domain-boundary.js';
+import type { RunnerDecisionScreenshotHost } from './decision-screenshot.js';
+import type { RunnerEffectVerifyHost } from './effect-verify.js';
+import type { RunnerExecuteHost } from './execute-plan.js';
+import type { ReplayPlan } from './replay/contracts.js';
 import { RunRegistry } from '../memory/run-registry.js';
 import { TurnEventBus } from './events.js';
+import { detectBatchFillOpportunity } from './batch-fill.js';
+import { hasPlaceholderPattern, isMeaningfulRunScriptOutput } from './completion-policy.js';
 import type { ResolvedExtensions } from '../extensions/types.js';
-/**
- * Detect when the agent is filling a multi-field form one input at a time and
- * inject a hint that demands a `fill` batch on the next turn.
- *
- * Trigger conditions (all must hold):
- *   1. The agent's most recent action was a single-step `type` on the
- *      current URL
- *   2. The current snapshot has 2+ unused fillable refs (textbox /
- *      searchbox / combobox) that the agent hasn't typed into yet
- *   3. We haven't already injected this hint in the last turn (to avoid
- *      hint loops if the agent ignores it)
- *
- * The detector fires after one type action when two or more unused fields
- * remain, which catches common two-field-per-step forms before the agent
- * burns extra turns.
- *
- * The hint is high-priority (100) so it survives ctxBudget truncation, and
- * it explicitly lists the unused @refs from the current snapshot so the LLM
- * doesn't have to guess. The injection is gated by BAD_BATCH_HINT=0 for
- * rollback.
- */
-export declare function detectBatchFillOpportunity(turns: Turn[], state: PageState): string | null;
+export { detectBatchFillOpportunity, hasPlaceholderPattern, isMeaningfulRunScriptOutput };
 export interface BrowserAgentOptions {
     driver: Driver;
     config?: AgentConfig;
@@ -51,6 +39,14 @@ export interface BrowserAgentOptions {
     onPhaseTiming?: (phase: 'navigate' | 'observe' | 'decide' | 'execute', durationMs: number) => void;
     /** Reference trajectory to inject into brain context */
     referenceTrajectory?: string;
+    /**
+     * Strict-matched replay plan for ZERO-LLM workflow replay. When provided AND
+     * `config.replay.enabled` is true, the runner attempts to re-execute the
+     * recorded steps before its normal loop. Built by the caller (test-runner)
+     * from `TrajectoryStore.findReplayCandidate`. Default behavior is unchanged
+     * when absent.
+     */
+    replayPlan?: ReplayPlan;
     /** Project memory store — enables knowledge + selector persistence */
     projectStore?: ProjectStore;
     /** Run registry for orchestration-facing manifests */
@@ -78,41 +74,22 @@ export interface BrowserAgentOptions {
      */
     macroPromptBlock?: string;
 }
-/**
- * Detect placeholder patterns in a planner-generated complete.result.
- *
- * The planner has to commit to its `complete.result` text BEFORE any prior
- * runScript step actually runs, so on extraction tasks it fabricates
- * placeholders. We detect those patterns and substitute the runScript
- * output (deterministic, no extra LLM call).
- *
- * Patterns we catch:
- *   - JSON `null` literals (e.g. `{"x": null, "y": null}`)
- *   - "<from prior step>", "<placeholder>", "<value from ...>", "<extracted ...>", "<observed ...>"
- *   - "{{...}}" template markers
- *
- * Conservative on purpose — we only substitute when the planner clearly
- * didn't know real values at planning time. A complete.result that contains
- * actual data (no nulls, no placeholder markers) passes through unchanged.
- */
-export declare function hasPlaceholderPattern(text: string): boolean;
-/** Returns true only when runScript output contains usable extracted data. */
-export declare function isMeaningfulRunScriptOutput(output: string | null | undefined): boolean;
 export declare function shouldUsePlannerForScenario(scenario: Scenario, mode?: 'always' | 'auto'): boolean;
-export declare class BrowserAgent {
-    private driver;
-    private brain;
-    private config;
-    private onTurn?;
+export declare class BrowserAgent implements RunnerScoutHost, RunnerDomainHost, RunnerDecisionScreenshotHost, RunnerEffectVerifyHost, RunnerExecuteHost {
+    driver: Driver;
+    brain: Brain;
+    config: AgentConfig;
+    onTurn?: (turn: Turn) => void;
     private beforeTurn?;
     private onPhaseTiming?;
     private referenceTrajectory?;
+    private replayPlan?;
     private projectStore?;
     private runRegistry?;
     private knowledge?;
     private selectorCache?;
-    private cachedPostState;
-    private bus;
+    cachedPostState: PageState | undefined;
+    bus: TurnEventBus;
     private currentRunId;
     private decisionCache?;
     private extensions?;
@@ -121,6 +98,14 @@ export declare class BrowserAgent {
     constructor(options: BrowserAgentOptions);
     run(scenario: Scenario): Promise<AgentResult>;
     private selectFollowUpActions;
+    /**
+     * Surface replay lifecycle events. The structured TurnEventBus union is closed
+     * and replay is opt-in, so rather than widen it we log under debug — the
+     * self-heal decision is never silent (the controller also logs + returns a
+     * reason, and the runner logs the fall-through). `runId` is accepted for
+     * symmetry with bus emits and future wiring.
+     */
+    private handleReplayEvent;
     /** Persist knowledge, selector cache, and session history to disk */
     private saveMemory;
     /**
@@ -161,10 +146,18 @@ export declare class BrowserAgent {
     private buildSearchResultsScoutFeedback;
     private buildVisibleLinkScoutRecommendation;
     private buildBranchLinkRecommendation;
-    private filterScoutCandidatesByAllowedDomains;
+    filterScoutCandidatesByAllowedDomains(candidates: Array<{
+        ref: string;
+        text: string;
+        score: number;
+    }>, allowedDomains: string[] | undefined): Promise<Array<{
+        ref: string;
+        text: string;
+        score: number;
+    }>>;
     private inspectDisallowedSearchClick;
     private enforceAllowedDomainBoundary;
-    private attachDecisionScreenshot;
+    attachDecisionScreenshot(state: PageState): Promise<PageState>;
 }
 /** Convenience function */
 export declare function runBrowserAgent(driver: Driver, scenario: Scenario, options?: Omit<BrowserAgentOptions, 'driver'>): Promise<AgentResult>;

package/dist/runner/runner.d.ts.map

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