gobot-channel-bgos 0.3.0

package/README.md

@@ -0,0 +1,121 @@
+# gobot-channel-bgos
+
+BGOS channel adapter for [Gobot](https://github.com/autonomee/gobot) — Socket.IO + REST client, full outbound modality coverage (text, inline buttons, approvals, ask-user-input pop-under, files/images/videos, typing), and a pair-CLI for first-time setup.
+
+The fork ([`BrandGrowthOS/gobot-bgos-fork`](https://github.com/BrandGrowthOS/gobot-bgos-fork) — private) wires this package into Gobot's existing message pipeline. Telegram and BGOS run side-by-side; replies always return to whichever channel the user wrote in.
+
+## Install
+
+```bash
+npm i -g gobot-channel-bgos
+```
+
+The package is published to npm as `gobot-channel-bgos`. The fork lists it under `optionalDependencies`, so a stock Gobot install still runs without it (BGOS support stays inert until the package is present).
+
+## Pair
+
+After standing up Gobot on your host (Mac mini, VPS, whatever), generate a pair code in BGOS (Integrations screen → "Pair Gobot") and run:
+
+```bash
+gobot-pair-bgos BGOS-XXXX-YY --device-label mac-mini
+```
+
+This:
+
+1. POSTs `/integrations/pair-exchange` with the code + your device label.
+2. Writes the pairing token to `~/.gobot/secrets/bgos.json` (mode 0600).
+3. Exits 0 on success, non-zero with a diagnostic on failure.
+
+## Environment variables
+
+The adapter resolves config in order: explicit constructor arg → env var → `~/.gobot/secrets/bgos.json`.
+
+| Var | Default | Purpose |
+|---|---|---|
+| `BGOS_PAIRING_TOKEN` | _from secrets file_ | The token written by `gobot-pair-bgos`. |
+| `BGOS_BASE_URL` | `https://api.brandgrowthos.ai` | BGOS backend root. |
+| `GOBOT_HOME` | `~/.gobot` | Where the adapter persists state (`bgos_last_id` cursor + secrets dir). |
+| `GOBOT_HOME_CHANNEL` | `both` | Destination for proactive (no-origin) messages: `telegram` \| `bgos` \| `both`. |
+| `GOBOT_POLL_INTERVAL` | `5` (seconds) | REST backfill interval. Set to `0` to disable polling once the server-side WS push gap is fixed. |
+
+## Prerequisites
+
+- The fork (`BrandGrowthOS/gobot-bgos-fork`) must be checked out and running on the host. The fork's loader auto-discovers `gobot-channel-bgos` and wires the adapter into Gobot's bootstrap.
+- Bun 1.x (Gobot's runtime) — npm-installed packages work fine.
+- A reachable BGOS backend (production by default; point `BGOS_BASE_URL` elsewhere for testing).
+
+## Architecture in one diagram
+
+```
+┌────────────────── Gobot host process (Bun) ───────────────────┐
+│                                                               │
+│  grammY Telegram handler ──┐                                  │
+│                            ▼                                  │
+│  ┌──────────────────────────────────────────────────────────┐ │
+│  │ processMessageForAgent({ origin, agentRoute, text,       │ │
+│  │                          attachments, replyHandle, ... })│ │
+│  │ — fork-exported wrapper around Gobot's Claude pipeline   │ │
+│  └──────────────────────────────────────────────────────────┘ │
+│                            ▲                                  │
+│                            │                                  │
+│  ┌──────────────────── BGOSAdapter ───────────────────────┐  │
+│  │ bgos-ws.ts (Socket.IO)  ◀── REST backfill cursor ◀──── │  │
+│  │ bgos-api.ts (REST)                                     │  │
+│  │ outbound.ts: sendText / sendButtons / sendApproval ... │  │
+│  │ inbound-handler.ts: builds replyHandle, calls dispatch │  │
+│  └────────────────────────────────────────────────────────┘  │
+└───────────────────────────────────────────────────────────────┘
+                                │
+                                ▼
+                       BGOS backend (api.brandgrowthos.ai)
+```
+
+## Troubleshooting
+
+**No replies in BGOS, but Telegram works:**
+- Tail `~/.gobot/logs/bgos-daemon.log` (the fork's loader writes here). Look for `whoami OK`, `connected`, `catalog pushed`.
+- Confirm `~/.gobot/secrets/bgos.json` exists and is readable: `cat ~/.gobot/secrets/bgos.json | jq .pairingId`.
+- Re-pair via the BGOS Integrations card if the pairing was revoked — adapter logs `PAIRING_REVOKED` on 401.
+
+**Replies are duplicated after every restart:**
+- The persisted cursor at `$GOBOT_HOME/bgos_last_id` failed to update. This file MUST advance with every processed message — if it stays at 0, every restart replays history.
+- Reset cursor manually: `echo <max-message-id> > ~/.gobot/bgos_last_id`. Or `rm` it to start fresh (will replay everything once).
+
+**Logs:** the fork pipes adapter output through Gobot's logger. On a default Mac install, look in `~/.gobot/logs/`.
+
+**Reset everything:**
+```bash
+rm -rf ~/.gobot/secrets ~/.gobot/bgos_last_id
+gobot-pair-bgos <NEW-CODE>
+# restart Gobot
+```
+
+## What lives in this package
+
+| Module | Role |
+|---|---|
+| `BGOSAdapter` (`src/adapter.ts`) | Lifecycle, route map, dispatch injection, poll loop |
+| `BgosOutbound` (`src/outbound.ts`) | All outbound modalities |
+| `inbound-handler.ts` | WS event → Gobot dispatch translator |
+| `attachment-bridge.ts` | BGOS files ⇄ local file paths (S3 + base64) |
+| `agent-hints.ts` | System-prompt addendum injected at dispatch |
+| `default-commands.ts` | 7 seeded slash commands |
+| `last-id-store.ts` | Persistent inbound cursor (CRITICAL — see source) |
+| `pair-cli.ts` | `gobot-pair-bgos` CLI |
+| `home-channel.ts` | Resolves `GOBOT_HOME_CHANNEL` for proactive messages |
+
+## Development
+
+```bash
+git clone https://github.com/BrandGrowthOS/gobot-channel-bgos
+cd gobot-channel-bgos
+npm install
+npm test          # vitest
+npm run build     # tsc + finalize-daemon
+```
+
+The package is also mirrored inside the BGOS monorepo at `gobot-channel-bgos/` — the public repo is the source of truth (matching the Hermes pattern).
+
+## License
+
+MIT.

package/dist/adapter.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Main adapter for the Gobot ↔ BGOS channel.
+ *
+ * Lifecycle:
+ *   1. Fork instantiates `new BGOSAdapter(config)`. Optionally calls
+ *      `setDispatch(fn)` immediately afterwards if dispatch is ready.
+ *   2. Fork calls `await adapter.start()`. Adapter:
+ *        - GET /integrations/me to populate the assistant→agent_route map
+ *        - opens the Socket.IO connection
+ *        - pushes the agent catalog (see `setCatalog()` for source)
+ *        - seeds default slash-commands for empty manifests
+ *        - replays missed messages via REST backfill from the persisted
+ *          cursor (CRITICAL — see last-id-store)
+ *        - starts a poll loop fallback for the server-side WS push gap
+ *          (mirrors the Hermes adapter; toggle via GOBOT_POLL_INTERVAL)
+ *   3. Inbound events flow through `inbound-handler.ts` which calls the
+ *      registered dispatch function.
+ *   4. Fork calls `await adapter.stop()` on shutdown.
+ *
+ * Reference: `hermes-channel-bgos/src/hermes_channel_bgos/bgos_adapter.py`
+ * — same shape, ported to TypeScript with Node-idiomatic event handling.
+ */
+import { BgosApi } from "./bgos-api.js";
+import { BgosOutbound } from "./outbound.js";
+import { ApprovalHandler } from "./approval-handler.js";
+import { CommandsSync } from "./commands-sync.js";
+import { ToolProgressOrchestrator } from "./tool-progress.js";
+import { type CatalogAgent } from "./catalog-sync.js";
+import { type CommandSeedMode } from "./default-commands.js";
+import { type DispatchFn } from "./inbound-handler.js";
+/** Public configuration the fork passes in. Mirrors `PluginConfig` plus
+ *  optional Gobot-specific knobs. */
+export interface BgosConfig {
+    /** Backend base URL (e.g. https://api.brandgrowthos.ai). */
+    baseUrl?: string;
+    /** Pairing token from `~/.gobot/secrets/bgos.json`. */
+    pairingToken?: string;
+    /** Reconnect tuning. Defaults: 1s initial, 30s max. */
+    reconnect?: {
+        initialDelayMs?: number;
+        maxDelayMs?: number;
+    };
+    /** Optional agent catalog to push on connect. If omitted, the fork
+     *  can call `setCatalog([...])` later or the catalog stays whatever
+     *  was registered at pair time. */
+    agents?: CatalogAgent[];
+    /** Optional system-prompt prefix per agent_route. Adapter appends
+     *  `BGOS_AGENT_HINTS` to whatever this returns at dispatch time. */
+    getSystemPrompt?: (agentRoute: string) => string;
+    /**
+     * Override the default-commands seed strategy. Defaults to whatever
+     * `GOBOT_BGOS_RESEED_COMMANDS` resolves to (which itself defaults to
+     * `"auto"`).
+     *
+     * Use `"safe"` to also seed when the backend's `whoami` doesn't return
+     * `command_count` (older deploys), or `"always"` to force a reseed
+     * after fixing a stuck manifest.
+     */
+    commandSeedMode?: CommandSeedMode;
+}
+export declare class BGOSAdapter {
+    /** REST client — public so the fork can use it for ad-hoc operations
+     *  (e.g. renaming chats, fetching history). */
+    readonly api: BgosApi;
+    /** Outbound modalities — public so proactive (no-origin) cron paths in
+     *  the fork can push messages directly without an inbound trigger. */
+    readonly outbound: BgosOutbound;
+    /** Approval bridge — public so the fork's task-queue can register +
+     *  resolve approvals without re-routing through `_handle_callback`. */
+    readonly approvals: ApprovalHandler;
+    /** Slash-command manifest sync — public so the fork can call
+     *  `commandsSync.schedule(assistantId, commands)` whenever Gobot's
+     *  user-defined commands change. */
+    readonly commandsSync: CommandsSync;
+    /** Tool-progress card orchestrator — wired into `ReplyHandle`
+     *  (sendToolStart + finalizeTurn). The fork's BGOS dispatch should
+     *  call replyHandle.sendToolStart(toolName) per LIVE tool_use event
+     *  (via callClaudeStreaming's onToolStart hook) and finalizeTurn()
+     *  after the agent's text reply lands. Public so proactive paths can
+     *  also emit cards if they ever run tools server-side. */
+    readonly toolProgress: ToolProgressOrchestrator;
+    private readonly cfg;
+    private readonly ws;
+    private readonly assistantToRoute;
+    private dispatch;
+    private catalog;
+    private getSystemPrompt;
+    private commandSeedModeOverride;
+    private pairingId;
+    private pollTimer;
+    private started;
+    constructor(input?: BgosConfig | unknown);
+    /** Resolve the effective seed mode — explicit override wins over env. */
+    private getCommandSeedMode;
+    /** The fork calls this at boot to install Gobot's dispatch function.
+     *  Safe to call multiple times — last call wins. */
+    setDispatch(fn: DispatchFn): void;
+    /** Replace the agent catalog (the next `start()` or call to
+     *  `pushCatalog()` will use it). */
+    setCatalog(agents: CatalogAgent[]): void;
+    /** Look up the bound agent_route for an assistant id. Returns null
+     *  for unbound or unknown assistants. Also exposed publicly so the
+     *  fork's reply-side code can correlate. */
+    getRouteForAssistant(assistantId: number): string | null;
+    /** Snapshot of the assistant→agent_route map. Defensive copy. */
+    get routeMap(): ReadonlyMap<number, string>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /**
+     * Force-replace the slash-command manifest with `DEFAULT_COMMANDS` for
+     * every bound assistant (or just the ones in `assistantIds`). Useful
+     * when the BGOS slash picker is missing commands and you need to reset
+     * without re-pairing.
+     *
+     * Idempotent — safe to call repeatedly. Returns the per-assistant
+     * outcome so callers can log / surface failures.
+     */
+    reseedAllCommands(assistantIds?: ReadonlyArray<number>): Promise<Array<{
+        assistantId: number;
+        ok: boolean;
+        error?: string;
+    }>>;
+    private seedDefaultCommands;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAEL,KAAK,UAAU,EAChB,MAAM,sBAAsB,CAAC;AAa9B;qCACqC;AACrC,MAAM,WAAW,UAAU;IACzB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,SAAS,CAAC,EAAE;QACV,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF;;uCAEmC;IACnC,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;IACxB;wEACoE;IACpE,eAAe,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC;IACjD;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,qBAAa,WAAW;IACtB;mDAC+C;IAC/C,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB;0EACsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC;2EACuE;IACvE,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC;;wCAEoC;IACpC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC;;;;;8DAK0D;IAC1D,QAAQ,CAAC,YAAY,EAAE,wBAAwB,CAAC;IAEhD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6B;IAC9D,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,eAAe,CAA4B;IACnD,OAAO,CAAC,uBAAuB,CAAgC;IAC/D,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,OAAO,CAAS;gBAEZ,KAAK,GAAE,UAAU,GAAG,OAAmB;IAkBnD,yEAAyE;IACzE,OAAO,CAAC,kBAAkB;IAI1B;wDACoD;IACpD,WAAW,CAAC,EAAE,EAAE,UAAU,GAAG,IAAI;IAIjC;wCACoC;IACpC,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,IAAI;IAIxC;;gDAE4C;IAC5C,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIxD,iEAAiE;IACjE,IAAI,QAAQ,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAE1C;IAMK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAyHtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB3B;;;;;;;;OAQG;IACG,iBAAiB,CACrB,YAAY,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,GACnC,OAAO,CAAC,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;YA2CzD,mBAAmB;CAuBlC"}

package/dist/adapter.js

@@ -0,0 +1,291 @@
+/**
+ * Main adapter for the Gobot ↔ BGOS channel.
+ *
+ * Lifecycle:
+ *   1. Fork instantiates `new BGOSAdapter(config)`. Optionally calls
+ *      `setDispatch(fn)` immediately afterwards if dispatch is ready.
+ *   2. Fork calls `await adapter.start()`. Adapter:
+ *        - GET /integrations/me to populate the assistant→agent_route map
+ *        - opens the Socket.IO connection
+ *        - pushes the agent catalog (see `setCatalog()` for source)
+ *        - seeds default slash-commands for empty manifests
+ *        - replays missed messages via REST backfill from the persisted
+ *          cursor (CRITICAL — see last-id-store)
+ *        - starts a poll loop fallback for the server-side WS push gap
+ *          (mirrors the Hermes adapter; toggle via GOBOT_POLL_INTERVAL)
+ *   3. Inbound events flow through `inbound-handler.ts` which calls the
+ *      registered dispatch function.
+ *   4. Fork calls `await adapter.stop()` on shutdown.
+ *
+ * Reference: `hermes-channel-bgos/src/hermes_channel_bgos/bgos_adapter.py`
+ * — same shape, ported to TypeScript with Node-idiomatic event handling.
+ */
+import { BgosApi } from "./bgos-api.js";
+import { BgosWs } from "./bgos-ws.js";
+import { BgosOutbound } from "./outbound.js";
+import { ApprovalHandler } from "./approval-handler.js";
+import { CommandsSync } from "./commands-sync.js";
+import { ToolProgressOrchestrator } from "./tool-progress.js";
+import { syncCatalog } from "./catalog-sync.js";
+import { DEFAULT_COMMANDS, resolveCommandSeedMode, shouldSeedDefaults, } from "./default-commands.js";
+import { createInboundHandler, } from "./inbound-handler.js";
+import { loadLastId } from "./last-id-store.js";
+import { loadConfigFromEnv, loadConfigFromPluginCfg, } from "./config.js";
+export class BGOSAdapter {
+    /** REST client — public so the fork can use it for ad-hoc operations
+     *  (e.g. renaming chats, fetching history). */
+    api;
+    /** Outbound modalities — public so proactive (no-origin) cron paths in
+     *  the fork can push messages directly without an inbound trigger. */
+    outbound;
+    /** Approval bridge — public so the fork's task-queue can register +
+     *  resolve approvals without re-routing through `_handle_callback`. */
+    approvals;
+    /** Slash-command manifest sync — public so the fork can call
+     *  `commandsSync.schedule(assistantId, commands)` whenever Gobot's
+     *  user-defined commands change. */
+    commandsSync;
+    /** Tool-progress card orchestrator — wired into `ReplyHandle`
+     *  (sendToolStart + finalizeTurn). The fork's BGOS dispatch should
+     *  call replyHandle.sendToolStart(toolName) per LIVE tool_use event
+     *  (via callClaudeStreaming's onToolStart hook) and finalizeTurn()
+     *  after the agent's text reply lands. Public so proactive paths can
+     *  also emit cards if they ever run tools server-side. */
+    toolProgress;
+    cfg;
+    ws;
+    assistantToRoute = new Map();
+    dispatch = null;
+    catalog;
+    getSystemPrompt;
+    commandSeedModeOverride = null;
+    pairingId = null;
+    pollTimer = null;
+    started = false;
+    constructor(input = undefined) {
+        this.cfg =
+            input !== undefined
+                ? loadConfigFromPluginCfg(input)
+                : loadConfigFromEnv();
+        this.api = new BgosApi(this.cfg);
+        this.ws = new BgosWs(this.cfg, this.api);
+        this.outbound = new BgosOutbound(this.api);
+        this.approvals = new ApprovalHandler(this.outbound);
+        this.commandsSync = new CommandsSync(this.api);
+        this.toolProgress = new ToolProgressOrchestrator(this.api);
+        const inputCfg = input ?? {};
+        this.catalog = inputCfg.agents ?? [];
+        this.getSystemPrompt = inputCfg.getSystemPrompt ?? (() => "");
+        this.commandSeedModeOverride = inputCfg.commandSeedMode ?? null;
+    }
+    /** Resolve the effective seed mode — explicit override wins over env. */
+    getCommandSeedMode() {
+        return this.commandSeedModeOverride ?? resolveCommandSeedMode();
+    }
+    /** The fork calls this at boot to install Gobot's dispatch function.
+     *  Safe to call multiple times — last call wins. */
+    setDispatch(fn) {
+        this.dispatch = fn;
+    }
+    /** Replace the agent catalog (the next `start()` or call to
+     *  `pushCatalog()` will use it). */
+    setCatalog(agents) {
+        this.catalog = agents;
+    }
+    /** Look up the bound agent_route for an assistant id. Returns null
+     *  for unbound or unknown assistants. Also exposed publicly so the
+     *  fork's reply-side code can correlate. */
+    getRouteForAssistant(assistantId) {
+        return this.assistantToRoute.get(assistantId) ?? null;
+    }
+    /** Snapshot of the assistant→agent_route map. Defensive copy. */
+    get routeMap() {
+        return new Map(this.assistantToRoute);
+    }
+    // -------------------------------------------------------------------
+    // Lifecycle
+    // -------------------------------------------------------------------
+    async start() {
+        if (this.started)
+            return;
+        this.started = true;
+        // 1. whoami — populate route map + capture pairing id
+        const seedMode = this.getCommandSeedMode();
+        const emptyManifestAssistantIds = [];
+        try {
+            const me = await this.api.whoami();
+            this.pairingId = me.pairing_id;
+            for (const a of me.assistants ?? []) {
+                if (a.agent_route) {
+                    this.assistantToRoute.set(a.assistant_id, a.agent_route);
+                }
+                if (shouldSeedDefaults(a.command_count, seedMode)) {
+                    emptyManifestAssistantIds.push(a.assistant_id);
+                }
+            }
+            // eslint-disable-next-line no-console
+            console.log("[gobot-channel-bgos] whoami complete", {
+                assistantCount: me.assistants?.length ?? 0,
+                seedMode,
+                willSeed: emptyManifestAssistantIds.length,
+                assistants: (me.assistants ?? []).map((a) => ({
+                    id: a.assistant_id,
+                    route: a.agent_route,
+                    commandCount: a.command_count,
+                })),
+            });
+        }
+        catch (err) {
+            // eslint-disable-next-line no-console
+            console.warn("[gobot-channel-bgos] whoami failed (non-fatal):", err instanceof Error ? err.message : String(err));
+        }
+        // 2. Wire WS event handlers BEFORE connecting so we don't miss
+        // anything the server emits in the window between connect + handler
+        // registration.
+        const inboundHandler = createInboundHandler({
+            outbound: this.outbound,
+            getRouteForAssistant: (id) => this.getRouteForAssistant(id),
+            getDispatch: () => this.dispatch,
+            getSystemPrompt: (route) => this.getSystemPrompt(route),
+            toolProgress: this.toolProgress,
+        });
+        this.ws.on("inbound_message", (msg) => {
+            void inboundHandler(msg);
+        });
+        this.ws.on("callback_result", (p) => {
+            // Approval clicks (`__approval__:*`) are absorbed by the approvals
+            // bridge; non-approval clicks fall through (the agent will see the
+            // resulting `inbound_message` if the backend synthesizes one).
+            this.approvals.handleCallbackResult(p);
+        });
+        this.ws.on("assistant_bound", (p) => {
+            this.assistantToRoute.set(p.assistantId, p.agentRoute);
+            // Newly-bound assistants always start with zero commands, so we
+            // can safely seed the defaults.
+            void this.seedDefaultCommands(p.assistantId, "bind");
+        });
+        this.ws.on("assistant_unbound", (p) => {
+            this.assistantToRoute.delete(p.assistantId);
+        });
+        this.ws.on("commands_updated", (_p) => {
+            // No-op — the user changed commands via the BGOS UI; nothing for
+            // the adapter to do. Hook is reserved so the fork can subscribe
+            // later if it needs to re-render a local picker.
+        });
+        this.ws.on("error", (err) => {
+            // eslint-disable-next-line no-console
+            console.warn("[gobot-channel-bgos] WS error:", err instanceof Error ? err.message : String(err));
+        });
+        // 3. Seed last-seen cursor + connect WS
+        this.ws.setLastSeen(loadLastId());
+        await this.ws.connect();
+        // 4. Push the agent catalog if we have one + a pairing id
+        if (this.pairingId !== null && this.catalog.length > 0) {
+            await syncCatalog(this.api, this.pairingId, this.catalog);
+        }
+        // 5. Seed defaults for any assistant whose manifest is empty
+        for (const id of emptyManifestAssistantIds) {
+            await this.seedDefaultCommands(id, "startup");
+        }
+        // 6. Run the initial backfill — this is the load-bearing step that
+        // replays messages that arrived while the daemon was down. Cursor
+        // came from disk via setLastSeen above.
+        await this.ws.triggerBackfill();
+        // 7. Start poll-loop fallback. Server currently doesn't deliver
+        // `inbound_message` to integration sockets (Hermes-shipped workaround;
+        // see `hermes_integration_shipped.md`). Until that's fixed, we poll
+        // REST every GOBOT_POLL_INTERVAL seconds.
+        const intervalRaw = process.env.GOBOT_POLL_INTERVAL;
+        const interval = intervalRaw !== undefined && intervalRaw !== ""
+            ? Number(intervalRaw)
+            : 5;
+        if (Number.isFinite(interval) && interval > 0) {
+            this.pollTimer = setInterval(() => {
+                void this.ws.triggerBackfill();
+            }, interval * 1000);
+            // Don't keep Node alive just for this timer.
+            this.pollTimer.unref?.();
+        }
+    }
+    async stop() {
+        if (!this.started)
+            return;
+        this.started = false;
+        if (this.pollTimer !== null) {
+            clearInterval(this.pollTimer);
+            this.pollTimer = null;
+        }
+        this.approvals.shutdown();
+        this.ws.disconnect();
+        this.toolProgress.dispose();
+        try {
+            await this.commandsSync.flushAll();
+        }
+        catch {
+            /* swallow on shutdown — best effort */
+        }
+    }
+    /**
+     * Force-replace the slash-command manifest with `DEFAULT_COMMANDS` for
+     * every bound assistant (or just the ones in `assistantIds`). Useful
+     * when the BGOS slash picker is missing commands and you need to reset
+     * without re-pairing.
+     *
+     * Idempotent — safe to call repeatedly. Returns the per-assistant
+     * outcome so callers can log / surface failures.
+     */
+    async reseedAllCommands(assistantIds) {
+        let ids = assistantIds ? [...assistantIds] : [];
+        if (ids.length === 0) {
+            try {
+                const me = await this.api.whoami();
+                for (const a of me.assistants ?? []) {
+                    ids.push(a.assistant_id);
+                }
+            }
+            catch (err) {
+                return [
+                    {
+                        assistantId: -1,
+                        ok: false,
+                        error: err instanceof Error ? err.message : String(err),
+                    },
+                ];
+            }
+        }
+        const results = [];
+        for (const id of ids) {
+            try {
+                await this.api.putCommands(id, [...DEFAULT_COMMANDS]);
+                results.push({ assistantId: id, ok: true });
+            }
+            catch (err) {
+                results.push({
+                    assistantId: id,
+                    ok: false,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+        return results;
+    }
+    // -------------------------------------------------------------------
+    // Helpers
+    // -------------------------------------------------------------------
+    async seedDefaultCommands(assistantId, origin) {
+        try {
+            await this.api.putCommands(assistantId, [...DEFAULT_COMMANDS]);
+            // eslint-disable-next-line no-console
+            console.log("[gobot-channel-bgos] seeded default commands", { assistantId, origin, count: DEFAULT_COMMANDS.length });
+        }
+        catch (err) {
+            // eslint-disable-next-line no-console
+            console.warn("[gobot-channel-bgos] default command seed failed (non-fatal):", {
+                assistantId,
+                origin,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

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

package/dist/agent-hints.d.ts

@@ -0,0 +1,26 @@
+/**
+ * BGOS system-prompt addendum for Gobot agents.
+ *
+ * This block is appended to every Gobot agent's system prompt when the
+ * agent is dispatched via the BGOS origin. Mirrors Hermes's
+ * `PLATFORM_HINTS["bgos"]` content (see hermes-fork-patch) so agents
+ * speaking to BGOS through Gobot get the same capability surface.
+ *
+ * Source of truth for what BGOS exposes: `hermes-channel-bgos/docs/
+ * bgos-agent-capabilities.md`. When that doc changes, this string MUST
+ * change too — the `bgos-plugin-capability-sync` skill enforces this.
+ */
+/**
+ * The complete addendum, including its leading separator. Append to a
+ * system prompt verbatim.
+ */
+export declare const BGOS_AGENT_HINTS: string;
+/**
+ * Append BGOS_AGENT_HINTS to a base system prompt.
+ *
+ * Idempotent — calling twice on the same input yields the same output.
+ * The check uses the addendum's first line so trailing whitespace
+ * differences don't trigger duplication.
+ */
+export declare function buildSystemPromptWithHints(originalPrompt: string): string;
+//# sourceMappingURL=agent-hints.d.ts.map

package/dist/agent-hints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-hints.d.ts","sourceRoot":"","sources":["../src/agent-hints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA6GH;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAA0C,CAAC;AAE1E;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAOzE"}