codeloop-mcp-server 0.1.88 → 0.1.95

package/dist/runners/window_manager.d.ts

@@ -122,10 +122,17 @@ export declare function clickAtPosition(x: number, y: number): Promise<boolean>;
  * - Linux: X11 keysym name as string via keyName param, or keyCode ignored
  */
 export declare function sendKeystroke(keyCode: number, keyName?: string): Promise<boolean>;
-export declare function adbTap(x: number, y: number): Promise<boolean>;
-export declare function adbType(text: string): Promise<boolean>;
-export declare function adbKey(keycode: string): Promise<boolean>;
-export declare function adbSwipe(x1: number, y1: number, x2: number, y2: number, durationMs?: number): Promise<boolean>;
+/**
+ * Prefix adb args with `-s <serial>` when a device id is given, so every
+ * helper hits the SAME device the journey booted instead of whatever adb
+ * picks when several emulators/phones are attached ("more than one
+ * device/emulator" is a hard adb error).
+ */
+export declare function adbArgs(device: string | undefined, ...rest: string[]): string[];
+export declare function adbTap(x: number, y: number, device?: string): Promise<boolean>;
+export declare function adbType(text: string, device?: string): Promise<boolean>;
+export declare function adbKey(keycode: string, device?: string): Promise<boolean>;
+export declare function adbSwipe(x1: number, y1: number, x2: number, y2: number, durationMs?: number, device?: string): Promise<boolean>;
 /**
  * Read back on-screen text from a booted Android emulator/device by dumping
  * the uiautomator view hierarchy and extracting every `text=` / `content-desc=`
@@ -137,15 +144,15 @@ export declare function adbSwipe(x1: number, y1: number, x2: number, y2: number,
  * `filterSubstring` (optional): when given (e.g. a resource-id fragment or
  * expected phrase) only nodes whose text contains it are returned.
  */
-export declare function adbGetText(filterSubstring?: string): Promise<string | null>;
+export declare function adbGetText(filterSubstring?: string, device?: string): Promise<string | null>;
 /**
  * Pure parser for a uiautomator XML dump: returns the de-duped, in-order text /
  * content-desc values joined by newlines, optionally filtered to nodes whose
  * text contains `filterSubstring` (case-insensitive). Exported for testing.
  */
 export declare function extractUiAutomatorText(xml: string, filterSubstring?: string): string;
