@diegoaltoworks/chatter 0.57.0 → 0.59.0

package/dist/channels/whatsapp/index.mjs

@@ -790,6 +790,16 @@ async function resolvePersonaLayer(config, ctx) {
     return void 0;
   }
 }
+async function isHistoryEnabled(config, sender) {
+  const predicate = config.history?.historyEnabledFor;
+  if (!predicate) return true;
+  try {
+    return await predicate(sender);
+  } catch (error) {
+    config.logger?.error("historyEnabledFor threw; disabling history for this turn", error);
+    return false;
+  }
+}
 function createInboundPipeline(deps, config) {
   const mutedChats = /* @__PURE__ */ new Set();
   const now = config.now ?? Date.now;
@@ -829,12 +839,15 @@ function createInboundPipeline(deps, config) {
     }
     const personaLayer = await resolvePersonaLayer(config, { sender, text: msg.text });
     const buckets = await resolveBuckets({ mode, sender, bucketsFor: config.bucketsFor });
-    const priorTurns = config.history ? await config.history.store.load(
+    const historyEnabled = config.history ? await isHistoryEnabled(config, sender) : false;
+    const priorTurns = config.history && historyEnabled ? await config.history.store.load(
       conversationId,
       config.history.limit ?? DEFAULT_HISTORY_LIMIT
     ) : [];
     const messages = [...priorTurns, { role: "user", content: msg.text }];
-    await config.history?.store.append(conversationId, { role: "user", content: msg.text });
+    if (historyEnabled) {
+      await config.history?.store.append(conversationId, { role: "user", content: msg.text });
+    }
     const { system } = await prepareChat({
       store: deps.store,
       prompts: deps.prompts,
@@ -866,7 +879,9 @@ function createInboundPipeline(deps, config) {
     if (!content) {
       return { action: "ignore" };
     }
-    await config.history?.store.append(conversationId, { role: "assistant", content });
+    if (historyEnabled) {
+      await config.history?.store.append(conversationId, { role: "assistant", content });
+    }
     await turn.reply.sendAnswer(msg.chatId, content);
     return { action: "reply", content };
   };

package/dist/history/index.d.ts

@@ -12,6 +12,7 @@
  *
  * @packageDocumentation
  */
+export type { TursoHistoryStoreOptions } from "./tursoStore";
 export { createTursoHistoryStore } from "./tursoStore";
 export type { HistoryMessage, HistoryStore } from "./types";
 //# sourceMappingURL=index.d.ts.map

package/dist/history/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/history/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/history/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,YAAY,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC"}

package/dist/history/index.js

@@ -58,19 +58,32 @@ function ensureHistorySchema(client, tableName) {
 var VALID_TABLE_NAME = /^[A-Za-z_][A-Za-z0-9_]*$/;
 var VALID_ROLES = /* @__PURE__ */ new Set(["user", "assistant"]);
 var DEFAULT_MAX_PER_CONVERSATION = 200;
-function createTursoHistoryStore(client, tableName = "chat_history", maxPerConversation = DEFAULT_MAX_PER_CONVERSATION) {
+function createTursoHistoryStore(client, tableName = "chat_history", maxPerConversation = DEFAULT_MAX_PER_CONVERSATION, options) {
   if (!VALID_TABLE_NAME.test(tableName)) {
     throw new Error(`Invalid history store table name: ${tableName}`);
   }
   if (!Number.isInteger(maxPerConversation) || maxPerConversation < 1) {
     throw new Error(`Invalid history store maxPerConversation: ${maxPerConversation}`);
   }
+  if (options?.ttlMs !== void 0 && (!Number.isInteger(options.ttlMs) || options.ttlMs < 1)) {
+    throw new Error(`Invalid history store ttlMs: ${options.ttlMs}`);
+  }
+  const ttlMs = options?.ttlMs;
+  const now = options?.now ?? Date.now;
+  async function pruneExpired(conversationId) {
+    if (ttlMs === void 0) return;
+    await client.execute({
+      sql: `DELETE FROM ${tableName} WHERE conversation_id = ? AND created_at < ?`,
+      args: [conversationId, now() - ttlMs]
+    });
+  }
   return {
     async append(conversationId, message) {
       await ensureHistorySchema(client, tableName);
+      await pruneExpired(conversationId);
       await client.execute({
         sql: `INSERT INTO ${tableName} (conversation_id, role, content, created_at) VALUES (?, ?, ?, ?)`,
-        args: [conversationId, message.role, message.content, Date.now()]
+        args: [conversationId, message.role, message.content, now()]
       });
       await client.execute({
         sql: `DELETE FROM ${tableName} WHERE conversation_id = ? AND id NOT IN (
@@ -83,6 +96,7 @@ function createTursoHistoryStore(client, tableName = "chat_history", maxPerConve
       const boundedLimit = Math.max(0, Math.trunc(limit));
       if (boundedLimit === 0) return [];
       await ensureHistorySchema(client, tableName);
+      await pruneExpired(conversationId);
       const result = await client.execute({
         sql: `SELECT role, content FROM ${tableName} WHERE conversation_id = ? ORDER BY id DESC LIMIT ?`,
         args: [conversationId, boundedLimit]
@@ -91,6 +105,13 @@ function createTursoHistoryStore(client, tableName = "chat_history", maxPerConve
         role: String(row.role),
         content: String(row.content)
       })).filter((row) => VALID_ROLES.has(row.role)).reverse();
+    },
+    async clear(conversationId) {
+      await ensureHistorySchema(client, tableName);
+      await client.execute({
+        sql: `DELETE FROM ${tableName} WHERE conversation_id = ?`,
+        args: [conversationId]
+      });
     }
   };
 }

package/dist/history/index.mjs

@@ -32,19 +32,32 @@ function ensureHistorySchema(client, tableName) {
 var VALID_TABLE_NAME = /^[A-Za-z_][A-Za-z0-9_]*$/;
 var VALID_ROLES = /* @__PURE__ */ new Set(["user", "assistant"]);
 var DEFAULT_MAX_PER_CONVERSATION = 200;
-function createTursoHistoryStore(client, tableName = "chat_history", maxPerConversation = DEFAULT_MAX_PER_CONVERSATION) {
+function createTursoHistoryStore(client, tableName = "chat_history", maxPerConversation = DEFAULT_MAX_PER_CONVERSATION, options) {
   if (!VALID_TABLE_NAME.test(tableName)) {
     throw new Error(`Invalid history store table name: ${tableName}`);
   }
   if (!Number.isInteger(maxPerConversation) || maxPerConversation < 1) {
     throw new Error(`Invalid history store maxPerConversation: ${maxPerConversation}`);
   }
+  if (options?.ttlMs !== void 0 && (!Number.isInteger(options.ttlMs) || options.ttlMs < 1)) {
+    throw new Error(`Invalid history store ttlMs: ${options.ttlMs}`);
+  }
+  const ttlMs = options?.ttlMs;
+  const now = options?.now ?? Date.now;
+  async function pruneExpired(conversationId) {
+    if (ttlMs === void 0) return;
+    await client.execute({
+      sql: `DELETE FROM ${tableName} WHERE conversation_id = ? AND created_at < ?`,
+      args: [conversationId, now() - ttlMs]
+    });
+  }
   return {
     async append(conversationId, message) {
       await ensureHistorySchema(client, tableName);
+      await pruneExpired(conversationId);
       await client.execute({
         sql: `INSERT INTO ${tableName} (conversation_id, role, content, created_at) VALUES (?, ?, ?, ?)`,
-        args: [conversationId, message.role, message.content, Date.now()]
+        args: [conversationId, message.role, message.content, now()]
       });
       await client.execute({
         sql: `DELETE FROM ${tableName} WHERE conversation_id = ? AND id NOT IN (
@@ -57,6 +70,7 @@ function createTursoHistoryStore(client, tableName = "chat_history", maxPerConve
       const boundedLimit = Math.max(0, Math.trunc(limit));
       if (boundedLimit === 0) return [];
       await ensureHistorySchema(client, tableName);
+      await pruneExpired(conversationId);
       const result = await client.execute({
         sql: `SELECT role, content FROM ${tableName} WHERE conversation_id = ? ORDER BY id DESC LIMIT ?`,
         args: [conversationId, boundedLimit]
@@ -65,6 +79,13 @@ function createTursoHistoryStore(client, tableName = "chat_history", maxPerConve
         role: String(row.role),
         content: String(row.content)
       })).filter((row) => VALID_ROLES.has(row.role)).reverse();
+    },
+    async clear(conversationId) {
+      await ensureHistorySchema(client, tableName);
+      await client.execute({
+        sql: `DELETE FROM ${tableName} WHERE conversation_id = ?`,
+        args: [conversationId]
+      });
     }
   };
 }

package/dist/history/tursoStore.d.ts

@@ -10,6 +10,18 @@
  */
 import type { Client } from "@libsql/client";
 import type { HistoryStore } from "./types";
+export interface TursoHistoryStoreOptions {
+    /**
+     * Retention window: rows older than this are pruned whenever the
+     * conversation they belong to is accessed (`append` or `load`) — there is
+     * no background sweep. Unset: rows never expire on their own (only the
+     * `maxPerConversation` count cap and explicit `clear` remove them). Must be
+     * a positive integer, validated at construction like `maxPerConversation`.
+     */
+    ttlMs?: number;
+    /** Injectable clock for tests. @default Date.now */
+    now?: () => number;
+}
 /**
  * Creates a history store keyed by an arbitrary conversation id (a WhatsApp
  * chat jid, a phone call sid, a web session id) on `tableName`.
@@ -22,5 +34,5 @@ import type { HistoryStore } from "./types";
  * or disable pruning entirely (SQLite reads a negative `LIMIT` as
  * unlimited), so it is validated at construction the same way `tableName` is.
  */
-export declare function createTursoHistoryStore(client: Client, tableName?: string, maxPerConversation?: number): HistoryStore;
+export declare function createTursoHistoryStore(client: Client, tableName?: string, maxPerConversation?: number, options?: TursoHistoryStoreOptions): HistoryStore;
 //# sourceMappingURL=tursoStore.d.ts.map

package/dist/history/tursoStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tursoStore.d.ts","sourceRoot":"","sources":["../../src/history/tursoStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,SAAS,CAAC;AAkD5D;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,SAAS,SAAiB,EAC1B,kBAAkB,SAA+B,GAChD,YAAY,CAkDd"}
+{"version":3,"file":"tursoStore.d.ts","sourceRoot":"","sources":["../../src/history/tursoStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,SAAS,CAAC;AAkD5D,MAAM,WAAW,wBAAwB;IACvC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,SAAS,SAAiB,EAC1B,kBAAkB,SAA+B,EACjD,OAAO,CAAC,EAAE,wBAAwB,GACjC,YAAY,CAyEd"}

package/dist/history/types.d.ts

@@ -14,5 +14,7 @@ export interface HistoryStore {
     append(conversationId: string, message: HistoryMessage): Promise<void>;
     /** Load up to `limit` most recent turns for `conversationId`, oldest first. */
     load(conversationId: string, limit: number): Promise<HistoryMessage[]>;
+    /** Reset primitive: erases all of `conversationId`'s history. Other conversations are untouched. */
+    clear(conversationId: string): Promise<void>;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/history/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/history/types.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,+EAA+E;IAC/E,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CACxE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/history/types.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,+EAA+E;IAC/E,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IACvE,oGAAoG;IACpG,KAAK,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C"}

package/package.json

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