@dexto/core 1.5.2 → 1.5.4

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
+});

package/dist/session/compaction-service.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Session Compaction Service
+ *
+ * Handles session-native compaction where compacting a session creates a new
+ * continuation session with the summary as initial context. This provides
+ * clean session isolation with linking for traceability.
+ *
+ * ## Architecture
+ *
+ * Session A (compacted) --continuedTo--> Session B (active)
+ *       ^                                      |
+ *       +--------continuedFrom-----------------+
+ *
+ * When compaction triggers:
+ * 1. Generate summary of old messages via compaction strategy
+ * 2. Create new session with summary as first message (isSessionSummary marker)
+ * 3. Mark old session as compacted (continuedTo, compactedAt)
+ * 4. Emit session:continued event
+ * 5. Return new session for caller to switch to
+ */
+import type { ICompactionStrategy } from '../context/compaction/types.js';
+import type { IDextoLogger } from '../logger/v2/types.js';
+import type { SessionManager } from './session-manager.js';
+import type { ChatSession } from './chat-session.js';
+import type { InternalMessage } from '../context/types.js';
+import type { AgentEventBus } from '../events/index.js';
+/**
+ * Result returned when compaction creates a new continuation session.
+ */
+export interface CompactionResult {
+    /** The session that was compacted */
+    previousSessionId: string;
+    /** The new session created for continuation */
+    newSessionId: string;
+    /** The ChatSession instance for the new session */
+    newSession: ChatSession;
+    /** The summary message added to the new session */
+    summary: InternalMessage;
+    /** Estimated tokens in the summary */
+    summaryTokens: number;
+    /** Number of messages that were summarized */
+    originalMessages: number;
+}
+/**
+ * Options for performing compaction.
+ */
+export interface CompactOptions {
+    /** Why the compaction was triggered */
+    reason: 'overflow' | 'manual';
+    /** Optional AgentEventBus to emit session:continued event */
+    eventBus?: AgentEventBus;
+}
+/**
+ * Service for performing session-native compaction.
+ *
+ * Instead of adding a summary message to the same session and filtering at read-time,
+ * this service creates a new session with the summary as the first message.
+ * This provides cleaner session isolation while maintaining traceability via linking.
+ */
+export declare class SessionCompactionService {
+    private readonly sessionManager;
+    private readonly compactionStrategy;
+    private readonly logger;
+    constructor(sessionManager: SessionManager, compactionStrategy: ICompactionStrategy, logger: IDextoLogger);
+    /**
+     * 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
+     */
+    compact(currentSession: ChatSession, options: CompactOptions): Promise<CompactionResult | null>;
+    /**
+     * Extract text content from message content.
+     */
+    private extractTextContent;
+}
+//# sourceMappingURL=compaction-service.d.ts.map

package/dist/session/compaction-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction-service.d.ts","sourceRoot":"","sources":["../../src/session/compaction-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAe,MAAM,qBAAqB,CAAC;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAIxD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,qCAAqC;IACrC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,UAAU,EAAE,WAAW,CAAC;IACxB,mDAAmD;IACnD,OAAO,EAAE,eAAe,CAAC;IACzB,sCAAsC;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,gBAAgB,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,uCAAuC;IACvC,MAAM,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC9B,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,aAAa,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,qBAAa,wBAAwB;IAI7B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IAJvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAGjB,cAAc,EAAE,cAAc,EAC9B,kBAAkB,EAAE,mBAAmB,EACxD,MAAM,EAAE,YAAY;IAKxB;;;;;;;;;OASG;IACG,OAAO,CACT,cAAc,EAAE,WAAW,EAC3B,OAAO,EAAE,cAAc,GACxB,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IA6GnC;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAS7B"}

package/dist/session/compaction-service.js

