@beeos-ai/device-agent 0.4.0

package/dist/core/session.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Core domain — Session state machine.
+ *
+ * A session is a single conversation thread. It owns:
+ *  - a chronological history of messages,
+ *  - lifecycle metadata (created / lastActive),
+ *  - the current task (if any) so cancel can target it.
+ *
+ * Pure data. The application layer (`SessionManager`) handles persistence,
+ * eviction, and ACP-side dispatch.
+ */
+export type SessionMessage = {
+    role: "user";
+    content: string;
+    createdAt: number;
+} | {
+    role: "assistant";
+    content: string;
+    createdAt: number;
+    messageType?: "text" | "tool_call" | "tool_result";
+    meta?: Record<string, unknown>;
+} | {
+    role: "system";
+    content: string;
+    createdAt: number;
+    meta?: Record<string, unknown>;
+};
+export interface Session {
+    id: string;
+    title: string;
+    history: SessionMessage[];
+    createdAt: number;
+    lastActive: number;
+    /** id of the in-flight task, if any. */
+    currentTaskId: string | null;
+}
+export declare function newSession(id: string, now?: number): Session;
+export declare function sessionSummary(s: Session): {
+    sessionId: string;
+    title: string;
+    updatedAt: number;
+};

package/dist/core/session.js

@@ -0,0 +1,29 @@
+/**
+ * Core domain — Session state machine.
+ *
+ * A session is a single conversation thread. It owns:
+ *  - a chronological history of messages,
+ *  - lifecycle metadata (created / lastActive),
+ *  - the current task (if any) so cancel can target it.
+ *
+ * Pure data. The application layer (`SessionManager`) handles persistence,
+ * eviction, and ACP-side dispatch.
+ */
+export function newSession(id, now = Date.now()) {
+    return {
+        id,
+        title: "New chat",
+        history: [],
+        createdAt: now,
+        lastActive: now,
+        currentTaskId: null,
+    };
+}
+export function sessionSummary(s) {
+    return {
+        sessionId: s.id,
+        title: s.title,
+        updatedAt: s.lastActive,
+    };
+}
+//# sourceMappingURL=session.js.map

package/dist/core/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/core/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAiBH,MAAM,UAAU,UAAU,CAAC,EAAU,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IACrD,OAAO;QACL,EAAE;QACF,KAAK,EAAE,UAAU;QACjB,OAAO,EAAE,EAAE;QACX,SAAS,EAAE,GAAG;QACd,UAAU,EAAE,GAAG;QACf,aAAa,EAAE,IAAI;KACpB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,CAAU;IACvC,OAAO;QACL,SAAS,EAAE,CAAC,CAAC,EAAE;QACf,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,SAAS,EAAE,CAAC,CAAC,UAAU;KACxB,CAAC;AACJ,CAAC"}

package/dist/debug/dump-system-prompt.d.ts

@@ -0,0 +1 @@
+import "dotenv/config";

package/dist/debug/dump-system-prompt.js

@@ -0,0 +1,34 @@
+import "dotenv/config";
+import { createAgentSession, DefaultResourceLoader, getAgentDir, } from "@mariozechner/pi-coding-agent";
+import { dirname, resolve } from "path";
+import { fileURLToPath } from "url";
+import { ORCHESTRATOR_SYSTEM_PROMPT } from "../orchestrator-system-prompt.js";
+import { projectPiSkillsLoaderOptions } from "../pi-local-skills.js";
+const PROJECT_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..", "..");
+async function main() {
+    const loader = new DefaultResourceLoader({
+        cwd: PROJECT_ROOT,
+        agentDir: getAgentDir(),
+        systemPromptOverride: () => ORCHESTRATOR_SYSTEM_PROMPT,
+        ...projectPiSkillsLoaderOptions(PROJECT_ROOT),
+    });
+    await loader.reload();
+    const { session } = await createAgentSession({ resourceLoader: loader });
+    const prompt = session.systemPrompt;
+    console.log("==== FINAL SYSTEM PROMPT ====");
+    console.log(prompt);
+    console.log(`\n==== END SYSTEM PROMPT (length=${prompt.length} chars) ====\n`);
+    // What's actually sent as the `tools` HTTP parameter (distinct from system prompt)
+    const tools = session.getAllTools();
+    console.log(`==== TOOLS PARAMETER (count=${tools.length}) ====`);
+    for (const t of tools) {
+        console.log(`\n[${t.name}]  source=${t.sourceInfo?.source ?? "?"}`);
+        console.log(`  description: ${t.description}`);
+        console.log(`  parameters: ${JSON.stringify(t.parameters).slice(0, 400)}`);
+    }
+    console.log("\n==== END TOOLS ====");
+    session.dispose();
+    process.exit(0);
+}
+main().catch((e) => { console.error(e); process.exit(1); });
+//# sourceMappingURL=dump-system-prompt.js.map

