@thinkrun/cli 0.1.27

package/dist/src/local-bridge-timing.js

@@ -0,0 +1,41 @@
+/**
+ * Shared local-bridge timing contract.
+ *
+ * This file is the checked-in source of truth for the reconnect/retry numbers
+ * that have to fit together across the native host and both CLI entrypoints.
+ *
+ * Contract:
+ * - Native host keeps the HTTP bridge alive for 90s after extension disconnect.
+ * - Typed CLI requests stay responsive with a 10s routine timeout and a 30s
+ *   health probe timeout.
+ * - The typed adapter gets at most one immediate replay after a route change
+ *   or successful live revalidation (2 attempts total).
+ * - The shell wrapper only does short patient retries for safe observational
+ *   reads: 3 attempts total with 1s then 2s delays (3s total backoff budget).
+ *
+ * The retry budgets are intentionally much smaller than the native-host grace
+ * window so a flapping bridge fails fast instead of being hidden behind long,
+ * contradictory patient retry loops.
+ */
+export const LOCAL_BRIDGE_RECONNECT_GRACE_MS = 90_000;
+export const LOCAL_BRIDGE_HEALTH_PROBE_TIMEOUT_MS = 30_000;
+export const LOCAL_BRIDGE_REQUEST_TIMEOUT_MS = 10_000;
+export const LOCAL_BRIDGE_TYPED_TRANSPORT_RECOVERY_ATTEMPTS = 2;
+export const LOCAL_BRIDGE_TYPED_EXTENSION_REVALIDATION_DELAYS_MS = [250, 500, 1_000];
+export const LOCAL_BRIDGE_TYPED_RECENT_DISCONNECT_GRACE_MS = 5_000;
+export const LOCAL_BRIDGE_SHELL_SAFE_READ_RETRY_MAX_ATTEMPTS = 3;
+export const LOCAL_BRIDGE_SHELL_SAFE_READ_RETRY_INITIAL_DELAY_MS = 1_000;
+export const LOCAL_BRIDGE_SHELL_SAFE_READ_RETRY_BACKOFF_MULTIPLIER = 2;
+export function getLocalBridgeShellSafeReadRetryDelaysMs() {
+    const delays = [];
+    let delay = LOCAL_BRIDGE_SHELL_SAFE_READ_RETRY_INITIAL_DELAY_MS;
+    for (let attempt = 1; attempt < LOCAL_BRIDGE_SHELL_SAFE_READ_RETRY_MAX_ATTEMPTS; attempt += 1) {
+        delays.push(delay);
+        delay *= LOCAL_BRIDGE_SHELL_SAFE_READ_RETRY_BACKOFF_MULTIPLIER;
+    }
+    return delays;
+}
+export function getLocalBridgeShellSafeReadRetryBudgetMs() {
+    return getLocalBridgeShellSafeReadRetryDelaysMs().reduce((sum, delay) => sum + delay, 0);
+}
+//# sourceMappingURL=local-bridge-timing.js.map

package/dist/src/local-bridge-timing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-bridge-timing.js","sourceRoot":"","sources":["../../src/local-bridge-timing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,CAAC,MAAM,+BAA+B,GAAG,MAAM,CAAC;AAEtD,MAAM,CAAC,MAAM,oCAAoC,GAAG,MAAM,CAAC;AAC3D,MAAM,CAAC,MAAM,+BAA+B,GAAG,MAAM,CAAC;AAEtD,MAAM,CAAC,MAAM,8CAA8C,GAAG,CAAC,CAAC;AAChE,MAAM,CAAC,MAAM,mDAAmD,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAU,CAAC;AAC9F,MAAM,CAAC,MAAM,6CAA6C,GAAG,KAAK,CAAC;AAEnE,MAAM,CAAC,MAAM,+CAA+C,GAAG,CAAC,CAAC;AACjE,MAAM,CAAC,MAAM,mDAAmD,GAAG,KAAK,CAAC;AACzE,MAAM,CAAC,MAAM,qDAAqD,GAAG,CAAC,CAAC;AAEvE,MAAM,UAAU,wCAAwC;IACtD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,GAAG,mDAAmD,CAAC;IAChE,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,+CAA+C,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QAC9F,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnB,KAAK,IAAI,qDAAqD,CAAC;IACjE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,wCAAwC;IACtD,OAAO,wCAAwC,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC;AAC3F,CAAC"}

