@tapflowio/ios-agent 0.18.0 → 0.19.0

package/dist/TouchHelper.d.ts

@@ -1,24 +1,63 @@
 export declare class TouchHelper {
     private readonly udid;
     private proc;
+    private gestureProc;
     private lastX;
     private lastY;
+    private stopped;
+    private ready;
+    private readyTimer;
+    private spawns;
     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;
-    private writeButtonOp;
-    pressButtonDown(usagePage: number, usage: number): void;
-    pressButtonUp(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;
+    isReady(): boolean;
+    private isRunning;
+    /**
+     * Why a write would be refused right now, for the ack to report.
+     *
+     * `starting` is the state that had no name: measured 186–247ms after spawn, the pipe is open and
+     * frames written to it land nowhere, and a caller that retries a moment later succeeds. Answering
+     * "no channel" for it — which is what a bare boolean forced — told the caller to reconnect when it
+     * should simply have waited.
+     *
+     * Safe to read at the ack site rather than inside the write: writes here are synchronous, so
+     * nothing can have changed between the two.
+     */
+    inputState(): 'ready' | 'starting' | 'unavailable';
+    /**
+     * Whether a gesture is currently owned by the live process — i.e. whether a continuation frame
+     * could land at all.
+     *
+     * Separate from `inputState()` because the two answer questions decided at different times.
+     * Readiness is about now; ownership was decided when the opening frame was written. A gesture whose
+     * open was refused (during the start-up window, say) leaves nothing owned, and no amount of waiting
+     * makes its terminal frame deliverable — the caller has to open a new gesture. Reading readiness
+     * alone at the ack site turned that into "the message is malformed, never retry".
+     */
+    ownsGesture(): boolean;
+    touchStart(x: number, y: number): boolean;
+    touchMove(x: number, y: number): boolean;
+    touchEnd(): boolean;
+    pressButton(usagePage: number, usage: number): boolean;
+    pressButtonDown(usagePage: number, usage: number): boolean;
+    pressButtonUp(usagePage: number, usage: number): boolean;
+    pressLegacyButton(code: number): boolean;
+    pinchStart(x1: number, y1: number, x2: number, y2: number): boolean;
+    pinchMove(x1: number, y1: number, x2: number, y2: number): boolean;
+    pinchEnd(): boolean;
+    sendKey(usage: number, modifiers?: number): boolean;
+    private coordFrame;
+    private buttonFrame;
+    private twoFingerFrame;
+    private sendSelfContained;
+    private openGesture;
+    private continueGesture;
+    private send;
+    private armReadyDeadline;
+    private clearReadyDeadline;
+    private respawn;
+    private spawnHelper;
+    private handleDeath;
 }
 //# sourceMappingURL=TouchHelper.d.ts.map

package/dist/TouchHelper.d.ts.map

@@ -1 +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;IAYnD,OAAO,CAAC,aAAa;IASrB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIvD,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAKrD,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"}
+{"version":3,"file":"TouchHelper.d.ts","sourceRoot":"","sources":["../src/TouchHelper.ts"],"names":[],"mappings":"AAiCA,qBAAa,WAAW;IAYV,OAAO,CAAC,QAAQ,CAAC,IAAI;IAXjC,OAAO,CAAC,IAAI,CAA4B;IAGxC,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,KAAK,CAAI;IACjB,OAAO,CAAC,KAAK,CAAI;IACjB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,UAAU,CAA6C;IAC/D,OAAO,CAAC,MAAM,CAAe;gBAEA,IAAI,EAAE,MAAM;IAEzC,KAAK,IAAI,IAAI;IAKb,IAAI,IAAI,IAAI;IAWZ,OAAO,IAAI,OAAO;IAOlB,OAAO,CAAC,SAAS;IAIjB;;;;;;;;;;OAUG;IACH,UAAU,IAAI,OAAO,GAAG,UAAU,GAAG,aAAa;IAKlD;;;;;;;;;OASG;IACH,WAAW,IAAI,OAAO;IAItB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO;IAMzC,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO;IAMxC,QAAQ,IAAI,OAAO;IAInB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAOtD,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAQ1D,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAKxD,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIxC,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO;IAInE,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO;IAIlE,QAAQ,IAAI,OAAO;IAOnB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,SAAI,GAAG,OAAO;IAW9C,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,WAAW;IAoBnB,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,IAAI;IAQZ,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,OAAO;IAQf,OAAO,CAAC,WAAW;IAsDnB,OAAO,CAAC,WAAW;CAMpB"}

package/dist/TouchHelper.js

@@ -1,100 +1,144 @@
 import { spawn } from 'child_process';
 import { join } from 'path';
 import { createLogger } from '@tapflowio/agent-core';
+import { killWithSigkillFallback } from './childProcessKill.js';
 const logger = createLogger('ios-agent:touch-helper');
 const BINARY = join(import.meta.dirname, '..', 'bin', 'touch-helper');
+// At most this many spawns in any window of this length. A rolling window rather than a count
+// of consecutive failures: the helper's start-up is expensive (a subprocess, two dlopens, a
+// device lookup), so "it failed quickly" cannot be told apart from "it failed slowly" without
+// guessing how long start-up takes — and a helper that reliably dies just after that guess would
+// reset a consecutive counter forever and churn processes for the life of the agent. A window
+// bounds it whatever the lifetime, and it self-clears, so a session that briefly could not start
+// a helper is not stuck without input until the device is rebooted.
+const RESPAWN_LIMIT = 3;
+const RESPAWN_WINDOW_MS = 30_000;
+// The helper announces itself on stderr once it holds its HID client and is about to start
+// reading stdin (`touch-helper.swift:281`). Measured against a real simulator: 186–247ms after
+// spawn (n=5), and a gesture written before it lands *nothing* — the frames are buffered by the
+// pipe and then drained in one go, which collapses a swipe into microseconds and iOS reads it as
+// no gesture at all. So "the pipe is open" is not the same as "the device will act on this", and
+// reporting the first as success is the same lie as #482 in a narrower window.
+const READY_MARKER = 'touch-helper ready';
+// A helper that wedges *before* announcing would otherwise never be replaced: it is running, so
+// nothing asks for a new one, and it is not ready, so every input is refused — honestly, but
+// forever. The announcement comes after a device lookup through CoreSimulator, which is where a
+// wedge would sit. Measured start-up is 186–247ms, so this is roughly twenty times the worst case
+// observed rather than a tight bound.
+const READY_DEADLINE_MS = 5_000;
 export class TouchHelper {
     udid;
     proc = null;
+    // The process that received the current gesture's opening frame. Mid-gesture frames are only
+    // meaningful to that one, so they are checked against it rather than against liveness alone.
+    gestureProc = null;
     lastX = 0;
     lastY = 0;
+    stopped = false;
+    ready = false;
+    readyTimer = null;
+    spawns = [];
     constructor(udid) {
         this.udid = udid;
     }
     start() {
-        const bin = BINARY;
-        this.proc = spawn(bin, [this.udid], { stdio: ['pipe', 'ignore', 'pipe'] });
-        this.proc.stderr?.on('data', (d) => {
-            const msg = d.toString().trim();
-            // print all lines, even debug: lines, until we're confident it's working
-            logger.error(msg);
-        });
-        this.proc.on('exit', (code) => {
-            logger.error(`exited with code ${code ?? 'null'}`);
-        });
-        this.proc.on('error', (e) => {
-            logger.error(`spawn error: ${e.message}`);
-        });
+        this.stopped = false;
+        this.spawnHelper();
     }
     stop() {
-        this.proc?.kill();
+        this.stopped = true;
+        this.clearReadyDeadline();
+        killWithSigkillFallback(this.proc);
         this.proc = null;
+        this.gestureProc = null;
+    }
+    // Whether an input written right now actually reaches the device. Two conditions, and they are
+    // deliberately not the same question as `isRunning()`: a helper that is still starting up is
+    // very much alive and must not be replaced, but a frame written to it is dropped on the floor.
+    isReady() {
+        return this.isRunning() && this.ready;
+    }
+    // Whether the helper process exists with an open pipe — the question a *replacement* decision
+    // asks. `this.proc` only ever holds a process that execed (`spawnHelper` is the gate), so from
+    // here on stdin closing is what death looks like.
+    isRunning() {
+        return this.proc?.stdin?.writable === true;
+    }
+    /**
+     * Why a write would be refused right now, for the ack to report.
+     *
+     * `starting` is the state that had no name: measured 186–247ms after spawn, the pipe is open and
+     * frames written to it land nowhere, and a caller that retries a moment later succeeds. Answering
+     * "no channel" for it — which is what a bare boolean forced — told the caller to reconnect when it
+     * should simply have waited.
+     *
+     * Safe to read at the ack site rather than inside the write: writes here are synchronous, so
+     * nothing can have changed between the two.
+     */
+    inputState() {
+        if (this.isReady())
+            return 'ready';
+        return this.isRunning() ? 'starting' : 'unavailable';
+    }
+    /**
+     * Whether a gesture is currently owned by the live process — i.e. whether a continuation frame
+     * could land at all.
+     *
+     * Separate from `inputState()` because the two answer questions decided at different times.
+     * Readiness is about now; ownership was decided when the opening frame was written. A gesture whose
+     * open was refused (during the start-up window, say) leaves nothing owned, and no amount of waiting
+     * makes its terminal frame deliverable — the caller has to open a new gesture. Reading readiness
+     * alone at the ack site turned that into "the message is malformed, never retry".
+     */
+    ownsGesture() {
+        return this.proc !== null && this.proc === this.gestureProc;
     }
     touchStart(x, y) {
         this.lastX = x;
         this.lastY = y;
-        this.write(1, x, y);
+        return this.openGesture(this.coordFrame(1, x, y));
     }
     touchMove(x, y) {
         this.lastX = x;
         this.lastY = y;
-        this.write(2, x, y);
+        return this.continueGesture(this.coordFrame(2, x, y));
     }
     touchEnd() {
-        this.write(3, this.lastX, this.lastY);
+        return this.continueGesture(this.coordFrame(3, this.lastX, this.lastY));
     }
     pressButton(usagePage, usage) {
-        if (!this.proc?.stdin?.writable)
-            return;
-        const buf = Buffer.allocUnsafe(9);
-        buf.writeUInt8(4, 0);
-        buf.writeUInt32BE(usagePage, 1);
-        buf.writeUInt32BE(usage, 5);
-        this.proc.stdin.write(buf);
+        return this.sendSelfContained(this.buttonFrame(4, usagePage, usage));
     }
     // Real-time button hold: down + up sent as separate frames so the hold lasts as long as
     // the user holds the button in the dashboard (e.g. Action button long-press). type 4 above
     // remains the fixed short-press path.
-    writeButtonOp(type, usagePage, usage) {
-        if (!this.proc?.stdin?.writable)
-            return;
-        const buf = Buffer.allocUnsafe(9);
-        buf.writeUInt8(type, 0);
-        buf.writeUInt32BE(usagePage, 1);
-        buf.writeUInt32BE(usage, 5);
-        this.proc.stdin.write(buf);
-    }
     pressButtonDown(usagePage, usage) {
-        this.writeButtonOp(10, usagePage, usage);
+        return this.sendSelfContained(this.buttonFrame(10, usagePage, usage));
     }
+    // Self-contained despite being the tail of a pair: the helper keeps no record of which
+    // buttons are down (`touch-helper.swift` sends one op per frame), so a fresh process serves
+    // this exactly as the old one would have. Refusing it would be worse — a `down` that reached
+    // a live helper could then never be released.
     pressButtonUp(usagePage, usage) {
-        this.writeButtonOp(11, usagePage, usage);
+        return this.sendSelfContained(this.buttonFrame(11, usagePage, usage));
     }
     // Legacy path for home (code=0) and lock (code=1) buttons
     pressLegacyButton(code) {
-        if (!this.proc?.stdin?.writable)
-            return;
-        const buf = Buffer.allocUnsafe(9);
-        buf.writeUInt8(5, 0);
-        buf.writeUInt32BE(code, 1);
-        buf.writeUInt32BE(0, 5);
-        this.proc.stdin.write(buf);
+        return this.sendSelfContained(this.buttonFrame(5, code, 0));
     }
     pinchStart(x1, y1, x2, y2) {
-        this.writeTwoFinger(6, x1, y1, x2, y2);
+        return this.openGesture(this.twoFingerFrame(6, x1, y1, x2, y2));
     }
     pinchMove(x1, y1, x2, y2) {
-        this.writeTwoFinger(7, x1, y1, x2, y2);
+        return this.continueGesture(this.twoFingerFrame(7, x1, y1, x2, y2));
     }
     pinchEnd() {
-        this.writeTwoFinger(8, 0, 0, 0, 0);
+        return this.continueGesture(this.twoFingerFrame(8, 0, 0, 0, 0));
     }
     // HID keyboard — type 9 frame: [9][modifiers][pad x3][usage:u32BE]
     // modifiers: USB HID modifier bitmap (0x01=LeftCtrl, 0x02=LeftShift, 0x04=LeftAlt, 0x08=LeftMeta, …)
     // usage: keyboard usage code from HID Keyboard/Keypad page (0x07)
     sendKey(usage, modifiers = 0) {
-        if (!this.proc?.stdin?.writable)
-            return;
         const buf = Buffer.allocUnsafe(9);
         buf.writeUInt8(9, 0);
         buf.writeUInt8(modifiers, 1);
@@ -102,27 +146,161 @@ export class TouchHelper {
         buf.writeUInt8(0, 3);
         buf.writeUInt8(0, 4);
         buf.writeUInt32BE(usage, 5);
-        this.proc.stdin.write(buf);
+        return this.sendSelfContained(buf);
     }
-    writeTwoFinger(type, x1, y1, x2, y2) {
-        if (!this.proc?.stdin?.writable)
-            return;
+    coordFrame(type, x, y) {
+        const buf = Buffer.allocUnsafe(9);
+        buf.writeUInt8(type, 0);
+        buf.writeFloatBE(x, 1);
+        buf.writeFloatBE(y, 5);
+        return buf;
+    }
+    buttonFrame(type, a, b) {
+        const buf = Buffer.allocUnsafe(9);
+        buf.writeUInt8(type, 0);
+        buf.writeUInt32BE(a, 1);
+        buf.writeUInt32BE(b, 5);
+        return buf;
+    }
+    twoFingerFrame(type, x1, y1, x2, y2) {
         const buf = Buffer.allocUnsafe(17);
         buf.writeUInt8(type, 0);
         buf.writeFloatBE(x1, 1);
         buf.writeFloatBE(y1, 5);
         buf.writeFloatBE(x2, 9);
         buf.writeFloatBE(y2, 13);
-        this.proc.stdin.write(buf);
+        return buf;
+    }
+    // Frames that carry their whole payload: a dead helper is replaced before the frame goes out,
+    // so input recovers rather than staying dead for the rest of the session (#482).
+    sendSelfContained(buf) {
+        // `isRunning`, not `isReady`: replacing a helper that is merely still starting up would spawn
+        // a second one, burn the window budget, and make the wait longer rather than shorter.
+        if (!this.isRunning())
+            this.respawn();
+        return this.send(buf);
+    }
+    // A gesture's opening frame. Self-contained, and it records which process is serving the
+    // gesture so the frames that follow can be held to it.
+    openGesture(buf) {
+        const sent = this.sendSelfContained(buf);
+        // Only a *delivered* open owns the gesture. Recording unconditionally looks equivalent and is
+        // not: during the start-up window the open is refused while `this.proc` is a healthy process
+        // that becomes ready ~200ms later, so identity would then pass and the rest of the gesture
+        // would reach a process that never received the down — a release at (0,0) reported as
+        // delivered, which is the exact defect this guard exists to prevent.
+        this.gestureProc = sent ? this.proc : null;
+        return sent;
+    }
+    // Everything after the opening frame. These are meaningless to any other process: types 3 and
+    // 8 inject coordinate latches the helper accumulated (`lastX/lastY`, `pinchLast*`) — a pinch
+    // end's own coordinates are all zero for exactly that reason — and a type 2 or 7 move with no
+    // preceding down is not the gesture the tester made.
+    //
+    // Checking liveness is not enough. Replacement is eager, so by the time a terminal frame
+    // arrives after a mid-gesture death there is usually a healthy process to write to, and a
+    // fresh one has those latches at zero: the tap would be released at (0,0) and reported as
+    // delivered. Identity is what the guard has to be about.
+    continueGesture(buf) {
+        if (this.proc === null || this.proc !== this.gestureProc)
+            return false;
+        return this.send(buf);
     }
-    write(type, x, y) {
-        if (!this.proc?.stdin?.writable)
+    send(buf) {
+        if (!this.isReady())
+            return false;
+        // A `false` from write() is backpressure: node buffers the frame and flushes it when the
+        // pipe drains, so it does not mean the input was dropped.
+        this.proc?.stdin?.write(buf);
+        return true;
+    }
+    armReadyDeadline(proc) {
+        this.clearReadyDeadline();
+        const timer = setTimeout(() => {
+            if (this.proc !== proc || this.ready)
+                return;
+            logger.error(`no readiness announcement within ${READY_DEADLINE_MS}ms — replacing the helper`);
+            killWithSigkillFallback(proc);
+            // Through the same path as a real death, so the replacement is subject to the same window.
+            this.handleDeath(proc);
+        }, READY_DEADLINE_MS);
+        timer.unref?.();
+        this.readyTimer = timer;
+    }
+    clearReadyDeadline() {
+        if (this.readyTimer) {
+            clearTimeout(this.readyTimer);
+            this.readyTimer = null;
+        }
+    }
+    respawn() {
+        if (this.stopped)
             return;
-        const buf = Buffer.allocUnsafe(9);
-        buf.writeUInt8(type, 0);
-        buf.writeFloatBE(x, 1);
-        buf.writeFloatBE(y, 5);
-        this.proc.stdin.write(buf);
+        const now = Date.now();
+        this.spawns = this.spawns.filter((t) => now - t < RESPAWN_WINDOW_MS);
+        if (this.spawns.length >= RESPAWN_LIMIT)
+            return;
+        this.spawnHelper();
+    }
+    spawnHelper() {
+        const proc = spawn(BINARY, [this.udid], { stdio: ['pipe', 'ignore', 'pipe'] });
+        this.spawns.push(Date.now());
+        this.ready = false;
+        // The one place that decides whether a spawn counts as a helper, and it has to decide
+        // synchronously: the frame that triggered this spawn is written immediately after.
+        //
+        // A pid is the only signal available that early. When the exec fails — binary missing, no
+        // execute bit, wrong architecture (#464) — libuv still hands back an open stdin pipe and
+        // reports the failure on a LATER tick. Measured against a real spawn of a nonexistent path,
+        // `stdin.writable` is `true` on a process that does not exist, and `stdin.write()` returning
+        // `false` is indistinguishable from ordinary backpressure on a healthy helper. A pid is
+        // assigned only once the exec succeeded.
+        if (proc.pid === undefined) {
+            proc.on('error', (e) => logger.error(`spawn error: ${e.message}`));
+            this.proc = null;
+            return;
+        }
+        this.proc = proc;
+        this.armReadyDeadline(proc);
+        // Cap what is retained: the marker is short, and a helper that never announces itself can
+        // still emit warnings indefinitely.
+        let tail = '';
+        proc.stderr?.on('data', (d) => {
+            const msg = d.toString();
+            // Guarded on identity so a superseded process's late announcement cannot mark a newer one
+            // ready.
+            if (!this.ready && this.proc === proc) {
+                const seen = tail + msg;
+                if (seen.includes(READY_MARKER)) {
+                    this.ready = true;
+                    tail = '';
+                    this.clearReadyDeadline();
+                    // Retain only enough to rejoin a marker split across two chunks.
+                }
+                else
+                    tail = seen.slice(-READY_MARKER.length);
+            }
+            // print all lines, even debug: lines, until we're confident it's working
+            logger.error(msg.trim());
+        });
+        proc.on('exit', (code) => {
+            logger.error(`exited with code ${code ?? 'null'}`);
+            this.handleDeath(proc);
+        });
+        proc.on('error', (e) => {
+            logger.error(`spawn error: ${e.message}`);
+            this.handleDeath(proc);
+        });
+    }
+    // Replace the helper as soon as it dies rather than on the next input. Waiting would make
+    // the first tap after a death pay the whole start-up cost (xcode-select, two dlopens, a
+    // device lookup), and that tap is the one the tester is watching.
+    handleDeath(proc) {
+        if (this.proc !== proc)
+            return; // superseded by a newer spawn, or stop() already cleared it
+        this.clearReadyDeadline();
+        this.proc = null;
+        this.respawn();
     }
 }
 //# sourceMappingURL=TouchHelper.js.map

package/dist/TouchHelper.js.map

@@ -1 +1 @@
-{"version":3,"file":"TouchHelper.js","sourceRoot":"","sources":["../src/TouchHelper.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"TouchHelper.js","sourceRoot":"","sources":["../src/TouchHelper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAqB,MAAM,eAAe,CAAA;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAE/D,MAAM,MAAM,GAAG,YAAY,CAAC,wBAAwB,CAAC,CAAA;AAErD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,cAAc,CAAC,CAAA;AAErE,8FAA8F;AAC9F,4FAA4F;AAC5F,8FAA8F;AAC9F,iGAAiG;AACjG,8FAA8F;AAC9F,iGAAiG;AACjG,oEAAoE;AACpE,MAAM,aAAa,GAAG,CAAC,CAAA;AACvB,MAAM,iBAAiB,GAAG,MAAM,CAAA;AAEhC,2FAA2F;AAC3F,+FAA+F;AAC/F,gGAAgG;AAChG,iGAAiG;AACjG,iGAAiG;AACjG,+EAA+E;AAC/E,MAAM,YAAY,GAAG,oBAAoB,CAAA;AACzC,gGAAgG;AAChG,6FAA6F;AAC7F,gGAAgG;AAChG,kGAAkG;AAClG,sCAAsC;AACtC,MAAM,iBAAiB,GAAG,KAAK,CAAA;AAE/B,MAAM,OAAO,WAAW;IAYO;IAXrB,IAAI,GAAwB,IAAI,CAAA;IACxC,6FAA6F;IAC7F,6FAA6F;IACrF,WAAW,GAAwB,IAAI,CAAA;IACvC,KAAK,GAAG,CAAC,CAAA;IACT,KAAK,GAAG,CAAC,CAAA;IACT,OAAO,GAAG,KAAK,CAAA;IACf,KAAK,GAAG,KAAK,CAAA;IACb,UAAU,GAAyC,IAAI,CAAA;IACvD,MAAM,GAAa,EAAE,CAAA;IAE7B,YAA6B,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;IAAG,CAAC;IAE7C,KAAK;QACH,IAAI,CAAC,OAAO,GAAG,KAAK,CAAA;QACpB,IAAI,CAAC,WAAW,EAAE,CAAA;IACpB,CAAC;IAED,IAAI;QACF,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;QACnB,IAAI,CAAC,kBAAkB,EAAE,CAAA;QACzB,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAA;IACzB,CAAC;IAED,+FAA+F;IAC/F,6FAA6F;IAC7F,+FAA+F;IAC/F,OAAO;QACL,OAAO,IAAI,CAAC,SAAS,EAAE,IAAI,IAAI,CAAC,KAAK,CAAA;IACvC,CAAC;IAED,8FAA8F;IAC9F,+FAA+F;IAC/F,kDAAkD;IAC1C,SAAS;QACf,OAAO,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAA;IAC5C,CAAC;IAED;;;;;;;;;;OAUG;IACH,UAAU;QACR,IAAI,IAAI,CAAC,OAAO,EAAE;YAAE,OAAO,OAAO,CAAA;QAClC,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa,CAAA;IACtD,CAAC;IAED;;;;;;;;;OASG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,WAAW,CAAA;IAC7D,CAAC;IAED,UAAU,CAAC,CAAS,EAAE,CAAS;QAC7B,IAAI,CAAC,KAAK,GAAG,CAAC,CAAA;QACd,IAAI,CAAC,KAAK,GAAG,CAAC,CAAA;QACd,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IACnD,CAAC;IAED,SAAS,CAAC,CAAS,EAAE,CAAS;QAC5B,IAAI,CAAC,KAAK,GAAG,CAAC,CAAA;QACd,IAAI,CAAC,KAAK,GAAG,CAAC,CAAA;QACd,OAAO,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IACvD,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;IACzE,CAAC;IAED,WAAW,CAAC,SAAiB,EAAE,KAAa;QAC1C,OAAO,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAA;IACtE,CAAC;IAED,wFAAwF;IACxF,2FAA2F;IAC3F,sCAAsC;IACtC,eAAe,CAAC,SAAiB,EAAE,KAAa;QAC9C,OAAO,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAA;IACvE,CAAC;IAED,uFAAuF;IACvF,4FAA4F;IAC5F,6FAA6F;IAC7F,8CAA8C;IAC9C,aAAa,CAAC,SAAiB,EAAE,KAAa;QAC5C,OAAO,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAA;IACvE,CAAC;IAED,0DAA0D;IAC1D,iBAAiB,CAAC,IAAY;QAC5B,OAAO,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;IAC7D,CAAC;IAED,UAAU,CAAC,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU;QACvD,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAA;IACjE,CAAC;IAED,SAAS,CAAC,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU;QACtD,OAAO,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAA;IACrE,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IACjE,CAAC;IAED,mEAAmE;IACnE,qGAAqG;IACrG,kEAAkE;IAClE,OAAO,CAAC,KAAa,EAAE,SAAS,GAAG,CAAC;QAClC,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAA;QACjC,GAAG,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QACpB,GAAG,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC,CAAC,CAAA;QAC5B,GAAG,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QACpB,GAAG,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QACpB,GAAG,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QACpB,GAAG,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;QAC3B,OAAO,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAA;IACpC,CAAC;IAEO,UAAU,CAAC,IAAY,EAAE,CAAS,EAAE,CAAS;QACnD,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAA;QACjC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QACvB,GAAG,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QACtB,GAAG,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QACtB,OAAO,GAAG,CAAA;IACZ,CAAC;IAEO,WAAW,CAAC,IAAY,EAAE,CAAS,EAAE,CAAS;QACpD,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAA;QACjC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QACvB,GAAG,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QACvB,GAAG,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QACvB,OAAO,GAAG,CAAA;IACZ,CAAC;IAEO,cAAc,CAAC,IAAY,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU;QACjF,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;QAClC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QACvB,GAAG,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;QACvB,GAAG,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;QACvB,GAAG,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;QACvB,GAAG,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;QACxB,OAAO,GAAG,CAAA;IACZ,CAAC;IAED,8FAA8F;IAC9F,iFAAiF;IACzE,iBAAiB,CAAC,GAAW;QACnC,8FAA8F;QAC9F,sFAAsF;QACtF,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;YAAE,IAAI,CAAC,OAAO,EAAE,CAAA;QACrC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACvB,CAAC;IAED,yFAAyF;IACzF,uDAAuD;IAC/C,WAAW,CAAC,GAAW;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAA;QACxC,8FAA8F;QAC9F,6FAA6F;QAC7F,2FAA2F;QAC3F,sFAAsF;QACtF,qEAAqE;QACrE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;QAC1C,OAAO,IAAI,CAAA;IACb,CAAC;IAED,8FAA8F;IAC9F,6FAA6F;IAC7F,8FAA8F;IAC9F,qDAAqD;IACrD,EAAE;IACF,yFAAyF;IACzF,0FAA0F;IAC1F,0FAA0F;IAC1F,yDAAyD;IACjD,eAAe,CAAC,GAAW;QACjC,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,WAAW;YAAE,OAAO,KAAK,CAAA;QACtE,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACvB,CAAC;IAEO,IAAI,CAAC,GAAW;QACtB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;YAAE,OAAO,KAAK,CAAA;QACjC,yFAAyF;QACzF,0DAA0D;QAC1D,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAA;QAC5B,OAAO,IAAI,CAAA;IACb,CAAC;IAEO,gBAAgB,CAAC,IAAkB;QACzC,IAAI,CAAC,kBAAkB,EAAE,CAAA;QACzB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,KAAK;gBAAE,OAAM;YAC5C,MAAM,CAAC,KAAK,CAAC,oCAAoC,iBAAiB,2BAA2B,CAAC,CAAA;YAC9F,uBAAuB,CAAC,IAAI,CAAC,CAAA;YAC7B,2FAA2F;YAC3F,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;QACxB,CAAC,EAAE,iBAAiB,CAAC,CAAA;QACrB,KAAK,CAAC,KAAK,EAAE,EAAE,CAAA;QACf,IAAI,CAAC,UAAU,GAAG,KAAK,CAAA;IACzB,CAAC;IAEO,kBAAkB;QACxB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAAC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAA;QAAC,CAAC;IAChF,CAAC;IAEO,OAAO;QACb,IAAI,IAAI,CAAC,OAAO;YAAE,OAAM;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACtB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,iBAAiB,CAAC,CAAA;QACpE,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,aAAa;YAAE,OAAM;QAC/C,IAAI,CAAC,WAAW,EAAE,CAAA;IACpB,CAAC;IAEO,WAAW;QACjB,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,CAAA;QAC9E,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAA;QAC5B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAElB,sFAAsF;QACtF,mFAAmF;QACnF,EAAE;QACF,0FAA0F;QAC1F,yFAAyF;QACzF,4FAA4F;QAC5F,6FAA6F;QAC7F,wFAAwF;QACxF,yCAAyC;QACzC,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;YAC3B,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;YAClE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;YAChB,OAAM;QACR,CAAC;QAED,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAA;QAC3B,0FAA0F;QAC1F,oCAAoC;QACpC,IAAI,IAAI,GAAG,EAAE,CAAA;QACb,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE;YACpC,MAAM,GAAG,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAA;YACxB,0FAA0F;YAC1F,SAAS;YACT,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;gBACtC,MAAM,IAAI,GAAG,IAAI,GAAG,GAAG,CAAA;gBACvB,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;oBAChC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;oBACjB,IAAI,GAAG,EAAE,CAAA;oBACT,IAAI,CAAC,kBAAkB,EAAE,CAAA;oBAC3B,iEAAiE;gBACjE,CAAC;;oBAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;YAChD,CAAC;YACD,yEAAyE;YACzE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAA;QAC1B,CAAC,CAAC,CAAA;QACF,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACvB,MAAM,CAAC,KAAK,CAAC,oBAAoB,IAAI,IAAI,MAAM,EAAE,CAAC,CAAA;YAClD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;QACxB,CAAC,CAAC,CAAA;QACF,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;YACrB,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,OAAO,EAAE,CAAC,CAAA;YACzC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;QACxB,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,0FAA0F;IAC1F,wFAAwF;IACxF,kEAAkE;IAC1D,WAAW,CAAC,IAAkB;QACpC,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI;YAAE,OAAM,CAAC,4DAA4D;QAC3F,IAAI,CAAC,kBAAkB,EAAE,CAAA;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,OAAO,EAAE,CAAA;IAChB,CAAC;CACF"}

package/dist/childProcessKill.d.ts

@@ -0,0 +1,3 @@
+import type { ChildProcess } from 'child_process';
+export declare function killWithSigkillFallback(proc: ChildProcess | null, timeoutMs?: number): void;
+//# sourceMappingURL=childProcessKill.d.ts.map

package/dist/childProcessKill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"childProcessKill.d.ts","sourceRoot":"","sources":["../src/childProcessKill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAMjD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,EAAE,SAAS,SAAO,GAAG,IAAI,CAWzF"}

package/dist/childProcessKill.js

@@ -0,0 +1,19 @@
+// SIGKILL fallback if SIGTERM did not take — shared by TouchHelper and KeyboardHelperDaemon,
+// which spawn non-detached helper processes (plain kill(), not a process group).
+// ScreenCaptureStreamer / XCUITreeReader use their own variant (different timeout, and
+// XCUITreeReader kills a process group) and are intentionally not folded into this helper.
+export function killWithSigkillFallback(proc, timeoutMs = 1000) {
+    if (!proc)
+        return;
+    // kill() returns false when the signal can't be delivered (e.g. already exited) — don't
+    // arm the fallback in that case, or it fires later against a possibly-reused pid: 'exit'
+    // already happened, so a once('exit', ...) attached now would never see it and clear it.
+    if (!proc.kill('SIGTERM'))
+        return;
+    const killTimer = setTimeout(() => proc.kill('SIGKILL'), timeoutMs);
+    killTimer.unref?.();
+    const clear = () => clearTimeout(killTimer);
+    proc.once('exit', clear);
+    proc.once('error', clear);
+}
+//# sourceMappingURL=childProcessKill.js.map

package/dist/childProcessKill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"childProcessKill.js","sourceRoot":"","sources":["../src/childProcessKill.ts"],"names":[],"mappings":"AAEA,6FAA6F;AAC7F,iFAAiF;AACjF,uFAAuF;AACvF,2FAA2F;AAC3F,MAAM,UAAU,uBAAuB,CAAC,IAAyB,EAAE,SAAS,GAAG,IAAI;IACjF,IAAI,CAAC,IAAI;QAAE,OAAM;IACjB,wFAAwF;IACxF,yFAAyF;IACzF,yFAAyF;IACzF,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,OAAM;IACjC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,CAAA;IACnE,SAAS,CAAC,KAAK,EAAE,EAAE,CAAA;IACnB,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,CAAA;IAC3C,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IACxB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;AAC3B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tapflowio/ios-agent",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "description": "iOS simulator agent for tapflow — xcrun simctl control and screen streaming",
   "keywords": [
     "tapflow",
@@ -46,28 +46,29 @@
     "LICENSE"
   ],
   "engines": {
-    "node": ">=20.12.0"
+    "node": ">=22.0.0"
   },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "ws": "^8.21.1",
-    "@tapflowio/agent-core": "0.18.0",
-    "@tapflowio/audiotap-helper": "0.2.8"
+    "ws": "^8.21.3",
+    "@tapflowio/audiotap-helper": "0.3.0",
+    "@tapflowio/protocol": "0.19.0",
+    "@tapflowio/agent-core": "0.19.0"
   },
   "devDependencies": {
-    "@types/node": "^20.19.43",
+    "@types/node": "^22.20.1",
     "@types/ws": "^8.0.0",
     "typescript": "^5.0.0",
     "vitest": "^4.1.10",
-    "@tapflowio/relay": "0.18.0",
+    "@tapflowio/relay": "0.19.0",
     "@tapflowio/test-utils": "0.0.0"
   },
   "scripts": {
     "postinstall": "node -e \"if (process.platform === 'darwin') { require('fs').readdirSync('bin').forEach(f => require('fs').chmodSync('bin/' + f, 0o755)) }\"",
     "build": "tsc -b",
-    "typecheck": "tsc -b",
+    "typecheck": "tsc -b && tsc -p src/__tests__/tsconfig.json",
     "test": "vitest run",
     "lint": "eslint src"
   }