@spinabot/brigade 1.7.0 → 1.8.0

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

@@ -0,0 +1,36 @@
+/**
+ * BlueBubbles outbound-addressing adapter (the `ChannelPlugin.messaging` slot).
+ *
+ * Turns the loose `to` the agent hands `send_message` ("+1 555 123 4567",
+ * "bluebubbles:user@example.com", "chat_guid:…") into a concrete target the
+ * runtime `sendText` understands. BlueBubbles shares iMessage's target grammar,
+ * so this reuses the iMessage target primitives (chat_guid / chat_id / handle)
+ * and only swaps the channel-name prefix to `bluebubbles:`.
+ */
+import { inferIMessageTargetChatType, looksLikeIMessageTargetId, normalizeIMessageHandle, } from "../imessage/targets.js";
+/** The BlueBubbles messaging adapter. */
+export const bluebubblesMessagingAdapter = {
+    parseExplicitTarget(text) {
+        const trimmed = (text ?? "").trim();
+        if (!trimmed)
+            return null;
+        // An explicit `bluebubbles:<handle>` form names the channel.
+        const m = /^bluebubbles:(.+)$/i.exec(trimmed);
+        if (m && m[1])
+            return { channelId: "bluebubbles", target: m[1].trim() };
+        // A concrete chat/service/handle id (vs a bare name) is an explicit target.
+        if (looksLikeIMessageTargetId(trimmed))
+            return { target: trimmed };
+        return null;
+    },
+    normalizeTarget(raw) {
+        const trimmed = (raw ?? "").trim();
+        if (!trimmed)
+            return trimmed;
+        return normalizeIMessageHandle(trimmed);
+    },
+    inferTargetChatType(target) {
+        return inferIMessageTargetChatType(target);
+    },
+};
+//# sourceMappingURL=messaging.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"messaging.js","sourceRoot":"","sources":["../../../../src/agents/channels/bluebubbles/messaging.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACN,2BAA2B,EAC3B,yBAAyB,EACzB,uBAAuB,GACvB,MAAM,wBAAwB,CAAC;AAEhC,yCAAyC;AACzC,MAAM,CAAC,MAAM,2BAA2B,GAA4B;IACnE,mBAAmB,CAAC,IAAY;QAC/B,MAAM,OAAO,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACpC,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAC1B,6DAA6D;QAC7D,MAAM,CAAC,GAAG,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACxE,4EAA4E;QAC5E,IAAI,yBAAyB,CAAC,OAAO,CAAC;YAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QACnE,OAAO,IAAI,CAAC;IACb,CAAC;IACD,eAAe,CAAC,GAAW;QAC1B,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,CAAC,OAAO;YAAE,OAAO,OAAO,CAAC;QAC7B,OAAO,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IACD,mBAAmB,CAAC,MAAc;QACjC,OAAO,2BAA2B,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC;CACD,CAAC"}

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

@@ -0,0 +1,24 @@
+/**
+ * BlueBubbles extension module.
+ *
+ * Registers the BlueBubbles channel adapter through the seam, AND — because
+ * BlueBubbles is a WEBHOOK-in channel — registers a gateway HTTP route PER
+ * configured account that receives the server's webhook POSTs and feeds them into
+ * the started adapter for THAT account (after verifying the password embedded in
+ * the registered webhook URL query string).
+ *
+ * The loader gates the adapter by the usual extension config; the adapter itself
+ * only starts when `channels.bluebubbles.enabled` is true AND a serverUrl +
+ * password resolve — so bundling this module is inert until the operator opts in.
+ *
+ *   - The default account keeps the base webhook path (`/bluebubbles/webhook`)
+ *     and feeds the inline adapter directly.
+ *   - Each NAMED account (only present when >1 account is configured) gets its own
+ *     route on a distinct path, whose `resolveSink` looks up THAT account's
+ *     STARTED adapter at request time via the per-account adapter registry
+ *     (`account-registry.ts`) the plugin populates on `startAccount`.
+ *     `b.httpRoute(...)` is only available at `register()` time (before the plugin
+ *     starts accounts), so the late binding is essential. Mirrors `slack/module.ts`.
+ */
+export declare const bluebubblesModule: import("../sdk.js").BrigadeModule;
+//# sourceMappingURL=module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../../src/agents/channels/bluebubbles/module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAcH,eAAO,MAAM,iBAAiB,mCA2B5B,CAAC"}

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

