@jobshimo/browser-link 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Martín Miguel Bernal
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,83 @@
+# @jobshimo/browser-link
+
+> ⚠️  **Read this before installing**
+>
+> This package opens a bridge between Claude Code and the Chrome tabs you
+> explicitly enable through a companion extension. On every tab where you
+> press "Conectar" in the extension popup, the agent can read its DOM,
+> click, type, run arbitrary JavaScript, and follow links — including any
+> logged-in session, saved card, wallet, banking page or admin panel that
+> tab is currently showing.
+>
+> Treat the agent like a junior dev with remote control of those tabs.
+> Only enable tabs where you would let an automated process act on your
+> behalf, and disconnect them when you are done. You are responsible for
+> every action the agent performs on the tabs you explicitly enable.
+
+MCP server that bridges Claude Code to the Chrome tabs you grant access to,
+through a small WebSocket relay and a companion Chrome extension. Ships
+with a persistent UI map so the agent remembers selectors, flows and
+gotchas it learned about each app, across sessions.
+
+## Install
+
+```bash
+npm install -g @jobshimo/browser-link
+```
+
+This puts the `browser-link` binary on your PATH on macOS, Linux and Windows.
+
+## Set it up
+
+The fastest path is the interactive menu:
+
+```bash
+browser-link
+```
+
+That opens the welcome / disclaimer screen (English or Spanish), and then
+the setup menu where you can register browser-link with Claude Code, see
+the Chrome extension install steps, run a doctor diagnose, and open the
+about / help page.
+
+If you prefer direct commands:
+
+```bash
+browser-link install        # register browser-link in Claude Code
+browser-link extension      # show the Chrome extension assets path + steps
+browser-link doctor         # diagnose current setup
+browser-link about          # what this is, how it works, every tool
+```
+
+After `install`, restart Claude Code. After `extension`, follow the printed
+steps to load the unpacked extension in Chrome. Then click "Conectar" on
+every tab you want the agent to reach — and only on those.
+
+## Tools exposed
+
+Browser bridge: `browser.list_tabs`, `browser.ping`, `browser.navigate`,
+`browser.snapshot`, `browser.click`, `browser.type`, `browser.evaluate`,
+`browser.console`, `browser.network`, `browser.network_body`.
+
+UI map (persistent across sessions): `browser.map.recall`,
+`browser.map.save`, `browser.map.record_use`, `browser.map.forget`,
+`browser.map.rename_app`, `browser.map.apps`.
+
+The server also ships usage instructions for the agent via the MCP
+`initialize` handshake — no manual prompt setup required.
+
+## Where the data lives
+
+```
+macOS    ~/Library/Application Support/browser-link/map.db
+Linux    $XDG_DATA_HOME/browser-link/map.db   (default: ~/.local/share/browser-link/map.db)
+Windows  %APPDATA%/browser-link/map.db
+```
+
+Override with `BROWSER_LINK_DATA_DIR`. The database is local to your
+machine and never uploaded anywhere by this package. The WebSocket relay
+binds to `127.0.0.1:17529` (loopback only).
+
+## License
+
+MIT — see [LICENSE](https://github.com/jobshimo/browser-link/blob/main/LICENSE).

package/dist/auth/allowlist.d.ts

@@ -0,0 +1,2 @@
+export declare function getAllowedBrowsers(os?: NodeJS.Platform): readonly string[];
+export declare function isAllowedBrowser(binaryName: string, os?: NodeJS.Platform): boolean;

package/dist/auth/allowlist.js

@@ -0,0 +1,53 @@
+import { platform } from 'node:os';
+/**
+ * Names of Chromium-based browser binaries the WebSocket bridge accepts as
+ * legitimate peers. Strict equality after stripping any path component.
+ *
+ * The match is per-OS because the binary that owns a TCP socket reports a
+ * different name on macOS ("Google Chrome Helper"), Linux ("chrome") and
+ * Windows ("chrome.exe"). Helper processes are included because in
+ * Chromium-based browsers the network stack often lives in a separate
+ * "Network Service" helper, not the main process.
+ */
+const ALLOWED_BY_OS = {
+    darwin: [
+        'Google Chrome',
+        'Google Chrome Helper',
+        'Google Chrome Helper (Renderer)',
+        'Google Chrome Helper (GPU)',
+        'Google Chrome Helper (Plugin)',
+        'Google Chrome Helper (Alerts)',
+        'Chromium',
+        'Chromium Helper',
+        'Chromium Helper (Renderer)',
+        'Microsoft Edge',
+        'Microsoft Edge Helper',
+        'Microsoft Edge Helper (Renderer)',
+        'Brave Browser',
+        'Brave Browser Helper',
+        'Brave Browser Helper (Renderer)',
+        'Vivaldi',
+        'Vivaldi Helper',
+    ],
+    linux: [
+        'chrome',
+        'chromium',
+        'chromium-browser',
+        'google-chrome',
+        'google-chrome-stable',
+        'msedge',
+        'microsoft-edge',
+        'brave',
+        'brave-browser',
+        'vivaldi-bin',
+        'vivaldi-stable',
+    ],
+    win32: ['chrome.exe', 'chromium.exe', 'msedge.exe', 'brave.exe', 'vivaldi.exe'],
+};
+export function getAllowedBrowsers(os = platform()) {
+    return ALLOWED_BY_OS[os] ?? [];
+}
+export function isAllowedBrowser(binaryName, os = platform()) {
+    return getAllowedBrowsers(os).includes(binaryName);
+}
+//# sourceMappingURL=allowlist.js.map

package/dist/auth/allowlist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"allowlist.js","sourceRoot":"","sources":["../../src/auth/allowlist.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC;;;;;;;;;GASG;AACH,MAAM,aAAa,GAAwD;IACzE,MAAM,EAAE;QACN,eAAe;QACf,sBAAsB;QACtB,iCAAiC;QACjC,4BAA4B;QAC5B,+BAA+B;QAC/B,+BAA+B;QAC/B,UAAU;QACV,iBAAiB;QACjB,4BAA4B;QAC5B,gBAAgB;QAChB,uBAAuB;QACvB,kCAAkC;QAClC,eAAe;QACf,sBAAsB;QACtB,iCAAiC;QACjC,SAAS;QACT,gBAAgB;KACjB;IACD,KAAK,EAAE;QACL,QAAQ;QACR,UAAU;QACV,kBAAkB;QAClB,eAAe;QACf,sBAAsB;QACtB,QAAQ;QACR,gBAAgB;QAChB,OAAO;QACP,eAAe;QACf,aAAa;QACb,gBAAgB;KACjB;IACD,KAAK,EAAE,CAAC,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,CAAC;CAChF,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,KAAsB,QAAQ,EAAE;IACjE,OAAO,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,UAAkB,EAAE,KAAsB,QAAQ,EAAE;IACnF,OAAO,kBAAkB,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AACrD,CAAC"}

package/dist/auth/process-identity.d.ts

@@ -0,0 +1,19 @@
+export interface PeerProcess {
+    pid: number;
+    binaryName: string;
+}
+/**
+ * Identify which OS process owns the local end of a loopback TCP connection
+ * at `host:port`. Returns null when the lookup cannot resolve a single owner
+ * (no result, ambiguous result, command not available, timeout).
+ *
+ * The caller decides how to treat null: this module's only job is to ask the
+ * kernel honestly. Concretely the server treats null as "reject", so users
+ * on systems without lsof / netstat fail closed.
+ */
+export declare function lookupPeerProcess(host: string, port: number): Promise<PeerProcess | null>;
+export declare function parseLsofOutput(out: string): PeerProcess | null;
+/** lsof escapes spaces and tabs in command names as \xHH. Reverse that. */
+export declare function decodeLsofString(s: string): string;
+export declare function parseNetstatForLocal(out: string, host: string, port: number): number | null;
+export declare function parseTasklistImage(out: string): string | null;

package/dist/auth/process-identity.js

@@ -0,0 +1,106 @@
+import { exec } from 'node:child_process';
+import { platform } from 'node:os';
+import { promisify } from 'node:util';
+const execAsync = promisify(exec);
+const LOOKUP_TIMEOUT_MS = 1500;
+/**
+ * Identify which OS process owns the local end of a loopback TCP connection
+ * at `host:port`. Returns null when the lookup cannot resolve a single owner
+ * (no result, ambiguous result, command not available, timeout).
+ *
+ * The caller decides how to treat null: this module's only job is to ask the
+ * kernel honestly. Concretely the server treats null as "reject", so users
+ * on systems without lsof / netstat fail closed.
+ */
+export async function lookupPeerProcess(host, port) {
+    const os = platform();
+    try {
+        if (os === 'darwin' || os === 'linux') {
+            return await lookupUnix(host, port);
+        }
+        if (os === 'win32') {
+            return await lookupWindows(host, port);
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * macOS / Linux path: `lsof` is the broadest tool available. The -F flag
+ * gives us a stable, field-tagged output (one field per line, prefixed with
+ * the field letter) that survives binary names containing spaces — common
+ * on macOS ("Google Chrome Helper").
+ */
+async function lookupUnix(host, port) {
+    const cmd = `lsof -nP -F pc -iTCP@${host}:${port} -sTCP:ESTABLISHED`;
+    const { stdout } = await execAsync(cmd, { timeout: LOOKUP_TIMEOUT_MS });
+    return parseLsofOutput(stdout);
+}
+export function parseLsofOutput(out) {
+    let pid = null;
+    for (const line of out.split('\n')) {
+        if (line.startsWith('p')) {
+            const n = Number.parseInt(line.slice(1), 10);
+            pid = Number.isFinite(n) ? n : null;
+            continue;
+        }
+        if (line.startsWith('c') && pid !== null) {
+            return { pid, binaryName: decodeLsofString(line.slice(1)) };
+        }
+    }
+    return null;
+}
+/** lsof escapes spaces and tabs in command names as \xHH. Reverse that. */
+export function decodeLsofString(s) {
+    return s.replace(/\\x([0-9a-fA-F]{2})/g, (_, hex) => String.fromCharCode(Number.parseInt(hex, 16)));
+}
+/**
+ * Windows path: `netstat -ano` lists every TCP connection with its owning
+ * PID. We then ask `tasklist` for the image name of that PID. Both ship by
+ * default with Windows; no extra tooling needed.
+ */
+async function lookupWindows(host, port) {
+    const { stdout: netstatOut } = await execAsync('netstat -ano -p TCP', {
+        timeout: LOOKUP_TIMEOUT_MS,
+    });
+    const pid = parseNetstatForLocal(netstatOut, host, port);
+    if (pid === null)
+        return null;
+    const { stdout: tasklistOut } = await execAsync(`tasklist /FI "PID eq ${pid}" /FO CSV /NH`, {
+        timeout: LOOKUP_TIMEOUT_MS,
+    });
+    const binaryName = parseTasklistImage(tasklistOut);
+    return binaryName ? { pid, binaryName } : null;
+}
+export function parseNetstatForLocal(out, host, port) {
+    const target = `${host}:${port}`;
+    for (const line of out.split(/\r?\n/)) {
+        if (!line.includes(target))
+            continue;
+        // Format:  Proto  LocalAddress  ForeignAddress  State  PID
+        const fields = line.trim().split(/\s+/);
+        if (fields.length < 5)
+            continue;
+        if (fields[1] !== target)
+            continue;
+        const pid = Number.parseInt(fields[4] ?? '', 10);
+        if (Number.isFinite(pid))
+            return pid;
+    }
+    return null;
+}
+export function parseTasklistImage(out) {
+    // CSV with no header:  "image.exe","PID","Session Name","Session#","Mem Usage"
+    for (const line of out.split(/\r?\n/)) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        const match = trimmed.match(/^"([^"]+)"/);
+        if (match?.[1])
+            return match[1];
+    }
+    return null;
+}
+//# sourceMappingURL=process-identity.js.map

package/dist/auth/process-identity.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+import { formatDoctor, runDoctor } from './commands/doctor.js';
+import { installAll, installFor } from './commands/install.js';
+import { uninstallAll, uninstallFor } from './commands/uninstall.js';
+import { printExtensionInstructions } from './commands/extension.js';
+import { printAbout } from './commands/about.js';
+import { loadConfig } from './config.js';
+const HELP = `browser-link — bridge Claude Code to the Chrome tabs you enable.
+
+Usage:
+  browser-link                  When invoked from an interactive terminal,
+                                opens a setup menu (register Claude Code,
+                                show extension steps, run doctor, about).
+                                When invoked by Claude Code (no TTY),
+                                starts the MCP server over stdio.
+  browser-link install          Register browser-link with Claude Code.
+  browser-link uninstall        Remove the registration.
+  browser-link extension        Show the path of the Chrome extension assets
+                                and per-OS install instructions.
+  browser-link doctor           Diagnose current setup (Claude Code, server, extension, map DB).
+  browser-link about            Show the full explanation of what this is and how it works.
+  browser-link help             This message.
+
+Environment:
+  BROWSER_LINK_DATA_DIR         Override the DB location (defaults per OS).
+  BROWSER_LINK_BIN              Override the command stored in client configs
+                                (e.g. "node /path/to/dist/index.js" for dev).`;
+function parseClient(argv) {
+    const idx = argv.findIndex((a) => a === '--client');
+    if (idx === -1 || idx === argv.length - 1)
+        return null;
+    const val = argv[idx + 1];
+    if (val === 'claude' || val === 'opencode')
+        return val;
+    throw new Error(`Unknown --client value: ${val}. Use claude or opencode.`);
+}
+async function dispatch(argv) {
+    const [cmd, ...rest] = argv;
+    switch (cmd) {
+        case undefined:
+        case 'start': {
+            const { runServer } = await import('./server.js');
+            await runServer();
+            return;
+        }
+        case 'help':
+        case '-h':
+        case '--help': {
+            console.log(HELP);
+            return;
+        }
+        case 'install': {
+            const client = parseClient(rest);
+            const reports = client ? [installFor(client)] : installAll();
+            for (const r of reports) {
+                const prefix = r.installedClient ? '✓' : '·';
+                console.log(`${prefix} ${r.displayName}: ${r.message}`);
+            }
+            console.log('');
+            console.log('Restart the MCP client so it picks up the registration.');
+            console.log('Next: install the Chrome extension — run `browser-link extension`.');
+            return;
+        }
+        case 'uninstall': {
+            const client = parseClient(rest);
+            const reports = client ? [uninstallFor(client)] : uninstallAll();
+            for (const r of reports)
+                console.log(`· ${r.displayName}: ${r.message}`);
+            return;
+        }
+        case 'extension': {
+            printExtensionInstructions();
+            return;
+        }
+        case 'doctor': {
+            const report = await runDoctor();
+            console.log(formatDoctor(report));
+            return;
+        }
+        case 'about': {
+            const cfg = loadConfig();
+            printAbout(cfg.language ?? 'en');
+            return;
+        }
+        default: {
+            console.error(`Unknown command: ${cmd}`);
+            console.error('');
+            console.error(HELP);
+            process.exit(2);
+        }
+    }
+}
+const argv = process.argv.slice(2);
+// No args + both stdin and stdout are TTYs → human in a terminal: show the
+// welcome / disclaimer screen (unless previously dismissed) and then the
+// setup menu in the chosen language.
+// Otherwise (no TTY anywhere, or output piped) → start the MCP server over stdio.
+if (argv.length === 0 && process.stdin.isTTY && process.stdout.isTTY) {
+    const cfg = loadConfig();
+    const { runMenu } = await import('./commands/menu.js');
+    let language = cfg.language ?? 'en';
+    if (!cfg.skipWelcome) {
+        const { runWelcome } = await import('./commands/welcome.js');
+        const welcome = await runWelcome({ initial: language });
+        if (welcome.action === 'quit')
+            process.exit(0);
+        language = welcome.language;
+    }
+    await runMenu(language);
+    process.exit(0);
+}
+dispatch(argv).catch((err) => {
+    console.error(err instanceof Error ? err.message : String(err));
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;8EAmBiE,CAAC;AAE/E,SAAS,WAAW,CAAC,IAAc;IACjC,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC;IACpD,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,GAAG,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACvD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IAC1B,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,UAAU;QAAE,OAAO,GAAG,CAAC;IACvD,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,2BAA2B,CAAC,CAAC;AAC7E,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,IAAc;IACpC,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAE5B,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,SAAS,CAAC;QACf,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;YAClD,MAAM,SAAS,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QACD,KAAK,MAAM,CAAC;QACZ,KAAK,IAAI,CAAC;QACV,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClB,OAAO;QACT,CAAC;QACD,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;YACjC,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;YAC7D,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,MAAM,MAAM,GAAG,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;gBAC7C,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAC1D,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,yDAAyD,CAAC,CAAC;YACvE,OAAO,CAAC,GAAG,CAAC,oEAAoE,CAAC,CAAC;YAClF,OAAO;QACT,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;YACjC,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC;YACjE,KAAK,MAAM,CAAC,IAAI,OAAO;gBAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YACzE,OAAO;QACT,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,0BAA0B,EAAE,CAAC;YAC7B,OAAO;QACT,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;YACjC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;YAClC,OAAO;QACT,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;YACzB,UAAU,CAAC,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC;YACjC,OAAO;QACT,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,OAAO,CAAC,KAAK,CAAC,oBAAoB,GAAG,EAAE,CAAC,CAAC;YACzC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAClB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEnC,2EAA2E;AAC3E,yEAAyE;AACzE,qCAAqC;AACrC,kFAAkF;AAClF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACrE,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;IACvD,IAAI,QAAQ,GAAG,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC;IACpC,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;QACrB,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;QAC7D,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;QACxD,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM;YAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC/C,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAC9B,CAAC;IACD,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAC3B,OAAO,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/commands/about.d.ts

@@ -0,0 +1,23 @@
+import type { Language } from './welcome.js';
+interface AboutI18n {
+    title: string;
+    whatItIs: string[];
+    howItWorks: string[];
+    bridgeTools: {
+        title: string;
+        items: string[];
+    };
+    mapTools: {
+        title: string;
+        items: string[];
+    };
+    privacy: string[];
+    whereToGetHelp: string[];
+    prompt: string;
+}
+export declare const I18N_ABOUT: Record<Language, AboutI18n>;
+export declare function buildAboutScreen(t: AboutI18n): string;
+export declare function runAbout(language?: Language): Promise<void>;
+/** Plain-text render of About for non-interactive output (browser-link about). */
+export declare function printAbout(language?: Language): void;
+export {};