@jobshimo/browser-link 0.18.2 → 0.19.0

package/dist/commands/config.js

@@ -0,0 +1,158 @@
+import { MAX_IDLE_TTL_MINUTES, MIN_IDLE_TTL_MINUTES, clampIdleTtlMinutes, loadConfig, saveConfig, } from '../config.js';
+import { HandshakeError, IpcClient } from '../bridge/ipc-client.js';
+import { readToken } from '../bridge/token.js';
+const CFG_I18N = {
+    en: {
+        header: 'browser-link config',
+        idleTtlLabel: 'idle-ttl',
+        never: 'never (auto-disconnect disabled)',
+        minutes: (n) => `${n} min`,
+        notSetViaCli: "not set via CLI — the extension's own default/popup choice applies (30 min unless changed in the popup)",
+        invalidValue: (raw) => `Invalid idle-ttl value: "${raw}". Use a whole number of minutes (${MIN_IDLE_TTL_MINUTES}-${MAX_IDLE_TTL_MINUTES}) or "never".`,
+        clampedNote: (original, clamped) => ` (clamped from ${original} to ${clamped})`,
+        setSaved: (label) => `Idle-disconnect TTL set to ${label}.`,
+        pushedLive: (n) => ` Pushed immediately to ${n} connected tab(s).`,
+        pushedNone: ' No tabs are currently connected — it will apply the next time one connects.',
+        pushUnavailable: ' Could not reach a running browser-link primary (not running, or multi-agent mode is off) — it will apply the next time a tab connects.',
+        pushRejected: ' A running primary rejected the push (stale or mismatched multi-agent token — it may have just restarted). The value is saved and applies the next time a tab connects.',
+        usage: 'Usage: browser-link config get [idle-ttl] | browser-link config set idle-ttl <minutes|never>',
+        unknownKey: (key) => `Unknown config key: ${key}. Known keys: idle-ttl.`,
+        unknownAction: (action) => `Unknown config action: ${action}. Use get or set.`,
+    },
+    es: {
+        header: 'Configuración de browser-link',
+        idleTtlLabel: 'idle-ttl',
+        never: 'nunca (auto-desconexión deshabilitada)',
+        minutes: (n) => `${n} min`,
+        notSetViaCli: 'no configurado por CLI — se aplica el valor por defecto o el elegido en el popup de la extensión (30 min salvo que se haya cambiado en el popup)',
+        invalidValue: (raw) => `Valor de idle-ttl inválido: "${raw}". Usá un número entero de minutos (${MIN_IDLE_TTL_MINUTES}-${MAX_IDLE_TTL_MINUTES}) o "never".`,
+        clampedNote: (original, clamped) => ` (ajustado de ${original} a ${clamped})`,
+        setSaved: (label) => `TTL de auto-desconexión configurado a ${label}.`,
+        pushedLive: (n) => ` Aplicado de inmediato a ${n} pestaña(s) conectada(s).`,
+        pushedNone: ' No hay pestañas conectadas actualmente — se aplicará la próxima vez que una se conecte.',
+        pushUnavailable: ' No se pudo contactar a un browser-link primary en ejecución (no está corriendo, o el modo multi-agente está apagado) — se aplicará la próxima vez que una pestaña se conecte.',
+        pushRejected: ' Un primary en ejecución rechazó el push (token multi-agente obsoleto o no coincidente — puede haberse reiniciado recién). El valor quedó guardado y se aplicará la próxima vez que una pestaña se conecte.',
+        usage: 'Uso: browser-link config get [idle-ttl] | browser-link config set idle-ttl <minutos|never>',
+        unknownKey: (key) => `Clave de configuración desconocida: ${key}. Claves conocidas: idle-ttl.`,
+        unknownAction: (action) => `Acción de config desconocida: ${action}. Usá get o set.`,
+    },
+};
+/** One formatted line describing the current `idleTtlMinutes` state, shared
+ * by both `config get` (no key — lists everything) and `config get idle-ttl`
+ * (just this one). */
+export function getIdleTtlLine(language = 'en') {
+    const t = CFG_I18N[language];
+    const cfg = loadConfig();
+    const value = cfg.idleTtlMinutes === undefined
+        ? t.notSetViaCli
+        : cfg.idleTtlMinutes === 0
+            ? t.never
+            : t.minutes(cfg.idleTtlMinutes);
+    return `  ${t.idleTtlLabel}   ${value}`;
+}
+export function listConfig(language = 'en') {
+    const t = CFG_I18N[language];
+    return [t.header, '', getIdleTtlLine(language)].join('\n');
+}
+/**
+ * Parse the CLI's raw `<minutes|never>` argument.
+ *
+ * Distinct from `clampIdleTtlMinutes` (config.ts) on purpose: that function
+ * is a defensive safety net for VALUES THE USER NEVER TYPED (a corrupted
+ * config.json, a hand-edited file) — for those, silently falling back to
+ * the 30-minute default is the safer failure mode, since there's no one to
+ * tell. Here the user just typed something on a terminal RIGHT NOW: a
+ * genuinely unparsable value (letters, decimals) gets a clear error instead
+ * of a silent substitution, and an out-of-range integer gets clamped to the
+ * boundary WITH a note explaining what happened — both are more honest
+ * feedback loops for an interactive command than defaulting silently.
+ */
+function parseIdleTtlArg(raw, t) {
+    const normalized = raw.trim().toLowerCase();
+    if (normalized === 'never' || normalized === '0')
+        return { minutes: 0, note: '' };
+    const parsed = Number(normalized);
+    if (!Number.isFinite(parsed) || !Number.isInteger(parsed)) {
+        throw new Error(t.invalidValue(raw));
+    }
+    if (parsed < MIN_IDLE_TTL_MINUTES || parsed > MAX_IDLE_TTL_MINUTES) {
+        const clamped = Math.min(Math.max(parsed, MIN_IDLE_TTL_MINUTES), MAX_IDLE_TTL_MINUTES);
+        return { minutes: clamped, note: t.clampedNote(parsed, clamped) };
+    }
+    return { minutes: parsed, note: '' };
+}
+/** Best-effort live push to an already-running primary over the
+ * multi-agent IPC bridge. Never throws — every failure degrades to a
+ * message. Failures are NOT collapsed into one diagnosis: an explicit
+ * hello-reject (stale/mismatched token, version mismatch) proves a primary
+ * IS running and gets `pushRejected`, while connection-refused / timeout /
+ * missing-token-file — where "no primary, or multi-agent off" is the
+ * honest reading — get `pushUnavailable`. */
+async function tryPushLive(settings, t, ipcOptions = {}) {
+    const token = readToken();
+    if (!token)
+        return t.pushUnavailable;
+    const client = new IpcClient();
+    try {
+        await client.connect(token, {
+            host: ipcOptions.host,
+            port: ipcOptions.port,
+            handshakeTimeoutMs: 1500,
+        });
+        const ack = await client.sendSettingsPush(settings);
+        return ack.notified > 0 ? t.pushedLive(ack.notified) : t.pushedNone;
+    }
+    catch (err) {
+        // HandshakeError message shapes (see ipc-client.ts): "Primary
+        // rejected: <reason>" only when a live primary answered with an
+        // explicit hello-reject — timeouts and unexpected frames use other
+        // wording, and socket-level failures are not HandshakeErrors at all.
+        if (err instanceof HandshakeError && /rejected/i.test(err.message)) {
+            return t.pushRejected;
+        }
+        return t.pushUnavailable;
+    }
+    finally {
+        await client.disconnect().catch(() => {
+            /* best effort */
+        });
+    }
+}
+export async function setIdleTtl(rawValue, language = 'en', ipcOptions = {}) {
+    const t = CFG_I18N[language];
+    // Defensive final pass: parseIdleTtlArg already guarantees an in-range
+    // value or 0, so this is a no-op in practice — but it keeps ONE function
+    // as the single source of truth for "what counts as a safe stored value",
+    // matching the extension side's clampIdleTtlMinutes.
+    const { minutes: parsedMinutes, note } = parseIdleTtlArg(rawValue, t);
+    const minutes = clampIdleTtlMinutes(parsedMinutes);
+    const updatedAt = Date.now();
+    saveConfig({ idleTtlMinutes: minutes, idleTtlUpdatedAt: updatedAt });
+    const label = (minutes === 0 ? t.never : t.minutes(minutes)) + note;
+    const pushMessage = await tryPushLive({ idleTtlMinutes: minutes, updatedAt }, t, ipcOptions);
+    return t.setSaved(label) + pushMessage;
+}
+export async function runConfigCommand(argv, language = 'en') {
+    const t = CFG_I18N[language];
+    const action = argv.at(0);
+    const key = argv.at(1);
+    const value = argv.at(2);
+    if (action === undefined || action === 'get') {
+        if (key === undefined)
+            return listConfig(language);
+        if (key === 'idle-ttl')
+            return getIdleTtlLine(language);
+        throw new Error(t.unknownKey(key));
+    }
+    if (action === 'set') {
+        if (key === undefined)
+            throw new Error(t.usage);
+        if (key !== 'idle-ttl')
+            throw new Error(t.unknownKey(key));
+        if (value === undefined)
+            throw new Error(t.usage);
+        return setIdleTtl(value, language);
+    }
+    throw new Error(t.unknownAction(action));
+}
+//# sourceMappingURL=config.js.map