@@ -0,0 +1,52 @@
+/**
+ * BlueBubbles extension module.
+ *
+ * Registers the BlueBubbles channel adapter through the seam, AND — because
+ * BlueBubbles is a WEBHOOK-in channel — registers a gateway HTTP route PER
+ * configured account that receives the server's webhook POSTs and feeds them into
+ * the started adapter for THAT account (after verifying the password embedded in
+ * the registered webhook URL query string).
+ *
+ * The loader gates the adapter by the usual extension config; the adapter itself
+ * only starts when `channels.bluebubbles.enabled` is true AND a serverUrl +
+ * password resolve — so bundling this module is inert until the operator opts in.
+ *
+ *   - The default account keeps the base webhook path (`/bluebubbles/webhook`)
+ *     and feeds the inline adapter directly.
+ *   - Each NAMED account (only present when >1 account is configured) gets its own
+ *     route on a distinct path, whose `resolveSink` looks up THAT account's
+ *     STARTED adapter at request time via the per-account adapter registry
+ *     (`account-registry.ts`) the plugin populates on `startAccount`.
+ *     `b.httpRoute(...)` is only available at `register()` time (before the plugin
+ *     starts accounts), so the late binding is essential. Mirrors `slack/module.ts`.
+ */
+import { defineModule } from "../sdk.js";
+import { bluebubblesChannelEnabled, listBlueBubblesAccountIds, resolveBlueBubblesPassword, resolveBlueBubblesWebhookPath, BLUEBUBBLES_DEFAULT_ACCOUNT_ID, } from "./account-config.js";
+import { getBlueBubblesAccountSink } from "./account-registry.js";
+import { createBlueBubblesAdapter } from "./adapter.js";
+import { buildBlueBubblesWebhookRoute } from "./webhook.js";
+export const bluebubblesModule = defineModule({
+    id: "bluebubbles",
+    register(b) {
+        const adapter = createBlueBubblesAdapter();
+        b.channel(adapter);
+        // Only register inbound routes when the channel is enabled (a disabled
+        // install exposes no inbound HTTP surface).
+        if (!bluebubblesChannelEnabled(b.config))
+            return;
+        const accountIds = listBlueBubblesAccountIds(b.config);
+        const isMultiAccount = accountIds.length > 1;
+        for (const accountId of accountIds) {
+            const isDefault = accountId === BLUEBUBBLES_DEFAULT_ACCOUNT_ID;
+            b.httpRoute(buildBlueBubblesWebhookRoute({
+                path: resolveBlueBubblesWebhookPath(b.config, accountId),
+                // Each route verifies with ITS OWN account's password.
+                password: resolveBlueBubblesPassword(b.config, accountId),
+                resolveSink: isDefault && !isMultiAccount
+                    ? () => adapter
+                    : () => getBlueBubblesAccountSink(accountId) ?? null,
+            }));
+        }
+    },
+});
+//# sourceMappingURL=module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../../../../src/agents/channels/bluebubbles/module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EACN,yBAAyB,EACzB,yBAAyB,EACzB,0BAA0B,EAC1B,6BAA6B,EAC7B,8BAA8B,GAC9B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAA2B,MAAM,cAAc,CAAC;AACjF,OAAO,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AAE5D,MAAM,CAAC,MAAM,iBAAiB,GAAG,YAAY,CAAC;IAC7C,EAAE,EAAE,aAAa;IACjB,QAAQ,CAAC,CAAC;QACT,MAAM,OAAO,GAAG,wBAAwB,EAAwB,CAAC;QACjE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAEnB,uEAAuE;QACvE,4CAA4C;QAC5C,IAAI,CAAC,yBAAyB,CAAC,CAAC,CAAC,MAAe,CAAC;YAAE,OAAO;QAE1D,MAAM,UAAU,GAAG,yBAAyB,CAAC,CAAC,CAAC,MAAe,CAAC,CAAC;QAChE,MAAM,cAAc,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;QAC7C,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACpC,MAAM,SAAS,GAAG,SAAS,KAAK,8BAA8B,CAAC;YAC/D,CAAC,CAAC,SAAS,CACV,4BAA4B,CAAC;gBAC5B,IAAI,EAAE,6BAA6B,CAAC,CAAC,CAAC,MAAe,EAAE,SAAS,CAAC;gBACjE,uDAAuD;gBACvD,QAAQ,EAAE,0BAA0B,CAAC,CAAC,CAAC,MAAe,EAAE,SAAS,CAAC;gBAClE,WAAW,EACV,SAAS,IAAI,CAAC,cAAc;oBAC3B,CAAC,CAAC,GAAG,EAAE,CAAC,OAAO;oBACf,CAAC,CAAC,GAAG,EAAE,CAAC,yBAAyB,CAAC,SAAS,CAAC,IAAI,IAAI;aACtD,CAAC,CACF,CAAC;QACH,CAAC;IACF,CAAC;CACD,CAAC,CAAC"}

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

