@diegoaltoworks/chatter 0.65.0 → 0.67.0

package/dist/channels/index.js

@@ -263,7 +263,12 @@ async function prepareChat({
         mode,
         buckets: resolvedBuckets,
         sender,
-        retrievedChunks
+        // A copy for the same reason the reranker gets one. Whenever `ctx` is
+        // still the array the store returned (no reranker, or one that threw
+        // or returned a non-array), the two are the same object, so whatever a
+        // hook pushed onto its argument would land in the context assembled
+        // below.
+        retrievedChunks: [...retrievedChunks]
       });
       if (typeof guidance === "string" && guidance.trim()) fallback = guidance.trim();
     } catch (error) {

package/dist/channels/index.mjs

@@ -229,7 +229,12 @@ async function prepareChat({
         mode,
         buckets: resolvedBuckets,
         sender,
-        retrievedChunks
+        // A copy for the same reason the reranker gets one. Whenever `ctx` is
+        // still the array the store returned (no reranker, or one that threw
+        // or returned a non-array), the two are the same object, so whatever a
+        // hook pushed onto its argument would land in the context assembled
+        // below.
+        retrievedChunks: [...retrievedChunks]
       });
       if (typeof guidance === "string" && guidance.trim()) fallback = guidance.trim();
     } catch (error) {

package/dist/channels/matrix/index.js

@@ -500,7 +500,12 @@ async function prepareChat({
         mode,
         buckets: resolvedBuckets,
         sender,
-        retrievedChunks
+        // A copy for the same reason the reranker gets one. Whenever `ctx` is
+        // still the array the store returned (no reranker, or one that threw
+        // or returned a non-array), the two are the same object, so whatever a
+        // hook pushed onto its argument would land in the context assembled
+        // below.
+        retrievedChunks: [...retrievedChunks]
       });
       if (typeof guidance === "string" && guidance.trim()) fallback = guidance.trim();
     } catch (error) {

package/dist/channels/matrix/index.mjs

@@ -452,7 +452,12 @@ async function prepareChat({
         mode,
         buckets: resolvedBuckets,
         sender,
-        retrievedChunks
+        // A copy for the same reason the reranker gets one. Whenever `ctx` is
+        // still the array the store returned (no reranker, or one that threw
+        // or returned a non-array), the two are the same object, so whatever a
+        // hook pushed onto its argument would land in the context assembled
+        // below.
+        retrievedChunks: [...retrievedChunks]
       });
       if (typeof guidance === "string" && guidance.trim()) fallback = guidance.trim();
     } catch (error) {

package/dist/channels/telegram/index.js

@@ -393,7 +393,12 @@ async function prepareChat({
         mode,
         buckets: resolvedBuckets,
         sender,
-        retrievedChunks
+        // A copy for the same reason the reranker gets one. Whenever `ctx` is
+        // still the array the store returned (no reranker, or one that threw
+        // or returned a non-array), the two are the same object, so whatever a
+        // hook pushed onto its argument would land in the context assembled
+        // below.
+        retrievedChunks: [...retrievedChunks]
       });
       if (typeof guidance === "string" && guidance.trim()) fallback = guidance.trim();
     } catch (error) {

package/dist/channels/telegram/index.mjs

@@ -348,7 +348,12 @@ async function prepareChat({
         mode,
         buckets: resolvedBuckets,
         sender,
-        retrievedChunks
+        // A copy for the same reason the reranker gets one. Whenever `ctx` is
+        // still the array the store returned (no reranker, or one that threw
+        // or returned a non-array), the two are the same object, so whatever a
+        // hook pushed onto its argument would land in the context assembled
+        // below.
+        retrievedChunks: [...retrievedChunks]
       });
       if (typeof guidance === "string" && guidance.trim()) fallback = guidance.trim();
     } catch (error) {

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

@@ -30,6 +30,39 @@ export interface WhatsAppMessageEvent {
     sock: WASocket;
     message: WAMessage;
 }
+/**
+ * A session's connection state, derived from the same `connection.update`
+ * and lease transitions the channel already reacts to - not a new event
+ * source. `connecting` covers both the first connect after acquiring the
+ * lease and every reconnect attempt; `waiting_for_lease` covers not
+ * currently holding this session's lease, whether another instance holds it
+ * or acquiring/renewing it is failing.
+ */
+export type WaConnectionState = "connected" | "connecting" | "waiting_for_lease" | "disconnected";
+export interface WaSessionStatus {
+    sessionId: string;
+    state: WaConnectionState;
+    /** `Date.now()`-style timestamp of the last state transition (not of the last read). */
+    since: number;
+    /** The most recent failure description; cleared once the session reconnects. */
+    lastError?: string;
+}
+/**
+ * Optional liveness escalation: `onUnhealthy` fires once a session has been
+ * anything but `connected` for at least `unhealthyAfterMs`, and rearms the
+ * moment it reconnects. That includes `waiting_for_lease` - legitimate
+ * during a brief multi-instance deploy overlap, so size `unhealthyAfterMs`
+ * comfortably above how long that overlap is expected to last, or an
+ * instance that never wins the lease (a stuck rollout) will trip the
+ * watchdog repeatedly. Off by default - an unconfigured host still gets a
+ * bounded, grep-able error log while unhealthy (see `createWhatsAppChannel`'s
+ * status checker), just no callback. A host can use `onUnhealthy` to alert,
+ * or to `process.exit` so the platform restarts the container.
+ */
+export interface WhatsAppWatchdogConfig {
+    unhealthyAfterMs: number;
+    onUnhealthy?: (status: WaSessionStatus) => void;
+}
 export interface WhatsAppChannelConfig {
     /** Passphrase that encrypts auth state at rest (AES-256-GCM key material). Keep it stable across restarts and deploys — losing it means re-pairing. */
     sessionSecret: string;
@@ -60,6 +93,8 @@ export interface WhatsAppChannelConfig {
     leaseStore?: WaLeaseStore;
     /** Baileys auth-state persistence, encrypted above this seam. Defaults to a `wa_auth` table in `deps.db`; inject your own to run this channel without a libsql database. */
     authStore?: WaAuthKV;
+    /** Liveness escalation for a session stuck unhealthy. Off by default (see {@link WhatsAppWatchdogConfig}). */
+    watchdog?: WhatsAppWatchdogConfig;
 }
 /** A live, leased session: what `stop()` (or losing the lease) must tear down. */
 export interface WaSessionHandle {
@@ -99,6 +134,8 @@ export interface LeaseGatedConnectDeps {
      * no live socket and nothing pending never recovers on its own.
      */
     onConnectFailed?: (sessionId: string, error: unknown) => void;
+    /** Reports a connection-state transition, for the channel's status/watchdog seam. Optional - direct callers of `acquireSessionLease` in tests don't need it. */
+    onStatusChange?: (sessionId: string, state: WaConnectionState, lastError?: string) => void;
 }
 /**
  * Acquire `sessionId`'s lease before connecting — two instances must never
@@ -130,5 +167,10 @@ export interface WhatsAppMediaPayload {
  * `false` rather than sending Baileys a `{ image: { url: undefined } }`.
  */
 export declare function normalizeWaMediaPayload(payload: unknown): WhatsAppMediaPayload;
-export declare function createWhatsAppChannel(config: WhatsAppChannelConfig): Channel;
+/** `createWhatsAppChannel`'s return type: the {@link Channel} SPI plus a way to poll per-session connection health without log-scraping. */
+export interface WhatsAppChannel extends Channel {
+    /** Per-session status, in the order `sessionIds` was configured. */
+    getStatus(): WaSessionStatus[];
+}
+export declare function createWhatsAppChannel(config: WhatsAppChannelConfig): WhatsAppChannel;
 //# sourceMappingURL=channel.d.ts.map

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

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

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

@@ -27,7 +27,7 @@ export type { AuthStateRuntime, TursoAuthStateResult, WaAuthKV } from "./authSta
 export { createTursoWaAuthKV, useAuthState, useTursoAuthState } from "./authState";
 export type { Baileys } from "./baileys";
 export { loadBaileys } from "./baileys";
-export { acquireSessionLease, createWhatsAppChannel, type LeaseGatedConnectDeps, normalizeWaMediaPayload, reconnectDelayMs, senderNameFor, shutdownWaSessions, type WaSessionHandle, type WhatsAppChannelConfig, type WhatsAppMediaPayload, type WhatsAppMessageEvent, } from "./channel";
+export { acquireSessionLease, createWhatsAppChannel, type LeaseGatedConnectDeps, normalizeWaMediaPayload, reconnectDelayMs, senderNameFor, shutdownWaSessions, type WaConnectionState, type WaSessionHandle, type WaSessionStatus, type WhatsAppChannel, type WhatsAppChannelConfig, type WhatsAppMediaPayload, type WhatsAppMessageEvent, type WhatsAppWatchdogConfig, } 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, type ResolvedWaMessage, resolveWaMessage, senderPhoneFor, stripOwnMentions, type WaMessageContext, type WhatsAppInboundConfig, } from "./inbound";

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,QAAQ,EAAE,MAAM,aAAa,CAAC;AACpF,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACnF,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,uBAAuB,EACvB,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,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,KAAK,iBAAiB,EACtB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,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;AACjB,OAAO,EACL,2BAA2B,EAC3B,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,2BAA2B,GACjC,MAAM,UAAU,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,QAAQ,EAAE,MAAM,aAAa,CAAC;AACpF,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACnF,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,uBAAuB,EACvB,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,GAC5B,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,KAAK,iBAAiB,EACtB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,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;AACjB,OAAO,EACL,2BAA2B,EAC3B,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,2BAA2B,GACjC,MAAM,UAAU,CAAC"}

package/dist/channels/whatsapp/index.js

@@ -348,9 +348,13 @@ function createTursoWaLeaseStore(client) {
 // src/channels/whatsapp/channel.ts
 var RECONNECT_DELAY_MS = 5e3;
 var RECONNECT_MAX_DELAY_MS = 10 * 60 * 1e3;
+var UNHEALTHY_LOG_INTERVAL_MS = 5 * 60 * 1e3;
 function reconnectDelayMs(failures) {
   return exponentialBackoffMs(RECONNECT_DELAY_MS, RECONNECT_MAX_DELAY_MS, failures);
 }
+function describeError(error) {
+  return error instanceof Error ? error.message : String(error);
+}
 async function shutdownWaSessions(sessions) {
   await Promise.all(
     [...sessions.values()].map(async (handle) => {
@@ -381,6 +385,7 @@ async function acquireSessionLease(sessionId, deps) {
   const schedule = deps.schedule ?? ((fn, ms) => void setTimeout(fn, ms));
   const logger = deps.logger ?? createConsoleLogger();
   if (isStopped()) return;
+  deps.onStatusChange?.(sessionId, "waiting_for_lease");
   const retry = () => {
     schedule(
       () => void acquireSessionLease(sessionId, deps).catch(
@@ -394,6 +399,7 @@ async function acquireSessionLease(sessionId, deps) {
     acquired = await leaseStore.tryAcquire(sessionId, instanceId, now(), staleMs);
   } catch (error) {
     logger.warn(`WhatsApp[${sessionId}]: lease acquire failed, retrying:`, error);
+    deps.onStatusChange?.(sessionId, "waiting_for_lease", describeError(error));
     retry();
     return;
   }
@@ -416,6 +422,11 @@ async function acquireSessionLease(sessionId, deps) {
       logger.error(
         `WhatsApp[${sessionId}]: lease heartbeats have been failing for ${failingForMs}ms, treating the lease as lost`
       );
+      deps.onStatusChange?.(
+        sessionId,
+        "disconnected",
+        `lease heartbeats failing for ${failingForMs}ms`
+      );
       demoteSelf();
       return;
     }
@@ -423,6 +434,7 @@ async function acquireSessionLease(sessionId, deps) {
       if (isStopped()) return;
       if (!stillHeld) {
         logger.error(`WhatsApp[${sessionId}]: lost the lease to another instance, disconnecting`);
+        deps.onStatusChange?.(sessionId, "disconnected", "lost the lease to another instance");
         demoteSelf();
         return;
       }
@@ -475,6 +487,26 @@ function createWhatsAppChannel(config) {
   const failureCounts = /* @__PURE__ */ new Map();
   const registeredSenderNames = /* @__PURE__ */ new Map();
   let senders;
+  const statuses = new Map(
+    sessionIds.map((id) => [id, { sessionId: id, state: "waiting_for_lease", since: now() }])
+  );
+  const unhealthySince = /* @__PURE__ */ new Map();
+  const watchdogFired = /* @__PURE__ */ new Set();
+  const lastUnhealthyLogAt = /* @__PURE__ */ new Map();
+  let healthCheckInterval;
+  function setStatus(sessionId, state, lastError) {
+    const prev = statuses.get(sessionId);
+    const since = prev && prev.state === state ? prev.since : now();
+    const resolvedLastError = lastError !== void 0 ? lastError : state === "connected" ? void 0 : prev?.lastError;
+    statuses.set(sessionId, { sessionId, state, since, lastError: resolvedLastError });
+    if (state === "connected") {
+      unhealthySince.delete(sessionId);
+      watchdogFired.delete(sessionId);
+      lastUnhealthyLogAt.delete(sessionId);
+    } else if (!unhealthySince.has(sessionId)) {
+      unhealthySince.set(sessionId, since);
+    }
+  }
   return {
     name: channelName,
     async start(deps) {
@@ -500,7 +532,8 @@ function createWhatsAppChannel(config) {
         waitMs,
         schedule,
         logger: log,
-        onConnectFailed: recoverFromFailedConnect
+        onConnectFailed: recoverFromFailedConnect,
+        onStatusChange: setStatus
       };
       function nextRetryDelayMs(sessionId) {
         const failures = failureCounts.get(sessionId) ?? 0;
@@ -515,6 +548,7 @@ function createWhatsAppChannel(config) {
         const handle = claimSession(sessionId, sessions);
         if (!handle) return;
         const delay = nextRetryDelayMs(sessionId);
+        setStatus(sessionId, "disconnected", describeError(error));
         log.error(
           `WhatsApp[${sessionId}]: connect attempt failed, releasing the lease and retrying in ${Math.round(delay / 1e3)}s:`,
           error
@@ -534,6 +568,7 @@ function createWhatsAppChannel(config) {
       }
       async function connect(sessionId) {
         if (stopped || !sessions.has(sessionId)) return;
+        setStatus(sessionId, "connecting");
         const baileys = await loadBaileys2();
         const runtime = {
           bufferJSON: baileys.BufferJSON,
@@ -550,6 +585,7 @@ function createWhatsAppChannel(config) {
           log.warn(
             `WhatsApp[${sessionId}]: no paired session found \u2014 pair it first (see docs/channels.md). Re-checking in 60s.`
           );
+          setStatus(sessionId, "disconnected", "no paired session - pair it first");
           schedule(() => attemptConnect(sessionId), 6e4);
           return;
         }
@@ -579,6 +615,7 @@ function createWhatsAppChannel(config) {
           const { connection, lastDisconnect } = update;
           if (connection === "open") {
             failureCounts.set(sessionId, 0);
+            setStatus(sessionId, "connected");
             log.info(`WhatsApp[${sessionId}]: connected as ${sock.user?.id ?? "unknown"}`);
             const senderName = senderNameFor(channelName, sessionId);
             const sender = {
@@ -609,6 +646,7 @@ function createWhatsAppChannel(config) {
             }
             const statusCode = lastDisconnect?.error?.output?.statusCode;
             if (statusCode === baileys.DisconnectReason.loggedOut) {
+              setStatus(sessionId, "disconnected", "session logged out - re-pair required");
               log.error(
                 `WhatsApp[${sessionId}]: session logged out \u2014 re-pair to reconnect (see docs/channels.md).`
               );
@@ -617,6 +655,7 @@ function createWhatsAppChannel(config) {
             }
             if (!stopped && sessions.has(sessionId)) {
               const delay = nextRetryDelayMs(sessionId);
+              setStatus(sessionId, "disconnected", `connection closed (${statusCode ?? "?"})`);
               log.warn(
                 `WhatsApp[${sessionId}]: connection closed (${statusCode ?? "?"}), reconnecting in ${Math.round(delay / 1e3)}s...`
               );
@@ -637,6 +676,33 @@ function createWhatsAppChannel(config) {
           });
         }
       }
+      function checkHealth() {
+        const nowMs = now();
+        for (const sessionId of sessionIds) {
+          const unhealthySinceMs = unhealthySince.get(sessionId);
+          if (unhealthySinceMs === void 0) continue;
+          const status = statuses.get(sessionId);
+          if (!status) continue;
+          const watchdog = config.watchdog;
+          if (watchdog && nowMs - unhealthySinceMs >= watchdog.unhealthyAfterMs && !watchdogFired.has(sessionId)) {
+            watchdogFired.add(sessionId);
+            watchdog.onUnhealthy?.(status);
+          }
+          if (!watchdog?.onUnhealthy) {
+            const lastLogged = lastUnhealthyLogAt.get(sessionId) ?? unhealthySinceMs;
+            if (nowMs - lastLogged >= UNHEALTHY_LOG_INTERVAL_MS) {
+              lastUnhealthyLogAt.set(sessionId, nowMs);
+              log.error(
+                `WhatsApp[${sessionId}]: unhealthy (${status.state}) since ${new Date(status.since).toISOString()}` + (status.lastError ? ` - ${status.lastError}` : "")
+              );
+            }
+          }
+        }
+      }
+      healthCheckInterval = setInterval(checkHealth, heartbeatMs);
+      if (typeof healthCheckInterval === "object" && "unref" in healthCheckInterval) {
+        healthCheckInterval.unref();
+      }
       for (const sessionId of sessionIds) {
         void acquireSessionLease(sessionId, leaseDeps).catch(
           (error) => log.error(`WhatsApp[${sessionId}]: failed to start:`, error)
@@ -645,11 +711,18 @@ function createWhatsAppChannel(config) {
     },
     async stop() {
       stopped = true;
+      if (healthCheckInterval) clearInterval(healthCheckInterval);
+      for (const sessionId of sessionIds) setStatus(sessionId, "disconnected", "channel stopped");
       for (const senderName of registeredSenderNames.values()) {
         senders?.unregister(senderName);
       }
       registeredSenderNames.clear();
       await shutdownWaSessions(sessions);
+    },
+    getStatus() {
+      return sessionIds.map(
+        (id) => statuses.get(id) ?? { sessionId: id, state: "waiting_for_lease", since: now() }
+      );
     }
   };
 }
@@ -950,7 +1023,12 @@ async function prepareChat({
         mode,
         buckets: resolvedBuckets,
         sender,
-        retrievedChunks
+        // A copy for the same reason the reranker gets one. Whenever `ctx` is
+        // still the array the store returned (no reranker, or one that threw
+        // or returned a non-array), the two are the same object, so whatever a
+        // hook pushed onto its argument would land in the context assembled
+        // below.
+        retrievedChunks: [...retrievedChunks]
       });
       if (typeof guidance === "string" && guidance.trim()) fallback = guidance.trim();
     } catch (error) {

package/dist/channels/whatsapp/index.mjs

@@ -283,9 +283,13 @@ function createTursoWaLeaseStore(client) {
 // src/channels/whatsapp/channel.ts
 var RECONNECT_DELAY_MS = 5e3;
 var RECONNECT_MAX_DELAY_MS = 10 * 60 * 1e3;
+var UNHEALTHY_LOG_INTERVAL_MS = 5 * 60 * 1e3;
 function reconnectDelayMs(failures) {
   return exponentialBackoffMs(RECONNECT_DELAY_MS, RECONNECT_MAX_DELAY_MS, failures);
 }
+function describeError(error) {
+  return error instanceof Error ? error.message : String(error);
+}
 async function shutdownWaSessions(sessions) {
   await Promise.all(
     [...sessions.values()].map(async (handle) => {
@@ -316,6 +320,7 @@ async function acquireSessionLease(sessionId, deps) {
   const schedule = deps.schedule ?? ((fn, ms) => void setTimeout(fn, ms));
   const logger = deps.logger ?? createConsoleLogger();
   if (isStopped()) return;
+  deps.onStatusChange?.(sessionId, "waiting_for_lease");
   const retry = () => {
     schedule(
       () => void acquireSessionLease(sessionId, deps).catch(
@@ -329,6 +334,7 @@ async function acquireSessionLease(sessionId, deps) {
     acquired = await leaseStore.tryAcquire(sessionId, instanceId, now(), staleMs);
   } catch (error) {
     logger.warn(`WhatsApp[${sessionId}]: lease acquire failed, retrying:`, error);
+    deps.onStatusChange?.(sessionId, "waiting_for_lease", describeError(error));
     retry();
     return;
   }
@@ -351,6 +357,11 @@ async function acquireSessionLease(sessionId, deps) {
       logger.error(
         `WhatsApp[${sessionId}]: lease heartbeats have been failing for ${failingForMs}ms, treating the lease as lost`
       );
+      deps.onStatusChange?.(
+        sessionId,
+        "disconnected",
+        `lease heartbeats failing for ${failingForMs}ms`
+      );
       demoteSelf();
       return;
     }
@@ -358,6 +369,7 @@ async function acquireSessionLease(sessionId, deps) {
       if (isStopped()) return;
       if (!stillHeld) {
         logger.error(`WhatsApp[${sessionId}]: lost the lease to another instance, disconnecting`);
+        deps.onStatusChange?.(sessionId, "disconnected", "lost the lease to another instance");
         demoteSelf();
         return;
       }
@@ -410,6 +422,26 @@ function createWhatsAppChannel(config) {
   const failureCounts = /* @__PURE__ */ new Map();
   const registeredSenderNames = /* @__PURE__ */ new Map();
   let senders;
+  const statuses = new Map(
+    sessionIds.map((id) => [id, { sessionId: id, state: "waiting_for_lease", since: now() }])
+  );
+  const unhealthySince = /* @__PURE__ */ new Map();
+  const watchdogFired = /* @__PURE__ */ new Set();
+  const lastUnhealthyLogAt = /* @__PURE__ */ new Map();
+  let healthCheckInterval;
+  function setStatus(sessionId, state, lastError) {
+    const prev = statuses.get(sessionId);
+    const since = prev && prev.state === state ? prev.since : now();
+    const resolvedLastError = lastError !== void 0 ? lastError : state === "connected" ? void 0 : prev?.lastError;
+    statuses.set(sessionId, { sessionId, state, since, lastError: resolvedLastError });
+    if (state === "connected") {
+      unhealthySince.delete(sessionId);
+      watchdogFired.delete(sessionId);
+      lastUnhealthyLogAt.delete(sessionId);
+    } else if (!unhealthySince.has(sessionId)) {
+      unhealthySince.set(sessionId, since);
+    }
+  }
   return {
     name: channelName,
     async start(deps) {
@@ -435,7 +467,8 @@ function createWhatsAppChannel(config) {
         waitMs,
         schedule,
         logger: log,
-        onConnectFailed: recoverFromFailedConnect
+        onConnectFailed: recoverFromFailedConnect,
+        onStatusChange: setStatus
       };
       function nextRetryDelayMs(sessionId) {
         const failures = failureCounts.get(sessionId) ?? 0;
@@ -450,6 +483,7 @@ function createWhatsAppChannel(config) {
         const handle = claimSession(sessionId, sessions);
         if (!handle) return;
         const delay = nextRetryDelayMs(sessionId);
+        setStatus(sessionId, "disconnected", describeError(error));
         log.error(
           `WhatsApp[${sessionId}]: connect attempt failed, releasing the lease and retrying in ${Math.round(delay / 1e3)}s:`,
           error
@@ -469,6 +503,7 @@ function createWhatsAppChannel(config) {
       }
       async function connect(sessionId) {
         if (stopped || !sessions.has(sessionId)) return;
+        setStatus(sessionId, "connecting");
         const baileys = await loadBaileys2();
         const runtime = {
           bufferJSON: baileys.BufferJSON,
@@ -485,6 +520,7 @@ function createWhatsAppChannel(config) {
           log.warn(
             `WhatsApp[${sessionId}]: no paired session found \u2014 pair it first (see docs/channels.md). Re-checking in 60s.`
           );
+          setStatus(sessionId, "disconnected", "no paired session - pair it first");
           schedule(() => attemptConnect(sessionId), 6e4);
           return;
         }
@@ -514,6 +550,7 @@ function createWhatsAppChannel(config) {
           const { connection, lastDisconnect } = update;
           if (connection === "open") {
             failureCounts.set(sessionId, 0);
+            setStatus(sessionId, "connected");
             log.info(`WhatsApp[${sessionId}]: connected as ${sock.user?.id ?? "unknown"}`);
             const senderName = senderNameFor(channelName, sessionId);
             const sender = {
@@ -544,6 +581,7 @@ function createWhatsAppChannel(config) {
             }
             const statusCode = lastDisconnect?.error?.output?.statusCode;
             if (statusCode === baileys.DisconnectReason.loggedOut) {
+              setStatus(sessionId, "disconnected", "session logged out - re-pair required");
               log.error(
                 `WhatsApp[${sessionId}]: session logged out \u2014 re-pair to reconnect (see docs/channels.md).`
               );
@@ -552,6 +590,7 @@ function createWhatsAppChannel(config) {
             }
             if (!stopped && sessions.has(sessionId)) {
               const delay = nextRetryDelayMs(sessionId);
+              setStatus(sessionId, "disconnected", `connection closed (${statusCode ?? "?"})`);
               log.warn(
                 `WhatsApp[${sessionId}]: connection closed (${statusCode ?? "?"}), reconnecting in ${Math.round(delay / 1e3)}s...`
               );
@@ -572,6 +611,33 @@ function createWhatsAppChannel(config) {
           });
         }
       }
+      function checkHealth() {
+        const nowMs = now();
+        for (const sessionId of sessionIds) {
+          const unhealthySinceMs = unhealthySince.get(sessionId);
+          if (unhealthySinceMs === void 0) continue;
+          const status = statuses.get(sessionId);
+          if (!status) continue;
+          const watchdog = config.watchdog;
+          if (watchdog && nowMs - unhealthySinceMs >= watchdog.unhealthyAfterMs && !watchdogFired.has(sessionId)) {
+            watchdogFired.add(sessionId);
+            watchdog.onUnhealthy?.(status);
+          }
+          if (!watchdog?.onUnhealthy) {
+            const lastLogged = lastUnhealthyLogAt.get(sessionId) ?? unhealthySinceMs;
+            if (nowMs - lastLogged >= UNHEALTHY_LOG_INTERVAL_MS) {
+              lastUnhealthyLogAt.set(sessionId, nowMs);
+              log.error(
+                `WhatsApp[${sessionId}]: unhealthy (${status.state}) since ${new Date(status.since).toISOString()}` + (status.lastError ? ` - ${status.lastError}` : "")
+              );
+            }
+          }
+        }
+      }
+      healthCheckInterval = setInterval(checkHealth, heartbeatMs);
+      if (typeof healthCheckInterval === "object" && "unref" in healthCheckInterval) {
+        healthCheckInterval.unref();
+      }
       for (const sessionId of sessionIds) {
         void acquireSessionLease(sessionId, leaseDeps).catch(
           (error) => log.error(`WhatsApp[${sessionId}]: failed to start:`, error)
@@ -580,11 +646,18 @@ function createWhatsAppChannel(config) {
     },
     async stop() {
       stopped = true;
+      if (healthCheckInterval) clearInterval(healthCheckInterval);
+      for (const sessionId of sessionIds) setStatus(sessionId, "disconnected", "channel stopped");
       for (const senderName of registeredSenderNames.values()) {
         senders?.unregister(senderName);
       }
       registeredSenderNames.clear();
       await shutdownWaSessions(sessions);
+    },
+    getStatus() {
+      return sessionIds.map(
+        (id) => statuses.get(id) ?? { sessionId: id, state: "waiting_for_lease", since: now() }
+      );
     }
   };
 }
@@ -885,7 +958,12 @@ async function prepareChat({
         mode,
         buckets: resolvedBuckets,
         sender,
-        retrievedChunks
+        // A copy for the same reason the reranker gets one. Whenever `ctx` is
+        // still the array the store returned (no reranker, or one that threw
+        // or returned a non-array), the two are the same object, so whatever a
+        // hook pushed onto its argument would land in the context assembled
+        // below.
+        retrievedChunks: [...retrievedChunks]
       });
       if (typeof guidance === "string" && guidance.trim()) fallback = guidance.trim();
     } catch (error) {

package/dist/client/src/ChatBot.d.ts

@@ -1,6 +1,6 @@
 /**
  * ChatBot API Client
- * A TypeScript client for consuming the DiegoBot API
+ * A TypeScript client for consuming a Chatter server's API
  */
 import type { ChatBotConfig, ChatMessage, StreamCallbacks } from "./types";
 export declare class ChatBot {

package/dist/client/src/types.d.ts

@@ -3,7 +3,7 @@
  */
 export type ChatMode = "public" | "private";
 export interface ChatBotConfig {
-    /** Host of the DiegoBot API (e.g., 'api.example.com' - protocol will be added automatically) */
+    /** Host of the Chatter server (e.g., 'api.example.com' - protocol will be added automatically) */
     host: string;
     /** Either 'public' or 'private' */
     mode: ChatMode;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/client/src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE5C,MAAM,WAAW,aAAa;IAC5B,gGAAgG;IAChG,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,IAAI,EAAE,QAAQ,CAAC;IACf,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,UAAW,SAAQ,aAAa;IAC/C,yEAAyE;IACzE,SAAS,EAAE,WAAW,GAAG,MAAM,CAAC;IAChC,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,eAAe,CAAC,EAAE,WAAW,EAAE,CAAC;IAChC,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,gBAAiB,SAAQ,aAAa;IACrD,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,cAAc,GAAG,aAAa,GAAG,WAAW,GAAG,UAAU,CAAC;IACrE,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACtC,gCAAgC;IAChC,UAAU,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC;CAC9E"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/client/src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE5C,MAAM,WAAW,aAAa;IAC5B,kGAAkG;IAClG,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,IAAI,EAAE,QAAQ,CAAC;IACf,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,UAAW,SAAQ,aAAa;IAC/C,yEAAyE;IACzE,SAAS,EAAE,WAAW,GAAG,MAAM,CAAC;IAChC,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,eAAe,CAAC,EAAE,WAAW,EAAE,CAAC;IAChC,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,gBAAiB,SAAQ,aAAa;IACrD,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,cAAc,GAAG,aAAa,GAAG,WAAW,GAAG,UAAU,CAAC;IACrE,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACtC,gCAAgC;IAChC,UAAU,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC;CAC9E"}

package/dist/core/pipeline.d.ts

@@ -70,11 +70,13 @@ export interface FallbackContext {
     /** Caller identity, where the surface has one. Absent on anonymous surfaces. */
     sender?: string;
     /**
-     * What `store.query` returned, before `rerankContext` ran: always
-     * non-empty when this is empty because `rerankContext` filtered
-     * everything out, and always empty when the store itself found nothing.
-     * A hook can use this to tell "some low-confidence signal existed" apart
-     * from "nothing matched at all".
+     * What `store.query` returned for this turn, before `rerankContext` ran.
+     * `fallbackFn` runs only when the post-rerank context is empty, so this
+     * array is non-empty exactly when `rerankContext` filtered every retrieved
+     * chunk out, and empty exactly when the store itself found nothing. A hook
+     * can use that to tell "some low-confidence signal existed" apart from
+     * "nothing matched at all". It is a copy, so mutating it in place cannot
+     * change the context the turn goes on to answer with.
      */
     retrievedChunks: string[];
 }

package/dist/core/pipeline.d.ts.map

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

package/dist/index.js

@@ -967,7 +967,12 @@ async function prepareChat({
         mode,
         buckets: resolvedBuckets,
         sender,
-        retrievedChunks
+        // A copy for the same reason the reranker gets one. Whenever `ctx` is
+        // still the array the store returned (no reranker, or one that threw
+        // or returned a non-array), the two are the same object, so whatever a
+        // hook pushed onto its argument would land in the context assembled
+        // below.
+        retrievedChunks: [...retrievedChunks]
       });
       if (typeof guidance === "string" && guidance.trim()) fallback = guidance.trim();
     } catch (error) {
@@ -1551,7 +1556,7 @@ async function createMCPServer(config) {
     privateToolConfig.enabled ? privateToolConfig.name : null
   ].filter(Boolean);
   if (enabledTools.length === 0) {
-    log.warn("\u26A0\uFE0F  Warning: No MCP tools enabled");
+    log.warn("No MCP tools enabled");
   }
   log.info(
     `\u2705 ${config.bot.name} MCP Server ready (transport: ${transportMode}, tools: ${enabledTools.join(", ") || "none"})`

package/dist/index.mjs

@@ -892,7 +892,12 @@ async function prepareChat({
         mode,
         buckets: resolvedBuckets,
         sender,
-        retrievedChunks
+        // A copy for the same reason the reranker gets one. Whenever `ctx` is
+        // still the array the store returned (no reranker, or one that threw
+        // or returned a non-array), the two are the same object, so whatever a
+        // hook pushed onto its argument would land in the context assembled
+        // below.
+        retrievedChunks: [...retrievedChunks]
       });
       if (typeof guidance === "string" && guidance.trim()) fallback = guidance.trim();
     } catch (error) {
@@ -1476,7 +1481,7 @@ async function createMCPServer(config) {
     privateToolConfig.enabled ? privateToolConfig.name : null
   ].filter(Boolean);
   if (enabledTools.length === 0) {
-    log.warn("\u26A0\uFE0F  Warning: No MCP tools enabled");
+    log.warn("No MCP tools enabled");
   }
   log.info(
     `\u2705 ${config.bot.name} MCP Server ready (transport: ${transportMode}, tools: ${enabledTools.join(", ") || "none"})`

package/dist/mcp-server.js

@@ -706,7 +706,12 @@ async function prepareChat({
         mode,
         buckets: resolvedBuckets,
         sender,
-        retrievedChunks
+        // A copy for the same reason the reranker gets one. Whenever `ctx` is
+        // still the array the store returned (no reranker, or one that threw
+        // or returned a non-array), the two are the same object, so whatever a
+        // hook pushed onto its argument would land in the context assembled
+        // below.
+        retrievedChunks: [...retrievedChunks]
       });
       if (typeof guidance === "string" && guidance.trim()) fallback = guidance.trim();
     } catch (error) {
@@ -1229,7 +1234,7 @@ async function createMCPServer(config) {
     privateToolConfig.enabled ? privateToolConfig.name : null
   ].filter(Boolean);
   if (enabledTools.length === 0) {
-    log.warn("\u26A0\uFE0F  Warning: No MCP tools enabled");
+    log.warn("No MCP tools enabled");
   }
   log.info(
     `\u2705 ${config.bot.name} MCP Server ready (transport: ${transportMode}, tools: ${enabledTools.join(", ") || "none"})`

package/dist/mcp-server.mjs

@@ -678,7 +678,12 @@ async function prepareChat({
         mode,
         buckets: resolvedBuckets,
         sender,
-        retrievedChunks
+        // A copy for the same reason the reranker gets one. Whenever `ctx` is
+        // still the array the store returned (no reranker, or one that threw
+        // or returned a non-array), the two are the same object, so whatever a
+        // hook pushed onto its argument would land in the context assembled
+        // below.
+        retrievedChunks: [...retrievedChunks]
       });
       if (typeof guidance === "string" && guidance.trim()) fallback = guidance.trim();
     } catch (error) {
@@ -1201,7 +1206,7 @@ async function createMCPServer(config) {
     privateToolConfig.enabled ? privateToolConfig.name : null
   ].filter(Boolean);
   if (enabledTools.length === 0) {
-    log.warn("\u26A0\uFE0F  Warning: No MCP tools enabled");
+    log.warn("No MCP tools enabled");
   }
   log.info(
     `\u2705 ${config.bot.name} MCP Server ready (transport: ${transportMode}, tools: ${enabledTools.join(", ") || "none"})`

package/dist/server.js

@@ -915,7 +915,12 @@ async function prepareChat({
         mode,
         buckets: resolvedBuckets,
         sender,
-        retrievedChunks
+        // A copy for the same reason the reranker gets one. Whenever `ctx` is
+        // still the array the store returned (no reranker, or one that threw
+        // or returned a non-array), the two are the same object, so whatever a
+        // hook pushed onto its argument would land in the context assembled
+        // below.
+        retrievedChunks: [...retrievedChunks]
       });
       if (typeof guidance === "string" && guidance.trim()) fallback = guidance.trim();
     } catch (error) {

package/dist/server.mjs

@@ -887,7 +887,12 @@ async function prepareChat({
         mode,
         buckets: resolvedBuckets,
         sender,
-        retrievedChunks
+        // A copy for the same reason the reranker gets one. Whenever `ctx` is
+        // still the array the store returned (no reranker, or one that threw
+        // or returned a non-array), the two are the same object, so whatever a
+        // hook pushed onto its argument would land in the context assembled
+        // below.
+        retrievedChunks: [...retrievedChunks]
       });
       if (typeof guidance === "string" && guidance.trim()) fallback = guidance.trim();
     } catch (error) {

package/dist/types.d.ts

@@ -28,7 +28,7 @@ export interface PricingRates {
  * Bot identity configuration
  */
 export interface BotIdentity {
-    /** Bot display name (e.g., "DiegoBot", "AcmeBot") */
+    /** Bot display name (e.g., "AcmeBot") */
     name: string;
     /** Person or company name the bot represents */
     personName: string;
@@ -38,12 +38,17 @@ export interface BotIdentity {
     description: string;
 }
 /**
- * Bot branding configuration
+ * Bot branding configuration.
+ *
+ * Passthrough only: both colors are published on `GET /config` for a host's
+ * own page to read, and nothing shipped applies them. The built-in widgets are
+ * styled with the `chatter-ui-` CSS classes (see docs/client.md), so setting a
+ * color here does not restyle them.
  */
 export interface BotBranding {
-    /** Primary color for public chat widget */
+    /** Primary color to publish for the public chat, for a host page to apply itself */
     publicPrimaryColor?: string;
-    /** Primary color for private chat widget */
+    /** Primary color to publish for the private chat, for a host page to apply itself */
     privatePrimaryColor?: string;
 }
 /**

package/dist/types.d.ts.map

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

package/package.json

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