@jobshimo/browser-link 0.39.0 → 0.41.0

package/dist/lifecycle/processes.js

@@ -0,0 +1,239 @@
+import { execFileSync } from 'node:child_process';
+import { platform } from 'node:os';
+/** WMI cold starts are slow: same budget `silent-debugger.ts` documents. */
+const LIST_TIMEOUT_MS = 5000;
+export const defaultExecFile = (file, args, options) => execFileSync(file, args, {
+    encoding: 'utf8',
+    stdio: ['ignore', 'pipe', 'ignore'],
+    windowsHide: true,
+    timeout: options.timeout,
+    // `ps` prints lstart in the C locale only when told so.
+    env: { ...process.env, LC_ALL: 'C' },
+});
+/**
+ * Parse a process start time in any of the forms the OS tools print:
+ * PowerShell 5.1's JSON `/Date(ms)/`, ISO 8601 (PowerShell 7 JSON,
+ * `ToString('o')`), a WMI datetime `yyyyMMddHHmmss.ffffff±UUU` (offset in
+ * minutes) and `ps`'s `lstart` (`Mon Nov  9 02:17:44 2026`, local time).
+ */
+export function parseProcessTime(raw) {
+    const text = raw.trim();
+    if (text.length === 0)
+        return null;
+    const msDate = /^\/Date\((-?\d+)\)\/$/.exec(text);
+    if (msDate)
+        return Number(msDate[1]);
+    const wmi = /^(\d{4})(\d{2})(\d{2})(\d{2})(\d{2})(\d{2})\.(\d{3})\d*([+-])(\d{3})$/.exec(text);
+    if (wmi) {
+        const [, y, mo, d, h, mi, s, ms, sign, off] = wmi;
+        const utc = Date.UTC(+y, +mo - 1, +d, +h, +mi, +s, +ms);
+        const offsetMs = Number(off) * 60_000 * (sign === '-' ? -1 : 1);
+        return utc - offsetMs;
+    }
+    const parsed = Date.parse(text);
+    return Number.isFinite(parsed) ? parsed : null;
+}
+/** Parse `Get-CimInstance … | ConvertTo-Json -Compress`. One process comes
+ * out as a bare object, several as an array; both are accepted. */
+export function parseWindowsProcessList(stdout) {
+    let data;
+    try {
+        data = JSON.parse(stdout);
+    }
+    catch {
+        return [];
+    }
+    const rows = (Array.isArray(data) ? data : [data]);
+    const out = [];
+    for (const row of rows) {
+        if (typeof row !== 'object' || row === null)
+            continue;
+        const { ProcessId, ParentProcessId, CreationDate, CommandLine } = row;
+        const pid = Number(ProcessId);
+        if (!Number.isInteger(pid) || pid <= 0)
+            continue;
+        const ppid = Number(ParentProcessId);
+        out.push({
+            pid,
+            ppid: Number.isInteger(ppid) ? ppid : 0,
+            startedAt: typeof CreationDate === 'string' ? parseProcessTime(CreationDate) : null,
+            command: typeof CommandLine === 'string' ? CommandLine.trim() : '',
+        });
+    }
+    return out;
+}
+const UNIX_ROW = /^\s*(\d+)\s+(\d+)\s+(\w{3}\s+\w{3}\s+\d{1,2}\s+\d{1,2}:\d{2}:\d{2}\s+\d{4})\s+(.*)$/;
+/** Parse `ps -axo pid=,ppid=,lstart=,command=` (C locale). */
+export function parseUnixProcessList(stdout) {
+    const out = [];
+    for (const line of stdout.split(/\r?\n/)) {
+        const m = UNIX_ROW.exec(line);
+        if (!m)
+            continue;
+        out.push({
+            pid: Number(m[1]),
+            ppid: Number(m[2]),
+            startedAt: parseProcessTime(m[3]),
+            command: m[4].trim(),
+        });
+    }
+    return out;
+}
+const WINDOWS_LIST_SCRIPT = 'Get-CimInstance Win32_Process | ' +
+    'Select-Object ProcessId, ParentProcessId, CreationDate, CommandLine | ' +
+    'ConvertTo-Json -Compress';
+function powershell(script) {
+    return ['powershell', ['-NoProfile', '-NonInteractive', '-Command', script]];
+}
+/** The whole process table, or `[]` when it cannot be read. */
+export function listProcesses(os = platform(), exec = defaultExecFile) {
+    try {
+        if (os === 'win32') {
+            const [file, args] = powershell(WINDOWS_LIST_SCRIPT);
+            return parseWindowsProcessList(exec(file, args, { timeout: LIST_TIMEOUT_MS }));
+        }
+        return parseUnixProcessList(exec('ps', ['-axo', 'pid=,ppid=,lstart=,command='], { timeout: LIST_TIMEOUT_MS }));
+    }
+    catch {
+        return [];
+    }
+}
+/** Start time of one process (epoch ms), or `null` when unknown. */
+export function readProcessStartTime(pid, opts = {}) {
+    const os = opts.os ?? platform();
+    const exec = opts.exec ?? defaultExecFile;
+    try {
+        if (os === 'win32') {
+            const [file, args] = powershell(`Get-CimInstance Win32_Process -Filter 'ProcessId = ${pid}' | ` +
+                `Select-Object -ExpandProperty CreationDate | ` +
+                `ForEach-Object { $_.ToUniversalTime().ToString('o') }`);
+            return parseProcessTime(exec(file, args, { timeout: LIST_TIMEOUT_MS }));
+        }
+        return parseProcessTime(exec('ps', ['-o', 'lstart=', '-p', String(pid)], { timeout: LIST_TIMEOUT_MS }));
+    }
+    catch {
+        return null;
+    }
+}
+/** Split a command line into arguments. Double quotes group (Windows
+ * command lines quote paths with spaces); backslashes stay literal. */
+function tokenize(command) {
+    const tokens = [];
+    let current = '';
+    let inQuotes = false;
+    let hasToken = false;
+    for (const ch of command) {
+        if (ch === '"') {
+            inQuotes = !inQuotes;
+            hasToken = true;
+            continue;
+        }
+        if (!inQuotes && /\s/.test(ch)) {
+            if (hasToken)
+                tokens.push(current);
+            current = '';
+            hasToken = false;
+            continue;
+        }
+        current += ch;
+        hasToken = true;
+    }
+    if (hasToken)
+        tokens.push(current);
+    return tokens;
+}
+function normalise(token) {
+    return token.replace(/\\+/g, '/').toLowerCase();
+}
+function basename(token) {
+    const n = normalise(token);
+    return n.slice(n.lastIndexOf('/') + 1);
+}
+/** Runtimes a browser-link process runs under. */
+const RUNTIMES = new Set(['node', 'node.exe', 'nodejs', 'bun', 'bun.exe']);
+/** npm's own entry scripts: the package spec is a later argument. */
+const NPM_ENTRIES = new Set(['npx-cli.js', 'npm-cli.js']);
+function isBrowserLinkEntry(token) {
+    const n = normalise(token);
+    if (n.includes('@jobshimo/browser-link'))
+        return true;
+    if (n.endsWith('browser-link/dist/cli.js'))
+        return true;
+    // The global bin shim (a symlink on Unix): `node /usr/local/bin/browser-link`.
+    const base = basename(token);
+    return n.includes('/') && (base === 'browser-link' || base === 'browser-link.js');
+}
+/**
+ * Whether a command line runs this package, and with which subcommand
+ * (`null` = none, i.e. the MCP server or the TUI). Only the script argument
+ * counts (the first non-flag argument after the runtime, or the package
+ * spec after npm's `npx-cli.js`), so a process that merely mentions a
+ * browser-link path as an option value is never matched.
+ */
+export function matchBrowserLinkCommand(command) {
+    const tokens = tokenize(command);
+    if (tokens.length < 2 || !RUNTIMES.has(basename(tokens[0])))
+        return null;
+    let i = 1;
+    while (i < tokens.length && tokens[i].startsWith('-'))
+        i += 1;
+    if (i >= tokens.length)
+        return null;
+    if (NPM_ENTRIES.has(basename(tokens[i]))) {
+        i += 1;
+        while (i < tokens.length && (tokens[i].startsWith('-') || tokens[i] === 'exec'))
+            i += 1;
+        if (i >= tokens.length)
+            return null;
+    }
+    if (!isBrowserLinkEntry(tokens[i]))
+        return null;
+    return { subcommand: tokens[i + 1] ?? null };
+}
+/** Subcommands that run the bridge (see `cli.ts`'s dispatch switch: only a
+ * bare invocation and `start` call `runServer`). Every other subcommand
+ * (`stop`, `doctor`, `version`, `help`, `about`, `config`, `map`,
+ * `instructions`, `activity`, `self-update`, …) is a short-lived command
+ * that `stop` must never kill. */
+function isBridgeSubcommand(subcommand) {
+    return subcommand === null || subcommand === 'start';
+}
+/** `selfPid` and every ancestor reachable through `ppid` in `list`. */
+function selfAndAncestors(list, selfPid) {
+    const byPid = new Map(list.map((p) => [p.pid, p]));
+    const out = new Set();
+    let pid = selfPid;
+    while (pid !== undefined && pid > 0 && !out.has(pid)) {
+        out.add(pid);
+        pid = byPid.get(pid)?.ppid;
+    }
+    return out;
+}
+/** Live browser-link bridges in `list`, excluding `selfPid`, its ancestor
+ * chain (the shell or client that launched it) and non-bridge commands. */
+export function findBridgeProcesses(list, selfPid) {
+    const excluded = selfAndAncestors(list, selfPid);
+    return list.filter((p) => {
+        if (excluded.has(p.pid))
+            return false;
+        const match = matchBrowserLinkCommand(p.command);
+        return match !== null && isBridgeSubcommand(match.subcommand);
+    });
+}
+export function listBridgeProcesses(opts = {}) {
+    return findBridgeProcesses(listProcesses(opts.os, opts.exec), opts.selfPid ?? process.pid);
+}
+/** Short, display-only form: runtime name, `browser-link`, then arguments. */
+export function shortCommand(command, max = 80) {
+    const tokens = tokenize(command);
+    if (tokens.length === 0)
+        return '';
+    const parts = tokens.map((t, i) => {
+        if (i === 0)
+            return basename(t).replace(/\.exe$/, '');
+        return isBrowserLinkEntry(t) ? 'browser-link' : t;
+    });
+    const text = parts.join(' ');
+    return text.length > max ? `${text.slice(0, max - 1)}…` : text;
+}
+//# sourceMappingURL=processes.js.map

