@diegoaltoworks/chatter 0.59.0 → 0.60.0

package/dist/channels/index.js

@@ -262,6 +262,75 @@ ${ctx.join("\n\n")}`
   return { system, messages, context: ctx };
 }
 
+// src/history/compaction.ts
+var DEFAULT_TIMEOUT_MS = 8e3;
+var LOAD_ALL = Number.MAX_SAFE_INTEGER;
+var SUMMARY_PREFIX = "Summary of earlier conversation: ";
+function defaultSummarize(client, model) {
+  return async ({ turns }) => {
+    const transcript = turns.map((turn) => `${turn.role}: ${turn.content}`).join("\n");
+    const { content } = await answerOnce({
+      client,
+      system: "Summarize the conversation turns below into a short paragraph a reader would need to continue the conversation. Preserve names, facts, and decisions; drop pleasantries. Reply with the summary only, no preamble.",
+      messages: [{ role: "user", content: transcript }],
+      // No `answerFn`: compaction is an internal chatter operation, not a
+      // chat surface, so it must not conscript a caller's brain hook, which
+      // is shaped to answer the user, not to summarize on the engine's behalf.
+      mode: "public",
+      model
+    });
+    return content;
+  };
+}
+function createHistoryCompactor(deps, options) {
+  const { threshold, keep, logger } = options;
+  if (!Number.isInteger(threshold) || threshold < 1) {
+    throw new Error(`Invalid history compaction threshold: ${threshold}`);
+  }
+  if (!Number.isInteger(keep) || keep < 0 || keep >= threshold) {
+    throw new Error(`Invalid history compaction keep: ${keep}`);
+  }
+  const summarize = options.summarize ?? defaultSummarize(deps.client, options.model);
+  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  return {
+    async maybeCompact(store, conversationId) {
+      const turns = await store.load(conversationId, LOAD_ALL);
+      if (turns.length < threshold) return;
+      const older = turns.slice(0, turns.length - keep);
+      let summary;
+      let timer;
+      try {
+        summary = await Promise.race([
+          summarize({ conversationId, turns: older }),
+          new Promise((_, reject) => {
+            timer = setTimeout(() => reject(new Error("history compaction timed out")), timeoutMs);
+          })
+        ]);
+      } catch (error) {
+        logger?.error(
+          `history compaction summarize failed for "${conversationId}"; history left untouched`,
+          error
+        );
+        return;
+      } finally {
+        clearTimeout(timer);
+      }
+      const trimmed = summary.trim();
+      if (!trimmed) return;
+      const fresh = await store.load(conversationId, LOAD_ALL);
+      const recent = fresh.slice(older.length);
+      await store.clear(conversationId);
+      await store.append(conversationId, {
+        role: "assistant",
+        content: `${SUMMARY_PREFIX}${trimmed}`
+      });
+      for (const turn of recent) {
+        await store.append(conversationId, turn);
+      }
+    }
+  };
+}
+
 // src/channels/pipeline.ts
 var DEFAULT_HISTORY_LIMIT = 20;
 var DEFAULT_GROUP_RATE_LIMIT = { max: 30, windowMs: 60 * 60 * 1e3 };
@@ -292,6 +361,10 @@ function createInboundPipeline(deps, config) {
   const underGroupRateLimit = createSlidingWindowRateLimiter(group.max, group.windowMs, now);
   const underDmRateLimit = createSlidingWindowRateLimiter(dm.max, dm.windowMs, now);
   const mode = "public";
+  const compactor = config.history?.compaction ? createHistoryCompactor(
+    { client: deps.client },
+    { model: config.model, ...config.history.compaction }
+  ) : void 0;
   return async function handleInboundMessage(msg, turn) {
     const allowedChats = config.allowedChats ?? [];
     const action = decideChannelAction(msg, {
@@ -367,6 +440,14 @@ function createInboundPipeline(deps, config) {
       await config.history?.store.append(conversationId, { role: "assistant", content });
     }
     await turn.reply.sendAnswer(msg.chatId, content);
+    const history = config.history;
+    if (compactor && historyEnabled && history) {
+      try {
+        await compactor.maybeCompact(history.store, conversationId);
+      } catch (error) {
+        config.logger?.error(`history compaction failed for "${conversationId}"`, error);
+      }
+    }
     return { action: "reply", content };
   };
 }

package/dist/channels/index.mjs

@@ -229,6 +229,75 @@ ${ctx.join("\n\n")}`
   return { system, messages, context: ctx };
 }
 
