@opentabs-dev/mcp-server 0.0.21 → 0.0.24

package/dist/extension-handlers.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Extension WebSocket message handlers.
+ * Each handler processes a specific JSON-RPC method from the Chrome extension.
+ * Exported individually so they can be unit tested independently of the
+ * handleExtensionMessage router in extension-protocol.ts.
+ */
+import type { PluginLogEntry } from './log-buffer.js';
+import type { RegisteredPlugin, ServerState, TabMapping } from './state.js';
+import type { JsonRpcError, JsonRpcNotification, JsonRpcRequest, JsonRpcResult } from '@opentabs-dev/shared';
+/** Callbacks the extension protocol can invoke on the MCP side */
+interface McpCallbacks {
+    onToolConfigChanged: () => void;
+    onToolConfigPersist: () => void;
+    onPluginLog: (entry: PluginLogEntry) => void;
+    onReload: () => Promise<{
+        plugins: number;
+        durationMs: number;
+    }>;
+}
+/**
+ * Send a JSON-serialized message to the extension WebSocket if connected.
+ * Centralizes the null check on state.extensionWs so callers don't repeat it.
+ * Returns true if the message was sent, false if the extension is not connected.
+ */
+declare const sendToExtension: (state: ServerState, msg: JsonRpcNotification | JsonRpcResult | JsonRpcRequest | JsonRpcError) => boolean;
+/**
+ * Send a JSON-RPC error response to the extension.
+ * Shorthand for the common pattern of sending { jsonrpc: '2.0', error: { code, message }, id }.
+ */
+declare const sendJsonRpcError: (state: ServerState, id: string | number, code: number, message: string) => void;
+/**
+ * Extract error details from a caught plugin management error and send a JSON-RPC error response.
+ * Handles code, message, data, and retryAfterMs fields that plugin management functions may throw.
+ */
+declare const sendPluginManagementError: (state: ServerState, id: string | number, err: unknown) => void;
+/**
+ * Serialize a plugin's metadata and tools into the wire format sent to the extension.
+ * Returns the common core shape shared by sync.full, plugin.update, and config.getState.
+ * Callers can spread additional fields on top (e.g., sourcePath, adapterHash for sync messages,
+ * or tabState, source, sdkVersion for config.getState).
+ */
+declare const serializePluginForExtension: (plugin: RegisteredPlugin, state: ServerState) => {
+    name: string;
+    version: string;
+    displayName: string;
+    urlPatterns: string[];
+    trustTier: string;
+    iconSvg?: string;
+    iconInactiveSvg?: string;
+    tools: {
+        name: string;
+        displayName: string;
+        description: string;
+        icon: string;
+        iconSvg?: string;
+        iconInactiveSvg?: string;
+        enabled: boolean;
+    }[];
+};
+/** Wire shape for tab mapping entries — all fields may be absent or wrong type */
+interface WireTabMapping {
+    state?: string;
+    tabId?: number | null;
+    url?: string | null;
+}
+declare const parseTabMapping: (wire: WireTabMapping) => TabMapping;
+declare const handleTabSyncAll: (state: ServerState, params: Record<string, unknown> | undefined) => void;
+declare const handleTabStateChanged: (state: ServerState, params: Record<string, unknown> | undefined, id?: string | number) => void;
+declare const handleConfigGetState: (state: ServerState, id: string | number) => void;
+declare const handleConfigSetToolEnabled: (state: ServerState, params: Record<string, unknown> | undefined, id: string | number, callbacks: McpCallbacks) => void;
+declare const handleConfigSetAllToolsEnabled: (state: ServerState, params: Record<string, unknown> | undefined, id: string | number, callbacks: McpCallbacks) => void;
+/**
+ * Handle tool.progress notification from the extension.
+ * Looks up the pending dispatch by dispatchId, invokes the onProgress callback
+ * to emit an MCP ProgressNotification to the client, and resets the dispatch
+ * timeout timer (the tool is alive). The timer reset is bounded by
+ * MAX_DISPATCH_TIMEOUT_MS — if the dispatch has been running longer than the
+ * absolute maximum, it is rejected immediately regardless of progress.
+ */
+declare const handleToolProgress: (state: ServerState, params: Record<string, unknown> | undefined) => void;
+/** Valid plugin log levels (matches MCP LoggingLevel subset used by the SDK) */
+declare const VALID_LOG_LEVELS: Set<string>;
+declare const handlePluginLog: (params: Record<string, unknown> | undefined, callbacks: McpCallbacks) => void;
+/**
+ * Handle a confirmation.response from the extension.
+ * Resolves the pending confirmation promise with the user's decision.
+ * For 'allow_always', also adds a session permission rule.
+ */
+declare const handleConfirmationResponse: (state: ServerState, params: Record<string, unknown> | undefined) => void;
+/**
+ * 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;
+declare const handlePluginSearch: (state: ServerState, params: Record<string, unknown> | undefined, id: string | number) => Promise<void>;
+declare const handlePluginInstall: (state: ServerState, params: Record<string, unknown> | undefined, id: string | number, callbacks: McpCallbacks) => Promise<void>;
+declare const handlePluginUpdateFromRegistry: (state: ServerState, params: Record<string, unknown> | undefined, id: string | number, callbacks: McpCallbacks) => Promise<void>;
+declare const handlePluginRemove: (state: ServerState, params: Record<string, unknown> | undefined, id: string | number, callbacks: McpCallbacks) => Promise<void>;
+declare const handlePluginCheckUpdates: (state: ServerState, id: string | number) => Promise<void>;
+export type { McpCallbacks, WireTabMapping };
+export { sendToExtension, sendJsonRpcError, sendPluginManagementError, serializePluginForExtension, parseTabMapping, VALID_LOG_LEVELS, handleTabSyncAll, handleTabStateChanged, handleConfigGetState, handleConfigSetToolEnabled, handleConfigSetAllToolsEnabled, handlePluginSearch, handlePluginInstall, handlePluginUpdateFromRegistry, handlePluginRemove, handlePluginCheckUpdates, handleToolProgress, handlePluginLog, handleConfirmationResponse, rejectAllPendingConfirmations, };
+//# sourceMappingURL=extension-handlers.d.ts.map

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

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

package/dist/extension-handlers.js

@@ -0,0 +1,443 @@
+/**
+ * Extension WebSocket message handlers.
+ * Each handler processes a specific JSON-RPC method from the Chrome extension.
+ * Exported individually so they can be unit tested independently of the
+ * handleExtensionMessage router in extension-protocol.ts.
+ */
+import { appendLog } from './log-buffer.js';
+import { log } from './logger.js';
+import { searchNpmPlugins, installPlugin, updatePlugin, removePlugin, checkPluginUpdates, } from './plugin-management.js';
+import { prefixedToolName, isToolEnabled, getNextRequestId, DISPATCH_TIMEOUT_MS, MAX_DISPATCH_TIMEOUT_MS, } from './state.js';
+/**
+ * Send a JSON-serialized message to the extension WebSocket if connected.
+ * Centralizes the null check on state.extensionWs so callers don't repeat it.
+ * Returns true if the message was sent, false if the extension is not connected.
+ */
+const sendToExtension = (state, msg) => {
+    if (!state.extensionWs)
+        return false;
+    try {
+        state.extensionWs.send(JSON.stringify(msg));
+        return true;
+    }
+    catch (err) {
+        log.warn('Failed to send to extension:', err);
+        return false;
+    }
+};
+/**
+ * Send a JSON-RPC error response to the extension.
+ * Shorthand for the common pattern of sending { jsonrpc: '2.0', error: { code, message }, id }.
+ */
+const sendJsonRpcError = (state, id, code, message) => {
+    sendToExtension(state, { jsonrpc: '2.0', error: { code, message }, id });
+};
+/**
+ * Extract error details from a caught plugin management error and send a JSON-RPC error response.
+ * Handles code, message, data, and retryAfterMs fields that plugin management functions may throw.
+ */
+const sendPluginManagementError = (state, id, err) => {
+    const code = typeof err.code === 'number' ? err.code : -32603;
+    const message = err instanceof Error ? err.message : 'Unknown error';
+    const rawData = err.data;
+    const data = typeof rawData === 'object' && rawData !== null ? rawData : undefined;
+    const retryAfterMs = typeof err.retryAfterMs === 'number'
+        ? err.retryAfterMs
+        : undefined;
+    const errorData = { ...(data ?? {}), ...(retryAfterMs !== undefined ? { retryAfterMs } : {}) };
+    const hasData = Object.keys(errorData).length > 0;
+    sendToExtension(state, {
+        jsonrpc: '2.0',
+        error: { code, message, ...(hasData ? { data: errorData } : {}) },
+        id,
+    });
+};
+/**
+ * Serialize a plugin's metadata and tools into the wire format sent to the extension.
+ * Returns the common core shape shared by sync.full, plugin.update, and config.getState.
+ * Callers can spread additional fields on top (e.g., sourcePath, adapterHash for sync messages,
+ * or tabState, source, sdkVersion for config.getState).
+ */
+const serializePluginForExtension = (plugin, state) => ({
+    name: plugin.name,
+    version: plugin.version,
+    displayName: plugin.displayName,
+    urlPatterns: plugin.urlPatterns,
+    trustTier: plugin.trustTier,
+    ...(plugin.iconSvg ? { iconSvg: plugin.iconSvg } : {}),
+    ...(plugin.iconInactiveSvg ? { iconInactiveSvg: plugin.iconInactiveSvg } : {}),
+    tools: plugin.tools.map(t => ({
+        name: t.name,
+        displayName: t.displayName,
+        description: t.description,
+        icon: t.icon,
+        ...(t.iconSvg ? { iconSvg: t.iconSvg } : {}),
+        ...(t.iconInactiveSvg ? { iconInactiveSvg: t.iconInactiveSvg } : {}),
+        enabled: isToolEnabled(state, prefixedToolName(plugin.name, t.name)),
+    })),
+});
+const parseTabMapping = (wire) => ({
+    state: wire.state === 'closed' || wire.state === 'unavailable' || wire.state === 'ready' ? wire.state : 'closed',
+    tabId: typeof wire.tabId === 'number' ? wire.tabId : null,
+    url: typeof wire.url === 'string' ? wire.url : null,
+});
+const handleTabSyncAll = (state, params) => {
+    if (!params)
+        return;
+    const tabSyncParams = params;
+    const tabs = tabSyncParams.tabs;
+    if (!tabs)
+        return;
+    state.tabMapping.clear();
+    for (const [pluginName, mapping] of Object.entries(tabs)) {
+        state.tabMapping.set(pluginName, parseTabMapping(mapping));
+    }
+    log.info(`tab.syncAll received — ${state.tabMapping.size} plugin(s) mapped`);
+};
+const handleTabStateChanged = (state, params, id) => {
+    const sendError = (message) => {
+        if (id !== undefined) {
+            sendJsonRpcError(state, id, -32602, message);
+        }
+        else {
+            log.warn(`tab.stateChanged: ${message}`);
+        }
+    };
+    if (!params) {
+        sendError('Missing params');
+        return;
+    }
+    const plugin = params.plugin;
+    if (typeof plugin !== 'string' || plugin.length === 0) {
+        sendError('Missing or invalid "plugin" field (expected non-empty string)');
+        return;
+    }
+    if (!state.registry.plugins.has(plugin)) {
+        sendError(`Unknown plugin: ${plugin}`);
+        return;
+    }
+    if (typeof params.state !== 'string') {
+        sendError('Missing or invalid "state" field (expected string)');
+        return;
+    }
+    if (params.state !== 'closed' && params.state !== 'unavailable' && params.state !== 'ready') {
+        sendError(`Invalid tab state: ${params.state} (expected closed, unavailable, or ready)`);
+        return;
+    }
+    const wire = {
+        state: params.state,
+        tabId: typeof params.tabId === 'number' ? params.tabId : null,
+        url: typeof params.url === 'string' ? params.url : null,
+    };
+    state.tabMapping.set(plugin, parseTabMapping(wire));
+    log.info(`tab.stateChanged: ${plugin} → ${wire.state ?? 'unknown'}`);
+};
+// --- Config handlers ---
+const handleConfigGetState = (state, id) => {
+    const outdatedByPkg = new Map(state.outdatedPlugins.map(o => [o.name, { latestVersion: o.latestVersion, updateCommand: o.updateCommand }]));
+    const plugins = Array.from(state.registry.plugins.values())
+        .sort((a, b) => a.name.localeCompare(b.name))
+        .map(p => {
+        const tabInfo = state.tabMapping.get(p.name);
+        const update = p.npmPackageName ? outdatedByPkg.get(p.npmPackageName) : undefined;
+        return {
+            ...serializePluginForExtension(p, state),
+            source: p.source,
+            tabState: tabInfo?.state ?? 'closed',
+            ...(p.sdkVersion ? { sdkVersion: p.sdkVersion } : {}),
+            ...(update ? { update } : {}),
+        };
+    });
+    sendToExtension(state, {
+        jsonrpc: '2.0',
+        result: {
+            plugins,
+            failedPlugins: state.discoveryErrors.map(e => ({ specifier: e.specifier, error: e.error })),
+        },
+        id,
+    });
+};
+const handleConfigSetToolEnabled = (state, params, id, callbacks) => {
+    if (!params) {
+        sendJsonRpcError(state, id, -32602, 'Missing params');
+        return;
+    }
+    const toolEnabledParams = params;
+    const pluginName = toolEnabledParams.plugin;
+    const tool = toolEnabledParams.tool;
+    const enabled = toolEnabledParams.enabled;
+    if (typeof pluginName !== 'string' || typeof tool !== 'string' || typeof enabled !== 'boolean') {
+        sendJsonRpcError(state, id, -32602, 'Invalid params: expected plugin (string), tool (string), enabled (boolean)');
+        return;
+    }
+    const plugin = state.registry.plugins.get(pluginName);
+    if (!plugin) {
+        sendJsonRpcError(state, id, -32602, `Plugin not found: ${pluginName}`);
+        return;
+    }
+    if (!plugin.tools.some(t => t.name === tool)) {
+        sendJsonRpcError(state, id, -32602, `Tool not found: ${tool} in plugin ${pluginName}`);
+        return;
+    }
+    const prefixed = prefixedToolName(pluginName, tool);
+    state.toolConfig[prefixed] = enabled;
+    callbacks.onToolConfigChanged();
+    callbacks.onToolConfigPersist();
+    sendToExtension(state, {
+        jsonrpc: '2.0',
+        result: { ok: true },
+        id,
+    });
+};
+const handleConfigSetAllToolsEnabled = (state, params, id, callbacks) => {
+    if (!params) {
+        sendJsonRpcError(state, id, -32602, 'Missing params');
+        return;
+    }
+    const allToolsEnabledParams = params;
+    const pluginName = allToolsEnabledParams.plugin;
+    const enabled = allToolsEnabledParams.enabled;
+    if (typeof pluginName !== 'string' || typeof enabled !== 'boolean') {
+        sendJsonRpcError(state, id, -32602, 'Invalid params: expected plugin (string), enabled (boolean)');
+        return;
+    }
+    const plugin = state.registry.plugins.get(pluginName);
+    if (!plugin) {
+        sendJsonRpcError(state, id, -32602, `Plugin not found: ${pluginName}`);
+        return;
+    }
+    for (const tool of plugin.tools) {
+        const prefixed = prefixedToolName(pluginName, tool.name);
+        state.toolConfig[prefixed] = enabled;
+    }
+    callbacks.onToolConfigChanged();
+    callbacks.onToolConfigPersist();
+    sendToExtension(state, {
+        jsonrpc: '2.0',
+        result: { ok: true },
+        id,
+    });
+};
+// --- Tool progress handler ---
+/**
+ * Handle tool.progress notification from the extension.
+ * Looks up the pending dispatch by dispatchId, invokes the onProgress callback
+ * to emit an MCP ProgressNotification to the client, and resets the dispatch
+ * timeout timer (the tool is alive). The timer reset is bounded by
+ * MAX_DISPATCH_TIMEOUT_MS — if the dispatch has been running longer than the
+ * absolute maximum, it is rejected immediately regardless of progress.
+ */
+const handleToolProgress = (state, params) => {
+    if (!params)
+        return;
+    const dispatchId = params.dispatchId;
+    if (typeof dispatchId !== 'string')
+        return;
+    const progress = params.progress;
+    const total = params.total;
+    if (typeof progress !== 'number' || typeof total !== 'number')
+        return;
+    const message = typeof params.message === 'string' ? params.message : undefined;
+    const pending = state.pendingDispatches.get(dispatchId);
+    if (!pending)
+        return;
+    pending.lastProgressTs = Date.now();
+    // Forward the progress notification to the MCP client
+    if (pending.onProgress) {
+        try {
+            pending.onProgress(progress, total, message);
+        }
+        catch {
+            // Fire-and-forget — errors in the progress chain must not affect tool execution
+        }
+    }
+    // Reset the dispatch timeout — the tool is alive and making progress.
+    // Bounded by MAX_DISPATCH_TIMEOUT_MS from the dispatch start time.
+    clearTimeout(pending.timerId);
+    const elapsed = Date.now() - pending.startTs;
+    const remainingMax = MAX_DISPATCH_TIMEOUT_MS - elapsed;
+    if (remainingMax <= 0) {
+        // Absolute max exceeded — reject immediately
+        state.pendingDispatches.delete(dispatchId);
+        pending.reject(new Error(`Dispatch ${pending.label} exceeded absolute max timeout of ${MAX_DISPATCH_TIMEOUT_MS}ms`));
+        return;
+    }
+    const nextTimeout = Math.min(DISPATCH_TIMEOUT_MS, remainingMax);
+    pending.timerId = setTimeout(() => {
+        if (state.pendingDispatches.has(dispatchId)) {
+            state.pendingDispatches.delete(dispatchId);
+            pending.reject(new Error(`Dispatch ${pending.label} timed out after ${DISPATCH_TIMEOUT_MS}ms`));
+        }
+    }, nextTimeout);
+};
+// --- Plugin log handler ---
+/** Valid plugin log levels (matches MCP LoggingLevel subset used by the SDK) */
+const VALID_LOG_LEVELS = new Set(['debug', 'info', 'warning', 'error']);
+const handlePluginLog = (params, callbacks) => {
+    if (!params)
+        return;
+    const plugin = params.plugin;
+    const level = params.level;
+    const message = params.message;
+    if (typeof plugin !== 'string' || plugin.length === 0)
+        return;
+    if (typeof level !== 'string' || !VALID_LOG_LEVELS.has(level))
+        return;
+    if (typeof message !== 'string')
+        return;
+    const ts = typeof params.ts === 'string' ? params.ts : new Date().toISOString();
+    const entry = {
+        level,
+        plugin,
+        message,
+        data: params.data,
+        ts,
+    };
+    appendLog(plugin, entry);
+    callbacks.onPluginLog(entry);
+};
+// --- Confirmation handler ---
+/**
+ * Handle a confirmation.response from the extension.
+ * Resolves the pending confirmation promise with the user's decision.
+ * For 'allow_always', also adds a session permission rule.
+ */
+const handleConfirmationResponse = (state, params) => {
+    if (!params)
+        return;
+    const id = params.id;
+    if (typeof id !== 'string')
+        return;
+    const decision = params.decision;
+    if (decision !== 'allow_once' && decision !== 'allow_always' && decision !== 'deny')
+        return;
+    const pending = state.pendingConfirmations.get(id);
+    if (!pending)
+        return;
+    clearTimeout(pending.timerId);
+    state.pendingConfirmations.delete(id);
+    // For allow_always, add a session permission rule based on the scope
+    if (decision === 'allow_always') {
+        const scope = typeof params.scope === 'string' ? params.scope : 'tool_domain';
+        const rule = { tool: pending.tool, domain: pending.domain, scope };
+        // Adjust rule fields based on scope
+        if (scope === 'tool_all') {
+            rule.domain = null;
+        }
+        else if (scope === 'domain_all') {
+            rule.tool = null;
+        }
+        state.sessionPermissions.push(rule);
+    }
+    pending.resolve(decision);
+};
+/**
+ * Reject all pending confirmations. Called when the extension disconnects
+ * to clean up any confirmation promises that can no longer be fulfilled.
+ */
+const rejectAllPendingConfirmations = (state) => {
+    for (const [id, pending] of state.pendingConfirmations) {
+        clearTimeout(pending.timerId);
+        pending.reject(new Error('Extension disconnected — confirmation cancelled'));
+        state.pendingConfirmations.delete(id);
+    }
+};
+// --- Plugin management handlers ---
+const handlePluginSearch = async (state, params, id) => {
+    const query = params?.query;
+    if (query !== undefined && typeof query !== 'string') {
+        sendJsonRpcError(state, id, -32602, 'Invalid params: query must be a string if provided');
+        return;
+    }
+    try {
+        const results = await searchNpmPlugins(query ?? undefined);
+        sendToExtension(state, {
+            jsonrpc: '2.0',
+            result: { results },
+            id,
+        });
+    }
+    catch (err) {
+        sendPluginManagementError(state, id, err);
+    }
+};
+const handlePluginInstall = async (state, params, id, callbacks) => {
+    if (!params || typeof params.name !== 'string' || params.name.length === 0) {
+        sendJsonRpcError(state, id, -32602, 'Invalid params: name must be a non-empty string');
+        return;
+    }
+    try {
+        const result = await installPlugin(params.name, state, callbacks.onReload);
+        // Notify the side panel so the UI refreshes with the new plugin
+        sendToExtension(state, { jsonrpc: '2.0', method: 'plugins.changed', params: {} });
+        sendToExtension(state, {
+            jsonrpc: '2.0',
+            result,
+            id,
+        });
+    }
+    catch (err) {
+        sendPluginManagementError(state, id, err);
+    }
+};
+const handlePluginUpdateFromRegistry = async (state, params, id, callbacks) => {
+    if (!params || typeof params.name !== 'string' || params.name.length === 0) {
+        sendJsonRpcError(state, id, -32602, 'Invalid params: name must be a non-empty string');
+        return;
+    }
+    try {
+        const result = await updatePlugin(params.name, state, callbacks.onReload);
+        // Notify the side panel so the UI refreshes
+        sendToExtension(state, { jsonrpc: '2.0', method: 'plugins.changed', params: {} });
+        sendToExtension(state, {
+            jsonrpc: '2.0',
+            result,
+            id,
+        });
+    }
+    catch (err) {
+        sendPluginManagementError(state, id, err);
+    }
+};
+const handlePluginRemove = async (state, params, id, callbacks) => {
+    if (!params || typeof params.name !== 'string' || params.name.length === 0) {
+        sendJsonRpcError(state, id, -32602, 'Invalid params: name must be a non-empty string');
+        return;
+    }
+    try {
+        const pluginName = params.name;
+        const result = await removePlugin(pluginName, state, callbacks.onReload);
+        // Send plugin.uninstall to extension to clean up adapters in matching tabs
+        sendToExtension(state, {
+            jsonrpc: '2.0',
+            method: 'plugin.uninstall',
+            params: { name: pluginName },
+            id: getNextRequestId(),
+        });
+        // Notify the side panel so the UI refreshes
+        sendToExtension(state, { jsonrpc: '2.0', method: 'plugins.changed', params: {} });
+        sendToExtension(state, {
+            jsonrpc: '2.0',
+            result,
+            id,
+        });
+    }
+    catch (err) {
+        sendPluginManagementError(state, id, err);
+    }
+};
+const handlePluginCheckUpdates = async (state, id) => {
+    try {
+        const result = await checkPluginUpdates(state);
+        sendToExtension(state, {
+            jsonrpc: '2.0',
+            result,
+            id,
+        });
+    }
+    catch (err) {
+        sendPluginManagementError(state, id, err);
+    }
+};
+export { sendToExtension, sendJsonRpcError, sendPluginManagementError, serializePluginForExtension, parseTabMapping, VALID_LOG_LEVELS, handleTabSyncAll, handleTabStateChanged, handleConfigGetState, handleConfigSetToolEnabled, handleConfigSetAllToolsEnabled, handlePluginSearch, handlePluginInstall, handlePluginUpdateFromRegistry, handlePluginRemove, handlePluginCheckUpdates, handleToolProgress, handlePluginLog, handleConfirmationResponse, rejectAllPendingConfirmations, };
+//# sourceMappingURL=extension-handlers.js.map

package/dist/extension-handlers.js.map

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

package/dist/extension-protocol.d.ts

@@ -1,26 +1,14 @@
 /**
  * Extension WebSocket protocol handler.
- * Handles JSON-RPC messages between the MCP server and Chrome extension.
+ * Handles JSON-RPC dispatch mechanics and message routing between the MCP
+ * server and Chrome extension. Individual message handlers live in
+ * extension-handlers.ts.
  */
-import type { PluginLogEntry } from './log-buffer.js';
+import { writeAdapterFile, writeExecFile, deleteExecFile, cleanupStaleExecFiles } from './adapter-files.js';
+import { rejectAllPendingConfirmations } from './extension-handlers.js';
+import type { McpCallbacks } from './extension-handlers.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,
@@ -62,11 +50,6 @@ declare const sendInvocationEnd: (state: ServerState, plugin: string, tool: stri
  * @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,
@@ -104,21 +87,6 @@ declare const isDispatchError: (err: unknown) => err is {
     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