@customaise/mcp 1.0.0

package/README.md

@@ -0,0 +1,172 @@
+# @customaise/mcp
+
+MCP server that connects AI coding agents to the [Customaise](https://customaise.com) Chrome extension for userscript management and browser automation.
+
+```
+AI Agent ←(stdio)→ MCP Server ←(WebSocket)→ Customaise Extension
+```
+
+## Quick Start
+
+### 1. Install Customaise
+Install the [Customaise Chrome extension](https://customaise.com) and enable **MCP Bridge** in Settings.
+
+### 2. Add to your IDE
+
+**Cursor** (`.cursor/mcp.json`):
+```json
+{
+  "mcpServers": {
+    "customaise": {
+      "command": "npx",
+      "args": ["-y", "@customaise/mcp"]
+    }
+  }
+}
+```
+
+**Claude Desktop** (`claude_desktop_config.json`):
+```json
+{
+  "mcpServers": {
+    "customaise": {
+      "command": "npx",
+      "args": ["-y", "@customaise/mcp"]
+    }
+  }
+}
+```
+
+**Windsurf** (`.windsurf/mcp.json`):
+```json
+{
+  "mcpServers": {
+    "customaise": {
+      "command": "npx",
+      "args": ["-y", "@customaise/mcp"]
+    }
+  }
+}
+```
+
+**Antigravity** (`mcp_config.json`):
+```json
+{
+  "mcpServers": {
+    "customaise": {
+      "command": "npx",
+      "args": ["-y", "@customaise/mcp"]
+    }
+  }
+}
+```
+
+### 3. Done!
+Your AI agent can now manage userscripts, inspect browser pages, and take screenshots — all through natural language.
+
+## Available Tools (12)
+
+### Script Lifecycle
+| Tool | Description |
+|------|-------------|
+| `list_scripts` | List all managed userscripts |
+| `import_script` | Pull a script to a local file for editing |
+| `export_script` | Push a local file to Customaise (validates + installs) |
+| `delete_script` | Permanently delete a script |
+| `toggle_script` | Enable or disable a script |
+
+### Browser Context
+| Tool | Description |
+|------|-------------|
+| `get_page_context` | DOM snapshot of the current page |
+| `get_console_context` | Console logs, errors, and GM_log output |
+| `list_tabs` | List all open browser tabs |
+
+### Testing & Verification
+| Tool | Description |
+|------|-------------|
+| `reload_tab` | Reload a tab to re-inject scripts |
+| `take_screenshot` | Capture a screenshot of the visible tab |
+
+### UI Control
+| Tool | Description |
+|------|-------------|
+| `toggle_ui` | Show or hide the Customaise UI overlay |
+
+### Batch Operations
+| Tool | Description |
+|------|-------------|
+| `sync_scripts` | Bulk export all scripts to a local directory |
+
+## Typical Workflow
+
+```
+1. get_page_context     → understand the target page
+2. write .user.js file  → AI creates the script using IDE tools
+3. export_script        → Customaise validates and installs
+4. reload_tab           → re-inject the script
+5. get_console_context  → check for errors
+6. take_screenshot      → verify visual result
+```
+
+## File Sync
+
+Use `sync_scripts` to bulk-export all scripts to a local directory:
+
+```
+sync_scripts({ directory: "~/customaise-scripts" })
+```
+
+This creates:
+- **One `.user.js` file per script** — filename is derived from the script name (lowercase, hyphens, e.g. `my-cool-script.user.js`)
+- **`.customaise-manifest.json`** — maps filenames to script IDs for round-trip editing
+
+### Manifest format
+
+```json
+{
+  "dark-mode-fix.user.js": "vm_script_1774225715376_lus75sdzn",
+  "my-cool-script.user.js": "vm_script_1774225800123_abc12defg"
+}
+```
+
+### Round-trip workflow
+
+1. `sync_scripts` → exports all scripts to a directory
+2. Edit any `.user.js` file in your IDE
+3. `export_script` with the file path + `scriptId` from the manifest → updates the script
+4. Omit `scriptId` when calling `export_script` → creates a new script instead
+
+### File watcher (auto-export)
+
+When `sync_scripts` has been called, the MCP server watches the directory for `.user.js` changes. Saving a file in your IDE automatically pushes it to Customaise — no manual `export_script` call needed.
+
+## Configuration
+
+| Environment Variable | Default | Description |
+|---------------------|---------|-------------|
+| `CUSTOMAISE_WS_PORT` | `4050` | WebSocket server port |
+
+## Requirements
+
+- **Node.js** ≥ 18
+- **Chrome** with the Customaise extension installed
+- **MCP Bridge** enabled in Customaise Settings (Power User feature)
+
+## Troubleshooting
+
+**"Customaise extension is not connected"**
+- Make sure Chrome is running with the Customaise extension
+- Check that MCP Bridge is enabled in extension Settings
+- The extension connects automatically within a few seconds
+
+**Port conflict on 4050**
+- Set a different port: `CUSTOMAISE_WS_PORT=4051 npx @customaise/mcp`
+
+**Scripts not running after export**
+- Call `reload_tab` to trigger script re-injection
+- Check `@match` pattern matches the current URL
+
+## License
+
+MIT

package/dist/extension-bridge.d.ts

@@ -0,0 +1,44 @@
+/**
+ * ExtensionBridge — WebSocket server that connects the MCP server to the
+ * Customaise Chrome extension.
+ *
+ * Architecture:
+ *   MCP Server (stdio) ←→ ExtensionBridge (WS server :4050) ←→ Extension SW (WS client)
+ *
+ * The MCP Node process hosts the WebSocket server because MV3 service workers
+ * cannot run servers. The extension connects as a WebSocket client.
+ */
+export declare class ExtensionBridge {
+    private wss;
+    private extensionSocket;
+    private pending;
+    private port;
+    private requestTimeoutMs;
+    constructor(port?: number, requestTimeoutMs?: number);
+    /**
+     * Start the WebSocket server and begin listening for the extension client.
+     */
+    start(): Promise<void>;
+    /**
+     * Send a request to the extension and wait for the response.
+     * Throws if the extension is not connected or the request times out.
+     */
+    request(type: string, args?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Whether the extension is currently connected.
+     */
+    get isConnected(): boolean;
+    /**
+     * Close the WebSocket server and all connections.
+     */
+    close(): Promise<void>;
+    /**
+     * Handle an incoming response from the extension, matching it to a pending request.
+     */
+    private _handleResponse;
+    /**
+     * Log to stderr (stdout is reserved for MCP stdio transport).
+     */
+    private _log;
+}
+//# sourceMappingURL=extension-bridge.d.ts.map

package/dist/extension-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-bridge.d.ts","sourceRoot":"","sources":["../src/extension-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA0BH,qBAAa,eAAe;IAC1B,OAAO,CAAC,GAAG,CAAgC;IAC3C,OAAO,CAAC,eAAe,CAA0B;IACjD,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,gBAAgB,CAAS;gBAErB,IAAI,SAAO,EAAE,gBAAgB,SAAS;IAKlD;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA8CtB;;;OAGG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAsBjF;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAyB5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAiBvB;;OAEG;IACH,OAAO,CAAC,IAAI;CAGb"}

package/dist/extension-bridge.js

@@ -0,0 +1,141 @@
+/**
+ * ExtensionBridge — WebSocket server that connects the MCP server to the
+ * Customaise Chrome extension.
+ *
+ * Architecture:
+ *   MCP Server (stdio) ←→ ExtensionBridge (WS server :4050) ←→ Extension SW (WS client)
+ *
+ * The MCP Node process hosts the WebSocket server because MV3 service workers
+ * cannot run servers. The extension connects as a WebSocket client.
+ */
+import { WebSocketServer, WebSocket } from 'ws';
+import { randomUUID } from 'node:crypto';
+export class ExtensionBridge {
+    wss = null;
+    extensionSocket = null;
+    pending = new Map();
+    port;
+    requestTimeoutMs;
+    constructor(port = 4050, requestTimeoutMs = 30_000) {
+        this.port = port;
+        this.requestTimeoutMs = requestTimeoutMs;
+    }
+    /**
+     * Start the WebSocket server and begin listening for the extension client.
+     */
+    start() {
+        return new Promise((resolve, reject) => {
+            this.wss = new WebSocketServer({ port: this.port }, () => {
+                this._log(`WebSocket server listening on ws://localhost:${this.port}`);
+                resolve();
+            });
+            this.wss.on('error', (err) => {
+                this._log(`WebSocket server error: ${err.message}`);
+                reject(err);
+            });
+            this.wss.on('connection', (ws) => {
+                this._log('Extension client connected');
+                // Only allow one client at a time (the Customaise extension)
+                if (this.extensionSocket) {
+                    this._log('Replacing existing extension connection');
+                    this.extensionSocket.close(1000, 'Replaced by new connection');
+                }
+                this.extensionSocket = ws;
+                ws.on('message', (data) => {
+                    try {
+                        const message = JSON.parse(data.toString());
+                        this._handleResponse(message);
+                    }
+                    catch (err) {
+                        this._log(`Failed to parse message from extension: ${err}`);
+                    }
+                });
+                ws.on('close', (code, reason) => {
+                    this._log(`Extension client disconnected (code=${code}, reason=${reason.toString()})`);
+                    if (this.extensionSocket === ws) {
+                        this.extensionSocket = null;
+                    }
+                });
+                ws.on('error', (err) => {
+                    this._log(`Extension client error: ${err.message}`);
+                });
+            });
+        });
+    }
+    /**
+     * Send a request to the extension and wait for the response.
+     * Throws if the extension is not connected or the request times out.
+     */
+    async request(type, args = {}) {
+        if (!this.extensionSocket || this.extensionSocket.readyState !== WebSocket.OPEN) {
+            throw new Error('Customaise extension is not connected. Make sure Chrome is running with the Customaise extension loaded.');
+        }
+        const id = randomUUID();
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new Error(`Request to extension timed out after ${this.requestTimeoutMs}ms (type=${type}, id=${id})`));
+            }, this.requestTimeoutMs);
+            this.pending.set(id, { resolve, reject, timer });
+            const request = { id, type, args };
+            this.extensionSocket.send(JSON.stringify(request));
+        });
+    }
+    /**
+     * Whether the extension is currently connected.
+     */
+    get isConnected() {
+        return this.extensionSocket !== null && this.extensionSocket.readyState === WebSocket.OPEN;
+    }
+    /**
+     * Close the WebSocket server and all connections.
+     */
+    async close() {
+        // Reject all pending requests
+        for (const [id, pending] of this.pending) {
+            clearTimeout(pending.timer);
+            pending.reject(new Error('Bridge is shutting down'));
+        }
+        this.pending.clear();
+        if (this.extensionSocket) {
+            this.extensionSocket.close(1000, 'MCP server shutting down');
+            this.extensionSocket = null;
+        }
+        return new Promise((resolve) => {
+            if (this.wss) {
+                this.wss.close(() => {
+                    this.wss = null;
+                    resolve();
+                });
+            }
+            else {
+                resolve();
+            }
+        });
+    }
+    /**
+     * Handle an incoming response from the extension, matching it to a pending request.
+     */
+    _handleResponse(message) {
+        const pending = this.pending.get(message.id);
+        if (!pending) {
+            this._log(`Received response for unknown request id: ${message.id}`);
+            return;
+        }
+        this.pending.delete(message.id);
+        clearTimeout(pending.timer);
+        if (message.success) {
+            pending.resolve(message.result);
+        }
+        else {
+            pending.reject(new Error(message.error || 'Extension returned an error'));
+        }
+    }
+    /**
+     * Log to stderr (stdout is reserved for MCP stdio transport).
+     */
+    _log(message) {
+        process.stderr.write(`[customaise-mcp] ${message}\n`);
+    }
+}
+//# sourceMappingURL=extension-bridge.js.map

