npm - portholejs - Versions diffs - 0.1.0 - Mend

portholejs 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (116) hide show

package/client-dist/assets/index-C_qSS_Gy.js +49 -0
package/client-dist/index.html +12 -0
package/dist/adb-actions.d.ts +4 -0
package/dist/adb-actions.d.ts.map +1 -0
package/dist/adb-actions.js +40 -0
package/dist/adb-actions.js.map +1 -0
package/dist/cli-errors.d.ts +5 -0
package/dist/cli-errors.d.ts.map +1 -0
package/dist/cli-errors.js +19 -0
package/dist/cli-errors.js.map +1 -0
package/dist/cli.d.ts +3 -0
package/dist/cli.d.ts.map +1 -0
package/dist/cli.js +542 -0
package/dist/cli.js.map +1 -0
package/dist/control-client.d.ts +22 -0
package/dist/control-client.d.ts.map +1 -0
package/dist/control-client.js +100 -0
package/dist/control-client.js.map +1 -0
package/dist/crashes.d.ts +8 -0
package/dist/crashes.d.ts.map +1 -0
package/dist/crashes.js +38 -0
package/dist/crashes.js.map +1 -0
package/dist/device-manager.d.ts +29 -0
package/dist/device-manager.d.ts.map +1 -0
package/dist/device-manager.js +213 -0
package/dist/device-manager.js.map +1 -0
package/dist/doctor.d.ts +8 -0
package/dist/doctor.d.ts.map +1 -0
package/dist/doctor.js +115 -0
package/dist/doctor.js.map +1 -0
package/dist/engine/scrcpy-engine.d.ts +38 -0
package/dist/engine/scrcpy-engine.d.ts.map +1 -0
package/dist/engine/scrcpy-engine.js +216 -0
package/dist/engine/scrcpy-engine.js.map +1 -0
package/dist/engine/types.d.ts +26 -0
package/dist/engine/types.d.ts.map +1 -0
package/dist/engine/types.js +2 -0
package/dist/engine/types.js.map +1 -0
package/dist/index.d.ts +14 -0
package/dist/index.d.ts.map +1 -0
package/dist/index.js +9 -0
package/dist/index.js.map +1 -0
package/dist/input-validation.d.ts +5 -0
package/dist/input-validation.d.ts.map +1 -0
package/dist/input-validation.js +62 -0
package/dist/input-validation.js.map +1 -0
package/dist/input.d.ts +22 -0
package/dist/input.d.ts.map +1 -0
package/dist/input.js +2 -0
package/dist/input.js.map +1 -0
package/dist/keycodes.d.ts +19 -0
package/dist/keycodes.d.ts.map +1 -0
package/dist/keycodes.js +32 -0
package/dist/keycodes.js.map +1 -0
package/dist/log.d.ts +3 -0
package/dist/log.d.ts.map +1 -0
package/dist/log.js +10 -0
package/dist/log.js.map +1 -0
package/dist/mcp/server.d.ts +2 -0
package/dist/mcp/server.d.ts.map +1 -0
package/dist/mcp/server.js +401 -0
package/dist/mcp/server.js.map +1 -0
package/dist/middleware.d.ts +13 -0
package/dist/middleware.d.ts.map +1 -0
package/dist/middleware.js +31 -0
package/dist/middleware.js.map +1 -0
package/dist/paths.d.ts +5 -0
package/dist/paths.d.ts.map +1 -0
package/dist/paths.js +27 -0
package/dist/paths.js.map +1 -0
package/dist/port-check.d.ts +5 -0
package/dist/port-check.d.ts.map +1 -0
package/dist/port-check.js +27 -0
package/dist/port-check.js.map +1 -0
package/dist/profiles.d.ts +4 -0
package/dist/profiles.d.ts.map +1 -0
package/dist/profiles.js +25 -0
package/dist/profiles.js.map +1 -0
package/dist/protocol.d.ts +10 -0
package/dist/protocol.d.ts.map +1 -0
package/dist/protocol.js +27 -0
package/dist/protocol.js.map +1 -0
package/dist/server/frame-convert.d.ts +6 -0
package/dist/server/frame-convert.d.ts.map +1 -0
package/dist/server/frame-convert.js +33 -0
package/dist/server/frame-convert.js.map +1 -0
package/dist/server/http.d.ts +20 -0
package/dist/server/http.d.ts.map +1 -0
package/dist/server/http.js +509 -0
package/dist/server/http.js.map +1 -0
package/dist/server/mjpeg.d.ts +21 -0
package/dist/server/mjpeg.d.ts.map +1 -0
package/dist/server/mjpeg.js +92 -0
package/dist/server/mjpeg.js.map +1 -0
package/dist/server/ws.d.ts +15 -0
package/dist/server/ws.d.ts.map +1 -0
package/dist/server/ws.js +102 -0
package/dist/server/ws.js.map +1 -0
package/dist/session.d.ts +45 -0
package/dist/session.d.ts.map +1 -0
package/dist/session.js +188 -0
package/dist/session.js.map +1 -0
package/dist/state.d.ts +27 -0
package/dist/state.d.ts.map +1 -0
package/dist/state.js +70 -0
package/dist/state.js.map +1 -0
package/dist/target-resolution.d.ts +14 -0
package/dist/target-resolution.d.ts.map +1 -0
package/dist/target-resolution.js +37 -0
package/dist/target-resolution.js.map +1 -0
package/dist/ui-tree.d.ts +47 -0
package/dist/ui-tree.d.ts.map +1 -0
package/dist/ui-tree.js +179 -0
package/dist/ui-tree.js.map +1 -0
package/package.json +63 -0
package/scripts/download-scrcpy-server.mjs +67 -0

