@clueprint/mcp 1.1.0

package/server/types/index.d.ts

@@ -0,0 +1,239 @@
+/**
+ * MCP Server Types
+ * Mirrors extension types for communication
+ */
+export type Intent = 'fix' | 'beautify' | 'other';
+export type EventType = 'refresh' | 'navigation' | 'click' | 'input' | 'scroll' | 'network_request' | 'network_response' | 'network_error' | 'console_log' | 'console_warn' | 'console_error' | 'dom_mutation' | 'layout_shift' | 'element_select' | 'form_submit' | 'keypress' | 'mouse_move' | 'clipboard' | 'selection' | 'focus' | 'blur';
+export interface ElementRect {
+    width: number;
+    height: number;
+    top: number;
+    left: number;
+}
+export interface ElementStyles {
+    layout: Record<string, string>;
+    size: Record<string, string>;
+    spacing: Record<string, string>;
+    visual: Record<string, string>;
+    text?: Record<string, string>;
+}
+export interface ParentInfo {
+    selector: string;
+    tag: string;
+    styles: Record<string, string>;
+}
+export interface SiblingInfo {
+    selector: string;
+    size: {
+        width: number;
+        height: number;
+    };
+    classes: string[];
+    isSelected: boolean;
+    anomaly?: string;
+}
+export interface CSSRule {
+    source: string;
+    selector: string;
+    properties: Record<string, string>;
+    isOverriding?: boolean;
+}
+export interface ConsoleEntry {
+    type: 'log' | 'warn' | 'error';
+    message: string;
+    stack?: string;
+    source?: string;
+    timestamp: number;
+    count?: number;
+}
+export interface NetworkEntry {
+    url: string;
+    method: string;
+    status?: number;
+    statusText?: string;
+    duration?: number;
+    transferSize?: number;
+    initiatorType?: string;
+    initiator?: string;
+    responseBody?: string;
+    timestamp: number;
+}
+export interface BrowserContext {
+    errors: ConsoleEntry[];
+    networkFailures: NetworkEntry[];
+    layoutShifts?: Array<{
+        value: number;
+        sources?: Array<{
+            selector: string;
+        }>;
+    }>;
+}
+export interface Diagnosis {
+    suspected: string[];
+    unusual: string[];
+    relatedErrors: string[];
+}
+export interface InspectCapture {
+    mode: 'inspect';
+    intent: Intent;
+    timestamp: number;
+    element: {
+        selector: string;
+        tag: string;
+        id?: string;
+        classes: string[];
+        text: string;
+        attributes: Record<string, string>;
+        rect: ElementRect;
+        styles: ElementStyles;
+    };
+    parent: ParentInfo;
+    siblings: SiblingInfo[];
+    cssRules: CSSRule[];
+    browserContext: BrowserContext;
+    diagnosis: Diagnosis;
+    screenshot?: string;
+}
+export interface FreeSelectCapture {
+    mode: 'free-select';
+    intent: Intent;
+    timestamp: number;
+    region: ElementRect;
+    screenshot: string;
+    elements: Array<{
+        selector: string;
+        tag: string;
+        text: string;
+        role: string;
+        styles: Record<string, unknown>;
+        hasInteractionStates: boolean;
+    }>;
+    structure: string;
+    aestheticAnalysis?: {
+        issues: string[];
+        suggestions: string[];
+        colorPalette: string[];
+    };
+    browserContext: BrowserContext;
+}
+export interface FlowEvent {
+    time: number;
+    type: EventType;
+    data: Record<string, unknown>;
+}
+export interface FlowRecording {
+    mode: 'flow';
+    duration: number;
+    startTime: number;
+    events: FlowEvent[];
+    finalSelection?: InspectCapture | FreeSelectCapture;
+    summary: {
+        totalEvents: number;
+        clicks: number;
+        inputs: number;
+        scrolls: number;
+        navigations: number;
+        networkRequests: number;
+        networkErrors: number;
+        consoleErrors: number;
+        layoutShifts: number;
+    };
+    diagnosis: {
+        suspectedIssue: string;
+        timeline: string;
+        rootCause?: string;
+    };
+}
+export interface PageDiagnostics {
+    mode: 'diagnostics';
+    url: string;
+    timestamp: number;
+    errors: Array<{
+        message: string;
+        source: string;
+        count: number;
+    }>;
+    networkFailures: Array<{
+        url: string;
+        method: string;
+        status: number;
+        statusText: string;
+    }>;
+    performance: {
+        lcp?: {
+            value: number;
+            element: string;
+        };
+        cls: {
+            value: number;
+            shifts: Array<{
+                element: string;
+                delta: number;
+            }>;
+        };
+        longTasks: Array<{
+            duration: number;
+            startTime: number;
+        }>;
+    };
+    accessibility: {
+        missingAltText: number;
+        lowContrast: number;
+        missingLabels: number;
+    };
+    warnings: string[];
+}
+export interface DOMSnapshot {
+    id: string;
+    timestamp: number;
+    url: string;
+    selector?: string;
+    elements: Map<string, {
+        selector: string;
+        classes: string[];
+        size: {
+            width: number;
+            height: number;
+        };
+        inlineStyles: string;
+    }>;
+}
+export interface DOMDiff {
+    before: string;
+    after: string;
+    changes: Array<{
+        selector: string;
+        type: 'added' | 'removed' | 'changed';
+        changes?: {
+            classes?: {
+                added: string[];
+                removed: string[];
+            };
+            size?: {
+                before: {
+                    width: number;
+                    height: number;
+                };
+                after: {
+                    width: number;
+                    height: number;
+                };
+            };
+            styles?: Array<{
+                property: string;
+                before: string;
+                after: string;
+            }>;
+        };
+    }>;
+}
+export interface ToolResponse {
+    content: Array<{
+        type: 'text' | 'image';
+        text?: string;
+        data?: string;
+        mimeType?: string;
+    }>;
+    isError?: boolean;
+}
+//# sourceMappingURL=index.d.ts.map

