@0xhayd3n/fling 0.6.0

package/dist/adb.d.ts

@@ -0,0 +1,18 @@
+export interface RunAdbOptions {
+    timeoutMs?: number;
+    maxBufferBytes?: number;
+}
+export interface AdbResult {
+    stdout: string;
+    stderr: string;
+}
+export interface AdbBinaryResult {
+    stdout: Buffer;
+    stderr: string;
+}
+export declare function runAdb(args: string[], options?: RunAdbOptions): Promise<AdbResult>;
+/**
+ * Run adb and capture stdout as raw bytes (for screencap, file pulls, etc.).
+ * Uses spawn so the byte stream is never coerced through a text encoding.
+ */
+export declare function runAdbBinary(args: string[], options?: RunAdbOptions): Promise<AdbBinaryResult>;

package/dist/adb.js

@@ -0,0 +1,109 @@
+import { execFile, spawn } from "node:child_process";
+import { promisify } from "node:util";
+import { FlingError } from "./errors.js";
+const execFileAsync = promisify(execFile);
+const DEFAULT_TIMEOUT_MS = 15_000;
+const DEFAULT_MAX_BUFFER = 10 * 1024 * 1024;
+const ADB_INSTALL_HINT = "adb (Android Platform Tools) is required but was not found on PATH. " +
+    "Install it via `winget install Google.PlatformTools` (Windows), " +
+    "`brew install --cask android-platform-tools` (macOS), " +
+    "or your distro's package manager (Linux), then restart this MCP server.";
+export async function runAdb(args, options = {}) {
+    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const maxBuffer = options.maxBufferBytes ?? DEFAULT_MAX_BUFFER;
+    try {
+        const { stdout, stderr } = await execFileAsync("adb", args, {
+            timeout: timeoutMs,
+            maxBuffer,
+            windowsHide: true,
+        });
+        return { stdout, stderr };
+    }
+    catch (err) {
+        const e = err;
+        if (e.code === "ENOENT") {
+            throw new FlingError("ADB_NOT_FOUND", ADB_INSTALL_HINT);
+        }
+        if (e.killed) {
+            throw new FlingError("ADB_TIMEOUT", `adb ${args.join(" ")} timed out after ${timeoutMs}ms`, { stdout: e.stdout, stderr: e.stderr });
+        }
+        const exitCode = typeof e.code === "number" ? e.code : undefined;
+        throw new FlingError("ADB_FAILED", `adb ${args.join(" ")} failed${exitCode !== undefined ? ` (exit ${exitCode})` : ""}: ${(e.stderr || e.message || "unknown error").trim()}`, { stdout: e.stdout, stderr: e.stderr, exitCode });
+    }
+}
+/**
+ * Run adb and capture stdout as raw bytes (for screencap, file pulls, etc.).
+ * Uses spawn so the byte stream is never coerced through a text encoding.
+ */
+export async function runAdbBinary(args, options = {}) {
+    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const maxBuffer = options.maxBufferBytes ?? DEFAULT_MAX_BUFFER;
+    return new Promise((resolve, reject) => {
+        const child = spawn("adb", args, { windowsHide: true });
+        const stdoutChunks = [];
+        let stdoutBytes = 0;
+        let stderrText = "";
+        let timedOut = false;
+        let overBuffer = false;
+        // ENOENT fires both 'error' and 'close' on Node; without this guard we'd
+        // try to reject twice. The second reject is a no-op on the Promise but
+        // still constructs a stray FlingError that some monitors flag.
+        let settled = false;
+        const safeResolve = (v) => {
+            if (settled)
+                return;
+            settled = true;
+            resolve(v);
+        };
+        const safeReject = (e) => {
+            if (settled)
+                return;
+            settled = true;
+            reject(e);
+        };
+        const timer = setTimeout(() => {
+            timedOut = true;
+            child.kill();
+        }, timeoutMs);
+        child.stdout.on("data", (chunk) => {
+            stdoutBytes += chunk.length;
+            if (stdoutBytes > maxBuffer) {
+                overBuffer = true;
+                child.kill();
+                return;
+            }
+            stdoutChunks.push(chunk);
+        });
+        child.stderr.setEncoding("utf8");
+        child.stderr.on("data", (chunk) => {
+            stderrText += chunk;
+        });
+        child.on("error", (err) => {
+            clearTimeout(timer);
+            const e = err;
+            if (e.code === "ENOENT") {
+                safeReject(new FlingError("ADB_NOT_FOUND", ADB_INSTALL_HINT));
+            }
+            else {
+                safeReject(new FlingError("ADB_FAILED", `adb ${args.join(" ")} failed: ${err.message}`));
+            }
+        });
+        child.on("close", (code) => {
+            clearTimeout(timer);
+            if (timedOut) {
+                safeReject(new FlingError("ADB_TIMEOUT", `adb ${args.join(" ")} timed out after ${timeoutMs}ms`, { stderr: stderrText }));
+                return;
+            }
+            if (overBuffer) {
+                safeReject(new FlingError("ADB_FAILED", `adb ${args.join(" ")} exceeded the binary buffer cap of ${maxBuffer} bytes.`));
+                return;
+            }
+            if (code !== 0) {
+                safeReject(new FlingError("ADB_FAILED", `adb ${args.join(" ")} failed (exit ${code}): ${stderrText.trim() || "unknown error"}`, { stderr: stderrText, exitCode: code ?? undefined }));
+                return;
+            }
+            safeResolve({ stdout: Buffer.concat(stdoutChunks), stderr: stderrText });
+        });
+    });
+}
+//# sourceMappingURL=adb.js.map

