@beeos-ai/device-agent 0.4.0

package/dist/app/session-manager.js

@@ -0,0 +1,350 @@
+/**
+ * Application use case — SessionManager.
+ *
+ * Owns ACP session lifecycle (new/load/list/rename/delete/clear) and the
+ * dispatch of `session/prompt` to the underlying `AgentHost`. Streaming
+ * `session/update` envelopes are produced by translating `AgentEvent`s
+ * received from the host bus.
+ *
+ * SessionManager itself is protocol-agnostic w.r.t. the agent core — it
+ * speaks `AgentHost` only. The translation of host events into ACP
+ * envelopes lives here so swapping `IAgentCore` (single-layer / pi
+ * orchestrator / mock) doesn't change ACP semantics.
+ *
+ * Surface mirrors the Python `SessionHandler` so ACP handlers remain
+ * thin pass-throughs.
+ */
+import { randomUUID } from "node:crypto";
+import { newSession } from "../core/session.js";
+import { MessageStore } from "./message-store.js";
+export class SessionManager {
+    host;
+    store;
+    notifier;
+    onSetModel;
+    maxSessions;
+    sessionTtlMs;
+    sessions = new Map();
+    /** taskId → sessionId for routing host events to the right ACP session. */
+    taskToSession = new Map();
+    activeSessionId = null;
+    currentTask = null;
+    unsubscribe = null;
+    constructor(opts) {
+        this.host = opts.host;
+        this.store = opts.messageStore ?? new MessageStore();
+        this.notifier = opts.notifier;
+        this.onSetModel = opts.onSetModel;
+        this.maxSessions = opts.maxSessions ?? 50;
+        this.sessionTtlMs = opts.sessionTtlMs ?? 60 * 60 * 1000;
+        this.unsubscribe = this.host.on((ev) => this.handleHostEvent(ev));
+    }
+    /** Detach from the host bus (used when shutting down the ACP plugin). */
+    detach() {
+        if (this.unsubscribe) {
+            this.unsubscribe();
+            this.unsubscribe = null;
+        }
+    }
+    // ── ACP semantics — name mirrors Python SessionHandler ───────────────────
+    newSession() {
+        this.evictExpired();
+        const id = randomUUID();
+        this.sessions.set(id, newSession(id));
+        this.activeSessionId = id;
+        this.store.upsertSession(id);
+        return { sessionId: id };
+    }
+    loadSession(sessionId) {
+        let id = sessionId;
+        const known = this.sessions.has(id) || this.store.sessionExists(id);
+        if (!known)
+            id = randomUUID();
+        if (!this.sessions.has(id))
+            this.sessions.set(id, newSession(id));
+        const s = this.sessions.get(id);
+        s.lastActive = Date.now();
+        this.activeSessionId = id;
+        this.store.upsertSession(id);
+        return { sessionId: id, history: this.store.getMessagesAsDicts(id, 50) };
+    }
+    listSessions() {
+        this.evictExpired();
+        return { sessions: this.store.listSessions(50) };
+    }
+    renameSession(sessionId, title) {
+        const s = this.sessions.get(sessionId);
+        if (s) {
+            s.title = title || s.title;
+            s.lastActive = Date.now();
+        }
+        if (title)
+            this.store.renameSession(sessionId, title);
+        return { sessionId, title };
+    }
+    deleteSession(sessionId) {
+        const had = this.sessions.has(sessionId);
+        this.sessions.delete(sessionId);
+        if (this.activeSessionId === sessionId)
+            this.activeSessionId = null;
+        this.store.deleteSession(sessionId);
+        return { deleted: had };
+    }
+    clearSession(sessionId) {
+        const s = this.sessions.get(sessionId);
+        if (s) {
+            s.history = [];
+            s.lastActive = Date.now();
+        }
+        this.store.clearSession(sessionId);
+        return { cleared: !!s };
+    }
+    setMode(sessionId, mode) {
+        return { sessionId, mode };
+    }
+    async setModel(sessionId, model, provider = "") {
+        if (!model)
+            throw new Error("model is required");
+        if (this.onSetModel)
+            await this.onSetModel(provider, model);
+        return { sessionId, provider, model };
+    }
+    /**
+     * Run a prompt to completion and return the ACP `stopReason`.
+     *
+     * Streams `session/update` notifications during execution (translated
+     * from `AgentHost` events).
+     */
+    async prompt(rawPrompt, sessionIdHint) {
+        const prompt = normalizePrompt(rawPrompt);
+        if (!prompt)
+            throw new Error("prompt is required");
+        const session = this.resolveSession(sessionIdHint);
+        session.lastActive = Date.now();
+        session.history.push({ role: "user", content: prompt, createdAt: session.lastActive });
+        this.store.addMessage(session.id, "user", prompt, "text");
+        this.activeSessionId = session.id;
+        this.notify(session.id, { sessionUpdate: "agent_status", status: "running" });
+        const submitted = this.host.submitTask(prompt, { correlationTag: session.id });
+        this.taskToSession.set(submitted.taskId, session.id);
+        this.currentTask = submitted;
+        session.currentTaskId = submitted.taskId;
+        let result;
+        try {
+            result = await submitted.done;
+        }
+        finally {
+            this.currentTask = null;
+            session.currentTaskId = null;
+            this.taskToSession.delete(submitted.taskId);
+            this.notify(session.id, { sessionUpdate: "agent_status", status: "idle" });
+        }
+        return { stopReason: result.cancelled ? "cancelled" : "end_turn" };
+    }
+    /** Cancel the in-flight task for the active session, if any. */
+    async cancel() {
+        if (!this.currentTask)
+            return false;
+        return this.currentTask.cancel();
+    }
+    // ── Internal ──────────────────────────────────────────────────────────────
+    /**
+     * Translate host `AgentEvent`s into ACP `session/update` envelopes.
+     *
+     * Handles five legitimate ACP-emitting sources plus structural events:
+     *   - `task:text`      — streamed user-visible reply (agent_message_chunk)
+     *   - `task:reasoning` — streaming "thinking" delta (agent_thought_chunk):
+     *                        planner plan/replan descriptions and per-step
+     *                        VLM rationale.
+     *   - `task:tool`      — start / end pairs (tool_call / tool_call_update)
+     *   - `task:notice`    — out-of-band protocol notice. level=warn
+     *                        (transient retry hints) is dropped — noise
+     *                        the user can't act on. level=error (terminal
+     *                        failure) becomes a `system_message_chunk`
+     *                        with `metadata.kind = "agent_notice"`; the
+     *                        web client merges it into the matching
+     *                        assistant bubble's footer. NOT persisted.
+     *   - `task:step`      — structural step record (no ACP emission, kept
+     *                        for HTTP debug / future plugins).
+     *
+     * Every emitted envelope carries `_turnId` (groups all chunks of a
+     * single user prompt) and `messageId` (the per-task authoritative id
+     * shared by every chunk / thought / tool / notice in this turn). The
+     * web `chat-store` sidecar resolver pins thoughts and tool calls to
+     * the assistant bubble bearing the matching `_messageId`.
+     *
+     * Events for tasks not owned by this SessionManager are ignored —
+     * other plugins (HTTP debug, custom) may submit tasks through the
+     * same host bus.
+     */
+    handleHostEvent(ev) {
+        const sessionId = this.taskToSession.get(ev.taskId);
+        if (!sessionId)
+            return;
+        if (ev.type === "task:text") {
+            if (!ev.text)
+                return;
+            this.notify(sessionId, {
+                sessionUpdate: "agent_message_chunk",
+                content: { type: "text", text: ev.text },
+                _turnId: ev.turnId,
+                messageId: ev.messageId,
+            });
+            this.store.addMessage(sessionId, "assistant", ev.text, "text");
+            return;
+        }
+        if (ev.type === "task:reasoning") {
+            // Reasoning / thinking deltas (planner plan descriptions + per-step
+            // VLM rationale) flow through the dedicated `agent_thought_chunk`
+            // ACP channel so the web UI can render them in the reasoning side
+            // panel without polluting the main conversation. We intentionally
+            // do NOT persist reasoning text into MessageStore — it would bloat
+            // the LLM context window on resume and is purely a presentation
+            // signal.
+            if (!ev.text)
+                return;
+            this.notify(sessionId, {
+                sessionUpdate: "agent_thought_chunk",
+                content: { type: "text", text: ev.text },
+                _turnId: ev.turnId,
+                messageId: ev.messageId,
+            });
+            return;
+        }
+        if (ev.type === "task:tool") {
+            const t = ev.tool;
+            if (t.status === "start") {
+                this.notify(sessionId, {
+                    sessionUpdate: "tool_call",
+                    toolCallId: t.id,
+                    title: t.name,
+                    arguments: JSON.stringify(t.args),
+                    status: "in_progress",
+                    _turnId: ev.turnId,
+                    messageId: ev.messageId,
+                });
+                this.store.addMessage(sessionId, "assistant", t.name, "tool_call", {
+                    toolCallId: t.id,
+                    parameters: t.args,
+                });
+            }
+            else if (t.status === "end") {
+                const status = t.isError ? "failed" : "completed";
+                const output = typeof t.result === "string" ? t.result : JSON.stringify(t.result ?? "");
+                this.notify(sessionId, {
+                    sessionUpdate: "tool_call_update",
+                    toolCallId: t.id,
+                    status,
+                    output: output || `${t.name} ${status}`,
+                    _turnId: ev.turnId,
+                    messageId: ev.messageId,
+                });
+                this.store.addMessage(sessionId, "assistant", output || `${t.name} ${status}`, "tool_result", { toolCallId: t.id, status });
+            }
+            return;
+        }
+        if (ev.type === "task:notice") {
+            // Ephemeral protocol notice. Two flavours:
+            //   - level=warn : transient retry hint ("Model temporarily
+            //     unavailable, retrying…"). User can't act on it; if the
+            //     retry succeeds the message is meaningless, and if it
+            //     ultimately fails the level=error notice will fire anyway.
+            //     We DROP it on the floor for the UI — agent-host already
+            //     logged it via pino, and HTTP debug listeners receive the
+            //     raw `task:notice` event independent of this ACP path.
+            //   - level=error: terminal failure ("Task failed: …"). We
+            //     translate to `system_message_chunk` carrying
+            //     `metadata.kind = "agent_notice"`. The web client recognises
+            //     this kind and merges the notice into the matching
+            //     assistant bubble's `metadata.notices` (correlated by
+            //     `_turnId`), so the user sees a small inline footer line
+            //     instead of a centered gray capsule. Older clients that
+            //     don't know `agent_notice` still render it as a plain
+            //     system message — the kind tag is purely additive.
+            //
+            // Intentionally NOT written to MessageStore — replaying retry
+            // hints / terminal-failure capsules on session resume would
+            // bloat the LLM context with stale degraded-state signals. We
+            // forward `_turnId` for ordering / merge correlation but DROP
+            // `messageId` because chat-store's sidecar resolver would
+            // otherwise still try to merge a system row with assistant
+            // rows sharing that id.
+            if (ev.level === "warn")
+                return;
+            if (!ev.text)
+                return;
+            this.notify(sessionId, {
+                sessionUpdate: "system_message_chunk",
+                content: { type: "text", text: ev.text },
+                _turnId: ev.turnId,
+                metadata: { kind: "agent_notice", level: ev.level },
+            });
+            return;
+        }
+        if (ev.type === "task:step") {
+            // `task:step` is a structural event (`{ stepIndex, action, finished,
+            // message }`) consumed by HTTP debug / future plugins. Per-step
+            // rationale is now delivered via `task:reasoning` →
+            // `agent_thought_chunk` (see above), so we no longer mis-emit
+            // `step.thinking` as `agent_message_chunk` here — that double-fire
+            // was leaking VLM rationale into the user-visible reply.
+            return;
+        }
+        if (ev.type === "task:end") {
+            const status = ev.error ? "failed" : ev.result.cancelled ? "cancelled" : "completed";
+            this.store.addMessage(sessionId, "system", `Task ${status}`, "status", {
+                taskId: ev.taskId,
+                status,
+            });
+        }
+    }
+    resolveSession(idHint) {
+        if (idHint && this.sessions.has(idHint))
+            return this.sessions.get(idHint);
+        if (idHint && this.store.sessionExists(idHint)) {
+            this.sessions.set(idHint, newSession(idHint));
+            return this.sessions.get(idHint);
+        }
+        if (this.activeSessionId && this.sessions.has(this.activeSessionId)) {
+            return this.sessions.get(this.activeSessionId);
+        }
+        const { sessionId } = this.newSession();
+        return this.sessions.get(sessionId);
+    }
+    notify(sessionId, update) {
+        if (!this.notifier)
+            return;
+        this.notifier.send(sessionId, update);
+    }
+    evictExpired() {
+        const now = Date.now();
+        for (const [id, s] of this.sessions) {
+            if (now - s.lastActive > this.sessionTtlMs) {
+                this.sessions.delete(id);
+                this.store.deleteSession(id);
+                if (this.activeSessionId === id)
+                    this.activeSessionId = null;
+            }
+        }
+        if (this.sessions.size > this.maxSessions) {
+            const sorted = Array.from(this.sessions.entries()).sort((a, b) => a[1].lastActive - b[1].lastActive);
+            for (let i = 0; i < sorted.length - this.maxSessions; i++) {
+                const [id] = sorted[i];
+                this.sessions.delete(id);
+                this.store.deleteSession(id);
+                if (this.activeSessionId === id)
+                    this.activeSessionId = null;
+            }
+        }
+    }
+}
+function normalizePrompt(raw) {
+    if (typeof raw === "string")
+        return raw.trim();
+    return raw
+        .filter((b) => b && b.type === "text" && typeof b.text === "string")
+        .map((b) => b.text)
+        .join("\n")
+        .trim();
+}
+//# sourceMappingURL=session-manager.js.map

