@dexto/core 1.5.3 → 1.5.4

package/dist/llm/services/vercel.cjs

@@ -92,13 +92,15 @@ class VercelLLMService {
   resourceManager;
   messageQueue;
   compactionStrategy;
+  modelLimits;
+  compactionThresholdPercent;
   /**
    * Helper to extract model ID from LanguageModel union type (string | LanguageModelV2)
    */
   getModelId() {
     return typeof this.model === "string" ? this.model : this.model.modelId;
   }
-  constructor(toolManager, model, systemPromptManager, historyProvider, sessionEventBus, config, sessionId, resourceManager, logger, compactionStrategy) {
+  constructor(toolManager, model, systemPromptManager, historyProvider, sessionEventBus, config, sessionId, resourceManager, logger, compactionStrategy, compactionConfig) {
     this.logger = logger.createChild(import_types2.DextoLogComponent.LLM);
     this.model = model;
     this.config = config;
@@ -107,9 +109,20 @@ class VercelLLMService {
     this.sessionId = sessionId;
     this.resourceManager = resourceManager;
     this.compactionStrategy = compactionStrategy ?? null;
+    this.compactionThresholdPercent = compactionConfig?.thresholdPercent ?? 0.9;
     this.messageQueue = new import_message_queue.MessageQueueService(this.sessionEventBus, this.logger);
     const formatter = new import_vercel.VercelMessageFormatter(this.logger);
     const maxInputTokens = (0, import_registry.getEffectiveMaxInputTokens)(config, this.logger);
+    let effectiveContextWindow = maxInputTokens;
+    if (compactionConfig?.maxContextTokens !== void 0) {
+      effectiveContextWindow = Math.min(maxInputTokens, compactionConfig.maxContextTokens);
+      this.logger.debug(
+        `Compaction: Using maxContextTokens override: ${compactionConfig.maxContextTokens} (model max: ${maxInputTokens})`
+      );
+    }
+    this.modelLimits = {
+      contextWindow: effectiveContextWindow
+    };
     this.contextManager = new import_manager.ContextManager(
       config,
       formatter,
@@ -149,19 +162,23 @@ class VercelLLMService {
       { provider: this.config.provider, model: this.getModelId() },
       this.logger,
       this.messageQueue,
-      void 0,
-      // modelLimits - TurnExecutor will use defaults
+      this.modelLimits,
       externalSignal,
-      this.compactionStrategy
+      this.compactionStrategy,
+      this.compactionThresholdPercent
     );
   }
+  /**
+   * Result from streaming a response.
+   */
+  static StreamResult;
   /**
    * Stream a response for the given content.
    * Primary method for running conversations with multi-image support.
    *
    * @param content - String or ContentPart[] (text, images, files)
    * @param options - { signal?: AbortSignal }
-   * @returns The assistant's text response
+   * @returns Object with text response, whether compaction occurred, and compaction data if applicable
    */
   async stream(content, options) {
     const activeSpan = import_api.trace.getActiveSpan();
@@ -191,7 +208,12 @@ class VercelLLMService {
       const executor = this.createTurnExecutor(options?.signal);
       const contributorContext = { mcpManager: this.toolManager.getMcpManager() };
       const result = await executor.execute(contributorContext, true);
-      return result.text ?? "";
+      return {
+        text: result.text ?? "",
+        didCompact: result.didCompact,
+        // Use spread to conditionally include compaction (exactOptionalPropertyTypes)
+        ...result.compaction && { compaction: result.compaction }
+      };
     });
   }
   /**
@@ -236,6 +258,12 @@ class VercelLLMService {
   getMessageQueue() {
     return this.messageQueue;
   }
+  /**
+   * Get the compaction strategy for external access (e.g., session-native compaction)
+   */
+  getCompactionStrategy() {
+    return this.compactionStrategy;
+  }
 }
 _init = __decoratorStart(null);
 VercelLLMService = __decorateElement(_init, 0, "VercelLLMService", _VercelLLMService_decorators, VercelLLMService);

package/dist/llm/services/vercel.d.ts

@@ -4,10 +4,12 @@ import { LLMServiceConfig } from './types.js';
 import type { IDextoLogger } from '../../logger/v2/types.js';
 import { ToolSet } from '../../tools/types.js';
 import { ContextManager } from '../../context/manager.js';
+import type { CompactionConfigInput } from '../../context/compaction/schemas.js';
 import type { SessionEventBus } from '../../events/index.js';
 import type { IConversationHistoryProvider } from '../../session/history/types.js';
 import type { SystemPromptManager } from '../../systemPrompt/manager.js';
 import type { ValidatedLLMConfig } from '../schemas.js';
+import type { CompactionData } from '../executor/types.js';
 import { MessageQueueService } from '../../session/message-queue.js';
 import type { ResourceManager } from '../../resources/index.js';
 import type { ContentInput } from '../../agent/types.js';
@@ -36,27 +38,41 @@ export declare class VercelLLMService {
     private resourceManager;
     private messageQueue;
     private compactionStrategy;
+    private modelLimits;
+    private compactionThresholdPercent;
     /**
      * Helper to extract model ID from LanguageModel union type (string | LanguageModelV2)
      */
     private getModelId;
-    constructor(toolManager: ToolManager, model: LanguageModel, systemPromptManager: SystemPromptManager, historyProvider: IConversationHistoryProvider, sessionEventBus: SessionEventBus, config: ValidatedLLMConfig, sessionId: string, resourceManager: ResourceManager, logger: IDextoLogger, compactionStrategy?: import('../../context/compaction/types.js').ICompactionStrategy | null);
+    constructor(toolManager: ToolManager, model: LanguageModel, systemPromptManager: SystemPromptManager, historyProvider: IConversationHistoryProvider, sessionEventBus: SessionEventBus, config: ValidatedLLMConfig, sessionId: string, resourceManager: ResourceManager, logger: IDextoLogger, compactionStrategy?: import('../../context/compaction/types.js').ICompactionStrategy | null, compactionConfig?: CompactionConfigInput);
     getAllTools(): Promise<ToolSet>;
     /**
      * Create a TurnExecutor instance for executing the agent loop.
      */
     private createTurnExecutor;
+    /**
+     * Result from streaming a response.
+     */
+    static StreamResult: {
+        text: string;
+        didCompact: boolean;
+        compaction?: CompactionData;
+    };
     /**
      * Stream a response for the given content.
      * Primary method for running conversations with multi-image support.
      *
      * @param content - String or ContentPart[] (text, images, files)
      * @param options - { signal?: AbortSignal }
-     * @returns The assistant's text response
+     * @returns Object with text response, whether compaction occurred, and compaction data if applicable
      */
     stream(content: ContentInput, options?: {
         signal?: AbortSignal;
-    }): Promise<string>;
+    }): Promise<{
+        text: string;
+        didCompact: boolean;
+        compaction?: CompactionData;
+    }>;
     /**
      * Get configuration information about the LLM service
      * @returns Configuration object with provider and model information
@@ -70,5 +86,9 @@ export declare class VercelLLMService {
      * Get the message queue for external access (e.g., queueing messages while busy)
      */
     getMessageQueue(): MessageQueueService;
+    /**
+     * Get the compaction strategy for external access (e.g., session-native compaction)
+     */
+    getCompactionStrategy(): import('../../context/compaction/types.js').ICompactionStrategy | null;
 }
 //# sourceMappingURL=vercel.d.ts.map

