openclaw-channel-bgos 0.6.1

package/dist/bgos-api.js

@@ -0,0 +1,136 @@
+import axios from "axios";
+import { PairingRevokedError, } from "./types.js";
+/**
+ * Thin typed wrapper around the BGOS integration endpoints. All methods
+ * attach the X-BGOS-Pairing header from cfg.pairingToken.
+ *
+ * A 401 from any request is mapped to PairingRevokedError so callers
+ * (WS client, outbound adapter) can short-circuit and let the setup
+ * wizard prompt for re-pair.
+ */
+export class BgosApi {
+    http;
+    constructor(cfg) {
+        this.http = axios.create({
+            baseURL: cfg.baseUrl + "/api/v1",
+            headers: {
+                "X-BGOS-Pairing": cfg.pairingToken,
+                "Content-Type": "application/json",
+            },
+            timeout: 30_000,
+        });
+        this.http.interceptors.response.use((r) => r, (err) => {
+            if (err?.response?.status === 401) {
+                return Promise.reject(new PairingRevokedError(err.response?.data?.message ?? "pairing rejected by BGOS"));
+            }
+            return Promise.reject(err);
+        });
+    }
+    /** GET /integrations/me — confirms token + touches last_seen_at.
+     *  Includes assistant→agent_route bindings so the plugin can seed
+     *  its dispatch map on cold start.
+     */
+    async whoami() {
+        const r = await this.http.get("integrations/me");
+        return r.data;
+    }
+    /** Pair exchange (Public; does NOT need X-BGOS-Pairing). */
+    static async pairExchange(baseUrl, params) {
+        const base = baseUrl.replace(/\/+$/, "") + "/api/v1";
+        const r = await axios.post(`${base}/integrations/pair-exchange`, params, {
+            timeout: 15_000,
+        });
+        return r.data;
+    }
+    /** Plugin pushes (or updates) the agent catalog for this pairing. */
+    async pushAgentCatalog(pairingId, agents) {
+        await this.http.post(`integrations/pairings/${pairingId}/agent-catalog`, {
+            agents,
+        });
+    }
+    /** Plugin replaces the slash-command manifest for a single bound assistant. */
+    async putCommands(assistantId, commands) {
+        await this.http.put(`integrations/assistants/${assistantId}/commands`, { commands });
+    }
+    /** REST backfill after a WS reconnect. */
+    async inboundSince(sinceMessageId) {
+        const r = await this.http.get("integrations/inbound", {
+            params: { since_message_id: sinceMessageId },
+        });
+        return r.data;
+    }
+    /** Fetch the recent message history for a chat — used by the daemon to
+     *  rebuild conversation context before dispatching to a stateless
+     *  gateway. Backend returns up to 100 entries ASC by created_at. */
+    async getMessages(chatId, userId) {
+        const r = await this.http.get(`chats/${chatId}/messages`, {
+            params: { userId },
+        });
+        const rows = r.data?.messages;
+        return Array.isArray(rows) ? rows : [];
+    }
+    /** Agent reply — assistant message with optional inline buttons/approval. */
+    async postMessage(payload) {
+        const r = await this.http.post("messages", payload);
+        return r.data;
+    }
+    /** Request a presigned PUT for a file ≥500 KB that the agent wants to send. */
+    async createUploadUrl(params) {
+        const r = await this.http.post("integrations/files/upload-url", {
+            filename: params.filename,
+            mime_type: params.mimeType,
+            size: params.size,
+        });
+        return r.data;
+    }
+    /** List this pairing's active/paired state. Mostly used in setup wizard. */
+    async listPairings() {
+        const r = await this.http.get("integrations/pairings");
+        return r.data;
+    }
+    /**
+     * A2A peer discovery for an OpenClaw agent. Returns the user's other
+     * assistants the caller is allowed to reach (filtered by the
+     * agent_introductions table). The caller's assistant id is sent via
+     * X-Caller-Assistant-Id; backend uses it to scope visibility +
+     * enforce per-pair introduction rules.
+     *
+     * Used by the daemon's peers HTTP server (peers_list) so OpenClaw
+     * agents can discover Ava/Mario/etc. by name before initiating a
+     * peer message via sendToPeer().
+     */
+    async listPeers(callerAssistantId) {
+        const r = await this.http.get("peers", {
+            headers: { "X-Caller-Assistant-Id": String(callerAssistantId) },
+        });
+        return Array.isArray(r.data) ? r.data : [];
+    }
+    /**
+     * Initiate (or continue) a peer side-thread from this OpenClaw agent
+     * to another BGOS assistant. Backend creates/reuses the a2a chat,
+     * persists the message, and emits inbound_message to the target's
+     * channel adapter with peerConversationId + turnState set.
+     *
+     * @param parentMessageId  Required by the backend: anchors the
+     *   SideConversationCard in the originating chat. Daemon picks the
+     *   most-recent inbound for this caller's assistant when the agent
+     *   doesn't supply one (see peers-server.ts).
+     */
+    async sendToPeer(callerAssistantId, targetAssistantId, params) {
+        const r = await this.http.post(`peers/${targetAssistantId}/send`, {
+            text: params.text,
+            parentMessageId: params.parentMessageId,
+            ...(params.waitForReply !== undefined && {
+                waitForReply: params.waitForReply,
+            }),
+            ...(params.timeoutSeconds !== undefined && {
+                timeoutSeconds: params.timeoutSeconds,
+            }),
+            ...(params.turnState !== undefined && { turnState: params.turnState }),
+        }, {
+            headers: { "X-Caller-Assistant-Id": String(callerAssistantId) },
+        });
+        return r.data;
+    }
+}
+//# sourceMappingURL=bgos-api.js.map