@@ -0,0 +1,111 @@
+/**
+ * BlueBubbles webhook normalisation — DEFENSIVE.
+ *
+ * BlueBubbles fires `new-message` / `updated-message` webhook POSTs whose payload
+ * shape varies by server version: the chat GUID may sit at the TOP LEVEL
+ * (`chatGuid` / `chat_guid`), nested under `chat` / `conversation`, OR in the
+ * `chats[0]` array. The sender may be a `handle` object, a `handle` string, or a
+ * `sender`/`from` field. This module reads ALL those shapes into one stable
+ * `NormalizedBlueBubblesMessage`, and surfaces the load-bearing decisions:
+ *
+ *   - `skip` reasons: `isFromMe` (we sent it) and tapback messages
+ *     (`associatedMessageType` 2000-3999 — these are DROPPED so the agent never
+ *     replies to a reaction as if it were text).
+ *   - DM vs group: derived from the chat-guid separator (`;-;` = DM, `;+;` =
+ *     group), then explicit flags, then participant count.
+ *   - a decoded tapback note (for optional surfacing) when the message is a tapback.
+ */
+import { type DecodedTapback } from "./reactions.js";
+import type { RawBlueBubblesAttachment } from "./media.js";
+/** A normalised inbound BlueBubbles message (transport-neutral). */
+export interface NormalizedBlueBubblesMessage {
+    /** The stable conversation id (a `chat_guid:` target the reply path understands). */
+    conversationId: string;
+    /** Raw chat GUID. */
+    chatGuid: string;
+    /** This message's GUID. */
+    messageGuid: string;
+    /** Sender handle (phone / email / `handle` string). */
+    from: string;
+    /** Optional display name of the sender. */
+    fromName?: string;
+    /** Message text (may be empty for a media-only message). */
+    text: string;
+    /** True when this is a group chat. */
+    isGroup: boolean;
+    /** When the platform stamped it (epoch ms), when known. */
+    timestampMs?: number;
+    /** A reply-to message GUID, when this message replies to another. */
+    replyToGuid?: string;
+    /**
+     * Handles mentioned in this message. iMessage has no @-mention metadata, so
+     * this is populated only when the bot's own `selfHandle` appears in the text —
+     * which is what lets the central pipeline's group requireMention gate fire.
+     */
+    mentions?: string[];
+    /**
+     * The GUID of the parent message this one is ASSOCIATED with (a link-preview
+     * balloon, a sticker, …). Carried for inbound coalescing — a text + its
+     * link-preview balloon arrive as two `new-message` webhooks; the debouncer
+     * keys both on this so they collapse into ONE logical message. Distinct from a
+     * tapback association (those are dropped earlier in `normalize`).
+     */
+    associatedMessageGuid?: string;
+    /**
+     * The balloon bundle id (`com.apple.messages.URLBalloonProvider`, sticker
+     * providers, …) when this message is a balloon rather than plain text. Present
+     * with `associatedMessageGuid` for a balloon; used as a coalescing signal.
+     */
+    balloonBundleId?: string;
+    /** Raw attachment descriptors (downloaded later, post-access-gate). */
+    attachments: RawBlueBubblesAttachment[];
+    /** The raw webhook payload (for the pipeline's `raw` field). */
+    raw: unknown;
+}
+/**
+ * A skip that MIGHT actually be a media message whose attachments indexed late
+ * (empty text + empty attachments + a real guid). The connection can use these
+ * fields to re-fetch the message's attachments and, only if media turns up,
+ * dispatch a synthetic inbound — without spamming the agent with truly-empty
+ * messages.
+ */
+export interface EmptyMediaCandidate {
+    messageGuid: string;
+    chatGuid: string;
+    from: string;
+    fromName?: string;
+    isGroup: boolean;
+    timestampMs?: number;
+}
+/** The result of normalising a webhook payload: a message, a skip, or a tapback note. */
+export type NormalizeResult = {
+    kind: "message";
+    message: NormalizedBlueBubblesMessage;
+} | {
+    kind: "skip";
+    reason: string;
+    mediaCandidate?: EmptyMediaCandidate;
+} | {
+    kind: "tapback";
+    tapback: DecodedTapback;
+    chatGuid: string;
+    targetGuid?: string;
+    from: string;
+    isGroup: boolean;
+};
+/**
+ * Detect whether the bot's own `selfHandle` is mentioned in the text. iMessage
+ * has no @-mention metadata, so "mention" = the bot's handle appearing in the
+ * message body. A phone handle matches on its digit-run inside the text's
+ * digits; an email matches case-insensitively. Returns the matched self handle
+ * in an array, or undefined when there's no match (so the field stays unset).
+ */
+export declare function detectBlueBubblesMentions(text: string, selfHandle: string | undefined): string[] | undefined;
+/**
+ * Normalise a BlueBubbles webhook payload. `eventType` is the webhook's declared
+ * type (`new-message` / `updated-message`). `selfHandle` (when set) lets group
+ * mention-gating fire by populating `mentions[]` when the bot is named in text.
+ * Returns a `message`, a `skip` (with a reason), or a `tapback` result.
+ */
+export declare function normalizeBlueBubblesWebhook(payload: unknown, eventType?: string, selfHandle?: string): NormalizeResult;
+//# sourceMappingURL=normalize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../../src/agents/channels/bluebubbles/normalize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAA8C,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACjG,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE3D,oEAAoE;AACpE,MAAM,WAAW,4BAA4B;IAC5C,qFAAqF;IACrF,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;;;;;OAMG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uEAAuE;IACvE,WAAW,EAAE,wBAAwB,EAAE,CAAC;IACxC,gEAAgE;IAChE,GAAG,EAAE,OAAO,CAAC;CACb;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,yFAAyF;AACzF,MAAM,MAAM,eAAe,GACxB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,4BAA4B,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,mBAAmB,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,cAAc,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC;AAgHvH;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,GAAG,SAAS,CAU5G;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,eAAe,CAuFtH"}

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

