@beeos-ai/device-agent 0.4.0

package/dist/adapters/agentcore-pi.js

@@ -0,0 +1,464 @@
+/**
+ * Adapter — PiOrchestratorAgent (two-layer outer orchestrator).
+ *
+ * Wraps `@mariozechner/pi-coding-agent`'s `AgentSession` so it can be
+ * plugged into the `IAgentCore` slot. The outer layer is the LLM that
+ * pi drives; the inner layer is whatever extensions are loaded from
+ * `<projectRoot>/.pi/extensions/` (e.g. `mobile_use`, `ground`,
+ * `ui_xml`). The adapter is **transport-agnostic** — it only knows about
+ * pi events and `AgentHost` callbacks.
+ *
+ * Key responsibilities:
+ *  - Lazy session bootstrap (extension/skill scanning, model resolution)
+ *    on first `run()` call.
+ *  - Map pi's session events to `IAgentCore` callbacks:
+ *      `message_update / text_delta`  → `onText`
+ *      `tool_execution_start/update/end` → `onTool` (start/update/end)
+ *      `message_end (assistant role)` → captures the final assistant text
+ *  - Translate `setModel(provider, model)` into pi-ai's `getModel()` and
+ *    forward to `session.setModel`. Hot-swap is best-effort — when model
+ *    resolution fails we keep the previous model and surface a warning.
+ *  - Honor `abortSignal` by calling `session.abort()`.
+ *  - Map ARouter / OpenRouter / OpenAI / Anthropic / Google base URLs to
+ *    pi-ai's known provider env vars (e.g. `OPENROUTER_API_KEY`) so
+ *    callers can pass a single `outer.apiKey` without exporting
+ *    provider-specific env names.
+ *
+ * NOT responsibilities:
+ *  - Loading extensions (caller passes the resourceLoader options).
+ *  - Setting up the device — pi extensions read device handles from
+ *    process env / DEVAGENT_HTTP_URL like before.
+ */
+import { formatUiXmlToolOutput } from "../device/ui-xml.js";
+import { setPiExtensionContext, } from "../pi-context.js";
+import { ORCHESTRATOR_SYSTEM_PROMPT } from "../orchestrator-system-prompt.js";
+// ── Adapter ─────────────────────────────────────────────────────────────
+export class PiOrchestratorAgent {
+    session = null;
+    starting = null;
+    outer;
+    projectRoot;
+    systemPrompt;
+    logger;
+    createSessionFactory;
+    resolveModelFn;
+    mcpProvider;
+    grounderFactory;
+    mobileUseRunner;
+    uiXmlRunner;
+    cachedGrounder = null;
+    constructor(opts) {
+        this.projectRoot = opts.projectRoot;
+        this.outer = { ...opts.outer };
+        this.systemPrompt = opts.systemPrompt ?? ORCHESTRATOR_SYSTEM_PROMPT;
+        this.logger = opts.logger ?? {
+            warn: (..._args) => undefined,
+            info: (..._args) => undefined,
+            debug: (..._args) => undefined,
+        };
+        this.createSessionFactory = opts.createSession ?? defaultCreateSession;
+        this.resolveModelFn = opts.resolveModel ?? defaultResolveModel;
+        this.mcpProvider = opts.mcpProvider;
+        this.grounderFactory = opts.grounderFactory;
+        this.mobileUseRunner = opts.mobileUseRunner;
+        this.uiXmlRunner = opts.uiXmlRunner;
+        applyOuterEnvMapping(this.outer);
+    }
+    get modelName() {
+        return this.outer.model ?? "";
+    }
+    get providerName() {
+        const inferred = this.outer.provider || inferPiProvider(this.outer.baseUrl ?? "");
+        return inferred || undefined;
+    }
+    async run(opts) {
+        if (opts.abortSignal?.aborted) {
+            return { finalMessage: "", steps: 0, cancelled: true };
+        }
+        const session = await this.ensureSession();
+        let cancelled = false;
+        let toolCount = 0;
+        let finalText = "";
+        let streamingBuf = "";
+        const dispatchTool = async (event) => {
+            if (opts.onTool)
+                await opts.onTool(event);
+        };
+        const unsubscribe = session.subscribe(async (event) => {
+            switch (event.type) {
+                case "message_start": {
+                    const msg = event.message;
+                    if (msg?.role === "assistant")
+                        streamingBuf = "";
+                    break;
+                }
+                case "message_update": {
+                    const ev = event.assistantMessageEvent;
+                    if (ev?.type === "text_delta" && typeof ev.delta === "string") {
+                        const delta = ev.delta;
+                        streamingBuf += delta;
+                        if (opts.onText)
+                            await opts.onText(delta);
+                    }
+                    break;
+                }
+                case "message_end": {
+                    const msg = event.message;
+                    if (msg?.role === "assistant") {
+                        if (streamingBuf.length > 0)
+                            finalText = streamingBuf;
+                        else {
+                            const fromBlocks = extractAssistantText(msg);
+                            if (fromBlocks)
+                                finalText = fromBlocks;
+                        }
+                    }
+                    break;
+                }
+                case "tool_execution_start": {
+                    toolCount++;
+                    const e = event;
+                    await dispatchTool({
+                        id: String(e.toolCallId ?? `t-${toolCount}`),
+                        name: String(e.toolName ?? "tool"),
+                        args: toRecord(e.args),
+                        status: "start",
+                    });
+                    break;
+                }
+                case "tool_execution_update": {
+                    const e = event;
+                    await dispatchTool({
+                        id: String(e.toolCallId ?? ""),
+                        name: String(e.toolName ?? "tool"),
+                        args: toRecord(e.args),
+                        status: "update",
+                        result: e.partialResult,
+                    });
+                    break;
+                }
+                case "tool_execution_end": {
+                    const e = event;
+                    await dispatchTool({
+                        id: String(e.toolCallId ?? ""),
+                        name: String(e.toolName ?? "tool"),
+                        args: {},
+                        status: "end",
+                        result: e.result,
+                        isError: !!e.isError,
+                    });
+                    break;
+                }
+                default:
+                    break;
+            }
+        });
+        let abortHandler = null;
+        if (opts.abortSignal) {
+            abortHandler = () => {
+                cancelled = true;
+                session.abort().catch(() => undefined);
+            };
+            opts.abortSignal.addEventListener("abort", abortHandler, { once: true });
+        }
+        try {
+            await session.prompt(opts.task);
+        }
+        catch (e) {
+            if (cancelled) {
+                return {
+                    finalMessage: finalText || streamingBuf,
+                    steps: toolCount,
+                    cancelled: true,
+                };
+            }
+            throw e;
+        }
+        finally {
+            if (abortHandler && opts.abortSignal) {
+                opts.abortSignal.removeEventListener("abort", abortHandler);
+            }
+            unsubscribe();
+        }
+        // Fall back to the accumulated streaming buffer when we never saw a
+        // terminal `message_end` for the assistant — this happens when the
+        // upstream session aborts mid-stream, when only non-assistant
+        // messages emit `message_end`, or when pi closes the stream early.
+        const message = finalText || streamingBuf;
+        return { finalMessage: message, steps: toolCount, cancelled };
+    }
+    async setModel(provider, model) {
+        if (!model)
+            return;
+        this.outer = { ...this.outer, provider, model };
+        applyOuterEnvMapping(this.outer);
+        if (!this.session)
+            return;
+        const resolved = this.resolveModelFn(provider, model, this.outer.baseUrl ?? "");
+        if (!resolved) {
+            this.logger.warn?.({ provider, model, baseUrl: this.outer.baseUrl }, "outer model resolution failed — keeping previous model");
+            return;
+        }
+        try {
+            await this.session.setModel(resolved);
+        }
+        catch (e) {
+            this.logger.warn?.({ err: e.message, provider, model }, "session.setModel failed");
+        }
+    }
+    /** Tear down the underlying pi session. Idempotent. */
+    async dispose() {
+        const s = this.session;
+        this.session = null;
+        this.starting = null;
+        this.cachedGrounder = null;
+        setPiExtensionContext(null);
+        if (s) {
+            try {
+                await s.abort();
+            }
+            catch {
+                /* ignore */
+            }
+            try {
+                s.dispose();
+            }
+            catch {
+                /* ignore */
+            }
+        }
+    }
+    // ── Internals ─────────────────────────────────────────────────────────
+    buildExtensionContext() {
+        // The pi extensions hard-fail when their context is missing, but the
+        // test seam (`createSession` injected) often doesn't need the
+        // context at all. Only install one when the bootstrap layer
+        // explicitly handed us an `mcpProvider`.
+        if (!this.mcpProvider)
+            return null;
+        const mcpProvider = this.mcpProvider;
+        const grounderFactory = this.grounderFactory;
+        const mobileUseRunner = this.mobileUseRunner;
+        const uiXmlRunner = this.uiXmlRunner;
+        return {
+            getMcpClient: () => mcpProvider(),
+            getGrounder: () => {
+                if (this.cachedGrounder)
+                    return this.cachedGrounder;
+                if (!grounderFactory) {
+                    throw new Error("PiOrchestratorAgent: ground tool invoked but no grounderFactory was provided");
+                }
+                this.cachedGrounder = grounderFactory();
+                return this.cachedGrounder;
+            },
+            runMobileUse: async (task, maxSteps, abortSignal) => {
+                if (!mobileUseRunner) {
+                    throw new Error("PiOrchestratorAgent: mobile_use tool invoked but no mobileUseRunner was provided");
+                }
+                return mobileUseRunner(task, maxSteps, abortSignal);
+            },
+            getUiXml: async (query) => {
+                if (uiXmlRunner)
+                    return uiXmlRunner(query);
+                // Default: dump the raw UI XML through the MCP runtime and
+                // feed it through `formatUiXmlToolOutput` — same shape the
+                // legacy `queryUiXml(device.raw, query)` produced on top of
+                // the Android driver. Backends that don't support a UI dump
+                // surface a clear "not supported" string so the orchestrator
+                // can fall back to `ground`.
+                const mcp = mcpProvider();
+                const dump = await mcp.uiDump({ format: "raw" });
+                if (!dump.supported) {
+                    return "UI XML is not supported on this backend (use `ground` to locate elements)";
+                }
+                const xml = dump.content ?? "";
+                return formatUiXmlToolOutput(xml, query);
+            },
+        };
+    }
+    ensureSession() {
+        if (this.session)
+            return Promise.resolve(this.session);
+        if (this.starting)
+            return this.starting;
+        const promise = (async () => {
+            // Install the extension context BEFORE the resource loader runs:
+            // pi calls each extension's `default(api)` during `loader.reload()`,
+            // which today only registers tools (no immediate context reads),
+            // but we want the singleton ready in case an extension decides to
+            // pre-warm a device handle.
+            const ctx = this.buildExtensionContext();
+            if (ctx)
+                setPiExtensionContext(ctx);
+            const provider = this.outer.provider || inferPiProvider(this.outer.baseUrl ?? "");
+            const model = this.outer.model
+                ? this.resolveModelFn(provider, this.outer.model, this.outer.baseUrl ?? "")
+                : undefined;
+            const sess = await this.createSessionFactory({
+                projectRoot: this.projectRoot,
+                systemPrompt: this.systemPrompt,
+                model,
+            });
+            this.session = sess;
+            return sess;
+        })();
+        this.starting = promise;
+        // Clear `starting` after settlement so a subsequent failed run can
+        // re-attempt initialisation. On failure, clear the extension context
+        // too so a stale context doesn't survive across retries.
+        promise.then(() => {
+            if (this.starting === promise)
+                this.starting = null;
+        }, () => {
+            if (this.starting === promise)
+                this.starting = null;
+            setPiExtensionContext(null);
+        });
+        return promise;
+    }
+}
+// ── Helpers ────────────────────────────────────────────────────────────
+/**
+ * Map our generic outer config to pi-ai's env-var contract. pi-ai reads
+ * provider-specific keys (e.g. `OPENROUTER_API_KEY`) from `process.env`,
+ * so we transparently set them when the caller hands us `outer.apiKey`
+ * + a recognised baseUrl. Never overwrites a key the caller already set.
+ *
+ * Recognised hosts:
+ *   - openrouter.ai / arouter.ai       → OPENROUTER_API_KEY
+ *   - api.openai.com                   → OPENAI_API_KEY
+ *   - api.anthropic.com                → ANTHROPIC_API_KEY
+ *   - generativelanguage.googleapis.com → GEMINI_API_KEY
+ */
+export function applyOuterEnvMapping(outer) {
+    const key = outer.apiKey;
+    if (!key)
+        return;
+    const provider = (outer.provider || "").toLowerCase();
+    const url = (outer.baseUrl ?? "").toLowerCase();
+    const candidates = [provider, url];
+    const matchesAny = (needles) => candidates.some((c) => needles.some((n) => c.includes(n)));
+    if (matchesAny(["openrouter", "arouter.ai"])) {
+        if (!process.env.OPENROUTER_API_KEY)
+            process.env.OPENROUTER_API_KEY = key;
+    }
+    else if (matchesAny(["anthropic"])) {
+        if (!process.env.ANTHROPIC_API_KEY)
+            process.env.ANTHROPIC_API_KEY = key;
+    }
+    else if (matchesAny(["openai", "api.openai.com"])) {
+        if (!process.env.OPENAI_API_KEY)
+            process.env.OPENAI_API_KEY = key;
+    }
+    else if (matchesAny(["gemini", "generativelanguage.googleapis.com", "google"])) {
+        if (!process.env.GEMINI_API_KEY)
+            process.env.GEMINI_API_KEY = key;
+    }
+}
+/** Infer the pi-ai provider tag from a base URL. */
+export function inferPiProvider(baseUrl) {
+    const url = (baseUrl ?? "").toLowerCase();
+    if (!url)
+        return "";
+    if (url.includes("openrouter.ai") || url.includes("arouter.ai"))
+        return "openrouter";
+    if (url.includes("api.openai.com"))
+        return "openai";
+    if (url.includes("anthropic.com"))
+        return "anthropic";
+    if (url.includes("generativelanguage.googleapis.com"))
+        return "google";
+    return "";
+}
+function toRecord(v) {
+    if (v && typeof v === "object" && !Array.isArray(v))
+        return v;
+    return {};
+}
+function extractAssistantText(message) {
+    if (message.role !== "assistant")
+        return "";
+    const c = message.content;
+    if (typeof c === "string")
+        return c;
+    if (!Array.isArray(c))
+        return "";
+    const parts = [];
+    for (const block of c) {
+        if (block &&
+            typeof block === "object" &&
+            "type" in block &&
+            block.type === "text") {
+            const t = block.text;
+            if (t)
+                parts.push(t);
+        }
+    }
+    return parts.join("");
+}
+// ── Default pi-ai / pi-coding-agent factory ─────────────────────────────
+function defaultResolveModel(provider, modelId, baseUrl) {
+    if (!modelId)
+        return undefined;
+    const piProvider = (provider || inferPiProvider(baseUrl)).toLowerCase();
+    if (!piProvider)
+        return undefined;
+    let model;
+    try {
+        // pi-ai is a peer dep of pi-coding-agent which is already imported by
+        // chat.ts; it's safe to require here. Wrap in try/catch so a missing
+        // optional install doesn't blow up the whole adapter — `legacyInner`
+        // users may opt out.
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const piAi = require("@mariozechner/pi-ai");
+        model = piAi.getModel(piProvider, modelId);
+    }
+    catch {
+        return undefined;
+    }
+    // ARouter is OpenRouter-compatible but lives at a different host. When
+    // the user explicitly pointed `outer.baseUrl` at arouter.ai (or another
+    // OpenRouter-clone), rewrite the resolved model's baseUrl so pi-ai's
+    // upstream HTTP call hits the right endpoint.
+    if (baseUrl && (baseUrl.toLowerCase().includes("arouter.ai") || piProvider === "openrouter")) {
+        const trimmed = baseUrl.replace(/\/$/, "");
+        if (trimmed && !trimmed.includes("openrouter.ai")) {
+            const suffix = trimmed.endsWith("/api/v1") || trimmed.endsWith("/v1") ? "" : "/api/v1";
+            model = { ...model, baseUrl: `${trimmed}${suffix}` };
+        }
+    }
+    return model;
+}
+const defaultCreateSession = async (cfg) => {
+    // Lazy-load to keep the adapter import-safe in environments where
+    // `@mariozechner/pi-coding-agent` isn't installed (e.g. tests using
+    // `legacyInner`).
+    const piAgent = (await import("@mariozechner/pi-coding-agent"));
+    const { createAgentSession, DefaultResourceLoader, getAgentDir } = piAgent;
+    const localSkills = await loadProjectSkillsLoaderOptions(cfg.projectRoot);
+    const loader = new DefaultResourceLoader({
+        cwd: cfg.projectRoot,
+        agentDir: getAgentDir(),
+        ...(cfg.systemPrompt ? { systemPromptOverride: () => cfg.systemPrompt } : {}),
+        ...localSkills,
+    });
+    await loader.reload();
+    const result = await createAgentSession({
+        resourceLoader: loader,
+        ...(cfg.model ? { model: cfg.model } : {}),
+    });
+    return result.session;
+};
+async function loadProjectSkillsLoaderOptions(projectRoot) {
+    try {
+        // The helper lives in the same package — we keep it on disk so the
+        // existing chat.ts CLI keeps working. Lazy-import to avoid a hard
+        // cycle through the public barrel.
+        const mod = (await import("../pi-local-skills.js"));
+        return mod.projectPiSkillsLoaderOptions?.(projectRoot) ?? {};
+    }
+    catch {
+        return {};
+    }
+}
+//# sourceMappingURL=agentcore-pi.js.map

