appium-desktop-driver 1.2.0

package/build/lib/mcp/config.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = loadConfig;
+function loadConfig() {
+    const appiumPort = parseInt(process.env.APPIUM_PORT ?? '4723', 10);
+    if (isNaN(appiumPort) || appiumPort < 1 || appiumPort > 65535) {
+        throw new Error(`APPIUM_PORT must be a valid port number (1-65535), got: '${process.env.APPIUM_PORT}'`);
+    }
+    return {
+        appiumHost: process.env.APPIUM_HOST ?? '127.0.0.1',
+        appiumPort,
+    };
+}
+//# sourceMappingURL=config.js.map

package/build/lib/mcp/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../lib/mcp/config.ts"],"names":[],"mappings":";;AAMA,gCAUC;AAVD,SAAgB,UAAU;IACtB,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;IACnE,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,GAAG,KAAK,EAAE,CAAC;QAC5D,MAAM,IAAI,KAAK,CAAC,4DAA4D,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,CAAC,CAAC;IAC5G,CAAC;IAED,OAAO;QACH,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,WAAW;QAClD,UAAU;KACb,CAAC;AACN,CAAC"}

package/build/lib/mcp/constants.d.ts

@@ -0,0 +1,3 @@
+/** W3C WebDriver element reference key */
+export declare const ELEMENT_KEY = "element-6066-11e4-a52e-4f735466cecf";
+//# sourceMappingURL=constants.d.ts.map

package/build/lib/mcp/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../lib/mcp/constants.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,eAAO,MAAM,WAAW,wCAAwC,CAAC"}

package/build/lib/mcp/constants.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ELEMENT_KEY = void 0;
+/** W3C WebDriver element reference key */
+exports.ELEMENT_KEY = 'element-6066-11e4-a52e-4f735466cecf';
+//# sourceMappingURL=constants.js.map

package/build/lib/mcp/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../lib/mcp/constants.ts"],"names":[],"mappings":";;;AAAA,0CAA0C;AAC7B,QAAA,WAAW,GAAG,qCAAqC,CAAC"}

package/build/lib/mcp/errors.d.ts

@@ -0,0 +1,2 @@
+export declare function formatError(err: unknown): string;
+//# sourceMappingURL=errors.d.ts.map

package/build/lib/mcp/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../lib/mcp/errors.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAGhD"}

package/build/lib/mcp/errors.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatError = formatError;
+function formatError(err) {
+    if (err instanceof Error) {
+        return `${err.constructor.name}: ${err.message}`;
+    }
+    return String(err);
+}
+//# sourceMappingURL=errors.js.map

package/build/lib/mcp/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../lib/mcp/errors.ts"],"names":[],"mappings":";;AAAA,kCAGC;AAHD,SAAgB,WAAW,CAAC,GAAY;IACpC,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QAAA,OAAO,GAAG,GAAG,CAAC,WAAW,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC;IAAA,CAAC;IAC7E,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC"}

package/build/lib/mcp/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/build/lib/mcp/index.d.ts.map

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

package/build/lib/mcp/index.js

