@beeos-ai/device-agent 0.5.0 → 0.6.0

package/dist/app/message-store.js

@@ -1,21 +1,38 @@
 /**
- * In-memory MessageStore.
+ * In-memory MessageStore — typed turn-grained transcript log.
  *
- * Mirrors the surface of the Python `MessageStore` (`add_message`,
- * `get_messages_as_dicts`, `list_sessions`, etc.) so the ACP handlers stay
- * byte-for-byte compatible. Persistence is left out of the MVP; `~/.beeos`
- * SQLite can be re-added later behind the same interface (pluggable adapter).
+ * Each session holds an ordered list of `PersistedRecord`s, one per
+ * logical turn:
+ *
+ *  - `user_message` — emitted on `session/prompt` entry.
+ *  - `assistant_turn` — emitted exactly once per `task:end` (replaces
+ *    the legacy "one row per chunk" model that produced fragmented
+ *    transcripts on reload). Carries the full `text`, every tool call
+ *    in invocation order, the stop reason, and an optional terminal
+ *    error string.
+ *
+ * This base class is pure in-memory; persistence is added by
+ * `JsonlMessageStore` which extends this and forwards every mutation
+ * to disk before returning.
+ *
+ * The shape is deliberately aligned with OpenClaw's per-agent JSONL
+ * (`~/.openclaw/agents/<id>/sessions/<sid>.jsonl`) so operational
+ * tooling that already knows that layout works here too.
  */
 import { randomUUID } from "node:crypto";