package/dist/commands/config.js.map

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

package/dist/config.d.ts

@@ -30,6 +30,44 @@ export interface BrowserLinkConfig {
      * the primary does). Has no effect when multiAgent is false.
      */
     autoReelect?: boolean;
+    /**
+     * CLI-side mirror of the extension's idle-disconnect TTL (see
+     * `packages/extension/src/idle-policy.ts`), in minutes. `0` means
+     * "never". Set via `browser-link config set idle-ttl <minutes|never>`.
+     *
+     * Deliberately left `undefined` — NOT defaulted to 30 here — when the
+     * CLI has never touched it: the WS bridge only pushes a `settings.update`
+     * to the extension when this field is explicitly set, so a popup-only
+     * user (who never ran the CLI command) never sees a spurious overwrite
+     * of their own choice with a server-side "default". See `idleTtlUpdatedAt`
+     * for the precedence rule when both sides have set a value.
+     */
+    idleTtlMinutes?: number;
+    /**
+     * Epoch-ms timestamp of the last `idleTtlMinutes` write from the CLI.
+     * Sent alongside `idleTtlMinutes` in every `settings.update` push so the
+     * extension can apply a last-write-wins precedence rule against its own
+     * locally-stored timestamp (popup edits stamp their own `Date.now()`).
+     * Always set together with `idleTtlMinutes` — never one without the other.
+     */
+    idleTtlUpdatedAt?: number;
 }