package/dist/extension-bridge.js.map

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

package/dist/file-watcher.d.ts

@@ -0,0 +1,36 @@
+/**
+ * FileWatcher — watches a synced scripts directory for .user.js changes
+ * and auto-exports modified files back to Customaise.
+ *
+ * Activated after sync_scripts creates the manifest.
+ * Uses native fs.watch() for reliable cross-platform file watching.
+ */
+import { ExtensionBridge } from './extension-bridge.js';
+export declare class FileWatcher {
+    private watcher;
+    private bridge;
+    private directory;
+    /** filenames we recently wrote — mute window to prevent re-export loops */
+    private muteSet;
+    private muteTimeoutMs;
+    /** debounce timers per file */
+    private debounceTimers;
+    private debounceMs;
+    constructor(bridge: ExtensionBridge);
+    /**
+     * Start watching a directory for .user.js changes.
+     * Replaces any previous watcher.
+     */
+    start(directory: string): void;
+    /**
+     * Mute a filename to prevent re-export after MCP-initiated writes.
+     */
+    muteFile(fileName: string): void;
+    /**
+     * Stop the file watcher.
+     */
+    stop(): void;
+    private handleFileChange;
+    private exportFile;
+}
+//# sourceMappingURL=file-watcher.d.ts.map

package/dist/file-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-watcher.d.ts","sourceRoot":"","sources":["../src/file-watcher.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAIxD,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,SAAS,CAAc;IAE/B,2EAA2E;IAC3E,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,aAAa,CAAQ;IAE7B,+BAA+B;IAC/B,OAAO,CAAC,cAAc,CAAoD;IAC1E,OAAO,CAAC,UAAU,CAAO;gBAEb,MAAM,EAAE,eAAe;IAInC;;;OAGG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IA8B9B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAOhC;;OAEG;IACH,IAAI,IAAI,IAAI;IAWZ,OAAO,CAAC,gBAAgB;YAqBV,UAAU;CAqCzB"}

