preflight-ios-mcp 1.0.0 → 2.0.0

package/README.md

@@ -2,7 +2,7 @@
 
 The most comprehensive MCP (Model Context Protocol) server for iOS Simulator automation. Gives AI agents like Claude, ChatGPT, Cursor, Windsurf, and any MCP-compatible tool full control over iOS Simulators — tap, swipe, type, read accessibility trees, inspect app data, capture screenshots, record video, manage devices, and debug apps in real time.
 
-**57 tools** across 10 categories. Zero cursor interference — works silently in the background while you use your Mac.
+**82 tools** across 14 categories. Zero cursor interference — works silently in the background while you use your Mac.
 
 Inspired by [Playwright MCP](https://github.com/anthropics/mcp-server-playwright) for web automation — Preflight brings the same structured accessibility-first approach to iOS.
 
@@ -15,7 +15,7 @@ Inspired by [Playwright MCP](https://github.com/anthropics/mcp-server-playwright
 - **AI-optimized** — Images compressed for minimal token usage. Video → key frames (most AI models can't view video files).
 - **Accessibility-first** — Like Playwright's `browser_snapshot`, use `simulator_snapshot` to understand the screen without vision models.
 - **Cursor-free** — Touch injection via idb (IndigoHID) — your Mac cursor stays put.
-- **57 tools** — From basic tap/swipe to Dynamic Type testing, biometric enrollment, crash log analysis.
+- **82 tools** — From basic tap/swipe to StoreKit testing, network conditioning, memory profiling, and crash log analysis.
 
 ## Quick Start
 
@@ -265,7 +265,7 @@ Set the `PATH` environment variable to include idb's location for cursor-free to
 | `simulator_record_video` | Start screen recording. On stop, key frames are extracted as images for AI chat. |
 | `simulator_stop_recording` | Stop recording. Returns key frames inline (no disk clutter). Optional `savePath` to keep the video. |
 
-### Advanced Debugging & Testing (14 tools)
+### Advanced Debugging & Testing (18 tools)
 
 | Tool | Description |
 |------|-------------|
@@ -279,16 +279,66 @@ Set the `PATH` environment variable to include idb's location for cursor-free to
 | `simulator_verbose_logging` | Enable/disable verbose device logging for deep debugging. |
 | `simulator_install_app_data` | Install .xcappdata packages to restore test data snapshots. |
 | `simulator_get_env` | Read environment variables from the running simulator. |
-| `simulator_biometric` | Set Face ID / Touch ID enrollment state for auth testing. |
+| `simulator_biometric` | Enroll, unenroll, match, or fail Face ID / Touch ID for auth testing. |
 | `simulator_network_status` | Get network configuration — DNS, interfaces, connectivity status. |
 | `simulator_defaults_read` | Read UserDefaults from inside the simulator (inspect app prefs, feature flags). |
 | `simulator_defaults_write` | Write UserDefaults inside the simulator (set flags, inject test config). |
+| `simulator_rotate` | Rotate the simulator left or right. |
+| `simulator_notify_post` | Post a Darwin notification to trigger system events. |
+| `simulator_set_locale` | Set device locale for internationalization testing. |
+| `simulator_trigger_siri` | Invoke Siri for voice command testing. |
+
+### Accessibility Settings (4 tools)
+
+| Tool | Description |
+|------|-------------|
+| `simulator_set_reduce_motion` | Toggle Reduce Motion accessibility setting (via defaults write + notification). |
+| `simulator_set_smart_invert` | Toggle Smart Invert Colors (via defaults write + notification). |
+| `simulator_set_bold_text` | Toggle Bold Text (via defaults write + notification). |
+| `simulator_set_reduce_transparency` | Toggle Reduce Transparency (via defaults write + notification). |
+
+### Device Creation & Management (4 tools)
+
+| Tool | Description |
+|------|-------------|
+| `simulator_create_device` | Create a new simulator with device type and runtime. |
+| `simulator_delete_device` | Permanently delete a simulator device. |
+| `simulator_rename_device` | Rename an existing device. |
+| `simulator_clone_device` | Clone a device with all its state. |
+
+### StoreKit Testing (6 tools) — Xcode 14-16
+
+| Tool | Description |
+|------|-------------|
+| `simulator_storekit_config` | Enable or disable StoreKit test mode. |
+| `simulator_storekit_transactions` | List all StoreKit test transactions. |
+| `simulator_storekit_delete_transactions` | Clear all test transactions. |
+| `simulator_storekit_manage_subscription` | Expire or force-renew a subscription. |
+| `simulator_storekit_manage_transaction` | Refund, approve, or decline ask-to-buy transactions. |
+| `simulator_storekit_reset_eligibility` | Reset introductory offer eligibility for all products. |
+
+### Network Testing (2 tools)
+
+| Tool | Description |
+|------|-------------|
+| `simulator_network_condition` | Apply network throttling with presets (3G, LTE, Edge, WiFi, 100% loss) or custom bandwidth/latency/loss. |
+| `simulator_network_capture` | Capture network activity summary — active connections, DNS, interfaces. |
+
+### Debugging & Profiling (5 tools)
+
+| Tool | Description |
+|------|-------------|
+| `simulator_leak_check` | Check a running app for memory leaks via Apple's `leaks` tool. |
+| `simulator_heap_info` | Dump heap allocation summary — object counts by class, total memory. |
+| `simulator_vmmap` | Show virtual memory map — regions, sizes, permissions. |
+| `simulator_sample_process` | Sample a process for CPU hotspot detection and hang analysis. |
+| `simulator_thermal_state` | Simulate thermal pressure state changes (nominal, fair, serious, critical). |
 
 ## Architecture
 
 ```
 src/
-├── index.ts                    # MCP server entry, 57 tool registrations
+├── index.ts                    # MCP server entry, 82 tool registrations
 ├── helpers/
 │   ├── idb.ts                  # Facebook idb CLI wrapper (cursor-free touch)
 │   ├── simctl.ts               # xcrun simctl command wrapper
@@ -304,7 +354,10 @@ src/
     ├── system.ts               # Location, push, clipboard, media, permissions
     ├── ui.ts                   # Appearance, status bar, video recording, navigate back
     ├── debug.ts                # Logs, files, crash reports, accessibility
-    ├── advanced.ts             # Dynamic Type, keychain, iCloud, biometric, defaults
+    ├── advanced.ts             # Dynamic Type, keychain, iCloud, biometric, defaults, accessibility, rotation, locale
+    ├── storekit.ts             # StoreKit testing — transactions, subscriptions, eligibility
+    ├── network.ts              # Network conditioning (dnctl/pfctl) and capture
+    ├── profiling.ts            # Memory profiling — leaks, heap, vmmap, sample, thermal
     └── playwright.ts           # Snapshot, wait_for_element, element_exists
 ```
 
@@ -345,11 +398,14 @@ xcodebuild -project MCPDemo.xcodeproj -scheme MCPDemo \
   build
 ```
 
-The demo app has 4 tabs exercising every tool category:
+The demo app has 7 tabs exercising every tool category:
 - **Interactions**: Buttons, text fields, long-press zones, navigation stack, scrollable lists
 - **Location**: Live GPS display for testing `simulator_set_location`
 - **Notifications**: Push notification display for testing `simulator_send_push`
 - **Settings**: Clipboard, file I/O, accessibility toggles, UserDefaults
+- **StoreKit**: Mock purchases and subscriptions for testing StoreKit tools
+- **Network**: Connection monitoring and latency testing for network conditioning
+- **Debug**: Memory/CPU stress tests, thermal state, accessibility settings observer, biometric auth
 
 ## Configuration
 

package/dist/helpers/coordinate-mapper.js

@@ -1,5 +1,8 @@
-import { execSimctlBuffer, runAppleScript } from './simctl.js';
+import { execSimctl, runAppleScript } from './simctl.js';
 import * as logger from './logger.js';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { readFile, unlink } from 'node:fs/promises';
 const TITLE_BAR_HEIGHT = 28;
 /**
  * Get the Simulator.app front window position and size using AppleScript.
@@ -33,8 +36,11 @@ end tell`;
  * Returns { pointWidth, pointHeight, scaleFactor }.
  */
 export async function getDeviceScreenDimensions(device) {
-    // Take a screenshot and get its pixel dimensions
-    const { stdout } = await execSimctlBuffer(['io', device, 'screenshot', '--type=png', '-'], 'coordinate-mapper');
+    // Take a screenshot and get its pixel dimensions (temp file to avoid stdout piping issues)
+    const tmpPath = join(tmpdir(), `simscr-dim-${Date.now()}.png`);
+    await execSimctl(['io', device, 'screenshot', '--type=png', tmpPath], 'coordinate-mapper');
+    const stdout = await readFile(tmpPath);
+    await unlink(tmpPath).catch(() => { });
     // Parse PNG header to get dimensions (IHDR chunk at offset 16)
     // PNG signature (8 bytes) + IHDR length (4 bytes) + "IHDR" (4 bytes) + width (4 bytes) + height (4 bytes)
     if (stdout.length < 24) {

package/dist/index.js

@@ -4,20 +4,23 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import * as logger from './helpers/logger.js';
 // Tool imports
 import { screenshotParams, handleScreenshot } from './tools/screenshot.js';
-import { listDevicesParams, handleListDevices, bootParams, handleBoot, shutdownParams, handleShutdown, eraseParams, handleErase, openUrlParams, handleOpenUrl, openSimulatorParams, handleOpenSimulator, getBootedSimIdParams, handleGetBootedSimId, } from './tools/device.js';
+import { listDevicesParams, handleListDevices, bootParams, handleBoot, shutdownParams, handleShutdown, eraseParams, handleErase, openUrlParams, handleOpenUrl, openSimulatorParams, handleOpenSimulator, getBootedSimIdParams, handleGetBootedSimId, createDeviceParams, handleCreateDevice, deleteDeviceParams, handleDeleteDevice, renameDeviceParams, handleRenameDevice, cloneDeviceParams, handleCloneDevice, } from './tools/device.js';
 import { listAppsParams, handleListApps, appInfoParams, handleAppInfo, launchAppParams, handleLaunchApp, terminateAppParams, handleTerminateApp, installAppParams, handleInstallApp, uninstallAppParams, handleUninstallApp, } from './tools/app.js';
 import { tapParams, handleTap, swipeParams, handleSwipe, longPressParams, handleLongPress, describePointParams, handleDescribePoint, typeTextParams, handleTypeText, pressKeyParams, handlePressKey, } from './tools/interaction.js';
 import { setLocationParams, handleSetLocation, sendPushParams, handleSendPush, setClipboardParams, handleSetClipboard, getClipboardParams, handleGetClipboard, addMediaParams, handleAddMedia, grantPermissionParams, handleGrantPermission, } from './tools/system.js';
 import { setAppearanceParams, handleSetAppearance, overrideStatusBarParams, handleOverrideStatusBar, recordVideoParams, handleRecordVideo, stopRecordingParams, handleStopRecording, navigateBackParams, handleNavigateBack, } from './tools/ui.js';
 import { getLogsParams, handleGetLogs, streamLogsParams, handleStreamLogs, getAppContainerParams, handleGetAppContainer, listAppFilesParams, handleListAppFiles, readAppFileParams, handleReadAppFile, getCrashLogsParams, handleGetCrashLogs, diagnoseParams, handleDiagnose, accessibilityAuditParams, handleAccessibilityAudit, getScreenInfoParams, handleGetScreenInfo, } from './tools/debug.js';
-import { icloudSyncParams, handleIcloudSync, keychainParams, handleKeychain, contentSizeParams, handleContentSize, increaseContrastParams, handleIncreaseContrast, locationScenarioParams, handleLocationScenario, locationRouteParams, handleLocationRoute, verboseLoggingParams, handleVerboseLogging, installAppDataParams, handleInstallAppData, getEnvParams, handleGetEnv, memoryWarningParams, handleMemoryWarning, biometricParams, handleBiometric, networkStatusParams, handleNetworkStatus, defaultsReadParams, handleDefaultsRead, defaultsWriteParams, handleDefaultsWrite, } from './tools/advanced.js';
+import { icloudSyncParams, handleIcloudSync, keychainParams, handleKeychain, contentSizeParams, handleContentSize, increaseContrastParams, handleIncreaseContrast, locationScenarioParams, handleLocationScenario, locationRouteParams, handleLocationRoute, verboseLoggingParams, handleVerboseLogging, installAppDataParams, handleInstallAppData, getEnvParams, handleGetEnv, memoryWarningParams, handleMemoryWarning, biometricParams, handleBiometric, networkStatusParams, handleNetworkStatus, defaultsReadParams, handleDefaultsRead, defaultsWriteParams, handleDefaultsWrite, reduceMotionParams, handleReduceMotion, smartInvertParams, handleSmartInvert, boldTextParams, handleBoldText, reduceTransparencyParams, handleReduceTransparency, rotateParams, handleRotate, notifyPostParams, handleNotifyPost, setLocaleParams, handleSetLocale, triggerSiriParams, handleTriggerSiri, } from './tools/advanced.js';
 import { snapshotParams, handleSnapshot, waitForElementParams, handleWaitForElement, elementExistsParams, handleElementExists, } from './tools/playwright.js';
+import { storekitConfigParams, handleStorekitConfig, storekitTransactionsParams, handleStorekitTransactions, storekitDeleteTransactionsParams, handleStorekitDeleteTransactions, storekitManageSubscriptionParams, handleStorekitManageSubscription, storekitManageTransactionParams, handleStorekitManageTransaction, storekitResetEligibilityParams, handleStorekitResetEligibility, } from './tools/storekit.js';
+import { networkConditionParams, handleNetworkCondition, networkCaptureParams, handleNetworkCapture, } from './tools/network.js';
+import { leakCheckParams, handleLeakCheck, heapInfoParams, handleHeapInfo, vmmapParams, handleVmmap, sampleProcessParams, handleSampleProcess, thermalStateParams, handleThermalState, } from './tools/profiling.js';
 // Support tool filtering via environment variable
 const filteredTools = new Set((process.env.PREFLIGHT_FILTERED_TOOLS || process.env.IOS_SIMULATOR_MCP_FILTERED_TOOLS || '')
     .split(',').map(s => s.trim()).filter(Boolean));
 const server = new McpServer({
     name: 'preflight-mcp',
-    version: '1.0.0',
+    version: '2.0.0',
 });
 // Register a tool, skipping if it's in the filtered list
 function registerTool(name, description, params, handler) {
@@ -109,7 +112,7 @@ registerTool('simulator_verbose_logging', 'Enable or disable verbose device logg
 registerTool('simulator_install_app_data', 'Install an .xcappdata package to replace the current app container contents. Useful for restoring test data snapshots.', installAppDataParams, wrapHandler('simulator_install_app_data', handleInstallAppData));
 registerTool('simulator_get_env', 'Read an environment variable from the running simulator device (e.g., HOME, TMPDIR, PATH).', getEnvParams, wrapHandler('simulator_get_env', handleGetEnv));
 registerTool('simulator_memory_warning', 'Trigger a simulated memory warning. Apps will receive didReceiveMemoryWarning and can be tested for proper memory cleanup.', memoryWarningParams, wrapHandler('simulator_memory_warning', handleMemoryWarning));
-registerTool('simulator_biometric', 'Set Face ID / Touch ID enrollment state. Test biometric authentication flows.', biometricParams, wrapHandler('simulator_biometric', handleBiometric));
+registerTool('simulator_biometric', 'Control Face ID / Touch ID: enroll, unenroll, trigger matching (success), or trigger failure. Test biometric authentication flows end-to-end.', biometricParams, wrapHandler('simulator_biometric', handleBiometric));
 registerTool('simulator_network_status', 'Get the current network configuration inside the simulator — interfaces, IP addresses, DNS config.', networkStatusParams, wrapHandler('simulator_network_status', handleNetworkStatus));
 registerTool('simulator_defaults_read', 'Read UserDefaults values from inside the simulator. Inspect app preferences, feature flags, and configuration.', defaultsReadParams, wrapHandler('simulator_defaults_read', handleDefaultsRead));
 registerTool('simulator_defaults_write', 'Write UserDefaults values inside the simulator. Set feature flags, change app configuration, or inject test data.', defaultsWriteParams, wrapHandler('simulator_defaults_write', handleDefaultsWrite));
@@ -117,6 +120,36 @@ registerTool('simulator_defaults_write', 'Write UserDefaults values inside the s
 registerTool('simulator_snapshot', 'Capture a structured accessibility snapshot of the current screen — like Playwright\'s browser_snapshot. Returns roles, labels, values, and positions. PREFERRED over screenshots for understanding UI structure and targeting interactions. No vision model needed.', snapshotParams, wrapHandler('simulator_snapshot', handleSnapshot));
 registerTool('simulator_wait_for_element', 'Wait for an accessibility element to appear on screen. Polls until the element matching your criteria (label, role, or text) appears, or times out. Like Playwright\'s browser_wait_for.', waitForElementParams, wrapHandler('simulator_wait_for_element', handleWaitForElement));
 registerTool('simulator_element_exists', 'Quick check: does an element matching your criteria exist on screen right now? Returns true/false. Useful for conditional logic.', elementExistsParams, wrapHandler('simulator_element_exists', handleElementExists));
+// ========== StoreKit Testing Tools ==========
+registerTool('simulator_storekit_config', 'Enable or disable StoreKit testing on the simulator. Required before using other StoreKit tools.', storekitConfigParams, wrapHandler('simulator_storekit_config', handleStorekitConfig));
+registerTool('simulator_storekit_transactions', 'List all StoreKit test transactions (purchases, subscriptions, etc.).', storekitTransactionsParams, wrapHandler('simulator_storekit_transactions', handleStorekitTransactions));
+registerTool('simulator_storekit_delete_transactions', 'Delete all StoreKit test transactions. Clears purchase history for fresh testing.', storekitDeleteTransactionsParams, wrapHandler('simulator_storekit_delete_transactions', handleStorekitDeleteTransactions));
+registerTool('simulator_storekit_manage_subscription', 'Expire or force-renew a StoreKit test subscription by transaction ID.', storekitManageSubscriptionParams, wrapHandler('simulator_storekit_manage_subscription', handleStorekitManageSubscription));
+registerTool('simulator_storekit_manage_transaction', 'Refund, approve, or decline ask-to-buy for a StoreKit test transaction.', storekitManageTransactionParams, wrapHandler('simulator_storekit_manage_transaction', handleStorekitManageTransaction));
+registerTool('simulator_storekit_reset_eligibility', 'Reset introductory offer eligibility for all StoreKit products. Allows re-testing intro pricing.', storekitResetEligibilityParams, wrapHandler('simulator_storekit_reset_eligibility', handleStorekitResetEligibility));
+// ========== Network Testing Tools ==========
+registerTool('simulator_network_condition', 'Apply network throttling: bandwidth limits, latency, and packet loss. Presets: 3G, LTE, Edge, WiFi, WiFi-lossy, 100%-loss (offline). Simulator shares host network stack, so conditioning affects all simulator traffic.', networkConditionParams, wrapHandler('simulator_network_condition', handleNetworkCondition));
+registerTool('simulator_network_capture', 'Capture a snapshot of network activity: active TCP connections, DNS resolution, host interfaces, and any active network conditioning.', networkCaptureParams, wrapHandler('simulator_network_capture', handleNetworkCapture));
+// ========== Debugging & Profiling Tools ==========
+registerTool('simulator_leak_check', 'Check a running app for memory leaks using Apple\'s leaks tool. Returns leak count, leaked bytes, and details.', leakCheckParams, wrapHandler('simulator_leak_check', handleLeakCheck));
+registerTool('simulator_heap_info', 'Dump heap allocation summary for a running app. Shows object counts by class and total memory usage.', heapInfoParams, wrapHandler('simulator_heap_info', handleHeapInfo));
+registerTool('simulator_vmmap', 'Show virtual memory map for a running app. Displays memory regions, sizes, and permissions. Useful for diagnosing memory issues.', vmmapParams, wrapHandler('simulator_vmmap', handleVmmap));
+registerTool('simulator_sample_process', 'Sample a running app\'s CPU activity for a few seconds. Returns call stack tree — useful for finding performance hotspots and hangs.', sampleProcessParams, wrapHandler('simulator_sample_process', handleSampleProcess));
+registerTool('simulator_thermal_state', 'Simulate thermal pressure changes (nominal, fair, serious, critical). Test how your app responds to device overheating.', thermalStateParams, wrapHandler('simulator_thermal_state', handleThermalState));
+// ========== Accessibility Settings Tools ==========
+registerTool('simulator_set_reduce_motion', 'Enable or disable the Reduce Motion accessibility setting. Test animations and transitions with motion sensitivity.', reduceMotionParams, wrapHandler('simulator_set_reduce_motion', handleReduceMotion));
+registerTool('simulator_set_smart_invert', 'Enable or disable Smart Invert Colors. Test how your app handles inverted color schemes.', smartInvertParams, wrapHandler('simulator_set_smart_invert', handleSmartInvert));
+registerTool('simulator_set_bold_text', 'Enable or disable Bold Text accessibility setting. Test text rendering with bold system fonts.', boldTextParams, wrapHandler('simulator_set_bold_text', handleBoldText));
+registerTool('simulator_set_reduce_transparency', 'Enable or disable Reduce Transparency. Test UI readability without blur/vibrancy effects.', reduceTransparencyParams, wrapHandler('simulator_set_reduce_transparency', handleReduceTransparency));
+// ========== Additional Device Management ==========
+registerTool('simulator_create_device', 'Create a new simulator device. Specify name and device type; auto-detects latest iOS runtime if not provided.', createDeviceParams, wrapHandler('simulator_create_device', handleCreateDevice));
+registerTool('simulator_delete_device', 'Permanently delete a simulator device by UDID or name.', deleteDeviceParams, wrapHandler('simulator_delete_device', handleDeleteDevice));
+registerTool('simulator_rename_device', 'Rename a simulator device.', renameDeviceParams, wrapHandler('simulator_rename_device', handleRenameDevice));
+registerTool('simulator_clone_device', 'Clone a simulator device with all its current state — apps, data, settings.', cloneDeviceParams, wrapHandler('simulator_clone_device', handleCloneDevice));
+registerTool('simulator_rotate', 'Rotate the simulator device left or right. Uses Cmd+Arrow keyboard shortcut in Simulator.app.', rotateParams, wrapHandler('simulator_rotate', handleRotate));
+registerTool('simulator_notify_post', 'Post a Darwin notification inside the simulator. Useful for triggering system events or testing notification observers.', notifyPostParams, wrapHandler('simulator_notify_post', handleNotifyPost));
+registerTool('simulator_set_locale', 'Set the device locale and language for internationalization testing. Requires device reboot to take effect.', setLocaleParams, wrapHandler('simulator_set_locale', handleSetLocale));
+registerTool('simulator_trigger_siri', 'Invoke Siri on the simulator. Use simulator_type_text to enter a query if text input is available.', triggerSiriParams, wrapHandler('simulator_trigger_siri', handleTriggerSiri));
 // ========== Start Server ==========
 async function main() {
     logger.info('server', 'Preflight MCP server starting...');

package/dist/tools/advanced.d.ts

@@ -144,11 +144,13 @@ export declare function handleMemoryWarning(args: {
     }[];
 }>;
 export declare const biometricParams: {
-    enrolled: z.ZodBoolean;
+    action: z.ZodOptional<z.ZodEnum<["enroll", "unenroll", "match", "fail"]>>;
+    enrolled: z.ZodOptional<z.ZodBoolean>;
     deviceId: z.ZodOptional<z.ZodString>;
 };
 export declare function handleBiometric(args: {
-    enrolled: boolean;
+    action?: string;
+    enrolled?: boolean;
     deviceId?: string;
 }): Promise<{
     content: {
@@ -201,3 +203,107 @@ export declare function handleDefaultsWrite(args: {
         text: string;
     }[];
 }>;
+export declare const reduceMotionParams: {
+    enabled: z.ZodBoolean;
+    deviceId: z.ZodOptional<z.ZodString>;
+};
+export declare function handleReduceMotion(args: {
+    enabled: boolean;
+    deviceId?: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export declare const smartInvertParams: {
+    enabled: z.ZodBoolean;
+    deviceId: z.ZodOptional<z.ZodString>;
+};
+export declare function handleSmartInvert(args: {
+    enabled: boolean;
+    deviceId?: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export declare const boldTextParams: {
+    enabled: z.ZodBoolean;
+    deviceId: z.ZodOptional<z.ZodString>;
+};
+export declare function handleBoldText(args: {
+    enabled: boolean;
+    deviceId?: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export declare const reduceTransparencyParams: {
+    enabled: z.ZodBoolean;
+    deviceId: z.ZodOptional<z.ZodString>;
+};
+export declare function handleReduceTransparency(args: {
+    enabled: boolean;
+    deviceId?: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export declare const rotateParams: {
+    direction: z.ZodEnum<["left", "right"]>;
+    deviceId: z.ZodOptional<z.ZodString>;
+};
+export declare function handleRotate(args: {
+    direction: 'left' | 'right';
+    deviceId?: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export declare const notifyPostParams: {
+    notification: z.ZodString;
+    deviceId: z.ZodOptional<z.ZodString>;
+};
+export declare function handleNotifyPost(args: {
+    notification: string;
+    deviceId?: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export declare const setLocaleParams: {
+    locale: z.ZodString;
+    language: z.ZodOptional<z.ZodString>;
+    deviceId: z.ZodOptional<z.ZodString>;
+};
+export declare function handleSetLocale(args: {
+    locale: string;
+    language?: string;
+    deviceId?: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export declare const triggerSiriParams: {
+    deviceId: z.ZodOptional<z.ZodString>;
+};
+export declare function handleTriggerSiri(args: {
+    deviceId?: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;

package/dist/tools/advanced.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { execSimctl, resolveDevice } from '../helpers/simctl.js';
+import { execSimctl, resolveDevice, runAppleScript } from '../helpers/simctl.js';
 // --- icloud_sync ---
 export const icloudSyncParams = {
     deviceId: z.string().optional().describe('Device (default: booted)'),
@@ -93,7 +93,19 @@ export async function handleLocationRoute(args) {
     if (args.waypoints.length < 2) {
         return { content: [{ type: 'text', text: 'At least 2 waypoints required.' }] };
     }
-    const waypointData = args.waypoints.map(w => `${w.lat},${w.lng}`).join('\n') + '\n';
+    // Generate proper GPX XML for simctl location start (incremental timestamps for movement)
+    const baseTime = Date.now();
+    const gpxWaypoints = args.waypoints.map((w, i) => `      <trkpt lat="${w.lat}" lon="${w.lng}"><time>${new Date(baseTime + i * 1000).toISOString()}</time></trkpt>`).join('\n');
+    const gpxData = `<?xml version="1.0" encoding="UTF-8"?>
+<gpx version="1.1" creator="preflight-mcp">
+  <trk>
+    <name>Preflight Route</name>
+    <trkseg>
+${gpxWaypoints}
+    </trkseg>
+  </trk>
+</gpx>
+`;
     const cmdArgs = ['simctl', 'location', device, 'start'];
     if (args.speed)
         cmdArgs.push('--speed=' + args.speed);
@@ -109,7 +121,7 @@ export async function handleLocationRoute(args) {
                 else
                     reject(new Error(stderr || `exit code ${code}`));
             });
-            child.stdin.write(waypointData);
+            child.stdin.write(gpxData);
             child.stdin.end();
         });
         return {
@@ -184,25 +196,41 @@ export async function handleMemoryWarning(args) {
 }
 // --- biometric_enrollment ---
 export const biometricParams = {
-    enrolled: z.boolean().describe('Whether Face ID / Touch ID is enrolled'),
+    action: z.enum(['enroll', 'unenroll', 'match', 'fail']).optional().describe('"enroll" to enable biometrics, "unenroll" to disable, "match" to simulate successful auth, "fail" to simulate failed auth'),
+    enrolled: z.boolean().optional().describe('(Deprecated: use action instead) Whether Face ID / Touch ID is enrolled'),
     deviceId: z.string().optional().describe('Device (default: booted)'),
 };
 export async function handleBiometric(args) {
     const device = await resolveDevice(args.deviceId);
-    // Use notifyutil to toggle biometric enrollment
+    // Backward compat: map enrolled boolean to action
+    let action = args.action;
+    if (!action && args.enrolled !== undefined) {
+        action = args.enrolled ? 'enroll' : 'unenroll';
+    }
+    if (!action) {
+        return { content: [{ type: 'text', text: 'Provide action ("enroll", "unenroll", "match", or "fail") or enrolled (true/false).' }] };
+    }
     try {
-        const val = args.enrolled ? '1' : '0';
-        await execSimctl(['spawn', device, 'notifyutil', '-s', 'com.apple.BiometricKit.enrollmentChanged', val], 'tool:biometric');
-        return {
-            content: [{
-                    type: 'text',
-                    text: `Biometric enrollment set to ${args.enrolled ? 'enrolled' : 'not enrolled'}.`,
-                }],
-        };
+        switch (action) {
+            case 'enroll':
+                await execSimctl(['spawn', device, 'notifyutil', '-s', 'com.apple.BiometricKit.enrollmentChanged', '1'], 'tool:biometric');
+                return { content: [{ type: 'text', text: 'Biometric enrollment enabled (Face ID / Touch ID enrolled).' }] };
+            case 'unenroll':
+                await execSimctl(['spawn', device, 'notifyutil', '-s', 'com.apple.BiometricKit.enrollmentChanged', '0'], 'tool:biometric');
+                return { content: [{ type: 'text', text: 'Biometric enrollment disabled.' }] };
+            case 'match':
+                await execSimctl(['spawn', device, 'notifyutil', '-p', 'com.apple.BiometricKit_Sim.fingerTouch.match'], 'tool:biometric');
+                return { content: [{ type: 'text', text: 'Biometric match triggered — app should receive successful authentication.' }] };
+            case 'fail':
+                await execSimctl(['spawn', device, 'notifyutil', '-p', 'com.apple.BiometricKit_Sim.fingerTouch.nomatch'], 'tool:biometric');
+                return { content: [{ type: 'text', text: 'Biometric failure triggered — app should receive authentication failure.' }] };
+            default:
+                return { content: [{ type: 'text', text: `Unknown action: ${action}` }] };
+        }
     }
     catch (err) {
         const e = err;
-        return { content: [{ type: 'text', text: `Biometric enrollment change failed: ${e.message}. Use Simulator > Features > Face ID/Touch ID menu.` }] };
+        return { content: [{ type: 'text', text: `Biometric action failed: ${e.message}. Use Simulator > Features > Face ID/Touch ID menu as alternative.` }] };
     }
 }
 // --- network_status (read/display network configuration) ---
@@ -273,3 +301,114 @@ export async function handleDefaultsWrite(args) {
     await execSimctl(['spawn', device, 'defaults', 'write', args.domain, args.key, typeFlag, args.value], 'tool:defaultsWrite');
     return { content: [{ type: 'text', text: `Set ${args.domain}.${args.key} = ${args.value} (${args.type || 'string'})` }] };
 }
+// --- reduce_motion ---
+export const reduceMotionParams = {
+    enabled: z.boolean().describe('Enable or disable Reduce Motion accessibility setting'),
+    deviceId: z.string().optional().describe('Device (default: booted)'),
+};
+export async function handleReduceMotion(args) {
+    const device = await resolveDevice(args.deviceId);
+    await execSimctl(['spawn', device, 'defaults', 'write', 'com.apple.Accessibility', 'ReduceMotionEnabled', '-bool', args.enabled ? 'true' : 'false'], 'tool:reduceMotion');
+    await execSimctl(['spawn', device, 'notifyutil', '-p', 'com.apple.accessibility.reduceMotionStatusDidChange'], 'tool:reduceMotion');
+    return { content: [{ type: 'text', text: `Reduce Motion ${args.enabled ? 'enabled' : 'disabled'}.` }] };
+}
+// --- smart_invert ---
+export const smartInvertParams = {
+    enabled: z.boolean().describe('Enable or disable Smart Invert Colors'),
+    deviceId: z.string().optional().describe('Device (default: booted)'),
+};
+export async function handleSmartInvert(args) {
+    const device = await resolveDevice(args.deviceId);
+    await execSimctl(['spawn', device, 'defaults', 'write', 'com.apple.Accessibility', 'AXSSystemUIProcessAppSmartInvertEnabledPreference', '-bool', args.enabled ? 'true' : 'false'], 'tool:smartInvert');
+    await execSimctl(['spawn', device, 'notifyutil', '-p', 'com.apple.accessibility.invertColorsStatusDidChange'], 'tool:smartInvert');
+    return { content: [{ type: 'text', text: `Smart Invert ${args.enabled ? 'enabled' : 'disabled'}.` }] };
+}
+// --- bold_text ---
+export const boldTextParams = {
+    enabled: z.boolean().describe('Enable or disable Bold Text'),
+    deviceId: z.string().optional().describe('Device (default: booted)'),
+};
+export async function handleBoldText(args) {
+    const device = await resolveDevice(args.deviceId);
+    await execSimctl(['spawn', device, 'defaults', 'write', 'com.apple.Accessibility', 'BoldTextEnabled', '-bool', args.enabled ? 'true' : 'false'], 'tool:boldText');
+    await execSimctl(['spawn', device, 'notifyutil', '-p', 'com.apple.accessibility.boldTextStatusDidChange'], 'tool:boldText');
+    return { content: [{ type: 'text', text: `Bold Text ${args.enabled ? 'enabled' : 'disabled'}.` }] };
+}
+// --- reduce_transparency ---
+export const reduceTransparencyParams = {
+    enabled: z.boolean().describe('Enable or disable Reduce Transparency'),
+    deviceId: z.string().optional().describe('Device (default: booted)'),
+};
+export async function handleReduceTransparency(args) {
+    const device = await resolveDevice(args.deviceId);
+    await execSimctl(['spawn', device, 'defaults', 'write', 'com.apple.Accessibility', 'EnhancedBackgroundContrastEnabled', '-bool', args.enabled ? 'true' : 'false'], 'tool:reduceTransparency');
+    await execSimctl(['spawn', device, 'notifyutil', '-p', 'com.apple.accessibility.reduceTransparencyStatusDidChange'], 'tool:reduceTransparency');
+    return { content: [{ type: 'text', text: `Reduce Transparency ${args.enabled ? 'enabled' : 'disabled'}.` }] };
+}
+// --- rotate ---
+export const rotateParams = {
+    direction: z.enum(['left', 'right']).describe('Rotation direction'),
+    deviceId: z.string().optional().describe('Device (default: booted)'),
+};
+export async function handleRotate(args) {
+    await resolveDevice(args.deviceId);
+    // Cmd+Left/Right arrow in Simulator.app rotates the device
+    const keyCode = args.direction === 'left' ? 123 : 124; // left=123, right=124
+    const script = `
+tell application "Simulator" to activate
+delay 0.3
+tell application "System Events"
+  key code ${keyCode} using command down
+end tell`;
+    await runAppleScript(script, 'tool:rotate');
+    return { content: [{ type: 'text', text: `Device rotated ${args.direction}.` }] };
+}
+// --- notify_post ---
+export const notifyPostParams = {
+    notification: z.string().describe('Darwin notification name to post (e.g., "com.apple.MobileDataSettingsUpdated")'),
+    deviceId: z.string().optional().describe('Device (default: booted)'),
+};
+export async function handleNotifyPost(args) {
+    const device = await resolveDevice(args.deviceId);
+    await execSimctl(['spawn', device, 'notifyutil', '-p', args.notification], 'tool:notifyPost');
+    return { content: [{ type: 'text', text: `Darwin notification posted: ${args.notification}` }] };
+}
+// --- set_locale ---
+export const setLocaleParams = {
+    locale: z.string().describe('Locale identifier (e.g., "en_US", "ja_JP", "fr_FR", "de_DE")'),
+    language: z.string().optional().describe('Language identifier (e.g., "en", "ja", "fr"). If omitted, derived from locale'),
+    deviceId: z.string().optional().describe('Device (default: booted)'),
+};
+export async function handleSetLocale(args) {
+    const device = await resolveDevice(args.deviceId);
+    const lang = args.language || args.locale.split('_')[0];
+    await execSimctl(['spawn', device, 'defaults', 'write', '.GlobalPreferences', 'AppleLocale', '-string', args.locale], 'tool:setLocale');
+    await execSimctl(['spawn', device, 'defaults', 'write', '.GlobalPreferences', 'AppleLanguages', '-array', lang], 'tool:setLocale');
+    return {
+        content: [{
+                type: 'text',
+                text: `Locale set to "${args.locale}", language to "${lang}". Reboot the simulator for changes to take effect (use simulator_shutdown then simulator_boot).`,
+            }],
+    };
+}
+// --- trigger_siri ---
+export const triggerSiriParams = {
+    deviceId: z.string().optional().describe('Device (default: booted)'),
+};
+export async function handleTriggerSiri(args) {
+    await resolveDevice(args.deviceId);
+    const script = `
+tell application "Simulator" to activate
+delay 0.3
+tell application "System Events"
+  key code 49 using command down
+end tell`;
+    try {
+        await runAppleScript(script, 'tool:triggerSiri');
+        return { content: [{ type: 'text', text: 'Siri invoked (Cmd+Space). Use simulator_type_text to enter a query if text input is available.' }] };
+    }
+    catch (err) {
+        const e = err;
+        return { content: [{ type: 'text', text: `Failed to trigger Siri: ${e.message}` }] };
+    }
+}

package/dist/tools/debug.js

@@ -36,8 +36,24 @@ export async function handleGetLogs(args) {
     if (args.messageContains)
         predicateParts.push(`eventMessage CONTAINS "${esc(args.messageContains)}"`);
     const cmdArgs = ['simctl', 'spawn', device, 'log', 'show'];
-    if (args.level)
-        cmdArgs.push('--level', args.level);
+    // log show uses --debug/--info flags, not --level
+    if (args.level) {
+        switch (args.level) {
+            case 'debug':
+                cmdArgs.push('--debug');
+                break;
+            case 'info':
+                cmdArgs.push('--info');
+                break;
+            case 'error':
+                predicateParts.push('(messageType == error OR messageType == fault)');
+                break;
+            case 'fault':
+                predicateParts.push('messageType == fault');
+                break;
+            // 'default' needs no flag — it's the default behavior
+        }
+    }
     cmdArgs.push('--last', args.since || '1m');
     cmdArgs.push('--style', 'compact');
     if (predicateParts.length > 0) {
@@ -131,7 +147,25 @@ export async function handleStreamLogs(args) {
         while (buffer.length > maxLines)
             buffer.shift();
     });
+    child.on('error', (err) => {
+        buffer.push(`[error] Stream process error: ${err.message}`);
+    });
+    child.on('exit', (code, signal) => {
+        buffer.push(`[info] Stream process exited (code=${code}, signal=${signal})`);
+    });
     activeStreams.set(streamKey, { process: child, buffer, maxLines });
+    // Brief check to verify the process didn't die immediately
+    await new Promise(resolve => setTimeout(resolve, 200));
+    if (child.exitCode !== null) {
+        const output = buffer.join('\n');
+        activeStreams.delete(streamKey);
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Log stream failed to start (exit code ${child.exitCode}):\n${output}`,
+                }],
+        };
+    }
     return {
         content: [{
                 type: 'text',