package/dist/debug/dump-system-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dump-system-prompt.js","sourceRoot":"","sources":["../../src/debug/dump-system-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AACvB,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,WAAW,GACZ,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAErE,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAElF,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,IAAI,qBAAqB,CAAC;QACvC,GAAG,EAAE,YAAY;QACjB,QAAQ,EAAE,WAAW,EAAE;QACvB,oBAAoB,EAAE,GAAG,EAAE,CAAC,0BAA0B;QACtD,GAAG,4BAA4B,CAAC,YAAY,CAAC;KAC9C,CAAC,CAAC;IACH,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;IAEtB,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,kBAAkB,CAAC,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC,CAAC;IAEzE,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IACpC,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpB,OAAO,CAAC,GAAG,CAAC,oCAAoC,MAAM,CAAC,MAAM,gBAAgB,CAAC,CAAC;IAE/E,mFAAmF;IACnF,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACpC,OAAO,CAAC,GAAG,CAAC,+BAA+B,KAAK,CAAC,MAAM,QAAQ,CAAC,CAAC;IACjE,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC,UAAU,EAAE,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC;QACpE,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IAErC,OAAO,CAAC,OAAO,EAAE,CAAC;IAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/device/android.d.ts

@@ -0,0 +1,25 @@
+import type { Device, ScreenshotResult } from "./base.js";
+export declare class AndroidDevice implements Device {
+    private readonly deviceId?;
+    constructor(deviceId?: string | undefined);
+    /** Read-only access to the ADB serial used by this driver. */
+    get serial(): string | undefined;
+    private adbArgs;
+    private adb;
+    takeScreenshot(): Promise<ScreenshotResult>;
+    getUiXml(): Promise<string | null>;
+    getCurrentApp(): Promise<string>;
+    tap(x: number, y: number): Promise<void>;
+    doubleTap(x: number, y: number): Promise<void>;
+    longPress(x: number, y: number, durationMs?: number): Promise<void>;
+    swipe(startX: number, startY: number, endX: number, endY: number, durationMs?: number): Promise<void>;
+    inputText(text: string): Promise<void>;
+    pressKey(key: string): Promise<void>;
+    launchApp(appName: string): Promise<boolean>;
+    pressBack(): Promise<void>;
+    pressHome(): Promise<void>;
+    clearText(): Promise<void>;
+    static listDevices(): Promise<string[]>;
+    private detectAndSetAdbKeyboard;
+    private restoreKeyboard;
+}

package/dist/device/android.js