+/** Safety-rail bounds mirrored from the extension's `idle-policy.ts` — kept
+ * as an independent copy (not a shared import) for the same reason
+ * `messages.ts` duplicates the wire types instead of depending on
+ * `@browser-link/shared`: the server publishes to npm standalone and must
+ * not carry an unresolvable workspace dependency. */
+export declare const MIN_IDLE_TTL_MINUTES = 1;
+export declare const MAX_IDLE_TTL_MINUTES = 1440;
+export declare const DEFAULT_IDLE_TTL_MINUTES = 30;
+/**
+ * Clamp a CLI-provided idle-TTL value the same way the extension clamps a
+ * stored one: `0` ("never") passes through untouched; a non-integer, an
+ * out-of-range value, or anything malformed falls back to
+ * `DEFAULT_IDLE_TTL_MINUTES` rather than being snapped to the nearest
+ * boundary. Exported so `commands/config.ts` and its tests share one
+ * implementation instead of re-deriving the bounds.
+ */
+export declare function clampIdleTtlMinutes(value: number): number;
 export declare function loadConfig(): BrowserLinkConfig;
 export declare function saveConfig(patch: Partial<BrowserLinkConfig>): BrowserLinkConfig;

package/dist/config.js

@@ -2,6 +2,31 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { getDataDir } from './map/paths.js';
 import { sanitizeDisabledTools } from './permissions.js';