package/dist/lifecycle/processes.js.map

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

package/dist/lifecycle/repair.d.ts

@@ -0,0 +1,48 @@
+import type { BridgeRepairMessage, ServerToExtension } from '../messages.js';
+/**
+ * Popup "Repair connection", server side (S4).
+ *
+ * On `bridge.repair` the bridge answers first, then this process restarts
+ * itself on the installed code: spawn the installed CLI detached, terminate
+ * every extension socket uncleanly (`ws.terminate()`, which the extension's
+ * auto-reconnect treats as involuntary), stop IPC (proxies get
+ * `primary-closing`) and exit 0. The child wins the port through the
+ * election's bind retries, and the extension reconnects to it by itself.
+ *
+ * The policy is pure; `server.ts` injects the real spawn/terminate/exit.
+ */
+export interface RepairDeps {
+    /** `process.execPath`. */
+    execPath: string;
+    /** The installed `dist/cli.js` (same file the process started from). */
+    cliPath: string;
+    spawn: (command: string, args: string[], options: {
+        detached: true;
+        stdio: 'ignore';
+        windowsHide: true;
+    }) => {
+        unref(): void;
+    };
+    terminateSockets: () => void;
+    stopIpc: () => Promise<void>;
+    exit: (code: number) => void;
+    /** Waits long enough for the ack frame to be flushed to the socket. */
+    delay: (ms: number) => Promise<void>;
+    log?: (msg: string) => void;
+}
+/** Time given to the `bridge.repair.result` frame before sockets die. */
+export declare const REPAIR_FLUSH_DELAY_MS = 150;
+export interface RepairController {
+    /** Start the restart (once). Returns whether it is (now) in progress. */
+    start(): boolean;
+    /** Settles when the current restart attempt finished (tests). */
+    readonly done: Promise<void>;
+}
+export declare function createRepairController(deps: RepairDeps): RepairController;
+/**
+ * Answer one `bridge.repair` frame: the ack goes out BEFORE the repair
+ * starts, so the popup learns the outcome even though its socket is about to
+ * be terminated. `startRepair` is undefined in a process that cannot repair
+ * itself (tests, a bridge started without the wiring).
+ */
+export declare function answerRepairRequest(msg: BridgeRepairMessage, send: (reply: ServerToExtension) => void, startRepair: (() => boolean) | undefined): void;