@@ -0,0 +1,231 @@
+import { execFile } from "child_process";
+import { promisify } from "util";
+import sharp from "sharp";
+import { APP_PACKAGES, getAppPackage } from "./apps.js";
+import { DeviceError } from "../core/errors.js";
+// Cap the longest edge sent to the model. Full-res PNG (e.g. 1200×2670 ≈ 4 MB)
+// reliably triggers ECONNRESET on some streaming endpoints. 1280 JPEG q80 ≈ 150-350 KB.
+const SS_MAX_EDGE = parseInt(process.env.GUI_AGENT_SS_MAX_EDGE ?? "1280", 10);
+const SS_JPEG_QUALITY = parseInt(process.env.GUI_AGENT_SS_JPEG_QUALITY ?? "80", 10);
+const ADB_DEFAULT_TIMEOUT_MS = 10_000;
+const ADB_SCREENSHOT_TIMEOUT_MS = 15_000;
+const execFileAsync = promisify(execFile);
+const DELAYS = {
+    tap: 1500,
+    doubleTap: 1000,
+    doubleTapInterval: 100,
+    longPress: 1500,
+    swipe: 2000,
+    back: 1500,
+    home: 1500,
+    launch: 3000,
+    keyboardSwitch: 500,
+    textClear: 300,
+    textInput: 500,
+    keyboardRestore: 300,
+};
+const sleep = (ms) => new Promise((res) => setTimeout(res, ms));
+export class AndroidDevice {
+    deviceId;
+    constructor(deviceId) {
+        this.deviceId = deviceId;
+    }
+    /** Read-only access to the ADB serial used by this driver. */
+    get serial() {
+        return this.deviceId;
+    }
+    adbArgs(...args) {
+        return this.deviceId ? ["-s", this.deviceId, ...args] : args;
+    }
+    async adb(...args) {
+        try {
+            const { stdout, stderr } = await execFileAsync("adb", this.adbArgs(...args), {
+                timeout: ADB_DEFAULT_TIMEOUT_MS,
+                killSignal: "SIGTERM",
+                maxBuffer: 32 * 1024 * 1024,
+            });
+            return { stdout, stderr };
+        }
+        catch (e) {
+            const err = e;
+            if (err.killed && err.signal === "SIGTERM") {
+                throw new DeviceError(`adb ${args[0] ?? ""} timed out after ${ADB_DEFAULT_TIMEOUT_MS}ms`, {
+                    subtype: "adb_timeout",
+                    retriable: true,
+                    cause: err,
+                });
+            }
+            throw new DeviceError(`adb ${args[0] ?? ""} failed: ${err.message}`, {
+                subtype: "adb_failed",
+                cause: err,
+            });
+        }
+    }
+    async takeScreenshot() {
+        let buf;
+        try {
+            const { stdout } = await execFileAsync("adb", this.adbArgs("exec-out", "screencap", "-p"), {
+                encoding: "buffer",
+                maxBuffer: 20 * 1024 * 1024,
+                timeout: ADB_SCREENSHOT_TIMEOUT_MS,
+                killSignal: "SIGTERM",
+            });
+            buf = stdout;
+        }
+        catch (e) {
+            const err = e;
+            if (err.killed && err.signal === "SIGTERM") {
+                throw new DeviceError(`adb screencap timed out after ${ADB_SCREENSHOT_TIMEOUT_MS}ms`, {
+                    subtype: "screenshot_timeout",
+                    retriable: true,
+                    cause: err,
+                });
+            }
+            throw new DeviceError(`adb screencap failed: ${err.message}`, {
+                subtype: "screenshot_failed",
+                cause: err,
+            });
+        }
+        const [width, height] = parsePngDimensions(buf);
+        // Downscale to cap payload size (real screen w/h still returned unchanged,
+        // so ActionHandler coordinate math stays correct).
+        const base64Data = await compressScreenshot(buf, width, height);
+        return { base64Data, width, height };
+    }
+    async getUiXml() {
+        // Dump UI hierarchy via uiautomator and pull the XML
+        await this.adb("shell", "uiautomator", "dump", "/sdcard/ui_dump.xml");
+        const { stdout } = await this.adb("shell", "cat", "/sdcard/ui_dump.xml");
+        if (!stdout || stdout.includes("ERROR"))
+            return null;
+        return stdout.trim() || null;
+    }
+    async getCurrentApp() {
+        const { stdout } = await this.adb("shell", "dumpsys", "window");
+        for (const line of stdout.split("\n")) {
+            if (line.includes("mCurrentFocus") || line.includes("mFocusedApp")) {
+                for (const [appName, pkg] of Object.entries(APP_PACKAGES)) {
+                    if (line.includes(pkg))
+                        return appName;
+                }
+            }
+        }
+        return "System Home";
+    }
+    async tap(x, y) {
+        await this.adb("shell", "input", "tap", String(x), String(y));
+        await sleep(DELAYS.tap);
+    }
+    async doubleTap(x, y) {
+        await this.adb("shell", "input", "tap", String(x), String(y));
+        await sleep(DELAYS.doubleTapInterval);
+        await this.adb("shell", "input", "tap", String(x), String(y));
+        await sleep(DELAYS.doubleTap);
+    }
+    async longPress(x, y, durationMs = 3000) {
+        await this.adb("shell", "input", "swipe", String(x), String(y), String(x), String(y), String(durationMs));
+        await sleep(DELAYS.longPress);
+    }
+    async swipe(startX, startY, endX, endY, durationMs) {
+        const dur = durationMs ?? Math.max(1000, Math.min(Math.round(Math.hypot(startX - endX, startY - endY)), 2000));
+        await this.adb("shell", "input", "swipe", String(startX), String(startY), String(endX), String(endY), String(dur));
+        await sleep(DELAYS.swipe);
+    }
+    async inputText(text) {
+        const originalIme = await this.detectAndSetAdbKeyboard();
+        await sleep(DELAYS.keyboardSwitch);
+        await this.clearText();
+        await sleep(DELAYS.textClear);
+        // ADB keyboard broadcast supports Unicode
+        await this.adb("shell", "am", "broadcast", "-a", "ADB_INPUT_TEXT", "--es", "msg", text);
+        await sleep(DELAYS.textInput);
+        await this.restoreKeyboard(originalIme);
+        await sleep(DELAYS.keyboardRestore);
+    }
+    async pressKey(key) {
+        await this.adb("shell", "input", "keyevent", key);
+    }
+    async launchApp(appName) {
+        const pkg = getAppPackage(appName);
+        if (!pkg) {
+            console.warn(`[AndroidDevice] launchApp: no package mapping for "${appName}"`);
+            return false;
+        }
+        await this.adb("shell", "monkey", "-p", pkg, "-c", "android.intent.category.LAUNCHER", "1");
+        await sleep(DELAYS.launch);
+        return true;
+    }
+    async pressBack() {
+        await this.adb("shell", "input", "keyevent", "4");
+        await sleep(DELAYS.back);
+    }
+    async pressHome() {
+        await this.adb("shell", "input", "keyevent", "KEYCODE_HOME");
+        await sleep(DELAYS.home);
+    }
+    async clearText() {
+        await this.adb("shell", "input", "keyevent", "KEYCODE_CTRL_A");
+        await this.adb("shell", "input", "keyevent", "KEYCODE_DEL");
+    }
+    static async listDevices() {
+        try {
+            const { stdout } = await execFileAsync("adb", ["devices"], {
+                timeout: ADB_DEFAULT_TIMEOUT_MS,
+                killSignal: "SIGTERM",
+            });
+            return stdout
+                .split("\n")
+                .slice(1)
+                .filter((l) => l.includes("\tdevice"))
+                .map((l) => l.split("\t")[0]);
+        }
+        catch (e) {
+            const err = e;
+            if (err.killed && err.signal === "SIGTERM") {
+                throw new DeviceError(`adb devices timed out after ${ADB_DEFAULT_TIMEOUT_MS}ms`, {
+                    subtype: "adb_timeout",
+                    retriable: true,
+                    cause: err,
+                });
+            }
+            throw new DeviceError(`adb devices failed: ${err.message}`, { subtype: "adb_failed", cause: err });
+        }
+    }
+    async detectAndSetAdbKeyboard() {
+        const { stdout } = await this.adb("shell", "settings", "get", "secure", "default_input_method");
+        const original = stdout.trim();
+        await this.adb("shell", "ime", "set", "com.android.adbkeyboard/.AdbIME");
+        return original;
+    }
+    async restoreKeyboard(ime) {
+        if (ime)
+            await this.adb("shell", "ime", "set", ime);
+    }
+}
+function parsePngDimensions(data) {
+    try {
+        return [data.readUInt32BE(16), data.readUInt32BE(20)];
+    }
+    catch {
+        return [1080, 1920];
+    }
+}
+async function compressScreenshot(buf, width, height) {
+    try {
+        const longEdge = Math.max(width, height);
+        const pipeline = sharp(buf, { failOn: "none" });
+        if (longEdge > SS_MAX_EDGE) {
+            if (width >= height)
+                pipeline.resize({ width: SS_MAX_EDGE });
+            else
+                pipeline.resize({ height: SS_MAX_EDGE });
+        }
+        const out = await pipeline.jpeg({ quality: SS_JPEG_QUALITY, mozjpeg: true }).toBuffer();
+        return out.toString("base64");
+    }
+    catch (e) {
+        console.warn(`[AndroidDevice] screenshot compression failed, falling back to raw PNG: ${e}`);
+        return buf.toString("base64");
+    }
+}
+//# sourceMappingURL=android.js.map

