@dexto/core 1.4.0 → 1.5.0

package/dist/context/compaction/providers/reactive-overflow-provider.cjs

@@ -0,0 +1,61 @@
+"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_provider_exports = {};
+__export(reactive_overflow_provider_exports, {
+  ReactiveOverflowConfigSchema: () => ReactiveOverflowConfigSchema,
+  reactiveOverflowProvider: () => reactiveOverflowProvider
+});
+module.exports = __toCommonJS(reactive_overflow_provider_exports);
+var import_zod = require("zod");
+var import_reactive_overflow = require("../strategies/reactive-overflow.js");
+const ReactiveOverflowConfigSchema = import_zod.z.object({
+  type: import_zod.z.literal("reactive-overflow"),
+  enabled: import_zod.z.boolean().default(true).describe("Enable or disable compaction"),
+  preserveLastNTurns: import_zod.z.number().int().positive().default(2).describe("Number of recent turns (user+assistant pairs) to preserve"),
+  maxSummaryTokens: import_zod.z.number().int().positive().default(2e3).describe("Maximum tokens for the summary output"),
+  summaryPrompt: import_zod.z.string().optional().describe("Custom summary prompt template. Use {conversation} as placeholder")
+}).strict();
+const reactiveOverflowProvider = {
+  type: "reactive-overflow",
+  configSchema: ReactiveOverflowConfigSchema,
+  metadata: {
+    displayName: "Reactive Overflow Compaction",
+    description: "Generates summaries when context window overflows, preserving recent turns",
+    requiresLLM: true,
+    isProactive: false
+  },
+  create(config, context) {
+    if (!context.model) {
+      throw new Error("ReactiveOverflowStrategy requires LanguageModel");
+    }
+    const options = {
+      preserveLastNTurns: config.preserveLastNTurns,
+      maxSummaryTokens: config.maxSummaryTokens
+    };
+    if (config.summaryPrompt !== void 0) {
+      options.summaryPrompt = config.summaryPrompt;
+    }
+    return new import_reactive_overflow.ReactiveOverflowStrategy(context.model, options, context.logger);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ReactiveOverflowConfigSchema,
+  reactiveOverflowProvider
+});

package/dist/context/compaction/providers/reactive-overflow-provider.d.ts

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+import type { CompactionProvider } from '../provider.js';
+/**
+ * Configuration schema for reactive overflow compaction
+ */
+export declare const ReactiveOverflowConfigSchema: z.ZodObject<{
+    type: z.ZodLiteral<"reactive-overflow">;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    preserveLastNTurns: z.ZodDefault<z.ZodNumber>;
+    maxSummaryTokens: z.ZodDefault<z.ZodNumber>;
+    summaryPrompt: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    type: "reactive-overflow";
+    enabled: boolean;
+    preserveLastNTurns: number;
+    maxSummaryTokens: number;
+    summaryPrompt?: string | undefined;
+}, {
+    type: "reactive-overflow";
+    enabled?: boolean | undefined;
+    preserveLastNTurns?: number | undefined;
+    maxSummaryTokens?: number | undefined;
+    summaryPrompt?: string | undefined;
+}>;
+export type ReactiveOverflowConfig = z.output<typeof ReactiveOverflowConfigSchema>;
+/**
+ * Provider for reactive overflow compaction strategy.
+ *
+ * This strategy triggers compaction when context window overflow is detected:
+ * - Generates LLM-powered summaries of older messages
+ * - Preserves recent turns for context continuity
+ * - Falls back to simple text summary if LLM call fails
+ * - Adds summary message to history (read-time filtering excludes old messages)
+ */
+export declare const reactiveOverflowProvider: CompactionProvider<'reactive-overflow', ReactiveOverflowConfig>;
+//# sourceMappingURL=reactive-overflow-provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reactive-overflow-provider.d.ts","sourceRoot":"","sources":["../../../../src/context/compaction/providers/reactive-overflow-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGzD;;GAEG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;EAqB5B,CAAC;AAEd,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAEnF;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB,EAAE,kBAAkB,CACrD,mBAAmB,EACnB,sBAAsB,CA2BzB,CAAC"}

package/dist/context/compaction/providers/reactive-overflow-provider.js