package/dist/lifecycle/repair.js

@@ -0,0 +1,67 @@
+/** Time given to the `bridge.repair.result` frame before sockets die. */
+export const REPAIR_FLUSH_DELAY_MS = 150;
+export function createRepairController(deps) {
+    let inProgress = false;
+    let done = Promise.resolve();
+    const run = async () => {
+        await deps.delay(REPAIR_FLUSH_DELAY_MS);
+        try {
+            deps
+                .spawn(deps.execPath, [deps.cliPath], {
+                detached: true,
+                stdio: 'ignore',
+                windowsHide: true,
+            })
+                .unref();
+        }
+        catch (err) {
+            // Without a successor, exiting would leave no server at all: keep
+            // serving and let the user fall back to `browser-link stop`.
+            inProgress = false;
+            deps.log?.(`Repair: could not start the installed server (${err instanceof Error ? err.message : String(err)}); still serving.`);
+            return;
+        }
+        deps.log?.('Repair: installed server started; handing over the port.');
+        deps.terminateSockets();
+        try {
+            await deps.stopIpc();
+        }
+        catch {
+            /* already closed; exiting anyway */
+        }
+        deps.exit(0);
+    };
+    return {
+        start() {
+            if (inProgress)
+                return true;
+            inProgress = true;
+            done = run();
+            return true;
+        },
+        get done() {
+            return done;
+        },
+    };
+}
+/**
+ * Answer one `bridge.repair` frame: the ack goes out BEFORE the repair
+ * starts, so the popup learns the outcome even though its socket is about to
+ * be terminated. `startRepair` is undefined in a process that cannot repair
+ * itself (tests, a bridge started without the wiring).
+ */
+export function answerRepairRequest(msg, send, startRepair) {
+    const requestId = typeof msg.request_id === 'string' ? msg.request_id : '';
+    if (!startRepair) {
+        send({
+            kind: 'bridge.repair.result',
+            request_id: requestId,
+            ok: false,
+            error: 'repair is not available in this server process',
+        });
+        return;
+    }
+    send({ kind: 'bridge.repair.result', request_id: requestId, ok: true, action: 'restarting' });
+    startRepair();
+}
+//# sourceMappingURL=repair.js.map