package/dist/adb.js.map

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

package/dist/apkFinder.d.ts

@@ -0,0 +1,19 @@
+export declare const DEFAULT_APK_GLOB = "**/outputs/apk/**/*.apk";
+/**
+ * Convert a glob to a regex. Supports:
+ *   `**` — any number of path segments (including zero, allowing top-level matches)
+ *   `*`  — any chars except `/`
+ *   `?`  — any single char except `/`
+ * All other regex metacharacters are escaped.
+ */
+export declare function globToRegex(pattern: string): RegExp;
+export declare function findFiles(rootDir: string, pattern: string): Promise<string[]>;
+export interface FoundApk {
+    path: string;
+    mtimeMs: number;
+}
+/**
+ * Find the newest file matching the pattern under rootDir.
+ * Returns null when no match exists.
+ */
+export declare function findNewestApk(rootDir: string, pattern?: string): Promise<FoundApk | null>;

package/dist/apkFinder.js

@@ -0,0 +1,113 @@
+import { readdir, stat } from "node:fs/promises";
+import { join } from "node:path";
+const SKIP_DIRS = new Set([
+    ".git",
+    ".gradle",
+    ".idea",
+    ".vscode",
+    "node_modules",
+]);
+export const DEFAULT_APK_GLOB = "**/outputs/apk/**/*.apk";
+/**
+ * Convert a glob to a regex. Supports:
+ *   `**` — any number of path segments (including zero, allowing top-level matches)
+ *   `*`  — any chars except `/`
+ *   `?`  — any single char except `/`
+ * All other regex metacharacters are escaped.
+ */
+export function globToRegex(pattern) {
+    let re = "";
+    let i = 0;
+    while (i < pattern.length) {
+        const c = pattern[i];
+        if (c === "*" && pattern[i + 1] === "*") {
+            // `**` semantics depend on what follows:
+            //   - At end of pattern: match anything (including no slash) → `.*`
+            //   - Followed by `/`: zero-or-more path segments → `(.*/)?`,
+            //     so `**/*.apk` matches both `app.apk` and `nested/app.apk`.
+            //   - Followed by non-slash text: literal "any chars" → `.*`
+            i += 2;
+            if (i >= pattern.length) {
+                re += ".*";
+            }
+            else if (pattern[i] === "/") {
+                re += "(.*/)?";
+                i++;
+            }
+            else {
+                re += ".*";
+            }
+            continue;
+        }
+        else if (c === "*") {
+            re += "[^/]*";
+            i++;
+        }
+        else if (c === "?") {
+            re += "[^/]";
+            i++;
+        }
+        else if (/[.+^$|(){}[\]\\]/.test(c)) {
+            re += "\\" + c;
+            i++;
+        }
+        else {
+            re += c;
+            i++;
+        }
+    }
+    return new RegExp(`^${re}$`);
+}
+export async function findFiles(rootDir, pattern) {
+    const regex = globToRegex(pattern);
+    const found = [];
+    async function walk(dir, relPath) {
+        let entries;
+        try {
+            entries = await readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const absChild = join(dir, entry.name);
+            const relChild = relPath ? `${relPath}/${entry.name}` : entry.name;
+            if (entry.isDirectory()) {
+                if (SKIP_DIRS.has(entry.name))
+                    continue;
+                await walk(absChild, relChild);
+            }
+            else if (entry.isFile()) {
+                if (regex.test(relChild)) {
+                    found.push(absChild);
+                }
+            }
+        }
+    }
+    await walk(rootDir, "");
+    return found;
+}
+/**
+ * Find the newest file matching the pattern under rootDir.
+ * Returns null when no match exists.
+ */
+export async function findNewestApk(rootDir, pattern = DEFAULT_APK_GLOB) {
+    const matches = await findFiles(rootDir, pattern);
+    if (matches.length === 0)
+        return null;
+    const withMtime = await Promise.all(matches.map(async (p) => {
+        try {
+            const s = await stat(p);
+            return { path: p, mtimeMs: s.mtimeMs };
+        }
+        catch {
+            return null;
+        }
+    }));
+    const valid = withMtime.filter((x) => x !== null);
+    if (valid.length === 0)
+        return null;
+    valid.sort((a, b) => b.mtimeMs - a.mtimeMs);
+    return valid[0];
+}
+//# sourceMappingURL=apkFinder.js.map