@@ -0,0 +1,113 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const http = __importStar(require("node:http"));
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const config_js_1 = require("./config.js");
+const session_js_1 = require("./session.js");
+const index_js_1 = require("./tools/index.js");
+function checkAppiumReachable(host, port) {
+    return new Promise((resolve) => {
+        const req = http.get({ hostname: host, port, path: '/status', timeout: 3000 }, (res) => {
+            let body = '';
+            res.on('data', (chunk) => { body += chunk; });
+            res.on('end', () => {
+                try {
+                    resolve(JSON.parse(body)?.value?.ready === true);
+                }
+                catch {
+                    resolve(false);
+                }
+            });
+        });
+        req.on('error', () => resolve(false));
+        req.on('timeout', () => { req.destroy(); resolve(false); });
+    });
+}
+async function main() {
+    // Step 1: Load infrastructure config (host, port — no app required)
+    let config;
+    try {
+        config = (0, config_js_1.loadConfig)();
+    }
+    catch (err) {
+        process.stderr.write(`[MCP] Configuration error: ${err instanceof Error ? err.message : String(err)}\n`);
+        process.exit(1);
+    }
+    // Step 2: Verify Appium is reachable
+    const { appiumHost: host, appiumPort: port } = config;
+    if (!await checkAppiumReachable(host, port)) {
+        process.stderr.write(`[MCP] Appium is not running on ${host}:${port}.\n` +
+            `Start it first with: appium --port ${port}\n`);
+        process.exit(1);
+    }
+    process.stderr.write(`[MCP] Appium detected on ${host}:${port}\n`);
+    // Step 3: Create session holder (no app launched yet — agent calls create_session)
+    const session = new session_js_1.AppiumSession(config);
+    // Step 4: Create and configure MCP server
+    const server = new mcp_js_1.McpServer({
+        name: 'novawindows-mcp',
+        version: '1.3.0',
+    });
+    // Step 5: Register all tools (including create_session / delete_session)
+    (0, index_js_1.registerAllTools)(server, session);
+    // Step 6: Shutdown handler
+    let shuttingDown = false;
+    async function shutdown(reason) {
+        if (shuttingDown) {
+            return;
+        }
+        shuttingDown = true;
+        process.stderr.write(`[MCP] Shutting down (${reason})...\n`);
+        if (session.isActive()) {
+            await Promise.race([
+                session.delete(),
+                new Promise((resolve) => setTimeout(resolve, 10_000)),
+            ]);
+        }
+        process.exit(0);
+    }
+    process.on('SIGINT', () => { shutdown('SIGINT'); });
+    process.on('SIGTERM', () => { shutdown('SIGTERM'); });
+    process.stdin.on('end', () => { shutdown('stdin closed'); });
+    // Step 7: Connect transport (stdout is owned by MCP protocol — all logs go to stderr)
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    process.stderr.write('[MCP] novawindows-mcp server ready. Call create_session to launch an app.\n');
+}
+main();
+//# sourceMappingURL=index.js.map

package/build/lib/mcp/index.js.map

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

package/build/lib/mcp/session.d.ts

@@ -0,0 +1,24 @@
+import type { Browser } from 'webdriverio';
+import type { McpConfig } from './config.js';
+/** Session parameters provided by the agent via the create_session tool. */
+export interface SessionParams {
+    app: string;
+    appArguments?: string;
+    appWorkingDir?: string;
+    waitForAppLaunch?: number;
+    shouldCloseApp?: boolean;
+    implicitTimeout?: number;
+    delayAfterClick?: number;
+    delayBeforeClick?: number;
+    smoothPointerMove?: string;
+}
+export declare class AppiumSession {
+    private readonly appiumConfig;
+    private driver;
+    constructor(appiumConfig: McpConfig);
+    create(params: SessionParams): Promise<void>;
+    delete(): Promise<void>;
+    isActive(): boolean;
+    getDriver(): Browser;
+}
+//# sourceMappingURL=session.d.ts.map

package/build/lib/mcp/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../lib/mcp/session.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,4EAA4E;AAC5E,MAAM,WAAW,aAAa;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,qBAAa,aAAa;IAGV,OAAO,CAAC,QAAQ,CAAC,YAAY;IAFzC,OAAO,CAAC,MAAM,CAAwB;gBAET,YAAY,EAAE,SAAS;IAE9C,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAgC5C,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAY7B,QAAQ,IAAI,OAAO;IAInB,SAAS,IAAI,OAAO;CAIvB"}

