@0xhayd3n/fling 0.6.0

package/dist/devices.js

@@ -0,0 +1,143 @@
+import { runAdb } from "./adb.js";
+import { FlingError } from "./errors.js";
+const KNOWN_STATES = [
+    "device",
+    "unauthorized",
+    "offline",
+    "no permissions",
+    "recovery",
+    "sideload",
+    "bootloader",
+];
+export function parseDevicesOutput(stdout) {
+    const lines = stdout.split(/\r?\n/);
+    const headerIdx = lines.findIndex((l) => l.trim().startsWith("List of devices attached"));
+    if (headerIdx === -1)
+        return [];
+    const devices = [];
+    for (let i = headerIdx + 1; i < lines.length; i++) {
+        const line = lines[i];
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        if (trimmed.startsWith("*"))
+            continue;
+        const parts = trimmed.split(/\s+/);
+        if (parts.length < 2)
+            continue;
+        const serial = parts[0];
+        let state = "unknown";
+        let rest = [];
+        const twoWord = `${parts[1]} ${parts[2] ?? ""}`.trim();
+        if (KNOWN_STATES.includes(twoWord) &&
+            twoWord.includes(" ")) {
+            state = twoWord;
+            rest = parts.slice(3);
+        }
+        else if (KNOWN_STATES.includes(parts[1])) {
+            state = parts[1];
+            rest = parts.slice(2);
+        }
+        else {
+            state = "unknown";
+            rest = parts.slice(2);
+        }
+        const device = { serial, state, raw: trimmed };
+        for (const token of rest) {
+            const colonIdx = token.indexOf(":");
+            if (colonIdx === -1)
+                continue;
+            const key = token.slice(0, colonIdx);
+            const value = token.slice(colonIdx + 1);
+            switch (key) {
+                case "product":
+                    device.product = value;
+                    break;
+                case "model":
+                    device.model = value;
+                    break;
+                case "device":
+                    device.device = value;
+                    break;
+                case "transport_id":
+                    device.transportId = value;
+                    break;
+                case "usb":
+                    device.usb = value;
+                    break;
+            }
+        }
+        devices.push(device);
+    }
+    return devices;
+}
+export async function listDevices() {
+    const { stdout } = await runAdb(["devices", "-l"]);
+    return parseDevicesOutput(stdout);
+}
+export function formatDevicesSummary(devices) {
+    if (devices.length === 0) {
+        return [
+            "No Android devices detected.",
+            "",
+            "Checklist:",
+            "  • Phone connected via USB (or paired over Wi-Fi).",
+            "  • USB Debugging enabled (Settings → Developer options).",
+            "  • RSA fingerprint prompt accepted on the phone.",
+        ].join("\n");
+    }
+    const lines = [
+        `${devices.length} device${devices.length === 1 ? "" : "s"} detected:`,
+        "",
+    ];
+    devices.forEach((d, idx) => {
+        const label = d.model ?? d.product ?? d.device ?? "unknown model";
+        lines.push(`${idx + 1}. ${d.serial}  [${d.state}]  ${label}`);
+        if (d.state === "unauthorized") {
+            lines.push("     → Accept the RSA fingerprint prompt on the phone, then re-run.");
+        }
+        else if (d.state === "offline") {
+            lines.push("     → Device is offline. Try unplugging/re-plugging or `adb kill-server`.");
+        }
+        else if (d.state === "no permissions") {
+            lines.push("     → adb lacks USB permissions. On Linux, configure udev rules; on Windows, reinstall the OEM USB driver.");
+        }
+        else if (d.state === "unknown") {
+            lines.push(`     → Unrecognized state. Raw: ${d.raw}`);
+        }
+    });
+    return lines.join("\n");
+}
+/**
+ * Resolve which `-s <id>` args to pass to adb.
+ *
+ * Priority: explicit deviceId → ANDROID_SERIAL env → auto-pick the single ready
+ * device. Throws FlingError when ambiguous or impossible.
+ */
+export async function resolveDeviceArgs(deviceId) {
+    if (deviceId)
+        return { args: ["-s", deviceId], serial: deviceId };
+    const envSerial = process.env.ANDROID_SERIAL;
+    if (envSerial)
+        return { args: ["-s", envSerial], serial: envSerial };
+    const devices = await listDevices();
+    const ready = devices.filter((d) => d.state === "device");
+    if (ready.length === 1) {
+        return { args: ["-s", ready[0].serial], serial: ready[0].serial };
+    }
+    if (ready.length === 0) {
+        if (devices.length === 0) {
+            throw new FlingError("NO_DEVICE", "No Android devices detected. Plug in a phone with USB Debugging enabled, " +
+                "or run list_devices for the full checklist.");
+        }
+        const states = devices.map((d) => `${d.serial} (${d.state})`).join(", ");
+        const hint = devices.some((d) => d.state === "unauthorized")
+            ? "Accept the RSA fingerprint prompt on the phone, then retry."
+            : "Run list_devices for per-device guidance.";
+        throw new FlingError("NO_READY_DEVICE", `No devices are in the 'device' state: ${states}. ${hint}`);
+    }
+    const serials = ready.map((d) => d.serial).join(", ");
+    throw new FlingError("MULTIPLE_DEVICES", `${ready.length} devices ready (${serials}). Pass device_id to pick one, ` +
+        "or set the ANDROID_SERIAL environment variable.");
+}
+//# sourceMappingURL=devices.js.map