package/dist/file-watcher.js

@@ -0,0 +1,124 @@
+/**
+ * FileWatcher — watches a synced scripts directory for .user.js changes
+ * and auto-exports modified files back to Customaise.
+ *
+ * Activated after sync_scripts creates the manifest.
+ * Uses native fs.watch() for reliable cross-platform file watching.
+ */
+import { watch, readFileSync, existsSync } from 'node:fs';
+import { basename, join } from 'node:path';
+const LOG_PREFIX = '[customaise-mcp:watcher]';
+export class FileWatcher {
+    watcher = null;
+    bridge;
+    directory = '';
+    /** filenames we recently wrote — mute window to prevent re-export loops */
+    muteSet = new Set();
+    muteTimeoutMs = 1000;
+    /** debounce timers per file */
+    debounceTimers = new Map();
+    debounceMs = 500;
+    constructor(bridge) {
+        this.bridge = bridge;
+    }
+    /**
+     * Start watching a directory for .user.js changes.
+     * Replaces any previous watcher.
+     */
+    start(directory) {
+        // Stop previous watcher if any
+        this.stop();
+        this.directory = directory;
+        const manifestPath = join(directory, '.customaise-manifest.json');
+        if (!existsSync(manifestPath)) {
+            console.error(`${LOG_PREFIX} No manifest found at ${manifestPath}. Run sync_scripts first.`);
+            return;
+        }
+        console.error(`${LOG_PREFIX} Watching ${directory} for .user.js changes`);
+        // Use native fs.watch on the directory
+        this.watcher = watch(directory, (eventType, filename) => {
+            if (!filename || !filename.endsWith('.user.js'))
+                return;
+            if (eventType === 'change' || eventType === 'rename') {
+                const filePath = join(directory, filename);
+                if (existsSync(filePath)) {
+                    this.handleFileChange(filePath);
+                }
+            }
+        });
+        this.watcher.on('error', (error) => {
+            console.error(`${LOG_PREFIX} Watcher error:`, error.message);
+        });
+    }
+    /**
+     * Mute a filename to prevent re-export after MCP-initiated writes.
+     */
+    muteFile(fileName) {
+        this.muteSet.add(fileName);
+        setTimeout(() => {
+            this.muteSet.delete(fileName);
+        }, this.muteTimeoutMs);
+    }
+    /**
+     * Stop the file watcher.
+     */
+    stop() {
+        if (this.watcher) {
+            this.watcher.close();
+            this.watcher = null;
+            console.error(`${LOG_PREFIX} Watcher stopped`);
+        }
+        this.debounceTimers.forEach((timer) => clearTimeout(timer));
+        this.debounceTimers.clear();
+        this.muteSet.clear();
+    }
+    handleFileChange(filePath) {
+        const fileName = basename(filePath);
+        // Skip if this file is in the mute window (MCP-initiated write)
+        if (this.muteSet.has(fileName)) {
+            return;
+        }
+        // Debounce — IDEs may trigger multiple save events
+        const existing = this.debounceTimers.get(fileName);
+        if (existing)
+            clearTimeout(existing);
+        this.debounceTimers.set(fileName, setTimeout(() => {
+            this.debounceTimers.delete(fileName);
+            this.exportFile(filePath, fileName);
+        }, this.debounceMs));
+    }
+    async exportFile(filePath, fileName) {
+        try {
+            // Read manifest to find scriptId
+            const manifestPath = join(this.directory, '.customaise-manifest.json');
+            if (!existsSync(manifestPath))
+                return;
+            const manifest = JSON.parse(readFileSync(manifestPath, 'utf-8'));
+            const scriptId = manifest[fileName];
+            if (!scriptId) {
+                console.error(`${LOG_PREFIX} No scriptId in manifest for ${fileName} — skipping`);
+                return;
+            }
+            // Read file content
+            const code = readFileSync(filePath, 'utf-8');
+            if (!code.trim())
+                return;
+            console.error(`${LOG_PREFIX} Auto-exporting ${fileName} → ${scriptId}`);
+            // Send to extension via bridge
+            const result = await this.bridge.request('export_script', {
+                code,
+                scriptId,
+            });
+            if (result?.success) {
+                console.error(`${LOG_PREFIX} ✓ ${fileName} exported successfully`);
+            }
+            else {
+                console.error(`${LOG_PREFIX} ✗ ${fileName} export failed: ${result?.error || 'unknown'}`);
+            }
+        }
+        catch (error) {
+            console.error(`${LOG_PREFIX} Error exporting ${fileName}:`, error instanceof Error ? error.message : error);
+        }
+    }
+}
+//# sourceMappingURL=file-watcher.js.map