package/build/lib/mcp/session.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppiumSession = void 0;
+const webdriverio_1 = require("webdriverio");
+class AppiumSession {
+    appiumConfig;
+    driver = null;
+    constructor(appiumConfig) {
+        this.appiumConfig = appiumConfig;
+    }
+    async create(params) {
+        if (this.driver) {
+            throw new Error('A session is already active. Call delete_session first.');
+        }
+        process.stderr.write(`[MCP] Creating Appium session for app: ${params.app}\n`);
+        const caps = {
+            platformName: 'Windows',
+            'appium:automationName': 'DesktopDriver',
+            'appium:app': params.app,
+        };
+        if (params.appArguments !== undefined) {
+            caps['appium:appArguments'] = params.appArguments;
+        }
+        if (params.appWorkingDir !== undefined) {
+            caps['appium:appWorkingDir'] = params.appWorkingDir;
+        }
+        if (params.waitForAppLaunch !== undefined) {
+            caps['appium:waitForAppLaunch'] = params.waitForAppLaunch;
+        }
+        if (params.shouldCloseApp !== undefined) {
+            caps['appium:shouldCloseApp'] = params.shouldCloseApp;
+        }
+        if (params.delayAfterClick !== undefined) {
+            caps['appium:delayAfterClick'] = params.delayAfterClick;
+        }
+        if (params.delayBeforeClick !== undefined) {
+            caps['appium:delayBeforeClick'] = params.delayBeforeClick;
+        }
+        if (params.smoothPointerMove !== undefined) {
+            caps['appium:smoothPointerMove'] = params.smoothPointerMove;
+        }
+        this.driver = await (0, webdriverio_1.remote)({
+            hostname: this.appiumConfig.appiumHost,
+            port: this.appiumConfig.appiumPort,
+            path: '/',
+            capabilities: caps,
+        });
+        await this.driver.setTimeout({ implicit: params.implicitTimeout });
+        process.stderr.write('[MCP] Session created successfully\n');
+    }
+    async delete() {
+        if (!this.driver) {
+            return;
+        }
+        try {
+            await this.driver.deleteSession();
+            process.stderr.write('[MCP] Session deleted\n');
+        }
+        catch (err) {
+            process.stderr.write(`[MCP] Warning: session delete failed: ${err}\n`);
+        }
+        finally {
+            this.driver = null;
+        }
+    }
+    isActive() {
+        return this.driver !== null;
+    }
+    getDriver() {
+        if (!this.driver) {
+            throw new Error('No active session. Call create_session first.');
+        }
+        return this.driver;
+    }
+}
+exports.AppiumSession = AppiumSession;
+//# sourceMappingURL=session.js.map

package/build/lib/mcp/session.js.map

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

package/build/lib/mcp/tools/advanced.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AppiumSession } from '../session.js';
+export declare function registerAdvancedTools(server: McpServer, session: AppiumSession): void;
+//# sourceMappingURL=advanced.d.ts.map

package/build/lib/mcp/tools/advanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced.d.ts","sourceRoot":"","sources":["../../../../lib/mcp/tools/advanced.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAKnD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAkIrF"}