package/dist/devices.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,13 @@
+export type FlingErrorCode = "ADB_NOT_FOUND" | "ADB_TIMEOUT" | "ADB_FAILED" | "NO_DEVICE" | "NO_READY_DEVICE" | "MULTIPLE_DEVICES" | "APK_NOT_FOUND" | "INSTALL_FAILED" | "LAUNCH_FAILED" | "APP_NOT_RUNNING" | "INVALID_INPUT" | "UI_ELEMENT_NOT_FOUND" | "UI_WAIT_TIMEOUT" | "ADB_SHELL_SHUT_DOWN" | "ADB_SHELL_DIED" | "ADB_SHELL_RECYCLED" | "BUILD_TOOL_NOT_FOUND" | "BUILD_TIMEOUT" | "BUILD_FAILED" | "CONFIG_MISSING" | "PAIRING_TIMEOUT" | "ADB_PAIR_FAILED" | "ADB_CONNECT_FAILED" | "MDNS_UNAVAILABLE" | "UNKNOWN_SERVICE" | "PAIRING_IN_PROGRESS";
+export declare class FlingError extends Error {
+    readonly code: FlingErrorCode;
+    readonly stderr?: string;
+    readonly stdout?: string;
+    readonly exitCode?: number;
+    constructor(code: FlingErrorCode, message: string, extras?: {
+        stderr?: string;
+        stdout?: string;
+        exitCode?: number;
+    });
+}
+export declare function describeError(err: unknown): string;

package/dist/errors.js

