@qawolf/run-globals-android 1.0.0 → 1.2.1

package/dist/emulator/adb.d.ts

@@ -0,0 +1,23 @@
+import { type RunCommandOptions } from "./runCommand.js";
+/**
+ * Run an `adb` command and return its combined stdout/stderr.
+ *
+ * Pass the arguments either as a single string for convenience, or as an array.
+ * A string is split on whitespace and supports quoting a single value that
+ * contains spaces; it does not go through a shell. When building arguments
+ * programmatically, prefer the array form so no quoting is needed.
+ *
+ * @example
+ * // adb shell input keyevent 26
+ * await adb("shell input keyevent 26");
+ *
+ * @example
+ * // a path with spaces, quoted in a string...
+ * await adb("pull '/sdcard/Recordings/My recording 1.m4a' /tmp/out.m4a");
+ *
+ * @example
+ * // ...or as a single array element, with no quoting to reason about
+ * await adb(["pull", "/sdcard/Recordings/My recording 1.m4a", destination]);
+ */
+export declare function adb(command: string | string[], runCommandOptions?: Omit<RunCommandOptions, "args">): Promise<string>;
+//# sourceMappingURL=adb.d.ts.map

package/dist/emulator/adb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adb.d.ts","sourceRoot":"","sources":["../../src/emulator/adb.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAc,MAAM,iBAAiB,CAAC;AAuBrE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,GAAG,CACvB,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,EAC1B,iBAAiB,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,GAClD,OAAO,CAAC,MAAM,CAAC,CAIjB"}

package/dist/emulator/adb.js

@@ -0,0 +1,43 @@
+import { runCommand } from "./runCommand.js";
+/**
+ * Split an `adb` command string into arguments, honoring single or double
+ * quotes around a value that contains spaces (for example a file path).
+ *
+ * This is a deliberately small tokenizer, not a shell: it does not expand
+ * variables, run pipes, or handle escaped or mid-token quotes. For anything
+ * beyond quoting a value with spaces, pass the arguments as an array instead.
+ */
+function splitCommand(command) {
+    const tokens = command.match(/'[^']*'|"[^"]*"|\S+/g) ?? [];
+    return tokens.map((token) => {
+        const isQuoted = token.length >= 2 &&
+            ((token.startsWith("'") && token.endsWith("'")) ||
+                (token.startsWith('"') && token.endsWith('"')));
+        return isQuoted ? token.slice(1, -1) : token;
+    });
+}
+/**
+ * Run an `adb` command and return its combined stdout/stderr.
+ *
+ * Pass the arguments either as a single string for convenience, or as an array.
+ * A string is split on whitespace and supports quoting a single value that
+ * contains spaces; it does not go through a shell. When building arguments
+ * programmatically, prefer the array form so no quoting is needed.
+ *
+ * @example
+ * // adb shell input keyevent 26
+ * await adb("shell input keyevent 26");
+ *
+ * @example
+ * // a path with spaces, quoted in a string...
+ * await adb("pull '/sdcard/Recordings/My recording 1.m4a' /tmp/out.m4a");
+ *
+ * @example
+ * // ...or as a single array element, with no quoting to reason about
+ * await adb(["pull", "/sdcard/Recordings/My recording 1.m4a", destination]);
+ */
+export async function adb(command, runCommandOptions) {
+    const args = typeof command === "string" ? splitCommand(command) : command;
+    return await runCommand("adb", { args, ...runCommandOptions });
+}
+//# sourceMappingURL=adb.js.map

package/dist/emulator/adb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adb.js","sourceRoot":"","sources":["../../src/emulator/adb.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAErE;;;;;;;GAOG;AACH,SAAS,YAAY,CAAC,OAAe;IACnC,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,IAAI,EAAE,CAAC;IAE3D,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC1B,MAAM,QAAQ,GACZ,KAAK,CAAC,MAAM,IAAI,CAAC;YACjB,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;gBAC7C,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAEpD,OAAO,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC/C,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,OAA0B,EAC1B,iBAAmD;IAEnD,MAAM,IAAI,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAE3E,OAAO,MAAM,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,GAAG,iBAAiB,EAAE,CAAC,CAAC;AACjE,CAAC"}

package/dist/emulator/captureAudioOutput.d.ts

@@ -0,0 +1,40 @@
+import { z } from "zod";
+import { type RunCommandOptions } from "./runCommand.js";
+declare const captureAudioOutputOptions: z.ZodObject<{
+    delaySeconds: z.ZodOptional<z.ZodNumber>;
+    durationSeconds: z.ZodNumber;
+    outputPath: z.ZodString;
+}, z.core.$strip>;
+export type CaptureAudioOutputOptions = z.input<typeof captureAudioOutputOptions>;
+/**
+ * Capture the emulator's audio output to a file on the runner host.
+ *
+ * The mirror of `passAudioAsMicrophoneInput`: where injection plays audio into
+ * the emulator's microphone with `ffplay`, this records what the emulator plays
+ * out of its speaker. The emulator's output sink exposes a PulseAudio monitor
+ * source (`virtual_speaker.monitor`), and `ffmpeg` reads from it on the runner
+ * host over the existing pulse tunnel (`PULSE_SERVER`). This wraps the recording
+ * flags so flow authors do not have to know them.
+ *
+ * Recording from a live source has no natural end, so `durationSeconds` is
+ * required.
+ *
+ * Note: `virtual_mic` is mastered on `virtual_speaker.monitor`, so audio
+ * injected via `passAudioAsMicrophoneInput` also passes through the sink. A
+ * recording taken while injecting concurrently will therefore include the
+ * injected audio; pure output capture (no simultaneous injection) is clean.
+ *
+ * @param options recording options
+ * @param runCommandOptions optional options forwarded to runCommand
+ * @returns the path the recording was written to (the given `outputPath`)
+ * @throws if the command failed
+ *
+ * @example
+ * await captureAudioOutput({
+ *   outputPath: `${process.env.TEAM_STORAGE_DIR}/output.wav`,
+ *   durationSeconds: 5,
+ * });
+ */
+export declare function captureAudioOutput(options: CaptureAudioOutputOptions, runCommandOptions?: Omit<RunCommandOptions, "args">): Promise<string>;
+export {};
+//# sourceMappingURL=captureAudioOutput.d.ts.map

