@0xhayd3n/fling 0.6.0

package/dist/pairing.js

@@ -0,0 +1,212 @@
+import { randomBytes } from "node:crypto";
+import { runAdb } from "./adb.js";
+import { FlingError } from "./errors.js";
+import { buildQrText } from "./qrText.js";
+import { discoverPairingPort as realDiscoverPairing, discoverConnectByHost as realDiscoverConnect, } from "./mdns.js";
+export { discoverConnectByHost } from "./mdns.js";
+let runAdbImpl = (args) => runAdb(args);
+export function __setRunAdbForTest(fn) {
+    runAdbImpl = fn ?? ((args) => runAdb(args));
+}
+let discoverImpl = {
+    discoverPairingPort: realDiscoverPairing,
+    discoverConnectByHost: realDiscoverConnect,
+};
+export function __setDiscoverForTest(d) {
+    discoverImpl = d ?? {
+        discoverPairingPort: realDiscoverPairing,
+        discoverConnectByHost: realDiscoverConnect,
+    };
+}
+const DEFAULT_TIMEOUT_MS = 60_000;
+function genServiceName() {
+    return `fling-debug-${randomBytes(2).toString("hex")}`;
+}
+function genPassword() {
+    return randomBytes(12).toString("base64").replace(/[=+/]/g, "");
+}
+function emit(cb, s) {
+    if (cb) {
+        try {
+            cb(s);
+        }
+        catch {
+            // Listener errors must not break the state machine.
+        }
+    }
+}
+async function parseDevicesForSerial(serial) {
+    const { stdout } = await runAdbImpl(["devices", "-l"]);
+    const lines = stdout.split(/\r?\n/);
+    for (const line of lines) {
+        if (!line.includes(serial))
+            continue;
+        const parts = line.trim().split(/\s+/);
+        if (parts.length < 2)
+            continue;
+        if (parts[1] !== "device")
+            continue;
+        const modelMatch = parts.find((p) => p.startsWith("model:"));
+        return { serial: parts[0], model: modelMatch ? modelMatch.slice("model:".length) : "Unknown" };
+    }
+    return null;
+}
+async function waitForDeviceReady(serial, timeoutMs) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        const d = await parseDevicesForSerial(serial);
+        if (d)
+            return d;
+        await new Promise((res) => setTimeout(res, 300));
+    }
+    throw new FlingError("ADB_CONNECT_FAILED", `Device ${serial} did not become ready within ${timeoutMs}ms.`);
+}
+/**
+ * Build an abort-aware race promise that rejects with "Cancelled." when the
+ * signal fires. Returns a no-op promise (never resolves/rejects) when no
+ * signal is provided, making Promise.race safe to call unconditionally.
+ */
+function abortPromise(signal) {
+    return new Promise((_, reject) => {
+        if (!signal)
+            return; // never resolves
+        if (signal.aborted) {
+            reject(new Error("Cancelled."));
+            return;
+        }
+        signal.addEventListener("abort", () => reject(new Error("Cancelled.")), { once: true });
+    });
+}
+export function startPairQr(opts = {}) {
+    const serviceName = genServiceName();
+    const password = genPassword();
+    const qrText = buildQrText({ serviceName, password });
+    const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const done = (async () => {
+        if (opts.signal?.aborted) {
+            const s = { kind: "error", reason: "Cancelled before start." };
+            emit(opts.onStatus, s);
+            return s;
+        }
+        emit(opts.onStatus, { kind: "waiting" });
+        const abort = abortPromise(opts.signal);
+        let pairingHost;
+        let pairingPort;
+        try {
+            const r = await Promise.race([
+                discoverImpl.discoverPairingPort(serviceName, timeoutMs),
+                abort,
+            ]);
+            pairingHost = r.host;
+            pairingPort = r.port;
+        }
+        catch (err) {
+            const code = err.code;
+            if (opts.signal?.aborted) {
+                const s = { kind: "error", reason: "Cancelled." };
+                emit(opts.onStatus, s);
+                return s;
+            }
+            if (code === "PAIRING_TIMEOUT") {
+                const s = { kind: "timeout" };
+                emit(opts.onStatus, s);
+                return s;
+            }
+            const s = { kind: "error", reason: err.message };
+            emit(opts.onStatus, s);
+            return s;
+        }
+        emit(opts.onStatus, { kind: "pairing" });
+        try {
+            await runAdbImpl(["pair", `${pairingHost}:${pairingPort}`, password]);
+        }
+        catch (err) {
+            const e = err;
+            const s = {
+                kind: "error",
+                reason: (e.stderr && e.stderr.trim()) || e.message || "adb pair failed",
+                rawAdbError: e.stderr,
+            };
+            emit(opts.onStatus, s);
+            return s;
+        }
+        emit(opts.onStatus, { kind: "connecting" });
+        let connectInfo;
+        try {
+            // After pair, the phone advertises _adb-tls-connect on a fresh port.
+            // We don't know the device's serial yet (we get it from `adb devices`
+            // post-connect), so match by host — connect service is on the same
+            // host as pairing.
+            const r = await Promise.race([
+                discoverImpl.discoverConnectByHost(pairingHost, 10_000),
+                abort,
+            ]);
+            connectInfo = r;
+        }
+        catch (err) {
+            const e = err;
+            const s = {
+                kind: "error",
+                reason: (e.message ?? "Couldn't find connect service after pairing"),
+                rawAdbError: e.stderr,
+            };
+            emit(opts.onStatus, s);
+            return s;
+        }
+        try {
+            await runAdbImpl(["connect", `${connectInfo.host}:${connectInfo.port}`]);
+            const dev = await waitForDeviceReady(`${connectInfo.host}:${connectInfo.port}`, 5_000);
+            const s = { kind: "success", serial: dev.serial, model: dev.model };
+            emit(opts.onStatus, s);
+            return s;
+        }
+        catch (err) {
+            const e = err;
+            const s = {
+                kind: "error",
+                reason: (e.stderr && e.stderr.trim()) || e.message || "adb connect failed",
+                rawAdbError: e.stderr,
+            };
+            emit(opts.onStatus, s);
+            return s;
+        }
+    })();
+    return { qrText, serviceName, done };
+}
+export async function pairWithCode(opts) {
+    const timeoutMs = opts.timeoutMs ?? 30_000;
+    emit(opts.onStatus, { kind: "pairing" });
+    try {
+        await runAdbImpl(["pair", `${opts.host}:${opts.port}`, opts.code]);
+    }
+    catch (err) {
+        const e = err;
+        const s = {
+            kind: "error",
+            reason: (e.stderr && e.stderr.trim()) || e.message || "adb pair failed",
+            rawAdbError: e.stderr,
+        };
+        emit(opts.onStatus, s);
+        return s;
+    }
+    emit(opts.onStatus, { kind: "connecting" });
+    try {
+        const r = await discoverImpl.discoverConnectByHost(opts.host, timeoutMs);
+        await runAdbImpl(["connect", `${r.host}:${r.port}`]);
+        const dev = await waitForDeviceReady(`${r.host}:${r.port}`, 5_000);
+        const s = { kind: "success", serial: dev.serial, model: dev.model };
+        emit(opts.onStatus, s);
+        return s;
+    }
+    catch (err) {
+        const e = err;
+        const s = {
+            kind: "error",
+            reason: (e.stderr && e.stderr.trim()) || e.message || "adb connect failed",
+            rawAdbError: e.stderr,
+        };
+        emit(opts.onStatus, s);
+        return s;
+    }
+}
+//# sourceMappingURL=pairing.js.map