package/dist/src/obstacle-recovery/classify-script.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Shared inline JS diagnostic script for element obstacle classification.
+ * Used by both CLI obstacle-classifier (via evaluateFn) and backend obstacle-detector (via page.evaluate).
+ * Also duplicated in extension/background/browser-commands.ts (classifyElementFailure) which uses
+ * chrome.scripting.executeScript with a func parameter — that copy must be maintained separately
+ * as it cannot import this module, but should match this logic.
+ *
+ * IMPORTANT: When updating this script, also update the extension copy in browser-commands.ts.
+ */
+export declare const CLASSIFY_ELEMENT_SCRIPT = "(() => {\n  const selector = __SELECTOR__;\n  let el;\n  try { el = document.querySelector(selector); } catch(e) { return null; }\n  if (el) {\n    const style = getComputedStyle(el);\n    if (style.display === 'none' || style.visibility === 'hidden') return 'not_visible';\n    if (el.hasAttribute('disabled') || style.pointerEvents === 'none') return 'not_interactive';\n    const rect = el.getBoundingClientRect();\n    if (rect.bottom < 0 || rect.top > window.innerHeight || rect.right < 0 || rect.left > window.innerWidth) return 'off_screen';\n    return null;\n  }\n  const iframes = document.querySelectorAll('iframe');\n  let crossOriginIframeFound = false;\n  for (const iframe of iframes) {\n    try {\n      const doc = iframe.contentDocument;\n      if (doc === null) { crossOriginIframeFound = true; continue; }\n      if (doc.querySelector(selector)) return 'element_in_iframe';\n    } catch (e) { crossOriginIframeFound = true; }\n  }\n  function searchShadow(root) {\n    for (const child of root.querySelectorAll('*')) {\n      if (child.shadowRoot) {\n        try {\n          if (child.shadowRoot.querySelector(selector)) return true;\n          if (searchShadow(child.shadowRoot)) return true;\n        } catch (e) {}\n      }\n    }\n    return false;\n  }\n  if (searchShadow(document.documentElement)) return 'element_in_shadow_dom';\n  if (crossOriginIframeFound) return 'cross_origin_blocked';\n  return 'element_not_found';\n})()";
+/**
+ * Build the classification script with a specific selector safely embedded.
+ * Uses JSON.stringify to prevent XSS injection via selector content.
+ */
+export declare function buildClassifyScript(selector: string): string;
+//# sourceMappingURL=classify-script.d.ts.map

package/dist/src/obstacle-recovery/classify-script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify-script.d.ts","sourceRoot":"","sources":["../../../src/obstacle-recovery/classify-script.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,q7CAmC/B,CAAC;AAEN;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE5D"}

package/dist/src/obstacle-recovery/classify-script.js

@@ -0,0 +1,53 @@
+/**
+ * Shared inline JS diagnostic script for element obstacle classification.
+ * Used by both CLI obstacle-classifier (via evaluateFn) and backend obstacle-detector (via page.evaluate).
+ * Also duplicated in extension/background/browser-commands.ts (classifyElementFailure) which uses
+ * chrome.scripting.executeScript with a func parameter — that copy must be maintained separately
+ * as it cannot import this module, but should match this logic.
+ *
+ * IMPORTANT: When updating this script, also update the extension copy in browser-commands.ts.
+ */
+export const CLASSIFY_ELEMENT_SCRIPT = `(() => {
+  const selector = __SELECTOR__;
+  let el;
+  try { el = document.querySelector(selector); } catch(e) { return null; }
+  if (el) {
+    const style = getComputedStyle(el);
+    if (style.display === 'none' || style.visibility === 'hidden') return 'not_visible';
+    if (el.hasAttribute('disabled') || style.pointerEvents === 'none') return 'not_interactive';
+    const rect = el.getBoundingClientRect();
+    if (rect.bottom < 0 || rect.top > window.innerHeight || rect.right < 0 || rect.left > window.innerWidth) return 'off_screen';
+    return null;
+  }
+  const iframes = document.querySelectorAll('iframe');
+  let crossOriginIframeFound = false;
+  for (const iframe of iframes) {
+    try {
+      const doc = iframe.contentDocument;
+      if (doc === null) { crossOriginIframeFound = true; continue; }
+      if (doc.querySelector(selector)) return 'element_in_iframe';
+    } catch (e) { crossOriginIframeFound = true; }
+  }
+  function searchShadow(root) {
+    for (const child of root.querySelectorAll('*')) {
+      if (child.shadowRoot) {
+        try {
+          if (child.shadowRoot.querySelector(selector)) return true;
+          if (searchShadow(child.shadowRoot)) return true;
+        } catch (e) {}
+      }
+    }
+    return false;
+  }
+  if (searchShadow(document.documentElement)) return 'element_in_shadow_dom';
+  if (crossOriginIframeFound) return 'cross_origin_blocked';
+  return 'element_not_found';
+})()`;
+/**
+ * Build the classification script with a specific selector safely embedded.
+ * Uses JSON.stringify to prevent XSS injection via selector content.
+ */
+export function buildClassifyScript(selector) {
+    return CLASSIFY_ELEMENT_SCRIPT.replace('__SELECTOR__', JSON.stringify(selector));
+}
+//# sourceMappingURL=classify-script.js.map

