@tapflowio/ios-agent 0.1.0-alpha.1

package/dist/KeyCodeMap.js

@@ -0,0 +1,42 @@
+// USB HID Keyboard/Keypad Page (0x07) — KeyboardEvent.code → usage ID
+export const KEY_CODE_MAP = {
+    // Letters
+    KeyA: 0x04, KeyB: 0x05, KeyC: 0x06, KeyD: 0x07, KeyE: 0x08,
+    KeyF: 0x09, KeyG: 0x0A, KeyH: 0x0B, KeyI: 0x0C, KeyJ: 0x0D,
+    KeyK: 0x0E, KeyL: 0x0F, KeyM: 0x10, KeyN: 0x11, KeyO: 0x12,
+    KeyP: 0x13, KeyQ: 0x14, KeyR: 0x15, KeyS: 0x16, KeyT: 0x17,
+    KeyU: 0x18, KeyV: 0x19, KeyW: 0x1A, KeyX: 0x1B, KeyY: 0x1C, KeyZ: 0x1D,
+    // Digits
+    Digit1: 0x1E, Digit2: 0x1F, Digit3: 0x20, Digit4: 0x21, Digit5: 0x22,
+    Digit6: 0x23, Digit7: 0x24, Digit8: 0x25, Digit9: 0x26, Digit0: 0x27,
+    // Control keys
+    Enter: 0x28, Escape: 0x29, Backspace: 0x2A, Tab: 0x2B, Space: 0x2C,
+    // Punctuation
+    Minus: 0x2D, Equal: 0x2E, BracketLeft: 0x2F, BracketRight: 0x30,
+    Backslash: 0x31, Semicolon: 0x33, Quote: 0x34, Backquote: 0x35,
+    Comma: 0x36, Period: 0x37, Slash: 0x38,
+    // Lock / function keys
+    CapsLock: 0x39,
+    F1: 0x3A, F2: 0x3B, F3: 0x3C, F4: 0x3D, F5: 0x3E, F6: 0x3F,
+    F7: 0x40, F8: 0x41, F9: 0x42, F10: 0x43, F11: 0x44, F12: 0x45,
+    // Navigation
+    Delete: 0x4C, Home: 0x4A, End: 0x4D, PageUp: 0x4B, PageDown: 0x4E,
+    ArrowRight: 0x4F, ArrowLeft: 0x50, ArrowDown: 0x51, ArrowUp: 0x52,
+    // Numpad
+    NumpadDivide: 0x54, NumpadMultiply: 0x55, NumpadSubtract: 0x56,
+    NumpadAdd: 0x57, NumpadEnter: 0x58,
+    Numpad1: 0x59, Numpad2: 0x5A, Numpad3: 0x5B, Numpad4: 0x5C,
+    Numpad5: 0x5D, Numpad6: 0x5E, Numpad7: 0x5F, Numpad8: 0x60,
+    Numpad9: 0x61, Numpad0: 0x62, NumpadDecimal: 0x63,
+    // IME / language toggle keys (Korean 한/영 = Lang1, Hanja = Lang2)
+    Lang1: 0x90, Lang2: 0x91,
+    // Modifiers
+    ControlLeft: 0xE0, ShiftLeft: 0xE1, AltLeft: 0xE2, MetaLeft: 0xE3,
+    ControlRight: 0xE4, ShiftRight: 0xE5, AltRight: 0xE6, MetaRight: 0xE7,
+};
+// USB HID modifier bitmap (bit position per key)
+export const MODIFIER_BITS = {
+    ControlLeft: 0x01, ShiftLeft: 0x02, AltLeft: 0x04, MetaLeft: 0x08,
+    ControlRight: 0x10, ShiftRight: 0x20, AltRight: 0x40, MetaRight: 0x80,
+};
+//# sourceMappingURL=KeyCodeMap.js.map

package/dist/KeyCodeMap.js.map

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

