@enricai/barnacle 1.12.78 → 1.12.80

package/dist/scraper/stagehand-guard.js

@@ -37,16 +37,25 @@
  * `node_modules/@browserbasehq/stagehand/dist/esm/lib/v3/zodCompat.d.ts`).
  * Barnacle uses Zod v4 via the `zod/v4` subpath export; that's compatible.
  */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.StagehandSchemaError = exports.ACT_RESULT_SCHEMA = exports.ACTION_SCHEMA = void 0;
+exports.StagehandSchemaError = exports.ACT_RESULT_SCHEMA = exports.ACTION_SCHEMA = exports.CLICK_INTENT_RE = void 0;
 exports.guardedAct = guardedAct;
 exports.guardedObserve = guardedObserve;
 exports.guardedExtract = guardedExtract;
 const node_crypto_1 = require("node:crypto");
+const p_retry_1 = __importDefault(require("p-retry"));
 const v4_1 = require("zod/v4");
+const errors_1 = require("../lib/errors");
+const logging_1 = require("../lib/logging");
+const pii_redaction_1 = require("../lib/pii-redaction");
 const call_capture_1 = require("../lib/telemetry/call-capture");
 const call_types_1 = require("../lib/telemetry/call-types");
 const frame_target_1 = require("./frame-target");
+const transient_provider_error_1 = require("./transient-provider-error");
+const trusted_click_1 = require("./trusted-click");
 const watchdog_1 = require("./watchdog");
 /**
  * Fallback watchdog bound for a guarded call whose caller passes no
@@ -55,6 +64,28 @@ const watchdog_1 = require("./watchdog");
  * `guardedObserve` from this module, so importing back would cycle.
  */
 const DEFAULT_GUARD_TIMEOUT_MS = 120_000;