package/dist/pairing.js.map

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

package/dist/qrText.d.ts

@@ -0,0 +1,5 @@
+export interface BuildQrTextOptions {
+    serviceName: string;
+    password: string;
+}
+export declare function buildQrText(opts: BuildQrTextOptions): string;

package/dist/qrText.js

@@ -0,0 +1,8 @@
+export function buildQrText(opts) {
+    if (!opts.serviceName)
+        throw new Error("serviceName must be non-empty");
+    if (!opts.password)
+        throw new Error("password must be non-empty");
+    return `WIFI:T:ADB;S:${opts.serviceName};P:${opts.password};;`;
+}
+//# sourceMappingURL=qrText.js.map

package/dist/qrText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qrText.js","sourceRoot":"","sources":["../src/qrText.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,WAAW,CAAC,IAAwB;IAClD,IAAI,CAAC,IAAI,CAAC,WAAW;QAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACxE,IAAI,CAAC,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAClE,OAAO,gBAAgB,IAAI,CAAC,WAAW,MAAM,IAAI,CAAC,QAAQ,IAAI,CAAC;AACjE,CAAC"}

package/dist/schemas.d.ts

@@ -0,0 +1,31 @@
+import { z } from "zod";
+export declare const deviceStateSchema: z.ZodEnum<["device", "unauthorized", "offline", "no permissions", "recovery", "sideload", "bootloader", "unknown"]>;
+export declare const deviceShape: z.ZodObject<{
+    serial: z.ZodString;
+    state: z.ZodEnum<["device", "unauthorized", "offline", "no permissions", "recovery", "sideload", "bootloader", "unknown"]>;
+    product: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    device: z.ZodOptional<z.ZodString>;
+    transportId: z.ZodOptional<z.ZodString>;
+    usb: z.ZodOptional<z.ZodString>;
+    raw: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    serial: string;
+    state: "unknown" | "device" | "unauthorized" | "offline" | "no permissions" | "recovery" | "sideload" | "bootloader";
+    raw: string;
+    device?: string | undefined;
+    product?: string | undefined;
+    model?: string | undefined;
+    usb?: string | undefined;
+    transportId?: string | undefined;
+}, {
+    serial: string;
+    state: "unknown" | "device" | "unauthorized" | "offline" | "no permissions" | "recovery" | "sideload" | "bootloader";
+    raw: string;
+    device?: string | undefined;
+    product?: string | undefined;
+    model?: string | undefined;
+    usb?: string | undefined;
+    transportId?: string | undefined;
+}>;
+export declare const deviceIdInput: z.ZodOptional<z.ZodString>;