package/dist/lifecycle/repair.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair.js","sourceRoot":"","sources":["../../src/lifecycle/repair.ts"],"names":[],"mappings":"AAiCA,yEAAyE;AACzE,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AASzC,MAAM,UAAU,sBAAsB,CAAC,IAAgB;IACrD,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,IAAI,IAAI,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAE5C,MAAM,GAAG,GAAG,KAAK,IAAmB,EAAE;QACpC,MAAM,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACxC,IAAI,CAAC;YACH,IAAI;iBACD,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;gBACpC,QAAQ,EAAE,IAAI;gBACd,KAAK,EAAE,QAAQ;gBACf,WAAW,EAAE,IAAI;aAClB,CAAC;iBACD,KAAK,EAAE,CAAC;QACb,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,kEAAkE;YAClE,6DAA6D;YAC7D,UAAU,GAAG,KAAK,CAAC;YACnB,IAAI,CAAC,GAAG,EAAE,CACR,iDAAiD,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,mBAAmB,CACrH,CAAC;YACF,OAAO;QACT,CAAC;QACD,IAAI,CAAC,GAAG,EAAE,CAAC,0DAA0D,CAAC,CAAC;QACvE,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,oCAAoC;QACtC,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACf,CAAC,CAAC;IAEF,OAAO;QACL,KAAK;YACH,IAAI,UAAU;gBAAE,OAAO,IAAI,CAAC;YAC5B,UAAU,GAAG,IAAI,CAAC;YAClB,IAAI,GAAG,GAAG,EAAE,CAAC;YACb,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,IAAI;YACN,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,GAAwB,EACxB,IAAwC,EACxC,WAAwC;IAExC,MAAM,SAAS,GAAG,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3E,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,IAAI,CAAC;YACH,IAAI,EAAE,sBAAsB;YAC5B,UAAU,EAAE,SAAS;YACrB,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,gDAAgD;SACxD,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IACD,IAAI,CAAC,EAAE,IAAI,EAAE,sBAAsB,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;IAC9F,WAAW,EAAE,CAAC;AAChB,CAAC"}

package/dist/lifecycle/version-endpoint.d.ts

@@ -0,0 +1,16 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { VersionInfo } from './election.js';
+/**
+ * The installed CLI entry point: `<package>/dist/cli.js`. This module lives
+ * in `dist/lifecycle/` (installed) or `src/lifecycle/` (dev), two levels
+ * below the package root either way. After `npm install -g` this is the
+ * same path the running process started from, now holding the new code.
+ */
+export declare const INSTALLED_CLI_PATH: string;
+/** Last-modified time of the installed CLI (epoch ms), or `null`. */
+export declare function readInstalledCodeMtime(path?: string): number | null;
+/** Approximate wall-clock start of this process, epoch ms. */
+export declare const PROCESS_STARTED_AT: number;
+export declare function buildVersionInfo(version: string, pid?: number, startedAt?: number, installed?: () => string | null): VersionInfo;
+/** The bridge's plain-HTTP handler: `/version` or 404. */
+export declare function handleBridgeHttpRequest(req: IncomingMessage, res: ServerResponse, version: string): void;

package/dist/lifecycle/version-endpoint.js

