@diegoaltoworks/chatter 0.33.0 → 0.34.0

package/dist/channels/whatsapp/images.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Optional image requests in the WhatsApp channel: detect a drawing/picture
+ * request (with or without an attached photo), route it through `../../images`,
+ * and reply with the generated picture. Inert unless `./images` is
+ * configured — `createWhatsAppImageHandler` returns `false` for every
+ * message when it isn't, so callers fall through to normal chat.
+ *
+ * This module ships no bot personality: the detector and subject-cleaning
+ * patterns are generic drawing verbs (no hardcoded bot names), and every
+ * reply string (ack/limit/moderation/error) is caller-configured with no
+ * default text.
+ *
+ * Downloading the attached photo needs Baileys' `downloadMediaMessage`,
+ * which — per this subpath's rule that only `./baileys` touches the
+ * optional peer dependency at runtime — is injected as `downloadPhoto`
+ * rather than imported here. The host wires it via `./whatsapp`'s
+ * `loadBaileys` (see docs/channels.md), not this module.
+ *
+ * Everything pulled in from `../../images` is type-only: each subpath is
+ * built as its own bundle, so a value import here (even just for an
+ * `instanceof` check) would inline the whole `./images` module — OpenAI SDK
+ * included — into `./whatsapp`, and importing from the `../../images`
+ * barrel rather than its leaf files pulls in every sibling module's value
+ * imports too. Error mapping below checks `code`/`name` structurally
+ * instead, which also means it works when the error crossed a bundle
+ * boundary (the two subpaths' `ImageGenerationError` classes are not
+ * `instanceof`-compatible with each other).
+ */
+import type { WAMessage, WASocket } from "@whiskeysockets/baileys";
+import type { CaptionComposer } from "../../images/captionComposer";
+import type { ImageUploader } from "../../images/uploader";
+export interface DrawRequestDetectorConfig {
+    /** Tested against the raw message text to decide whether it's an image request. Defaults to a generic set of drawing verbs — no bot-specific names. */
+    detectPattern?: RegExp;
+    /** Applied in order to derive the subject from the raw text (mention tokens, greetings/politeness, the draw verb itself). */
+    stripPatterns?: readonly RegExp[];
+}
+export declare function isDrawRequest(text: string, config?: DrawRequestDetectorConfig): boolean;
+/** Cleans a draw request into a scene subject: "@1234 please draw me a cat" -> "cat". Falls back to the trimmed original when the patterns strip everything (or nothing). */
+export declare function drawSubject(text: string, config?: DrawRequestDetectorConfig): string;
+/** Neutral, overridable reply strings — this module ships no bot personality. Unset = silent for that outcome. */
+export interface WhatsAppImageStrings {
+    /** Sent immediately on accepting the request, before generation starts. */
+    ack?: string;
+    /** Sent when the per-sender/day cap (`checkAndReserve`) blocks the request. */
+    limitReached?: string;
+    /** Sent when the image API blocks the request on moderation grounds. */
+    moderationBlocked?: string;
+    /** Sent for any other generation/upload/download failure. */
+    error?: string;
+}
+export interface WhatsAppImageHandlerDeps {
+    /** The slice of `./images`' `ImageUploader` this module needs. */
+    images: Pick<ImageUploader, "isConfigured" | "peekCached" | "getOrCreateImage">;
+    /**
+     * Per-sender/day reservation (e.g. `./usage`'s `DailyLimiter.checkAndReserve`).
+     * Omit to skip the cap entirely. Checked AFTER the cache, so a cache hit
+     * never burns a unit.
+     */
+    checkAndReserve?: (senderId: string) => Promise<{
+        allowed: boolean;
+    }>;
+    /**
+     * Downloads the attached photo as bytes. Omit to ignore attached photos —
+     * text-only requests still work. See the module docstring for why this is
+     * injected rather than imported.
+     */
+    downloadPhoto?: (message: WAMessage) => Promise<Uint8Array>;
+    /** Best-effort tailored caption for the reply. Omit to send the image with no caption. */
+    captionComposer?: Pick<CaptionComposer, "composeCaption">;
+    detector?: DrawRequestDetectorConfig;
+    strings?: WhatsAppImageStrings;
+}
+export interface WhatsAppImageRequestContext {
+    sock: WASocket;
+    message: WAMessage;
+    chatId: string;
+    senderId: string;
+    text: string;
+    hasPhoto: boolean;
+}
+/** `true` = the message was an image request and this module replied to it (successfully or with a mapped error) — the caller must not also route it through normal chat. `false` = not an image request, or `./images` isn't configured. */
+export type WhatsAppImageHandler = (ctx: WhatsAppImageRequestContext) => Promise<boolean>;
+export declare function createWhatsAppImageHandler(deps: WhatsAppImageHandlerDeps): WhatsAppImageHandler;
+//# sourceMappingURL=images.d.ts.map