package/client-dist/index.html ADDED Viewed

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Porthole</title>
+    <script type="module" crossorigin src="/assets/index-C_qSS_Gy.js"></script>
+  </head>
+  <body>
+    <div id="root"></div>
+  </body>
+</html>

package/dist/adb-actions.d.ts ADDED Viewed

@@ -0,0 +1,4 @@
+export declare function openUrl(serial: string, url: string): Promise<string>;
+export declare function stopApp(serial: string, packageName: string): Promise<void>;
+export declare function clearApp(serial: string, packageName: string): Promise<void>;
+//# sourceMappingURL=adb-actions.d.ts.map

package/dist/adb-actions.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"adb-actions.d.ts","sourceRoot":"","sources":["../src/adb-actions.ts"],"names":[],"mappings":"AAMA,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAc1E;AAED,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAShF;AAED,wBAAsB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASjF"}

package/dist/adb-actions.js ADDED Viewed

@@ -0,0 +1,40 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { adbBin, findAndroidSdk } from "./device-manager.js";
+const execFileAsync = promisify(execFile);
+export async function openUrl(serial, url) {
+    const { stdout } = await execFileAsync(adbBin(findAndroidSdk()), [
+        "-s",
+        serial,
+        "shell",
+        "am",
+        "start",
+        "-W",
+        "-a",
+        "android.intent.action.VIEW",
+        "-d",
+        url,
+    ]);
+    return stdout;
+}
+export async function stopApp(serial, packageName) {
+    await execFileAsync(adbBin(findAndroidSdk()), [
+        "-s",
+        serial,
+        "shell",
+        "am",
+        "force-stop",
+        packageName,
+    ]);
+}
+export async function clearApp(serial, packageName) {
+    await execFileAsync(adbBin(findAndroidSdk()), [
+        "-s",
+        serial,
+        "shell",
+        "pm",
+        "clear",
+        packageName,
+    ]);
+}
+//# sourceMappingURL=adb-actions.js.map

