booths 2.0.0-0 → 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.
@@ -764,6 +829,12 @@ export declare class CoreBooth<T> {
         llmAdapter: LLMAdapter<T>;
         sessionHistory?: ResponseInput;
         endInteractionLoopMarker?: string;
+        loopLimit?: number;
+        compactOptions?: {
+            onCompactStart?: () => void;
+            onCompactEnd?: () => void;
+            tokenCompactionThreshold?: number;
+        };
     });
 }
 
@@ -774,9 +845,15 @@ export declare class CoreBooth<T> {
  *
  * @param llmAdapter - The LLM adapter for communication with the language model.
  * @param boothConfig - The configuration for the single booth to be used.
+ * @param options - Optional configuration for the CoreBooth instance.
+ * @param options.endInteractionLoopMarker - Custom marker to signal end of interaction loop.
+ * @param options.loopLimit - Maximum number of interaction loop iterations (default: 10).
  * @returns A fully configured CoreBooth instance.
  */
-export declare function createCoreBooth<T>(llmAdapter: LLMAdapter<T>, boothConfig: BoothConfig): CoreBooth<T>;
+export declare function createCoreBooth<T>(llmAdapter: LLMAdapter<T>, boothConfig: BoothConfig, options?: {
+    endInteractionLoopMarker?: string;
+    loopLimit?: number;
+}): CoreBooth<T>;
 
 /**
  * Creates a `route_to_booth` tool module that can be used by the LLM to switch the conversation
@@ -902,7 +979,7 @@ export declare class InteractionProcessor<T> {
      * @param toolRegistry - The registry for available tools.
      * @param llmAdapter - The adapter for interacting with the LLM.
      */
-    constructor(boothRegistry: BoothRegistry, boothPlugins: BoothPluginRegistry, toolRegistry: ToolRegistry, llmAdapter: LLMAdapter<T>);
+    constructor(boothRegistry: BoothRegistry, boothPlugins: BoothPluginRegistry, toolRegistry: ToolRegistry, llmAdapter: LLMAdapter<T>, loopLimit?: number);
     /**
      * Sends a message to the LLM and processes the response through the interaction loop.
      * This involves running pre-loop, pre-send, response-received, and post-loop plugin hooks.