@thinkrun/cli 0.1.27

package/dist/src/adapters/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Adapter factory — resolves local vs cloud from stored session context first,
+ * then falls back to environment reachability when no context exists.
+ */
+import type { BrowserAdapter } from './types.js';
+export type AdapterTarget = 'local' | 'cloud';
+export type PreferredMode = 'local' | 'cloud';
+export declare function resolveAdapterTarget(opts: {
+    hasApiKey: boolean;
+    hasNativeHost: boolean;
+    contextMode?: 'local' | 'cloud';
+    preferredMode?: PreferredMode;
+}): AdapterTarget;
+export type ResolutionInfo = {
+    resolvedMode: AdapterTarget | null;
+    modeSource: 'explicit_local' | 'explicit_cloud' | 'context_local' | 'context_cloud' | 'fallback_local' | 'needs_explicit_cloud' | 'unavailable';
+    contextMode: 'local' | 'cloud' | undefined;
+    hasApiKey: boolean;
+    hasNativeHost: boolean;
+    bridgePort: number | undefined;
+    error?: string;
+};
+export declare function resolveReachableBridgePort(opts?: {
+    preferredMode?: PreferredMode;
+    contextMode?: 'local' | 'cloud';
+    readPort?: () => number | undefined;
+    probePort?: (port: number) => Promise<boolean>;
+    maxAttempts?: number;
+}): Promise<{
+    port: number | undefined;
+    reachable: boolean;
+}>;
+/**
+ * Returns resolution metadata for the next command (no preferredMode) or for an explicit mode.
+ * Does not throw; use for session debug and doctor.
+ */
+export declare function getResolutionInfo(preferredMode?: PreferredMode): Promise<ResolutionInfo>;
+export declare function getAdapter(preferredMode?: PreferredMode, tabOverride?: string): Promise<BrowserAdapter>;
+/**
+ * Returns true if the native host is running and healthy at the given port.
+ * Fast timeout (2s) so commands don't hang on startup.
+ */
+export declare function checkNativeHost(port?: number): Promise<boolean>;
+export { CloudAdapter } from './cloud.js';
+export { LocalAdapter } from './local.js';
+export type { BrowserAdapter } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAWjD,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,OAAO,CAAC;AAC9C,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,OAAO,CAAC;AAE9C,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAChC,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B,GAAG,aAAa,CAoChB;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,YAAY,EAAE,aAAa,GAAG,IAAI,CAAC;IACnC,UAAU,EAAE,gBAAgB,GAAG,gBAAgB,GAAG,eAAe,GAAG,eAAe,GAAG,gBAAgB,GAAG,sBAAsB,GAAG,aAAa,CAAC;IAChJ,WAAW,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;IAC3C,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAUF,wBAAsB,0BAA0B,CAAC,IAAI,GAAE;IACrD,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,WAAW,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACpC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CAsCjE;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,aAAa,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CA2E9F;AAED,wBAAsB,UAAU,CAAC,aAAa,CAAC,EAAE,aAAa,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CA+B7G;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAYrE;AAED,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/src/adapters/index.js