package/dist/apkFinder.js.map

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

package/dist/apkResolver.d.ts

@@ -0,0 +1,14 @@
+import type { FlingConfig } from "./config.js";
+export interface ResolvedApk {
+    path: string;
+    source: "explicit" | "config-path" | "config-glob" | "auto-discover";
+}
+/**
+ * Resolve which APK to install. Priority:
+ *   1. Explicit `explicitPath` argument (from the tool call)
+ *   2. config.apkPath
+ *   3. Glob search using config.apkGlob (or default) under buildCwd
+ *
+ * Throws FlingError("APK_NOT_FOUND") with the actual locations tried.
+ */
+export declare function resolveApk(explicitPath: string | undefined, config: FlingConfig, buildCwd: string): Promise<ResolvedApk>;

package/dist/apkResolver.js

@@ -0,0 +1,55 @@
+import { stat } from "node:fs/promises";
+import { isAbsolute, resolve as resolvePath } from "node:path";
+import { DEFAULT_APK_GLOB, findNewestApk } from "./apkFinder.js";
+import { FlingError } from "./errors.js";
+async function fileExists(path) {
+    try {
+        return (await stat(path)).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Resolve which APK to install. Priority:
+ *   1. Explicit `explicitPath` argument (from the tool call)
+ *   2. config.apkPath
+ *   3. Glob search using config.apkGlob (or default) under buildCwd
+ *
+ * Throws FlingError("APK_NOT_FOUND") with the actual locations tried.
+ */
+export async function resolveApk(explicitPath, config, buildCwd) {
+    if (explicitPath) {
+        // Relative paths resolve against buildCwd, matching how config.apkPath
+        // resolves. The previous behavior used process.cwd() which surprised
+        // users who passed relative paths from inside a project directory.
+        const abs = isAbsolute(explicitPath)
+            ? explicitPath
+            : resolvePath(buildCwd, explicitPath);
+        if (!(await fileExists(abs))) {
+            throw new FlingError("APK_NOT_FOUND", `APK not found at ${abs}.`);
+        }
+        return { path: abs, source: "explicit" };
+    }
+    if (config.apkPath) {
+        const abs = isAbsolute(config.apkPath)
+            ? config.apkPath
+            : resolvePath(buildCwd, config.apkPath);
+        if (!(await fileExists(abs))) {
+            throw new FlingError("APK_NOT_FOUND", `config.apkPath points to ${abs} but no file is there. ` +
+                "Build first, or update the apkPath in your fling.config.json.");
+        }
+        return { path: abs, source: "config-path" };
+    }
+    const pattern = config.apkGlob ?? DEFAULT_APK_GLOB;
+    const found = await findNewestApk(buildCwd, pattern);
+    if (!found) {
+        throw new FlingError("APK_NOT_FOUND", `No APK matched ${pattern} under ${buildCwd}. ` +
+            "Build the project first, or set apkPath in fling.config.json.");
+    }
+    return {
+        path: found.path,
+        source: config.apkGlob ? "config-glob" : "auto-discover",
+    };
+}
+//# sourceMappingURL=apkResolver.js.map

package/dist/apkResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apkResolver.js","sourceRoot":"","sources":["../src/apkResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AAE/D,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAOzC,KAAK,UAAU,UAAU,CAAC,IAAY;IACpC,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,YAAgC,EAChC,MAAmB,EACnB,QAAgB;IAEhB,IAAI,YAAY,EAAE,CAAC;QACjB,uEAAuE;QACvE,qEAAqE;QACrE,mEAAmE;QACnE,MAAM,GAAG,GAAG,UAAU,CAAC,YAAY,CAAC;YAClC,CAAC,CAAC,YAAY;YACd,CAAC,CAAC,WAAW,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QACxC,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,UAAU,CAClB,eAAe,EACf,oBAAoB,GAAG,GAAG,CAC3B,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAC3C,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC;YACpC,CAAC,CAAC,MAAM,CAAC,OAAO;YAChB,CAAC,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,UAAU,CAClB,eAAe,EACf,4BAA4B,GAAG,yBAAyB;gBACtD,+DAA+D,CAClE,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IAC9C,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,gBAAgB,CAAC;IACnD,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACrD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,UAAU,CAClB,eAAe,EACf,kBAAkB,OAAO,UAAU,QAAQ,IAAI;YAC7C,+DAA+D,CAClE,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,eAAe;KACzD,CAAC;AACJ,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,44 @@
+import { z } from "zod";
+export declare const flingConfigSchema: z.ZodObject<{
+    buildCommand: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    gradleTask: z.ZodOptional<z.ZodString>;
+    buildCwd: z.ZodOptional<z.ZodString>;
+    apkPath: z.ZodOptional<z.ZodString>;
+    apkGlob: z.ZodOptional<z.ZodString>;
+    packageName: z.ZodOptional<z.ZodString>;
+    mainActivity: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    buildCommand?: string | string[] | undefined;
+    gradleTask?: string | undefined;
+    buildCwd?: string | undefined;
+    apkPath?: string | undefined;
+    apkGlob?: string | undefined;
+    packageName?: string | undefined;
+    mainActivity?: string | undefined;
+}, {
+    buildCommand?: string | string[] | undefined;
+    gradleTask?: string | undefined;
+    buildCwd?: string | undefined;
+    apkPath?: string | undefined;
+    apkGlob?: string | undefined;
+    packageName?: string | undefined;
+    mainActivity?: string | undefined;
+}>;
+export type FlingConfig = z.infer<typeof flingConfigSchema>;
+export interface LoadedConfig {
+    config: FlingConfig;
+    configPath: string | null;
+    projectRoot: string;
+}
+/**
+ * Walk up from `startDir` looking for fling.config.json or a "fling" key in
+ * package.json. The first hit wins. Returns the loaded (possibly empty) config
+ * and the project root (the directory of the config file, or `startDir` if
+ * none was found).
+ */
+export declare function loadFlingConfig(startDir: string): Promise<LoadedConfig>;
+/**
+ * Resolve the build working directory: explicit config.buildCwd (relative to
+ * the config file's directory) or the project root if not set.
+ */
+export declare function resolveBuildCwd(loaded: LoadedConfig): string;

package/dist/config.js

@@ -0,0 +1,113 @@
+import { readFile } from "node:fs/promises";
+import { dirname, isAbsolute, resolve as resolvePath } from "node:path";
+import { z } from "zod";
+import { FlingError } from "./errors.js";
+export const flingConfigSchema = z.object({
+    buildCommand: z
+        .union([z.string(), z.array(z.string())])
+        .optional()
+        .describe("Override for the build command. String form is split on whitespace. " +
+        "If omitted, the gradle wrapper at projectRoot/gradlew[.bat] is run with gradleTask."),
+    gradleTask: z
+        .string()
+        .optional()
+        .describe('Gradle task to run when buildCommand is not set. Default "assembleDebug".'),
+    buildCwd: z
+        .string()
+        .optional()
+        .describe("Directory to run the build from. Relative paths resolve against the config file's directory. Defaults to the config directory."),
+    apkPath: z
+        .string()
+        .optional()
+        .describe("Explicit path to the APK to install. Resolved relative to buildCwd. Takes precedence over apkGlob."),
+    apkGlob: z
+        .string()
+        .optional()
+        .describe('Glob (relative to buildCwd) for locating the build output. Default "**/outputs/apk/**/*.apk". Newest match by mtime wins.'),
+    packageName: z
+        .string()
+        .optional()
+        .describe("Default Android package for launch_app and install_app."),
+    mainActivity: z
+        .string()
+        .optional()
+        .describe("Optional default activity for launch_app. Use a leading dot for a package-relative class (e.g. .MainActivity)."),
+});
+const CONFIG_FILENAMES = ["fling.config.json"];
+const PACKAGE_JSON = "package.json";
+async function tryReadJson(path) {
+    try {
+        const content = await readFile(path, "utf8");
+        return JSON.parse(content);
+    }
+    catch (err) {
+        const e = err;
+        if (e.code === "ENOENT")
+            return null;
+        if (e instanceof SyntaxError) {
+            throw new FlingError("INVALID_INPUT", `Failed to parse ${path}: ${e.message}`);
+        }
+        throw err;
+    }
+}
+function validateConfig(raw, source) {
+    const parsed = flingConfigSchema.safeParse(raw);
+    if (!parsed.success) {
+        const issues = parsed.error.issues
+            .map((i) => `${i.path.join(".") || "(root)"}: ${i.message}`)
+            .join("; ");
+        throw new FlingError("INVALID_INPUT", `Invalid Fling config at ${source}: ${issues}`);
+    }
+    return parsed.data;
+}
+/**
+ * Walk up from `startDir` looking for fling.config.json or a "fling" key in
+ * package.json. The first hit wins. Returns the loaded (possibly empty) config
+ * and the project root (the directory of the config file, or `startDir` if
+ * none was found).
+ */
+export async function loadFlingConfig(startDir) {
+    let dir = resolvePath(startDir);
+    const seen = new Set();
+    while (!seen.has(dir)) {
+        seen.add(dir);
+        for (const name of CONFIG_FILENAMES) {
+            const candidate = resolvePath(dir, name);
+            const raw = await tryReadJson(candidate);
+            if (raw !== null) {
+                return {
+                    config: validateConfig(raw, candidate),
+                    configPath: candidate,
+                    projectRoot: dir,
+                };
+            }
+        }
+        const pkgPath = resolvePath(dir, PACKAGE_JSON);
+        const pkgRaw = await tryReadJson(pkgPath);
+        if (pkgRaw && typeof pkgRaw === "object" && "fling" in pkgRaw) {
+            return {
+                config: validateConfig(pkgRaw.fling, pkgPath),
+                configPath: pkgPath,
+                projectRoot: dir,
+            };
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return { config: {}, configPath: null, projectRoot: resolvePath(startDir) };
+}
+/**
+ * Resolve the build working directory: explicit config.buildCwd (relative to
+ * the config file's directory) or the project root if not set.
+ */
+export function resolveBuildCwd(loaded) {
+    const { config, projectRoot } = loaded;
+    if (!config.buildCwd)
+        return projectRoot;
+    if (isAbsolute(config.buildCwd))
+        return config.buildCwd;
+    return resolvePath(projectRoot, config.buildCwd);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AACxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,YAAY,EAAE,CAAC;SACZ,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;SACxC,QAAQ,EAAE;SACV,QAAQ,CACP,sEAAsE;QACpE,qFAAqF,CACxF;IACH,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,2EAA2E,CAAC;IACxF,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,gIAAgI,CACjI;IACH,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,oGAAoG,CACrG;IACH,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,2HAA2H,CAC5H;IACH,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,yDAAyD,CAAC;IACtE,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,gHAAgH,CACjH;CACJ,CAAC,CAAC;AAUH,MAAM,gBAAgB,GAAG,CAAC,mBAAmB,CAAC,CAAC;AAC/C,MAAM,YAAY,GAAG,cAAc,CAAC;AAEpC,KAAK,UAAU,WAAW,CAAC,IAAY;IACrC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,GAAG,GAA4B,CAAC;QACvC,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACrC,IAAI,CAAC,YAAY,WAAW,EAAE,CAAC;YAC7B,MAAM,IAAI,UAAU,CAClB,eAAe,EACf,mBAAmB,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CACxC,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,GAAY,EAAE,MAAc;IAClD,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM;aAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;aAC3D,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,UAAU,CAClB,eAAe,EACf,2BAA2B,MAAM,KAAK,MAAM,EAAE,CAC/C,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAgB;IACpD,IAAI,GAAG,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEd,KAAK,MAAM,IAAI,IAAI,gBAAgB,EAAE,CAAC;YACpC,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACzC,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,SAAS,CAAC,CAAC;YACzC,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;gBACjB,OAAO;oBACL,MAAM,EAAE,cAAc,CAAC,GAAG,EAAE,SAAS,CAAC;oBACtC,UAAU,EAAE,SAAS;oBACrB,WAAW,EAAE,GAAG;iBACjB,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;YAC9D,OAAO;gBACL,MAAM,EAAE,cAAc,CAAE,MAA6B,CAAC,KAAK,EAAE,OAAO,CAAC;gBACrE,UAAU,EAAE,OAAO;gBACnB,WAAW,EAAE,GAAG;aACjB,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;AAC9E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAAoB;IAClD,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,QAAQ;QAAE,OAAO,WAAW,CAAC;IACzC,IAAI,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC;IACxD,OAAO,WAAW,CAAC,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;AACnD,CAAC"}

package/dist/devices.d.ts

@@ -0,0 +1,24 @@
+export type DeviceState = "device" | "unauthorized" | "offline" | "no permissions" | "recovery" | "sideload" | "bootloader" | "unknown";
+export interface Device {
+    serial: string;
+    state: DeviceState;
+    product?: string;
+    model?: string;
+    device?: string;
+    transportId?: string;
+    usb?: string;
+    raw: string;
+}
+export declare function parseDevicesOutput(stdout: string): Device[];
+export declare function listDevices(): Promise<Device[]>;
+export declare function formatDevicesSummary(devices: Device[]): string;
+/**
+ * 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 declare function resolveDeviceArgs(deviceId?: string): Promise<{
+    args: string[];
+    serial: string;
+}>;