@@ -0,0 +1,37 @@
+import "../../../chunk-PTJYTZNU.js";
+import { z } from "zod";
+import { ReactiveOverflowStrategy } from "../strategies/reactive-overflow.js";
+const ReactiveOverflowConfigSchema = z.object({
+  type: z.literal("reactive-overflow"),
+  enabled: z.boolean().default(true).describe("Enable or disable compaction"),
+  preserveLastNTurns: z.number().int().positive().default(2).describe("Number of recent turns (user+assistant pairs) to preserve"),
+  maxSummaryTokens: z.number().int().positive().default(2e3).describe("Maximum tokens for the summary output"),
+  summaryPrompt: z.string().optional().describe("Custom summary prompt template. Use {conversation} as placeholder")
+}).strict();
+const reactiveOverflowProvider = {
+  type: "reactive-overflow",
+  configSchema: ReactiveOverflowConfigSchema,
+  metadata: {
+    displayName: "Reactive Overflow Compaction",
+    description: "Generates summaries when context window overflows, preserving recent turns",
+    requiresLLM: true,
+    isProactive: false
+  },
+  create(config, context) {
+    if (!context.model) {
+      throw new Error("ReactiveOverflowStrategy requires LanguageModel");
+    }
+    const options = {
+      preserveLastNTurns: config.preserveLastNTurns,
+      maxSummaryTokens: config.maxSummaryTokens
+    };
+    if (config.summaryPrompt !== void 0) {
+      options.summaryPrompt = config.summaryPrompt;
+    }
+    return new ReactiveOverflowStrategy(context.model, options, context.logger);
+  }
+};
+export {
+  ReactiveOverflowConfigSchema,
+  reactiveOverflowProvider
+};

package/dist/context/compaction/registry.cjs

@@ -0,0 +1,39 @@
+"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 registry_exports = {};
+__export(registry_exports, {
+  compactionRegistry: () => compactionRegistry
+});
+module.exports = __toCommonJS(registry_exports);
+var import_errors = require("../errors.js");
+var import_base_registry = require("../../providers/base-registry.js");
+const compactionErrorFactory = {
+  alreadyRegistered: (type) => import_errors.ContextError.compactionProviderAlreadyRegistered(type),
+  notFound: (type, availableTypes) => import_errors.ContextError.compactionInvalidType(type, availableTypes)
+};
+class CompactionRegistry extends import_base_registry.BaseRegistry {
+  constructor() {
+    super(compactionErrorFactory);
+  }
+}
+const compactionRegistry = new CompactionRegistry();
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  compactionRegistry
+});

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

@@ -0,0 +1,19 @@
+import type { CompactionProvider } from './provider.js';
+import { BaseRegistry } from '../../providers/base-registry.js';
+/**
+ * Global registry for compaction providers.
+ *
+ * Follows the same pattern as blob storage and tools registries:
+ * - Singleton instance exported
+ * - Registration before agent initialization
+ * - Type-safe provider lookup
+ *
+ * Extends BaseRegistry for common registry functionality.
+ */
+declare class CompactionRegistry extends BaseRegistry<CompactionProvider<any, any>> {
+    constructor();
+}
+/** Global singleton instance */
+export declare const compactionRegistry: CompactionRegistry;
+export {};
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/context/compaction/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExD,OAAO,EAAE,YAAY,EAA6B,MAAM,kCAAkC,CAAC;AAY3F;;;;;;;;;GASG;AACH,cAAM,kBAAmB,SAAQ,YAAY,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;;CAI1E;AAED,gCAAgC;AAChC,eAAO,MAAM,kBAAkB,oBAA2B,CAAC"}

package/dist/context/compaction/registry.js

@@ -0,0 +1,16 @@
+import "../../chunk-PTJYTZNU.js";
+import { ContextError } from "../errors.js";
+import { BaseRegistry } from "../../providers/base-registry.js";
+const compactionErrorFactory = {
+  alreadyRegistered: (type) => ContextError.compactionProviderAlreadyRegistered(type),
+  notFound: (type, availableTypes) => ContextError.compactionInvalidType(type, availableTypes)
+};
+class CompactionRegistry extends BaseRegistry {
+  constructor() {
+    super(compactionErrorFactory);
+  }
+}
+const compactionRegistry = new CompactionRegistry();
+export {
+  compactionRegistry
+};

package/dist/context/compaction/schemas.cjs

