appium-mcp 0.0.1 → 1.1.5

package/dist/tests/generate-all-locators.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-all-locators.test.js","sourceRoot":"","sources":["../../src/tests/generate-all-locators.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EACL,0BAA0B,GAE3B,MAAM,sCAAsC,CAAC;AAE9C,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC1C,yBAAyB;IACzB,MAAM,SAAS,GAAG;;;;;;;;;;GAUjB,CAAC;IAEF,6BAA6B;IAC7B,MAAM,YAAY,GAAG;;;;;;;;;;GAUpB,CAAC;IAEF,IAAI,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACvD,wCAAwC;QACxC,MAAM,MAAM,GAAG,0BAA0B,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QAE3E,iCAAiC;QACjC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAEzC,gDAAgD;QAChD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YAC1B,MAAM,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;YAC1C,MAAM,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;YAC3C,MAAM,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;YACvC,MAAM,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;YAC9C,MAAM,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;YAC7C,MAAM,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;YAC5C,MAAM,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;YAC1C,MAAM,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC/D,2EAA2E;QAC3E,MAAM,MAAM,GAAG,0BAA0B,CACvC,yBAAyB,EACzB,IAAI,EACJ,cAAc,CACf,CAAC;QAEF,yEAAyE;QACzE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACzD,iCAAiC;QACjC,MAAM,MAAM,GAAG,0BAA0B,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE;YACzE,eAAe,EAAE,CAAC,uBAAuB,CAAC;SAC3C,CAAC,CAAC;QAEH,6EAA6E;QAC7E,kCAAkC;QAClC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CACtE,IAAI,CACL,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACzD,gDAAgD;QAChD,MAAM,MAAM,GAAG,0BAA0B,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE;YACzE,eAAe,EAAE,CAAC,uBAAuB,CAAC;SAC3C,CAAC,CAAC;QAEH,yCAAyC;QACzC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CACvE,IAAI,CACL,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,iDAAiD,EAAE,GAAG,EAAE;QAC3D,kDAAkD;QAClD,MAAM,MAAM,GAAG,0BAA0B,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE;YACzE,iBAAiB,EAAE,CAAC;SACrB,CAAC,CAAC;QAEH,iDAAiD;QACjD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,yFAAyF;YACzF,yEAAyE;YACzE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,mBAAmB,CACvC,0BAA0B,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC,MAAM,CACnE,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,gDAAgD,EAAE,GAAG,EAAE;QAC1D,8CAA8C;QAC9C,MAAM,MAAM,GAAG,0BAA0B,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE;YACzE,aAAa,EAAE,IAAI;SACpB,CAAC,CAAC;QAEH,wDAAwD;QACxD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,gBAAgB,GAAG;gBACvB,UAAU;gBACV,QAAQ;gBACR,aAAa;gBACb,UAAU;gBACV,aAAa;gBACb,QAAQ;gBACR,cAAc;gBACd,UAAU;aACX,CAAC;YAEF,MAAM,CACJ,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE;gBACrB,OAAO,CACL,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;oBAC3D,OAAO,CAAC,SAAS,KAAK,IAAI,CAC3B,CAAC;YACJ,CAAC,CAAC,CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACf,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACtD,sDAAsD;QACtD,MAAM,MAAM,GAAG,0BAA0B,CAAC,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE;YACxE,aAAa,EAAE,IAAI;SACpB,CAAC,CAAC;QAEH,4DAA4D;QAC5D,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,gBAAgB,GAAG;gBACvB,0BAA0B;gBAC1B,gCAAgC;gBAChC,uBAAuB;gBACvB,sBAAsB;gBACtB,uBAAuB;gBACvB,2BAA2B;gBAC3B,yBAAyB;gBACzB,qBAAqB;gBACrB,qBAAqB;aACtB,CAAC;YAEF,MAAM,CACJ,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE;gBACrB,OAAO,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;YACrE,CAAC,CAAC,CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACf,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACxD,8CAA8C;QAC9C,MAAM,MAAM,GAAG,0BAA0B,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE;YACzE,aAAa,EAAE,IAAI;SACpB,CAAC,CAAC;QAEH,oCAAoC;QACpC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tests/test-setup-wda.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/test-setup-wda.js