@@ -0,0 +1,211 @@
+/**
+ * Adapter factory — resolves local vs cloud from stored session context first,
+ * then falls back to environment reachability when no context exists.
+ */
+import { CloudAdapter } from './cloud.js';
+import { LocalAdapter } from './local.js';
+import { ApiError } from '../errors.js';
+import { config } from '../config/store.js';
+import { readBridgePort } from '../utils.js';
+import { getSessionContext } from '../session/context.js';
+import { cloudSessionMissingApiKeyError, localSessionBridgeUnavailableError, noConnectionError, } from '../session/errors.js';
+export function resolveAdapterTarget(opts) {
+    const { hasApiKey, hasNativeHost, contextMode, preferredMode } = opts;
+    if (preferredMode === 'local') {
+        if (!hasNativeHost) {
+            throw localSessionBridgeUnavailableError();
+        }
+        return 'local';
+    }
+    if (preferredMode === 'cloud') {
+        if (!hasApiKey) {
+            throw cloudSessionMissingApiKeyError();
+        }
+        return 'cloud';
+    }
+    if (contextMode === 'local') {
+        if (!hasNativeHost) {
+            throw localSessionBridgeUnavailableError();
+        }
+        return 'local';
+    }
+    if (contextMode === 'cloud') {
+        if (!hasApiKey) {
+            throw cloudSessionMissingApiKeyError();
+        }
+        return 'cloud';
+    }
+    if (hasNativeHost)
+        return 'local';
+    // Local is the default — do not silently fall back to cloud.
+    // Cloud must be explicit: --mode cloud, or a prior `thinkrun cloud start`.
+    throw noConnectionError();
+}
+/** One re-read after delay; worst-case ~250ms extra when the host is down. */
+const BRIDGE_PORT_RETRY_ATTEMPTS = 2;
+const BRIDGE_PORT_RETRY_DELAY_MS = 250;
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export async function resolveReachableBridgePort(opts = {}) {
+    const { preferredMode, contextMode, readPort = readBridgePort, probePort = checkNativeHost, maxAttempts = BRIDGE_PORT_RETRY_ATTEMPTS, } = opts;
+    const shouldProbeNativeHost = preferredMode === 'local' ||
+        (preferredMode !== 'cloud' && contextMode !== 'cloud');
+    if (!shouldProbeNativeHost) {
+        return { port: undefined, reachable: false };
+    }
+    let lastPort;
+    const raw = maxAttempts ?? BRIDGE_PORT_RETRY_ATTEMPTS;
+    const parsed = Number(raw);
+    const attempts = Math.max(1, Math.min(50, Number.isFinite(parsed) ? Math.floor(parsed) : BRIDGE_PORT_RETRY_ATTEMPTS));
+    for (let attempt = 0; attempt < attempts; attempt += 1) {
+        const port = readPort();
+        lastPort = port;
+        try {
+            if (port !== undefined && (await probePort(port))) {
+                return { port, reachable: true };
+            }
+        }
+        catch {
+            /* Treat probe rejection as unreachable; continue to re-read port / retry. */
+        }
+        if (attempt < attempts - 1) {
+            await delay(BRIDGE_PORT_RETRY_DELAY_MS);
+        }
+    }
+    return { port: lastPort, reachable: false };
+}
+/**
+ * Returns resolution metadata for the next command (no preferredMode) or for an explicit mode.
+ * Does not throw; use for session debug and doctor.
+ */
+export async function getResolutionInfo(preferredMode) {
+    const apiKey = config.get('apiKey');
+    let context;
+    try {
+        context = getSessionContext();
+    }
+    catch {
+        return {
+            resolvedMode: null,
+            modeSource: 'unavailable',
+            contextMode: undefined,
+            hasApiKey: !!apiKey,
+            hasNativeHost: false,
+            bridgePort: undefined,
+            error: 'Mixed or invalid session context',
+        };
+    }
+    const bridge = await resolveReachableBridgePort({
+        preferredMode,
+        contextMode: context?.mode,
+    });
+    const port = bridge.port;
+    const isReachable = bridge.reachable;
+    try {
+        const target = resolveAdapterTarget({
+            hasApiKey: !!apiKey,
+            hasNativeHost: isReachable,
+            contextMode: context?.mode,
+            preferredMode,
+        });
+        const modeSource = preferredMode === 'local'
+            ? 'explicit_local'
+            : preferredMode === 'cloud'
+                ? 'explicit_cloud'
+                : context?.mode === 'local'
+                    ? 'context_local'
+                    : context?.mode === 'cloud'
+                        ? 'context_cloud'
+                        : 'fallback_local';
+        return {
+            resolvedMode: target,
+            modeSource,
+            contextMode: context?.mode,
+            hasApiKey: !!apiKey,
+            hasNativeHost: isReachable,
+            bridgePort: port,
+        };
+    }
+    catch (e) {
+        // Mirror the success-path modeSource logic so that explicit/context modes
+        // are preserved in diagnostics even when resolution fails.
+        // 'needs_explicit_cloud' is reserved for the no-context, no-host, has-key
+        // case — not for local/cloud context failures.
+        const modeSource = preferredMode === 'local'
+            ? 'explicit_local'
+            : preferredMode === 'cloud'
+                ? 'explicit_cloud'
+                : context?.mode === 'local'
+                    ? 'context_local'
+                    : context?.mode === 'cloud'
+                        ? 'context_cloud'
+                        : !isReachable && !!apiKey
+                            ? 'needs_explicit_cloud'
+                            : 'unavailable';
+        return {
+            resolvedMode: null,
+            modeSource,
+            contextMode: context?.mode,
+            hasApiKey: !!apiKey,
+            hasNativeHost: isReachable,
+            bridgePort: port,
+            error: e instanceof Error ? e.message : String(e),
+        };
+    }
+}
+export async function getAdapter(preferredMode, tabOverride) {
+    const apiKey = config.get('apiKey');
+    let context;
+    try {
+        context = getSessionContext();
+    }
+    catch (error) {
+        if (error instanceof ApiError)
+            throw error;
+        throw new ApiError(error.message || 'Invalid session context');
+    }
+    const bridge = await resolveReachableBridgePort({
+        preferredMode,
+        contextMode: context?.mode,
+    });
+    const port = bridge.port;
+    const isReachable = bridge.reachable;
+    const target = resolveAdapterTarget({
+        hasApiKey: !!apiKey,
+        hasNativeHost: isReachable,
+        contextMode: context?.mode,
+        preferredMode,
+    });
+    if (target === 'cloud') {
+        if (!apiKey)
+            throw cloudSessionMissingApiKeyError();
+        if (tabOverride) {
+            process.stderr.write('[thinkrun] Warning: --tab is not supported in cloud mode, ignoring\n');
+        }
+        return new CloudAdapter(apiKey);
+    }
+    return new LocalAdapter(port, undefined, tabOverride);
+}
+/**
+ * Returns true if the native host is running and healthy at the given port.
+ * Fast timeout (2s) so commands don't hang on startup.
+ */
+export async function checkNativeHost(port) {
+    const resolvedPort = port ?? readBridgePort();
+    try {
+        const response = await fetch(`http://127.0.0.1:${resolvedPort}/health`, {
+            signal: AbortSignal.timeout(2000),
+        });
+        if (!response.ok)
+            return false;
+        const json = (await response.json());
+        return json?.data?.status === 'ok';
+    }
+    catch {
+        return false;
+    }
+}
+export { CloudAdapter } from './cloud.js';
+export { LocalAdapter } from './local.js';
+//# sourceMappingURL=index.js.map

