@thinkrun/cli 0.1.27

package/dist/src/session/continuity.js

@@ -0,0 +1,179 @@
+// Four hours is conservative enough to survive ordinary CLI pauses while still
+// allowing reclaim of obviously orphaned state within the same work day.
+export const DEFAULT_CONTINUITY_STALE_LEASE_WINDOW_MS = 4 * 60 * 60 * 1000;
+function toMs(value) {
+    if (value == null)
+        return null;
+    if (typeof value === 'number')
+        return Number.isFinite(value) ? value : null;
+    if (value instanceof Date)
+        return Number.isFinite(value.getTime()) ? value.getTime() : null;
+    const parsed = Date.parse(value);
+    return Number.isFinite(parsed) ? parsed : null;
+}
+function normalizeStaleLeaseWindow(staleLeaseWindowMs) {
+    return Number.isFinite(staleLeaseWindowMs) && staleLeaseWindowMs != null && staleLeaseWindowMs > 0
+        ? staleLeaseWindowMs
+        : DEFAULT_CONTINUITY_STALE_LEASE_WINDOW_MS;
+}
+export function isContinuityLeaseStale(setAt, now = Date.now(), staleLeaseWindowMs = DEFAULT_CONTINUITY_STALE_LEASE_WINDOW_MS) {
+    const leaseMs = toMs(setAt);
+    const nowMs = toMs(now);
+    if (leaseMs == null || nowMs == null)
+        return false;
+    return nowMs - leaseMs >= normalizeStaleLeaseWindow(staleLeaseWindowMs);
+}
+function getEffectiveTabId(evidence) {
+    // Prefer the freshest local attachment context first, then the tab currently
+    // locked on disk, then any older persisted binding. Later guards treat tab
+    // identity mismatches as blocking, so this ordering favors live continuity
+    // evidence without silently trusting a stale tab reference.
+    const workingTabId = evidence.workingLocation?.tabId;
+    if (workingTabId != null)
+        return String(workingTabId);
+    const lockTabId = evidence.lockOwner?.tabId;
+    if (lockTabId != null)
+        return String(lockTabId);
+    const persistedTabId = evidence.persistedBinding?.tabId;
+    if (persistedTabId != null && persistedTabId.length > 0)
+        return persistedTabId;
+    return null;
+}
+function hasSameControllerEvidence(evidence) {
+    const { currentAgentId, workingLocation, lockOwner } = evidence;
+    return workingLocation?.agentId === currentAgentId || lockOwner?.agentId === currentAgentId;
+}
+function hasConflictingControllerEvidence(evidence) {
+    const { currentAgentId, workingLocation, lockOwner } = evidence;
+    const foreignWorkingAgent = workingLocation?.agentId && workingLocation.agentId !== currentAgentId;
+    const foreignLockAgent = lockOwner?.agentId && lockOwner.agentId !== currentAgentId;
+    // Any foreign-authority signal is enough to mark the evidence set as conflicting.
+    return !!foreignWorkingAgent || !!foreignLockAgent;
+}
+function isStaleReclaimable(evidence) {
+    const leaseWindowMs = normalizeStaleLeaseWindow(evidence.staleLeaseWindowMs);
+    const leaseSetAt = evidence.lockOwner?.setAt;
+    return (
+    // Reclaim requires authoritative lock-file evidence; working-location state
+    // alone is intentionally insufficient to justify ownership transfer.
+    evidence.lockOwner != null
+        && evidence.ownerShellAlive === false
+        && evidence.runtimeSessionState === 'missing'
+        && isContinuityLeaseStale(leaseSetAt, evidence.now, leaseWindowMs));
+}
+export function assessLocalContinuity(evidence) {
+    const effectiveTabId = getEffectiveTabId(evidence);
+    if (!effectiveTabId) {
+        return {
+            state: 'unbound',
+            effectiveTabId: null,
+            sameController: false,
+            canRepairRuntime: false,
+            canReclaim: false,
+            reason: 'no_binding',
+        };
+    }
+    if (evidence.tabIdentityState === 'mismatch') {
+        return {
+            state: 'ambiguous_blocked',
+            effectiveTabId,
+            sameController: false,
+            canRepairRuntime: false,
+            canReclaim: false,
+            reason: 'tab_identity_mismatch',
+        };
+    }
+    if (evidence.legacyStateStatus === 'legacy_conflict') {
+        return {
+            state: 'ambiguous_blocked',
+            effectiveTabId,
+            sameController: false,
+            canRepairRuntime: false,
+            canReclaim: false,
+            reason: 'legacy_state_conflict',
+        };
+    }
+    const sameController = hasSameControllerEvidence(evidence);
+    const conflictingController = hasConflictingControllerEvidence(evidence);
+    if (sameController && conflictingController) {
+        return {
+            state: 'ambiguous_blocked',
+            effectiveTabId,
+            sameController: false,
+            canRepairRuntime: false,
+            canReclaim: false,
+            reason: 'conflicting_controller_evidence',
+        };
+    }
+    if (sameController) {
+        if (evidence.runtimeSessionState === 'recognized') {
+            return {
+                state: 'same_controller_resumable',
+                effectiveTabId,
+                sameController: true,
+                canRepairRuntime: false,
+                canReclaim: false,
+                reason: 'same_controller_live_runtime',
+            };
+        }
+        if (evidence.runtimeSessionState === 'unknown') {
+            return {
+                state: 'ambiguous_blocked',
+                effectiveTabId,
+                sameController: true,
+                canRepairRuntime: false,
+                canReclaim: false,
+                reason: 'runtime_status_unknown',
+            };
+        }
+        return {
+            state: 'same_controller_missing_runtime',
+            effectiveTabId,
+            sameController: true,
+            canRepairRuntime: true,
+            canReclaim: false,
+            reason: 'same_controller_runtime_missing',
+        };
+    }
+    if (conflictingController && evidence.ownerShellAlive === true) {
+        return {
+            state: 'foreign_controller_live',
+            effectiveTabId,
+            sameController: false,
+            canRepairRuntime: false,
+            canReclaim: false,
+            reason: 'foreign_controller_live',
+        };
+    }
+    if (conflictingController && isStaleReclaimable(evidence)) {
+        return {
+            state: 'stale_reclaimable',
+            effectiveTabId,
+            sameController: false,
+            canRepairRuntime: false,
+            canReclaim: true,
+            reason: 'stale_lease_reclaimable',
+        };
+    }
+    if (!sameController && evidence.persistedBinding) {
+        return {
+            state: 'ambiguous_blocked',
+            effectiveTabId,
+            sameController: false,
+            canRepairRuntime: false,
+            canReclaim: false,
+            reason: conflictingController ? 'insufficient_stale_evidence' : 'missing_continuity_proof',
+        };
+    }
+    // Safety-net fallback for future callers that provide a tab target without any
+    // usable continuity proof. Current tests exercise the explicit ambiguous path.
+    return {
+        state: 'ambiguous_blocked',
+        effectiveTabId,
+        sameController: false,
+        canRepairRuntime: false,
+        canReclaim: false,
+        reason: 'missing_continuity_proof',
+    };
+}
+//# sourceMappingURL=continuity.js.map