+/** Safety-rail bounds mirrored from the extension's `idle-policy.ts` — kept
+ * as an independent copy (not a shared import) for the same reason
+ * `messages.ts` duplicates the wire types instead of depending on
+ * `@browser-link/shared`: the server publishes to npm standalone and must
+ * not carry an unresolvable workspace dependency. */
+export const MIN_IDLE_TTL_MINUTES = 1;
+export const MAX_IDLE_TTL_MINUTES = 1440;
+export const DEFAULT_IDLE_TTL_MINUTES = 30;
+/**
+ * Clamp a CLI-provided idle-TTL value the same way the extension clamps a
+ * stored one: `0` ("never") passes through untouched; a non-integer, an
+ * out-of-range value, or anything malformed falls back to
+ * `DEFAULT_IDLE_TTL_MINUTES` rather than being snapped to the nearest
+ * boundary. Exported so `commands/config.ts` and its tests share one
+ * implementation instead of re-deriving the bounds.
+ */
+export function clampIdleTtlMinutes(value) {
+    if (value === 0)
+        return 0;
+    if (!Number.isFinite(value) || !Number.isInteger(value))
+        return DEFAULT_IDLE_TTL_MINUTES;
+    if (value < MIN_IDLE_TTL_MINUTES || value > MAX_IDLE_TTL_MINUTES)
+        return DEFAULT_IDLE_TTL_MINUTES;
+    return value;
+}
 /** Defaults applied at load time so consumers can read `cfg.multiAgent`
  * directly. Persisted form (see `normaliseForWrite`) only carries the field
  * when the user overrides the default, keeping the on-disk config minimal. */

package/dist/config.js.map

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

package/dist/extension/background.js