package/dist/KeyboardHelperDaemon.d.ts

@@ -0,0 +1,13 @@
+export declare class KeyboardHelperDaemon {
+    private proc;
+    private pending;
+    private queue;
+    private draining;
+    show(udid: string): Promise<void>;
+    hide(udid: string): Promise<void>;
+    stop(): void;
+    private enqueue;
+    private drain;
+    private ensureStarted;
+}
+//# sourceMappingURL=KeyboardHelperDaemon.d.ts.map

package/dist/KeyboardHelperDaemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KeyboardHelperDaemon.d.ts","sourceRoot":"","sources":["../src/KeyboardHelperDaemon.ts"],"names":[],"mappings":"AAcA,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,IAAI,CAA4B;IACxC,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,KAAK,CAAuC;IACpD,OAAO,CAAC,QAAQ,CAAQ;IAExB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACjC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAEjC,IAAI,IAAI,IAAI;IAWZ,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,KAAK;IAiBb,OAAO,CAAC,aAAa;CAgDtB"}

package/dist/KeyboardHelperDaemon.js

@@ -0,0 +1,96 @@
+import { spawn } from 'child_process';
+import { createInterface } from 'readline';
+import { join } from 'path';
+import { createLogger } from '@tapflowio/agent-core';
+const logger = createLogger('ios-agent:keyboard-helper');
+const BINARY = join(import.meta.dirname, '..', 'bin', 'keyboard-helper');
+export class KeyboardHelperDaemon {
+    proc = null;
+    pending = null;
+    queue = [];
+    draining = false;
+    show(udid) { return this.enqueue(`show ${udid}`); }
+    hide(udid) { return this.enqueue(`hide ${udid}`); }
+    stop() {
+        this.proc?.kill();
+        this.proc = null;
+        const err = new Error('keyboard-helper daemon stopped');
+        this.pending?.reject(err);
+        this.pending = null;
+        for (const item of this.queue)
+            item.reject(err);
+        this.queue = [];
+        this.draining = false;
+    }
+    enqueue(cmd) {
+        return new Promise((resolve, reject) => {
+            this.queue.push({ cmd, resolve, reject });
+            this.drain();
+        });
+    }
+    drain() {
+        if (this.draining || this.queue.length === 0)
+            return;
+        this.draining = true;
+        const item = this.queue.shift();
+        this.pending = { resolve: item.resolve, reject: item.reject };
+        this.ensureStarted();
+        if (!this.proc?.stdin?.writable) {
+            const err = new Error('keyboard-helper stdin not writable');
+            this.pending.reject(err);
+            this.pending = null;
+            this.draining = false;
+            this.drain();
+            return;
+        }
+        this.proc.stdin.write(item.cmd + '\n');
+    }
+    ensureStarted() {
+        if (this.proc !== null)
+            return;
+        const proc = spawn(BINARY, ['--daemon'], { stdio: ['pipe', 'pipe', 'pipe'] });
+        this.proc = proc;
+        const rl = createInterface({ input: proc.stdout });
+        rl.on('line', (line) => {
+            const pending = this.pending;
+            this.pending = null;
+            this.draining = false;
+            if (!pending)
+                return;
+            if (line.startsWith('ok')) {
+                pending.resolve();
+            }
+            else {
+                pending.reject(new Error(line.replace(/^err\s*/, '') || 'keyboard-helper error'));
+            }
+            this.drain();
+        });
+        proc.stderr?.on('data', (d) => {
+            logger.error(d.toString().trim());
+        });
+        proc.on('exit', (code) => {
+            logger.error(`exited with code ${code ?? 'null'}`);
+            this.proc = null;
+            // reject any in-flight pending (rl 'line' won't fire after exit)
+            const pending = this.pending;
+            this.pending = null;
+            this.draining = false;
+            if (pending) {
+                pending.reject(new Error(`keyboard-helper exited with code ${code}`));
+                this.drain();
+            }
+        });
+        proc.on('error', (e) => {
+            logger.error(`spawn error: ${e.message}`);
+            this.proc = null;
+            const pending = this.pending;
+            this.pending = null;
+            this.draining = false;
+            if (pending) {
+                pending.reject(e);
+                this.drain();
+            }
+        });
+    }
+}
+//# sourceMappingURL=KeyboardHelperDaemon.js.map