package/dist/src/session/continuity.js.map

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

package/dist/src/session/errors.d.ts

@@ -0,0 +1,9 @@
+import { ApiKeyError, ApiError, SessionError } from '../errors.js';
+export declare function mixedSessionStateError(): ApiError;
+export declare function localSessionStateConflictError(): ApiError;
+export declare function localSessionBridgeUnavailableError(): ApiError;
+export declare function cloudSessionMissingApiKeyError(): ApiKeyError;
+export declare function noConnectionError(): ApiError;
+export declare function localCommandRequiresTabError(): SessionError;
+export declare function cloudCommandRequiresSessionError(): SessionError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/src/session/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/session/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGnE,wBAAgB,sBAAsB,IAAI,QAAQ,CAMjD;AAED,wBAAgB,8BAA8B,IAAI,QAAQ,CAMzD;AAED,wBAAgB,kCAAkC,IAAI,QAAQ,CAQ7D;AAED,wBAAgB,8BAA8B,IAAI,WAAW,CAkB5D;AAED,wBAAgB,iBAAiB,IAAI,QAAQ,CAO5C;AAED,wBAAgB,4BAA4B,IAAI,YAAY,CAK3D;AAED,wBAAgB,gCAAgC,IAAI,YAAY,CAK/D"}

package/dist/src/session/errors.js