@@ -0,0 +1,50 @@
+import { statSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { PACKAGE_NAME, readInstalledVersion } from '../version.js';
+/**
+ * `GET /version` on the bridge port (S5). The election (`election.ts`),
+ * `doctor` and anything else that needs to know "which browser-link is the
+ * primary, and is it outdated?" read it. Every other plain HTTP request is a
+ * 404; WebSocket upgrades never reach this handler.
+ */
+const here = dirname(fileURLToPath(import.meta.url));
+/**
+ * The installed CLI entry point: `<package>/dist/cli.js`. This module lives
+ * in `dist/lifecycle/` (installed) or `src/lifecycle/` (dev), two levels
+ * below the package root either way. After `npm install -g` this is the
+ * same path the running process started from, now holding the new code.
+ */
+export const INSTALLED_CLI_PATH = join(here, '..', '..', 'dist', 'cli.js');
+/** Last-modified time of the installed CLI (epoch ms), or `null`. */
+export function readInstalledCodeMtime(path = INSTALLED_CLI_PATH) {
+    try {
+        return statSync(path).mtimeMs;
+    }
+    catch {
+        return null;
+    }
+}
+/** Approximate wall-clock start of this process, epoch ms. */
+export const PROCESS_STARTED_AT = Date.now() - Math.round(process.uptime() * 1000);
+export function buildVersionInfo(version, pid = process.pid, startedAt = PROCESS_STARTED_AT, installed = readInstalledVersion) {
+    return {
+        name: PACKAGE_NAME,
+        version,
+        pid,
+        startedAt: new Date(startedAt).toISOString(),
+        installedVersion: installed(),
+    };
+}
+/** The bridge's plain-HTTP handler: `/version` or 404. */
+export function handleBridgeHttpRequest(req, res, version) {
+    const path = (req.url ?? '').split('?')[0];
+    if (req.method === 'GET' && path === '/version') {
+        res.writeHead(200, { 'content-type': 'application/json' });
+        res.end(JSON.stringify(buildVersionInfo(version)));
+        return;
+    }
+    res.writeHead(404, { 'content-type': 'text/plain' });
+    res.end('Not found');
+}
+//# sourceMappingURL=version-endpoint.js.map

package/dist/lifecycle/version-endpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-endpoint.js","sourceRoot":"","sources":["../../src/lifecycle/version-endpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAGnE;;;;;GAKG;AAEH,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAErD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAW,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;AAEnF,qEAAqE;AACrE,MAAM,UAAU,sBAAsB,CAAC,OAAe,kBAAkB;IACtE,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,8DAA8D;AAC9D,MAAM,CAAC,MAAM,kBAAkB,GAAW,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;AAE3F,MAAM,UAAU,gBAAgB,CAC9B,OAAe,EACf,MAAc,OAAO,CAAC,GAAG,EACzB,YAAoB,kBAAkB,EACtC,YAAiC,oBAAoB;IAErD,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,OAAO;QACP,GAAG;QACH,SAAS,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE;QAC5C,gBAAgB,EAAE,SAAS,EAAE;KAC9B,CAAC;AACJ,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,uBAAuB,CACrC,GAAoB,EACpB,GAAmB,EACnB,OAAe;IAEf,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QAChD,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACnD,OAAO;IACT,CAAC;IACD,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC,CAAC;IACrD,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AACvB,CAAC"}

package/dist/manual/topics.js

@@ -45,7 +45,7 @@ export const TOPICS = {
     },
     'multi-agent': {
         title: 'Sharing tabs with other agents (multi-agent mode)',
-        body: lines('Several MCP clients can share one bridge; a cooperative claim layer keeps two agents off the same tab.', '- Action tools (`browser.click`, `browser.type`, `browser.navigate`, `browser.evaluate`) auto-claim a free tab on first use. If another agent holds it they fail naming the owner: ask the user whose tab it is, or use a different one.', '- Read tools (`browser.snapshot`, `browser.state`, `browser.console`, `browser.network`, `browser.network_body`, `browser.events`, `browser.ping`) ignore claims.', '- Give `browser.claim_tab` a stable `label` ("claude-code", "opencode"); claims also end on disconnect and after the inactivity TTL. The label is display only: ownership rests on the IPC session id, not on what an agent calls itself.'),
+        body: lines('Several MCP clients can share one bridge; a cooperative claim layer keeps two agents off the same tab.', '- Action tools (`browser.click`, `browser.type`, `browser.navigate`, `browser.evaluate`) auto-claim a free tab on first use. If another agent holds it they fail naming the owner: ask the user whose tab it is, or use a different one.', '- Read tools (`browser.snapshot`, `browser.state`, `browser.console`, `browser.network`, `browser.network_body`, `browser.events`, `browser.ping`) ignore claims.', '- Give `browser.claim_tab` a stable `label` ("claude-code", "opencode"); claims also end on disconnect and after the inactivity TTL. The label is display only: ownership rests on the IPC session id, not on what an agent calls itself.', '- One server process is the primary. A newer browser-link that starts displaces an older primary (it reads `GET /version` on the bridge port, then stops the old process), and the extension reconnects by itself.', '- A `list_tabs` hint "server running X, installed Y" means the package was updated under a live server: ask the user to run `browser-link stop` and restart the agent, or to click "Repair connection" in the extension popup. Do not kill processes yourself.'),
     },
     'cdp-direct': {
         title: 'cdp-direct tabs (optional, off by default, human-gated)',

package/dist/manual/topics.js.map

@@ -1 +1 @@
-{"version":3,"file":"topics.js","sourceRoot":"","sources":["../../src/manual/topics.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,WAAW;IACX,QAAQ;IACR,YAAY;IACZ,OAAO;IACP,KAAK;IACL,kBAAkB;IAClB,aAAa;IACb,YAAY;CACJ,CAAC;AASX,MAAM,KAAK,GAAG,CAAC,GAAG,CAAW,EAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEvD,MAAM,CAAC,MAAM,MAAM,GAA6B;IAC9C,SAAS,EAAE;QACT,KAAK,EAAE,2CAA2C;QAClD,IAAI,EAAE,KAAK,CACT,kOAAkO,EAClO,+OAA+O,EAC/O,0EAA0E,EAC1E,uHAAuH,CACxH;KACF;IACD,MAAM,EAAE;QACN,KAAK,EAAE,0DAA0D;QACjE,IAAI,EAAE,KAAK,CACT,+OAA+O,EAC/O,oPAAoP,EACpP,oSAAoS,CACrS;KACF;IACD,UAAU,EAAE;QACV,KAAK,EAAE,mCAAmC;QAC1C,IAAI,EAAE,KAAK,CACT,wKAAwK,EACxK,oLAAoL,EACpL,oFAAoF,CACrF;KACF;IACD,KAAK,EAAE;QACL,KAAK,EAAE,wDAAwD;QAC/D,IAAI,EAAE,KAAK,CACT,gaAAga,EACha,EAAE,EACF,iJAAiJ,EACjJ,6HAA6H,EAC7H,iOAAiO,EACjO,gWAAgW,EAChW,qIAAqI,EACrI,sXAAsX,EACtX,kMAAkM,EAClM,EAAE,EACF,6aAA6a,EAC7a,EAAE,EACF,2XAA2X,EAC3X,kNAAkN,EAClN,qGAAqG,EACrG,uGAAuG,EACvG,mLAAmL,CACpL;KACF;IACD,GAAG,EAAE;QACH,KAAK,EAAE,mEAAmE;QAC1E,IAAI,EAAE,KAAK,CACT,qRAAqR,EACrR,0MAA0M,EAC1M,0MAA0M,EAC1M,+UAA+U,EAC/U,yRAAyR,EACzR,2IAA2I,CAC5I;KACF;IACD,kBAAkB,EAAE;QAClB,KAAK,EAAE,2CAA2C;QAClD,IAAI,EAAE,KAAK,CACT,kGAAkG,EAClG,qRAAqR,EACrR,iJAAiJ,EACjJ,gNAAgN,EAChN,wFAAwF,EACxF,2HAA2H,EAC3H,iGAAiG,EACjG,sPAAsP,EACtP,uaAAua,EACva,sQAAsQ,EACtQ,+HAA+H,EAC/H,2QAA2Q,EAC3Q,oNAAoN,CACrN;KACF;IACD,aAAa,EAAE;QACb,KAAK,EAAE,mDAAmD;QAC1D,IAAI,EAAE,KAAK,CACT,wGAAwG,EACxG,0OAA0O,EAC1O,mKAAmK,EACnK,2OAA2O,CAC5O;KACF;IACD,YAAY,EAAE;QACZ,KAAK,EAAE,yDAAyD;QAChE,IAAI,EAAE,KAAK,CACT,yOAAyO,EACzO,gIAAgI,EAChI,qHAAqH,EACrH,0GAA0G,CAC3G;KACF;CACF,CAAC;AAEF,wEAAwE;AACxE,MAAM,UAAU,WAAW,CAAC,IAAe;IACzC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3B,OAAO,OAAO,KAAK,CAAC,KAAK,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AAC/C,CAAC"}
+{"version":3,"file":"topics.js","sourceRoot":"","sources":["../../src/manual/topics.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,WAAW;IACX,QAAQ;IACR,YAAY;IACZ,OAAO;IACP,KAAK;IACL,kBAAkB;IAClB,aAAa;IACb,YAAY;CACJ,CAAC;AASX,MAAM,KAAK,GAAG,CAAC,GAAG,CAAW,EAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEvD,MAAM,CAAC,MAAM,MAAM,GAA6B;IAC9C,SAAS,EAAE;QACT,KAAK,EAAE,2CAA2C;QAClD,IAAI,EAAE,KAAK,CACT,kOAAkO,EAClO,+OAA+O,EAC/O,0EAA0E,EAC1E,uHAAuH,CACxH;KACF;IACD,MAAM,EAAE;QACN,KAAK,EAAE,0DAA0D;QACjE,IAAI,EAAE,KAAK,CACT,+OAA+O,EAC/O,oPAAoP,EACpP,oSAAoS,CACrS;KACF;IACD,UAAU,EAAE;QACV,KAAK,EAAE,mCAAmC;QAC1C,IAAI,EAAE,KAAK,CACT,wKAAwK,EACxK,oLAAoL,EACpL,oFAAoF,CACrF;KACF;IACD,KAAK,EAAE;QACL,KAAK,EAAE,wDAAwD;QAC/D,IAAI,EAAE,KAAK,CACT,gaAAga,EACha,EAAE,EACF,iJAAiJ,EACjJ,6HAA6H,EAC7H,iOAAiO,EACjO,gWAAgW,EAChW,qIAAqI,EACrI,sXAAsX,EACtX,kMAAkM,EAClM,EAAE,EACF,6aAA6a,EAC7a,EAAE,EACF,2XAA2X,EAC3X,kNAAkN,EAClN,qGAAqG,EACrG,uGAAuG,EACvG,mLAAmL,CACpL;KACF;IACD,GAAG,EAAE;QACH,KAAK,EAAE,mEAAmE;QAC1E,IAAI,EAAE,KAAK,CACT,qRAAqR,EACrR,0MAA0M,EAC1M,0MAA0M,EAC1M,+UAA+U,EAC/U,yRAAyR,EACzR,2IAA2I,CAC5I;KACF;IACD,kBAAkB,EAAE;QAClB,KAAK,EAAE,2CAA2C;QAClD,IAAI,EAAE,KAAK,CACT,kGAAkG,EAClG,qRAAqR,EACrR,iJAAiJ,EACjJ,gNAAgN,EAChN,wFAAwF,EACxF,2HAA2H,EAC3H,iGAAiG,EACjG,sPAAsP,EACtP,uaAAua,EACva,sQAAsQ,EACtQ,+HAA+H,EAC/H,2QAA2Q,EAC3Q,oNAAoN,CACrN;KACF;IACD,aAAa,EAAE;QACb,KAAK,EAAE,mDAAmD;QAC1D,IAAI,EAAE,KAAK,CACT,wGAAwG,EACxG,0OAA0O,EAC1O,mKAAmK,EACnK,2OAA2O,EAC3O,oNAAoN,EACpN,gQAAgQ,CACjQ;KACF;IACD,YAAY,EAAE;QACZ,KAAK,EAAE,yDAAyD;QAChE,IAAI,EAAE,KAAK,CACT,yOAAyO,EACzO,gIAAgI,EAChI,qHAAqH,EACrH,0GAA0G,CAC3G;KACF;CACF,CAAC;AAEF,wEAAwE;AACxE,MAAM,UAAU,WAAW,CAAC,IAAe;IACzC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3B,OAAO,OAAO,KAAK,CAAC,KAAK,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AAC/C,CAAC"}

package/dist/messages.d.ts

@@ -35,6 +35,14 @@ export interface TabRegisteredPayload {
      * extensions that don't know about the field can still parse the message.
      */
     serverVersion?: string;
+    /**
+     * Version installed on disk right now (re-read on every register). When it
+     * differs from `serverVersion`, the running server is outdated and the
+     * popup offers "Repair connection". Absent from servers older than 0.41.0.
+     */
+    installedVersion?: string;
+    /** PID of the server process that handed out this tabId (0.41.0+). */
+    serverPid?: number;
 }
 export interface TabRegisterMessage {
     kind: 'tab.register';
@@ -254,5 +262,26 @@ export type ActivityPurgeResultMessage = {
     ok: false;
     error: string;
 };
-export type ExtensionToServer = TabRegisterMessage | ToolResponseMessage | BridgeEventMessage | FlowRecordedMessage | ActivityQueryMessage | ActivityPurgeMessage;
-export type ServerToExtension = TabRegisteredMessage | ToolRequestMessage | ToolCancelMessage | SettingsUpdateMessage | FlowRecordedResultMessage | ActivityResultMessage | ActivityPurgeResultMessage;
+/**
+ * Popup "Repair connection": ask the running server to restart itself on
+ * the installed code. The server answers with `bridge.repair.result` first,
+ * then spawns the installed CLI detached, terminates every extension socket
+ * uncleanly (so the extension auto-reconnects) and exits.
+ */
+export interface BridgeRepairMessage {
+    kind: 'bridge.repair';
+    request_id: string;
+}
+export type BridgeRepairResultMessage = {
+    kind: 'bridge.repair.result';
+    request_id: string;
+    ok: true;
+    action: 'restarting';
+} | {
+    kind: 'bridge.repair.result';
+    request_id: string;
+    ok: false;
+    error: string;
+};
+export type ExtensionToServer = TabRegisterMessage | ToolResponseMessage | BridgeEventMessage | FlowRecordedMessage | ActivityQueryMessage | ActivityPurgeMessage | BridgeRepairMessage;
+export type ServerToExtension = TabRegisteredMessage | ToolRequestMessage | ToolCancelMessage | SettingsUpdateMessage | FlowRecordedResultMessage | ActivityResultMessage | ActivityPurgeResultMessage | BridgeRepairResultMessage;

package/dist/notice.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Verbatim copy of `packages/shared/src/notice.ts` (everything below this
+ * header). The server publishes to npm standalone and cannot import
+ * `@browser-link/shared`; `notice.test.ts` fails the build if the two
+ * copies drift. Change both together.
+ */
+export interface NoticeText {
+    title: string;
+    paragraphs: string[];
+}
+export declare const NOTICE: {
+    es: NoticeText;
+    en: NoticeText;
+};

package/dist/notice.js

@@ -0,0 +1,25 @@
+/**
+ * Verbatim copy of `packages/shared/src/notice.ts` (everything below this
+ * header). The server publishes to npm standalone and cannot import
+ * `@browser-link/shared`; `notice.test.ts` fails the build if the two
+ * copies drift. Change both together.
+ */
+export const NOTICE = {
+    es: {
+        title: 'Aviso importante',
+        paragraphs: [
+            'browser-link es una herramienta de desarrollo. Conecta un agente de IA a las pestañas de Chrome que usted elija, y en ellas el agente actúa con su propia sesión: ve y puede usar todo lo que el navegador tenga en esas pestañas, incluidos inicios de sesión activos, cookies y tokens, contraseñas y tarjetas de pago autocompletadas, correos, documentos y cualquier dato que la página muestre o permita enviar. Puede hacer clic, escribir, enviar formularios y descargar archivos como lo haría usted.',
+            'Conecte únicamente pestañas que un agente deba manejar, desconéctelas al terminar y no la utilice en sitios cuyos términos lo prohíban ni con datos que no pueda permitirse exponer. La decisión de a qué dar acceso, y lo que el agente haga con ese acceso, es responsabilidad exclusiva del usuario.',
+            'El software se distribuye "tal cual", sin garantía de ningún tipo, bajo licencia MIT. Los autores no se hacen responsables de pérdidas, daños o usos indebidos derivados de su utilización.',
+        ],
+    },
+    en: {
+        title: 'Important notice',
+        paragraphs: [
+            'browser-link is a development tool. It connects an AI agent to the Chrome tabs you choose, and in those tabs the agent acts with your own session: it sees and can use everything the browser holds in them, including active logins, cookies and tokens, autofilled passwords and payment cards, email, documents and any data the page shows or lets you submit. It can click, type, submit forms and download files as you would.',
+            "Connect only tabs an agent should operate, disconnect them when you are done, and do not use it on sites whose terms forbid it or with data you cannot afford to expose. Deciding what to grant access to, and what the agent does with that access, is solely the user's responsibility.",
+            'The software is provided "as is", without warranty of any kind, under the MIT license. The authors accept no liability for losses, damage or misuse arising from its use.',
+        ],
+    },
+};
+//# sourceMappingURL=notice.js.map

package/dist/notice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notice.js","sourceRoot":"","sources":["../src/notice.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,MAAM,CAAC,MAAM,MAAM,GAAuC;IACxD,EAAE,EAAE;QACF,KAAK,EAAE,kBAAkB;QACzB,UAAU,EAAE;YACV,ifAAif;YACjf,ySAAyS;YACzS,6LAA6L;SAC9L;KACF;IACD,EAAE,EAAE;QACF,KAAK,EAAE,kBAAkB;QACzB,UAAU,EAAE;YACV,saAAsa;YACta,2RAA2R;YAC3R,2KAA2K;SAC5K;KACF;CACF,CAAC"}