package/dist/channels/whatsapp/images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.d.ts","sourceRoot":"","sources":["../../../src/channels/whatsapp/images.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAkB3D,MAAM,WAAW,yBAAyB;IACxC,uJAAuJ;IACvJ,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6HAA6H;IAC7H,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAOD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,yBAA8B,GAAG,OAAO,CAE3F;AAED,6KAA6K;AAC7K,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,yBAA8B,GAAG,MAAM,CAUxF;AAED,kHAAkH;AAClH,MAAM,WAAW,oBAAoB;IACnC,2EAA2E;IAC3E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,kEAAkE;IAClE,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,cAAc,GAAG,YAAY,GAAG,kBAAkB,CAAC,CAAC;IAChF;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACtE;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,SAAS,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5D,0FAA0F;IAC1F,eAAe,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,gBAAgB,CAAC,CAAC;IAC1D,QAAQ,CAAC,EAAE,yBAAyB,CAAC;IACrC,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,SAAS,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,6OAA6O;AAC7O,MAAM,MAAM,oBAAoB,GAAG,CAAC,GAAG,EAAE,2BAA2B,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAsB1F,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,wBAAwB,GAAG,oBAAoB,CA4C/F"}

package/dist/channels/whatsapp/images.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=images.test.d.ts.map

package/dist/channels/whatsapp/images.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.test.d.ts","sourceRoot":"","sources":["../../../src/channels/whatsapp/images.test.ts"],"names":[],"mappings":""}

package/dist/channels/whatsapp/inbound.d.ts

@@ -50,6 +50,7 @@ import type { PromptLoader } from "../../core/prompts";
 import type { VectorStore } from "../../core/retrieval";
 import { type SessionIdentityRegistry } from "../gates";
 import type { WhatsAppMessageEvent } from "./channel";
+import type { WhatsAppImageHandler } from "./images";
 export declare function isGroupJid(jid: string): boolean;
 /** "447700900123:17@s.whatsapp.net" (device-suffixed) and "447700900123@s.whatsapp.net" match. */
 export declare function jidsMatch(a: string | undefined, b: string | undefined): boolean;
@@ -124,6 +125,14 @@ export interface WhatsAppInboundConfig {
         senderPhone: string;
         text: string;
     }) => string | undefined | Promise<string | undefined>;
+    /**
+     * Optional image-request routing (see `./images`). Consulted right before
+     * the normal chat pipeline; a `true` result means the message was handled
+     * as an image request (successfully or with a mapped error string) and
+     * this handler returns without answering through chat. Inert unless
+     * `./images` is configured.
+     */
+    images?: WhatsAppImageHandler;
     now?: () => number;
 }
 /** Builds the `onMessage` handler for `createWhatsAppChannel` (see `./channel`) — see the module docstring for how to wire `ServerDependencies` into it. */

package/dist/channels/whatsapp/inbound.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inbound.d.ts","sourceRoot":"","sources":["../../../src/channels/whatsapp/inbound.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,EAAE,KAAK,QAAQ,EAAc,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,KAAK,UAAU,EAAkB,MAAM,oBAAoB,CAAC;AAErE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAKL,KAAK,uBAAuB,EAE7B,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAItD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED,kGAAkG;AAClG,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAI/E;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGpD;AAeD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,SAAS,EAClB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CA+BjB;AAID,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,GAAG,gBAAgB,CAWnE;AAED,mHAAmH;AACnH,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,GAAG,MAAM,CAWtD;AAID,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;OAOG;IACH,QAAQ,EAAE,uBAAuB,CAAC;IAClC,4HAA4H;IAC5H,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gHAAgH;IAChH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,cAAc,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,oGAAoG;IACpG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;KACd,KAAK,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACvD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAqBD,4JAA4J;AAC5J,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,qBAAqB,GAC5B,CAAC,KAAK,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CA0GhD"}
+{"version":3,"file":"inbound.d.ts","sourceRoot":"","sources":["../../../src/channels/whatsapp/inbound.ts"],"names":[],"mappings":"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"}