package/dist/KeyboardHelperDaemon.js.map

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

package/dist/MjpegStreamer.d.ts

@@ -0,0 +1,10 @@
+import type { SimctlWrapper } from './SimctlWrapper.js';
+type Screenshottable = Pick<SimctlWrapper, 'screenshot'>;
+export declare class MjpegStreamer {
+    private readonly simctl;
+    private readonly intervalMs;
+    constructor(simctl: Screenshottable, intervalMs?: number);
+    start(): ReadableStream<Buffer>;
+}
+export {};
+//# sourceMappingURL=MjpegStreamer.d.ts.map

package/dist/MjpegStreamer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MjpegStreamer.d.ts","sourceRoot":"","sources":["../src/MjpegStreamer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEvD,KAAK,eAAe,GAAG,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,CAAA;AAExD,qBAAa,aAAa;IAEtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBADV,MAAM,EAAE,eAAe,EACvB,UAAU,GAAE,MAAY;IAG3C,KAAK,IAAI,cAAc,CAAC,MAAM,CAAC;CA8BhC"}

package/dist/MjpegStreamer.js

@@ -0,0 +1,40 @@
+export class MjpegStreamer {
+    simctl;
+    intervalMs;
+    constructor(simctl, intervalMs = 100) {
+        this.simctl = simctl;
+        this.intervalMs = intervalMs;
+    }
+    start() {
+        let timer = null;
+        let capturing = false;
+        return new ReadableStream({
+            start: (controller) => {
+                const capture = async () => {
+                    if (capturing)
+                        return;
+                    capturing = true;
+                    try {
+                        const frame = await this.simctl.screenshot();
+                        controller.enqueue(frame);
+                    }
+                    catch (err) {
+                        controller.error(err);
+                    }
+                    finally {
+                        capturing = false;
+                    }
+                };
+                void capture();
+                timer = setInterval(capture, this.intervalMs);
+            },
+            cancel: () => {
+                if (timer !== null) {
+                    clearInterval(timer);
+                    timer = null;
+                }
+            },
+        });
+    }
+}
+//# sourceMappingURL=MjpegStreamer.js.map

package/dist/MjpegStreamer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MjpegStreamer.js","sourceRoot":"","sources":["../src/MjpegStreamer.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,aAAa;IAEL;IACA;IAFnB,YACmB,MAAuB,EACvB,aAAqB,GAAG;QADxB,WAAM,GAAN,MAAM,CAAiB;QACvB,eAAU,GAAV,UAAU,CAAc;IACxC,CAAC;IAEJ,KAAK;QACH,IAAI,KAAK,GAA0C,IAAI,CAAA;QACvD,IAAI,SAAS,GAAG,KAAK,CAAA;QAErB,OAAO,IAAI,cAAc,CAAS;YAChC,KAAK,EAAE,CAAC,UAAU,EAAE,EAAE;gBACpB,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE;oBACzB,IAAI,SAAS;wBAAE,OAAM;oBACrB,SAAS,GAAG,IAAI,CAAA;oBAChB,IAAI,CAAC;wBACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAA;wBAC5C,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;oBAC3B,CAAC;oBAAC,OAAO,GAAG,EAAE,CAAC;wBACb,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;oBACvB,CAAC;4BAAS,CAAC;wBACT,SAAS,GAAG,KAAK,CAAA;oBACnB,CAAC;gBACH,CAAC,CAAA;gBAED,KAAK,OAAO,EAAE,CAAA;gBACd,KAAK,GAAG,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,CAAA;YAC/C,CAAC;YACD,MAAM,EAAE,GAAG,EAAE;gBACX,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBACnB,aAAa,CAAC,KAAK,CAAC,CAAA;oBACpB,KAAK,GAAG,IAAI,CAAA;gBACd,CAAC;YACH,CAAC;SACF,CAAC,CAAA;IACJ,CAAC;CACF"}

