@beeos-ai/device-agent 0.8.0 → 0.9.1

package/dist/plugins/message-bus/ms-channel-notifier.d.ts

@@ -0,0 +1,101 @@
+/**
+ * MsChannelNotifier — translate per-session ACP `session/update`
+ * envelopes into BeeOS Message Service wire envelopes for ONE
+ * Centrifugo channel (`ch:{channelId}`).
+ *
+ * Implements `SessionUpdateNotifier` so it can be `bindNotifier`'d
+ * to a specific sid in `SessionManager`. The MessageBus inbound
+ * handler creates one of these per `chat_message` envelope, binds
+ * it for the duration of the turn, then unbinds it when the await
+ * for `promptForSession()` returns.
+ *
+ * Wire mapping (locked in to match beeos-claw `acp-server.ts onStreamDelta`):
+ *
+ *   - `agent_message_chunk` → `agent_reply_delta` envelope with
+ *     `update.sessionUpdate=agent_message_chunk`. The text is also
+ *     accumulated into `accumulatedText` so the terminal `agent_reply`
+ *     can carry the full reply as `payload.text`.
+ *
+ *   - `agent_thought_chunk` → `agent_reply_delta` envelope with
+ *     `update.sessionUpdate=agent_thought_chunk`. Reasoning is NEVER
+ *     accumulated — `backend/pkg/convmsg/extract.go::extractNestedDelta`
+ *     intentionally drops thought chunks so they don't pollute reply
+ *     text, and we mirror that here.
+ *
+ *   - `stream_complete` → terminal `agent_reply` envelope. Payload
+ *     shape mirrors beeos-claw:
+ *       success   → { session_key, text }
+ *       cancelled → { session_key, error: "cancelled", text? }
+ *       failure   → { session_key, error, text? }
+ *
+ *   - All other `sessionUpdate` types (`agent_status`, `tool_call`,
+ *     `tool_call_update`, `history_turn`, `system_message_chunk`,
+ *     `user_message_chunk`) are intentionally SKIPPED. The old
+ *     outbound listener also skipped them; mirroring keeps the wire
+ *     format byte-for-byte identical for downstream consumers.
+ *
+ * **Only the terminal `agent_reply`** carries `in_reply_to = inboundMessageId`
+ * so the L0 `/channels/{id}/wait` endpoint can match the reply on the
+ * original `message_id`. Streaming deltas are fan-out only and MUST NOT
+ * carry `in_reply_to` — otherwise MS `/wait` (which only checks
+ * `in_reply_to`, not message type) would short-circuit on the first
+ * delta and the caller would misreport "completed". Mirrors beeos-claw
+ * `acp-server.ts:73-85`.
+ *
+ * The notifier never throws out of `send()` — that runs on the
+ * SessionManager event hot path and a synchronous throw would skip
+ * subsequent handlers (e.g. status:idle). All publish failures are
+ * logged and swallowed. The next event for the same turn will retry
+ * any subsequent publishes via the same path.
+ */
+import type { MessageSDK } from "@beeos-ai/message-sdk";
+import type { SessionUpdateNotifier } from "../../app/session-manager.js";
+import type { Logger } from "../../logger/index.js";
+export interface MsChannelNotifierOptions {
+    sdk: MessageSDK;
+    /** IM channel the reply is published on (`ch:{channelId}`). */
+    channelId: string;
+    /**
+     * Original `chat_message.message_id`. Echoed as `in_reply_to` on
+     * every published envelope so L0 `/wait` can match.
+     */
+    inboundMessageId: string;
+    /**
+     * Stable session anchor (`agent:{id}:invoke:ctx-{contextId}` or
+     * `agent:{id}:invoke:ch-{channelId}`) derived by `extractChatPrompt`.
+     * Embedded as `payload.session_key` for forward-compat parity with
+     * beeos-claw downstream observers.
+     */
+    sessionKey: string;
+    logger: Logger;
+}
+export declare class MsChannelNotifier implements SessionUpdateNotifier {
+    private readonly opts;
+    /** Cumulative `agent_message_chunk` text — populates terminal `agent_reply.text`. */
+    private accumulatedText;
+    private finalized;
+    constructor(opts: MsChannelNotifierOptions);
+    /**
+     * Called by SessionManager for every `session/update` envelope on
+     * this notifier's bound sid. Fire-and-forget: the SessionManager
+     * event hot path is synchronous, so we kick off the publish in the
+     * background and never block.
+     */
+    send(_sessionId: string, update: Record<string, unknown>): void;
+    /**
+     * Cumulative reply text emitted so far. Exposed for diagnostics +
+     * tests; not part of any wire contract.
+     */
+    get currentText(): string;
+    /** True once the terminal `agent_reply` has been published. */
+    get isFinalized(): boolean;
+    private handle;
+    private publishDelta;
+    /**
+     * Emit the terminal `agent_reply`. Idempotent — guarded by
+     * `finalized` so a duplicate `stream_complete` (extremely rare,
+     * but possible if the host event handler ever fires twice) cannot
+     * publish two terminal envelopes.
+     */
+    private publishFinal;
+}