package/dist/src/adapters/index.js.map

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

package/dist/src/adapters/local-command-retry.d.ts

@@ -0,0 +1,12 @@
+export type LocalCommandRetryKey = 'get_session' | 'list_tabs' | 'navigate' | 'go_back' | 'go_forward' | 'click' | 'fill' | 'type' | 'press' | 'hover' | 'select' | 'wait' | 'wait_for_text' | 'evaluate' | 'screenshot' | 'snapshot' | 'extract' | 'scroll' | 'get_url' | 'get_title' | 'get_html' | 'handle_dialog' | 'get_console_logs' | 'get_network_logs' | 'clear_logs' | 'unknown';
+export type TransportReplayPolicy = 'safe_same_bridge' | 'only_after_route_change' | 'never';
+export type TransportOutcomeRisk = 'no_side_effect_if_retried' | 'unknown_if_request_left_process';
+export type LocalCommandRetryProfile = {
+    key: LocalCommandRetryKey;
+    description: string;
+    transportReplay: TransportReplayPolicy;
+    outcomeRisk: TransportOutcomeRisk;
+};
+export declare function getLocalCommandRetryProfileFromPath(path: string, method: string): LocalCommandRetryProfile;
+export declare function isSafelyReplayableOnSameBridge(profile: LocalCommandRetryProfile): boolean;
+//# sourceMappingURL=local-command-retry.d.ts.map

package/dist/src/adapters/local-command-retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-command-retry.d.ts","sourceRoot":"","sources":["../../../src/adapters/local-command-retry.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAC5B,aAAa,GACb,WAAW,GACX,UAAU,GACV,SAAS,GACT,YAAY,GACZ,OAAO,GACP,MAAM,GACN,MAAM,GACN,OAAO,GACP,OAAO,GACP,QAAQ,GACR,MAAM,GACN,eAAe,GACf,UAAU,GACV,YAAY,GACZ,UAAU,GACV,SAAS,GACT,QAAQ,GACR,SAAS,GACT,WAAW,GACX,UAAU,GACV,eAAe,GACf,kBAAkB,GAClB,kBAAkB,GAClB,YAAY,GACZ,SAAS,CAAC;AAEd,MAAM,MAAM,qBAAqB,GAC7B,kBAAkB,GAClB,yBAAyB,GACzB,OAAO,CAAC;AAEZ,MAAM,MAAM,oBAAoB,GAC5B,2BAA2B,GAC3B,iCAAiC,CAAC;AAEtC,MAAM,MAAM,wBAAwB,GAAG;IACrC,GAAG,EAAE,oBAAoB,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,qBAAqB,CAAC;IAGvC,WAAW,EAAE,oBAAoB,CAAC;CACnC,CAAC;AAiKF,wBAAgB,mCAAmC,CACjD,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,wBAAwB,CA6D1B;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAKzF"}

package/dist/src/adapters/local-command-retry.js

