@enricai/barnacle 1.9.9 → 1.9.10

package/dist/scraper/phantom-click.d.ts

@@ -11,12 +11,38 @@ export interface PhantomClickSnapshot {
     url: string;
     /** `document.body.outerHTML.length`. */
     bodyHtmlLength: number;
+    /**
+     * Fingerprint of client-side selection state across selection-bearing
+     * controls — `aria-pressed`/`aria-checked`/`aria-selected`, `data-state`
+     * (excluding `open`/`closed` disclosure values), `data-selected`/
+     * `data-checked`, and a selected/active/checked class-token hit on an
+     * interactive element. A multi-select toggle (React state flip) moves this
+     * without moving network, URL, or byte size — often a NEGATIVE byte delta
+     * (an `aria-pressed="false"`→`"true"` flip shrinks the HTML), which the
+     * byte-floor branch can never catch. A pure `disabled`→`enabled` gate with
+     * no accompanying selection-marker change is intentionally NOT tracked.
+     * Optional so pre-`selectionStateSignature` snapshots (and this module's own
+     * tests) stay valid; a defined pre/post pair that differs is a real effect
+     * (see {@link classifyPhantomClick}). The producer is `snapshotPage`'s
+     * `DOM_SNAPSHOT_EXPR` in `flow-runner.ts`, which documents the exact shape.
+     */
+    selectionStateSignature?: string;
 }
 export interface PhantomClickAttempt {
     /** Stagehand's own verdict for the attempt — did it believe it acted? */
     actResultSuccess: boolean | null;
     pre: PhantomClickSnapshot;
     post: PhantomClickSnapshot;
+    /**
+     * True when the step is submit-shaped (a final/submit click). A submit must
+     * show a REAL effect (network/URL) to count as effective — a mere selection-
+     * state flip (e.g. the submit button toggling its own `aria-pressed`, or a
+     * validation render nudging some control) must NOT lift the verdict off
+     * `phantom`, because the cascade's submit-escalation to `deep-submit-locator`
+     * keys on a `phantom` verdict here (see `executeStepWithHealing`). Optional
+     * so non-submit callers and existing tests are unchanged; defaults to false.
+     */
+    isSubmitShapedStep?: boolean;
 }
 export type PhantomClickVerdict = 
 /** Stagehand reported success but pre/post shows no observable effect — a no-op click. */