package/dist/bgos-api.js.map

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

package/dist/bgos-ws.d.ts

@@ -0,0 +1,69 @@
+import type { BgosApi } from "./bgos-api.js";
+import { type AssistantBoundPayload, type AssistantUnboundPayload, type CallbackResultPayload, type CommandsUpdatedPayload, type InboundMessagePayload, type PairReadyPayload, type PairingRevokedPayload, type PluginConfig } from "./types.js";
+type EventMap = {
+    inbound_message: [InboundMessagePayload];
+    commands_updated: [CommandsUpdatedPayload];
+    pair_ready: [PairReadyPayload];
+    assistant_bound: [AssistantBoundPayload];
+    assistant_unbound: [AssistantUnboundPayload];
+    pairing_revoked: [PairingRevokedPayload];
+    callback_result: [CallbackResultPayload];
+    error: [Error];
+};
+/**
+ * Socket.IO client against BGOS. Handshake passes pairingToken as a query
+ * param; backend validates via bcrypt and joins the client to
+ * pairing:<id> + every assistant:<id> the pairing owns.
+ *
+ * Reconnect: exponential backoff 1s → 30s. On reconnect, the plugin
+ * should call triggerBackfill() which hits GET /integrations/inbound?since=...
+ * and re-emits missed user messages through the same inbound_message
+ * event — callers handle live + backfill identically.
+ */
+export declare class BgosWs {
+    private readonly cfg;
+    private readonly api;
+    private readonly emitter;
+    private socket;
+    private lastSeenMessageId;
+    private reconnectAttempts;
+    private manualClose;
+    /**
+     * De-dup cache for inbound message IDs. Without this, the same
+     * `inbound_message` can fire downstream twice — observed in prod
+     * 2026-05-10 when the daemon's ~33s reconnect cycle caused
+     * `triggerBackfill()` to re-emit live messages whose lastSeenMessageId
+     * cursor hadn't yet settled. Bounded at 500 entries (FIFO eviction).
+     */
+    private readonly processedIds;
+    constructor(cfg: PluginConfig, api: BgosApi);
+    on<K extends keyof EventMap>(event: K, listener: (...args: EventMap[K]) => void): this;
+    off<K extends keyof EventMap>(event: K, listener: (...args: EventMap[K]) => void): this;
+    connect(): Promise<void>;
+    /**
+     * Explicit reconnect-triggered backfill. Also callable on startup.
+     *
+     * COLD-START GUARD: when `lastSeenMessageId === 0` at the start of this
+     * call, treat it as a fresh-process boot. We still fetch the inbound
+     * history to seed the cursor + dedup cache, but we do NOT emit the
+     * messages downstream. Without this guard every daemon restart re-plays
+     * the entire chat history (observed in prod 2026-05-10: chat 917 saw 20+
+     * replies to old messages within a 2-minute window after a daemon
+     * upgrade-restart).
+     *
+     * Trade-off: messages sent DURING the daemon-restart window are dropped.
+     * Better fix: persist `lastSeenMessageId` to disk so cold start can
+     * resume from where the previous process left off — deferred follow-up.
+     */
+    triggerBackfill(): Promise<void>;
+    setLastSeen(messageId: number): void;
+    disconnect(): void;
+    /**
+     * Translate the wire-level payload (snake_case) into our camelCase type.
+     * Backend already emits camelCase via the helper service, but defensively
+     * handle both so we don't drop messages if someone changes the emitter.
+     */
+    private normalizeInbound;
+}
+export {};
+//# sourceMappingURL=bgos-ws.d.ts.map