package/server/types/index.d.ts.map

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

package/server/types/index.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * MCP Server Types
+ * Mirrors extension types for communication
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/server/types/index.js.map

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

package/server/websocket.d.ts

@@ -0,0 +1,55 @@
+/**
+ * WebSocket Server for Chrome Extension Communication
+ */
+import { WebSocketServer } from 'ws';
+import type { InspectCapture, FreeSelectCapture, FlowRecording, PageDiagnostics, DOMSnapshot, DOMDiff } from './types/index.js';
+/**
+ * Create and start WebSocket server
+ */
+export declare function createWebSocketServer(port?: number): Promise<WebSocketServer | null>;
+/**
+ * Check if extension is connected
+ * Checks both in-memory connection and shared state file
+ */
+export declare function isExtensionConnected(): boolean;
+/**
+ * Get current selection
+ */
+export declare function getCurrentSelection(): InspectCapture | FreeSelectCapture | null;
+/**
+ * Clear current selection
+ */
+export declare function clearSelection(): void;
+/**
+ * Get current recording
+ */
+export declare function getCurrentRecording(): FlowRecording | null;
+/**
+ * Check if recording is in progress
+ */
+export declare function isRecordingActive(): boolean;
+/**
+ * Request page diagnostics from extension
+ */
+export declare function requestDiagnostics(): Promise<PageDiagnostics>;
+/**
+ * Start flow recording
+ */
+export declare function startRecording(): Promise<void>;
+/**
+ * Stop flow recording
+ */
+export declare function stopRecording(): Promise<FlowRecording>;
+/**
+ * Request recent activity buffer from extension
+ */
+export declare function requestRecentActivity(): Promise<FlowRecording | null>;
+/**
+ * Request DOM snapshot
+ */
+export declare function requestSnapshot(selector?: string): Promise<DOMSnapshot>;
+/**
+ * Request DOM diff
+ */
+export declare function requestDiff(before: string, after: string): Promise<DOMDiff>;
+//# sourceMappingURL=websocket.d.ts.map

package/server/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../src/websocket.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAa,MAAM,IAAI,CAAC;AAYhD,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,WAAW,EACX,OAAO,EACR,MAAM,kBAAkB,CAAC;AAyL1B;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,SAAe,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAwF1F;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAW9C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,cAAc,GAAG,iBAAiB,GAAG,IAAI,CAO/E;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,GAAG,IAAI,CAO1D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAK3C;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,eAAe,CAAC,CAEnE;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAMpD;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,aAAa,CAAC,CAO5D;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAE3E;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAE7E;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEjF"}