package/dist/device/android.js.map

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

package/dist/device/apps.d.ts

@@ -0,0 +1,3 @@
+export declare const APP_PACKAGES: Record<string, string>;
+/** Resolve app name to package, with normalization + fuzzy (substring) fallback. */
+export declare function getAppPackage(appName: string): string | undefined;

package/dist/device/apps.js

@@ -0,0 +1,77 @@
+export const APP_PACKAGES = {
+    // Social & Messaging
+    "微信": "com.tencent.mm", WeChat: "com.tencent.mm", wechat: "com.tencent.mm",
+    QQ: "com.tencent.mobileqq",
+    "微博": "com.sina.weibo",
+    "钉钉": "com.alibaba.android.rimet", DingTalk: "com.alibaba.android.rimet",
+    "飞书": "com.ss.android.lark", Feishu: "com.ss.android.lark",
+    Telegram: "org.telegram.messenger",
+    WhatsApp: "com.whatsapp", Whatsapp: "com.whatsapp",
+    // E-commerce
+    "淘宝": "com.taobao.taobao",
+    "京东": "com.jingdong.app.mall",
+    "拼多多": "com.xunmeng.pinduoduo",
+    "小红书": "com.xingin.xhs", XiaoHongShu: "com.xingin.xhs", xiaohongshu: "com.xingin.xhs", RED: "com.xingin.xhs",
+    Temu: "com.einnovation.temu", temu: "com.einnovation.temu",
+    // Food
+    "美团": "com.sankuai.meituan",
+    "大众点评": "com.dianping.v1",
+    "饿了么": "me.ele",
+    // Maps
+    "高德地图": "com.autonavi.minimap",
+    "百度地图": "com.baidu.BaiduMap",
+    "滴滴出行": "com.sdu.didi.psnger",
+    GoogleMaps: "com.google.android.apps.maps", "Google Maps": "com.google.android.apps.maps",
+    // Travel
+    "携程": "ctrip.android.view",
+    "铁路12306": "com.MobileTicket", "12306": "com.MobileTicket",
+    "去哪儿": "com.Qunar", "去哪儿旅行": "com.Qunar",
+    // Video & Entertainment
+    bilibili: "tv.danmaku.bili",
+    "抖音": "com.ss.android.ugc.aweme",
+    TikTok: "com.zhiliaoapp.musically",
+    "快手": "com.smile.gifmaker",
+    "腾讯视频": "com.tencent.qqlive",
+    "爱奇艺": "com.qiyi.video",
+    "优酷": "com.youku.phone",
+    // Music
+    "网易云音乐": "com.netease.cloudmusic",
+    "QQ音乐": "com.tencent.qqmusic",
+    Spotify: "com.spotify.music",
+    // Finance
+    "支付宝": "com.eg.android.AlipayGphone", Alipay: "com.eg.android.AlipayGphone",
+    "招商银行": "cmb.pb",
+    // Health
+    "微信运动": "com.tencent.mm", // same package, different entry
+    // System
+    "设置": "com.android.settings", Settings: "com.android.settings",
+    "系统设置": "com.android.settings", "手机设置": "com.android.settings", SystemSettings: "com.android.settings",
+    "相机": "com.android.camera2", Camera: "com.android.camera2",
+    "图库": "com.android.gallery3d", Gallery: "com.android.gallery3d",
+    // Browsers
+    Chrome: "com.android.chrome",
+    "夸克浏览器": "com.quark.browser",
+    "UC浏览器": "com.UCMobile.intl",
+};
+/** Resolve app name to package, with normalization + fuzzy (substring) fallback. */
+export function getAppPackage(appName) {
+    if (!appName)
+        return undefined;
+    if (APP_PACKAGES[appName])
+        return APP_PACKAGES[appName];
+    const trimmed = appName.trim();
+    if (APP_PACKAGES[trimmed])
+        return APP_PACKAGES[trimmed];
+    const lower = trimmed.toLowerCase();
+    for (const [k, v] of Object.entries(APP_PACKAGES)) {
+        if (k.toLowerCase() === lower)
+            return v;
+    }
+    // Substring match — e.g. "系统设置" matches key "设置"
+    for (const [k, v] of Object.entries(APP_PACKAGES)) {
+        if (trimmed.includes(k) || k.includes(trimmed))
+            return v;
+    }
+    return undefined;
+}
+//# sourceMappingURL=apps.js.map