package/build/lib/mcp/tools/advanced.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAdvancedTools = registerAdvancedTools;
+const zod_1 = require("zod");
+const errors_js_1 = require("../errors.js");
+const modifierKeys = zod_1.z.array(zod_1.z.enum(['shift', 'ctrl', 'alt', 'win'])).default([]);
+function registerAdvancedTools(server, session) {
+    server.registerTool('advanced_click', {
+        description: 'Perform an advanced click with modifier keys, multiple clicks, or custom duration. Use this for right-click, Ctrl+click, double-click, etc.',
+        annotations: { destructiveHint: false },
+        inputSchema: {
+            elementId: zod_1.z.string().optional().describe('Element to click (its center). Provide either elementId or x+y.'),
+            x: zod_1.z.number().int().optional().describe('Absolute screen x coordinate'),
+            y: zod_1.z.number().int().optional().describe('Absolute screen y coordinate'),
+            button: zod_1.z.enum(['left', 'right', 'middle', 'back', 'forward']).default('left'),
+            modifierKeys,
+            durationMs: zod_1.z.number().int().min(0).default(0).describe('Hold duration in ms (for long-press)'),
+            times: zod_1.z.number().int().min(1).default(1).describe('Number of clicks (2 = double-click)'),
+            interClickDelayMs: zod_1.z.number().int().min(0).default(100),
+        },
+    }, async (args) => {
+        try {
+            const driver = session.getDriver();
+            await driver.executeScript('windows: click', [args]);
+            return { content: [{ type: 'text', text: 'clicked' }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: (0, errors_js_1.formatError)(err) }] };
+        }
+    });
+    server.registerTool('send_keys', {
+        description: 'Send keyboard input. Each action can be a pause (ms delay), text to type, or a virtual key code press/release.',
+        annotations: { destructiveHint: false },
+        inputSchema: {
+            actions: zod_1.z.array(zod_1.z.object({
+                pause: zod_1.z.number().int().optional().describe('Pause in milliseconds'),
+                text: zod_1.z.string().optional().describe('Text to type (unicode supported)'),
+                virtualKeyCode: zod_1.z.number().int().optional().describe('Windows Virtual Key code (e.g. 13 = Enter, 27 = Escape)'),
+                down: zod_1.z.boolean().optional().describe('true = key down only, false = key up only, omit = press and release'),
+            })).describe('Sequence of keyboard actions to perform'),
+            forceUnicode: zod_1.z.boolean().default(false).describe('Use Unicode input method for special characters'),
+        },
+    }, async (args) => {
+        try {
+            const driver = session.getDriver();
+            await driver.executeScript('windows: keys', [args]);
+            return { content: [{ type: 'text', text: 'keys sent' }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: (0, errors_js_1.formatError)(err) }] };
+        }
+    });
+    server.registerTool('hover', {
+        description: 'Move the mouse pointer from one position to another, optionally with modifier keys held. Useful for hover effects and drag-without-click.',
+        inputSchema: {
+            startElementId: zod_1.z.string().optional().describe('Element to start hover from (uses element center)'),
+            startX: zod_1.z.number().int().optional(),
+            startY: zod_1.z.number().int().optional(),
+            endElementId: zod_1.z.string().optional().describe('Element to hover to'),
+            endX: zod_1.z.number().int().optional(),
+            endY: zod_1.z.number().int().optional(),
+            modifierKeys,
+            durationMs: zod_1.z.number().int().min(0).default(500).describe('Duration of the hover movement in ms'),
+        },
+    }, async (args) => {
+        try {
+            const driver = session.getDriver();
+            await driver.executeScript('windows: hover', [args]);
+            return { content: [{ type: 'text', text: 'hovered' }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: (0, errors_js_1.formatError)(err) }] };
+        }
+    });
+    server.registerTool('scroll', {
+        description: 'Scroll the mouse wheel at an element or screen coordinate.',
+        inputSchema: {
+            elementId: zod_1.z.string().optional().describe('Element to scroll over (uses element center)'),
+            x: zod_1.z.number().int().optional().describe('Absolute screen x coordinate'),
+            y: zod_1.z.number().int().optional().describe('Absolute screen y coordinate'),
+            deltaX: zod_1.z.number().int().default(0).describe('Horizontal scroll amount (positive = right)'),
+            deltaY: zod_1.z.number().int().default(0).describe('Vertical scroll amount (positive = down)'),
+            modifierKeys,
+        },
+    }, async (args) => {
+        try {
+            const driver = session.getDriver();
+            await driver.executeScript('windows: scroll', [args]);
+            return { content: [{ type: 'text', text: 'scrolled' }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: (0, errors_js_1.formatError)(err) }] };
+        }
+    });
+    server.registerTool('click_and_drag', {
+        description: 'Click and drag from one position to another. Useful for resizing, reordering, or moving elements.',
+        inputSchema: {
+            startElementId: zod_1.z.string().optional().describe('Element to start drag from'),
+            startX: zod_1.z.number().int().optional(),
+            startY: zod_1.z.number().int().optional(),
+            endElementId: zod_1.z.string().optional().describe('Element to drag to'),
+            endX: zod_1.z.number().int().optional(),
+            endY: zod_1.z.number().int().optional(),
+            modifierKeys,
+            durationMs: zod_1.z.number().int().min(0).default(500),
+            button: zod_1.z.enum(['left', 'right', 'middle']).default('left'),
+        },
+    }, async (args) => {
+        try {
+            const driver = session.getDriver();
+            await driver.executeScript('windows: clickAndDrag', [args]);
+            return { content: [{ type: 'text', text: 'drag completed' }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: (0, errors_js_1.formatError)(err) }] };
+        }
+    });
+}
+//# sourceMappingURL=advanced.js.map

package/build/lib/mcp/tools/advanced.js.map

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

package/build/lib/mcp/tools/app.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AppiumSession } from '../session.js';
+export declare function registerAppTools(server: McpServer, session: AppiumSession): void;
+//# sourceMappingURL=app.d.ts.map

package/build/lib/mcp/tools/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../../../lib/mcp/tools/app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAyEhF"}