package/dist/bgos-ws.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bgos-ws.d.ts","sourceRoot":"","sources":["../src/bgos-ws.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EAClB,MAAM,YAAY,CAAC;AAEpB,KAAK,QAAQ,GAAG;IACd,eAAe,EAAE,CAAC,qBAAqB,CAAC,CAAC;IACzC,gBAAgB,EAAE,CAAC,sBAAsB,CAAC,CAAC;IAC3C,UAAU,EAAE,CAAC,gBAAgB,CAAC,CAAC;IAC/B,eAAe,EAAE,CAAC,qBAAqB,CAAC,CAAC;IACzC,iBAAiB,EAAE,CAAC,uBAAuB,CAAC,CAAC;IAC7C,eAAe,EAAE,CAAC,qBAAqB,CAAC,CAAC;IACzC,eAAe,EAAE,CAAC,qBAAqB,CAAC,CAAC;IACzC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;CAChB,CAAC;AAEF;;;;;;;;;GASG;AACH,qBAAa,MAAM;IAgBf,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAhBtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,WAAW,CAAS;IAC5B;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA8B;gBAGxC,GAAG,EAAE,YAAY,EACjB,GAAG,EAAE,OAAO;IAG/B,EAAE,CAAC,CAAC,SAAS,MAAM,QAAQ,EACzB,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,GACvC,IAAI;IAKP,GAAG,CAAC,CAAC,SAAS,MAAM,QAAQ,EAC1B,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,GACvC,IAAI;IAKD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAiE9B;;;;;;;;;;;;;;OAcG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IA6BtC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAMpC,UAAU,IAAI,IAAI;IAMlB;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;CA2BzB"}

package/dist/bgos-ws.js