+// src/history/compaction.ts
+var DEFAULT_TIMEOUT_MS = 8e3;
+var LOAD_ALL = Number.MAX_SAFE_INTEGER;
+var SUMMARY_PREFIX = "Summary of earlier conversation: ";
+function defaultSummarize(client, model) {
+  return async ({ turns }) => {
+    const transcript = turns.map((turn) => `${turn.role}: ${turn.content}`).join("\n");
+    const { content } = await answerOnce({
+      client,
+      system: "Summarize the conversation turns below into a short paragraph a reader would need to continue the conversation. Preserve names, facts, and decisions; drop pleasantries. Reply with the summary only, no preamble.",
+      messages: [{ role: "user", content: transcript }],
+      // No `answerFn`: compaction is an internal chatter operation, not a
+      // chat surface, so it must not conscript a caller's brain hook, which
+      // is shaped to answer the user, not to summarize on the engine's behalf.
+      mode: "public",
+      model
+    });
+    return content;
+  };
+}
+function createHistoryCompactor(deps, options) {
+  const { threshold, keep, logger } = options;
+  if (!Number.isInteger(threshold) || threshold < 1) {
+    throw new Error(`Invalid history compaction threshold: ${threshold}`);
+  }
+  if (!Number.isInteger(keep) || keep < 0 || keep >= threshold) {
+    throw new Error(`Invalid history compaction keep: ${keep}`);
+  }
+  const summarize = options.summarize ?? defaultSummarize(deps.client, options.model);
+  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  return {
+    async maybeCompact(store, conversationId) {
+      const turns = await store.load(conversationId, LOAD_ALL);
+      if (turns.length < threshold) return;
+      const older = turns.slice(0, turns.length - keep);
+      let summary;
+      let timer;
+      try {
+        summary = await Promise.race([
+          summarize({ conversationId, turns: older }),
+          new Promise((_, reject) => {
+            timer = setTimeout(() => reject(new Error("history compaction timed out")), timeoutMs);
+          })
+        ]);
+      } catch (error) {
+        logger?.error(
+          `history compaction summarize failed for "${conversationId}"; history left untouched`,
+          error
+        );
+        return;
+      } finally {
+        clearTimeout(timer);
+      }
+      const trimmed = summary.trim();
+      if (!trimmed) return;
+      const fresh = await store.load(conversationId, LOAD_ALL);
+      const recent = fresh.slice(older.length);
+      await store.clear(conversationId);
+      await store.append(conversationId, {
+        role: "assistant",
+        content: `${SUMMARY_PREFIX}${trimmed}`
+      });
+      for (const turn of recent) {
+        await store.append(conversationId, turn);
+      }
+    }
+  };
+}
+
 // src/channels/pipeline.ts
 var DEFAULT_HISTORY_LIMIT = 20;
 var DEFAULT_GROUP_RATE_LIMIT = { max: 30, windowMs: 60 * 60 * 1e3 };