@@ -0,0 +1,239 @@
+/**
+ * BlueBubbles webhook normalisation — DEFENSIVE.
+ *
+ * BlueBubbles fires `new-message` / `updated-message` webhook POSTs whose payload
+ * shape varies by server version: the chat GUID may sit at the TOP LEVEL
+ * (`chatGuid` / `chat_guid`), nested under `chat` / `conversation`, OR in the
+ * `chats[0]` array. The sender may be a `handle` object, a `handle` string, or a
+ * `sender`/`from` field. This module reads ALL those shapes into one stable
+ * `NormalizedBlueBubblesMessage`, and surfaces the load-bearing decisions:
+ *
+ *   - `skip` reasons: `isFromMe` (we sent it) and tapback messages
+ *     (`associatedMessageType` 2000-3999 — these are DROPPED so the agent never
+ *     replies to a reaction as if it were text).
+ *   - DM vs group: derived from the chat-guid separator (`;-;` = DM, `;+;` =
+ *     group), then explicit flags, then participant count.
+ *   - a decoded tapback note (for optional surfacing) when the message is a tapback.
+ */
+import { decodeTapbackType, isTapbackAssociatedType } from "./reactions.js";
+function asRecord(v) {
+    return v && typeof v === "object" && !Array.isArray(v) ? v : null;
+}
+function readString(rec, ...keys) {
+    if (!rec)
+        return undefined;
+    for (const key of keys) {
+        const v = rec[key];
+        if (typeof v === "string" && v.trim())
+            return v.trim();
+    }
+    return undefined;
+}
+function readBoolean(rec, ...keys) {
+    if (!rec)
+        return undefined;
+    for (const key of keys) {
+        const v = rec[key];
+        if (typeof v === "boolean")
+            return v;
+    }
+    return undefined;
+}
+function readNumber(rec, ...keys) {
+    if (!rec)
+        return undefined;
+    for (const key of keys) {
+        const v = rec[key];
+        if (typeof v === "number" && Number.isFinite(v))
+            return v;
+    }
+    return undefined;
+}
+/** The first `chats[]` record on a message, or null. */
+function readFirstChatRecord(message) {
+    const chats = message.chats;
+    if (Array.isArray(chats) && chats.length > 0)
+        return asRecord(chats[0]);
+    return null;
+}
+/**
+ * Unwrap the webhook envelope to the inner message record. BlueBubbles nests the
+ * message under `data` (and sometimes `payload` / `event`); the inner message may
+ * itself be under `message` or be the record directly.
+ */
+function extractMessageRecord(payload) {
+    const root = asRecord(payload);
+    if (!root)
+        return null;
+    const data = asRecord(root.data) ?? asRecord(root.payload) ?? asRecord(root.event) ?? root;
+    return asRecord(data.message) ?? data;
+}
+/** Resolve the chat GUID across the top-level / nested / `chats[0]` shapes. */
+function resolveChatGuid(message) {
+    const chat = asRecord(message.chat) ?? asRecord(message.conversation);
+    const first = readFirstChatRecord(message);
+    return (readString(message, "chatGuid", "chat_guid") ??
+        readString(chat, "chatGuid", "chat_guid", "guid") ??
+        readString(first, "chatGuid", "chat_guid", "guid"));
+}
+/** Derive group-ness from the chat-guid separator (`;+;` group, `;-;` DM). */
+function isGroupFromGuid(chatGuid) {
+    if (!chatGuid)
+        return undefined;
+    if (chatGuid.includes(";+;"))
+        return true;
+    if (chatGuid.includes(";-;"))
+        return false;
+    return undefined;
+}
+/** Extract the sender handle (object handle / string handle / sender / from). */
+function resolveSender(message) {
+    const handle = asRecord(message.handle);
+    const fromHandle = readString(handle, "address", "handle", "id") ??
+        (typeof message.handle === "string" ? message.handle.trim() : undefined);
+    const from = fromHandle ?? readString(message, "sender", "from", "senderId") ?? "";
+    const fromName = readString(message, "displayName", "senderName") ?? readString(handle, "displayName");
+    return fromName ? { from, fromName } : { from };
+}
+/** Normalise a timestamp (s or ms) to epoch ms. */
+function resolveTimestampMs(message) {
+    const raw = readNumber(message, "dateCreated", "date", "timestamp");
+    if (raw === undefined)
+        return undefined;
+    return raw > 1e12 ? raw : raw * 1000;
+}
+/** Read the raw attachment descriptors (camel + snake case). */
+function resolveAttachments(message) {
+    const raw = message.attachments;
+    if (!Array.isArray(raw))
+        return [];
+    const out = [];
+    for (const a of raw) {
+        const rec = asRecord(a);
+        if (!rec)
+            continue;
+        const guid = readString(rec, "guid");
+        if (!guid)
+            continue;
+        const transferName = readString(rec, "transferName", "transfer_name");
+        const mimeType = readString(rec, "mimeType", "mime_type", "uti");
+        const totalBytes = readNumber(rec, "totalBytes", "total_bytes");
+        out.push({
+            guid,
+            ...(transferName ? { transferName } : {}),
+            ...(mimeType ? { mimeType } : {}),
+            ...(totalBytes !== undefined ? { totalBytes } : {}),
+        });
+    }
+    return out;
+}
+/**
+ * Detect whether the bot's own `selfHandle` is mentioned in the text. iMessage
+ * has no @-mention metadata, so "mention" = the bot's handle appearing in the
+ * message body. A phone handle matches on its digit-run inside the text's
+ * digits; an email matches case-insensitively. Returns the matched self handle
+ * in an array, or undefined when there's no match (so the field stays unset).
+ */
+export function detectBlueBubblesMentions(text, selfHandle) {
+    const handle = (selfHandle ?? "").trim();
+    if (!handle || !text)
+        return undefined;
+    if (handle.includes("@")) {
+        return text.toLowerCase().includes(handle.toLowerCase()) ? [handle] : undefined;
+    }
+    // Phone: compare digit-runs so "+1 (555) 123-4567" in text matches "15551234567".
+    const handleDigits = handle.replace(/[^0-9]/g, "");
+    if (handleDigits.length >= 5 && text.replace(/[^0-9]/g, "").includes(handleDigits))
+        return [handle];
+    return undefined;
+}
+/**
+ * Normalise a BlueBubbles webhook payload. `eventType` is the webhook's declared
+ * type (`new-message` / `updated-message`). `selfHandle` (when set) lets group
+ * mention-gating fire by populating `mentions[]` when the bot is named in text.
+ * Returns a `message`, a `skip` (with a reason), or a `tapback` result.
+ */
+export function normalizeBlueBubblesWebhook(payload, eventType, selfHandle) {
+    const message = extractMessageRecord(payload);
+    if (!message)
+        return { kind: "skip", reason: "unparseable payload" };
+    // We sent it — never reply to our own message.
+    const fromMe = readBoolean(message, "isFromMe", "is_from_me");
+    if (fromMe)
+        return { kind: "skip", reason: "isFromMe" };
+    const chatGuid = resolveChatGuid(message);
+    const { from, fromName } = resolveSender(message);
+    const isGroup = isGroupFromGuid(chatGuid) ?? readBoolean(message, "isGroup", "is_group") ?? false;
+    // Tapback: an `associatedMessageType` in the 2000-3999 range. DROP it as a
+    // normal message; surface a decoded note when it's one of the six tapbacks.
+    const associatedType = readNumber(message, "associatedMessageType", "associated_message_type");
+    if (isTapbackAssociatedType(associatedType)) {
+        const decoded = decodeTapbackType(associatedType);
+        const targetGuid = readString(message, "associatedMessageGuid", "associated_message_guid");
+        if (decoded && chatGuid) {
+            return {
+                kind: "tapback",
+                tapback: decoded,
+                chatGuid,
+                ...(targetGuid ? { targetGuid } : {}),
+                from,
+                isGroup,
+            };
+        }
+        return { kind: "skip", reason: "tapback" };
+    }
+    if (!chatGuid)
+        return { kind: "skip", reason: "no chat guid" };
+    const messageGuid = readString(message, "guid", "messageGuid") ?? "";
+    const text = readString(message, "text", "message") ?? "";
+    const attachments = resolveAttachments(message);
+    const timestampMs = resolveTimestampMs(message);
+    // Skip a truly empty message (no text, no media) — nothing to act on. BUT when
+    // it carries a real guid it MIGHT be a media message whose attachments indexed
+    // late (BlueBubbles fires the webhook before indexing finishes), so we hand the
+    // connection a `mediaCandidate` it can re-fetch + dispatch only if media exists.
+    if (!text && attachments.length === 0) {
+        const skip = { kind: "skip", reason: "empty message" };
+        if (messageGuid) {
+            skip.mediaCandidate = {
+                messageGuid,
+                chatGuid,
+                from,
+                ...(fromName ? { fromName } : {}),
+                isGroup,
+                ...(timestampMs !== undefined ? { timestampMs } : {}),
+            };
+        }
+        return skip;
+    }
+    // A reply target — but NOT a reaction association (that's handled above).
+    const replyToGuid = readString(message, "threadOriginatorGuid", "thread_originator_guid", "replyToGuid");
+    // Self-mention detection (group gating) — only meaningful in groups.
+    const mentions = isGroup ? detectBlueBubblesMentions(text, selfHandle) : undefined;
+    // Balloon-coalescing signals: a link-preview / sticker balloon carries an
+    // `associatedMessageGuid` pointing at its parent text + a `balloonBundleId`.
+    // These are NOT tapbacks (handled above) — they pass through as messages, and
+    // the debouncer keys them onto the parent so the two webhooks collapse.
+    const associatedMessageGuid = readString(message, "associatedMessageGuid", "associated_message_guid");
+    const balloonBundleId = readString(message, "balloonBundleId", "balloon_bundle_id");
+    return {
+        kind: "message",
+        message: {
+            conversationId: `chat_guid:${chatGuid}`,
+            chatGuid,
+            messageGuid,
+            from,
+            ...(fromName ? { fromName } : {}),
+            text,
+            isGroup,
+            ...(timestampMs !== undefined ? { timestampMs } : {}),
+            ...(replyToGuid ? { replyToGuid } : {}),
+            ...(mentions ? { mentions } : {}),
+            ...(associatedMessageGuid ? { associatedMessageGuid } : {}),
+            ...(balloonBundleId ? { balloonBundleId } : {}),
+            attachments,
+            raw: payload,
+        },
+    };
+}
+//# sourceMappingURL=normalize.js.map

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

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

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

