@beeos-ai/device-agent 0.4.0

package/dist/inbound/cli/run-command.js

@@ -0,0 +1,405 @@
+/**
+ * inbound/cli/run-command — `device-agent run --task "..." ...`
+ *
+ * One-shot CLI driver for the v0.3.0 Plan-Act runtime: connects to a
+ * sibling `device-mcp-server` over HTTP, talks to an OpenAI-compatible
+ * endpoint (default ARouter / AutoGLM-Phone-9B), and runs a single task
+ * to completion. Streams structured progress to stdout.
+ *
+ * This bypasses the ACP/Bridge bootstrap entirely — for that, use plain
+ * `device-agent` without the `run` sub-command.
+ *
+ * Design contract:
+ *  - `--plan auto` (default): Hybrid strategy in `AgentRunner`. Long
+ *    tasks (≥30 chars) start with `LLMPlanner` + `PlanExecutor`; short
+ *    tasks start with pure `AgentLoop` and escalate to Plan-Act when
+ *    they burn through `1/3 * maxSteps`.
+ *  - `--plan always`: skip the heuristic, always plan.
+ *  - `--plan never`: skip the planner entirely (pure ReAct).
+ *  - `--planner-model` defaults to `glm-4-flash` (cheap chat-only model
+ *    on ARouter).
+ */
+import { McpClient, resolveDefaultMcpUrl } from "../../mcp-client/client.js";
+import { FleetStatusClient, FleetClientError } from "../../fleet/http/status-client.js";
+import { OpenAIClient } from "../../model/client.js";
+import { AgentRunner, LLMPlanner, OpenAIAdapter, } from "../../agent-runtime/index.js";
+/** Side-effect: registers the `autoglm` ModelAdapter (and friends). */
+import "../../model/adapters/autoglm.js";
+const DEFAULT_BASE_URL = "https://autoglm-mobile-9b.arouter.ai/v1";
+const DEFAULT_MODEL = "autoglm-phone-9b";
+const DEFAULT_PLANNER_MODEL = "glm-4-flash";
+export function parseRunArgs(argv) {
+    const out = {};
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        const next = () => {
+            const v = argv[++i];
+            if (v === undefined)
+                throw new Error(`Missing value for ${a}`);
+            return v;
+        };
+        switch (a) {
+            case "-h":
+            case "--help":
+                out.help = true;
+                break;
+            case "--task":
+                out.task = next();
+                break;
+            case "--mcp":
+            case "--mcp-url":
+                out.mcp = next();
+                break;
+            case "--device":
+                out.device = next();
+                break;
+            case "--model":
+                out.model = next();
+                break;
+            case "--base-url":
+                out.baseUrl = next();
+                break;
+            case "--api-key":
+                out.apiKey = next();
+                break;
+            case "--plan": {
+                const v = next();
+                if (v !== "auto" && v !== "always" && v !== "never") {
+                    throw new Error(`--plan must be one of: auto | always | never (got "${v}")`);
+                }
+                out.plan = v;
+                break;
+            }
+            case "--planner-model":
+                out.plannerModel = next();
+                break;
+            case "--planner-base-url":
+                out.plannerBaseUrl = next();
+                break;
+            case "--planner-api-key":
+                out.plannerApiKey = next();
+                break;
+            case "--max-steps":
+                out.maxSteps = Number(next());
+                if (!Number.isFinite(out.maxSteps) || out.maxSteps <= 0) {
+                    throw new Error(`--max-steps must be a positive integer`);
+                }
+                break;
+            case "--timeout":
+                out.timeoutMs = parseTimeoutToMs(next());
+                break;
+            case "--env": {
+                const v = next();
+                if (v !== "mobile" && v !== "computer" && v !== "browser") {
+                    throw new Error(`--env must be one of: mobile | computer | browser`);
+                }
+                out.env = v;
+                break;
+            }
+            case "--lang": {
+                const v = next();
+                if (v !== "cn" && v !== "en")
+                    throw new Error(`--lang must be cn or en`);
+                out.lang = v;
+                break;
+            }
+            case "--json":
+                out.json = true;
+                break;
+            default:
+                if (a.startsWith("--")) {
+                    throw new Error(`device-agent run: unknown flag "${a}"`);
+                }
+                break;
+        }
+    }
+    return out;
+}
+/** Accepts: `30000`, `30s`, `5m`, `2h`, plain numbers (ms). */
+export function parseTimeoutToMs(raw) {
+    const m = raw.trim().toLowerCase().match(/^(\d+(?:\.\d+)?)(ms|s|m|h)?$/);
+    if (!m)
+        throw new Error(`--timeout: invalid duration "${raw}"`);
+    const n = Number(m[1]);
+    switch (m[2]) {
+        case undefined:
+        case "ms":
+            return n;
+        case "s":
+            return n * 1_000;
+        case "m":
+            return n * 60_000;
+        case "h":
+            return n * 3_600_000;
+        default:
+            throw new Error(`--timeout: unsupported unit "${m[2]}"`);
+    }
+}
+export function printRunUsage(out = process.stdout) {
+    out.write(`device-agent run — one-shot Plan-Act runner
+
+Usage:
+  device-agent run --task "..." [options]
+
+Required:
+  --task <text>            Task description for the agent.
+
+Common:
+  --mcp <url>              device-mcp-server HTTP base (default: $MCP_URL or http://127.0.0.1:7900)
+  --device <serial|name>   Resolve mcp URL via the running fleet supervisor (loopback :7950)
+  --model <name>           VLM model name (default: ${DEFAULT_MODEL})
+  --base-url <url>         OpenAI-compatible endpoint (default: ${DEFAULT_BASE_URL})
+  --api-key <key>          API key (default: $AROUTER_API_KEY or $GUI_AGENT_API_KEY)
+  --env <mobile|computer|browser>          Observation env (default: mobile)
+  --lang <cn|en>           System-prompt language (default: cn)
+
+Plan-Act:
+  --plan <auto|always|never>   Plan strategy (default: auto)
+  --planner-model <name>       Chat-only model for the planner (default: ${DEFAULT_PLANNER_MODEL})
+  --planner-base-url <url>     Override planner endpoint
+  --planner-api-key <key>      Override planner API key
+
+Limits:
+  --max-steps <n>          Step budget (default: 30)
+  --timeout <30s|5m|...>   Wall-clock timeout (default: 5m)
+
+Output:
+  --json                   Emit one structured JSON line per event (NDJSON)
+  -h, --help               Show this help
+
+Example:
+  AROUTER_API_KEY=xxx device-agent run \\
+    --task "打开微信，发一条朋友圈，内容：「Hello from BeeOS device-agent v0.3.0」" \\
+    --mcp http://127.0.0.1:7900 --model autoglm-phone-9b \\
+    --base-url https://autoglm-mobile-9b.arouter.ai/v1 --plan auto
+`);
+}
+export async function runCommand(argv, io = {}, deps = {}) {
+    const stdout = io.stdout ?? process.stdout;
+    const stderr = io.stderr ?? process.stderr;
+    let flags;
+    try {
+        flags = parseRunArgs(argv);
+    }
+    catch (e) {
+        stderr.write(`device-agent run: ${e.message}\n`);
+        return 2;
+    }
+    if (flags.help) {
+        printRunUsage(stdout);
+        return 0;
+    }
+    if (!flags.task || flags.task.trim().length === 0) {
+        stderr.write(`device-agent run: --task is required\n`);
+        printRunUsage(stdout);
+        return 2;
+    }
+    // ── Resolve config ────────────────────────────────────────────────────
+    let mcpUrl;
+    if (flags.mcp) {
+        mcpUrl = flags.mcp;
+    }
+    else if (flags.device) {
+        // --device pixel-7 → ask the running fleet supervisor for the
+        // matching mcp URL. We deliberately do NOT auto-spawn the fleet here
+        // (that's a deployment decision), but we DO surface a clear hint
+        // when the supervisor isn't running.
+        try {
+            mcpUrl = await resolveDeviceMcpUrl(flags.device);
+        }
+        catch (e) {
+            stderr.write(`device-agent run: ${e.message}\n`);
+            return 2;
+        }
+    }
+    else {
+        mcpUrl = resolveDefaultMcpUrl();
+    }
+    const modelName = flags.model ?? DEFAULT_MODEL;
+    const baseUrl = flags.baseUrl ?? process.env.GUI_AGENT_BASE_URL ?? DEFAULT_BASE_URL;
+    const apiKey = flags.apiKey ??
+        process.env.AROUTER_API_KEY ??
+        process.env.GUI_AGENT_API_KEY ??
+        process.env.OPENAI_API_KEY ??
+        "EMPTY";
+    const planMode = flags.plan ?? "auto";
+    const plannerModel = flags.plannerModel ?? process.env.PLANNER_MODEL ?? DEFAULT_PLANNER_MODEL;
+    const plannerBaseUrl = flags.plannerBaseUrl ?? process.env.PLANNER_BASE_URL ?? baseUrl;
+    const plannerApiKey = flags.plannerApiKey ?? process.env.PLANNER_API_KEY ?? apiKey;
+    const maxSteps = flags.maxSteps ?? 30;
+    const timeoutMs = flags.timeoutMs ?? 5 * 60 * 1000;
+    const env = flags.env ?? "mobile";
+    const lang = flags.lang ?? "cn";
+    const useJson = flags.json ?? false;
+    const emit = (event) => {
+        if (useJson) {
+            stdout.write(`${JSON.stringify(event)}\n`);
+        }
+        else {
+            stdout.write(formatHuman(event));
+        }
+    };
+    emit({
+        event: "start",
+        task: flags.task,
+        mcpUrl,
+        modelName,
+        baseUrl,
+        planMode,
+        plannerModel: planMode === "never" ? null : plannerModel,
+        maxSteps,
+        timeoutMs,
+        env,
+        lang,
+    });
+    // ── Wire MCP ─────────────────────────────────────────────────────────
+    const mcp = deps.mcpFactory?.(mcpUrl) ??
+        new McpClient({ baseUrl: mcpUrl });
+    try {
+        if (typeof mcp.waitUntilReady === "function") {
+            await mcp.waitUntilReady({ attempts: 10, attemptDelayMs: 500 });
+        }
+        emit({ event: "mcp_ready", mcpUrl });
+    }
+    catch (e) {
+        emit({ event: "fatal", scope: "mcp_unreachable", message: e.message });
+        return 1;
+    }
+    // ── Wire model + adapter ─────────────────────────────────────────────
+    const modelClient = deps.modelClientFactory?.({ baseUrl, apiKey, modelName }) ??
+        new OpenAIClient({ baseUrl, apiKey, modelName });
+    const adapter = new OpenAIAdapter({
+        client: modelClient,
+        lang,
+    });
+    emit({ event: "model_ready", modelName: modelClient.modelName, adapter: modelClient.adapterName });
+    // ── Wire planner ─────────────────────────────────────────────────────
+    let planner;
+    if (planMode !== "never") {
+        planner =
+            deps.plannerFactory?.({
+                baseUrl: plannerBaseUrl,
+                apiKey: plannerApiKey,
+                modelName: plannerModel,
+            }) ??
+                new LLMPlanner({
+                    baseUrl: plannerBaseUrl,
+                    apiKey: plannerApiKey,
+                    modelName: plannerModel,
+                });
+        if (planner)
+            emit({ event: "planner_ready", plannerModel, plannerName: planner.name });
+    }
+    // ── Build runner ─────────────────────────────────────────────────────
+    const runnerCtor = deps.runnerFactory ?? ((opts) => new AgentRunner(opts));
+    const runner = runnerCtor({
+        task: flags.task,
+        env,
+        mcp: mcp,
+        adapter,
+        planner: planner,
+        mode: planMode,
+        maxSteps,
+        timeoutMs,
+        hooks: {
+            onStep: (step) => {
+                emit({
+                    event: "step",
+                    index: step.index,
+                    rationale: shortRationale(step.rationale),
+                    action: step.action.type,
+                    target: step.action.target,
+                    finished: step.finished,
+                });
+            },
+            onTool: (tool) => {
+                emit({
+                    event: "tool",
+                    name: tool.name,
+                    durationMs: tool.durationMs,
+                });
+            },
+            onError: (err) => {
+                emit({ event: "error", code: err.code, message: err.message, fatal: err.fatal });
+            },
+        },
+    });
+    // ── Run + finish ─────────────────────────────────────────────────────
+    let result;
+    try {
+        result = await runner.run();
+    }
+    catch (e) {
+        emit({ event: "fatal", scope: "runner", message: e.message });
+        return 1;
+    }
+    emit({
+        event: "done",
+        ok: result.ok,
+        mode: result.mode,
+        terminator: result.terminator,
+        steps: result.steps,
+        finalText: result.finalText,
+        plansEmitted: result.plansEmitted,
+        replans: result.replans,
+        reactFallbackUsed: result.reactFallbackUsed,
+        usage: result.usage,
+    });
+    return result.ok ? 0 : 1;
+}
+/* -------------------------------------------------------------------------- */
+/* helpers                                                                    */
+/* -------------------------------------------------------------------------- */
+async function resolveDeviceMcpUrl(target) {
+    const client = new FleetStatusClient();
+    let devices;
+    try {
+        devices = await client.listDevices();
+    }
+    catch (e) {
+        if (e instanceof FleetClientError) {
+            throw new Error(`--device requires a running fleet supervisor. ${e.message}`);
+        }
+        throw e;
+    }
+    const match = devices.find((d) => d.serial === target || d.name === target);
+    if (!match) {
+        throw new Error(`--device: no device matches '${target}'. Run \`device-agent fleet devices\` to see available targets.`);
+    }
+    if (!match.mcpUrl) {
+        throw new Error(`--device: device '${target}' is in state '${match.state}' and has no mcp endpoint yet. Wait for it to reach 'healthy'.`);
+    }
+    return match.mcpUrl;
+}
+function shortRationale(s) {
+    if (!s)
+        return undefined;
+    const trimmed = s.trim();
+    return trimmed.length > 200 ? `${trimmed.slice(0, 197)}...` : trimmed;
+}
+function formatHuman(ev) {
+    const tag = String(ev.event ?? "?").toUpperCase();
+    switch (ev.event) {
+        case "start":
+            return `[${tag}] task=${JSON.stringify(ev.task)} mcp=${ev.mcpUrl} model=${ev.modelName} plan=${ev.planMode} steps<=${ev.maxSteps} t<=${ev.timeoutMs}ms\n`;
+        case "mcp_ready":
+            return `[${tag}] connected to ${ev.mcpUrl}\n`;
+        case "model_ready":
+            return `[${tag}] model=${ev.modelName} adapter=${ev.adapter}\n`;
+        case "planner_ready":
+            return `[${tag}] planner=${ev.plannerName} model=${ev.plannerModel}\n`;
+        case "step":
+            return `[${tag} ${String(ev.index).padStart(2, " ")}] action=${ev.action} ${ev.rationale ?? ""}\n`;
+        case "tool":
+            return `[${tag}] ${ev.name} (${ev.durationMs}ms)\n`;
+        case "error":
+            return `[${tag}] ${ev.code}: ${ev.message}${ev.fatal ? " (fatal)" : ""}\n`;
+        case "fatal":
+            return `[${tag}] ${ev.scope}: ${ev.message}\n`;
+        case "done":
+            return `[${tag}] ok=${ev.ok} mode=${ev.mode} term=${ev.terminator} steps=${ev.steps} text=${JSON.stringify(ev.finalText)}\n`;
+        default:
+            return `[${tag}] ${JSON.stringify(ev)}\n`;
+    }
+}
+//# sourceMappingURL=run-command.js.map