@@ -0,0 +1,31 @@
+import { ApiKeyError, ApiError, SessionError } from '../errors.js';
+import { config } from '../config/store.js';
+export function mixedSessionStateError() {
+    return new ApiError('Config contains both local and cloud session state', undefined, 'Re-attach to a local tab with: thinkrun attach <tabId>, or reset the active cloud session with: thinkrun cloud start');
+}
+export function localSessionStateConflictError() {
+    return new ApiError('Config local tab binding conflicts with private local control state', undefined, 'Run: thinkrun session debug\nThen re-attach to the intended local tab with: thinkrun attach <tabId>');
+}
+export function localSessionBridgeUnavailableError() {
+    return new ApiError('Active session is a local tab, but the native host is not reachable', undefined, 'Open a Chromium-based browser (e.g. Chrome or Helium) with the ThinkRun extension active, or switch to cloud mode with: thinkrun cloud start', 'NATIVE_HOST_UNREACHABLE', false);
+}
+export function cloudSessionMissingApiKeyError() {
+    // PRD 0086 B2: classify by actual key state so the cloud-session routing
+    // path matches the CloudAdapter constructor taxonomy.
+    const health = config.getKeyHealth();
+    if (health.state === 'malformed') {
+        return new ApiKeyError(`Active session is a cloud session, but the stored API key is malformed and was quarantined (${health.quarantinedMasked}).`, 'API_KEY_MALFORMED', 'Set a valid key: thinkrun config set-key <your-api-key>. Diagnose with: thinkrun doctor', 401);
+    }
+    return new ApiKeyError('Active session is a cloud session, but no API key is configured', 'API_KEY_MISSING', 'Run: thinkrun config set-key <your-api-key>, or attach to a local tab with: thinkrun attach <tabId>', 401);
+}
+export function noConnectionError() {
+    return new ApiError('ThinkRun extension not reachable', undefined, 'Start a Chromium-based browser (e.g. Chrome or Helium) with the ThinkRun extension active, then run: thinkrun attach <tabId>\n' +
+        'To use a cloud browser instead: thinkrun cloud start  (requires an API key)');
+}
+export function localCommandRequiresTabError() {
+    return new SessionError('No active local tab', 'List tabs with: thinkrun tabs\nThen attach: thinkrun attach <tabId>');
+}
+export function cloudCommandRequiresSessionError() {
+    return new SessionError('No active session', 'Start a session with: thinkrun cloud start');
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/session/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/session/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,UAAU,sBAAsB;IACpC,OAAO,IAAI,QAAQ,CACjB,oDAAoD,EACpD,SAAS,EACT,sHAAsH,CACvH,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,8BAA8B;IAC5C,OAAO,IAAI,QAAQ,CACjB,qEAAqE,EACrE,SAAS,EACT,qGAAqG,CACtG,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kCAAkC;IAChD,OAAO,IAAI,QAAQ,CACjB,qEAAqE,EACrE,SAAS,EACT,8IAA8I,EAC9I,yBAAyB,EACzB,KAAK,CACN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,8BAA8B;IAC5C,yEAAyE;IACzE,sDAAsD;IACtD,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,EAAE,CAAC;IACrC,IAAI,MAAM,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;QACjC,OAAO,IAAI,WAAW,CACpB,+FAA+F,MAAM,CAAC,iBAAiB,IAAI,EAC3H,mBAAmB,EACnB,yFAAyF,EACzF,GAAG,CACJ,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,WAAW,CACpB,iEAAiE,EACjE,iBAAiB,EACjB,qGAAqG,EACrG,GAAG,CACJ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,IAAI,QAAQ,CACjB,kCAAkC,EAClC,SAAS,EACT,gIAAgI;QAChI,6EAA6E,CAC9E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,4BAA4B;IAC1C,OAAO,IAAI,YAAY,CACrB,qBAAqB,EACrB,qEAAqE,CACtE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gCAAgC;IAC9C,OAAO,IAAI,YAAY,CACrB,mBAAmB,EACnB,4CAA4C,CAC7C,CAAC;AACJ,CAAC"}

package/dist/src/session/local-continuity.d.ts

@@ -0,0 +1,16 @@
+import { type WorkingLocation } from '../working-location.js';
+import type { LocalSessionContext } from './context.js';
+export type LocalContinuityState = 'unbound' | 'same_controller_read_resumable' | 'same_controller_read_write_resumable' | 'same_controller_missing_runtime_registration' | 'same_controller_missing_mutating_authority_state' | 'foreign_controller_live' | 'stale_reclaimable' | 'ambiguous_blocked';
+export type LocalContinuityLockOwner = Pick<WorkingLocation, 'tabId' | 'agentId' | 'pid' | 'ownerShellPid' | 'controlSessionId' | 'setAt'>;
+export type LocalContinuityAssessment = {
+    state: LocalContinuityState;
+    effectiveTabId: string | null;
+    hint: string | null;
+    runtimeSessionPresent: boolean;
+    controlSessionPresent: boolean;
+    controlLeaseHeld: boolean;
+    staleLock: boolean;
+    lockOwner: LocalContinuityLockOwner | null;
+};
+export declare function assessLocalContinuity(localContext?: LocalSessionContext, workingLocation?: WorkingLocation | null): LocalContinuityAssessment;
+//# sourceMappingURL=local-continuity.d.ts.map

package/dist/src/session/local-continuity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-continuity.d.ts","sourceRoot":"","sources":["../../../src/session/local-continuity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgD,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC5G,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGxD,MAAM,MAAM,oBAAoB,GAC5B,SAAS,GACT,gCAAgC,GAChC,sCAAsC,GACtC,8CAA8C,GAC9C,kDAAkD,GAClD,yBAAyB,GACzB,mBAAmB,GACnB,mBAAmB,CAAC;AAExB,MAAM,MAAM,wBAAwB,GAAG,IAAI,CACzC,eAAe,EACf,OAAO,GAAG,SAAS,GAAG,KAAK,GAAG,eAAe,GAAG,kBAAkB,GAAG,OAAO,CAC7E,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,KAAK,EAAE,oBAAoB,CAAC;IAC5B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,wBAAwB,GAAG,IAAI,CAAC;CAC5C,CAAC;AAcF,wBAAgB,qBAAqB,CACnC,YAAY,CAAC,EAAE,mBAAmB,EAClC,eAAe,CAAC,EAAE,eAAe,GAAG,IAAI,GACvC,yBAAyB,CA2I3B"}

package/dist/src/session/local-continuity.js

@@ -0,0 +1,146 @@
+import { getLockedBy, getWorkingLocation, isLockStale } from '../working-location.js';
+import { resolveAgentId } from './agent-identity.js';
+function toLockOwner(lock) {
+    if (!lock)
+        return null;
+    return {
+        tabId: lock.tabId,
+        ...(lock.agentId ? { agentId: lock.agentId } : {}),
+        pid: lock.pid,
+        ...(lock.ownerShellPid !== undefined ? { ownerShellPid: lock.ownerShellPid } : {}),
+        ...(lock.controlSessionId ? { controlSessionId: lock.controlSessionId } : {}),
+        setAt: lock.setAt,
+    };
+}
+export function assessLocalContinuity(localContext, workingLocation) {
+    const currentAgentId = resolveAgentId();
+    const context = localContext;
+    const working = workingLocation ?? getWorkingLocation();
+    const effectiveTabId = working ? String(working.tabId) : context?.tabId ?? null;
+    const lock = effectiveTabId ? getLockedBy(Number(effectiveTabId)) : null;
+    const staleLock = effectiveTabId ? isLockStale(Number(effectiveTabId)) : false;
+    const lockOwner = toLockOwner(lock);
+    const runtimeSessionPresent = typeof context?.agentSessionId === 'string' && context.agentSessionId.length > 0;
+    const controlSessionPresent = typeof context?.controlSessionId === 'string' && context.controlSessionId.length > 0;
+    const sameTab = !!context?.tabId && !!working && context.tabId === String(working.tabId);
+    const sameControllerWorking = !!working?.agentId && working.agentId === currentAgentId;
+    const sameControllerLock = !!lock?.agentId && lock.agentId === currentAgentId;
+    const workingControlMismatch = !!context?.controlSessionId
+        && !!working?.controlSessionId
+        && working.controlSessionId !== context.controlSessionId;
+    const lockControlMismatch = !!context?.controlSessionId
+        && !!lock?.controlSessionId
+        && lock.controlSessionId !== context.controlSessionId;
+    const controlLeaseHeld = controlSessionPresent
+        && !workingControlMismatch
+        && !lockControlMismatch;
+    if (!context?.tabId && !working && !lock) {
+        return {
+            state: 'unbound',
+            effectiveTabId: null,
+            hint: 'No persisted local binding or working location exists yet. Attach or open a new local tab first.',
+            runtimeSessionPresent: false,
+            controlSessionPresent: false,
+            controlLeaseHeld: false,
+            staleLock: false,
+            lockOwner: null,
+        };
+    }
+    if (lock?.agentId && lock.agentId !== currentAgentId) {
+        if (staleLock) {
+            return {
+                state: 'stale_reclaimable',
+                effectiveTabId,
+                hint: `Tab ${effectiveTabId} still has a stale foreign lock. Inspect session debug, then re-attach to reclaim it safely if the other controller is really gone.`,
+                runtimeSessionPresent,
+                controlSessionPresent,
+                controlLeaseHeld: false,
+                staleLock: true,
+                lockOwner,
+            };
+        }
+        return {
+            state: 'foreign_controller_live',
+            effectiveTabId,
+            hint: `Tab ${effectiveTabId} is actively controlled by another local agent. Use a new tab/window or wait for that controller to release it.`,
+            runtimeSessionPresent,
+            controlSessionPresent,
+            controlLeaseHeld: false,
+            staleLock: false,
+            lockOwner,
+        };
+    }
+    if (context?.tabId && working && !sameTab) {
+        return {
+            state: 'ambiguous_blocked',
+            effectiveTabId,
+            hint: `Persisted local binding points to tab ${context.tabId}, but working location points to tab ${working.tabId}. Resolve the drift before trusting mutating continuity.`,
+            runtimeSessionPresent,
+            controlSessionPresent,
+            controlLeaseHeld: false,
+            staleLock,
+            lockOwner,
+        };
+    }
+    if (sameControllerWorking || sameControllerLock || controlSessionPresent) {
+        if (runtimeSessionPresent && controlLeaseHeld) {
+            return {
+                state: 'same_controller_read_write_resumable',
+                effectiveTabId,
+                hint: `Same-controller continuity is intact for tab ${effectiveTabId}. Read and mutating commands should resume cleanly.`,
+                runtimeSessionPresent,
+                controlSessionPresent,
+                controlLeaseHeld: true,
+                staleLock,
+                lockOwner,
+            };
+        }
+        if (!runtimeSessionPresent && controlLeaseHeld) {
+            return {
+                state: 'same_controller_missing_runtime_registration',
+                effectiveTabId,
+                hint: `Same-controller continuity is proven for tab ${effectiveTabId}, but the runtime session registration is missing. A narrow re-register path is expected to repair mutating commands.`,
+                runtimeSessionPresent,
+                controlSessionPresent,
+                controlLeaseHeld: true,
+                staleLock,
+                lockOwner,
+            };
+        }
+        if (runtimeSessionPresent && !controlLeaseHeld) {
+            return {
+                state: 'same_controller_missing_mutating_authority_state',
+                effectiveTabId,
+                hint: `Targeting continuity still exists for tab ${effectiveTabId}, but the active mutating-authority lease is missing or inconsistent. Read-only commands may still work while mutations fail.`,
+                runtimeSessionPresent,
+                controlSessionPresent,
+                controlLeaseHeld: false,
+                staleLock,
+                lockOwner,
+            };
+        }
+        return {
+            state: 'same_controller_read_resumable',
+            effectiveTabId,
+            hint: `Some same-controller continuity evidence exists for tab ${effectiveTabId}, but not enough to trust mutating authority yet.`,
+            runtimeSessionPresent,
+            controlSessionPresent,
+            controlLeaseHeld: false,
+            staleLock,
+            lockOwner,
+        };
+    }
+    return {
+        state: 'ambiguous_blocked',
+        effectiveTabId,
+        hint: effectiveTabId
+            ? `Local context still points at tab ${effectiveTabId}, but same-controller authority could not be proven from the current working-location and lock state.`
+            : 'Local continuity could not be proven from the current persisted state.',
+        runtimeSessionPresent,
+        controlSessionPresent,
+        controlLeaseHeld: false,
+        staleLock,
+        lockOwner,
+    };
+}
+//# sourceMappingURL=local-continuity.js.map

package/dist/src/session/local-continuity.js.map

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

package/dist/src/session/signal-handler.d.ts

@@ -0,0 +1,24 @@
+/**
+ * SIGINT / SIGTERM handler factory for the CLI entry point.
+ *
+ * Extracted into a separate module so that unit tests can import and call
+ * `handleTermSignal` directly, instead of simulating the handler logic
+ * inline and risking test/handler drift.
+ */
+import { closeCliSessionSync } from './cli-session-sync.js';
+import { getWorkingLocation } from '../working-location.js';
+/**
+ * Returns a function that, when called, performs a best-effort synchronous
+ * close of the current CLI session and then exits the process with `exitCode`.
+ *
+ * Uses `getWorkingLocation()` as the authoritative source of the active tabId
+ * so the correct session is closed even when the handler fires mid-command.
+ *
+ * @param exitCode - Process exit code (130 for SIGINT, 143 for SIGTERM).
+ * @param status   - Session close status: 'failed' for SIGINT (user interrupt),
+ *                   'completed' for SIGTERM (graceful shutdown by process manager).
+ * @param getLocFn - Injectable for testing; defaults to `getWorkingLocation`.
+ * @param closeFn  - Injectable for testing; defaults to `closeCliSessionSync`.
+ */
+export declare function handleTermSignal(exitCode: number, status?: 'completed' | 'failed', getLocFn?: () => ReturnType<typeof getWorkingLocation>, closeFn?: typeof closeCliSessionSync): () => void;
+//# sourceMappingURL=signal-handler.d.ts.map

package/dist/src/session/signal-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-handler.d.ts","sourceRoot":"","sources":["../../../src/session/signal-handler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,WAAW,GAAG,QAAmB,EACzC,QAAQ,GAAE,MAAM,UAAU,CAAC,OAAO,kBAAkB,CAAsB,EAC1E,OAAO,GAAE,OAAO,mBAAyC,GACxD,MAAM,IAAI,CAUZ"}

package/dist/src/session/signal-handler.js

@@ -0,0 +1,35 @@
+/**
+ * SIGINT / SIGTERM handler factory for the CLI entry point.
+ *
+ * Extracted into a separate module so that unit tests can import and call
+ * `handleTermSignal` directly, instead of simulating the handler logic
+ * inline and risking test/handler drift.
+ */
+import { closeCliSessionSync } from './cli-session-sync.js';
+import { getWorkingLocation } from '../working-location.js';
+/**
+ * Returns a function that, when called, performs a best-effort synchronous
+ * close of the current CLI session and then exits the process with `exitCode`.
+ *
+ * Uses `getWorkingLocation()` as the authoritative source of the active tabId
+ * so the correct session is closed even when the handler fires mid-command.
+ *
+ * @param exitCode - Process exit code (130 for SIGINT, 143 for SIGTERM).
+ * @param status   - Session close status: 'failed' for SIGINT (user interrupt),
+ *                   'completed' for SIGTERM (graceful shutdown by process manager).
+ * @param getLocFn - Injectable for testing; defaults to `getWorkingLocation`.
+ * @param closeFn  - Injectable for testing; defaults to `closeCliSessionSync`.
+ */
+export function handleTermSignal(exitCode, status = 'failed', getLocFn = getWorkingLocation, closeFn = closeCliSessionSync) {
+    return () => {
+        try {
+            const loc = getLocFn();
+            if (loc?.tabId) {
+                closeFn(String(loc.tabId), status);
+            }
+        }
+        catch { /* best-effort — never block clean exit */ }
+        process.exit(exitCode);
+    };
+}
+//# sourceMappingURL=signal-handler.js.map

package/dist/src/session/signal-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-handler.js","sourceRoot":"","sources":["../../../src/session/signal-handler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAAgB,EAChB,SAAiC,QAAQ,EACzC,WAAwD,kBAAkB,EAC1E,UAAsC,mBAAmB;IAEzD,OAAO,GAAG,EAAE;QACV,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,QAAQ,EAAE,CAAC;YACvB,IAAI,GAAG,EAAE,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAC,0CAA0C,CAAC,CAAC;QACtD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC,CAAC;AACJ,CAAC"}

package/dist/src/shared/local-recovery-policy.d.ts

@@ -0,0 +1,40 @@
+export declare const LOCAL_BRIDGE_RECOVERY_RETRY_DELAYS_MS: readonly [250, 500, 1000, 2000, 4000];
+export declare const LOCAL_SAFE_MAX_ATTEMPTS: number;
+export declare const LOCAL_MUTATION_MAX_ATTEMPTS = 1;
+export declare const LOCAL_SAFE_NO_RETRY_MAX_ATTEMPTS = 1;
+export type LocalReplayPolicy = 'safe' | 'safe-no-retry' | 'mutation';
+/**
+ * Canonical replay policy for local CLI commands while the extension/native host
+ * transport is reconnecting.
+ */
+export declare const LOCAL_COMMAND_REPLAY_POLICY: {
+    getSession: "safe";
+    listSessions: "safe";
+    wait: "safe-no-retry";
+    waitForText: "safe-no-retry";
+    snapshot: "safe";
+    screenshot: "safe";
+    extract: "safe";
+    getUrl: "safe";
+    getTitle: "safe";
+    getHtml: "safe";
+    getDialog: "safe-no-retry";
+    getConsoleMessages: "safe";
+    getNetworkRequests: "safe";
+    navigate: "mutation";
+    goBack: "mutation";
+    goForward: "mutation";
+    click: "mutation";
+    type: "mutation";
+    fill: "mutation";
+    press: "mutation";
+    scroll: "mutation";
+    hover: "mutation";
+    select: "mutation";
+    evaluate: "mutation";
+    handleDialog: "mutation";
+    clearLogs: "mutation";
+};
+export declare const LOCAL_RECONNECTABLE_BRIDGE_CODES: Set<string>;
+export declare const LOCAL_RECONNECTABLE_TIMEOUT_CODES: Set<string>;
+//# sourceMappingURL=local-recovery-policy.d.ts.map

package/dist/src/shared/local-recovery-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-recovery-policy.d.ts","sourceRoot":"","sources":["../../../src/shared/local-recovery-policy.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qCAAqC,uCAMxC,CAAC;AAEX,eAAO,MAAM,uBAAuB,QAAmD,CAAC;AACxF,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAG7C,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAElD,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,eAAe,GAAG,UAAU,CAAC;AAEtE;;;GAGG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BK,CAAC;AAE9C,eAAO,MAAM,gCAAgC,aAI3C,CAAC;AAEH,eAAO,MAAM,iCAAiC,aAK5C,CAAC"}

package/dist/src/shared/local-recovery-policy.js

@@ -0,0 +1,59 @@
+export const LOCAL_BRIDGE_RECOVERY_RETRY_DELAYS_MS = [
+    250,
+    500,
+    1_000,
+    2_000,
+    4_000,
+];
+export const LOCAL_SAFE_MAX_ATTEMPTS = LOCAL_BRIDGE_RECOVERY_RETRY_DELAYS_MS.length + 1;
+export const LOCAL_MUTATION_MAX_ATTEMPTS = 1;
+// Keep a distinct constant for explicit mutation semantics even though it currently
+// matches the observation no-retry budget.
+export const LOCAL_SAFE_NO_RETRY_MAX_ATTEMPTS = 1;
+/**
+ * Canonical replay policy for local CLI commands while the extension/native host
+ * transport is reconnecting.
+ */
+export const LOCAL_COMMAND_REPLAY_POLICY = {
+    getSession: 'safe',
+    listSessions: 'safe',
+    wait: 'safe-no-retry',
+    waitForText: 'safe-no-retry',
+    snapshot: 'safe',
+    screenshot: 'safe',
+    extract: 'safe',
+    getUrl: 'safe',
+    getTitle: 'safe',
+    getHtml: 'safe',
+    // Keep a single attempt for dialog inspection, but use observation wording until
+    // the bridge exposes a distinct read-only command path for dialog state.
+    getDialog: 'safe-no-retry',
+    getConsoleMessages: 'safe',
+    getNetworkRequests: 'safe',
+    navigate: 'mutation',
+    goBack: 'mutation',
+    goForward: 'mutation',
+    click: 'mutation',
+    type: 'mutation',
+    fill: 'mutation',
+    press: 'mutation',
+    scroll: 'mutation',
+    hover: 'mutation',
+    select: 'mutation',
+    // Scripts are opaque here; we cannot distinguish read-only evaluation from mutation safely.
+    evaluate: 'mutation',
+    handleDialog: 'mutation',
+    clearLogs: 'mutation',
+};
+export const LOCAL_RECONNECTABLE_BRIDGE_CODES = new Set([
+    'EXTENSION_NOT_CONNECTED',
+    'EXTENSION_DISCONNECTED',
+    'NATIVE_HOST_UNREACHABLE',
+]);
+export const LOCAL_RECONNECTABLE_TIMEOUT_CODES = new Set([
+    // These are only replayed when the native host marks them retryable, which
+    // signals bridge-state churn rather than a definitive command timeout.
+    'REQUEST_TIMEOUT',
+    'COMMAND_TIMEOUT',
+]);
+//# sourceMappingURL=local-recovery-policy.js.map

package/dist/src/shared/local-recovery-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-recovery-policy.js","sourceRoot":"","sources":["../../../src/shared/local-recovery-policy.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qCAAqC,GAAG;IACnD,GAAG;IACH,GAAG;IACH,KAAK;IACL,KAAK;IACL,KAAK;CACG,CAAC;AAEX,MAAM,CAAC,MAAM,uBAAuB,GAAG,qCAAqC,CAAC,MAAM,GAAG,CAAC,CAAC;AACxF,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC;AAC7C,oFAAoF;AACpF,2CAA2C;AAC3C,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC;AAIlD;;;GAGG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,UAAU,EAAE,MAAM;IAClB,YAAY,EAAE,MAAM;IACpB,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,eAAe;IAC5B,QAAQ,EAAE,MAAM;IAChB,UAAU,EAAE,MAAM;IAClB,OAAO,EAAE,MAAM;IACf,MAAM,EAAE,MAAM;IACd,QAAQ,EAAE,MAAM;IAChB,OAAO,EAAE,MAAM;IACf,iFAAiF;IACjF,yEAAyE;IACzE,SAAS,EAAE,eAAe;IAC1B,kBAAkB,EAAE,MAAM;IAC1B,kBAAkB,EAAE,MAAM;IAC1B,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,UAAU;IAClB,SAAS,EAAE,UAAU;IACrB,KAAK,EAAE,UAAU;IACjB,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,4FAA4F;IAC5F,QAAQ,EAAE,UAAU;IACpB,YAAY,EAAE,UAAU;IACxB,SAAS,EAAE,UAAU;CACsB,CAAC;AAE9C,MAAM,CAAC,MAAM,gCAAgC,GAAG,IAAI,GAAG,CAAC;IACtD,yBAAyB;IACzB,wBAAwB;IACxB,yBAAyB;CAC1B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iCAAiC,GAAG,IAAI,GAAG,CAAC;IACvD,2EAA2E;IAC3E,uEAAuE;IACvE,iBAAiB;IACjB,iBAAiB;CAClB,CAAC,CAAC"}

package/dist/src/shared/recovery-state.d.ts

@@ -0,0 +1,3 @@
+export declare const RECOVERY_STATE_VALUES: readonly ["healthy", "recovering", "recently_recovered", "circuit_breaker_tripped", "service_worker_flapping", "hard_disconnected"];
+export type RecoveryState = (typeof RECOVERY_STATE_VALUES)[number];
+//# sourceMappingURL=recovery-state.d.ts.map

package/dist/src/shared/recovery-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery-state.d.ts","sourceRoot":"","sources":["../../../src/shared/recovery-state.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,qIAOxB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/src/shared/recovery-state.js

@@ -0,0 +1,9 @@
+export const RECOVERY_STATE_VALUES = [
+    'healthy',
+    'recovering',
+    'recently_recovered',
+    'circuit_breaker_tripped',
+    'service_worker_flapping',
+    'hard_disconnected',
+];
+//# sourceMappingURL=recovery-state.js.map

package/dist/src/shared/recovery-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery-state.js","sourceRoot":"","sources":["../../../src/shared/recovery-state.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,SAAS;IACT,YAAY;IACZ,oBAAoB;IACpB,yBAAyB;IACzB,yBAAyB;IACzB,mBAAmB;CACX,CAAC"}