brms-host 1.0.0

package/build/tools/screenshot.tools.js

@@ -0,0 +1,40 @@
+import { z } from 'zod';
+import { bridge } from '../bridge/native-messaging.js';
+import { log } from '../utils/logger.js';
+export function registerScreenshotTools(server) {
+    server.tool('capture_screenshot', 'Capture a screenshot of the active page or a specific element. Optionally highlight the target element with a red border before capture.', {
+        selector: z.string().optional().describe('CSS selector of element to screenshot (default: full page)'),
+        highlight: z.boolean().optional().describe('Inject a temporary red border on the selector before capture (default: false)'),
+        format: z.enum(['png', 'jpeg']).optional().describe('Image format (default: png)'),
+        quality: z.number().int().min(1).max(100).optional().describe('JPEG quality 1-100 (only for jpeg format)'),
+    }, async ({ selector, highlight, format, quality }) => {
+        try {
+            if (highlight && selector) {
+                await bridge.sendRequest('highlight_element', { selector });
+            }
+            const result = await bridge.sendRequest('screenshot', {
+                selector,
+                format: format ?? 'png',
+                quality: quality ?? 80,
+            });
+            if (highlight && selector) {
+                await bridge.sendRequest('remove_highlight', { selector }).catch(() => { });
+            }
+            const base64 = result.base64;
+            const mimeType = result.mimeType;
+            return {
+                content: [{
+                        type: 'image',
+                        data: base64,
+                        mimeType,
+                    }],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            log.error(message);
+            return { content: [{ type: 'text', text: `Error: ${message}` }] };
+        }
+    });
+}
+//# sourceMappingURL=screenshot.tools.js.map

package/build/tools/screenshot.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot.tools.js","sourceRoot":"","sources":["../../src/tools/screenshot.tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AACvD,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAEzC,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB,0IAA0I,EAC1I;QACE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;QACtG,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+EAA+E,CAAC;QAC3H,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;QAClF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;KAC3G,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;QACjD,IAAI,CAAC;YACH,IAAI,SAAS,IAAI,QAAQ,EAAE,CAAC;gBAC1B,MAAM,MAAM,CAAC,WAAW,CAAC,mBAAmB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC9D,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,YAAY,EAAE;gBACpD,QAAQ;gBACR,MAAM,EAAE,MAAM,IAAI,KAAK;gBACvB,OAAO,EAAE,OAAO,IAAI,EAAE;aACvB,CAAC,CAAC;YAEH,IAAI,SAAS,IAAI,QAAQ,EAAE,CAAC;gBAC1B,MAAM,MAAM,CAAC,WAAW,CAAC,kBAAkB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAC7E,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAgB,CAAC;YACvC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAkB,CAAC;YAE3C,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,OAAgB;wBACtB,IAAI,EAAE,MAAM;wBACZ,QAAQ;qBACT,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACnB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC;QAC7E,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/build/tools/styles.tools.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerStyleTools(server: McpServer): void;

package/build/tools/styles.tools.js

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+import { bridge } from '../bridge/native-messaging.js';
+import { safeResult } from '../utils/errors.js';
+export function registerStyleTools(server) {
+    server.tool('get_computed_styles', 'Get computed CSS styles for elements matching a selector. Optionally includes ancestor chain styles (for debugging clipping/stacking) and pseudo-element styles.', {
+        selector: z.string().describe('CSS selector to query'),
+        properties: z.array(z.string()).optional().describe('Specific CSS properties to return (default: key layout properties)'),
+        includeAncestors: z.boolean().optional().describe('Include overflow/position/zIndex/display of each ancestor up to body (default: false)'),
+        includePseudo: z.boolean().optional().describe('Include ::before and ::after pseudo-element styles (default: false)'),
+    }, async ({ selector, properties, includeAncestors, includePseudo }) => {
+        return safeResult(async () => {
+            const result = await bridge.sendRequest('get_styles', {
+                selector,
+                properties,
+                includeAncestors: includeAncestors ?? false,
+                includePseudo: includePseudo ?? false,
+            });
+            return JSON.stringify(result.results ?? result, null, 2);
+        });
+    });
+}
+//# sourceMappingURL=styles.tools.js.map

package/build/tools/styles.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.tools.js","sourceRoot":"","sources":["../../src/tools/styles.tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAClD,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,kKAAkK,EAClK;QACE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;QACtD,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oEAAoE,CAAC;QACzH,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uFAAuF,CAAC;QAC1I,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qEAAqE,CAAC;KACtH,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,gBAAgB,EAAE,aAAa,EAAE,EAAE,EAAE;QAClE,OAAO,UAAU,CAAC,KAAK,IAAI,EAAE;YAC3B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,YAAY,EAAE;gBACpD,QAAQ;gBACR,UAAU;gBACV,gBAAgB,EAAE,gBAAgB,IAAI,KAAK;gBAC3C,aAAa,EAAE,aAAa,IAAI,KAAK;aACtC,CAAC,CAAC;YAEH,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;IACL,CAAC,CACF,CAAC;AACJ,CAAC"}

package/build/types/index.d.ts

@@ -0,0 +1,130 @@
+export interface DOMNode {
+    tag: string;
+    id: string;
+    classes: string[];
+    text: string;
+    attributes: Record<string, string>;
+    children: DOMNode[];
+}
+export interface NetworkEntry {
+    url: string;
+    method: string;
+    status: number | null;
+    statusText: string;
+    headers: Record<string, string>;
+    requestHeaders: Record<string, string>;
+    requestBody: string | null;
+    responseBody: string | null;
+    resourceType: string;
+    timing: {
+        startTime: number;
+        duration: number;
+    };
+    timestamp: number;
+}
+export interface ConsoleEntry {
+    level: 'log' | 'warn' | 'error' | 'info' | 'debug';
+    text: string;
+    timestamp: number;
+    location: string | null;
+}
+export interface PageInfo {
+    index: number;
+    title: string;
+    url: string;
+}
+export interface NetworkFilter {
+    urlPattern?: string;
+    statusCode?: number;
+    resourceType?: string;
+    limit?: number;
+}
+export interface ComputedStyleResult {
+    selector: string;
+    styles: Record<string, string>;
+}
+export interface LayoutInfo {
+    selector: string;
+    boundingBox: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null;
+    isVisible: boolean;
+    isInViewport: boolean;
+}
+export interface OverlapInfo {
+    coveredBy: {
+        tag: string;
+        id: string;
+        classes: string[];
+        zIndex: string;
+    } | null;
+    checkedPoints: Array<{
+        label: string;
+        x: number;
+        y: number;
+        hitTag: string;
+        hitId: string;
+        isSelf: boolean;
+    }>;
+}
+export interface EventListenerEntry {
+    type: string;
+    handler: string;
+    useCapture: boolean;
+    once: boolean;
+    passive: boolean;
+}
+export interface EventListenerInfo {
+    selector: string;
+    element: {
+        tag: string;
+        id: string;
+    };
+    listeners: EventListenerEntry[];
+}
+export interface DebugIssue {
+    issue: string;
+    reasons: string[];
+    confidence: number;
+}
+export interface DebugCheck {
+    name: string;
+    passed: boolean;
+    detail: string;
+}
+export type Severity = 'critical' | 'warning' | 'info';
+export interface CorrelationResult {
+    domain: string;
+    severity: Severity;
+    details: string;
+    evidence: string[];
+}
+export interface NetworkDiagnosis {
+    totalRequests: number;
+    timingBuckets: {
+        fast: number;
+        normal: number;
+        slow: number;
+        verySlow: number;
+    };
+    p95ResponseTime: number;
+    failedRequests: Array<{
+        url: string;
+        status: number | null;
+        method: string;
+        errorBody: string | null;
+    }>;
+    corsIssues: Array<{
+        url: string;
+        method: string;
+    }>;
+    rateLimited: Array<{
+        url: string;
+        domain: string;
+    }>;
+    failuresByDomain: Record<string, number>;
+    summary: string;
+}

package/build/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/build/types/index.js.map

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

package/build/utils/errors.d.ts

@@ -0,0 +1,16 @@
+export declare class BRMSError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+export declare function notConnected(): BRMSError;
+export declare function noActivePage(): BRMSError;
+/**
+ * Wraps a tool handler so MCP errors are returned as structured text
+ * instead of crashing the server.
+ */
+export declare function safeResult(fn: () => Promise<string>): Promise<{
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+}>;

package/build/utils/errors.js

@@ -0,0 +1,29 @@
+import { log } from './logger.js';
+export class BRMSError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = 'BRMSError';
+    }
+}
+export function notConnected() {
+    return new BRMSError('Extension not connected. Ensure the BRMS Chrome Extension is installed and active.', 'NOT_CONNECTED');
+}
+export function noActivePage() {
+    return new BRMSError('No active tab selected. Call select_page first.', 'NO_ACTIVE_PAGE');
+}
+/**
+ * Wraps a tool handler so MCP errors are returned as structured text
+ * instead of crashing the server.
+ */
+export function safeResult(fn) {
+    return fn()
+        .then((text) => ({ content: [{ type: 'text', text }] }))
+        .catch((err) => {
+        const message = err instanceof Error ? err.message : String(err);
+        log.error(message);
+        return { content: [{ type: 'text', text: `Error: ${message}` }] };
+    });
+}
+//# sourceMappingURL=errors.js.map