package/dist/channels/whatsapp/index.d.ts

@@ -29,6 +29,7 @@ export type { Baileys } from "./baileys";
 export { loadBaileys } from "./baileys";
 export { acquireSessionLease, createWhatsAppChannel, type LeaseGatedConnectDeps, reconnectDelayMs, senderNameFor, shutdownWaSessions, type WaSessionHandle, type WhatsAppChannelConfig, type WhatsAppMessageEvent, } from "./channel";
 export { decrypt, encrypt } from "./crypto";
+export { createWhatsAppImageHandler, type DrawRequestDetectorConfig, drawSubject, isDrawRequest, type WhatsAppImageHandler, type WhatsAppImageHandlerDeps, type WhatsAppImageRequestContext, type WhatsAppImageStrings, } from "./images";
 export { createWhatsAppInboundHandler, extractText, isGroupJid, jidsMatch, jidToPhoneNumber, messageContext, senderPhoneFor, type WaMessageContext, type WhatsAppInboundConfig, } from "./inbound";
 export { canAcquireLease, createTursoWaLeaseStore, LEASE_HEARTBEAT_MS, LEASE_STALE_MS, LEASE_WAIT_MS, type WaLeaseRow, type WaLeaseStore, } from "./lease";
 //# sourceMappingURL=index.d.ts.map

package/dist/channels/whatsapp/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/channels/whatsapp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,KAAK,qBAAqB,EAC1B,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EACL,4BAA4B,EAC5B,WAAW,EACX,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,KAAK,UAAU,EACf,KAAK,YAAY,GAClB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/channels/whatsapp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,KAAK,qBAAqB,EAC1B,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EACL,0BAA0B,EAC1B,KAAK,yBAAyB,EAC9B,WAAW,EACX,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EAChC,KAAK,oBAAoB,GAC1B,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,4BAA4B,EAC5B,WAAW,EACX,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,KAAK,UAAU,EACf,KAAK,YAAY,GAClB,MAAM,SAAS,CAAC"}

package/dist/channels/whatsapp/index.js