package/dist/schemas.js

@@ -0,0 +1,26 @@
+import { z } from "zod";
+export const deviceStateSchema = z.enum([
+    "device",
+    "unauthorized",
+    "offline",
+    "no permissions",
+    "recovery",
+    "sideload",
+    "bootloader",
+    "unknown",
+]);
+export const deviceShape = z.object({
+    serial: z.string(),
+    state: deviceStateSchema,
+    product: z.string().optional(),
+    model: z.string().optional(),
+    device: z.string().optional(),
+    transportId: z.string().optional(),
+    usb: z.string().optional(),
+    raw: z.string(),
+});
+export const deviceIdInput = z
+    .string()
+    .optional()
+    .describe("Target device serial. Omit when exactly one device is connected; required when multiple are.");
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC;IACtC,QAAQ;IACR,cAAc;IACd,SAAS;IACT,gBAAgB;IAChB,UAAU;IACV,UAAU;IACV,YAAY;IACZ,SAAS;CACV,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,KAAK,EAAE,iBAAiB;IACxB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;CAChB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,MAAM,EAAE;KACR,QAAQ,EAAE;KACV,QAAQ,CACP,8FAA8F,CAC/F,CAAC"}

package/dist/shellFraming.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Per-shell random token used to namespace sentinel lines. 8 hex chars =
+ * 2^32 possibilities — far below a credible accidental collision with
+ * legitimate command output.
+ */
+export declare function newToken(): string;
+/**
+ * Append a printf sentinel to the user's command. The sentinel encodes the
+ * per-shell token and a per-call sequence number, plus the command's exit
+ * code via $?. Reader strips the marker line and exposes everything before
+ * it as stdout.
+ *
+ * Uses printf rather than echo for consistent newline handling across
+ * Android's toybox sh.
+ */
+export declare function buildFramedCommand(cmd: string, token: string, seq: number): string;
+export interface FrameMatch {
+    matched: boolean;
+    exitCode?: number;
+}
+/**
+ * Pre-compile a per-shell matcher. The token is baked into a regex so we
+ * don't recompile per line. matchLine is invoked once per CR/LF-delimited
+ * stdout line.
+ */
+export declare function makeFrameMatcher(token: string): {
+    matchLine: (line: string, expectedSeq: number) => FrameMatch;
+};