@@ -0,0 +1,202 @@
+/**
+ * Test file for setup-wda tool
+ * Run with: npx tsx src/tests/test-setup-wda.ts
+ */
+import path from 'path';
+import fs from 'fs';
+import os from 'os';
+import https from 'https';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+const execAsync = promisify(exec);
+// Mock server object to test the tool
+class MockServer {
+    constructor() {
+        this.tools = new Map();
+    }
+    addTool(tool) {
+        this.tools.set(tool.name, tool);
+        console.log(`✅ Tool registered: ${tool.name}`);
+    }
+    getTool(name) {
+        return this.tools.get(name);
+    }
+}
+async function downloadFile(url, destPath) {
+    return new Promise((resolve, reject) => {
+        const file = fs.createWriteStream(destPath);
+        https
+            .get(url, response => {
+            // Handle redirects
+            if (response.statusCode === 302 || response.statusCode === 301) {
+                file.close();
+                fs.unlinkSync(destPath);
+                return downloadFile(response.headers.location, destPath)
+                    .then(resolve)
+                    .catch(reject);
+            }
+            if (response.statusCode !== 200) {
+                file.close();
+                fs.unlinkSync(destPath);
+                return reject(new Error(`Failed to download: ${response.statusCode}`));
+            }
+            const totalSize = parseInt(response.headers['content-length'] || '0', 10);
+            let downloadedSize = 0;
+            response.on('data', chunk => {
+                downloadedSize += chunk.length;
+                const percent = ((downloadedSize / totalSize) * 100).toFixed(1);
+                process.stdout.write(`\r   Downloading... ${percent}% (${Math.round(downloadedSize / 1024 / 1024)}MB / ${Math.round(totalSize / 1024 / 1024)}MB)`);
+            });
+            response.pipe(file);
+            file.on('finish', () => {
+                file.close();
+                process.stdout.write('\n');
+                resolve();
+            });
+        })
+            .on('error', err => {
+            file.close();
+            fs.unlinkSync(destPath);
+            reject(err);
+        });
+    });
+}
+async function unzipFile(zipPath, destDir) {
+    console.log(`   Extracting to: ${destDir}`);
+    await execAsync(`unzip -q "${zipPath}" -d "${destDir}"`);
+    console.log('   ✅ Extraction complete');
+}
+function cachePath(folder) {
+    return path.join(os.homedir(), '.cache', 'appium-mcp', folder);
+}
+async function getLatestWDAVersion() {
+    return new Promise((resolve, reject) => {
+        const options = {
+            hostname: 'api.github.com',
+            path: '/repos/appium/WebDriverAgent/releases/latest',
+            method: 'GET',
+            headers: {
+                'User-Agent': 'mcp-appium-test',
+                Accept: 'application/vnd.github.v3+json',
+            },
+        };
+        https
+            .get(options, response => {
+            let data = '';
+            response.on('data', chunk => {
+                data += chunk;
+            });
+            response.on('end', () => {
+                try {
+                    const release = JSON.parse(data);
+                    if (release.tag_name) {
+                        // Remove 'v' prefix if present
+                        const version = release.tag_name.replace(/^v/, '');
+                        resolve(version);
+                    }
+                    else {
+                        reject(new Error('No tag_name found in release data'));
+                    }
+                }
+                catch (error) {
+                    reject(error);
+                }
+            });
+        })
+            .on('error', err => {
+            reject(err);
+        });
+    });
+}
+async function main() {
+    console.log('🧪 Testing WDA Download and Setup\n');
+    console.log('='.repeat(60));
+    try {
+        // Fetch latest WDA version from GitHub releases API
+        console.log('\n🔍 Fetching latest WDA version from GitHub...');
+        const wdaVersion = await getLatestWDAVersion();
+        console.log(`✅ Latest WDA Version: v${wdaVersion}`);
+        console.log('   Source: https://github.com/appium/WebDriverAgent/releases/latest');
+        // Create cache directory structure using home directory
+        const versionCacheDir = cachePath(`wda/${wdaVersion}`);
+        const extractDir = path.join(versionCacheDir, 'extracted');
+        const zipPath = path.join(versionCacheDir, 'WebDriverAgentRunner-Runner.zip');
+        const appPath = path.join(extractDir, 'WebDriverAgentRunner-Runner.app');
+        console.log('\n📁 Cache Directory:', versionCacheDir);
+        console.log(`   (~/.cache/appium-device-farm/wda/${wdaVersion})`);
+        // Check if this version is already cached
+        if (fs.existsSync(appPath)) {
+            console.log('\n✅ WDA version already cached! Skipping download.');
+            console.log(`   Location: ${appPath}`);
+            // Show app contents
+            const appContents = fs.readdirSync(appPath);
+            console.log('\n📋 Cached App bundle contents:');
+            appContents.forEach(item => {
+                console.log(`      - ${item}`);
+            });
+            console.log('\n' + '='.repeat(60));
+            console.log('🎉 Using cached WDA!');
+            console.log(`💡 Cache location: ${versionCacheDir}`);
+            return;
+        }
+        // Version not cached, proceed with download
+        console.log('\n⚠️  Version not found in cache. Downloading...');
+        // Create cache directories
+        fs.mkdirSync(versionCacheDir, { recursive: true });
+        fs.mkdirSync(extractDir, { recursive: true });
+        // Download URL
+        const downloadUrl = `https://github.com/appium/WebDriverAgent/releases/download/v${wdaVersion}/WebDriverAgentRunner-Runner.zip`;
+        console.log('\n⬇️  Downloading WDA from GitHub releases...');
+        console.log(`   URL: ${downloadUrl}`);
+        const startTime = Date.now();
+        await downloadFile(downloadUrl, zipPath);
+        const downloadTime = ((Date.now() - startTime) / 1000).toFixed(1);
+        console.log(`   ✅ Download complete (${downloadTime}s)`);
+        // Check file size
+        const stats = fs.statSync(zipPath);
+        const fileSizeMB = (stats.size / 1024 / 1024).toFixed(2);
+        console.log(`   📦 File size: ${fileSizeMB} MB`);
+        // Unzip the file
+        console.log('\n📂 Extracting WDA bundle...');
+        await unzipFile(zipPath, extractDir);
+        // List contents
+        console.log('\n📋 Extracted contents:');
+        const contents = fs.readdirSync(extractDir);
+        contents.forEach(item => {
+            const itemPath = path.join(extractDir, item);
+            const isDir = fs.statSync(itemPath).isDirectory();
+            console.log(`   ${isDir ? '📁' : '📄'} ${item}`);
+        });
+        // Check if WebDriverAgentRunner-Runner.app exists
+        if (fs.existsSync(appPath)) {
+            console.log('\n✅ WebDriverAgentRunner-Runner.app found!');
+            console.log(`   Location: ${appPath}`);
+            // Show app contents
+            const appContents = fs.readdirSync(appPath);
+            console.log('\n   App bundle contents:');
+            appContents.forEach(item => {
+                console.log(`      - ${item}`);
+            });
+        }
+        else {
+            console.log('\n⚠️  WebDriverAgentRunner-Runner.app not found');
+        }
+        console.log('\n' + '='.repeat(60));
+        console.log('🎉 Download and setup completed successfully!');
+        console.log(`\n💡 Cached location: ${versionCacheDir}`);
+        console.log('   This version will be reused on subsequent runs (no re-download needed)');
+    }
+    catch (error) {
+        console.error('\n❌ Test failed:', error.message);
+        if (error.stack) {
+            console.error('\nStack trace:', error.stack);
+        }
+        process.exit(1);
+    }
+}
+// Run main function
+main().catch(error => {
+    console.error('\n💥 Unexpected error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=test-setup-wda.js.map

package/dist/tests/test-setup-wda.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-setup-wda.js","sourceRoot":"","sources":["../../src/tests/test-setup-wda.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAEjC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAElC,sCAAsC;AACtC,MAAM,UAAU;IAAhB;QACU,UAAK,GAAqB,IAAI,GAAG,EAAE,CAAC;IAU9C,CAAC;IARC,OAAO,CAAC,IAAS;QACf,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,OAAO,CAAC,IAAY;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;CACF;AAED,KAAK,UAAU,YAAY,CAAC,GAAW,EAAE,QAAgB;IACvD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,IAAI,GAAG,EAAE,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAE5C,KAAK;aACF,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE;YACnB,mBAAmB;YACnB,IAAI,QAAQ,CAAC,UAAU,KAAK,GAAG,IAAI,QAAQ,CAAC,UAAU,KAAK,GAAG,EAAE,CAAC;gBAC/D,IAAI,CAAC,KAAK,EAAE,CAAC;gBACb,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;gBACxB,OAAO,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAS,EAAE,QAAQ,CAAC;qBACtD,IAAI,CAAC,OAAO,CAAC;qBACb,KAAK,CAAC,MAAM,CAAC,CAAC;YACnB,CAAC;YAED,IAAI,QAAQ,CAAC,UAAU,KAAK,GAAG,EAAE,CAAC;gBAChC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACb,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;gBACxB,OAAO,MAAM,CACX,IAAI,KAAK,CAAC,uBAAuB,QAAQ,CAAC,UAAU,EAAE,CAAC,CACxD,CAAC;YACJ,CAAC;YAED,MAAM,SAAS,GAAG,QAAQ,CACxB,QAAQ,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,GAAG,EACzC,EAAE,CACH,CAAC;YACF,IAAI,cAAc,GAAG,CAAC,CAAC;YAEvB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE;gBAC1B,cAAc,IAAI,KAAK,CAAC,MAAM,CAAC;gBAC/B,MAAM,OAAO,GAAG,CAAC,CAAC,cAAc,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBAChE,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,uBAAuB,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,IAAI,GAAG,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,GAAG,IAAI,CAAC,KAAK,CAC7H,CAAC;YACJ,CAAC,CAAC,CAAC;YAEH,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEpB,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;gBACrB,IAAI,CAAC,KAAK,EAAE,CAAC;gBACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC3B,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;aACD,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE;YACjB,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YACxB,MAAM,CAAC,GAAG,CAAC,CAAC;QACd,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,OAAe,EAAE,OAAe;IACvD,OAAO,CAAC,GAAG,CAAC,qBAAqB,OAAO,EAAE,CAAC,CAAC;IAC5C,MAAM,SAAS,CAAC,aAAa,OAAO,SAAS,OAAO,GAAG,CAAC,CAAC;IACzD,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,SAAS,CAAC,MAAc;IAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;AACjE,CAAC;AAED,KAAK,UAAU,mBAAmB;IAChC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,OAAO,GAAG;YACd,QAAQ,EAAE,gBAAgB;YAC1B,IAAI,EAAE,8CAA8C;YACpD,MAAM,EAAE,KAAK;YACb,OAAO,EAAE;gBACP,YAAY,EAAE,iBAAiB;gBAC/B,MAAM,EAAE,gCAAgC;aACzC;SACF,CAAC;QAEF,KAAK;aACF,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE;YACvB,IAAI,IAAI,GAAG,EAAE,CAAC;YAEd,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE;gBAC1B,IAAI,IAAI,KAAK,CAAC;YAChB,CAAC,CAAC,CAAC;YAEH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;gBACtB,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBACjC,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;wBACrB,+BAA+B;wBAC/B,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;wBACnD,OAAO,CAAC,OAAO,CAAC,CAAC;oBACnB,CAAC;yBAAM,CAAC;wBACN,MAAM,CAAC,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC,CAAC;oBACzD,CAAC;gBACH,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,CAAC,KAAK,CAAC,CAAC;gBAChB,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;aACD,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE;YACjB,MAAM,CAAC,GAAG,CAAC,CAAC;QACd,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;IACnD,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAE5B,IAAI,CAAC;QACH,oDAAoD;QACpD,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;QAC/D,MAAM,UAAU,GAAG,MAAM,mBAAmB,EAAE,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,0BAA0B,UAAU,EAAE,CAAC,CAAC;QACpD,OAAO,CAAC,GAAG,CACT,qEAAqE,CACtE,CAAC;QAEF,wDAAwD;QACxD,MAAM,eAAe,GAAG,SAAS,CAAC,OAAO,UAAU,EAAE,CAAC,CAAC;QACvD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CACvB,eAAe,EACf,iCAAiC,CAClC,CAAC;QACF,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,iCAAiC,CAAC,CAAC;QAEzE,OAAO,CAAC,GAAG,CAAC,uBAAuB,EAAE,eAAe,CAAC,CAAC;QACtD,OAAO,CAAC,GAAG,CAAC,uCAAuC,UAAU,GAAG,CAAC,CAAC;QAElE,0CAA0C;QAC1C,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,oDAAoD,CAAC,CAAC;YAClE,OAAO,CAAC,GAAG,CAAC,gBAAgB,OAAO,EAAE,CAAC,CAAC;YAEvC,oBAAoB;YACpB,MAAM,WAAW,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;YAChD,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;gBACzB,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;YACjC,CAAC,CAAC,CAAC;YAEH,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;YACpC,OAAO,CAAC,GAAG,CAAC,sBAAsB,eAAe,EAAE,CAAC,CAAC;YACrD,OAAO;QACT,CAAC;QAED,4CAA4C;QAC5C,OAAO,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC;QAEhE,2BAA2B;QAC3B,EAAE,CAAC,SAAS,CAAC,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE9C,eAAe;QACf,MAAM,WAAW,GAAG,+DAA+D,UAAU,kCAAkC,CAAC;QAEhI,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;QAC7D,OAAO,CAAC,GAAG,CAAC,WAAW,WAAW,EAAE,CAAC,CAAC;QAEtC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACzC,MAAM,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAElE,OAAO,CAAC,GAAG,CAAC,2BAA2B,YAAY,IAAI,CAAC,CAAC;QAEzD,kBAAkB;QAClB,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACnC,MAAM,UAAU,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACzD,OAAO,CAAC,GAAG,CAAC,oBAAoB,UAAU,KAAK,CAAC,CAAC;QAEjD,iBAAiB;QACjB,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;QAC7C,MAAM,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAErC,gBAAgB;QAChB,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,EAAE,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QAC5C,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;YACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YAC7C,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;YAClD,OAAO,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;QAEH,kDAAkD;QAClD,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;YAC1D,OAAO,CAAC,GAAG,CAAC,gBAAgB,OAAO,EAAE,CAAC,CAAC;YAEvC,oBAAoB;YACpB,MAAM,WAAW,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;YACzC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;gBACzB,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;YACjC,CAAC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;QACjE,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;QAC7D,OAAO,CAAC,GAAG,CAAC,yBAAyB,eAAe,EAAE,CAAC,CAAC;QACxD,OAAO,CAAC,GAAG,CACT,2EAA2E,CAC5E,CAAC;IACJ,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACjD,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,oBAAoB;AACpB,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;IAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools/answer-appium.d.ts

@@ -0,0 +1 @@
+export default function answerAppium(server: any): void;

package/dist/tools/answer-appium.js

@@ -0,0 +1,71 @@
+/**
+ * Tool to select mobile platform before creating a session
+ */
+import { z } from 'zod';
+import { answerAppiumQuery, initializeAppiumDocumentation, } from './documentation/index.js';
+export default function answerAppium(server) {
+    server.addTool({
+        name: 'appium_documentation_query',
+        description: `Query Appium documentation using RAG (Retrieval-Augmented Generation).
+      This tool searches through indexed Appium documentation to answer questions about Appium features, setup, configuration, drivers, and usage.
+      `,
+        parameters: z.object({
+            query: z
+                .string()
+                .describe('The question or query about Appium documentation'),
+        }),
+        execute: async (args, context) => {
+            const query = args.query;
+            if (!query) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'Query parameter is required',
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            try {
+                const result = await answerAppiumQuery({ query });
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: result.answer,
+                        },
+                    ],
+                };
+            }
+            catch (docError) {
+                // If documentation query fails, try to initialize and retry once
+                try {
+                    console.log('Documentation not initialized, initializing now...');
+                    await initializeAppiumDocumentation();
+                    const result = await answerAppiumQuery({ query });
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: result.answer,
+                            },
+                        ],
+                    };
+                }
+                catch (retryError) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Error querying Appium documentation: ${retryError.message}. Please ensure the documentation is indexed first.`,
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+            }
+        },
+    });
+}
+//# sourceMappingURL=answer-appium.js.map

package/dist/tools/answer-appium.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"answer-appium.js","sourceRoot":"","sources":["../../src/tools/answer-appium.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,iBAAiB,EACjB,6BAA6B,GAC9B,MAAM,0BAA0B,CAAC;AAElC,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,MAAW;IAC9C,MAAM,CAAC,OAAO,CAAC;QACb,IAAI,EAAE,4BAA4B;QAClC,WAAW,EAAE;;OAEV;QACH,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,CAAC,kDAAkD,CAAC;SAChE,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,IAAS,EAAE,OAAY,EAAgB,EAAE;YACvD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;YACzB,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,6BAA6B;yBACpC;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;gBAClD,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,MAAM,CAAC,MAAM;yBACpB;qBACF;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,QAAQ,EAAE,CAAC;gBAClB,iEAAiE;gBACjE,IAAI,CAAC;oBACH,OAAO,CAAC,GAAG,CAAC,oDAAoD,CAAC,CAAC;oBAClE,MAAM,6BAA6B,EAAE,CAAC;oBACtC,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;oBAClD,OAAO;wBACL,OAAO,EAAE;4BACP;gCACE,IAAI,EAAE,MAAM;gCACZ,IAAI,EAAE,MAAM,CAAC,MAAM;6BACpB;yBACF;qBACF,CAAC;gBACJ,CAAC;gBAAC,OAAO,UAAU,EAAE,CAAC;oBACpB,OAAO;wBACL,OAAO,EAAE;4BACP;gCACE,IAAI,EAAE,MAAM;gCACZ,IAAI,EAAE,wCACH,UAAoB,CAAC,OACxB,qDAAqD;6BACtD;yBACF;wBACD,OAAO,EAAE,IAAI;qBACd,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/boot-simulator.d.ts

@@ -0,0 +1 @@
+export default function bootSimulator(server: any): void;

package/dist/tools/boot-simulator.js

@@ -0,0 +1,71 @@
+/**
+ * Tool to boot iOS simulator
+ */
+import { z } from 'zod';
+import { Simctl } from 'node-simctl';
+import { IOSManager } from '../devicemanager/ios-manager.js';
+export default function bootSimulator(server) {
+    server.addTool({
+        name: 'boot_simulator',
+        description: `Boot an iOS simulator and wait for it to be ready.
+      This speeds up subsequent session creation by ensuring the simulator is already running.`,
+        parameters: z.object({
+            udid: z.string().describe(`The UDID of the iOS simulator to boot.
+          Use select_platform and select_device tools first to get the UDID.`),
+        }),
+        annotations: {
+            readOnlyHint: false,
+            openWorldHint: false,
+        },
+        execute: async (args, context) => {
+            try {
+                const { udid } = args;
+                // Verify it's a macOS system
+                if (process.platform !== 'darwin') {
+                    throw new Error('iOS simulators can only be booted on macOS systems');
+                }
+                const iosManager = IOSManager.getInstance();
+                const simulators = await iosManager.listSimulators();
+                // Find the simulator with the given UDID
+                const simulator = simulators.find(sim => sim.udid === udid);
+                if (!simulator) {
+                    throw new Error(`Simulator with UDID "${udid}" not found. Please use select_platform and select_device tools to get a valid UDID.`);
+                }
+                // Check current state
+                if (simulator.state === 'Booted') {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `✅ Simulator "${simulator.name}" is already booted and ready!\n\nUDID: ${udid}\niOS Version: ${simulator.platform || 'Unknown'}\nState: ${simulator.state}`,
+                            },
+                        ],
+                    };
+                }
+                const simctl = new Simctl();
+                simctl.udid = udid;
+                // Boot the device and measure time
+                const bootStartTime = Date.now();
+                await simctl.bootDevice();
+                await simctl.startBootMonitor({ timeout: 120000 });
+                const bootDuration = ((Date.now() - bootStartTime) / 1000).toFixed(1);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `${JSON.stringify({
+                                instruction: 'You can now use the install_wda tool to install WDA on the simulator.',
+                                status: 'Simulator booted successfully!',
+                            }, null, 2)}`,
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                console.error('Error booting simulator:', error);
+                throw new Error(`Failed to boot simulator: ${error.message}`);
+            }
+        },
+    });
+}
+//# sourceMappingURL=boot-simulator.js.map

package/dist/tools/boot-simulator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boot-simulator.js","sourceRoot":"","sources":["../../src/tools/boot-simulator.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAE7D,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,MAAW;IAC/C,MAAM,CAAC,OAAO,CAAC;QACb,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE;+FAC8E;QAC3F,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CACvB;6EACqE,CACtE;SACF,CAAC;QACF,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,aAAa,EAAE,KAAK;SACrB;QACD,OAAO,EAAE,KAAK,EAAE,IAAS,EAAE,OAAY,EAAgB,EAAE;YACvD,IAAI,CAAC;gBACH,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;gBAEtB,6BAA6B;gBAC7B,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;oBAClC,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;gBACxE,CAAC;gBAED,MAAM,UAAU,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;gBAC5C,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,cAAc,EAAE,CAAC;gBAErD,yCAAyC;gBACzC,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;gBAE5D,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,MAAM,IAAI,KAAK,CACb,wBAAwB,IAAI,sFAAsF,CACnH,CAAC;gBACJ,CAAC;gBAED,sBAAsB;gBACtB,IAAI,SAAS,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;oBACjC,OAAO;wBACL,OAAO,EAAE;4BACP;gCACE,IAAI,EAAE,MAAM;gCACZ,IAAI,EAAE,gBAAgB,SAAS,CAAC,IAAI,2CAA2C,IAAI,kBAAkB,SAAS,CAAC,QAAQ,IAAI,SAAS,YAAY,SAAS,CAAC,KAAK,EAAE;6BAClK;yBACF;qBACF,CAAC;gBACJ,CAAC;gBAED,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;gBAC5B,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;gBAEnB,mCAAmC;gBACnC,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBACjC,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;gBAC1B,MAAM,MAAM,CAAC,gBAAgB,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;gBACnD,MAAM,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBAEtE,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CACrB;gCACE,WAAW,EACT,uEAAuE;gCACzE,MAAM,EAAE,gCAAgC;6BACzC,EACD,IAAI,EACJ,CAAC,CACF,EAAE;yBACJ;qBACF;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;gBACjD,MAAM,IAAI,KAAK,CAAC,6BAA6B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/create-session.d.ts

@@ -0,0 +1 @@
+export default function createSession(server: any): void;

package/dist/tools/create-session.js

@@ -0,0 +1,192 @@
+/**
+ * Tool to create a new mobile session (Android or iOS)
+ */
+import { z } from 'zod';
+import { access, readFile } from 'fs/promises';
+import { constants } from 'fs';
+import { AndroidUiautomator2Driver } from 'appium-uiautomator2-driver';
+import { XCUITestDriver } from 'appium-xcuitest-driver';
+import { setSession, hasActiveSession, safeDeleteSession, } from './session-store.js';
+import { getSelectedDevice, getSelectedDeviceType, getSelectedDeviceInfo, clearSelectedDevice, } from './select-device.js';
+import { IOSManager } from '../devicemanager/ios-manager.js';
+import log from '../locators/logger.js';
+/**
+ * Load capabilities configuration from file if specified in environment
+ */
+async function loadCapabilitiesConfig() {
+    const configPath = process.env.CAPABILITIES_CONFIG;
+    if (!configPath) {
+        return { android: {}, ios: {} };
+    }
+    try {
+        await access(configPath, constants.F_OK);
+        const configContent = await readFile(configPath, 'utf8');
+        return JSON.parse(configContent);
+    }
+    catch (error) {
+        log.warn(`Failed to parse capabilities config: ${error}`);
+        return { android: {}, ios: {} };
+    }
+}
+/**
+ * Remove empty string values from capabilities object
+ */
+function filterEmptyCapabilities(capabilities) {
+    const filtered = { ...capabilities };
+    Object.keys(filtered).forEach(key => {
+        if (filtered[key] === '') {
+            delete filtered[key];
+        }
+    });
+    return filtered;
+}
+/**
+ * Build Android capabilities by merging defaults, config, device selection, and custom capabilities
+ */
+function buildAndroidCapabilities(configCaps, customCaps) {
+    const defaultCaps = {
+        platformName: 'Android',
+        'appium:automationName': 'UiAutomator2',
+        'appium:deviceName': 'Android Device',
+    };
+    const selectedDeviceUdid = getSelectedDevice();
+    const capabilities = {
+        ...defaultCaps,
+        ...configCaps,
+        ...(selectedDeviceUdid && { 'appium:udid': selectedDeviceUdid }),
+        ...customCaps,
+    };
+    if (selectedDeviceUdid) {
+        clearSelectedDevice();
+    }
+    return filterEmptyCapabilities(capabilities);
+}
+/**
+ * Validate iOS device selection when multiple devices are available
+ */
+async function validateIOSDeviceSelection(deviceType) {
+    if (!deviceType) {
+        return;
+    }
+    const iosManager = IOSManager.getInstance();
+    const devices = await iosManager.getDevicesByType(deviceType);
+    if (devices.length > 1) {
+        const selectedDevice = getSelectedDevice();
+        if (!selectedDevice) {
+            throw new Error(`Multiple iOS ${deviceType === 'simulator' ? 'simulators' : 'devices'} found (${devices.length}). Please use the select_device tool to choose which device to use before creating a session.`);
+        }
+    }
+}
+/**
+ * Build iOS capabilities by merging defaults, config, device selection, and custom capabilities
+ */
+async function buildIOSCapabilities(configCaps, customCaps) {
+    const deviceType = getSelectedDeviceType();
+    await validateIOSDeviceSelection(deviceType);
+    const defaultCaps = {
+        platformName: 'iOS',
+        'appium:automationName': 'XCUITest',
+        'appium:deviceName': 'iPhone Simulator',
+    };
+    const selectedDeviceUdid = getSelectedDevice();
+    const selectedDeviceInfo = getSelectedDeviceInfo();
+    log.debug('Selected device info:', selectedDeviceInfo);
+    const platformVersion = selectedDeviceInfo?.platform && selectedDeviceInfo.platform.trim() !== ''
+        ? selectedDeviceInfo.platform
+        : undefined;
+    log.debug('Platform version:', platformVersion);
+    const capabilities = {
+        ...defaultCaps,
+        ...configCaps,
+        ...(selectedDeviceUdid && { 'appium:udid': selectedDeviceUdid }),
+        ...(platformVersion && { 'appium:platformVersion': platformVersion }),
+        ...(deviceType === 'simulator' && {
+            'appium:usePrebuiltWDA': true,
+            'appium:wdaStartupRetries': 4,
+            'appium:wdaStartupRetryInterval': 20000,
+        }),
+        ...customCaps,
+    };
+    if (selectedDeviceUdid) {
+        clearSelectedDevice();
+    }
+    return filterEmptyCapabilities(capabilities);
+}
+/**
+ * Create the appropriate driver instance for the given platform
+ */
+function createDriverForPlatform(platform) {
+    if (platform === 'android') {
+        return new AndroidUiautomator2Driver();
+    }
+    if (platform === 'ios') {
+        return new XCUITestDriver();
+    }
+    throw new Error(`Unsupported platform: ${platform}. Please choose 'android' or 'ios'.`);
+}
+/**
+ * Create a new session with the given driver and capabilities
+ */
+async function createDriverSession(driver, capabilities) {
+    // @ts-ignore
+    const sessionId = await driver.createSession(null, {
+        alwaysMatch: capabilities,
+        firstMatch: [{}],
+    });
+    return sessionId;
+}
+export default function createSession(server) {
+    server.addTool({
+        name: 'create_session',
+        description: `Create a new mobile session with Android or iOS device.
+      MUST use select_platform tool first to ask the user which platform they want.
+      DO NOT assume or default to any platform.
+      `,
+        parameters: z.object({
+            platform: z.enum(['ios', 'android']).describe(`REQUIRED: Must match the platform the user explicitly selected via the select_platform tool.
+          DO NOT default to Android or iOS without asking the user first.`),
+            capabilities: z
+                .object({})
+                .optional()
+                .describe('Optional custom capabilities for the session (W3C format).'),
+        }),
+        annotations: {
+            readOnlyHint: false,
+            openWorldHint: false,
+        },
+        execute: async (args, context) => {
+            try {
+                if (hasActiveSession()) {
+                    log.info('Existing session detected, cleaning up before creating new session...');
+                    await safeDeleteSession();
+                }
+                const { platform, capabilities: customCapabilities } = args;
+                const configCapabilities = await loadCapabilitiesConfig();
+                const platformCaps = platform === 'android'
+                    ? configCapabilities.android
+                    : configCapabilities.ios;
+                const finalCapabilities = platform === 'android'
+                    ? buildAndroidCapabilities(platformCaps, customCapabilities)
+                    : await buildIOSCapabilities(platformCaps, customCapabilities);
+                const driver = createDriverForPlatform(platform);
+                log.info(`Creating new ${platform.toUpperCase()} session with capabilities:`, JSON.stringify(finalCapabilities, null, 2));
+                const sessionId = await createDriverSession(driver, finalCapabilities);
+                setSession(driver, sessionId);
+                log.info(`${platform.toUpperCase()} session created successfully with ID: ${sessionId}`);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `${platform.toUpperCase()} session created successfully with ID: ${sessionId}\nPlatform: ${finalCapabilities.platformName}\nAutomation: ${finalCapabilities['appium:automationName']}\nDevice: ${finalCapabilities['appium:deviceName']}`,
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                log.error('Error creating session:', error);
+                throw new Error(`Failed to create session: ${error.message}`);
+            }
+        },
+    });
+}
+//# sourceMappingURL=create-session.js.map

package/dist/tools/create-session.js.map

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

package/dist/tools/delete-session.d.ts

@@ -0,0 +1 @@
+export default function deleteSession(server: any): void;

package/dist/tools/delete-session.js

@@ -0,0 +1,47 @@
+/**
+ * Tool to delete the current mobile session and clean up resources
+ */
+import { z } from 'zod';
+import { safeDeleteSession } from './session-store.js';
+export default function deleteSession(server) {
+    server.addTool({
+        name: 'delete_session',
+        description: 'Delete the current mobile session and clean up resources.',
+        parameters: z.object({}),
+        annotations: {
+            destructiveHint: true,
+            readOnlyHint: false,
+            openWorldHint: false,
+        },
+        execute: async () => {
+            try {
+                const deleted = await safeDeleteSession();
+                if (deleted) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: 'Session deleted successfully.',
+                            },
+                        ],
+                    };
+                }
+                else {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: 'No active session found or deletion already in progress.',
+                            },
+                        ],
+                    };
+                }
+            }
+            catch (error) {
+                console.error(`Error deleting session`, error);
+                throw new Error(`Failed to delete session: ${error.message}`);
+            }
+        },
+    });
+}
+//# sourceMappingURL=delete-session.js.map

package/dist/tools/delete-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-session.js","sourceRoot":"","sources":["../../src/tools/delete-session.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,MAAW;IAC/C,MAAM,CAAC,OAAO,CAAC;QACb,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,2DAA2D;QACxE,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,WAAW,EAAE;YACX,eAAe,EAAE,IAAI;YACrB,YAAY,EAAE,KAAK;YACnB,aAAa,EAAE,KAAK;SACrB;QACD,OAAO,EAAE,KAAK,IAAkB,EAAE;YAChC,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,iBAAiB,EAAE,CAAC;gBAE1C,IAAI,OAAO,EAAE,CAAC;oBACZ,OAAO;wBACL,OAAO,EAAE;4BACP;gCACE,IAAI,EAAE,MAAM;gCACZ,IAAI,EAAE,+BAA+B;6BACtC;yBACF;qBACF,CAAC;gBACJ,CAAC;qBAAM,CAAC;oBACN,OAAO;wBACL,OAAO,EAAE;4BACP;gCACE,IAAI,EAAE,MAAM;gCACZ,IAAI,EAAE,0DAA0D;6BACjE;yBACF;qBACF,CAAC;gBACJ,CAAC;YACH,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;gBAC/C,MAAM,IAAI,KAAK,CAAC,6BAA6B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}