@intentface/latch-channels 0.9.1

package/dist/whatsapp/whatsappChannel.d.ts

@@ -0,0 +1,104 @@
+import type { AskStateStore, AuthResult, ChannelRunOps, ChannelThreadStore } from "../types.js";
+import { decodeApprovalData, decodeQuestionData, encodeApprovalData, type InboundMedia, type Surface } from "../kernel.js";
+import { type LazyString, type WhatsappApiOptions, type WhatsappClient } from "./api.js";
+export interface WhatsappUser {
+    waId: string;
+    profileName?: string;
+}
+export interface WhatsappChannelConfig<P> {
+    /** The agent this number serves. */
+    agent: string;
+    /** Stable host-side bot id — used in chat ids (`whatsapp_<botRef>_<waId>`) and delivery keys. */
+    botRef: string;
+    /** Meta credentials, all lazily resolvable from the host's vault. */
+    accessToken: LazyString;
+    phoneNumberId: LazyString;
+    appSecret: LazyString;
+    verifyToken: LazyString;
+    runtime: ChannelRunOps<P>;
+    /** Resolve the inbound WhatsApp user (`wa_id`) to a platform principal. */
+    authorizeUser: (user: WhatsappUser) => Promise<AuthResult<P>>;
+    /** Persistent dedupe on `<botRef>:<waId>:<wamid>` (Meta re-delivers webhooks). */
+    seen?: (deliveryKey: string) => Promise<boolean>;
+    /** Host-backed one-turn-per-chat lease (see the kernel). */
+    claimTurn?: (chatId: string) => Promise<string | null>;
+    releaseTurn?: (chatId: string, token: string) => Promise<void>;
+    /** Stash the message that triggered a link prompt, to replay after linking. */
+    stashPending?: (input: WhatsappUser & {
+        text: string;
+        media?: InboundMedia<WaMediaRef>[];
+    }) => Promise<void>;
+    /** Build the platform authorize URL for a `connect_<name>` OAuth approval. */
+    authorizeUrl?: (connectionName: string, ctx: {
+        chatId: string;
+        waId: string;
+        approvalId: string;
+    }) => string;
+    /** Host storage for in-flight `askUser` questionnaires (see the kernel). */
+    askState?: AskStateStore;
+    /** Host storage for the thread epoch — what makes `/new` possible. */
+    thread?: ChannelThreadStore;
+    waitUntil?: (p: Promise<unknown>) => void;
+    /** Test seam: base URL / fetch for the Graph API client. */
+    apiOptions?: WhatsappApiOptions;
+}
+export interface WaMediaRef {
+    id: string;
+    mime_type?: string;
+    filename?: string;
+    caption?: string;
+}
+/** Interactive reply ids use the kernel's shared `lta:` / `ltq:` formats (256-char budget here). */
+export declare const encodeWhatsappApprovalId: typeof encodeApprovalData;
+export declare const decodeWhatsappApprovalId: typeof decodeApprovalData;
+export declare const decodeWhatsappQuestionId: typeof decodeQuestionData;
+/** Build the chat id for a (bot, WhatsApp user) at a thread epoch — same shape as Telegram's. */
+export declare function whatsappChatId(botRef: string, waId: string, epoch?: number): string;
+/** The inverse of `whatsappChatId`, or null when `id` isn't one of ours. */
+export declare function parseWhatsappChatId(id: string): {
+    botRef: string;
+    waId: string;
+    epoch: number;
+} | null;
+/** Kept for hosts that split their own text; the kernel splits answers itself. */
+export declare const splitWhatsappText: (text: string, max?: number) => string[];
+export declare function whatsappSurface(api: WhatsappClient, botRef: string): Surface<WhatsappUser, WaMediaRef>;
+export declare function whatsappChannel<P>(config: WhatsappChannelConfig<P>): {
+    handleRequest: (request: Request) => Promise<Response>;
+    /** Run one already-gated, already-leased message (scheduled delivery). */
+    runMessage: (ctx: {
+        waId: string;
+        text: string;
+        media?: InboundMedia<WaMediaRef>[];
+        principal: P;
+    } & {
+        chatId?: string;
+    }) => Promise<void>;
+    /** Replay a stashed message under the turn lease (the post-link resume). */
+    replayMessage: (ctx: {
+        waId: string;
+        text: string;
+        media?: InboundMedia<WaMediaRef>[];
+        principal: P;
+    }) => Promise<void>;
+    api: {
+        sendText(to: string, body: string): Promise<void>;
+        sendReplyButtons(to: string, body: string, buttons: import("./api.js").WhatsappReplyButton[]): Promise<void>;
+        sendList(to: string, body: string, buttonLabel: string, rows: {
+            id: string;
+            title: string;
+            description?: string;
+        }[]): Promise<void>;
+        getMediaInfo(mediaId: string): Promise<{
+            url?: string;
+            mimeType?: string;
+            fileSize?: number;
+        }>;
+        downloadMedia(url: string): Promise<Uint8Array>;
+        checkCredentials(): Promise<{
+            displayPhoneNumber?: string;
+            verifiedName?: string;
+        }>;
+    };
+};
+//# sourceMappingURL=whatsappChannel.d.ts.map