package/dist/app/session-manager.js.map

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

package/dist/bootstrap.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Bootstrap — wire up the agent core, host, and plugins.
+ *
+ * High-level flow:
+ *
+ *   1. Load identity (Ed25519 keypair on disk).
+ *   2. Discover Bridge URL via Agent Gateway (when not standalone).
+ *   3. Build the device adapter (`IDevice`) and a `DeviceManager`.
+ *   4. Build the agent core (v0.3.0 default = AgentRunner Hybrid Plan-Act):
+ *        - default            → `AgentRunnerCore`
+ *          (one shared `AgentRunner` driving the new agent-runtime
+ *          `AgentLoop` + optional `LLMPlanner` via OpenAI-compat client.
+ *          Wired to the AutoGLM-Phone family via the `OpenAIAdapter`
+ *          adapter registry pattern.)
+ *        - `legacyInner: true` → `InnerLoopAgent` over `InnerLoopVlm`
+ *          (single-layer fallback; opt-in)
+ *        - `pi: true`          → `PiOrchestratorAgent`
+ *          (outer text LLM + inner mobile_use VLM; opt-in)
+ *   5. Construct `AgentHostImpl` around the agent.
+ *   6. Register plugins in this order: agent-sync, http-debug, acp.
+ *      The acp plugin is started LAST so the bridge connection only opens
+ *      after agent-sync has registered the device-agent in the platform's
+ *      Agents directory.
+ *   7. Run `init()` on every plugin sequentially, then `start()`.
+ *   8. Return a `stop()` function that tears down plugins in reverse order.
+ *
+ * Custom callers (tests, EdgeAgent embeds, alternate CLIs) can call
+ * `bootstrap()` directly with a custom plugin list to compose the agent
+ * however they want — every behavior beyond the core (HTTP, ACP, sync,
+ * any future skill plugin) is opt-in.
+ */
+import { type Logger } from "./logger/index.js";
+import { type CliFlags } from "./config/loader.js";
+import type { Config } from "./config/schema.js";
+import { type AgentDeclarationInput } from "./adapters/agent-gateway-client.js";
+import { DeviceManager } from "./app/device-manager.js";
+import { McpClient } from "./mcp-client/index.js";
+import type { IAgentCore } from "./ports/agent-core.js";
+import type { IDevice } from "./ports/device.js";
+import type { IDeviceIdentity } from "./ports/identity.js";
+import type { AgentHost } from "./ports/agent-host.js";
+import type { AgentPlugin } from "./ports/plugin.js";
+export interface BootstrapOptions {
+    /** Pre-parsed CLI flags. Defaults to `{}` (env + config file only). */
+    flags?: CliFlags;
+    /** Override the resolved config (after merging flags / env / file). */
+    configOverride?: Partial<Config>;
+    /** Inject a custom logger. */
+    logger?: Logger;
+    /** Inject a custom agent core (e.g. for tests / experimental adapters). */
+    agentOverride?: IAgentCore;
+    /** Inject a custom device. Useful for tests. */
+    deviceOverride?: IDevice;
+    /**
+     * Replace the default plugin list. When omitted, bootstrap registers
+     * agent-sync + http-debug + acp using the loaded config. Pass `[]` to
+     * run a barebones agent (host + core only).
+     */
+    pluginsOverride?: AgentPlugin[];
+    /** Version string surfaced in agent-sync declarations. */
+    version?: string;
+    /**
+     * Custom AgentDeclaration builder. Defaults to a device-agent default
+     * matching the legacy `main.ts` declaration.
+     */
+    buildDeclarations?: (info: {
+        name?: string;
+        type?: string;
+    } | null) => AgentDeclarationInput[];
+}
+export interface BootstrappedAgent {
+    config: Config;
+    host: AgentHost;
+    devices: DeviceManager;
+    identity: IDeviceIdentity;
+    plugins: AgentPlugin[];
+    /**
+     * Optional handle to the sibling device-mcp-server, present when
+     * `config.mcpUrl` was set and the readiness probe succeeded. Subsequent
+     * tasks (acp_plugin / pi_orchestrator) wire this through to the runtime.
+     */
+    mcp?: McpClient;
+    /**
+     * Tear-down function — stops every plugin in REVERSE registration
+     * order, then disconnects all devices. Safe to call multiple times.
+     */
+    stop: () => Promise<void>;
+}
+export declare function bootstrap(opts?: BootstrapOptions): Promise<BootstrappedAgent>;
+export declare class BootstrapError extends Error {
+    readonly exitCode: number;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(message: string, exitCode: number, details?: Record<string, unknown> | undefined);
+}