package/dist/adb-actions.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"adb-actions.js","sourceRoot":"","sources":["../src/adb-actions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE7D,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,MAAc,EAAE,GAAW;IACvD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC,EAAE;QAC/D,IAAI;QACJ,MAAM;QACN,OAAO;QACP,IAAI;QACJ,OAAO;QACP,IAAI;QACJ,IAAI;QACJ,4BAA4B;QAC5B,IAAI;QACJ,GAAG;KACJ,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,MAAc,EAAE,WAAmB;IAC/D,MAAM,aAAa,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC,EAAE;QAC5C,IAAI;QACJ,MAAM;QACN,OAAO;QACP,IAAI;QACJ,YAAY;QACZ,WAAW;KACZ,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,MAAc,EAAE,WAAmB;IAChE,MAAM,aAAa,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC,EAAE;QAC5C,IAAI;QACJ,MAAM;QACN,OAAO;QACP,IAAI;QACJ,OAAO;QACP,WAAW;KACZ,CAAC,CAAC;AACL,CAAC"}

package/dist/cli-errors.d.ts ADDED Viewed

@@ -0,0 +1,5 @@
+export interface CliErrorOptions {
+    quiet?: boolean;
+}
+export declare function runCliAction(opts: CliErrorOptions, action: () => Promise<void>): Promise<void>;
+//# sourceMappingURL=cli-errors.d.ts.map

