codex-channel-bgos 0.2.0

package/dist/inbound-handler.js

@@ -0,0 +1,282 @@
+/**
+ * Translate a BGOS WS `inbound_message` into a `dispatch()` call against
+ * Codex's existing per-agent handler.
+ *
+ * The fork wires this up: at boot the fork calls `adapter.setDispatch(fn)`
+ * with a closure that runs Codex's `processMessageForAgent` (or
+ * equivalent) and uses the supplied `replyHandle` for any outbound
+ * action. `dispatch` is dependency-injected because the fork has access
+ * to Codex's internal types we deliberately do not import here - keeping
+ * this vendor package free of any dependency on the upstream Codex
+ * source so it stays npm-installable on its own.
+ *
+ * What this module owns:
+ *   - Looking up `agent_route` from `assistant_id` via the adapter's map
+ *   - Translating BGOS attachments into local file paths via
+ *     `attachment-bridge`
+ *   - Building a `ReplyHandle` scoped to BGOS (calls back through the
+ *     `BgosOutbound` instance, never Telegram)
+ *   - Persisting `last_id` BEFORE dispatch so a crash inside the agent
+ *     handler doesn't infinite-loop the cursor
+ *   - Injecting `BGOS_AGENT_HINTS` into the system prompt before
+ *     dispatching
+ */
+import { randomUUID } from "node:crypto";
+import { ingestBgosAttachment, publishMediaPath, } from "./attachment-bridge.js";
+import { buildSystemPromptWithHints } from "./agent-hints.js";
+import { saveLastId } from "./last-id-store.js";
+import { clearPendingUnknown, recordPendingUnknown, } from "./pending-unknown-store.js";
+import { ProcessedIdsCache } from "./processed-ids.js";
+/**
+ * Build a BGOS-scoped ReplyHandle. Extracted so both the inbound dispatch
+ * path AND the adapter's `makeReplyHandle` factory (contract C6, for the
+ * fork's HITL button-click resume) produce an identical surface.
+ *
+ * `replyVia` / `replyToId` are set by the inbound path for a2a peer replies;
+ * `makeReplyHandle` leaves them undefined (a plain reply into a chat).
+ */
+export function buildReplyHandle(deps, target) {
+    const { assistantId, chatId, replyVia, replyToId } = target;
+    return {
+        origin: "bgos",
+        sendText: (text) => deps.outbound.sendText({ assistantId, chatId, text, replyVia, replyToId }),
+        sendButtons: (text, options) => deps.outbound.sendButtons({
+            assistantId,
+            chatId,
+            text,
+            options,
+            replyVia,
+            replyToId,
+        }),
+        sendApprovalRequest: (text, meta) => deps.outbound.sendApprovalRequest({
+            assistantId,
+            chatId,
+            text,
+            // SECURITY: ignore any agent-supplied request_id and mint a
+            // fork-generated UUID. The request_id keys the approval-callback
+            // correlation map (ea:<decision>:<reqId>); an agent that picks its
+            // own value could collide with another in-flight approval and steal
+            // or clobber its decision. A v4 UUID is collision-free.
+            meta: { ...meta, request_id: randomUUID() },
+            replyVia,
+            replyToId,
+        }),
+        sendAskUserInput: (prompt, options, modal) => deps.outbound.sendAskUserInput({ assistantId, chatId, prompt, options, modal }),
+        sendFile: (filePath, caption) => deps.outbound.sendFile({
+            assistantId,
+            chatId,
+            filePath,
+            caption,
+            replyVia,
+            replyToId,
+        }),
+        sendImage: (filePath, caption) => deps.outbound.sendImage({
+            assistantId,
+            chatId,
+            filePath,
+            caption,
+            replyVia,
+            replyToId,
+        }),
+        sendVideo: (filePath, caption) => deps.outbound.sendVideo({
+            assistantId,
+            chatId,
+            filePath,
+            caption,
+            replyVia,
+            replyToId,
+        }),
+        sendTyping: () => deps.outbound.sendTyping({ assistantId, chatId }),
+        uploadFile: (filePath, opts) => publishMediaPath(deps.outbound.api, filePath, opts),
+        sendToolStart: async (toolName, args) => {
+            if (!deps.toolProgress)
+                return;
+            await deps.toolProgress.sendToolStart({ assistantId, chatId, toolName, args });
+        },
+        finalizeTurn: async () => {
+            if (!deps.toolProgress)
+                return;
+            await deps.toolProgress.finalizeTurn(chatId);
+        },
+    };
+}
+/**
+ * Build the inbound-event handler. Returns an async function the
+ * adapter wires onto `BgosWs`'s `inbound_message` event.
+ */
+export function createInboundHandler(deps) {
+    // Chats known to be a2a (peer) side-threads. A chat is learned the first
+    // time an inbound arrives carrying `peerConversationId` (the WS event
+    // stamps it). We remember it so a later message in the same thread that
+    // arrives WITHOUT markers - e.g. a REST `integrations/inbound` poll
+    // backfill, which strips them - still gets its reply routed correctly.
+    const a2aChats = new Set();
+    // Dedupe cache shared by the live WS path AND the backfill/poll path (both
+    // flow through this handler). Gated AFTER the route resolves so an unknown-
+    // assistant message stays UNCONSUMED and the poll re-fetches it until
+    // identity heals (contract C3). 500-entry FIFO, ported from openclaw.
+    const processedIds = new ProcessedIdsCache(500);
+    // Rate-limit the unknown-assistant warning to 1/min per assistant id.
+    const unknownWarnedAt = new Map();
+    return async function handleInbound(event) {
+        let route = deps.getRouteForAssistant(event.assistantId);
+        if (!route) {
+            // Unknown assistant: the user likely just exposed a new agent. Ask the
+            // adapter to refresh identity (rate-limited + single-flight), then retry
+            // the lookup ONCE.
+            if (deps.onUnknownAssistant) {
+                try {
+                    await deps.onUnknownAssistant(event.assistantId);
+                }
+                catch {
+                    /* swallow: the retry below decides the outcome */
+                }
+                route = deps.getRouteForAssistant(event.assistantId);
+            }
+            if (!route) {
+                // Leave the message UNCONSUMED: do NOT mark dedupe, do NOT saveLastId.
+                // Record it as pending-unknown so a sibling KNOWN message's saveLastId
+                // cannot advance the disk cursor past this hole (durable clamp). The 5s
+                // poll re-fetches it until refreshIdentity fills the map. Warn at most
+                // 1/min per assistant so we don't spam the logs.
+                recordPendingUnknown(event.messageId);
+                const now = Date.now();
+                const last = unknownWarnedAt.get(event.assistantId) ?? 0;
+                if (now - last >= 60_000) {
+                    unknownWarnedAt.set(event.assistantId, now);
+                    // eslint-disable-next-line no-console
+                    console.warn("[codex-channel-bgos] inbound for unknown assistant_id=" +
+                        event.assistantId +
+                        " (leaving unconsumed; poll will retry after identity heals)");
+                }
+                return;
+            }
+        }
+        // Route resolved. Dedupe SYNCHRONOUSLY before the first await: a message
+        // that already dispatched (via the other delivery path) is skipped here,
+        // and only a first-seen message advances the disk cursor.
+        if (!processedIds.markIfFirstTime(event.messageId))
+            return;
+        // This id is now consumed: clear any pending-unknown record for it BEFORE
+        // saving the cursor so the clamp releases and the cursor can advance to it.
+        // (A message that heals after being stranded flows through here once its
+        // route resolves.) No-op when the id was never pending.
+        clearPendingUnknown(event.messageId);
+        // Persist the cursor BEFORE dispatch. A crash inside the agent handler
+        // should not cause an infinite replay on restart (matches Hermes).
+        saveLastId(event.messageId);
+        deps.onInbound?.();
+        // Translate BGOS attachments to local file paths. Failures are
+        // surfaced as a single agent_error and the message is still
+        // dispatched without attachments - better degraded behavior than
+        // dropping the user's text entirely.
+        const attachments = [];
+        for (const f of event.files ?? []) {
+            try {
+                const ingested = await ingestBgosAttachment(f);
+                attachments.push({
+                    localPath: ingested.localPath,
+                    fileName: (f.filename || "attachment"),
+                    mimeType: ingested.mimeType,
+                    kind: ingested.kind,
+                });
+            }
+            catch (err) {
+                // eslint-disable-next-line no-console
+                console.warn("[codex-channel-bgos] attachment ingest failed for " +
+                    (f.filename || "<unnamed>") +
+                    ": " +
+                    (err instanceof Error ? err.message : String(err)));
+            }
+        }
+        // a2a peer detection. If this inbound carries a peerConversationId it
+        // is a peer agent's side-thread message; remember the chat so later
+        // (marker-less) messages in it are still treated as a2a. For any reply
+        // into a known a2a chat we (a) route via `/send-message` so the backend
+        // peer-reply bridge fires and the initiator's `wait_for_reply`
+        // resolves, and (b) anchor the reply to the inbound's messageId via
+        // `reply_to_id` for precise correlation (same-chat, so no 400). Normal
+        // user replies are untouched: `replyVia`/`replyToId` stay undefined and
+        // the outbound falls through to `/messages` exactly as before.
+        if (event.peerConversationId !== undefined)
+            a2aChats.add(event.chatId);
+        const isPeerReply = a2aChats.has(event.chatId);
+        const replyVia = isPeerReply
+            ? "send-message"
+            : undefined;
+        const replyToId = isPeerReply
+            ? event.messageId
+            : undefined;
+        // Build the BGOS-scoped ReplyHandle via the shared factory (identical to
+        // the surface the adapter's makeReplyHandle exposes for HITL resume).
+        const replyHandle = buildReplyHandle({ outbound: deps.outbound, toolProgress: deps.toolProgress }, {
+            assistantId: event.assistantId,
+            chatId: event.chatId,
+            replyVia,
+            replyToId,
+        });
+        const dispatch = deps.getDispatch();
+        if (!dispatch) {
+            // Fork hasn't installed the dispatch function yet - log and keep
+            // going. The cursor was saved above so this message won't replay
+            // on restart; users should ensure dispatch is set before pairing.
+            // eslint-disable-next-line no-console
+            console.warn("[codex-channel-bgos] no dispatch fn registered - message_id=" +
+                event.messageId +
+                " dropped. Ensure the fork called adapter.setDispatch().");
+            return;
+        }
+        const baseSystemPrompt = deps.getSystemPrompt?.(route) ?? "";
+        const systemPrompt = buildSystemPromptWithHints(baseSystemPrompt);
+        const command = event.messageType === "slash_command"
+            ? {
+                name: (event.commandName ?? "").toLowerCase(),
+                args: event.commandArgs ?? "",
+            }
+            : undefined;
+        try {
+            await dispatch({
+                origin: "bgos",
+                agentRoute: route,
+                assistantId: event.assistantId,
+                chatId: event.chatId,
+                messageId: event.messageId,
+                userId: event.userId,
+                text: event.text,
+                attachments,
+                systemPrompt,
+                replyHandle,
+                command,
+                messageType: event.messageType,
+                ...(event.peerConversationId !== undefined
+                    ? { peerConversationId: event.peerConversationId }
+                    : {}),
+                ...(event.turnState !== undefined
+                    ? { turnState: event.turnState }
+                    : {}),
+            });
+        }
+        catch (err) {
+            // Fork's dispatch should never throw - but if it does, surface
+            // the failure as an `agent_error` so the user sees something
+            // rather than a silent dead chat.
+            const reason = err instanceof Error ? err.message : String(err);
+            // eslint-disable-next-line no-console
+            console.error("[codex-channel-bgos] dispatch threw for assistant_id=" +
+                event.assistantId +
+                ": " +
+                reason);
+            try {
+                await deps.outbound.sendAgentError({
+                    assistantId: event.assistantId,
+                    chatId: event.chatId,
+                    reason,
+                });
+            }
+            catch {
+                /* swallow - best-effort */
+            }
+        }
+    };
+}
+//# sourceMappingURL=inbound-handler.js.map