@@ -0,0 +1,172 @@
+import { io } from "socket.io-client";
+import { EventEmitter } from "node:events";
+import { ProcessedIdsCache } from "./processed-ids.js";
+import { PairingRevokedError, } from "./types.js";
+/**
+ * Socket.IO client against BGOS. Handshake passes pairingToken as a query
+ * param; backend validates via bcrypt and joins the client to
+ * pairing:<id> + every assistant:<id> the pairing owns.
+ *
+ * Reconnect: exponential backoff 1s → 30s. On reconnect, the plugin
+ * should call triggerBackfill() which hits GET /integrations/inbound?since=...
+ * and re-emits missed user messages through the same inbound_message
+ * event — callers handle live + backfill identically.
+ */
+export class BgosWs {
+    cfg;
+    api;
+    emitter = new EventEmitter();
+    socket = null;
+    lastSeenMessageId = 0;
+    reconnectAttempts = 0;
+    manualClose = false;
+    /**
+     * De-dup cache for inbound message IDs. Without this, the same
+     * `inbound_message` can fire downstream twice — observed in prod
+     * 2026-05-10 when the daemon's ~33s reconnect cycle caused
+     * `triggerBackfill()` to re-emit live messages whose lastSeenMessageId
+     * cursor hadn't yet settled. Bounded at 500 entries (FIFO eviction).
+     */
+    processedIds = new ProcessedIdsCache(500);
+    constructor(cfg, api) {
+        this.cfg = cfg;
+        this.api = api;
+    }
+    on(event, listener) {
+        this.emitter.on(event, listener);
+        return this;
+    }
+    off(event, listener) {
+        this.emitter.off(event, listener);
+        return this;
+    }
+    async connect() {
+        this.manualClose = false;
+        const socket = io(this.cfg.baseUrl, {
+            path: "/socket.io",
+            query: { pairingToken: this.cfg.pairingToken },
+            transports: ["websocket"],
+            reconnection: true,
+            reconnectionDelay: this.cfg.reconnect.initialDelayMs,
+            reconnectionDelayMax: this.cfg.reconnect.maxDelayMs,
+            reconnectionAttempts: Infinity,
+        });
+        socket.on("connect", () => {
+            this.reconnectAttempts = 0;
+        });
+        socket.on("reconnect", () => void this.triggerBackfill());
+        socket.on("inbound_message", (payload) => {
+            const msg = this.normalizeInbound(payload);
+            if (!msg)
+                return;
+            // Idempotency gate — skip if we've already dispatched this messageId.
+            // See ProcessedIdsCache for the prod incident this prevents.
+            if (!this.processedIds.markIfFirstTime(msg.messageId)) {
+                return;
+            }
+            if (msg.messageId > this.lastSeenMessageId) {
+                this.lastSeenMessageId = msg.messageId;
+            }
+            this.emitter.emit("inbound_message", msg);
+        });
+        socket.on("commands_updated", (p) => this.emitter.emit("commands_updated", p));
+        socket.on("pair_ready", (p) => this.emitter.emit("pair_ready", p));
+        socket.on("assistant_bound", (p) => this.emitter.emit("assistant_bound", p));
+        socket.on("assistant_unbound", (p) => this.emitter.emit("assistant_unbound", p));
+        socket.on("pairing_revoked", (p) => {
+            this.emitter.emit("pairing_revoked", p);
+            this.emitter.emit("error", new PairingRevokedError("Pairing revoked by backend"));
+        });
+        socket.on("callback_result", (p) => this.emitter.emit("callback_result", p));
+        socket.on("connect_error", (err) => {
+            this.reconnectAttempts++;
+            this.emitter.emit("error", err);
+        });
+        this.socket = socket;
+    }
+    /**
+     * Explicit reconnect-triggered backfill. Also callable on startup.
+     *
+     * COLD-START GUARD: when `lastSeenMessageId === 0` at the start of this
+     * call, treat it as a fresh-process boot. We still fetch the inbound
+     * history to seed the cursor + dedup cache, but we do NOT emit the
+     * messages downstream. Without this guard every daemon restart re-plays
+     * the entire chat history (observed in prod 2026-05-10: chat 917 saw 20+
+     * replies to old messages within a 2-minute window after a daemon
+     * upgrade-restart).
+     *
+     * Trade-off: messages sent DURING the daemon-restart window are dropped.
+     * Better fix: persist `lastSeenMessageId` to disk so cold start can
+     * resume from where the previous process left off — deferred follow-up.
+     */
+    async triggerBackfill() {
+        try {
+            const isColdStart = this.lastSeenMessageId === 0;
+            const { messages } = await this.api.inboundSince(this.lastSeenMessageId);
+            for (const m of messages) {
+                // Same idempotency gate as the live WS handler. Backfill races
+                // against in-flight live emits during reconnect — without this
+                // check, a message that landed via WS just before disconnect can
+                // re-fire here and produce a duplicate dispatch.
+                if (!this.processedIds.markIfFirstTime(m.messageId)) {
+                    continue;
+                }
+                if (m.messageId > this.lastSeenMessageId) {
+                    this.lastSeenMessageId = m.messageId;
+                }
+                if (isColdStart) {
+                    // Cold start — seed only; never re-dispatch history.
+                    continue;
+                }
+                this.emitter.emit("inbound_message", m);
+            }
+        }
+        catch (err) {
+            this.emitter.emit("error", err instanceof Error ? err : new Error(String(err)));
+        }
+    }
+    setLastSeen(messageId) {
+        if (messageId > this.lastSeenMessageId) {
+            this.lastSeenMessageId = messageId;
+        }
+    }
+    disconnect() {
+        this.manualClose = true;
+        this.socket?.disconnect();
+        this.socket = null;
+    }
+    /**
+     * Translate the wire-level payload (snake_case) into our camelCase type.
+     * Backend already emits camelCase via the helper service, but defensively
+     * handle both so we don't drop messages if someone changes the emitter.
+     */
+    normalizeInbound(raw) {
+        if (!raw || typeof raw !== "object")
+            return null;
+        const r = raw;
+        const toInt = (v) => {
+            if (typeof v === "number")
+                return v;
+            if (typeof v === "string" && /^\d+$/.test(v))
+                return Number(v);
+            return 0;
+        };
+        const assistantId = toInt(r.assistantId ?? r.assistant_id);
+        const chatId = toInt(r.chatId ?? r.chat_id);
+        const messageId = toInt(r.messageId ?? r.message_id);
+        if (!assistantId || !chatId || !messageId)
+            return null;
+        return {
+            assistantId,
+            chatId,
+            messageId,
+            userId: String(r.userId ?? r.user_id ?? ""),
+            text: String(r.text ?? ""),
+            files: Array.isArray(r.files) ? r.files : [],
+            messageType: (r.messageType ?? r.message_type ?? "standard"),
+            commandName: (r.commandName ?? r.command_name ?? undefined),
+            commandArgs: (r.commandArgs ?? r.command_args ?? undefined),
+        };
+    }
+}
+//# sourceMappingURL=bgos-ws.js.map