@@ -0,0 +1,106 @@
+import "../chunk-PTJYTZNU.js";
+import { DextoLogComponent } from "../logger/v2/types.js";
+import { estimateMessagesTokens } from "../context/utils.js";
+class SessionCompactionService {
+  constructor(sessionManager, compactionStrategy, logger) {
+    this.sessionManager = sessionManager;
+    this.compactionStrategy = compactionStrategy;
+    this.logger = logger.createChild(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 = 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");
+  }
+}
+export {
+  SessionCompactionService
+};

package/dist/session/session-manager.cjs

@@ -516,6 +516,152 @@ class SessionManager {
       sessionTTL: this.sessionTTL
     };
   }
+  /**
+   * Get the raw session data for a session ID.
+   * This is used for accessing continuation fields and other metadata.
+   *
+   * @param sessionId The session ID
+   * @returns Session data if found, undefined otherwise
+   */
+  async getSessionData(sessionId) {
+    await this.ensureInitialized();
+    const sessionKey = `session:${sessionId}`;
+    return await this.services.storageManager.getDatabase().get(sessionKey);
+  }
+  /**
+   * Creates a continuation session from a compacted session.
+   * The new session will have the summary as its first message.
+   *
+   * @param fromSessionId The session being compacted
+   * @returns The new session ID and ChatSession
+   */
+  async createContinuationSession(fromSessionId) {
+    await this.ensureInitialized();
+    const fromSessionData = await this.getSessionData(fromSessionId);
+    if (!fromSessionData) {
+      throw import_errors.SessionError.notFound(fromSessionId);
+    }
+    const activeSessionKeys = await this.services.storageManager.getDatabase().list("session:");
+    if (activeSessionKeys.length >= this.maxSessions) {
+      throw import_errors.SessionError.maxSessionsExceeded(activeSessionKeys.length, this.maxSessions);
+    }
+    const newSessionId = (0, import_crypto.randomUUID)();
+    const originalLLMConfig = this.services.stateManager.getRuntimeConfig(fromSessionId).llm;
+    this.services.stateManager.updateLLM(originalLLMConfig, newSessionId);
+    const parentCompactionCount = fromSessionData.compactionCount ?? 0;
+    const newSessionData = {
+      id: newSessionId,
+      createdAt: Date.now(),
+      lastActivity: Date.now(),
+      messageCount: 0,
+      continuedFrom: fromSessionId,
+      compactionCount: parentCompactionCount + 1,
+      ...fromSessionData.userId !== void 0 && { userId: fromSessionData.userId },
+      ...fromSessionData.metadata && {
+        metadata: {
+          ...fromSessionData.metadata,
+          title: fromSessionData.metadata?.title
+          // Preserve title
+        }
+      }
+    };
+    const sessionKey = `session:${newSessionId}`;
+    try {
+      await this.services.storageManager.getDatabase().set(sessionKey, newSessionData);
+      await this.services.storageManager.getCache().set(sessionKey, newSessionData, this.sessionTTL / 1e3);
+    } catch (error) {
+      this.services.stateManager.clearSessionOverride(newSessionId);
+      throw error;
+    }
+    const session = new import_chat_session.ChatSession(
+      { ...this.services, sessionManager: this },
+      newSessionId,
+      this.logger
+    );
+    try {
+      await session.init();
+    } catch (error) {
+      session.dispose();
+      await this.services.storageManager.getDatabase().delete(sessionKey);
+      await this.services.storageManager.getCache().delete(sessionKey);
+      this.services.stateManager.clearSessionOverride(newSessionId);
+      throw error;
+    }
+    this.sessions.set(newSessionId, session);
+    this.logger.info(
+      `Created continuation session ${newSessionId} from compacted session ${fromSessionId}`
+    );
+    return { sessionId: newSessionId, session };
+  }
+  /**
+   * Marks a session as compacted and links it to its continuation session.
+   *
+   * @param sessionId The session being compacted
+   * @param continuedToId The new session created from compaction
+   */
+  async markSessionCompacted(sessionId, continuedToId) {
+    await this.ensureInitialized();
+    const sessionKey = `session:${sessionId}`;
+    const sessionData = await this.services.storageManager.getDatabase().get(sessionKey);
+    if (!sessionData) {
+      throw import_errors.SessionError.notFound(sessionId);
+    }
+    sessionData.continuedTo = continuedToId;
+    sessionData.compactedAt = Date.now();
+    sessionData.lastActivity = Date.now();
+    await this.services.storageManager.getDatabase().set(sessionKey, sessionData);
+    await this.services.storageManager.getCache().set(sessionKey, sessionData, this.sessionTTL / 1e3);
+    this.logger.debug(`Marked session ${sessionId} as compacted \u2192 ${continuedToId}`);
+  }
+  /**
+   * Gets the compaction count for a session.
+   * Returns 0 if the session has never been compacted.
+   *
+   * @param sessionId The session ID
+   * @returns Number of times this session chain has been compacted
+   */
+  async getCompactionCount(sessionId) {
+    const sessionData = await this.getSessionData(sessionId);
+    return sessionData?.compactionCount ?? 0;
+  }
+  /**
+   * Gets the chain of linked sessions (ancestors and descendants).
+   * Returns sessions in chronological order (oldest first).
+   *
+   * @param sessionId Any session ID in the chain
+   * @returns Array of session data in the chain, ordered chronologically
+   */
+  async getSessionChain(sessionId) {
+    await this.ensureInitialized();
+    const chain = [];
+    const visited = /* @__PURE__ */ new Set();
+    let currentData = await this.getSessionData(sessionId);
+    if (!currentData) {
+      return [];
+    }
+    while (currentData?.continuedFrom && !visited.has(currentData.continuedFrom)) {
+      visited.add(currentData.id);
+      const parent = await this.getSessionData(currentData.continuedFrom);
+      if (!parent) {
+        break;
+      }
+      currentData = parent;
+    }
+    if (currentData && !visited.has(currentData.id)) {
+      visited.add(currentData.id);
+    }
+    visited.clear();
+    while (currentData && !visited.has(currentData.id)) {
+      visited.add(currentData.id);
+      chain.push(currentData);
+      if (currentData.continuedTo) {
+        currentData = await this.getSessionData(currentData.continuedTo);
+      } else {
+        break;
+      }
+    }
+    return chain;
+  }
   /**
    * Cleanup all sessions and resources.
    * This should be called when shutting down the application.

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

@@ -34,6 +34,14 @@ export interface SessionData {
     metadata?: Record<string, any>;
     tokenUsage?: SessionTokenUsage;
     estimatedCost?: number;
+    /** Parent session that was compacted to create this session */
+    continuedFrom?: string;
+    /** Child session created when this session was compacted */
+    continuedTo?: string;
+    /** Timestamp when this session was compacted (created a continuation) */
+    compactedAt?: number;
+    /** Number of times this session chain has been compacted (inherited + 1 on each compaction) */
+    compactionCount?: number;
 }
 /**
  * Manages multiple chat sessions within a Dexto agent.
@@ -204,6 +212,48 @@ export declare class SessionManager {
         maxSessions: number;
         sessionTTL: number;
     }>;
+    /**
+     * Get the raw session data for a session ID.
+     * This is used for accessing continuation fields and other metadata.
+     *
+     * @param sessionId The session ID
+     * @returns Session data if found, undefined otherwise
+     */
+    getSessionData(sessionId: string): Promise<SessionData | undefined>;
+    /**
+     * Creates a continuation session from a compacted session.
+     * The new session will have the summary as its first message.
+     *
+     * @param fromSessionId The session being compacted
+     * @returns The new session ID and ChatSession
+     */
+    createContinuationSession(fromSessionId: string): Promise<{
+        sessionId: string;
+        session: ChatSession;
+    }>;
+    /**
+     * Marks a session as compacted and links it to its continuation session.
+     *
+     * @param sessionId The session being compacted
+     * @param continuedToId The new session created from compaction
+     */
+    markSessionCompacted(sessionId: string, continuedToId: string): Promise<void>;
+    /**
+     * Gets the compaction count for a session.
+     * Returns 0 if the session has never been compacted.
+     *
+     * @param sessionId The session ID
+     * @returns Number of times this session chain has been compacted
+     */
+    getCompactionCount(sessionId: string): Promise<number>;
+    /**
+     * Gets the chain of linked sessions (ancestors and descendants).
+     * Returns sessions in chronological order (oldest first).
+     *
+     * @param sessionId Any session ID in the chain
+     * @returns Array of session data in the chain, ordered chronologically
+     */
+    getSessionChain(sessionId: string): Promise<SessionData[]>;
     /**
      * Cleanup all sessions and resources.
      * This should be called when shutting down the application.

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

@@ -1 +1 @@
-{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../src/session/session-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../src/session/session-manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;AAErD,MAAM,WAAW,eAAe;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+FAA+F;IAC/F,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,cAAc;IAcnB,OAAO,CAAC,QAAQ;IAbpB,OAAO,CAAC,QAAQ,CAAuC;IACvD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,eAAe,CAAC,CAAiB;IACzC,OAAO,CAAC,qBAAqB,CAAiB;IAE9C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA2C;IAE5E,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAoC;IACpE,OAAO,CAAC,MAAM,CAAe;gBAGjB,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,OAAO,mBAAmB,EAAE,UAAU,CAAC;KACtD,EACD,MAAM,EAAE,oBAAoB,YAAK,EACjC,MAAM,EAAE,YAAY;IAOxB;;;OAGG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAyBlC;;;OAGG;YACW,0BAA0B;IAmCxC;;OAEG;YACW,iBAAiB;IAS/B;;;;;;OAMG;IACU,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IA6BpE;;;OAGG;YACW,qBAAqB;IA4EnC;;;;;;OAMG;IACU,UAAU,CACnB,SAAS,EAAE,MAAM,EACjB,kBAAkB,GAAE,OAAc,GACnC,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAmCnC;;;;;OAKG;IACU,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBzD;;;;;OAKG;IACU,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB5D;;;;;OAKG;IACU,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4B3D;;;;OAIG;IACU,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAM9C;;;;;OAKG;IACU,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAoBxF;;OAEG;IACI,SAAS,IAAI,oBAAoB;IAOxC;;OAEG;YACW,qBAAqB;IAgBnC;;OAEG;IACU,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBpE;;;;;OAKG;IACU,oBAAoB,CAC7B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,UAAU,EACjB,IAAI,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;IA8DhB;;;OAGG;IACU,eAAe,CACxB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAO,GACrC,OAAO,CAAC,IAAI,CAAC;IA2BhB;;OAEG;IACU,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAS5E;;;OAGG;YACW,sBAAsB;IAoCpC;;;;OAIG;IACU,uBAAuB,CAChC,YAAY,EAAE,kBAAkB,GACjC,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IA4CnD;;;;;OAKG;IACU,2BAA2B,CACpC,YAAY,EAAE,kBAAkB,EAChC,SAAS,EAAE,MAAM,GAClB,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAmBnD;;OAEG;IACU,eAAe,IAAI,OAAO,CAAC;QACpC,aAAa,EAAE,MAAM,CAAC;QACtB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;KACtB,CAAC;IAcF;;;;;;OAMG;IACU,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAMhF;;;;;;OAMG;IACU,yBAAyB,CAClC,aAAa,EAAE,MAAM,GACtB,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,WAAW,CAAA;KAAE,CAAC;IAuFvD;;;;;OAKG;IACU,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB1F;;;;;;OAMG;IACU,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKnE;;;;;;OAMG;IACU,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA4CvE;;;OAGG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CA4BxC"}