@@ -0,0 +1,224 @@
+const LOCAL_COMMAND_RETRY_PROFILES = {
+    get_session: {
+        key: 'get_session',
+        description: 'Read current tab state',
+        transportReplay: 'safe_same_bridge',
+        outcomeRisk: 'no_side_effect_if_retried',
+    },
+    list_tabs: {
+        key: 'list_tabs',
+        description: 'List visible tabs and ownership metadata',
+        transportReplay: 'safe_same_bridge',
+        outcomeRisk: 'no_side_effect_if_retried',
+    },
+    navigate: {
+        key: 'navigate',
+        description: 'Change the page URL',
+        transportReplay: 'only_after_route_change',
+        outcomeRisk: 'unknown_if_request_left_process',
+    },
+    go_back: {
+        key: 'go_back',
+        description: 'Navigate browser history backward',
+        transportReplay: 'only_after_route_change',
+        outcomeRisk: 'unknown_if_request_left_process',
+    },
+    go_forward: {
+        key: 'go_forward',
+        description: 'Navigate browser history forward',
+        transportReplay: 'only_after_route_change',
+        outcomeRisk: 'unknown_if_request_left_process',
+    },
+    click: {
+        key: 'click',
+        description: 'Mutate page state via click',
+        transportReplay: 'only_after_route_change',
+        outcomeRisk: 'unknown_if_request_left_process',
+    },
+    fill: {
+        key: 'fill',
+        description: 'Mutate page state via form fill',
+        transportReplay: 'only_after_route_change',
+        outcomeRisk: 'unknown_if_request_left_process',
+    },
+    type: {
+        key: 'type',
+        description: 'Mutate page state via text entry',
+        transportReplay: 'only_after_route_change',
+        outcomeRisk: 'unknown_if_request_left_process',
+    },
+    press: {
+        key: 'press',
+        description: 'Mutate page state via keyboard input',
+        transportReplay: 'only_after_route_change',
+        outcomeRisk: 'unknown_if_request_left_process',
+    },
+    hover: {
+        key: 'hover',
+        description: 'Pointer movement that may trigger page behavior',
+        transportReplay: 'only_after_route_change',
+        outcomeRisk: 'unknown_if_request_left_process',
+    },
+    select: {
+        key: 'select',
+        description: 'Mutate form selection state',
+        transportReplay: 'only_after_route_change',
+        outcomeRisk: 'unknown_if_request_left_process',
+    },
+    wait: {
+        key: 'wait',
+        description: 'Observe page state until a condition is met',
+        transportReplay: 'safe_same_bridge',
+        outcomeRisk: 'no_side_effect_if_retried',
+    },
+    wait_for_text: {
+        key: 'wait_for_text',
+        description: 'Observe page text until a condition is met',
+        transportReplay: 'safe_same_bridge',
+        outcomeRisk: 'no_side_effect_if_retried',
+    },
+    evaluate: {
+        key: 'evaluate',
+        description: 'Arbitrary JavaScript execution',
+        transportReplay: 'never',
+        outcomeRisk: 'unknown_if_request_left_process',
+    },
+    screenshot: {
+        key: 'screenshot',
+        description: 'Capture current visual state',
+        transportReplay: 'never',
+        outcomeRisk: 'unknown_if_request_left_process',
+    },
+    snapshot: {
+        key: 'snapshot',
+        description: 'Capture current DOM/accessibility state',
+        transportReplay: 'safe_same_bridge',
+        outcomeRisk: 'no_side_effect_if_retried',
+    },
+    extract: {
+        key: 'extract',
+        description: 'Read page content or element data',
+        transportReplay: 'safe_same_bridge',
+        outcomeRisk: 'no_side_effect_if_retried',
+    },
+    scroll: {
+        key: 'scroll',
+        description: 'Mutate viewport position',
+        transportReplay: 'only_after_route_change',
+        outcomeRisk: 'unknown_if_request_left_process',
+    },
+    get_url: {
+        key: 'get_url',
+        description: 'Read current page URL',
+        transportReplay: 'safe_same_bridge',
+        outcomeRisk: 'no_side_effect_if_retried',
+    },
+    get_title: {
+        key: 'get_title',
+        description: 'Read current page title',
+        transportReplay: 'safe_same_bridge',
+        outcomeRisk: 'no_side_effect_if_retried',
+    },
+    get_html: {
+        key: 'get_html',
+        description: 'Read current document HTML',
+        transportReplay: 'safe_same_bridge',
+        outcomeRisk: 'no_side_effect_if_retried',
+    },
+    handle_dialog: {
+        key: 'handle_dialog',
+        description: 'Accept or dismiss browser dialog',
+        transportReplay: 'only_after_route_change',
+        outcomeRisk: 'unknown_if_request_left_process',
+    },
+    get_console_logs: {
+        key: 'get_console_logs',
+        description: 'Read console log buffer',
+        transportReplay: 'safe_same_bridge',
+        outcomeRisk: 'no_side_effect_if_retried',
+    },
+    get_network_logs: {
+        key: 'get_network_logs',
+        description: 'Read network log buffer',
+        transportReplay: 'safe_same_bridge',
+        outcomeRisk: 'no_side_effect_if_retried',
+    },
+    clear_logs: {
+        key: 'clear_logs',
+        description: 'Clear buffered console/network logs',
+        transportReplay: 'only_after_route_change',
+        outcomeRisk: 'unknown_if_request_left_process',
+    },
+    unknown: {
+        key: 'unknown',
+        description: 'Unknown local bridge command',
+        transportReplay: 'never',
+        outcomeRisk: 'unknown_if_request_left_process',
+    },
+};
+export function getLocalCommandRetryProfileFromPath(path, method) {
+    const normalizedMethod = method.toUpperCase();
+    if (normalizedMethod === 'GET' && path === '/tabs') {
+        return LOCAL_COMMAND_RETRY_PROFILES.list_tabs;
+    }
+    if (normalizedMethod === 'GET' && /^\/sessions\/[^/]+$/.test(path)) {
+        return LOCAL_COMMAND_RETRY_PROFILES.get_session;
+    }
+    const actionMatch = path.match(/^\/sessions\/[^/]+\/([a-z-]+)$/);
+    const action = actionMatch?.[1];
+    switch (action) {
+        case 'navigate':
+            return LOCAL_COMMAND_RETRY_PROFILES.navigate;
+        case 'go-back':
+            return LOCAL_COMMAND_RETRY_PROFILES.go_back;
+        case 'go-forward':
+            return LOCAL_COMMAND_RETRY_PROFILES.go_forward;
+        case 'click':
+            return LOCAL_COMMAND_RETRY_PROFILES.click;
+        case 'fill':
+            return LOCAL_COMMAND_RETRY_PROFILES.fill;
+        case 'type':
+            return LOCAL_COMMAND_RETRY_PROFILES.type;
+        case 'press':
+            return LOCAL_COMMAND_RETRY_PROFILES.press;
+        case 'hover':
+            return LOCAL_COMMAND_RETRY_PROFILES.hover;
+        case 'select':
+            return LOCAL_COMMAND_RETRY_PROFILES.select;
+        case 'wait':
+            return LOCAL_COMMAND_RETRY_PROFILES.wait;
+        case 'wait-for-text':
+            return LOCAL_COMMAND_RETRY_PROFILES.wait_for_text;
+        case 'evaluate':
+            return LOCAL_COMMAND_RETRY_PROFILES.evaluate;
+        case 'screenshot':
+            return LOCAL_COMMAND_RETRY_PROFILES.screenshot;
+        case 'snapshot':
+            return LOCAL_COMMAND_RETRY_PROFILES.snapshot;
+        case 'extract':
+            return LOCAL_COMMAND_RETRY_PROFILES.extract;
+        case 'scroll':
+            return LOCAL_COMMAND_RETRY_PROFILES.scroll;
+        case 'url':
+            return LOCAL_COMMAND_RETRY_PROFILES.get_url;
+        case 'title':
+            return LOCAL_COMMAND_RETRY_PROFILES.get_title;
+        case 'html':
+            return LOCAL_COMMAND_RETRY_PROFILES.get_html;
+        case 'dialog':
+            return LOCAL_COMMAND_RETRY_PROFILES.handle_dialog;
+        case 'console':
+            return LOCAL_COMMAND_RETRY_PROFILES.get_console_logs;
+        case 'network':
+            return LOCAL_COMMAND_RETRY_PROFILES.get_network_logs;
+        case 'clear-logs':
+            return LOCAL_COMMAND_RETRY_PROFILES.clear_logs;
+        default:
+            return LOCAL_COMMAND_RETRY_PROFILES.unknown;
+    }
+}
+export function isSafelyReplayableOnSameBridge(profile) {
+    return (profile.transportReplay === 'safe_same_bridge'
+        && profile.outcomeRisk === 'no_side_effect_if_retried');
+}
+//# sourceMappingURL=local-command-retry.js.map