@@ -0,0 +1,46 @@
+/**
+ * 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 type { BrigadeConfig } from "../../../config/types.js";
+import { type ChannelAdapter, type ChannelOutboundTarget, type ChannelPlugin, type StartChannelsArgs } from "../sdk.js";
+import { type ResolvedBlueBubblesAccount } from "./account-config.js";
+import { type BlueBubblesAdapter } from "./adapter.js";
+import { type BlueBubblesProbeResult } from "./probe.js";
+/** Dependencies the gateway hands the plugin to drive turns + replies. */
+export interface BlueBubblesPluginDeps {
+    defaultAgentId: string;
+    loadConfig: () => BrigadeConfig;
+    runTurn: StartChannelsArgs["runTurn"];
+    /** Optional adapter factory — tests inject a fake; production uses `createBlueBubblesAdapter`. */
+    adapterFactory?: (args: {
+        accountId: string;
+    }) => BlueBubblesAdapter;
+}
+/** Operator-grade view of a per-account bridge — exposed via attached helpers. */
+export interface BlueBubblesPluginRuntimeView {
+    startedAccountIds(): string[];
+    getAdapter(accountId: string): ChannelAdapter | undefined;
+    probeAccount(accountId: string, cfg: BrigadeConfig): Promise<BlueBubblesProbeResult>;
+}
+/** Plugin handle with the extra per-account introspection surface attached. */
+export type BlueBubblesPluginHandle = ChannelPlugin<ResolvedBlueBubblesAccount> & BlueBubblesPluginRuntimeView;
+/** Construct the plugin instance, capturing per-account runtime state in closure. */
+export declare function createBlueBubblesPlugin(deps: BlueBubblesPluginDeps): BlueBubblesPluginHandle;
+/** Outbound dispatch helper for callers reaching the plugin directly. */
+export type BlueBubblesOutboundTarget = ChannelOutboundTarget;
+//# sourceMappingURL=plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../src/agents/channels/bluebubbles/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAMN,KAAK,cAAc,EAKnB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAKlB,KAAK,iBAAiB,EAEtB,MAAM,WAAW,CAAC;AACnB,OAAO,EAQN,KAAK,0BAA0B,EAC/B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAA4B,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEjF,OAAO,EAAoB,KAAK,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAwB3E,0EAA0E;AAC1E,MAAM,WAAW,qBAAqB;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,aAAa,CAAC;IAChC,OAAO,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC;IACtC,kGAAkG;IAClG,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,KAAK,kBAAkB,CAAC;CACrE;AAED,kFAAkF;AAClF,MAAM,WAAW,4BAA4B;IAC5C,iBAAiB,IAAI,MAAM,EAAE,CAAC;IAC9B,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;IAC1D,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACrF;AAED,+EAA+E;AAC/E,MAAM,MAAM,uBAAuB,GAAG,aAAa,CAAC,0BAA0B,CAAC,GAAG,4BAA4B,CAAC;AAE/G,qFAAqF;AACrF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,qBAAqB,GAAG,uBAAuB,CAkM5F;AAOD,yEAAyE;AACzE,MAAM,MAAM,yBAAyB,GAAG,qBAAqB,CAAC"}