package/dist/inbound/cli/run-command.js.map

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

package/dist/inbound/cli/skills-command.d.ts

@@ -0,0 +1,39 @@
+/**
+ * inbound/cli/skills-command — `device-agent skills <subcmd>`.
+ *
+ * Phase 3.4 of the [device-agent reflector upgrade plan](../../../../../../.cursor/plans/device-agent-reflector-skills_d5599350.plan.md),
+ * upgraded to the FileSystem-backed cache layout described in
+ * [skill-cache-fs-backend](../../../../../../.cursor/plans/skill-cache-fs-backend_0191f2c7.plan.md).
+ *
+ * Subcommands:
+ *   list                     List all cached skills (default sorting: newest first).
+ *   inspect <id>             Print full row for a single skill, including action sequence.
+ *   forget <id> | --all      Delete a skill, or wipe the entire cache.
+ *   import <file.json>       Bulk-load skills exported by another store.
+ *   export [<file.json>]     Dump every skill row as JSON (defaults to stdout).
+ *
+ * The store is opened against the directory `~/.beeos/device-agent/skills/`
+ * unless `SKILL_CACHE_PATH` (or `--root <dir>`) overrides it. All output
+ * is text-friendly by default; pass `--json` for machine consumption.
+ *
+ * `--db <path>` is accepted as a deprecated alias for `--root` so old
+ * scripts keep working through one minor release.
+ */
+import { type SkillCacheStore } from "../../agent-runtime/skills/index.js";
+export interface SkillsCommandIO {
+    stdout?: {
+        write: (s: string) => void;
+    };
+    stderr?: {
+        write: (s: string) => void;
+    };
+    /** Allows tests to inject an in-memory store. */
+    openStore?: (flags: {
+        root?: string;
+    }) => SkillCacheStore;
+    fs?: {
+        writeFileSync: (p: string, c: string) => void;
+        readFileSync: (p: string, enc: BufferEncoding) => string;
+    };
+}
+export declare function skillsCommand(argv: string[], io?: SkillsCommandIO): Promise<number>;