package/dist/adapters/agentcore-pi.js.map

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

package/dist/adapters/agentcore-runner.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Adapter — AgentRunnerCore (v0.3.0 default).
+ *
+ * Wraps the new `AgentRunner` (Hybrid Plan-Act runtime) behind the
+ * legacy `IAgentCore` port so the ACP plugin / `AgentHost` /
+ * `SessionManager` keep working without protocol changes.
+ *
+ * This is the **default** core path as of v0.3.0. The two opt-in
+ * decorators retained from earlier versions are:
+ *   - `--legacy-inner`     → `InnerLoopAgent` (single-layer fallback)
+ *   - (default off)        → `PiOrchestratorAgent` (outer LLM + inner
+ *                            mobile_use VLM, two-layer)
+ *
+ * The runner picks the strategy according to the user-tunable
+ * Plan-Act options:
+ *   - `mode: "auto"` (default) → ReAct for short tasks, Plan-Act for
+ *     long ones, with mid-run replan-fallback when ReAct stalls.
+ *   - `mode: "always"`         → straight Plan-Act
+ *   - `mode: "never"`          → pure ReAct
+ *
+ * Translation contract (IAgentCore → AgentRunner):
+ *   - `opts.task`        → `runner.task`
+ *   - `opts.maxSteps`    → `runner.maxSteps`
+ *   - `opts.abortSignal` → `runner.signal`
+ *   - `opts.onText`      → `runner.hooks.onText`
+ *   - `opts.onReasoning` → `runner.hooks.onReasoning` (planner plan
+ *                          descriptions + per-step VLM rationale; the
+ *                          ACP plugin translates this into
+ *                          `agent_thought_chunk`).
+ *   - `opts.onTool`      → synthesised from `runner.hooks.onTool` /
+ *                          `runner.hooks.onError` (start + end pair).
+ *   - `opts.onStep`      → synthesised from `runner.hooks.onStep`,
+ *                          mapped onto the legacy `VlmStep` shape so
+ *                          ACP `tool_call_update` envelopes keep their
+ *                          historical fields (`thinking`, `action`,
+ *                          `finished`, `message`).
+ */
+import type { AgentCoreRunOptions, AgentCoreRunResult, IAgentCore } from "../ports/agent-core.js";
+import { type AgentPlanMode } from "../agent-runtime/index.js";
+import type { IModelAdapter } from "../agent-runtime/adapters/base.js";
+import type { IPlanner } from "../agent-runtime/planner/base.js";
+import type { IMcpRuntime } from "../mcp-client/runtime.js";
+import type { Observation } from "@beeos-ai/device-common";
+export interface AgentRunnerCoreOptions {
+    mcpProvider: () => IMcpRuntime;
+    /** Already-built adapter (typically `OpenAIAdapter` wrapping AutoGLMPhone). */
+    adapter: IModelAdapter;
+    /** Optional planner. When omitted the runner is pure ReAct. */
+    planner?: IPlanner;
+    /** Plan-mode policy. Defaults to `"auto"`. */
+    mode?: AgentPlanMode;
+    /** Default observation env. Defaults to `"mobile"`. */
+    env?: Observation["env"];
+    /** Default per-task max steps (overridable via `AgentCoreRunOptions.maxSteps`). */
+    defaultMaxSteps?: number;
+    /** Default per-task wall-clock timeout (ms). */
+    defaultTimeoutMs?: number;
+    /** Optional informational tag (e.g. `arouter` / `openrouter`). */
+    providerTag?: string;
+}
+export declare class AgentRunnerCore implements IAgentCore {
+    private readonly opts;
+    private currentModel;
+    private currentProvider;
+    constructor(opts: AgentRunnerCoreOptions);
+    get modelName(): string;
+    get providerName(): string | undefined;
+    run(opts: AgentCoreRunOptions): Promise<AgentCoreRunResult>;
+    setModel(provider: string, model: string): Promise<void>;
+}