package/dist/whatsapp/whatsappChannel.d.ts.map

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

package/dist/whatsapp/whatsappChannel.js

@@ -0,0 +1,217 @@
+import { createTurnKernel, decodeApprovalData, decodeQuestionData, encodeApprovalData, splitText, } from "../kernel.js";
+import { whatsappApi, MAX_LIST_ROWS, MAX_REPLY_BUTTONS, } from "./api.js";
+import { verifyWhatsappSignature, whatsappVerifyChallenge } from "./verify.js";
+/**
+ * One agent's WhatsApp business number (Meta Cloud API). The host wires
+ * `handleRequest` to the bot's per-bot webhook route; we handle Meta's GET
+ * verify handshake, check the POST signature, ACK fast, and hand the parsed
+ * message to the turn kernel in the background. WhatsApp messages cannot be
+ * edited, so the surface never edits: answers post once (split past the
+ * 4096-char cap), receipts are separate messages.
+ */
+const MAX_TEXT_CHARS = 4096;
+/** Interactive reply ids use the kernel's shared `lta:` / `ltq:` formats (256-char budget here). */
+export const encodeWhatsappApprovalId = encodeApprovalData;
+export const decodeWhatsappApprovalId = decodeApprovalData;
+export const decodeWhatsappQuestionId = decodeQuestionData;
+/** Build the chat id for a (bot, WhatsApp user) at a thread epoch — same shape as Telegram's. */
+export function whatsappChatId(botRef, waId, epoch = 0) {
+    const base = `whatsapp_${botRef}_${waId}`;
+    return epoch > 0 ? `${base}_t${epoch}` : base;
+}
+/** The inverse of `whatsappChatId`, or null when `id` isn't one of ours. */
+export function parseWhatsappChatId(id) {
+    const m = /^whatsapp_(.+)_(\d+)(?:_t(\d+))?$/.exec(id);
+    if (!m)
+        return null;
+    return { botRef: m[1], waId: m[2], epoch: m[3] ? Number(m[3]) : 0 };
+}
+/** Kept for hosts that split their own text; the kernel splits answers itself. */
+export const splitWhatsappText = (text, max = MAX_TEXT_CHARS) => splitText(text, max);
+const ok = () => new Response(null, { status: 200 });
+function mediaRefs(msg) {
+    const out = [];
+    if (msg.image)
+        out.push({ ref: msg.image, mediaType: msg.image.mime_type ?? "image/jpeg", name: "photo.jpg" });
+    if (msg.document)
+        out.push({
+            ref: msg.document,
+            mediaType: msg.document.mime_type ?? "application/octet-stream",
+            name: msg.document.filename ?? "document",
+        });
+    if (msg.audio)
+        out.push({ ref: msg.audio, mediaType: msg.audio.mime_type ?? "audio/ogg", name: "audio.ogg" });
+    if (msg.video)
+        out.push({ ref: msg.video, mediaType: msg.video.mime_type ?? "video/mp4", name: "video.mp4" });
+    return out;
+}
+/** Question body text: the question plus, when `numbered`, its options (typed "2" answers it). */
+function questionBody(q, index, total, numbered) {
+    const head = total > 1 ? `*Question ${index + 1} of ${total}*\n` : "";
+    const title = q.header ? `_${q.header}_\n${q.question}` : q.question;
+    if (!numbered)
+        return `${head}${title}`;
+    const opts = q.options.map((o, i) => `${i + 1}. ${o.label}`).join("\n");
+    const how = q.multiSelect
+        ? "\n\nReply with the numbers you want, e.g. 1,3"
+        : "\n\nReply with a number, or just tell me in your own words.";
+    return `${head}${title}\n\n${opts}${how}`;
+}
+// ── The surface ─────────────────────────────────────────────────────────────
+export function whatsappSurface(api, botRef) {
+    return {
+        kind: "whatsapp",
+        maxTextChars: MAX_TEXT_CHARS,
+        chatId: (u, epoch) => whatsappChatId(botRef, u.waId, epoch),
+        sendText: async (u, text) => {
+            await api.sendText(u.waId, text);
+            return undefined;
+        },
+        sendLink: (u, body, label, url) => api.sendText(u.waId, `${body}\n\n${label}: ${url}`),
+        sendApproval: async (u, pa, data) => {
+            let json;
+            try {
+                json = JSON.stringify(pa.input, null, 2) ?? String(pa.input);
+            }
+            catch {
+                json = String(pa.input);
+            }
+            if (json.length > 800)
+                json = `${json.slice(0, 800)}\n… (truncated)`;
+            await api.sendReplyButtons(u.waId, `🔒 Approve ${pa.toolName}?\n\n${json}`, [
+                { id: data.approve, title: "✅ Approve" },
+                { id: data.deny, title: "🚫 Deny" },
+            ]);
+            return undefined;
+        },
+        /**
+         * Post one question with the best affordance Meta allows: reply buttons up
+         * to 3 options, a tappable list up to 10, otherwise a numbered text prompt.
+         * Multi-select always falls back to numbers: messages can't be edited, so
+         * there is no way to tick options in place.
+         */
+        sendQuestion: async (u, session, data) => {
+            const q = session.questions[session.cursor];
+            if (!q)
+                return undefined;
+            const total = session.questions.length;
+            if (data && !q.multiSelect && q.options.length <= MAX_REPLY_BUTTONS) {
+                await api.sendReplyButtons(u.waId, questionBody(q, session.cursor, total, false), q.options.map((o, i) => ({ id: data.pick(i), title: o.label })));
+            }
+            else if (data && !q.multiSelect && q.options.length <= MAX_LIST_ROWS) {
+                await api.sendList(u.waId, questionBody(q, session.cursor, total, false), "Choose", q.options.map((o, i) => ({ id: data.pick(i), title: o.label, description: o.description })));
+            }
+            else {
+                await api.sendText(u.waId, questionBody(q, session.cursor, total, true));
+            }
+            return undefined;
+        },
+        answered: (u, _card, a) => api.sendText(u.waId, `✓ ${a.answer}`),
+        fetchMedia: async (m, maxBytes) => {
+            const info = await api.getMediaInfo(m.ref.id);
+            if (!info.url || (info.fileSize ?? 0) > maxBytes)
+                return null;
+            return { bytes: await api.downloadMedia(info.url), mediaType: info.mimeType ?? m.mediaType };
+        },
+    };
+}
+// ── The channel ─────────────────────────────────────────────────────────────
+export function whatsappChannel(config) {
+    const api = whatsappApi({ accessToken: config.accessToken, phoneNumberId: config.phoneNumberId }, config.apiOptions);
+    const defer = (p) => (config.waitUntil ? config.waitUntil(p) : p);
+    const resolveLazy = async (v) => (typeof v === "function" ? v() : v);
+    const kernel = createTurnKernel({
+        agent: config.agent,
+        botRef: config.botRef,
+        runtime: config.runtime,
+        authorizeUser: config.authorizeUser,
+        ...(config.seen ? { seen: config.seen } : {}),
+        ...(config.claimTurn ? { claimTurn: config.claimTurn } : {}),
+        ...(config.releaseTurn ? { releaseTurn: config.releaseTurn } : {}),
+        ...(config.askState ? { askState: config.askState } : {}),
+        ...(config.thread ? { thread: config.thread } : {}),
+        ...(config.stashPending
+            ? {
+                stashPending: (i) => config.stashPending({ ...i.user, text: i.text, ...(i.media ? { media: i.media } : {}) }),
+            }
+            : {}),
+        ...(config.authorizeUrl
+            ? {
+                authorizeUrl: (name, ctx) => config.authorizeUrl(name, { chatId: ctx.chatId, waId: ctx.user.waId, approvalId: ctx.approvalId }),
+            }
+            : {}),
+    }, whatsappSurface(api, config.botRef));
+    /** One Meta message → the kernel's inbound event. Button/list replies are actions. */
+    function parse(msg, value) {
+        const profileName = value.contacts?.find((c) => c.wa_id === msg.from)?.profile?.name;
+        const user = { waId: msg.from, ...(profileName ? { profileName } : {}) };
+        const deliveryKey = `${config.botRef}:${msg.from}:${msg.id}`;
+        const replyId = msg.interactive?.button_reply?.id ?? msg.interactive?.list_reply?.id;
+        if (replyId)
+            return { kind: "action", user, data: replyId, deliveryKey };
+        return {
+            kind: "message",
+            user,
+            text: (msg.text?.body ?? msg.image?.caption ?? msg.document?.caption ?? msg.video?.caption ?? "").trim(),
+            media: mediaRefs(msg),
+            deliveryKey,
+        };
+    }
+    // ── The per-bot webhook entrypoint (GET verify + POST events) ──────────────
+    async function handleRequest(request) {
+        if (request.method === "GET") {
+            const challenge = whatsappVerifyChallenge(new URL(request.url), await resolveLazy(config.verifyToken));
+            return challenge !== null
+                ? new Response(challenge, { status: 200, headers: { "content-type": "text/plain" } })
+                : new Response("verification failed", { status: 403 });
+        }
+        const raw = await request.text();
+        const valid = verifyWhatsappSignature({
+            appSecret: await resolveLazy(config.appSecret),
+            rawBody: raw,
+            signature: request.headers.get("x-hub-signature-256"),
+        });
+        if (!valid)
+            return new Response("invalid signature", { status: 401 });
+        let body;
+        try {
+            body = JSON.parse(raw || "{}");
+        }
+        catch {
+            return ok();
+        }
+        if (body.object !== "whatsapp_business_account")
+            return ok();
+        // One Meta app/WABA can deliver events for MULTIPLE registered numbers to
+        // the same endpoint — only dispatch changes addressed to OUR number, or a
+        // message for a sibling number would run this bot's agent and reply
+        // through this binding.
+        const ourPhoneNumberId = await resolveLazy(config.phoneNumberId);
+        for (const entry of body.entry ?? []) {
+            for (const change of entry.changes ?? []) {
+                if (change.field !== "messages" || !change.value)
+                    continue;
+                const recipient = change.value.metadata?.phone_number_id;
+                if (recipient && recipient !== ourPhoneNumberId) {
+                    console.log(`[whatsapp] change for phone_number_id ${recipient} ignored (bot ${config.botRef} serves ${ourPhoneNumberId})`);
+                    continue;
+                }
+                for (const msg of change.value.messages ?? []) {
+                    defer(kernel.handleInbound(parse(msg, change.value)));
+                }
+                // statuses[] (delivery receipts) are intentionally ignored.
+            }
+        }
+        return ok();
+    }
+    const kernelCtx = ({ waId, ...rest }) => ({ user: { waId }, ...rest });
+    return {
+        handleRequest,
+        /** Run one already-gated, already-leased message (scheduled delivery). */
+        runMessage: (ctx) => kernel.runMessage(kernelCtx(ctx)),
+        /** Replay a stashed message under the turn lease (the post-link resume). */
+        replayMessage: (ctx) => kernel.replayMessage(kernelCtx(ctx)),
+        api,
+    };
+}
+//# sourceMappingURL=whatsappChannel.js.map

package/dist/whatsapp/whatsappChannel.js.map

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

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@intentface/latch-channels",
+  "version": "0.9.1",
+  "description": "Latch channels — bring a Latch agent to chat platforms (Slack first). A generic run→render-event projection plus per-platform adapters, reusing the core runtime, storage and durability (no separate state store).",
+  "keywords": [
+    "ai",
+    "ai-sdk",
+    "agents",
+    "llm",
+    "slack",
+    "telegram",
+    "whatsapp",
+    "chatbot"
+  ],
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./slack": {
+      "types": "./dist/slack/index.d.ts",
+      "import": "./dist/slack/index.js"
+    },
+    "./telegram": {
+      "types": "./dist/telegram/index.d.ts",
+      "import": "./dist/telegram/index.js"
+    },
+    "./whatsapp": {
+      "types": "./dist/whatsapp/index.d.ts",
+      "import": "./dist/whatsapp/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "dependencies": {
+    "@intentface/latch-core": "^0.9.1"
+  },
+  "peerDependencies": {
+    "ai": ">=7.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22",
+    "ai": "^7.0.2",
+    "typescript": "^5.7.0",
+    "vitest": "^4"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Intentface/intentface-latch.git",
+    "directory": "packages/latch-channels"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  }
+}