@dexto/core 1.3.0 → 1.5.0

package/dist/context/compaction/strategies/reactive-overflow.cjs

@@ -0,0 +1,201 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var reactive_overflow_exports = {};
+__export(reactive_overflow_exports, {
+  ReactiveOverflowStrategy: () => ReactiveOverflowStrategy
+});
+module.exports = __toCommonJS(reactive_overflow_exports);
+var import_ai = require("ai");
+var import_types = require("../../types.js");
+const DEFAULT_OPTIONS = {
+  preserveLastNTurns: 2,
+  maxSummaryTokens: 2e3,
+  summaryPrompt: `You are a conversation summarizer. Summarize the following conversation history concisely, focusing on:
+- What tasks were attempted and their outcomes
+- Current state and context the assistant needs to remember
+- Any important decisions or information discovered
+- What the user was trying to accomplish
+
+Be concise but preserve essential context. Output only the summary, no preamble.
+
+Conversation:
+{conversation}`
+};
+class ReactiveOverflowStrategy {
+  name = "reactive-overflow";
+  model;
+  options;
+  logger;
+  constructor(model, options = {}, logger) {
+    this.model = model;
+    this.options = { ...DEFAULT_OPTIONS, ...options };
+    this.logger = logger;
+  }
+  /**
+   * Generate a summary message for the old portion of history.
+   *
+   * IMPORTANT: This does NOT replace history. It returns a summary message
+   * that the caller should ADD to history via contextManager.addMessage().
+   * Read-time filtering (filterCompacted) will then exclude pre-summary
+   * messages when formatting for LLM.
+   *
+   * @param history The full conversation history
+   * @returns Array with single summary message to add, or empty if nothing to summarize
+   */
+  async compact(history) {
+    if (history.length <= 2) {
+      this.logger.debug("ReactiveOverflowStrategy: History too short, skipping compaction");
+      return [];
+    }
+    const { toSummarize, toKeep } = this.splitHistory(history);
+    if (toSummarize.length === 0) {
+      this.logger.debug("ReactiveOverflowStrategy: No messages to summarize");
+      return [];
+    }
+    this.logger.info(
+      `ReactiveOverflowStrategy: Summarizing ${toSummarize.length} messages, keeping ${toKeep.length}`
+    );
+    const summary = await this.generateSummary(toSummarize);
+    const summaryMessage = {
+      role: "assistant",
+      content: [{ type: "text", text: summary }],
+      timestamp: Date.now(),
+      metadata: {
+        isSummary: true,
+        summarizedAt: Date.now(),
+        summarizedMessageCount: toSummarize.length,
+        originalFirstTimestamp: toSummarize[0]?.timestamp,
+        originalLastTimestamp: toSummarize[toSummarize.length - 1]?.timestamp
+      }
+    };
+    return [summaryMessage];
+  }
+  /**
+   * Split history into messages to summarize and messages to keep.
+   * Keeps the last N turns (user + assistant pairs) intact.
+   */
+  splitHistory(history) {
+    const turnsToKeep = this.options.preserveLastNTurns;
+    const userMessageIndices = [];
+    for (let i = history.length - 1; i >= 0; i--) {
+      if (history[i]?.role === "user") {
+        userMessageIndices.unshift(i);
+        if (userMessageIndices.length >= turnsToKeep) {
+          break;
+        }
+      }
+    }
+    if (userMessageIndices.length > 0) {
+      const splitIndex = userMessageIndices[0];
+      if (splitIndex !== void 0) {
+        if (splitIndex === 0) {
+          return {
+            toSummarize: [],
+            toKeep: history
+          };
+        }
+        return {
+          toSummarize: history.slice(0, splitIndex),
+          toKeep: history.slice(splitIndex)
+        };
+      }
+    }
+    const keepCount = Math.min(4, history.length);
+    return {
+      toSummarize: history.slice(0, -keepCount),
+      toKeep: history.slice(-keepCount)
+    };
+  }
+  /**
+   * Generate an LLM summary of the messages.
+   */
+  async generateSummary(messages) {
+    const formattedConversation = this.formatMessagesForSummary(messages);
+    const prompt = this.options.summaryPrompt.replace("{conversation}", formattedConversation);
+    try {
+      const result = await (0, import_ai.generateText)({
+        model: this.model,
+        prompt,
+        maxOutputTokens: this.options.maxSummaryTokens
+      });
+      return `[Previous conversation summary]
+${result.text}`;
+    } catch (error) {
+      this.logger.error("ReactiveOverflowStrategy: Failed to generate summary", { error });
+      return this.createFallbackSummary(messages);
+    }
+  }
+  /**
+   * Format messages for the summary prompt.
+   */
+  formatMessagesForSummary(messages) {
+    return messages.map((msg) => {
+      const role = msg.role.toUpperCase();
+      let content;
+      if (typeof msg.content === "string") {
+        content = msg.content;
+      } else if (Array.isArray(msg.content)) {
+        content = msg.content.filter(
+          (part) => part.type === "text"
+        ).map((part) => part.text).join("\n");
+      } else {
+        content = "[no content]";
+      }
+      if (content.length > 2e3) {
+        content = content.slice(0, 2e3) + "... [truncated]";
+      }
+      if ((0, import_types.isAssistantMessage)(msg) && msg.toolCalls && msg.toolCalls.length > 0) {
+        const toolNames = msg.toolCalls.map((tc) => tc.function.name).join(", ");
+        content += `
+[Used tools: ${toolNames}]`;
+      }
+      if ((0, import_types.isToolMessage)(msg)) {
+        return `TOOL (${msg.name}): ${content.slice(0, 500)}${content.length > 500 ? "..." : ""}`;
+      }
+      return `${role}: ${content}`;
+    }).join("\n\n");
+  }
+  /**
+   * Create a fallback summary if LLM call fails.
+   */
+  createFallbackSummary(messages) {
+    const userMessages = messages.filter((m) => m.role === "user");
+    const assistantWithTools = messages.filter(
+      (m) => (0, import_types.isAssistantMessage)(m) && !!m.toolCalls && m.toolCalls.length > 0
+    );
+    const userTopics = userMessages.slice(-3).map((m) => {
+      const text = typeof m.content === "string" ? m.content : Array.isArray(m.content) ? m.content.filter(
+        (p) => p.type === "text"
+      ).map((p) => p.text).join(" ") : "";
+      return text.slice(0, 100);
+    }).join("; ");
+    const toolsUsed = [
+      ...new Set(
+        assistantWithTools.flatMap((m) => m.toolCalls.map((tc) => tc.function.name))
+      )
+    ].join(", ");
+    return `[Previous conversation summary - fallback]
+User discussed: ${userTopics || "various topics"}
+Tools used: ${toolsUsed || "none"}`;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ReactiveOverflowStrategy
+});

