@hypothesi/tauri-mcp-server 0.11.0 → 0.11.1

package/dist/constants.d.ts

@@ -0,0 +1 @@
+export declare const SETUP_INSTRUCTIONS: string;

package/dist/constants.js

@@ -0,0 +1,67 @@
+import { PLUGIN_VERSION_CARGO } from './version.js';
+export const SETUP_INSTRUCTIONS = `Help me set up or update the MCP Bridge plugin in my Tauri project.
+
+## IMPORTANT: Do Not Act Without Permission
+
+**You must NOT make any changes to files without my explicit approval.**
+
+1. First, examine my project to understand its current state
+2. Then, present a clear summary of what changes are needed
+3. Wait for my approval before making ANY modifications
+4. Only proceed with changes after I confirm
+
+## Prerequisites Check
+
+First, verify this is a Tauri v2 project:
+- Look for \`src-tauri/\` directory and \`tauri.conf.json\`
+- If this is NOT a Tauri project, stop and let me know this setup only applies to Tauri apps
+
+## What to Check
+
+Examine these files and report what needs to be added or updated:
+
+### 1. Rust Plugin Dependency
+Check \`src-tauri/Cargo.toml\` for \`tauri-plugin-mcp-bridge\`. If missing or outdated, note that it needs:
+\`\`\`toml
+[dependencies]
+tauri-plugin-mcp-bridge = "${PLUGIN_VERSION_CARGO}"
+\`\`\`
+
+### 2. Plugin Registration
+Check \`src-tauri/src/lib.rs\` or \`src-tauri/src/main.rs\` for plugin registration. It should have:
+\`\`\`rust
+#[cfg(debug_assertions)]
+{
+    builder = builder.plugin(tauri_plugin_mcp_bridge::init());
+}
+\`\`\`
+
+### 3. Global Tauri Setting
+Check \`src-tauri/tauri.conf.json\` for \`withGlobalTauri: true\` under the \`app\` section.
+**This is required** - without it, the MCP bridge cannot communicate with the webview.
+
+### 4. Plugin Permissions
+Check \`src-tauri/capabilities/default.json\` (or similar) for \`"mcp-bridge:default"\` permission.
+
+## Your Response Format
+
+After examining the project, respond with:
+
+1. **Current State**: What's already configured correctly
+2. **Changes Needed**: A numbered list of specific changes required
+3. **Ask for Permission**: "May I proceed with these changes?"
+
+Only after I say yes should you make any modifications.
+
+## After Setup
+
+Once changes are approved and made:
+1. Run the Tauri app in development mode (\`cargo tauri dev\`)
+2. Use \`driver_session\` with action "start" to connect
+3. Use \`driver_session\` with action "status" to verify
+
+## Notes
+
+- The plugin only runs in debug builds so it won't affect production
+- The WebSocket server binds to \`0.0.0.0:9223\` by default
+- For localhost-only access, use \`Builder::new().bind_address("127.0.0.1").build()\``;

package/dist/driver/element-picker.js

@@ -10,7 +10,7 @@ import { executeInWebview, executeAsyncInWebview } from './webview-executor.js';
 import { ensureSessionAndConnect } from './plugin-client.js';
 import { SCRIPTS, buildScript } from './scripts/index.js';
 import { WindowTargetSchema } from './webview-interactions.js';
-import { getHtml2CanvasSource, HTML2CANVAS_SCRIPT_ID, } from './scripts/html2canvas-loader.js';
+import { getHtml2CanvasSource, HTML2CANVAS_SCRIPT_ID, HTML2CANVAS_RESOLVER_SCRIPT, HTML2CANVAS_OPTIONS_SCRIPT, } from './scripts/html2canvas-loader.js';
 import { registerScript, isScriptRegistered } from './script-manager.js';
 // ============================================================================
 // Schemas
