@jobshimo/browser-link 0.1.0 → 0.4.0

package/dist/commands/welcome.js

@@ -1,14 +1,15 @@
-import * as p from '@clack/prompts';
-import { saveConfig } from '../config.js';
+/* Welcome screen strings (English / Spanish) shared by the interactive Ink
+ * Welcome view and any future non-interactive caller. No runtime logic here
+ * — every screen consumes this as a pure data module. */
 export const I18N_WELCOME = {
     en: {
         title: 'browser-link',
         aboutTitle: 'What this is',
         about: [
             'An MCP server that opens a small WebSocket bridge between an MCP',
-            'client (Claude Code, OpenCode, …) and the Google Chrome tabs you',
-            'explicitly grant access to through a custom companion extension you',
-            'load locally.',
+            'client (Claude Code, OpenCode, GitHub Copilot CLI…) and the Google',
+            'Chrome tabs you explicitly grant access to through a custom companion',
+            'extension you load locally.',
         ].join('\n'),
         capabilitiesTitle: 'What the agent can do on a connected tab',
         capabilities: [
@@ -22,7 +23,7 @@ export const I18N_WELCOME = {
             'about each app across sessions in a local SQLite map (selectors,',
             'flows, gotchas — never uploaded anywhere).',
         ].join('\n'),
-        warningTitle: '⚠  Read this before you continue',
+        warningTitle: 'Read this before you continue',
         warning: [
             'Connecting a tab gives the agent access to whatever is on it — any',
             'logged-in session, saved card, wallet, banking page, work console or',
@@ -51,9 +52,9 @@ export const I18N_WELCOME = {
         aboutTitle: 'Qué es esto',
         about: [
             'Un servidor MCP que abre un puente WebSocket entre un cliente MCP',
-            '(Claude Code, OpenCode, …) y las pestañas de Google Chrome a las que',
-            'vos le des acceso explícito a través de una extensión que cargás vos',
-            'manualmente.',
+            '(Claude Code, OpenCode, GitHub Copilot CLI…) y las pestañas de Google',
+            'Chrome a las que vos le des acceso explícito a través de una extensión',
+            'que cargás vos manualmente.',
         ].join('\n'),
         capabilitiesTitle: 'Qué puede hacer el agente en una pestaña conectada',
         capabilities: [
@@ -67,7 +68,7 @@ export const I18N_WELCOME = {
             'aprende de cada app entre sesiones en un mapa SQLite local (selectores,',
             'flujos, gotchas — nunca se sube a ningún lado).',
         ].join('\n'),
-        warningTitle: '⚠  Leelo antes de continuar',
+        warningTitle: 'Leelo antes de continuar',
         warning: [
             'Conectar una pestaña le da al agente acceso a todo lo que esté en esa',
             'pestaña: sesiones iniciadas, tarjetas guardadas, wallets, banca,',
@@ -94,41 +95,4 @@ export const I18N_WELCOME = {
         },
     },
 };
-export async function runWelcome(opts = {}) {
-    let lang = opts.initial ?? 'en';
-    const hideDismiss = opts.hideDismiss === true;
-    while (true) {
-        const t = I18N_WELCOME[lang];
-        p.intro(t.title);
-        p.note(t.about, t.aboutTitle);
-        p.note(t.capabilities, t.capabilitiesTitle);
-        p.note(t.warning, t.warningTitle);
-        p.note(`${t.responsibility}\n\n${t.extensionNote}`);
-        const options = [
-            { value: 'accept', label: t.options.accept },
-        ];
-        if (!hideDismiss)
-            options.push({ value: 'dismiss', label: t.options.dismiss });
-        options.push({ value: 'swap', label: t.options.swap }, { value: 'quit', label: t.options.quit });
-        const choice = (await p.select({
-            message: t.prompt,
-            options,
-            initialValue: 'accept',
-        }));
-        if (p.isCancel(choice) || choice === 'quit') {
-            p.cancel(lang === 'es' ? 'Cancelado.' : 'Cancelled.');
-            return { action: 'quit', language: lang, persisted: false };
-        }
-        if (choice === 'swap') {
-            lang = lang === 'en' ? 'es' : 'en';
-            continue;
-        }
-        if (choice === 'dismiss') {
-            saveConfig({ skipWelcome: true, language: lang });
-            return { action: 'continue', language: lang, persisted: true };
-        }
-        // accept
-        return { action: 'continue', language: lang, persisted: false };
-    }
-}
 //# sourceMappingURL=welcome.js.map

package/dist/commands/welcome.js.map

@@ -1 +1 @@
-{"version":3,"file":"welcome.js","sourceRoot":"","sources":["../../src/commands/welcome.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"welcome.js","sourceRoot":"","sources":["../../src/commands/welcome.ts"],"names":[],"mappings":"AAAA;;yDAEyD;AAkCzD,MAAM,CAAC,MAAM,YAAY,GAA2B;IAClD,EAAE,EAAE;QACF,KAAK,EAAE,cAAc;QACrB,UAAU,EAAE,cAAc;QAC1B,KAAK,EAAE;YACL,kEAAkE;YAClE,oEAAoE;YACpE,uEAAuE;YACvE,6BAA6B;SAC9B,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,iBAAiB,EAAE,0CAA0C;QAC7D,YAAY,EAAE;YACZ,gCAAgC;YAChC,6CAA6C;YAC7C,oCAAoC;YACpC,oDAAoD;YACpD,EAAE;YACF,oEAAoE;YACpE,uEAAuE;YACvE,kEAAkE;YAClE,4CAA4C;SAC7C,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,YAAY,EAAE,+BAA+B;QAC7C,OAAO,EAAE;YACP,oEAAoE;YACpE,sEAAsE;YACtE,2DAA2D;YAC3D,EAAE;YACF,uEAAuE;YACvE,wEAAwE;YACxE,qEAAqE;YACrE,EAAE;YACF,uEAAuE;YACvE,uEAAuE;YACvE,4BAA4B;SAC7B,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,cAAc,EACZ,iLAAiL;QACnL,aAAa,EACX,yLAAyL;QAC3L,MAAM,EAAE,6BAA6B;QACrC,OAAO,EAAE;YACP,MAAM,EAAE,wBAAwB;YAChC,OAAO,EAAE,6BAA6B;YACtC,IAAI,EAAE,mBAAmB;YACzB,IAAI,EAAE,MAAM;SACb;KACF;IACD,EAAE,EAAE;QACF,KAAK,EAAE,cAAc;QACrB,UAAU,EAAE,aAAa;QACzB,KAAK,EAAE;YACL,mEAAmE;YACnE,uEAAuE;YACvE,wEAAwE;YACxE,6BAA6B;SAC9B,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,iBAAiB,EAAE,oDAAoD;QACvE,YAAY,EAAE;YACZ,uCAAuC;YACvC,+CAA+C;YAC/C,2CAA2C;YAC3C,8DAA8D;YAC9D,EAAE;YACF,qEAAqE;YACrE,uEAAuE;YACvE,yEAAyE;YACzE,iDAAiD;SAClD,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,YAAY,EAAE,0BAA0B;QACxC,OAAO,EAAE;YACP,uEAAuE;YACvE,kEAAkE;YAClE,qEAAqE;YACrE,wCAAwC;YACxC,EAAE;YACF,iEAAiE;YACjE,4DAA4D;YAC5D,qEAAqE;YACrE,oCAAoC;YACpC,EAAE;YACF,oEAAoE;YACpE,uEAAuE;YACvE,4BAA4B;SAC7B,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,cAAc,EACZ,oMAAoM;QACtM,aAAa,EACX,qNAAqN;QACvN,MAAM,EAAE,sBAAsB;QAC9B,OAAO,EAAE;YACP,MAAM,EAAE,sBAAsB;YAC9B,OAAO,EAAE,+BAA+B;YACxC,IAAI,EAAE,mBAAmB;YACzB,IAAI,EAAE,OAAO;SACd;KACF;CACF,CAAC"}

package/dist/config.d.ts

@@ -1,11 +1,33 @@
 /**
- * Small per-user config persisted next to the map DB. Only meant for UX
- * preferences (e.g. "don't show me the welcome screen every time").
- * No domain data ever lives here.
+ * Small per-user config persisted next to the map DB. UX preferences and
+ * the tool-access deny list — never any domain data.
  */
 export interface BrowserLinkConfig {
     skipWelcome?: boolean;
     language?: 'en' | 'es';
+    /**
+     * Tool names the MCP server must not expose. Empty / undefined means
+     * "everything enabled" (default, backwards-compatible). Unknown names
+     * are dropped silently by sanitizeDisabledTools so old configs survive
+     * tool renames or removals.
+     */
+    disabledTools?: string[];
+    /**
+     * Multi-agent mode. When false (default), only one MCP client can have
+     * browser-link active at a time; a second client trying to spawn the
+     * server crashes with EADDRINUSE. When true, the second instance becomes
+     * a proxy that forwards MCP requests to the first one over an internal
+     * IPC port (127.0.0.1:17530). All agents end up sharing the same Chrome
+     * tabs and the same persistent UI map.
+     */
+    multiAgent?: boolean;
+    /**
+     * Only honoured when multiAgent === true. When false (default), if the
+     * primary's MCP client closes, secondary clients lose the bridge and
+     * have to be relaunched manually. When true, one of the secondaries
+     * takes over the primary role automatically (race on bind(17529)).
+     */
+    autoReelect?: boolean;
 }
 export declare function loadConfig(): BrowserLinkConfig;
 export declare function saveConfig(patch: Partial<BrowserLinkConfig>): BrowserLinkConfig;

package/dist/config.js

@@ -1,9 +1,42 @@
 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';
 function configFile() {
     return join(getDataDir(), 'config.json');
 }
+function normalise(cfg) {
+    // Always run the disabled-tools list through the sanitizer — both on read
+    // and on write — so unknown names from a downgraded build, a typo, or a
+    // manual edit never reach the server filter.
+    const sanitized = sanitizeDisabledTools(cfg.disabledTools);
+    let next;
+    if (sanitized.length === 0) {
+        const { disabledTools: _omit, ...rest } = cfg;
+        next = rest;
+    }
+    else {
+        next = { ...cfg, disabledTools: sanitized };
+    }
+    // autoReelect only makes sense when multiAgent is on. Drop a stray
+    // autoReelect:true if multiAgent is off, so the config file never has
+    // an inert flag advertising a behaviour it does not produce.
+    if (next.autoReelect && !next.multiAgent) {
+        const { autoReelect: _omit2, ...rest2 } = next;
+        next = rest2;
+    }
+    // Drop explicit `false` for the two new flags too — the default is false,
+    // so storing it just adds noise.
+    if (next.multiAgent === false) {
+        const { multiAgent: _omit3, ...rest3 } = next;
+        next = rest3;
+    }
+    if (next.autoReelect === false) {
+        const { autoReelect: _omit4, ...rest4 } = next;
+        next = rest4;
+    }
+    return next;
+}
 export function loadConfig() {
     const path = configFile();
     if (!existsSync(path))
@@ -12,7 +45,7 @@ export function loadConfig() {
         const raw = readFileSync(path, 'utf8');
         const parsed = JSON.parse(raw);
         if (parsed && typeof parsed === 'object')
-            return parsed;
+            return normalise(parsed);
         return {};
     }
     catch (err) {
@@ -28,7 +61,7 @@ export function saveConfig(patch) {
     const path = configFile();
     mkdirSync(dirname(path), { recursive: true });
     const current = loadConfig();
-    const next = { ...current, ...patch };
+    const next = normalise({ ...current, ...patch });
     writeFileSync(path, JSON.stringify(next, null, 2) + '\n', 'utf8');
     return next;
 }

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAY5C,SAAS,UAAU;IACjB,OAAO,IAAI,CAAC,UAAU,EAAE,EAAE,aAAa,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;IAC1B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;QAC1C,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,OAAO,MAA2B,CAAC;QAC7E,OAAO,EAAE,CAAC;IACZ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,kEAAkE;QAClE,kEAAkE;QAClE,mEAAmE;QACnE,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,CAAC,IAAI,CAAC,2CAA2C,IAAI,KAAK,OAAO,mBAAmB,CAAC,CAAC;QAC7F,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAiC;IAC1D,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;IAC1B,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,IAAI,GAAsB,EAAE,GAAG,OAAO,EAAE,GAAG,KAAK,EAAE,CAAC;IACzD,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;IAClE,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/installers/copilot.d.ts

@@ -0,0 +1,2 @@
+import type { Installer } from './types.js';
+export declare const copilotInstaller: Installer;

package/dist/installers/copilot.js

@@ -0,0 +1,72 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+const SERVER_NAME = 'browser-link';
+function configFile() {
+    // GitHub Copilot CLI reads from ~/.copilot/mcp-config.json by default.
+    // COPILOT_HOME overrides the directory (the same env var the CLI honours).
+    const root = process.env.COPILOT_HOME ?? join(homedir(), '.copilot');
+    return join(root, 'mcp-config.json');
+}
+function readConfig(path) {
+    if (!existsSync(path))
+        return {};
+    try {
+        return JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch {
+        throw new Error(`Could not parse Copilot config at ${path}. Fix the file or delete it.`);
+    }
+}
+function writeConfig(path, cfg) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, JSON.stringify(cfg, null, 2) + '\n', 'utf8');
+}
+function isRegistered(cfg) {
+    return !!cfg.mcpServers?.[SERVER_NAME];
+}
+export const copilotInstaller = {
+    id: 'copilot',
+    displayName: 'GitHub Copilot CLI',
+    configPath() {
+        return configFile();
+    },
+    detect() {
+        const path = configFile();
+        if (!existsSync(path)) {
+            return { installed: false, registered: false, configPath: path };
+        }
+        const cfg = readConfig(path);
+        return { installed: true, registered: isRegistered(cfg), configPath: path };
+    },
+    install(command, args) {
+        const path = configFile();
+        const cfg = readConfig(path);
+        cfg.mcpServers = cfg.mcpServers ?? {};
+        const existing = cfg.mcpServers[SERVER_NAME];
+        // Copilot requires `env` and `tools` even when empty/wildcard.
+        cfg.mcpServers[SERVER_NAME] = {
+            type: 'local',
+            command,
+            args,
+            env: {},
+            tools: ['*'],
+        };
+        writeConfig(path, cfg);
+        return existing
+            ? `Updated ${SERVER_NAME} entry in ${path}.`
+            : `Added ${SERVER_NAME} entry to ${path}.`;
+    },
+    uninstall() {
+        const path = configFile();
+        if (!existsSync(path))
+            return `No Copilot CLI config at ${path}; nothing to remove.`;
+        const cfg = readConfig(path);
+        if (!cfg.mcpServers?.[SERVER_NAME])
+            return `${SERVER_NAME} was not registered in ${path}.`;
+        delete cfg.mcpServers[SERVER_NAME];
+        writeConfig(path, cfg);
+        return `Removed ${SERVER_NAME} entry from ${path}.`;
+    },
+};
+//# sourceMappingURL=copilot.js.map

package/dist/installers/copilot.js.map

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

package/dist/installers/index.js

@@ -1,10 +1,11 @@
 import { claudeInstaller } from './claude.js';
+import { copilotInstaller } from './copilot.js';
 import { opencodeInstaller } from './opencode.js';
 /**
  * Installers wired into the CLI surface (`install`, `install --client X`,
  * the interactive menu, and `doctor`). Order here is the display order.
  */
-export const INSTALLERS = [claudeInstaller, opencodeInstaller];
+export const INSTALLERS = [claudeInstaller, opencodeInstaller, copilotInstaller];
 export function getInstaller(id) {
     const found = INSTALLERS.find((i) => i.id === id);
     if (!found)

package/dist/installers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/installers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGlD;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAgB,CAAC,eAAe,EAAE,iBAAiB,CAAC,CAAC;AAE5E,MAAM,UAAU,YAAY,CAAC,EAAY;IACvC,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAClD,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,EAAE,EAAE,CAAC,CAAC;IACpE,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/installers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGlD;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAgB,CAAC,eAAe,EAAE,iBAAiB,EAAE,gBAAgB,CAAC,CAAC;AAE9F,MAAM,UAAU,YAAY,CAAC,EAAY;IACvC,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAClD,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,EAAE,EAAE,CAAC,CAAC;IACpE,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/installers/types.d.ts

@@ -1,4 +1,4 @@
-export type ClientId = 'claude' | 'opencode';
+export type ClientId = 'claude' | 'opencode' | 'copilot';
 export interface ClientInfo {
     id: ClientId;
     displayName: string;

package/dist/messages.d.ts

@@ -9,6 +9,13 @@ export type TabId = string;
 export interface TabRegisterPayload {
     url: string;
     title: string;
+    /**
+     * Optional. The browser-link tab_id this Chrome tab last had, as
+     * remembered by the extension across primary swaps. The primary honours
+     * it if free; otherwise it assigns a new id and emits a `tab-renamed`
+     * event the agent can pick up via the `browser.events` tool.
+     */
+    previousTabId?: TabId;
 }
 export interface TabRegisteredPayload {
     tabId: TabId;

package/dist/permissions.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Tool access control — single source of truth for which MCP tools
+ * browser-link exposes and how the user can narrow that down.
+ *
+ * The runtime answer to "is this tool allowed?" is computed from the
+ * `disabledTools` list in `config.json` (default: empty = everything
+ * allowed). The catalogue below adds human-readable metadata used by
+ * the UI and the CLI subcommand — it never affects what the MCP server
+ * returns by itself.
+ */
+export type ToolFamily = 'bridge' | 'map';
+/** Coarse-grained behaviour bucket — used by presets, not by the runtime
+ * filter. The runtime only cares about the exact tool name. */
+export type ToolCategory = 'read' | 'action' | 'eval' | 'map-read' | 'map-write';
+export interface ToolMeta {
+    name: string;
+    family: ToolFamily;
+    category: ToolCategory;
+    summary: string;
+}
+export declare const TOOL_CATALOGUE: readonly ToolMeta[];
+export type PresetId = 'all' | 'readonly' | 'no-eval' | 'no-map';
+export interface PresetDef {
+    id: PresetId;
+    label: string;
+    /** Which tool names this preset disables. */
+    disabled: readonly string[];
+}
+export declare const PRESETS: readonly PresetDef[];
+/** True when the tool should be exposed in tools/list and accepted in tools/call. */
+export declare function isToolEnabled(name: string, disabled: readonly string[] | undefined): boolean;
+/** Drop entries that don't match any current tool, dedupe, and sort. Used
+ * before writing the list to disk and after reading it back, so unknown
+ * names from older or newer versions never poison the runtime. */
+export declare function sanitizeDisabledTools(input: readonly string[] | undefined): string[];
+export declare function getPreset(id: PresetId): PresetDef;
+export declare function isKnownTool(name: string): boolean;

package/dist/permissions.js

@@ -0,0 +1,156 @@
+/**
+ * Tool access control — single source of truth for which MCP tools
+ * browser-link exposes and how the user can narrow that down.
+ *
+ * The runtime answer to "is this tool allowed?" is computed from the
+ * `disabledTools` list in `config.json` (default: empty = everything
+ * allowed). The catalogue below adds human-readable metadata used by
+ * the UI and the CLI subcommand — it never affects what the MCP server
+ * returns by itself.
+ */
+export const TOOL_CATALOGUE = [
+    // Browser bridge — read-only
+    { name: 'browser.list_tabs', family: 'bridge', category: 'read', summary: 'List connected tabs' },
+    {
+        name: 'browser.ping',
+        family: 'bridge',
+        category: 'read',
+        summary: 'Verify the bridge to a tab',
+    },
+    {
+        name: 'browser.snapshot',
+        family: 'bridge',
+        category: 'read',
+        summary: 'Dump DOM, text and interactive elements',
+    },
+    {
+        name: 'browser.console',
+        family: 'bridge',
+        category: 'read',
+        summary: 'Read recent console messages',
+    },
+    {
+        name: 'browser.network',
+        family: 'bridge',
+        category: 'read',
+        summary: 'Read recent network requests',
+    },
+    {
+        name: 'browser.network_body',
+        family: 'bridge',
+        category: 'read',
+        summary: 'Fetch the body of a specific request',
+    },
+    // Browser bridge — actions
+    {
+        name: 'browser.navigate',
+        family: 'bridge',
+        category: 'action',
+        summary: 'Navigate the tab to a URL',
+    },
+    {
+        name: 'browser.click',
+        family: 'bridge',
+        category: 'action',
+        summary: 'Click an element by CSS selector',
+    },
+    {
+        name: 'browser.type',
+        family: 'bridge',
+        category: 'action',
+        summary: 'Type text into an input',
+    },
+    // Browser bridge — arbitrary code
+    {
+        name: 'browser.evaluate',
+        family: 'bridge',
+        category: 'eval',
+        summary: 'Run arbitrary JavaScript in the page',
+    },
+    // Persistent map — reads
+    {
+        name: 'browser.map.recall',
+        family: 'map',
+        category: 'map-read',
+        summary: 'Recall selectors / flows / gotchas for an app',
+    },
+    { name: 'browser.map.apps', family: 'map', category: 'map-read', summary: 'List known apps' },
+    // Persistent map — writes
+    {
+        name: 'browser.map.save',
+        family: 'map',
+        category: 'map-write',
+        summary: 'Persist a selector / flow / gotcha',
+    },
+    {
+        name: 'browser.map.record_use',
+        family: 'map',
+        category: 'map-write',
+        summary: 'Mark an entry verified or failed',
+    },
+    {
+        name: 'browser.map.forget',
+        family: 'map',
+        category: 'map-write',
+        summary: 'Delete an entry or a whole app',
+    },
+    {
+        name: 'browser.map.rename_app',
+        family: 'map',
+        category: 'map-write',
+        summary: 'Rename an app_key',
+    },
+];
+function namesWhere(predicate) {
+    return TOOL_CATALOGUE.filter(predicate)
+        .map((m) => m.name)
+        .sort();
+}
+export const PRESETS = [
+    { id: 'all', label: 'All enabled', disabled: [] },
+    {
+        id: 'readonly',
+        label: 'Read-only (no actions, no JS, no map writes)',
+        disabled: namesWhere((m) => m.category === 'action' || m.category === 'eval' || m.category === 'map-write'),
+    },
+    {
+        id: 'no-eval',
+        label: 'No evaluate (everything except arbitrary JS)',
+        disabled: ['browser.evaluate'],
+    },
+    {
+        id: 'no-map',
+        label: 'No persistent map (all bridge tools on)',
+        disabled: namesWhere((m) => m.family === 'map'),
+    },
+];
+const KNOWN_NAMES = new Set(TOOL_CATALOGUE.map((m) => m.name));
+/** True when the tool should be exposed in tools/list and accepted in tools/call. */
+export function isToolEnabled(name, disabled) {
+    if (!disabled || disabled.length === 0)
+        return true;
+    return !disabled.includes(name);
+}
+/** Drop entries that don't match any current tool, dedupe, and sort. Used
+ * before writing the list to disk and after reading it back, so unknown
+ * names from older or newer versions never poison the runtime. */
+export function sanitizeDisabledTools(input) {
+    if (!input || input.length === 0)
+        return [];
+    const out = new Set();
+    for (const name of input) {
+        if (typeof name === 'string' && KNOWN_NAMES.has(name))
+            out.add(name);
+    }
+    return [...out].sort();
+}
+export function getPreset(id) {
+    const found = PRESETS.find((p) => p.id === id);
+    if (!found)
+        throw new Error(`Unknown preset: ${id}`);
+    return found;
+}
+export function isKnownTool(name) {
+    return KNOWN_NAMES.has(name);
+}
+//# sourceMappingURL=permissions.js.map

package/dist/permissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../src/permissions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAeH,MAAM,CAAC,MAAM,cAAc,GAAwB;IACjD,6BAA6B;IAC7B,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,EAAE;IACjG;QACE,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,MAAM;QAChB,OAAO,EAAE,4BAA4B;KACtC;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,MAAM;QAChB,OAAO,EAAE,yCAAyC;KACnD;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,MAAM;QAChB,OAAO,EAAE,8BAA8B;KACxC;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,MAAM;QAChB,OAAO,EAAE,8BAA8B;KACxC;IACD;QACE,IAAI,EAAE,sBAAsB;QAC5B,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,MAAM;QAChB,OAAO,EAAE,sCAAsC;KAChD;IAED,2BAA2B;IAC3B;QACE,IAAI,EAAE,kBAAkB;QACxB,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,QAAQ;QAClB,OAAO,EAAE,2BAA2B;KACrC;IACD;QACE,IAAI,EAAE,eAAe;QACrB,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,QAAQ;QAClB,OAAO,EAAE,kCAAkC;KAC5C;IACD;QACE,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,QAAQ;QAClB,OAAO,EAAE,yBAAyB;KACnC;IAED,kCAAkC;IAClC;QACE,IAAI,EAAE,kBAAkB;QACxB,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,MAAM;QAChB,OAAO,EAAE,sCAAsC;KAChD;IAED,yBAAyB;IACzB;QACE,IAAI,EAAE,oBAAoB;QAC1B,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,UAAU;QACpB,OAAO,EAAE,+CAA+C;KACzD;IACD,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,iBAAiB,EAAE;IAE7F,0BAA0B;IAC1B;QACE,IAAI,EAAE,kBAAkB;QACxB,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,WAAW;QACrB,OAAO,EAAE,oCAAoC;KAC9C;IACD;QACE,IAAI,EAAE,wBAAwB;QAC9B,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,WAAW;QACrB,OAAO,EAAE,kCAAkC;KAC5C;IACD;QACE,IAAI,EAAE,oBAAoB;QAC1B,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,WAAW;QACrB,OAAO,EAAE,gCAAgC;KAC1C;IACD;QACE,IAAI,EAAE,wBAAwB;QAC9B,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,WAAW;QACrB,OAAO,EAAE,mBAAmB;KAC7B;CACF,CAAC;AAWF,SAAS,UAAU,CAAC,SAAmC;IACrD,OAAO,cAAc,CAAC,MAAM,CAAC,SAAS,CAAC;SACpC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SAClB,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,CAAC,MAAM,OAAO,GAAyB;IAC3C,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,EAAE,EAAE;IACjD;QACE,EAAE,EAAE,UAAU;QACd,KAAK,EAAE,8CAA8C;QACrD,QAAQ,EAAE,UAAU,CAClB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,KAAK,MAAM,IAAI,CAAC,CAAC,QAAQ,KAAK,WAAW,CACtF;KACF;IACD;QACE,EAAE,EAAE,SAAS;QACb,KAAK,EAAE,8CAA8C;QACrD,QAAQ,EAAE,CAAC,kBAAkB,CAAC;KAC/B;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,yCAAyC;QAChD,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC;KAChD;CACF,CAAC;AAEF,MAAM,WAAW,GAAwB,IAAI,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAEpF,qFAAqF;AACrF,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,QAAuC;IACjF,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC;AAED;;kEAEkE;AAClE,MAAM,UAAU,qBAAqB,CAAC,KAAoC;IACxE,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,EAAY;IACpC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/C,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;IACrD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC"}

package/dist/server.d.ts

@@ -1,6 +1,10 @@
 export declare const WS_HOST = "127.0.0.1";
 export declare const WS_PORT = 17529;
-/** Start the MCP server (stdio transport) and the WebSocket bridge.
- * Resolves only when both are ready. If the WebSocket bind fails the
- * MCP transport is never exposed and the caller sees a clear error. */
+/**
+ * Entry point used by the MCP client over stdio. Decides whether THIS
+ * process becomes the primary (binds 17529, runs the WS bridge + MCP
+ * server + optional IPC server) or — when multi-agent mode is enabled
+ * and another primary is already running — becomes a thin proxy that
+ * forwards MCP stdio frames to the primary over IPC.
+ */
 export declare function runServer(): Promise<void>;