package/dist/ScreenCaptureStreamer.d.ts

@@ -0,0 +1,7 @@
+export declare class ScreenCaptureStreamer {
+    private readonly fps;
+    private readonly udid;
+    constructor(fps?: number, udid?: string);
+    start(): ReadableStream<Buffer>;
+}
+//# sourceMappingURL=ScreenCaptureStreamer.d.ts.map

package/dist/ScreenCaptureStreamer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScreenCaptureStreamer.d.ts","sourceRoot":"","sources":["../src/ScreenCaptureStreamer.ts"],"names":[],"mappings":"AAiCA,qBAAa,qBAAqB;IAE9B,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBADJ,GAAG,GAAE,MAAW,EAChB,IAAI,GAAE,MAAiB;IAG1C,KAAK,IAAI,cAAc,CAAC,MAAM,CAAC;CAuDhC"}

package/dist/ScreenCaptureStreamer.js

@@ -0,0 +1,92 @@
+import { spawn, execFileSync } from 'child_process';
+import { existsSync, statSync, unlinkSync } from 'fs';
+import { join } from 'path';
+import { createLogger } from '@tapflowio/agent-core';
+const logger = createLogger('ios-agent:screencapture');
+const SWIFT_SRC = join(import.meta.dirname, '..', 'src', 'screencapture-helper.swift');
+const BINARY = join(import.meta.dirname, '..', 'bin', 'screencapture-helper');
+function ensureCompiled() {
+    if (existsSync(BINARY)) {
+        // Swift source is not included in the published package — skip recompilation check
+        if (!existsSync(SWIFT_SRC))
+            return;
+        const srcMtime = statSync(SWIFT_SRC).mtimeMs;
+        const binMtime = statSync(BINARY).mtimeMs;
+        if (binMtime >= srcMtime)
+            return;
+        logger.info('Swift source changed, recompiling...');
+        unlinkSync(BINARY);
+    }
+    if (!existsSync(SWIFT_SRC)) {
+        throw new Error('screencapture-helper binary missing and Swift source not found — reinstall @tapflowio/ios-agent');
+    }
+    logger.info('compiling screencapture-helper...');
+    execFileSync('swiftc', [
+        SWIFT_SRC,
+        '-o', BINARY,
+        '-framework', 'CoreVideo',
+        '-framework', 'ImageIO',
+    ], { stdio: ['ignore', 'ignore', 'inherit'] });
+    logger.info('compiled OK');
+}
+export class ScreenCaptureStreamer {
+    fps;
+    udid;
+    constructor(fps = 30, udid = 'booted') {
+        this.fps = fps;
+        this.udid = udid;
+    }
+    start() {
+        ensureCompiled();
+        const proc = spawn(BINARY, [String(this.fps), this.udid], {
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        proc.stderr.on('data', (d) => process.stderr.write(d));
+        // done is hoisted so both start() and cancel() share the same flag
+        let done = false;
+        return new ReadableStream({
+            start(controller) {
+                let buf = Buffer.alloc(0);
+                const close = () => {
+                    if (done)
+                        return;
+                    done = true;
+                    controller.close();
+                };
+                const error = (e) => {
+                    if (done)
+                        return;
+                    done = true;
+                    controller.error(e);
+                };
+                proc.stdout.on('data', (chunk) => {
+                    if (done)
+                        return;
+                    buf = Buffer.concat([buf, chunk]);
+                    while (buf.length >= 4) {
+                        const frameLen = buf.readUInt32BE(0);
+                        if (buf.length < 4 + frameLen)
+                            break;
+                        controller.enqueue(buf.subarray(4, 4 + frameLen));
+                        buf = buf.subarray(4 + frameLen);
+                    }
+                });
+                proc.stdout.on('end', close);
+                proc.on('error', error);
+                proc.on('exit', (code) => {
+                    if (code !== null && code !== 0)
+                        error(new Error(`[ScreenCaptureStreamer] exited with code ${code}`));
+                    else
+                        close();
+                });
+            },
+            cancel() {
+                done = true;
+                proc.kill('SIGTERM');
+                const killTimer = setTimeout(() => proc.kill('SIGKILL'), 1000);
+                proc.once('exit', () => clearTimeout(killTimer));
+            },
+        });
+    }
+}
+//# sourceMappingURL=ScreenCaptureStreamer.js.map

package/dist/ScreenCaptureStreamer.js.map

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

package/dist/SimctlWrapper.d.ts

@@ -0,0 +1,21 @@
+import type { Device } from '@tapflowio/agent-core';
+import { type SimctlRunner } from './simctl.js';
+export declare class SimctlWrapper {
+    private readonly runner;
+    private readonly kbd;
+    constructor(runner?: SimctlRunner);
+    listDevices(): Promise<Device[]>;
+    boot(deviceId: string): Promise<void>;
+    shutdown(deviceId: string): Promise<void>;
+    erase(deviceId: string): Promise<void>;
+    uninstallApp(bundleId: string): Promise<void>;
+    installApp(appPath: string): Promise<void>;
+    launchApp(bundleId: string): Promise<void>;
+    screenshot(): Promise<Buffer>;
+    syncKeyboardsFromLanguages(udid: string): Promise<void>;
+    rotate(udid: string, orientation: 'portrait' | 'landscapeLeft' | 'landscapeRight' | 'portraitUpsideDown'): Promise<void>;
+    showSoftwareKeyboard(udid: string): Promise<void>;
+    hideSoftwareKeyboard(udid: string): Promise<void>;
+    stopKeyboardDaemon(): void;
+}
+//# sourceMappingURL=SimctlWrapper.d.ts.map

package/dist/SimctlWrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SimctlWrapper.d.ts","sourceRoot":"","sources":["../src/SimctlWrapper.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAAE,MAAM,EAAgB,MAAM,uBAAuB,CAAA;AACjE,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAA;AA4B9D,qBAAa,aAAa;IAGZ,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA6B;gBAEpB,MAAM,GAAE,YAA4B;IAE3D,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAuBhC,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAcrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1C,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1C,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAc7B,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BvD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,GAAG,eAAe,GAAG,gBAAgB,GAAG,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxH,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD,kBAAkB,IAAI,IAAI;CAG3B"}

package/dist/SimctlWrapper.js

@@ -0,0 +1,154 @@
+import { randomUUID } from 'crypto';
+import { execFile } from 'child_process';
+import { promisify } from 'util';
+import { promises as fs } from 'fs';
+import { tmpdir } from 'os';
+import { join } from 'path';
+const execFileAsync = promisify(execFile);
+const ROTATION_HELPER = join(import.meta.dirname, '..', 'bin', 'rotation-helper');
+// Language code → iOS AppleKeyboards entry string with hw=Automatic.
+// hw=Automatic lets iOS switch the hardware layout when the input source changes via LANG1/CapsLock.
+// hw=Korean (previous approach) locked the hardware layout to Korean regardless of active input source,
+// which caused the toggle HUD to appear but not actually change key output.
+const LANG_KEYBOARD_MAP = {
+    ko: 'ko_KR@sw=Korean;hw=Automatic',
+    ja: 'ja_JP@sw=Japanese-Kana;hw=Automatic',
+    zh: 'zh_Hans_CN@sw=ChineseSimplified-Pinyin;hw=Automatic',
+    fr: 'fr_FR@sw=French;hw=Automatic',
+    de: 'de_DE@sw=German;hw=Automatic',
+    es: 'es_ES@sw=Spanish;hw=Automatic',
+    it: 'it_IT@sw=Italian;hw=Automatic',
+    pt: 'pt_BR@sw=Portuguese;hw=Automatic',
+    ru: 'ru_RU@sw=Russian;hw=Automatic',
+    ar: 'ar@sw=Arabic;hw=Automatic',
+    th: 'th_TH@sw=Thai;hw=Automatic',
+};
+function langToKeyboard(lang) {
+    const code = lang.split('-')[0].toLowerCase();
+    return LANG_KEYBOARD_MAP[code] ?? 'en_US@sw=QWERTY;hw=Automatic';
+}
+import { defaultRunner } from './simctl.js';
+import { KeyboardHelperDaemon } from './KeyboardHelperDaemon.js';
+function toDeviceStatus(state) {
+    if (state === 'Booted')
+        return 'booted';
+    if (state === 'Shutdown')
+        return 'shutdown';
+    return 'unknown';
+}
+// "com.apple.CoreSimulator.SimRuntime.iOS-18-3" → "iOS 18.3"
+function parseOsVersion(runtimeKey) {
+    const m = runtimeKey.match(/\.([A-Za-z]+)-(\d+(?:-\d+)*)$/);
+    if (!m)
+        return undefined;
+    return `${m[1]} ${m[2].replace(/-/g, '.')}`;
+}
+export class SimctlWrapper {
+    runner;
+    kbd = new KeyboardHelperDaemon();
+    constructor(runner = defaultRunner) {
+        this.runner = runner;
+    }
+    async listDevices() {
+        const output = await this.runner.exec('list', 'devices', '--json');
+        const parsed = JSON.parse(output);
+        const devices = [];
+        for (const [runtimeKey, runtimeDevices] of Object.entries(parsed.devices)) {
+            const osVersion = parseOsVersion(runtimeKey);
+            for (const d of runtimeDevices) {
+                if (!d.isAvailable)
+                    continue;
+                devices.push({
+                    id: d.udid,
+                    name: d.name,
+                    platform: 'ios',
+                    status: toDeviceStatus(d.state),
+                    typeId: d.deviceTypeIdentifier,
+                    osVersion,
+                });
+            }
+        }
+        return devices;
+    }
+    async boot(deviceId) {
+        try {
+            await this.runner.exec('boot', deviceId);
+        }
+        catch (err) {
+            const stderr = err.stderr ?? '';
+            // already booted is not an error
+            if (stderr.includes('Unable to boot device in current state: Booted'))
+                return;
+            throw err;
+        }
+        // Xcode 14+ auto-opens Simulator.app on `simctl boot`.
+        // Quitting kills the simulator runtime, so just hide the app window instead.
+        execFile('osascript', ['-e', 'tell application "Simulator" to set visible to false'], () => { });
+    }
+    async shutdown(deviceId) {
+        await this.runner.exec('shutdown', deviceId);
+    }
+    async erase(deviceId) {
+        await this.runner.exec('erase', deviceId);
+    }
+    async uninstallApp(bundleId) {
+        await this.runner.exec('uninstall', 'booted', bundleId);
+    }
+    async installApp(appPath) {
+        await this.runner.exec('install', 'booted', appPath);
+    }
+    async launchApp(bundleId) {
+        await this.runner.exec('launch', 'booted', bundleId);
+    }
+    async screenshot() {
+        const tmpPath = `${tmpdir()}/tapflow-${randomUUID()}.png`;
+        try {
+            await this.runner.exec('io', 'booted', 'screenshot', tmpPath);
+            return await fs.readFile(tmpPath);
+        }
+        finally {
+            await fs.unlink(tmpPath).catch(() => { });
+        }
+    }
+    // Reads AppleLanguages from the simulator's Global Domain and rewrites AppleKeyboards
+    // so each entry uses hw=Automatic. This lets iOS switch hardware key layout when the
+    // user toggles the input source (via LANG1/CapsLock), fixing the iOS 15+ bug where
+    // hw=Korean locks the hardware layout regardless of the active input source.
+    async syncKeyboardsFromLanguages(udid) {
+        let languages;
+        try {
+            const out = await this.runner.exec('spawn', udid, 'defaults', 'read', '-g', 'AppleLanguages');
+            // Output: (\n    "ko-KR",\n    "en-US"\n)
+            languages = [...out.matchAll(/"([^"]+)"/g)].map((m) => m[1]);
+        }
+        catch {
+            languages = [];
+        }
+        if (languages.length === 0)
+            return;
+        // Always include English as a fallback so the English QWERTY keyboard is available.
+        const hasEnglish = languages.some((l) => l.toLowerCase().startsWith('en'));
+        const allLangs = hasEnglish ? languages : [...languages, 'en-US'];
+        const keyboards = [...new Set([...allLangs.map(langToKeyboard), 'emoji@sw=Emoji'])];
+        await this.runner.exec('spawn', udid, 'defaults', 'write', '-g', 'AppleKeyboards', '-array', ...keyboards);
+        // Restart the keyboard daemon so it picks up the new settings immediately.
+        // Errors are silently ignored — changes will take effect on next text field focus if the daemon isn't running yet.
+        try {
+            await this.runner.exec('spawn', udid, 'launchctl', 'kickstart', '-k', 'system/com.apple.kbd');
+        }
+        catch { /* expected on some iOS versions */ }
+    }
+    async rotate(udid, orientation) {
+        await execFileAsync(ROTATION_HELPER, [orientation, udid]);
+    }
+    async showSoftwareKeyboard(udid) {
+        await this.kbd.show(udid);
+    }
+    async hideSoftwareKeyboard(udid) {
+        await this.kbd.hide(udid);
+    }
+    stopKeyboardDaemon() {
+        this.kbd.stop();
+    }
+}
+//# sourceMappingURL=SimctlWrapper.js.map

package/dist/SimctlWrapper.js.map

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

package/dist/TouchHelper.d.ts

@@ -0,0 +1,21 @@
+export declare class TouchHelper {
+    private readonly udid;
+    private proc;
+    private lastX;
+    private lastY;
+    constructor(udid: string);
+    start(): void;
+    stop(): void;
+    touchStart(x: number, y: number): void;
+    touchMove(x: number, y: number): void;
+    touchEnd(): void;
+    pressButton(usagePage: number, usage: number): void;
+    pressLegacyButton(code: number): void;
+    pinchStart(x1: number, y1: number, x2: number, y2: number): void;
+    pinchMove(x1: number, y1: number, x2: number, y2: number): void;
+    pinchEnd(): void;
+    sendKey(usage: number, modifiers?: number): void;
+    private writeTwoFinger;
+    private write;
+}
+//# sourceMappingURL=TouchHelper.d.ts.map

package/dist/TouchHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TouchHelper.d.ts","sourceRoot":"","sources":["../src/TouchHelper.ts"],"names":[],"mappings":"AAQA,qBAAa,WAAW;IAKV,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJjC,OAAO,CAAC,IAAI,CAA4B;IACxC,OAAO,CAAC,KAAK,CAAI;IACjB,OAAO,CAAC,KAAK,CAAI;gBAEY,IAAI,EAAE,MAAM;IAEzC,KAAK,IAAI,IAAI;IAgBb,IAAI,IAAI,IAAI;IAKZ,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAMtC,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAMrC,QAAQ,IAAI,IAAI;IAIhB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAUnD,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IASrC,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAIhE,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAI/D,QAAQ,IAAI,IAAI;IAOhB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,SAAI,GAAG,IAAI;IAY3C,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,KAAK;CAQd"}