package/dist/file-watcher.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+/**
+ * Customaise MCP Server — Entry Point
+ *
+ * Connects AI coding agents (Cursor, Antigravity, Claude Code) to the
+ * Customaise Chrome extension via the Model Context Protocol.
+ *
+ * Transport:
+ *   AI Agent ←(stdio)→ MCP Server ←(WebSocket)→ Chrome Extension
+ *
+ * Usage:
+ *   node dist/index.js
+ *
+ * Environment:
+ *   CUSTOMAISE_WS_PORT  — WebSocket server port (default: 4050)
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+/**
+ * Customaise MCP Server — Entry Point
+ *
+ * Connects AI coding agents (Cursor, Antigravity, Claude Code) to the
+ * Customaise Chrome extension via the Model Context Protocol.
+ *
+ * Transport:
+ *   AI Agent ←(stdio)→ MCP Server ←(WebSocket)→ Chrome Extension
+ *
+ * Usage:
+ *   node dist/index.js
+ *
+ * Environment:
+ *   CUSTOMAISE_WS_PORT  — WebSocket server port (default: 4050)
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { registerTools, registerPromptsAndResources } from './server.js';
+import { ExtensionBridge } from './extension-bridge.js';
+import { FileWatcher } from './file-watcher.js';
+const WS_PORT = Number(process.env.CUSTOMAISE_WS_PORT || process.env.VIBEMONKEY_WS_PORT) || 4050;
+async function main() {
+    // 1. Start the WebSocket server for the extension to connect to
+    const bridge = new ExtensionBridge(WS_PORT);
+    await bridge.start();
+    // 2. Create the MCP server
+    const server = new McpServer({
+        name: 'customaise',
+        version: '1.0.0'
+    }, {
+        capabilities: {
+            tools: {},
+            prompts: {},
+            resources: {}
+        }
+    });
+    // 3. Create file watcher for sync_scripts auto-export
+    const fileWatcher = new FileWatcher(bridge);
+    // 4. Register tools, prompts, and resources
+    registerTools(server, bridge, fileWatcher);
+    registerPromptsAndResources(server, bridge);
+    // 4. Connect via stdio transport (AI agent communicates over stdin/stdout)
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    process.stderr.write('[customaise-mcp] MCP server running (stdio + WebSocket)\n');
+    // Graceful shutdown
+    const shutdown = async () => {
+        process.stderr.write('[customaise-mcp] Shutting down...\n');
+        fileWatcher.stop();
+        await bridge.close();
+        await server.close();
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+}
+main().catch((err) => {
+    process.stderr.write(`[customaise-mcp] Fatal error: ${err.message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,IAAI,CAAC;AAEjG,KAAK,UAAU,IAAI;IACjB,gEAAgE;IAChE,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IAErB,2BAA2B;IAC3B,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE;YACT,OAAO,EAAE,EAAE;YACX,SAAS,EAAE,EAAE;SACd;KACF,CACF,CAAC;IAEF,sDAAsD;IACtD,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IAE5C,4CAA4C;IAC5C,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAC3C,2BAA2B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE5C,2EAA2E;IAC3E,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAElF,oBAAoB;IACpB,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;QAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAC5D,WAAW,CAAC,IAAI,EAAE,CAAC;QACnB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iCAAiC,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;IACvE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,12 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { ExtensionBridge } from './extension-bridge.js';
+import { FileWatcher } from './file-watcher.js';
+/**
+ * Register all MCP tools with the server.
+ */
+export declare function registerTools(server: McpServer, bridge: ExtensionBridge, fileWatcher?: FileWatcher): void;
+/**
+ * Register MCP Prompts and Resources.
+ */
+export declare function registerPromptsAndResources(server: McpServer, bridge: ExtensionBridge): void;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAKtF,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,IAAI,CA0UzG;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAqJ5F"}

