@jobshimo/browser-link 0.0.1

package/dist/map/queries.js

@@ -0,0 +1,162 @@
+import { getDb } from './db.js';
+function now() {
+    return new Date().toISOString();
+}
+function parsePayload(raw) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return raw;
+    }
+}
+function hydrate(row) {
+    return { ...row, payload: parsePayload(row.payload) };
+}
+function slugify(text) {
+    return text
+        .normalize('NFD')
+        .replace(/[̀-ͯ]/g, '')
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+function deriveAppKey(origin, title) {
+    if (title && title.trim().length > 0) {
+        const slug = slugify(title);
+        if (slug.length > 0)
+            return slug;
+    }
+    // last-resort: use origin host as key
+    try {
+        return slugify(new URL(origin).host);
+    }
+    catch {
+        return slugify(origin) || 'app';
+    }
+}
+export function upsertApp(input) {
+    const db = getDb();
+    const ts = now();
+    const app_key = input.app_key && input.app_key.trim().length > 0
+        ? slugify(input.app_key)
+        : deriveAppKey(input.origin, input.title);
+    const existing = db
+        .prepare('SELECT * FROM apps WHERE origin = ? AND app_key = ?')
+        .get(input.origin, app_key);
+    if (existing) {
+        db.prepare(`UPDATE apps SET title = COALESCE(?, title), notes = COALESCE(?, notes), last_seen_at = ? WHERE id = ?`).run(input.title ?? null, input.notes ?? null, ts, existing.id);
+        return db.prepare('SELECT * FROM apps WHERE id = ?').get(existing.id);
+    }
+    const info = db
+        .prepare(`INSERT INTO apps (origin, app_key, title, notes, created_at, last_seen_at)
+       VALUES (?, ?, ?, ?, ?, ?)`)
+        .run(input.origin, app_key, input.title ?? null, input.notes ?? null, ts, ts);
+    return db.prepare('SELECT * FROM apps WHERE id = ?').get(info.lastInsertRowid);
+}
+export function saveEntry(input) {
+    const app = upsertApp({
+        origin: input.origin,
+        app_key: input.app_key ?? null,
+        title: input.title ?? null,
+    });
+    const ts = now();
+    const payloadJson = JSON.stringify(input.payload);
+    const db = getDb();
+    const existing = db
+        .prepare(`SELECT * FROM entries WHERE app_id = ? AND url_pattern = ? AND kind = ? AND purpose = ?`)
+        .get(app.id, input.url_pattern, input.kind, input.purpose);
+    if (existing) {
+        db.prepare(`UPDATE entries
+       SET payload = ?, notes = COALESCE(?, notes), verified_at = ?, failed_at = NULL, updated_at = ?
+       WHERE id = ?`).run(payloadJson, input.notes ?? null, ts, ts, existing.id);
+        const updated = db
+            .prepare('SELECT * FROM entries WHERE id = ?')
+            .get(existing.id);
+        return { app, entry: hydrate(updated) };
+    }
+    const info = db
+        .prepare(`INSERT INTO entries (app_id, url_pattern, kind, purpose, payload, verified_at, notes, created_at, updated_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+        .run(app.id, input.url_pattern, input.kind, input.purpose, payloadJson, ts, input.notes ?? null, ts, ts);
+    const inserted = db
+        .prepare('SELECT * FROM entries WHERE id = ?')
+        .get(info.lastInsertRowid);
+    return { app, entry: hydrate(inserted) };
+}
+export function recall(input) {
+    const db = getDb();
+    // Resolve app: prefer (origin, app_key) if provided; otherwise pick the most-recent app for this origin.
+    let app;
+    if (input.app_key && input.app_key.trim().length > 0) {
+        app = db
+            .prepare('SELECT * FROM apps WHERE origin = ? AND app_key = ?')
+            .get(input.origin, slugify(input.app_key));
+    }
+    else {
+        app = db
+            .prepare('SELECT * FROM apps WHERE origin = ? ORDER BY last_seen_at DESC LIMIT 1')
+            .get(input.origin);
+    }
+    if (!app)
+        return { app: null, entries: [] };
+    // Touch last_seen_at so apps that are actively used bubble up.
+    db.prepare('UPDATE apps SET last_seen_at = ? WHERE id = ?').run(now(), app.id);
+    const pathname = input.url ? extractPathname(input.url) : null;
+    const rows = (pathname
+        ? db
+            .prepare(`SELECT * FROM entries WHERE app_id = ? AND url_pattern = ? ORDER BY updated_at DESC`)
+            .all(app.id, pathname)
+        : db
+            .prepare(`SELECT * FROM entries WHERE app_id = ? ORDER BY url_pattern, updated_at DESC`)
+            .all(app.id));
+    return { app, entries: rows.map(hydrate) };
+}
+function extractPathname(url) {
+    try {
+        return new URL(url).pathname;
+    }
+    catch {
+        return url;
+    }
+}
+// Two prepared statements with no string interpolation. ok=true clears
+// failed_at so a freshly verified entry is unambiguously healthy; ok=false
+// only stamps failed_at and leaves verified_at as a historical fact so we
+// can still tell whether the entry ever worked.
+const RECORD_USE_OK_SQL = 'UPDATE entries SET verified_at = ?, failed_at = NULL, notes = COALESCE(?, notes), updated_at = ? WHERE id = ?';
+const RECORD_USE_FAIL_SQL = 'UPDATE entries SET failed_at = ?, notes = COALESCE(?, notes), updated_at = ? WHERE id = ?';
+export function recordUse(input) {
+    const db = getDb();
+    const ts = now();
+    const sql = input.ok ? RECORD_USE_OK_SQL : RECORD_USE_FAIL_SQL;
+    db.prepare(sql).run(ts, input.notes ?? null, ts, input.entry_id);
+    const row = db.prepare('SELECT * FROM entries WHERE id = ?').get(input.entry_id);
+    return row ? hydrate(row) : null;
+}
+export function forget(input) {
+    const db = getDb();
+    if (input.entry_id) {
+        const info = db.prepare('DELETE FROM entries WHERE id = ?').run(input.entry_id);
+        return { deleted_entries: info.changes, deleted_apps: 0 };
+    }
+    if (input.app_id) {
+        // ON DELETE CASCADE wipes entries.
+        const before = db
+            .prepare('SELECT COUNT(*) AS n FROM entries WHERE app_id = ?')
+            .get(input.app_id);
+        const info = db.prepare('DELETE FROM apps WHERE id = ?').run(input.app_id);
+        return { deleted_entries: before.n, deleted_apps: info.changes };
+    }
+    return { deleted_entries: 0, deleted_apps: 0 };
+}
+export function renameApp(app_id, new_app_key) {
+    const db = getDb();
+    db.prepare('UPDATE apps SET app_key = ?, last_seen_at = ? WHERE id = ?').run(slugify(new_app_key), now(), app_id);
+    const row = db.prepare('SELECT * FROM apps WHERE id = ?').get(app_id);
+    return row ?? null;
+}
+export function listApps() {
+    return getDb().prepare('SELECT * FROM apps ORDER BY last_seen_at DESC').all();
+}
+//# sourceMappingURL=queries.js.map

package/dist/map/queries.js.map

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

package/dist/map/tools.d.ts

@@ -0,0 +1,8 @@
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+export declare const MAP_TOOL_DEFINITIONS: ToolDefinition[];
+export declare function isMapTool(name: string): boolean;
+export declare function handleMapTool(name: string, args: unknown): unknown;

package/dist/map/tools.js

@@ -0,0 +1,143 @@
+import { forget, listApps, recall, recordUse, renameApp, saveEntry, } from './queries.js';
+export const MAP_TOOL_DEFINITIONS = [
+    {
+        name: 'browser.map.recall',
+        description: 'Recall what is already known about a browser app/route from the local map DB. Call this first when you arrive at a tab so you can reuse known selectors, flows and gotchas instead of rediscovering them. Pass origin (scheme://host:port). Optionally pass app_key to disambiguate when multiple apps share an origin, and url to filter entries down to a specific pathname.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                origin: { type: 'string', description: 'scheme://host:port of the tab.' },
+                app_key: {
+                    type: 'string',
+                    description: 'Optional. Slug identifying the app within the origin (e.g. "flight-managment"). If omitted, the most-recently-seen app for the origin is used.',
+                },
+                url: {
+                    type: 'string',
+                    description: 'Optional full URL; only its pathname is used to filter entries.',
+                },
+            },
+            required: ['origin'],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: 'browser.map.save',
+        description: 'Persist something learned about a browser app. Three kinds are supported: "selector" (a CSS selector tied to a purpose), "flow" (an ordered list of steps to reach an outcome), and "gotcha" (a free-form note). Saving auto-creates the app row if needed (app_key is derived from title when not provided). Upsert on (app, url_pattern, kind, purpose). Marks verified_at = now and clears failed_at. Never save selectors or flows you have not just successfully executed.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                origin: { type: 'string' },
+                app_key: {
+                    type: 'string',
+                    description: 'Optional slug. If omitted, derived from title or origin host.',
+                },
+                title: {
+                    type: 'string',
+                    description: 'Optional document.title; used to derive app_key on first save for this origin.',
+                },
+                url_pattern: {
+                    type: 'string',
+                    description: 'Pathname this entry applies to (e.g. "/home/flight-management/cga"). Use exact paths by default; only generalize when you have evidence of a parametric route.',
+                },
+                kind: { type: 'string', enum: ['selector', 'flow', 'gotcha'] },
+                purpose: {
+                    type: 'string',
+                    description: 'Human-readable label for what this entry achieves (e.g. "open task detail dialog").',
+                },
+                payload: {
+                    description: 'Kind-specific payload. selector: { selector: string, evidence?: string }. flow: { steps: array<{action,...}>}. gotcha: { body: string }.',
+                },
+                notes: { type: 'string' },
+            },
+            required: ['origin', 'url_pattern', 'kind', 'purpose', 'payload'],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: 'browser.map.record_use',
+        description: 'Mark an entry as freshly verified or freshly failed after you used it. ok=true updates verified_at and clears failed_at; ok=false updates failed_at. Always call this after using an entry from recall so the map stays honest about what works today.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                entry_id: { type: 'number' },
+                ok: { type: 'boolean' },
+                notes: { type: 'string' },
+            },
+            required: ['entry_id', 'ok'],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: 'browser.map.forget',
+        description: 'Permanently delete an entry (entry_id) or a whole app and all its entries (app_id). Use when a refactor or app change makes the saved knowledge actively wrong.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                entry_id: { type: 'number' },
+                app_id: { type: 'number' },
+                reason: { type: 'string' },
+            },
+            additionalProperties: false,
+        },
+    },
+    {
+        name: 'browser.map.rename_app',
+        description: 'Rename an app_key. Useful when the heuristic from the document title picked a poor name (e.g. typos like "FLIGHT MANAGMENT" → "flight-management").',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                app_id: { type: 'number' },
+                new_app_key: { type: 'string' },
+            },
+            required: ['app_id', 'new_app_key'],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: 'browser.map.apps',
+        description: 'List apps currently tracked in the map, most recently used first. Use to discover known origins and their app_keys.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+    },
+];
+export function isMapTool(name) {
+    return name.startsWith('browser.map.');
+}
+export function handleMapTool(name, args) {
+    switch (name) {
+        case 'browser.map.recall': {
+            const a = args;
+            return recall({ origin: a.origin, app_key: a.app_key ?? null, url: a.url ?? null });
+        }
+        case 'browser.map.save': {
+            const a = args;
+            return saveEntry({
+                origin: a.origin,
+                app_key: a.app_key ?? null,
+                title: a.title ?? null,
+                url_pattern: a.url_pattern,
+                kind: a.kind,
+                purpose: a.purpose,
+                payload: a.payload,
+                notes: a.notes ?? null,
+            });
+        }
+        case 'browser.map.record_use': {
+            const a = args;
+            return recordUse({ entry_id: a.entry_id, ok: a.ok, notes: a.notes ?? null });
+        }
+        case 'browser.map.forget': {
+            const a = args;
+            return forget({ entry_id: a.entry_id, app_id: a.app_id, reason: a.reason });
+        }
+        case 'browser.map.rename_app': {
+            const a = args;
+            return renameApp(a.app_id, a.new_app_key);
+        }
+        case 'browser.map.apps': {
+            return listApps();
+        }
+        default:
+            throw new Error(`Unknown map tool: ${name}`);
+    }
+}
+//# sourceMappingURL=tools.js.map

package/dist/map/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/map/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,QAAQ,EACR,MAAM,EACN,SAAS,EACT,SAAS,EACT,SAAS,GAEV,MAAM,cAAc,CAAC;AAQtB,MAAM,CAAC,MAAM,oBAAoB,GAAqB;IACpD;QACE,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EACT,gXAAgX;QAClX,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE;gBACzE,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,gJAAgJ;iBACnJ;gBACD,GAAG,EAAE;oBACH,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,iEAAiE;iBAC/E;aACF;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;YACpB,oBAAoB,EAAE,KAAK;SAC5B;KACF;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,idAAid;QACnd,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC1B,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+DAA+D;iBAC7E;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,gFAAgF;iBACnF;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,gKAAgK;iBACnK;gBACD,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE;gBAC9D,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,qFAAqF;iBACxF;gBACD,OAAO,EAAE;oBACP,WAAW,EACT,0IAA0I;iBAC7I;gBACD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAC1B;YACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC;YACjE,oBAAoB,EAAE,KAAK;SAC5B;KACF;IACD;QACE,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EACT,wPAAwP;QAC1P,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC5B,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;gBACvB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAC1B;YACD,QAAQ,EAAE,CAAC,UAAU,EAAE,IAAI,CAAC;YAC5B,oBAAoB,EAAE,KAAK;SAC5B;KACF;IACD;QACE,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EACT,iKAAiK;QACnK,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC5B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC1B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAC3B;YACD,oBAAoB,EAAE,KAAK;SAC5B;KACF;IACD;QACE,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EACT,qJAAqJ;QACvJ,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC1B,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAChC;YACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC;YACnC,oBAAoB,EAAE,KAAK;SAC5B;KACF;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,qHAAqH;QACvH,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE;KAC7E;CACF,CAAC;AAoCF,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,IAAa;IACvD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,oBAAoB,CAAC,CAAC,CAAC;YAC1B,MAAM,CAAC,GAAG,IAAkB,CAAC;YAC7B,OAAO,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC,CAAC;QACtF,CAAC;QACD,KAAK,kBAAkB,CAAC,CAAC,CAAC;YACxB,MAAM,CAAC,GAAG,IAAgB,CAAC;YAC3B,OAAO,SAAS,CAAC;gBACf,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,IAAI;gBAC1B,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI;gBACtB,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI;aACvB,CAAC,CAAC;QACL,CAAC;QACD,KAAK,wBAAwB,CAAC,CAAC,CAAC;YAC9B,MAAM,CAAC,GAAG,IAAqB,CAAC;YAChC,OAAO,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,EAAE,CAAC,CAAC;QAC/E,CAAC;QACD,KAAK,oBAAoB,CAAC,CAAC,CAAC;YAC1B,MAAM,CAAC,GAAG,IAAkB,CAAC;YAC7B,OAAO,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9E,CAAC;QACD,KAAK,wBAAwB,CAAC,CAAC,CAAC;YAC9B,MAAM,CAAC,GAAG,IAAkB,CAAC;YAC7B,OAAO,SAAS,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC;QAC5C,CAAC;QACD,KAAK,kBAAkB,CAAC,CAAC,CAAC;YACxB,OAAO,QAAQ,EAAE,CAAC;QACpB,CAAC;QACD;YACE,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;AACH,CAAC"}

package/dist/messages.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Wire-protocol types between the MCP server and the Chrome extension.
+ *
+ * Kept in-tree (instead of the @browser-link/shared workspace package) so the
+ * server publishes to npm without an unresolvable workspace dependency.
+ * The extension still uses the workspace copy in packages/shared.
+ */
+export type TabId = string;
+export interface TabRegisterPayload {
+    url: string;
+    title: string;
+}
+export interface TabRegisteredPayload {
+    tabId: TabId;
+}
+export interface TabRegisterMessage {
+    kind: 'tab.register';
+    payload: TabRegisterPayload;
+}
+export interface TabRegisteredMessage {
+    kind: 'tab.registered';
+    payload: TabRegisteredPayload;
+}
+export interface ToolRequestMessage {
+    kind: 'tool.request';
+    id: string;
+    tool: string;
+    params: unknown;
+}
+export type ToolResponseMessage = {
+    kind: 'tool.response';
+    id: string;
+    ok: true;
+    result: unknown;
+} | {
+    kind: 'tool.response';
+    id: string;
+    ok: false;
+    error: string;
+};
+export type ExtensionToServer = TabRegisterMessage | ToolResponseMessage;
+export type ServerToExtension = TabRegisteredMessage | ToolRequestMessage;

package/dist/messages.js

@@ -0,0 +1,9 @@
+/**
+ * Wire-protocol types between the MCP server and the Chrome extension.
+ *
+ * Kept in-tree (instead of the @browser-link/shared workspace package) so the
+ * server publishes to npm without an unresolvable workspace dependency.
+ * The extension still uses the workspace copy in packages/shared.
+ */
+export {};
+//# sourceMappingURL=messages.js.map

package/dist/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/server.d.ts

@@ -0,0 +1,6 @@
+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. */
+export declare function runServer(): Promise<void>;

package/dist/server.js

@@ -0,0 +1,217 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { WebSocketServer } from 'ws';
+import { randomUUID } from 'node:crypto';
+import { MAP_TOOL_DEFINITIONS, handleMapTool, isMapTool } from './map/tools.js';
+import { closeDb } from './map/db.js';
+import { isAllowedBrowser } from './auth/allowlist.js';
+import { lookupPeerProcess } from './auth/process-identity.js';
+import { BROWSER_TOOL_DEFINITIONS } from './tools/browser-definitions.js';
+import { handleBrowserTool, isBrowserTool, } from './tools/browser-dispatch.js';
+import { toolError, toolResponse } from './tools/responses.js';
+import { SERVER_INSTRUCTIONS } from './tools/server-instructions.js';
+export const WS_HOST = '127.0.0.1';
+export const WS_PORT = 17529;
+const DEFAULT_TIMEOUT_MS = 15_000;
+function log(msg) {
+    console.error(`[browser-link] ${msg}`);
+}
+function safeParse(raw) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+function send(ws, msg) {
+    ws.send(JSON.stringify(msg));
+}
+/** Bring up the WebSocket bridge for the Chrome extension. Resolves only
+ * after the server is listening, so the caller can fail fast (and refuse
+ * to expose the MCP transport) when the port is taken or any other bind
+ * error happens. */
+/**
+ * Loopback-only addresses can show up as ::ffff:127.0.0.1 (IPv4-mapped IPv6)
+ * or ::1 depending on how the kernel exposes the dual stack. Normalise to the
+ * IPv4 form lsof / netstat understand.
+ */
+function normaliseLoopback(addr) {
+    if (addr === '::1' || addr === '::ffff:127.0.0.1')
+        return '127.0.0.1';
+    if (addr.startsWith('::ffff:'))
+        return addr.slice('::ffff:'.length);
+    return addr;
+}
+function startWsBridge(tabs, pendingRequests) {
+    return new Promise((resolve, reject) => {
+        const wss = new WebSocketServer({
+            host: WS_HOST,
+            port: WS_PORT,
+            // Refuse the upgrade unless the OS confirms the peer is a Chromium-based
+            // browser. The check happens before any application bytes are exchanged.
+            verifyClient: (info, cb) => {
+                const remoteAddress = normaliseLoopback(info.req.socket.remoteAddress ?? '');
+                const remotePort = info.req.socket.remotePort;
+                if (!remoteAddress || remotePort == null) {
+                    log('Rejected WS handshake: peer address/port not exposed by socket.');
+                    cb(false, 403, 'Cannot identify peer');
+                    return;
+                }
+                lookupPeerProcess(remoteAddress, remotePort)
+                    .then((peer) => {
+                    if (!peer) {
+                        log(`Rejected WS handshake from ${remoteAddress}:${remotePort}: could not identify owning process.`);
+                        cb(false, 403, 'Peer process unknown');
+                        return;
+                    }
+                    if (!isAllowedBrowser(peer.binaryName)) {
+                        log(`Rejected WS handshake from PID ${peer.pid} (${peer.binaryName}): not a Chromium-based browser.`);
+                        cb(false, 403, 'Peer is not a Chromium-based browser');
+                        return;
+                    }
+                    cb(true);
+                })
+                    .catch((err) => {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    log(`Rejected WS handshake: process lookup failed (${msg}).`);
+                    cb(false, 500, 'Process lookup failed');
+                });
+            },
+        });
+        let settled = false;
+        wss.on('listening', () => {
+            settled = true;
+            log(`WebSocket listening on ws://${WS_HOST}:${WS_PORT}`);
+            resolve(wss);
+        });
+        wss.on('error', (err) => {
+            if (!settled) {
+                settled = true;
+                reject(translateBindError(err));
+                return;
+            }
+            // Post-listening errors: log but keep running; ws will emit per-connection
+            // errors separately.
+            log(`WebSocket server error: ${err.message}`);
+        });
+        wss.on('connection', (ws) => {
+            let assignedTabId = null;
+            ws.on('message', (raw) => {
+                const msg = safeParse(raw.toString());
+                if (!msg)
+                    return;
+                if (msg.kind === 'tab.register' && !assignedTabId) {
+                    assignedTabId = assignTabId();
+                    tabs.set(assignedTabId, {
+                        tabId: assignedTabId,
+                        url: msg.payload.url,
+                        title: msg.payload.title,
+                        ws,
+                    });
+                    send(ws, { kind: 'tab.registered', payload: { tabId: assignedTabId } });
+                    log(`Tab registered: ${assignedTabId} -> ${msg.payload.url}`);
+                    return;
+                }
+                if (msg.kind === 'tool.response') {
+                    const pending = pendingRequests.get(msg.id);
+                    if (!pending)
+                        return;
+                    clearTimeout(pending.timeout);
+                    pendingRequests.delete(msg.id);
+                    if (msg.ok)
+                        pending.resolve(msg.result);
+                    else
+                        pending.reject(new Error(msg.error));
+                }
+            });
+            ws.on('close', () => {
+                if (assignedTabId) {
+                    tabs.delete(assignedTabId);
+                    log(`Tab disconnected: ${assignedTabId}`);
+                }
+            });
+            ws.on('error', (err) => {
+                log(`WS connection error: ${err.message}`);
+            });
+        });
+    });
+}
+let tabIdCounter = 0;
+function assignTabId() {
+    tabIdCounter += 1;
+    return `tab_${tabIdCounter}`;
+}
+function translateBindError(err) {
+    if (err.code === 'EADDRINUSE') {
+        return new Error(`browser-link: port ${WS_HOST}:${WS_PORT} is already in use. ` +
+            `Another browser-link server is likely running. Stop it (and any ` +
+            `\`npm run dev\` running this project) before launching this one.`);
+    }
+    return err;
+}
+function buildCallBrowserTool(tabs, pendingRequests) {
+    return (tabId, tool, params, timeoutMs = DEFAULT_TIMEOUT_MS) => {
+        const session = tabs.get(tabId);
+        if (!session)
+            return Promise.reject(new Error(`Tab not connected: ${tabId}`));
+        const id = randomUUID();
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                pendingRequests.delete(id);
+                reject(new Error(`Tool '${tool}' timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+            pendingRequests.set(id, { resolve, reject, timeout });
+            send(session.ws, { kind: 'tool.request', id, tool, params });
+        });
+    };
+}
+function buildListTabs(tabs) {
+    return () => Array.from(tabs.values()).map((t) => ({
+        tab_id: t.tabId,
+        url: t.url,
+        title: t.title,
+    }));
+}
+/** 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. */
+export async function runServer() {
+    const tabs = new Map();
+    const pendingRequests = new Map();
+    // Bind the WS bridge first. If this throws, runServer() rejects and the
+    // MCP client receives a fail-fast exit instead of a half-started server.
+    await startWsBridge(tabs, pendingRequests);
+    const deps = {
+        listTabs: buildListTabs(tabs),
+        callBrowserTool: buildCallBrowserTool(tabs, pendingRequests),
+    };
+    const mcpServer = new Server({ name: 'browser-link', version: '0.0.1' }, { capabilities: { tools: {} }, instructions: SERVER_INSTRUCTIONS });
+    mcpServer.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: [...BROWSER_TOOL_DEFINITIONS, ...MAP_TOOL_DEFINITIONS],
+    }));
+    mcpServer.setRequestHandler(CallToolRequestSchema, async (req) => {
+        const { name, arguments: args } = req.params;
+        try {
+            if (isMapTool(name))
+                return toolResponse(handleMapTool(name, args));
+            if (isBrowserTool(name))
+                return toolResponse(await handleBrowserTool(name, args, deps));
+            return toolError(`Unknown tool: ${name}`);
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    });
+    const transport = new StdioServerTransport();
+    await mcpServer.connect(transport);
+    log('MCP server ready on stdio');
+    for (const sig of ['SIGINT', 'SIGTERM']) {
+        process.once(sig, () => {
+            closeDb();
+            process.exit(0);
+        });
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/browser-definitions.d.ts

@@ -0,0 +1,7 @@
+/**
+ * MCP tool definitions for the browser-bridge family. Kept separate from
+ * the runtime dispatcher so the JSON schemas stay reviewable in one place
+ * and the dispatch logic stays small.
+ */
+import type { ToolDefinition } from './types.js';
+export declare const BROWSER_TOOL_DEFINITIONS: ToolDefinition[];