+const logger = (0, logging_1.getLogger)({ name: "scraper/stagehand-guard" });
+/** Instructions that name a click; only these are worth an observe to find a click point. */
+exports.CLICK_INTENT_RE = /\bclick\b/i;
+const TRANSIENT_RETRIES = 2;
+const TRANSIENT_RETRY_MIN_TIMEOUT_MS = 500;
+/**
+ * Retries a Stagehand call that failed with a transient provider error so a
+ * blip is not recorded as a failed technique. Wrap it OUTSIDE `withWatchdog`:
+ * each try gets its own watchdog timeout and the backoff is not charged to it.
+ * Safe for `act` because the provider 5xx is raised during Stagehand's
+ * inference request, before it performs any page action; the narrow
+ * classifier never matches selector, timeout, or schema errors raised after
+ * one.
+ */
+function retryTransient(call) {
+    return (0, p_retry_1.default)(call, {
+        retries: TRANSIENT_RETRIES,
+        minTimeout: TRANSIENT_RETRY_MIN_TIMEOUT_MS,
+        randomize: false,
+        shouldRetry: ({ error }) => (0, transient_provider_error_1.isTransientProviderError)(error),
+    });
+}
 /**
  * Zod parallel of Stagehand's public `Action` shape (from
  * `@browserbasehq/stagehand/.../public/methods.d.ts`):
@@ -127,6 +158,41 @@ function safeStringify(value, cap = 4000) {
 function actInstructionOf(input) {
     return typeof input === "string" ? input : input.description;
 }
+function mergeVariables(options, variables) {
+    if (Object.keys(variables).length === 0)
+        return options;
+    return { ...options, variables: { ...options?.variables, ...variables } };
+}
+/**
+ * Observe only needs the token names for its prompt (it never performs the
+ * action, so never substitutes): withhold the values so they are not shipped
+ * to the Stagehand API either. Plain strings, not the `{ value, description }`
+ * form, so the call stays inside the wire shape already proven against the API.
+ */
+function withheldVariables(variables) {
+    return Object.fromEntries(Object.keys(variables).map((name) => [name, ""]));
+}
+function detokenizeAction(action, variables) {
+    if (Object.keys(variables).length === 0)
+        return action;
+    return {
+        ...action,
+        description: (0, pii_redaction_1.detokenize)(action.description, variables),
+        ...(action.arguments
+            ? { arguments: action.arguments.map((arg) => (0, pii_redaction_1.detokenize)(arg, variables)) }
+            : {}),
+    };
+}
+function detokenizeActResult(result, variables) {
+    if (Object.keys(variables).length === 0)
+        return result;
+    return {
+        ...result,
+        message: (0, pii_redaction_1.detokenize)(result.message, variables),
+        actionDescription: (0, pii_redaction_1.detokenize)(result.actionDescription, variables),
+        actions: result.actions.map((action) => detokenizeAction(action, variables)),
+    };
+}
 /**
  * Merges `frameTarget.frameSelector` into `options.selector` for
  * `ObserveOptions`/`ExtractOptions`, composed as Stagehand `">>"` hop
@@ -144,6 +210,79 @@ function frameScopedOptions(options, frameTarget) {
         return options;
     return { ...options, selector: (0, frame_target_1.buildHopSelector)(frameTarget.frameSelector, "*") };
 }
+/**
+ * Resolves a string act instruction to the Action Stagehand would click so it
+ * can be centred first. Scoped to the step's frame the same way
+ * `guardedObserve` is, so an in-frame control is not resolved against the top
+ * document. Resolution is best-effort: when `observe` is unavailable, throws,
+ * or finds nothing, Stagehand's own string `act` resolves internally exactly
+ * as before.
+ */
+async function resolveClickAction(stagehand, instruction, options, frameTarget) {
+    if (typeof stagehand.observe !== "function" || !exports.CLICK_INTENT_RE.test(instruction)) {
+        return undefined;
+    }
+    const observeOptions = frameScopedOptions(options?.timeout ? { timeout: options.timeout } : {}, frameTarget);
+    const observed = await (0, watchdog_1.withWatchdog)(() => stagehand.observe(instruction, observeOptions), {
+        timeoutMs: options?.timeout ?? DEFAULT_GUARD_TIMEOUT_MS,
+        label: "stagehand-observe",
+    });
+    return observed[0];
+}
+/**
+ * Stagehand's `act` clicks the content-box centre after only a
+ * `scrollIntoViewIfNeeded`, so a sticky overlay swallows the click. Centre +
+ * hit-test the click target first so Stagehand's own scroll is a no-op. String
+ * instructions are resolved via `observe` for the pre-centring only and still
+ * reach `act` as the original string, so downstream method/argument handling
+ * is unchanged. Frame-hop (`>>`) selectors are centred in the child frame they
+ * resolve to. Best-effort by design: a target that cannot be resolved or
+ * centred is logged and left to Stagehand's own delivery, because a click that
+ * lands on an overlay is caught as a phantom by the healing ladder and retried
+ * through the centred trusted-click path, whereas failing here would turn an
+ * act that would have run into a hard attempt failure. Non-click actions are
+ * skipped since there is no click point to clear.
+ */
+async function preCentreClickTarget(stagehand, input, options, frameTarget) {
+    try {
+        const page = typeof stagehand.context?.activePage === "function"
+            ? stagehand.context.activePage()
+            : undefined;
+        const target = frameTarget ?? (page ? (0, frame_target_1.mainFrameTarget)(page) : undefined);
+        if (!target)
+            return;
+        const action = typeof input === "string"
+            ? await resolveClickAction(stagehand, input, options, frameTarget)
+            : input;
+        if (action?.method !== "click")
+            return;
+        await centreAction(page, target, action);
+    }
+    catch (err) {
+        logger.warn(`pre-centring skipped: ${(0, errors_1.toErrorMessage)(err)}`);
+    }
+}
+/**
+ * Centres and hit-tests an Action's click target, resolving a `>>` frame hop
+ * to the child frame the tail selector lives in.
+ */
+async function centreAction(page, target, action) {
+    const hopAt = action.selector.lastIndexOf(">>");
+    if (hopAt === -1) {
+        await (0, trusted_click_1.centreSelectorForClick)(target, action.selector, { label: action.selector });
+        return;
+    }
+    if (!page) {
+        throw new Error(`no active page to resolve frame hop for ${action.selector}`);
+    }
+    const hopTarget = await (0, frame_target_1.resolveFrameTarget)(page, action.selector.slice(0, hopAt).trim());
+    if (hopTarget.declaredFrameSelector) {
+        throw new Error(`frame ${hopTarget.declaredFrameSelector} not attached; cannot centre click`);
+    }
+    await (0, trusted_click_1.centreSelectorForClick)(hopTarget, action.selector.slice(hopAt + 2).trim(), {
+        label: action.selector,
+    });
+}
 /**
  * Schema-guarded wrapper around Stagehand's `act`. Same signature as the
  * underlying call: accepts either an instruction string or a structured
@@ -156,8 +295,11 @@ function frameScopedOptions(options, frameTarget) {
  * receives the same `timeout` as before, but a call that ignores it and hangs
  * now fails the attempt instead of blocking the step forever.
  *
- * Accepts the same trailing `frameTarget` param as `guardedObserve`/
- * `guardedExtract` for signature symmetry, but does not forward it into
+ * Click targets are centred and hit-tested before Stagehand acts (see
+ * `preCentreClickTarget`); a given `frameTarget` scopes that pass, and
+ * `preCentred` skips it when the caller already resolved and centred the
+ * target, so one click does not cost two observe calls. The
+ * trailing `frameTarget` param is not forwarded into
  * `ActOptions` — `ActOptions` has no `selector` field, and its `page`
  * override only accepts a full Playwright/Puppeteer/Patchright/understudy
  * `Page`, not the `Frame` handle `FrameTarget.frame` exposes (the
@@ -168,11 +310,19 @@ function frameScopedOptions(options, frameTarget) {
  * that `Action` — the `observe(...)[0] -> act(target)` pattern already used
  * throughout `flow-runner.ts`.
  */