@@ -2,23 +2,81 @@ import { buildSnapshotJs, buildFindJs, buildClickResolveJs, buildTypeResolveJs,
 import { buildKeyEventSequence, resolveKey, modifiersToBitmask, MODIFIER_BITS, } from './keymap.js';
 import { resolveSettleParams, settleSafely } from './settle.js';
 import { runFlow, } from './flow.js';
+import { DEFAULT_IDLE_TTL_MINUTES, IDLE_TTL_STORAGE_KEY, IDLE_TTL_UPDATED_AT_STORAGE_KEY, clampIdleTtlMinutes, parseIncomingSettings, shouldAcceptIncomingSettings, shouldDisconnectForIdle, shouldScheduleIdleSweep, } from './idle-policy.js';
 const WS_URL = 'ws://127.0.0.1:17529';
 const CDP_VERSION = '1.3';
 const CONSOLE_BUFFER_MAX = 200;
 const NETWORK_BUFFER_MAX = 200;
 /* Idle TTL for a tab's WebSocket bridge.
  *
- * After this many milliseconds without a tool.request from the server,
- * the extension closes its side of the WS and detaches the debugger.
- * The popup then shows "Not connected" again and the user explicitly
- * re-presses Connect when they want to reactivate.
+ * After this many minutes without a tool.request from the server, the
+ * extension closes its side of the WS and detaches the debugger. The
+ * popup then shows "Not connected" again and the user explicitly
+ * re-presses Connect when they want to reactivate — unless the user
+ * configured "Never" in the popup, in which case the sweep never fires.
  *
  * This replaces the previous behaviour where the bridge implicitly
  * died together with the MCP server subprocess (parent_death_guard,
  * removed in v0.9.0). Lifecycle is now client-side: agent activity
- * keeps the tab warm, silence eventually parks it. */
-const WS_IDLE_TTL_MS = 30 * 60 * 1000;
+ * keeps the tab warm, silence eventually parks it (or never does, if
+ * the user opted out).
+ *
+ * The TTL itself is user-configurable (`idleTtlMinutes` in
+ * `chrome.storage.local`, edited from the popup — see idle-policy.ts for
+ * the decision logic and popup.ts for the control). `idleTtlMinutesCache`
+ * is the in-memory mirror the sweep reads on every tick: chrome.storage is
+ * async, the sweep loop below is not, so the value is loaded once at
+ * startup and kept current via `chrome.storage.onChanged` instead of being
+ * awaited inside the interval callback. */
 const WS_IDLE_SWEEP_MS = 60 * 1000;
+let idleTtlMinutesCache = DEFAULT_IDLE_TTL_MINUTES;
+async function loadIdleTtlMinutes() {
+    try {
+        const data = await chrome.storage.local.get(IDLE_TTL_STORAGE_KEY);
+        idleTtlMinutesCache = clampIdleTtlMinutes(data[IDLE_TTL_STORAGE_KEY]);
+    }
+    catch {
+        idleTtlMinutesCache = DEFAULT_IDLE_TTL_MINUTES;
+    }
+}
+void loadIdleTtlMinutes();
+chrome.storage.onChanged.addListener((changes, areaName) => {
+    if (areaName !== 'local')
+        return;
+    if (!(IDLE_TTL_STORAGE_KEY in changes))
+        return;
+    idleTtlMinutesCache = clampIdleTtlMinutes(changes[IDLE_TTL_STORAGE_KEY].newValue);
+});
+/**
+ * Apply an incoming `settings.update` push from the server (see
+ * `handleTool`'s caller — the WS message listener in `connectTab` below).
+ * The server sends this both right after `tab.registered` (when
+ * `browser-link config set idle-ttl` was run at least once) AND on demand
+ * when the CLI pushes a change to an already-connected tab.
+ *
+ * Applies `shouldAcceptIncomingSettings` (idle-policy.ts) — newest
+ * `updatedAt` wins against whatever was last written locally (typically by
+ * the popup). Writing through `chrome.storage.local.set` here is enough to
+ * take effect: the `onChanged` listener above keeps `idleTtlMinutesCache`
+ * current, and the popup re-reads storage on its own refresh interval.
+ */
+async function applyIncomingSettings(settings) {
+    try {
+        const data = await chrome.storage.local.get(IDLE_TTL_UPDATED_AT_STORAGE_KEY);
+        const rawLocalUpdatedAt = data[IDLE_TTL_UPDATED_AT_STORAGE_KEY];
+        const localUpdatedAt = typeof rawLocalUpdatedAt === 'number' ? rawLocalUpdatedAt : undefined;
+        if (!shouldAcceptIncomingSettings(localUpdatedAt, settings.updatedAt))
+            return;
+        await chrome.storage.local.set({
+            [IDLE_TTL_STORAGE_KEY]: clampIdleTtlMinutes(settings.idleTtlMinutes),
+            [IDLE_TTL_UPDATED_AT_STORAGE_KEY]: settings.updatedAt,
+        });
+    }
+    catch {
+        // Best effort — a failed sync just leaves the local value as-is; the
+        // next settings.update (or a popup edit) can still apply it.
+    }
+}
 function isRuntimeMessage(msg) {
     if (typeof msg !== 'object' || msg === null)
         return false;
@@ -1436,27 +1494,56 @@ async function connectTab(tabId) {
                 const msg = safeParse(typeof ev.data === 'string' ? ev.data : '');
                 if (!msg)
                     return;
-                if (msg.kind === 'tab.registered') {
-                    state.serverTabId = msg.payload.tabId;
-                    // serverVersion is optional on the wire so older servers that
-                    // predate the field still parse — narrow on `typeof string`.
-                    if (typeof msg.payload.serverVersion === 'string') {
-                        state.serverVersion = msg.payload.serverVersion;
+                // Exhaustive routing over ServerToExtension. The `default` branch
+                // pins `msg` to `never`, so adding a fourth message kind to the
+                // union fails to COMPILE here instead of silently misrouting the
+                // new kind into the tool.request handler.
+                switch (msg.kind) {
+                    case 'tab.registered': {
+                        state.serverTabId = msg.payload.tabId;
+                        // serverVersion is optional on the wire so older servers that
+                        // predate the field still parse — narrow on `typeof string`.
+                        if (typeof msg.payload.serverVersion === 'string') {
+                            state.serverVersion = msg.payload.serverVersion;
+                        }
+                        // Remember this id so the next reconnect (after a primary swap)
+                        // asks the new primary to honour it. The primary emits
+                        // `tab-renamed` in the bridge event log if it can't.
+                        void storeTabId(tabId, msg.payload.tabId);
+                        settle({ ok: true, serverTabId: msg.payload.tabId });
+                        return;
+                    }
+                    case 'settings.update': {
+                        // Housekeeping, not agent activity — deliberately does NOT touch
+                        // state.lastActivityAt. Counting a server-pushed settings sync as
+                        // "activity" would let it silently keep an otherwise-idle tab
+                        // connected forever, defeating the idle TTL it is updating.
+                        //
+                        // `safeParse` is only a cast — validate the payload shape at the
+                        // wire boundary (same rigor the IPC settings.push frame gets in
+                        // the server's protocol.ts) so a malformed push is dropped here
+                        // instead of throwing inside the apply path.
+                        const settings = parseIncomingSettings(msg.settings);
+                        if (settings)
+                            void applyIncomingSettings(settings);
+                        return;
+                    }
+                    case 'tool.request': {
+                        // Touch the activity timestamp so the WS-idle sweeper keeps
+                        // this tab warm.
+                        state.lastActivityAt = Date.now();
+                        const response = await handleTool(state, msg);
+                        if (ws.readyState === WebSocket.OPEN)
+                            send(ws, response);
+                        return;
+                    }
+                    default: {
+                        // Compile-time exhaustiveness check; at runtime an unknown kind
+                        // (newer server, older extension) is ignored defensively.
+                        const _exhaustive = msg;
+                        return;
                     }
-                    // Remember this id so the next reconnect (after a primary swap)
-                    // asks the new primary to honour it. The primary emits
-                    // `tab-renamed` in the bridge event log if it can't.
-                    void storeTabId(tabId, msg.payload.tabId);
-                    settle({ ok: true, serverTabId: msg.payload.tabId });
-                    return;
                 }
-                // ServerToExtension is the union { tab.registered | tool.request },
-                // so by elimination this branch handles the tool.request case. Touch
-                // the activity timestamp so the WS-idle sweeper keeps this tab warm.
-                state.lastActivityAt = Date.now();
-                const response = await handleTool(state, msg);
-                if (ws.readyState === WebSocket.OPEN)
-                    send(ws, response);
             })();
         });
         ws.addEventListener('error', () => {
@@ -1651,17 +1738,27 @@ chrome.debugger.onDetach.addListener((source) => {
 /* WS-idle sweeper.
  *
  * Every WS_IDLE_SWEEP_MS, walk every connected tab. Any tab whose last
- * tool.request landed more than WS_IDLE_TTL_MS ago gets disconnected:
- * the WS closes, the debugger detaches, the popup goes back to "Not
- * connected". The user explicitly re-presses Connect to bring it back.
+ * tool.request landed more than the user's configured `idleTtlMinutes`
+ * ago gets disconnected: the WS closes, the debugger detaches, the popup
+ * goes back to "Not connected". The user explicitly re-presses Connect to
+ * bring it back.
+ *
+ * When the user picked "Never" (idleTtlMinutesCache === 0),
+ * `shouldScheduleIdleSweep` short-circuits the tick before it walks
+ * `tabStates` — the interval itself keeps ticking (cancelling/rearming a
+ * service-worker timer from a storage listener is more moving parts than
+ * it is worth for a once-a-minute no-op), but each tick does zero work
+ * beyond that one check.
  *
  * This is the replacement for the parent_death_guard that used to kill
  * the entire MCP server on stdio close — now the server stays alive and
  * the bridge is parked tab-by-tab from the client side. */
 setInterval(() => {
+    if (!shouldScheduleIdleSweep(idleTtlMinutesCache))
+        return;
     const now = Date.now();
     for (const [tabId, state] of tabStates) {
-        if (now - state.lastActivityAt < WS_IDLE_TTL_MS)
+        if (!shouldDisconnectForIdle(state.lastActivityAt, now, idleTtlMinutesCache))
             continue;
         void cleanup(tabId).catch(() => {
             // Best effort.