@thinkrun/cli 0.1.27

package/dist/src/types.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Shared TypeScript types for ThinkRun CLI
+ */
+export interface SessionOptions {
+    browser?: 'chromium' | 'firefox' | 'webkit';
+    proxy?: boolean;
+    stealth?: boolean;
+    headless?: boolean;
+}
+export interface Session {
+    sessionId: string;
+    status: 'pending' | 'creating' | 'provisioning' | 'active' | 'ready' | 'running' | 'busy' | 'error' | 'failed' | 'terminated' | 'closed';
+    currentUrl?: string;
+    title?: string;
+    createdAt: string;
+    isFlyMachine?: boolean;
+    machineId?: string;
+    actionCount?: number;
+}
+export interface ActionResult {
+    success: boolean;
+    data?: any;
+    error?: string;
+}
+export interface NavigateOptions {
+    waitUntil?: 'load' | 'domcontentloaded' | 'networkidle';
+    timeout?: number;
+    waitFor?: string;
+}
+export interface ClickOptions {
+    button?: 'left' | 'right' | 'middle';
+    count?: number;
+    delay?: number;
+    timeout?: number;
+}
+export interface TypeOptions {
+    delay?: number;
+    clear?: boolean;
+    mask?: boolean;
+}
+export interface ScreenshotOptions {
+    output?: string;
+    fullPage?: boolean;
+    selector?: string;
+    format?: 'png' | 'jpeg' | 'webp';
+    quality?: number;
+    maxDimension?: number;
+    caption?: string;
+}
+export interface ExtractOptions {
+    all?: boolean;
+    attr?: string;
+    format?: 'text' | 'json' | 'html';
+}
+export interface WaitOptions {
+    visible?: boolean;
+    hidden?: boolean;
+    timeout?: number;
+}
+export interface CLIConfig {
+    apiKey?: string;
+    /** Quarantined schema-invalid apiKey value (PRD 0086 B1). */
+    apiKeyInvalid?: string;
+    apiUrl?: string;
+    defaultBrowser?: string;
+    extensionId?: string;
+    registeredExtensionId?: string;
+    preferPackagedDefaultExtensionId?: boolean;
+    nativeHostVersion?: string;
+    nativeHostChecksum?: string;
+    localTabId?: string;
+    localAgentSessionId?: string;
+    cloudSessionId?: string;
+    activeSessionId?: string;
+    agentSessionId?: string;
+    /**
+     * Local transport mode (PRD 0086 Track A).
+     * 'native' (default): use native messaging host (classic path, unchanged behaviour).
+     * 'daemon': route CLI/MCP requests through the bridge daemon process.
+     *
+     * Note: the daemon is only spawned when THINKRUN_DAEMON_SPIKE=1 env flag is set
+     * (THINKBROWSE_DAEMON_SPIKE is still accepted as a legacy fallback).
+     * (host-side gate). Wiring config→env automatically is a task 6.11 follow-up.
+     */
+    localTransport?: 'native' | 'daemon';
+}
+export interface OutputOptions {
+    json?: boolean;
+    quiet?: boolean;
+    verbose?: boolean;
+}
+export interface DialogResult {
+    success: boolean;
+    hasDialog?: boolean;
+    dialog?: {
+        type: string;
+        message: string;
+        defaultValue?: string;
+    } | null;
+    history?: Array<{
+        type: string;
+        message: string;
+        action: string;
+        timestamp: string;
+    }>;
+    error?: string;
+}
+export interface ConsoleResult {
+    success: boolean;
+    logs?: Array<{
+        level: string;
+        text: string;
+        timestamp?: string;
+        url?: string;
+    }>;
+    count?: number;
+    error?: string;
+}
+export interface NetworkResult {
+    success: boolean;
+    requests?: Array<{
+        url: string;
+        method: string;
+        status?: number;
+        type?: string;
+        size?: number;
+    }>;
+    count?: number;
+    error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

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

package/dist/src/types.js

@@ -0,0 +1,5 @@
+/**
+ * Shared TypeScript types for ThinkRun CLI
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/src/utils.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Shared utility functions
+ */
+/** Default next-step hint when cloud API authentication fails. */
+export declare const API_KEY_HELP_FALLBACK = "Run `thinkrun doctor` or check your API key at https://thinkbrowse.io/settings";
+export declare function handleError(error: any, command?: string, startMs?: number): never;
+export declare function isLocalApiUrl(apiUrl: string): boolean;
+export declare const DEFAULT_BRIDGE_PORT = 3012;
+/**
+ * Longer timeout for cold-start / health GET /tabs checks (e.g. embed verify script).
+ * Interactive CLI bridge calls should use {@link BRIDGE_REQUEST_TIMEOUT_MS}.
+ */
+export declare const BRIDGE_HEALTH_PROBE_TIMEOUT_MS = 30000;
+/**
+ * Default timeout for routine HTTP calls to the local native-host bridge
+ * (tab list, tab switch, session register, tab validation, task status/cancel).
+ * Keeps failures responsive when the bridge is down (vs waiting for cold-start).
+ */
+export declare const BRIDGE_REQUEST_TIMEOUT_MS = 10000;
+/**
+ * Bridge evaluate responses sometimes nest the return value in `data.result`
+ * (native host / test doubles). Fingerprint capture and obstacle classification
+ * expect the unwrapped value. Only unwraps a plain `{ result: ... }` wrapper
+ * (sole own enumerable string key `result`) so objects that legitimately
+ * include other fields alongside `result` are left intact. Only one level is
+ * unwrapped per call.
+ */
+export declare function unwrapEvaluatePayload(data: unknown): unknown;
+/**
+ * Read the native host bridge port from ~/.thinkbrowse/port.
+ * This path is intentionally frozen during the internal pass.
+ * Falls back to DEFAULT_BRIDGE_PORT if the file is missing or unparseable.
+ * This utility is shared by the doctor, tabs, and attach commands.
+ */
+export declare function readBridgePort(portFilePath?: string): number;
+/**
+ * Modification time of `~/.thinkbrowse/port` when present (ms since epoch).
+ * This path is intentionally frozen during the internal pass.
+ * Used by `thinkrun doctor` to warn when the file may be stale after a port rotation.
+ */
+export declare function getBridgePortFileMtimeMs(portFilePath?: string): number | null;
+/**
+ * When the port file is older than `maxAgeMs` relative to `nowMs`, returns the file's age in ms;
+ * otherwise null (fresh or missing file — missing yields null from stat).
+ */
+export declare function getStaleBridgePortFileAgeMs(mtimeMs: number | null, opts?: {
+    nowMs?: number;
+    maxAgeMs?: number;
+}): number | null;
+//# sourceMappingURL=utils.d.ts.map

package/dist/src/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH,kEAAkE;AAClE,eAAO,MAAM,qBAAqB,mFACgD,CAAC;AAEnF,wBAAgB,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CA0CjF;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAQrD;AAED,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC;;;GAGG;AACH,eAAO,MAAM,8BAA8B,QAA8C,CAAC;AAE1F;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,QAAyC,CAAC;AAEhF;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAS5D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,YAAY,SAA0C,GAAG,MAAM,CAY7F;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,SAA0C,GAAG,MAAM,GAAG,IAAI,CAM9G;AAID;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3C,MAAM,GAAG,IAAI,CAMf"}

package/dist/src/utils.js

@@ -0,0 +1,147 @@
+/**
+ * Shared utility functions
+ */
+import chalk from 'chalk';
+import { existsSync, readFileSync, statSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { ApiError, SessionError, ThinkRunError } from './errors.js';
+import { isJsonMode } from './output/mode.js';
+import { LOCAL_BRIDGE_HEALTH_PROBE_TIMEOUT_MS as SHARED_LOCAL_BRIDGE_HEALTH_PROBE_TIMEOUT_MS, LOCAL_BRIDGE_REQUEST_TIMEOUT_MS as SHARED_LOCAL_BRIDGE_REQUEST_TIMEOUT_MS, } from './local-bridge-timing.js';
+/** Default next-step hint when cloud API authentication fails. */
+export const API_KEY_HELP_FALLBACK = 'Run `thinkrun doctor` or check your API key at https://thinkbrowse.io/settings';
+export function handleError(error, command, startMs) {
+    const durationMs = startMs !== undefined ? Date.now() - startMs : undefined;
+    if (isJsonMode()) {
+        const envelope = { success: false };
+        if (command)
+            envelope.command = command;
+        if (durationMs !== undefined)
+            envelope.durationMs = durationMs;
+        if (error instanceof ThinkRunError) {
+            envelope.error = error.message;
+            envelope.code = (error instanceof ApiError && error.nativeCode)
+                ? error.nativeCode
+                : error.code;
+            if (error instanceof ApiError && error.retryable !== undefined) {
+                envelope.retryable = error.retryable;
+            }
+            if (error.suggestion)
+                envelope.hint = error.suggestion;
+            if (error instanceof ApiError && error.upgradeUrl) {
+                envelope.upgradeUrl = error.upgradeUrl;
+            }
+        }
+        else {
+            envelope.error = error.message || String(error);
+            envelope.code = 'INTERNAL_ERROR';
+        }
+        process.stderr.write(JSON.stringify(envelope) + '\n');
+        process.exit(1);
+    }
+    // TTY mode
+    if (error instanceof ApiError || error instanceof SessionError) {
+        console.error(chalk.red('Error:'), error.message);
+        if (error instanceof ApiError && error.nativeCode === 'INSUFFICIENT_SCOPE' && error.upgradeUrl) {
+            console.error(chalk.yellow('Upgrade:'), error.upgradeUrl);
+        }
+        if (error.suggestion) {
+            console.error(chalk.yellow('Tip:'), error.suggestion);
+        }
+    }
+    else {
+        console.error(chalk.red('Error:'), error.message || error);
+    }
+    process.exit(1);
+}
+export function isLocalApiUrl(apiUrl) {
+    try {
+        const u = new URL(apiUrl);
+        if (u.protocol !== 'http:' && u.protocol !== 'https:')
+            return false;
+        return u.hostname === 'localhost' || u.hostname === '127.0.0.1' || u.hostname === '[::1]';
+    }
+    catch {
+        return false;
+    }
+}
+export const DEFAULT_BRIDGE_PORT = 3012;
+/**
+ * Longer timeout for cold-start / health GET /tabs checks (e.g. embed verify script).
+ * Interactive CLI bridge calls should use {@link BRIDGE_REQUEST_TIMEOUT_MS}.
+ */
+export const BRIDGE_HEALTH_PROBE_TIMEOUT_MS = SHARED_LOCAL_BRIDGE_HEALTH_PROBE_TIMEOUT_MS;
+/**
+ * Default timeout for routine HTTP calls to the local native-host bridge
+ * (tab list, tab switch, session register, tab validation, task status/cancel).
+ * Keeps failures responsive when the bridge is down (vs waiting for cold-start).
+ */
+export const BRIDGE_REQUEST_TIMEOUT_MS = SHARED_LOCAL_BRIDGE_REQUEST_TIMEOUT_MS;
+/**
+ * Bridge evaluate responses sometimes nest the return value in `data.result`
+ * (native host / test doubles). Fingerprint capture and obstacle classification
+ * expect the unwrapped value. Only unwraps a plain `{ result: ... }` wrapper
+ * (sole own enumerable string key `result`) so objects that legitimately
+ * include other fields alongside `result` are left intact. Only one level is
+ * unwrapped per call.
+ */
+export function unwrapEvaluatePayload(data) {
+    if (data === null || data === undefined)
+        return data;
+    if (typeof data !== 'object')
+        return data;
+    const o = data;
+    const keys = Object.keys(o);
+    if (keys.length === 1 && Object.prototype.hasOwnProperty.call(o, 'result')) {
+        return o.result;
+    }
+    return data;
+}
+/**
+ * Read the native host bridge port from ~/.thinkbrowse/port.
+ * This path is intentionally frozen during the internal pass.
+ * Falls back to DEFAULT_BRIDGE_PORT if the file is missing or unparseable.
+ * This utility is shared by the doctor, tabs, and attach commands.
+ */
+export function readBridgePort(portFilePath = join(homedir(), '.thinkbrowse', 'port')) {
+    if (!existsSync(portFilePath))
+        return DEFAULT_BRIDGE_PORT;
+    try {
+        const raw = readFileSync(portFilePath, 'utf-8').trim();
+        const parsed = Number(raw);
+        if (Number.isInteger(parsed) && parsed > 0 && parsed <= 65535) {
+            return parsed;
+        }
+    }
+    catch {
+        // ignore
+    }
+    return DEFAULT_BRIDGE_PORT;
+}
+/**
+ * Modification time of `~/.thinkbrowse/port` when present (ms since epoch).
+ * This path is intentionally frozen during the internal pass.
+ * Used by `thinkrun doctor` to warn when the file may be stale after a port rotation.
+ */
+export function getBridgePortFileMtimeMs(portFilePath = join(homedir(), '.thinkbrowse', 'port')) {
+    try {
+        return statSync(portFilePath).mtimeMs;
+    }
+    catch {
+        return null;
+    }
+}
+const DEFAULT_STALE_BRIDGE_PORT_FILE_MS = 5 * 60 * 1000;
+/**
+ * When the port file is older than `maxAgeMs` relative to `nowMs`, returns the file's age in ms;
+ * otherwise null (fresh or missing file — missing yields null from stat).
+ */
+export function getStaleBridgePortFileAgeMs(mtimeMs, opts) {
+    if (mtimeMs === null)
+        return null;
+    const nowMs = opts?.nowMs ?? Date.now();
+    const maxAgeMs = opts?.maxAgeMs ?? DEFAULT_STALE_BRIDGE_PORT_FILE_MS;
+    const ageMs = nowMs - mtimeMs;
+    return ageMs > maxAgeMs ? ageMs : null;
+}
+//# sourceMappingURL=utils.js.map

package/dist/src/utils.js.map

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

package/dist/src/working-location.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Working location and per-tab lock file management for CLI agent isolation.
+ *
+ * Each agent process that calls `thinkrun attach` or `thinkrun new-window`
+ * acquires an exclusive lock on the target Chrome tab so that two agents running
+ * simultaneously cannot clash on the same tab.
+ *
+ * Files written under `~/.thinkrun/` (or THINKRUN_LOCK_DIR in tests):
+ *   locks/{tabId}.lock      — who currently owns this tab (persists across commands)
+ *   working-location.json   — which tab this agent is currently using (shared, stable)
+ *   groups/{name}.lock      — named group pointing to a tab
+ *
+ * The working-location file uses a stable name (not PID-scoped) so that separate
+ * CLI command invocations (each a new process) can share the same attachment
+ * context.  It is written by `attach`/`new-window` and removed only by an explicit
+ * `thinkrun release`.  The lock files follow the same lease semantics: they
+ * persist until explicitly released or stale-lock detection overwrites them.
+ *
+ * During the internal rebrand pass, we still fall back to legacy
+ * `THINKBROWSE_LOCK_DIR` / `~/.thinkbrowse/` state if the new dir is not
+ * established yet.
+ */
+export interface WorkingLocation {
+    tabId: number;
+    windowId?: number;
+    group?: string;
+    controlSessionId?: string;
+    pid: number;
+    /** Stable agent identifier — persists across all CLI invocations within an agent session. */
+    agentId?: string;
+    /** PID of the shell that invoked thinkrun — alive for the entire terminal session. */
+    ownerShellPid?: number;
+    setAt: string;
+}
+export interface ReclaimAuditEntry {
+    tabId: number;
+    reclaimedAt: string;
+    reclaimedByAgentId: string;
+    reason: 'stale_owner_shell' | 'stale_pid_legacy' | 'corrupt_existing_lock';
+    previousAgentId?: string;
+    previousPid?: number;
+    previousOwnerShellPid?: number;
+    previousControlSessionId?: string;
+}
+/** Path to the per-tab CLI session persistence file.
+ *  Stored alongside other lock files so THINKRUN_LOCK_DIR / THINKBROWSE_LOCK_DIR
+ *  test isolation applies.
+ *  tabId is sanitized (alphanumeric + hyphens/underscores only) to prevent path traversal. */
+export declare function getCliSessionFilePath(tabId: string | number): string;
+export declare function getLastReclaimAudit(): ReclaimAuditEntry | null;
+/**
+ * Acquire an exclusive lock on `tabId`. Throws with message starting
+ * `TAB_LOCKED:` if the tab is already locked by a live agent or PID.
+ * If the existing lock is stale (owner dead), it is silently overwritten.
+ *
+ * Ownership logic:
+ *   1. Same agentId → re-acquire (same agent, different invocation)
+ *   2. Different agentId → check ownerShellPid liveness
+ *        alive  → BLOCK: TAB_LOCKED with agent info
+ *        dead   → stale → overwrite
+ *   3. No agentId in existing lock → fall back to PID-based logic (backward compat)
+ */
+export declare function acquireLock(tabId: number, group?: string): void;
+/**
+ * Release the lock for `tabId`. No-op if the file doesn't exist.
+ *
+ * A lock can be released when:
+ *   - This process's PID matches the lock's pid, OR
+ *   - This process's agentId matches the lock's agentId (same agent, different invocation)
+ */
+export declare function releaseLock(tabId: number): void;
+/**
+ * Returns true when no live process holds the lock for `tabId`
+ * (either no lock file exists, or the locking PID is dead).
+ */
+export declare function isLockStale(tabId: number): boolean;
+/**
+ * Returns the WorkingLocation stored in the lock file for `tabId`, or null.
+ * Does not check whether the locking PID is alive.
+ */
+export declare function getLockedBy(tabId: number): WorkingLocation | null;
+/**
+ * Set the working location for this process.
+ * Acquires a lock on `tabId` (throws TAB_LOCKED if another live PID owns it)
+ * and writes the stable working-location file for cross-command persistence.
+ */
+export declare function setWorkingLocation(loc: Omit<WorkingLocation, 'pid' | 'setAt'>): void;
+/**
+ * Update the control-session identifier for the currently owned working location.
+ * Best-effort: no-op when no working location exists.
+ */
+export declare function updateWorkingLocationControlSession(controlSessionId: string): void;
+/**
+ * Return the working location for this process.
+ * Checks in-process memory first, then falls back to the on-disk file.
+ */
+export declare function getWorkingLocation(): WorkingLocation | null;
+/**
+ * Release the working location for this process (and optionally a named group).
+ * Deletes the lock file for the current tab and the working-location file.
+ *
+ * When `group` is provided and working-location.json is absent (e.g. after a
+ * crash or on a different machine), the group file itself is used to look up
+ * the tabId so the lock can be released by group name alone.
+ */
+export declare function releaseWorkingLocation(group?: string): void;
+//# sourceMappingURL=working-location.d.ts.map

package/dist/src/working-location.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"working-location.d.ts","sourceRoot":"","sources":["../../src/working-location.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAOH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,6FAA6F;IAC7F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sFAAsF;IACtF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,mBAAmB,GAAG,kBAAkB,GAAG,uBAAuB,CAAC;IAC3E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AAsCD;;;8FAG8F;AAC9F,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAGpE;AAoED,wBAAgB,mBAAmB,IAAI,iBAAiB,GAAG,IAAI,CA0B9D;AAgCD;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAkL/D;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAiB/C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAYlD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAQjE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,KAAK,GAAG,OAAO,CAAC,GAAG,IAAI,CA8DpF;AAED;;;GAGG;AACH,wBAAgB,mCAAmC,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAkBlF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,GAAG,IAAI,CAsD3D;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAgE3D"}