package/dist/scraper/phantom-click.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"phantom-click.d.ts","sourceRoot":"","sources":["../../src/scraper/phantom-click.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,qFAAqF;AACrF,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,wCAAwC;IACxC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,yEAAyE;IACzE,gBAAgB,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,GAAG,EAAE,oBAAoB,CAAC;IAC1B,IAAI,EAAE,oBAAoB,CAAC;CAC5B;AAED,MAAM,MAAM,mBAAmB;AAC7B,0FAA0F;AACxF,SAAS;AACX,mEAAmE;GACjE,WAAW;AACb,kKAAkK;GAChK,YAAY,CAAC;AAEjB;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,mBAAmB,GAAG,mBAAmB,CAStF"}
+{"version":3,"file":"phantom-click.d.ts","sourceRoot":"","sources":["../../src/scraper/phantom-click.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,qFAAqF;AACrF,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,wCAAwC;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB;;;;;;;;;;;;;;OAcG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,mBAAmB;IAClC,yEAAyE;IACzE,gBAAgB,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,GAAG,EAAE,oBAAoB,CAAC;IAC1B,IAAI,EAAE,oBAAoB,CAAC;IAC3B;;;;;;;;OAQG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,MAAM,mBAAmB;AAC7B,0FAA0F;AACxF,SAAS;AACX,mEAAmE;GACjE,WAAW;AACb,kKAAkK;GAChK,YAAY,CAAC;AAEjB;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,mBAAmB,GAAG,mBAAmB,CA2BtF"}

package/dist/scraper/phantom-click.js

@@ -31,7 +31,23 @@ function classifyPhantomClick(attempt) {
     const networkDelta = attempt.post.networkCount - attempt.pre.networkCount;
     const bytesDelta = attempt.post.bodyHtmlLength - attempt.pre.bodyHtmlLength;
     const urlChanged = attempt.post.url !== attempt.pre.url;
-    const hasEffect = networkDelta !== 0 || urlChanged || bytesDelta >= exports.TRIVIAL_DOM_DELTA_BYTES;
+    // A client-side selection toggle (aria-pressed/checked/selected, data-state,
+    // or a selected/active/checked class) is a real effect regardless of byte
+    // size — the byte floor below rejects it because the delta is trivial or
+    // negative. Only credit when BOTH signatures are defined (an older snapshot
+    // without the field mustn't read undefined === undefined as a change) and
+    // they differ. NOT on a submit-shaped step: a submit must prove itself via
+    // network/URL, and letting a stray selection flip mark it "effective" would
+    // defeat the cascade's phantom-verdict-driven escalation to the deep submit
+    // locator.
+    const selectionStateChanged = !attempt.isSubmitShapedStep &&
+        attempt.pre.selectionStateSignature !== undefined &&
+        attempt.post.selectionStateSignature !== undefined &&
+        attempt.pre.selectionStateSignature !== attempt.post.selectionStateSignature;
+    const hasEffect = networkDelta !== 0 ||
+        urlChanged ||
+        selectionStateChanged ||
+        bytesDelta >= exports.TRIVIAL_DOM_DELTA_BYTES;
     return hasEffect ? "effective" : "phantom";
 }
 //# sourceMappingURL=phantom-click.js.map

package/dist/scraper/phantom-click.js.map

@@ -1 +1 @@
-{"version":3,"file":"phantom-click.js","sourceRoot":"","sources":["../../src/scraper/phantom-click.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;AAyBH;;;;;;GAMG;AACU,QAAA,uBAAuB,GAAG,GAAG,CAAC;AAE3C;;;;;;;GAOG;AACH,8BAAqC,OAA4B;IAC/D,IAAI,OAAO,CAAC,gBAAgB,KAAK,IAAI;QAAE,OAAO,YAAY,CAAC;IAE3D,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IAC1E,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAC5E,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;IAExD,MAAM,SAAS,GAAG,YAAY,KAAK,CAAC,IAAI,UAAU,IAAI,UAAU,IAAI,QAAA,uBAAuB,CAAC;IAC5F,OAAO,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"phantom-click.js","sourceRoot":"","sources":["../../src/scraper/phantom-click.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;AAmDH;;;;;;GAMG;AACU,QAAA,uBAAuB,GAAG,GAAG,CAAC;AAE3C;;;;;;;GAOG;AACH,8BAAqC,OAA4B;IAC/D,IAAI,OAAO,CAAC,gBAAgB,KAAK,IAAI;QAAE,OAAO,YAAY,CAAC;IAE3D,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IAC1E,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAC5E,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;IACxD,6EAA6E;IAC7E,0EAA0E;IAC1E,yEAAyE;IACzE,4EAA4E;IAC5E,0EAA0E;IAC1E,2EAA2E;IAC3E,4EAA4E;IAC5E,4EAA4E;IAC5E,WAAW;IACX,MAAM,qBAAqB,GACzB,CAAC,OAAO,CAAC,kBAAkB;QAC3B,OAAO,CAAC,GAAG,CAAC,uBAAuB,KAAK,SAAS;QACjD,OAAO,CAAC,IAAI,CAAC,uBAAuB,KAAK,SAAS;QAClD,OAAO,CAAC,GAAG,CAAC,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,uBAAuB,CAAC;IAE/E,MAAM,SAAS,GACb,YAAY,KAAK,CAAC;QAClB,UAAU;QACV,qBAAqB;QACrB,UAAU,IAAI,QAAA,uBAAuB,CAAC;IACxC,OAAO,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enricai/barnacle",
-  "version": "1.9.9",
+  "version": "1.9.10",
   "description": "Site-agnostic browser automation engine. POST a structured payload to a typed endpoint; Barnacle drives a Steel + Stagehand session through the target site and returns a structured result.",
   "license": "MIT",
   "author": "Enricai",