package/build/lib/mcp/tools/app.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAppTools = registerAppTools;
+const errors_js_1 = require("../errors.js");
+function registerAppTools(server, session) {
+    server.registerTool('get_window_element', {
+        description: 'Get the root UI element of the current app window. Returns an element ID that represents the top-level window.',
+        annotations: { readOnlyHint: true },
+    }, async () => {
+        try {
+            const driver = session.getDriver();
+            const result = await driver.executeScript('windows: getWindowElement', [{}]);
+            const ref = result;
+            const elementId = ref['element-6066-11e4-a52e-4f735466cecf'] ?? ref.ELEMENT;
+            if (!elementId) {
+                throw new Error(`windows: getWindowElement returned unexpected value: ${JSON.stringify(result)}`);
+            }
+            return { content: [{ type: 'text', text: elementId }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: (0, errors_js_1.formatError)(err) }] };
+        }
+    });
+    server.registerTool('launch_app', {
+        description: 'Launch the application configured for this session (re-launch if it was closed).',
+        annotations: { destructiveHint: false },
+    }, async () => {
+        try {
+            const driver = session.getDriver();
+            await driver.executeScript('windows: launchApp', [{}]);
+            return { content: [{ type: 'text', text: 'app launched' }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: (0, errors_js_1.formatError)(err) }] };
+        }
+    });
+    server.registerTool('close_app', {
+        description: 'Close the application under test without ending the session.',
+        annotations: { destructiveHint: true },
+    }, async () => {
+        try {
+            const driver = session.getDriver();
+            await driver.executeScript('windows: closeApp', [{}]);
+            return { content: [{ type: 'text', text: 'app closed' }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: (0, errors_js_1.formatError)(err) }] };
+        }
+    });
+    server.registerTool('get_device_time', {
+        description: 'Get the current date/time on the Windows device.',
+        annotations: { readOnlyHint: true },
+    }, async () => {
+        try {
+            const driver = session.getDriver();
+            const result = await driver.executeScript('windows: getDeviceTime', [{}]);
+            return { content: [{ type: 'text', text: String(result) }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: (0, errors_js_1.formatError)(err) }] };
+        }
+    });
+}
+//# sourceMappingURL=app.js.map

package/build/lib/mcp/tools/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../../../lib/mcp/tools/app.ts"],"names":[],"mappings":";;AAIA,4CAyEC;AA3ED,4CAA2C;AAE3C,SAAgB,gBAAgB,CAAC,MAAiB,EAAE,OAAsB;IACtE,MAAM,CAAC,YAAY,CACf,oBAAoB,EACpB;QACI,WAAW,EAAE,gHAAgH;QAC7H,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACtC,EACD,KAAK,IAAI,EAAE;QACP,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,2BAA2B,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YAC7E,MAAM,GAAG,GAAG,MAAgC,CAAC;YAC7C,MAAM,SAAS,GAAG,GAAG,CAAC,qCAAqC,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC;YAC5E,IAAI,CAAC,SAAS,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,wDAAwD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACtG,CAAC;YACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;QACrE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAA,uBAAW,EAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;QAC3F,CAAC;IACL,CAAC,CACJ,CAAC;IAEF,MAAM,CAAC,YAAY,CACf,YAAY,EACZ;QACI,WAAW,EAAE,kFAAkF;QAC/F,WAAW,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE;KAC1C,EACD,KAAK,IAAI,EAAE;QACP,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;YACnC,MAAM,MAAM,CAAC,aAAa,CAAC,oBAAoB,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YACvD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;QAC1E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAA,uBAAW,EAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;QAC3F,CAAC;IACL,CAAC,CACJ,CAAC;IAEF,MAAM,CAAC,YAAY,CACf,WAAW,EACX;QACI,WAAW,EAAE,8DAA8D;QAC3E,WAAW,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;KACzC,EACD,KAAK,IAAI,EAAE;QACP,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;YACnC,MAAM,MAAM,CAAC,aAAa,CAAC,mBAAmB,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YACtD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;QACxE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAA,uBAAW,EAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;QAC3F,CAAC;IACL,CAAC,CACJ,CAAC;IAEF,MAAM,CAAC,YAAY,CACf,iBAAiB,EACjB;QACI,WAAW,EAAE,kDAAkD;QAC/D,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACtC,EACD,KAAK,IAAI,EAAE;QACP,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,wBAAwB,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YAC1E,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;QAC1E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAA,uBAAW,EAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;QAC3F,CAAC;IACL,CAAC,CACJ,CAAC;AACN,CAAC"}