package/dist/context/compaction/strategies/reactive-overflow.d.ts

@@ -0,0 +1,81 @@
+import { type LanguageModel } from 'ai';
+import type { ICompactionStrategy } from '../types.js';
+import type { InternalMessage } from '../../types.js';
+import type { IDextoLogger } from '../../../logger/v2/types.js';
+/**
+ * Configuration options for ReactiveOverflowStrategy.
+ */
+export interface ReactiveOverflowOptions {
+    /**
+     * Number of recent turns to preserve (not summarize).
+     * A "turn" is a user message + assistant response pair.
+     * Default: 2
+     */
+    preserveLastNTurns?: number;
+    /**
+     * Maximum tokens for the summary output.
+     * Default: 2000
+     */
+    maxSummaryTokens?: number;
+    /**
+     * Custom summary prompt template.
+     * Use {conversation} as placeholder for formatted messages.
+     */
+    summaryPrompt?: string;
+}
+/**
+ * ReactiveOverflowStrategy implements reactive compaction.
+ *
+ * Key behaviors:
+ * - Triggers on overflow (after actual tokens exceed context limit)
+ * - Uses LLM to generate intelligent summary of older messages
+ * - Returns summary message to ADD to history (not replace)
+ * - Read-time filtering via filterCompacted() excludes pre-summary messages
+ *
+ * This strategy is designed to work with TurnExecutor's main loop:
+ * 1. After each step, check if overflow occurred
+ * 2. If yes, generate summary and ADD it to history
+ * 3. filterCompacted() in getFormattedMessages() excludes old messages
+ * 4. Continue with fresh context (summary + recent messages)
+ *
+ * NOTE: This does NOT replace history. The summary message is ADDED,
+ * and filterCompacted() handles excluding old messages at read-time.
+ * This preserves full history for audit/recovery purposes.
+ */
+export declare class ReactiveOverflowStrategy implements ICompactionStrategy {
+    readonly name = "reactive-overflow";
+    private readonly model;
+    private readonly options;
+    private readonly logger;
+    constructor(model: LanguageModel, options: ReactiveOverflowOptions | undefined, logger: IDextoLogger);
+    /**
+     * Generate a summary message for the old portion of history.
+     *
+     * IMPORTANT: This does NOT replace history. It returns a summary message
+     * that the caller should ADD to history via contextManager.addMessage().
+     * Read-time filtering (filterCompacted) will then exclude pre-summary
+     * messages when formatting for LLM.
+     *
+     * @param history The full conversation history
+     * @returns Array with single summary message to add, or empty if nothing to summarize
+     */
+    compact(history: readonly InternalMessage[]): Promise<InternalMessage[]>;
+    /**
+     * Split history into messages to summarize and messages to keep.
+     * Keeps the last N turns (user + assistant pairs) intact.
+     */
+    private splitHistory;
+    /**
+     * Generate an LLM summary of the messages.
+     */
+    private generateSummary;
+    /**
+     * Format messages for the summary prompt.
+     */
+    private formatMessagesForSummary;
+    /**
+     * Create a fallback summary if LLM call fails.
+     */
+    private createFallbackSummary;
+}
+//# sourceMappingURL=reactive-overflow.d.ts.map

