codex-channel-bgos 0.2.0

package/dist/bgos-ws.js

@@ -0,0 +1,310 @@
+import { io } from "socket.io-client";
+import { EventEmitter } from "node:events";
+import { loadLastId, saveLastId } from "./last-id-store.js";
+import { normalizeVoiceRpc } from "./voice-rpc.js";
+import { PairingRevokedError, } from "./types.js";
+/** Resolve the storm-guard limit. 0 disables. Default 25. */
+function resolveStormLimit() {
+    const raw = process.env.CODEX_BGOS_BACKFILL_STORM_LIMIT;
+    if (raw === undefined || raw === "")
+        return 25;
+    const n = Number(raw);
+    if (!Number.isFinite(n) || n < 0)
+        return 25;
+    return Math.floor(n);
+}
+/**
+ * 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.
+ *
+ * Cursor authority is the DISK cursor (bgos_last_id): triggerBackfill reads
+ * loadLastId() at call time and the live WS path advances no cursor of its
+ * own. Dedupe + saveLastId happen in the inbound handler after the route
+ * resolves. Reconnect is handled at the Manager level (socket.io.on) because
+ * the Socket does not emit a `reconnect` reserved event in socket.io-client v4.
+ */
+export class BgosWs {
+    cfg;
+    api;
+    emitter = new EventEmitter();
+    socket = null;
+    reconnectAttempts = 0;
+    manualClose = false;
+    wsConnectedSince = null;
+    backfillInFlight = null;
+    typingThrottle = new Map();
+    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;
+    }
+    /** ISO timestamp of the current connection, or null when disconnected. */
+    get connectedSince() {
+        return this.wsConnectedSince;
+    }
+    /** Swap the pairing token (and optionally base URL) for re-pair recovery.
+     *  Caller reconnects (disconnect + connect) to apply it. */
+    updateToken(token, baseUrl) {
+        this.cfg = {
+            ...this.cfg,
+            pairingToken: token,
+            ...(baseUrl ? { baseUrl } : {}),
+        };
+    }
+    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;
+            this.wsConnectedSince = new Date().toISOString();
+            this.emitter.emit("connect");
+        });
+        socket.on("disconnect", () => {
+            this.wsConnectedSince = null;
+            this.emitter.emit("disconnect");
+        });
+        // Manager-level reconnect (the Socket does not emit `reconnect` in
+        // socket.io-client v4, the previous socket.on("reconnect") was dead
+        // code). The adapter refreshes identity + backfills on this.
+        socket.io.on("reconnect", () => {
+            this.emitter.emit("reconnect");
+        });
+        socket.on("inbound_message", (payload) => {
+            const msg = this.normalizeInbound(payload);
+            if (!msg)
+                return;
+            // No cursor advance here: the inbound handler dedupes + persists the
+            // disk cursor after the route resolves.
+            this.emitter.emit("inbound_message", msg);
+        });
+        socket.on("inbound_click", (payload) => {
+            const click = this.normalizeInboundClick(payload);
+            if (click)
+                this.emitter.emit("inbound_click", click);
+        });
+        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));
+        // Native voice control plane (mint / consult / dispatch). Frames are
+        // normalized + op-whitelisted here (G2 lesson: a malformed frame is
+        // dropped safely, the backend's own timeout surfaces it, but every
+        // well-formed op MUST pass through to the handler, which answers
+        // unserved ops with a descriptive error rather than silence).
+        socket.on("voice_rpc", (p) => {
+            const frame = normalizeVoiceRpc(p);
+            if (frame)
+                this.emitter.emit("voice_rpc", frame);
+        });
+        socket.on("connect_error", (err) => {
+            this.reconnectAttempts++;
+            this.emitter.emit("error", err);
+        });
+        this.socket = socket;
+    }
+    /**
+     * Backfill missed messages from the DISK cursor. Single-flight: concurrent
+     * calls (poll tick racing a reconnect) coalesce onto the same promise.
+     *
+     * `opts.initial` marks the boot backfill: when the disk cursor is 0 and the
+     * pairing already has history, page through it WITHOUT dispatching and seed
+     * the cursor to the newest id (cold-start guard), so a fresh install does
+     * not replay the entire history as new messages.
+     */
+    triggerBackfill(opts) {
+        if (this.backfillInFlight)
+            return this.backfillInFlight;
+        this.backfillInFlight = this.runBackfill(opts?.initial ?? false).finally(() => {
+            this.backfillInFlight = null;
+        });
+        return this.backfillInFlight;
+    }
+    async runBackfill(initial) {
+        try {
+            const since = loadLastId();
+            if (initial && since === 0) {
+                await this.coldStartSeed();
+                this.emitter.emit("backfill_ok");
+                return;
+            }
+            const { messages } = await this.api.inboundSince(since);
+            const normalized = [];
+            for (const raw of messages) {
+                const m = this.normalizeInbound(raw);
+                if (m)
+                    normalized.push(m);
+            }
+            const stormLimit = resolveStormLimit();
+            if (stormLimit > 0 && normalized.length > stormLimit) {
+                // Storm guard: fast-forward the cursor, skip dispatch, surface it.
+                let maxId = since;
+                for (const m of normalized)
+                    if (m.messageId > maxId)
+                        maxId = m.messageId;
+                saveLastId(maxId);
+                this.emitter.emit("backfill_storm", normalized.length);
+                return;
+            }
+            for (const m of normalized) {
+                // The inbound handler dedupes (processed-ids) + persists the cursor.
+                this.emitter.emit("inbound_message", m);
+            }
+            this.emitter.emit("backfill_ok");
+        }
+        catch (err) {
+            const e = err instanceof Error ? err : new Error(String(err));
+            this.emitter.emit("backfill_error", e);
+            this.emitter.emit("error", e);
+        }
+    }
+    /**
+     * Cold-start seed: page the entire history WITHOUT dispatching, advancing
+     * the disk cursor to the newest id. Bounded iterations to guarantee
+     * termination even if the backend paginates oddly.
+     */
+    async coldStartSeed() {
+        let cursor = 0;
+        for (let i = 0; i < 100; i++) {
+            const { messages } = await this.api.inboundSince(cursor);
+            let maxId = cursor;
+            let count = 0;
+            for (const raw of messages) {
+                const m = this.normalizeInbound(raw);
+                if (!m)
+                    continue;
+                count++;
+                if (m.messageId > maxId)
+                    maxId = m.messageId;
+            }
+            if (count === 0 || maxId <= cursor)
+                break;
+            saveLastId(maxId);
+            cursor = maxId;
+            // Small terminal page: almost certainly the end of history.
+            if (count < 2)
+                break;
+        }
+    }
+    /**
+     * Emit a client-side `typing` WS event (contract C4). Best-effort +
+     * throttled to 1 per 3s per chat. Safe on old backends: an unknown WS
+     * event is ignored server-side.
+     */
+    emitTyping(params) {
+        try {
+            const now = Date.now();
+            const last = this.typingThrottle.get(params.chatId) ?? 0;
+            if (now - last < 3000)
+                return;
+            this.typingThrottle.set(params.chatId, now);
+            this.socket?.emit("typing", {
+                chatId: params.chatId,
+                assistantId: params.assistantId,
+            });
+        }
+        catch {
+            /* best-effort, never break a reply path over a typing indicator */
+        }
+    }
+    disconnect() {
+        this.manualClose = true;
+        this.socket?.disconnect();
+        this.socket = null;
+        this.wsConnectedSince = 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;
+        // a2a side-thread markers, present only on peer-agent inbounds (the
+        // backend stamps them on the WS event). `toInt` yields 0 when absent;
+        // collapse that to undefined so ordinary user messages stay clean.
+        const peerConversationId = toInt(r.peerConversationId ?? r.peer_conversation_id) || undefined;
+        const turnStateRaw = r.turnState ?? r.turn_state;
+        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),
+            ...(peerConversationId !== undefined ? { peerConversationId } : {}),
+            ...(typeof turnStateRaw === "string" && turnStateRaw
+                ? { turnState: turnStateRaw }
+                : {}),
+        };
+    }
+    /** Normalize an inbound_click WS payload (camelCase or snake_case). */
+    normalizeInboundClick(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);
+        const callbackData = r.callbackData ?? r.callback_data;
+        if (!assistantId || !chatId || typeof callbackData !== "string") {
+            return null;
+        }
+        return {
+            assistantId,
+            chatId,
+            messageId,
+            userId: String(r.userId ?? r.user_id ?? ""),
+            optionId: toInt(r.optionId ?? r.option_id),
+            callbackData,
+            ...(typeof (r.buttonText ?? r.button_text) === "string"
+                ? { buttonText: String(r.buttonText ?? r.button_text) }
+                : {}),
+        };
+    }
+}
+//# 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/capabilities.d.ts