package/dist/shellFraming.js

@@ -0,0 +1,43 @@
+import { randomBytes } from "node:crypto";
+/**
+ * Per-shell random token used to namespace sentinel lines. 8 hex chars =
+ * 2^32 possibilities — far below a credible accidental collision with
+ * legitimate command output.
+ */
+export function newToken() {
+    return randomBytes(4).toString("hex");
+}
+/**
+ * Append a printf sentinel to the user's command. The sentinel encodes the
+ * per-shell token and a per-call sequence number, plus the command's exit
+ * code via $?. Reader strips the marker line and exposes everything before
+ * it as stdout.
+ *
+ * Uses printf rather than echo for consistent newline handling across
+ * Android's toybox sh.
+ */
+export function buildFramedCommand(cmd, token, seq) {
+    return `${cmd} ; printf '\\n__FLING_RC_${token}_${seq}__%d\\n' $?`;
+}
+/**
+ * Pre-compile a per-shell matcher. The token is baked into a regex so we
+ * don't recompile per line. matchLine is invoked once per CR/LF-delimited
+ * stdout line.
+ */
+export function makeFrameMatcher(token) {
+    const re = new RegExp(`^__FLING_RC_${token}_(\\d+)__(\\d+)$`);
+    return {
+        matchLine(line, expectedSeq) {
+            const trimmed = line.replace(/\r$/, "");
+            const m = re.exec(trimmed);
+            if (!m)
+                return { matched: false };
+            const seq = Number(m[1]);
+            const exitCode = Number(m[2]);
+            if (seq !== expectedSeq)
+                return { matched: false };
+            return { matched: true, exitCode };
+        },
+    };
+}
+//# sourceMappingURL=shellFraming.js.map

package/dist/shellFraming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shellFraming.js","sourceRoot":"","sources":["../src/shellFraming.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;GAIG;AACH,MAAM,UAAU,QAAQ;IACtB,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAChC,GAAW,EACX,KAAa,EACb,GAAW;IAEX,OAAO,GAAG,GAAG,4BAA4B,KAAK,IAAI,GAAG,aAAa,CAAC;AACrE,CAAC;AAOD;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAG5C,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,eAAe,KAAK,kBAAkB,CAAC,CAAC;IAC9D,OAAO;QACL,SAAS,CAAC,IAAY,EAAE,WAAmB;YACzC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACxC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC3B,IAAI,CAAC,CAAC;gBAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YAClC,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACzB,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9B,IAAI,GAAG,KAAK,WAAW;gBAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QACrC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/shellPool.d.ts

@@ -0,0 +1,54 @@
+import { type ChildProcess } from "node:child_process";
+export interface AdbShellOptions {
+    /**
+     * Injection seam for tests: a function returning a ChildProcess-shaped
+     * object. Defaults to node:child_process.spawn.
+     */
+    spawnImpl?: (cmd: string, args: string[]) => ChildProcess;
+}
+export interface ExecOptions {
+    timeoutMs?: number;
+}
+export interface ExecResult {
+    stdout: string;
+    exitCode: number;
+}
+export declare class AdbShell {
+    readonly serial: string;
+    private child;
+    private readonly token;
+    private readonly matcher;
+    private seq;
+    private shutDown;
+    private readonly spawnImpl;
+    private buffer;
+    private queue;
+    private inFlight;
+    private inFlightTimer;
+    private readersAttached;
+    constructor(serial: string, options?: AdbShellOptions);
+    /** @internal — test seam. Real callers go through exec(). */
+    _ensureSpawned(): ChildProcess;
+    exec(cmd: string, opts?: ExecOptions): Promise<ExecResult>;
+    private _pump;
+    private _onTimeout;
+    private _recycle;
+    private _attachReadersOnce;
+    private _onExit;
+    /** @internal — test seam. */
+    _currentChildForTest(): ChildProcess | null;
+    private _onStdout;
+    shutdown(): void;
+}
+/**
+ * Lazily get-or-create the AdbShell for a device and exec a command on it.
+ * One persistent `adb -s <serial> shell` per device, shared across all
+ * tools that use this helper.
+ */
+export declare function shell(serial: string, cmd: string, opts?: ExecOptions): Promise<ExecResult>;
+/** Kill all live shells and clear the pool. Wired to process exit/SIGINT. */
+export declare function shutdownPool(): void;
+/** @internal — test-only hook to clear pool state between tests. */
+export declare function _resetPoolForTests(): void;
+/** @internal — test-only hook to inspect the pool. */
+export declare function _poolSizeForTests(): number;