package/dist/llm/services/vercel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vercel.d.ts","sourceRoot":"","sources":["../../../src/llm/services/vercel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAqB,MAAM,IAAI,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AACnF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAIxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAGhE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD;;;;;;;;;;;;;GAaG;AACH,qBAIa,gBAAgB;IACzB,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,kBAAkB,CAEf;IAEX;;OAEG;IACH,OAAO,CAAC,UAAU;gBAKd,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,aAAa,EACpB,mBAAmB,EAAE,mBAAmB,EACxC,eAAe,EAAE,4BAA4B,EAC7C,eAAe,EAAE,eAAe,EAChC,MAAM,EAAE,kBAAkB,EAC1B,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,eAAe,EAChC,MAAM,EAAE,YAAY,EACpB,kBAAkB,CAAC,EAAE,OAAO,mCAAmC,EAAE,mBAAmB,GAAG,IAAI;IAkC/F,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAyB1B;;;;;;;OAOG;IACG,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAsDxF;;;OAGG;IACH,SAAS,IAAI,gBAAgB;IA+B7B;;OAEG;IACH,iBAAiB,IAAI,cAAc,CAAC,OAAO,CAAC;IAI5C;;OAEG;IACH,eAAe,IAAI,mBAAmB;CAGzC"}
+{"version":3,"file":"vercel.d.ts","sourceRoot":"","sources":["../../../src/llm/services/vercel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAqB,MAAM,IAAI,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAEjF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AACnF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAIxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAGhE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD;;;;;;;;;;;;;GAaG;AACH,qBAIa,gBAAgB;IACzB,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,kBAAkB,CAEf;IACX,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,0BAA0B,CAAS;IAE3C;;OAEG;IACH,OAAO,CAAC,UAAU;gBAKd,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,aAAa,EACpB,mBAAmB,EAAE,mBAAmB,EACxC,eAAe,EAAE,4BAA4B,EAC7C,eAAe,EAAE,eAAe,EAChC,MAAM,EAAE,kBAAkB,EAC1B,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,eAAe,EAChC,MAAM,EAAE,YAAY,EACpB,kBAAkB,CAAC,EAAE,OAAO,mCAAmC,EAAE,mBAAmB,GAAG,IAAI,EAC3F,gBAAgB,CAAC,EAAE,qBAAqB;IAuD5C,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA0B1B;;OAEG;IACH,OAAc,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,cAAc,CAAA;KAAE,CAAC;IAE/F;;;;;;;OAOG;IACG,MAAM,CACR,OAAO,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACnC,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,cAAc,CAAA;KAAE,CAAC;IA2D9E;;;OAGG;IACH,SAAS,IAAI,gBAAgB;IA+B7B;;OAEG;IACH,iBAAiB,IAAI,cAAc,CAAC,OAAO,CAAC;IAI5C;;OAEG;IACH,eAAe,IAAI,mBAAmB;IAItC;;OAEG;IACH,qBAAqB,IACf,OAAO,mCAAmC,EAAE,mBAAmB,GAC/D,IAAI;CAGb"}

package/dist/llm/services/vercel.js

@@ -29,13 +29,15 @@ class VercelLLMService {
   resourceManager;
   messageQueue;
   compactionStrategy;
+  modelLimits;
+  compactionThresholdPercent;
   /**
    * Helper to extract model ID from LanguageModel union type (string | LanguageModelV2)
    */
   getModelId() {
     return typeof this.model === "string" ? this.model : this.model.modelId;
   }
-  constructor(toolManager, model, systemPromptManager, historyProvider, sessionEventBus, config, sessionId, resourceManager, logger, compactionStrategy) {
+  constructor(toolManager, model, systemPromptManager, historyProvider, sessionEventBus, config, sessionId, resourceManager, logger, compactionStrategy, compactionConfig) {
     this.logger = logger.createChild(DextoLogComponent.LLM);
     this.model = model;
     this.config = config;
@@ -44,9 +46,20 @@ class VercelLLMService {
     this.sessionId = sessionId;
     this.resourceManager = resourceManager;
     this.compactionStrategy = compactionStrategy ?? null;
+    this.compactionThresholdPercent = compactionConfig?.thresholdPercent ?? 0.9;
     this.messageQueue = new MessageQueueService(this.sessionEventBus, this.logger);
     const formatter = new VercelMessageFormatter(this.logger);
     const maxInputTokens = getEffectiveMaxInputTokens(config, this.logger);
+    let effectiveContextWindow = maxInputTokens;
+    if (compactionConfig?.maxContextTokens !== void 0) {
+      effectiveContextWindow = Math.min(maxInputTokens, compactionConfig.maxContextTokens);
+      this.logger.debug(
+        `Compaction: Using maxContextTokens override: ${compactionConfig.maxContextTokens} (model max: ${maxInputTokens})`
+      );
+    }
+    this.modelLimits = {
+      contextWindow: effectiveContextWindow
+    };
     this.contextManager = new ContextManager(
       config,
       formatter,
@@ -86,19 +99,23 @@ class VercelLLMService {
       { provider: this.config.provider, model: this.getModelId() },
       this.logger,
       this.messageQueue,
-      void 0,
-      // modelLimits - TurnExecutor will use defaults
+      this.modelLimits,
       externalSignal,
-      this.compactionStrategy
+      this.compactionStrategy,
+      this.compactionThresholdPercent
     );
   }
+  /**
+   * Result from streaming a response.
+   */
+  static StreamResult;
   /**
    * Stream a response for the given content.
    * Primary method for running conversations with multi-image support.
    *
    * @param content - String or ContentPart[] (text, images, files)
    * @param options - { signal?: AbortSignal }
-   * @returns The assistant's text response
+   * @returns Object with text response, whether compaction occurred, and compaction data if applicable
    */
   async stream(content, options) {
     const activeSpan = trace.getActiveSpan();
@@ -128,7 +145,12 @@ class VercelLLMService {
       const executor = this.createTurnExecutor(options?.signal);
       const contributorContext = { mcpManager: this.toolManager.getMcpManager() };
       const result = await executor.execute(contributorContext, true);
-      return result.text ?? "";
+      return {
+        text: result.text ?? "",
+        didCompact: result.didCompact,
+        // Use spread to conditionally include compaction (exactOptionalPropertyTypes)
+        ...result.compaction && { compaction: result.compaction }
+      };
     });
   }
   /**
@@ -173,6 +195,12 @@ class VercelLLMService {
   getMessageQueue() {
     return this.messageQueue;
   }
+  /**
+   * Get the compaction strategy for external access (e.g., session-native compaction)
+   */
+  getCompactionStrategy() {
+    return this.compactionStrategy;
+  }
 }
 _init = __decoratorStart(null);
 VercelLLMService = __decorateElement(_init, 0, "VercelLLMService", _VercelLLMService_decorators, VercelLLMService);

package/dist/session/chat-session.cjs

@@ -169,8 +169,10 @@ class ChatSession {
       // Pass ResourceManager for blob storage
       this.logger,
       // Pass logger for dependency injection
-      compactionStrategy
+      compactionStrategy,
       // Pass compaction strategy
+      runtimeConfig.compaction
+      // Pass compaction config for threshold settings
     );
     this.logger.debug(`ChatSession ${this.id}: Services initialized with storage`);
   }
@@ -210,15 +212,15 @@ class ChatSession {
    *
    * @param content - String or ContentPart[] (text, images, files)
    * @param options - { signal?: AbortSignal }
-   * @returns Promise that resolves to the AI's response text
+   * @returns Promise that resolves to object with text and compaction status
    *
    * @example
    * ```typescript
    * // Text only
-   * const response = await session.stream('What is the weather?');
+   * const { text, didCompact } = await session.stream('What is the weather?');
    *
    * // Multiple images
-   * const response = await session.stream([
+   * const { text, didCompact } = await session.stream([
    *     { type: 'text', text: 'Compare these images' },
    *     { type: 'image', image: base64Data1, mimeType: 'image/png' },
    *     { type: 'image', image: base64Data2, mimeType: 'image/png' }
@@ -275,10 +277,10 @@ class ChatSession {
         modifiedParts = modifiedParts.filter((p) => p.type !== "text");
         modifiedParts.unshift({ type: "text", text: modifiedBeforePayload.text });
       }
-      const response = await this.llmService.stream(modifiedParts, { signal });
+      const streamResult = await this.llmService.stream(modifiedParts, { signal });
       const llmConfig = this.services.stateManager.getLLMConfig(this.id);
       const beforeResponsePayload = {
-        content: response,
+        content: streamResult.text,
         provider: llmConfig.provider,
         model: llmConfig.model,
         sessionId: this.id
@@ -295,7 +297,12 @@ class ChatSession {
           abortSignal: signal
         }
       );
-      return modifiedResponsePayload.content;
+      return {
+        text: modifiedResponsePayload.content,
+        didCompact: streamResult.didCompact,
+        // Use spread to conditionally include compaction (exactOptionalPropertyTypes)
+        ...streamResult.compaction && { compaction: streamResult.compaction }
+      };
     } catch (error) {
       const aborted = error instanceof Error && error.name === "AbortError" || typeof error === "object" && error !== null && error.aborted === true;
       if (aborted) {
@@ -308,12 +315,12 @@ class ChatSession {
           const history = await this.getHistory();
           const lastAssistant = history.filter((m) => m.role === "assistant").pop();
           if (lastAssistant && typeof lastAssistant.content === "string") {
-            return lastAssistant.content;
+            return { text: lastAssistant.content, didCompact: false };
           }
         } catch {
           this.logger.debug("Failed to retrieve partial response from history on cancel");
         }
-        return "";
+        return { text: "", didCompact: false };
       }
       if (error instanceof import_errors.DextoRuntimeError && error.code === import_error_codes.PluginErrorCode.PLUGIN_BLOCKED_EXECUTION && error.scope === import_errors.ErrorScope.PLUGIN && error.type === import_errors.ErrorType.FORBIDDEN) {
         const textContent = parts.filter((p) => p.type === "text").map((p) => p.text).join("\n");
@@ -327,7 +334,7 @@ class ChatSession {
             `Failed to save blocked interaction to history: ${saveError instanceof Error ? saveError.message : String(saveError)}`
           );
         }
-        return error.message;
+        return { text: error.message, didCompact: false };
       }
       this.logger.error(
         `Error in ChatSession.stream: ${error instanceof Error ? error.message : String(error)}`
@@ -455,8 +462,10 @@ class ChatSession {
         this.id,
         this.services.resourceManager,
         this.logger,
-        compactionStrategy
+        compactionStrategy,
         // Pass compaction strategy
+        runtimeConfig.compaction
+        // Pass compaction config for threshold settings
       );
       this.llmService = newLLMService;
       this.logger.info(

package/dist/session/chat-session.d.ts

@@ -12,6 +12,7 @@ import type { IDextoLogger } from '../logger/v2/types.js';
 import type { InternalMessage } from '../context/types.js';
 import type { UserMessageInput } from './message-queue.js';
 import type { ContentInput } from '../agent/types.js';
+import type { CompactionData } from '../llm/executor/types.js';
 /**
  * Represents an isolated conversation session within a Dexto agent.
  *
@@ -162,15 +163,15 @@ export declare class ChatSession {
      *
      * @param content - String or ContentPart[] (text, images, files)
      * @param options - { signal?: AbortSignal }
-     * @returns Promise that resolves to the AI's response text
+     * @returns Promise that resolves to object with text and compaction status
      *
      * @example
      * ```typescript
      * // Text only
-     * const response = await session.stream('What is the weather?');
+     * const { text, didCompact } = await session.stream('What is the weather?');
      *
      * // Multiple images
-     * const response = await session.stream([
+     * const { text, didCompact } = await session.stream([
      *     { type: 'text', text: 'Compare these images' },
      *     { type: 'image', image: base64Data1, mimeType: 'image/png' },
      *     { type: 'image', image: base64Data2, mimeType: 'image/png' }
@@ -179,7 +180,11 @@ export declare class ChatSession {
      */
     stream(content: ContentInput, options?: {
         signal?: AbortSignal;
-    }): Promise<string>;
+    }): Promise<{
+        text: string;
+        didCompact: boolean;
+        compaction?: CompactionData;
+    }>;
     /**
      * Combine multiple abort signals into one.
      */

package/dist/session/chat-session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-session.d.ts","sourceRoot":"","sources":["../../src/session/chat-session.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"chat-session.d.ts","sourceRoot":"","sources":["../../src/session/chat-session.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EACH,eAAe,EACf,aAAa,EAIhB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAI1D,OAAO,KAAK,EAAE,eAAe,EAAe,MAAM,qBAAqB,CAAC;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,qBAAa,WAAW;IA6DhB,OAAO,CAAC,QAAQ;aAWA,EAAE,EAAE,MAAM;IAvE9B;;;;;;;;;;OAUG;IACH,SAAgB,QAAQ,EAAE,eAAe,CAAC;IAE1C;;;OAGG;IACH,OAAO,CAAC,eAAe,CAAgC;IAEvD;;;;;OAKG;IACH,OAAO,CAAC,UAAU,CAAoB;IAEtC;;;OAGG;IACH,OAAO,CAAC,UAAU,CAA6D;IAE/E;;OAEG;IACH,OAAO,CAAC,wBAAwB,CACvB;IAET;;;OAGG;IACH,OAAO,CAAC,oBAAoB,CAAgC;IAE5D,OAAO,CAAC,MAAM,CAAe;IAE7B;;;;;;;;;;;OAWG;gBAES,QAAQ,EAAE;QACd,YAAY,EAAE,iBAAiB,CAAC;QAChC,mBAAmB,EAAE,mBAAmB,CAAC;QACzC,WAAW,EAAE,WAAW,CAAC;QACzB,aAAa,EAAE,aAAa,CAAC;QAC7B,cAAc,EAAE,cAAc,CAAC;QAC/B,eAAe,EAAE,OAAO,uBAAuB,EAAE,eAAe,CAAC;QACjE,aAAa,EAAE,aAAa,CAAC;QAC7B,UAAU,EAAE,UAAU,CAAC;QACvB,cAAc,EAAE,OAAO,sBAAsB,EAAE,cAAc,CAAC;KACjE,EACe,EAAE,EAAE,MAAM,EAC1B,MAAM,EAAE,YAAY;IAaxB;;;OAGG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIlC;;;;;;;OAOG;IACH,OAAO,CAAC,oBAAoB;IA4B5B;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAyB9B;;OAEG;YACW,kBAAkB;IAsChC;;;;;;;;;;OAUG;YACW,sBAAsB;IAoCpC;;;;;;;;;;;;;;;;;;;;OAoBG;IACU,MAAM,CACf,OAAO,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACnC,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,cAAc,CAAA;KAAE,CAAC;IAqK9E;;OAEG;IACH,OAAO,CAAC,cAAc;IAetB;;;;;;;;;;;;;;;;;;;;OAoBG;IACU,UAAU;IAIvB;;;;;;;;;;;;;;;;;;;;OAoBG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAUnC;;;;OAIG;IACI,iBAAiB,IAAI,cAAc,CAAC,OAAO,CAAC;IAInD;;;;OAIG;IACI,aAAa,IAAI,gBAAgB;IAIxC;;;;;;;;;;;;;;;;;;OAkBG;IACU,SAAS,CAAC,YAAY,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IA+CvE;;;;OAIG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBrC;;;;;;OAMG;IACI,OAAO,IAAI,IAAI;IAoBtB;;;OAGG;IACI,MAAM,IAAI,OAAO;IAIxB;;;;;;OAMG;IACI,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG;QAAE,MAAM,EAAE,IAAI,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE;IAI9F;;;OAGG;IACI,iBAAiB,IAAI,OAAO,YAAY,EAAE,aAAa,EAAE;IAIhE;;;;OAIG;IACI,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI/C;;;OAGG;IACI,iBAAiB,IAAI,MAAM;IAOlC;;;OAGG;IACI,MAAM,IAAI,OAAO;CAa3B"}

package/dist/session/chat-session.js

@@ -150,8 +150,10 @@ class ChatSession {
       // Pass ResourceManager for blob storage
       this.logger,
       // Pass logger for dependency injection
-      compactionStrategy
+      compactionStrategy,
       // Pass compaction strategy
+      runtimeConfig.compaction
+      // Pass compaction config for threshold settings
     );
     this.logger.debug(`ChatSession ${this.id}: Services initialized with storage`);
   }
@@ -191,15 +193,15 @@ class ChatSession {
    *
    * @param content - String or ContentPart[] (text, images, files)
    * @param options - { signal?: AbortSignal }
-   * @returns Promise that resolves to the AI's response text
+   * @returns Promise that resolves to object with text and compaction status
    *
    * @example
    * ```typescript
    * // Text only
-   * const response = await session.stream('What is the weather?');
+   * const { text, didCompact } = await session.stream('What is the weather?');
    *
    * // Multiple images
-   * const response = await session.stream([
+   * const { text, didCompact } = await session.stream([
    *     { type: 'text', text: 'Compare these images' },
    *     { type: 'image', image: base64Data1, mimeType: 'image/png' },
    *     { type: 'image', image: base64Data2, mimeType: 'image/png' }
@@ -256,10 +258,10 @@ class ChatSession {
         modifiedParts = modifiedParts.filter((p) => p.type !== "text");
         modifiedParts.unshift({ type: "text", text: modifiedBeforePayload.text });
       }
-      const response = await this.llmService.stream(modifiedParts, { signal });
+      const streamResult = await this.llmService.stream(modifiedParts, { signal });
       const llmConfig = this.services.stateManager.getLLMConfig(this.id);
       const beforeResponsePayload = {
-        content: response,
+        content: streamResult.text,
         provider: llmConfig.provider,
         model: llmConfig.model,
         sessionId: this.id
@@ -276,7 +278,12 @@ class ChatSession {
           abortSignal: signal
         }
       );
-      return modifiedResponsePayload.content;
+      return {
+        text: modifiedResponsePayload.content,
+        didCompact: streamResult.didCompact,
+        // Use spread to conditionally include compaction (exactOptionalPropertyTypes)
+        ...streamResult.compaction && { compaction: streamResult.compaction }
+      };
     } catch (error) {
       const aborted = error instanceof Error && error.name === "AbortError" || typeof error === "object" && error !== null && error.aborted === true;
       if (aborted) {
@@ -289,12 +296,12 @@ class ChatSession {
           const history = await this.getHistory();
           const lastAssistant = history.filter((m) => m.role === "assistant").pop();
           if (lastAssistant && typeof lastAssistant.content === "string") {
-            return lastAssistant.content;
+            return { text: lastAssistant.content, didCompact: false };
           }
         } catch {
           this.logger.debug("Failed to retrieve partial response from history on cancel");
         }
-        return "";
+        return { text: "", didCompact: false };
       }
       if (error instanceof DextoRuntimeError && error.code === PluginErrorCode.PLUGIN_BLOCKED_EXECUTION && error.scope === ErrorScope.PLUGIN && error.type === ErrorType.FORBIDDEN) {
         const textContent = parts.filter((p) => p.type === "text").map((p) => p.text).join("\n");
@@ -308,7 +315,7 @@ class ChatSession {
             `Failed to save blocked interaction to history: ${saveError instanceof Error ? saveError.message : String(saveError)}`
           );
         }
-        return error.message;
+        return { text: error.message, didCompact: false };
       }
       this.logger.error(
         `Error in ChatSession.stream: ${error instanceof Error ? error.message : String(error)}`
@@ -436,8 +443,10 @@ class ChatSession {
         this.id,
         this.services.resourceManager,
         this.logger,
-        compactionStrategy
+        compactionStrategy,
         // Pass compaction strategy
+        runtimeConfig.compaction
+        // Pass compaction config for threshold settings
       );
       this.llmService = newLLMService;
       this.logger.info(

package/dist/session/compaction-service.cjs

@@ -0,0 +1,139 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var compaction_service_exports = {};
+__export(compaction_service_exports, {
+  SessionCompactionService: () => SessionCompactionService
+});
+module.exports = __toCommonJS(compaction_service_exports);
+var import_types = require("../logger/v2/types.js");
+var import_utils = require("../context/utils.js");
+class SessionCompactionService {
+  constructor(sessionManager, compactionStrategy, logger) {
+    this.sessionManager = sessionManager;
+    this.compactionStrategy = compactionStrategy;
+    this.logger = logger.createChild(import_types.DextoLogComponent.SESSION);
+  }
+  logger;
+  /**
+   * Perform session-native compaction.
+   *
+   * This creates a new continuation session with the summary as initial context,
+   * then marks the old session as compacted.
+   *
+   * @param currentSession The session to compact
+   * @param options Compaction options
+   * @returns CompactionResult with new session, or null if compaction not needed/possible
+   */
+  async compact(currentSession, options) {
+    const { reason, eventBus } = options;
+    const currentSessionId = currentSession.id;
+    this.logger.info(
+      `SessionCompactionService: Starting compaction for session ${currentSessionId} (reason: ${reason})`
+    );
+    const history = await currentSession.getHistory();
+    if (history.length <= 2) {
+      this.logger.debug("SessionCompactionService: History too short for compaction");
+      return null;
+    }
+    const summaryMessages = await this.compactionStrategy.compact(history);
+    if (summaryMessages.length === 0) {
+      this.logger.debug("SessionCompactionService: Strategy returned no summary");
+      return null;
+    }
+    const strategySummary = summaryMessages[0];
+    if (!strategySummary || !strategySummary.content) {
+      return null;
+    }
+    const summaryText = this.extractTextContent(strategySummary.content);
+    if (!summaryText.trim()) {
+      this.logger.debug("SessionCompactionService: Empty summary text; skipping compaction");
+      return null;
+    }
+    const summaryMessage = {
+      role: "assistant",
+      content: [{ type: "text", text: summaryText }],
+      timestamp: Date.now(),
+      metadata: {
+        isSessionSummary: true,
+        // New marker for session-native compaction
+        continuedFrom: currentSessionId,
+        summarizedAt: Date.now(),
+        originalMessageCount: history.length,
+        originalFirstTimestamp: history[0]?.timestamp,
+        originalLastTimestamp: history[history.length - 1]?.timestamp
+      }
+    };
+    const summaryTokens = (0, import_utils.estimateMessagesTokens)([summaryMessage]);
+    const { sessionId: newSessionId, session: newSession } = await this.sessionManager.createContinuationSession(currentSessionId);
+    const contextManager = newSession.getContextManager();
+    await contextManager.addMessage(summaryMessage);
+    await this.sessionManager.markSessionCompacted(currentSessionId, newSessionId);
+    this.logger.info(
+      `SessionCompactionService: Compaction complete. ${currentSessionId} \u2192 ${newSessionId}, ${history.length} messages \u2192 summary (~${summaryTokens} tokens)`
+    );
+    if (eventBus) {
+      const llmConfig = newSession.getLLMService().getConfig();
+      const modelId = typeof llmConfig.model === "string" ? llmConfig.model : llmConfig.model.modelId;
+      const { getModelDisplayName } = await import("../llm/registry.js");
+      const modelDisplayName = getModelDisplayName(modelId, llmConfig.provider);
+      eventBus.emit("session:continued", {
+        previousSessionId: currentSessionId,
+        newSessionId,
+        summaryTokens,
+        originalMessages: history.length,
+        reason,
+        sessionId: newSessionId,
+        // For consistency with other streaming events
+        model: modelId,
+        modelDisplayName
+      });
+    }
+    return {
+      previousSessionId: currentSessionId,
+      newSessionId,
+      newSession,
+      summary: summaryMessage,
+      summaryTokens,
+      originalMessages: history.length
+    };
+  }
+  /**
+   * Extract text content from message content.
+   */
+  extractTextContent(content) {
+    if (typeof content === "string") {
+      return content;
+    }
+    return content.filter((part) => part.type === "text").map((part) => part.text).join("\n");
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SessionCompactionService
+});