@@ -0,0 +1,38 @@
+"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 schemas_exports = {};
+__export(schemas_exports, {
+  CompactionConfigSchema: () => CompactionConfigSchema,
+  DEFAULT_COMPACTION_CONFIG: () => DEFAULT_COMPACTION_CONFIG
+});
+module.exports = __toCommonJS(schemas_exports);
+var import_zod = require("zod");
+const CompactionConfigSchema = import_zod.z.object({
+  type: import_zod.z.string().describe("Compaction provider type"),
+  enabled: import_zod.z.boolean().default(true).describe("Enable or disable compaction")
+}).passthrough().describe("Context compaction configuration");
+const DEFAULT_COMPACTION_CONFIG = {
+  type: "reactive-overflow",
+  enabled: true
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CompactionConfigSchema,
+  DEFAULT_COMPACTION_CONFIG
+});

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

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+/**
+ * Base compaction configuration schema.
+ * Uses discriminated union to support different provider types.
+ *
+ * Each provider registers its own schema with specific validation rules.
+ * This schema accepts any configuration with a 'type' field.
+ */
+export declare const CompactionConfigSchema: z.ZodObject<{
+    type: z.ZodString;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    type: z.ZodString;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    type: z.ZodString;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+}, z.ZodTypeAny, "passthrough">>;
+export type CompactionConfigInput = z.output<typeof CompactionConfigSchema>;
+/**
+ * Default compaction configuration - uses reactive-overflow strategy
+ */
+export declare const DEFAULT_COMPACTION_CONFIG: CompactionConfigInput;
+//# sourceMappingURL=schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/context/compaction/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;gCAMc,CAAC;AAElD,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,qBAGvC,CAAC"}

package/dist/context/compaction/schemas.js

@@ -0,0 +1,14 @@
+import "../../chunk-PTJYTZNU.js";
+import { z } from "zod";
+const CompactionConfigSchema = z.object({
+  type: z.string().describe("Compaction provider type"),
+  enabled: z.boolean().default(true).describe("Enable or disable compaction")
+}).passthrough().describe("Context compaction configuration");
+const DEFAULT_COMPACTION_CONFIG = {
+  type: "reactive-overflow",
+  enabled: true
+};
+export {
+  CompactionConfigSchema,
+  DEFAULT_COMPACTION_CONFIG
+};

package/dist/context/compaction/strategies/noop.cjs

@@ -0,0 +1,36 @@
+"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 noop_exports = {};
+__export(noop_exports, {
+  NoOpCompactionStrategy: () => NoOpCompactionStrategy
+});
+module.exports = __toCommonJS(noop_exports);
+class NoOpCompactionStrategy {
+  name = "noop";
+  /**
+   * Does nothing - returns empty array (no summary needed)
+   */
+  async compact(_history) {
+    return [];
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  NoOpCompactionStrategy
+});

package/dist/context/compaction/strategies/noop.d.ts

@@ -0,0 +1,18 @@
+import type { ICompactionStrategy } from '../types.js';
+import type { InternalMessage } from '../../types.js';
+/**
+ * No-op compaction strategy that doesn't perform any compaction.
+ *
+ * Useful for:
+ * - Testing without compaction overhead
+ * - Disabling compaction temporarily
+ * - Contexts where full history is required
+ */
+export declare class NoOpCompactionStrategy implements ICompactionStrategy {
+    readonly name = "noop";
+    /**
+     * Does nothing - returns empty array (no summary needed)
+     */
+    compact(_history: readonly InternalMessage[]): Promise<InternalMessage[]>;
+}
+//# sourceMappingURL=noop.d.ts.map

package/dist/context/compaction/strategies/noop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop.d.ts","sourceRoot":"","sources":["../../../../src/context/compaction/strategies/noop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD;;;;;;;GAOG;AACH,qBAAa,sBAAuB,YAAW,mBAAmB;IAC9D,QAAQ,CAAC,IAAI,UAAU;IAEvB;;OAEG;IACG,OAAO,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CAGlF"}

package/dist/context/compaction/strategies/noop.js

@@ -0,0 +1,13 @@
+import "../../../chunk-PTJYTZNU.js";
+class NoOpCompactionStrategy {
+  name = "noop";
+  /**
+   * Does nothing - returns empty array (no summary needed)
+   */
+  async compact(_history) {
+    return [];
+  }
+}
+export {
+  NoOpCompactionStrategy
+};

package/dist/context/{compression → compaction/strategies}/reactive-overflow.cjs

@@ -22,7 +22,7 @@ __export(reactive_overflow_exports, {
 });
 module.exports = __toCommonJS(reactive_overflow_exports);
 var import_ai = require("ai");