@@ -0,0 +1,28 @@
+/** The bundled, offline fallback shipped with the daemon. */
+export declare const BUNDLED_CAPABILITIES = "# BGOS Channel, Agent Capabilities\n\nYou are reachable from the BGOS chat app. Your text reply is delivered to the\nuser as a chat message. A few markers let you use richer BGOS features. Put each\nmarker on its own line. The daemon strips markers from the visible text.\n\n## Markdown\nSupported: **bold**, *italic*, `inline code`, fenced code blocks, [links](url),\n# / ## / ### headings, ordered and unordered lists, > blockquotes.\nNOT supported: tables (they do not lay out on mobile), inline images via\n![alt](url) (use MEDIA: instead), strikethrough. Do not escape punctuation; this\nis not Telegram MarkdownV2.\n\n## Sending files, images, videos (you to user)\nPut `MEDIA:/absolute/path/to/file` on its own line. The daemon infers the type\nfrom the extension and uploads it (inline under 500 KB, presigned S3 otherwise).\nCaps: image 10 MB, video 100 MB, audio 25 MB, document 25 MB. Multiple MEDIA:\nlines send multiple files in one bubble. Surrounding sentences remain visible.\n\n## Inline option buttons (non-blocking)\nOffer up to 6 tappable choices. The user can still type instead.\n[[BGOS_BUTTONS]]\nYes, ship it | ship\nHold off | hold\n[[/BGOS_BUTTONS]]\nEach line is `Label | value`. The value comes back to you as the user's next\nmessage when they tap. Any text before the block is the question.\n\n## ask_user_input (blocking questions)\nAsk 1 to 4 questions the user must answer before continuing.\n[[BGOS_ASK]]\nQ: Which environment?\nStaging | staging\nProduction | prod\nQ: Proceed now?\nnoskip\nYes | yes\n[[/BGOS_ASK]]\nOptions are `Label | value`. Add `noskip` to require an answer, `nofreetext`\nto disallow a typed answer. Each answer arrives as your next message.\n\n## Status line\nShow a short working status with `STATUS: <text>` on its own line (for example\n`STATUS: running tests`). An empty `STATUS:` clears it.\n\n## Tool activity (automatic)\nYour shell commands, file edits, MCP tool calls, and web searches are shown to\nthe user as a live tool-progress card automatically. You do not need to report\nthem.\n\n## Files the user sends you\nImages are attached to your input directly. Other files are downloaded and their\nabsolute path is given to you inline as `[File attached: /path (mime)]`; read\nthem from disk as needed.\n\n## Slash commands\n`/new` starts a fresh conversation (your thread is reset). `/retry` re-runs the\nuser's last message. `/status` shows daemon health. These are handled by the\ndaemon; you will not see them.\n\n## Not supported here\nNo group chats, threads, or message editing. Dangerous-command approval prompts\nare not surfaced to BGOS in this version; run within your sandbox.\n";
+/** Shape of GET /integrations/capabilities?channel=codex. */
+export interface ServedCapabilities {
+    channel: string;
+    version: string;
+    text: string;
+    core: string;
+    channelSyntax: string;
+}
+/**
+ * Whether a payload looks like a real BGOS capability canon. The served text
+ * opens with "# BGOS Channel Agent Capabilities" and the bundled copy with
+ * "# BGOS Channel, Agent Capabilities"; both carry the two dash-free markers, so
+ * matching on both rejects an empty or garbage body while accepting either form.
+ */
+export declare function hasCanonMarkers(text: string | null | undefined): boolean;
+export interface PickedCapabilities {
+    text: string;
+    source: "backend" | "bundled";
+}
+/**
+ * Choose the agent-hints text to inject: the served canon when it is present and
+ * well-formed, else the bundled fallback. Pure and total (never throws), so the
+ * connect path can call it on any input, including a failed fetch (pass null).
+ */
+export declare function pickCapabilitiesText(fetched: ServedCapabilities | null | undefined, bundled?: string): PickedCapabilities;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAiBA,6DAA6D;AAC7D,eAAO,MAAM,oBAAoB,ymFAAmB,CAAC;AAErD,6DAA6D;AAC7D,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAGxE;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,kBAAkB,GAAG,IAAI,GAAG,SAAS,EAC9C,OAAO,GAAE,MAA6B,GACrC,kBAAkB,CAUpB"}

