@spinabot/brigade 1.7.0 → 1.8.0

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

@@ -0,0 +1,242 @@
+/**
+ * BlueBubbles `ChannelPlugin` — the multi-ACCOUNT contract surface.
+ *
+ * Mirrors `slack/plugin.ts` (webhook-in + REST-out, multi-account): wraps
+ * `createBlueBubblesAdapter()` once per configured account, partitions per-account
+ * runtime in a `Map<accountId, AccountRuntime>`, and drives each account's inbound
+ * through the shared `runChannelInboundPipeline` so every account carries the
+ * identical ACL + debounce + abort surface.
+ *
+ * The webhook bridge: each module-registered route resolves its account's STARTED
+ * adapter via the per-account registry (`account-registry.ts`). This plugin
+ * populates that registry on `startAccount` (so a webhook POST for THIS account's
+ * path reaches THIS adapter) and clears it on `stopAccount` (so a torn-down
+ * account's route can't feed a dead adapter).
+ *
+ * The legacy single-account `createBlueBubblesAdapter` STEPS ASIDE when >1 account
+ * is configured (its `isConfigured` returns false for the default account).
+ */
+import { buildBundledCommands, createInboundPipelineContext, createSubsystemLogger, runChannelInboundPipeline, BLUEBUBBLES_CHANNEL_META, } from "../sdk.js";
+import { listBlueBubblesAccountIds, resolveBlueBubblesAccount, resolveBlueBubblesPassword, resolveBlueBubblesProbeTimeoutMs, resolveBlueBubblesServerUrl, BLUEBUBBLES_CHANNEL_ID, BLUEBUBBLES_DEFAULT_ACCOUNT_ID, } from "./account-config.js";
+import { registerBlueBubblesAccountSink, removeBlueBubblesAccountSink } from "./account-registry.js";
+import { createBlueBubblesAdapter } from "./adapter.js";
+import { bluebubblesMessagingAdapter } from "./messaging.js";
+import { probeBlueBubbles } from "./probe.js";
+import { collectBlueBubblesStatusIssues, statusAccountFromSnapshot, toChannelStatusIssues } from "./status-issues.js";
+const log = createSubsystemLogger("channels/bluebubbles/plugin");
+const BLUEBUBBLES_META = BLUEBUBBLES_CHANNEL_META;
+/** BlueBubbles capabilities baseline (rich actions are gated at runtime by Private-API status). */
+const BLUEBUBBLES_BASE_CAPABILITIES = {
+    chatTypes: ["direct", "group"],
+    media: true,
+    reply: true,
+    reactions: true,
+    edit: true,
+    unsend: true,
+};
+/** Construct the plugin instance, capturing per-account runtime state in closure. */
+export function createBlueBubblesPlugin(deps) {
+    const accountRuntimes = new Map();
+    const startAccount = async (ctx) => {
+        const accountId = ctx.accountId || BLUEBUBBLES_DEFAULT_ACCOUNT_ID;
+        const existing = accountRuntimes.get(accountId);
+        if (existing) {
+            try {
+                await existing.adapter.stop();
+            }
+            catch {
+                /* best-effort */
+            }
+            try {
+                existing.abort.abort("restart");
+            }
+            catch {
+                /* best-effort */
+            }
+            removeBlueBubblesAccountSink(accountId);
+            accountRuntimes.delete(accountId);
+        }
+        const cfg = deps.loadConfig();
+        const factory = deps.adapterFactory ?? defaultBlueBubblesAdapterFactory;
+        const adapter = factory({ accountId });
+        const accountAbort = new AbortController();
+        const parent = ctx.signal;
+        if (parent) {
+            if (parent.aborted)
+                accountAbort.abort();
+            else
+                parent.addEventListener("abort", () => accountAbort.abort(), { once: true });
+        }
+        const pipelineRunTurn = (turn) => deps.runTurn(turn);
+        const commandMap = new Map();
+        for (const c of buildBundledCommands(adapter))
+            commandMap.set(c.name.toLowerCase(), c);
+        const pipeline = createInboundPipelineContext({
+            adapter,
+            config: cfg,
+            agentId: deps.defaultAgentId,
+            runTurn: pipelineRunTurn,
+            commandMap,
+            parentAbort: accountAbort.signal,
+        });
+        const startCtx = {
+            signal: accountAbort.signal,
+            log: (msg, meta) => log.info(`[${accountId}] ${msg}`, meta),
+            onInbound: async (msg) => {
+                pipeline.config = deps.loadConfig();
+                const stamped = msg.accountId ? msg : { ...msg, accountId };
+                await runChannelInboundPipeline(pipeline, stamped);
+            },
+        };
+        try {
+            await adapter.start(startCtx);
+            accountRuntimes.set(accountId, { adapter, pipeline, abort: accountAbort });
+            // Bridge this started adapter to its webhook route via the registry.
+            registerBlueBubblesAccountSink(accountId, {
+                feedWebhookEvent: (eventType, payload) => adapter.feedWebhookEvent(eventType, payload),
+            });
+            log.info("bluebubbles account started", { accountId });
+        }
+        catch (err) {
+            log.warn("bluebubbles account failed to start", {
+                accountId,
+                error: err instanceof Error ? err.message : String(err),
+            });
+            throw err;
+        }
+    };
+    const stopAccount = async (ctx) => {
+        const runtime = accountRuntimes.get(ctx.accountId);
+        // Drop the sink BEFORE teardown so a late in-flight POST can't drive a dead adapter.
+        removeBlueBubblesAccountSink(ctx.accountId);
+        if (!runtime)
+            return;
+        accountRuntimes.delete(ctx.accountId);
+        try {
+            runtime.abort.abort("stop-requested");
+        }
+        catch {
+            /* best-effort */
+        }
+        for (const slot of runtime.pipeline.pendingDispatches.values())
+            clearTimeout(slot.timer);
+        runtime.pipeline.pendingDispatches.clear();
+        try {
+            await runtime.adapter.stop();
+        }
+        catch (err) {
+            log.warn("bluebubbles account stop threw", {
+                accountId: ctx.accountId,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    };
+    const logoutAccount = async (ctx) => {
+        try {
+            await stopAccount(ctx);
+            return { ok: true };
+        }
+        catch (err) {
+            return { ok: false, error: err instanceof Error ? err.message : String(err) };
+        }
+    };
+    return {
+        id: BLUEBUBBLES_CHANNEL_ID,
+        meta: BLUEBUBBLES_META,
+        capabilities: BLUEBUBBLES_BASE_CAPABILITIES,
+        startedAccountIds: () => [...accountRuntimes.keys()],
+        getAdapter: (accountId) => accountRuntimes.get(accountId)?.adapter,
+        probeAccount: async (accountId, cfg) => {
+            return probeBlueBubbles({
+                serverUrl: resolveBlueBubblesServerUrl(cfg, accountId),
+                password: resolveBlueBubblesPassword(cfg, accountId),
+                timeoutMs: resolveBlueBubblesProbeTimeoutMs(cfg, accountId),
+            });
+        },
+        config: {
+            listAccountIds: (cfg) => listBlueBubblesAccountIds(cfg),
+            resolveAccount: (cfg, accountId) => resolveBlueBubblesAccount(cfg, accountId ?? undefined),
+            defaultAccountId: () => BLUEBUBBLES_DEFAULT_ACCOUNT_ID,
+            isEnabled: (account) => account.enabled,
+        },
+        gateway: {
+            startAccount,
+            stopAccount,
+            logoutAccount,
+        },
+        status: {
+            // Stamp probe-derived diagnostics onto the open-shaped snapshot so
+            // `collectStatusIssues` can derive structured issues without re-probing.
+            buildAccountSnapshot: async ({ account, cfg, runtime }) => {
+                const base = { ...(runtime ?? {}), id: account.accountId };
+                const configured = Boolean(account.serverUrl) && Boolean(account.password);
+                base.configured = configured;
+                if (configured) {
+                    try {
+                        const probe = await probeBlueBubbles({
+                            serverUrl: resolveBlueBubblesServerUrl(cfg, account.accountId),
+                            password: resolveBlueBubblesPassword(cfg, account.accountId),
+                            timeoutMs: resolveBlueBubblesProbeTimeoutMs(cfg, account.accountId),
+                        });
+                        base.reachable = probe.ok;
+                        base.privateApi = probe.privateApi;
+                    }
+                    catch {
+                        base.reachable = false;
+                    }
+                }
+                return base;
+            },
+            collectStatusIssues: (accounts) => toChannelStatusIssues(collectBlueBubblesStatusIssues((accounts ?? []).map((s) => statusAccountFromSnapshot(s)))),
+        },
+        outbound: {
+            sendText: async (params) => {
+                const accountId = params.target.accountId || BLUEBUBBLES_DEFAULT_ACCOUNT_ID;
+                const runtime = accountRuntimes.get(accountId);
+                if (!runtime)
+                    return { ok: false, error: `bluebubbles account "${accountId}" is not running` };
+                try {
+                    const sent = await runtime.adapter.sendText(params.target.to, params.text, { accountId });
+                    return {
+                        ok: true,
+                        ...(sent && typeof sent === "object" && sent.messageId !== undefined ? { messageId: sent.messageId } : {}),
+                    };
+                }
+                catch (err) {
+                    return { ok: false, error: err instanceof Error ? err.message : String(err) };
+                }
+            },
+            sendMedia: async (params) => {
+                const accountId = params.target.accountId || BLUEBUBBLES_DEFAULT_ACCOUNT_ID;
+                const runtime = accountRuntimes.get(accountId);
+                if (!runtime || !runtime.adapter.sendMedia) {
+                    return { ok: false, error: `bluebubbles account "${accountId}" cannot send media right now` };
+                }
+                try {
+                    await runtime.adapter.sendMedia(params.target.to, {
+                        kind: params.mediaType ?? "document",
+                        path: params.mediaUrl,
+                        ...(params.caption !== undefined ? { caption: params.caption } : {}),
+                    });
+                    return { ok: true };
+                }
+                catch (err) {
+                    return { ok: false, error: err instanceof Error ? err.message : String(err) };
+                }
+            },
+        },
+        messaging: bluebubblesMessagingAdapter,
+        secrets: {
+            // The server password is a sealable secret-ref target.
+            secretTargetRegistryEntries: [
+                { path: "channels.bluebubbles.password", description: "BlueBubbles server password (single-account)" },
+                { path: "channels.bluebubbles.accounts.*.password", description: "BlueBubbles server password (per account)" },
+            ],
+        },
+    };
+}
+/** Default adapter factory — threads the per-account scope. */
+function defaultBlueBubblesAdapterFactory(args) {
+    return createBlueBubblesAdapter({ accountId: args.accountId });
+}
+//# sourceMappingURL=plugin.js.map

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

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

package/dist/agents/channels/bluebubbles/probe.d.ts

@@ -0,0 +1,79 @@
+/**
+ * BlueBubbles probe / doctor.
+ *
+ * `probeBlueBubbles` does a `GET /api/v1/server/info` round-trip. It NEVER throws
+ * — it returns `{ ok, error?, fatal?, serverInfo?, privateApi, elapsedMs }` so
+ * `brigade channels status` / `doctor` can render a verdict and the adapter can
+ * gate rich actions on the detected Private-API status (and advertise
+ * capabilities honestly). `fetch` is injectable (the test seam).
+ *
+ *   - `ok: false` + `fatal: true`  → server unreachable / auth rejected (config error).
+ *   - `ok: true`  + `privateApi`   → tri-state: true (rich actions live), false
+ *                                    (text-only), or null (unknown — server info
+ *                                    didn't report it).
+ */
+import { type BlueBubblesServerInfo, type FetchLike } from "./types.js";
+/** Result of a BlueBubbles probe — never throws; this is the verdict. */
+export interface BlueBubblesProbeResult {
+    ok: boolean;
+    /** Operator-facing failure reason (when `ok: false`). */
+    error?: string;
+    /** True when the failure is a config error (bad URL / password), not transient. */
+    fatal?: boolean;
+    /** The parsed server/info payload (when reachable). */
+    serverInfo?: BlueBubblesServerInfo;
+    /** Private-API status — true / false / null (unknown). Gates rich actions. */
+    privateApi: boolean | null;
+    /**
+     * The macOS MAJOR version of the BlueBubbles host (e.g. 14, 15, 26), parsed
+     * from `serverInfo.os_version`. null when unknown. macOS 26+ removed iMessage
+     * EDIT, so the adapter refuses `edit` cleanly when this is ≥ 26.
+     */
+    macOSMajor: number | null;
+    /** Round-trip time in ms. */
+    elapsedMs: number;
+}
+/** The macOS major version at/after which iMessage message EDIT is unsupported (Apple removed it). */
+export declare const BLUEBUBBLES_EDIT_UNSUPPORTED_MACOS_MAJOR = 26;
+/** True when the probed macOS major version no longer supports message edit (≥ 26). */
+export declare function isMacOSEditUnsupported(macOSMajor: number | null | undefined): boolean;
+export interface ProbeBlueBubblesArgs {
+    serverUrl: string;
+    password: string;
+    timeoutMs?: number;
+    /** TEST SEAM — inject a mock fetch. */
+    fetchImpl?: FetchLike;
+    /** Allow private/LAN/loopback hosts through the SSRF guard (default TRUE for BlueBubbles). */
+    allowPrivateNetwork?: boolean;
+}
+/** Probe a BlueBubbles server's `server/info`. Never throws. */
+export declare function probeBlueBubbles(args: ProbeBlueBubblesArgs): Promise<BlueBubblesProbeResult>;
+/** Default TTL for a cached probe result (10 min) — long enough to spare repeated sends a round-trip. */
+export declare const BLUEBUBBLES_SERVER_INFO_CACHE_TTL_MS: number;
+/** Cap on the number of distinct accounts held in the cache (LRU-ish; oldest evicted). */
+export declare const BLUEBUBBLES_SERVER_INFO_CACHE_MAX = 64;
+/** Read a non-expired cached probe for an account, or null. */
+export declare function getCachedBlueBubblesProbe(accountId: string, nowMs?: number): BlueBubblesProbeResult | null;
+/** Store a probe result for an account (refreshes its position for the LRU-ish cap). */
+export declare function setCachedBlueBubblesProbe(accountId: string, result: BlueBubblesProbeResult, ttlMs?: number, nowMs?: number): void;
+/** Clear the cache (tests + key rotation). */
+export declare function clearBlueBubblesProbeCache(): void;
+/** Args for a cached probe — a probe plus the account-scope key + TTL/clock seams. */
+export interface ProbeBlueBubblesCachedArgs extends ProbeBlueBubblesArgs {
+    /** Cache key — the account id this probe is scoped to. */
+    accountId: string;
+    /** Override the cache TTL (ms). */
+    cacheTtlMs?: number;
+    /** Clock seam (tests). */
+    now?: () => number;
+}
+/**
+ * Probe a BlueBubbles server, served from a per-account TTL cache when fresh.
+ * Repeated sends/actions within the TTL reuse the last probe (no extra
+ * round-trip). Only a SUCCESSFUL probe (`ok: true`) is cached — a transient
+ * failure isn't, so the next call retries the server. Never throws.
+ */
+export declare function probeBlueBubblesCached(args: ProbeBlueBubblesCachedArgs): Promise<BlueBubblesProbeResult>;
+/** Parse the macOS major version from a server/info `os_version` (e.g. `"26.1"` → 26). */
+export declare function parseMacOSMajorVersion(osVersion: string | undefined): number | null;
+//# sourceMappingURL=probe.d.ts.map

package/dist/agents/channels/bluebubbles/probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe.d.ts","sourceRoot":"","sources":["../../../../src/agents/channels/bluebubbles/probe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAGN,KAAK,qBAAqB,EAC1B,KAAK,SAAS,EACd,MAAM,YAAY,CAAC;AAEpB,yEAAyE;AACzE,MAAM,WAAW,sBAAsB;IACtC,EAAE,EAAE,OAAO,CAAC;IACZ,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,uDAAuD;IACvD,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,8EAA8E;IAC9E,UAAU,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3B;;;;OAIG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,sGAAsG;AACtG,eAAO,MAAM,wCAAwC,KAAK,CAAC;AAE3D,uFAAuF;AACvF,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAErF;AAED,MAAM,WAAW,oBAAoB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,8FAA8F;IAC9F,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,gEAAgE;AAChE,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAsDlG;AAID,yGAAyG;AACzG,eAAO,MAAM,oCAAoC,QAAiB,CAAC;AACnE,0FAA0F;AAC1F,eAAO,MAAM,iCAAiC,KAAK,CAAC;AAmBpD,+DAA+D;AAC/D,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,GAAE,MAAmB,GAAG,sBAAsB,GAAG,IAAI,CAQtH;AAED,wFAAwF;AACxF,wBAAgB,yBAAyB,CACxC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,sBAAsB,EAC9B,KAAK,GAAE,MAA6C,EACpD,KAAK,GAAE,MAAmB,GACxB,IAAI,CAIN;AAED,8CAA8C;AAC9C,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AAED,sFAAsF;AACtF,MAAM,WAAW,0BAA2B,SAAQ,oBAAoB;IACvE,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,0BAA0B,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAO9G;AAED,0FAA0F;AAC1F,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAKnF"}

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

@@ -0,0 +1,138 @@
+/**
+ * BlueBubbles probe / doctor.
+ *
+ * `probeBlueBubbles` does a `GET /api/v1/server/info` round-trip. It NEVER throws
+ * — it returns `{ ok, error?, fatal?, serverInfo?, privateApi, elapsedMs }` so
+ * `brigade channels status` / `doctor` can render a verdict and the adapter can
+ * gate rich actions on the detected Private-API status (and advertise
+ * capabilities honestly). `fetch` is injectable (the test seam).
+ *
+ *   - `ok: false` + `fatal: true`  → server unreachable / auth rejected (config error).
+ *   - `ok: true`  + `privateApi`   → tri-state: true (rich actions live), false
+ *                                    (text-only), or null (unknown — server info
+ *                                    didn't report it).
+ */
+import { blueBubblesFetchWithTimeout, buildBlueBubblesApiUrl, } from "./types.js";
+/** The macOS major version at/after which iMessage message EDIT is unsupported (Apple removed it). */
+export const BLUEBUBBLES_EDIT_UNSUPPORTED_MACOS_MAJOR = 26;
+/** True when the probed macOS major version no longer supports message edit (≥ 26). */
+export function isMacOSEditUnsupported(macOSMajor) {
+    return typeof macOSMajor === "number" && macOSMajor >= BLUEBUBBLES_EDIT_UNSUPPORTED_MACOS_MAJOR;
+}
+/** Probe a BlueBubbles server's `server/info`. Never throws. */
+export async function probeBlueBubbles(args) {
+    const start = Date.now();
+    if (!args.serverUrl.trim()) {
+        return { ok: false, error: "BlueBubbles serverUrl is not configured", fatal: true, privateApi: null, macOSMajor: null, elapsedMs: 0 };
+    }
+    let url;
+    try {
+        url = buildBlueBubblesApiUrl({ serverUrl: args.serverUrl, path: "server/info", password: args.password });
+    }
+    catch (err) {
+        return {
+            ok: false,
+            error: err instanceof Error ? err.message : String(err),
+            fatal: true,
+            privateApi: null,
+            macOSMajor: null,
+            elapsedMs: Date.now() - start,
+        };
+    }
+    try {
+        const res = await blueBubblesFetchWithTimeout(url, { method: "GET" }, { ...(args.timeoutMs !== undefined ? { timeoutMs: args.timeoutMs } : {}), ...(args.fetchImpl ? { fetchImpl: args.fetchImpl } : {}), ...(args.allowPrivateNetwork === false ? { allowPrivateNetwork: false } : {}) });
+        const elapsedMs = Date.now() - start;
+        if (res.status === 401 || res.status === 403) {
+            return { ok: false, error: "BlueBubbles rejected the password (401/403)", fatal: true, privateApi: null, macOSMajor: null, elapsedMs };
+        }
+        if (!res.ok) {
+            return { ok: false, error: `BlueBubbles server/info returned HTTP ${res.status}`, fatal: false, privateApi: null, macOSMajor: null, elapsedMs };
+        }
+        let serverInfo;
+        try {
+            const text = await res.text();
+            const body = text ? JSON.parse(text) : {};
+            const data = body.data;
+            if (data && typeof data === "object")
+                serverInfo = data;
+        }
+        catch {
+            serverInfo = undefined;
+        }
+        const privateApi = serverInfo && typeof serverInfo.private_api === "boolean" ? serverInfo.private_api : null;
+        const macOSMajor = parseMacOSMajorVersion(serverInfo?.os_version);
+        return { ok: true, ...(serverInfo ? { serverInfo } : {}), privateApi, macOSMajor, elapsedMs };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            error: err instanceof Error ? err.message : String(err),
+            fatal: false,
+            privateApi: null,
+            macOSMajor: null,
+            elapsedMs: Date.now() - start,
+        };
+    }
+}
+/* ───────────────────────── server-info cache ───────────────────────── */
+/** Default TTL for a cached probe result (10 min) — long enough to spare repeated sends a round-trip. */
+export const BLUEBUBBLES_SERVER_INFO_CACHE_TTL_MS = 10 * 60 * 1000;
+/** Cap on the number of distinct accounts held in the cache (LRU-ish; oldest evicted). */
+export const BLUEBUBBLES_SERVER_INFO_CACHE_MAX = 64;
+/** Module-level per-account cache of the last successful probe. */
+const serverInfoCache = new Map();
+/** Evict the oldest entry when over the cap (Map preserves insertion order). */
+function evictIfOver() {
+    while (serverInfoCache.size > BLUEBUBBLES_SERVER_INFO_CACHE_MAX) {
+        const oldest = serverInfoCache.keys().next().value;
+        if (oldest === undefined)
+            break;
+        serverInfoCache.delete(oldest);
+    }
+}
+/** Read a non-expired cached probe for an account, or null. */
+export function getCachedBlueBubblesProbe(accountId, nowMs = Date.now()) {
+    const hit = serverInfoCache.get(accountId);
+    if (!hit)
+        return null;
+    if (hit.expiresAt <= nowMs) {
+        serverInfoCache.delete(accountId);
+        return null;
+    }
+    return hit.result;
+}
+/** Store a probe result for an account (refreshes its position for the LRU-ish cap). */
+export function setCachedBlueBubblesProbe(accountId, result, ttlMs = BLUEBUBBLES_SERVER_INFO_CACHE_TTL_MS, nowMs = Date.now()) {
+    serverInfoCache.delete(accountId); // refresh insertion order
+    serverInfoCache.set(accountId, { result, expiresAt: nowMs + ttlMs });
+    evictIfOver();
+}
+/** Clear the cache (tests + key rotation). */
+export function clearBlueBubblesProbeCache() {
+    serverInfoCache.clear();
+}
+/**
+ * Probe a BlueBubbles server, served from a per-account TTL cache when fresh.
+ * Repeated sends/actions within the TTL reuse the last probe (no extra
+ * round-trip). Only a SUCCESSFUL probe (`ok: true`) is cached — a transient
+ * failure isn't, so the next call retries the server. Never throws.
+ */
+export async function probeBlueBubblesCached(args) {
+    const nowMs = (args.now ?? Date.now)();
+    const cached = getCachedBlueBubblesProbe(args.accountId, nowMs);
+    if (cached)
+        return cached;
+    const result = await probeBlueBubbles(args);
+    if (result.ok)
+        setCachedBlueBubblesProbe(args.accountId, result, args.cacheTtlMs ?? BLUEBUBBLES_SERVER_INFO_CACHE_TTL_MS, nowMs);
+    return result;
+}
+/** Parse the macOS major version from a server/info `os_version` (e.g. `"26.1"` → 26). */
+export function parseMacOSMajorVersion(osVersion) {
+    const m = /^(\d+)/.exec((osVersion ?? "").trim());
+    if (!m || !m[1])
+        return null;
+    const n = Number.parseInt(m[1], 10);
+    return Number.isFinite(n) ? n : null;
+}
+//# sourceMappingURL=probe.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"probe.js","sourceRoot":"","sources":["../../../../src/agents/channels/bluebubbles/probe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACN,2BAA2B,EAC3B,sBAAsB,GAGtB,MAAM,YAAY,CAAC;AAuBpB,sGAAsG;AACtG,MAAM,CAAC,MAAM,wCAAwC,GAAG,EAAE,CAAC;AAE3D,uFAAuF;AACvF,MAAM,UAAU,sBAAsB,CAAC,UAAqC;IAC3E,OAAO,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,IAAI,wCAAwC,CAAC;AACjG,CAAC;AAYD,gEAAgE;AAChE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAA0B;IAChE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC;QAC5B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,yCAAyC,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACvI,CAAC;IACD,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACJ,GAAG,GAAG,sBAAsB,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC3G,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,OAAO;YACN,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;YACvD,KAAK,EAAE,IAAI;YACX,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,IAAI;YAChB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;SAC7B,CAAC;IACH,CAAC;IACD,IAAI,CAAC;QACJ,MAAM,GAAG,GAAG,MAAM,2BAA2B,CAC5C,GAAG,EACH,EAAE,MAAM,EAAE,KAAK,EAAE,EACjB,EAAE,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,mBAAmB,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CACnN,CAAC;QACF,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QACrC,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC9C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,6CAA6C,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QACxI,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACb,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,yCAAyC,GAAG,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QACjJ,CAAC;QACD,IAAI,UAA6C,CAAC;QAClD,IAAI,CAAC;YACJ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAA6B,CAAC,CAAC,CAAC,EAAE,CAAC;YACvE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;YACvB,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;gBAAE,UAAU,GAAG,IAA6B,CAAC;QAClF,CAAC;QAAC,MAAM,CAAC;YACR,UAAU,GAAG,SAAS,CAAC;QACxB,CAAC;QACD,MAAM,UAAU,GACf,UAAU,IAAI,OAAO,UAAU,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3F,MAAM,UAAU,GAAG,sBAAsB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAClE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;IAC/F,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,OAAO;YACN,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;YACvD,KAAK,EAAE,KAAK;YACZ,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,IAAI;YAChB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;SAC7B,CAAC;IACH,CAAC;AACF,CAAC;AAED,2EAA2E;AAE3E,yGAAyG;AACzG,MAAM,CAAC,MAAM,oCAAoC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AACnE,0FAA0F;AAC1F,MAAM,CAAC,MAAM,iCAAiC,GAAG,EAAE,CAAC;AAOpD,mEAAmE;AACnE,MAAM,eAAe,GAAG,IAAI,GAAG,EAAuB,CAAC;AAEvD,gFAAgF;AAChF,SAAS,WAAW;IACnB,OAAO,eAAe,CAAC,IAAI,GAAG,iCAAiC,EAAE,CAAC;QACjE,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;QACnD,IAAI,MAAM,KAAK,SAAS;YAAE,MAAM;QAChC,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;AACF,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,yBAAyB,CAAC,SAAiB,EAAE,QAAgB,IAAI,CAAC,GAAG,EAAE;IACtF,MAAM,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC3C,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,IAAI,GAAG,CAAC,SAAS,IAAI,KAAK,EAAE,CAAC;QAC5B,eAAe,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC;IACb,CAAC;IACD,OAAO,GAAG,CAAC,MAAM,CAAC;AACnB,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,yBAAyB,CACxC,SAAiB,EACjB,MAA8B,EAC9B,QAAgB,oCAAoC,EACpD,QAAgB,IAAI,CAAC,GAAG,EAAE;IAE1B,eAAe,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,0BAA0B;IAC7D,eAAe,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,GAAG,KAAK,EAAE,CAAC,CAAC;IACrE,WAAW,EAAE,CAAC;AACf,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,0BAA0B;IACzC,eAAe,CAAC,KAAK,EAAE,CAAC;AACzB,CAAC;AAYD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAAgC;IAC5E,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IACvC,MAAM,MAAM,GAAG,yBAAyB,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAChE,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,MAAM,CAAC,EAAE;QAAE,yBAAyB,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,UAAU,IAAI,oCAAoC,EAAE,KAAK,CAAC,CAAC;IACjI,OAAO,MAAM,CAAC;AACf,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,sBAAsB,CAAC,SAA6B;IACnE,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAClD,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7B,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACpC,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACtC,CAAC"}

package/dist/agents/channels/bluebubbles/reactions.d.ts

@@ -0,0 +1,46 @@
+/**
+ * BlueBubbles tapback / reaction maps.
+ *
+ * iMessage "tapbacks" are the six canonical reactions. They cross the wire two
+ * different ways:
+ *
+ *   OUTBOUND — the Private-API `message/react` endpoint takes a TYPE NAME string
+ *   (`"love"`, `"like"`, …), with a leading `-` to REMOVE
+ *   (`"-love"`). `normalizeBlueBubblesReaction` resolves any input — a type name,
+ *   a common alias, or an emoji glyph — to that wire string.
+ *
+ *   INBOUND — a tapback arrives as a MESSAGE whose `associatedMessageType` is a
+ *   numeric code: `2000-2005` = ADD, `3000-3005` = REMOVE, in the canonical order
+ *   love/like/dislike/laugh/emphasize/question. `decodeTapbackType` maps that
+ *   code to `{ emoji, action }` so the inbound path can DROP the tapback as a
+ *   normal message and (optionally) surface it as a reaction note.
+ */
+/** The six canonical iMessage tapback types. */
+export type BlueBubblesReactionType = "love" | "like" | "dislike" | "laugh" | "emphasize" | "question";
+/**
+ * Resolve any reaction input to the BlueBubbles wire string for `message/react`.
+ * A leading `-` (e.g. `"-love"`) or the words `remove`/`removed` mark a REMOVAL.
+ * Returns null when the input doesn't map to a known tapback.
+ */
+export declare function normalizeBlueBubblesReaction(raw: string): string | null;
+/** Resolve a name/alias/emoji to a canonical reaction type (null when unknown). */
+export declare function resolveReactionType(raw: string): BlueBubblesReactionType | null;
+/** The decoded inbound tapback: which emoji, and add vs remove. */
+export interface DecodedTapback {
+    type: BlueBubblesReactionType;
+    emoji: string;
+    action: "added" | "removed";
+}
+/**
+ * Decode an inbound `associatedMessageType` numeric code into a tapback. Codes
+ * `2000-2005` are ADD; `3000-3005` are REMOVE; the low digit selects the type in
+ * canonical order. Returns null for any non-tapback type.
+ */
+export declare function decodeTapbackType(associatedMessageType: number | undefined): DecodedTapback | null;
+/**
+ * True iff an `associatedMessageType` is in the tapback range at all (2000-3999).
+ * Used to DROP a tapback-as-message so it isn't replied to as normal text and so
+ * a reaction-association isn't mistaken for a reply target.
+ */
+export declare function isTapbackAssociatedType(associatedMessageType: number | undefined): boolean;
+//# sourceMappingURL=reactions.d.ts.map

package/dist/agents/channels/bluebubbles/reactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactions.d.ts","sourceRoot":"","sources":["../../../../src/agents/channels/bluebubbles/reactions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,gDAAgD;AAChD,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,UAAU,CAAC;AAsHvG;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiBvE;AAED,mFAAmF;AACnF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,uBAAuB,GAAG,IAAI,CAS/E;AAED,mEAAmE;AACnE,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,uBAAuB,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,qBAAqB,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,GAAG,IAAI,CAgBlG;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,qBAAqB,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAO1F"}