-var import_types = require("../types.js");
+var import_types = require("../../types.js");
 const DEFAULT_OPTIONS = {
   preserveLastNTurns: 2,
   maxSummaryTokens: 2e3,
@@ -58,9 +58,9 @@ class ReactiveOverflowStrategy {
    * @param history The full conversation history
    * @returns Array with single summary message to add, or empty if nothing to summarize
    */
-  async compress(history) {
+  async compact(history) {
     if (history.length <= 2) {
-      this.logger.debug("ReactiveOverflowStrategy: History too short, skipping compression");
+      this.logger.debug("ReactiveOverflowStrategy: History too short, skipping compaction");
       return [];
     }
     const { toSummarize, toKeep } = this.splitHistory(history);

package/dist/context/{compression → compaction/strategies}/reactive-overflow.d.ts

@@ -1,7 +1,7 @@
 import { type LanguageModel } from 'ai';
-import type { ICompressionStrategy } from './types.js';
-import type { InternalMessage } from '../types.js';
-import type { IDextoLogger } from '../../logger/v2/types.js';
+import type { ICompactionStrategy } from '../types.js';
+import type { InternalMessage } from '../../types.js';
+import type { IDextoLogger } from '../../../logger/v2/types.js';
 /**
  * Configuration options for ReactiveOverflowStrategy.
  */
@@ -24,7 +24,7 @@ export interface ReactiveOverflowOptions {
     summaryPrompt?: string;
 }
 /**
- * ReactiveOverflowStrategy implements reactive compression.
+ * ReactiveOverflowStrategy implements reactive compaction.
  *
  * Key behaviors:
  * - Triggers on overflow (after actual tokens exceed context limit)
@@ -42,7 +42,7 @@ export interface ReactiveOverflowOptions {
  * and filterCompacted() handles excluding old messages at read-time.
  * This preserves full history for audit/recovery purposes.
  */
-export declare class ReactiveOverflowStrategy implements ICompressionStrategy {
+export declare class ReactiveOverflowStrategy implements ICompactionStrategy {
     readonly name = "reactive-overflow";
     private readonly model;
     private readonly options;
@@ -59,7 +59,7 @@ export declare class ReactiveOverflowStrategy implements ICompressionStrategy {
      * @param history The full conversation history
      * @returns Array with single summary message to add, or empty if nothing to summarize
      */
-    compress(history: readonly InternalMessage[]): Promise<InternalMessage[]>;
+    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.

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/{compression → compaction/strategies}/reactive-overflow.js

@@ -1,6 +1,6 @@
-import "../../chunk-PTJYTZNU.js";
+import "../../../chunk-PTJYTZNU.js";
 import { generateText } from "ai";
-import { isAssistantMessage, isToolMessage } from "../types.js";
+import { isAssistantMessage, isToolMessage } from "../../types.js";
 const DEFAULT_OPTIONS = {
   preserveLastNTurns: 2,
   maxSummaryTokens: 2e3,
@@ -36,9 +36,9 @@ class ReactiveOverflowStrategy {
    * @param history The full conversation history
    * @returns Array with single summary message to add, or empty if nothing to summarize
    */
-  async compress(history) {
+  async compact(history) {
     if (history.length <= 2) {
-      this.logger.debug("ReactiveOverflowStrategy: History too short, skipping compression");
+      this.logger.debug("ReactiveOverflowStrategy: History too short, skipping compaction");
       return [];
     }
     const { toSummarize, toKeep } = this.splitHistory(history);

package/dist/context/{compression → compaction}/types.d.ts

@@ -1,20 +1,20 @@
 import { InternalMessage } from '../types.js';
 /**
- * Compression strategy interface.
+ * 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 ICompressionStrategy {
+export interface ICompactionStrategy {
     /** Human-readable name for logging/UI */
     readonly name: string;
     /**
-     * Compresses the provided message history.
+     * Compacts the provided message history.
      *
      * @param history The current conversation history.
      * @returns Summary messages to add to history (filterCompacted handles the rest).
      */
-    compress(history: readonly InternalMessage[]): Promise<InternalMessage[]> | InternalMessage[];
+    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,10 @@ 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";

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

@@ -14,6 +14,10 @@ export declare enum ContextErrorCode {
     TOKEN_COUNT_FAILED = "context_token_count_failed",
     PRESERVE_VALUES_NEGATIVE = "context_preserve_values_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"

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;IAGvD,iBAAiB,8BAA8B;IAC/C,qBAAqB,kCAAkC;IACvD,4BAA4B,yCAAyC;CACxE"}
+{"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

@@ -11,6 +11,10 @@ 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";

package/dist/context/errors.cjs

@@ -139,6 +139,46 @@ 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(

package/dist/context/errors.d.ts

@@ -17,6 +17,20 @@ 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;
     }>;

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;IAY1B,MAAM,CAAC,eAAe,CAAC,SAAS,EAAE,MAAM;;;IAUxC,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,MAAM;;;IAU5C,MAAM,CAAC,yBAAyB;CASnC"}
+{"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"}