package/dist/context/compaction/strategies/reactive-overflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactive-overflow.d.ts","sourceRoot":"","sources":["../../../../src/context/compaction/strategies/reactive-overflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,IAAI,CAAC;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAY,MAAM,gBAAgB,CAAC;AAEhE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACpC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAiBD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,wBAAyB,YAAW,mBAAmB;IAChE,QAAQ,CAAC,IAAI,uBAAuB;IAEpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAC5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAE1B,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,uBAAuB,YAAK,EAAE,MAAM,EAAE,YAAY;IAM7F;;;;;;;;;;OAUG;IACG,OAAO,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IA0C9E;;;OAGG;IACH,OAAO,CAAC,YAAY;IA2CpB;;OAEG;YACW,eAAe;IAmB7B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA2ChC;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAiChC"}

package/dist/context/compaction/strategies/reactive-overflow.js

@@ -0,0 +1,178 @@
+import "../../../chunk-PTJYTZNU.js";
+import { generateText } from "ai";
+import { isAssistantMessage, isToolMessage } from "../../types.js";
+const DEFAULT_OPTIONS = {
+  preserveLastNTurns: 2,
+  maxSummaryTokens: 2e3,
+  summaryPrompt: `You are a conversation summarizer. Summarize the following conversation history concisely, focusing on:
+- What tasks were attempted and their outcomes
+- Current state and context the assistant needs to remember
+- Any important decisions or information discovered
+- What the user was trying to accomplish
+
+Be concise but preserve essential context. Output only the summary, no preamble.
+
+Conversation:
+{conversation}`
+};
+class ReactiveOverflowStrategy {
+  name = "reactive-overflow";
+  model;
+  options;
+  logger;
+  constructor(model, options = {}, logger) {
+    this.model = model;
+    this.options = { ...DEFAULT_OPTIONS, ...options };
+    this.logger = logger;
+  }
+  /**
+   * Generate a summary message for the old portion of history.
+   *
+   * IMPORTANT: This does NOT replace history. It returns a summary message
+   * that the caller should ADD to history via contextManager.addMessage().
+   * Read-time filtering (filterCompacted) will then exclude pre-summary
+   * messages when formatting for LLM.
+   *
+   * @param history The full conversation history
+   * @returns Array with single summary message to add, or empty if nothing to summarize
+   */
+  async compact(history) {
+    if (history.length <= 2) {
+      this.logger.debug("ReactiveOverflowStrategy: History too short, skipping compaction");
+      return [];
+    }
+    const { toSummarize, toKeep } = this.splitHistory(history);
+    if (toSummarize.length === 0) {
+      this.logger.debug("ReactiveOverflowStrategy: No messages to summarize");
+      return [];
+    }
+    this.logger.info(
+      `ReactiveOverflowStrategy: Summarizing ${toSummarize.length} messages, keeping ${toKeep.length}`
+    );
+    const summary = await this.generateSummary(toSummarize);
+    const summaryMessage = {
+      role: "assistant",
+      content: [{ type: "text", text: summary }],
+      timestamp: Date.now(),
+      metadata: {
+        isSummary: true,
+        summarizedAt: Date.now(),
+        summarizedMessageCount: toSummarize.length,
+        originalFirstTimestamp: toSummarize[0]?.timestamp,
+        originalLastTimestamp: toSummarize[toSummarize.length - 1]?.timestamp
+      }
+    };
+    return [summaryMessage];
+  }
+  /**
+   * Split history into messages to summarize and messages to keep.
+   * Keeps the last N turns (user + assistant pairs) intact.
+   */
+  splitHistory(history) {
+    const turnsToKeep = this.options.preserveLastNTurns;
+    const userMessageIndices = [];
+    for (let i = history.length - 1; i >= 0; i--) {
+      if (history[i]?.role === "user") {
+        userMessageIndices.unshift(i);
+        if (userMessageIndices.length >= turnsToKeep) {
+          break;
+        }
+      }
+    }
+    if (userMessageIndices.length > 0) {
+      const splitIndex = userMessageIndices[0];
+      if (splitIndex !== void 0) {
+        if (splitIndex === 0) {
+          return {
+            toSummarize: [],
+            toKeep: history
+          };
+        }
+        return {
+          toSummarize: history.slice(0, splitIndex),
+          toKeep: history.slice(splitIndex)
+        };
+      }
+    }
+    const keepCount = Math.min(4, history.length);
+    return {
+      toSummarize: history.slice(0, -keepCount),
+      toKeep: history.slice(-keepCount)
+    };
+  }
+  /**
+   * Generate an LLM summary of the messages.
+   */
+  async generateSummary(messages) {
+    const formattedConversation = this.formatMessagesForSummary(messages);
+    const prompt = this.options.summaryPrompt.replace("{conversation}", formattedConversation);
+    try {
+      const result = await generateText({
+        model: this.model,
+        prompt,
+        maxOutputTokens: this.options.maxSummaryTokens
+      });
+      return `[Previous conversation summary]
+${result.text}`;
+    } catch (error) {
+      this.logger.error("ReactiveOverflowStrategy: Failed to generate summary", { error });
+      return this.createFallbackSummary(messages);
+    }
+  }
+  /**
+   * Format messages for the summary prompt.
+   */
+  formatMessagesForSummary(messages) {
+    return messages.map((msg) => {
+      const role = msg.role.toUpperCase();
+      let content;
+      if (typeof msg.content === "string") {
+        content = msg.content;
+      } else if (Array.isArray(msg.content)) {
+        content = msg.content.filter(
+          (part) => part.type === "text"
+        ).map((part) => part.text).join("\n");
+      } else {
+        content = "[no content]";
+      }
+      if (content.length > 2e3) {
+        content = content.slice(0, 2e3) + "... [truncated]";
+      }
+      if (isAssistantMessage(msg) && msg.toolCalls && msg.toolCalls.length > 0) {
+        const toolNames = msg.toolCalls.map((tc) => tc.function.name).join(", ");
+        content += `
+[Used tools: ${toolNames}]`;
+      }
+      if (isToolMessage(msg)) {
+        return `TOOL (${msg.name}): ${content.slice(0, 500)}${content.length > 500 ? "..." : ""}`;
+      }
+      return `${role}: ${content}`;
+    }).join("\n\n");
+  }
+  /**
+   * Create a fallback summary if LLM call fails.
+   */
+  createFallbackSummary(messages) {
+    const userMessages = messages.filter((m) => m.role === "user");
+    const assistantWithTools = messages.filter(
+      (m) => isAssistantMessage(m) && !!m.toolCalls && m.toolCalls.length > 0
+    );
+    const userTopics = userMessages.slice(-3).map((m) => {
+      const text = typeof m.content === "string" ? m.content : Array.isArray(m.content) ? m.content.filter(
+        (p) => p.type === "text"
+      ).map((p) => p.text).join(" ") : "";
+      return text.slice(0, 100);
+    }).join("; ");
+    const toolsUsed = [
+      ...new Set(
+        assistantWithTools.flatMap((m) => m.toolCalls.map((tc) => tc.function.name))
+      )
+    ].join(", ");
+    return `[Previous conversation summary - fallback]
+User discussed: ${userTopics || "various topics"}
+Tools used: ${toolsUsed || "none"}`;
+  }
+}
+export {
+  ReactiveOverflowStrategy
+};

