feat: add visibility hints to boot and launch simulator tools

- Updated boot_sim description to mention using open_sim() after booting
- Updated launch_app_sim and launch_app_sim_name descriptions to hint about open_sim()
- Modified success messages in boot_sim and launch_app_sim to prominently suggest open_sim()
- Kept hints concise to preserve context while ensuring agents remember to make simulator visible

Author: cameroncooke

src/mcp/tools/simulator/boot_sim.ts

@@ -38,17 +38,12 @@ export async function boot_simLogic(
       content: [
         {
           type: 'text',
-          text: `Simulator booted successfully. Next steps:
-1. Open the Simulator app: open_sim({ enabled: true })
+          text: `✅ Simulator booted successfully. To make it visible, use: open_sim()
+
+Next steps:
+1. Open the Simulator app (makes it visible): open_sim()
 2. Install an app: install_app_sim({ simulatorUuid: "${params.simulatorUuid}", appPath: "PATH_TO_YOUR_APP" })
-3. Launch an app: launch_app_sim({ simulatorUuid: "${params.simulatorUuid}", bundleId: "YOUR_APP_BUNDLE_ID" })
-4. Log capture options:
-   - Option 1: Capture structured logs only (app continues running):
-     start_sim_log_cap({ simulatorUuid: "${params.simulatorUuid}", bundleId: "YOUR_APP_BUNDLE_ID" })
-   - Option 2: Capture both console and structured logs (app will restart):
-     start_sim_log_cap({ simulatorUuid: "${params.simulatorUuid}", bundleId: "YOUR_APP_BUNDLE_ID", captureConsole: true })
-   - Option 3: Launch app with logs in one step:
-     launch_app_logs_sim({ simulatorUuid: "${params.simulatorUuid}", bundleId: "YOUR_APP_BUNDLE_ID" })`,
+3. Launch an app: launch_app_sim({ simulatorUuid: "${params.simulatorUuid}", bundleId: "YOUR_APP_BUNDLE_ID" })`,
         },
       ],
     };
@@ -69,7 +64,7 @@ export async function boot_simLogic(
 export default {
   name: 'boot_sim',
   description:
-    "Boots an iOS simulator. IMPORTANT: You MUST provide the simulatorUuid parameter. Example: boot_sim({ simulatorUuid: 'YOUR_UUID_HERE' })",
+    "Boots an iOS simulator. After booting, use open_sim() to make the simulator visible. IMPORTANT: You MUST provide the simulatorUuid parameter. Example: boot_sim({ simulatorUuid: 'YOUR_UUID_HERE' })",
   schema: bootSimSchema.shape, // MCP SDK compatibility
   handler: createTypedTool(bootSimSchema, boot_simLogic, getDefaultCommandExecutor),
 };

src/mcp/tools/simulator/launch_app_sim.ts

@@ -159,21 +159,14 @@ export async function launch_app_simLogic(
       content: [
         {
           type: 'text',
-          text: `App launched successfully in simulator ${simulatorDisplayName || simulatorUuid}`,
-        },
-        {
-          type: 'text',
-          text: `Next Steps:
-1. You can now interact with the app in the simulator.
+          text: `✅ App launched successfully in simulator ${simulatorDisplayName || simulatorUuid}. If simulator window isn't visible, use: open_sim()
+
+Next Steps:
+1. To see the simulator window (if hidden): open_sim()
 2. Log capture options:
-   - Option 1: Capture structured logs only (app continues running):
-     start_sim_log_cap({ simulatorUuid: "${simulatorUuid}", bundleId: "${params.bundleId}" })
-   - Option 2: Capture both console and structured logs (app will restart):
-     start_sim_log_cap({ simulatorUuid: "${simulatorUuid}", bundleId: "${params.bundleId}", captureConsole: true })
-   - Option 3: Restart with logs in one step:
-     launch_app_logs_sim({ simulatorUuid: "${simulatorUuid}", bundleId: "${params.bundleId}" })
-
-3. When done with any option, use: stop_sim_log_cap({ logSessionId: 'SESSION_ID' })`,
+   - Capture structured logs: start_sim_log_cap({ simulatorUuid: "${simulatorUuid}", bundleId: "${params.bundleId}" })
+   - Capture console+structured logs: start_sim_log_cap({ simulatorUuid: "${simulatorUuid}", bundleId: "${params.bundleId}", captureConsole: true })
+3. When done, use: stop_sim_log_cap({ logSessionId: 'SESSION_ID' })`,
         },
       ],
     };
@@ -194,7 +187,7 @@ export async function launch_app_simLogic(
 export default {
   name: 'launch_app_sim',
   description:
-    "Launches an app in an iOS simulator. IMPORTANT: You MUST provide both the simulatorUuid and bundleId parameters.\n\nNote: You must install the app in the simulator before launching. The typical workflow is: build → install → launch. Example: launch_app_sim({ simulatorUuid: 'YOUR_UUID_HERE', bundleId: 'com.example.MyApp' })",
+    "Launches an app in an iOS simulator. If simulator window isn't visible, use open_sim() first. IMPORTANT: You MUST provide both the simulatorUuid and bundleId parameters.\n\nNote: You must install the app in the simulator before launching. The typical workflow is: build → install → launch. Example: launch_app_sim({ simulatorUuid: 'YOUR_UUID_HERE', bundleId: 'com.example.MyApp' })",
   schema: launchAppSimSchema.shape, // MCP SDK compatibility
   handler: createTypedTool(launchAppSimSchema, launch_app_simLogic, getDefaultCommandExecutor),
 };

src/mcp/tools/simulator/launch_app_sim_name.ts

@@ -18,7 +18,7 @@ type LaunchAppSimNameParams = z.infer<typeof launchAppSimNameSchema>;
 export default {
   name: 'launch_app_sim_name',
   description:
-    "Launches an app in an iOS simulator by simulator name. IMPORTANT: You MUST provide both the simulatorName and bundleId parameters.\n\nNote: You must install the app in the simulator before launching. The typical workflow is: build → install → launch. Example: launch_app_sim_name({ simulatorName: 'iPhone 16', bundleId: 'com.example.MyApp' })",
+    "Launches an app in an iOS simulator by simulator name. If simulator window isn't visible, use open_sim() first. IMPORTANT: You MUST provide both the simulatorName and bundleId parameters.\n\nNote: You must install the app in the simulator before launching. The typical workflow is: build → install → launch. Example: launch_app_sim_name({ simulatorName: 'iPhone 16', bundleId: 'com.example.MyApp' })",
   schema: launchAppSimNameSchema.shape, // MCP SDK compatibility
   handler: createTypedTool(
     launchAppSimNameSchema,