@hypothesi/tauri-mcp-server 0.8.3 → 0.10.0

package/dist/driver/plugin-commands.d.ts

@@ -0,0 +1,163 @@
+import { z } from 'zod';
+export declare const ExecuteIPCCommandSchema: z.ZodObject<{
+    command: z.ZodString;
+    args: z.ZodOptional<z.ZodUnknown>;
+    appIdentifier: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+}, "strip", z.ZodTypeAny, {
+    command: string;
+    appIdentifier?: string | number | undefined;
+    args?: unknown;
+}, {
+    command: string;
+    appIdentifier?: string | number | undefined;
+    args?: unknown;
+}>;
+export declare function executeIPCCommand(options: {
+    command: string;
+    args?: unknown;
+    appIdentifier?: string | number;
+}): Promise<string>;
+export declare const ManageIPCMonitoringSchema: z.ZodObject<{
+    action: z.ZodEnum<["start", "stop"]>;
+    appIdentifier: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+}, "strip", z.ZodTypeAny, {
+    action: "start" | "stop";
+    appIdentifier?: string | number | undefined;
+}, {
+    action: "start" | "stop";
+    appIdentifier?: string | number | undefined;
+}>;
+export declare const StartIPCMonitoringSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const StopIPCMonitoringSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare function manageIPCMonitoring(action: 'start' | 'stop', appIdentifier?: string | number): Promise<string>;
+export declare function startIPCMonitoring(appIdentifier?: string | number): Promise<string>;
+export declare function stopIPCMonitoring(appIdentifier?: string | number): Promise<string>;
+export declare const GetIPCEventsSchema: z.ZodObject<{
+    filter: z.ZodOptional<z.ZodString>;
+    appIdentifier: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+}, "strip", z.ZodTypeAny, {
+    filter?: string | undefined;
+    appIdentifier?: string | number | undefined;
+}, {
+    filter?: string | undefined;
+    appIdentifier?: string | number | undefined;
+}>;
+export declare function getIPCEvents(filter?: string, appIdentifier?: string | number): Promise<string>;
+export declare const EmitTestEventSchema: z.ZodObject<{
+    eventName: z.ZodString;
+    payload: z.ZodUnknown;
+    appIdentifier: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+}, "strip", z.ZodTypeAny, {
+    eventName: string;
+    appIdentifier?: string | number | undefined;
+    payload?: unknown;
+}, {
+    eventName: string;
+    appIdentifier?: string | number | undefined;
+    payload?: unknown;
+}>;
+export declare function emitTestEvent(eventName: string, payload: unknown, appIdentifier?: string | number): Promise<string>;
+export declare const GetWindowInfoSchema: z.ZodObject<{
+    appIdentifier: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+}, "strip", z.ZodTypeAny, {
+    appIdentifier?: string | number | undefined;
+}, {
+    appIdentifier?: string | number | undefined;
+}>;
+export declare function getWindowInfo(appIdentifier?: string | number): Promise<string>;
+export declare const GetBackendStateSchema: z.ZodObject<{
+    appIdentifier: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+}, "strip", z.ZodTypeAny, {
+    appIdentifier?: string | number | undefined;
+}, {
+    appIdentifier?: string | number | undefined;
+}>;
+/**
+ * Get backend state from the connected Tauri app.
+ *
+ * This function can work in two modes:
+ * 1. Normal mode: Requires an active session (for MCP tool calls)
+ * 2. Setup mode: Uses existing connected client (for session setup)
+ *
+ * @param useExistingClient If true, uses the existing connected client without
+ *        session validation. Used during session setup before currentSession is set.
+ */
+export declare function getBackendState(options?: {
+    useExistingClient?: boolean;
+    appIdentifier?: string | number;
+}): Promise<string>;
+export declare const ListWindowsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+/**
+ * Lists all open webview windows in the Tauri application.
+ */
+export declare function listWindows(appIdentifier?: string | number): Promise<string>;
+export declare const ResizeWindowSchema: z.ZodObject<{
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    windowId: z.ZodOptional<z.ZodString>;
+    logical: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    width: number;
+    height: number;
+    logical: boolean;
+    windowId?: string | undefined;
+}, {
+    width: number;
+    height: number;
+    windowId?: string | undefined;
+    logical?: boolean | undefined;
+}>;
+/**
+ * Resizes a window to the specified dimensions.
+ *
+ * @param options - Resize options including width, height, and optional windowId
+ * @returns JSON string with the result of the resize operation
+ */
+export declare function resizeWindow(options: {
+    width: number;
+    height: number;
+    windowId?: string;
+    logical?: boolean;
+    appIdentifier?: string | number;
+}): Promise<string>;
+export declare const ManageWindowSchema: z.ZodObject<{
+    action: z.ZodEnum<["list", "info", "resize"]>;
+    windowId: z.ZodOptional<z.ZodString>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    logical: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    appIdentifier: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+}, "strip", z.ZodTypeAny, {
+    action: "list" | "info" | "resize";
+    logical: boolean;
+    windowId?: string | undefined;
+    appIdentifier?: string | number | undefined;
+    width?: number | undefined;
+    height?: number | undefined;
+}, {
+    action: "list" | "info" | "resize";
+    windowId?: string | undefined;
+    appIdentifier?: string | number | undefined;
+    width?: number | undefined;
+    height?: number | undefined;
+    logical?: boolean | undefined;
+}>;
+/**
+ * Unified window management function.
+ *
+ * Actions:
+ * - `list`: List all open webview windows with their labels, titles, URLs, and state
+ * - `info`: Get detailed info for a window (size, position, title, focus, visibility)
+ * - `resize`: Resize a window to specified dimensions
+ *
+ * @param options - Action and parameters
+ * @returns JSON string with the result
+ */
+export declare function manageWindow(options: {
+    action: 'list' | 'info' | 'resize';
+    windowId?: string;
+    width?: number;
+    height?: number;
+    logical?: boolean;
+    appIdentifier?: string | number;
+}): Promise<string>;