package/dist/src/obstacle-recovery/classify-script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify-script.js","sourceRoot":"","sources":["../../../src/obstacle-recovery/classify-script.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAmClC,CAAC;AAEN;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,OAAO,uBAAuB,CAAC,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;AACnF,CAAC"}

package/dist/src/obstacle-recovery/obstacle-classifier.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Obstacle classifier — diagnoses WHY a selector lookup failed.
+ *
+ * Runs a single evaluate call with a diagnostic JS script that checks
+ * visibility, interactivity, viewport bounds, iframes, and shadow DOM
+ * before falling back to 'element_not_found'.
+ */
+import type { ObstacleType } from './types.js';
+/**
+ * Classify why an element selector lookup failed by running diagnostic
+ * JavaScript on the page via the provided evaluate function.
+ *
+ * The selector is embedded safely using JSON.stringify to prevent XSS
+ * (handled by buildClassifyScript).
+ *
+ * @param selector  CSS selector that failed to match or interact
+ * @param evaluateFn  Executes a JS script string on the page and returns the result
+ * @returns The classified obstacle type
+ */
+export declare function classifyElementFailure(selector: string, evaluateFn: (script: string) => Promise<any>): Promise<ObstacleType>;
+//# sourceMappingURL=obstacle-classifier.d.ts.map

package/dist/src/obstacle-recovery/obstacle-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"obstacle-classifier.d.ts","sourceRoot":"","sources":["../../../src/obstacle-recovery/obstacle-classifier.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC,GAC3C,OAAO,CAAC,YAAY,CAAC,CAevB"}

package/dist/src/obstacle-recovery/obstacle-classifier.js

@@ -0,0 +1,37 @@
+/**
+ * Obstacle classifier — diagnoses WHY a selector lookup failed.
+ *
+ * Runs a single evaluate call with a diagnostic JS script that checks
+ * visibility, interactivity, viewport bounds, iframes, and shadow DOM
+ * before falling back to 'element_not_found'.
+ */
+import { buildClassifyScript } from './classify-script.js';
+/**
+ * Classify why an element selector lookup failed by running diagnostic
+ * JavaScript on the page via the provided evaluate function.
+ *
+ * The selector is embedded safely using JSON.stringify to prevent XSS
+ * (handled by buildClassifyScript).
+ *
+ * @param selector  CSS selector that failed to match or interact
+ * @param evaluateFn  Executes a JS script string on the page and returns the result
+ * @returns The classified obstacle type
+ */
+export async function classifyElementFailure(selector, evaluateFn) {
+    const script = buildClassifyScript(selector);
+    // 3s timeout — classification is best-effort, must not block the error path
+    let timeoutId;
+    const timeoutPromise = new Promise(r => { timeoutId = setTimeout(() => r(null), 3000); });
+    let result;
+    try {
+        result = await Promise.race([evaluateFn(script), timeoutPromise]);
+    }
+    finally {
+        if (timeoutId)
+            clearTimeout(timeoutId);
+    }
+    // null means element was found and appeared healthy — no obstacle detected,
+    // but we still ended up here because the action failed. Fall back to generic.
+    return (result ?? 'element_not_found');
+}
+//# sourceMappingURL=obstacle-classifier.js.map