package/dist/inbound-handler.js.map

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

package/dist/inbound-input.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Turn a BGOS inbound message (text + downloaded attachments) into a Codex SDK
+ * `Input`. Images map to the SDK's native `local_image` input; other files have
+ * no native input type, so we inject a labeled path line into the text (the
+ * daemon adds each file's directory to the thread's additionalDirectories so
+ * Codex can read it from disk).
+ */
+import type { Input } from "@openai/codex-sdk";
+export interface InboundFileForCodex {
+    /** Absolute local path the file was downloaded to. */
+    path: string;
+    mime: string;
+    name: string;
+    isImage: boolean;
+}
+export declare function buildCodexInput(text: string, files: InboundFileForCodex[]): Input;
+//# sourceMappingURL=inbound-input.d.ts.map

package/dist/inbound-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-input.d.ts","sourceRoot":"","sources":["../src/inbound-input.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,KAAK,EAAa,MAAM,mBAAmB,CAAC;AAE1D,MAAM,WAAW,mBAAmB;IAClC,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAOD,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,mBAAmB,EAAE,GAC3B,KAAK,CAsBP"}

package/dist/inbound-input.js

@@ -0,0 +1,25 @@
+function describeFile(f) {
+    const name = f.name ? `, name="${f.name}"` : "";
+    return `[File attached: ${f.path} (${f.mime})${name}]`;
+}
+export function buildCodexInput(text, files) {
+    const images = files.filter((f) => f.isImage);
+    const others = files.filter((f) => !f.isImage);
+    let composed = text ?? "";
+    if (others.length > 0) {
+        const lines = others.map(describeFile).join("\n");
+        composed = composed.trim().length > 0 ? `${composed}\n\n${lines}` : lines;
+    }
+    if (images.length === 0) {
+        return composed;
+    }
+    const parts = [];
+    if (composed.trim().length > 0) {
+        parts.push({ type: "text", text: composed });
+    }
+    for (const image of images) {
+        parts.push({ type: "local_image", path: image.path });
+    }
+    return parts;
+}
+//# sourceMappingURL=inbound-input.js.map

