codex-channel-bgos 0.2.0

package/dist/types.d.ts

@@ -0,0 +1,244 @@
+/**
+ * Payload shapes mirrored from the BGOS backend. Independent types so the
+ * plugin doesn't depend on backend code.
+ *
+ * Keep these in sync with:
+ *   docs/superpowers/specs/2026-04-25-codex-bgos-integration-design.md §7
+ *   backend/src/dto/integrations/*.ts
+ */
+export type IntegrationDirection = "bgos_initiated" | "codex_initiated";
+export interface PairExchangeResponse {
+    pairing_token: string;
+    pairing_id: number;
+    user_id: string;
+}
+export interface AgentCatalogEntry {
+    agent_route: string;
+    name: string;
+    description?: string;
+    avatar_url?: string;
+}
+export interface IntegrationPairing {
+    id: number;
+    device_label: string;
+    integration: string;
+    token_prefix: string;
+    last_seen_at: string | null;
+    created_at: string;
+    agent_catalog: AgentCatalogEntry[];
+}
+export interface InboundFile {
+    id: number;
+    filename: string;
+    mime: string;
+    url?: string;
+}
+export interface InboundMessagePayload {
+    assistantId: number;
+    userId: string;
+    chatId: number;
+    messageId: number;
+    text: string;
+    files: InboundFile[];
+    messageType: "standard" | "slash_command" | "approval_request" | "agent_error" | "ask_user_input";
+    commandName?: string;
+    commandArgs?: string;
+    /**
+     * Agent-to-agent (a2a) side-thread marker. Present ONLY when this inbound
+     * originated from a peer agent's side-thread conversation - the backend
+     * stamps it on the WS `inbound_message` event (it is NOT carried by the
+     * REST `integrations/inbound` poll backfill, nor by ordinary user
+     * messages). When set, the reply must go back via `POST /send-message`
+     * with `reply_to_id` so the initiating peer's `wait_for_reply` resolves
+     * (see inbound-handler.ts). See bgos-agent-capabilities.md §11.
+     */
+    peerConversationId?: number;
+    /** Turn state on a peer side-thread: `expecting_reply` | `more_coming` |
+     *  `final`. Present alongside `peerConversationId`. */
+    turnState?: string;
+}
+export interface CommandsUpdatedPayload {
+    userId: string;
+    assistantId: number;
+    commands: CommandManifestEntry[];
+}
+export interface PairReadyPayload {
+    userId: string;
+    pairingId: number;
+    agentCatalog: AgentCatalogEntry[];
+}
+export interface AssistantBoundPayload {
+    pairingId: number;
+    assistantId: number;
+    agentRoute: string;
+}
+export interface AssistantUnboundPayload {
+    pairingId: number;
+    assistantId: number;
+}
+export interface PairingRevokedPayload {
+    pairingId: number;
+    /** Why the pairing became unusable. `'revoked'` (user deleted the pairing)
+     *  or `'rotated'` (token rotated: re-pair with the new token). Absent on
+     *  older backends; the adapter treats an absent reason as `'revoked'`. */
+    reason?: "revoked" | "rotated" | string;
+}
+export interface CallbackResultPayload {
+    messageId: number;
+    optionId: number;
+    success: boolean;
+    error?: string;
+    assistantId?: number;
+}
+/**
+ * Inbound button-click event (`inbound_click`). Emitted to `assistant:<id>`
+ * when the user taps an inline button. Unlike `callback_result` (the n8n
+ * success/error lane, which has NO callbackData), this carries the raw
+ * `callbackData` so the adapter can route approval clicks (`ea:*`) through the
+ * ApprovalHandler and forward everything else to the fork's onButtonClick hook.
+ */
+export interface InboundClickPayload {
+    assistantId: number;
+    userId: string;
+    chatId: number;
+    messageId: number;
+    optionId: number;
+    callbackData: string;
+    buttonText?: string;
+}
+/** Option = button on a message (Telegram inline-keyboard equivalent). */
+export interface MessageOption {
+    text: string;
+    callbackData: string;
+    style?: "default" | "success" | "danger" | "primary";
+}
+export interface ApprovalMeta {
+    tool: string;
+    agent_route: string;
+    risk: "low" | "medium" | "high";
+    request_id: string;
+    expired?: boolean;
+}
+/**
+ * Inline agent identity. When present, the backend resolves it to
+ * `messages.from_agent_inline` (or `from_agent_peer_id` if `peerId`/
+ * `assistantId` matches a peer in the registry) and the BGOS frontend
+ * renders the bubble with this name + color + avatar instead of the
+ * bound assistant's identity.
+ *
+ * Used by `/board` to render each agent's contribution as a visually
+ * distinct bubble even though they all originate from the single bound
+ * Codex assistant. Mirrors `FromAgentInputDto` in the backend.
+ */
+export interface FromAgentInput {
+    /** AgentPeer.id from the BGOS registry (preferred when available). */
+    peerId?: number;
+    /** Source assistant id - for BGOS-native cross-assistant peers. */
+    assistantId?: number;
+    /** Stable string id (max 128 chars) used to look up the peer. */
+    externalId?: string;
+    /** Display name (inline fallback). Max 80 chars. */
+    name?: string;
+    /** Bubble accent color, hex e.g. "#0EA5E9". */
+    color?: string;
+    /** Avatar URL (https only). Max 2048 chars. */
+    avatarUrl?: string;
+    /** Agent type. `[a-z0-9_-]+`, max 32 chars. */
+    type?: "n8n" | "bgos" | "external" | "codex" | string;
+}
+/** Outbound message payload we POST to /api/v1/messages. */
+export interface OutboundMessagePayload {
+    assistantId: number;
+    chatId: number;
+    text: string;
+    sender: "assistant";
+    options?: MessageOption[];
+    messageType?: "standard" | "slash_command" | "approval_request" | "agent_error" | "tool_progress";
+    approvalMeta?: ApprovalMeta;
+    /**
+     * tool_progress card payload - required when messageType="tool_progress".
+     * Codex agents stream tool_use events from Claude's API in real time
+     * (src/lib/claude.ts:391 in the fork), so unlike OpenClaw we emit LIVE
+     * cards: POST first card with state="running" on the first tool, PATCH
+     * to add tools, then PATCH state="done" at end-of-turn. Channel-agnostic
+     * wire format documented at
+     *   docs/superpowers/specs/2026-05-15-tool-progress-message-type-design.md
+     */
+    toolProgress?: {
+        state: "running" | "done";
+        tools: Array<{
+            icon: string;
+            name: string;
+            args?: string;
+            status: "running" | "done" | "error";
+        }>;
+    };
+    files?: Array<{
+        fileName: string;
+        fileMimeType: string;
+        size?: number;
+        fileData?: string;
+        s3Key?: string;
+        isImage?: boolean;
+        isVideo?: boolean;
+        isAudio?: boolean;
+        isDocument?: boolean;
+        width?: number;
+        height?: number;
+    }>;
+    /**
+     * When set, the backend stores `messages.reply_to_id = replyToId` and the
+     * UI renders this as a quoted reply. REQUIRED in agent-to-agent (a2a)
+     * side-thread chats: the originator's pollForReply correlates the target's
+     * reply with the inbound peer message via this field. Without it the
+     * backend falls back to positional matching, which works for 1:1 side
+     * threads but is less precise.
+     */
+    replyToId?: number;
+    /**
+     * Inline-agent identity override. When set, the backend's
+     * agent-peer resolver maps it to `messages.from_agent_peer_id` (registry
+     * hit) or `messages.from_agent_inline` (free-form), and the BGOS UI
+     * renders the bubble with the supplied name/avatar/color. Required for
+     * Codex's `/board` flow so each agent's contribution shows as its own
+     * sender even though they share one bound assistant.
+     */
+    fromAgent?: FromAgentInput;
+}
+export interface CommandManifestEntry {
+    command: string;
+    description: string;
+    scope?: string;
+    order_index?: number;
+}
+export interface PluginConfig {
+    baseUrl: string;
+    pairingToken: string;
+    reconnect: {
+        initialDelayMs: number;
+        maxDelayMs: number;
+    };
+}
+/** Error thrown when BGOS returns 401 - plugin should clear token + re-pair. */
+export declare class PairingRevokedError extends Error {
+    constructor(message?: string);
+}
+/** OpenAI-compat chat message. One of these per prior turn when we dispatch
+ *  to the gateway, so the agent sees full conversation context. */
+export interface ChatMessage {
+    role: "user" | "assistant" | "system";
+    content: string;
+}
+/** One entry from `GET /api/v1/chats/:id/messages?userId=`. The backend
+ *  returns `MessagesDto { messages: MessageWithFilesAndOptionsDto[] }`,
+ *  where each entry nests a `message` object. */
+export interface BgosMessageEnvelope {
+    message: {
+        id: number;
+        sender: "user" | "assistant" | null;
+        text: string | null;
+        messageType: string;
+        createdAt: string;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,16 @@
+/**
+ * Payload shapes mirrored from the BGOS backend. Independent types so the
+ * plugin doesn't depend on backend code.
+ *
+ * Keep these in sync with:
+ *   docs/superpowers/specs/2026-04-25-codex-bgos-integration-design.md §7
+ *   backend/src/dto/integrations/*.ts
+ */
+/** Error thrown when BGOS returns 401 - plugin should clear token + re-pair. */
+export class PairingRevokedError extends Error {
+    constructor(message = "Pairing token revoked or invalid") {
+        super(message);
+        this.name = "PairingRevokedError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAuPH,gFAAgF;AAChF,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,OAAO,GAAG,kCAAkC;QACtD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF"}

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare function getPackageVersion(): string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAeA,wBAAgB,iBAAiB,IAAI,MAAM,CAW1C"}

package/dist/version.js

@@ -0,0 +1,28 @@
+/**
+ * Read this package's own version from its package.json exactly once at load.
+ *
+ * The daemon reports `daemonVersion` in the heartbeat DTO + the pair-exchange
+ * body, and the local heartbeat file records it. Both `dist/version.js` (built)
+ * and `src/version.ts` (tests) live one directory under the package root, so
+ * `../package.json` resolves in both. Falls back to "0.0.0" if the file cannot
+ * be read (never throws: a missing version must not block boot).
+ */
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+let cached = null;
+export function getPackageVersion() {
+    if (cached !== null)
+        return cached;
+    try {
+        const here = dirname(fileURLToPath(import.meta.url));
+        const raw = readFileSync(join(here, "..", "package.json"), "utf8");
+        const parsed = JSON.parse(raw);
+        cached = typeof parsed.version === "string" ? parsed.version : "0.0.0";
+    }
+    catch {
+        cached = "0.0.0";
+    }
+    return cached;
+}
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,IAAI,MAAM,GAAkB,IAAI,CAAC;AAEjC,MAAM,UAAU,iBAAiB;IAC/B,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IACnC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACrD,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC;QACnE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAyB,CAAC;QACvD,MAAM,GAAG,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IACzE,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,GAAG,OAAO,CAAC;IACnB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/voice-rpc.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Voice control-plane wire types + normalizer.
+ *
+ * In-app realtime voice (mint / consult / dispatch) is DEFERRED for the Codex
+ * adapter v1 (parity with the Hermes / OpenClaw / Gobot decision to ship chat
+ * first). We keep the frame types and the normalizer so the WS layer can accept
+ * and safely drop `voice_rpc` frames, and so `bgos-api` can expose the ack /
+ * result endpoints for a later voice build. No handler is wired: an unhandled
+ * frame simply times out on the backend, which surfaces the failure to the app.
+ *
+ * Types mirror gobot-channel-bgos/src/voice-rpc.ts (originally the OpenClaw
+ * normalizer) so a future voice module drops in without a wire change.
+ */
+export type VoiceRpcOp = "mint" | "consult" | "dispatch";
+export interface VoiceRpcFrame {
+    rpcId: string;
+    op: VoiceRpcOp;
+    assistantId: string | number;
+    agentRoute: string;
+    chatId: string | number | null;
+    payload: Record<string, unknown>;
+}
+export interface VoiceRpcResultBody {
+    ok: boolean;
+    payload?: Record<string, unknown>;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+/**
+ * Validate a voice_rpc control frame. Backend emits camelCase:
+ * {rpcId, op, assistantId, agentRoute, chatId, payload}. Ops are WHITELISTED,
+ * anything else is dropped here.
+ */
+export declare function normalizeVoiceRpc(raw: unknown): VoiceRpcFrame | null;
+//# sourceMappingURL=voice-rpc.d.ts.map

package/dist/voice-rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-rpc.d.ts","sourceRoot":"","sources":["../src/voice-rpc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;AAEzD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,UAAU,CAAC;IACf,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,CA0BpE"}

package/dist/voice-rpc.js

@@ -0,0 +1,44 @@
+/**
+ * Voice control-plane wire types + normalizer.
+ *
+ * In-app realtime voice (mint / consult / dispatch) is DEFERRED for the Codex
+ * adapter v1 (parity with the Hermes / OpenClaw / Gobot decision to ship chat
+ * first). We keep the frame types and the normalizer so the WS layer can accept
+ * and safely drop `voice_rpc` frames, and so `bgos-api` can expose the ack /
+ * result endpoints for a later voice build. No handler is wired: an unhandled
+ * frame simply times out on the backend, which surfaces the failure to the app.
+ *
+ * Types mirror gobot-channel-bgos/src/voice-rpc.ts (originally the OpenClaw
+ * normalizer) so a future voice module drops in without a wire change.
+ */
+/**
+ * Validate a voice_rpc control frame. Backend emits camelCase:
+ * {rpcId, op, assistantId, agentRoute, chatId, payload}. Ops are WHITELISTED,
+ * anything else is dropped here.
+ */
+export function normalizeVoiceRpc(raw) {
+    if (!raw || typeof raw !== "object")
+        return null;
+    const r = raw;
+    const rpcId = typeof r.rpcId === "string" ? r.rpcId : "";
+    const op = r.op === "mint" || r.op === "consult" || r.op === "dispatch"
+        ? r.op
+        : null;
+    if (!rpcId || !op)
+        return null;
+    return {
+        rpcId,
+        op,
+        assistantId: typeof r.assistantId === "number" || typeof r.assistantId === "string"
+            ? r.assistantId
+            : "",
+        agentRoute: typeof r.agentRoute === "string" ? r.agentRoute : "",
+        chatId: typeof r.chatId === "number" || typeof r.chatId === "string"
+            ? r.chatId
+            : null,
+        payload: r.payload && typeof r.payload === "object"
+            ? r.payload
+            : {},
+    };
+}
+//# sourceMappingURL=voice-rpc.js.map

package/dist/voice-rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-rpc.js","sourceRoot":"","sources":["../src/voice-rpc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAmBH;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAY;IAC5C,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACjD,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACzD,MAAM,EAAE,GACN,CAAC,CAAC,EAAE,KAAK,MAAM,IAAI,CAAC,CAAC,EAAE,KAAK,SAAS,IAAI,CAAC,CAAC,EAAE,KAAK,UAAU;QAC1D,CAAC,CAAC,CAAC,CAAC,EAAE;QACN,CAAC,CAAC,IAAI,CAAC;IACX,IAAI,CAAC,KAAK,IAAI,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC;IAC/B,OAAO;QACL,KAAK;QACL,EAAE;QACF,WAAW,EACT,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ;YACpE,CAAC,CAAC,CAAC,CAAC,WAAW;YACf,CAAC,CAAC,EAAE;QACR,UAAU,EAAE,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE;QAChE,MAAM,EACJ,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ;YAC1D,CAAC,CAAC,CAAC,CAAC,MAAM;YACV,CAAC,CAAC,IAAI;QACV,OAAO,EACL,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;YACxC,CAAC,CAAE,CAAC,CAAC,OAAmC;YACxC,CAAC,CAAC,EAAE;KACT,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "codex-channel-bgos",
+  "version": "0.2.0",
+  "description": "BGOS channel adapter for OpenAI Codex: pair, WS + REST client, Codex SDK host, outbound modalities, one-paste connect",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "codex-channel-bgos": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node scripts/finalize-daemon.mjs",
+    "start": "node dist/cli.js start",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit -p tsconfig.json"
+  },
+  "keywords": [
+    "codex",
+    "openai-codex",
+    "codex-channel",
+    "bgos",
+    "brandgrowthos"
+  ],
+  "author": "BrandGrowthOS",
+  "license": "MIT",
+  "dependencies": {
+    "@openai/codex-sdk": "^0.144.1",
+    "axios": "^1.13.2",
+    "qrcode": "^1.5.4",
+    "socket.io-client": "^4.8.1",
+    "zod": "^4.3.5"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "@types/qrcode": "^1.5.6",
+    "typescript": "^5.7.3",
+    "vitest": "^2.1.8"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}