@us-all/android-mcp 1.0.0

package/dist/tools/apps.js

@@ -0,0 +1,174 @@
+import { z } from "zod";
+import { adb, adbShell } from "../adb.js";
+import { assertWriteAllowed } from "./utils.js";
+// --- Schemas ---
+export const listPackagesSchema = z.object({
+    filter: z
+        .string()
+        .optional()
+        .describe("Filter packages by name. Example: 'com.google'"),
+    type: z
+        .enum(["all", "system", "third-party"])
+        .optional()
+        .default("all")
+        .describe("Package type filter: all, system, or third-party."),
+    serial: z
+        .string()
+        .optional()
+        .describe("Device serial number. Uses default device if omitted."),
+});
+export const getPackageInfoSchema = z.object({
+    packageName: z
+        .string()
+        .describe("Package name. Example: 'com.android.chrome'"),
+    serial: z
+        .string()
+        .optional()
+        .describe("Device serial number. Uses default device if omitted."),
+});
+export const installAppSchema = z.object({
+    apkPath: z.string().describe("Local path to the APK file to install."),
+    replace: z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe("Replace existing app if installed (default: true)."),
+    serial: z
+        .string()
+        .optional()
+        .describe("Device serial number. Uses default device if omitted."),
+});
+export const uninstallAppSchema = z.object({
+    packageName: z
+        .string()
+        .describe("Package name to uninstall. Example: 'com.example.app'"),
+    keepData: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("Keep app data after uninstall (default: false)."),
+    serial: z
+        .string()
+        .optional()
+        .describe("Device serial number. Uses default device if omitted."),
+});
+export const launchAppSchema = z.object({
+    packageName: z
+        .string()
+        .describe("Package name to launch. Example: 'com.android.chrome'"),
+    activity: z
+        .string()
+        .optional()
+        .describe("Activity to start. If omitted, launches the default launcher activity."),
+    serial: z
+        .string()
+        .optional()
+        .describe("Device serial number. Uses default device if omitted."),
+});
+export const stopAppSchema = z.object({
+    packageName: z
+        .string()
+        .describe("Package name to force stop. Example: 'com.example.app'"),
+    serial: z
+        .string()
+        .optional()
+        .describe("Device serial number. Uses default device if omitted."),
+});
+// --- Handlers ---
+export async function listPackages(params) {
+    const opts = params.serial ? { serial: params.serial } : undefined;
+    let flag = "";
+    if (params.type === "system")
+        flag = "-s";
+    else if (params.type === "third-party")
+        flag = "-3";
+    const args = flag ? `pm list packages ${flag}` : "pm list packages";
+    const output = await adbShell(args, opts);
+    let packages = output
+        .split("\n")
+        .map((l) => l.replace("package:", "").trim())
+        .filter(Boolean);
+    if (params.filter) {
+        const filter = params.filter.toLowerCase();
+        packages = packages.filter((p) => p.toLowerCase().includes(filter));
+    }
+    packages.sort();
+    return { count: packages.length, packages };
+}
+export async function getPackageInfo(params) {
+    const opts = params.serial ? { serial: params.serial } : undefined;
+    const output = await adbShell(`dumpsys package ${params.packageName}`, opts);
+    const info = {
+        packageName: params.packageName,
+    };
+    const versionName = output.match(/versionName=(\S+)/);
+    if (versionName)
+        info.versionName = versionName[1];
+    const versionCode = output.match(/versionCode=(\d+)/);
+    if (versionCode)
+        info.versionCode = versionCode[1];
+    const targetSdk = output.match(/targetSdk=(\d+)/);
+    if (targetSdk)
+        info.targetSdk = targetSdk[1];
+    const minSdk = output.match(/minSdk=(\d+)/);
+    if (minSdk)
+        info.minSdk = minSdk[1];
+    const firstInstall = output.match(/firstInstallTime=(.+)/);
+    if (firstInstall)
+        info.firstInstallTime = firstInstall[1].trim();
+    const lastUpdate = output.match(/lastUpdateTime=(.+)/);
+    if (lastUpdate)
+        info.lastUpdateTime = lastUpdate[1].trim();
+    const permissions = [];
+    const permSection = output.match(/requested permissions:\n([\s\S]*?)(?:\n\s*\n|\ninstall permissions:)/);
+    if (permSection) {
+        const lines = permSection[1].split("\n");
+        for (const line of lines) {
+            const perm = line.trim();
+            if (perm && perm.startsWith("android.permission.")) {
+                permissions.push(perm);
+            }
+        }
+    }
+    if (permissions.length > 0)
+        info.permissions = permissions;
+    return info;
+}
+export async function installApp(params) {
+    assertWriteAllowed();
+    const opts = params.serial ? { serial: params.serial } : undefined;
+    const args = ["install"];
+    if (params.replace)
+        args.push("-r");
+    args.push(params.apkPath);
+    const output = await adb(args, { ...opts, timeout: 120_000 });
+    return { result: output };
+}
+export async function uninstallApp(params) {
+    assertWriteAllowed();
+    const opts = params.serial ? { serial: params.serial } : undefined;
+    const args = ["uninstall"];
+    if (params.keepData)
+        args.push("-k");
+    args.push(params.packageName);
+    const output = await adb(args, opts);
+    return { result: output };
+}
+export async function launchApp(params) {
+    assertWriteAllowed();
+    const opts = params.serial ? { serial: params.serial } : undefined;
+    if (params.activity) {
+        const component = `${params.packageName}/${params.activity}`;
+        const output = await adbShell(`am start -n ${component}`, opts);
+        return { result: output };
+    }
+    const output = await adbShell(`monkey -p ${params.packageName} -c android.intent.category.LAUNCHER 1`, opts);
+    return { result: output };
+}
+export async function stopApp(params) {
+    assertWriteAllowed();
+    const opts = params.serial ? { serial: params.serial } : undefined;
+    const output = await adbShell(`am force-stop ${params.packageName}`, opts);
+    return { result: output || "App stopped successfully" };
+}
+//# sourceMappingURL=apps.js.map