@@ -114,28 +114,14 @@ async function captureElementScreenshot(cssSelector, windowId, appIdentifier) {
     const escapedSelector = cssSelector.replace(/\\/g, '\\\\').replace(/'/g, '\\\'');
     // Build a script that captures just the element with html2canvas
     const captureScript = `
-      const html2canvasFn = typeof html2canvas !== 'undefined' ? html2canvas :
-                           (typeof window !== 'undefined' && window.html2canvas) ? window.html2canvas :
-                           (typeof self !== 'undefined' && self.html2canvas) ? self.html2canvas :
-                           (typeof globalThis !== 'undefined' && globalThis.html2canvas) ? globalThis.html2canvas : null;
-
-      if (!html2canvasFn) {
-         throw new Error('html2canvas not loaded');
-      }
+      ${HTML2CANVAS_RESOLVER_SCRIPT}
 
       const el = document.querySelector('${escapedSelector}');
       if (!el) {
          throw new Error('Element not found for screenshot');
       }
 
-      const canvas = await html2canvasFn(el, {
-         backgroundColor: null,
-         scale: window.devicePixelRatio || 1,
-         logging: false,
-         useCORS: true,
-         allowTaint: false,
-         imageTimeout: 5000,
-      });
+      const canvas = await html2canvasFn(el, ${HTML2CANVAS_OPTIONS_SCRIPT});
 
       if (!canvas) {
          throw new Error('html2canvas returned null canvas');
@@ -168,6 +154,23 @@ async function captureElementScreenshot(cssSelector, windowId, appIdentifier) {
         return null;
     }
 }
+/**
+ * Common helper to format an element and capture its screenshot.
+ */
+async function buildElementContent(element, windowId, appIdentifier) {
+    const content = [];
+    // Add formatted metadata
+    content.push({ type: 'text', text: formatElementMetadata(element) });
+    // Capture element-only screenshot (no picker overlays visible)
+    const screenshot = await captureElementScreenshot(element.cssSelector, windowId, appIdentifier);
+    if (screenshot) {
+        content.push(screenshot);
+    }
+    else {
+        content.push({ type: 'text', text: '(Element screenshot capture failed)' });
+    }
+    return content;
+}
 // ============================================================================
 // selectElement - Agent-initiated picker
 // ============================================================================
@@ -217,18 +220,7 @@ export async function selectElement(options) {
     }
     // Clean up all picker UI BEFORE taking the screenshot
     await cleanupPickerHighlights(windowId, appIdentifier);
-    const content = [];
-    // Add formatted metadata
-    content.push({ type: 'text', text: formatElementMetadata(element) });
-    // Capture element-only screenshot (no picker overlays visible)
-    const screenshot = await captureElementScreenshot(element.cssSelector, windowId, appIdentifier);
-    if (screenshot) {
-        content.push(screenshot);
-    }
-    else {
-        content.push({ type: 'text', text: '(Element screenshot capture failed)' });
-    }
-    return content;
+    return buildElementContent(element, windowId, appIdentifier);
 }
 // ============================================================================
 // getPointedElement - Retrieve user-pointed element
@@ -257,16 +249,5 @@ export async function getPointedElement(options) {
     catch {
         return [{ type: 'text', text: `Failed to parse pointed element data: ${raw.substring(0, 200)}` }];
     }
-    const content = [];
-    // Add formatted metadata
-    content.push({ type: 'text', text: formatElementMetadata(element) });
-    // Capture element-only screenshot (no overlays)
-    const screenshot = await captureElementScreenshot(element.cssSelector, windowId, appIdentifier);
-    if (screenshot) {
-        content.push(screenshot);
-    }
-    else {
-        content.push({ type: 'text', text: '(Element screenshot capture failed)' });
-    }
-    return content;
+    return buildElementContent(element, windowId, appIdentifier);
 }

package/dist/driver/scripts/html2canvas-loader.d.ts

@@ -13,6 +13,8 @@ export declare const HTML2CANVAS_SCRIPT_ID = "__mcp_html2canvas__";
  * Loaded lazily and cached.
  */
 export declare function getHtml2CanvasSource(): string;
+export declare const HTML2CANVAS_RESOLVER_SCRIPT = "\n      // Get the html2canvas function (may be on window, self, or globalThis)\n      const html2canvasFn = typeof html2canvas !== 'undefined' ? html2canvas :\n                           (typeof window !== 'undefined' && window.html2canvas) ? window.html2canvas :\n                           (typeof self !== 'undefined' && self.html2canvas) ? self.html2canvas :\n                           (typeof globalThis !== 'undefined' && globalThis.html2canvas) ? globalThis.html2canvas : null;\n\n      if (!html2canvasFn) {\n         throw new Error('html2canvas not loaded');\n      }\n";
+export declare const HTML2CANVAS_OPTIONS_SCRIPT = "{\n         backgroundColor: null,\n         scale: window.devicePixelRatio || 1,\n         logging: false,\n         useCORS: true,\n         allowTaint: false,\n         imageTimeout: 5000,\n      }";
 /**
  * Build a script that captures a screenshot using html2canvas.
  * Assumes html2canvas is already loaded (either via script manager or inline).

package/dist/driver/scripts/html2canvas-loader.js

@@ -30,13 +30,7 @@ export function getHtml2CanvasSource() {
     }
     return html2canvasProSource;
 }
-/**
- * Build a script that captures a screenshot using html2canvas.
- * Assumes html2canvas is already loaded (either via script manager or inline).
- */
-export function buildScreenshotCaptureScript(format, quality) {
-    // Note: This script is wrapped by executeAsyncInWebview, so we don't need an IIFE
-    return `
+export const HTML2CANVAS_RESOLVER_SCRIPT = `
       // Get the html2canvas function (may be on window, self, or globalThis)
       const html2canvasFn = typeof html2canvas !== 'undefined' ? html2canvas :
                            (typeof window !== 'undefined' && window.html2canvas) ? window.html2canvas :
@@ -44,27 +38,34 @@ export function buildScreenshotCaptureScript(format, quality) {
                            (typeof globalThis !== 'undefined' && globalThis.html2canvas) ? globalThis.html2canvas : null;
 
       if (!html2canvasFn) {
-         throw new Error('html2canvas not loaded - function not found on any global');
+         throw new Error('html2canvas not loaded');
       }
-
-      // Capture the entire document
-      const element = document.documentElement;
-      if (!element) {
-         throw new Error('document.documentElement is null');
-      }
-
-      // Configure html2canvas options
-      const options = {
+`;
+export const HTML2CANVAS_OPTIONS_SCRIPT = `{
          backgroundColor: null,
          scale: window.devicePixelRatio || 1,
          logging: false,
          useCORS: true,
          allowTaint: false,
          imageTimeout: 5000,
-      };
+      }`;
+/**
+ * Build a script that captures a screenshot using html2canvas.
+ * Assumes html2canvas is already loaded (either via script manager or inline).
+ */
+export function buildScreenshotCaptureScript(format, quality) {
+    // Note: This script is wrapped by executeAsyncInWebview, so we don't need an IIFE
+    return `
+      ${HTML2CANVAS_RESOLVER_SCRIPT}
+
+      // Capture the entire document
+      const element = document.documentElement;
+      if (!element) {
+         throw new Error('document.documentElement is null');
+      }
 
       // Capture the webview
-      const canvas = await html2canvasFn(element, options);
+      const canvas = await html2canvasFn(element, ${HTML2CANVAS_OPTIONS_SCRIPT});
       if (!canvas) {
          throw new Error('html2canvas returned null canvas');
       }

package/dist/driver/scripts/index.js

@@ -106,17 +106,20 @@ export function buildKeyEventScript(action, key, modifiers = []) {
 
          const activeElement = document.activeElement || document.body;
 
+         const modStr = modifiers.length ? ' with ' + modifiers.join('+') : '';
+         const dispatch = (type) => activeElement.dispatchEvent(new KeyboardEvent(type, eventOptions));
+
          if (action === 'press') {
-            activeElement.dispatchEvent(new KeyboardEvent('keydown', eventOptions));
-            activeElement.dispatchEvent(new KeyboardEvent('keypress', eventOptions));
-            activeElement.dispatchEvent(new KeyboardEvent('keyup', eventOptions));
-            return 'Pressed key: ' + key + (modifiers.length ? ' with ' + modifiers.join('+') : '');
+            dispatch('keydown');
+            dispatch('keypress');
+            dispatch('keyup');
+            return 'Pressed key: ' + key + modStr;
          } else if (action === 'down') {
-            activeElement.dispatchEvent(new KeyboardEvent('keydown', eventOptions));
-            return 'Key down: ' + key + (modifiers.length ? ' with ' + modifiers.join('+') : '');
+            dispatch('keydown');
+            return 'Key down: ' + key + modStr;
          } else if (action === 'up') {
-            activeElement.dispatchEvent(new KeyboardEvent('keyup', eventOptions));
-            return 'Key up: ' + key + (modifiers.length ? ' with ' + modifiers.join('+') : '');
+            dispatch('keyup');
+            return 'Key up: ' + key + modStr;
          }
 
          throw new Error('Unknown action: ' + action);

package/dist/prompts-registry.js

@@ -2,7 +2,7 @@
  * Single source of truth for all MCP prompt definitions
  * Prompts are user-controlled templates that appear as slash commands in MCP clients
  */
-import { PLUGIN_VERSION_CARGO } from './version.js';
+import { SETUP_INSTRUCTIONS as SETUP_PROMPT } from './constants.js';
 const FIX_WEBVIEW_ERRORS_PROMPT = `I need help finding and fixing JavaScript errors in my Tauri app's webview.
 
 Please follow these steps:
@@ -25,72 +25,6 @@ Please follow these steps:
 If no errors are found, let me know the app is running cleanly.
 
 If the session fails to start, help me troubleshoot the connection (is the app running? is the MCP bridge plugin installed?).`;
-const SETUP_PROMPT = `Help me set up or update the MCP Bridge plugin in my Tauri project.
-
-## IMPORTANT: Do Not Act Without Permission
-
-**You must NOT make any changes to files without my explicit approval.**
-
-1. First, examine my project to understand its current state
-2. Then, present a clear summary of what changes are needed
-3. Wait for my approval before making ANY modifications
-4. Only proceed with changes after I confirm
-
-## Prerequisites Check
-
-First, verify this is a Tauri v2 project:
-- Look for \`src-tauri/\` directory and \`tauri.conf.json\`
-- If this is NOT a Tauri project, stop and let me know this setup only applies to Tauri apps
-
-## What to Check
-
-Examine these files and report what needs to be added or updated:
-
-### 1. Rust Plugin Dependency
-Check \`src-tauri/Cargo.toml\` for \`tauri-plugin-mcp-bridge\`. If missing or outdated, note that it needs:
-\`\`\`toml
-[dependencies]
-tauri-plugin-mcp-bridge = "${PLUGIN_VERSION_CARGO}"
-\`\`\`
-
-### 2. Plugin Registration
-Check \`src-tauri/src/lib.rs\` or \`src-tauri/src/main.rs\` for plugin registration. It should have:
-\`\`\`rust
-#[cfg(debug_assertions)]
-{
-    builder = builder.plugin(tauri_plugin_mcp_bridge::init());
-}
-\`\`\`
-
-### 3. Global Tauri Setting
-Check \`src-tauri/tauri.conf.json\` for \`withGlobalTauri: true\` under the \`app\` section.
-**This is required** - without it, the MCP bridge cannot communicate with the webview.
-
-### 4. Plugin Permissions
-Check \`src-tauri/capabilities/default.json\` (or similar) for \`"mcp-bridge:default"\` permission.
-
-## Your Response Format
-
-After examining the project, respond with:
-
-1. **Current State**: What's already configured correctly
-2. **Changes Needed**: A numbered list of specific changes required
-3. **Ask for Permission**: "May I proceed with these changes?"
-
-Only after I say yes should you make any modifications.
-
-## After Setup
-
-Once changes are approved and made:
-1. Run the Tauri app in development mode (\`cargo tauri dev\`)
-2. Use \`driver_session\` with action "start" to connect
-3. Use \`driver_session\` with action "status" to verify
-
-## Notes
-
-- The plugin only runs in debug builds so it won't affect production
-- The WebSocket server binds to \`0.0.0.0:9223\` by default
-- For localhost-only access, use \`Builder::new().bind_address("127.0.0.1").build()\``;
 const SELECT_ELEMENT_PROMPT = (message) => {
     const lines = [
         'The user wants to visually select an element in their running Tauri app so they can discuss it with you.',

package/dist/tools-registry.js

@@ -9,7 +9,7 @@ import { readLogs, ReadLogsSchema } from './monitor/logs.js';
 import { executeIPCCommand, manageIPCMonitoring, getIPCEvents, emitTestEvent, getBackendState, manageWindow, ExecuteIPCCommandSchema, ManageIPCMonitoringSchema, GetIPCEventsSchema, EmitTestEventSchema, GetBackendStateSchema, ManageWindowSchema, } from './driver/plugin-commands.js';
 import { interact, screenshot, keyboard, waitFor, getStyles, executeJavaScript, findElement, domSnapshot, InteractSchema, ScreenshotSchema, KeyboardSchema, WaitForSchema, GetStylesSchema, ExecuteJavaScriptSchema, FindElementSchema, DomSnapshotSchema, } from './driver/webview-interactions.js';
 import { selectElement, getPointedElement, SelectElementSchema, GetPointedElementSchema, } from './driver/element-picker.js';
-import { PLUGIN_VERSION_CARGO } from './version.js';
+import { SETUP_INSTRUCTIONS } from './constants.js';
 /**
  * Standard multi-app description for webview tools.
  */
@@ -24,76 +24,6 @@ export const TOOL_CATEGORIES = {
     UI_AUTOMATION: 'UI Automation & WebView Interaction',
     IPC_PLUGIN: 'IPC & Plugin Tools (via MCP Bridge)',
 };
-// Setup instructions for the MCP Bridge plugin
-const SETUP_INSTRUCTIONS = `# MCP Bridge Plugin Setup Instructions
-
-Use these instructions to set up or update the MCP Bridge plugin in a Tauri v2 project.
-
-## IMPORTANT: Do Not Act Without Permission
-
-**You must NOT make any changes to files without the user's explicit approval.**
-
-1. First, examine the project to understand its current state
-2. Then, present a clear summary of what changes are needed
-3. Wait for user approval before making ANY modifications
-4. Only proceed with changes after they confirm
-
-## Prerequisites Check
-
-First, verify this is a Tauri v2 project:
-- Look for \`src-tauri/\` directory and \`tauri.conf.json\`
-- If this is NOT a Tauri project, stop and let the user know this setup only applies to Tauri apps
-
-## What to Check
-
-Examine these files and report what needs to be added or updated:
-
-### 1. Rust Plugin Dependency
-Check \`src-tauri/Cargo.toml\` for \`tauri-plugin-mcp-bridge\`. If missing or outdated, note that it needs:
-\`\`\`toml
-[dependencies]
-tauri-plugin-mcp-bridge = "${PLUGIN_VERSION_CARGO}"
-\`\`\`
-
-### 2. Plugin Registration
-Check \`src-tauri/src/lib.rs\` or \`src-tauri/src/main.rs\` for plugin registration. It should have:
-\`\`\`rust
-#[cfg(debug_assertions)]
-{
-    builder = builder.plugin(tauri_plugin_mcp_bridge::init());
-}
-\`\`\`
-
-### 3. Global Tauri Setting
-Check \`src-tauri/tauri.conf.json\` for \`withGlobalTauri: true\` under the \`app\` section.
-**This is required** - without it, the MCP bridge cannot communicate with the webview.
-
-### 4. Plugin Permissions
-Check \`src-tauri/capabilities/default.json\` (or similar) for \`"mcp-bridge:default"\` permission.
-
-## Response Format
-
-After examining the project, respond with:
-
-1. **Current State**: What's already configured correctly
-2. **Changes Needed**: A numbered list of specific changes required
-3. **Ask for Permission**: "May I proceed with these changes?"
-
-Only after the user says yes should you make any modifications.
-
-## After Setup
-
-Once changes are approved and made:
-1. Run the Tauri app in development mode (\`cargo tauri dev\`)
-2. Use \`driver_session\` with action "start" to connect
-3. Use \`driver_session\` with action "status" to verify
-
-## Notes
-
-- The plugin only runs in debug builds so it won't affect production
-- The WebSocket server binds to \`0.0.0.0:9223\` by default
-- For localhost-only access, use \`Builder::new().bind_address("127.0.0.1").build()\`
-`;
 /**
  * Complete registry of all available tools
  * This is the single source of truth for tool definitions

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hypothesi/tauri-mcp-server",
-  "version": "0.11.0",
+  "version": "0.11.1",
   "mcpName": "io.github.hypothesi/mcp-server-tauri",
   "description": "A Model Context Protocol server for use with Tauri v2 applications",
   "type": "module",