package/dist/src/obstacle-recovery/obstacle-classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"obstacle-classifier.js","sourceRoot":"","sources":["../../../src/obstacle-recovery/obstacle-classifier.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,QAAgB,EAChB,UAA4C;IAE5C,MAAM,MAAM,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAE7C,4EAA4E;IAC5E,IAAI,SAAoD,CAAC;IACzD,MAAM,cAAc,GAAG,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,GAAG,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChG,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC;IACpE,CAAC;YAAS,CAAC;QACT,IAAI,SAAS;YAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC;IACD,4EAA4E;IAC5E,8EAA8E;IAC9E,OAAO,CAAC,MAAM,IAAI,mBAAmB,CAAiB,CAAC;AACzD,CAAC"}

package/dist/src/obstacle-recovery/state-fingerprint.d.ts

@@ -0,0 +1,26 @@
+/**
+ * State fingerprint capture and comparison for obstacle recovery.
+ *
+ * Captures a lightweight snapshot of page state (URL, title, focused element,
+ * form values) before and after an action so the agent can detect whether
+ * the action had any effect.
+ */
+import type { StateFingerprint, StateComparisonResult } from './types.js';
+/**
+ * Capture a state fingerprint by evaluating a script on the current page.
+ *
+ * @param evaluateFn - mirrors the adapter's `evaluate()`: takes a JS string,
+ *   returns the serialized result.
+ * @returns A StateFingerprint, or a fallback fingerprint with empty values
+ *   if the evaluate call fails (e.g. page crashed, navigation in progress).
+ */
+export declare function captureFingerprint(evaluateFn: (script: string) => Promise<any>): Promise<StateFingerprint>;
+/**
+ * Compare two state fingerprints and classify the change.
+ *
+ * - `'navigated'` — the URL changed (different page entirely).
+ * - `'unchanged'` — every field matches (action had no visible effect).
+ * - `'changed'`   — same URL but something else differs.
+ */
+export declare function compareFingerprints(before: StateFingerprint, after: StateFingerprint): StateComparisonResult;
+//# sourceMappingURL=state-fingerprint.d.ts.map

package/dist/src/obstacle-recovery/state-fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-fingerprint.d.ts","sourceRoot":"","sources":["../../../src/obstacle-recovery/state-fingerprint.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAsB1E;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC,GAC3C,OAAO,CAAC,gBAAgB,CAAC,CAyB3B;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,gBAAgB,GACtB,qBAAqB,CAcvB"}

package/dist/src/obstacle-recovery/state-fingerprint.js

@@ -0,0 +1,85 @@
+/**
+ * State fingerprint capture and comparison for obstacle recovery.
+ *
+ * Captures a lightweight snapshot of page state (URL, title, focused element,
+ * form values) before and after an action so the agent can detect whether
+ * the action had any effect.
+ */
+/**
+ * JavaScript snippet executed on the page to collect serializable state.
+ * Returns a plain object — no DOM references — so it survives the
+ * evaluate round-trip.
+ */
+const CAPTURE_SCRIPT = `(() => {
+  const focused = document.activeElement
+    ? document.activeElement.tagName + '#' + (document.activeElement.id || '') + '.' + (document.activeElement.className || '')
+    : null;
+  const formValues = Array.from(document.querySelectorAll('input,select,textarea'))
+    .map(function(e) { var t = e.type; var k = e.name || e.id || ''; return (t === 'checkbox' || t === 'radio') ? k + '=' + e.checked : k + '=' + e.value; })
+    .join('&');
+  return {
+    url: location.href,
+    title: document.title,
+    focusedElement: focused,
+    formValues: formValues
+  };
+})()`;
+/**
+ * Capture a state fingerprint by evaluating a script on the current page.
+ *
+ * @param evaluateFn - mirrors the adapter's `evaluate()`: takes a JS string,
+ *   returns the serialized result.
+ * @returns A StateFingerprint, or a fallback fingerprint with empty values
+ *   if the evaluate call fails (e.g. page crashed, navigation in progress).
+ */
+export async function captureFingerprint(evaluateFn) {
+    try {
+        const result = await evaluateFn(CAPTURE_SCRIPT);
+        // Defensively validate the shape — the page could return anything.
+        if (result &&
+            typeof result === 'object' &&
+            typeof result.url === 'string' &&
+            typeof result.title === 'string') {
+            return {
+                url: result.url,
+                title: result.title,
+                focusedElement: result.focusedElement != null ? String(result.focusedElement) : null,
+                formValues: result.formValues != null ? String(result.formValues) : '',
+            };
+        }
+        // Result was truthy but wrong shape — return empty fingerprint.
+        return emptyFingerprint();
+    }
+    catch {
+        // Evaluate failed (page crash, navigation, timeout, etc.)
+        return emptyFingerprint();
+    }
+}
+/**
+ * Compare two state fingerprints and classify the change.
+ *
+ * - `'navigated'` — the URL changed (different page entirely).
+ * - `'unchanged'` — every field matches (action had no visible effect).
+ * - `'changed'`   — same URL but something else differs.
+ */
+export function compareFingerprints(before, after) {
+    if (before.url !== after.url) {
+        return 'navigated';
+    }
+    if (before.title === after.title &&
+        before.focusedElement === after.focusedElement &&
+        before.formValues === after.formValues) {
+        return 'unchanged';
+    }
+    return 'changed';
+}
+/** Returns a fingerprint with safe empty defaults. */
+function emptyFingerprint() {
+    return {
+        url: '',
+        title: '',
+        focusedElement: null,
+        formValues: '',
+    };
+}
+//# sourceMappingURL=state-fingerprint.js.map