@@ -37,10 +37,13 @@ __export(index_exports, {
   canAcquireLease: () => canAcquireLease,
   createTursoWaLeaseStore: () => createTursoWaLeaseStore,
   createWhatsAppChannel: () => createWhatsAppChannel,
+  createWhatsAppImageHandler: () => createWhatsAppImageHandler,
   createWhatsAppInboundHandler: () => createWhatsAppInboundHandler,
   decrypt: () => decrypt,
+  drawSubject: () => drawSubject,
   encrypt: () => encrypt,
   extractText: () => extractText,
+  isDrawRequest: () => isDrawRequest,
   isGroupJid: () => isGroupJid,
   jidToPhoneNumber: () => jidToPhoneNumber,
   jidsMatch: () => jidsMatch,
@@ -467,6 +470,71 @@ function createWhatsAppChannel(config) {
   };
 }
 
+// src/channels/whatsapp/images.ts
+var DEFAULT_DETECT_PATTERN = /\b(draw|paint|sketch|illustrate)\b|\b(make|generate|create)\b[^.!?]{0,20}\b(picture|image|drawing|photo|cartoon)\b/i;
+var DEFAULT_STRIP_PATTERNS = [
+  /@\d+/g,
+  /^(hey|hi|please|ok)[,!\s]+/i,
+  /^(can|could|will)\s+you\s+/i,
+  // Longest-alternative-first ((an|a), not (a|an)): a first-match-wins
+  // alternation would otherwise take "a" out of "an" and leave a stray "n".
+  /^(please\s+)?(draw|paint|sketch|illustrate|make|generate|create)\s+(me|us)?\s*(an|a)?\s*(picture|image|drawing|sketch|photo|cartoon)?\s*(of\s+)?/i
+];
+function testPattern(pattern, text) {
+  return new RegExp(pattern.source, pattern.flags.replace(/[gy]/g, "")).test(text);
+}
+function isDrawRequest(text, config = {}) {
+  return testPattern(config.detectPattern ?? DEFAULT_DETECT_PATTERN, text);
+}
+function drawSubject(text, config = {}) {
+  let subject = text;
+  for (const pattern of config.stripPatterns ?? DEFAULT_STRIP_PATTERNS) {
+    subject = subject.replace(pattern, " ").replace(/\s+/g, " ").trim();
+  }
+  return subject.length > 0 ? subject : text.trim();
+}
+function isModerationError(error) {
+  return typeof error === "object" && error !== null && error.name === "ImageGenerationError" && error.code === "moderation";
+}
+async function replyText(sock, chatId, message, text) {
+  if (!text) return;
+  await sock.sendMessage(chatId, { text }, { quoted: message }).catch(() => void 0);
+}
+function createWhatsAppImageHandler(deps) {
+  return async function handleWhatsAppImageRequest(ctx) {
+    if (!deps.images.isConfigured()) return false;
+    if (!isDrawRequest(ctx.text, deps.detector)) return false;
+    const subject = drawSubject(ctx.text, deps.detector);
+    try {
+      const photoBytes = ctx.hasPhoto ? await deps.downloadPhoto?.(ctx.message) : void 0;
+      const inputImages = photoBytes ? [{ bytes: photoBytes }] : void 0;
+      const request = { prompt: subject, inputImages };
+      if (deps.checkAndReserve) {
+        const cached2 = await deps.images.peekCached(request);
+        if (!cached2) {
+          const reserved = await deps.checkAndReserve(ctx.senderId);
+          if (!reserved.allowed) {
+            await replyText(ctx.sock, ctx.chatId, ctx.message, deps.strings?.limitReached);
+            return true;
+          }
+        }
+      }
+      await replyText(ctx.sock, ctx.chatId, ctx.message, deps.strings?.ack);
+      const image = await deps.images.getOrCreateImage(request);
+      const caption = deps.captionComposer ? await deps.captionComposer.composeCaption({ subject }) : void 0;
+      await ctx.sock.sendMessage(
+        ctx.chatId,
+        caption ? { image: { url: image.url }, caption } : { image: { url: image.url } },
+        { quoted: ctx.message }
+      );
+    } catch (error) {
+      const text = isModerationError(error) ? deps.strings?.moderationBlocked : deps.strings?.error;
+      await replyText(ctx.sock, ctx.chatId, ctx.message, text);
+    }
+    return true;
+  };
+}
+
 // src/core/guardrails.ts
 function detectLeakage(text) {
   const flags = [
@@ -751,6 +819,17 @@ function createWhatsAppInboundHandler(config) {
         return;
       }
       const senderPhone = await senderPhoneFor(sock, message, chatId);
+      if (config.images) {
+        const handled = await config.images({
+          sock,
+          message,
+          chatId,
+          senderId: senderPhone,
+          text,
+          hasPhoto: Boolean(message.message?.imageMessage)
+        });
+        if (handled) return;
+      }
       const personaLayer = await resolvePersonaLayer(config, { senderPhone, text });
       const buckets = await resolveBuckets({
         mode: "public",
@@ -793,10 +872,13 @@ function createWhatsAppInboundHandler(config) {
   canAcquireLease,
   createTursoWaLeaseStore,
   createWhatsAppChannel,
+  createWhatsAppImageHandler,
   createWhatsAppInboundHandler,
   decrypt,
+  drawSubject,
   encrypt,
   extractText,
+  isDrawRequest,
   isGroupJid,
   jidToPhoneNumber,
   jidsMatch,

package/dist/channels/whatsapp/index.mjs

@@ -411,6 +411,71 @@ function createWhatsAppChannel(config) {
   };
 }
 
+// src/channels/whatsapp/images.ts
+var DEFAULT_DETECT_PATTERN = /\b(draw|paint|sketch|illustrate)\b|\b(make|generate|create)\b[^.!?]{0,20}\b(picture|image|drawing|photo|cartoon)\b/i;
+var DEFAULT_STRIP_PATTERNS = [
+  /@\d+/g,
+  /^(hey|hi|please|ok)[,!\s]+/i,
+  /^(can|could|will)\s+you\s+/i,
+  // Longest-alternative-first ((an|a), not (a|an)): a first-match-wins
+  // alternation would otherwise take "a" out of "an" and leave a stray "n".
+  /^(please\s+)?(draw|paint|sketch|illustrate|make|generate|create)\s+(me|us)?\s*(an|a)?\s*(picture|image|drawing|sketch|photo|cartoon)?\s*(of\s+)?/i
+];
+function testPattern(pattern, text) {
+  return new RegExp(pattern.source, pattern.flags.replace(/[gy]/g, "")).test(text);
+}
+function isDrawRequest(text, config = {}) {
+  return testPattern(config.detectPattern ?? DEFAULT_DETECT_PATTERN, text);
+}
+function drawSubject(text, config = {}) {
+  let subject = text;
+  for (const pattern of config.stripPatterns ?? DEFAULT_STRIP_PATTERNS) {
+    subject = subject.replace(pattern, " ").replace(/\s+/g, " ").trim();
+  }
+  return subject.length > 0 ? subject : text.trim();
+}
+function isModerationError(error) {
+  return typeof error === "object" && error !== null && error.name === "ImageGenerationError" && error.code === "moderation";
+}
+async function replyText(sock, chatId, message, text) {
+  if (!text) return;
+  await sock.sendMessage(chatId, { text }, { quoted: message }).catch(() => void 0);
+}
+function createWhatsAppImageHandler(deps) {
+  return async function handleWhatsAppImageRequest(ctx) {
+    if (!deps.images.isConfigured()) return false;
+    if (!isDrawRequest(ctx.text, deps.detector)) return false;
+    const subject = drawSubject(ctx.text, deps.detector);
+    try {
+      const photoBytes = ctx.hasPhoto ? await deps.downloadPhoto?.(ctx.message) : void 0;
+      const inputImages = photoBytes ? [{ bytes: photoBytes }] : void 0;
+      const request = { prompt: subject, inputImages };
+      if (deps.checkAndReserve) {
+        const cached2 = await deps.images.peekCached(request);
+        if (!cached2) {
+          const reserved = await deps.checkAndReserve(ctx.senderId);
+          if (!reserved.allowed) {
+            await replyText(ctx.sock, ctx.chatId, ctx.message, deps.strings?.limitReached);
+            return true;
+          }
+        }
+      }
+      await replyText(ctx.sock, ctx.chatId, ctx.message, deps.strings?.ack);
+      const image = await deps.images.getOrCreateImage(request);
+      const caption = deps.captionComposer ? await deps.captionComposer.composeCaption({ subject }) : void 0;
+      await ctx.sock.sendMessage(
+        ctx.chatId,
+        caption ? { image: { url: image.url }, caption } : { image: { url: image.url } },
+        { quoted: ctx.message }
+      );
+    } catch (error) {
+      const text = isModerationError(error) ? deps.strings?.moderationBlocked : deps.strings?.error;
+      await replyText(ctx.sock, ctx.chatId, ctx.message, text);
+    }
+    return true;
+  };
+}
+
 // src/core/guardrails.ts
 function detectLeakage(text) {
   const flags = [
@@ -695,6 +760,17 @@ function createWhatsAppInboundHandler(config) {
         return;
       }
       const senderPhone = await senderPhoneFor(sock, message, chatId);
+      if (config.images) {
+        const handled = await config.images({
+          sock,
+          message,
+          chatId,
+          senderId: senderPhone,
+          text,
+          hasPhoto: Boolean(message.message?.imageMessage)
+        });
+        if (handled) return;
+      }
       const personaLayer = await resolvePersonaLayer(config, { senderPhone, text });
       const buckets = await resolveBuckets({
         mode: "public",
@@ -736,10 +812,13 @@ export {
   canAcquireLease,
   createTursoWaLeaseStore,
   createWhatsAppChannel,
+  createWhatsAppImageHandler,
   createWhatsAppInboundHandler,
   decrypt,
+  drawSubject,
   encrypt,
   extractText,
+  isDrawRequest,
   isGroupJid,
   jidToPhoneNumber,
   jidsMatch,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegoaltoworks/chatter",
-  "version": "0.33.0",
+  "version": "0.34.0",
   "description": "Embeddable AI chatbot framework with RAG, authentication, and customizable widgets",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",