package/dist/bgos-ws.js.map

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

package/dist/commands-sync.d.ts

@@ -0,0 +1,24 @@
+import type { BgosApi } from "./bgos-api.js";
+import type { CommandManifestEntry } from "./types.js";
+/**
+ * Per-assistant command manifest sync. Debounces rapid changes into at
+ * most one PUT every DEBOUNCE_MS. Analogous to Telegram plugin's
+ * setMyCommands flow (see bot-native-commands.ts in OpenClaw's telegram
+ * extension).
+ */
+export declare class CommandsSync {
+    private readonly api;
+    private static readonly DEBOUNCE_MS;
+    private readonly pending;
+    private timers;
+    constructor(api: BgosApi);
+    /**
+     * Queue a replacement manifest for an assistant. Coalesces multiple
+     * calls within DEBOUNCE_MS into a single PUT.
+     */
+    schedule(assistantId: number, commands: CommandManifestEntry[]): void;
+    /** Force-sync all pending — useful on graceful shutdown or pair-ready. */
+    flushAll(): Promise<void>;
+    private flush;
+}
+//# sourceMappingURL=commands-sync.d.ts.map

package/dist/commands-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands-sync.d.ts","sourceRoot":"","sources":["../src/commands-sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD;;;;;GAKG;AACH,qBAAa,YAAY;IAMX,OAAO,CAAC,QAAQ,CAAC,GAAG;IALhC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAQ;IAE3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6C;IACrE,OAAO,CAAC,MAAM,CAAqC;gBAEtB,GAAG,EAAE,OAAO;IAEzC;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,EAAE,GAAG,IAAI;IAUrE,0EAA0E;IACpE,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;YAKjB,KAAK;CAOpB"}

package/dist/commands-sync.js

@@ -0,0 +1,43 @@
+/**
+ * Per-assistant command manifest sync. Debounces rapid changes into at
+ * most one PUT every DEBOUNCE_MS. Analogous to Telegram plugin's
+ * setMyCommands flow (see bot-native-commands.ts in OpenClaw's telegram
+ * extension).
+ */
+export class CommandsSync {
+    api;
+    static DEBOUNCE_MS = 2000;
+    pending = new Map();
+    timers = new Map();
+    constructor(api) {
+        this.api = api;
+    }
+    /**
+     * Queue a replacement manifest for an assistant. Coalesces multiple
+     * calls within DEBOUNCE_MS into a single PUT.
+     */
+    schedule(assistantId, commands) {
+        this.pending.set(assistantId, commands);
+        const existing = this.timers.get(assistantId);
+        if (existing)
+            clearTimeout(existing);
+        const t = setTimeout(() => {
+            void this.flush(assistantId);
+        }, CommandsSync.DEBOUNCE_MS);
+        this.timers.set(assistantId, t);
+    }
+    /** Force-sync all pending — useful on graceful shutdown or pair-ready. */
+    async flushAll() {
+        const ids = [...this.pending.keys()];
+        await Promise.all(ids.map((id) => this.flush(id)));
+    }
+    async flush(assistantId) {
+        const commands = this.pending.get(assistantId);
+        this.pending.delete(assistantId);
+        this.timers.delete(assistantId);
+        if (!commands)
+            return;
+        await this.api.putCommands(assistantId, commands);
+    }
+}
+//# sourceMappingURL=commands-sync.js.map