-export declare function simctlLaunch(bundleId: string): Promise<boolean>;
-export declare function simctlTerminate(bundleId: string): Promise<boolean>;
+export declare function simctlLaunch(bundleId: string, udid?: string): Promise<boolean>;
+export declare function simctlTerminate(bundleId: string, udid?: string): Promise<boolean>;
 /**
  * Launch a desktop application by name from a project directory.
  *
@@ -191,24 +198,47 @@ export declare function hoverAtPosition(x: number, y: number): Promise<boolean>;
 export declare function sendHotkey(combo: string): Promise<boolean>;
 export declare function dragDrop(x1: number, y1: number, x2: number, y2: number, durationMs?: number): Promise<boolean>;
 export declare function longPressAtPosition(x: number, y: number, durationMs?: number): Promise<boolean>;
-export declare function simctlTap(x: number, y: number): Promise<boolean>;
-export declare function simctlType(text: string): Promise<boolean>;
-export declare function simctlOpenUrl(url: string): Promise<boolean>;
-export declare function simctlBiometric(accept: boolean): Promise<boolean>;
-export declare function simctlSwipe(x1: number, y1: number, x2: number, y2: number, durationMs?: number): Promise<boolean>;
-export declare function simctlKey(keyName: string): Promise<boolean>;
-export declare function adbDeepLink(url: string): Promise<boolean>;
-export declare function adbPermission(packageId: string, permission: string, grant: boolean): Promise<boolean>;
-export declare function adbHomeButton(): Promise<boolean>;
-export declare function adbBackButton(): Promise<boolean>;
-export declare function adbRecentApps(): Promise<boolean>;
-export declare function adbNotificationShade(expand: boolean): Promise<boolean>;
-export declare function adbLongPress(x: number, y: number, durationMs?: number): Promise<boolean>;
-export declare function adbClearData(packageId: string): Promise<boolean>;
-export declare function adbInstallApk(apkPath: string): Promise<boolean>;
-export declare function adbNetworkCondition(mode: string): Promise<boolean>;
-export declare function adbMockLocation(lat: number, lng: number): Promise<boolean>;
-export declare function adbRotate(landscape: boolean): Promise<boolean>;
+export declare function simctlOpenUrl(url: string, udid?: string): Promise<boolean>;
+export declare function simctlBiometric(accept: boolean, udid?: string): Promise<boolean>;
+/** `simctl privacy <udid> grant|revoke <service> <bundle>` (photos, location, microphone, …). */
+export declare function simctlPermission(bundleId: string, service: string, grant: boolean, udid?: string): Promise<boolean>;
+/** `simctl location <udid> set <lat>,<lon>`. */
+export declare function simctlSetLocation(lat: number, lon: number, udid?: string): Promise<boolean>;
+/** `simctl uninstall <udid> <bundle>` — the iOS equivalent of `pm clear` (wipes data AND binary). */
+export declare function simctlUninstall(bundleId: string, udid?: string): Promise<boolean>;
+/**
+ * `simctl push <udid> <bundle> <payload.json>` — simulated remote push.
+ * `payload` may be a full APNs JSON string (must contain an `aps` key) or
+ * plain alert text which gets wrapped in a minimal aps payload.
+ */
+export declare function simctlPush(bundleId: string, payload: string, udid?: string): Promise<{
+    success: boolean;
+    detail: string;
+}>;
+/**
+ * `simctl status_bar <udid> override --time 9:41 …` for demo-clean
+ * screenshots, or `clear` when no overrides are given.
+ * `spec` is either JSON (`{"time":"9:41","batteryLevel":100}`) or a
+ * comma-separated `key=value` list (`time=9:41,batteryLevel=100`).
+ */
+export declare function simctlStatusBar(spec: string, udid?: string): Promise<{
+    success: boolean;
+    detail: string;
+}>;
+export declare function adbDeepLink(url: string, device?: string): Promise<boolean>;
+export declare function adbPermission(packageId: string, permission: string, grant: boolean, device?: string): Promise<boolean>;
+export declare function adbHomeButton(device?: string): Promise<boolean>;
+export declare function adbBackButton(device?: string): Promise<boolean>;
+export declare function adbRecentApps(device?: string): Promise<boolean>;
+export declare function adbNotificationShade(expand: boolean, device?: string): Promise<boolean>;
+export declare function adbLongPress(x: number, y: number, durationMs?: number, device?: string): Promise<boolean>;
+export declare function adbClearData(packageId: string, device?: string): Promise<boolean>;
+export declare function adbInstallApk(apkPath: string, device?: string): Promise<boolean>;
+/** True when an adb serial names an emulator (`emulator-5554`) rather than hardware. */
+export declare function isEmulatorSerial(serial: string | undefined): boolean;
+export declare function adbNetworkCondition(mode: string, device?: string): Promise<boolean>;
+export declare function adbMockLocation(lat: number, lng: number, device?: string): Promise<boolean>;
+export declare function adbRotate(landscape: boolean, device?: string): Promise<boolean>;
 export type TargetType = "desktop" | "android_emulator" | "ios_simulator" | "browser";
 /**
  * Check if a required external tool is installed.

package/dist/runners/window_manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"window_manager.d.ts","sourceRoot":"","sources":["../../src/runners/window_manager.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAG1E;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,KAAK,CAAC;IACb,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,IAAI,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,mBAAmB,CAAC;AAEnE,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAoBvF;AA+FD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA2BjE;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAgChE;AAiED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAKtE;AAkGD;;;;;;;;;GASG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;GAGG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAMnF;AAkKD;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA+C5E;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA6CvF;AAID,wBAAsB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGnE;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAI5D;AAED,wBAAsB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAG9D;AAED,wBAAsB,QAAQ,CAC5B,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,GAAE,MAAY,GACvE,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAqCjF;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,CAqBpF;AAcD,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGrE;AAED,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGxE;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA+NjF;AAyDD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGxD;AAED,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAE/C;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CASrE;AAID,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAyB7D;AAED,wBAAsB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,MAAM,GAAE,MAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAyD9I;AAED,wBAAsB,qBAAqB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAqDlF;AAED,wBAAsB,oBAAoB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA4CjF;AAED,wBAAsB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAiC5E;AAUD,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAiEhE;AAED,wBAAsB,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,GAAE,MAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAyDzH;AAED,wBAAsB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,UAAU,GAAE,MAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CA6C3G;AAID,wBAAsB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGtE;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAM/D;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGjE;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAKvE;AAED,wBAAsB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,SAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQpH;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGjE;AAID,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAG/D;AAED,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAI3G;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAEtD;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAEtD;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAEtD;AAED,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAI5E;AAED,wBAAsB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,UAAU,GAAE,MAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAEpG;AAED,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGtE;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGrE;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGxE;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGhF;AAED,wBAAsB,SAAS,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAKpE;AAID,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,kBAAkB,GAAG,eAAe,GAAG,SAAS,CAAC;AAoCtF;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAc1F;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAgC1E;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAa1E;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO1F;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAM9E;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA+B3E"}
+{"version":3,"file":"window_manager.d.ts","sourceRoot":"","sources":["../../src/runners/window_manager.ts"],"names":[],"mappings":"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"}

package/dist/runners/window_manager.js

@@ -669,26 +669,30 @@ Start-Sleep -Milliseconds 50
     return false;
 }
 // ── Mobile Interaction (Android emulator via ADB) ───────────────
-export async function adbTap(x, y) {
-    const result = await runCommand("adb", ["shell", "input", "tap", String(Math.round(x)), String(Math.round(y))], process.cwd());
+/**
+ * Prefix adb args with `-s <serial>` when a device id is given, so every
+ * helper hits the SAME device the journey booted instead of whatever adb
+ * picks when several emulators/phones are attached ("more than one
+ * device/emulator" is a hard adb error).
+ */
+export function adbArgs(device, ...rest) {
+    return device ? ["-s", device, ...rest] : rest;
+}
+export async function adbTap(x, y, device) {
+    const result = await runCommand("adb", adbArgs(device, "shell", "input", "tap", String(Math.round(x)), String(Math.round(y))), process.cwd());
     return result.exit_code === 0;
 }