package/dist/src/obstacle-recovery/state-fingerprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-fingerprint.js","sourceRoot":"","sources":["../../../src/obstacle-recovery/state-fingerprint.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;GAIG;AACH,MAAM,cAAc,GAAG;;;;;;;;;;;;;KAalB,CAAC;AAEN;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,UAA4C;IAE5C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,cAAc,CAAC,CAAC;QAChD,mEAAmE;QACnE,IACE,MAAM;YACN,OAAO,MAAM,KAAK,QAAQ;YAC1B,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ;YAC9B,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,EAChC,CAAC;YACD,OAAO;gBACL,GAAG,EAAE,MAAM,CAAC,GAAG;gBACf,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,cAAc,EACZ,MAAM,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI;gBACtE,UAAU,EACR,MAAM,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE;aAC7D,CAAC;QACJ,CAAC;QACD,gEAAgE;QAChE,OAAO,gBAAgB,EAAE,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,0DAA0D;QAC1D,OAAO,gBAAgB,EAAE,CAAC;IAC5B,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAwB,EACxB,KAAuB;IAEvB,IAAI,MAAM,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG,EAAE,CAAC;QAC7B,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,IACE,MAAM,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK;QAC5B,MAAM,CAAC,cAAc,KAAK,KAAK,CAAC,cAAc;QAC9C,MAAM,CAAC,UAAU,KAAK,KAAK,CAAC,UAAU,EACtC,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,sDAAsD;AACtD,SAAS,gBAAgB;IACvB,OAAO;QACL,GAAG,EAAE,EAAE;QACP,KAAK,EAAE,EAAE;QACT,cAAc,EAAE,IAAI;QACpB,UAAU,EAAE,EAAE;KACf,CAAC;AACJ,CAAC"}