package/dist/device/apps.js.map

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

package/dist/device/base.d.ts

@@ -0,0 +1,20 @@
+export interface ScreenshotResult {
+    base64Data: string;
+    width: number;
+    height: number;
+}
+export interface Device {
+    takeScreenshot(): Promise<ScreenshotResult>;
+    getCurrentApp(): Promise<string>;
+    getUiXml(): Promise<string | null>;
+    tap(x: number, y: number): Promise<void>;
+    doubleTap(x: number, y: number): Promise<void>;
+    longPress(x: number, y: number, durationMs?: number): Promise<void>;
+    swipe(startX: number, startY: number, endX: number, endY: number, durationMs?: number): Promise<void>;
+    inputText(text: string): Promise<void>;
+    pressKey(key: string): Promise<void>;
+    launchApp(appName: string): Promise<boolean>;
+    pressBack(): Promise<void>;
+    pressHome(): Promise<void>;
+    clearText(): Promise<void>;
+}

package/dist/device/base.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=base.js.map

package/dist/device/base.js.map

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

package/dist/device/ui-xml.d.ts

@@ -0,0 +1,29 @@
+import type { Device } from "./base.js";
+export interface UiNode {
+    text: string;
+    resourceId: string;
+    contentDesc: string;
+    className: string;
+    bounds: string;
+    center: {
+        x: number;
+        y: number;
+    };
+    clickable: boolean;
+    enabled: boolean;
+}
+/**
+ * Fetch UI hierarchy from the device and return a compact, LLM-ready string.
+ *
+ * No query  → all interactive + standalone-text nodes, one line each.
+ * With query → same list filtered by substring match on text / resource-id /
+ *              content-desc / class (case-insensitive).
+ */
+export declare function queryUiXml(device: Device, query?: string): Promise<string>;
+/** Same string the `ui_xml` tool returns, given already-fetched XML. */
+export declare function formatUiXmlToolOutput(xml: string, query?: string): string;
+/**
+ * Search raw XML for nodes matching a query — used by test:ui-xml script.
+ * Returns UiNode[] for JSON dump; formatUiXmlToolOutput() is the tool path.
+ */
+export declare function searchUiXmlNodes(xml: string, query: string): UiNode[];