Added tool to boot simulator

Co-authored-by: SrinivasanTarget <[email protected]>

Author: saikrishna321

src/devicemanager/ios-manager.ts

@@ -109,17 +109,9 @@ export class IOSManager {
 
   /**
    * Get all available iOS simulators
-   * Prioritizes booted simulators, but returns all if none are booted
-   * @returns Array of iOS simulators
+   * @returns Array of all iOS simulators (both booted and shutdown)
    */
   public async getAvailableSimulators(): Promise<IOSDevice[]> {
-    const bootedSimulators = await this.listBootedSimulators();
-
-    if (bootedSimulators.length > 0) {
-      return bootedSimulators;
-    }
-
-    // If no booted simulators, return all available simulators
     return await this.listSimulators();
   }
 

src/tools/boot-simulator.ts

@@ -0,0 +1,87 @@
+/**
+ * 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: any): void {
+  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: any, context: any): Promise<any> => {
+      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}`,
+              },
+            ],
+          };
+        }
+
+        console.log(`Booting iOS simulator: ${simulator.name} (${udid})...`);
+
+        const simctl = new Simctl();
+        simctl.udid = udid;
+
+        // Boot the device
+        await simctl.bootDevice();
+        console.log(
+          'Simulator boot initiated, waiting for boot to complete...'
+        );
+
+        // Wait for boot to complete with 2 minute timeout
+        await simctl.startBootMonitor({ timeout: 120000 });
+
+        console.log(`Simulator "${simulator.name}" booted successfully!`);
+
+        return {
+          content: [
+            {
+              type: 'text',
+              text: `✅ Simulator booted successfully!\n\nDevice: ${simulator.name}\nUDID: ${udid}\niOS Version: ${simulator.platform || 'Unknown'}\n\n🚀 The simulator is now ready for session creation. You can now use the create_session tool to start an Appium session.`,
+            },
+          ],
+        };
+      } catch (error: any) {
+        console.error('Error booting simulator:', error);
+        throw new Error(`Failed to boot simulator: ${error.message}`);
+      }
+    },
+  });
+}

src/tools/create-session.ts

@@ -166,6 +166,12 @@ export default function createSession(server: any): void {
             ...(platformVersion && {
               'appium:platformVersion': platformVersion,
             }),
+            // Add WDA optimization for simulators
+            ...(deviceType === 'simulator' && {
+              'appium:usePrebuiltWDA': true,
+              'appium:wdaStartupRetries': 4,
+              'appium:wdaStartupRetryInterval': 20000,
+            }),
             ...customCapabilities,
           };
 

src/tools/index.ts

@@ -7,6 +7,7 @@ import uploadApp from './upload-app.js';
 import generateLocators from './locators.js';
 import selectPlatform from './select-platform.js';
 import selectDevice from './select-device.js';
+import bootSimulator from './boot-simulator.js';
 import generateTest from './generate-tests.js';
 import scroll from './scroll.js';
 import scrollToElement from './scroll-to-element.js';
@@ -24,6 +25,7 @@ import listApps from './interactions/listApps.js';
 export default function registerTools(server: FastMCP): void {
   selectPlatform(server);
   selectDevice(server);
+  bootSimulator(server);
   createSession(server);
   deleteSession(server);
   createCloudSession(server);