@opentabs-dev/mcp-server 0.0.19

package/dist/extension-install.js

@@ -0,0 +1,75 @@
+/**
+ * Managed extension auto-install.
+ *
+ * On every MCP server startup (and hot reload), checks whether the browser
+ * extension in ~/.opentabs/extension/ is up to date with the server's package
+ * version. If the version file is missing or stale, copies the extension from
+ * the platform/browser-extension/ source directory, writes a version marker,
+ * and creates the adapters/ directory for plugin IIFEs.
+ *
+ * The copy excludes build/development artifacts (node_modules, src, .git,
+ * tsconfig*) — only the files needed to load an unpacked extension in Chrome.
+ */
+import { getAdaptersDir, getExtensionDir, getExtensionVersionFile } from './config.js';
+import { log } from './logger.js';
+import { version } from './version.js';
+import { EXTENSION_COPY_EXCLUDE_PATTERN } from '@opentabs-dev/shared';
+import { cpSync, mkdirSync } from 'node:fs';
+import { dirname, join, relative, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/**
+ * Resolve the browser-extension source directory relative to this module's
+ * compiled location. The MCP server compiles to dist/extension-install.js,
+ * so browser-extension is at ../../browser-extension from that file.
+ */
+const getExtensionSourceDir = () => resolve(dirname(fileURLToPath(import.meta.url)), '..', '..', 'browser-extension');
+const ensureExtensionInstalled = async () => {
+    const extensionDir = getExtensionDir();
+    const versionFile = getExtensionVersionFile();
+    const adaptersDir = getAdaptersDir();
+    // Read installed version (missing file → empty string → mismatch)
+    let installedVersion = '';
+    try {
+        const file = Bun.file(versionFile);
+        if (await file.exists()) {
+            installedVersion = (await file.text()).trim();
+        }
+    }
+    catch {
+        // File unreadable — treat as missing
+    }
+    if (installedVersion === version) {
+        log.debug(`Managed extension is up to date (v${version})`);
+        return { versionChanged: false };
+    }
+    // Version mismatch or missing — perform the copy
+    const extensionSrc = getExtensionSourceDir();
+    // Verify the source exists before attempting the copy
+    if (!(await Bun.file(join(extensionSrc, 'manifest.json')).exists())) {
+        log.warn(`Browser extension source not found at ${extensionSrc}, skipping auto-install`);
+        return { versionChanged: false };
+    }
+    log.info(installedVersion
+        ? `Updating managed extension: v${installedVersion} → v${version}`
+        : `Installing managed extension v${version}`);
+    try {
+        cpSync(extensionSrc, extensionDir, {
+            recursive: true,
+            force: true,
+            filter: (source) => {
+                const rel = relative(extensionSrc, source);
+                return rel === '' || !EXTENSION_COPY_EXCLUDE_PATTERN.test(rel);
+            },
+        });
+        mkdirSync(adaptersDir, { recursive: true });
+        await Bun.write(versionFile, version);
+        log.info(`Managed extension installed to ${extensionDir}`);
+        return { versionChanged: true };
+    }
+    catch (err) {
+        log.warn('Failed to install managed extension:', err);
+        return { versionChanged: false };
+    }
+};
+export { ensureExtensionInstalled };
+//# sourceMappingURL=extension-install.js.map

package/dist/extension-install.js.map

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

package/dist/extension-protocol.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Extension WebSocket protocol handler.
+ * Handles JSON-RPC messages between the MCP server and Chrome extension.
+ */
+import type { PluginLogEntry } from './log-buffer.js';
+import type { ServerState, ConfirmationDecision } from './state.js';
+import type { WsHandle } from '@opentabs-dev/shared';
+/** Callbacks the extension protocol can invoke on the MCP side */
+interface McpCallbacks {
+    onToolConfigChanged: () => void;
+    onToolConfigPersist: () => void;
+    onPluginLog: (entry: PluginLogEntry) => void;
+}
+/**
+ * Write a plugin's adapter IIFE to the extension's adapters/ directory.
+ * The extension injects adapters via chrome.scripting.executeScript({ files: [...] })
+ * using these files, bypassing page CSP restrictions.
+ *
+ * If a source map is provided, writes it alongside the adapter as {pluginName}.js.map
+ * and rewrites the sourceMappingURL in the IIFE to reference the per-plugin filename
+ * (prevents collisions when multiple plugins are loaded).
+ */
+declare const writeAdapterFile: (pluginName: string, iife: string, sourceMap?: string) => Promise<void>;
+/**
+ * Send sync.full notification to extension on connect.
+ * Writes all plugin adapter IIFEs to the extension's adapters/ directory,
+ * then sends plugin metadata (without IIFE content) to the extension.
+ */
+declare const sendSyncFull: (state: ServerState) => Promise<void>;
+/** Options for dispatchToExtension beyond the basic method + params */
+interface DispatchOptions {
+    /** Human-readable description for timeout error messages (e.g., "browser.openTab" or "slack/send_message") */
+    label?: string;
+    /** MCP progressToken from the tools/call request's _meta — stored on PendingDispatch for progress forwarding */
+    progressToken?: string | number;
+    /** Callback to emit an MCP ProgressNotification when tool.progress arrives for this dispatch */
+    onProgress?: (progress: number, total: number, message?: string) => void;
+}
+/**
+ * Send a JSON-RPC request to the extension and return a promise for the response.
+ * Unified dispatch for both browser commands (browser.*, extension.*) and
+ * plugin tool dispatches (tool.dispatch).
+ */
+declare const dispatchToExtension: (state: ServerState, method: string, params: Record<string, unknown>, options?: string | DispatchOptions) => Promise<unknown>;
+/**
+ * Send tool.invocationStart notification to extension (for side panel animation).
+ */
+declare const sendInvocationStart: (state: ServerState, plugin: string, tool: string) => void;
+/**
+ * Send tool.invocationEnd notification to extension (for side panel animation).
+ */
+declare const sendInvocationEnd: (state: ServerState, plugin: string, tool: string, durationMs: number, success: boolean) => void;
+/**
+ * Send a confirmation request to the extension and return a promise that resolves
+ * with the user's decision. The promise rejects on timeout (30s) or extension disconnect.
+ *
+ * @param state - Server state
+ * @param tool - Browser tool name (e.g., 'browser_execute_script')
+ * @param domain - Target domain (e.g., 'mail.google.com'), or null
+ * @param tabId - Target tab ID, if applicable
+ * @param paramsPreview - Truncated preview of tool parameters
+ * @returns The user's decision: 'allow_once', 'allow_always', or 'deny'
+ */
+declare const sendConfirmationRequest: (state: ServerState, tool: string, domain: string | null, tabId: number | undefined, paramsPreview: string) => Promise<ConfirmationDecision>;
+/**
+ * Reject all pending confirmations. Called when the extension disconnects
+ * to clean up any confirmation promises that can no longer be fulfilled.
+ */
+declare const rejectAllPendingConfirmations: (state: ServerState) => void;
+/**
+ * Send plugin.update notification to extension with updated plugin metadata.
+ * Writes the adapter IIFE to the extension's adapters/ directory first,
+ * then sends the notification (without IIFE content) to the extension.
+ *
+ * Used by file watcher when a local plugin's manifest or IIFE changes on disk,
+ * and by the hot reload sequence after re-discovery.
+ *
+ * Sent as a JSON-RPC notification (no id, no response expected). The extension
+ * processes the update and re-injects the adapter into matching tabs.
+ */
+declare const sendPluginUpdate: (state: ServerState, pluginName: string, iife: string, sourceMap?: string) => Promise<void>;
+/**
+ * Handle an incoming WebSocket message from the extension.
+ * Routes to the appropriate handler based on method/id.
+ *
+ * @param senderWs - The raw WebSocket that sent this message. Used to reply
+ *   pongs on the exact connection that pinged, preventing race conditions
+ *   during hot reload when two connections may briefly coexist.
+ */
+declare const handleExtensionMessage: (state: ServerState, text: string, callbacks: McpCallbacks, senderWs?: WsHandle) => void;
+/**
+ * Check if an error is a DispatchError by duck-typing rather than instanceof.
+ *
+ * Under bun --hot, each module re-evaluation creates a new DispatchError class.
+ * If a tool dispatch timeout fires after hot reload, the error is an instance of
+ * the OLD module's DispatchError class. Using `instanceof` against the NEW
+ * module's DispatchError would fail, causing the error to fall through to the
+ * generic catch branch and lose the specific error code/message. Duck-typing
+ * avoids this cross-reload class identity problem.
+ */
+declare const isDispatchError: (err: unknown) => err is {
+    name: string;
+    message: string;
+    code: number;
+    data?: Record<string, unknown>;
+};
+/**
+ * Write a dynamic exec script to the adapters/ directory.
+ * Wraps the user's code in an IIFE that captures the result (sync or async)
+ * into globalThis.__openTabs.__lastExecResult for the extension to read back.
+ *
+ * Returns the filename (relative to adapters/) for the extension to inject.
+ */
+declare const writeExecFile: (execId: string, code: string) => Promise<string>;
+/** Delete a dynamic exec script file. Fire-and-forget — logs on failure. */
+declare const deleteExecFile: (filename: string) => Promise<void>;
+/**
+ * Remove stale __exec-*.js files from the adapters directory.
+ * Called on server startup to clean up leftovers from crashed sessions.
+ */
+declare const cleanupStaleExecFiles: () => Promise<void>;
+/**
+ * Send extension.reload JSON-RPC request to trigger chrome.runtime.reload()
+ * in the connected extension. Used when the server detects that the managed
+ * extension files were updated (version change).
+ */
+declare const sendExtensionReload: (state: ServerState) => boolean;
+export type { McpCallbacks };
+export { sendSyncFull, dispatchToExtension, sendInvocationStart, sendInvocationEnd, sendConfirmationRequest, rejectAllPendingConfirmations, sendPluginUpdate, handleExtensionMessage, isDispatchError, writeAdapterFile, writeExecFile, deleteExecFile, cleanupStaleExecFiles, sendExtensionReload, };
+//# sourceMappingURL=extension-protocol.d.ts.map

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

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