@@ -0,0 +1,22 @@
+export class FlingError extends Error {
+    code;
+    stderr;
+    stdout;
+    exitCode;
+    constructor(code, message, extras = {}) {
+        super(message);
+        this.name = "FlingError";
+        this.code = code;
+        this.stderr = extras.stderr;
+        this.stdout = extras.stdout;
+        this.exitCode = extras.exitCode;
+    }
+}
+export function describeError(err) {
+    if (err instanceof FlingError)
+        return `${err.code}: ${err.message}`;
+    if (err instanceof Error)
+        return err.message;
+    return String(err);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AA4BA,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC1B,IAAI,CAAiB;IACrB,MAAM,CAAU;IAChB,MAAM,CAAU;IAChB,QAAQ,CAAU;IAE3B,YACE,IAAoB,EACpB,OAAe,EACf,SAAkE,EAAE;QAEpE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAClC,CAAC;CACF;AAED,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,IAAI,GAAG,YAAY,UAAU;QAAE,OAAO,GAAG,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC;IACpE,IAAI,GAAG,YAAY,KAAK;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC;IAC7C,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC"}

package/dist/featureFlags.d.ts

@@ -0,0 +1,6 @@
+/**
+ * FLING_PERSISTENT_SHELL gates the persistent adb-shell pool path during
+ * rollout. Off by default; on for any of 1/true/yes/on (case-insensitive).
+ * Removed in Stage 4 once the pool path is stable.
+ */
+export declare function isPersistentShellEnabled(): boolean;

package/dist/featureFlags.js

@@ -0,0 +1,11 @@
+const TRUTHY = new Set(["1", "true", "yes", "on"]);
+/**
+ * FLING_PERSISTENT_SHELL gates the persistent adb-shell pool path during
+ * rollout. Off by default; on for any of 1/true/yes/on (case-insensitive).
+ * Removed in Stage 4 once the pool path is stable.
+ */
+export function isPersistentShellEnabled() {
+    const v = (process.env.FLING_PERSISTENT_SHELL ?? "").trim().toLowerCase();
+    return TRUTHY.has(v);
+}
+//# sourceMappingURL=featureFlags.js.map

package/dist/featureFlags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"featureFlags.js","sourceRoot":"","sources":["../src/featureFlags.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;AAEnD;;;;GAIG;AACH,MAAM,UAAU,wBAAwB;IACtC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC1E,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC"}

package/dist/gradle.d.ts

@@ -0,0 +1,39 @@
+import { join } from "node:path";
+import type { FlingConfig } from "./config.js";
+declare const DEFAULT_GRADLE_TASK = "assembleDebug";
+export interface BuildCommand {
+    command: string;
+    args: string[];
+    source: "config" | "wrapper" | "path";
+}
+/**
+ * Resolve the command Fling should run for a build, given a buildCwd and
+ * the user's (possibly empty) config.
+ *
+ * Order of preference:
+ *   1. config.buildCommand (string split on whitespace, or array)
+ *   2. gradle wrapper at buildCwd (gradlew.bat on Windows, gradlew otherwise)
+ *   3. `gradle` on PATH
+ */
+export declare function resolveBuildCommand(buildCwd: string, config: FlingConfig): Promise<BuildCommand>;
+export interface RunBuildOptions {
+    timeoutMs?: number;
+    maxBufferBytes?: number;
+}
+export interface BuildOutcome {
+    command: BuildCommand;
+    stdout: string;
+    stderr: string;
+    durationMs: number;
+}
+/**
+ * Run a build command synchronously (no streaming) and return the captured
+ * output. Throws FlingError on non-zero exit, timeout, or missing tool.
+ */
+export declare function runBuild(cwd: string, command: BuildCommand, options?: RunBuildOptions): Promise<BuildOutcome>;
+/**
+ * Pull the most useful failure block out of a verbose gradle log. Falls
+ * back to the last 25 non-empty lines if no marker is found.
+ */
+export declare function extractBuildFailureReason(stdout: string, stderr: string): string;
+export { DEFAULT_GRADLE_TASK, join as joinPath };

package/dist/gradle.js

@@ -0,0 +1,129 @@
+import { execFile } from "node:child_process";
+import { stat } from "node:fs/promises";
+import { join, resolve as resolvePath } from "node:path";
+import { promisify } from "node:util";
+import { FlingError } from "./errors.js";
+const execFileAsync = promisify(execFile);
+const DEFAULT_GRADLE_TASK = "assembleDebug";
+const DEFAULT_BUILD_TIMEOUT_MS = 10 * 60 * 1000;
+const DEFAULT_BUILD_BUFFER_BYTES = 50 * 1024 * 1024;
+const IS_WINDOWS = process.platform === "win32";
+const TASK_NAME_RE = /^[A-Za-z][\w:.\-]*$/;
+async function fileExists(path) {
+    try {
+        const s = await stat(path);
+        return s.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+function splitBuildCommand(cmd) {
+    if (Array.isArray(cmd))
+        return cmd;
+    return cmd.trim().split(/\s+/).filter(Boolean);
+}
+/**
+ * Wrap an invocation through cmd.exe so we can run .bat/.cmd on Windows
+ * without enabling `shell: true`. NOTE: cmd.exe still interprets `&`, `|`,
+ * `>`, `<`, `^`, and parens in its arguments, so this is only safe when
+ * the args are validated/trusted. The two callers that reach this:
+ *   - gradleTask, validated by TASK_NAME_RE.
+ *   - config.buildCommand, which is part of the user's own project config
+ *     and is treated as trusted (the threat model is the same as a shell
+ *     script committed to the repo).
+ * Future callers must enforce equivalent validation.
+ */
+function wrapForWindowsBatch(command, args) {
+    return { command: "cmd.exe", args: ["/c", command, ...args] };
+}
+function looksLikeBatch(command) {
+    const lower = command.toLowerCase();
+    return lower.endsWith(".bat") || lower.endsWith(".cmd");
+}
+/**
+ * Resolve the command Fling should run for a build, given a buildCwd and
+ * the user's (possibly empty) config.
+ *
+ * Order of preference:
+ *   1. config.buildCommand (string split on whitespace, or array)
+ *   2. gradle wrapper at buildCwd (gradlew.bat on Windows, gradlew otherwise)
+ *   3. `gradle` on PATH
+ */
+export async function resolveBuildCommand(buildCwd, config) {
+    if (config.buildCommand) {
+        const tokens = splitBuildCommand(config.buildCommand);
+        if (tokens.length === 0) {
+            throw new FlingError("INVALID_INPUT", "buildCommand in fling config is empty.");
+        }
+        return { command: tokens[0], args: tokens.slice(1), source: "config" };
+    }
+    const task = config.gradleTask ?? DEFAULT_GRADLE_TASK;
+    if (!TASK_NAME_RE.test(task)) {
+        throw new FlingError("INVALID_INPUT", `Invalid gradleTask "${task}". Expected a gradle task identifier.`);
+    }
+    const wrapperName = IS_WINDOWS ? "gradlew.bat" : "gradlew";
+    const wrapperPath = resolvePath(buildCwd, wrapperName);
+    if (await fileExists(wrapperPath)) {
+        return { command: wrapperPath, args: [task], source: "wrapper" };
+    }
+    return { command: "gradle", args: [task], source: "path" };
+}
+/**
+ * Run a build command synchronously (no streaming) and return the captured
+ * output. Throws FlingError on non-zero exit, timeout, or missing tool.
+ */
+export async function runBuild(cwd, command, options = {}) {
+    const timeoutMs = options.timeoutMs ?? DEFAULT_BUILD_TIMEOUT_MS;
+    const maxBuffer = options.maxBufferBytes ?? DEFAULT_BUILD_BUFFER_BYTES;
+    let invocation = { command: command.command, args: command.args };
+    if (IS_WINDOWS && looksLikeBatch(command.command)) {
+        invocation = wrapForWindowsBatch(command.command, command.args);
+    }
+    const start = Date.now();
+    try {
+        const { stdout, stderr } = await execFileAsync(invocation.command, invocation.args, {
+            cwd,
+            timeout: timeoutMs,
+            maxBuffer,
+            windowsHide: true,
+        });
+        return { command, stdout, stderr, durationMs: Date.now() - start };
+    }
+    catch (err) {
+        const e = err;
+        if (e.code === "ENOENT") {
+            throw new FlingError("BUILD_TOOL_NOT_FOUND", command.source === "wrapper"
+                ? `Gradle wrapper not found at ${command.command}.`
+                : command.source === "path"
+                    ? "`gradle` was not found on PATH and no wrapper exists at the build cwd. " +
+                        "Either commit a gradle wrapper to the project or install Gradle and add it to PATH."
+                    : `Build command ${command.command} was not found.`);
+        }
+        if (e.killed) {
+            throw new FlingError("BUILD_TIMEOUT", `Build timed out after ${timeoutMs}ms`, { stdout: e.stdout, stderr: e.stderr });
+        }
+        const reason = extractBuildFailureReason(e.stdout ?? "", e.stderr ?? "");
+        const exitCode = typeof e.code === "number" ? e.code : undefined;
+        throw new FlingError("BUILD_FAILED", `Build failed${exitCode !== undefined ? ` (exit ${exitCode})` : ""}:\n${reason}`, { stdout: e.stdout, stderr: e.stderr, exitCode });
+    }
+}
+/**
+ * Pull the most useful failure block out of a verbose gradle log. Falls
+ * back to the last 25 non-empty lines if no marker is found.
+ */
+export function extractBuildFailureReason(stdout, stderr) {
+    const combined = `${stdout}\n${stderr}`.replace(/\r\n/g, "\n");
+    const whatWentWrong = combined.match(/\* What went wrong:[\s\S]*?(?=\n\* Try:|\n\* Exception|\nBUILD FAILED|\n\* Get more help|$)/);
+    if (whatWentWrong)
+        return whatWentWrong[0].trim();
+    const buildFailedIdx = combined.lastIndexOf("BUILD FAILED");
+    if (buildFailedIdx >= 0) {
+        const tail = combined.slice(Math.max(0, buildFailedIdx - 4000));
+        return tail.trim();
+    }
+    const lines = combined.split("\n").filter((l) => l.trim().length > 0);
+    return lines.slice(-25).join("\n").trim() || "(no output)";
+}
+export { DEFAULT_GRADLE_TASK, join as joinPath };
+//# sourceMappingURL=gradle.js.map

package/dist/gradle.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { registerBuildApp } from "./tools/build-app.js";
+import { registerDeployAndRun } from "./tools/deploy-and-run.js";
+import { registerDumpUi } from "./tools/dump-ui.js";
+import { registerFindOnScreen } from "./tools/find-on-screen.js";
+import { registerInstallApp } from "./tools/install-app.js";
+import { registerLaunchApp } from "./tools/launch-app.js";
+import { registerListDevices } from "./tools/list-devices.js";
+import { registerReadLogs } from "./tools/read-logs.js";
+import { registerScreenshot } from "./tools/screenshot.js";
+import { registerStopApp } from "./tools/stop-app.js";
+import { registerTapByContentDesc } from "./tools/tap-by-content-desc.js";
+import { registerTapByResourceId } from "./tools/tap-by-resource-id.js";
+import { registerTapByText } from "./tools/tap-by-text.js";
+import { registerDismissDialog } from "./tools/dismiss-dialog.js";
+import { registerUninstallApp } from "./tools/uninstall-app.js";
+import { registerWaitFor } from "./tools/wait-for.js";
+import { registerScrollUntilVisible } from "./tools/scroll-until-visible.js";
+import { registerOpenSetting } from "./tools/open-setting.js";
+import { registerTapTextVerified } from "./tools/tap-text-verified.js";
+import { registerLaunchAndWait } from "./tools/launch-and-wait.js";
+import { registerScreenshotWithUi } from "./tools/screenshot-with-ui.js";
+import { registerDeviceState } from "./tools/device-state.js";
+import { registerStartPairQr } from "./tools/start-pair-qr.js";
+import { registerWaitForPair } from "./tools/wait-for-pair.js";
+import { shutdownPool } from "./shellPool.js";
+const SERVER_NAME = "fling";
+const pkgPath = join(dirname(fileURLToPath(import.meta.url)), "..", "package.json");
+const SERVER_VERSION = JSON.parse(readFileSync(pkgPath, "utf8")).version;
+async function main() {
+    process.on("exit", () => shutdownPool());
+    process.on("SIGINT", () => {
+        shutdownPool();
+        process.exit(0);
+    });
+    const server = new McpServer({
+        name: SERVER_NAME,
+        version: SERVER_VERSION,
+    });
+    registerListDevices(server);
+    registerBuildApp(server);
+    registerInstallApp(server);
+    registerLaunchApp(server);
+    registerStopApp(server);
+    registerUninstallApp(server);
+    registerReadLogs(server);
+    registerScreenshot(server);
+    registerTapByText(server);
+    registerTapByResourceId(server);
+    registerTapByContentDesc(server);
+    registerDismissDialog(server);
+    registerWaitFor(server);
+    registerScrollUntilVisible(server);
+    registerDumpUi(server);
+    registerFindOnScreen(server);
+    registerDeployAndRun(server);
+    registerOpenSetting(server);
+    registerTapTextVerified(server);
+    registerLaunchAndWait(server);
+    registerScreenshotWithUi(server);
+    registerDeviceState(server);
+    registerStartPairQr(server);
+    registerWaitForPair(server);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    process.stderr.write(`[fling] fatal: ${err instanceof Error ? err.stack ?? err.message : String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/mdns.d.ts

@@ -0,0 +1,19 @@
+export interface MdnsService {
+    serviceName: string;
+    host: string;
+    port: number;
+}
+export interface ParsedMdns {
+    pairing: MdnsService[];
+    connect: MdnsService[];
+    daemonAvailable: boolean;
+}
+export declare function parseMdnsServices(stdout: string): ParsedMdns;
+type RunAdbFn = (args: string[]) => Promise<{
+    stdout: string;
+    stderr: string;
+}>;
+export declare function __setRunAdbForTest(fn: RunAdbFn | null): void;
+export declare function discoverPairingPort(serviceName: string, timeoutMs: number, pollIntervalMs?: number): Promise<MdnsService>;
+export declare function discoverConnectByHost(host: string, timeoutMs: number, pollIntervalMs?: number): Promise<MdnsService>;
+export {};

package/dist/mdns.js

@@ -0,0 +1,68 @@
+const PAIRING_TYPE = "_adb-tls-pairing._tcp.";
+const CONNECT_TYPE = "_adb-tls-connect._tcp.";
+export function parseMdnsServices(stdout) {
+    const lines = stdout.split(/\r?\n/);
+    for (const line of lines) {
+        if (line.trim().startsWith("ERROR")) {
+            return { pairing: [], connect: [], daemonAvailable: false };
+        }
+    }
+    const pairing = [];
+    const connect = [];
+    for (const line of lines) {
+        if (!line.trim() || line.startsWith("List of discovered"))
+            continue;
+        const parts = line.split(/\t+/).map((s) => s.trim()).filter(Boolean);
+        if (parts.length !== 3)
+            continue;
+        const [serviceName, type, hostPort] = parts;
+        const m = /^([0-9.]+):(\d+)$/.exec(hostPort);
+        if (!m)
+            continue;
+        const entry = { serviceName, host: m[1], port: parseInt(m[2], 10) };
+        if (type === PAIRING_TYPE)
+            pairing.push(entry);
+        else if (type === CONNECT_TYPE)
+            connect.push(entry);
+    }
+    return { pairing, connect, daemonAvailable: true };
+}
+import { runAdb } from "./adb.js";
+import { FlingError } from "./errors.js";
+let runAdbImpl = runAdb;
+export function __setRunAdbForTest(fn) {
+    runAdbImpl = fn ?? runAdb;
+}
+async function pollMdns() {
+    const { stdout } = await runAdbImpl(["mdns", "services"]);
+    return parseMdnsServices(stdout);
+}
+export async function discoverPairingPort(serviceName, timeoutMs, pollIntervalMs = 500) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        const r = await pollMdns();
+        if (!r.daemonAvailable) {
+            throw new FlingError("MDNS_UNAVAILABLE", "adb mdns daemon is not available.");
+        }
+        const match = r.pairing.find((s) => s.serviceName === serviceName);
+        if (match)
+            return match;
+        await new Promise((res) => setTimeout(res, pollIntervalMs));
+    }
+    throw new FlingError("PAIRING_TIMEOUT", `No mDNS pairing service '${serviceName}' within ${timeoutMs}ms.`);
+}
+export async function discoverConnectByHost(host, timeoutMs, pollIntervalMs = 500) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        const r = await pollMdns();
+        if (!r.daemonAvailable) {
+            throw new FlingError("MDNS_UNAVAILABLE", "adb mdns daemon is not available.");
+        }
+        const match = r.connect.find((s) => s.host === host);
+        if (match)
+            return match;
+        await new Promise((res) => setTimeout(res, pollIntervalMs));
+    }
+    throw new FlingError("PAIRING_TIMEOUT", `No mDNS connect service on host '${host}' within ${timeoutMs}ms.`);
+}
+//# sourceMappingURL=mdns.js.map

package/dist/mdns.js.map

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

package/dist/pairing.d.ts

@@ -0,0 +1,52 @@
+import { discoverPairingPort as realDiscoverPairing, discoverConnectByHost as realDiscoverConnect } from "./mdns.js";
+export { discoverConnectByHost } from "./mdns.js";
+export type PairStatus = {
+    kind: "waiting";
+} | {
+    kind: "pairing";
+} | {
+    kind: "connecting";
+} | {
+    kind: "success";
+    serial: string;
+    model: string;
+} | {
+    kind: "error";
+    reason: string;
+    rawAdbError?: string;
+} | {
+    kind: "timeout";
+};
+export interface StartPairQrOptions {
+    onStatus?: (s: PairStatus) => void;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}
+export interface StartPairQrResult {
+    qrText: string;
+    serviceName: string;
+    done: Promise<PairStatus>;
+}
+export interface PairWithCodeOptions {
+    host: string;
+    port: number;
+    code: string;
+    onStatus?: (s: PairStatus) => void;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}
+type RunAdbFn = (args: string[], opts?: {
+    stdin?: string;
+    timeoutMs?: number;
+}) => Promise<{
+    stdout: string;
+    stderr: string;
+}>;
+export declare function __setRunAdbForTest(fn: RunAdbFn | null): void;
+interface Discover {
+    discoverPairingPort: typeof realDiscoverPairing;
+    discoverConnectByHost: typeof realDiscoverConnect;
+}
+export declare function __setDiscoverForTest(d: Discover | null): void;
+export declare function startPairQr(opts?: StartPairQrOptions): StartPairQrResult;
+export declare function pairWithCode(opts: PairWithCodeOptions): Promise<PairStatus>;