package/dist/inbound-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-input.js","sourceRoot":"","sources":["../src/inbound-input.ts"],"names":[],"mappings":"AAiBA,SAAS,YAAY,CAAC,CAAsB;IAC1C,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAChD,OAAO,mBAAmB,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,IAAI,IAAI,GAAG,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,KAA4B;IAE5B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAE/C,IAAI,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAC;IAC1B,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,QAAQ,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IAC5E,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC/C,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * codex-channel-bgos: make OpenAI Codex agents first-class BGOS agents.
+ *
+ * The daemon is normally run via the CLI (`codex-channel-bgos connect <code>`).
+ * These exports let the pieces be embedded or tested programmatically.
+ */
+export { CodexAdapter } from "./adapter.js";
+export type { CodexAdapterOptions, FatalInfo } from "./adapter.js";
+export { CodexHost } from "./codex-host.js";
+export type { CodexHostOptions, RunTurnCallbacks, RunTurnResult, } from "./codex-host.js";
+export { resolveAuthMode } from "./auth-mode.js";
+export type { AuthForce, AuthResolution } from "./auth-mode.js";
+export { parseReply } from "./reply-markers.js";
+export type { ParsedReply } from "./reply-markers.js";
+export { buildCodexInput } from "./inbound-input.js";
+export type { InboundFileForCodex } from "./inbound-input.js";
+export { RunAccumulator, toolCardFromItem } from "./event-mapper.js";
+export type { ToolCard } from "./event-mapper.js";
+export { BGOS_AGENT_HINTS } from "./agent-hints.js";
+export { BUNDLED_CAPABILITIES, hasCanonMarkers, pickCapabilitiesText, } from "./capabilities.js";
+export type { ServedCapabilities, PickedCapabilities, } from "./capabilities.js";
+export { pairBgos } from "./pair-cli.js";
+export { loadConfig } from "./load-config.js";
+export { getPackageVersion } from "./version.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,YAAY,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrE,YAAY,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+/**
+ * codex-channel-bgos: make OpenAI Codex agents first-class BGOS agents.
+ *
+ * The daemon is normally run via the CLI (`codex-channel-bgos connect <code>`).
+ * These exports let the pieces be embedded or tested programmatically.
+ */
+export { CodexAdapter } from "./adapter.js";
+export { CodexHost } from "./codex-host.js";
+export { resolveAuthMode } from "./auth-mode.js";
+export { parseReply } from "./reply-markers.js";
+export { buildCodexInput } from "./inbound-input.js";
+export { RunAccumulator, toolCardFromItem } from "./event-mapper.js";
+export { BGOS_AGENT_HINTS } from "./agent-hints.js";
+export { BUNDLED_CAPABILITIES, hasCanonMarkers, pickCapabilitiesText, } from "./capabilities.js";
+export { pairBgos } from "./pair-cli.js";
+export { loadConfig } from "./load-config.js";
+export { getPackageVersion } from "./version.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAM5C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAK3B,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/dist/install-service.d.ts