package/dist/tools/apps.js.map

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

package/dist/tools/device.d.ts

@@ -0,0 +1,44 @@
+import { z } from "zod";
+export declare const listDevicesSchema: z.ZodObject<{}, z.core.$strip>;
+export declare const getDeviceInfoSchema: z.ZodObject<{
+    serial: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const getDevicePropertiesSchema: z.ZodObject<{
+    filter: z.ZodOptional<z.ZodString>;
+    serial: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const connectDeviceSchema: z.ZodObject<{
+    address: z.ZodString;
+}, z.core.$strip>;
+export declare const disconnectDeviceSchema: z.ZodObject<{
+    address: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare function listDevices(): Promise<{
+    count: number;
+    devices: {
+        serial: string;
+        status: string;
+    }[];
+}>;
+export declare function getDeviceInfo(params: z.infer<typeof getDeviceInfoSchema>): Promise<{
+    model: string;
+    brand: string;
+    androidVersion: string;
+    sdkVersion: number;
+    abi: string;
+    display: {
+        density: string;
+        size: string;
+    };
+}>;
+export declare function getDeviceProperties(params: z.infer<typeof getDevicePropertiesSchema>): Promise<{
+    count: number;
+    properties: Record<string, string>;
+}>;
+export declare function connectDevice(params: z.infer<typeof connectDeviceSchema>): Promise<{
+    result: string;
+}>;
+export declare function disconnectDevice(params: z.infer<typeof disconnectDeviceSchema>): Promise<{
+    result: string;
+}>;
+//# sourceMappingURL=device.d.ts.map

package/dist/tools/device.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../../src/tools/device.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,iBAAiB,gCAAe,CAAC;AAE9C,eAAO,MAAM,mBAAmB;;iBAK9B,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;iBAWpC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;iBAI9B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;iBAOjC,CAAC;AAIH,wBAAsB,WAAW;;;;;;GAmBhC;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC;;;;;;;;;;GAyB5C;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC;;;GAoBlD;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC;;GAK5C;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC;;GAQ/C"}

package/dist/tools/device.js

@@ -0,0 +1,105 @@
+import { z } from "zod";
+import { adb, adbShell } from "../adb.js";
+import { assertWriteAllowed } from "./utils.js";
+// --- Schemas ---
+export const listDevicesSchema = z.object({});
+export const getDeviceInfoSchema = z.object({
+    serial: z
+        .string()
+        .optional()
+        .describe("Device serial number. Uses default device if omitted."),
+});
+export const getDevicePropertiesSchema = z.object({
+    filter: z
+        .string()
+        .optional()
+        .describe("Filter properties by prefix. Example: 'ro.build' to get build-related props."),
+    serial: z
+        .string()
+        .optional()
+        .describe("Device serial number. Uses default device if omitted."),
+});
+export const connectDeviceSchema = z.object({
+    address: z
+        .string()
+        .describe("Device address in host:port format. Example: '192.168.1.100:5555'"),
+});
+export const disconnectDeviceSchema = z.object({
+    address: z
+        .string()
+        .optional()
+        .describe("Device address to disconnect. Disconnects all TCP/IP devices if omitted."),
+});
+// --- Handlers ---
+export async function listDevices() {
+    const output = await adb(["devices", "-l"]);
+    const lines = output.split("\n").filter((l) => l.trim() && !l.startsWith("List"));
+    const devices = lines.map((line) => {
+        const parts = line.trim().split(/\s+/);
+        const serial = parts[0];
+        const status = parts[1];
+        const details = {};
+        for (const part of parts.slice(2)) {
+            const [key, value] = part.split(":");
+            if (key && value) {
+                details[key] = value;
+            }
+        }
+        return { serial, status, ...details };
+    });
+    return { count: devices.length, devices };
+}
+export async function getDeviceInfo(params) {
+    const opts = params.serial ? { serial: params.serial } : undefined;
+    const [model, brand, sdk, release, density, size, abi] = await Promise.all([
+        adbShell("getprop ro.product.model", opts),
+        adbShell("getprop ro.product.brand", opts),
+        adbShell("getprop ro.build.version.sdk", opts),
+        adbShell("getprop ro.build.version.release", opts),
+        adbShell("wm density", opts).catch(() => "unknown"),
+        adbShell("wm size", opts).catch(() => "unknown"),
+        adbShell("getprop ro.product.cpu.abi", opts),
+    ]);
+    return {
+        model: model.trim(),
+        brand: brand.trim(),
+        androidVersion: release.trim(),
+        sdkVersion: parseInt(sdk.trim(), 10),
+        abi: abi.trim(),
+        display: {
+            density: density.replace("Physical density: ", "").trim(),
+            size: size.replace("Physical size: ", "").trim(),
+        },
+    };
+}
+export async function getDeviceProperties(params) {
+    const opts = params.serial ? { serial: params.serial } : undefined;
+    const output = await adbShell("getprop", opts);
+    const props = {};
+    const lines = output.split("\n");
+    for (const line of lines) {
+        const match = line.match(/^\[(.+?)\]:\s*\[(.*)?\]$/);
+        if (match) {
+            const key = match[1];
+            const value = match[2] ?? "";
+            if (!params.filter || key.startsWith(params.filter)) {
+                props[key] = value;
+            }
+        }
+    }
+    return { count: Object.keys(props).length, properties: props };
+}
+export async function connectDevice(params) {
+    assertWriteAllowed();
+    const output = await adb(["connect", params.address]);
+    return { result: output };
+}
+export async function disconnectDevice(params) {
+    assertWriteAllowed();
+    const args = params.address
+        ? ["disconnect", params.address]
+        : ["disconnect"];
+    const output = await adb(args);
+    return { result: output };
+}
+//# sourceMappingURL=device.js.map

package/dist/tools/device.js.map

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

package/dist/tools/emulator.d.ts

@@ -0,0 +1,46 @@
+import { z } from "zod";
+export declare const listAvdsSchema: z.ZodObject<{}, z.core.$strip>;
+export declare const startEmulatorSchema: z.ZodObject<{
+    avdName: z.ZodString;
+    noWindow: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    wipeData: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>;
+export declare const stopEmulatorSchema: z.ZodObject<{
+    serial: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
+export declare const listSnapshotsSchema: z.ZodObject<{
+    serial: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
+export declare const loadSnapshotSchema: z.ZodObject<{
+    snapshotName: z.ZodString;
+    serial: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
+export declare function listAvds(): Promise<{
+    count: number;
+    avds: string[];
+    error?: undefined;
+} | {
+    count: number;
+    avds: never[];
+    error: string;
+}>;
+export declare function startEmulator(params: z.infer<typeof startEmulatorSchema>): Promise<{
+    result: string;
+    pid: number | undefined;
+}>;
+export declare function stopEmulator(params: z.infer<typeof stopEmulatorSchema>): Promise<{
+    result: string;
+}>;
+export declare function listSnapshots(params: z.infer<typeof listSnapshotsSchema>): Promise<{
+    count: number;
+    snapshots: string[];
+    note?: undefined;
+} | {
+    count: number;
+    snapshots: never[];
+    note: string;
+}>;
+export declare function loadSnapshot(params: z.infer<typeof loadSnapshotSchema>): Promise<{
+    result: string;
+}>;
+//# sourceMappingURL=emulator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"emulator.d.ts","sourceRoot":"","sources":["../../src/tools/emulator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA0BxB,eAAO,MAAM,cAAc,gCAAe,CAAC;AAE3C,eAAO,MAAM,mBAAmB;;;;iBAY9B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;iBAQ7B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;iBAM9B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;iBAO7B,CAAC;AAIH,wBAAsB,QAAQ;;;;;;;;GA2B7B;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC;;;GAkB5C;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC;;GAK3C;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC;;;;;;;;GAe5C;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC;;GAQ3C"}

package/dist/tools/emulator.js

@@ -0,0 +1,129 @@
+import { z } from "zod";
+import { execFile, spawn } from "node:child_process";
+import { promisify } from "node:util";
+import path from "node:path";
+import { config } from "../config.js";
+import { adb, adbShell } from "../adb.js";
+import { assertWriteAllowed } from "./utils.js";
+const execFileAsync = promisify(execFile);
+function getEmulatorPath() {
+    if (config.androidHome) {
+        return path.join(config.androidHome, "emulator", "emulator");
+    }
+    return "emulator";
+}
+function getAvdManagerPath() {
+    if (config.androidHome) {
+        return path.join(config.androidHome, "cmdline-tools", "latest", "bin", "avdmanager");
+    }
+    return "avdmanager";
+}
+// --- Schemas ---
+export const listAvdsSchema = z.object({});
+export const startEmulatorSchema = z.object({
+    avdName: z.string().describe("Name of the AVD to start."),
+    noWindow: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("Start emulator without GUI window (headless mode)."),
+    wipeData: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("Wipe user data before starting."),
+});
+export const stopEmulatorSchema = z.object({
+    serial: z
+        .string()
+        .optional()
+        .default("emulator-5554")
+        .describe("Emulator serial number to stop (default: 'emulator-5554')."),
+});
+export const listSnapshotsSchema = z.object({
+    serial: z
+        .string()
+        .optional()
+        .default("emulator-5554")
+        .describe("Emulator serial number (default: 'emulator-5554')."),
+});
+export const loadSnapshotSchema = z.object({
+    snapshotName: z.string().describe("Name of the snapshot to load."),
+    serial: z
+        .string()
+        .optional()
+        .default("emulator-5554")
+        .describe("Emulator serial number (default: 'emulator-5554')."),
+});
+// --- Handlers ---
+export async function listAvds() {
+    const emulatorPath = getEmulatorPath();
+    try {
+        const { stdout } = await execFileAsync(emulatorPath, ["-list-avds"]);
+        const avds = stdout
+            .trim()
+            .split("\n")
+            .filter(Boolean);
+        return { count: avds.length, avds };
+    }
+    catch {
+        try {
+            const avdManagerPath = getAvdManagerPath();
+            const { stdout } = await execFileAsync(avdManagerPath, ["list", "avd", "-c"]);
+            const avds = stdout
+                .trim()
+                .split("\n")
+                .filter(Boolean);
+            return { count: avds.length, avds };
+        }
+        catch {
+            return {
+                count: 0,
+                avds: [],
+                error: "Could not list AVDs. Ensure ANDROID_HOME is set and emulator/avdmanager is available.",
+            };
+        }
+    }
+}
+export async function startEmulator(params) {
+    assertWriteAllowed();
+    const emulatorPath = getEmulatorPath();
+    const args = ["-avd", params.avdName];
+    if (params.noWindow)
+        args.push("-no-window");
+    if (params.wipeData)
+        args.push("-wipe-data");
+    const child = spawn(emulatorPath, args, {
+        detached: true,
+        stdio: "ignore",
+    });
+    child.unref();
+    return {
+        result: `Emulator '${params.avdName}' starting...`,
+        pid: child.pid,
+    };
+}
+export async function stopEmulator(params) {
+    assertWriteAllowed();
+    const output = await adb(["emu", "kill"], { serial: params.serial });
+    return { result: output || "Emulator stopped" };
+}
+export async function listSnapshots(params) {
+    try {
+        const output = await adbShell("ls /data/misc/snapshots/ 2>/dev/null || echo 'default_boot'", { serial: params.serial });
+        const snapshots = output
+            .trim()
+            .split("\n")
+            .filter(Boolean);
+        return { count: snapshots.length, snapshots };
+    }
+    catch {
+        return { count: 0, snapshots: [], note: "Snapshot listing not supported on this device" };
+    }
+}
+export async function loadSnapshot(params) {
+    assertWriteAllowed();
+    const output = await adb(["emu", "avd", "snapshot", "load", params.snapshotName], { serial: params.serial });
+    return { result: output || `Snapshot '${params.snapshotName}' loaded` };
+}
+//# sourceMappingURL=emulator.js.map

package/dist/tools/emulator.js.map

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

package/dist/tools/files.d.ts

@@ -0,0 +1,36 @@
+import { z } from "zod";
+export declare const listFilesSchema: z.ZodObject<{
+    path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    recursive: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    serial: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const pullFileSchema: z.ZodObject<{
+    remotePath: z.ZodString;
+    localPath: z.ZodString;
+    serial: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const pushFileSchema: z.ZodObject<{
+    localPath: z.ZodString;
+    remotePath: z.ZodString;
+    serial: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const deleteFileSchema: z.ZodObject<{
+    path: z.ZodString;
+    recursive: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    serial: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare function listFiles(params: z.infer<typeof listFilesSchema>): Promise<{
+    path: string;
+    count: number;
+    entries: string[];
+}>;
+export declare function pullFile(params: z.infer<typeof pullFileSchema>): Promise<{
+    result: string;
+}>;
+export declare function pushFile(params: z.infer<typeof pushFileSchema>): Promise<{
+    result: string;
+}>;
+export declare function deleteFile(params: z.infer<typeof deleteFileSchema>): Promise<{
+    result: string;
+}>;
+//# sourceMappingURL=files.d.ts.map

package/dist/tools/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/tools/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,eAAe;;;;iBAe1B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;iBAWzB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;iBASzB,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;iBAW3B,CAAC;AAIH,wBAAsB,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC;;;;GAWtE;AAED,wBAAsB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC;;GAOpE;AAED,wBAAsB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC;;GAQpE;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC;;GAMxE"}

package/dist/tools/files.js

@@ -0,0 +1,85 @@
+import { z } from "zod";
+import { adb, adbShell } from "../adb.js";
+import { assertWriteAllowed } from "./utils.js";
+// --- Schemas ---
+export const listFilesSchema = z.object({
+    path: z
+        .string()
+        .optional()
+        .default("/sdcard")
+        .describe("Directory path on device (default: /sdcard)."),
+    recursive: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("List files recursively (default: false)."),
+    serial: z
+        .string()
+        .optional()
+        .describe("Device serial number. Uses default device if omitted."),
+});
+export const pullFileSchema = z.object({
+    remotePath: z
+        .string()
+        .describe("File path on the device to pull."),
+    localPath: z
+        .string()
+        .describe("Local destination path."),
+    serial: z
+        .string()
+        .optional()
+        .describe("Device serial number. Uses default device if omitted."),
+});
+export const pushFileSchema = z.object({
+    localPath: z.string().describe("Local file path to push."),
+    remotePath: z
+        .string()
+        .describe("Destination path on the device."),
+    serial: z
+        .string()
+        .optional()
+        .describe("Device serial number. Uses default device if omitted."),
+});
+export const deleteFileSchema = z.object({
+    path: z.string().describe("File or directory path on the device to delete."),
+    recursive: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("Delete recursively for directories (default: false)."),
+    serial: z
+        .string()
+        .optional()
+        .describe("Device serial number. Uses default device if omitted."),
+});
+// --- Handlers ---
+export async function listFiles(params) {
+    const opts = params.serial ? { serial: params.serial } : undefined;
+    const flag = params.recursive ? "-lR" : "-la";
+    const output = await adbShell(`ls ${flag} ${params.path}`, opts);
+    const lines = output.split("\n").filter(Boolean);
+    return {
+        path: params.path,
+        count: lines.length,
+        entries: lines,
+    };
+}
+export async function pullFile(params) {
+    const opts = params.serial ? { serial: params.serial } : undefined;
+    const output = await adb(["pull", params.remotePath, params.localPath], opts);
+    return { result: output };
+}
+export async function pushFile(params) {
+    assertWriteAllowed();
+    const opts = params.serial ? { serial: params.serial } : undefined;
+    const output = await adb(["push", params.localPath, params.remotePath], opts);
+    return { result: output };
+}
+export async function deleteFile(params) {
+    assertWriteAllowed();
+    const opts = params.serial ? { serial: params.serial } : undefined;
+    const flag = params.recursive ? "-rf" : "-f";
+    const output = await adbShell(`rm ${flag} ${params.path}`, opts);
+    return { result: output || `Deleted: ${params.path}` };
+}
+//# sourceMappingURL=files.js.map