package/dist/emulator/captureAudioOutput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"captureAudioOutput.d.ts","sourceRoot":"","sources":["../../src/emulator/captureAudioOutput.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,KAAK,iBAAiB,EAAc,MAAM,iBAAiB,CAAC;AAErE,QAAA,MAAM,yBAAyB;;;;iBAO7B,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAC7C,OAAO,yBAAyB,CACjC,CAAC;AAUF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,yBAAyB,EAClC,iBAAiB,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,GAClD,OAAO,CAAC,MAAM,CAAC,CAiCjB"}

package/dist/emulator/captureAudioOutput.js

@@ -0,0 +1,73 @@
+import ms from "ms";
+import { z } from "zod";
+import { runCommand } from "./runCommand.js";
+const captureAudioOutputOptions = z.object({
+    /** Delay in seconds before recording starts. */
+    delaySeconds: z.number().nonnegative().optional(),
+    /** How long to record, in seconds. */
+    durationSeconds: z.number().positive(),
+    /** File path on the runner host to write the recording to. */
+    outputPath: z.string().min(1),
+});
+/**
+ * ffmpeg records for `durationSeconds`, and `runCommand` kills it at its
+ * timeout (1 minute by default). When the requested duration would exceed that
+ * default, we raise the timeout to cover it plus this margin (startup/teardown
+ * slack).
+ */
+const timeoutMarginSeconds = 30;
+/**
+ * Capture the emulator's audio output to a file on the runner host.
+ *
+ * The mirror of `passAudioAsMicrophoneInput`: where injection plays audio into
+ * the emulator's microphone with `ffplay`, this records what the emulator plays
+ * out of its speaker. The emulator's output sink exposes a PulseAudio monitor
+ * source (`virtual_speaker.monitor`), and `ffmpeg` reads from it on the runner
+ * host over the existing pulse tunnel (`PULSE_SERVER`). This wraps the recording
+ * flags so flow authors do not have to know them.
+ *
+ * Recording from a live source has no natural end, so `durationSeconds` is
+ * required.
+ *
+ * Note: `virtual_mic` is mastered on `virtual_speaker.monitor`, so audio
+ * injected via `passAudioAsMicrophoneInput` also passes through the sink. A
+ * recording taken while injecting concurrently will therefore include the
+ * injected audio; pure output capture (no simultaneous injection) is clean.
+ *
+ * @param options recording options
+ * @param runCommandOptions optional options forwarded to runCommand
+ * @returns the path the recording was written to (the given `outputPath`)
+ * @throws if the command failed
+ *
+ * @example
+ * await captureAudioOutput({
+ *   outputPath: `${process.env.TEAM_STORAGE_DIR}/output.wav`,
+ *   durationSeconds: 5,
+ * });
+ */
+export async function captureAudioOutput(options, runCommandOptions) {
+    const { delaySeconds, durationSeconds, outputPath } = captureAudioOutputOptions.parse(options);
+    if (delaySeconds)
+        await new Promise((resolve) => setTimeout(resolve, delaySeconds * 1000));
+    const args = [
+        "-hide_banner",
+        "-loglevel",
+        "error",
+        "-f",
+        "pulse",
+        "-i",
+        "virtual_speaker.monitor",
+        "-t",
+        String(durationSeconds),
+        "-y",
+        outputPath,
+    ];
+    const timeout = Math.max(ms("1m"), (durationSeconds + timeoutMarginSeconds) * 1000);
+    await runCommand("ffmpeg", {
+        args,
+        timeout,
+        ...runCommandOptions,
+    });
+    return outputPath;
+}
+//# sourceMappingURL=captureAudioOutput.js.map