@@ -0,0 +1,8 @@
+/** Absolute path to the installed CLI entry (dist/cli.js). */
+export declare function cliEntryPath(): string;
+export interface InstallResult {
+    ok: boolean;
+    message: string;
+}
+export declare function installService(): InstallResult;
+//# sourceMappingURL=install-service.d.ts.map

package/dist/install-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-service.d.ts","sourceRoot":"","sources":["../src/install-service.ts"],"names":[],"mappings":"AAwBA,8DAA8D;AAC9D,wBAAgB,YAAY,IAAI,MAAM,CAGrC;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,cAAc,IAAI,aAAa,CAkD9C"}

package/dist/install-service.js

@@ -0,0 +1,66 @@
+/**
+ * Install the always-on service (launchd on macOS, systemd user unit on Linux)
+ * that runs `codex-channel-bgos start`. Run this AFTER a successful `connect`
+ * (so the pairing token is on disk) and from a persistent install (a global
+ * `npm i -g codex-channel-bgos`), not an ephemeral `npx` cache dir.
+ */
+import { mkdirSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { spawnSync } from "node:child_process";
+import { pickSupervisor, renderLaunchdPlist, renderSystemdUnit, LAUNCHD_LABEL, SYSTEMD_UNIT, } from "./setup/supervisor.js";
+function codexBgosHome() {
+    return process.env.CODEX_BGOS_HOME ?? join(homedir(), ".codex-bgos");
+}
+/** Absolute path to the installed CLI entry (dist/cli.js). */
+export function cliEntryPath() {
+    const here = fileURLToPath(import.meta.url);
+    return join(dirname(here), "cli.js");
+}
+export function installService() {
+    const kind = pickSupervisor(process.platform);
+    const home = codexBgosHome();
+    const nodePath = process.execPath;
+    const cliEntry = cliEntryPath();
+    try {
+        mkdirSync(join(home, "logs"), { recursive: true });
+    }
+    catch {
+        /* logs dir is best-effort */
+    }
+    if (kind === "launchd") {
+        const dir = join(homedir(), "Library", "LaunchAgents");
+        mkdirSync(dir, { recursive: true });
+        const path = join(dir, `${LAUNCHD_LABEL}.plist`);
+        writeFileSync(path, renderLaunchdPlist({ nodePath, cliEntry, home }));
+        spawnSync("launchctl", ["unload", path], { stdio: "ignore" });
+        const r = spawnSync("launchctl", ["load", path], { encoding: "utf8" });
+        return {
+            ok: r.status === 0,
+            message: `launchd agent installed at ${path} (label ${LAUNCHD_LABEL}).\n` +
+                `Manage it with: launchctl unload/load ${path}`,
+        };
+    }
+    if (kind === "systemd") {
+        const dir = join(homedir(), ".config", "systemd", "user");
+        mkdirSync(dir, { recursive: true });
+        const path = join(dir, SYSTEMD_UNIT);
+        writeFileSync(path, renderSystemdUnit({ nodePath, cliEntry, home }));
+        spawnSync("systemctl", ["--user", "daemon-reload"], { stdio: "ignore" });
+        const r = spawnSync("systemctl", ["--user", "enable", "--now", SYSTEMD_UNIT], {
+            encoding: "utf8",
+        });
+        return {
+            ok: r.status === 0,
+            message: `systemd user unit installed at ${path} (${SYSTEMD_UNIT}).\n` +
+                `To keep it running after logout: loginctl enable-linger "$USER"`,
+        };
+    }
+    return {
+        ok: false,
+        message: `Automatic service install is not supported on ${process.platform}. ` +
+            `Run 'codex-channel-bgos start' under your own supervisor (pm2, nohup, or Task Scheduler on Windows).`,
+    };
+}
+//# sourceMappingURL=install-service.js.map

package/dist/install-service.js.map

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

package/dist/last-id-store.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Read the persisted cursor.
+ *
+ * Returns 0 when:
+ *   - The file does not exist (fresh install).
+ *   - The file is unreadable (permissions, IO error).
+ *   - The file's contents do not parse as a positive integer (corruption,
+ *     truncation, manual edit).
+ *
+ * Never throws - the adapter calls this on hot paths and crashing here
+ * would block boot.
+ */
+export declare function loadLastId(): number;
+/**
+ * Atomically persist the cursor.
+ *
+ * Skips:
+ *   - Non-positive ids (0 means "no progress"; negative is malformed).
+ *   - Ids less than or equal to the currently persisted value (cursor must
+ *     advance monotonically). This guards against a backfill replay
+ *     accidentally rewinding the cursor.
+ *
+ * Clamp: the cursor never advances past the LOWEST still-pending unknown
+ * assistant id (see pending-unknown-store). Without this a sibling KNOWN
+ * message with a higher id would push the cursor past an unconsumed unknown
+ * message, stranding it forever (silent loss). The clamp holds the cursor just
+ * below the hole so the inbound window stays re-fetchable until the route heals
+ * and the pending id is consumed + cleared.
+ *
+ * Errors are caught + ignored - see module docstring.
+ */
+export declare function saveLastId(id: number): void;
+//# sourceMappingURL=last-id-store.d.ts.map

