@diegoaltoworks/chatter 0.60.0 → 0.62.0

package/dist/channels/whatsapp/index.js

@@ -35,6 +35,7 @@ __export(index_exports, {
   LEASE_WAIT_MS: () => LEASE_WAIT_MS,
   acquireSessionLease: () => acquireSessionLease,
   canAcquireLease: () => canAcquireLease,
+  createTursoWaAuthKV: () => createTursoWaAuthKV,
   createTursoWaLeaseStore: () => createTursoWaLeaseStore,
   createWhatsAppChannel: () => createWhatsAppChannel,
   createWhatsAppImageHandler: () => createWhatsAppImageHandler,
@@ -50,12 +51,14 @@ __export(index_exports, {
   jidsMatch: () => jidsMatch,
   loadBaileys: () => loadBaileys,
   messageContext: () => messageContext,
+  normalizeWaMediaPayload: () => normalizeWaMediaPayload,
   reconnectDelayMs: () => reconnectDelayMs,
   resolveWaMessage: () => resolveWaMessage,
   senderNameFor: () => senderNameFor,
   senderPhoneFor: () => senderPhoneFor,
   shutdownWaSessions: () => shutdownWaSessions,
   stripOwnMentions: () => stripOwnMentions,
+  useAuthState: () => useAuthState,
   useTursoAuthState: () => useTursoAuthState
 });
 module.exports = __toCommonJS(index_exports);
@@ -129,27 +132,55 @@ function ensureAuthSchema(client) {
   }
   return ready;
 }
-async function useTursoAuthState(db, secret, sessionId, runtime) {
-  await ensureAuthSchema(db);
+function createTursoWaAuthKV(db) {
+  return {
+    async read(id) {
+      await ensureAuthSchema(db);
+      const result = await db.execute({
+        sql: "SELECT value FROM wa_auth WHERE id = ?",
+        args: [id]
+      });
+      const row = result.rows[0];
+      return row ? row.value : null;
+    },
+    async write(id, value) {
+      await ensureAuthSchema(db);
+      await db.execute({
+        sql: "INSERT OR REPLACE INTO wa_auth (id, value) VALUES (?, ?)",
+        args: [id, value]
+      });
+    },
+    async remove(id) {
+      await ensureAuthSchema(db);
+      await db.execute({ sql: "DELETE FROM wa_auth WHERE id = ?", args: [id] });
+    },
+    // Mirrors isAuthRowForSession - keep the two in sync.
+    async clear(sessionId) {
+      await ensureAuthSchema(db);
+      if (sessionId === "default") {
+        await db.execute("DELETE FROM wa_auth WHERE id NOT LIKE 's:%'");
+      } else {
+        await db.execute({
+          sql: "DELETE FROM wa_auth WHERE id LIKE ?",
+          args: [`s:${sessionId}/%`]
+        });
+      }
+    }
+  };
+}
+async function useAuthState(store, secret, sessionId, runtime) {
   const rowId = (id) => sessionId === "default" ? id : `s:${sessionId}/${id}`;
   async function read(id) {
-    const result = await db.execute({
-      sql: "SELECT value FROM wa_auth WHERE id = ?",
-      args: [rowId(id)]
-    });
-    const row = result.rows[0];
-    if (!row) return null;
-    return JSON.parse(await decrypt(row.value, secret), runtime.bufferJSON.reviver);
+    const value = await store.read(rowId(id));
+    if (value === null) return null;
+    return JSON.parse(await decrypt(value, secret), runtime.bufferJSON.reviver);
   }
   async function write(id, value) {
     const payload = await encrypt(JSON.stringify(value, runtime.bufferJSON.replacer), secret);
-    await db.execute({
-      sql: "INSERT OR REPLACE INTO wa_auth (id, value) VALUES (?, ?)",
-      args: [rowId(id), payload]
-    });
+    await store.write(rowId(id), payload);
   }
   async function remove(id) {
-    await db.execute({ sql: "DELETE FROM wa_auth WHERE id = ?", args: [rowId(id)] });
+    await store.remove(rowId(id));
   }
   const creds = await read("creds") ?? runtime.initAuthCreds();
   return {
@@ -186,18 +217,13 @@ async function useTursoAuthState(db, secret, sessionId, runtime) {
       }
     },
     saveCreds: () => write("creds", creds),
-    clear: async () => {
-      if (sessionId === "default") {
-        await db.execute("DELETE FROM wa_auth WHERE id NOT LIKE 's:%'");
-      } else {
-        await db.execute({
-          sql: "DELETE FROM wa_auth WHERE id LIKE ?",
-          args: [`s:${sessionId}/%`]
-        });
-      }
-    }
+    // Scoped to THIS session - never nuke a sibling number's pairing.
+    clear: () => store.clear(sessionId)
   };
 }
+async function useTursoAuthState(db, secret, sessionId, runtime) {
+  return useAuthState(createTursoWaAuthKV(db), secret, sessionId, runtime);
+}
 
 // src/channels/whatsapp/baileys.ts
 function wrapMissingBaileysError(cause) {
@@ -260,6 +286,11 @@ function createConsoleLogger(level = "info") {
   };
 }
 
+// src/channels/backoff.ts
+function exponentialBackoffMs(baseMs, maxMs, n) {
+  return Math.min(baseMs * 2 ** Math.max(0, Math.min(n, 20)), maxMs);
+}
+
 // src/channels/whatsapp/lease.ts
 var LEASE_STALE_MS = 9e4;
 var LEASE_HEARTBEAT_MS = 3e4;
@@ -318,7 +349,7 @@ function createTursoWaLeaseStore(client) {
 var RECONNECT_DELAY_MS = 5e3;
 var RECONNECT_MAX_DELAY_MS = 10 * 60 * 1e3;
 function reconnectDelayMs(failures) {
-  return Math.min(RECONNECT_DELAY_MS * 2 ** Math.min(failures, 20), RECONNECT_MAX_DELAY_MS);
+  return exponentialBackoffMs(RECONNECT_DELAY_MS, RECONNECT_MAX_DELAY_MS, failures);
 }
 async function shutdownWaSessions(sessions) {
   await Promise.all(
@@ -389,9 +420,18 @@ async function acquireSessionLease(sessionId, deps) {
 function senderNameFor(channelName, sessionId) {
   return sessionId === "default" ? channelName : `${channelName}:${sessionId}`;
 }
+function normalizeWaMediaPayload(payload) {
+  const media = typeof payload === "string" ? { url: payload } : payload;
+  if (!media || typeof media !== "object" || typeof media.url !== "string" || !media.url) {
+    throw new TypeError(
+      `WhatsApp sendMedia payload must be a URL string or { url, caption? }, got: ${typeof payload}`
+    );
+  }
+  return media;
+}
 function createWhatsAppChannel(config) {
   assertStrongSecret(config.sessionSecret, "WhatsApp sessionSecret (e.g. WA_SESSION_SECRET)");
-  const channelName = "whatsapp";
+  const channelName = config.name ?? "whatsapp";
   const sessionIds = config.sessionIds && config.sessionIds.length > 0 ? config.sessionIds : ["default"];
   const now = config.now ?? Date.now;
   const schedule = config.schedule ?? ((fn, ms) => void setTimeout(fn, ms));
@@ -409,8 +449,13 @@ function createWhatsAppChannel(config) {
     name: channelName,
     async start(deps) {
       const log = config.logger ?? deps.logger ?? createConsoleLogger();
-      const db = deps.db;
-      const leaseStore = createTursoWaLeaseStore(db);
+      if ((!config.leaseStore || !config.authStore) && !deps.db) {
+        throw new Error(
+          "The WhatsApp channel needs a libsql client for auth state and the session lease: set config.database (config.retriever alone does not open one), or supply both config.leaseStore and config.authStore."
+        );
+      }
+      const leaseStore = config.leaseStore ?? createTursoWaLeaseStore(deps.db);
+      const authStore = config.authStore ?? createTursoWaAuthKV(deps.db);
       senders = deps.senders;
       await loadBaileys2();
       async function connect(sessionId) {
@@ -421,8 +466,8 @@ function createWhatsAppChannel(config) {
           initAuthCreds: baileys.initAuthCreds,
           appStateSyncKeyFromObject: (value) => baileys.proto.Message.AppStateSyncKeyData.fromObject(value)
         };
-        const { state, saveCreds } = await useTursoAuthState(
-          db,
+        const { state, saveCreds } = await useAuthState(
+          authStore,
           config.sessionSecret,
           sessionId,
           runtime
@@ -466,6 +511,13 @@ function createWhatsAppChannel(config) {
               sendText: async (chatId, text) => {
                 await sock.sendMessage(chatId, { text });
               },
+              sendMedia: async (chatId, payload) => {
+                const { url, caption } = normalizeWaMediaPayload(payload);
+                await sock.sendMessage(
+                  chatId,
+                  caption !== void 0 ? { image: { url }, caption } : { image: { url } }
+                );
+              },
               sendReaction: async (chatId, messageRef, emoji) => {
                 await sock.sendMessage(chatId, {
                   react: { text: emoji, key: messageRef }
@@ -741,7 +793,8 @@ async function answerOnce({
 async function applyTransformReply(transformReply, input, logger) {
   if (!transformReply) return input.text;
   try {
-    return await transformReply(input);
+    const result = await transformReply(input);
+    return typeof result === "string" ? result : null;
   } catch (error) {
     logger?.error(
       `transformReply threw for channel "${input.channel}"; sending the original reply`,
@@ -803,6 +856,7 @@ async function prepareChat({
   sender,
   rewriteQuery,
   rerankContext,
+  fallbackFn,
   logger
 }) {
   const lastUserMsg = lastUserMessage(messages);
@@ -819,21 +873,39 @@ async function prepareChat({
       logger?.error("rewriteQuery threw; falling back to the original query", error);
     }
   }
-  let ctx = await store.query(query, topK, buckets ?? defaultBuckets(mode));
+  const resolvedBuckets = buckets ?? defaultBuckets(mode);
+  const retrievedChunks = await store.query(query, topK, resolvedBuckets);
+  let ctx = retrievedChunks;
   if (rerankContext) {
     try {
-      const reranked = await rerankContext({ query, chunks: ctx });
+      const reranked = await rerankContext({ query, chunks: [...ctx] });
       if (Array.isArray(reranked) && reranked.every((c) => typeof c === "string")) ctx = reranked;
     } catch (error) {
       logger?.error("rerankContext threw; falling back to the original chunks", error);
     }
   }
+  let fallback;
+  if (ctx.length === 0 && fallbackFn) {
+    try {
+      const guidance = await fallbackFn({
+        query,
+        mode,
+        buckets: resolvedBuckets,
+        sender,
+        retrievedChunks
+      });
+      if (typeof guidance === "string" && guidance.trim()) fallback = guidance.trim();
+    } catch (error) {
+      logger?.error("fallbackFn threw; proceeding without fallback guidance", error);
+    }
+  }
   const persona = personaLayer?.trim() || (mode === "private" ? prompts.privatePersona : prompts.publicPersona);
   const hint = channelHint?.trim();
   const system = [
     prompts.baseSystemRules,
     persona,
     ...hint ? [hint] : [],
+    ...fallback ? [fallback] : [],
     `${label}:
 ${ctx.join("\n\n")}`
   ].join("\n\n");
@@ -841,7 +913,7 @@ ${ctx.join("\n\n")}`
 }
 
 // src/history/compaction.ts
-var DEFAULT_TIMEOUT_MS = 8e3;
+var COMPACTION_TIMEOUT_MS = 8e3;
 var LOAD_ALL = Number.MAX_SAFE_INTEGER;
 var SUMMARY_PREFIX = "Summary of earlier conversation: ";
 function defaultSummarize(client, model) {
@@ -869,7 +941,7 @@ function createHistoryCompactor(deps, options) {
     throw new Error(`Invalid history compaction keep: ${keep}`);
   }
   const summarize = options.summarize ?? defaultSummarize(deps.client, options.model);
-  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  const timeoutMs = options.timeoutMs ?? COMPACTION_TIMEOUT_MS;
   return {
     async maybeCompact(store, conversationId) {
       const turns = await store.load(conversationId, LOAD_ALL);
@@ -910,6 +982,16 @@ function createHistoryCompactor(deps, options) {
 }
 
 // src/channels/pipeline.ts
+function resolveBrainHooks(config, fallback) {
+  return {
+    answerFn: config.answerFn ?? fallback?.answerFn,
+    bucketsFor: config.bucketsFor ?? fallback?.bucketsFor,
+    rewriteQuery: config.rewriteQuery ?? fallback?.rewriteQuery,
+    rerankContext: config.rerankContext ?? fallback?.rerankContext,
+    fallbackFn: config.fallbackFn ?? fallback?.fallbackFn,
+    transformReply: config.transformReply ?? fallback?.transformReply
+  };
+}
 var DEFAULT_HISTORY_LIMIT = 20;
 var DEFAULT_GROUP_RATE_LIMIT = { max: 30, windowMs: 60 * 60 * 1e3 };
 var DEFAULT_DM_RATE_LIMIT = { max: 20, windowMs: 60 * 60 * 1e3 };
@@ -994,6 +1076,7 @@ function createInboundPipeline(deps, config) {
       sender,
       rewriteQuery: config.rewriteQuery,
       rerankContext: config.rerankContext,
+      fallbackFn: config.fallbackFn,
       logger: config.logger
     });
     const { content: produced } = await answerOnce({
@@ -1129,13 +1212,9 @@ function createWhatsAppInboundHandler(config) {
     { client: config.client, store: config.store, prompts: config.prompts },
     {
       channel: "whatsapp",
-      answerFn: config.answerFn,
-      bucketsFor: config.bucketsFor,
-      rewriteQuery: config.rewriteQuery,
-      rerankContext: config.rerankContext,
-      transformReply: config.transformReply,
+      ...resolveBrainHooks(config, config.serverConfig),
       model: config.model,
-      channelHint: config.channelHint,
+      channelHint: config.channelHint ?? "Channel: WhatsApp.",
       personaResolver: personaResolver ? ({ sender, text }) => personaResolver({ senderPhone: sender, text }) : void 0,
       history: config.history,
       allowedChats,
@@ -1296,6 +1375,7 @@ function createWhatsAppMessageRouter(config) {
   LEASE_WAIT_MS,
   acquireSessionLease,
   canAcquireLease,
+  createTursoWaAuthKV,
   createTursoWaLeaseStore,
   createWhatsAppChannel,
   createWhatsAppImageHandler,
@@ -1311,11 +1391,13 @@ function createWhatsAppMessageRouter(config) {
   jidsMatch,
   loadBaileys,
   messageContext,
+  normalizeWaMediaPayload,
   reconnectDelayMs,
   resolveWaMessage,
   senderNameFor,
   senderPhoneFor,
   shutdownWaSessions,
   stripOwnMentions,
+  useAuthState,
   useTursoAuthState
 });

package/dist/channels/whatsapp/index.mjs

@@ -67,27 +67,55 @@ function ensureAuthSchema(client) {
   }
   return ready;
 }
-async function useTursoAuthState(db, secret, sessionId, runtime) {
-  await ensureAuthSchema(db);
+function createTursoWaAuthKV(db) {
+  return {
+    async read(id) {
+      await ensureAuthSchema(db);
+      const result = await db.execute({
+        sql: "SELECT value FROM wa_auth WHERE id = ?",
+        args: [id]
+      });
+      const row = result.rows[0];
+      return row ? row.value : null;
+    },
+    async write(id, value) {
+      await ensureAuthSchema(db);
+      await db.execute({
+        sql: "INSERT OR REPLACE INTO wa_auth (id, value) VALUES (?, ?)",
+        args: [id, value]
+      });
+    },
+    async remove(id) {
+      await ensureAuthSchema(db);
+      await db.execute({ sql: "DELETE FROM wa_auth WHERE id = ?", args: [id] });
+    },
+    // Mirrors isAuthRowForSession - keep the two in sync.
+    async clear(sessionId) {
+      await ensureAuthSchema(db);
+      if (sessionId === "default") {
+        await db.execute("DELETE FROM wa_auth WHERE id NOT LIKE 's:%'");
+      } else {
+        await db.execute({
+          sql: "DELETE FROM wa_auth WHERE id LIKE ?",
+          args: [`s:${sessionId}/%`]
+        });
+      }
+    }
+  };
+}
+async function useAuthState(store, secret, sessionId, runtime) {
   const rowId = (id) => sessionId === "default" ? id : `s:${sessionId}/${id}`;
   async function read(id) {
-    const result = await db.execute({
-      sql: "SELECT value FROM wa_auth WHERE id = ?",
-      args: [rowId(id)]
-    });
-    const row = result.rows[0];
-    if (!row) return null;
-    return JSON.parse(await decrypt(row.value, secret), runtime.bufferJSON.reviver);
+    const value = await store.read(rowId(id));
+    if (value === null) return null;
+    return JSON.parse(await decrypt(value, secret), runtime.bufferJSON.reviver);
   }
   async function write(id, value) {
     const payload = await encrypt(JSON.stringify(value, runtime.bufferJSON.replacer), secret);
-    await db.execute({
-      sql: "INSERT OR REPLACE INTO wa_auth (id, value) VALUES (?, ?)",
-      args: [rowId(id), payload]
-    });
+    await store.write(rowId(id), payload);
   }
   async function remove(id) {
-    await db.execute({ sql: "DELETE FROM wa_auth WHERE id = ?", args: [rowId(id)] });
+    await store.remove(rowId(id));
   }
   const creds = await read("creds") ?? runtime.initAuthCreds();
   return {
@@ -124,18 +152,13 @@ async function useTursoAuthState(db, secret, sessionId, runtime) {
       }
     },
     saveCreds: () => write("creds", creds),
-    clear: async () => {
-      if (sessionId === "default") {
-        await db.execute("DELETE FROM wa_auth WHERE id NOT LIKE 's:%'");
-      } else {
-        await db.execute({
-          sql: "DELETE FROM wa_auth WHERE id LIKE ?",
-          args: [`s:${sessionId}/%`]
-        });
-      }
-    }
+    // Scoped to THIS session - never nuke a sibling number's pairing.
+    clear: () => store.clear(sessionId)
   };
 }
+async function useTursoAuthState(db, secret, sessionId, runtime) {
+  return useAuthState(createTursoWaAuthKV(db), secret, sessionId, runtime);
+}
 
 // src/channels/whatsapp/baileys.ts
 function wrapMissingBaileysError(cause) {
@@ -198,6 +221,11 @@ function createConsoleLogger(level = "info") {
   };
 }
 
+// src/channels/backoff.ts
+function exponentialBackoffMs(baseMs, maxMs, n) {
+  return Math.min(baseMs * 2 ** Math.max(0, Math.min(n, 20)), maxMs);
+}
+
 // src/channels/whatsapp/lease.ts
 var LEASE_STALE_MS = 9e4;
 var LEASE_HEARTBEAT_MS = 3e4;
@@ -256,7 +284,7 @@ function createTursoWaLeaseStore(client) {
 var RECONNECT_DELAY_MS = 5e3;
 var RECONNECT_MAX_DELAY_MS = 10 * 60 * 1e3;
 function reconnectDelayMs(failures) {
-  return Math.min(RECONNECT_DELAY_MS * 2 ** Math.min(failures, 20), RECONNECT_MAX_DELAY_MS);
+  return exponentialBackoffMs(RECONNECT_DELAY_MS, RECONNECT_MAX_DELAY_MS, failures);
 }
 async function shutdownWaSessions(sessions) {
   await Promise.all(
@@ -327,9 +355,18 @@ async function acquireSessionLease(sessionId, deps) {
 function senderNameFor(channelName, sessionId) {
   return sessionId === "default" ? channelName : `${channelName}:${sessionId}`;
 }
+function normalizeWaMediaPayload(payload) {
+  const media = typeof payload === "string" ? { url: payload } : payload;
+  if (!media || typeof media !== "object" || typeof media.url !== "string" || !media.url) {
+    throw new TypeError(
+      `WhatsApp sendMedia payload must be a URL string or { url, caption? }, got: ${typeof payload}`
+    );
+  }
+  return media;
+}
 function createWhatsAppChannel(config) {
   assertStrongSecret(config.sessionSecret, "WhatsApp sessionSecret (e.g. WA_SESSION_SECRET)");
-  const channelName = "whatsapp";
+  const channelName = config.name ?? "whatsapp";
   const sessionIds = config.sessionIds && config.sessionIds.length > 0 ? config.sessionIds : ["default"];
   const now = config.now ?? Date.now;
   const schedule = config.schedule ?? ((fn, ms) => void setTimeout(fn, ms));
@@ -347,8 +384,13 @@ function createWhatsAppChannel(config) {
     name: channelName,
     async start(deps) {
       const log = config.logger ?? deps.logger ?? createConsoleLogger();
-      const db = deps.db;
-      const leaseStore = createTursoWaLeaseStore(db);
+      if ((!config.leaseStore || !config.authStore) && !deps.db) {
+        throw new Error(
+          "The WhatsApp channel needs a libsql client for auth state and the session lease: set config.database (config.retriever alone does not open one), or supply both config.leaseStore and config.authStore."
+        );
+      }
+      const leaseStore = config.leaseStore ?? createTursoWaLeaseStore(deps.db);
+      const authStore = config.authStore ?? createTursoWaAuthKV(deps.db);
       senders = deps.senders;
       await loadBaileys2();
       async function connect(sessionId) {
@@ -359,8 +401,8 @@ function createWhatsAppChannel(config) {
           initAuthCreds: baileys.initAuthCreds,
           appStateSyncKeyFromObject: (value) => baileys.proto.Message.AppStateSyncKeyData.fromObject(value)
         };
-        const { state, saveCreds } = await useTursoAuthState(
-          db,
+        const { state, saveCreds } = await useAuthState(
+          authStore,
           config.sessionSecret,
           sessionId,
           runtime
@@ -404,6 +446,13 @@ function createWhatsAppChannel(config) {
               sendText: async (chatId, text) => {
                 await sock.sendMessage(chatId, { text });
               },
+              sendMedia: async (chatId, payload) => {
+                const { url, caption } = normalizeWaMediaPayload(payload);
+                await sock.sendMessage(
+                  chatId,
+                  caption !== void 0 ? { image: { url }, caption } : { image: { url } }
+                );
+              },
               sendReaction: async (chatId, messageRef, emoji) => {
                 await sock.sendMessage(chatId, {
                   react: { text: emoji, key: messageRef }
@@ -679,7 +728,8 @@ async function answerOnce({
 async function applyTransformReply(transformReply, input, logger) {
   if (!transformReply) return input.text;
   try {
-    return await transformReply(input);
+    const result = await transformReply(input);
+    return typeof result === "string" ? result : null;
   } catch (error) {
     logger?.error(
       `transformReply threw for channel "${input.channel}"; sending the original reply`,
@@ -741,6 +791,7 @@ async function prepareChat({
   sender,
   rewriteQuery,
   rerankContext,
+  fallbackFn,
   logger
 }) {
   const lastUserMsg = lastUserMessage(messages);
@@ -757,21 +808,39 @@ async function prepareChat({
       logger?.error("rewriteQuery threw; falling back to the original query", error);
     }
   }
-  let ctx = await store.query(query, topK, buckets ?? defaultBuckets(mode));
+  const resolvedBuckets = buckets ?? defaultBuckets(mode);
+  const retrievedChunks = await store.query(query, topK, resolvedBuckets);
+  let ctx = retrievedChunks;
   if (rerankContext) {
     try {
-      const reranked = await rerankContext({ query, chunks: ctx });
+      const reranked = await rerankContext({ query, chunks: [...ctx] });
       if (Array.isArray(reranked) && reranked.every((c) => typeof c === "string")) ctx = reranked;
     } catch (error) {
       logger?.error("rerankContext threw; falling back to the original chunks", error);
     }
   }
+  let fallback;
+  if (ctx.length === 0 && fallbackFn) {
+    try {
+      const guidance = await fallbackFn({
+        query,
+        mode,
+        buckets: resolvedBuckets,
+        sender,
+        retrievedChunks
+      });
+      if (typeof guidance === "string" && guidance.trim()) fallback = guidance.trim();
+    } catch (error) {
+      logger?.error("fallbackFn threw; proceeding without fallback guidance", error);
+    }
+  }
   const persona = personaLayer?.trim() || (mode === "private" ? prompts.privatePersona : prompts.publicPersona);
   const hint = channelHint?.trim();
   const system = [
     prompts.baseSystemRules,
     persona,
     ...hint ? [hint] : [],
+    ...fallback ? [fallback] : [],
     `${label}:
 ${ctx.join("\n\n")}`
   ].join("\n\n");
@@ -779,7 +848,7 @@ ${ctx.join("\n\n")}`
 }
 
 // src/history/compaction.ts
-var DEFAULT_TIMEOUT_MS = 8e3;
+var COMPACTION_TIMEOUT_MS = 8e3;
 var LOAD_ALL = Number.MAX_SAFE_INTEGER;
 var SUMMARY_PREFIX = "Summary of earlier conversation: ";
 function defaultSummarize(client, model) {
@@ -807,7 +876,7 @@ function createHistoryCompactor(deps, options) {
     throw new Error(`Invalid history compaction keep: ${keep}`);
   }
   const summarize = options.summarize ?? defaultSummarize(deps.client, options.model);
-  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  const timeoutMs = options.timeoutMs ?? COMPACTION_TIMEOUT_MS;
   return {
     async maybeCompact(store, conversationId) {
       const turns = await store.load(conversationId, LOAD_ALL);
@@ -848,6 +917,16 @@ function createHistoryCompactor(deps, options) {
 }
 
 // src/channels/pipeline.ts
+function resolveBrainHooks(config, fallback) {
+  return {
+    answerFn: config.answerFn ?? fallback?.answerFn,
+    bucketsFor: config.bucketsFor ?? fallback?.bucketsFor,
+    rewriteQuery: config.rewriteQuery ?? fallback?.rewriteQuery,
+    rerankContext: config.rerankContext ?? fallback?.rerankContext,
+    fallbackFn: config.fallbackFn ?? fallback?.fallbackFn,
+    transformReply: config.transformReply ?? fallback?.transformReply
+  };
+}
 var DEFAULT_HISTORY_LIMIT = 20;
 var DEFAULT_GROUP_RATE_LIMIT = { max: 30, windowMs: 60 * 60 * 1e3 };
 var DEFAULT_DM_RATE_LIMIT = { max: 20, windowMs: 60 * 60 * 1e3 };
@@ -932,6 +1011,7 @@ function createInboundPipeline(deps, config) {
       sender,
       rewriteQuery: config.rewriteQuery,
       rerankContext: config.rerankContext,
+      fallbackFn: config.fallbackFn,
       logger: config.logger
     });
     const { content: produced } = await answerOnce({
@@ -1067,13 +1147,9 @@ function createWhatsAppInboundHandler(config) {
     { client: config.client, store: config.store, prompts: config.prompts },
     {
       channel: "whatsapp",
-      answerFn: config.answerFn,
-      bucketsFor: config.bucketsFor,
-      rewriteQuery: config.rewriteQuery,
-      rerankContext: config.rerankContext,
-      transformReply: config.transformReply,
+      ...resolveBrainHooks(config, config.serverConfig),
       model: config.model,
-      channelHint: config.channelHint,
+      channelHint: config.channelHint ?? "Channel: WhatsApp.",
       personaResolver: personaResolver ? ({ sender, text }) => personaResolver({ senderPhone: sender, text }) : void 0,
       history: config.history,
       allowedChats,
@@ -1233,6 +1309,7 @@ export {
   LEASE_WAIT_MS,
   acquireSessionLease,
   canAcquireLease,
+  createTursoWaAuthKV,
   createTursoWaLeaseStore,
   createWhatsAppChannel,
   createWhatsAppImageHandler,
@@ -1248,11 +1325,13 @@ export {
   jidsMatch,
   loadBaileys,
   messageContext,
+  normalizeWaMediaPayload,
   reconnectDelayMs,
   resolveWaMessage,
   senderNameFor,
   senderPhoneFor,
   shutdownWaSessions,
   stripOwnMentions,
+  useAuthState,
   useTursoAuthState
 };

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

@@ -1 +1 @@
-{"version":3,"file":"pairing.d.ts","sourceRoot":"","sources":["../../../src/channels/whatsapp/pairing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,8FAA8F;AAC9F,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C,mFAAmF;AACnF,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAczC;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAM/F;AAED,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAAA;CAAE,CAAC;AAEzD,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,aAAa,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,kBAAkB,CAS/E;AAED,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE;QACF,EAAE,EAAE,CACF,KAAK,EAAE,mBAAmB,GAAG,cAAc,EAC3C,QAAQ,EAAE,CAAC,MAAM,EAAE,uBAAuB,KAAK,IAAI,KAChD,IAAI,CAAC;KACX,CAAC;IACF,IAAI,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9B,kBAAkB,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7D,qEAAqE;IACrE,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,aAAa,CAAC;IACpB,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC;AAOD,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,cAAc,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;CAC7C;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,WAAW,GAAG,WAAW,GAAG,OAAO,GAAG,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjG,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,OAAO,EAAE,CACP,OAAO,EAAE,MAAM,KACZ,aAAa,GAAG,cAAc,GAAG,OAAO,CAAC,aAAa,GAAG,cAAc,CAAC,CAAC;IAC9E,aAAa,EAAE,MAAM,CAAC;IACtB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD,uEAAuE;IACvE,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,+BAA+B;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mFAAmF;IACnF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,uDAAuD;IACvD,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,2EAA2E;IAC3E,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CA0NvE"}
+{"version":3,"file":"pairing.d.ts","sourceRoot":"","sources":["../../../src/channels/whatsapp/pairing.ts"],"names":[],"mappings":"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"}

package/dist/client/src/Chat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Chat.d.ts","sourceRoot":"","sources":["../../../src/client/src/Chat.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEvD,qBAAa,IAAI;IACf,OAAO,CAAC,GAAG,CAAU;IACrB,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAC,CAAa;IAE7B,OAAO,CAAC,iBAAiB,CAAe;IACxC,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,UAAU,CAAqB;IAEvC,YAAY,MAAM,EAAE,UAAU,EA4B7B;IAED,OAAO,CAAC,MAAM;IAqBd,OAAO,CAAC,oBAAoB;YA+Cd,UAAU;IAkExB,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,oBAAoB;IAQ5B,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,KAAK,IAAI,IAAI,CAGZ;IAED;;OAEG;IACH,WAAW,IAAI,WAAW,EAAE,CAE3B;IAED;;OAEG;IACH,OAAO,IAAI,IAAI,CAEd;IAED;;OAEG;IACH,OAAO,CAAC,QAAQ;CAGjB"}
+{"version":3,"file":"Chat.d.ts","sourceRoot":"","sources":["../../../src/client/src/Chat.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEvD,qBAAa,IAAI;IACf,OAAO,CAAC,GAAG,CAAU;IACrB,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAC,CAAa;IAE7B,OAAO,CAAC,iBAAiB,CAAe;IACxC,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,UAAU,CAAqB;IAEvC,YAAY,MAAM,EAAE,UAAU,EA0B7B;IAED,OAAO,CAAC,MAAM;IAoBd,OAAO,CAAC,oBAAoB;YA8Cd,UAAU;IA4DxB,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,oBAAoB;IAQ5B,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,KAAK,IAAI,IAAI,CAGZ;IAED;;OAEG;IACH,WAAW,IAAI,WAAW,EAAE,CAE3B;IAED;;OAEG;IACH,OAAO,IAAI,IAAI,CAEd;IAED;;OAEG;IACH,OAAO,CAAC,QAAQ;CAGjB"}

package/dist/client/src/ChatButton.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatButton.d.ts","sourceRoot":"","sources":["../../../src/client/src/ChatButton.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,aAAa,CAAe;IACpC,OAAO,CAAC,IAAI,CAAqB;IACjC,OAAO,CAAC,MAAM,CAAS;IAEvB,YAAY,MAAM,EAAE,gBAAgB,EASnC;IAED,OAAO,CAAC,MAAM;IAsBd,OAAO,CAAC,oBAAoB;IAsB5B,OAAO,CAAC,MAAM;IAQd,IAAI,IAAI,IAAI,CAgDX;IAED,KAAK,IAAI,IAAI,CAcZ;IAED;;OAEG;IACH,OAAO,CAAC,QAAQ;IAIhB;;OAEG;IACH,OAAO,IAAI,IAAI,CAId;IAED;;OAEG;IACH,QAAQ,IAAI,OAAO,CAElB;CACF"}
+{"version":3,"file":"ChatButton.d.ts","sourceRoot":"","sources":["../../../src/client/src/ChatButton.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,aAAa,CAAe;IACpC,OAAO,CAAC,IAAI,CAAqB;IACjC,OAAO,CAAC,MAAM,CAAS;IAEvB,YAAY,MAAM,EAAE,gBAAgB,EASnC;IAED,OAAO,CAAC,MAAM;IAkBd,OAAO,CAAC,oBAAoB;IAoB5B,OAAO,CAAC,MAAM;IAQd,IAAI,IAAI,IAAI,CA+CX;IAED,KAAK,IAAI,IAAI,CAcZ;IAED;;OAEG;IACH,OAAO,CAAC,QAAQ;IAIhB;;OAEG;IACH,OAAO,IAAI,IAAI,CAId;IAED;;OAEG;IACH,QAAQ,IAAI,OAAO,CAElB;CACF"}

package/dist/client/src/browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../../src/client/src/browser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,OAAO,EAAE;YACP,OAAO,EAAE,OAAO,OAAO,CAAC;YACxB,IAAI,EAAE,OAAO,IAAI,CAAC;YAClB,UAAU,EAAE,OAAO,UAAU,CAAC;SAC/B,CAAC;KACH;CACF;AAWD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../../src/client/src/browser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,OAAO,EAAE;YACP,OAAO,EAAE,OAAO,OAAO,CAAC;YACxB,IAAI,EAAE,OAAO,IAAI,CAAC;YAClB,UAAU,EAAE,OAAO,UAAU,CAAC;SAC/B,CAAC;KACH;CACF;AAYD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC"}