package/dist/src/obstacle-recovery/types.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Obstacle recovery types for agent resilience.
+ * Used by state fingerprinting, obstacle classification, and escalation orchestrator.
+ */
+/** Why an element lookup or action failed — enriches ELEMENT_NOT_FOUND with actionable context. */
+export type ObstacleType = 'element_not_found' | 'element_in_iframe' | 'element_in_shadow_dom' | 'not_visible' | 'not_interactive' | 'off_screen' | 'action_no_op' | 'cross_origin_blocked';
+/** Lightweight page state for pre/post action comparison. */
+export interface StateFingerprint {
+    url: string;
+    title: string;
+    /** Tag name + id/class of the focused element, or null. */
+    focusedElement: string | null;
+    /** Serialized form values of the target region (or page-wide). */
+    formValues: string;
+    /** Optional hash of visible text content near the target element. */
+    targetHash?: string;
+}
+/** Result of comparing two state fingerprints. */
+export type StateComparisonResult = 'changed' | 'unchanged' | 'navigated';
+/** Which escalation tier resolved the action. */
+export type EscalationTier = 'css' | 'scroll_retry' | 'shadow_pierce' | 'frame_search' | 'coordinate_click' | 'keyboard' | 'handoff';
+/** Audit entry for one escalation attempt. */
+export interface EscalationAttempt {
+    tier: EscalationTier;
+    selector: string;
+    result: 'success' | 'fail' | 'no_op';
+    obstacleType?: ObstacleType;
+    timeMs: number;
+}
+/** Result of running the full escalation ladder for one action. */
+export interface EscalationResult {
+    success: boolean;
+    /** Which tier ultimately resolved the action (or 'handoff' if all failed). */
+    resolvedBy: EscalationTier;
+    /** Full audit trail of every tier attempted. */
+    attempts: EscalationAttempt[];
+    /** Total time across all tiers. */
+    totalTimeMs: number;
+    /** Obstacle classification from the final failure, if any. */
+    obstacleType?: ObstacleType;
+}
+/** Human-facing hints for each obstacle type. */
+export declare const OBSTACLE_HINTS: Record<ObstacleType, string>;
+//# sourceMappingURL=types.d.ts.map

package/dist/src/obstacle-recovery/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/obstacle-recovery/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mGAAmG;AACnG,MAAM,MAAM,YAAY,GACpB,mBAAmB,GACnB,mBAAmB,GACnB,uBAAuB,GACvB,aAAa,GACb,iBAAiB,GACjB,YAAY,GACZ,cAAc,GACd,sBAAsB,CAAC;AAE3B,6DAA6D;AAC7D,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,kDAAkD;AAClD,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,CAAC;AAE1E,iDAAiD;AACjD,MAAM,MAAM,cAAc,GACtB,KAAK,GACL,cAAc,GACd,eAAe,GACf,cAAc,GACd,kBAAkB,GAClB,UAAU,GACV,SAAS,CAAC;AAEd,8CAA8C;AAC9C,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;IACrC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,mEAAmE;AACnE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,8EAA8E;IAC9E,UAAU,EAAE,cAAc,CAAC;IAC3B,gDAAgD;IAChD,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED,iDAAiD;AACjD,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CASvD,CAAC"}

package/dist/src/obstacle-recovery/types.js

@@ -0,0 +1,16 @@
+/**
+ * Obstacle recovery types for agent resilience.
+ * Used by state fingerprinting, obstacle classification, and escalation orchestrator.
+ */
+/** Human-facing hints for each obstacle type. */
+export const OBSTACLE_HINTS = {
+    element_not_found: 'Selector matched nothing. Run `thinkrun snapshot` to inspect page structure.',
+    element_in_iframe: 'Element is inside an iframe. Try a frame-aware selector or coordinate click.',
+    element_in_shadow_dom: 'Element is inside a shadow DOM. Use `>>>` syntax: `host >>> inner-selector`.',
+    not_visible: 'Element exists but is hidden (display:none or visibility:hidden). Wait for it to become visible.',
+    not_interactive: 'Element is disabled or has pointer-events:none. Wait for it to become interactive.',
+    off_screen: 'Element exists but is outside the viewport. Scroll to it first.',
+    action_no_op: 'Action fired but page state did not change. The element may need a different interaction method.',
+    cross_origin_blocked: 'Element is in a cross-origin iframe. Use coordinate click or human handoff.',
+};
+//# sourceMappingURL=types.js.map

package/dist/src/obstacle-recovery/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/obstacle-recovery/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA4DH,iDAAiD;AACjD,MAAM,CAAC,MAAM,cAAc,GAAiC;IAC1D,iBAAiB,EAAE,8EAA8E;IACjG,iBAAiB,EAAE,8EAA8E;IACjG,qBAAqB,EAAE,8EAA8E;IACrG,WAAW,EAAE,kGAAkG;IAC/G,eAAe,EAAE,oFAAoF;IACrG,UAAU,EAAE,iEAAiE;IAC7E,YAAY,EAAE,kGAAkG;IAChH,oBAAoB,EAAE,6EAA6E;CACpG,CAAC"}