package/server/websocket.js

@@ -0,0 +1,355 @@
+"use strict";
+/**
+ * WebSocket Server for Chrome Extension Communication
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWebSocketServer = createWebSocketServer;
+exports.isExtensionConnected = isExtensionConnected;
+exports.getCurrentSelection = getCurrentSelection;
+exports.clearSelection = clearSelection;
+exports.getCurrentRecording = getCurrentRecording;
+exports.isRecordingActive = isRecordingActive;
+exports.requestDiagnostics = requestDiagnostics;
+exports.startRecording = startRecording;
+exports.stopRecording = stopRecording;
+exports.requestRecentActivity = requestRecentActivity;
+exports.requestSnapshot = requestSnapshot;
+exports.requestDiff = requestDiff;
+const ws_1 = require("ws");
+const http_1 = require("http");
+const shared_state_js_1 = require("./shared-state.js");
+const DEFAULT_PORT = 7007;
+// Current state from extension
+let currentSelection = null;
+let currentRecording = null;
+let isRecording = false;
+let connectedClient = null; // Extension connection (server mode)
+let relayClient = null; // Connection to primary server (relay mode)
+let relayClients = new Set(); // Relay MCP clients connected to this server
+// Pending requests waiting for response
+const pendingRequests = new Map();
+let requestIdCounter = 0;
+/**
+ * Generate unique request ID
+ */
+function generateRequestId() {
+    return `req_${++requestIdCounter}_${Date.now()}`;
+}
+/**
+ * Send request to extension and wait for response
+ */
+async function sendRequest(type, payload, timeoutMs = 10000) {
+    return new Promise((resolve, reject) => {
+        // Determine which connection to use: direct extension or relay
+        const target = (connectedClient && connectedClient.readyState === ws_1.WebSocket.OPEN)
+            ? connectedClient
+            : (relayClient && relayClient.readyState === ws_1.WebSocket.OPEN)
+                ? relayClient
+                : null;
+        if (!target) {
+            reject(new Error('Extension not connected. The browser extension WebSocket may have disconnected. Try reloading the extension or refreshing the page.'));
+            return;
+        }
+        const id = generateRequestId();
+        const timeout = setTimeout(() => {
+            pendingRequests.delete(id);
+            reject(new Error(`Request timed out: ${type}`));
+        }, timeoutMs);
+        pendingRequests.set(id, { resolve: resolve, reject, timeout });
+        target.send(JSON.stringify({ type, id, payload }));
+    });
+}
+/**
+ * Handle incoming message from extension
+ */
+function handleMessage(data) {
+    try {
+        const message = JSON.parse(data);
+        // Handle response to pending request
+        if (message.id && pendingRequests.has(message.id)) {
+            const pending = pendingRequests.get(message.id);
+            clearTimeout(pending.timeout);
+            pendingRequests.delete(message.id);
+            if (message.error) {
+                pending.reject(new Error(message.error));
+            }
+            else {
+                pending.resolve(message.payload);
+            }
+            return;
+        }
+        // Handle push messages from extension
+        switch (message.type) {
+            case 'ELEMENT_SELECTED':
+                currentSelection = message.payload;
+                (0, shared_state_js_1.saveSelection)(currentSelection); // Save to shared state
+                console.error('[MCP] Element selected:', currentSelection.element.selector);
+                break;
+            case 'REGION_SELECTED':
+                currentSelection = message.payload;
+                (0, shared_state_js_1.saveSelection)(currentSelection); // Save to shared state
+                console.error('[MCP] Region selected:', `${currentSelection.region.width}x${currentSelection.region.height}`);
+                break;
+            case 'RECORDING_STOPPED':
+                currentRecording = message.payload;
+                isRecording = false;
+                (0, shared_state_js_1.saveRecording)(currentRecording); // Save to shared state
+                (0, shared_state_js_1.saveRecordingState)(false); // Save recording state
+                console.error('[MCP] Recording stopped:', currentRecording?.summary.totalEvents, 'events');
+                break;
+            case 'BUFFER_RECORDING':
+                currentRecording = message.payload;
+                (0, shared_state_js_1.saveRecording)(currentRecording);
+                console.error('[MCP] Buffer recording received:', currentRecording?.summary.totalEvents, 'events');
+                break;
+            case 'PONG':
+                // Connection alive
+                break;
+            default:
+                console.error('[MCP] Unknown message type:', message.type);
+        }
+    }
+    catch (error) {
+        console.error('[MCP] Failed to parse message:', error);
+    }
+}
+/**
+ * Connect as a relay client to an existing WebSocket server
+ */
+function connectAsRelay(port) {
+    if (relayClient && relayClient.readyState === ws_1.WebSocket.OPEN)
+        return;
+    try {
+        relayClient = new ws_1.WebSocket(`ws://localhost:${port}`);
+        relayClient.on('open', () => {
+            console.error('[MCP] Connected as relay client to primary server');
+            // Identify ourselves as a relay client
+            relayClient.send(JSON.stringify({ type: 'MCP_RELAY_IDENTIFY' }));
+        });
+        relayClient.on('message', (data) => {
+            handleMessage(data.toString());
+        });
+        relayClient.on('close', () => {
+            console.error('[MCP] Relay connection closed, reconnecting...');
+            relayClient = null;
+            setTimeout(() => connectAsRelay(port), 3000);
+        });
+        relayClient.on('error', () => {
+            // Error will be followed by close event
+        });
+    }
+    catch (error) {
+        console.error('[MCP] Failed to connect as relay:', error);
+        setTimeout(() => connectAsRelay(port), 3000);
+    }
+}
+/**
+ * Handle a message from a relay client (on the server side)
+ * Forwards requests to the extension and relays responses back
+ */
+function handleRelayRequest(relayWs, message) {
+    if (!message.id || !connectedClient || connectedClient.readyState !== ws_1.WebSocket.OPEN) {
+        // Can't forward without an id or without extension connection
+        if (message.id) {
+            relayWs.send(JSON.stringify({ id: message.id, error: 'Extension not connected to primary server' }));
+        }
+        return;
+    }
+    // Forward to extension with a mapped ID
+    const relayId = generateRequestId();
+    const timeout = setTimeout(() => {
+        pendingRequests.delete(relayId);
+        relayWs.send(JSON.stringify({ id: message.id, error: 'Request timed out' }));
+    }, 10000);
+    pendingRequests.set(relayId, {
+        resolve: (value) => {
+            relayWs.send(JSON.stringify({ id: message.id, payload: value }));
+        },
+        reject: (error) => {
+            relayWs.send(JSON.stringify({ id: message.id, error: error.message }));
+        },
+        timeout,
+    });
+    connectedClient.send(JSON.stringify({ type: message.type, id: relayId, payload: message.payload }));
+}
+/**
+ * Create and start WebSocket server
+ */
+function createWebSocketServer(port = DEFAULT_PORT) {
+    return new Promise((resolve) => {
+        const httpServer = (0, http_1.createServer)();
+        // Handle port-in-use error before trying to bind
+        httpServer.on('error', (error) => {
+            if (error.code === 'EADDRINUSE') {
+                console.error(`[MCP] Port ${port} already in use - connecting as relay client`);
+                connectAsRelay(port);
+                resolve(null);
+            }
+            else {
+                console.error('[MCP] HTTP server error:', error);
+                resolve(null);
+            }
+        });
+        httpServer.listen(port, () => {
+            const wss = new ws_1.WebSocketServer({ server: httpServer });
+            console.error(`[MCP] WebSocket server listening on port ${port}`);
+            wss.on('connection', (ws) => {
+                // Default to extension — relay clients will re-identify themselves immediately
+                // Only replace if no existing open extension connection
+                if (!connectedClient || connectedClient.readyState !== ws_1.WebSocket.OPEN) {
+                    console.error('[MCP] Extension connected');
+                    connectedClient = ws;
+                    (0, shared_state_js_1.saveConnectionState)(true);
+                }
+                ws.on('message', (data) => {
+                    const msgStr = data.toString();
+                    try {
+                        const msg = JSON.parse(msgStr);
+                        // Check if this client is identifying as a relay
+                        if (msg.type === 'MCP_RELAY_IDENTIFY') {
+                            console.error('[MCP] Client re-identified as relay');
+                            relayClients.add(ws);
+                            // Unset as extension if it was set
+                            if (connectedClient === ws) {
+                                connectedClient = null;
+                            }
+                            return;
+                        }
+                        // If it's a known relay client, forward its requests to extension
+                        if (relayClients.has(ws)) {
+                            handleRelayRequest(ws, msg);
+                            return;
+                        }
+                        // Extension message
+                        handleMessage(msgStr);
+                    }
+                    catch {
+                        handleMessage(msgStr);
+                    }
+                });
+                ws.on('close', () => {
+                    if (relayClients.has(ws)) {
+                        console.error('[MCP] Relay client disconnected');
+                        relayClients.delete(ws);
+                    }
+                    else if (connectedClient === ws) {
+                        console.error('[MCP] Extension disconnected');
+                        connectedClient = null;
+                        (0, shared_state_js_1.saveConnectionState)(false);
+                    }
+                });
+                ws.on('error', (error) => {
+                    console.error('[MCP] WebSocket error:', error);
+                });
+                // Send ping periodically and refresh connection state
+                const pingInterval = setInterval(() => {
+                    if (ws.readyState === ws_1.WebSocket.OPEN && connectedClient === ws) {
+                        ws.send(JSON.stringify({ type: 'PING' }));
+                        (0, shared_state_js_1.saveConnectionState)(true); // Refresh timestamp
+                    }
+                }, 30000);
+                ws.on('close', () => clearInterval(pingInterval));
+            });
+            resolve(wss);
+        });
+    });
+}
+/**
+ * Check if extension is connected
+ * Checks both in-memory connection and shared state file
+ */
+function isExtensionConnected() {
+    // Check direct extension connection (primary server mode)
+    if (connectedClient !== null && connectedClient.readyState === ws_1.WebSocket.OPEN) {
+        return true;
+    }
+    // Check relay connection (secondary process mode)
+    if (relayClient !== null && relayClient.readyState === ws_1.WebSocket.OPEN) {
+        return true;
+    }
+    // Fall back to shared state file
+    return (0, shared_state_js_1.loadConnectionState)();
+}
+/**
+ * Get current selection
+ */
+function getCurrentSelection() {
+    // Load from shared state to get updates from other processes
+    const sharedSelection = (0, shared_state_js_1.loadSelection)();
+    if (sharedSelection) {
+        currentSelection = sharedSelection;
+    }
+    return currentSelection;
+}
+/**
+ * Clear current selection
+ */
+function clearSelection() {
+    currentSelection = null;
+}
+/**
+ * Get current recording
+ */
+function getCurrentRecording() {
+    // Load from shared state to get updates from other processes
+    const sharedRecording = (0, shared_state_js_1.loadRecording)();
+    if (sharedRecording) {
+        currentRecording = sharedRecording;
+    }
+    return currentRecording;
+}
+/**
+ * Check if recording is in progress
+ */
+function isRecordingActive() {
+    // Load from shared state to get updates from other processes
+    const sharedState = (0, shared_state_js_1.loadRecordingState)();
+    isRecording = sharedState;
+    return isRecording;
+}
+/**
+ * Request page diagnostics from extension
+ */
+async function requestDiagnostics() {
+    return sendRequest('GET_DIAGNOSTICS');
+}
+/**
+ * Start flow recording
+ */
+async function startRecording() {
+    await sendRequest('START_RECORDING');
+    isRecording = true;
+    currentRecording = null;
+    (0, shared_state_js_1.saveRecordingState)(true); // Save to shared state
+    (0, shared_state_js_1.saveRecording)(null); // Clear recording
+}
+/**
+ * Stop flow recording
+ */
+async function stopRecording() {
+    const recording = await sendRequest('STOP_RECORDING');
+    isRecording = false;
+    currentRecording = recording;
+    (0, shared_state_js_1.saveRecordingState)(false); // Save to shared state
+    (0, shared_state_js_1.saveRecording)(recording); // Save recording
+    return recording;
+}
+/**
+ * Request recent activity buffer from extension
+ */
+async function requestRecentActivity() {
+    return sendRequest('GET_RECENT_ACTIVITY');
+}
+/**
+ * Request DOM snapshot
+ */
+async function requestSnapshot(selector) {
+    return sendRequest('SNAPSHOT_DOM', { selector });
+}
+/**
+ * Request DOM diff
+ */
+async function requestDiff(before, after) {
+    return sendRequest('DIFF_SNAPSHOTS', { before, after });
+}
+//# sourceMappingURL=websocket.js.map