package/dist/src/adapters/local-command-retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-command-retry.js","sourceRoot":"","sources":["../../../src/adapters/local-command-retry.ts"],"names":[],"mappings":"AA8CA,MAAM,4BAA4B,GAA2D;IAC3F,WAAW,EAAE;QACX,GAAG,EAAE,aAAa;QAClB,WAAW,EAAE,wBAAwB;QACrC,eAAe,EAAE,kBAAkB;QACnC,WAAW,EAAE,2BAA2B;KACzC;IACD,SAAS,EAAE;QACT,GAAG,EAAE,WAAW;QAChB,WAAW,EAAE,0CAA0C;QACvD,eAAe,EAAE,kBAAkB;QACnC,WAAW,EAAE,2BAA2B;KACzC;IACD,QAAQ,EAAE;QACR,GAAG,EAAE,UAAU;QACf,WAAW,EAAE,qBAAqB;QAClC,eAAe,EAAE,yBAAyB;QAC1C,WAAW,EAAE,iCAAiC;KAC/C;IACD,OAAO,EAAE;QACP,GAAG,EAAE,SAAS;QACd,WAAW,EAAE,mCAAmC;QAChD,eAAe,EAAE,yBAAyB;QAC1C,WAAW,EAAE,iCAAiC;KAC/C;IACD,UAAU,EAAE;QACV,GAAG,EAAE,YAAY;QACjB,WAAW,EAAE,kCAAkC;QAC/C,eAAe,EAAE,yBAAyB;QAC1C,WAAW,EAAE,iCAAiC;KAC/C;IACD,KAAK,EAAE;QACL,GAAG,EAAE,OAAO;QACZ,WAAW,EAAE,6BAA6B;QAC1C,eAAe,EAAE,yBAAyB;QAC1C,WAAW,EAAE,iCAAiC;KAC/C;IACD,IAAI,EAAE;QACJ,GAAG,EAAE,MAAM;QACX,WAAW,EAAE,iCAAiC;QAC9C,eAAe,EAAE,yBAAyB;QAC1C,WAAW,EAAE,iCAAiC;KAC/C;IACD,IAAI,EAAE;QACJ,GAAG,EAAE,MAAM;QACX,WAAW,EAAE,kCAAkC;QAC/C,eAAe,EAAE,yBAAyB;QAC1C,WAAW,EAAE,iCAAiC;KAC/C;IACD,KAAK,EAAE;QACL,GAAG,EAAE,OAAO;QACZ,WAAW,EAAE,sCAAsC;QACnD,eAAe,EAAE,yBAAyB;QAC1C,WAAW,EAAE,iCAAiC;KAC/C;IACD,KAAK,EAAE;QACL,GAAG,EAAE,OAAO;QACZ,WAAW,EAAE,iDAAiD;QAC9D,eAAe,EAAE,yBAAyB;QAC1C,WAAW,EAAE,iCAAiC;KAC/C;IACD,MAAM,EAAE;QACN,GAAG,EAAE,QAAQ;QACb,WAAW,EAAE,6BAA6B;QAC1C,eAAe,EAAE,yBAAyB;QAC1C,WAAW,EAAE,iCAAiC;KAC/C;IACD,IAAI,EAAE;QACJ,GAAG,EAAE,MAAM;QACX,WAAW,EAAE,6CAA6C;QAC1D,eAAe,EAAE,kBAAkB;QACnC,WAAW,EAAE,2BAA2B;KACzC;IACD,aAAa,EAAE;QACb,GAAG,EAAE,eAAe;QACpB,WAAW,EAAE,4CAA4C;QACzD,eAAe,EAAE,kBAAkB;QACnC,WAAW,EAAE,2BAA2B;KACzC;IACD,QAAQ,EAAE;QACR,GAAG,EAAE,UAAU;QACf,WAAW,EAAE,gCAAgC;QAC7C,eAAe,EAAE,OAAO;QACxB,WAAW,EAAE,iCAAiC;KAC/C;IACD,UAAU,EAAE;QACV,GAAG,EAAE,YAAY;QACjB,WAAW,EAAE,8BAA8B;QAC3C,eAAe,EAAE,OAAO;QACxB,WAAW,EAAE,iCAAiC;KAC/C;IACD,QAAQ,EAAE;QACR,GAAG,EAAE,UAAU;QACf,WAAW,EAAE,yCAAyC;QACtD,eAAe,EAAE,kBAAkB;QACnC,WAAW,EAAE,2BAA2B;KACzC;IACD,OAAO,EAAE;QACP,GAAG,EAAE,SAAS;QACd,WAAW,EAAE,mCAAmC;QAChD,eAAe,EAAE,kBAAkB;QACnC,WAAW,EAAE,2BAA2B;KACzC;IACD,MAAM,EAAE;QACN,GAAG,EAAE,QAAQ;QACb,WAAW,EAAE,0BAA0B;QACvC,eAAe,EAAE,yBAAyB;QAC1C,WAAW,EAAE,iCAAiC;KAC/C;IACD,OAAO,EAAE;QACP,GAAG,EAAE,SAAS;QACd,WAAW,EAAE,uBAAuB;QACpC,eAAe,EAAE,kBAAkB;QACnC,WAAW,EAAE,2BAA2B;KACzC;IACD,SAAS,EAAE;QACT,GAAG,EAAE,WAAW;QAChB,WAAW,EAAE,yBAAyB;QACtC,eAAe,EAAE,kBAAkB;QACnC,WAAW,EAAE,2BAA2B;KACzC;IACD,QAAQ,EAAE;QACR,GAAG,EAAE,UAAU;QACf,WAAW,EAAE,4BAA4B;QACzC,eAAe,EAAE,kBAAkB;QACnC,WAAW,EAAE,2BAA2B;KACzC;IACD,aAAa,EAAE;QACb,GAAG,EAAE,eAAe;QACpB,WAAW,EAAE,kCAAkC;QAC/C,eAAe,EAAE,yBAAyB;QAC1C,WAAW,EAAE,iCAAiC;KAC/C;IACD,gBAAgB,EAAE;QAChB,GAAG,EAAE,kBAAkB;QACvB,WAAW,EAAE,yBAAyB;QACtC,eAAe,EAAE,kBAAkB;QACnC,WAAW,EAAE,2BAA2B;KACzC;IACD,gBAAgB,EAAE;QAChB,GAAG,EAAE,kBAAkB;QACvB,WAAW,EAAE,yBAAyB;QACtC,eAAe,EAAE,kBAAkB;QACnC,WAAW,EAAE,2BAA2B;KACzC;IACD,UAAU,EAAE;QACV,GAAG,EAAE,YAAY;QACjB,WAAW,EAAE,qCAAqC;QAClD,eAAe,EAAE,yBAAyB;QAC1C,WAAW,EAAE,iCAAiC;KAC/C;IACD,OAAO,EAAE;QACP,GAAG,EAAE,SAAS;QACd,WAAW,EAAE,8BAA8B;QAC3C,eAAe,EAAE,OAAO;QACxB,WAAW,EAAE,iCAAiC;KAC/C;CACF,CAAC;AAEF,MAAM,UAAU,mCAAmC,CACjD,IAAY,EACZ,MAAc;IAEd,MAAM,gBAAgB,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IAC9C,IAAI,gBAAgB,KAAK,KAAK,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACnD,OAAO,4BAA4B,CAAC,SAAS,CAAC;IAChD,CAAC;IACD,IAAI,gBAAgB,KAAK,KAAK,IAAI,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACnE,OAAO,4BAA4B,CAAC,WAAW,CAAC;IAClD,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;IAChC,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,UAAU;YACb,OAAO,4BAA4B,CAAC,QAAQ,CAAC;QAC/C,KAAK,SAAS;YACZ,OAAO,4BAA4B,CAAC,OAAO,CAAC;QAC9C,KAAK,YAAY;YACf,OAAO,4BAA4B,CAAC,UAAU,CAAC;QACjD,KAAK,OAAO;YACV,OAAO,4BAA4B,CAAC,KAAK,CAAC;QAC5C,KAAK,MAAM;YACT,OAAO,4BAA4B,CAAC,IAAI,CAAC;QAC3C,KAAK,MAAM;YACT,OAAO,4BAA4B,CAAC,IAAI,CAAC;QAC3C,KAAK,OAAO;YACV,OAAO,4BAA4B,CAAC,KAAK,CAAC;QAC5C,KAAK,OAAO;YACV,OAAO,4BAA4B,CAAC,KAAK,CAAC;QAC5C,KAAK,QAAQ;YACX,OAAO,4BAA4B,CAAC,MAAM,CAAC;QAC7C,KAAK,MAAM;YACT,OAAO,4BAA4B,CAAC,IAAI,CAAC;QAC3C,KAAK,eAAe;YAClB,OAAO,4BAA4B,CAAC,aAAa,CAAC;QACpD,KAAK,UAAU;YACb,OAAO,4BAA4B,CAAC,QAAQ,CAAC;QAC/C,KAAK,YAAY;YACf,OAAO,4BAA4B,CAAC,UAAU,CAAC;QACjD,KAAK,UAAU;YACb,OAAO,4BAA4B,CAAC,QAAQ,CAAC;QAC/C,KAAK,SAAS;YACZ,OAAO,4BAA4B,CAAC,OAAO,CAAC;QAC9C,KAAK,QAAQ;YACX,OAAO,4BAA4B,CAAC,MAAM,CAAC;QAC7C,KAAK,KAAK;YACR,OAAO,4BAA4B,CAAC,OAAO,CAAC;QAC9C,KAAK,OAAO;YACV,OAAO,4BAA4B,CAAC,SAAS,CAAC;QAChD,KAAK,MAAM;YACT,OAAO,4BAA4B,CAAC,QAAQ,CAAC;QAC/C,KAAK,QAAQ;YACX,OAAO,4BAA4B,CAAC,aAAa,CAAC;QACpD,KAAK,SAAS;YACZ,OAAO,4BAA4B,CAAC,gBAAgB,CAAC;QACvD,KAAK,SAAS;YACZ,OAAO,4BAA4B,CAAC,gBAAgB,CAAC;QACvD,KAAK,YAAY;YACf,OAAO,4BAA4B,CAAC,UAAU,CAAC;QACjD;YACE,OAAO,4BAA4B,CAAC,OAAO,CAAC;IAChD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,OAAiC;IAC9E,OAAO,CACL,OAAO,CAAC,eAAe,KAAK,kBAAkB;WAC3C,OAAO,CAAC,WAAW,KAAK,2BAA2B,CACvD,CAAC;AACJ,CAAC"}