package/dist/src/output/formatter.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Output formatting utilities.
+ * Handles JSON vs pretty output modes.
+ *
+ * Use `createSpinner(text)` instead of ora() directly so that spinners
+ * are automatically suppressed in JSON mode. Use `emitJson(envelope)`
+ * to output machine-readable results in JSON mode.
+ */
+export interface JsonEnvelope {
+    success: boolean;
+    command?: string;
+    durationMs?: number;
+    data?: any;
+    error?: string;
+    code?: string;
+    hint?: string;
+    retryable?: boolean;
+    blocked?: boolean;
+    /** Resolved execution mode (when available). */
+    mode?: 'local' | 'cloud';
+    /** How mode was determined: explicit flag, context, or fallback. */
+    modeSource?: string;
+}
+/**
+ * Emit a single JSON line to stdout. Always one line — no pretty-print —
+ * so agents can reliably parse line-by-line.
+ */
+export declare function emitJson(envelope: JsonEnvelope): void;
+type SpinnerLike = {
+    succeed(msg?: string): void;
+    fail(msg?: string): void;
+    stop(): void;
+    set text(val: string);
+};
+/**
+ * Returns an ora spinner in TTY mode, or a no-op object in JSON mode.
+ * Callers should always call `spinner.succeed()` / `spinner.fail()` —
+ * in JSON mode these are silent and `emitJson()` handles output.
+ */
+export declare function createSpinner(text: string): SpinnerLike;
+export interface FormattedOutput {
+    success: boolean;
+    data?: any;
+    error?: string;
+    code?: string;
+}
+export declare function formatOutput(result: FormattedOutput, options?: {
+    json?: boolean;
+    quiet?: boolean;
+}): void;
+export declare function shouldUseJSON(globalOptions?: {
+    json?: boolean;
+}): boolean;
+export {};
+//# sourceMappingURL=formatter.d.ts.map

package/dist/src/output/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../../src/output/formatter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gDAAgD;IAChD,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IACzB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAErD;AAMD,KAAK,WAAW,GAAG;IACjB,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,IAAI,IAAI,CAAC;IACb,IAAI,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE;CACvB,CAAC;AASF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAGvD;AAMD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAWzG;AAED,wBAAgB,aAAa,CAAC,aAAa,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAEzE"}

package/dist/src/output/formatter.js

@@ -0,0 +1,55 @@
+/**
+ * Output formatting utilities.
+ * Handles JSON vs pretty output modes.
+ *
+ * Use `createSpinner(text)` instead of ora() directly so that spinners
+ * are automatically suppressed in JSON mode. Use `emitJson(envelope)`
+ * to output machine-readable results in JSON mode.
+ */
+import chalk from 'chalk';
+import ora from 'ora';
+import { isJsonMode } from './mode.js';
+// ------------------------------------------------------------------
+// JSON output
+// ------------------------------------------------------------------
+/**
+ * Emit a single JSON line to stdout. Always one line — no pretty-print —
+ * so agents can reliably parse line-by-line.
+ */
+export function emitJson(envelope) {
+    console.log(JSON.stringify(envelope));
+}
+const NOOP_SPINNER = {
+    succeed: () => { },
+    fail: () => { },
+    stop: () => { },
+    set text(_) { },
+};
+/**
+ * Returns an ora spinner in TTY mode, or a no-op object in JSON mode.
+ * Callers should always call `spinner.succeed()` / `spinner.fail()` —
+ * in JSON mode these are silent and `emitJson()` handles output.
+ */
+export function createSpinner(text) {
+    if (isJsonMode())
+        return NOOP_SPINNER;
+    return ora(text).start();
+}
+export function formatOutput(result, options) {
+    if (options?.quiet && result.success)
+        return;
+    if (options?.json || !process.stdout.isTTY) {
+        console.log(JSON.stringify(result, null, 2));
+    }
+    else {
+        if (!result.success && result.error) {
+            console.error(chalk.red('Error:'), result.error);
+            if (result.code)
+                console.error(chalk.gray(`Code: ${result.code}`));
+        }
+    }
+}
+export function shouldUseJSON(globalOptions) {
+    return globalOptions?.json === true || !process.stdout.isTTY;
+}
+//# sourceMappingURL=formatter.js.map