@@ -259,6 +328,10 @@ function createInboundPipeline(deps, config) {
   const underGroupRateLimit = createSlidingWindowRateLimiter(group.max, group.windowMs, now);
   const underDmRateLimit = createSlidingWindowRateLimiter(dm.max, dm.windowMs, now);
   const mode = "public";
+  const compactor = config.history?.compaction ? createHistoryCompactor(
+    { client: deps.client },
+    { model: config.model, ...config.history.compaction }
+  ) : void 0;
   return async function handleInboundMessage(msg, turn) {
     const allowedChats = config.allowedChats ?? [];
     const action = decideChannelAction(msg, {
@@ -334,6 +407,14 @@ function createInboundPipeline(deps, config) {
       await config.history?.store.append(conversationId, { role: "assistant", content });
     }
     await turn.reply.sendAnswer(msg.chatId, content);
+    const history = config.history;
+    if (compactor && historyEnabled && history) {
+      try {
+        await compactor.maybeCompact(history.store, conversationId);
+      } catch (error) {
+        config.logger?.error(`history compaction failed for "${conversationId}"`, error);
+      }
+    }
     return { action: "reply", content };
   };
 }

package/dist/channels/pipeline.d.ts

@@ -20,6 +20,7 @@ import type { Logger } from "../core/logger";
 import { type RerankContext, type RewriteQuery } from "../core/pipeline";
 import type { PromptLoader } from "../core/prompts";
 import type { VectorStore } from "../core/retrieval";
+import type { HistoryCompactionOptions } from "../history/compaction";
 import type { HistoryStore } from "../history/types";
 import { type ChannelMessage } from "./gates";
 /** Where a pipeline turn's output goes. Distinct from `ChannelSender` (`./senders`) — a transport implementing this may thread/quote the chat answer without doing the same for a plain gate acknowledgement. */
@@ -69,6 +70,13 @@ export interface InboundPipelineConfig {
          * opted out. @default every sender is enabled
          */
         historyEnabledFor?: (sender: string) => boolean | Promise<boolean>;
+        /**
+         * Summarize-then-truncate compaction, checked right after each reply is
+         * appended. Off by default — a conversation's window grows unbounded
+         * (aside from the store's own `maxPerConversation`) until this is set.
+         * See `../history/compaction`.
+         */
+        compaction?: HistoryCompactionOptions;
     };
     /** Group chats eligible for a reply. Empty (default) = every group. Has no effect on DMs, which always reply. */
     allowedChats?: string[];

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

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

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

@@ -24,6 +24,7 @@ import type { AnswerFn, TransformReply } from "../../core/answer";
 import type { BucketsFor } from "../../core/buckets";
 import { type Logger } from "../../core/logger";
 import type { RerankContext, RewriteQuery } from "../../core/pipeline";
+import type { HistoryCompactionOptions } from "../../history/compaction";
 import type { HistoryStore } from "../../history/types";
 import type { Channel } from "../index";
 import { type TelegramApi } from "./api";
@@ -61,6 +62,12 @@ export interface TelegramChannelConfig {
          * @default every sender is enabled
          */
         historyEnabledFor?: (sender: string) => boolean | Promise<boolean>;
+        /**
+         * Summarize-then-truncate compaction — see
+         * `InboundPipelineConfig.history.compaction` in `./channels`.
+         * @default off
+         */
+        compaction?: HistoryCompactionOptions;
     };
     muteRegex?: RegExp;
     unmuteRegex?: RegExp;

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

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

package/dist/channels/telegram/index.js

@@ -393,6 +393,75 @@ ${ctx.join("\n\n")}`
   return { system, messages, context: ctx };
 }
 
+// src/history/compaction.ts
+var DEFAULT_TIMEOUT_MS = 8e3;
+var LOAD_ALL = Number.MAX_SAFE_INTEGER;
+var SUMMARY_PREFIX = "Summary of earlier conversation: ";
+function defaultSummarize(client, model) {
+  return async ({ turns }) => {
+    const transcript = turns.map((turn) => `${turn.role}: ${turn.content}`).join("\n");
+    const { content } = await answerOnce({
+      client,
+      system: "Summarize the conversation turns below into a short paragraph a reader would need to continue the conversation. Preserve names, facts, and decisions; drop pleasantries. Reply with the summary only, no preamble.",
+      messages: [{ role: "user", content: transcript }],
+      // No `answerFn`: compaction is an internal chatter operation, not a
+      // chat surface, so it must not conscript a caller's brain hook, which
+      // is shaped to answer the user, not to summarize on the engine's behalf.
+      mode: "public",
+      model
+    });
+    return content;
+  };
+}
+function createHistoryCompactor(deps, options) {
+  const { threshold, keep, logger } = options;
+  if (!Number.isInteger(threshold) || threshold < 1) {
+    throw new Error(`Invalid history compaction threshold: ${threshold}`);
+  }
+  if (!Number.isInteger(keep) || keep < 0 || keep >= threshold) {
+    throw new Error(`Invalid history compaction keep: ${keep}`);
+  }
+  const summarize = options.summarize ?? defaultSummarize(deps.client, options.model);
+  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  return {
+    async maybeCompact(store, conversationId) {
+      const turns = await store.load(conversationId, LOAD_ALL);
+      if (turns.length < threshold) return;
+      const older = turns.slice(0, turns.length - keep);
+      let summary;
+      let timer;
+      try {
+        summary = await Promise.race([
+          summarize({ conversationId, turns: older }),
+          new Promise((_, reject) => {
+            timer = setTimeout(() => reject(new Error("history compaction timed out")), timeoutMs);
+          })
+        ]);
+      } catch (error) {
+        logger?.error(
+          `history compaction summarize failed for "${conversationId}"; history left untouched`,
+          error
+        );
+        return;
+      } finally {
+        clearTimeout(timer);
+      }
+      const trimmed = summary.trim();
+      if (!trimmed) return;
+      const fresh = await store.load(conversationId, LOAD_ALL);
+      const recent = fresh.slice(older.length);
+      await store.clear(conversationId);
+      await store.append(conversationId, {
+        role: "assistant",
+        content: `${SUMMARY_PREFIX}${trimmed}`
+      });
+      for (const turn of recent) {
+        await store.append(conversationId, turn);
+      }
+    }
+  };
+}
+
 // src/channels/gates.ts
 function matches(re, text) {
   return new RegExp(re.source, re.flags.replace(/[gy]/g, "")).test(text);
@@ -473,6 +542,10 @@ function createInboundPipeline(deps, config) {
   const underGroupRateLimit = createSlidingWindowRateLimiter(group.max, group.windowMs, now);
   const underDmRateLimit = createSlidingWindowRateLimiter(dm.max, dm.windowMs, now);
   const mode = "public";
+  const compactor = config.history?.compaction ? createHistoryCompactor(
+    { client: deps.client },
+    { model: config.model, ...config.history.compaction }
+  ) : void 0;
   return async function handleInboundMessage(msg, turn) {
     const allowedChats = config.allowedChats ?? [];
     const action = decideChannelAction(msg, {
@@ -548,6 +621,14 @@ function createInboundPipeline(deps, config) {
       await config.history?.store.append(conversationId, { role: "assistant", content });
     }
     await turn.reply.sendAnswer(msg.chatId, content);
+    const history = config.history;
+    if (compactor && historyEnabled && history) {
+      try {
+        await compactor.maybeCompact(history.store, conversationId);
+      } catch (error) {
+        config.logger?.error(`history compaction failed for "${conversationId}"`, error);
+      }
+    }
     return { action: "reply", content };
   };
 }

package/dist/channels/telegram/index.mjs

@@ -348,6 +348,75 @@ ${ctx.join("\n\n")}`
   return { system, messages, context: ctx };
 }
 
+// src/history/compaction.ts
+var DEFAULT_TIMEOUT_MS = 8e3;
+var LOAD_ALL = Number.MAX_SAFE_INTEGER;
+var SUMMARY_PREFIX = "Summary of earlier conversation: ";
+function defaultSummarize(client, model) {
+  return async ({ turns }) => {
+    const transcript = turns.map((turn) => `${turn.role}: ${turn.content}`).join("\n");
+    const { content } = await answerOnce({
+      client,
+      system: "Summarize the conversation turns below into a short paragraph a reader would need to continue the conversation. Preserve names, facts, and decisions; drop pleasantries. Reply with the summary only, no preamble.",
+      messages: [{ role: "user", content: transcript }],
+      // No `answerFn`: compaction is an internal chatter operation, not a
+      // chat surface, so it must not conscript a caller's brain hook, which
+      // is shaped to answer the user, not to summarize on the engine's behalf.
+      mode: "public",
+      model
+    });
+    return content;
+  };
+}
+function createHistoryCompactor(deps, options) {
+  const { threshold, keep, logger } = options;
+  if (!Number.isInteger(threshold) || threshold < 1) {
+    throw new Error(`Invalid history compaction threshold: ${threshold}`);
+  }
+  if (!Number.isInteger(keep) || keep < 0 || keep >= threshold) {
+    throw new Error(`Invalid history compaction keep: ${keep}`);
+  }
+  const summarize = options.summarize ?? defaultSummarize(deps.client, options.model);
+  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  return {
+    async maybeCompact(store, conversationId) {
+      const turns = await store.load(conversationId, LOAD_ALL);
+      if (turns.length < threshold) return;
+      const older = turns.slice(0, turns.length - keep);
+      let summary;
+      let timer;
+      try {
+        summary = await Promise.race([
+          summarize({ conversationId, turns: older }),
+          new Promise((_, reject) => {
+            timer = setTimeout(() => reject(new Error("history compaction timed out")), timeoutMs);
+          })
+        ]);
+      } catch (error) {
+        logger?.error(
+          `history compaction summarize failed for "${conversationId}"; history left untouched`,
+          error
+        );
+        return;
+      } finally {
+        clearTimeout(timer);
+      }
+      const trimmed = summary.trim();
+      if (!trimmed) return;
+      const fresh = await store.load(conversationId, LOAD_ALL);
+      const recent = fresh.slice(older.length);
+      await store.clear(conversationId);
+      await store.append(conversationId, {
+        role: "assistant",
+        content: `${SUMMARY_PREFIX}${trimmed}`
+      });
+      for (const turn of recent) {
+        await store.append(conversationId, turn);
+      }
+    }
+  };
+}
+
 // src/channels/gates.ts
 function matches(re, text) {
   return new RegExp(re.source, re.flags.replace(/[gy]/g, "")).test(text);
@@ -428,6 +497,10 @@ function createInboundPipeline(deps, config) {
   const underGroupRateLimit = createSlidingWindowRateLimiter(group.max, group.windowMs, now);
   const underDmRateLimit = createSlidingWindowRateLimiter(dm.max, dm.windowMs, now);
   const mode = "public";
+  const compactor = config.history?.compaction ? createHistoryCompactor(
+    { client: deps.client },
+    { model: config.model, ...config.history.compaction }
+  ) : void 0;
   return async function handleInboundMessage(msg, turn) {
     const allowedChats = config.allowedChats ?? [];
     const action = decideChannelAction(msg, {
@@ -503,6 +576,14 @@ function createInboundPipeline(deps, config) {
       await config.history?.store.append(conversationId, { role: "assistant", content });
     }
     await turn.reply.sendAnswer(msg.chatId, content);
+    const history = config.history;
+    if (compactor && historyEnabled && history) {
+      try {
+        await compactor.maybeCompact(history.store, conversationId);
+      } catch (error) {
+        config.logger?.error(`history compaction failed for "${conversationId}"`, error);
+      }
+    }
     return { action: "reply", content };
   };
 }

package/dist/channels/telegram/webhook.d.ts

@@ -23,6 +23,7 @@ import type { AnswerFn, TransformReply } from "../../core/answer";
 import type { BucketsFor } from "../../core/buckets";
 import { type Logger } from "../../core/logger";
 import type { RerankContext, RewriteQuery } from "../../core/pipeline";
+import type { HistoryCompactionOptions } from "../../history/compaction";
 import type { HistoryStore } from "../../history/types";
 import type { CustomRoutes } from "../../types";
 import { type TelegramApi } from "./api";
@@ -62,6 +63,12 @@ export interface TelegramWebhookConfig {
         /** Most recent turns to load per reply. @default 20 */
         limit?: number;
         historyEnabledFor?: (sender: string) => boolean | Promise<boolean>;
+        /**
+         * Summarize-then-truncate compaction — see
+         * `InboundPipelineConfig.history.compaction` in `./channels`.
+         * @default off
+         */
+        compaction?: HistoryCompactionOptions;
     };
     muteRegex?: RegExp;
     unmuteRegex?: RegExp;

package/dist/channels/telegram/webhook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../../../src/channels/telegram/webhook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAuB,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAqB,KAAK,WAAW,EAAuB,MAAM,OAAO,CAAC;AAMjF,MAAM,WAAW,qBAAqB;IACpC,qFAAqF;IACrF,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8GAA8G;IAC9G,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iHAAiH;IACjH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kIAAkI;IAClI,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4GAA4G;IAC5G,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,KAAK,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACvD,kFAAkF;IAClF,OAAO,CAAC,EAAE;QACR,KAAK,EAAE,YAAY,CAAC;QACpB,uDAAuD;QACvD,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;KACpE,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,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,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,mGAAmG;IACnG,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qJAAqJ;IACrJ,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAeD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,qBAAqB,GAAG,YAAY,CAkHtF"}
+{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../../../src/channels/telegram/webhook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAuB,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAqB,KAAK,WAAW,EAAuB,MAAM,OAAO,CAAC;AAMjF,MAAM,WAAW,qBAAqB;IACpC,qFAAqF;IACrF,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8GAA8G;IAC9G,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iHAAiH;IACjH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kIAAkI;IAClI,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4GAA4G;IAC5G,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,KAAK,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACvD,kFAAkF;IAClF,OAAO,CAAC,EAAE;QACR,KAAK,EAAE,YAAY,CAAC;QACpB,uDAAuD;QACvD,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QACnE;;;;WAIG;QACH,UAAU,CAAC,EAAE,wBAAwB,CAAC;KACvC,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,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,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,mGAAmG;IACnG,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qJAAqJ;IACrJ,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAeD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,qBAAqB,GAAG,YAAY,CAkHtF"}

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

@@ -54,6 +54,7 @@ import { type Logger } from "../../core/logger";
 import type { RerankContext, RewriteQuery } from "../../core/pipeline";
 import type { PromptLoader } from "../../core/prompts";
 import type { VectorStore } from "../../core/retrieval";
+import type { HistoryCompactionOptions } from "../../history/compaction";
 import type { HistoryStore } from "../../history/types";
 import { type ChannelMessage, type SessionIdentityRegistry } from "../gates";
 import type { WhatsAppMessageEvent } from "./channel";
@@ -199,6 +200,12 @@ export interface WhatsAppInboundConfig {
          * @default every sender is enabled
          */
         historyEnabledFor?: (sender: string) => boolean | Promise<boolean>;
+        /**
+         * Summarize-then-truncate compaction — see
+         * `InboundPipelineConfig.history.compaction` in `./channels`.
+         * @default off
+         */
+        compaction?: HistoryCompactionOptions;
     };
     now?: () => number;
     /** Logger for gate/dispatch diagnostics. Default: a console logger writing to stderr. */

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

package/dist/channels/whatsapp/index.js

@@ -840,6 +840,75 @@ ${ctx.join("\n\n")}`
   return { system, messages, context: ctx };
 }
 
+// src/history/compaction.ts
+var DEFAULT_TIMEOUT_MS = 8e3;
+var LOAD_ALL = Number.MAX_SAFE_INTEGER;
+var SUMMARY_PREFIX = "Summary of earlier conversation: ";
+function defaultSummarize(client, model) {
+  return async ({ turns }) => {
+    const transcript = turns.map((turn) => `${turn.role}: ${turn.content}`).join("\n");
+    const { content } = await answerOnce({
+      client,
+      system: "Summarize the conversation turns below into a short paragraph a reader would need to continue the conversation. Preserve names, facts, and decisions; drop pleasantries. Reply with the summary only, no preamble.",
+      messages: [{ role: "user", content: transcript }],
+      // No `answerFn`: compaction is an internal chatter operation, not a
+      // chat surface, so it must not conscript a caller's brain hook, which
+      // is shaped to answer the user, not to summarize on the engine's behalf.
+      mode: "public",
+      model
+    });
+    return content;
+  };
+}
+function createHistoryCompactor(deps, options) {
+  const { threshold, keep, logger } = options;
+  if (!Number.isInteger(threshold) || threshold < 1) {
+    throw new Error(`Invalid history compaction threshold: ${threshold}`);
+  }
+  if (!Number.isInteger(keep) || keep < 0 || keep >= threshold) {
+    throw new Error(`Invalid history compaction keep: ${keep}`);
+  }
+  const summarize = options.summarize ?? defaultSummarize(deps.client, options.model);
+  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  return {
+    async maybeCompact(store, conversationId) {
+      const turns = await store.load(conversationId, LOAD_ALL);
+      if (turns.length < threshold) return;
+      const older = turns.slice(0, turns.length - keep);
+      let summary;
+      let timer;
+      try {
+        summary = await Promise.race([
+          summarize({ conversationId, turns: older }),
+          new Promise((_, reject) => {
+            timer = setTimeout(() => reject(new Error("history compaction timed out")), timeoutMs);
+          })
+        ]);
+      } catch (error) {
+        logger?.error(
+          `history compaction summarize failed for "${conversationId}"; history left untouched`,
+          error
+        );
+        return;
+      } finally {
+        clearTimeout(timer);
+      }
+      const trimmed = summary.trim();
+      if (!trimmed) return;
+      const fresh = await store.load(conversationId, LOAD_ALL);
+      const recent = fresh.slice(older.length);
+      await store.clear(conversationId);
+      await store.append(conversationId, {
+        role: "assistant",
+        content: `${SUMMARY_PREFIX}${trimmed}`
+      });
+      for (const turn of recent) {
+        await store.append(conversationId, turn);
+      }
+    }
+  };
+}
+
 // src/channels/pipeline.ts
 var DEFAULT_HISTORY_LIMIT = 20;
 var DEFAULT_GROUP_RATE_LIMIT = { max: 30, windowMs: 60 * 60 * 1e3 };
@@ -870,6 +939,10 @@ function createInboundPipeline(deps, config) {
   const underGroupRateLimit = createSlidingWindowRateLimiter(group.max, group.windowMs, now);
   const underDmRateLimit = createSlidingWindowRateLimiter(dm.max, dm.windowMs, now);
   const mode = "public";
+  const compactor = config.history?.compaction ? createHistoryCompactor(
+    { client: deps.client },
+    { model: config.model, ...config.history.compaction }
+  ) : void 0;
   return async function handleInboundMessage(msg, turn) {
     const allowedChats = config.allowedChats ?? [];
     const action = decideChannelAction(msg, {
@@ -945,6 +1018,14 @@ function createInboundPipeline(deps, config) {
       await config.history?.store.append(conversationId, { role: "assistant", content });
     }
     await turn.reply.sendAnswer(msg.chatId, content);
+    const history = config.history;
+    if (compactor && historyEnabled && history) {
+      try {
+        await compactor.maybeCompact(history.store, conversationId);
+      } catch (error) {
+        config.logger?.error(`history compaction failed for "${conversationId}"`, error);
+      }
+    }
     return { action: "reply", content };
   };
 }

package/dist/channels/whatsapp/index.mjs

@@ -778,6 +778,75 @@ ${ctx.join("\n\n")}`
   return { system, messages, context: ctx };
 }
 
+// src/history/compaction.ts
+var DEFAULT_TIMEOUT_MS = 8e3;
+var LOAD_ALL = Number.MAX_SAFE_INTEGER;
+var SUMMARY_PREFIX = "Summary of earlier conversation: ";
+function defaultSummarize(client, model) {
+  return async ({ turns }) => {
+    const transcript = turns.map((turn) => `${turn.role}: ${turn.content}`).join("\n");
+    const { content } = await answerOnce({
+      client,
+      system: "Summarize the conversation turns below into a short paragraph a reader would need to continue the conversation. Preserve names, facts, and decisions; drop pleasantries. Reply with the summary only, no preamble.",
+      messages: [{ role: "user", content: transcript }],
+      // No `answerFn`: compaction is an internal chatter operation, not a
+      // chat surface, so it must not conscript a caller's brain hook, which
+      // is shaped to answer the user, not to summarize on the engine's behalf.
+      mode: "public",
+      model
+    });
+    return content;
+  };
+}
+function createHistoryCompactor(deps, options) {
+  const { threshold, keep, logger } = options;
+  if (!Number.isInteger(threshold) || threshold < 1) {
+    throw new Error(`Invalid history compaction threshold: ${threshold}`);
+  }
+  if (!Number.isInteger(keep) || keep < 0 || keep >= threshold) {
+    throw new Error(`Invalid history compaction keep: ${keep}`);
+  }
+  const summarize = options.summarize ?? defaultSummarize(deps.client, options.model);
+  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  return {
+    async maybeCompact(store, conversationId) {
+      const turns = await store.load(conversationId, LOAD_ALL);
+      if (turns.length < threshold) return;
+      const older = turns.slice(0, turns.length - keep);
+      let summary;
+      let timer;
+      try {
+        summary = await Promise.race([
+          summarize({ conversationId, turns: older }),
+          new Promise((_, reject) => {
+            timer = setTimeout(() => reject(new Error("history compaction timed out")), timeoutMs);
+          })
+        ]);
+      } catch (error) {
+        logger?.error(
+          `history compaction summarize failed for "${conversationId}"; history left untouched`,
+          error
+        );
+        return;
+      } finally {
+        clearTimeout(timer);
+      }
+      const trimmed = summary.trim();
+      if (!trimmed) return;
+      const fresh = await store.load(conversationId, LOAD_ALL);
+      const recent = fresh.slice(older.length);
+      await store.clear(conversationId);
+      await store.append(conversationId, {
+        role: "assistant",
+        content: `${SUMMARY_PREFIX}${trimmed}`
+      });
+      for (const turn of recent) {
+        await store.append(conversationId, turn);
+      }
+    }
+  };
+}
+
 // src/channels/pipeline.ts
 var DEFAULT_HISTORY_LIMIT = 20;
 var DEFAULT_GROUP_RATE_LIMIT = { max: 30, windowMs: 60 * 60 * 1e3 };
@@ -808,6 +877,10 @@ function createInboundPipeline(deps, config) {
   const underGroupRateLimit = createSlidingWindowRateLimiter(group.max, group.windowMs, now);
   const underDmRateLimit = createSlidingWindowRateLimiter(dm.max, dm.windowMs, now);
   const mode = "public";
+  const compactor = config.history?.compaction ? createHistoryCompactor(
+    { client: deps.client },
+    { model: config.model, ...config.history.compaction }
+  ) : void 0;
   return async function handleInboundMessage(msg, turn) {
     const allowedChats = config.allowedChats ?? [];
     const action = decideChannelAction(msg, {
@@ -883,6 +956,14 @@ function createInboundPipeline(deps, config) {
       await config.history?.store.append(conversationId, { role: "assistant", content });
     }
     await turn.reply.sendAnswer(msg.chatId, content);
+    const history = config.history;
+    if (compactor && historyEnabled && history) {
+      try {
+        await compactor.maybeCompact(history.store, conversationId);
+      } catch (error) {
+        config.logger?.error(`history compaction failed for "${conversationId}"`, error);
+      }
+    }
     return { action: "reply", content };
   };
 }

package/dist/history/compaction.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Summarize-then-truncate compaction for `HistoryStore` — folds older turns
+ * into a single stored summary row once a conversation's window grows past a
+ * threshold, so a long-running conversation's prompt doesn't grow without
+ * bound. Off by default; a caller wires `maybeCompact` in right after its own
+ * `store.append` call, the same way `./index`'s docs describe wiring the
+ * store itself.
+ *
+ * The summarize step races a timeout the same way `../images/captionComposer`
+ * races its compose step, except the safe fallback here is "leave history
+ * untouched" rather than a template pool — a stuck or failing summarize call
+ * must never lose turns nobody got to read back.
+ */
+import type OpenAI from "openai";
+import type { Logger } from "../core/logger";
+import type { HistoryMessage, HistoryStore } from "./types";
+/** What a summarize step receives: the turns being folded away, oldest first. Never includes the turns `keep` retains verbatim. */
+export interface SummarizeRequest {
+    conversationId: string;
+    turns: HistoryMessage[];
+}
+/** Best-effort compaction step, typically an LLM call. */
+export type SummarizeFn = (request: SummarizeRequest) => Promise<string>;
+export interface HistoryCompactionOptions {
+    /** Turn count that triggers compaction. */
+    threshold: number;
+    /** Most recent turns kept verbatim after compaction; everything older is folded into the summary. Must be less than `threshold`. */
+    keep: number;
+    /**
+     * Best-effort summarize step. Defaults to `answerOnce` with a neutral
+     * prompt and no `answerFn` (so it always uses the built-in completion,
+     * never a caller's brain hook) — set this to route summarization through a
+     * caller's own `answerFn`, a cheaper model, or a non-LLM summarizer.
+     */
+    summarize?: SummarizeFn;
+    /** Model for the default `summarize` step. Ignored when `summarize` is supplied. Falls back to `answerOnce`'s own default model when unset. */
+    model?: string;
+    /** Milliseconds before `summarize` is abandoned in favour of leaving history untouched for this turn. @default 8000 */
+    timeoutMs?: number;
+    logger?: Pick<Logger, "error">;
+}
+export interface HistoryCompactor {
+    /**
+     * Compacts `conversationId` if its stored turn count has reached
+     * `threshold`. A no-op below threshold. A failed or timed-out `summarize`
+     * leaves the store exactly as it was and does not throw; a failure in the
+     * store itself (`load`/`clear`/`append`) propagates like any other store
+     * failure.
+     */
+    maybeCompact(store: HistoryStore, conversationId: string): Promise<void>;
+}
+/** Marks a stored row as a compaction summary rather than a real turn — informational only, nothing parses it back out. */
+export declare const SUMMARY_PREFIX = "Summary of earlier conversation: ";
+/**
+ * `deps.client` builds the default `summarize` step; unused when a caller
+ * supplies its own.
+ */
+export declare function createHistoryCompactor(deps: {
+    client: OpenAI;
+}, options: HistoryCompactionOptions): HistoryCompactor;
+//# sourceMappingURL=compaction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../src/history/compaction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAEjC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5D,mIAAmI;AACnI,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED,0DAA0D;AAC1D,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAEzE,MAAM,WAAW,wBAAwB;IACvC,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,oIAAoI;IACpI,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,+IAA+I;IAC/I,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uHAAuH;IACvH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;;;;OAMG;IACH,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1E;AAWD,2HAA2H;AAC3H,eAAO,MAAM,cAAc,sCAAsC,CAAC;AAoBlE;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,EACxB,OAAO,EAAE,wBAAwB,GAChC,gBAAgB,CAgElB"}

package/dist/history/index.d.ts

@@ -10,8 +10,15 @@
  * implement it. The shipped Turso implementation needs `@libsql/client`,
  * which chatter already expects for retrieval.
  *
+ * `./compaction` is an optional layer on top: summarize-then-truncate for a
+ * conversation whose window has grown past a threshold, built entirely on
+ * the store's own `load`/`clear`/`append` so it works with any
+ * `HistoryStore`, not just the Turso one.
+ *
  * @packageDocumentation
  */
+export type { HistoryCompactionOptions, HistoryCompactor, SummarizeFn, SummarizeRequest, } from "./compaction";
+export { createHistoryCompactor, SUMMARY_PREFIX } from "./compaction";
 export type { TursoHistoryStoreOptions } from "./tursoStore";
 export { createTursoHistoryStore } from "./tursoStore";
 export type { HistoryMessage, HistoryStore } from "./types";

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,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/history/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,YAAY,EACV,wBAAwB,EACxB,gBAAgB,EAChB,WAAW,EACX,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACtE,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

@@ -20,10 +20,151 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/history/index.ts
 var index_exports = {};
 __export(index_exports, {
+  SUMMARY_PREFIX: () => SUMMARY_PREFIX,
+  createHistoryCompactor: () => createHistoryCompactor,
   createTursoHistoryStore: () => createTursoHistoryStore
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/core/guardrails.ts
+function detectLeakage(text) {
+  const flags = [
+    /system prompt/i,
+    /hidden instruction/i,
+    /here (are|is) (my|the) rules/i,
+    /BEGIN SYSTEM PROMPT/i,
+    /tool instructions/i
+  ];
+  return flags.some((rx) => rx.test(text));
+}
+function scrubOutput(text) {
+  return text.replace(/sk-[A-Za-z0-9]{15,}/g, "[REDACTED]").replace(/AIza[0-9A-Za-z_-]{30,}/g, "[REDACTED]");
+}
+function guardOutput(text) {
+  if (detectLeakage(text)) {
+    return "Sorry, I can't share internal instructions. How else can I help?";
+  }
+  return scrubOutput(text);
+}
+
+// src/core/llm.ts
+var DEFAULT_MODEL = "gpt-4o";
+async function completeOnce({
+  client,
+  system,
+  messages,
+  temperature = 0.2,
+  model = DEFAULT_MODEL
+}) {
+  const res = await client.chat.completions.create({
+    model,
+    temperature,
+    messages: [{ role: "system", content: system }, ...messages]
+  });
+  const text = res.choices[0]?.message?.content ?? "";
+  return {
+    content: guardOutput(text),
+    usage: res.usage || { prompt_tokens: 0, completion_tokens: 0, total_tokens: 0 }
+  };
+}
+
+// src/core/answer.ts
+var noUsage = () => ({ prompt_tokens: 0, completion_tokens: 0, total_tokens: 0 });
+async function runAnswerFn(answerFn, { system, messages, mode, sender, conversationId }) {
+  const result = await answerFn({ system, messages, mode, sender, conversationId });
+  const raw = typeof result === "string" ? result : result?.content;
+  const usage = typeof result === "string" ? void 0 : result?.usage;
+  return {
+    content: guardOutput(typeof raw === "string" ? raw : ""),
+    usage: usage ?? noUsage()
+  };
+}
+async function answerOnce({
+  answerFn,
+  client,
+  system,
+  messages,
+  mode,
+  sender,
+  conversationId,
+  temperature,
+  model
+}) {
+  if (answerFn) {
+    return runAnswerFn(answerFn, { system, messages, mode, sender, conversationId });
+  }
+  return completeOnce({ client, system, messages, temperature, model });
+}
+
+// src/history/compaction.ts
+var DEFAULT_TIMEOUT_MS = 8e3;
+var LOAD_ALL = Number.MAX_SAFE_INTEGER;
+var SUMMARY_PREFIX = "Summary of earlier conversation: ";
+function defaultSummarize(client, model) {
+  return async ({ turns }) => {
+    const transcript = turns.map((turn) => `${turn.role}: ${turn.content}`).join("\n");
+    const { content } = await answerOnce({
+      client,
+      system: "Summarize the conversation turns below into a short paragraph a reader would need to continue the conversation. Preserve names, facts, and decisions; drop pleasantries. Reply with the summary only, no preamble.",
+      messages: [{ role: "user", content: transcript }],
+      // No `answerFn`: compaction is an internal chatter operation, not a
+      // chat surface, so it must not conscript a caller's brain hook, which
+      // is shaped to answer the user, not to summarize on the engine's behalf.
+      mode: "public",
+      model
+    });
+    return content;
+  };
+}
+function createHistoryCompactor(deps, options) {
+  const { threshold, keep, logger } = options;
+  if (!Number.isInteger(threshold) || threshold < 1) {
+    throw new Error(`Invalid history compaction threshold: ${threshold}`);
+  }
+  if (!Number.isInteger(keep) || keep < 0 || keep >= threshold) {
+    throw new Error(`Invalid history compaction keep: ${keep}`);
+  }
+  const summarize = options.summarize ?? defaultSummarize(deps.client, options.model);
+  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  return {
+    async maybeCompact(store, conversationId) {
+      const turns = await store.load(conversationId, LOAD_ALL);
+      if (turns.length < threshold) return;
+      const older = turns.slice(0, turns.length - keep);
+      let summary;
+      let timer;
+      try {
+        summary = await Promise.race([
+          summarize({ conversationId, turns: older }),
+          new Promise((_, reject) => {
+            timer = setTimeout(() => reject(new Error("history compaction timed out")), timeoutMs);
+          })
+        ]);
+      } catch (error) {
+        logger?.error(
+          `history compaction summarize failed for "${conversationId}"; history left untouched`,
+          error
+        );
+        return;
+      } finally {
+        clearTimeout(timer);
+      }
+      const trimmed = summary.trim();
+      if (!trimmed) return;
+      const fresh = await store.load(conversationId, LOAD_ALL);
+      const recent = fresh.slice(older.length);
+      await store.clear(conversationId);
+      await store.append(conversationId, {
+        role: "assistant",
+        content: `${SUMMARY_PREFIX}${trimmed}`
+      });
+      for (const turn of recent) {
+        await store.append(conversationId, turn);
+      }
+    }
+  };
+}
+
 // src/history/tursoStore.ts
 var schemaReady = /* @__PURE__ */ new WeakMap();
 function ensureHistorySchema(client, tableName) {
@@ -117,5 +258,7 @@ function createTursoHistoryStore(client, tableName = "chat_history", maxPerConve
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  SUMMARY_PREFIX,
+  createHistoryCompactor,
   createTursoHistoryStore
 });

package/dist/history/index.mjs

@@ -1,3 +1,142 @@
+// src/core/guardrails.ts
+function detectLeakage(text) {
+  const flags = [
+    /system prompt/i,
+    /hidden instruction/i,
+    /here (are|is) (my|the) rules/i,
+    /BEGIN SYSTEM PROMPT/i,
+    /tool instructions/i
+  ];
+  return flags.some((rx) => rx.test(text));
+}
+function scrubOutput(text) {
+  return text.replace(/sk-[A-Za-z0-9]{15,}/g, "[REDACTED]").replace(/AIza[0-9A-Za-z_-]{30,}/g, "[REDACTED]");
+}
+function guardOutput(text) {
+  if (detectLeakage(text)) {
+    return "Sorry, I can't share internal instructions. How else can I help?";
+  }
+  return scrubOutput(text);
+}
+
+// src/core/llm.ts
+var DEFAULT_MODEL = "gpt-4o";
+async function completeOnce({
+  client,
+  system,
+  messages,
+  temperature = 0.2,
+  model = DEFAULT_MODEL
+}) {
+  const res = await client.chat.completions.create({
+    model,
+    temperature,
+    messages: [{ role: "system", content: system }, ...messages]
+  });
+  const text = res.choices[0]?.message?.content ?? "";
+  return {
+    content: guardOutput(text),
+    usage: res.usage || { prompt_tokens: 0, completion_tokens: 0, total_tokens: 0 }
+  };
+}
+
+// src/core/answer.ts
+var noUsage = () => ({ prompt_tokens: 0, completion_tokens: 0, total_tokens: 0 });
+async function runAnswerFn(answerFn, { system, messages, mode, sender, conversationId }) {
+  const result = await answerFn({ system, messages, mode, sender, conversationId });
+  const raw = typeof result === "string" ? result : result?.content;
+  const usage = typeof result === "string" ? void 0 : result?.usage;
+  return {
+    content: guardOutput(typeof raw === "string" ? raw : ""),
+    usage: usage ?? noUsage()
+  };
+}
+async function answerOnce({
+  answerFn,
+  client,
+  system,
+  messages,
+  mode,
+  sender,
+  conversationId,
+  temperature,
+  model
+}) {
+  if (answerFn) {
+    return runAnswerFn(answerFn, { system, messages, mode, sender, conversationId });
+  }
+  return completeOnce({ client, system, messages, temperature, model });
+}
+
+// src/history/compaction.ts
+var DEFAULT_TIMEOUT_MS = 8e3;
+var LOAD_ALL = Number.MAX_SAFE_INTEGER;
+var SUMMARY_PREFIX = "Summary of earlier conversation: ";
+function defaultSummarize(client, model) {
+  return async ({ turns }) => {
+    const transcript = turns.map((turn) => `${turn.role}: ${turn.content}`).join("\n");
+    const { content } = await answerOnce({
+      client,
+      system: "Summarize the conversation turns below into a short paragraph a reader would need to continue the conversation. Preserve names, facts, and decisions; drop pleasantries. Reply with the summary only, no preamble.",
+      messages: [{ role: "user", content: transcript }],
+      // No `answerFn`: compaction is an internal chatter operation, not a
+      // chat surface, so it must not conscript a caller's brain hook, which
+      // is shaped to answer the user, not to summarize on the engine's behalf.
+      mode: "public",
+      model
+    });
+    return content;
+  };
+}
+function createHistoryCompactor(deps, options) {
+  const { threshold, keep, logger } = options;
+  if (!Number.isInteger(threshold) || threshold < 1) {
+    throw new Error(`Invalid history compaction threshold: ${threshold}`);
+  }
+  if (!Number.isInteger(keep) || keep < 0 || keep >= threshold) {
+    throw new Error(`Invalid history compaction keep: ${keep}`);
+  }
+  const summarize = options.summarize ?? defaultSummarize(deps.client, options.model);
+  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  return {
+    async maybeCompact(store, conversationId) {
+      const turns = await store.load(conversationId, LOAD_ALL);
+      if (turns.length < threshold) return;
+      const older = turns.slice(0, turns.length - keep);
+      let summary;
+      let timer;
+      try {
+        summary = await Promise.race([
+          summarize({ conversationId, turns: older }),
+          new Promise((_, reject) => {
+            timer = setTimeout(() => reject(new Error("history compaction timed out")), timeoutMs);
+          })
+        ]);
+      } catch (error) {
+        logger?.error(
+          `history compaction summarize failed for "${conversationId}"; history left untouched`,
+          error
+        );
+        return;
+      } finally {
+        clearTimeout(timer);
+      }
+      const trimmed = summary.trim();
+      if (!trimmed) return;
+      const fresh = await store.load(conversationId, LOAD_ALL);
+      const recent = fresh.slice(older.length);
+      await store.clear(conversationId);
+      await store.append(conversationId, {
+        role: "assistant",
+        content: `${SUMMARY_PREFIX}${trimmed}`
+      });
+      for (const turn of recent) {
+        await store.append(conversationId, turn);
+      }
+    }
+  };
+}
+
 // src/history/tursoStore.ts
 var schemaReady = /* @__PURE__ */ new WeakMap();
 function ensureHistorySchema(client, tableName) {
@@ -90,5 +229,7 @@ function createTursoHistoryStore(client, tableName = "chat_history", maxPerConve
   };
 }
 export {
+  SUMMARY_PREFIX,
+  createHistoryCompactor,
   createTursoHistoryStore
 };

package/package.json

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