package/dist/plugins/message-bus/ms-channel-notifier.js

@@ -0,0 +1,181 @@
+/**
+ * MsChannelNotifier — translate per-session ACP `session/update`
+ * envelopes into BeeOS Message Service wire envelopes for ONE
+ * Centrifugo channel (`ch:{channelId}`).
+ *
+ * Implements `SessionUpdateNotifier` so it can be `bindNotifier`'d
+ * to a specific sid in `SessionManager`. The MessageBus inbound
+ * handler creates one of these per `chat_message` envelope, binds
+ * it for the duration of the turn, then unbinds it when the await
+ * for `promptForSession()` returns.
+ *
+ * Wire mapping (locked in to match beeos-claw `acp-server.ts onStreamDelta`):
+ *
+ *   - `agent_message_chunk` → `agent_reply_delta` envelope with
+ *     `update.sessionUpdate=agent_message_chunk`. The text is also
+ *     accumulated into `accumulatedText` so the terminal `agent_reply`
+ *     can carry the full reply as `payload.text`.
+ *
+ *   - `agent_thought_chunk` → `agent_reply_delta` envelope with
+ *     `update.sessionUpdate=agent_thought_chunk`. Reasoning is NEVER
+ *     accumulated — `backend/pkg/convmsg/extract.go::extractNestedDelta`
+ *     intentionally drops thought chunks so they don't pollute reply
+ *     text, and we mirror that here.
+ *
+ *   - `stream_complete` → terminal `agent_reply` envelope. Payload
+ *     shape mirrors beeos-claw:
+ *       success   → { session_key, text }
+ *       cancelled → { session_key, error: "cancelled", text? }
+ *       failure   → { session_key, error, text? }
+ *
+ *   - All other `sessionUpdate` types (`agent_status`, `tool_call`,
+ *     `tool_call_update`, `history_turn`, `system_message_chunk`,
+ *     `user_message_chunk`) are intentionally SKIPPED. The old
+ *     outbound listener also skipped them; mirroring keeps the wire
+ *     format byte-for-byte identical for downstream consumers.
+ *
+ * **Only the terminal `agent_reply`** carries `in_reply_to = inboundMessageId`
+ * so the L0 `/channels/{id}/wait` endpoint can match the reply on the
+ * original `message_id`. Streaming deltas are fan-out only and MUST NOT
+ * carry `in_reply_to` — otherwise MS `/wait` (which only checks
+ * `in_reply_to`, not message type) would short-circuit on the first
+ * delta and the caller would misreport "completed". Mirrors beeos-claw
+ * `acp-server.ts:73-85`.
+ *
+ * The notifier never throws out of `send()` — that runs on the
+ * SessionManager event hot path and a synchronous throw would skip
+ * subsequent handlers (e.g. status:idle). All publish failures are
+ * logged and swallowed. The next event for the same turn will retry
+ * any subsequent publishes via the same path.
+ */
+export class MsChannelNotifier {
+    opts;
+    /** Cumulative `agent_message_chunk` text — populates terminal `agent_reply.text`. */
+    accumulatedText = "";
+    finalized = false;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    /**
+     * Called by SessionManager for every `session/update` envelope on
+     * this notifier's bound sid. Fire-and-forget: the SessionManager
+     * event hot path is synchronous, so we kick off the publish in the
+     * background and never block.
+     */
+    send(_sessionId, update) {
+        void this.handle(update);
+    }
+    /**
+     * Cumulative reply text emitted so far. Exposed for diagnostics +
+     * tests; not part of any wire contract.
+     */
+    get currentText() {
+        return this.accumulatedText;
+    }
+    /** True once the terminal `agent_reply` has been published. */
+    get isFinalized() {
+        return this.finalized;
+    }
+    async handle(update) {
+        const sessionUpdate = pickSessionUpdate(update);
+        try {
+            switch (sessionUpdate) {
+                case "agent_message_chunk": {
+                    const text = pickContentText(update.content);
+                    if (!text)
+                        return;
+                    this.accumulatedText += text;
+                    await this.publishDelta("agent_message_chunk", text);
+                    return;
+                }
+                case "agent_thought_chunk": {
+                    const text = pickContentText(update.content);
+                    if (!text)
+                        return;
+                    await this.publishDelta("agent_thought_chunk", text);
+                    return;
+                }
+                case "stream_complete": {
+                    const stopReason = pickString(update.stopReason) || "end_turn";
+                    const errorText = pickString(update.error);
+                    await this.publishFinal(stopReason, errorText);
+                    return;
+                }
+                default:
+                    // agent_status / tool_call / tool_call_update / history_turn
+                    // / system_message_chunk / user_message_chunk → skip.
+                    return;
+            }
+        }
+        catch (err) {
+            this.opts.logger.error({
+                err: err instanceof Error ? err.message : String(err),
+                channelId: this.opts.channelId,
+                sessionUpdate,
+            }, "ms-channel-notifier: publish failed");
+        }
+    }
+    async publishDelta(sessionUpdate, text) {
+        // Streaming deltas are fan-out only — they MUST NOT carry
+        // `in_reply_to`, otherwise MS `/wait` (which only checks
+        // `in_reply_to`, not message type) would short-circuit on the
+        // first delta and the caller would think the turn finished.
+        // Mirrors beeos-claw `acp-server.ts:73-85`.
+        await this.opts.sdk.sendToChannel(this.opts.channelId, "agent_reply_delta", {
+            session_key: this.opts.sessionKey,
+            update: {
+                sessionUpdate,
+                content: { type: "text", text },
+            },
+        });
+    }
+    /**
+     * Emit the terminal `agent_reply`. Idempotent — guarded by
+     * `finalized` so a duplicate `stream_complete` (extremely rare,
+     * but possible if the host event handler ever fires twice) cannot
+     * publish two terminal envelopes.
+     */
+    async publishFinal(stopReason, errorText) {
+        if (this.finalized)
+            return;
+        this.finalized = true;
+        let payload;
+        if (stopReason === "cancelled") {
+            payload = {
+                session_key: this.opts.sessionKey,
+                error: "cancelled",
+                text: this.accumulatedText,
+            };
+        }
+        else if (errorText) {
+            payload = {
+                session_key: this.opts.sessionKey,
+                error: errorText,
+                text: this.accumulatedText,
+            };
+        }
+        else {
+            payload = {
+                session_key: this.opts.sessionKey,
+                text: this.accumulatedText,
+            };
+        }
+        await this.opts.sdk.sendToChannel(this.opts.channelId, "agent_reply", payload, { inReplyTo: this.opts.inboundMessageId });
+    }
+}
+function pickSessionUpdate(update) {
+    const v = update.sessionUpdate;
+    return typeof v === "string" ? v : "";
+}
+function pickContentText(content) {
+    if (!content || typeof content !== "object")
+        return "";
+    const c = content;
+    if (typeof c.text === "string")
+        return c.text;
+    return "";
+}
+function pickString(v) {
+    return typeof v === "string" ? v : "";
+}
+//# sourceMappingURL=ms-channel-notifier.js.map