package/dist/src/output/formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.js","sourceRoot":"","sources":["../../../src/output/formatter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAsBvC,qEAAqE;AACrE,cAAc;AACd,qEAAqE;AAErE;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,QAAsB;IAC7C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;AACxC,CAAC;AAaD,MAAM,YAAY,GAAgB;IAChC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC;IACjB,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,IAAI,IAAI,CAAC,CAAS,IAAG,CAAC;CACvB,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,UAAU,EAAE;QAAE,OAAO,YAAY,CAAC;IACtC,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;AAC3B,CAAC;AAaD,MAAM,UAAU,YAAY,CAAC,MAAuB,EAAE,OAA6C;IACjG,IAAI,OAAO,EAAE,KAAK,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO;IAE7C,IAAI,OAAO,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;SAAM,CAAC;QACN,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACpC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YACjD,IAAI,MAAM,CAAC,IAAI;gBAAE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,aAAkC;IAC9D,OAAO,aAAa,EAAE,IAAI,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;AAC/D,CAAC"}

package/dist/src/output/mode.d.ts

@@ -0,0 +1,11 @@
+/**
+ * JSON mode singleton — shared across all commands.
+ * Set once at program startup via `setJsonMode(true)`.
+ *
+ * isJsonMode() returns true when:
+ *  1. Explicitly set via --json flag (setJsonMode(true))
+ *  2. stdout is not a TTY (piped/redirected — agent/script context)
+ */
+export declare function setJsonMode(val: boolean): void;
+export declare function isJsonMode(): boolean;
+//# sourceMappingURL=mode.d.ts.map

package/dist/src/output/mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode.d.ts","sourceRoot":"","sources":["../../../src/output/mode.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAE9C;AAED,wBAAgB,UAAU,IAAI,OAAO,CAEpC"}

package/dist/src/output/mode.js

@@ -0,0 +1,16 @@
+/**
+ * JSON mode singleton — shared across all commands.
+ * Set once at program startup via `setJsonMode(true)`.
+ *
+ * isJsonMode() returns true when:
+ *  1. Explicitly set via --json flag (setJsonMode(true))
+ *  2. stdout is not a TTY (piped/redirected — agent/script context)
+ */
+let _jsonMode = false;
+export function setJsonMode(val) {
+    _jsonMode = val;
+}
+export function isJsonMode() {
+    return _jsonMode || !process.stdout.isTTY;
+}
+//# sourceMappingURL=mode.js.map

package/dist/src/output/mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode.js","sourceRoot":"","sources":["../../../src/output/mode.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,IAAI,SAAS,GAAG,KAAK,CAAC;AAEtB,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,SAAS,GAAG,GAAG,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,SAAS,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;AAC5C,CAAC"}

package/dist/src/protected-flow/detector.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Protected-flow classification: detect when an action did not change state or hit a protected element.
+ */
+import type { BlockedOutcome, BlockerCategory } from './types.js';
+import type { StateFingerprint } from '../obstacle-recovery/types.js';
+/** Bridge can send this in action result data to signal blocked/handoff. */
+export interface BridgeBlockedHint {
+    blocked?: boolean;
+    blockedReason?: BlockerCategory | string;
+    handoffRequired?: boolean;
+    target?: string;
+}
+/**
+ * Classify a bridge result into a blocked outcome when the bridge signals blocked.
+ * Returns null when the result does not indicate a blocked flow.
+ */
+export declare function classifyFromBridgeResult(data: unknown): BlockedOutcome | null;
+/**
+ * Classify from pre/post state comparison using StateFingerprint objects.
+ * Detects no-op actions by comparing page state before and after the action.
+ *
+ * Returns null if states differ (action had an effect) or if fingerprints are missing.
+ * Returns BlockedOutcome with 'no_op_click' if page state is unchanged.
+ */
+export declare function classifyFromStateCheck(actionType: 'click' | 'type' | 'fill' | 'select', preState: StateFingerprint | string | undefined, postState: StateFingerprint | string | undefined): BlockedOutcome | null;
+//# sourceMappingURL=detector.d.ts.map

package/dist/src/protected-flow/detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../../src/protected-flow/detector.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,4EAA4E;AAC5E,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,eAAe,GAAG,MAAM,CAAC;IACzC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,OAAO,GACZ,cAAc,GAAG,IAAI,CAWvB;AAgBD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,EAChD,QAAQ,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS,EAC/C,SAAS,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAC/C,cAAc,GAAG,IAAI,CAgCvB"}