package/dist/commands-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands-sync.js","sourceRoot":"","sources":["../src/commands-sync.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,OAAO,YAAY;IAMM;IALrB,MAAM,CAAU,WAAW,GAAG,IAAI,CAAC;IAE1B,OAAO,GAAG,IAAI,GAAG,EAAkC,CAAC;IAC7D,MAAM,GAAG,IAAI,GAAG,EAA0B,CAAC;IAEnD,YAA6B,GAAY;QAAZ,QAAG,GAAH,GAAG,CAAS;IAAG,CAAC;IAE7C;;;OAGG;IACH,QAAQ,CAAC,WAAmB,EAAE,QAAgC;QAC5D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC9C,IAAI,QAAQ;YAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;QACrC,MAAM,CAAC,GAAG,UAAU,CAAC,GAAG,EAAE;YACxB,KAAK,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAC/B,CAAC,EAAE,YAAY,CAAC,WAAW,CAAC,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAClC,CAAC;IAED,0EAA0E;IAC1E,KAAK,CAAC,QAAQ;QACZ,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QACrC,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC;IAEO,KAAK,CAAC,KAAK,CAAC,WAAmB;QACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC/C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACjC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAChC,IAAI,CAAC,QAAQ;YAAE,OAAO;QACtB,MAAM,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACpD,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,4 @@
+import type { PluginConfig } from "./types.js";
+export declare function loadConfigFromEnv(): PluginConfig;
+export declare function loadConfigFromPluginCfg(cfg: unknown): PluginConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAS/C,wBAAgB,iBAAiB,IAAI,YAAY,CAOhD;AAaD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,CAUlE"}

package/dist/config.js