package/dist/plugins/message-bus/ms-channel-notifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ms-channel-notifier.js","sourceRoot":"","sources":["../../../src/plugins/message-bus/ms-channel-notifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AA0BH,MAAM,OAAO,iBAAiB;IAKC;IAJ7B,qFAAqF;IAC7E,eAAe,GAAG,EAAE,CAAC;IACrB,SAAS,GAAG,KAAK,CAAC;IAE1B,YAA6B,IAA8B;QAA9B,SAAI,GAAJ,IAAI,CAA0B;IAAG,CAAC;IAE/D;;;;;OAKG;IACH,IAAI,CAAC,UAAkB,EAAE,MAA+B;QACtD,KAAK,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED,+DAA+D;IAC/D,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAEO,KAAK,CAAC,MAAM,CAAC,MAA+B;QAClD,MAAM,aAAa,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,CAAC;YACH,QAAQ,aAAa,EAAE,CAAC;gBACtB,KAAK,qBAAqB,CAAC,CAAC,CAAC;oBAC3B,MAAM,IAAI,GAAG,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;oBAC7C,IAAI,CAAC,IAAI;wBAAE,OAAO;oBAClB,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC;oBAC7B,MAAM,IAAI,CAAC,YAAY,CAAC,qBAAqB,EAAE,IAAI,CAAC,CAAC;oBACrD,OAAO;gBACT,CAAC;gBACD,KAAK,qBAAqB,CAAC,CAAC,CAAC;oBAC3B,MAAM,IAAI,GAAG,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;oBAC7C,IAAI,CAAC,IAAI;wBAAE,OAAO;oBAClB,MAAM,IAAI,CAAC,YAAY,CAAC,qBAAqB,EAAE,IAAI,CAAC,CAAC;oBACrD,OAAO;gBACT,CAAC;gBACD,KAAK,iBAAiB,CAAC,CAAC,CAAC;oBACvB,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC;oBAC/D,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;oBAC3C,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;oBAC/C,OAAO;gBACT,CAAC;gBACD;oBACE,6DAA6D;oBAC7D,sDAAsD;oBACtD,OAAO;YACX,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CACpB;gBACE,GAAG,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;gBACrD,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS;gBAC9B,aAAa;aACd,EACD,qCAAqC,CACtC,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,YAAY,CACxB,aAA4D,EAC5D,IAAY;QAEZ,0DAA0D;QAC1D,yDAAyD;QACzD,8DAA8D;QAC9D,4DAA4D;QAC5D,4CAA4C;QAC5C,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,CAC/B,IAAI,CAAC,IAAI,CAAC,SAAS,EACnB,mBAAmB,EACnB;YACE,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU;YACjC,MAAM,EAAE;gBACN,aAAa;gBACb,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;aAChC;SACF,CACF,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,YAAY,CACxB,UAAkB,EAClB,SAAiB;QAEjB,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QAEtB,IAAI,OAAgC,CAAC;QACrC,IAAI,UAAU,KAAK,WAAW,EAAE,CAAC;YAC/B,OAAO,GAAG;gBACR,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU;gBACjC,KAAK,EAAE,WAAW;gBAClB,IAAI,EAAE,IAAI,CAAC,eAAe;aAC3B,CAAC;QACJ,CAAC;aAAM,IAAI,SAAS,EAAE,CAAC;YACrB,OAAO,GAAG;gBACR,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU;gBACjC,KAAK,EAAE,SAAS;gBAChB,IAAI,EAAE,IAAI,CAAC,eAAe;aAC3B,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO,GAAG;gBACR,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU;gBACjC,IAAI,EAAE,IAAI,CAAC,eAAe;aAC3B,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,CAC/B,IAAI,CAAC,IAAI,CAAC,SAAS,EACnB,aAAa,EACb,OAAO,EACP,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAC1C,CAAC;IACJ,CAAC;CACF;AAED,SAAS,iBAAiB,CAAC,MAA+B;IACxD,MAAM,CAAC,GAAG,MAAM,CAAC,aAAa,CAAC;IAC/B,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACxC,CAAC;AAED,SAAS,eAAe,CAAC,OAAgB;IACvC,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACvD,MAAM,CAAC,GAAG,OAA6C,CAAC;IACxD,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC,IAAI,CAAC;IAC9C,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,UAAU,CAAC,CAAU;IAC5B,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACxC,CAAC"}