package/dist/context/compaction/types.d.ts

@@ -0,0 +1,20 @@
+import { InternalMessage } from '../types.js';
+/**
+ * Compaction strategy interface.
+ *
+ * Strategies are responsible for reducing conversation history size
+ * when context limits are exceeded. The strategy is called by TurnExecutor
+ * after detecting overflow via actual token usage from the API.
+ */
+export interface ICompactionStrategy {
+    /** Human-readable name for logging/UI */
+    readonly name: string;
+    /**
+     * Compacts the provided message history.
+     *
+     * @param history The current conversation history.
+     * @returns Summary messages to add to history (filterCompacted handles the rest).
+     */
+    compact(history: readonly InternalMessage[]): Promise<InternalMessage[]> | InternalMessage[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/context/compaction/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/context/compaction/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAChC,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;;OAKG;IACH,OAAO,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,GAAG,eAAe,EAAE,CAAC;CAChG"}

package/dist/context/error-codes.cjs

@@ -33,6 +33,13 @@ var ContextErrorCode = /* @__PURE__ */ ((ContextErrorCode2) => {
   ContextErrorCode2["TOKEN_COUNT_FAILED"] = "context_token_count_failed";
   ContextErrorCode2["PRESERVE_VALUES_NEGATIVE"] = "context_preserve_values_negative";
   ContextErrorCode2["MIN_MESSAGES_NEGATIVE"] = "context_min_messages_negative";
+  ContextErrorCode2["COMPACTION_INVALID_TYPE"] = "context_compaction_invalid_type";
+  ContextErrorCode2["COMPACTION_VALIDATION"] = "context_compaction_validation";
+  ContextErrorCode2["COMPACTION_MISSING_LLM"] = "context_compaction_missing_llm";
+  ContextErrorCode2["COMPACTION_PROVIDER_ALREADY_REGISTERED"] = "context_compaction_provider_already_registered";
+  ContextErrorCode2["MESSAGE_NOT_FOUND"] = "context_message_not_found";
+  ContextErrorCode2["MESSAGE_NOT_ASSISTANT"] = "context_message_not_assistant";
+  ContextErrorCode2["ASSISTANT_CONTENT_NOT_STRING"] = "context_assistant_content_not_string";
   return ContextErrorCode2;
 })(ContextErrorCode || {});
 // Annotate the CommonJS export names for ESM import in node:

package/dist/context/error-codes.d.ts

@@ -13,6 +13,13 @@ export declare enum ContextErrorCode {
     SYSTEM_MESSAGE_CONTENT_INVALID = "context_system_message_content_invalid",
     TOKEN_COUNT_FAILED = "context_token_count_failed",
     PRESERVE_VALUES_NEGATIVE = "context_preserve_values_negative",
-    MIN_MESSAGES_NEGATIVE = "context_min_messages_negative"
+    MIN_MESSAGES_NEGATIVE = "context_min_messages_negative",
+    COMPACTION_INVALID_TYPE = "context_compaction_invalid_type",
+    COMPACTION_VALIDATION = "context_compaction_validation",
+    COMPACTION_MISSING_LLM = "context_compaction_missing_llm",
+    COMPACTION_PROVIDER_ALREADY_REGISTERED = "context_compaction_provider_already_registered",
+    MESSAGE_NOT_FOUND = "context_message_not_found",
+    MESSAGE_NOT_ASSISTANT = "context_message_not_assistant",
+    ASSISTANT_CONTENT_NOT_STRING = "context_assistant_content_not_string"
 }
 //# sourceMappingURL=error-codes.d.ts.map

package/dist/context/error-codes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../../src/context/error-codes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,gBAAgB;IAExB,oBAAoB,iCAAiC;IACrD,qBAAqB,kCAAkC;IAGvD,4BAA4B,yCAAyC;IAGrE,2CAA2C,wDAAwD;IACnG,oCAAoC,iDAAiD;IAGrF,2BAA2B,wCAAwC;IACnE,0BAA0B,uCAAuC;IAGjE,8BAA8B,2CAA2C;IAEzE,kBAAkB,+BAA+B;IAMjD,wBAAwB,qCAAqC;IAC7D,qBAAqB,kCAAkC;CAC1D"}
+{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../../src/context/error-codes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,gBAAgB;IAExB,oBAAoB,iCAAiC;IACrD,qBAAqB,kCAAkC;IAGvD,4BAA4B,yCAAyC;IAGrE,2CAA2C,wDAAwD;IACnG,oCAAoC,iDAAiD;IAGrF,2BAA2B,wCAAwC;IACnE,0BAA0B,uCAAuC;IAGjE,8BAA8B,2CAA2C;IAEzE,kBAAkB,+BAA+B;IAMjD,wBAAwB,qCAAqC;IAC7D,qBAAqB,kCAAkC;IACvD,uBAAuB,oCAAoC;IAC3D,qBAAqB,kCAAkC;IACvD,sBAAsB,mCAAmC;IACzD,sCAAsC,mDAAmD;IAGzF,iBAAiB,8BAA8B;IAC/C,qBAAqB,kCAAkC;IACvD,4BAA4B,yCAAyC;CACxE"}

package/dist/context/error-codes.js

@@ -1,4 +1,4 @@
-import "../chunk-C6A6W6XS.js";
+import "../chunk-PTJYTZNU.js";
 var ContextErrorCode = /* @__PURE__ */ ((ContextErrorCode2) => {
   ContextErrorCode2["MESSAGE_ROLE_MISSING"] = "context_message_role_missing";
   ContextErrorCode2["MESSAGE_CONTENT_EMPTY"] = "context_message_content_empty";
@@ -11,6 +11,13 @@ var ContextErrorCode = /* @__PURE__ */ ((ContextErrorCode2) => {
   ContextErrorCode2["TOKEN_COUNT_FAILED"] = "context_token_count_failed";
   ContextErrorCode2["PRESERVE_VALUES_NEGATIVE"] = "context_preserve_values_negative";
   ContextErrorCode2["MIN_MESSAGES_NEGATIVE"] = "context_min_messages_negative";
+  ContextErrorCode2["COMPACTION_INVALID_TYPE"] = "context_compaction_invalid_type";
+  ContextErrorCode2["COMPACTION_VALIDATION"] = "context_compaction_validation";
+  ContextErrorCode2["COMPACTION_MISSING_LLM"] = "context_compaction_missing_llm";
+  ContextErrorCode2["COMPACTION_PROVIDER_ALREADY_REGISTERED"] = "context_compaction_provider_already_registered";
+  ContextErrorCode2["MESSAGE_NOT_FOUND"] = "context_message_not_found";
+  ContextErrorCode2["MESSAGE_NOT_ASSISTANT"] = "context_message_not_assistant";
+  ContextErrorCode2["ASSISTANT_CONTENT_NOT_STRING"] = "context_assistant_content_not_string";
   return ContextErrorCode2;
 })(ContextErrorCode || {});
 export {

package/dist/context/errors.cjs

@@ -139,6 +139,74 @@ class ContextError {
       "Set minMessagesToKeep to zero or positive value"
     );
   }
+  static compactionInvalidType(type, available) {
+    return new import_errors.DextoRuntimeError(
+      import_error_codes.ContextErrorCode.COMPACTION_INVALID_TYPE,
+      import_types.ErrorScope.CONTEXT,
+      import_types.ErrorType.USER,
+      `Unknown compaction provider type: '${type}'`,
+      { type, available },
+      `Use one of the available types: ${available.join(", ")}`
+    );
+  }
+  static compactionValidation(type, errors) {
+    return new import_errors.DextoRuntimeError(
+      import_error_codes.ContextErrorCode.COMPACTION_VALIDATION,
+      import_types.ErrorScope.CONTEXT,
+      import_types.ErrorType.USER,
+      `Invalid configuration for compaction provider '${type}'`,
+      { type, errors },
+      "Check the configuration schema for this provider"
+    );
+  }
+  static compactionMissingLLM(type) {
+    return new import_errors.DextoRuntimeError(
+      import_error_codes.ContextErrorCode.COMPACTION_MISSING_LLM,
+      import_types.ErrorScope.CONTEXT,
+      import_types.ErrorType.USER,
+      `Compaction provider '${type}' requires LLM service but none provided`,
+      { type },
+      "Ensure LLM service is initialized before creating this compaction provider"
+    );
+  }
+  static compactionProviderAlreadyRegistered(type) {
+    return new import_errors.DextoRuntimeError(
+      import_error_codes.ContextErrorCode.COMPACTION_PROVIDER_ALREADY_REGISTERED,
+      import_types.ErrorScope.CONTEXT,
+      import_types.ErrorType.USER,
+      `Compaction provider '${type}' is already registered`,
+      { type },
+      "Each provider type can only be registered once"
+    );
+  }
+  // Message lookup errors
+  static messageNotFound(messageId) {
+    return new import_errors.DextoRuntimeError(
+      import_error_codes.ContextErrorCode.MESSAGE_NOT_FOUND,
+      import_types.ErrorScope.CONTEXT,
+      import_types.ErrorType.NOT_FOUND,
+      `Message with ID ${messageId} not found`,
+      { messageId }
+    );
+  }
+  static messageNotAssistant(messageId) {
+    return new import_errors.DextoRuntimeError(
+      import_error_codes.ContextErrorCode.MESSAGE_NOT_ASSISTANT,
+      import_types.ErrorScope.CONTEXT,
+      import_types.ErrorType.USER,
+      `Message with ID ${messageId} is not an assistant message`,
+      { messageId }
+    );
+  }
+  static assistantContentNotString() {
+    return new import_errors.DextoRuntimeError(
+      import_error_codes.ContextErrorCode.ASSISTANT_CONTENT_NOT_STRING,
+      import_types.ErrorScope.CONTEXT,
+      import_types.ErrorType.USER,
+      "Cannot append text to non-string assistant message content",
+      {}
+    );
+  }
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/context/errors.d.ts

@@ -17,5 +17,26 @@ export declare class ContextError {
         cause: string;
     }>;
     static minMessagesNegative(): DextoRuntimeError<{}>;
+    static compactionInvalidType(type: string, available: string[]): DextoRuntimeError<{
+        type: string;
+        available: string[];
+    }>;
+    static compactionValidation(type: string, errors: unknown): DextoRuntimeError<{
+        type: string;
+        errors: unknown;
+    }>;
+    static compactionMissingLLM(type: string): DextoRuntimeError<{
+        type: string;
+    }>;
+    static compactionProviderAlreadyRegistered(type: string): DextoRuntimeError<{
+        type: string;
+    }>;
+    static messageNotFound(messageId: string): DextoRuntimeError<{
+        messageId: string;
+    }>;
+    static messageNotAssistant(messageId: string): DextoRuntimeError<{
+        messageId: string;
+    }>;
+    static assistantContentNotString(): DextoRuntimeError<{}>;
 }
 //# sourceMappingURL=errors.d.ts.map

package/dist/context/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/context/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAIvD;;;GAGG;AACH,qBAAa,YAAY;IAErB,MAAM,CAAC,kBAAkB;IAWzB,MAAM,CAAC,yBAAyB;IAWhC,MAAM,CAAC,sCAAsC;IAW7C,MAAM,CAAC,gCAAgC;IAWvC,MAAM,CAAC,wBAAwB;IAW/B,MAAM,CAAC,2BAA2B;IAWlC,MAAM,CAAC,uBAAuB;IAW9B,MAAM,CAAC,sBAAsB;IAe7B,MAAM,CAAC,sBAAsB;IAW7B,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM;;;IAWrC,MAAM,CAAC,mBAAmB;CAU7B"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/context/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAIvD;;;GAGG;AACH,qBAAa,YAAY;IAErB,MAAM,CAAC,kBAAkB;IAWzB,MAAM,CAAC,yBAAyB;IAWhC,MAAM,CAAC,sCAAsC;IAW7C,MAAM,CAAC,gCAAgC;IAWvC,MAAM,CAAC,wBAAwB;IAW/B,MAAM,CAAC,2BAA2B;IAWlC,MAAM,CAAC,uBAAuB;IAW9B,MAAM,CAAC,sBAAsB;IAe7B,MAAM,CAAC,sBAAsB;IAW7B,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM;;;IAWrC,MAAM,CAAC,mBAAmB;IAW1B,MAAM,CAAC,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE;;;;IAW9D,MAAM,CAAC,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO;;;;IAWzD,MAAM,CAAC,oBAAoB,CAAC,IAAI,EAAE,MAAM;;;IAWxC,MAAM,CAAC,mCAAmC,CAAC,IAAI,EAAE,MAAM;;;IAYvD,MAAM,CAAC,eAAe,CAAC,SAAS,EAAE,MAAM;;;IAUxC,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,MAAM;;;IAU5C,MAAM,CAAC,yBAAyB;CASnC"}