@@ -0,0 +1,36 @@
+import { z } from "zod";
+const DEFAULT_BASE_URL = "https://api.brandgrowthos.ai";
+const envSchema = z.object({
+    BGOS_BASE_URL: z.string().url().optional(),
+    BGOS_PAIRING_TOKEN: z.string().min(20),
+});
+export function loadConfigFromEnv() {
+    const env = envSchema.parse(process.env);
+    return {
+        baseUrl: (env.BGOS_BASE_URL ?? DEFAULT_BASE_URL).replace(/\/+$/, ""),
+        pairingToken: env.BGOS_PAIRING_TOKEN,
+        reconnect: { initialDelayMs: 1000, maxDelayMs: 30000 },
+    };
+}
+const cfgSchema = z.object({
+    baseUrl: z.string().url().optional(),
+    pairingToken: z.string().min(20),
+    reconnect: z
+        .object({
+        initialDelayMs: z.number().int().positive().optional(),
+        maxDelayMs: z.number().int().positive().optional(),
+    })
+        .optional(),
+});
+export function loadConfigFromPluginCfg(cfg) {
+    const parsed = cfgSchema.parse(cfg);
+    return {
+        baseUrl: (parsed.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, ""),
+        pairingToken: parsed.pairingToken,
+        reconnect: {
+            initialDelayMs: parsed.reconnect?.initialDelayMs ?? 1000,
+            maxDelayMs: parsed.reconnect?.maxDelayMs ?? 30000,
+        },
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,gBAAgB,GAAG,8BAA8B,CAAC;AAExD,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IACzB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAC1C,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;CACvC,CAAC,CAAC;AAEH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACzC,OAAO;QACL,OAAO,EAAE,CAAC,GAAG,CAAC,aAAa,IAAI,gBAAgB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QACpE,YAAY,EAAE,GAAG,CAAC,kBAAkB;QACpC,SAAS,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE;KACvD,CAAC;AACJ,CAAC;AAED,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IACzB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACpC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;IAChC,SAAS,EAAE,CAAC;SACT,MAAM,CAAC;QACN,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QACtD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;KACnD,CAAC;SACD,QAAQ,EAAE;CACd,CAAC,CAAC;AAEH,MAAM,UAAU,uBAAuB,CAAC,GAAY;IAClD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpC,OAAO;QACL,OAAO,EAAE,CAAC,MAAM,CAAC,OAAO,IAAI,gBAAgB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QACjE,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,SAAS,EAAE;YACT,cAAc,EAAE,MAAM,CAAC,SAAS,EAAE,cAAc,IAAI,IAAI;YACxD,UAAU,EAAE,MAAM,CAAC,SAAS,EAAE,UAAU,IAAI,KAAK;SAClD;KACF,CAAC;AACJ,CAAC"}

package/dist/daemon-helpers.d.ts

@@ -0,0 +1,109 @@
+import type { BgosMessageEnvelope, ChatMessage, ChatMessageContent, InboundFile } from "./types.js";
+/**
+ * Convert an inbound user message (text + files) into one OpenAI-compat
+ * ChatMessage.
+ *
+ * - Images become `image_url` blocks for vision-capable models.
+ * - Non-image files become text markers `[user attached: name — mime — url]`
+ *   so non-vision agents still know something was attached.
+ * - URL-less files (legacy inline-only entries) are skipped — we cannot
+ *   reference them from a stateless dispatch.
+ *
+ * If the message ends up with no usable content blocks, we collapse to
+ * the original text (preserves the empty-string contract upstream).
+ */
+export declare function buildInboundChatMessage(params: {
+    text: string;
+    files: InboundFile[];
+}): ChatMessage;
+/**
+ * Build an optional 1-token marker line summarising read-only context
+ * fields on a BGOS message envelope. Returns "" when there's nothing to
+ * surface.
+ *
+ * Used to decorate prior history turns so the agent sees that a message
+ * was a reply / forward / pinned without bloating the content blocks.
+ */
+export declare function buildContextMarkers(env: BgosMessageEnvelope["message"]): string;
+/** Map a BgosMessageEnvelope.files row into the InboundFile shape. */
+export declare function envelopeFileToInbound(f: NonNullable<BgosMessageEnvelope["message"]["files"]>[number]): InboundFile | null;
+/**
+ * Map BGOS chat-history rows to the OpenAI-compat `messages` array.
+ * Skips internal `agent_error` turns; keeps file-only / voice-only
+ * turns as content blocks (image_url for images, text markers for the
+ * rest) so prior multimodal context survives. Caps at `limit`
+ * most-recent entries.
+ */
+export declare function mapToOpenAIRoles(rows: BgosMessageEnvelope[], limit: number): ChatMessage[];
+/** Deep-equality helper used to dedupe an already-present last user
+ *  turn against the live inbound. JSON.stringify is acceptable here —
+ *  content blocks are tiny and rare to mismatch. */
+export declare function chatMessageContentEqual(a: ChatMessageContent, b: ChatMessageContent): boolean;
+/**
+ * Bridge-local commands (`/new`, `/retry`, `/status`) are intercepted
+ * by the plugin BEFORE forwarding to the gateway. See
+ * bgos-agent-capabilities.md §7 — these commands have channel-local
+ * semantics (history reset, re-dispatch, liveness probe) that must NOT
+ * roll through to the agent.
+ *
+ * The handler is a tiny state machine:
+ *
+ *   - `/new` records a "history-reset point" (the inbound messageId).
+ *     Subsequent dispatches filter the BGOS history fetch to entries
+ *     strictly newer than this point — effectively wiping context for
+ *     the chat without touching the database.
+ *
+ *   - `/retry` re-dispatches the most-recent user turn to the gateway
+ *     (looked up via the BGOS history fetch), so the user can ask the
+ *     agent to take another swing without re-typing.
+ *
+ *   - `/status` replies inline with the daemon's current health (route,
+ *     gateway up/down, last reply latency, pairing id). No network round
+ *     trip — pure introspection.
+ */
+export type BridgeCommandName = "new" | "retry" | "status";
+export declare const BRIDGE_LOCAL_COMMANDS: ReadonlySet<BridgeCommandName>;
+export declare function isBridgeLocalCommand(cmd: string): cmd is BridgeCommandName;
+/**
+ * Per-chat history-reset cursor produced by `/new`. Subsequent dispatches
+ * read this map and skip rows with `id <= cursor`. Stays in-process —
+ * a daemon restart wipes the resets, which is fine: the worst case is
+ * one extra turn of unwanted history and the user can `/new` again.
+ */
+export declare class HistoryResetState {
+    private readonly cursors;
+    /** Record a reset point for `chatId`. Inclusive — the inbound `/new`
+     *  message itself is filtered out so the agent doesn't see it. */
+    record(chatId: number, messageId: number): void;
+    /** Filter a list of envelopes for one chat, dropping entries that are
+     *  at or older than the most-recent `/new` cursor. */
+    filterRows(chatId: number, rows: BgosMessageEnvelope[]): BgosMessageEnvelope[];
+    /** Forget the cursor for a chat (e.g. on chat delete). */
+    clear(chatId: number): void;
+    /** Test introspection. */
+    size(): number;
+}
+/**
+ * Build the per-turn system message that surfaces shared-recipient
+ * context to the agent. Returns null when the inbound message isn't a
+ * shared-assistant scenario (no addendum needed).
+ *
+ * The message goes into the `messages` array right before the live
+ * user turn so the agent sees it in-prompt and can key per-user data
+ * off `userId` to keep recipients isolated.
+ */
+export declare function buildSharedRecipientSystem(params: {
+    isSharedRecipient?: boolean;
+    userId: string;
+    shareOwnerUserId?: string | null;
+}): ChatMessage | null;
+/**
+ * Find the most-recent user turn (text + files) in a sequence of
+ * envelopes — used by `/retry` to look up the prior turn to re-dispatch.
+ * Excludes the `/retry` envelope itself when its messageId is supplied.
+ */
+export declare function findMostRecentUserTurn(rows: BgosMessageEnvelope[], excludeMessageId?: number): {
+    text: string;
+    files: InboundFile[];
+} | null;
+//# sourceMappingURL=daemon-helpers.d.ts.map

package/dist/daemon-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-helpers.d.ts","sourceRoot":"","sources":["../src/daemon-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB,GAAG,WAAW,CAwBd;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,mBAAmB,CAAC,SAAS,CAAC,GAAG,MAAM,CAQ/E;AAED,sEAAsE;AACtE,wBAAgB,qBAAqB,CACnC,CAAC,EAAE,WAAW,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAC9D,WAAW,GAAG,IAAI,CASpB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,mBAAmB,EAAE,EAC3B,KAAK,EAAE,MAAM,GACZ,WAAW,EAAE,CA2Bf;AAED;;oDAEoD;AACpD,wBAAgB,uBAAuB,CACrC,CAAC,EAAE,kBAAkB,EACrB,CAAC,EAAE,kBAAkB,GACpB,OAAO,CAGT;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE3D,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,iBAAiB,CAI/D,CAAC;AAEH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,GACV,GAAG,IAAI,iBAAiB,CAE1B;AAED;;;;;GAKG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IAErD;sEACkE;IAClE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAI/C;0DACsD;IACtD,UAAU,CACR,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,mBAAmB,EAAE,GAC1B,mBAAmB,EAAE;IAMxB,0DAA0D;IAC1D,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI3B,0BAA0B;IAC1B,IAAI,IAAI,MAAM;CAGf;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IACjD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC,GAAG,WAAW,GAAG,IAAI,CAOrB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,mBAAmB,EAAE,EAC3B,gBAAgB,CAAC,EAAE,MAAM,GACxB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,WAAW,EAAE,CAAA;CAAE,GAAG,IAAI,CAgB/C"}