package/dist/driver/protocol.d.ts

@@ -0,0 +1,128 @@
+/**
+ * WebSocket protocol types for communication between MCP server and Tauri plugin
+ *
+ * This file defines the message format for the WebSocket-based communication
+ * between the Node.js MCP server and the Rust Tauri plugin.
+ */
+/** Commands that can be sent to the Tauri plugin */
+export type PluginCommandType = 'execute_command' | 'get_window_info' | 'get_backend_state' | 'emit_event' | 'start_ipc_monitor' | 'stop_ipc_monitor' | 'get_ipc_events' | 'execute_js' | 'capture_native_screenshot';
+/** Request message sent from MCP server to Tauri plugin */
+export interface PluginRequest {
+    id: string;
+    command: PluginCommandType;
+    args?: unknown;
+}
+/** Response message sent from Tauri plugin to MCP server */
+export interface PluginResponse {
+    id: string;
+    success: boolean;
+    data?: unknown;
+    error?: string;
+}
+/** Event broadcast from Tauri plugin (not in response to a request) */
+export interface PluginEvent {
+    type: 'ipc_event' | 'console_log' | 'error' | 'element_picked' | 'element_pointed';
+    payload: unknown;
+    timestamp?: string;
+}
+/** Structured info about a parent element in the DOM ancestry */
+export interface ParentElementInfo {
+    tag: string;
+    id: string | null;
+    classes: string[];
+    boundingRect: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+}
+/** Metadata collected about a picked/pointed DOM element */
+export interface ElementMetadata {
+    tag: string;
+    id: string | null;
+    classes: string[];
+    attributes: Record<string, string>;
+    textContent: string;
+    boundingRect: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+    cssSelector: string;
+    xpath: string;
+    computedStyles: Record<string, string>;
+    parentChain: ParentElementInfo[];
+    timestamp: number;
+}
+/** Broadcast message for element picker events */
+export interface ElementPickerBroadcast {
+    type: 'element_picked' | 'element_pointed';
+    payload: {
+        pickerId?: string;
+        element?: ElementMetadata;
+        cancelled?: boolean;
+    };
+}
+/** IPC event captured by the monitor */
+export interface IPCEvent {
+    command: string;
+    args?: unknown;
+    response?: unknown;
+    duration?: number;
+    timestamp: string;
+}
+/** Window information returned by get_window_info */
+export interface WindowInfo {
+    width: number;
+    height: number;
+    x: number;
+    y: number;
+    title: string;
+    focused: boolean;
+    visible: boolean;
+}
+/** Backend state returned by get_backend_state */
+export interface BackendState {
+    app: {
+        name: string;
+        identifier: string;
+        version: string;
+    };
+    tauri: {
+        version: string;
+    };
+    environment: {
+        debug: boolean;
+        os: string;
+        arch: string;
+        family: string;
+    };
+    windows: Array<{
+        label: string;
+        title: string;
+        focused: boolean;
+        visible: boolean;
+    }>;
+    window_count: number;
+    timestamp: number;
+}
+/** Console log entry */
+export interface ConsoleLogEntry {
+    level: 'log' | 'info' | 'warn' | 'error' | 'debug';
+    message: string;
+    timestamp: string;
+    source?: string;
+}
+/** Screenshot result */
+export interface ScreenshotResult {
+    data: string;
+    format: 'png' | 'jpeg';
+    width?: number;
+    height?: number;
+}