-async function guardedAct(stagehand, input, options, captureFn, _frameTarget) {
+async function guardedAct(stagehand, input, options, captureFn, frameTarget, preCentred = false) {
     const callId = (0, node_crypto_1.randomUUID)();
-    const userContent = actInstructionOf(input);
+    // Request values travel as Stagehand `variables`, substituted only when
+    // the action is performed. An `Action` (from observe) is replayed without
+    // an LLM, so it keeps its literal arguments.
+    const tokenized = typeof input === "string" ? (0, pii_redaction_1.tokenizeSensitiveValues)(input) : { text: "", variables: {} };
+    const sendInput = typeof input === "string" ? tokenized.text : input;
+    const sendOptions = mergeVariables(options, tokenized.variables);
+    const userContent = actInstructionOf(sendInput);
     const t0 = performance.now();
     try {
+        if (!preCentred)
+            await preCentreClickTarget(stagehand, sendInput, sendOptions, frameTarget);
         // Stagehand's `act` has two overloads (string and Action) that share the
         // same runtime implementation (dispatch is via `isObserveResult` inside
         // Stagehand). The two branches LOOK identical but TS can't resolve the
@@ -180,7 +330,9 @@ async function guardedAct(stagehand, input, options, captureFn, _frameTarget) {
         // `stagehand.act` to a variable then calling it as a standalone function
         // loses `this` in strict mode, which crashes inside Stagehand's
         // `withInstanceLogContext(this.instanceId, ...)` wrapper on entry.
-        const raw = await (0, watchdog_1.withWatchdog)(() => typeof input === "string" ? stagehand.act(input, options) : stagehand.act(input, options), { timeoutMs: options?.timeout ?? DEFAULT_GUARD_TIMEOUT_MS, label: "stagehand-act" });
+        const raw = await retryTransient(() => (0, watchdog_1.withWatchdog)(() => typeof sendInput === "string"
+            ? stagehand.act(sendInput, sendOptions)
+            : stagehand.act(sendInput, sendOptions), { timeoutMs: options?.timeout ?? DEFAULT_GUARD_TIMEOUT_MS, label: "stagehand-act" }));
         const latencyMs = performance.now() - t0;
         const parsed = exports.ACT_RESULT_SCHEMA.safeParse(raw);
         if (!parsed.success) {
@@ -208,7 +360,7 @@ async function guardedAct(stagehand, input, options, captureFn, _frameTarget) {
             errorMessage: null,
             failureKind: null,
         }, captureFn);
-        return parsed.data;
+        return detokenizeActResult(parsed.data, tokenized.variables);
     }
     catch (err) {
         if (err instanceof StagehandSchemaError)
@@ -250,17 +402,22 @@ async function guardedAct(stagehand, input, options, captureFn, _frameTarget) {
  */
 async function guardedObserve(stagehand, instruction, options, captureFn, frameTarget) {
     const callId = (0, node_crypto_1.randomUUID)();
-    const userContent = instruction ?? "";
+    const tokenized = instruction === undefined ? { text: "", variables: {} } : (0, pii_redaction_1.tokenizeSensitiveValues)(instruction);
+    const sendInstruction = instruction === undefined ? undefined : tokenized.text;
+    const userContent = sendInstruction ?? "";
     const t0 = performance.now();
-    const scopedOptions = frameScopedOptions(options, frameTarget);
+    const scopedOptions = mergeVariables(frameScopedOptions(options, frameTarget), withheldVariables(tokenized.variables));
     try {
         // Match Stagehand's overloads: pass instruction only when defined, so
         // the SDK falls through to its no-arg/options-only path otherwise.
-        const raw = await (0, watchdog_1.withWatchdog)(() => instruction === undefined
+        const raw = await retryTransient(() => (0, watchdog_1.withWatchdog)(() => sendInstruction === undefined
             ? scopedOptions === undefined
                 ? stagehand.observe()
                 : stagehand.observe(scopedOptions)
-            : stagehand.observe(instruction, scopedOptions), { timeoutMs: scopedOptions?.timeout ?? DEFAULT_GUARD_TIMEOUT_MS, label: "stagehand-observe" });
+            : stagehand.observe(sendInstruction, scopedOptions), {
+            timeoutMs: scopedOptions?.timeout ?? DEFAULT_GUARD_TIMEOUT_MS,
+            label: "stagehand-observe",
+        }));
         const latencyMs = performance.now() - t0;
         const parsed = v4_1.z.array(exports.ACTION_SCHEMA).safeParse(raw);
         if (!parsed.success) {
@@ -288,7 +445,13 @@ async function guardedObserve(stagehand, instruction, options, captureFn, frameT
             errorMessage: null,
             failureKind: null,
         }, captureFn);
-        return parsed.data;
+        // Callers replay these actions directly (no substitution on that path),
+        // so tokens are resolved here; an action carrying a token the LLM
+        // invented would type it verbatim and is dropped.
+        return parsed.data
+            .map((action) => detokenizeAction(action, tokenized.variables))
+            .filter((action) => Object.keys(tokenized.variables).length === 0 ||
+            (action.arguments ?? []).every((arg) => (0, pii_redaction_1.unresolvedTokens)(arg, tokenized.variables).length === 0));
     }
     catch (err) {
         if (err instanceof StagehandSchemaError)
@@ -336,7 +499,7 @@ async function guardedExtract(stagehand, instruction, schema, options, captureFn
         // the cleanest public-API way to express "whatever overload-2 expects."
         // The `as unknown` step is needed because TS won't accept a single
         // direct cast across the entire overload set.
-        const raw = await (0, watchdog_1.withWatchdog)(() => stagehand.extract(instruction, schema, frameScopedOptions(options, frameTarget)), { timeoutMs: options?.timeout ?? DEFAULT_GUARD_TIMEOUT_MS, label: "stagehand-extract" });
+        const raw = await retryTransient(() => (0, watchdog_1.withWatchdog)(() => stagehand.extract(instruction, schema, frameScopedOptions(options, frameTarget)), { timeoutMs: options?.timeout ?? DEFAULT_GUARD_TIMEOUT_MS, label: "stagehand-extract" }));
         const latencyMs = performance.now() - t0;
         const parsed = schema.safeParse(raw);
         if (!parsed.success) {
@@ -392,8 +555,13 @@ async function guardedExtract(stagehand, instruction, schema, options, captureFn
  * `LlmCallInput` contract (which already supports null for those fields).
  */
 async function captureCall(partial, captureFn = call_capture_1.captureLlmCall) {
+    // Replayed observe `Action`s keep literal arguments, so scrub here rather
+    // than relying on every caller-supplied sink to do it.
     await captureFn({
         ...partial,
+        userContent: (0, pii_redaction_1.redactPii)(partial.userContent),
+        responseContent: partial.responseContent === null ? null : (0, pii_redaction_1.redactPii)(partial.responseContent),
+        errorMessage: partial.errorMessage === null ? null : (0, pii_redaction_1.redactPii)(partial.errorMessage),
         model: "stagehand-internal",
         systemPrompt: null,
         inputTokens: null,

package/dist/scraper/stagehand-guard.js.map

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

package/dist/scraper/submit-control.d.ts

@@ -66,7 +66,7 @@ export declare const SUBMIT_SHAPE_EXPR = "((el) => {\n  if (!el || !el.tagName)
  * match no positive tier — including anything caught by
  * {@link NEGATIVE_TEXT_EXPR} — are excluded entirely rather than ranked
  * last, so the caller never has to guess where the "safe" cutoff is. Same
- * treatment for a node that fails {@link IS_VISIBLE_EXPR}: a hidden
+ * treatment for a node that fails {@link ACTIONABLE_VISIBILITY_EXPR}: a hidden
  * per-step submit button in a wizard (0x0 layout box, `display:none`) is
  * dropped before ranking so it can never outrank the rendered one and win
  * a click that would silently no-op. Same treatment again for a node that
@@ -100,7 +100,7 @@ export declare function buildRankSubmitCandidatesExpr(root?: string): string;
  * out of range for the current DOM (e.g. the page changed between the
  * locate and click calls), and `{ clicked: false, reason: "not-actionable" }`
  * without dispatching any event if the element at that index fails
- * {@link IS_VISIBLE_EXPR} or {@link IS_DISABLED_EXPR} — a node with no
+ * {@link ACTIONABLE_VISIBILITY_EXPR} or {@link IS_DISABLED_EXPR} — a node with no
  * layout box makes a real click throw a CDP `-32000 Node does not have a
  * layout object` error, and a disabled node accepts a synthetic click as a
  * silent no-op, so this check reports the same outcome as data instead.

package/dist/scraper/submit-control.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"submit-control.d.ts","sourceRoot":"","sources":["../../src/scraper/submit-control.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,sOAG5B,CAAC;AA4DJ;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,0BAA0B,s4CAyBpC,CAAC;AAEJ;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,iBAAiB,uoEAQ3B,CAAC;AA+CJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,SAAa,GAAG,MAAM,CA0BvE;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,SAAa,GAAG,MAAM,CAYtF;AAED,2HAA2H;AAC3H,MAAM,MAAM,mBAAmB,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAElD,qGAAqG;AACrG,MAAM,WAAW,eAAe;IAC9B,mIAAmI;IACnI,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,0EAA0E;AAC1E,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,oKAAoK;IACpK,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B"}
+{"version":3,"file":"submit-control.d.ts","sourceRoot":"","sources":["../../src/scraper/submit-control.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,sOAG5B,CAAC;AA0CJ;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,0BAA0B,s4CAyBpC,CAAC;AAEJ;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,iBAAiB,uoEAQ3B,CAAC;AA+CJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,SAAa,GAAG,MAAM,CA0BvE;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,SAAa,GAAG,MAAM,CAYtF;AAED,2HAA2H;AAC3H,MAAM,MAAM,mBAAmB,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAElD,qGAAqG;AACrG,MAAM,WAAW,eAAe;IAC9B,mIAAmI;IACnI,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,0EAA0E;AAC1E,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,oKAAoK;IACpK,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B"}

package/dist/scraper/submit-control.js

@@ -13,6 +13,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SUBMIT_SHAPE_EXPR = exports.SUBMIT_SHAPE_FALLBACK_EXPR = exports.NEGATIVE_TEXT_EXPR = void 0;
 exports.buildRankSubmitCandidatesExpr = buildRankSubmitCandidatesExpr;
 exports.buildClickByDeepIndexExpr = buildClickByDeepIndexExpr;
+const actionable_visibility_expr_1 = require("./actionable-visibility-expr");
 const browser_click_expr_1 = require("./browser-click-expr");
 /**
  * Verbs that identify a control as NOT the submit action even when it is
@@ -43,23 +44,6 @@ const ACCESSIBLE_NAME_EXPR = `((el) => {
   const fallback = tag === "input" ? el.value : el.textContent;
   return norm(el.getAttribute("aria-label") || fallback || "");
 })`;
-/**
- * Visibility check: a node with a 0x0 layout box, or a computed
- * `display:none`/`visibility:hidden`, can never be the target of a real
- * click. Duplicated from `deep-locator-scan.ts`'s private `IS_VISIBLE_EXPR`
- * rather than imported — both are browser-context expression strings
- * composed by string interpolation, matching the convention this module
- * already follows for {@link DEEP_ELEMENTS_EXPR}. Applied both when ranking
- * (so an unrendered node never outranks a rendered one) and when clicking
- * (so a node that became hidden between the rank and click calls is
- * reported as not-actionable instead of dispatching a no-op click).
- */
-const IS_VISIBLE_EXPR = `((el) => {
-  const rect = el.getBoundingClientRect();
-  if (rect.width === 0 && rect.height === 0) return false;
-  const style = getComputedStyle(el);
-  return style.display !== "none" && style.visibility !== "hidden";
-})`;
 /**
  * Disabled check: a candidate carrying the native `disabled` property or
  * `aria-disabled="true"` — on itself or an ancestor within
@@ -207,7 +191,7 @@ const RANK_TIERS_EXPR = `((el, name) => {
  * match no positive tier — including anything caught by
  * {@link NEGATIVE_TEXT_EXPR} — are excluded entirely rather than ranked
  * last, so the caller never has to guess where the "safe" cutoff is. Same
- * treatment for a node that fails {@link IS_VISIBLE_EXPR}: a hidden
+ * treatment for a node that fails {@link ACTIONABLE_VISIBILITY_EXPR}: a hidden
  * per-step submit button in a wizard (0x0 layout box, `display:none`) is
  * dropped before ranking so it can never outrank the rendered one and win
  * a click that would silently no-op. Same treatment again for a node that
@@ -233,7 +217,7 @@ function buildRankSubmitCandidatesExpr(root = "document") {
     return `(() => {
     const accessibleName = ${ACCESSIBLE_NAME_EXPR};
     const rankTier = ${RANK_TIERS_EXPR};
-    const isVisible = ${IS_VISIBLE_EXPR};
+    const isVisible = ${actionable_visibility_expr_1.ACTIONABLE_VISIBILITY_EXPR};
     const isDisabled = ${IS_DISABLED_EXPR};
     const deepElements = ${browser_click_expr_1.DEEP_ELEMENTS_EXPR};
     const all = deepElements(${root});
@@ -267,7 +251,7 @@ function buildRankSubmitCandidatesExpr(root = "document") {
  * out of range for the current DOM (e.g. the page changed between the
  * locate and click calls), and `{ clicked: false, reason: "not-actionable" }`
  * without dispatching any event if the element at that index fails
- * {@link IS_VISIBLE_EXPR} or {@link IS_DISABLED_EXPR} — a node with no
+ * {@link ACTIONABLE_VISIBILITY_EXPR} or {@link IS_DISABLED_EXPR} — a node with no
  * layout box makes a real click throw a CDP `-32000 Node does not have a
  * layout object` error, and a disabled node accepts a synthetic click as a
  * silent no-op, so this check reports the same outcome as data instead.
@@ -282,7 +266,7 @@ function buildRankSubmitCandidatesExpr(root = "document") {
  */
 function buildClickByDeepIndexExpr(deepIndex, root = "document") {
     return `(() => {
-    const isVisible = ${IS_VISIBLE_EXPR};
+    const isVisible = ${actionable_visibility_expr_1.ACTIONABLE_VISIBILITY_EXPR};
     const isDisabled = ${IS_DISABLED_EXPR};
     const deepElements = ${browser_click_expr_1.DEEP_ELEMENTS_EXPR};
     const all = deepElements(${root});

package/dist/scraper/submit-control.js.map

@@ -1 +1 @@
-{"version":3,"file":"submit-control.js","sourceRoot":"","sources":["../../src/scraper/submit-control.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;;;AAEH,qEAIsC;AAEtC;;;;;;;;;GASG;AACU,QAAA,kBAAkB,GAAG;;;GAG/B,CAAC;AAEJ;;;;;;;;GAQG;AACH,MAAM,oBAAoB,GAAG;;;;;GAK1B,CAAC;AAEJ;;;;;;;;;;GAUG;AACH,MAAM,eAAe,GAAG;;;;;GAKrB,CAAC;AAEJ;;;;;;;;;;;;;;GAcG;AACH,MAAM,gBAAgB,GAAG;gCACO,iDAA4B;;;;;;GAMzD,CAAC;AAEJ;;;;;;;;;;;;;;;GAeG;AACU,QAAA,0BAA0B,GAAG;;;;;;;kCAOR,iDAA4B;;;;;;;;2BAQnC,oBAAoB;;;;;;;;;;GAU5C,CAAC;AAEJ;;;;;;;;;;;;;;;;;;;;GAoBG;AACU,QAAA,iBAAiB,GAAG;;uBAEV,QAAA,kBAAkB;2BACd,oBAAoB;;;6BAGlB,QAAA,0BAA0B;;GAEpD,CAAC;AAEJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,eAAe,GAAG;uBACD,QAAA,kBAAkB;;;;;;;;;;6BAUZ,QAAA,0BAA0B;;;GAGpD,CAAC;AAEJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,uCAA8C,IAAI,GAAG,UAAU;IAC7D,OAAO;6BACoB,oBAAoB;uBAC1B,eAAe;wBACd,eAAe;yBACd,gBAAgB;2BACd,uCAAkB;+BACd,IAAI;;;;;;;;;;;;;;;;;;OAkB5B,CAAC;AACR,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,mCAA0C,SAAiB,EAAE,IAAI,GAAG,UAAU;IAC5E,OAAO;wBACe,eAAe;yBACd,gBAAgB;2BACd,uCAAkB;+BACd,IAAI;qBACd,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;;;MAGxC,IAAA,wCAAmB,EAAC,IAAI,CAAC;;OAExB,CAAC;AACR,CAAC"}
+{"version":3,"file":"submit-control.js","sourceRoot":"","sources":["../../src/scraper/submit-control.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;;;AAEH,qFAAkF;AAClF,qEAIsC;AAEtC;;;;;;;;;GASG;AACU,QAAA,kBAAkB,GAAG;;;GAG/B,CAAC;AAEJ;;;;;;;;GAQG;AACH,MAAM,oBAAoB,GAAG;;;;;GAK1B,CAAC;AAEJ;;;;;;;;;;;;;;GAcG;AACH,MAAM,gBAAgB,GAAG;gCACO,iDAA4B;;;;;;GAMzD,CAAC;AAEJ;;;;;;;;;;;;;;;GAeG;AACU,QAAA,0BAA0B,GAAG;;;;;;;kCAOR,iDAA4B;;;;;;;;2BAQnC,oBAAoB;;;;;;;;;;GAU5C,CAAC;AAEJ;;;;;;;;;;;;;;;;;;;;GAoBG;AACU,QAAA,iBAAiB,GAAG;;uBAEV,QAAA,kBAAkB;2BACd,oBAAoB;;;6BAGlB,QAAA,0BAA0B;;GAEpD,CAAC;AAEJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,eAAe,GAAG;uBACD,QAAA,kBAAkB;;;;;;;;;;6BAUZ,QAAA,0BAA0B;;;GAGpD,CAAC;AAEJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,uCAA8C,IAAI,GAAG,UAAU;IAC7D,OAAO;6BACoB,oBAAoB;uBAC1B,eAAe;wBACd,uDAA0B;yBACzB,gBAAgB;2BACd,uCAAkB;+BACd,IAAI;;;;;;;;;;;;;;;;;;OAkB5B,CAAC;AACR,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,mCAA0C,SAAiB,EAAE,IAAI,GAAG,UAAU;IAC5E,OAAO;wBACe,uDAA0B;yBACzB,gBAAgB;2BACd,uCAAkB;+BACd,IAAI;qBACd,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;;;MAGxC,IAAA,wCAAmB,EAAC,IAAI,CAAC;;OAExB,CAAC;AACR,CAAC"}

package/dist/scraper/target-resolution-diagnostic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"target-resolution-diagnostic.d.ts","sourceRoot":"","sources":["../../src/scraper/target-resolution-diagnostic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAGrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACzB,MAAM,0BAA0B,CAAC;AAoBlC,uIAAuI;AACvI,MAAM,WAAW,2BAA2B;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,oFAAoF;AACpF,MAAM,WAAW,kCAAkC;IACjD,0KAA0K;IAC1K,UAAU,EAAE,2BAA2B,EAAE,CAAC;IAC1C,4KAA4K;IAC5K,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAuED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,yCAAyC,CAC7D,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,IAAI,EAAE,IAAI,EACV,iBAAiB,CAAC,EAAE,eAAe,EAAE,GAAG,IAAI,GAC3C,OAAO,CAAC,kCAAkC,GAAG,IAAI,CAAC,CAyCpD"}
+{"version":3,"file":"target-resolution-diagnostic.d.ts","sourceRoot":"","sources":["../../src/scraper/target-resolution-diagnostic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAIrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACzB,MAAM,0BAA0B,CAAC;AAoBlC,uIAAuI;AACvI,MAAM,WAAW,2BAA2B;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,oFAAoF;AACpF,MAAM,WAAW,kCAAkC;IACjD,0KAA0K;IAC1K,UAAU,EAAE,2BAA2B,EAAE,CAAC;IAC1C,4KAA4K;IAC5K,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAiED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,yCAAyC,CAC7D,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,IAAI,EAAE,IAAI,EACV,iBAAiB,CAAC,EAAE,eAAe,EAAE,GAAG,IAAI,GAC3C,OAAO,CAAC,kCAAkC,GAAG,IAAI,CAAC,CAyCpD"}

package/dist/scraper/target-resolution-diagnostic.js

@@ -14,6 +14,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.captureTargetResolutionDiagnosticSnapshot = captureTargetResolutionDiagnosticSnapshot;
 const logging_1 = require("../lib/logging");
+const actionable_visibility_expr_1 = require("./actionable-visibility-expr");
 const submit_control_1 = require("./submit-control");
 const logger = (0, logging_1.getLogger)({ name: "scraper/target-resolution-diagnostic" });
 /** Cap on the number of ranked candidates kept in a snapshot. */
@@ -31,11 +32,10 @@ const MAX_SNAPSHOT_JSON_LENGTH = 20_000;
 const MAX_EXCERPT_LENGTH = 2_000;
 /**
  * Re-walks the light DOM plus every open shadow root (same traversal shape
- * as `submit-control.ts`'s private `DEEP_ELEMENTS_EXPR` — duplicated rather
- * than imported, since both are browser-context expression strings composed
- * by string interpolation, matching that module's own stated convention for
- * why `IS_VISIBLE_EXPR`/`DEEP_ELEMENTS_EXPR` are duplicated instead of
- * shared) to read the role/visible/disabled/excerpt fields the ranking
+ * as `submit-control.ts`'s private `DEEP_ELEMENTS_EXPR`, duplicated rather
+ * than imported; visibility comes from the shared
+ * {@link ACTIONABLE_VISIBILITY_EXPR} so an `aria-hidden` decoy is never
+ * reported visible) to read the role/visible/disabled/excerpt fields the ranking
  * expression itself doesn't return, and to build a short accessible-name
  * excerpt around the top-ranked candidate. Runs as a single `page.evaluate`
  * round trip so the DOM observed here always matches the one
@@ -55,12 +55,7 @@ function buildCandidateDetailExpr(root, deepIndices) {
       walk(rootEl);
       return out;
     })(${root});
-    const isVisible = (el) => {
-      const rect = el.getBoundingClientRect();
-      if (rect.width === 0 && rect.height === 0) return false;
-      const style = getComputedStyle(el);
-      return style.display !== "none" && style.visibility !== "hidden";
-    };
+    const isVisible = ${actionable_visibility_expr_1.ACTIONABLE_VISIBILITY_EXPR};
     const isDisabled = (el) => {
       for (let depth = 0, node = el; depth < 8 && node; depth++) {
         if (node.disabled === true) return true;

package/dist/scraper/target-resolution-diagnostic.js.map

@@ -1 +1 @@
-{"version":3,"file":"target-resolution-diagnostic.js","sourceRoot":"","sources":["../../src/scraper/target-resolution-diagnostic.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAIH,2CAA0C;AAE1C,6DAIkC;AAElC,MAAM,MAAM,GAAG,IAAA,mBAAS,EAAC,EAAE,IAAI,EAAE,sCAAsC,EAAE,CAAC,CAAC;AAE3E,iEAAiE;AACjE,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAEnC;;;;;;;GAOG;AACH,MAAM,wBAAwB,GAAG,MAAM,CAAC;AAExC,mFAAmF;AACnF,MAAM,kBAAkB,GAAG,KAAK,CAAC;AAoBjC;;;;;;;;;;;GAWG;AACH,SAAS,wBAAwB,CAAC,IAAY,EAAE,WAA8B;IAC5E,OAAO;;;;;;;;;;;;SAYA,IAAI;;;;;;;;;;;;;;;;;;;;;;;;sBAwBS,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;;;;;;;;;;;;;;oBAc7B,kBAAkB;;;OAG/B,CAAC;AACR,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACI,KAAK,oDACV,MAA+B,EAC/B,IAAU,EACV,iBAA4C;IAE5C,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,IAAI,IAAI,CAAC;QACjC,MAAM,IAAI,GAAG,UAAU,CAAC;QACxB,MAAM,MAAM,GACV,iBAAiB;YACjB,CAAC,MAAM,SAAS,CAAC,QAAQ,CAEvB,IAAA,8CAA6B,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,uBAAuB,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAIrC,wBAAwB,CACtB,IAAI,EACJ,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAChC,CACF,CAAC;QACF,MAAM,UAAU,GAAkC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YACvE,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,cAAc,EAAE,CAAC,CAAC,cAAc;YAChC,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE;YACnC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,KAAK;YAC5C,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,IAAI,IAAI;SAC9C,CAAC,CAAC,CAAC;QACJ,MAAM,QAAQ,GAAuC;YACnD,UAAU;YACV,oBAAoB,EAAE,MAAM,CAAC,OAAO,IAAI,IAAI;SAC7C,CAAC;QACF,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,UAAU,CAAC,MAAM,IAAI,wBAAwB;YAAE,OAAO,QAAQ,CAAC;QACnE,OAAO;YACL,UAAU,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;YAC/E,oBAAoB,EAAE,QAAQ,CAAC,oBAAoB;SACpD,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,4DAA4D,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACzF,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"target-resolution-diagnostic.js","sourceRoot":"","sources":["../../src/scraper/target-resolution-diagnostic.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAIH,2CAA0C;AAC1C,qFAAkF;AAElF,6DAIkC;AAElC,MAAM,MAAM,GAAG,IAAA,mBAAS,EAAC,EAAE,IAAI,EAAE,sCAAsC,EAAE,CAAC,CAAC;AAE3E,iEAAiE;AACjE,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAEnC;;;;;;;GAOG;AACH,MAAM,wBAAwB,GAAG,MAAM,CAAC;AAExC,mFAAmF;AACnF,MAAM,kBAAkB,GAAG,KAAK,CAAC;AAoBjC;;;;;;;;;;GAUG;AACH,SAAS,wBAAwB,CAAC,IAAY,EAAE,WAA8B;IAC5E,OAAO;;;;;;;;;;;;SAYA,IAAI;wBACW,uDAA0B;;;;;;;;;;;;;;;;;;sBAkB5B,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;;;;;;;;;;;;;;oBAc7B,kBAAkB;;;OAG/B,CAAC;AACR,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACI,KAAK,oDACV,MAA+B,EAC/B,IAAU,EACV,iBAA4C;IAE5C,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,IAAI,IAAI,CAAC;QACjC,MAAM,IAAI,GAAG,UAAU,CAAC;QACxB,MAAM,MAAM,GACV,iBAAiB;YACjB,CAAC,MAAM,SAAS,CAAC,QAAQ,CAEvB,IAAA,8CAA6B,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,uBAAuB,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAIrC,wBAAwB,CACtB,IAAI,EACJ,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAChC,CACF,CAAC;QACF,MAAM,UAAU,GAAkC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YACvE,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,cAAc,EAAE,CAAC,CAAC,cAAc;YAChC,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE;YACnC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,KAAK;YAC5C,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,IAAI,IAAI;SAC9C,CAAC,CAAC,CAAC;QACJ,MAAM,QAAQ,GAAuC;YACnD,UAAU;YACV,oBAAoB,EAAE,MAAM,CAAC,OAAO,IAAI,IAAI;SAC7C,CAAC;QACF,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,UAAU,CAAC,MAAM,IAAI,wBAAwB;YAAE,OAAO,QAAQ,CAAC;QACnE,OAAO;YACL,UAAU,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;YAC/E,oBAAoB,EAAE,QAAQ,CAAC,oBAAoB;SACpD,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,4DAA4D,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACzF,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/scraper/transient-provider-error.d.ts

@@ -0,0 +1,19 @@
+/**
+ * One site-agnostic definition of a transient model-provider failure (5xx,
+ * overload, connection reset raised at inference) so the call guard and the
+ * replan guard agree. Structured status/code fields win; message text is a
+ * fallback only for provider-wrapped errors that carry no status.
+ */
+export declare function isTransientProviderError(err: unknown): boolean;
+/**
+ * Tells whether a failure dump's attempts[] errorMessage values are
+ * transient, so the replan guard can avoid treating a provider outage as a
+ * verdict about the step. `all` requires at least one message.
+ */
+export declare function summarizeAttemptTransience(attempts: ReadonlyArray<{
+    errorMessage?: string | null;
+}>): {
+    all: boolean;
+    any: boolean;
+};
+//# sourceMappingURL=transient-provider-error.d.ts.map

package/dist/scraper/transient-provider-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transient-provider-error.d.ts","sourceRoot":"","sources":["../../src/scraper/transient-provider-error.ts"],"names":[],"mappings":"AAuBA;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAc9D;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,aAAa,CAAC;IAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,GACxD;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,CAMhC"}

package/dist/scraper/transient-provider-error.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isTransientProviderError = isTransientProviderError;
+exports.summarizeAttemptTransience = summarizeAttemptTransience;
+const TRANSIENT_STATUS_CODES = new Set([429, 529]);
+const TRANSIENT_ERROR_CODES = new Set([
+    "ECONNRESET",
+    "ETIMEDOUT",
+    "EPIPE",
+    "ECONNREFUSED",
+    "EAI_AGAIN",
+]);
+const TRANSIENT_MESSAGE_RX = /internal server error|\boverloaded\b|bad gateway|service unavailable|gateway time-?out|socket hang up|\bECONNRESET\b|connection reset|\b(?:5\d\d)\s+(?:internal|bad|service|gateway)/i;
+function readStatus(obj) {
+    for (const key of ["status", "statusCode"]) {
+        const value = obj[key];
+        if (typeof value === "number")
+            return value;
+    }
+    return null;
+}
+function readCode(obj) {
+    return typeof obj.code === "string" ? obj.code : null;
+}
+/**
+ * One site-agnostic definition of a transient model-provider failure (5xx,
+ * overload, connection reset raised at inference) so the call guard and the
+ * replan guard agree. Structured status/code fields win; message text is a
+ * fallback only for provider-wrapped errors that carry no status.
+ */
+function isTransientProviderError(err) {
+    if (typeof err === "object" && err !== null) {
+        const obj = err;
+        const status = readStatus(obj);
+        if (status !== null)
+            return (status >= 500 && status < 600) || TRANSIENT_STATUS_CODES.has(status);
+        const code = readCode(obj);
+        if (code !== null && TRANSIENT_ERROR_CODES.has(code))
+            return true;
+        if (obj.cause !== undefined && obj.cause !== err && isTransientProviderError(obj.cause)) {
+            return true;
+        }
+    }
+    const message = err instanceof Error ? err.message : typeof err === "string" ? err : "";
+    return TRANSIENT_MESSAGE_RX.test(message);
+}
+/**
+ * Tells whether a failure dump's attempts[] errorMessage values are
+ * transient, so the replan guard can avoid treating a provider outage as a
+ * verdict about the step. `all` requires at least one message.
+ */
+function summarizeAttemptTransience(attempts) {
+    const messages = attempts
+        .map((a) => a.errorMessage)
+        .filter((m) => typeof m === "string" && m.length > 0);
+    const flags = messages.map((m) => isTransientProviderError(new Error(m)));
+    return { all: flags.length > 0 && flags.every(Boolean), any: flags.some(Boolean) };
+}
+//# sourceMappingURL=transient-provider-error.js.map

package/dist/scraper/transient-provider-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transient-provider-error.js","sourceRoot":"","sources":["../../src/scraper/transient-provider-error.ts"],"names":[],"mappings":";;;;AAAA,MAAM,sBAAsB,GAAwB,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AACxE,MAAM,qBAAqB,GAAwB,IAAI,GAAG,CAAC;IACzD,YAAY;IACZ,WAAW;IACX,OAAO;IACP,cAAc;IACd,WAAW;CACZ,CAAC,CAAC;AACH,MAAM,oBAAoB,GACxB,uLAAuL,CAAC;AAE1L,SAAS,UAAU,CAAC,GAA4B;IAC9C,KAAK,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QACvB,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;IAC9C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,QAAQ,CAAC,GAA4B;IAC5C,OAAO,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AACxD,CAAC;AAED;;;;;GAKG;AACH,kCAAyC,GAAY;IACnD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC5C,MAAM,GAAG,GAAG,GAA8B,CAAC;QAC3C,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,MAAM,KAAK,IAAI;YACjB,OAAO,CAAC,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG,CAAC,IAAI,sBAAsB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC/E,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,IAAI,KAAK,IAAI,IAAI,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAClE,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,GAAG,CAAC,KAAK,KAAK,GAAG,IAAI,wBAAwB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACxF,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACxF,OAAO,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,oCACE,QAAyD;IAEzD,MAAM,QAAQ,GAAG,QAAQ;SACtB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC;SAC1B,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACrE,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,wBAAwB,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1E,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;AACrF,CAAC"}