package/build/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAElC,MAAM,OAAO,SAAU,SAAQ,KAAK;IAGhB;IAFlB,YACE,OAAe,EACC,IAAY;QAE5B,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,SAAI,GAAJ,IAAI,CAAQ;QAG5B,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,SAAS,CAClB,oFAAoF,EACpF,eAAe,CAChB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,SAAS,CAClB,iDAAiD,EACjD,gBAAgB,CACjB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,EAAyB;IAClD,OAAO,EAAE,EAAE;SACR,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;SAChE,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACnB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC;IAC7E,CAAC,CAAC,CAAC;AACP,CAAC"}

package/build/utils/logger.d.ts

@@ -0,0 +1,11 @@
+/**
+ * All logging goes to stderr so stdout remains clean for native messaging.
+ */
+export declare function info(...args: unknown[]): void;
+export declare function warn(...args: unknown[]): void;
+export declare function error(...args: unknown[]): void;
+export declare const log: {
+    info: typeof info;
+    warn: typeof warn;
+    error: typeof error;
+};

package/build/utils/logger.js

@@ -0,0 +1,15 @@
+/**
+ * All logging goes to stderr so stdout remains clean for native messaging.
+ */
+const PREFIX = '[brms]';
+export function info(...args) {
+    console.error(PREFIX, ...args);
+}
+export function warn(...args) {
+    console.error(PREFIX, 'WARN', ...args);
+}
+export function error(...args) {
+    console.error(PREFIX, 'ERROR', ...args);
+}
+export const log = { info, warn, error };
+//# sourceMappingURL=logger.js.map

package/build/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,GAAG,QAAQ,CAAC;AAExB,MAAM,UAAU,IAAI,CAAC,GAAG,IAAe;IACrC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,GAAG,IAAe;IACrC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,GAAG,IAAe;IACtC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,CAAC,MAAM,GAAG,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "brms-host",
+  "version": "1.0.0",
+  "description": "Native messaging host for BRMS Chrome Extension — bridges browser state to Cursor via MCP",
+  "type": "module",
+  "bin": {
+    "brms-host": "./build/bin/install.js"
+  },
+  "main": "./build/index.js",
+  "scripts": {
+    "build": "tsc",
+    "start": "node build/index.js",
+    "dev": "tsc --watch"
+  },
+  "files": [
+    "build"
+  ],
+  "keywords": [
+    "mcp",
+    "browser",
+    "devtools",
+    "chrome-extension",
+    "native-messaging",
+    "ai"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.28.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^6.0.2"
+  }
+}