package/dist/shellPool.js

@@ -0,0 +1,181 @@
+import { spawn as nodeSpawn } from "node:child_process";
+import { FlingError } from "./errors.js";
+import { buildFramedCommand, makeFrameMatcher, newToken } from "./shellFraming.js";
+const DEFAULT_TIMEOUT_MS = 15_000;
+export class AdbShell {
+    serial;
+    child = null;
+    token = newToken();
+    matcher = makeFrameMatcher(this.token);
+    seq = 0;
+    shutDown = false;
+    spawnImpl;
+    buffer = "";
+    queue = [];
+    inFlight = null;
+    inFlightTimer = null;
+    readersAttached = false;
+    constructor(serial, options = {}) {
+        this.serial = serial;
+        this.spawnImpl = options.spawnImpl ?? nodeSpawn;
+    }
+    /** @internal — test seam. Real callers go through exec(). */
+    _ensureSpawned() {
+        if (this.child)
+            return this.child;
+        if (this.shutDown) {
+            throw new FlingError("ADB_SHELL_SHUT_DOWN", `Shell for ${this.serial} has been shut down.`);
+        }
+        this.child = this.spawnImpl("adb", ["-s", this.serial, "shell"]);
+        return this.child;
+    }
+    exec(cmd, opts = {}) {
+        if (this.shutDown) {
+            return Promise.reject(new FlingError("ADB_SHELL_SHUT_DOWN", `Shell for ${this.serial} has been shut down.`));
+        }
+        this.seq += 1;
+        const seq = this.seq;
+        const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        return new Promise((resolve, reject) => {
+            this.queue.push({ cmd, seq, timeoutMs, resolve, reject });
+            this._pump();
+        });
+    }
+    _pump() {
+        if (this.inFlight)
+            return;
+        const next = this.queue.shift();
+        if (!next)
+            return;
+        const child = this._ensureSpawned();
+        this._attachReadersOnce(child);
+        this.inFlight = {
+            seq: next.seq,
+            resolve: next.resolve,
+            reject: next.reject,
+            stdoutLines: [],
+        };
+        this.inFlightTimer = setTimeout(() => this._onTimeout(), next.timeoutMs);
+        const framed = buildFramedCommand(next.cmd, this.token, next.seq);
+        child.stdin.write(framed + "\n");
+    }
+    _onTimeout() {
+        const failed = this.inFlight;
+        this.inFlight = null;
+        this.inFlightTimer = null;
+        if (failed) {
+            failed.reject(new FlingError("ADB_TIMEOUT", `adb shell command (seq ${failed.seq}) timed out on ${this.serial}.`));
+        }
+        this._recycle("ADB_SHELL_RECYCLED", `Shell for ${this.serial} was recycled after a command timeout.`);
+    }
+    _recycle(code, reason) {
+        for (const q of this.queue) {
+            q.reject(new FlingError(code, reason));
+        }
+        this.queue = [];
+        if (this.child && !this.child.killed) {
+            this.child.kill();
+        }
+        this.child = null;
+        this.readersAttached = false;
+        this.buffer = "";
+    }
+    _attachReadersOnce(child) {
+        if (this.readersAttached)
+            return;
+        this.readersAttached = true;
+        child.stdout.on("data", (chunk) => this._onStdout(chunk));
+        child.on("exit", (code, signal) => this._onExit(code, signal));
+    }
+    _onExit(code, signal) {
+        // If we already nulled the child (clean shutdown, recycle, timeout
+        // path), this is a no-op — those paths already rejected callers.
+        if (!this.child)
+            return;
+        const reason = `adb shell for ${this.serial} exited (code=${code} signal=${signal}).`;
+        const failed = this.inFlight;
+        this.inFlight = null;
+        if (this.inFlightTimer) {
+            clearTimeout(this.inFlightTimer);
+            this.inFlightTimer = null;
+        }
+        if (failed) {
+            failed.reject(new FlingError("ADB_SHELL_DIED", reason));
+        }
+        this._recycle("ADB_SHELL_DIED", reason);
+    }
+    /** @internal — test seam. */
+    _currentChildForTest() {
+        return this.child;
+    }
+    _onStdout(chunk) {
+        this.buffer += chunk.toString();
+        const lines = this.buffer.split(/\n/);
+        this.buffer = lines.pop() ?? "";
+        for (const line of lines) {
+            const call = this.inFlight;
+            if (!call)
+                continue;
+            const m = this.matcher.matchLine(line, call.seq);
+            if (m.matched) {
+                this.inFlight = null;
+                if (this.inFlightTimer) {
+                    clearTimeout(this.inFlightTimer);
+                    this.inFlightTimer = null;
+                }
+                // The framing's printf prepends a literal \n so the sentinel lines
+                // up at column 0 even if the user's command emitted no trailing
+                // newline. That separator surfaces as a trailing empty entry in
+                // stdoutLines — discard it so we don't tack a spurious blank line
+                // onto every command's stdout.
+                if (call.stdoutLines.length > 0 &&
+                    call.stdoutLines[call.stdoutLines.length - 1] === "") {
+                    call.stdoutLines.pop();
+                }
+                const stdout = call.stdoutLines.length === 0
+                    ? ""
+                    : call.stdoutLines.join("\n") + "\n";
+                call.resolve({ stdout, exitCode: m.exitCode });
+                this._pump();
+            }
+            else {
+                call.stdoutLines.push(line);
+            }
+        }
+    }
+    shutdown() {
+        this.shutDown = true;
+        if (this.child && !this.child.killed) {
+            this.child.kill();
+        }
+    }
+}
+const pool = new Map();
+/**
+ * Lazily get-or-create the AdbShell for a device and exec a command on it.
+ * One persistent `adb -s <serial> shell` per device, shared across all
+ * tools that use this helper.
+ */
+export function shell(serial, cmd, opts) {
+    let s = pool.get(serial);
+    if (!s) {
+        s = new AdbShell(serial);
+        pool.set(serial, s);
+    }
+    return s.exec(cmd, opts);
+}
+/** Kill all live shells and clear the pool. Wired to process exit/SIGINT. */
+export function shutdownPool() {
+    for (const s of pool.values())
+        s.shutdown();
+    pool.clear();
+}
+/** @internal — test-only hook to clear pool state between tests. */
+export function _resetPoolForTests() {
+    pool.clear();
+}
+/** @internal — test-only hook to inspect the pool. */
+export function _poolSizeForTests() {
+    return pool.size;
+}
+//# sourceMappingURL=shellPool.js.map

package/dist/shellPool.js.map

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

package/dist/toolResult.d.ts

@@ -0,0 +1,10 @@
+export interface ToolErrorResult {
+    [key: string]: unknown;
+    isError: true;
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+}
+export declare function toolError(message: string): ToolErrorResult;
+export declare function toolErrorFrom(err: unknown): ToolErrorResult;

package/dist/toolResult.js

@@ -0,0 +1,11 @@
+import { describeError } from "./errors.js";
+export function toolError(message) {
+    return {
+        isError: true,
+        content: [{ type: "text", text: message }],
+    };
+}
+export function toolErrorFrom(err) {
+    return toolError(describeError(err));
+}
+//# sourceMappingURL=toolResult.js.map

package/dist/toolResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolResult.js","sourceRoot":"","sources":["../src/toolResult.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAQ5C,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;KAC3C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,OAAO,SAAS,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;AACvC,CAAC"}