@0xmaxma/claude-gateway 1.8.9 → 1.8.11

package/dist/api/whatsapp-cloud-client.d.ts

@@ -0,0 +1,143 @@
+import { WHATSAPP_ACK_EMOJI } from '../shared/whatsapp-ack';
+/**
+ * Cloud API hard limit for a text message body. Longer replies are split
+ * across several messages rather than being rejected by Meta (error 131009)
+ * or silently truncated.
+ */
+export declare const WHATSAPP_CLOUD_MAX_TEXT_CHARS = 4096;
+/**
+ * Meta's hard cap on reply buttons in an `interactive: {type: 'button'}`
+ * message. Not a soft/UX limit — the Graph API rejects a 4th button outright,
+ * so `sendInteractiveButtons` refuses locally with a readable message rather
+ * than letting the agent see an opaque Meta error code.
+ */
+export declare const WHATSAPP_CLOUD_MAX_BUTTONS = 3;
+/** A single reply button: `id` is what comes back on tap, `title` is what the user sees. */
+export interface WhatsAppCloudButton {
+    id: string;
+    title: string;
+}
+/** One row of a list message. `description` is the optional grey sub-line. */
+export interface WhatsAppCloudListRow {
+    id: string;
+    title: string;
+    description?: string;
+}
+/** A list message's section — a titled group of rows. */
+export interface WhatsAppCloudListSection {
+    title: string;
+    rows: WhatsAppCloudListRow[];
+}
+export { WHATSAPP_ACK_EMOJI };
+export interface WhatsAppCloudClientOptions {
+    accessToken: string;
+    phoneNumberId: string;
+    logDir: string;
+    /** Test-only override for the Graph API base URL. Production uses the real default. */
+    apiBase?: string;
+}
+export interface WhatsAppCloudApiResponse {
+    error?: {
+        message?: string;
+        type?: string;
+        code?: number;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+export declare class WhatsAppCloudClient {
+    private readonly accessToken;
+    private readonly phoneNumberId;
+    private readonly apiBase;
+    private readonly logger;
+    constructor(opts: WhatsAppCloudClientOptions);
+    private call;
+    /**
+     * Verify the token + phone number id — used both as the connect flow's
+     * "Save"-time check (router.ts) and reused here for any other caller that
+     * wants a live credential check without duplicating the request shape.
+     */
+    verifyCredentials(): Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+    /**
+     * Send a plain text message, splitting anything over the Cloud API's
+     * 4096-char body limit into several messages (one Graph API call per chunk,
+     * sent in order).
+     *
+     * `quotedMessageId` makes the FIRST chunk a quote-reply to that inbound
+     * message (Meta's outbound `context: {message_id}`); follow-on chunks are
+     * plain so the conversation doesn't show the same quote block repeated.
+     *
+     * Returns the first errored response if any chunk failed (so existing
+     * `if (sent.error)` callers still see the failure), otherwise the last
+     * successful one.
+     */
+    sendText(to: string, body: string, quotedMessageId?: string): Promise<WhatsAppCloudApiResponse>;
+    /**
+     * Send up to 3 tappable reply buttons under a body of text (Phase 3).
+     *
+     * A tap comes back through the webhook as `type: 'interactive'` with a
+     * `button_reply` — the inbound normalizer turns that into plain text
+     * (the button's title), so the agent reads a tap exactly as if the user had
+     * typed the label. See normalizeWhatsAppCloudMessage's interactive branch.
+     *
+     * THROWS (rather than returning an `{error}` response) when more than
+     * WHATSAPP_CLOUD_MAX_BUTTONS are passed or the list is empty: both are
+     * caller bugs that Meta would reject anyway, and a thrown, readable message
+     * reaches the agent through the MCP tool's catch as actionable text.
+     */
+    sendInteractiveButtons(to: string, bodyText: string, buttons: WhatsAppCloudButton[]): Promise<WhatsAppCloudApiResponse>;
+    /**
+     * Send a list message — a single button that opens a picker of grouped rows
+     * (Phase 3). The way past the 3-button ceiling above.
+     *
+     * A pick comes back as `type: 'interactive'` with a `list_reply`, handled by
+     * the same normalizer branch as button taps.
+     */
+    sendInteractiveList(to: string, bodyText: string, buttonLabel: string, sections: WhatsAppCloudListSection[]): Promise<WhatsAppCloudApiResponse>;
+    /**
+     * Send a pre-approved message template (Phase 3) — the ONLY way to open a
+     * conversation outside WhatsApp's 24h customer-service window, which is why
+     * the caller must be gated on `whatsapp_cloud.templatesEnabled` (see
+     * mcp/tools/whatsapp-cloud/module.ts; this method itself does not gate).
+     *
+     * `components` is Meta's variable-substitution array. It is passed through
+     * VERBATIM and deliberately NOT validated or typed beyond `unknown[]`: its
+     * required shape depends on the individual template's definition in Meta's
+     * Business Manager, which this gateway has no visibility into.
+     */
+    sendTemplate(to: string, templateName: string, languageCode: string, components?: unknown[]): Promise<WhatsAppCloudApiResponse>;
+    /**
+     * Mark an inbound message as read (the blue double-tick on the sender's
+     * side). Best-effort: logged, never thrown — a read receipt is UX polish,
+     * not correctness-critical, exactly like Slack's ack reaction.
+     */
+    markAsRead(messageId: string): Promise<void>;
+    /**
+     * Ack-reaction (ported from `slack-client.ts`'s addReaction): added to the
+     * inbound message on receipt, cleared once the agent's reply lands. An
+     * EMPTY `emoji` is how the Cloud API removes an existing reaction — see
+     * removeReaction below. Best-effort, same as markAsRead.
+     */
+    sendReaction(to: string, messageId: string, emoji?: string): Promise<void>;
+    /** Clear a reaction — the same endpoint with an empty-string emoji. */
+    removeReaction(to: string, messageId: string): Promise<void>;
+    /**
+     * Upload a local file to the Cloud API's media store, returning its
+     * `media_id` — a prerequisite step before `sendImage`/`sendDocument`
+     * (the Cloud API sends media by id, not by raw bytes or URL, for
+     * gateway-originated files).
+     */
+    uploadMedia(filePath: string, mimeType: string): Promise<{
+        mediaId: string;
+    } | {
+        error: string;
+    }>;
+    /** Send an already-uploaded image by media id, with an optional caption. */
+    sendImage(to: string, mediaId: string, caption?: string): Promise<WhatsAppCloudApiResponse>;
+    /** Send an already-uploaded document by media id, with a filename and optional caption. */
+    sendDocument(to: string, mediaId: string, filename: string, caption?: string): Promise<WhatsAppCloudApiResponse>;
+}
+//# sourceMappingURL=whatsapp-cloud-client.d.ts.map

package/dist/api/whatsapp-cloud-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp-cloud-client.d.ts","sourceRoot":"","sources":["../../src/api/whatsapp-cloud-client.ts"],"names":[],"mappings":"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"}

package/dist/api/whatsapp-cloud-client.js

@@ -0,0 +1,298 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WhatsAppCloudClient = exports.WHATSAPP_ACK_EMOJI = exports.WHATSAPP_CLOUD_MAX_BUTTONS = exports.WHATSAPP_CLOUD_MAX_TEXT_CHARS = void 0;
+/**
+ * Thin WhatsApp Business Cloud API (Meta Graph API) wrapper — the outbound
+ * half of the WhatsApp Cloud channel.
+ *
+ * Modeled on `slack-client.ts`'s shape (Bearer auth, thin fetch wrappers, a
+ * `{accessToken, phoneNumberId, logDir, apiBase?}` constructor) but the
+ * request body is plain JSON, not form-urlencoded — Slack's form-encoding
+ * was a Slack-specific finding (see slack-client.ts's `call()` doc comment),
+ * not a universal REST-API rule. The Graph API accepts and expects JSON.
+ *
+ * Phase 2 of the WhatsApp feature-parity plan added the ack/read-receipt half
+ * that v1 deliberately skipped (`markAsRead`, `sendReaction`,
+ * `removeReaction`) — ported from `slack-client.ts`'s addReaction/
+ * removeReaction shape, same best-effort posture (log, never throw).
+ *
+ * Phase 3 adds the two Cloud-ONLY message kinds that have no Baileys analogue
+ * at all (`sendInteractiveButtons`/`sendInteractiveList`) and the 24h-window
+ * escape hatch (`sendTemplate`). These are net-new here — no other channel in
+ * this gateway sends interactive blocks, so there was no in-repo pattern to
+ * port; the payload shapes come straight from Meta's Cloud API reference.
+ */
+const fs = __importStar(require("fs"));
+const logger_1 = require("../logger");
+const text_chunk_1 = require("../shared/text-chunk");
+const whatsapp_ack_1 = require("../shared/whatsapp-ack");
+Object.defineProperty(exports, "WHATSAPP_ACK_EMOJI", { enumerable: true, get: function () { return whatsapp_ack_1.WHATSAPP_ACK_EMOJI; } });
+const WHATSAPP_CLOUD_API_BASE = 'https://graph.facebook.com/v20.0';
+/**
+ * Cloud API hard limit for a text message body. Longer replies are split
+ * across several messages rather than being rejected by Meta (error 131009)
+ * or silently truncated.
+ */
+exports.WHATSAPP_CLOUD_MAX_TEXT_CHARS = 4096;
+/**
+ * Meta's hard cap on reply buttons in an `interactive: {type: 'button'}`
+ * message. Not a soft/UX limit — the Graph API rejects a 4th button outright,
+ * so `sendInteractiveButtons` refuses locally with a readable message rather
+ * than letting the agent see an opaque Meta error code.
+ */
+exports.WHATSAPP_CLOUD_MAX_BUTTONS = 3;
+class WhatsAppCloudClient {
+    constructor(opts) {
+        this.accessToken = opts.accessToken;
+        this.phoneNumberId = opts.phoneNumberId;
+        this.apiBase = opts.apiBase ?? WHATSAPP_CLOUD_API_BASE;
+        this.logger = (0, logger_1.createLogger)('whatsapp-cloud-client', opts.logDir);
+    }
+    async call(method, path, body) {
+        const res = await fetch(`${this.apiBase}${path}`, {
+            method,
+            headers: {
+                Authorization: `Bearer ${this.accessToken}`,
+                ...(body ? { 'Content-Type': 'application/json' } : {}),
+            },
+            ...(body ? { body: JSON.stringify(body) } : {}),
+        });
+        const json = (await res.json());
+        if (json.error) {
+            this.logger.warn(`WhatsApp Cloud API ${method} ${path} failed`, { error: json.error });
+        }
+        return json;
+    }
+    /**
+     * Verify the token + phone number id — used both as the connect flow's
+     * "Save"-time check (router.ts) and reused here for any other caller that
+     * wants a live credential check without duplicating the request shape.
+     */
+    async verifyCredentials() {
+        const json = await this.call('GET', `/${this.phoneNumberId}`);
+        if (json.error) {
+            return { ok: false, error: json.error.message ?? 'unknown error' };
+        }
+        return { ok: true };
+    }
+    /**
+     * Send a plain text message, splitting anything over the Cloud API's
+     * 4096-char body limit into several messages (one Graph API call per chunk,
+     * sent in order).
+     *
+     * `quotedMessageId` makes the FIRST chunk a quote-reply to that inbound
+     * message (Meta's outbound `context: {message_id}`); follow-on chunks are
+     * plain so the conversation doesn't show the same quote block repeated.
+     *
+     * Returns the first errored response if any chunk failed (so existing
+     * `if (sent.error)` callers still see the failure), otherwise the last
+     * successful one.
+     */
+    async sendText(to, body, quotedMessageId) {
+        const chunks = (0, text_chunk_1.chunkText)(body, exports.WHATSAPP_CLOUD_MAX_TEXT_CHARS);
+        // chunkText returns [] for an empty body — keep the historical single-call
+        // behaviour so a caller that deliberately sends "" still hits the API.
+        const parts = chunks.length > 0 ? chunks : [body];
+        let last = {};
+        for (let i = 0; i < parts.length; i++) {
+            last = await this.call('POST', `/${this.phoneNumberId}/messages`, {
+                messaging_product: 'whatsapp',
+                to,
+                type: 'text',
+                text: { body: parts[i] },
+                ...(i === 0 && quotedMessageId ? { context: { message_id: quotedMessageId } } : {}),
+            });
+            if (last.error)
+                return last;
+        }
+        return last;
+    }
+    /**
+     * Send up to 3 tappable reply buttons under a body of text (Phase 3).
+     *
+     * A tap comes back through the webhook as `type: 'interactive'` with a
+     * `button_reply` — the inbound normalizer turns that into plain text
+     * (the button's title), so the agent reads a tap exactly as if the user had
+     * typed the label. See normalizeWhatsAppCloudMessage's interactive branch.
+     *
+     * THROWS (rather than returning an `{error}` response) when more than
+     * WHATSAPP_CLOUD_MAX_BUTTONS are passed or the list is empty: both are
+     * caller bugs that Meta would reject anyway, and a thrown, readable message
+     * reaches the agent through the MCP tool's catch as actionable text.
+     */
+    async sendInteractiveButtons(to, bodyText, buttons) {
+        if (buttons.length === 0) {
+            throw new Error('sendInteractiveButtons: at least 1 button is required');
+        }
+        if (buttons.length > exports.WHATSAPP_CLOUD_MAX_BUTTONS) {
+            throw new Error(`sendInteractiveButtons: WhatsApp allows at most ${exports.WHATSAPP_CLOUD_MAX_BUTTONS} buttons, got ${buttons.length}. ` +
+                'Use a list message (sendInteractiveList) for more options.');
+        }
+        return this.call('POST', `/${this.phoneNumberId}/messages`, {
+            messaging_product: 'whatsapp',
+            to,
+            type: 'interactive',
+            interactive: {
+                type: 'button',
+                body: { text: bodyText },
+                action: {
+                    buttons: buttons.map((b) => ({ type: 'reply', reply: { id: b.id, title: b.title } })),
+                },
+            },
+        });
+    }
+    /**
+     * Send a list message — a single button that opens a picker of grouped rows
+     * (Phase 3). The way past the 3-button ceiling above.
+     *
+     * A pick comes back as `type: 'interactive'` with a `list_reply`, handled by
+     * the same normalizer branch as button taps.
+     */
+    async sendInteractiveList(to, bodyText, buttonLabel, sections) {
+        return this.call('POST', `/${this.phoneNumberId}/messages`, {
+            messaging_product: 'whatsapp',
+            to,
+            type: 'interactive',
+            interactive: {
+                type: 'list',
+                body: { text: bodyText },
+                action: { button: buttonLabel, sections },
+            },
+        });
+    }
+    /**
+     * Send a pre-approved message template (Phase 3) — the ONLY way to open a
+     * conversation outside WhatsApp's 24h customer-service window, which is why
+     * the caller must be gated on `whatsapp_cloud.templatesEnabled` (see
+     * mcp/tools/whatsapp-cloud/module.ts; this method itself does not gate).
+     *
+     * `components` is Meta's variable-substitution array. It is passed through
+     * VERBATIM and deliberately NOT validated or typed beyond `unknown[]`: its
+     * required shape depends on the individual template's definition in Meta's
+     * Business Manager, which this gateway has no visibility into.
+     */
+    async sendTemplate(to, templateName, languageCode, components) {
+        return this.call('POST', `/${this.phoneNumberId}/messages`, {
+            messaging_product: 'whatsapp',
+            to,
+            type: 'template',
+            template: {
+                name: templateName,
+                language: { code: languageCode },
+                ...(components ? { components } : {}),
+            },
+        });
+    }
+    /**
+     * Mark an inbound message as read (the blue double-tick on the sender's
+     * side). Best-effort: logged, never thrown — a read receipt is UX polish,
+     * not correctness-critical, exactly like Slack's ack reaction.
+     */
+    async markAsRead(messageId) {
+        const json = await this.call('POST', `/${this.phoneNumberId}/messages`, {
+            messaging_product: 'whatsapp',
+            status: 'read',
+            message_id: messageId,
+        });
+        if (json.error) {
+            this.logger.debug('markAsRead failed', { error: json.error });
+        }
+    }
+    /**
+     * Ack-reaction (ported from `slack-client.ts`'s addReaction): added to the
+     * inbound message on receipt, cleared once the agent's reply lands. An
+     * EMPTY `emoji` is how the Cloud API removes an existing reaction — see
+     * removeReaction below. Best-effort, same as markAsRead.
+     */
+    async sendReaction(to, messageId, emoji = whatsapp_ack_1.WHATSAPP_ACK_EMOJI) {
+        const json = await this.call('POST', `/${this.phoneNumberId}/messages`, {
+            messaging_product: 'whatsapp',
+            to,
+            type: 'reaction',
+            reaction: { message_id: messageId, emoji },
+        });
+        if (json.error) {
+            this.logger.debug('sendReaction failed', { error: json.error });
+        }
+    }
+    /** Clear a reaction — the same endpoint with an empty-string emoji. */
+    async removeReaction(to, messageId) {
+        return this.sendReaction(to, messageId, '');
+    }
+    /**
+     * Upload a local file to the Cloud API's media store, returning its
+     * `media_id` — a prerequisite step before `sendImage`/`sendDocument`
+     * (the Cloud API sends media by id, not by raw bytes or URL, for
+     * gateway-originated files).
+     */
+    async uploadMedia(filePath, mimeType) {
+        const form = new FormData();
+        form.append('messaging_product', 'whatsapp');
+        form.append('file', new Blob([new Uint8Array(fs.readFileSync(filePath))], { type: mimeType }), filePath.split('/').pop());
+        const res = await fetch(`${this.apiBase}/${this.phoneNumberId}/media`, {
+            method: 'POST',
+            headers: { Authorization: `Bearer ${this.accessToken}` },
+            body: form,
+        });
+        const json = (await res.json());
+        if (json.error || typeof json.id !== 'string') {
+            const error = json.error?.message ?? 'upload failed: no media id returned';
+            this.logger.warn('WhatsApp Cloud media upload failed', { error });
+            return { error };
+        }
+        return { mediaId: json.id };
+    }
+    /** Send an already-uploaded image by media id, with an optional caption. */
+    async sendImage(to, mediaId, caption) {
+        return this.call('POST', `/${this.phoneNumberId}/messages`, {
+            messaging_product: 'whatsapp',
+            to,
+            type: 'image',
+            image: { id: mediaId, ...(caption ? { caption } : {}) },
+        });
+    }
+    /** Send an already-uploaded document by media id, with a filename and optional caption. */
+    async sendDocument(to, mediaId, filename, caption) {
+        return this.call('POST', `/${this.phoneNumberId}/messages`, {
+            messaging_product: 'whatsapp',
+            to,
+            type: 'document',
+            document: { id: mediaId, filename, ...(caption ? { caption } : {}) },
+        });
+    }
+}
+exports.WhatsAppCloudClient = WhatsAppCloudClient;
+//# sourceMappingURL=whatsapp-cloud-client.js.map

package/dist/api/whatsapp-cloud-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp-cloud-client.js","sourceRoot":"","sources":["../../src/api/whatsapp-cloud-client.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,uCAAyB;AACzB,sCAAyC;AACzC,qDAAiD;AACjD,yDAA4D;AAyCnD,mGAzCA,iCAAkB,OAyCA;AAvC3B,MAAM,uBAAuB,GAAG,kCAAkC,CAAC;AAEnE;;;;GAIG;AACU,QAAA,6BAA6B,GAAG,IAAI,CAAC;AAElD;;;;;GAKG;AACU,QAAA,0BAA0B,GAAG,CAAC,CAAC;AAuC5C,MAAa,mBAAmB;IAM9B,YAAY,IAAgC;QAC1C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;QACxC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,uBAAuB,CAAC;QACvD,IAAI,CAAC,MAAM,GAAG,IAAA,qBAAY,EAAC,uBAAuB,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACnE,CAAC;IAEO,KAAK,CAAC,IAAI,CAChB,MAAsB,EACtB,IAAY,EACZ,IAA8B;QAE9B,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,EAAE;YAChD,MAAM;YACN,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,IAAI,CAAC,WAAW,EAAE;gBAC3C,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACxD;YACD,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChD,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA6B,CAAC;QAC5D,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sBAAsB,MAAM,IAAI,IAAI,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QACzF,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,iBAAiB;QACrB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;QAC9D,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,eAAe,EAAE,CAAC;QACrE,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACtB,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,QAAQ,CACZ,EAAU,EACV,IAAY,EACZ,eAAwB;QAExB,MAAM,MAAM,GAAG,IAAA,sBAAS,EAAC,IAAI,EAAE,qCAA6B,CAAC,CAAC;QAC9D,2EAA2E;QAC3E,uEAAuE;QACvE,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,IAAI,GAA6B,EAAE,CAAC;QACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,aAAa,WAAW,EAAE;gBAChE,iBAAiB,EAAE,UAAU;gBAC7B,EAAE;gBACF,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAE,EAAE;gBACzB,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,eAAe,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,eAAe,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACpF,CAAC,CAAC;YACH,IAAI,IAAI,CAAC,KAAK;gBAAE,OAAO,IAAI,CAAC;QAC9B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,sBAAsB,CAC1B,EAAU,EACV,QAAgB,EAChB,OAA8B;QAE9B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,GAAG,kCAA0B,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CACb,mDAAmD,kCAA0B,iBAAiB,OAAO,CAAC,MAAM,IAAI;gBAC9G,4DAA4D,CAC/D,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,aAAa,WAAW,EAAE;YAC1D,iBAAiB,EAAE,UAAU;YAC7B,EAAE;YACF,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACxB,MAAM,EAAE;oBACN,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;iBACtF;aACF;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,mBAAmB,CACvB,EAAU,EACV,QAAgB,EAChB,WAAmB,EACnB,QAAoC;QAEpC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,aAAa,WAAW,EAAE;YAC1D,iBAAiB,EAAE,UAAU;YAC7B,EAAE;YACF,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE;gBACX,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACxB,MAAM,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE;aAC1C;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,YAAY,CAChB,EAAU,EACV,YAAoB,EACpB,YAAoB,EACpB,UAAsB;QAEtB,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,aAAa,WAAW,EAAE;YAC1D,iBAAiB,EAAE,UAAU;YAC7B,EAAE;YACF,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE;gBACR,IAAI,EAAE,YAAY;gBAClB,QAAQ,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE;gBAChC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACtC;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,SAAiB;QAChC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,aAAa,WAAW,EAAE;YACtE,iBAAiB,EAAE,UAAU;YAC7B,MAAM,EAAE,MAAM;YACd,UAAU,EAAE,SAAS;SACtB,CAAC,CAAC;QACH,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,YAAY,CAAC,EAAU,EAAE,SAAiB,EAAE,KAAK,GAAG,iCAAkB;QAC1E,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,aAAa,WAAW,EAAE;YACtE,iBAAiB,EAAE,UAAU;YAC7B,EAAE;YACF,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE;SAC3C,CAAC,CAAC;QACH,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED,uEAAuE;IACvE,KAAK,CAAC,cAAc,CAAC,EAAU,EAAE,SAAiB;QAChD,OAAO,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,WAAW,CAAC,QAAgB,EAAE,QAAgB;QAClD,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QAC1H,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,aAAa,QAAQ,EAAE;YACrE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,IAAI,CAAC,WAAW,EAAE,EAAE;YACxD,IAAI,EAAE,IAAI;SACX,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA6B,CAAC;QAC5D,IAAI,IAAI,CAAC,KAAK,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;YAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,OAAO,IAAI,qCAAqC,CAAC;YAC3E,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,oCAAoC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAClE,OAAO,EAAE,KAAK,EAAE,CAAC;QACnB,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;IAC9B,CAAC;IAED,4EAA4E;IAC5E,KAAK,CAAC,SAAS,CAAC,EAAU,EAAE,OAAe,EAAE,OAAgB;QAC3D,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,aAAa,WAAW,EAAE;YAC1D,iBAAiB,EAAE,UAAU;YAC7B,EAAE;YACF,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;SACxD,CAAC,CAAC;IACL,CAAC;IAED,2FAA2F;IAC3F,KAAK,CAAC,YAAY,CAAC,EAAU,EAAE,OAAe,EAAE,QAAgB,EAAE,OAAgB;QAChF,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,aAAa,WAAW,EAAE;YAC1D,iBAAiB,EAAE,UAAU;YAC7B,EAAE;YACF,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;SACrE,CAAC,CAAC;IACL,CAAC;CACF;AAnQD,kDAmQC"}

package/dist/api/whatsapp-cloud-webhook-router.d.ts

@@ -0,0 +1,132 @@
+import type { AgentRunner } from '../agent/runner';
+import { type ResolvedWhatsAppCloudSource } from './whatsapp-cloud-access';
+import type { WebhookAppHandler } from './webhooks-router';
+export type NormalizedWhatsAppCloudMessage = {
+    content: string;
+    meta: Record<string, string>;
+};
+interface WhatsAppCloudContact {
+    profile?: {
+        name?: string;
+    };
+    wa_id?: string;
+}
+interface WhatsAppCloudMediaObject {
+    id?: string;
+    mime_type?: string;
+    caption?: string;
+    filename?: string;
+}
+/**
+ * Meta's structured contact payload. NOT a vCard — unlike Baileys (which
+ * hands over the raw vCard string the sender's phone produced), the Cloud API
+ * decomposes it into JSON, so a vCard has to be synthesized from these fields
+ * if the agent is to see one (see `synthesizeVCard`).
+ */
+interface WhatsAppCloudContactCard {
+    name?: {
+        formatted_name?: string;
+    };
+    phones?: Array<{
+        phone?: string;
+    }>;
+}
+export interface WhatsAppCloudMessage {
+    from?: string;
+    id?: string;
+    timestamp?: string;
+    type?: string;
+    text?: {
+        body?: string;
+    };
+    image?: WhatsAppCloudMediaObject;
+    document?: WhatsAppCloudMediaObject;
+    /**
+     * Present when the user replied to a specific earlier message; `id` is that
+     * message's id. Meta does NOT inline the quoted message's text or sender
+     * here — see normalizeWhatsAppCloudMessage's reply-context branch.
+     */
+    context?: {
+        id?: string;
+    };
+    location?: {
+        latitude?: number;
+        longitude?: number;
+        name?: string;
+        address?: string;
+    };
+    contacts?: WhatsAppCloudContactCard[];
+    /** Stickers are `image/webp` media, downloaded through the same path as images. */
+    sticker?: WhatsAppCloudMediaObject;
+    /**
+     * A tap on a reply button / a pick from a list message that WE sent (Phase 3
+     * — see WhatsAppCloudClient.sendInteractiveButtons/sendInteractiveList).
+     * Exactly one of `button_reply`/`list_reply` is present, matching the
+     * interactive type that was sent.
+     */
+    interactive?: {
+        type?: string;
+        button_reply?: {
+            id: string;
+            title: string;
+        };
+        list_reply?: {
+            id: string;
+            title: string;
+            description?: string;
+        };
+    };
+    [key: string]: unknown;
+}
+export interface WhatsAppCloudValue {
+    messaging_product?: string;
+    metadata?: {
+        phone_number_id?: string;
+    };
+    contacts?: WhatsAppCloudContact[];
+    messages?: WhatsAppCloudMessage[];
+    statuses?: unknown[];
+}
+/**
+ * Extract the inbound message list from a webhook `value` object — returns
+ * [] for a status-only batch (our own outbound delivery receipts) or any
+ * payload shape without a `messages` array at all, so callers never try to
+ * normalize a status update as an inbound message.
+ */
+export declare function extractInboundMessages(value: WhatsAppCloudValue | undefined): WhatsAppCloudMessage[];
+/**
+ * Build a minimal vCard from Meta's structured contact payload.
+ *
+ * The Cloud API does NOT hand over a vCard string (Baileys does — see
+ * manager.ts's contactMessage branch, which uses `contactMessage.vcard`
+ * verbatim), it hands over decomposed JSON. Synthesizing a 3.0 vCard here
+ * means BOTH WhatsApp channels put the same kind of value in the same
+ * `meta.vcard` key, so the agent never needs channel-specific handling.
+ * Returns undefined when there is neither a name nor a phone to put in it.
+ */
+export declare function synthesizeVCard(contact: WhatsAppCloudContactCard | undefined): string | undefined;
+/**
+ * Normalize an inbound Cloud API message into the gateway's {content, meta}
+ * intake shape. Returns null when `from` is missing/empty (no reply target).
+ * `content` is the text body for `type: 'text'`, the caption (possibly
+ * empty) for `type: 'image'`/`'document'`, or a short human summary for
+ * `type: 'location'`, or the selected option's title for `type: 'interactive'`
+ * (a button tap / list pick) — remaining types (audio, video, ...) are still
+ * out of scope and forward with empty content rather than being dropped, same
+ * posture as Slack's "no text → empty content, not null".
+ *
+ * Stays synchronous and pure: an attached image/document/sticker's bytes are
+ * fetched by the async handler AFTER this returns, which sets
+ * `meta.image_path`/`meta.document_path`/`meta.sticker_path` on the object
+ * built here.
+ */
+export declare function normalizeWhatsAppCloudMessage(msg: WhatsAppCloudMessage, resolved?: ResolvedWhatsAppCloudSource): NormalizedWhatsAppCloudMessage | null;
+/** Verify `X-Hub-Signature-256` (HMAC-SHA256 of the raw body — no timestamp component). */
+export declare function verifyMetaSignature(rawBody: Buffer, appSecret: string, sigHeader: string | undefined): boolean;
+export interface WhatsAppCloudWebhookOptions {
+    /** Test-only Graph API base override (see WhatsAppCloudClient / media metadata fetch). */
+    apiBase?: string;
+}
+export declare function createWhatsAppCloudWebhookHandler(agents: Map<string, AgentRunner>, logDir: string, opts?: WhatsAppCloudWebhookOptions): WebhookAppHandler;
+export {};
+//# sourceMappingURL=whatsapp-cloud-webhook-router.d.ts.map

package/dist/api/whatsapp-cloud-webhook-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp-cloud-webhook-router.d.ts","sourceRoot":"","sources":["../../src/api/whatsapp-cloud-webhook-router.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EAGL,KAAK,2BAA2B,EACjC,MAAM,yBAAyB,CAAC;AASjC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAoB3D,MAAM,MAAM,8BAA8B,GAAG;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B,CAAC;AAEF,UAAU,oBAAoB;IAC5B,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,wBAAwB;IAChC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,UAAU,wBAAwB;IAChC,IAAI,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzB,KAAK,CAAC,EAAE,wBAAwB,CAAC;IACjC,QAAQ,CAAC,EAAE,wBAAwB,CAAC;IACpC;;;;OAIG;IACH,OAAO,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1B,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtF,QAAQ,CAAC,EAAE,wBAAwB,EAAE,CAAC;IACtC,mFAAmF;IACnF,OAAO,CAAC,EAAE,wBAAwB,CAAC;IACnC;;;;;OAKG;IACH,WAAW,CAAC,EAAE;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,YAAY,CAAC,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;QAC7C,UAAU,CAAC,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAClE,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,QAAQ,CAAC,EAAE,oBAAoB,EAAE,CAAC;IAClC,QAAQ,CAAC,EAAE,oBAAoB,EAAE,CAAC;IAClC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;CACtB;AAiBD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,GAAG,SAAS,GAAG,oBAAoB,EAAE,CAEpG;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,wBAAwB,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CASjG;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,oBAAoB,EACzB,QAAQ,CAAC,EAAE,2BAA2B,GACrC,8BAA8B,GAAG,IAAI,CAmDvC;AAED,2FAA2F;AAC3F,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,OAAO,CAST;AAwHD,MAAM,WAAW,2BAA2B;IAC1C,0FAA0F;IAC1F,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,EAChC,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,2BAAgC,GACrC,iBAAiB,CA8MnB"}