package/build/lib/mcp/tools/clipboard.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AppiumSession } from '../session.js';
+export declare function registerClipboardTools(server: McpServer, session: AppiumSession): void;
+//# sourceMappingURL=clipboard.d.ts.map

package/build/lib/mcp/tools/clipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../../../../lib/mcp/tools/clipboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAKnD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAwCtF"}

package/build/lib/mcp/tools/clipboard.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerClipboardTools = registerClipboardTools;
+const zod_1 = require("zod");
+const errors_js_1 = require("../errors.js");
+const contentTypeSchema = zod_1.z.enum(['plaintext', 'image']).default('plaintext');
+function registerClipboardTools(server, session) {
+    server.registerTool('get_clipboard', {
+        description: 'Read the current clipboard contents as a base64-encoded string.',
+        inputSchema: {
+            contentType: contentTypeSchema.describe('"plaintext" for text, "image" for image content'),
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ contentType }) => {
+        try {
+            const driver = session.getDriver();
+            const result = await driver.executeScript('windows: getClipboard', [{ contentType }]);
+            return { content: [{ type: 'text', text: String(result) }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: (0, errors_js_1.formatError)(err) }] };
+        }
+    });
+    server.registerTool('set_clipboard', {
+        description: 'Set the clipboard contents from a base64-encoded string.',
+        inputSchema: {
+            b64Content: zod_1.z.string().min(1).describe('Base64-encoded content to set'),
+            contentType: contentTypeSchema.describe('"plaintext" for text, "image" for image content'),
+        },
+    }, async ({ b64Content, contentType }) => {
+        try {
+            const driver = session.getDriver();
+            await driver.executeScript('windows: setClipboard', [{ b64Content, contentType }]);
+            return { content: [{ type: 'text', text: 'clipboard set' }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: (0, errors_js_1.formatError)(err) }] };
+        }
+    });
+}
+//# sourceMappingURL=clipboard.js.map

package/build/lib/mcp/tools/clipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.js","sourceRoot":"","sources":["../../../../lib/mcp/tools/clipboard.ts"],"names":[],"mappings":";;AAOA,wDAwCC;AA9CD,6BAAwB;AAExB,4CAA2C;AAE3C,MAAM,iBAAiB,GAAG,OAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;AAE9E,SAAgB,sBAAsB,CAAC,MAAiB,EAAE,OAAsB;IAC5E,MAAM,CAAC,YAAY,CACf,eAAe,EACf;QACI,WAAW,EAAE,iEAAiE;QAC9E,WAAW,EAAE;YACT,WAAW,EAAE,iBAAiB,CAAC,QAAQ,CAAC,iDAAiD,CAAC;SAC7F;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KACtC,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;QACtB,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,uBAAuB,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;YACtF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;QAC1E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAA,uBAAW,EAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;QAC3F,CAAC;IACL,CAAC,CACJ,CAAC;IAEF,MAAM,CAAC,YAAY,CACf,eAAe,EACf;QACI,WAAW,EAAE,0DAA0D;QACvE,WAAW,EAAE;YACT,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,+BAA+B,CAAC;YACvE,WAAW,EAAE,iBAAiB,CAAC,QAAQ,CAAC,iDAAiD,CAAC;SAC7F;KACJ,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,EAAE,EAAE;QAClC,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;YACnC,MAAM,MAAM,CAAC,aAAa,CAAC,uBAAuB,EAAE,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;YACnF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC;QAC3E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAA,uBAAW,EAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;QAC3F,CAAC;IACL,CAAC,CACJ,CAAC;AACN,CAAC"}

package/build/lib/mcp/tools/find.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AppiumSession } from '../session.js';
+export declare function registerFindTools(server: McpServer, session: AppiumSession): void;
+//# sourceMappingURL=find.d.ts.map

package/build/lib/mcp/tools/find.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../../../lib/mcp/tools/find.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAkCnD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAkHjF"}