@spinabot/brigade 0.1.2 → 1.0.1

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

@@ -0,0 +1,270 @@
+/**
+ * WhatsApp channel adapter.
+ *
+ * Implements the Brigade `ChannelAdapter` contract on top of the Baileys
+ * connection. Linking is QR-based (no API key): on first start it prints a QR
+ * to the gateway terminal and surfaces it via `ctx.onPairing`; once scanned,
+ * creds persist under `~/.brigade/channels/whatsapp/auth/` and subsequent boots
+ * reconnect silently.
+ *
+ * Enablement is explicit — `channels.whatsapp.enabled: true` in brigade.json —
+ * so the gateway never prints a QR unless the operator opted in.
+ */
+import path from "node:path";
+import { tryGetRuntimeContext } from "../../../storage/runtime-context.js";
+import { ensureDir, resolveChannelStateDir } from "../../../config/paths.js";
+import { listWhatsAppAccountIds, resolveWhatsAppAccountAuthDir, whatsappChannelEnabled, } from "./account-config.js";
+import { connectWhatsApp, toWhatsAppJid } from "./connection.js";
+const CHANNEL_ID = "whatsapp";
+/** Default account id for legacy single-account installs. */
+const DEFAULT_ACCOUNT_ID = "default";
+/** Render a QR to the terminal (lazy-imports qrcode-terminal). */
+async function printQr(qr) {
+    try {
+        const mod = await import("qrcode-terminal");
+        const qrcode = (mod.default ?? mod);
+        // Friendly, on-brand prompt rendered ONCE above the QR. The CLI link
+        // command intentionally does not print a second prompt below — one
+        // instruction is enough, more is clutter.
+        process.stdout.write("\n📱  Scan this QR from WhatsApp → Settings → Linked Devices → Link a Device:\n\n");
+        qrcode.generate(qr, { small: true });
+    }
+    catch {
+        // qrcode-terminal missing — fall back to the raw string so linking still works.
+        process.stdout.write(`\nWhatsApp QR (paste into a QR renderer to link):\n${qr}\n`);
+    }
+}
+export function createWhatsAppAdapter(opts = {}) {
+    /** Account id this adapter instance represents — stamped on every inbound. */
+    const accountId = opts.accountId?.trim() || DEFAULT_ACCOUNT_ID;
+    /** Auth directory override (multi-account plugin path), else derived per-account in start(). */
+    const authDirOverride = opts.authDir?.trim();
+    let connection = null;
+    // Health state captured from the connection's lifecycle callbacks. The
+    // adapter is otherwise stateless about session liveness — Baileys owns
+    // the socket — so we mirror just enough into these flags for the
+    // `health()` method (and every caller that depends on it) to refuse a
+    // send against a dead session without dialling Baileys on the hot path.
+    //
+    //   - `connected` flips true when the WS handshakes + flips false again
+    //     on any close (network drop, server kick, logout).
+    //   - `loggedOut` is a STICKY terminal: once the phone or the platform
+    //     terminates the link, reconnect is no longer attempted (per the
+    //     connection layer's "dead creds — never reconnect" path) and the
+    //     ONLY recovery is `brigade channels link`. The flag stays true
+    //     until the next successful `onConnected` from a freshly-paired
+    //     adapter (after the operator runs the unlink + link CLI flow).
+    let connected = false;
+    let loggedOut = false;
+    return {
+        id: CHANNEL_ID,
+        label: "WhatsApp",
+        isConfigured(cfg) {
+            if (!whatsappChannelEnabled(cfg))
+                return false;
+            // Legacy single-adapter boot: when the operator declared
+            // `channels.whatsapp.accounts:[...]` with more than one entry, the
+            // plugin path owns lifecycle — the legacy adapter steps aside so
+            // the gateway doesn't double-spawn the default-account socket.
+            const isLegacyAdapter = !authDirOverride && accountId === DEFAULT_ACCOUNT_ID;
+            if (isLegacyAdapter && listWhatsAppAccountIds(cfg).length > 1)
+                return false;
+            return true;
+        },
+        async start(ctx) {
+            // When the plugin path resolved a per-account auth dir, use it; legacy
+            // single-adapter callers fall back to the channel-state-dir layout.
+            const authDir = authDirOverride ??
+                (accountId === DEFAULT_ACCOUNT_ID
+                    ? path.join(resolveChannelStateDir(CHANNEL_ID), "auth")
+                    : resolveWhatsAppAccountAuthDir(accountId));
+            // Convex mode never uses the on-disk auth dir (useConvexAuthState
+            // owns auth) — creating it would write under ~/.brigade and trip
+            // the strict-zero guard. Skip; pass accountId so the convex auth
+            // tables key per-account (multi-account safe).
+            if (tryGetRuntimeContext()?.mode !== "convex")
+                ensureDir(authDir);
+            connection = await connectWhatsApp({
+                authDir,
+                accountId,
+                verbose: false,
+                log: ctx.log,
+                // Plumb linkMode from the channel-start context so the CLI's
+                // `channels link` command gets clean one-shot behavior, while the
+                // gateway path keeps its aggressive auto-reconnect.
+                linkMode: ctx.linkMode === true,
+                // Forward polished link-progress strings to the CLI when present.
+                onLinkProgress: ctx.onLinkProgress,
+                onQr: (qr) => {
+                    ctx.onPairing?.({ kind: "qr", value: qr });
+                    void printQr(qr);
+                },
+                onConnected: () => {
+                    connected = true;
+                    // A fresh `onConnected` clears a prior sticky logged-out state —
+                    // the operator must have re-linked via the CLI flow.
+                    loggedOut = false;
+                    ctx.log("WhatsApp ready");
+                    ctx.onConnected?.();
+                },
+                onLoggedOut: () => {
+                    connected = false;
+                    loggedOut = true;
+                    // Recipient-friendly wording — no on-disk paths, no "delete X then …"
+                    // instructions. The operator gets a clean recovery flow via the CLI
+                    // (`brigade channels unlink` wipes the local credentials; then
+                    // `brigade channels link` walks them through a fresh scan). Path
+                    // names belong in operator logs, not in user-visible CLI output.
+                    ctx.log("WhatsApp was unlinked. Run `brigade channels unlink --channel whatsapp` then `brigade channels link` to scan a new code.");
+                    ctx.onLoggedOut?.();
+                },
+                onMessage: (msg) => {
+                    void ctx.onInbound({
+                        channel: CHANNEL_ID,
+                        // Stamp the per-account scope on every inbound so the channel
+                        // manager + 8-tier router can disambiguate sibling accounts
+                        // (e.g. personal vs work) sharing the same `from` phone digits.
+                        // Closure-bound — there's one adapter instance per account in
+                        // the plugin path; the legacy single-adapter path stamps the
+                        // default id transparently for back-compat.
+                        accountId,
+                        conversationId: msg.conversationId,
+                        messageId: msg.messageId,
+                        participantId: msg.participantId,
+                        messageTimestampMs: msg.messageTimestampMs,
+                        from: msg.from,
+                        senderLid: msg.senderLid,
+                        fromName: msg.fromName,
+                        text: msg.text,
+                        chatType: msg.chatType,
+                        isGroup: msg.chatType === "group",
+                        mentions: msg.mentions,
+                        replyTo: msg.replyTo,
+                        media: msg.media,
+                        // Deferred media thunk rides through untouched — the pipeline
+                        // resolves it only after the access gate admits the sender.
+                        resolveMedia: msg.resolveMedia,
+                        raw: msg.raw,
+                    });
+                },
+            });
+        },
+        async stop() {
+            await connection?.close();
+            connection = null;
+            connected = false;
+        },
+        /**
+         * Synchronous read of the cached session state. Returns:
+         *   - `{ ok: true }` once Baileys has signalled a successful handshake
+         *     AND the session hasn't been terminated since.
+         *   - `{ ok: false, kind: "logged-out" }` after the phone / platform
+         *     unlinks the session. Sticky — the only recovery is the operator
+         *     re-pairing via `brigade channels link`.
+         *   - `{ ok: false, kind: "starting" }` between `start()` and the first
+         *     `onConnected` callback (incl. during QR-scan link flow).
+         *   - `{ ok: false, kind: "disconnected" }` for transient drops where
+         *     reconnect is in-flight but the socket isn't ready yet.
+         *
+         * Cheap — reads two booleans. Safe to call from cron timer / send tool
+         * pre-flights without any I/O.
+         */
+        health() {
+            if (loggedOut) {
+                return {
+                    ok: false,
+                    kind: "logged-out",
+                    reason: "WhatsApp was unlinked from the operator's phone — Brigade can't send until it's paired again.",
+                    remediation: "Run `brigade channels unlink --channel whatsapp` then `brigade channels link --channel whatsapp` and scan the new QR.",
+                };
+            }
+            if (!connection) {
+                return {
+                    ok: false,
+                    kind: "starting",
+                    reason: "WhatsApp adapter is not started yet.",
+                };
+            }
+            if (!connected) {
+                return {
+                    ok: false,
+                    kind: "disconnected",
+                    reason: "WhatsApp socket is reconnecting — sends will fail until the link comes back up.",
+                };
+            }
+            return { ok: true };
+        },
+        async sendText(conversationId, text, opts) {
+            if (!connection)
+                throw new Error("WhatsApp channel is not started");
+            if (loggedOut) {
+                throw new Error("WhatsApp is unlinked — run `brigade channels link --channel whatsapp` to re-pair, then retry.");
+            }
+            if (!connected) {
+                throw new Error("WhatsApp socket is reconnecting — try again in a moment.");
+            }
+            // Normalise to a JID — accept human-shaped phone numbers like
+            // "+1 555 010 0001" / "+15550100001" / "15550100001" by stripping
+            // formatting and appending `@s.whatsapp.net`. Without this Baileys'
+            // `jidDecode` returns undefined for a bare-phone input and the send
+            // crashes with the opaque "Cannot destructure property 'user' of
+            // 'jidDecode(...)' as it is undefined" — exactly what the operator
+            // hit when telling the model "send hi to a bare number". JIDs / group ids /
+            // LID aliases pass through unchanged.
+            const jid = toWhatsAppJid(conversationId);
+            if (!jid) {
+                throw new Error(`WhatsApp: couldn't normalise recipient "${conversationId}" — pass a phone number (e.g. +15550100001) or a WhatsApp JID.`);
+            }
+            // WhatsApp has no thread routing — `opts.threadId` is accepted for
+            // signature compatibility with threaded channels (Slack/Discord)
+            // and silently ignored here.
+            void opts;
+            await connection.sendText(jid, text);
+        },
+        // Pairing customization — WhatsApp ids are international phone numbers,
+        // so the challenge card uses the "Your number: +X" line. No
+        // `normalizeAllowEntry` (numbers are already in canonical form by the
+        // time they reach the allow store) and no `notifyApproval` (operator
+        // can DM the approved sender manually for now).
+        pairing: { idLabel: "phone" },
+        async sendMedia(conversationId, media) {
+            if (!connection)
+                throw new Error("WhatsApp channel is not started");
+            const jid = toWhatsAppJid(conversationId);
+            if (!jid) {
+                throw new Error(`WhatsApp: couldn't normalise recipient "${conversationId}" — pass a phone number or a WhatsApp JID.`);
+            }
+            await connection.sendMedia(jid, media);
+        },
+        async react(conversationId, messageId, emoji) {
+            if (!connection)
+                throw new Error("WhatsApp channel is not started");
+            const jid = toWhatsAppJid(conversationId);
+            if (!jid)
+                return; // Cosmetic — refuse silently rather than throw on a reaction.
+            await connection.react(jid, messageId, emoji);
+        },
+        async markRead(conversationId, messageId, participant) {
+            // No-op when the socket isn't up — read receipts are cosmetic and the
+            // manager calls this best-effort post-gate.
+            if (!connection)
+                return;
+            const jid = toWhatsAppJid(conversationId);
+            if (!jid)
+                return;
+            await connection.markRead(jid, messageId, participant);
+        },
+        async setComposing(conversationId, state) {
+            if (!connection)
+                return;
+            await connection.setComposing(conversationId, state);
+        },
+        selfId() {
+            return connection?.selfId() ?? undefined;
+        },
+        connectedAt() {
+            return connection?.connectedAt() ?? null;
+        },
+    };
+}
+//# sourceMappingURL=adapter.js.map

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

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