+/** Schema version. Bumped only on incompatible disk format changes. */
+export const RECORD_SCHEMA_VERSION = 1;
+/** Mutable in-memory message store. */
 export class MessageStore {
-    maxPerSession;
+    maxRecordsPerSession;
     maxSessions;
     sessions = new Map();
-    messages = new Map();
+    records = new Map();
     constructor(opts = {}) {
-        this.maxPerSession = opts.maxMessagesPerSession ?? 100;
+        this.maxRecordsPerSession = opts.maxRecordsPerSession ?? 200;
         this.maxSessions = opts.maxSessions ?? 200;
     }
+    // ── session metadata ─────────────────────────────────────────────────────
     upsertSession(sessionId, title = "New chat") {
         const now = Date.now();
         const cur = this.sessions.get(sessionId);
@@ -31,14 +48,21 @@ export class MessageStore {
     }
     renameSession(sessionId, title) {
         const s = this.sessions.get(sessionId);
-        if (s) {
-            s.title = title;
-            s.updatedAt = Date.now();
-        }
+        if (!s)
+            return;
+        s.title = title;
+        s.updatedAt = Date.now();
     }
     deleteSession(sessionId) {
         this.sessions.delete(sessionId);
-        this.messages.delete(sessionId);
+        this.records.delete(sessionId);
+    }
+    /** Drop every record in a session but keep the session record itself. */
+    clearSession(sessionId) {
+        this.records.delete(sessionId);
+        const s = this.sessions.get(sessionId);
+        if (s)
+            s.updatedAt = Date.now();
     }
     listSessions(limit = 50) {
         const all = Array.from(this.sessions.values())
@@ -46,44 +70,81 @@ export class MessageStore {
             .slice(0, limit);
         return all.map((s) => ({ sessionId: s.sessionId, title: s.title, updatedAt: s.updatedAt }));
     }
-    clearSession(sessionId) {
-        this.messages.delete(sessionId);
+    // ── record append ────────────────────────────────────────────────────────
+    /** Append a user prompt row. Returns the persisted record. */
+    appendUserMessage(sessionId, content, opts = {}) {
+        const ts = opts.now ?? Date.now();
+        const record = {
+            v: RECORD_SCHEMA_VERSION,
+            type: "user_message",
+            id: randomUUID(),
+            ts,
+            content,
+            ...(opts.turnId ? { turnId: opts.turnId } : {}),
+            ...(opts.messageId ? { messageId: opts.messageId } : {}),
+        };
+        this.persistRecord(sessionId, record, ts);
+        return record;
     }
-    addMessage(sessionId, role, content, messageType = "text", metadata = {}) {
-        const id = randomUUID();
-        const now = Date.now();
-        const entry = { id, sessionId, role, content, messageType, metadata, createdAt: now };
-        const arr = this.messages.get(sessionId) ?? [];
-        arr.push(entry);
-        if (arr.length > this.maxPerSession)
-            arr.splice(0, arr.length - this.maxPerSession);
-        this.messages.set(sessionId, arr);
-        const s = this.sessions.get(sessionId);
-        if (s)
-            s.updatedAt = now;
-        else
-            this.upsertSession(sessionId);
-        return id;
+    /** Append a finalized assistant turn. Returns the persisted record. */
+    appendAssistantTurn(sessionId, turn, opts = {}) {
+        const ts = opts.now ?? turn.completedAt ?? Date.now();
+        const record = {
+            ...turn,
+            v: RECORD_SCHEMA_VERSION,
+            type: "assistant_turn",
+            id: randomUUID(),
+            ts,
+        };
+        this.persistRecord(sessionId, record, ts);
+        return record;
+    }
+    /** Pre-loaded record (used by `JsonlMessageStore.open` to seed memory). */
+    loadRecord(sessionId, record) {
+        this.persistRecord(sessionId, record, record.ts, /*touch*/ false);
+    }
+    /** All records for a session in chronological insertion order. */
+    getTurns(sessionId) {
+        return [...(this.records.get(sessionId) ?? [])];
     }
-    getMessages(sessionId, limit) {
-        const arr = this.messages.get(sessionId) ?? [];
-        const n = Math.min(limit ?? this.maxPerSession, arr.length);
-        return arr.slice(arr.length - n);
+    /** True iff at least one record exists for this session. */
+    hasRecords(sessionId) {
+        const arr = this.records.get(sessionId);
+        return !!arr && arr.length > 0;
     }
-    getMessagesAsDicts(sessionId, limit) {
-        return this.getMessages(sessionId, limit).map((m) => {
-            const out = {
-                role: m.role,
-                content: m.content,
-                type: m.messageType,
-                createdAt: m.createdAt,
-            };
-            if (Object.keys(m.metadata).length > 0)
-                out.metadata = m.metadata;
-            return out;
-        });
+    // ── internals ────────────────────────────────────────────────────────────
+    /**
+     * Append a record to memory and bump session.updatedAt.
+     * Subclasses (JsonlMessageStore) override to additionally persist.
+     *
+     * `touch=false` is used by `loadRecord` so a cold-start replay of a
+     * year-old transcript doesn't artificially bump updatedAt to "now".
+     */
+    persistRecord(sessionId, record, ts, touch = true) {
+        const arr = this.records.get(sessionId) ?? [];
+        arr.push(record);
+        if (arr.length > this.maxRecordsPerSession) {
+            arr.splice(0, arr.length - this.maxRecordsPerSession);
+        }
+        this.records.set(sessionId, arr);
+        const s = this.sessions.get(sessionId);
+        if (s) {
+            if (touch)
+                s.updatedAt = ts;
+            else if (ts > s.updatedAt)
+                s.updatedAt = ts;
+        }
+        else {
+            this.sessions.set(sessionId, {
+                sessionId,
+                title: "New chat",
+                createdAt: ts,
+                updatedAt: ts,
+            });
+            this.evictSessionLru();
+        }
     }
-    /** Drop the least-recently-updated sessions when we exceed maxSessions. */
+    /** Drop the least-recently-updated sessions when exceeding maxSessions. */
     evictSessionLru() {
         if (this.sessions.size <= this.maxSessions)
             return;
@@ -92,7 +153,7 @@ export class MessageStore {
         for (let i = 0; i < overflow; i++) {
             const id = sorted[i].sessionId;
             this.sessions.delete(id);
-            this.messages.delete(id);
+            this.records.delete(id);
         }
     }
 }

package/dist/app/message-store.js.map

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

package/dist/app/session-manager.d.ts

@@ -6,18 +6,43 @@
  * `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.
+ * Persistence model — turn-grained:
  *
- * Surface mirrors the Python `SessionHandler` so ACP handlers remain
- * thin pass-throughs.
+ *   - User prompts persist immediately on entry to `prompt()` (one
+ *     `user_message` JSONL row).
+ *   - Assistant chunks (`task:text`) and tool events (`task:tool`) are
+ *     accumulated in an in-memory `InFlightTurnAggregator`; nothing is
+ *     written until `task:end`, at which point a single
+ *     `assistant_turn` JSONL row captures the entire turn (full text,
+ *     every tool call in invocation order, stop reason, optional
+ *     terminal error). This matches OpenClaw's "one line = one
+ *     complete message" model and avoids the fragmented transcript
+ *     produced by the legacy "one row per chunk" implementation.
+ *
+ * Single-session mode (`fixedSessionId`):
+ *
+ *   When a fixedSessionId is supplied, every ACP session-management
+ *   method (`new`/`load`/`list`/`rename`/`delete`) collapses onto that
+ *   one sid. The mobile/web client receives `multipleSessions: false`
+ *   in the initialize handshake so the UI hides session-switching
+ *   affordances. This is the production configuration for device-agent
+ *   — a single physical device serialises tasks anyway, and a fixed
+ *   sid keeps the JSONL transcript stable across reconnects.
+ *
+ * Replay model — push-style:
+ *
+ *   `session/load` does NOT return history in the RPC `result` (the
+ *   web/mobile SDKs ignore that field). Instead, it pushes one
+ *   `history_turn` envelope per persisted turn followed by an
+ *   in-flight snapshot (streaming-style, WITHOUT `stream_complete`)
+ *   when a task is mid-flight. This matches beeos-claw's
+ *   `handleSessionLoad` exactly so the same chat-store reducer paths
+ *   handle both agents.
  */
-import { MessageStore, type MessageHistoryEntry } from "./message-store.js";
+import { MessageStore } from "./message-store.js";
 import type { AgentHost } from "../ports/agent-host.js";
 export interface SessionUpdateNotifier {
-    /** Called for every step during `session/prompt`. */
+    /** Called for every step during `session/prompt` (and during `session/load` replay). */
     send(sessionId: string, update: Record<string, unknown>): void;
 }
 export interface SessionManagerOptions {
@@ -26,10 +51,16 @@ export interface SessionManagerOptions {
     notifier?: SessionUpdateNotifier;
     /**
      * Called when the user asks to switch the underlying agent model.
-     * `provider` may be empty when the caller doesn't pin a specific adapter
-     * (auto-detect from `model`).
+     * `provider` may be empty when the caller doesn't pin a specific
+     * adapter (auto-detect from `model`).
      */
     onSetModel?: (provider: string, model: string) => Promise<void> | void;
+    /**
+     * If set, single-session mode is active: every session-management
+     * method aliases to this sid, `multipleSessions` should be advertised
+     * as `false` in `initialize`, and `delete` collapses to `clear`.
+     */
+    fixedSessionId?: string;
     maxSessions?: number;
     sessionTtlMs?: number;
 }
@@ -38,11 +69,14 @@ export declare class SessionManager {
     private readonly store;
     private readonly notifier;
     private readonly onSetModel;
+    private readonly fixedSessionId;
     private readonly maxSessions;
     private readonly sessionTtlMs;
     private readonly sessions;
     /** taskId → sessionId for routing host events to the right ACP session. */
     private readonly taskToSession;
+    /** Per-task in-flight aggregators. Keyed by taskId. */
+    private readonly inFlightByTask;
     private activeSessionId;
     private currentTask;
     private unsubscribe;
@@ -52,9 +86,22 @@ export declare class SessionManager {
     newSession(): {
         sessionId: string;
     };
+    /**
+     * Load a session.
+     *
+     * Push-replay model: emit one `history_turn` envelope per persisted
+     * turn so the chat-store sidecar resolver can reconstruct the bubble
+     * graph identically to a fresh streaming run. If a task is currently
+     * in-flight on this sid, additionally emit a streaming-style
+     * snapshot (`agent_message_chunk` + `tool_call` + `tool_call_update`)
+     * WITHOUT the closing `stream_complete` so the client knows the turn
+     * is still active.
+     *
+     * Returns `{ sessionId }` only — the legacy `history` field has been
+     * dropped because no client reads it (see explore audit).
+     */
     loadSession(sessionId: string): {
         sessionId: string;
-        history: MessageHistoryEntry[];
     };
     listSessions(): {
         sessions: {
@@ -67,6 +114,14 @@ export declare class SessionManager {
         sessionId: string;
         title: string;
     };
+    /**
+     * Delete a session.
+     *
+     * In single-session mode, this collapses to `clearSession` because
+     * the one-and-only session can't be removed without losing the
+     * device's identity. Otherwise drops the in-memory + persisted state
+     * for `sessionId`.
+     */
     deleteSession(sessionId: string): {
         deleted: boolean;
     };
@@ -94,56 +149,64 @@ export declare class SessionManager {
     /** Cancel the in-flight task for the active session, if any. */
     cancel(): Promise<boolean>;
     /**
-     * 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 / update / end (tool_call / tool_call_update).
-     *                        `update` carries partial progress for long-running
-     *                        tools (large APK install, long shell streams,
-     *                        large screenshots) so the chat-store tool card
-     *                        can refresh in-place without waiting for `end`.
-     *                        Mirrors beeos-claw's tool_call_update in_progress
-     *                        semantics (see acp-gateway/tool-call-payload-builder.ts).
-     *   - `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).
-     *   - `task:end`       — terminal lifecycle event. We emit the canonical
-     *                        ACP `stream_complete` envelope here (BEFORE the
-     *                        `prompt()` finally block fires `agent_status:
-     *                        "idle"`). chat-store's `applyIncrementalUpdate`
-     *                        relies on `stream_complete` to (a) collapse
-     *                        streaming text part `state` from "streaming"
-     *                        back to "done" so the cursor caret stops
-     *                        rendering, and (b) trim `pendingMap` /
-     *                        `currentAsstId` so history-replay paths don't
-     *                        re-flag the just-finished turn as processing.
-     *                        Without it the bubble caret never collapses
-     *                        and reload paths see a stale `processing`
-     *                        pending — see plan
-     *                        `device-agent_stream_complete_对齐`.
+     * Translate host `AgentEvent`s into ACP `session/update` envelopes
+     * AND accumulate the assistant turn into the in-memory aggregator
+     * for this task. The aggregator is finalised on `task:end` and
+     * persisted as a single `assistant_turn` JSONL row — chunk-level
+     * persistence is intentionally NOT done (it produces fragmented
+     * transcripts that can't be reconstructed cleanly on reload).
      *
-     * 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.
+     * Source events:
+     *   - `task:start`     — allocate the in-flight aggregator.
+     *   - `task:text`      — append delta to in-flight + emit
+     *                        `agent_message_chunk`.
+     *   - `task:reasoning` — emit `agent_thought_chunk` only (NOT
+     *                        persisted — bloats LLM context on resume).
+     *   - `task:tool`      — track in in-flight + emit
+     *                        `tool_call` / `tool_call_update`. Mid-flight
+     *                        progress is forwarded as `in_progress`.
+     *   - `task:notice`    — `warn` is dropped entirely; `error` becomes
+     *                        a `system_message_chunk` with
+     *                        `metadata.kind = "agent_notice"` AND is
+     *                        captured as the in-flight `error` field so
+     *                        the persisted turn carries the failure
+     *                        text.
+     *   - `task:step`      — structural; no ACP emission.
+     *   - `task:end`       — finalise the in-flight, persist a single
+     *                        `assistant_turn` row, emit `stream_complete`
+     *                        BEFORE the closing `agent_status: idle`
+     *                        (chat-store relies on this order).
      */
     private handleHostEvent;
     private resolveSession;
+    /** Map any sid the client passes onto the canonical sid in fixed mode. */
+    private aliasSessionId;
+    /** Materialise the fixed session in-memory + on disk if it isn't yet. */
+    private ensureFixedSession;
+    /**
+     * Lazily create an in-flight aggregator for events that arrive
+     * without a preceding `task:start` (defensive — agent-host always
+     * fires start, but tests + alternate adapters may not).
+     */
+    private ensureInflight;
+    private findInflightForSession;
+    /**
+     * Emit a single persisted record as a `history_turn` envelope.
+     *
+     * Mirrors beeos-claw `bridge-core.replayAssistantTurnAsStream` —
+     * `history_turn` is a stamped-done snapshot of an entire turn that
+     * the chat-store reducer renders as a complete bubble (no streaming
+     * cursor). For assistant turns, we serialise tool calls into the
+     * shape `apply-update.buildToolCalls` accepts.
+     */
+    private emitHistoryTurn;
+    /**
+     * Emit the current state of an in-flight turn as streaming-style
+     * envelopes WITHOUT the closing `stream_complete`. The client uses
+     * the absence of `stream_complete` to recognise the turn is still
+     * generating, matching beeos-claw's `emitCurrentStreamSnapshot`.
+     */
+    private emitInflightSnapshot;
     private notify;
     private evictExpired;
 }