@spinabot/brigade 1.7.0 → 1.8.0

package/dist/agents/channels/bluebubbles/adapter.js

@@ -0,0 +1,366 @@
+/**
+ * BlueBubbles channel adapter.
+ *
+ * Implements the Brigade `ChannelAdapter` contract on top of the BlueBubbles
+ * macOS server (REST-out, `connection.ts`) with inbound delivered via the gateway
+ * webhook route (`feedWebhookEvent` → the connection's normalize+dedupe path).
+ * BlueBubbles authenticates with a server password (sealed like Slack/Discord
+ * tokens); enablement is `channels.bluebubbles.enabled: true` plus a resolvable
+ * serverUrl + password.
+ *
+ * Unlike the native `imessage` channel, BlueBubbles supports REAL message actions
+ * via the server's Private API — reactions / edit / unsend — so this adapter
+ * advertises those capabilities (gated on `actions.*` config AND the live
+ * Private-API status from the probe) and implements `handleAction`.
+ *
+ * TEST SEAM: `connectImpl` overrides how the connection is built — production
+ * leaves it undefined and `connectBlueBubbles` is used with the real (injectable)
+ * fetch; a unit test injects a fake connection so send / action / inbound run
+ * with no live server.
+ */
+import { loadConfig } from "../../../core/config.js";
+import { chunkText, } from "../sdk.js";
+import { bluebubblesChannelEnabled, isBlueBubblesOpAllowed, listBlueBubblesAccountIds, resolveBlueBubblesAccount, resolveBlueBubblesPassword, resolveBlueBubblesServerUrl, BLUEBUBBLES_CHANNEL_ID, BLUEBUBBLES_DEFAULT_ACCOUNT_ID, } from "./account-config.js";
+import { connectBlueBubbles, } from "./connection.js";
+import { isMacOSEditUnsupported, probeBlueBubbles } from "./probe.js";
+/** Practical per-message text limit for chunked sends (before bubble-splitting). */
+const BLUEBUBBLES_TEXT_LIMIT = 10_000;
+/**
+ * Synthesise the agent-facing note for an inbound tapback. A tapback carries no
+ * text of its own, so the note ("<emoji> tapback on message <id>") is what the
+ * central pipeline routes through dispatchTurn so the agent has context.
+ */
+export function buildBlueBubblesReactionNote(emoji, targetMessageId) {
+    const target = targetMessageId.trim();
+    return target
+        ? `Reacted ${emoji} to message ${target}.`
+        : `Reacted ${emoji} to a message.`;
+}
+/** Build the capability flags for the account's action toggles + Private-API status. */
+function buildCapabilities(actions, privateApi) {
+    const richAvailable = privateApi === true;
+    return {
+        chatTypes: ["direct", "group"],
+        media: true,
+        reply: true,
+        reactions: actions.reactions && richAvailable,
+        edit: actions.edit && richAvailable,
+        unsend: actions.unsend && richAvailable,
+    };
+}
+async function loadStartConfig() {
+    return loadConfig();
+}
+export function createBlueBubblesAdapter(opts = {}) {
+    const accountId = opts.accountId?.trim() || BLUEBUBBLES_DEFAULT_ACCOUNT_ID;
+    const connectImpl = opts.connectImpl ?? connectBlueBubbles;
+    const probeImpl = opts.probeImpl ?? probeBlueBubbles;
+    let connection = null;
+    let lastConfig = null;
+    let lastEnv = process.env;
+    let started = false;
+    let privateApi = null;
+    let macOSMajor = null;
+    let selfHandle = "";
+    let actions = {
+        reactions: true,
+        edit: true,
+        unsend: true,
+        effects: true,
+        groupAdmin: true,
+    };
+    const adapter = {
+        id: BLUEBUBBLES_CHANNEL_ID,
+        label: "BlueBubbles",
+        isConfigured(cfg, env) {
+            lastConfig = cfg;
+            lastEnv = env ?? process.env;
+            if (!bluebubblesChannelEnabled(cfg))
+                return false;
+            // Need a resolvable server URL + password.
+            if (!resolveBlueBubblesServerUrl(cfg, accountId, env ?? process.env))
+                return false;
+            if (!resolveBlueBubblesPassword(cfg, accountId, env ?? process.env))
+                return false;
+            // Multi-account: the plugin path owns lifecycle when >1 account; the
+            // legacy single adapter steps aside.
+            const isLegacyAdapter = accountId === BLUEBUBBLES_DEFAULT_ACCOUNT_ID;
+            if (isLegacyAdapter && listBlueBubblesAccountIds(cfg).length > 1)
+                return false;
+            return true;
+        },
+        async start(ctx) {
+            const cfg = lastConfig ?? (await loadStartConfig());
+            const account = resolveBlueBubblesAccount(cfg, accountId, lastEnv);
+            actions = account.actions;
+            selfHandle = account.selfHandle;
+            // Probe once at start to detect Private-API status (gates rich actions +
+            // honest capabilities). Never throws.
+            try {
+                const probe = await probeImpl({
+                    serverUrl: account.serverUrl,
+                    password: account.password,
+                    timeoutMs: account.probeTimeoutMs,
+                });
+                privateApi = probe.privateApi;
+                macOSMajor = probe.macOSMajor ?? null;
+                if (!probe.ok)
+                    ctx.log(`BlueBubbles probe failed: ${probe.error ?? "unknown"}`);
+            }
+            catch {
+                privateApi = null;
+                macOSMajor = null;
+            }
+            try {
+                connection = connectImpl({
+                    account,
+                    log: ctx.log,
+                    privateApi,
+                    macOSMajor,
+                    onMessage: (msg) => {
+                        void ctx.onInbound({
+                            channel: BLUEBUBBLES_CHANNEL_ID,
+                            accountId,
+                            conversationId: msg.conversationId,
+                            ...(msg.messageGuid ? { messageId: msg.messageGuid } : {}),
+                            ...(msg.timestampMs !== undefined ? { messageTimestampMs: msg.timestampMs } : {}),
+                            from: msg.from,
+                            ...(msg.fromName !== undefined ? { fromName: msg.fromName } : {}),
+                            text: msg.text,
+                            chatType: msg.isGroup ? "group" : "direct",
+                            isGroup: msg.isGroup,
+                            ...(msg.replyToGuid ? { replyTo: { messageId: msg.replyToGuid } } : {}),
+                            ...(msg.mentions && msg.mentions.length > 0 ? { mentions: msg.mentions } : {}),
+                            ...(msg.resolveMedia ? { resolveMedia: msg.resolveMedia } : {}),
+                            raw: msg.raw,
+                        });
+                    },
+                    // Inbound tapback → synthesise a short note + a `reaction` event and
+                    // route it through the SAME inbound pipeline as a normal message so
+                    // the access gate + routing apply uniformly. Only "added" tapbacks
+                    // wake the agent (a removal is noise); the connection already gates
+                    // this on `actions.reactions`.
+                    onTapback: (note) => {
+                        if (note.action !== "added")
+                            return;
+                        const targetId = note.targetGuid ?? "";
+                        void ctx.onInbound({
+                            channel: BLUEBUBBLES_CHANNEL_ID,
+                            accountId,
+                            conversationId: note.conversationId,
+                            from: note.from,
+                            text: buildBlueBubblesReactionNote(note.emoji, targetId),
+                            chatType: note.isGroup ? "group" : "direct",
+                            isGroup: note.isGroup,
+                            reaction: { emojis: [note.emoji], targetMessageId: targetId },
+                        });
+                    },
+                });
+                started = true;
+                ctx.log("BlueBubbles connected");
+                ctx.onConnected?.();
+                // On (re)connect, backfill recently-missed messages so nothing is lost
+                // across a Brigade restart. Each fetched message replays through the
+                // SAME normalize+dedupe path as a live webhook, so a message already
+                // delivered live is dropped at dedupe (no double-delivery). Fire-and-
+                // forget + never throws — a backfill failure never blocks the channel.
+                void connection
+                    ?.runCatchup()
+                    .then((summary) => {
+                    if (summary.replayed > 0 || summary.fetched > 0) {
+                        ctx.log(`BlueBubbles catch-up: fetched ${summary.fetched}, replayed ${summary.replayed}`);
+                    }
+                })
+                    .catch((err) => ctx.log(`BlueBubbles catch-up failed: ${err instanceof Error ? err.message : String(err)}`));
+            }
+            catch (err) {
+                started = false;
+                ctx.log(`BlueBubbles failed to start: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        },
+        async stop() {
+            connection?.close();
+            connection = null;
+            started = false;
+        },
+        health() {
+            if (!connection || !started) {
+                return { ok: false, kind: "starting", reason: "BlueBubbles adapter is not started yet." };
+            }
+            return { ok: true };
+        },
+        feedWebhookEvent(eventType, payload) {
+            if (!connection)
+                return;
+            connection.feedWebhookEvent(eventType, payload);
+        },
+        async sendText(conversationId, text, opts) {
+            if (!connection)
+                throw new Error("BlueBubbles channel is not started");
+            // Chunk very long replies first (bubble-split happens inside the connection).
+            const chunks = chunkText(text, { limit: BLUEBUBBLES_TEXT_LIMIT });
+            let first = true;
+            let lastMessageId;
+            for (const chunk of chunks) {
+                if (!chunk.trim())
+                    continue;
+                const replyOpt = first && opts?.replyToId ? { replyToId: opts.replyToId } : {};
+                const sent = await connection.sendText(conversationId, chunk, { ...replyOpt });
+                if (sent.messageId)
+                    lastMessageId = sent.messageId;
+                first = false;
+            }
+            return lastMessageId ? { messageId: lastMessageId } : undefined;
+        },
+        async sendMedia(conversationId, media) {
+            if (!connection)
+                throw new Error("BlueBubbles channel is not started");
+            // Per-op gate: the operator can disable attachment sends independently.
+            if (!isBlueBubblesOpAllowed(actions, "sendAttachment")) {
+                throw new Error("BlueBubbles attachment sends are disabled (channels.bluebubbles.actions.sendAttachment = false)");
+            }
+            const sent = await connection.sendMedia(conversationId, media);
+            return sent.messageId ? { messageId: sent.messageId } : undefined;
+        },
+        // Read-receipt hook the pipeline calls after the access gate admits a
+        // sender (so a challenged stranger never sees a read receipt first).
+        // Cosmetic + best-effort: no-ops when the Private API is off, swallows
+        // transport errors (the pipeline already wraps this in a try/catch).
+        async markRead(conversationId) {
+            if (!connection)
+                return;
+            await connection.markRead(conversationId);
+        },
+        // Typing-indicator hook the pipeline calls around a turn so the user sees
+        // "typing…" while the agent thinks. Cosmetic; no-ops when the Private API
+        // is off. `composing` → start, `paused` → stop.
+        async setComposing(conversationId, state) {
+            if (!connection)
+                return;
+            await connection.setTyping(conversationId, state === "composing");
+        },
+        // The bot's own iMessage handle (when the operator configured
+        // `channels.bluebubbles.selfHandle`) — lets the central pipeline's group
+        // mention-gating match `msg.mentions` against the bot. Undefined when unset.
+        selfId() {
+            return selfHandle || undefined;
+        },
+        connectedAt() {
+            return connection?.connectedAt() ?? null;
+        },
+        // The BlueBubbles bot runs AS the operator's signed-in Messages.app, so the
+        // pairing card uses the "account" label.
+        pairing: { idLabel: "account" },
+        setup: {
+            credentialKeys: [
+                {
+                    key: "serverUrl",
+                    prompt: "BlueBubbles server URL (e.g. http://192.168.1.5:1234). Find it in the BlueBubbles Server app under Connection.",
+                    secret: false,
+                    envVar: "BLUEBUBBLES_SERVER_URL",
+                },
+                {
+                    key: "password",
+                    prompt: "BlueBubbles server password (BlueBubbles Server app → Settings).",
+                    secret: true,
+                    envVar: "BLUEBUBBLES_PASSWORD",
+                },
+                {
+                    key: "webhookPath",
+                    prompt: "Inbound webhook path (optional; default /bluebubbles/webhook). After setup, add your gateway URL + this path in BlueBubbles Server → Settings → Webhooks and enable it (e.g. https://your-gateway-host:3000/bluebubbles/webhook).",
+                    secret: false,
+                },
+                {
+                    key: "dmPolicy",
+                    prompt: "Who may DM this account? pairing (owner + approved; strangers challenged — default) / allowlist (only allowFrom) / open (anyone) / disabled (drop all DMs). Leave blank for pairing.",
+                    secret: false,
+                },
+                {
+                    key: "allowFrom",
+                    prompt: "Allowlist of senders for allowlist mode — handles or chat targets, comma-separated (e.g. +15555550123, user@example.com, chat_id:123). Leave blank for none.",
+                    secret: false,
+                },
+            ],
+            validateInput(key, value) {
+                const v = value.trim();
+                if (key === "serverUrl" && v && !/^https?:\/\//i.test(v) && !/^[\w.-]+(:\d+)?$/.test(v)) {
+                    return "Server URL must be a host or http(s):// URL.";
+                }
+                if (key === "webhookPath" && v && !v.startsWith("/")) {
+                    return "Webhook path must start with /.";
+                }
+                if (key === "dmPolicy" && v && !["pairing", "allowlist", "open", "disabled"].includes(v.toLowerCase())) {
+                    return "dmPolicy must be one of: pairing, allowlist, open, disabled.";
+                }
+                return null;
+            },
+            buildAccountConfig(values) {
+                const out = { enabled: true };
+                const serverUrl = (values.serverUrl ?? "").trim();
+                if (serverUrl)
+                    out.serverUrl = serverUrl;
+                const webhookPath = (values.webhookPath ?? "").trim();
+                if (webhookPath)
+                    out.webhookPath = webhookPath;
+                const dmPolicy = (values.dmPolicy ?? "").trim().toLowerCase();
+                if (dmPolicy && dmPolicy !== "pairing")
+                    out.dmPolicy = dmPolicy;
+                const allowFrom = (values.allowFrom ?? "")
+                    .split(/[\n,]+/g)
+                    .map((s) => s.trim())
+                    .filter(Boolean);
+                if (allowFrom.length > 0)
+                    out.allowFrom = allowFrom;
+                return out;
+            },
+        },
+        get capabilities() {
+            return buildCapabilities(actions, privateApi);
+        },
+        async handleAction(params) {
+            if (!connection)
+                return { ok: false, error: "BlueBubbles channel is not started" };
+            const action = params.action;
+            try {
+                switch (action.kind) {
+                    case "react": {
+                        if (!actions.reactions || privateApi !== true) {
+                            return { ok: false, error: "BlueBubbles reactions require the Private API" };
+                        }
+                        await connection.react({
+                            conversationId: params.conversationId,
+                            messageId: action.messageId,
+                            reaction: action.emoji,
+                        });
+                        return { ok: true };
+                    }
+                    case "edit": {
+                        if (!actions.edit || privateApi !== true) {
+                            return { ok: false, error: "BlueBubbles message edit requires the Private API" };
+                        }
+                        // macOS 26+ removed iMessage message EDIT — refuse cleanly.
+                        if (isMacOSEditUnsupported(macOSMajor)) {
+                            return { ok: false, error: "message edit isn't supported on macOS 26+" };
+                        }
+                        await connection.edit({ messageId: action.messageId, text: action.text });
+                        return { ok: true };
+                    }
+                    case "delete": {
+                        if (!actions.unsend || privateApi !== true) {
+                            return { ok: false, error: "BlueBubbles unsend requires the Private API" };
+                        }
+                        await connection.unsend({ messageId: action.messageId });
+                        return { ok: true };
+                    }
+                    default:
+                        return { ok: false, error: `BlueBubbles does not support the "${action.kind}" action` };
+                }
+            }
+            catch (err) {
+                return { ok: false, error: err instanceof Error ? err.message : String(err) };
+            }
+        },
+    };
+    return adapter;
+}
+//# sourceMappingURL=adapter.js.map

package/dist/agents/channels/bluebubbles/adapter.js.map

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

package/dist/agents/channels/bluebubbles/catchup-cursor.d.ts

@@ -0,0 +1,52 @@
+/**
+ * BlueBubbles catch-up cursor persistence.
+ *
+ * Catch-up recovers messages delivered while Brigade was down. A FIXED lookback
+ * window re-scans the same span every startup (re-deduping the overlap each
+ * time) and, worse, permanently loses anything older than the window when an
+ * outage runs long. A persisted per-account CURSOR (`lastSeenMs`) fixes both:
+ * each run queries strictly AFTER the last run's high-water mark, advances the
+ * cursor to "now" on success, holds it just before a still-retrying failure, and
+ * force-advances past a message that has failed `maxFailureRetries` times (so one
+ * malformed record can't wedge catch-up forever).
+ *
+ * The cursor is small per-account JSON under the channel's OWN state dir
+ * (`~/.brigade/channels/bluebubbles/accounts/<id>/catchup-cursor.json`) — no
+ * central store. Reads/writes are best-effort + total: a missing/garbage file
+ * loads as `null` (→ first-run lookback), a write failure is swallowed (the next
+ * run simply re-scans). `fs` is INJECTABLE for tests.
+ */
+/** The persisted cursor shape. */
+export interface BlueBubblesCatchupCursor {
+    /** High-water mark — the newest message timestamp this account has processed (epoch ms). */
+    lastSeenMs: number;
+    /** When the cursor was last written (epoch ms). */
+    updatedAt: number;
+    /**
+     * Per-message-GUID consecutive-failure counter, preserved across runs. An
+     * entry with `count >= maxFailureRetries` means catch-up has GIVEN UP on that
+     * GUID: it is skipped on sight and no longer holds the cursor back. A
+     * successful replay drops the entry. Optional so older cursor files load.
+     */
+    failureRetries?: Record<string, number>;
+}
+/** Defense-in-depth cap on the retry map size (a storm of unique failing GUIDs). */
+export declare const BLUEBUBBLES_MAX_FAILURE_RETRY_MAP_SIZE = 5000;
+/** A read/write seam so tests can run the cursor logic with no disk. */
+export interface BlueBubblesCursorStore {
+    load(accountId: string): BlueBubblesCatchupCursor | null;
+    save(accountId: string, cursor: BlueBubblesCatchupCursor): void;
+}
+/** Resolve the per-account cursor file path under the channel's state dir. */
+export declare function resolveCatchupCursorPath(accountId: string): string;
+/** Drop non-positive / non-finite / non-string entries from a loaded retry map. */
+export declare function sanitizeFailureRetries(raw: unknown): Record<string, number>;
+/**
+ * Cap the retry map to the `maxSize` highest-count entries (closest to give-up),
+ * deterministic tiebreak on GUID. A defense-in-depth bound, not the primary prune
+ * (entries not seen in a run are dropped by the caller building a fresh map).
+ */
+export declare function capFailureRetriesMap(map: Record<string, number>, maxSize: number): Record<string, number>;
+/** The default filesystem-backed cursor store (under the channel state dir). */
+export declare const filesystemCursorStore: BlueBubblesCursorStore;
+//# sourceMappingURL=catchup-cursor.d.ts.map

package/dist/agents/channels/bluebubbles/catchup-cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catchup-cursor.d.ts","sourceRoot":"","sources":["../../../../src/agents/channels/bluebubbles/catchup-cursor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAQH,kCAAkC;AAClC,MAAM,WAAW,wBAAwB;IACxC,4FAA4F;IAC5F,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED,oFAAoF;AACpF,eAAO,MAAM,sCAAsC,OAAQ,CAAC;AAE5D,wEAAwE;AACxE,MAAM,WAAW,sBAAsB;IACtC,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,wBAAwB,GAAG,IAAI,CAAC;IACzD,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,wBAAwB,GAAG,IAAI,CAAC;CAChE;AAED,8EAA8E;AAC9E,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGlE;AAED,mFAAmF;AACnF,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAS3E;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUzG;AAED,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,EAAE,sBAgDnC,CAAC"}

package/dist/agents/channels/bluebubbles/catchup-cursor.js

@@ -0,0 +1,118 @@
+/**
+ * BlueBubbles catch-up cursor persistence.
+ *
+ * Catch-up recovers messages delivered while Brigade was down. A FIXED lookback
+ * window re-scans the same span every startup (re-deduping the overlap each
+ * time) and, worse, permanently loses anything older than the window when an
+ * outage runs long. A persisted per-account CURSOR (`lastSeenMs`) fixes both:
+ * each run queries strictly AFTER the last run's high-water mark, advances the
+ * cursor to "now" on success, holds it just before a still-retrying failure, and
+ * force-advances past a message that has failed `maxFailureRetries` times (so one
+ * malformed record can't wedge catch-up forever).
+ *
+ * The cursor is small per-account JSON under the channel's OWN state dir
+ * (`~/.brigade/channels/bluebubbles/accounts/<id>/catchup-cursor.json`) — no
+ * central store. Reads/writes are best-effort + total: a missing/garbage file
+ * loads as `null` (→ first-run lookback), a write failure is swallowed (the next
+ * run simply re-scans). `fs` is INJECTABLE for tests.
+ */
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import path from "node:path";
+import { ensureDir, resolveChannelStateDir } from "../sdk.js";
+import { BLUEBUBBLES_CHANNEL_ID } from "./account-config.js";
+/** Defense-in-depth cap on the retry map size (a storm of unique failing GUIDs). */
+export const BLUEBUBBLES_MAX_FAILURE_RETRY_MAP_SIZE = 5_000;
+/** Resolve the per-account cursor file path under the channel's state dir. */
+export function resolveCatchupCursorPath(accountId) {
+    const safe = accountId.replace(/[^a-zA-Z0-9_-]/g, "_") || "default";
+    return path.join(resolveChannelStateDir(BLUEBUBBLES_CHANNEL_ID), "accounts", safe, "catchup-cursor.json");
+}
+/** Drop non-positive / non-finite / non-string entries from a loaded retry map. */
+export function sanitizeFailureRetries(raw) {
+    if (!raw || typeof raw !== "object")
+        return {};
+    const out = {};
+    for (const [guid, count] of Object.entries(raw)) {
+        if (!guid || typeof guid !== "string")
+            continue;
+        if (typeof count !== "number" || !Number.isFinite(count) || count <= 0)
+            continue;
+        out[guid] = Math.floor(count);
+    }
+    return out;
+}
+/**
+ * Cap the retry map to the `maxSize` highest-count entries (closest to give-up),
+ * deterministic tiebreak on GUID. A defense-in-depth bound, not the primary prune
+ * (entries not seen in a run are dropped by the caller building a fresh map).
+ */
+export function capFailureRetriesMap(map, maxSize) {
+    const entries = Object.entries(map);
+    if (entries.length <= maxSize)
+        return map;
+    entries.sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]));
+    const capped = {};
+    for (let i = 0; i < maxSize; i++) {
+        const [guid, count] = entries[i];
+        capped[guid] = count;
+    }
+    return capped;
+}
+/** The default filesystem-backed cursor store (under the channel state dir). */
+export const filesystemCursorStore = {
+    load(accountId) {
+        const file = resolveCatchupCursorPath(accountId);
+        let text;
+        try {
+            text = readFileSync(file, "utf8");
+        }
+        catch {
+            return null; // missing → first run
+        }
+        try {
+            const value = JSON.parse(text);
+            if (!value || typeof value !== "object")
+                return null;
+            if (typeof value.lastSeenMs !== "number" || !Number.isFinite(value.lastSeenMs))
+                return null;
+            const failureRetries = sanitizeFailureRetries(value.failureRetries);
+            const hasRetries = Object.keys(failureRetries).length > 0;
+            return {
+                lastSeenMs: value.lastSeenMs,
+                updatedAt: typeof value.updatedAt === "number" ? value.updatedAt : 0,
+                ...(hasRetries ? { failureRetries } : {}),
+            };
+        }
+        catch {
+            return null; // garbage → first run
+        }
+    },
+    save(accountId, cursor) {
+        const file = resolveCatchupCursorPath(accountId);
+        try {
+            ensureDir(path.dirname(file));
+        }
+        catch {
+            try {
+                mkdirSync(path.dirname(file), { recursive: true });
+            }
+            catch {
+                return; // can't make the dir → best-effort skip
+            }
+        }
+        const sanitized = sanitizeFailureRetries(cursor.failureRetries);
+        const hasRetries = Object.keys(sanitized).length > 0;
+        const payload = {
+            lastSeenMs: cursor.lastSeenMs,
+            updatedAt: cursor.updatedAt,
+            ...(hasRetries ? { failureRetries: sanitized } : {}),
+        };
+        try {
+            writeFileSync(file, JSON.stringify(payload), "utf8");
+        }
+        catch {
+            /* best-effort — next run re-scans */
+        }
+    },
+};
+//# sourceMappingURL=catchup-cursor.js.map

package/dist/agents/channels/bluebubbles/catchup-cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catchup-cursor.js","sourceRoot":"","sources":["../../../../src/agents/channels/bluebubbles/catchup-cursor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAiB7D,oFAAoF;AACpF,MAAM,CAAC,MAAM,sCAAsC,GAAG,KAAK,CAAC;AAQ5D,8EAA8E;AAC9E,MAAM,UAAU,wBAAwB,CAAC,SAAiB;IACzD,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,IAAI,SAAS,CAAC;IACpE,OAAO,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,sBAAsB,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,qBAAqB,CAAC,CAAC;AAC3G,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,sBAAsB,CAAC,GAAY;IAClD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IAC/C,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAA8B,CAAC,EAAE,CAAC;QAC5E,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,SAAS;QAChD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;YAAE,SAAS;QACjF,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAA2B,EAAE,OAAe;IAChF,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO;QAAE,OAAO,GAAG,CAAC;IAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChE,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IACtB,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,MAAM,qBAAqB,GAA2B;IAC5D,IAAI,CAAC,SAAiB;QACrB,MAAM,IAAI,GAAG,wBAAwB,CAAC,SAAS,CAAC,CAAC;QACjD,IAAI,IAAY,CAAC;QACjB,IAAI,CAAC;YACJ,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,IAAI,CAAC,CAAC,sBAAsB;QACpC,CAAC;QACD,IAAI,CAAC;YACJ,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAA6C,CAAC;YAC3E,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC;YACrD,IAAI,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC5F,MAAM,cAAc,GAAG,sBAAsB,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;YACpE,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;YAC1D,OAAO;gBACN,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,SAAS,EAAE,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;gBACpE,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACzC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,IAAI,CAAC,CAAC,sBAAsB;QACpC,CAAC;IACF,CAAC;IACD,IAAI,CAAC,SAAiB,EAAE,MAAgC;QACvD,MAAM,IAAI,GAAG,wBAAwB,CAAC,SAAS,CAAC,CAAC;QACjD,IAAI,CAAC;YACJ,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACR,IAAI,CAAC;gBACJ,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACpD,CAAC;YAAC,MAAM,CAAC;gBACR,OAAO,CAAC,wCAAwC;YACjD,CAAC;QACF,CAAC;QACD,MAAM,SAAS,GAAG,sBAAsB,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QAChE,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QACrD,MAAM,OAAO,GAA6B;YACzC,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACpD,CAAC;QACF,IAAI,CAAC;YACJ,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC;QACtD,CAAC;QAAC,MAAM,CAAC;YACR,qCAAqC;QACtC,CAAC;IACF,CAAC;CACD,CAAC"}