package/dist/capabilities.js

@@ -0,0 +1,44 @@
+/**
+ * Capability bootstrap (fetch-on-connect).
+ *
+ * The BGOS backend owns the machine-readable capability canon and serves it per
+ * channel at `GET /api/v1/integrations/capabilities?channel=codex`. The daemon
+ * fetches it once at connect and writes the returned `text` to the Codex agent's
+ * AGENTS.md (see CodexHost.applyAgentHints), so a connected agent always sees the
+ * current canon without a daemon release. When the endpoint is unreachable (old
+ * backend, network, revoked token, malformed body) the daemon keeps the frozen
+ * `BGOS_AGENT_HINTS` copy it shipped with. A fetch failure NEVER hard-fails the
+ * daemon.
+ *
+ * This module holds only PURE helpers (no I/O), so the validate-and-choose logic
+ * is unit-tested; the fetch + AGENTS.md write live in bgos-api.ts / codex-host.ts.
+ */
+import { BGOS_AGENT_HINTS } from "./agent-hints.js";
+/** The bundled, offline fallback shipped with the daemon. */
+export const BUNDLED_CAPABILITIES = BGOS_AGENT_HINTS;
+/**
+ * Whether a payload looks like a real BGOS capability canon. The served text
+ * opens with "# BGOS Channel Agent Capabilities" and the bundled copy with
+ * "# BGOS Channel, Agent Capabilities"; both carry the two dash-free markers, so
+ * matching on both rejects an empty or garbage body while accepting either form.
+ */
+export function hasCanonMarkers(text) {
+    if (typeof text !== "string")
+        return false;
+    return text.includes("BGOS Channel") && text.includes("Agent Capabilities");
+}
+/**
+ * Choose the agent-hints text to inject: the served canon when it is present and
+ * well-formed, else the bundled fallback. Pure and total (never throws), so the
+ * connect path can call it on any input, including a failed fetch (pass null).
+ */
+export function pickCapabilitiesText(fetched, bundled = BUNDLED_CAPABILITIES) {
+    const served = fetched?.text;
+    if (typeof served === "string" &&
+        served.trim().length > 0 &&
+        hasCanonMarkers(served)) {
+        return { text: served, source: "backend" };
+    }
+    return { text: bundled, source: "bundled" };
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,6DAA6D;AAC7D,MAAM,CAAC,MAAM,oBAAoB,GAAG,gBAAgB,CAAC;AAWrD;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,IAA+B;IAC7D,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC3C,OAAO,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC;AAC9E,CAAC;AAOD;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAA8C,EAC9C,UAAkB,oBAAoB;IAEtC,MAAM,MAAM,GAAG,OAAO,EAAE,IAAI,CAAC;IAC7B,IACE,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QACxB,eAAe,CAAC,MAAM,CAAC,EACvB,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC7C,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAC9C,CAAC"}

package/dist/catalog-sync.d.ts

@@ -0,0 +1,26 @@
+import type { BgosApi } from "./bgos-api.js";
+/**
+ * Push the agent catalog to BGOS so the Integrations card's checklist
+ * populates with the available-to-bind agents.
+ *
+ * Fail-open: catalog push is non-fatal. If it errors we log + return so
+ * the daemon stays connected. The user can either retry by reloading the
+ * Integrations card (which calls `/integrations/me`) or restart the
+ * daemon.
+ *
+ * Caller is responsible for resolving `pairing_id` (typically by
+ * `BgosApi.whoami()` on connect) and providing the agent list.
+ */
+export interface CatalogAgent {
+    /** Stable identifier the host uses to dispatch (e.g. `"general"`,
+     *  `"critic"`, etc.). Becomes the assistant's `agent_route` in BGOS. */
+    route: string;
+    /** Display name shown on the Integrations checklist. */
+    name: string;
+    /** Optional one-line description for the checklist row. */
+    description?: string;
+    /** Optional avatar URL for the checklist row. */
+    avatarUrl?: string;
+}
+export declare function syncCatalog(api: BgosApi, pairingId: number, agents: CatalogAgent[]): Promise<void>;
+//# sourceMappingURL=catalog-sync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-sync.d.ts","sourceRoot":"","sources":["../src/catalog-sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAG7C;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,YAAY;IAC3B;4EACwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,WAAW,CAC/B,GAAG,EAAE,OAAO,EACZ,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,EAAE,GACrB,OAAO,CAAC,IAAI,CAAC,CA0Bf"}

package/dist/catalog-sync.js

@@ -0,0 +1,24 @@
+export async function syncCatalog(api, pairingId, agents) {
+    if (!agents.length) {
+        // eslint-disable-next-line no-console
+        console.warn("[codex-channel-bgos] syncCatalog called with empty agent list - skipping");
+        return;
+    }
+    const entries = agents.map((a) => ({
+        agent_route: a.route,
+        name: a.name,
+        description: a.description,
+        avatar_url: a.avatarUrl,
+    }));
+    try {
+        await api.pushAgentCatalog(pairingId, entries);
+    }
+    catch (err) {
+        // Fail-open. Surface the message so logs are useful but never
+        // throw - `BGOSAdapter.start()` calls this path and a 5xx in
+        // catalog push must NOT take down the adapter.
+        // eslint-disable-next-line no-console
+        console.warn("[codex-channel-bgos] agent catalog push failed (non-fatal):", err instanceof Error ? err.message : String(err));
+    }
+}
+//# sourceMappingURL=catalog-sync.js.map

package/dist/catalog-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-sync.js","sourceRoot":"","sources":["../src/catalog-sync.ts"],"names":[],"mappings":"AA4BA,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,GAAY,EACZ,SAAiB,EACjB,MAAsB;IAEtB,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,sCAAsC;QACtC,OAAO,CAAC,IAAI,CACV,0EAA0E,CAC3E,CAAC;QACF,OAAO;IACT,CAAC;IACD,MAAM,OAAO,GAAwB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtD,WAAW,EAAE,CAAC,CAAC,KAAK;QACpB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,UAAU,EAAE,CAAC,CAAC,SAAS;KACxB,CAAC,CAAC,CAAC;IACJ,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,gBAAgB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,8DAA8D;QAC9D,6DAA6D;QAC7D,+CAA+C;QAC/C,sCAAsC;QACtC,OAAO,CAAC,IAAI,CACV,6DAA6D,EAC7D,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CACjD,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,152 @@
+#!/usr/bin/env node
+/**
+ * codex-channel-bgos daemon CLI.
+ *
+ *   codex-channel-bgos connect <CODE>   pair with a BGOS code, then start
+ *   codex-channel-bgos start            start from the stored pairing token
+ *   codex-channel-bgos install-service  install launchd/systemd persistence
+ *   codex-channel-bgos --help
+ *
+ * `connect` is pair-then-start in one process (the OpenClaw one-paste shape):
+ * pairing writes ~/.codex-bgos/secrets/bgos.json, then control falls through to
+ * start, which reads that same file.
+ */
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { pairBgos } from "./pair-cli.js";
+import { loadConfig } from "./load-config.js";
+import { resolveAuthMode } from "./auth-mode.js";
+import { CodexAdapter } from "./adapter.js";
+import { getPackageVersion } from "./version.js";
+import { installService } from "./install-service.js";
+const DEFAULT_BASE_URL = "https://api.brandgrowthos.ai";
+const LOG = "[codex-channel-bgos]";
+/** Path to OpenAI Codex's own auth.json (a prior `codex login`). */
+function codexAuthJsonPath() {
+    const home = process.env.CODEX_HOME?.trim();
+    const root = home && home.length > 0 ? home : join(homedir(), ".codex");
+    return join(root, "auth.json");
+}
+function resolveAuth() {
+    const raw = (process.env.CODEX_BGOS_AUTH_MODE ?? "auto").trim().toLowerCase();
+    const forced = raw === "chatgpt" || raw === "apikey" ? raw : "auto";
+    return resolveAuthMode({
+        authJsonExists: existsSync(codexAuthJsonPath()),
+        openaiKey: process.env.OPENAI_API_KEY,
+        forced,
+    });
+}
+function printPreflight() {
+    // The codex binary ships with @openai/codex-sdk (a dependency), so "installed"
+    // is always true for a working install; report auth as the meaningful gate.
+    process.stdout.write(`${LOG} preflight: codex runtime bundled (ok)\n`);
+}
+function usage() {
+    process.stdout.write(`codex-channel-bgos v${getPackageVersion()}\n\n` +
+        `Usage:\n` +
+        `  codex-channel-bgos connect <CODE>   Pair with a BGOS code, then start the daemon\n` +
+        `  codex-channel-bgos start            Start from the stored pairing token\n` +
+        `  codex-channel-bgos install-service  Install launchd/systemd persistence\n` +
+        `  codex-channel-bgos --help\n\n` +
+        `Auth (D7): prefers an existing 'codex login', else OPENAI_API_KEY.\n` +
+        `Override with CODEX_BGOS_AUTH_MODE=auto|chatgpt|apikey.\n`);
+}
+async function runStart() {
+    const auth = resolveAuth();
+    if (!auth.ok) {
+        process.stderr.write(`${LOG} cannot start: ${auth.error}\n`);
+        process.exit(1);
+    }
+    let cfg;
+    try {
+        cfg = loadConfig();
+    }
+    catch {
+        process.stderr.write(`${LOG} not paired yet. Get a code from the BGOS app, then run:\n` +
+            `  npx codex-channel-bgos connect BGOS-XXXX-XX\n`);
+        process.exit(1);
+        return;
+    }
+    process.stdout.write(`${LOG} starting v${getPackageVersion()}\n`);
+    process.stdout.write(`${LOG} auth: ${auth.label} (${auth.mode})\n`);
+    const adapter = new CodexAdapter(cfg, auth, {
+        model: process.env.CODEX_BGOS_MODEL,
+    });
+    let stopping = false;
+    const shutdown = () => {
+        if (stopping)
+            return;
+        stopping = true;
+        process.stdout.write(`\n${LOG} shutting down...\n`);
+        void adapter.stop().finally(() => process.exit(0));
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+    await adapter.start();
+    process.stdout.write(`${LOG} ready, waiting for BGOS messages\n`);
+}
+async function runConnect(code) {
+    const auth = resolveAuth();
+    if (!auth.ok) {
+        process.stderr.write(`${LOG} ${auth.error}\n`);
+        process.exit(1);
+    }
+    printPreflight();
+    process.stdout.write(`${LOG} auth: ${auth.ok ? auth.label : "unresolved"} (${auth.ok ? auth.mode : "none"})\n`);
+    const baseUrl = process.env.BGOS_BASE_URL ?? DEFAULT_BASE_URL;
+    if (!code) {
+        process.stderr.write(`${LOG} no pair code given. Get one from the BGOS app (Add an agent -> Codex) and run:\n` +
+            `  npx codex-channel-bgos connect BGOS-XXXX-XX\n`);
+        process.exit(2);
+        return;
+    }
+    try {
+        const { pairing, tokenFile } = await pairBgos({ baseUrl, code });
+        process.stdout.write(`${LOG} paired (pairing_id=${pairing.pairing_id}). Token stored at ${tokenFile}. Starting...\n`);
+    }
+    catch (err) {
+        const e = err;
+        const status = e?.response?.status;
+        if (status === 400 || status === 404 || status === 410) {
+            process.stderr.write(`${LOG} pair code rejected (${status}): expired or already used. Get a fresh code and try again.\n`);
+            process.exit(2);
+            return;
+        }
+        process.stderr.write(`${LOG} pairing failed: ${e?.message ?? String(err)}\n`);
+        process.exit(1);
+        return;
+    }
+    await runStart();
+}
+async function main() {
+    const argv = process.argv.slice(2);
+    const verb = argv[0];
+    if (verb === "--help" || verb === "-h" || verb === "help") {
+        usage();
+        return;
+    }
+    if (verb === "install-service") {
+        const r = installService();
+        process.stdout.write(`${LOG} ${r.message}\n`);
+        process.exit(r.ok ? 0 : 1);
+        return;
+    }
+    if (verb === "connect") {
+        const code = argv.slice(1).find((a) => !a.startsWith("-"));
+        await runConnect(code);
+        return;
+    }
+    if (verb === "start" || verb === undefined) {
+        await runStart();
+        return;
+    }
+    process.stderr.write(`${LOG} unknown command: ${verb}\n`);
+    usage();
+    process.exit(2);
+}
+void main().catch((err) => {
+    process.stderr.write(`${LOG} fatal: ${err instanceof Error ? err.stack : String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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