booths 2.0.0-1 → 2.0.0-2

package/dist/index.d.ts

@@ -592,6 +592,9 @@ export declare class ContextProviderPlugin implements BoothPlugin {
  * interaction has access to the full conversation history, enabling contextual responses.
  */
 export declare class ConversationHistoryPlugin implements BoothPlugin {
+    private onCompactStart;
+    private onCompactEnd;
+    private tokenCompactionThreshold;
     /**
      * The sessionHistory variable stores the conversation history between the user and the booth system.
      * It is initialized as an empty array and will be populated with messages exchanged during the interaction.
@@ -626,8 +629,11 @@ export declare class ConversationHistoryPlugin implements BoothPlugin {
      * Constructs a new instance with an optional session history.
      *
      * @param {ResponseInput[]} [sessionHistory=[]] - An array representing the session history. Defaults to an empty array if not provided.
+     * @param onCompactStart
+     * @param onCompactEnd
+     * @param tokenCompactionThreshold
      */
-    constructor(sessionHistory?: ResponseInput);
+    constructor(sessionHistory?: ResponseInput, onCompactStart?: () => void, onCompactEnd?: () => void, tokenCompactionThreshold?: number);
     /**
      * Retrieves the session history.
      *
@@ -648,6 +654,65 @@ export declare class ConversationHistoryPlugin implements BoothPlugin {
      * Returns the plugin's description.
      */
     get description(): string;
+    /**
+     * Checks if the conversation history should be compacted.
+     *
+     * @param response - The response from the LLM
+     * @returns True if compaction is needed, false otherwise
+     * @private
+     */
+    private shouldCompactHistory;
+    /**
+     * Creates the summarization prompt for compacting conversation history.
+     *
+     * @returns The formatted summarization prompt
+     * @private
+     */
+    private createSummarizationPrompt;
+    /**
+     * Extracts summary text from the LLM's summary response.
+     *
+     * @param summary - The output from the summarizer booth
+     * @returns The extracted summary text
+     * @private
+     */
+    private extractSummaryText;
+    /**
+     * Finds unresolved function calls from the history.
+     * A function call is considered unresolved if it doesn't have a matching output.
+     *
+     * @param history - The conversation history to search
+     * @returns Array of unresolved function call items
+     * @private
+     */
+    private findUnresolvedFunctionCalls;
+    /**
+     * Gets the last user message from the history.
+     *
+     * @param history - The conversation history
+     * @returns The last user message, or undefined if none exists
+     * @private
+     */
+    private getLastUserMessage;
+    /**
+     * Builds the compacted conversation history.
+     *
+     * @param functionCalls - Unresolved function calls to include
+     * @param summaryText - The summary text from the LLM
+     * @param lastUserMessage - The last user message, if any
+     * @returns The compacted history
+     * @private
+     */
+    private buildCompactedHistory;
+    /**
+     * Compacts the conversation history by summarizing it.
+     *
+     * @param utilities - Repository utilities for accessing the LLM adapter
+     * @param newHistory - The current full history to compact
+     * @returns The compacted history
+     * @private
+     */
+    private compactHistory;
     /**
      * Executes before the interaction loop starts, adding the current user input to the
      * conversation history and updating the response parameters with the complete history.
@@ -765,6 +830,11 @@ export declare class CoreBooth<T> {
         sessionHistory?: ResponseInput;
         endInteractionLoopMarker?: string;
         loopLimit?: number;
+        compactOptions?: {
+            onCompactStart?: () => void;
+            onCompactEnd?: () => void;
+            tokenCompactionThreshold?: number;
+        };
     });
 }