package/dist/agents/channels/whatsapp/chunk.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Split a long outbound message into WhatsApp-sized chunks WITHOUT shredding
+ * code fences, paragraphs, or sentences.
+ *
+ * WhatsApp's hard limit is ~4096 chars; we target a safe 4000. Splitting
+ * strategy, from cheapest to last-resort:
+ *   1. If under the limit → one chunk, done.
+ *   2. Walk paragraphs (`\n\n` separators) — keep them intact, accumulate into
+ *      chunks under the limit. A single oversized paragraph passes to step 3.
+ *   3. Walk lines within the paragraph — same accumulation pattern. Single
+ *      oversized lines pass to step 4.
+ *   4. Hard-split on character boundary at a word break near the limit.
+ *
+ * Fence-aware: an open code fence (```) inside a chunk is closed at the chunk
+ * boundary and re-opened in the next chunk, so each chunk renders as valid
+ * markdown.
+ *
+ * Pure / deterministic — no I/O, no globals.
+ */
+export interface ChunkOptions {
+    /** Max characters per chunk; defaults to ~4000 (WhatsApp). */
+    limit?: number;
+}
+/** Split `text` into chunks suitable for one-by-one outbound delivery. */
+export declare function chunkText(text: string, opts?: ChunkOptions): string[];
+//# sourceMappingURL=chunk.d.ts.map

package/dist/agents/channels/whatsapp/chunk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk.d.ts","sourceRoot":"","sources":["../../../../src/agents/channels/whatsapp/chunk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,MAAM,WAAW,YAAY;IAC5B,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,0EAA0E;AAC1E,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,MAAM,EAAE,CAiCzE"}

package/dist/agents/channels/whatsapp/chunk.js

@@ -0,0 +1,123 @@
+/**
+ * Split a long outbound message into WhatsApp-sized chunks WITHOUT shredding
+ * code fences, paragraphs, or sentences.
+ *
+ * WhatsApp's hard limit is ~4096 chars; we target a safe 4000. Splitting
+ * strategy, from cheapest to last-resort:
+ *   1. If under the limit → one chunk, done.
+ *   2. Walk paragraphs (`\n\n` separators) — keep them intact, accumulate into
+ *      chunks under the limit. A single oversized paragraph passes to step 3.
+ *   3. Walk lines within the paragraph — same accumulation pattern. Single
+ *      oversized lines pass to step 4.
+ *   4. Hard-split on character boundary at a word break near the limit.
+ *
+ * Fence-aware: an open code fence (```) inside a chunk is closed at the chunk
+ * boundary and re-opened in the next chunk, so each chunk renders as valid
+ * markdown.
+ *
+ * Pure / deterministic — no I/O, no globals.
+ */
+const DEFAULT_LIMIT = 4000;
+const FENCE = "```";
+/** Split `text` into chunks suitable for one-by-one outbound delivery. */
+export function chunkText(text, opts = {}) {
+    const limit = opts.limit ?? DEFAULT_LIMIT;
+    if (text.length <= limit)
+        return [text];
+    const chunks = [];
+    let pending = "";
+    const flush = () => {
+        if (pending) {
+            chunks.push(closeOpenFence(pending));
+            pending = "";
+        }
+    };
+    // Paragraph-level pass.
+    const paragraphs = text.split(/\n\n+/);
+    for (let i = 0; i < paragraphs.length; i++) {
+        const para = paragraphs[i];
+        const sep = pending ? "\n\n" : "";
+        if (pending.length + sep.length + para.length <= limit) {
+            pending += sep + para;
+            continue;
+        }
+        // Flush whatever fits so far.
+        flush();
+        // Single paragraph that's still too big → line-level pass.
+        if (para.length > limit) {
+            for (const piece of splitByLines(para, limit))
+                chunks.push(closeOpenFence(piece));
+        }
+        else {
+            pending = para;
+        }
+    }
+    flush();
+    return chunks;
+}
+/** Split a single oversized paragraph by line, packing lines into <=limit chunks. */
+function splitByLines(paragraph, limit) {
+    const out = [];
+    const lines = paragraph.split("\n");
+    let pending = "";
+    for (const line of lines) {
+        const sep = pending ? "\n" : "";
+        if (pending.length + sep.length + line.length <= limit) {
+            pending += sep + line;
+            continue;
+        }
+        if (pending) {
+            out.push(pending);
+            pending = "";
+        }
+        // Single oversized line → hard split at a word break.
+        if (line.length > limit) {
+            for (const piece of hardSplit(line, limit))
+                out.push(piece);
+        }
+        else {
+            pending = line;
+        }
+    }
+    if (pending)
+        out.push(pending);
+    return out;
+}
+/** Last resort: split a string at a word boundary near `limit`. */
+function hardSplit(s, limit) {
+    const out = [];
+    let i = 0;
+    while (i < s.length) {
+        if (s.length - i <= limit) {
+            out.push(s.slice(i));
+            break;
+        }
+        // Prefer the last whitespace in the window.
+        const window = s.slice(i, i + limit);
+        const breakAt = Math.max(window.lastIndexOf(" "), window.lastIndexOf("\t"));
+        const cut = breakAt > limit / 2 ? breakAt : limit;
+        out.push(s.slice(i, i + cut));
+        i += cut;
+        // Skip the consumed whitespace so the next chunk doesn't start with " ".
+        while (i < s.length && (s[i] === " " || s[i] === "\t"))
+            i++;
+    }
+    return out;
+}
+/**
+ * If `s` has an odd number of code-fence markers, close the trailing fence so
+ * the chunk renders as valid markdown on its own. The next chunk will need to
+ * re-open a fence to keep the language tag, but at minimum every chunk parses.
+ */
+function closeOpenFence(s) {
+    // Count occurrences of FENCE that start at line beginnings (the markdown rule).
+    let count = 0;
+    for (let i = 0; i < s.length - 2; i++) {
+        if ((i === 0 || s[i - 1] === "\n") && s.slice(i, i + 3) === FENCE)
+            count++;
+    }
+    if (count % 2 === 1)
+        return `${s}\n${FENCE}`;
+    return s;
+}
+//# sourceMappingURL=chunk.js.map

package/dist/agents/channels/whatsapp/chunk.js.map

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