package/dist/server.js

@@ -0,0 +1,472 @@
+import { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { tmpdir } from 'node:os';
+/**
+ * Register all MCP tools with the server.
+ */
+export function registerTools(server, bridge, fileWatcher) {
+    // ─── Script Lifecycle ───────────────────────────────────────────────
+    server.tool('list_scripts', 'List all userscripts managed by Customaise. Returns each script\'s ID, name, enabled status, URL match patterns, and description. Use this to discover available scripts before importing or modifying them.', {}, async () => {
+        const result = await bridge.request('list_scripts', {});
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2)
+                }]
+        };
+    });
+    server.tool('import_script', 'Import an existing userscript from Customaise to a local file for editing. The file will include the full source code with metadata block. After editing the file with your IDE tools, use export_script to push changes back to Customaise.', {
+        scriptId: z.string().describe('The ID of the script to import (get from list_scripts)'),
+        filePath: z.string().describe('Local file path to write the script to (e.g., ./scripts/my-script.user.js)')
+    }, async ({ scriptId, filePath }) => {
+        const result = await bridge.request('import_script', { scriptId });
+        // Ensure directory exists and write file
+        mkdirSync(dirname(filePath), { recursive: true });
+        writeFileSync(filePath, result.source, 'utf-8');
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        filePath,
+                        scriptId: result.scriptId,
+                        metadata: result.metadata,
+                        bytesWritten: Buffer.byteLength(result.source, 'utf-8')
+                    }, null, 2)
+                }]
+        };
+    });
+    server.tool('export_script', 'Export a userscript from a local file into Customaise. The file will be validated through Customaise\'s sanitization pipeline (syntax checking, AST validation, security analysis). If valid, the script is installed and ready to execute on matching pages. If invalid, detailed diagnostics explain exactly what to fix. Pass scriptId to update an existing script instead of creating a new one.', {
+        filePath: z.string().describe('Local file path containing the userscript source code'),
+        scriptId: z.string().optional().describe('ID of an existing script to update. Omit to create a new script.')
+    }, async ({ filePath, scriptId }) => {
+        const code = readFileSync(filePath, 'utf-8');
+        const result = await bridge.request('export_script', { code, scriptId });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2)
+                }]
+        };
+    });
+    server.tool('delete_script', 'Permanently delete a userscript from Customaise. This action cannot be undone.', {
+        scriptId: z.string().describe('The ID of the script to delete')
+    }, async ({ scriptId }) => {
+        const result = await bridge.request('delete_script', { scriptId });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2)
+                }]
+        };
+    });
+    server.tool('toggle_script', 'Enable or disable a userscript. Disabled scripts are not injected into matching pages. Use this to temporarily turn off a script without deleting it.', {
+        scriptId: z.string().describe('The ID of the script to enable/disable'),
+        enabled: z.boolean().describe('true to enable, false to disable')
+    }, async ({ scriptId, enabled }) => {
+        const result = await bridge.request('set_script_enabled', { scriptId, enabled });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2)
+                }]
+        };
+    });
+    // ─── Browser Context ────────────────────────────────────────────────
+    server.tool('get_page_context', 'Get a DOM snapshot of the current page including URL, title, page structure, and visible elements. Use this to understand the page layout before writing userscripts that manipulate it.', {
+        tabId: z.number().optional().describe('Tab ID to inspect. Defaults to the active tab.')
+    }, async ({ tabId }) => {
+        const result = await bridge.request('get_page_context', { tabId });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2)
+                }]
+        };
+    });
+    server.tool('get_console_context', 'Get console logs from the browser, including errors, warnings, and userscript GM_log output. Use after reload_tab to check for script runtime errors. Logs include userscript-specific entries by default.', {
+        tabId: z.number().optional().describe('Tab ID to get logs from. Defaults to the active tab.'),
+        level: z.enum(['all', 'error', 'warn', 'info', 'debug']).optional().describe('Filter by log level. Default: all')
+    }, async ({ tabId, level }) => {
+        const result = await bridge.request('get_console_context', { tabId });
+        // Apply level filter client-side — ConsoleContextService returns
+        // pre-structured arrays (errors, warnings, userscriptLogs).
+        if (level && level !== 'all') {
+            const filtered = { ...result };
+            if (level === 'error') {
+                delete filtered.warnings;
+                delete filtered.userscriptLogs;
+            }
+            else if (level === 'warn') {
+                delete filtered.errors;
+                delete filtered.userscriptLogs;
+            }
+            else if (level === 'info' || level === 'debug') {
+                delete filtered.errors;
+                delete filtered.warnings;
+            }
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify(filtered, null, 2)
+                    }]
+            };
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2)
+                }]
+        };
+    });
+    server.tool('list_tabs', 'List all open browser tabs with their IDs, URLs, titles, and active status. Use to find a specific tab ID for other tools like reload_tab or take_screenshot.', {}, async () => {
+        const result = await bridge.request('list_tabs', {});
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2)
+                }]
+        };
+    });
+    server.tool('reload_tab', 'Reload a browser tab to re-inject updated userscripts. Use after export_script to see the effect of your changes. Waits for the page to fully load before returning.', {
+        tabId: z.number().optional().describe('Tab ID to reload. Defaults to the active tab.')
+    }, async ({ tabId }) => {
+        const result = await bridge.request('reload_tab', { tabId });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2)
+                }]
+        };
+    });
+    server.tool('take_screenshot', 'Capture a screenshot of the current visible browser tab. Use to verify visual changes made by userscripts. The screenshot is saved as a PNG file.', {
+        tabId: z.number().optional().describe('Tab ID to screenshot. Defaults to the active tab.'),
+        filePath: z.string().optional().describe('Local file path to save the screenshot. Auto-generates a temp path if omitted.')
+    }, async ({ tabId, filePath }) => {
+        const result = await bridge.request('take_screenshot', { tabId });
+        // Write base64 PNG data to file
+        const savePath = filePath || join(tmpdir(), `customaise-screenshot-${Date.now()}.png`);
+        const base64Data = result.dataUrl.replace(/^data:image\/png;base64,/, '');
+        mkdirSync(dirname(savePath), { recursive: true });
+        writeFileSync(savePath, Buffer.from(base64Data, 'base64'));
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        filePath: savePath,
+                        width: result.width,
+                        height: result.height
+                    }, null, 2)
+                }]
+        };
+    });
+    server.tool('toggle_ui', 'Show or hide the Customaise UI overlay on the active tab. Use this to make the Customaise interface visible or dismiss it — AI agents cannot click the extension icon directly. Optionally specify which panel to open.', {
+        tabId: z.number().optional().describe('Tab ID to toggle UI on. Defaults to the active tab.'),
+        panel: z.string().optional().describe('Panel to open: "scripts", "chat", "settings"')
+    }, async ({ tabId, panel }) => {
+        const result = await bridge.request('show_ui', { tabId, panel });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2)
+                }]
+        };
+    });
+    // ─── File Sync ──────────────────────────────────────────────────────
+    server.tool('sync_scripts', 'Bulk export all scripts from Customaise to a local directory as individual .user.js files. Creates a .customaise-manifest.json mapping filenames to script IDs. Use this to set up a local workspace for editing scripts with your IDE.', {
+        directory: z.string().describe('Local directory to export scripts to (e.g., ./customaise-scripts/)')
+    }, async ({ directory }) => {
+        // Get all scripts with code
+        const scripts = await bridge.request('list_scripts_with_code', {});
+        mkdirSync(directory, { recursive: true });
+        const manifest = {};
+        let filesWritten = 0;
+        const usedNames = new Set();
+        for (const script of scripts) {
+            // Generate a safe filename from the script name
+            let safeName = (script.name || 'untitled')
+                .toLowerCase()
+                .replace(/[^a-z0-9_-]/g, '-')
+                .replace(/-+/g, '-')
+                .replace(/^-|-$/g, '');
+            // Handle filename collisions — append short ID suffix if name already used
+            let fileName = `${safeName}.user.js`;
+            if (usedNames.has(fileName)) {
+                const idSuffix = script.id.slice(-6);
+                fileName = `${safeName}-${idSuffix}.user.js`;
+            }
+            usedNames.add(fileName);
+            const filePath = `${directory}/${fileName}`;
+            // Mute each file to prevent the watcher from re-exporting
+            if (fileWatcher)
+                fileWatcher.muteFile(fileName);
+            writeFileSync(filePath, script.code || '', 'utf-8');
+            manifest[fileName] = script.id;
+            filesWritten++;
+        }
+        // Write manifest for ID mapping
+        const manifestPath = `${directory}/.customaise-manifest.json`;
+        writeFileSync(manifestPath, JSON.stringify(manifest, null, 2), 'utf-8');
+        // Start file watcher on the synced directory
+        if (fileWatcher) {
+            fileWatcher.start(directory);
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        directory,
+                        filesWritten,
+                        manifestPath,
+                        scripts: Object.entries(manifest).map(([file, id]) => ({ file, id }))
+                    }, null, 2)
+                }]
+        };
+    });
+}
+/**
+ * Register MCP Prompts and Resources.
+ */
+export function registerPromptsAndResources(server, bridge) {
+    // ─── Prompts ────────────────────────────────────────────────────────
+    server.prompt('create-userscript', 'Guided workflow for creating a new userscript. Provides a step-by-step prompt that helps the AI agent understand what the user needs and produce a working script.', {
+        targetUrl: z.string().describe('The URL pattern the script should match (e.g., *://*.example.com/*)'),
+        goal: z.string().describe('What the script should accomplish')
+    }, async ({ targetUrl, goal }) => {
+        return {
+            messages: [
+                {
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: [
+                            `Create a userscript for Customaise that does the following:`,
+                            ``,
+                            `**Target URL:** ${targetUrl}`,
+                            `**Goal:** ${goal}`,
+                            ``,
+                            `## Requirements`,
+                            `1. Include a proper metadata block with @name, @match, @description, @version, and @grant directives`,
+                            `2. Use @match ${targetUrl}`,
+                            `3. Wrap the script in an IIFE containing named functions (required for symbol-level editing via Customaise)`,
+                            `4. If making cross-origin requests, include the @connect directive`,
+                            `5. Use GM_log for debug output (it appears in Customaise's console context)`,
+                            `6. Handle edge cases (element not found, page still loading, etc.)`,
+                            ``,
+                            `## Workflow`,
+                            `1. Use \`get_page_context\` to understand the page structure`,
+                            `2. Write the script code`,
+                            `3. For targeting existing page elements, consider using \`VM_findElement\` with \`dom_*\` IDs from \`get_page_context\` for bulletproof selector resilience`,
+                            `4. Use \`export_script\` to install it in Customaise (it will be validated through the sanitization pipeline)`,
+                            `5. Use \`reload_tab\` to test it`,
+                            `6. Use \`get_console_context\` to check for errors or GM_log output`,
+                            `7. If there are issues, fix and re-export`,
+                        ].join('\n')
+                    }
+                }
+            ]
+        };
+    });
+    server.prompt('debug-userscript', 'Debugging workflow for an existing userscript that isn\'t working as expected. Guides the AI through systematic diagnosis using available tools.', {
+        scriptId: z.string().describe('The ID of the script to debug')
+    }, async ({ scriptId }) => {
+        return {
+            messages: [
+                {
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: [
+                            `Debug the userscript with ID \`${scriptId}\`.`,
+                            ``,
+                            `## Debugging Steps`,
+                            `1. Use \`import_script\` to pull the script to a local file for inspection`,
+                            `2. Check if the script is enabled with \`list_scripts\``,
+                            `3. Use \`list_tabs\` to find a tab matching the script's @match pattern`,
+                            `4. Use \`reload_tab\` on that tab to trigger script injection`,
+                            `5. Use \`get_console_context\` to capture errors and GM_log output`,
+                            `6. Use \`get_page_context\` to verify the DOM state`,
+                            `7. If needed, use \`take_screenshot\` to see the visual result`,
+                            ``,
+                            `## Common Issues`,
+                            `- @match pattern doesn't match the current URL`,
+                            `- @run-at timing: script runs before target elements exist`,
+                            `- Missing @grant for GM_* or VM_* APIs used in the script`,
+                            `- Missing @connect directive for cross-origin GM_xmlhttpRequest calls`,
+                            `- CSP blocking inline script injection`,
+                            `- Element selectors changed on the page`,
+                            ``,
+                            `Fix any issues found and use \`export_script\` to push updates.`,
+                        ].join('\n')
+                    }
+                }
+            ]
+        };
+    });
+    // ─── Resources ──────────────────────────────────────────────────────
+    server.resource('scripts-list', 'customaise://scripts', {
+        description: 'Live list of all userscripts managed by Customaise, including their IDs, names, and enabled status.',
+        mimeType: 'application/json'
+    }, async (uri) => {
+        const result = await bridge.request('list_scripts', {});
+        return {
+            contents: [{
+                    uri: uri.href,
+                    mimeType: 'application/json',
+                    text: JSON.stringify(result, null, 2)
+                }]
+        };
+    });
+    server.resource('script-source', new ResourceTemplate('customaise://scripts/{scriptId}', { list: undefined }), {
+        description: 'Full source code and metadata of a specific userscript. Use the script ID from the scripts list.',
+        mimeType: 'application/json'
+    }, async (uri, variables) => {
+        const scriptId = variables.scriptId;
+        // Reuse the import_script bridge command (same logic, avoids duplication)
+        const result = await bridge.request('import_script', { scriptId });
+        return {
+            contents: [{
+                    uri: uri.href,
+                    mimeType: 'application/json',
+                    text: JSON.stringify(result, null, 2)
+                }]
+        };
+    });
+    server.resource('conventions', 'customaise://conventions', {
+        description: 'Userscript writing conventions and best practices for Customaise.',
+        mimeType: 'text/markdown'
+    }, async (uri) => {
+        return {
+            contents: [{
+                    uri: uri.href,
+                    mimeType: 'text/markdown',
+                    text: CONVENTIONS_GUIDE
+                }]
+        };
+    });
+}
+const CONVENTIONS_GUIDE = `# Customaise Userscript Conventions
+
+## File Format & Structure
+
+Every userscript is a single \`.user.js\` file with a metadata block at the top. 
+**CRITICAL**: Customaise supports symbol-level editing (function-by-function). To enable this, your script MUST be wrapped in an IIFE containing **named functions**, rather than flat inline code.
+
+\`\`\`javascript
+// ==UserScript==
+// @name        My Script
+// @description What this script does
+// @match       https://example.com/*
+// @version     1.0
+// @grant       GM_log
+// @grant       VM_findElement
+// @run-at      document-idle
+// ==/UserScript==
+
+(function() {
+  'use strict';
+  
+  // Good: Named functions allow Customaise to edit them individually
+  async function init() {
+    GM_log('Script initialized');
+    await hideAnnoyingBanner();
+  }
+
+  async function hideAnnoyingBanner() {
+    // VM_findElement is our bulletproof DOM selector
+    const banner = await VM_findElement('dom_banner_123');
+    if (banner) banner.style.display = 'none';
+  }
+
+  init();
+})();
+\`\`\`
+
+## Metadata Directives
+
+| Directive | Required | Description |
+|-----------|----------|-------------|
+| \`@name\` | ✅ | Script name (must be unique) |
+| \`@match\` | ✅ | URL pattern(s) where the script runs (\`*://*.example.com/*\`) |
+| \`@description\` | Recommended | What the script does |
+| \`@version\` | Recommended | Semantic version (defaults to 1.0) |
+| \`@grant\` | Optional | GM_* or VM_* APIs to enable (use \`none\` for no special APIs) |
+| \`@run-at\` | Optional | When to inject: \`document-start\`, \`document-end\`, \`document-idle\` (default) |
+| \`@connect\` | Optional | Domains allowed for \`GM_xmlhttpRequest\` (e.g., \`api.github.com\`) |
+| \`@domId\` | Auto | Auto-managed by Customaise for \`VM_findElement\`. **Do not edit manually.** |
+| \`@require\` | Optional | External JS libraries to load before the script |
+| \`@resource\` | Optional | Named external resources (CSS, JSON, images) accessible via \`GM_getResourceText/URL\` |
+| \`@namespace\` | Optional | Script namespace (used for de-duplication with imported scripts) |
+| \`@author\` | Optional | Script author |
+
+## VM_findElement (Bulletproof DOM Targeting)
+
+Customaise provides a revolutionary multi-tier selector API that guarantees 100% element targeting reliability, surviving UI redesigns and dynamic class changes.
+
+**Usage:**
+1. You must declare \`@grant VM_findElement\`
+2. Pass a \`dom_*\` ID string (e.g., \`await VM_findElement('dom_1234567890_abc')\`)
+3. **Important:** \`dom_*\` IDs are generated by the user using the Customaise DOM selector tooltip. Do not invent your own \`dom_*\` IDs. If creating elements dynamically, use standard \`document.querySelector\`.
+4. The function is async and must be awaited.
+
+**VM_findExternalElement:** Works like \`VM_findElement\` but targets elements inside cross-origin iframes. Requires \`@connect\` for the iframe's domain. Usage: \`await VM_findExternalElement('dom_ext_xxx')\`.
+
+## Available GM_* APIs
+
+Customaise supports 22 \`GM_*\` APIs, making it highly compatible with existing Greasemonkey/Tampermonkey scripts. You can use either the classic \`GM_*\` (underscore) or modern \`GM.*\` (promise-based) syntax.
+
+### Environment & Console
+| API | Description |
+|-----|-------------|
+| \`GM_log(msg)\` / \`GM.log(msg)\` | Log to Customaise console (visible via \`get_console_context\` tool) |
+| \`GM_info\` / \`GM.info\` | Object containing script metadata |
+
+### Storage (Extension-Scoped)
+| API | Description |
+|-----|-------------|
+| \`GM_setValue(k, v)\` / \`GM.setValue(k, v)\` | Persistent storage (survives page reloads) |
+| \`GM_getValue(k, def)\` / \`GM.getValue(k, def)\` | Read from persistent storage |
+| \`GM_deleteValue(k)\` / \`GM.deleteValue(k)\` | Delete from persistent storage |
+| \`GM_listValues()\` / \`GM.listValues()\` | List all stored keys |
+| \`GM_addValueChangeListener(name, cb)\` | Listen for storage changes across tabs |
+| \`GM_removeValueChangeListener(id)\` | Remove storage listener |
+
+### DOM & UI
+| API | Description |
+|-----|-------------|
+| \`GM_addStyle(css)\` / \`GM.addStyle(css)\` | Inject CSS into the page |
+| \`GM_addElement(tag, attr)\` / \`GM.addElement(tag, attr)\` | Safely create and append DOM elements |
+| \`GM_registerMenuCommand(name, fn)\` | Add a command to the Customaise extension menu |
+| \`GM_unregisterMenuCommand(id)\` | Remove a menu command |
+| \`GM_notification(details)\` / \`GM.notification(details)\` | Show a desktop OS notification |
+
+### Network & Resources
+| API | Description |
+|-----|-------------|
+| \`GM_xmlhttpRequest(details)\` | Cross-origin HTTP requests. **Requires \`@connect\` directive.** |
+| \`GM.xmlHttpRequest(details)\` | Promise-based cross-origin HTTP requests |
+| \`GM_download(details)\` | Download a file to disk |
+| \`GM_getResourceText(name)\` / \`GM.getResourceText(name)\` | Read text content from a \`@resource\` |
+| \`GM_getResourceURL(name)\` / \`GM.getResourceUrl(name)\` | Get base64 data URI for a \`@resource\` |
+
+### Tabs & System
+| API | Description |
+|-----|-------------|
+| \`GM_setClipboard(text)\` / \`GM.setClipboard(text)\` | Copy text to OS clipboard |
+| \`GM_openInTab(url, options)\` / \`GM.openInTab(url, options)\` | Open a new browser tab |
+| \`GM_getTab(cb)\` / \`GM.getTab()\` | Get persistent state for the current tab |
+| \`GM_saveTab(obj)\` / \`GM.saveTab(obj)\` | Save persistent state for the current tab |
+| \`GM_getTabs(cb)\` / \`GM.getTabs()\` | Get persistent state for all tabs running this script |
+
+## Developer Workflow & Best Practices
+
+1. **Use \`GM_log\` over \`console.log\`:** \`GM_log\` output is explicitly tracked by Customaise and is visible when using the \`get_console_context\` MCP tool.
+2. **Cross-Origin Requests:** If your script needs to fetch data from \`api.github.com\`, you MUST include \`// @connect api.github.com\` in the metadata block, or \`GM_xmlhttpRequest\` will fail silently.
+3. **Handle Dynamic Pages:** Most modern sites are SPAs (Single Page Applications). Elements may not exist immediately. Use \`VM_findElement\` or \`MutationObserver\` instead of assuming elements are present on load.
+4. **Execution Timing:** \`// @run-at document-idle\` is the safest default as it ensures the initial DOM is fully parsed.
+`;
+//# 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/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@customaise/mcp",
+  "version": "1.0.0",
+  "description": "MCP server that connects AI coding agents (Cursor, Claude Code, Windsurf, Antigravity) to the Customaise Chrome extension for userscript management and browser automation.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "customaise-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist/",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "node --loader ts-node/esm src/index.ts",
+    "test": "tsc -p tsconfig.test.json && node --loader ./test-loader.mjs --test test-out/__tests__/*.test.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "customaise",
+    "userscripts",
+    "chrome-extension",
+    "browser-automation",
+    "model-context-protocol",
+    "ai-tools",
+    "cursor",
+    "claude",
+    "windsurf"
+  ],
+  "author": "Customaise",
+  "license": "MIT",
+  "homepage": "https://customaise.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/customaise/customaise-mcp"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "ws": "^8.18.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.0",
+    "ts-node": "^10.9.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.7.0",
+    "vitest": "^4.1.0"
+  }
+}