-export async function adbType(text) {
+export async function adbType(text, device) {
     const escaped = text.replace(/ /g, "%s").replace(/'/g, "\\'");
-    const result = await runCommand("adb", ["shell", "input", "text", escaped], process.cwd());
+    const result = await runCommand("adb", adbArgs(device, "shell", "input", "text", escaped), process.cwd());
     return result.exit_code === 0;
 }
-export async function adbKey(keycode) {
-    const result = await runCommand("adb", ["shell", "input", "keyevent", keycode], process.cwd());
+export async function adbKey(keycode, device) {
+    const result = await runCommand("adb", adbArgs(device, "shell", "input", "keyevent", keycode), process.cwd());
     return result.exit_code === 0;
 }
-export async function adbSwipe(x1, y1, x2, y2, durationMs = 300) {
-    const result = await runCommand("adb", [
-        "shell", "input", "swipe",
-        String(Math.round(x1)), String(Math.round(y1)),
-        String(Math.round(x2)), String(Math.round(y2)),
-        String(durationMs),
-    ], process.cwd());
+export async function adbSwipe(x1, y1, x2, y2, durationMs = 300, device) {
+    const result = await runCommand("adb", adbArgs(device, "shell", "input", "swipe", String(Math.round(x1)), String(Math.round(y1)), String(Math.round(x2)), String(Math.round(y2)), String(durationMs)), process.cwd());
     return result.exit_code === 0;
 }
 /**
@@ -702,18 +706,18 @@ export async function adbSwipe(x1, y1, x2, y2, durationMs = 300) {
  * `filterSubstring` (optional): when given (e.g. a resource-id fragment or
  * expected phrase) only nodes whose text contains it are returned.
  */
-export async function adbGetText(filterSubstring) {
+export async function adbGetText(filterSubstring, device) {
     // Preferred: stream the dump straight back over exec-out (no device file).
     let xml = "";
-    const direct = await runCommand("adb", ["exec-out", "uiautomator", "dump", "/dev/tty"], process.cwd(), undefined, undefined, 20_000);
+    const direct = await runCommand("adb", adbArgs(device, "exec-out", "uiautomator", "dump", "/dev/tty"), process.cwd(), undefined, undefined, 20_000);
     if (direct.exit_code === 0 && direct.stdout.includes("<hierarchy")) {
         xml = direct.stdout;
     }
     else {
         // Fallback: dump to a device file, then read it back. Works on devices
         // whose toolbox build can't write to /dev/tty.
-        await runCommand("adb", ["shell", "uiautomator", "dump", "/sdcard/codeloop_ui.xml"], process.cwd(), undefined, undefined, 20_000);
-        const cat = await runCommand("adb", ["exec-out", "cat", "/sdcard/codeloop_ui.xml"], process.cwd(), undefined, undefined, 20_000);
+        await runCommand("adb", adbArgs(device, "shell", "uiautomator", "dump", "/sdcard/codeloop_ui.xml"), process.cwd(), undefined, undefined, 20_000);
+        const cat = await runCommand("adb", adbArgs(device, "exec-out", "cat", "/sdcard/codeloop_ui.xml"), process.cwd(), undefined, undefined, 20_000);
         if (cat.exit_code !== 0 || !cat.stdout.includes("<hierarchy"))
             return null;
         xml = cat.stdout;
@@ -758,12 +762,12 @@ function decodeXmlEntities(s) {
         .replace(/&apos;/g, "'");
 }
 // ── Mobile Interaction (iOS Simulator via simctl) ───────────────
-export async function simctlLaunch(bundleId) {
-    const result = await runCommand("xcrun", ["simctl", "launch", "booted", bundleId], process.cwd());
+export async function simctlLaunch(bundleId, udid = "booted") {
+    const result = await runCommand("xcrun", ["simctl", "launch", udid, bundleId], process.cwd());
     return result.exit_code === 0;
 }
-export async function simctlTerminate(bundleId) {
-    const result = await runCommand("xcrun", ["simctl", "terminate", "booted", bundleId], process.cwd());
+export async function simctlTerminate(bundleId, udid = "booted") {
+    const result = await runCommand("xcrun", ["simctl", "terminate", udid, bundleId], process.cwd());
     return result.exit_code === 0;
 }
 // ── Desktop App Launch (cross-OS) ────────────────────────────────
@@ -1550,88 +1554,184 @@ Start-Sleep -Milliseconds ${durationMs}
     return false;
 }
 // ── iOS Simulator Extended Interaction ──────────────────────────
-export async function simctlTap(x, y) {
-    const result = await runCommand("xcrun", ["simctl", "io", "booted", "tap", String(Math.round(x)), String(Math.round(y))], process.cwd());
+//
+// NOTE: coordinate input (tap/type/swipe/sendkey) is NOT part of
+// `simctl io` — those subcommands never existed in any Xcode. Real
+// iOS simulator input lives in ios_sim_input.ts (CGEvent window
+// mapping with optional idb backend). Only genuine simctl commands
+// (openurl / biometric / launch / terminate) remain here.
+export async function simctlOpenUrl(url, udid = "booted") {
+    const result = await runCommand("xcrun", ["simctl", "openurl", udid, url], process.cwd());
     return result.exit_code === 0;
 }
-export async function simctlType(text) {
-    for (const char of text) {
-        const result = await runCommand("xcrun", ["simctl", "io", "booted", "type", char], process.cwd());
-        if (result.exit_code !== 0)
-            return false;
-    }
-    return true;
-}
-export async function simctlOpenUrl(url) {
-    const result = await runCommand("xcrun", ["simctl", "openurl", "booted", url], process.cwd());
+export async function simctlBiometric(accept, udid = "booted") {
+    await runCommand("xcrun", ["simctl", "biometric", udid, "--state", "enrolled"], process.cwd());
+    const action = accept ? "--match" : "--no-match";
+    const result = await runCommand("xcrun", ["simctl", "biometric", udid, action], process.cwd());
     return result.exit_code === 0;
 }
-export async function simctlBiometric(accept) {
-    await runCommand("xcrun", ["simctl", "biometric", "booted", "--state", "enrolled"], process.cwd());
-    const action = accept ? "--match" : "--no-match";
-    const result = await runCommand("xcrun", ["simctl", "biometric", "booted", action], process.cwd());
+// ── Extended iOS (simctl) Helpers — P1.2 (0.1.91) ────────────────
+// Real device-fixture features that previously silently no-opped on iOS
+// (the interact switch only had Android branches for them).
+/** `simctl privacy <udid> grant|revoke <service> <bundle>` (photos, location, microphone, …). */
+export async function simctlPermission(bundleId, service, grant, udid = "booted") {
+    // Accept Android-style names so cross-platform journeys can reuse one
+    // value: "android.permission.ACCESS_FINE_LOCATION" → "location".
+    const normalized = service
+        .replace(/^android\.permission\./, "")
+        .replace(/^ACCESS_(FINE|COARSE)_LOCATION$/, "location")
+        .replace(/^RECORD_AUDIO$/, "microphone")
+        .replace(/^READ_MEDIA_IMAGES$/, "photos")
+        .toLowerCase();
+    const action = grant ? "grant" : "revoke";
+    const result = await runCommand("xcrun", ["simctl", "privacy", udid, action, normalized, bundleId], process.cwd());
     return result.exit_code === 0;
 }
-export async function simctlSwipe(x1, y1, x2, y2, durationMs = 300) {
-    const result = await runCommand("xcrun", [
-        "simctl", "io", "booted", "swipe",
-        String(Math.round(x1)), String(Math.round(y1)),
-        String(Math.round(x2)), String(Math.round(y2)),
-        "--duration", String(durationMs / 1000),
-    ], process.cwd());
+/** `simctl location <udid> set <lat>,<lon>`. */
+export async function simctlSetLocation(lat, lon, udid = "booted") {
+    const result = await runCommand("xcrun", ["simctl", "location", udid, "set", `${lat},${lon}`], process.cwd());
     return result.exit_code === 0;
 }
-export async function simctlKey(keyName) {
-    const result = await runCommand("xcrun", ["simctl", "io", "booted", "sendkey", keyName], process.cwd());
+/** `simctl uninstall <udid> <bundle>` — the iOS equivalent of `pm clear` (wipes data AND binary). */
+export async function simctlUninstall(bundleId, udid = "booted") {
+    const result = await runCommand("xcrun", ["simctl", "uninstall", udid, bundleId], process.cwd());
     return result.exit_code === 0;
 }
+/**
+ * `simctl push <udid> <bundle> <payload.json>` — simulated remote push.
+ * `payload` may be a full APNs JSON string (must contain an `aps` key) or
+ * plain alert text which gets wrapped in a minimal aps payload.
+ */
+export async function simctlPush(bundleId, payload, udid = "booted") {
+    let json;
+    try {
+        const parsed = JSON.parse(payload);
+        json = JSON.stringify(typeof parsed === "object" && parsed !== null && "aps" in parsed
+            ? parsed
+            : { aps: { alert: parsed } });
+    }
+    catch {
+        json = JSON.stringify({ aps: { alert: payload } });
+    }
+    const file = join(tmpdir(), `codeloop-push-${Date.now()}.json`);
+    try {
+        writeFileSync(file, json, "utf-8");
+        const result = await runCommand("xcrun", ["simctl", "push", udid, bundleId, file], process.cwd());
+        return {
+            success: result.exit_code === 0,
+            detail: result.exit_code === 0 ? `push delivered to ${bundleId}` : (result.stderr || result.stdout || "simctl push failed").trim(),
+        };
+    }
+    finally {
+        try {
+            unlinkSync(file);
+        }
+        catch { /* temp cleanup */ }
+    }
+}
+/** Allowed `simctl status_bar override` flags (value validation stays with simctl). */
+const STATUS_BAR_KEYS = new Set([
+    "time", "dataNetwork", "wifiMode", "wifiBars", "cellularMode", "cellularBars",
+    "operatorName", "batteryState", "batteryLevel",
+]);
+/**
+ * `simctl status_bar <udid> override --time 9:41 …` for demo-clean
+ * screenshots, or `clear` when no overrides are given.
+ * `spec` is either JSON (`{"time":"9:41","batteryLevel":100}`) or a
+ * comma-separated `key=value` list (`time=9:41,batteryLevel=100`).
+ */
+export async function simctlStatusBar(spec, udid = "booted") {
+    const trimmed = spec.trim();
+    if (!trimmed || trimmed === "clear") {
+        const result = await runCommand("xcrun", ["simctl", "status_bar", udid, "clear"], process.cwd());
+        return { success: result.exit_code === 0, detail: "status_bar cleared" };
+    }
+    let overrides;
+    try {
+        overrides = JSON.parse(trimmed);
+    }
+    catch {
+        overrides = {};
+        for (const pair of trimmed.split(",")) {
+            const [k, ...rest] = pair.split("=");
+            if (k && rest.length > 0)
+                overrides[k.trim()] = rest.join("=").trim();
+        }
+    }
+    const args = ["simctl", "status_bar", udid, "override"];
+    const unknown = [];
+    for (const [k, v] of Object.entries(overrides)) {
+        if (!STATUS_BAR_KEYS.has(k)) {
+            unknown.push(k);
+            continue;
+        }
+        args.push(`--${k}`, String(v));
+    }
+    if (args.length === 4) {
+        return {
+            success: false,
+            detail: `status_bar: no valid override keys in "${spec}". Supported: ${[...STATUS_BAR_KEYS].join(", ")}${unknown.length ? ` (unknown: ${unknown.join(", ")})` : ""}.`,
+        };
+    }
+    const result = await runCommand("xcrun", args, process.cwd());
+    return {
+        success: result.exit_code === 0,
+        detail: result.exit_code === 0
+            ? `status_bar override applied (${args.slice(4).filter((a) => a.startsWith("--")).map((a) => a.slice(2)).join(", ")})${unknown.length ? `; ignored unknown: ${unknown.join(", ")}` : ""}`
+            : (result.stderr || result.stdout || "simctl status_bar failed").trim(),
+    };
+}
 // ── Extended Android (adb) Helpers ──────────────────────────────
-export async function adbDeepLink(url) {
-    const result = await runCommand("adb", ["shell", "am", "start", "-a", "android.intent.action.VIEW", "-d", url], process.cwd());
+export async function adbDeepLink(url, device) {
+    const result = await runCommand("adb", adbArgs(device, "shell", "am", "start", "-a", "android.intent.action.VIEW", "-d", url), process.cwd());
     return result.exit_code === 0;
 }
-export async function adbPermission(packageId, permission, grant) {
+export async function adbPermission(packageId, permission, grant, device) {
     const action = grant ? "grant" : "revoke";
-    const result = await runCommand("adb", ["shell", "pm", action, packageId, permission], process.cwd());
+    const result = await runCommand("adb", adbArgs(device, "shell", "pm", action, packageId, permission), process.cwd());
     return result.exit_code === 0;
 }
-export async function adbHomeButton() {
-    return adbKey("KEYCODE_HOME");
+export async function adbHomeButton(device) {
+    return adbKey("KEYCODE_HOME", device);
 }
-export async function adbBackButton() {
-    return adbKey("KEYCODE_BACK");
+export async function adbBackButton(device) {
+    return adbKey("KEYCODE_BACK", device);
 }
-export async function adbRecentApps() {
-    return adbKey("KEYCODE_APP_SWITCH");
+export async function adbRecentApps(device) {
+    return adbKey("KEYCODE_APP_SWITCH", device);
 }
-export async function adbNotificationShade(expand) {
+export async function adbNotificationShade(expand, device) {
     const action = expand ? "expand-notifications" : "collapse";
-    const result = await runCommand("adb", ["shell", "cmd", "statusbar", action], process.cwd());
+    const result = await runCommand("adb", adbArgs(device, "shell", "cmd", "statusbar", action), process.cwd());
     return result.exit_code === 0;
 }
-export async function adbLongPress(x, y, durationMs = 1000) {
-    return adbSwipe(x, y, x, y, durationMs);
+export async function adbLongPress(x, y, durationMs = 1000, device) {
+    return adbSwipe(x, y, x, y, durationMs, device);
 }
-export async function adbClearData(packageId) {
-    const result = await runCommand("adb", ["shell", "pm", "clear", packageId], process.cwd());
+export async function adbClearData(packageId, device) {
+    const result = await runCommand("adb", adbArgs(device, "shell", "pm", "clear", packageId), process.cwd());
     return result.exit_code === 0;
 }
-export async function adbInstallApk(apkPath) {
-    const result = await runCommand("adb", ["install", "-r", apkPath], process.cwd());
+export async function adbInstallApk(apkPath, device) {
+    const result = await runCommand("adb", adbArgs(device, "install", "-r", apkPath), process.cwd());
     return result.exit_code === 0;
 }
-export async function adbNetworkCondition(mode) {
-    const result = await runCommand("adb", ["emu", "network", "speed", mode], process.cwd());
+/** True when an adb serial names an emulator (`emulator-5554`) rather than hardware. */
+export function isEmulatorSerial(serial) {
+    return serial == null || serial === "" || serial.startsWith("emulator-");
+}
+export async function adbNetworkCondition(mode, device) {
+    const result = await runCommand("adb", adbArgs(device, "emu", "network", "speed", mode), process.cwd());
     return result.exit_code === 0;
 }
-export async function adbMockLocation(lat, lng) {
-    const result = await runCommand("adb", ["emu", "geo", "fix", String(lng), String(lat)], process.cwd());
+export async function adbMockLocation(lat, lng, device) {
+    const result = await runCommand("adb", adbArgs(device, "emu", "geo", "fix", String(lng), String(lat)), process.cwd());
     return result.exit_code === 0;
 }
-export async function adbRotate(landscape) {
-    await runCommand("adb", ["shell", "settings", "put", "system", "accelerometer_rotation", "0"], process.cwd());
+export async function adbRotate(landscape, device) {
+    await runCommand("adb", adbArgs(device, "shell", "settings", "put", "system", "accelerometer_rotation", "0"), process.cwd());
     const rotation = landscape ? "1" : "0";
-    const result = await runCommand("adb", ["shell", "settings", "put", "system", "user_rotation", rotation], process.cwd());
+    const result = await runCommand("adb", adbArgs(device, "shell", "settings", "put", "system", "user_rotation", rotation), process.cwd());
     return result.exit_code === 0;
 }
 const INSTALL_INSTRUCTIONS = {