package/dist/emulator/captureAudioOutput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"captureAudioOutput.js","sourceRoot":"","sources":["../../src/emulator/captureAudioOutput.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAA0B,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAErE,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,gDAAgD;IAChD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACjD,sCAAsC;IACtC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC,8DAA8D;IAC9D,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC9B,CAAC,CAAC;AAMH;;;;;GAKG;AACH,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAkC,EAClC,iBAAmD;IAEnD,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,GACjD,yBAAyB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAE3C,IAAI,YAAY;QACd,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC,CAAC,CAAC;IAE3E,MAAM,IAAI,GAAG;QACX,cAAc;QACd,WAAW;QACX,OAAO;QACP,IAAI;QACJ,OAAO;QACP,IAAI;QACJ,yBAAyB;QACzB,IAAI;QACJ,MAAM,CAAC,eAAe,CAAC;QACvB,IAAI;QACJ,UAAU;KACX,CAAC;IAEF,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CACtB,EAAE,CAAC,IAAI,CAAC,EACR,CAAC,eAAe,GAAG,oBAAoB,CAAC,GAAG,IAAI,CAChD,CAAC;IAEF,MAAM,UAAU,CAAC,QAAQ,EAAE;QACzB,IAAI;QACJ,OAAO;QACP,GAAG,iBAAiB;KACrB,CAAC,CAAC;IAEH,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/emulator/index.d.ts

@@ -1,3 +1,6 @@
+export { adb } from "./adb.js";
+export { type CaptureAudioOutputOptions, captureAudioOutput, } from "./captureAudioOutput.js";
+export { type PassAudioAsMicrophoneInputOptions, passAudioAsMicrophoneInput, } from "./passAudioAsMicrophoneInput.js";
 export { type PlayAutomationOptions, playAutomation, } from "./playAutomation.js";
 export { type GeoLocationOptions, setGeoLocation } from "./setGeoLocation.js";
 export { type ProxyOptions, clearProxy, setProxy } from "./setProxy.js";

package/dist/emulator/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/emulator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,qBAAqB,EAC1B,cAAc,GACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,KAAK,kBAAkB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,KAAK,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EACL,KAAK,wBAAwB,EAC7B,oBAAoB,GACrB,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/emulator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EACL,KAAK,yBAAyB,EAC9B,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,KAAK,iCAAiC,EACtC,0BAA0B,GAC3B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,KAAK,qBAAqB,EAC1B,cAAc,GACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,KAAK,kBAAkB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,KAAK,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EACL,KAAK,wBAAwB,EAC7B,oBAAoB,GACrB,MAAM,2BAA2B,CAAC"}

package/dist/emulator/index.js

@@ -1,3 +1,6 @@
+export { adb } from "./adb.js";
+export { captureAudioOutput, } from "./captureAudioOutput.js";
+export { passAudioAsMicrophoneInput, } from "./passAudioAsMicrophoneInput.js";
 export { playAutomation, } from "./playAutomation.js";
 export { setGeoLocation } from "./setGeoLocation.js";
 export { clearProxy, setProxy } from "./setProxy.js";

package/dist/emulator/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/emulator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,cAAc,GACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAA2B,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAqB,UAAU,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAEL,oBAAoB,GACrB,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/emulator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAEL,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,0BAA0B,GAC3B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAEL,cAAc,GACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAA2B,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAqB,UAAU,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAEL,oBAAoB,GACrB,MAAM,2BAA2B,CAAC"}

package/dist/emulator/passAudioAsMicrophoneInput.d.ts

@@ -0,0 +1,37 @@
+import { z } from "zod";
+import { type RunCommandOptions } from "./runCommand.js";
+declare const passAudioAsMicrophoneInputOptions: z.ZodObject<{
+    data: z.ZodString;
+    delaySeconds: z.ZodOptional<z.ZodNumber>;
+    durationSeconds: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type PassAudioAsMicrophoneInputOptions = z.input<typeof passAudioAsMicrophoneInputOptions>;
+/**
+ * Pass an audio file to the emulator as microphone input.
+ *
+ * The emulator routes host audio into its microphone, and `ffplay` performs the
+ * playback on the runner host. This wraps the playback flags so flow authors do
+ * not have to know them, and enables the emulator's host-microphone toggle
+ * first, so a flow never has to.
+ *
+ * **Playback is synchronous, so flow order matters.** This resolves only once
+ * `ffplay` has finished, which means the app has to be recording *before* it is
+ * called. Awaiting it first plays the whole file into a microphone nobody is
+ * listening to, and the recording that follows captures silence. `delaySeconds`
+ * does not work around that either, since it is awaited inline as well. Start
+ * the app recording first, then call this; or hold the promise and await it
+ * after the app has started.
+ *
+ * @param options playback options
+ * @param runCommandOptions optional options forwarded to runCommand
+ * @throws if the command failed
+ *
+ * @example
+ * await passAudioAsMicrophoneInput({ data: `${process.env.TEAM_STORAGE_DIR}/audio.mp3` });
+ *
+ * @example
+ * await passAudioAsMicrophoneInput({ data: `${process.env.TEAM_STORAGE_DIR}/audio.mp3`, durationSeconds: 10 });
+ */
+export declare function passAudioAsMicrophoneInput(options: PassAudioAsMicrophoneInputOptions, runCommandOptions?: Omit<RunCommandOptions, "args">): Promise<string>;
+export {};
+//# sourceMappingURL=passAudioAsMicrophoneInput.d.ts.map

package/dist/emulator/passAudioAsMicrophoneInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"passAudioAsMicrophoneInput.d.ts","sourceRoot":"","sources":["../../src/emulator/passAudioAsMicrophoneInput.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,KAAK,iBAAiB,EAAc,MAAM,iBAAiB,CAAC;AAErE,QAAA,MAAM,iCAAiC;;;;iBAWrC,CAAC;AAEH,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CACrD,OAAO,iCAAiC,CACzC,CAAC;AAUF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAQH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,iCAAiC,EAC1C,iBAAiB,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,GAClD,OAAO,CAAC,MAAM,CAAC,CAgCjB"}

package/dist/emulator/passAudioAsMicrophoneInput.js

@@ -0,0 +1,83 @@
+import ms from "ms";
+import { z } from "zod";
+import { adb } from "./adb.js";
+import { runCommand } from "./runCommand.js";
+const passAudioAsMicrophoneInputOptions = z.object({
+    /** File path on the runner host, or URL, for the audio to play. */
+    data: z.string().min(1),
+    /** Delay in seconds before playback starts. */
+    delaySeconds: z.number().nonnegative().optional(),
+    /**
+     * Maximum playback duration in seconds (`ffplay -t`). Omit to play the whole
+     * file, but note playback is still bounded by the command timeout (1 minute
+     * by default — pass a larger `runCommandOptions.timeout` for longer audio).
+     */
+    durationSeconds: z.number().positive().optional(),
+});
+/**
+ * ffplay blocks until playback finishes, and `runCommand` kills it at its
+ * timeout (1 minute by default). For audio longer than that default, the
+ * command would be cut off mid-playback, so when a duration is requested we
+ * raise the timeout to cover it plus this margin (network/startup slack).
+ */
+const timeoutMarginSeconds = 30;
+/**
+ * Pass an audio file to the emulator as microphone input.
+ *
+ * The emulator routes host audio into its microphone, and `ffplay` performs the
+ * playback on the runner host. This wraps the playback flags so flow authors do
+ * not have to know them, and enables the emulator's host-microphone toggle
+ * first, so a flow never has to.
+ *
+ * **Playback is synchronous, so flow order matters.** This resolves only once
+ * `ffplay` has finished, which means the app has to be recording *before* it is
+ * called. Awaiting it first plays the whole file into a microphone nobody is
+ * listening to, and the recording that follows captures silence. `delaySeconds`
+ * does not work around that either, since it is awaited inline as well. Start
+ * the app recording first, then call this; or hold the promise and await it
+ * after the app has started.
+ *
+ * @param options playback options
+ * @param runCommandOptions optional options forwarded to runCommand
+ * @throws if the command failed
+ *
+ * @example
+ * await passAudioAsMicrophoneInput({ data: `${process.env.TEAM_STORAGE_DIR}/audio.mp3` });
+ *
+ * @example
+ * await passAudioAsMicrophoneInput({ data: `${process.env.TEAM_STORAGE_DIR}/audio.mp3`, durationSeconds: 10 });
+ */
+// Named `passAudioAsMicrophoneInput`, not `injectAudio`: the name describes what
+// actually happens (the emulator receives the audio as microphone input, it is
+// not played back on a speaker), and it avoids the iOS `injectAudio` clash —
+// `@qawolf/flows/ios` exports its own `injectAudio`, and the generated
+// editor-type bundles flatten both platforms' declarations into one file, where
+// a shared name would be renamed to `injectAudio_2` and leak into iOS author
+// autocomplete.
+export async function passAudioAsMicrophoneInput(options, runCommandOptions) {
+    const { data, delaySeconds, durationSeconds } = passAudioAsMicrophoneInputOptions.parse(options);
+    // Without this the guest records silence: `-allow-host-audio` only lets QEMU open the
+    // record stream, and this toggle is what forwards it to the guest. It defaults to off
+    // and resets on every emulator start, so set it every time. The command is idempotent.
+    await adb("emu avd hostmicon");
+    if (delaySeconds)
+        await new Promise((resolve) => setTimeout(resolve, delaySeconds * 1000));
+    const args = [
+        "-nodisp",
+        "-autoexit",
+        "-hide_banner",
+        "-loglevel",
+        "error",
+        ...(durationSeconds !== undefined ? ["-t", String(durationSeconds)] : []),
+        data,
+    ];
+    const timeout = durationSeconds !== undefined
+        ? Math.max(ms("1m"), (durationSeconds + timeoutMarginSeconds) * 1000)
+        : ms("1m");
+    return await runCommand("ffplay", {
+        args,
+        timeout,
+        ...runCommandOptions,
+    });
+}
+//# sourceMappingURL=passAudioAsMicrophoneInput.js.map

package/dist/emulator/passAudioAsMicrophoneInput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"passAudioAsMicrophoneInput.js","sourceRoot":"","sources":["../../src/emulator/passAudioAsMicrophoneInput.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAA0B,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAErE,MAAM,iCAAiC,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,mEAAmE;IACnE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,+CAA+C;IAC/C,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACjD;;;;OAIG;IACH,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAClD,CAAC,CAAC;AAMH;;;;;GAKG;AACH,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,iFAAiF;AACjF,+EAA+E;AAC/E,6EAA6E;AAC7E,uEAAuE;AACvE,gFAAgF;AAChF,6EAA6E;AAC7E,gBAAgB;AAChB,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,OAA0C,EAC1C,iBAAmD;IAEnD,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,eAAe,EAAE,GAC3C,iCAAiC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAEnD,sFAAsF;IACtF,sFAAsF;IACtF,uFAAuF;IACvF,MAAM,GAAG,CAAC,mBAAmB,CAAC,CAAC;IAE/B,IAAI,YAAY;QACd,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC,CAAC,CAAC;IAE3E,MAAM,IAAI,GAAG;QACX,SAAS;QACT,WAAW;QACX,cAAc;QACd,WAAW;QACX,OAAO;QACP,GAAG,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,IAAI;KACL,CAAC;IAEF,MAAM,OAAO,GACX,eAAe,KAAK,SAAS;QAC3B,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,eAAe,GAAG,oBAAoB,CAAC,GAAG,IAAI,CAAC;QACrE,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;IAEf,OAAO,MAAM,UAAU,CAAC,QAAQ,EAAE;QAChC,IAAI;QACJ,OAAO;QACP,GAAG,iBAAiB;KACrB,CAAC,CAAC;AACL,CAAC"}

package/dist/emulator/playAutomation.d.ts

@@ -4,12 +4,7 @@ import { type RunCommandOptions } from "./runCommand.js";
  * Options for playing back an automation macro.
  */
 declare const PlayAutomationOptions: z.ZodUnion<readonly [z.ZodObject<{
-    macro: z.ZodEnum<{
-        Reset_position: "Reset_position";
-        Track_horizontal_plane: "Track_horizontal_plane";
-        Track_vertical_plane: "Track_vertical_plane";
-        Walk_to_image_room: "Walk_to_image_room";
-    }>;
+    macro: z.ZodLiteral<"Reset_position" | "Track_horizontal_plane" | "Track_vertical_plane" | "Walk_to_image_room">;
     overrideMacroPath: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     file: z.ZodString;

package/dist/emulator/playAutomation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playAutomation.d.ts","sourceRoot":"","sources":["../../src/emulator/playAutomation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,KAAK,iBAAiB,EAAc,MAAM,iBAAiB,CAAC;AAErE;;GAEG;AACH,QAAA,MAAM,qBAAqB;;;;;;;;;;mBAgBzB,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE1E;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,EAC9B,iBAAiB,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,GAClD,OAAO,CAAC,MAAM,CAAC,CAgBjB"}
+{"version":3,"file":"playAutomation.d.ts","sourceRoot":"","sources":["../../src/emulator/playAutomation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,KAAK,iBAAiB,EAAc,MAAM,iBAAiB,CAAC;AAErE;;GAEG;AACH,QAAA,MAAM,qBAAqB;;;;;mBAgBzB,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE1E;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,EAC9B,iBAAiB,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,GAClD,OAAO,CAAC,MAAM,CAAC,CAgBjB"}

package/dist/emulator/playAutomation.js

@@ -7,7 +7,7 @@ import { runCommand } from "./runCommand.js";
 const PlayAutomationOptions = z.union([
     z.object({
         /** Built-in macro to play */
-        macro: z.enum([
+        macro: z.literal([
             "Reset_position",
             "Track_horizontal_plane",
             "Track_vertical_plane",

package/dist/emulator/playAutomation.js.map

@@ -1 +1 @@
-{"version":3,"file":"playAutomation.js","sourceRoot":"","sources":["../../src/emulator/playAutomation.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAA0B,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAErE;;GAEG;AACH,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC;IACpC,CAAC,CAAC,MAAM,CAAC;QACP,6BAA6B;QAC7B,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC;YACZ,gBAAgB;YAChB,wBAAwB;YACxB,sBAAsB;YACtB,oBAAoB;SACrB,CAAC;QACF,oEAAoE;QACpE,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACzC,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,0CAA0C;QAC1C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;KACjB,CAAC;CACH,CAAC,CAAC;AAIH;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAA8B,EAC9B,iBAAmD;IAEnD,MAAM,aAAa,GAAG,qBAAqB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAE3D,MAAM,SAAS,GACb,CAAC,mBAAmB,IAAI,aAAa,IAAI,aAAa,CAAC,iBAAiB,CAAC;QACzE,wCAAwC,CAAC;IAE3C,MAAM,IAAI,GACR,OAAO,IAAI,aAAa;QACtB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,KAAK,CAAC;QAC3C,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC;IAEzB,OAAO,MAAM,UAAU,CAAC,KAAK,EAAE;QAC7B,IAAI,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC;QACzC,GAAG,iBAAiB;KACrB,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"playAutomation.js","sourceRoot":"","sources":["../../src/emulator/playAutomation.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAA0B,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAErE;;GAEG;AACH,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC;IACpC,CAAC,CAAC,MAAM,CAAC;QACP,6BAA6B;QAC7B,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC;YACf,gBAAgB;YAChB,wBAAwB;YACxB,sBAAsB;YACtB,oBAAoB;SACrB,CAAC;QACF,oEAAoE;QACpE,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACzC,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,0CAA0C;QAC1C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;KACjB,CAAC;CACH,CAAC,CAAC;AAIH;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAA8B,EAC9B,iBAAmD;IAEnD,MAAM,aAAa,GAAG,qBAAqB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAE3D,MAAM,SAAS,GACb,CAAC,mBAAmB,IAAI,aAAa,IAAI,aAAa,CAAC,iBAAiB,CAAC;QACzE,wCAAwC,CAAC;IAE3C,MAAM,IAAI,GACR,OAAO,IAAI,aAAa;QACtB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,KAAK,CAAC;QAC3C,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC;IAEzB,OAAO,MAAM,UAAU,CAAC,KAAK,EAAE;QAC7B,IAAI,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC;QACzC,GAAG,iBAAiB;KACrB,CAAC,CAAC;AACL,CAAC"}

package/dist/emulator/runCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runCommand.d.ts","sourceRoot":"","sources":["../../src/emulator/runCommand.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,iBAAiB;;;;;;iBAM5B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,MAAM,CAAC,CAuCjB"}
+{"version":3,"file":"runCommand.d.ts","sourceRoot":"","sources":["../../src/emulator/runCommand.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,iBAAiB;;;;;;iBAM5B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,MAAM,CAAC,CAyCjB"}

package/dist/emulator/runCommand.js

@@ -40,6 +40,8 @@ export async function runCommand(command, options = {}) {
     // We can't be totally sure, but SIGTERM usually means the command timed out
     if (signal === "SIGTERM")
         throw Error("Command timed out");
+    if (all === undefined)
+        throw Error("Expected combined output from execa");
     return all;
 }
 //# sourceMappingURL=runCommand.js.map

package/dist/emulator/runCommand.js.map

@@ -1 +1 @@
-{"version":3,"file":"runCommand.js","sourceRoot":"","sources":["../../src/emulator/runCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAC9B,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACrC,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACxC,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IACzD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,OAAe,EACf,UAA6B,EAAE;IAE/B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,CAAC,OAAO;QAAE,MAAM,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAElE,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,CAAC,OAAO;QAAE,MAAM,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAElE,MAAM,aAAa,GAAG,iBAAiB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAEvD,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,IAAI,EAAE;QAC/D,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,iBAAiB,IAAI,EAAE,CAAC;QAE9D,gEAAgE;QAChE,iDAAiD;QACjD,GAAG,EAAE;YACH,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;YACzB,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;YACzB,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;YACjC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;YAC7B,IAAI,EACF,OAAO;gBACP,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;SAC1C;QAED,4BAA4B;QAC5B,GAAG,EAAE,IAAI;QAET,uDAAuD;QACvD,SAAS,EAAE,KAAK;QAEhB,yEAAyE;QACzE,OAAO,EAAE,aAAa,CAAC,OAAO,IAAI,EAAE,CAAC,IAAI,CAAC;KAC3C,CAAC,CAAC;IAEH,4EAA4E;IAC5E,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAE3D,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"runCommand.js","sourceRoot":"","sources":["../../src/emulator/runCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAC9B,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACrC,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACxC,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IACzD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,OAAe,EACf,UAA6B,EAAE;IAE/B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,CAAC,OAAO;QAAE,MAAM,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAElE,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,CAAC,OAAO;QAAE,MAAM,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAElE,MAAM,aAAa,GAAG,iBAAiB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAEvD,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,IAAI,EAAE;QAC/D,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,iBAAiB,IAAI,EAAE,CAAC;QAE9D,gEAAgE;QAChE,iDAAiD;QACjD,GAAG,EAAE;YACH,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;YACzB,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;YACzB,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;YACjC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;YAC7B,IAAI,EACF,OAAO;gBACP,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;SAC1C;QAED,4BAA4B;QAC5B,GAAG,EAAE,IAAI;QAET,uDAAuD;QACvD,SAAS,EAAE,KAAK;QAEhB,yEAAyE;QACzE,OAAO,EAAE,aAAa,CAAC,OAAO,IAAI,EAAE,CAAC,IAAI,CAAC;KAC3C,CAAC,CAAC;IAEH,4EAA4E;IAC5E,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAE3D,IAAI,GAAG,KAAK,SAAS;QAAE,MAAM,KAAK,CAAC,qCAAqC,CAAC,CAAC;IAE1E,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/emulator/setVirtualSceneImage.d.ts

@@ -2,10 +2,7 @@ import { z } from "zod";
 import { type RunCommandOptions } from "./runCommand.js";
 declare const VirtualSceneImageOptions: z.ZodObject<{
     image: z.ZodDefault<z.ZodString>;
-    location: z.ZodEnum<{
-        wall: "wall";
-        table: "table";
-    }>;
+    location: z.ZodLiteral<"wall" | "table">;
 }, z.core.$strip>;
 export type VirtualSceneImageOptions = z.input<typeof VirtualSceneImageOptions>;
 /**

package/dist/emulator/setVirtualSceneImage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setVirtualSceneImage.d.ts","sourceRoot":"","sources":["../../src/emulator/setVirtualSceneImage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,KAAK,iBAAiB,EAAc,MAAM,iBAAiB,CAAC;AAGrE,QAAA,MAAM,wBAAwB;;;;;;iBAK5B,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEhF;;;;;;;;;;;GAWG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,wBAAwB,EACjC,iBAAiB,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,GAClD,OAAO,CAAC,MAAM,CAAC,CAgBjB"}
+{"version":3,"file":"setVirtualSceneImage.d.ts","sourceRoot":"","sources":["../../src/emulator/setVirtualSceneImage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,KAAK,iBAAiB,EAAc,MAAM,iBAAiB,CAAC;AAGrE,QAAA,MAAM,wBAAwB;;;iBAK5B,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEhF;;;;;;;;;;;GAWG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,wBAAwB,EACjC,iBAAiB,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,GAClD,OAAO,CAAC,MAAM,CAAC,CAgBjB"}

package/dist/emulator/setVirtualSceneImage.js

@@ -5,7 +5,7 @@ const VirtualSceneImageOptions = z.object({
     /** Optional absolute path to image file. Leave empty to reset to default. */
     image: z.string().default(""),
     /** Virtual scene location to update the image. */
-    location: z.enum(["wall", "table"]),
+    location: z.literal(["wall", "table"]),
 });
 /**
  * Set or reset the virtual scene image.

package/dist/emulator/setVirtualSceneImage.js.map

@@ -1 +1 @@
-{"version":3,"file":"setVirtualSceneImage.js","sourceRoot":"","sources":["../../src/emulator/setVirtualSceneImage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAA0B,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,6EAA6E;IAC7E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAC7B,kDAAkD;IAClD,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC,CAAC;AAIH;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAiC,EACjC,iBAAmD;IAEnD,MAAM,aAAa,GAAG,wBAAwB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9D,IAAI,SAAS,GAAG,aAAa,CAAC,KAAK,CAAC;IAEpC,qFAAqF;IACrF,gFAAgF;IAChF,oFAAoF;IACpF,OAAO,CAAC,GAAG,CACT,yDAAyD,SAAS,EAAE,CACrE,CAAC;IACF,SAAS,GAAG,MAAM,yBAAyB,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAEjE,OAAO,MAAM,UAAU,CAAC,KAAK,EAAE;QAC7B,IAAI,EAAE,CAAC,KAAK,EAAE,oBAAoB,EAAE,aAAa,CAAC,QAAQ,EAAE,SAAS,CAAC;QACtE,GAAG,iBAAiB;KACrB,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"setVirtualSceneImage.js","sourceRoot":"","sources":["../../src/emulator/setVirtualSceneImage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAA0B,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,6EAA6E;IAC7E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAC7B,kDAAkD;IAClD,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC,CAAC,CAAC;AAIH;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAiC,EACjC,iBAAmD;IAEnD,MAAM,aAAa,GAAG,wBAAwB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9D,IAAI,SAAS,GAAG,aAAa,CAAC,KAAK,CAAC;IAEpC,qFAAqF;IACrF,gFAAgF;IAChF,oFAAoF;IACpF,OAAO,CAAC,GAAG,CACT,yDAAyD,SAAS,EAAE,CACrE,CAAC;IACF,SAAS,GAAG,MAAM,yBAAyB,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAEjE,OAAO,MAAM,UAAU,CAAC,KAAK,EAAE;QAC7B,IAAI,EAAE,CAAC,KAAK,EAAE,oBAAoB,EAAE,aAAa,CAAC,QAAQ,EAAE,SAAS,CAAC;QACtE,GAAG,iBAAiB;KACrB,CAAC,CAAC;AACL,CAAC"}

package/dist/emulator/typings.d.ts

@@ -12,14 +12,99 @@ declare const RunCommandOptions: z.ZodObject<{
 	timeout: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 type RunCommandOptions = z.input<typeof RunCommandOptions>;
+/**
+ * Run an `adb` command and return its combined stdout/stderr.
+ *
+ * Pass the arguments either as a single string for convenience, or as an array.
+ * A string is split on whitespace and supports quoting a single value that
+ * contains spaces; it does not go through a shell. When building arguments
+ * programmatically, prefer the array form so no quoting is needed.
+ *
+ * @example
+ * // adb shell input keyevent 26
+ * await adb("shell input keyevent 26");
+ *
+ * @example
+ * // a path with spaces, quoted in a string...
+ * await adb("pull '/sdcard/Recordings/My recording 1.m4a' /tmp/out.m4a");
+ *
+ * @example
+ * // ...or as a single array element, with no quoting to reason about
+ * await adb(["pull", "/sdcard/Recordings/My recording 1.m4a", destination]);
+ */
+export declare function adb(command: string | string[], runCommandOptions?: Omit<RunCommandOptions, "args">): Promise<string>;
+declare const captureAudioOutputOptions: z.ZodObject<{
+	delaySeconds: z.ZodOptional<z.ZodNumber>;
+	durationSeconds: z.ZodNumber;
+	outputPath: z.ZodString;
+}, z.core.$strip>;
+export type CaptureAudioOutputOptions = z.input<typeof captureAudioOutputOptions>;
+/**
+ * Capture the emulator's audio output to a file on the runner host.
+ *
+ * The mirror of `passAudioAsMicrophoneInput`: where injection plays audio into
+ * the emulator's microphone with `ffplay`, this records what the emulator plays
+ * out of its speaker. The emulator's output sink exposes a PulseAudio monitor
+ * source (`virtual_speaker.monitor`), and `ffmpeg` reads from it on the runner
+ * host over the existing pulse tunnel (`PULSE_SERVER`). This wraps the recording
+ * flags so flow authors do not have to know them.
+ *
+ * Recording from a live source has no natural end, so `durationSeconds` is
+ * required.
+ *
+ * Note: `virtual_mic` is mastered on `virtual_speaker.monitor`, so audio
+ * injected via `passAudioAsMicrophoneInput` also passes through the sink. A
+ * recording taken while injecting concurrently will therefore include the
+ * injected audio; pure output capture (no simultaneous injection) is clean.
+ *
+ * @param options recording options
+ * @param runCommandOptions optional options forwarded to runCommand
+ * @returns the path the recording was written to (the given `outputPath`)
+ * @throws if the command failed
+ *
+ * @example
+ * await captureAudioOutput({
+ *   outputPath: `${process.env.TEAM_STORAGE_DIR}/output.wav`,
+ *   durationSeconds: 5,
+ * });
+ */
+export declare function captureAudioOutput(options: CaptureAudioOutputOptions, runCommandOptions?: Omit<RunCommandOptions, "args">): Promise<string>;
+declare const passAudioAsMicrophoneInputOptions: z.ZodObject<{
+	data: z.ZodString;
+	delaySeconds: z.ZodOptional<z.ZodNumber>;
+	durationSeconds: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type PassAudioAsMicrophoneInputOptions = z.input<typeof passAudioAsMicrophoneInputOptions>;
+/**
+ * Pass an audio file to the emulator as microphone input.
+ *
+ * The emulator routes host audio into its microphone, and `ffplay` performs the
+ * playback on the runner host. This wraps the playback flags so flow authors do
+ * not have to know them, and enables the emulator's host-microphone toggle
+ * first, so a flow never has to.
+ *
+ * **Playback is synchronous, so flow order matters.** This resolves only once
+ * `ffplay` has finished, which means the app has to be recording *before* it is
+ * called. Awaiting it first plays the whole file into a microphone nobody is
+ * listening to, and the recording that follows captures silence. `delaySeconds`
+ * does not work around that either, since it is awaited inline as well. Start
+ * the app recording first, then call this; or hold the promise and await it
+ * after the app has started.
+ *
+ * @param options playback options
+ * @param runCommandOptions optional options forwarded to runCommand
+ * @throws if the command failed
+ *
+ * @example
+ * await passAudioAsMicrophoneInput({ data: `${process.env.TEAM_STORAGE_DIR}/audio.mp3` });
+ *
+ * @example
+ * await passAudioAsMicrophoneInput({ data: `${process.env.TEAM_STORAGE_DIR}/audio.mp3`, durationSeconds: 10 });
+ */
+export declare function passAudioAsMicrophoneInput(options: PassAudioAsMicrophoneInputOptions, runCommandOptions?: Omit<RunCommandOptions, "args">): Promise<string>;
 declare const PlayAutomationOptions: z.ZodUnion<readonly [
 	z.ZodObject<{
-		macro: z.ZodEnum<{
-			Reset_position: "Reset_position";
-			Track_horizontal_plane: "Track_horizontal_plane";
-			Track_vertical_plane: "Track_vertical_plane";
-			Walk_to_image_room: "Walk_to_image_room";
-		}>;
+		macro: z.ZodLiteral<"Reset_position" | "Track_horizontal_plane" | "Track_vertical_plane" | "Walk_to_image_room">;
 		overrideMacroPath: z.ZodOptional<z.ZodString>;
 	}, z.core.$strip>,
 	z.ZodObject<{
@@ -92,10 +177,7 @@ export declare function setProxy(options: ProxyOptions$1, runCommandOptions?: Om
 export declare function clearProxy(runCommandOptions?: Omit<RunCommandOptions, "args">): Promise<string>;
 declare const VirtualSceneImageOptions: z.ZodObject<{
 	image: z.ZodDefault<z.ZodString>;
-	location: z.ZodEnum<{
-		wall: "wall";
-		table: "table";
-	}>;
+	location: z.ZodLiteral<"wall" | "table">;
 }, z.core.$strip>;
 type VirtualSceneImageOptions$1 = z.input<typeof VirtualSceneImageOptions>;
 /**
@@ -111,64 +193,6 @@ type VirtualSceneImageOptions$1 = z.input<typeof VirtualSceneImageOptions>;
  * @throws if the command failed
  */
 export declare function setVirtualSceneImage(options: VirtualSceneImageOptions$1, runCommandOptions?: Omit<RunCommandOptions, "args">): Promise<string>;
-declare module "enzyme-shallow-equal" {
-	export default function shallowEqual(objA: unknown, objB: unknown): boolean;
-}
-declare module "http-compression" {
-	import type { IncomingMessage, ServerResponse } from "node:http";
-	type Options = {
-		brotli?: boolean;
-		gzip?: boolean;
-		level?: number;
-		mimes?: RegExp;
-		threshold?: number;
-	};
-	type Handler = (req: IncomingMessage, res: ServerResponse) => void;
-	export default function compression(options?: Options): Handler;
-}
-declare module "parse-prometheus-text-format" {
-	export default function parsePrometheusTextFormat(text: string): {
-		metrics: {
-			value: string;
-		}[];
-		name: string;
-	}[];
-}
-declare module "react" {
-	namespace JSX {
-		// The entire namespace is deprecated in React, but VS Code doe not
-		// show the deprecation annotation on the namespace, so we add them
-		// on individual namespace members.
-		/**
-		 * @deprecated Usually you want ReactNode from react instead. If you really think you need JSX.Element, explicitly import it from react.
-		 */
-		interface Element extends JSX.Element {
-			// Prevent this from being an empty interface,
-			// which is then collapsed and does not pass
-			// the @deprecated annotation when using.
-			_dummy?: unknown;
-		}
-	}
-}
-type DefaultEventsMap = {
-	[event: string]: (...args: unknown[]) => void;
-};
-type EventsMap = {
-	[event: string]: unknown;
-};
-declare module "socket.io-client" {
-	interface Socket<ListenEvents extends EventsMap = DefaultEventsMap, EmitEvents extends EventsMap = ListenEvents> extends BaseSocket<ListenEvents, EmitEvents> {
-		timeout(ms: number): Socket<ListenEvents, EmitEvents> & {
-			/**
-			 * disallow emit, since it is not correctly typed
-			 * after this change.
-			 *
-			 * use emitWithAck instead.
-			 */
-			emit: never;
-		};
-	}
-}
 
 export {
 	GeoLocationOptions$1 as GeoLocationOptions,

package/package.json

@@ -1,10 +1,15 @@
 {
   "name": "@qawolf/run-globals-android",
-  "version": "1.0.0",
+  "version": "1.2.1",
   "private": false,
   "license": "MIT",
-  "sideEffects": false,
+  "files": [
+    "/dist",
+    "/LICENSE",
+    "/README.md"
+  ],
   "type": "module",
+  "sideEffects": false,
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -15,39 +20,29 @@
       "import": "./dist/emulator/index.js"
     }
   },
-  "files": [
-    "/dist",
-    "/LICENSE",
-    "/README.md"
-  ],
   "scripts": {
     "build": "rm -rf ./dist && tsc -p tsconfig.build.json && npm run build:dts",
     "build:dts": "dts-bundle-generator --config dts.config.json",
-    "lint:ci": "npm run lint:non-fixable; NON_FIXABLE_EXIT=$?; npm run lint:fixable && exit $NON_FIXABLE_EXIT",
-    "lint:dev": "npm run lint:fixable",
-    "lint:fixable": "eslint . --ext cjs,cts,js,jsx,mjs,ts,tsx --fix --quiet && prettier --write .",
-    "lint:non-fixable": "dpdm --exit-code circular:1 --no-tree --no-warning --transform --include='.*' --exclude='/(dist|node_modules)/' '**/*'",
+    "lint:ci": "npm run lint:first-half; FIRST_HALF_EXIT=$?; npm run lint:second-half && exit $FIRST_HALF_EXIT",
+    "lint:dev": "npm run lint:first-half",
+    "lint:first-half": "oxlint . --fix --quiet --report-unused-disable-directives --type-aware && oxfmt --write .",
+    "lint:second-half": "dpdm --exit-code circular:1 --no-tree --no-warning --transform --include='.*' --exclude='/(dist|node_modules)/' '**/*'",
     "prepublishOnly": "nx run run-globals-android:build",
     "test": "NODE_OPTIONS=\"--experimental-vm-modules\" NODE_NO_WARNINGS=1 jest",
     "test:watch": "npm run test -- --watch",
     "tsc:check": "tsc"
   },
   "dependencies": {
-    "execa": "^9.3.1",
+    "execa": "^9.6.1",
     "ms": "^3.0.0-canary.202508261828",
     "tslib": "^2.5.3",
     "zod": "^4.1.11"
   },
   "devDependencies": {
     "dts-bundle-generator": "^9.5.1",
-    "typescript": "^5.9.2"
+    "typescript": "^5.9.3"
   },
   "engines": {
-    "node": ">=22.22.0 <25"
-  },
-  "nx": {
-    "targets": {
-      "npm:publish": {}
-    }
+    "node": ">=20.19.0 <25"
   }
 }

package/dist/typings.d.ts

@@ -1,62 +0,0 @@
-// Generated by dts-bundle-generator v9.5.1
-
-declare module "enzyme-shallow-equal" {
-	export default function shallowEqual(objA: unknown, objB: unknown): boolean;
-}
-declare module "http-compression" {
-	import type { IncomingMessage, ServerResponse } from "node:http";
-	type Options = {
-		brotli?: boolean;
-		gzip?: boolean;
-		level?: number;
-		mimes?: RegExp;
-		threshold?: number;
-	};
-	type Handler = (req: IncomingMessage, res: ServerResponse) => void;
-	export default function compression(options?: Options): Handler;
-}
-declare module "parse-prometheus-text-format" {
-	export default function parsePrometheusTextFormat(text: string): {
-		metrics: {
-			value: string;
-		}[];
-		name: string;
-	}[];
-}
-declare module "react" {
-	namespace JSX {
-		// The entire namespace is deprecated in React, but VS Code doe not
-		// show the deprecation annotation on the namespace, so we add them
-		// on individual namespace members.
-		/**
-		 * @deprecated Usually you want ReactNode from react instead. If you really think you need JSX.Element, explicitly import it from react.
-		 */
-		interface Element extends JSX.Element {
-			// Prevent this from being an empty interface,
-			// which is then collapsed and does not pass
-			// the @deprecated annotation when using.
-			_dummy?: unknown;
-		}
-	}
-}
-type DefaultEventsMap = {
-	[event: string]: (...args: unknown[]) => void;
-};
-type EventsMap = {
-	[event: string]: unknown;
-};
-declare module "socket.io-client" {
-	interface Socket<ListenEvents extends EventsMap = DefaultEventsMap, EmitEvents extends EventsMap = ListenEvents> extends BaseSocket<ListenEvents, EmitEvents> {
-		timeout(ms: number): Socket<ListenEvents, EmitEvents> & {
-			/**
-			 * disallow emit, since it is not correctly typed
-			 * after this change.
-			 *
-			 * use emitWithAck instead.
-			 */
-			emit: never;
-		};
-	}
-}
-
-export {};