package/dist/src/adapters/local.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Local adapter — routes browser actions to the native host HTTP API
+ * (localhost:PORT/sessions/:tabId/*). No API key required; uses the
+ * active tabId stored by `thinkrun attach`.
+ */
+import type { BrowserAdapter } from './types.js';
+import type { Session, SessionOptions, ActionResult, NavigateOptions, ClickOptions, TypeOptions, ScreenshotOptions, ExtractOptions, WaitOptions, DialogResult, ConsoleResult, NetworkResult } from '../types.js';
+import { readBridgePort } from '../utils.js';
+import type { BlockedOutcome } from '../protected-flow/types.js';
+/** Actionable hint for native host error codes (TTY tips and JSON `hint` field). */
+export declare function getNativeCodeHint(code: string | undefined): string | undefined;
+export declare class LocalAdapter implements BrowserAdapter {
+    private baseUrl;
+    private defaultTimeout;
+    private validatedTabCache;
+    private readonly TAB_CACHE_TTL_MS;
+    /** Injected fetch function — allows unit tests to intercept all HTTP calls. */
+    private readonly fetchFn;
+    /**
+     * When set (via --tab flag or THINKRUN_TAB_ID env), bypasses the global
+     * working-location.json entirely. Each command targets this tab directly.
+     */
+    private readonly tabOverride;
+    private readonly readBridgePortFn;
+    private readonly diagnosticsEnabled;
+    constructor(port?: number, fetchFn?: typeof fetch, tabOverride?: string, readBridgePortFn?: typeof readBridgePort);
+    /** Read the agent session ID from config (set by `thinkrun attach`). */
+    private getAgentSessionId;
+    private rethrowTabLock;
+    /**
+     * Fire-and-forget: sync a browser action to the cloud session activity feed.
+     * No-op if no cloud sessionId is persisted for the tab (e.g. no API key configured).
+     * Never throws, never blocks the caller.
+     */
+    private syncAction;
+    private refreshBaseUrl;
+    private isTransientBridgeError;
+    private isPreDispatchBridgeDisconnect;
+    private logDiagnostics;
+    private probeBridgeHealth;
+    private getLiveExtensionDisconnectHint;
+    private isRecentDisconnectedState;
+    private revalidateExtensionConnection;
+    private extractTabIdFromSessionPath;
+    private tryRecoverMissingSession;
+    private tryRepairMissingMutatingAuthority;
+    /**
+     * Pre-action check: if this process has a working location set (via `attach`
+     * or `new-window`) and the configured active tab has drifted away from it,
+     * silently re-switch the bridge to the working-location tab.
+     *
+     * This prevents "tab stolen by another agent" where a second agent's `attach`
+     * changes the bridge's active tab mid-session.
+     */
+    private ensureWorkingLocationTab;
+    private assertOwnedTab;
+    /**
+     * Returns the active tab ID, validating it still exists against the native
+     * host's /tabs list. Results are cached within this adapter instance's lifetime
+     * (a single CLI command invocation). The cache does NOT persist between commands —
+     * the CLI starts a new process for each invocation so `validatedTabCache` is always
+     * empty at command start. Clears the stored local session if the tab is gone.
+     */
+    private getActiveTabId;
+    private request;
+    /**
+     * In local mode this does not start a cloud browser.  However, if an API
+     * key is configured the session is registered in the cloud activity feed
+     * so screenshots and actions appear alongside cloud/extension sessions.
+     * Without an API key this is a silent no-op (no error).
+     */
+    startSession(_options?: SessionOptions): Promise<Session>;
+    /**
+     * In local mode this does not stop a cloud browser.  If a session was
+     * registered via startSession(), a fire-and-forget local-close request
+     * is sent to mark it completed in the activity feed.
+     */
+    stopSession(_sessionId?: string): Promise<void>;
+    getSession(sessionId: string): Promise<Session>;
+    listSessions(): Promise<Session[]>;
+    waitForSessionReady(sessionId: string, _timeout?: number): Promise<Session>;
+    navigate(url: string, options?: NavigateOptions): Promise<ActionResult>;
+    goBack(): Promise<ActionResult>;
+    goForward(): Promise<ActionResult>;
+    /** Evaluate function suitable for captureFingerprint / classifyElementFailure. */
+    private evaluateForFingerprint;
+    /** Capture fingerprint with a 3s timeout to avoid blocking the primary action. */
+    private tryCaptureFP;
+    /** A fingerprint with empty url means capture failed — skip comparison. */
+    private static isFingerprintValid;
+    /**
+     * Enrich an ELEMENT_NOT_FOUND ApiError with obstacle classification.
+     * Runs classifyElementFailure to determine WHY the selector failed,
+     * then attaches the result as `obstacleType` on the error object.
+     * If classification itself fails, returns the original error unchanged.
+     */
+    private enrichElementNotFound;
+    click(selector: string, options?: ClickOptions): Promise<ActionResult & {
+        data?: BlockedOutcome;
+    }>;
+    type(selector: string, text: string, options?: TypeOptions): Promise<ActionResult & {
+        data?: BlockedOutcome;
+    }>;
+    fill(selector: string, value: string): Promise<ActionResult & {
+        data?: BlockedOutcome;
+    }>;
+    press(key: string): Promise<ActionResult>;
+    scroll(options: {
+        selector?: string;
+        x?: number;
+        y?: number;
+    }): Promise<ActionResult>;
+    hover(selector: string): Promise<ActionResult>;
+    select(selector: string, value: string): Promise<ActionResult & {
+        data?: BlockedOutcome;
+    }>;
+    wait(condition: string | number, options?: WaitOptions): Promise<ActionResult>;
+    waitForText(text: string, options?: {
+        timeout?: number;
+    }): Promise<ActionResult>;
+    snapshot(): Promise<ActionResult>;
+    screenshot(options?: ScreenshotOptions): Promise<ActionResult>;
+    extract(selector: string, options?: ExtractOptions): Promise<ActionResult>;
+    evaluate(script: string, args?: any[], evalOpts?: {
+        timeout?: number;
+    }): Promise<ActionResult>;
+    getUrl(): Promise<ActionResult>;
+    getTitle(): Promise<ActionResult>;
+    getHtml(): Promise<ActionResult>;
+    getDialog(): Promise<DialogResult>;
+    handleDialog(action: 'accept' | 'dismiss', promptText?: string): Promise<ActionResult>;
+    getConsoleMessages(): Promise<ConsoleResult>;
+    getNetworkRequests(): Promise<NetworkResult>;
+    clearLogs(): Promise<ActionResult>;
+}
+//# sourceMappingURL=local.d.ts.map