package/dist/cli-errors.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"cli-errors.d.ts","sourceRoot":"","sources":["../src/cli-errors.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,YAAY,CAChC,IAAI,EAAE,eAAe,EACrB,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAC1B,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/dist/cli-errors.js ADDED Viewed

@@ -0,0 +1,19 @@
+export async function runCliAction(opts, action) {
+    try {
+        await action();
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (process.env["PORTHOLE_DEBUG"]) {
+            console.error(error);
+        }
+        else if (opts.quiet) {
+            process.stderr.write(JSON.stringify({ error: message }) + "\n");
+        }
+        else {
+            process.stderr.write(`porthole: ${message}\n`);
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=cli-errors.js.map

package/dist/cli-errors.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"cli-errors.js","sourceRoot":"","sources":["../src/cli-errors.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAqB,EACrB,MAA2B;IAE3B,IAAI,CAAC;QACH,MAAM,MAAM,EAAE,CAAC;IACjB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAClC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;aAAM,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QAClE,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,OAAO,IAAI,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/cli.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js ADDED Viewed

@@ -0,0 +1,542 @@
+#!/usr/bin/env node
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { createInterface } from "node:readline/promises";
+import { fileURLToPath } from "node:url";
+import { Command } from "commander";
+import { listDevices, findAndroidSdk, bootDevice, shutdownDevice, wasBootedByUs, reconnectOfflineDevices, } from "./device-manager.js";
+import { REMOTE_BUTTON_TO_KEYCODE } from "./keycodes.js";
+import { Session } from "./session.js";
+import { startMcpServer } from "./mcp/server.js";
+import { VERSION } from "./index.js";
+import { resolveTarget } from "./target-resolution.js";
+import { defaultScreenshotPath, fetchSessionScreenshot, getSessionJson, postSessionJson, sendSessionInput, writeScreenshot, } from "./control-client.js";
+import { readState } from "./state.js";
+import { runCliAction } from "./cli-errors.js";
+import { runDoctor } from "./doctor.js";
+import { ensurePortFree } from "./port-check.js";
+const program = new Command();
+if (Number(process.versions.node.split(".")[0] ?? "0") < 20) {
+    console.error("porthole: Node.js 20 or newer is required.");
+    process.exit(1);
+}
+program.name("porthole").description("Android emulator preview").version(VERSION);
+program
+    .command("list", { isDefault: false })
+    .description("List AVDs and running emulators")
+    .option("-q, --quiet", "JSON output")
+    .action(async (opts) => {
+    const devices = await listDevices();
+    const state = await readState();
+    if (opts.quiet) {
+        process.stdout.write(JSON.stringify({ devices, sessions: state.sessions }) + "\n");
+    }
+    else {
+        if (devices.length === 0) {
+            console.log("No AVDs found.");
+        }
+        else {
+            for (const d of devices) {
+                const status = d.state === "running"
+                    ? `running (${d.serial})`
+                    : d.state === "offline"
+                        ? `offline (${d.serial})`
+                        : "stopped";
+                console.log(`  ${d.name}  [${d.profile}]  ${status}`);
+            }
+        }
+        if (state.sessions.length > 0) {
+            console.log("\nActive sessions:");
+            for (const session of state.sessions) {
+                console.log(`  ${session.avdName}  ${session.url}  pid=${session.pid} serial=${session.serial}`);
+            }
+        }
+    }
+});
+program
+    .command("doctor")
+    .description("Check local Porthole and Android emulator prerequisites")
+    .option("-q, --quiet", "JSON output")
+    .action((opts) => {
+    void runCliAction(opts, async () => {
+        const checks = await runDoctor();
+        if (opts.quiet) {
+            process.stdout.write(JSON.stringify({ checks }) + "\n");
+            return;
+        }
+        for (const check of checks) {
+            const mark = check.ok ? "OK" : "FAIL";
+            console.log(`${mark} ${check.name}: ${check.detail}`);
+            if (!check.ok && check.fix)
+                console.log(`  fix: ${check.fix}`);
+        }
+        if (checks.some((check) => !check.ok))
+            process.exit(1);
+    });
+});
+program
+    .command("start [avd]", { isDefault: true })
+    .description("Boot/attach emulator and serve preview")
+    .option("-p, --port <port>", "HTTP port", "3200")
+    .option("-d, --device <serial>", "Target device serial")
+    .option("--host <host>", "Bind address", "127.0.0.1")
+    .option("--no-preview", "Don't open browser")
+    .option("--mjpeg", "MJPEG mode")
+    .option("--detach", "Run the preview server in the background")
+    .option("--keep-alive", "Leave a Porthole-booted emulator running on exit")
+    .option("--wipe-data", "Wipe emulator data before boot")
+    .option("--no-snapshot", "Disable loading/saving emulator snapshots")
+    .option("--cold-boot", "Alias for --no-snapshot")
+    .option("--gpu <mode>", "Pass emulator GPU mode")
+    .option("--max-size <px>", "Maximum stream dimension", "1280")
+    .option("--max-fps <fps>", "Maximum stream FPS", "30")
+    .option("--bitrate <bps>", "Stream bitrate in bits per second")
+    .option("-q, --quiet", "Quiet/JSON mode")
+    .action(async (avd, opts) => {
+    // Check the port before prompting, booting, or detaching — a busy port
+    // otherwise surfaces as a boot wasted on a doomed session or as an
+    // opaque detach timeout.
+    const portError = await ensurePortFree(parseInt(opts.port, 10), opts.host);
+    if (portError) {
+        console.error(portError);
+        process.exit(1);
+    }
+    if (opts.detach && process.env["PORTHOLE_DETACHED_CHILD"] !== "1") {
+        await startDetached(avd, opts);
+        return;
+    }
+    const sdk = findAndroidSdk();
+    let devices = await listDevices();
+    let selectedAvd = avd;
+    if (!selectedAvd && !opts.device && !opts.quiet) {
+        selectedAvd = await promptForAvd(devices);
+    }
+    const resolution = resolveTarget(devices, selectedAvd, opts.device);
+    let target;
+    let bootedByUs = false;
+    if (resolution.action === "error") {
+        console.error(resolution.message);
+        process.exit(1);
+    }
+    if (resolution.action === "boot") {
+        if (!opts.quiet)
+            console.log(`Booting ${resolution.avdName}...`);
+        const serial = await bootDevice({
+            sdk,
+            avdName: resolution.avdName,
+            emulatorArgs: emulatorArgs(opts),
+        });
+        devices = await listDevices();
+        target = devices.find((d) => d.serial === serial);
+        bootedByUs = true;
+    }
+    else {
+        target = resolution.device;
+    }
+    if (target?.state === "offline") {
+        if (!opts.quiet)
+            console.log(`Reconnecting ${target.serial}...`);
+        await reconnectOfflineDevices(sdk, target.serial ?? undefined);
+        devices = await listDevices();
+        const reconnected = devices.find((device) => (target?.serial && device.serial === target.serial) ||
+            device.name === target?.name);
+        if (reconnected) {
+            target = reconnected;
+        }
+    }
+    if (!target || !target.serial || target.state !== "running") {
+        console.error("No target device.");
+        process.exit(1);
+    }
+    const session = new Session({
+        device: target,
+        port: parseInt(opts.port, 10),
+        host: opts.host,
+        maxSize: Number(opts.maxSize),
+        maxFps: Number(opts.maxFps),
+        bitrate: opts.bitrate ? Number(opts.bitrate) : undefined,
+        bootedByUs,
+        detached: process.env["PORTHOLE_DETACHED_CHILD"] === "1",
+        forceMjpeg: opts.mjpeg ?? false,
+    });
+    try {
+        const { url } = await session.start();
+        if (!opts.quiet) {
+            console.log(`Attached to ${target.name} [${target.profile}] (${target.serial})`);
+            console.log(`Preview: ${url}`);
+            if (opts.mjpeg)
+                console.log("Video mode: MJPEG screenshot polling");
+        }
+        else {
+            process.stdout.write(JSON.stringify({ device: target, url }) + "\n");
+        }
+        if (opts.preview && process.env["PORTHOLE_DETACHED_CHILD"] !== "1") {
+            openBrowser(url);
+        }
+    }
+    catch (e) {
+        const message = e instanceof Error ? e.message : String(e);
+        if (message.includes("EADDRINUSE")) {
+            console.error(`Port ${opts.port} is already in use. Try another port with -p ${Number(opts.port) + 1}.`);
+        }
+        else {
+            console.error(`Failed to start: ${message}`);
+        }
+        if (bootedByUs && !opts.keepAlive && target.serial) {
+            await shutdownDevice(sdk, target.serial);
+        }
+        process.exit(1);
+    }
+    const stopForSignal = async () => {
+        await session.stop();
+        if (bootedByUs && !opts.keepAlive && target.serial) {
+            await shutdownDevice(sdk, target.serial);
+        }
+        process.exit(0);
+    };
+    process.on("SIGINT", () => void stopForSignal());
+    process.on("SIGTERM", () => void stopForSignal());
+});
+program
+    .command("kill [avd]")
+    .description("Stop emulator(s) Porthole started")
+    .option("-q, --quiet", "JSON output")
+    .action(async (avd, opts) => {
+    const sdk = findAndroidSdk();
+    const devices = await listDevices();
+    const state = await readState();
+    const targetSerials = new Set();
+    for (const d of devices) {
+        if (d.state === "running" &&
+            d.serial &&
+            (avd ? d.name === avd : await wasBootedByUs(d.serial))) {
+            targetSerials.add(d.serial);
+        }
+    }
+    for (const session of state.sessions) {
+        if (!avd || session.avdName === avd) {
+            targetSerials.add(session.serial);
+            if (session.detached && session.pid !== process.pid) {
+                try {
+                    process.kill(session.pid, "SIGTERM");
+                }
+                catch {
+                    // process already gone
+                }
+            }
+        }
+    }
+    if (targetSerials.size === 0) {
+        if (opts.quiet) {
+            process.stdout.write(JSON.stringify({ killed: [] }) + "\n");
+        }
+        else {
+            console.log("No emulators to kill.");
+        }
+        return;
+    }
+    const killed = [];
+    for (const serial of targetSerials) {
+        if (!opts.quiet) {
+            console.log(`Shutting down ${serial}...`);
+        }
+        await shutdownDevice(sdk, serial);
+        killed.push(serial);
+    }
+    if (opts.quiet) {
+        process.stdout.write(JSON.stringify({ killed }) + "\n");
+    }
+});
+program
+    .command("tap <x> <y>")
+    .description("Touch at normalized 0..1 coordinates")
+    .option("-p, --port <port>", "Session port")
+    .option("-q, --quiet", "JSON output")
+    .action((x, y, opts) => {
+    void runCliAction(opts, async () => {
+        const nx = parseFloat(x);
+        const ny = parseFloat(y);
+        if (isNaN(nx) || isNaN(ny) || nx < 0 || nx > 1 || ny < 0 || ny > 1) {
+            throw new Error("Coordinates must be numbers in 0..1");
+        }
+        await sendSessionInput({ kind: "touch", phase: "down", x: nx, y: ny }, { port: parseOptionalPort(opts.port) });
+        const session = await sendSessionInput({ kind: "touch", phase: "up", x: nx, y: ny }, { port: parseOptionalPort(opts.port) });
+        printResult(opts.quiet, { ok: true, session, event: "tap" }, `Tapped ${nx},${ny}`);
+    });
+});
+program
+    .command("key <keycode>")
+    .description("Send a single Android keyevent")
+    .option("-p, --port <port>", "Session port")
+    .option("-q, --quiet", "JSON output")
+    .action((keycode, opts) => {
+    void runCliAction(opts, async () => {
+        const code = parseInt(keycode, 10);
+        if (isNaN(code)) {
+            throw new Error("Keycode must be a number");
+        }
+        await sendSessionInput({ kind: "key", phase: "down", keycode: code }, { port: parseOptionalPort(opts.port) });
+        const session = await sendSessionInput({ kind: "key", phase: "up", keycode: code }, { port: parseOptionalPort(opts.port) });
+        printResult(opts.quiet, { ok: true, session, keycode: code }, `Key ${code} sent`);
+    });
+});
+program
+    .command("remote <button>")
+    .description("D-pad / media remote button")
+    .option("-p, --port <port>", "Session port")
+    .option("-q, --quiet", "JSON output")
+    .action((button, opts) => {
+    void runCliAction(opts, async () => {
+        if (!(button in REMOTE_BUTTON_TO_KEYCODE)) {
+            throw new Error(`Unknown button: ${button}. Valid: ${Object.keys(REMOTE_BUTTON_TO_KEYCODE).join(", ")}`);
+        }
+        const session = await sendSessionInput({ kind: "remote", button: button }, { port: parseOptionalPort(opts.port) });
+        printResult(opts.quiet, { ok: true, session, button }, `Remote: ${button}`);
+    });
+});
+program
+    .command("text <string>")
+    .description("Type text")
+    .option("-p, --port <port>", "Session port")
+    .option("-q, --quiet", "JSON output")
+    .action((text, opts) => {
+    void runCliAction(opts, async () => {
+        const session = await sendSessionInput({ kind: "text", text }, { port: parseOptionalPort(opts.port) });
+        printResult(opts.quiet, { ok: true, session, text }, `Typed "${text}"`);
+    });
+});
+program
+    .command("screenshot")
+    .description("Take a PNG screenshot from a running session")
+    .option("-p, --port <port>", "Session port")
+    .option("-o, --output <file>", "Output path")
+    .option("-q, --quiet", "JSON output")
+    .action((opts) => {
+    void runCliAction(opts, async () => {
+        const { session, png } = await fetchSessionScreenshot({
+            port: parseOptionalPort(opts.port),
+        });
+        const output = opts.output ?? defaultScreenshotPath(session.serial);
+        await writeScreenshot(output, png);
+        printResult(opts.quiet, { ok: true, path: output, session }, output);
+    });
+});
+program
+    .command("rotate <orientation>")
+    .description("Rotate a phone session: portrait, landscape, left, or right")
+    .option("-p, --port <port>", "Session port")
+    .option("-q, --quiet", "JSON output")
+    .action((orientation, opts) => {
+    void runCliAction(opts, async () => {
+        const result = await postSessionJson("/api/rotate", { orientation }, { port: parseOptionalPort(opts.port) });
+        printResult(opts.quiet, { ok: true, ...result }, `Rotated ${orientation}`);
+    });
+});
+program
+    .command("emu <args...>")
+    .description("Pass arguments to adb emu for the active session")
+    .option("-p, --port <port>", "Session port")
+    .option("-q, --quiet", "JSON output")
+    .action((args, opts) => {
+    void runCliAction(opts, async () => {
+        const result = await postSessionJson("/api/emu", { args }, { port: parseOptionalPort(opts.port) });
+        printResult(opts.quiet, { ok: true, ...result }, "Emulator command sent");
+    });
+});
+program
+    .command("focused")
+    .description("Print the currently focused UI node")
+    .option("-p, --port <port>", "Session port")
+    .option("-q, --quiet", "JSON output")
+    .action((opts) => {
+    void runCliAction(opts, async () => {
+        const result = await getSessionJson("/api/focused", {
+            port: parseOptionalPort(opts.port),
+        });
+        printResult(opts.quiet, result, JSON.stringify(result.response, null, 2));
+    });
+});
+program
+    .command("dump-ui")
+    .description("Dump the Android accessibility hierarchy")
+    .option("-p, --port <port>", "Session port")
+    .option("--filter <text>", "Filter by text/resource id/content description")
+    .option("-q, --quiet", "JSON output")
+    .action((opts) => {
+    void runCliAction(opts, async () => {
+        const query = opts.filter
+            ? `?${new URLSearchParams({ filter: opts.filter }).toString()}`
+            : "";
+        const result = await getSessionJson(`/api/ui${query}`, {
+            port: parseOptionalPort(opts.port),
+        });
+        printResult(opts.quiet, result, JSON.stringify(result.response, null, 2));
+    });
+});
+program
+    .command("wait-for <text>")
+    .description("Wait until text appears in the UI hierarchy")
+    .option("-p, --port <port>", "Session port")
+    .option("--timeout <ms>", "Timeout in milliseconds", "10000")
+    .option("-q, --quiet", "JSON output")
+    .action((text, opts) => {
+    void runCliAction(opts, async () => {
+        const result = await postSessionJson("/api/wait_for", { text, timeoutMs: Number(opts.timeout) }, { port: parseOptionalPort(opts.port) });
+        printResult(opts.quiet, { ok: true, ...result }, `Found "${text}"`);
+    });
+});
+program
+    .command("open-url <url>")
+    .description("Open an Android deep link or URL")
+    .option("-p, --port <port>", "Session port")
+    .option("-q, --quiet", "JSON output")
+    .action((url, opts) => {
+    void runCliAction(opts, async () => {
+        const result = await postSessionJson("/api/open_url", { url }, { port: parseOptionalPort(opts.port) });
+        printResult(opts.quiet, { ok: true, ...result }, `Opened ${url}`);
+    });
+});
+program
+    .command("stop-app <package>")
+    .description("Force-stop an app package")
+    .option("-p, --port <port>", "Session port")
+    .option("-q, --quiet", "JSON output")
+    .action((packageName, opts) => {
+    void runCliAction(opts, async () => {
+        const result = await postSessionJson("/api/stop_app", { packageName }, { port: parseOptionalPort(opts.port) });
+        printResult(opts.quiet, { ok: true, ...result }, `Stopped ${packageName}`);
+    });
+});
+program
+    .command("clear-app <package>")
+    .description("Clear an app package's data")
+    .option("-p, --port <port>", "Session port")
+    .option("-q, --quiet", "JSON output")
+    .action((packageName, opts) => {
+    void runCliAction(opts, async () => {
+        const result = await postSessionJson("/api/clear_app", { packageName }, { port: parseOptionalPort(opts.port) });
+        printResult(opts.quiet, { ok: true, ...result }, `Cleared ${packageName}`);
+    });
+});
+program
+    .command("mcp")
+    .description("Run the MCP server on stdio")
+    .action(async () => {
+    await startMcpServer();
+});
+program.parse();
+async function startDetached(avd, opts) {
+    const cliPath = fileURLToPath(import.meta.url);
+    const args = [cliPath, "start"];
+    if (avd)
+        args.push(avd);
+    args.push("--port", opts.port, "--host", opts.host, "--no-preview");
+    if (opts.device)
+        args.push("--device", opts.device);
+    if (opts.mjpeg)
+        args.push("--mjpeg");
+    if (opts.keepAlive)
+        args.push("--keep-alive");
+    if (opts.wipeData)
+        args.push("--wipe-data");
+    if (opts.snapshot === false || opts.coldBoot)
+        args.push("--no-snapshot");
+    if (opts.gpu)
+        args.push("--gpu", opts.gpu);
+    args.push("--max-size", opts.maxSize, "--max-fps", opts.maxFps);
+    if (opts.bitrate)
+        args.push("--bitrate", opts.bitrate);
+    if (opts.quiet)
+        args.push("--quiet");
+    const child = spawn(process.execPath, args, {
+        detached: true,
+        stdio: "ignore",
+        env: { ...process.env, PORTHOLE_DETACHED_CHILD: "1" },
+    });
+    child.unref();
+    const port = parsePort(opts.port);
+    const deadline = Date.now() + 120_000;
+    let session;
+    while (Date.now() < deadline) {
+        const state = await readState();
+        session = state.sessions.find((record) => record.port === port && record.pid === child.pid);
+        if (session)
+            break;
+        await new Promise((resolve) => setTimeout(resolve, 500));
+    }
+    if (!session) {
+        console.error("Detached server did not become ready before the timeout.");
+        process.exit(1);
+    }
+    if (opts.quiet) {
+        process.stdout.write(JSON.stringify(session) + "\n");
+    }
+    else {
+        console.log(`Detached Porthole server pid=${session.pid}`);
+        console.log(`Preview: ${session.url}`);
+    }
+}
+function emulatorArgs(opts) {
+    const args = [];
+    if (opts.wipeData)
+        args.push("-wipe-data");
+    if (opts.snapshot === false || opts.coldBoot) {
+        args.push("-no-snapshot-load", "-no-snapshot-save");
+    }
+    else {
+        args.push("-no-snapshot-load");
+    }
+    if (opts.gpu)
+        args.push("-gpu", opts.gpu);
+    return args;
+}
+async function promptForAvd(devices) {
+    const stopped = devices.filter((device) => device.state === "stopped");
+    if (stopped.length === 0)
+        return undefined;
+    console.log("Choose an AVD to boot:");
+    stopped.forEach((device, index) => {
+        console.log(`  ${index + 1}. ${device.name} [${device.profile}]`);
+    });
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        const answer = await rl.question("AVD number: ");
+        const index = Number(answer) - 1;
+        return stopped[index]?.name;
+    }
+    finally {
+        rl.close();
+    }
+}
+function openBrowser(url) {
+    const command = process.platform === "darwin"
+        ? "open"
+        : process.platform === "win32"
+            ? "cmd"
+            : "xdg-open";
+    const args = process.platform === "win32" ? ["/c", "start", "", url] : [url];
+    if (process.platform !== "win32" && !existsSync(`/usr/bin/${command}`)) {
+        return;
+    }
+    const child = spawn(command, args, { detached: true, stdio: "ignore" });
+    child.unref();
+}
+function parseOptionalPort(port) {
+    return port === undefined ? undefined : parsePort(port);
+}
+function parsePort(port) {
+    const parsed = Number(port);
+    if (!Number.isInteger(parsed) || parsed <= 0 || parsed > 65535) {
+        throw new Error(`Invalid port: ${port}`);
+    }
+    return parsed;
+}
+function printResult(quiet, json, text) {
+    if (quiet) {
+        process.stdout.write(JSON.stringify(json) + "\n");
+    }
+    else {
+        console.log(text);
+    }
+}
+//# sourceMappingURL=cli.js.map