package/dist/driver/script-manager.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Script Manager - Manages persistent script injection across page navigations.
+ *
+ * This module provides functions to register, remove, and manage scripts that
+ * should be automatically re-injected when pages load or navigate.
+ *
+ * @internal This module is for internal use only and is not exposed as MCP tools.
+ */
+/**
+ * Type of script to inject.
+ */
+export type ScriptType = 'inline' | 'url';
+/**
+ * A script entry in the registry.
+ */
+export interface ScriptEntry {
+    /** Unique identifier for this script. */
+    id: string;
+    /** Type of script (inline code or external URL). */
+    type: ScriptType;
+    /** The script content (JavaScript code) or URL. */
+    content: string;
+}
+/**
+ * Response from script registration.
+ */
+interface RegisterScriptResponse {
+    registered: boolean;
+    scriptId: string;
+}
+/**
+ * Response from script removal.
+ */
+interface RemoveScriptResponse {
+    removed: boolean;
+    scriptId: string;
+}
+/**
+ * Response from clearing scripts.
+ */
+interface ClearScriptsResponse {
+    cleared: number;
+}
+/**
+ * Response from getting scripts.
+ */
+interface GetScriptsResponse {
+    scripts: ScriptEntry[];
+}
+/**
+ * Registers a script to be injected into the webview.
+ *
+ * The script will be immediately injected if the page is loaded, and will be
+ * automatically re-injected on subsequent page loads/navigations.
+ *
+ * @param id - Unique identifier for the script
+ * @param type - Type of script ('inline' for code, 'url' for external script)
+ * @param content - The script content (JavaScript code) or URL
+ * @param windowLabel - Optional window label to target
+ * @returns Promise resolving to registration result
+ */
+export declare function registerScript(id: string, type: ScriptType, content: string, windowLabel?: string): Promise<RegisterScriptResponse>;
+/**
+ * Removes a script from the registry and DOM.
+ *
+ * @param id - The script ID to remove
+ * @param windowLabel - Optional window label to target
+ * @returns Promise resolving to removal result
+ */
+export declare function removeScript(id: string, windowLabel?: string): Promise<RemoveScriptResponse>;
+/**
+ * Clears all registered scripts from the registry and DOM.
+ *
+ * @param windowLabel - Optional window label to target
+ * @returns Promise resolving to the number of scripts cleared
+ */
+export declare function clearScripts(windowLabel?: string): Promise<ClearScriptsResponse>;
+/**
+ * Gets all registered scripts.
+ *
+ * @returns Promise resolving to the list of registered scripts
+ */
+export declare function getScripts(): Promise<GetScriptsResponse>;
+/**
+ * Checks if a script with the given ID is registered.
+ *
+ * @param id - The script ID to check
+ * @returns Promise resolving to true if the script is registered
+ */
+export declare function isScriptRegistered(id: string): Promise<boolean>;
+export {};

package/dist/driver/scripts/aria-api-loader.d.ts

@@ -0,0 +1,17 @@
+/**
+ * aria-api library loader
+ *
+ * Bundles aria-api for browser injection. Provides comprehensive W3C-compliant
+ * accessibility computation including:
+ * - WAI-ARIA 1.3 role computation
+ * - HTML-AAM 1.0 implicit role mappings
+ * - Accessible Name and Description Computation 1.2
+ * - aria-owns relationship handling
+ */
+/** Script ID used for the aria-api library in the script registry. */
+export declare const ARIA_API_SCRIPT_ID = "__mcp_aria_api__";
+/**
+ * Get the aria-api library source code.
+ * Loaded lazily and cached.
+ */
+export declare function getAriaApiSource(): string;