package/dist/last-id-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"last-id-store.d.ts","sourceRoot":"","sources":["../src/last-id-store.ts"],"names":[],"mappings":"AAiCA;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAUnC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAsB3C"}

package/dist/last-id-store.js

@@ -0,0 +1,101 @@
+/**
+ * Persistent cursor for the BGOS WebSocket inbound stream.
+ *
+ * CRITICAL - DO NOT REGRESS. Without persistence the adapter will replay
+ * every historical message on every restart (the REST backfill cursor
+ * starts at the loaded value), producing duplicate agent replies forever.
+ *
+ * See `memory/hermes_integration_shipped.md` "Critical gotcha: last-id
+ * persistence" for the full background - this is the same fix as Hermes
+ * commit-to-disk pattern, ported to TypeScript.
+ *
+ * File location: `$CODEX_BGOS_HOME/bgos_last_id` (default `~/.codex-bgos/bgos_last_id`).
+ *
+ * Format: a single integer in plain text, no newline. Atomic writes via
+ * write-to-tempfile + rename so a crash mid-write can't leave a half-
+ * written file.
+ *
+ * All errors are swallowed - disk full, permission denied, missing
+ * directory, etc. The worst case is a one-time replay on the next start;
+ * we'd rather not crash the adapter for a persistence hiccup.
+ */
+import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { lowestPendingUnknown } from "./pending-unknown-store.js";
+/** Resolve the target file path; respects `CODEX_BGOS_HOME` env override. */
+function lastIdPath() {
+    const root = process.env.CODEX_BGOS_HOME ?? join(homedir(), ".codex-bgos");
+    return join(root, "bgos_last_id");
+}
+/**
+ * Read the persisted cursor.
+ *
+ * Returns 0 when:
+ *   - The file does not exist (fresh install).
+ *   - The file is unreadable (permissions, IO error).
+ *   - The file's contents do not parse as a positive integer (corruption,
+ *     truncation, manual edit).
+ *
+ * Never throws - the adapter calls this on hot paths and crashing here
+ * would block boot.
+ */
+export function loadLastId() {
+    try {
+        const raw = readFileSync(lastIdPath(), "utf8").trim();
+        if (!raw)
+            return 0;
+        const n = Number(raw);
+        if (!Number.isFinite(n) || !Number.isInteger(n) || n < 0)
+            return 0;
+        return n;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Atomically persist the cursor.
+ *
+ * Skips:
+ *   - Non-positive ids (0 means "no progress"; negative is malformed).
+ *   - Ids less than or equal to the currently persisted value (cursor must
+ *     advance monotonically). This guards against a backfill replay
+ *     accidentally rewinding the cursor.
+ *
+ * Clamp: the cursor never advances past the LOWEST still-pending unknown
+ * assistant id (see pending-unknown-store). Without this a sibling KNOWN
+ * message with a higher id would push the cursor past an unconsumed unknown
+ * message, stranding it forever (silent loss). The clamp holds the cursor just
+ * below the hole so the inbound window stays re-fetchable until the route heals
+ * and the pending id is consumed + cleared.
+ *
+ * Errors are caught + ignored - see module docstring.
+ */
+export function saveLastId(id) {
+    if (!Number.isFinite(id) || !Number.isInteger(id) || id <= 0)
+        return;
+    try {
+        const current = loadLastId();
+        // Clamp against the lowest pending-unknown id so the cursor never strands
+        // an unconsumed message above the hole.
+        let advanceTo = id;
+        const lowest = lowestPendingUnknown();
+        if (lowest !== null && advanceTo >= lowest) {
+            advanceTo = lowest - 1;
+        }
+        if (advanceTo <= current)
+            return;
+        const target = lastIdPath();
+        mkdirSync(dirname(target), { recursive: true });
+        // Write to a sibling tempfile then rename so a partial write never
+        // leaves us with a corrupt cursor.
+        const tmp = `${target}.${process.pid}.tmp`;
+        writeFileSync(tmp, String(advanceTo), { mode: 0o600 });
+        renameSync(tmp, target);
+    }
+    catch {
+        /* swallow - see module docstring */
+    }
+}
+//# sourceMappingURL=last-id-store.js.map

package/dist/last-id-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"last-id-store.js","sourceRoot":"","sources":["../src/last-id-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAElE,6EAA6E;AAC7E,SAAS,UAAU;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,aAAa,CAAC,CAAC;IAC3E,OAAO,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,EAAE,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QACtD,IAAI,CAAC,GAAG;YAAE,OAAO,CAAC,CAAC;QACnB,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACtB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,OAAO,CAAC,CAAC;QACnE,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,UAAU,CAAC,EAAU;IACnC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;QAAE,OAAO;IACrE,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;QAC7B,0EAA0E;QAC1E,wCAAwC;QACxC,IAAI,SAAS,GAAG,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,oBAAoB,EAAE,CAAC;QACtC,IAAI,MAAM,KAAK,IAAI,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;YAC3C,SAAS,GAAG,MAAM,GAAG,CAAC,CAAC;QACzB,CAAC;QACD,IAAI,SAAS,IAAI,OAAO;YAAE,OAAO;QACjC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,mEAAmE;QACnE,mCAAmC;QACnC,MAAM,GAAG,GAAG,GAAG,MAAM,IAAI,OAAO,CAAC,GAAG,MAAM,CAAC;QAC3C,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACvD,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,oCAAoC;IACtC,CAAC;AACH,CAAC"}