package/dist/plugins/message-bus/ms-inflight-tracker.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Tiny single-entry tracker for the IN-FLIGHT MS-originated turn.
+ *
+ * v0.9.0 — replaces the v0.8.0 `TurnContextRegister`, which carried
+ * far more state because the outbound listener needed to look up the
+ * channelId / sessionKey / inboundMessageId per AgentEvent. With
+ * `MsChannelNotifier` owning the wire mapping per-sid, the tracker
+ * only needs to answer ONE question: "given a `chat_cancel.target_
+ * message_id`, which sid (if any) is currently running?".
+ *
+ * The tracker is single-entry by design — `SessionManager.currentTask`
+ * already enforces "at most one in-flight turn" at the SessionManager
+ * level, so the plugin layer can't legitimately have two MS turns
+ * active at once.
+ */
+export interface MsInflightEntry {
+    /** Original inbound `chat_message.message_id`. */
+    messageId: string;
+    /** Centrifugo channel `ch:{channelId}` the reply will be published on. */
+    channelId: string;
+    /** Per-channel sid bound on `SessionManager` (== `extractChatPrompt.sessionKey`). */
+    sid: string;
+    /** Wall-clock timestamp the turn was claimed (ms). For diagnostics. */
+    startedAt: number;
+}
+export declare class MsInflightTracker {
+    private current;
+    set(entry: Omit<MsInflightEntry, "startedAt">): MsInflightEntry;
+    /** Idempotent — clearing twice or with a wrong id is a no-op. */
+    clear(messageId: string): void;
+    /** Force-clear (used during plugin stop / disconnect). */
+    reset(): void;
+    findByInboundMessageId(messageId: string): MsInflightEntry | null;
+    /** Visible for tests / logs. */
+    peek(): MsInflightEntry | null;
+}

package/dist/plugins/message-bus/ms-inflight-tracker.js

@@ -0,0 +1,42 @@
+/**
+ * Tiny single-entry tracker for the IN-FLIGHT MS-originated turn.
+ *
+ * v0.9.0 — replaces the v0.8.0 `TurnContextRegister`, which carried
+ * far more state because the outbound listener needed to look up the
+ * channelId / sessionKey / inboundMessageId per AgentEvent. With
+ * `MsChannelNotifier` owning the wire mapping per-sid, the tracker
+ * only needs to answer ONE question: "given a `chat_cancel.target_
+ * message_id`, which sid (if any) is currently running?".
+ *
+ * The tracker is single-entry by design — `SessionManager.currentTask`
+ * already enforces "at most one in-flight turn" at the SessionManager
+ * level, so the plugin layer can't legitimately have two MS turns
+ * active at once.
+ */
+export class MsInflightTracker {
+    current = null;
+    set(entry) {
+        this.current = { ...entry, startedAt: Date.now() };
+        return this.current;
+    }
+    /** Idempotent — clearing twice or with a wrong id is a no-op. */
+    clear(messageId) {
+        if (this.current && this.current.messageId === messageId) {
+            this.current = null;
+        }
+    }
+    /** Force-clear (used during plugin stop / disconnect). */
+    reset() {
+        this.current = null;
+    }
+    findByInboundMessageId(messageId) {
+        return this.current && this.current.messageId === messageId
+            ? this.current
+            : null;
+    }
+    /** Visible for tests / logs. */
+    peek() {
+        return this.current;
+    }
+}
+//# sourceMappingURL=ms-inflight-tracker.js.map

package/dist/plugins/message-bus/ms-inflight-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ms-inflight-tracker.js","sourceRoot":"","sources":["../../../src/plugins/message-bus/ms-inflight-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAaH,MAAM,OAAO,iBAAiB;IACpB,OAAO,GAA2B,IAAI,CAAC;IAE/C,GAAG,CAAC,KAAyC;QAC3C,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACnD,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,iEAAiE;IACjE,KAAK,CAAC,SAAiB;QACrB,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACzD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,CAAC;IACH,CAAC;IAED,0DAA0D;IAC1D,KAAK;QACH,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACtB,CAAC;IAED,sBAAsB,CAAC,SAAiB;QACtC,OAAO,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS;YACzD,CAAC,CAAC,IAAI,CAAC,OAAO;YACd,CAAC,CAAC,IAAI,CAAC;IACX,CAAC;IAED,gCAAgC;IAChC,IAAI;QACF,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF"}

package/dist/ports/plugin.d.ts

@@ -33,11 +33,23 @@
  */
 import type { Logger } from "pino";
 import type { Config } from "../config/schema.js";
+import type { SessionManager } from "../app/session-manager.js";
 import type { AgentHost } from "./agent-host.js";
 export interface PluginContext {
     host: AgentHost;
     config: Config;
     log: Logger;
+    /**
+     * v0.9.0 — bootstrap-owned `SessionManager` shared across plugins.
+     *
+     * AcpPlugin uses it via the operator's fixed sid; MessageBusPlugin
+     * uses `findOrCreateSession(sessionKey)` + `bindNotifier` to route
+     * per-channel turns. Plugins MUST NOT construct their own
+     * SessionManager — single instance per process is the invariant
+     * that lets the in-flight gate (Layer 3) protect the physical
+     * device.
+     */
+    sessionManager: SessionManager;
 }
 export interface AgentPlugin {
     /** Unique, stable plugin name (used for logging / disable filters). */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beeos-ai/device-agent",
-  "version": "0.8.0",
+  "version": "0.9.1",
   "description": "BeeOS device-agent — Android/desktop AI control agent (TypeScript) speaking ACP over Bridge WebSocket. Connects to a sibling device-mcp-server process for device control.",
   "license": "Apache-2.0",
   "type": "module",

package/dist/agent-runtime/skills/sqlite-store.d.ts

@@ -1,60 +0,0 @@
-/**
- * agent-runtime/skills/sqlite-store — SQLite-backed
- * {@link SkillCacheStore}.
- *
- * Phase 3.1 of the [device-agent reflector upgrade plan](../../../../../../.cursor/plans/device-agent-reflector-skills_d5599350.plan.md).
- *
- * Schema (kept verbatim with the plan):
- * ```sql
- * CREATE TABLE skills (
- *   id TEXT PRIMARY KEY,
- *   app_package TEXT NOT NULL,
- *   task_summary TEXT NOT NULL,
- *   task_embedding BLOB,
- *   action_sequence_json TEXT NOT NULL,
- *   success_count INTEGER NOT NULL DEFAULT 1,
- *   fail_count INTEGER NOT NULL DEFAULT 0,
- *   last_used_at INTEGER NOT NULL,
- *   created_at INTEGER NOT NULL
- * );
- * CREATE INDEX idx_skills_app ON skills(app_package);
- * ```
- *
- * Default DB path: `~/.beeos/device-agent/skills.sqlite`. Containerised
- * deployments mount `/var/lib/beeos/device-agent` and override
- * `SKILL_CACHE_PATH` accordingly.
- *
- * Search is implemented as a full scan over the matching app rows —
- * the cache is intentionally small (<10k rows / device), so a brute
- * cosine pass is cheaper than maintaining an ANN index. If profile
- * data shows that's wrong we can plug in `sqlite-vss` / `pgvector`
- * later behind the same {@link SkillCacheStore} interface.
- */
-import type { Database as DB } from "better-sqlite3";
-import type { NewSkillInput, Skill, SkillCacheStore, SkillMatch } from "./types.js";
-export interface SQLiteSkillCacheStoreOptions {
-    /** Override the default DB path. Use ":memory:" for ephemeral tests. */
-    path?: string;
-    /** Pre-built better-sqlite3 Database (used by tests). */
-    db?: DB;
-    /** Skip auto-mkdir on the parent dir (when path is :memory:). */
-    noMkdir?: boolean;
-}
-export declare function defaultSkillCachePath(): string;
-export declare class SQLiteSkillCacheStore implements SkillCacheStore {
-    private readonly db;
-    private readonly stmts;
-    private closed;
-    constructor(opts?: SQLiteSkillCacheStoreOptions);
-    insert(input: NewSkillInput): Skill;
-    get(id: string): Skill | undefined;
-    listByApp(appPackage: string, limit?: number): Skill[];
-    listAll(limit?: number): Skill[];
-    search(appPackage: string, query: Float32Array, k: number): SkillMatch[];
-    recordSuccess(id: string, now?: number): void;
-    recordFailure(id: string, now?: number): void;
-    delete(id: string): boolean;
-    clear(): void;
-    close(): void;
-    private applyMigrations;
-}