@strands-agents/sdk 0.6.0 → 0.7.0

package/dist/src/conversation-manager/conversation-manager.js

@@ -0,0 +1,59 @@
+/**
+ * Abstract base class for conversation history management.
+ *
+ * This module defines the ConversationManager abstraction, which provides a
+ * domain-specific interface for managing an agent's conversation context.
+ */
+import { AfterModelCallEvent } from '../hooks/events.js';
+import { ContextWindowOverflowError } from '../errors.js';
+/**
+ * Abstract base class for conversation history management strategies.
+ *
+ * The primary responsibility of a ConversationManager is overflow recovery: when the
+ * model returns a {@link ContextWindowOverflowError}, {@link ConversationManager.reduce}
+ * is called and MUST reduce the history enough for the next model call to succeed.
+ * If `reduce` returns `false` (no reduction performed), the error propagates out of
+ * the agent loop uncaught. This makes `reduce` a critical operation — implementations
+ * must be able to make meaningful progress when called with `error` set.
+ *
+ * Optionally, a manager can also do proactive management (e.g. trimming after every
+ * invocation to stay within a window) by overriding `initAgent`, calling
+ * `super.initAgent(agent)` to preserve overflow recovery, then registering additional hooks.
+ *
+ * @example
+ * ```typescript
+ * class Last10MessagesManager extends ConversationManager {
+ *   readonly name = 'my:last-10-messages'
+ *
+ *   reduce({ agent }: ReduceOptions): boolean {
+ *     if (agent.messages.length <= 10) return false
+ *     agent.messages.splice(0, agent.messages.length - 10)
+ *     return true
+ *   }
+ * }
+ * ```
+ */
+export class ConversationManager {
+    /**
+     * Initialize the conversation manager with the agent instance.
+     *
+     * Registers overflow recovery: when a {@link ContextWindowOverflowError} occurs,
+     * calls {@link ConversationManager.reduce} and retries the model call if reduction succeeded.
+     * If `reduce` returns `false`, the error propagates out of the agent loop uncaught.
+     *
+     * Subclasses that need proactive management MUST call `super.initAgent(agent)` to
+     * preserve this overflow recovery behavior.
+     *
+     * @param agent - The agent to register hooks with
+     */
+    initAgent(agent) {
+        agent.addHook(AfterModelCallEvent, (event) => {
+            if (event.error instanceof ContextWindowOverflowError) {
+                if (this.reduce({ agent: event.agent, error: event.error })) {
+                    event.retry = true;
+                }
+            }
+        });
+    }
+}
+//# sourceMappingURL=conversation-manager.js.map

package/dist/src/conversation-manager/conversation-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-manager.js","sourceRoot":"","sources":["../../../src/conversation-manager/conversation-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAA;AAmBzD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,OAAgB,mBAAmB;IAuBvC;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,KAAiB;QACzB,KAAK,CAAC,OAAO,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;YAC3C,IAAI,KAAK,CAAC,KAAK,YAAY,0BAA0B,EAAE,CAAC;gBACtD,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC;oBAC5D,KAAK,CAAC,KAAK,GAAG,IAAI,CAAA;gBACpB,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAA;IACJ,CAAC;CACF"}

package/dist/src/conversation-manager/index.d.ts

@@ -3,6 +3,7 @@
  *
  * This module exports conversation manager implementations.
  */
+export { ConversationManager, type ConversationManagerReduceOptions as ReduceOptions } from './conversation-manager.js';
 export { NullConversationManager } from './null-conversation-manager.js';
 export { SlidingWindowConversationManager, type SlidingWindowConversationManagerConfig, } from './sliding-window-conversation-manager.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/conversation-manager/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/conversation-manager/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAA;AACxE,OAAO,EACL,gCAAgC,EAChC,KAAK,sCAAsC,GAC5C,MAAM,0CAA0C,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/conversation-manager/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,KAAK,gCAAgC,IAAI,aAAa,EAAE,MAAM,2BAA2B,CAAA;AACvH,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAA;AACxE,OAAO,EACL,gCAAgC,EAChC,KAAK,sCAAsC,GAC5C,MAAM,0CAA0C,CAAA"}

package/dist/src/conversation-manager/index.js

@@ -3,6 +3,7 @@
  *
  * This module exports conversation manager implementations.
  */
+export { ConversationManager } from './conversation-manager.js';
 export { NullConversationManager } from './null-conversation-manager.js';
 export { SlidingWindowConversationManager, } from './sliding-window-conversation-manager.js';
 //# sourceMappingURL=index.js.map

package/dist/src/conversation-manager/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/conversation-manager/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAA;AACxE,OAAO,EACL,gCAAgC,GAEjC,MAAM,0CAA0C,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/conversation-manager/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAA0D,MAAM,2BAA2B,CAAA;AACvH,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAA;AACxE,OAAO,EACL,gCAAgC,GAEjC,MAAM,0CAA0C,CAAA"}

package/dist/src/conversation-manager/null-conversation-manager.d.ts

@@ -5,19 +5,23 @@
  * the conversation history. Useful for testing and scenarios where conversation
  * management is handled externally.
  */
-import type { HookProvider } from '../hooks/types.js';
-import type { HookRegistry } from '../hooks/registry.js';
+import { ConversationManager, type ConversationManagerReduceOptions } from './conversation-manager.js';
 /**
  * A no-op conversation manager that does not modify the conversation history.
- * Implements HookProvider but registers zero hooks.
+ *
+ * Does not register any proactive hooks. Overflow errors will not be retried
+ * since `reduce` always returns `false`.
  */
-export declare class NullConversationManager implements HookProvider {
+export declare class NullConversationManager extends ConversationManager {
+    /**
+     * Unique identifier for this conversation manager.
+     */
+    readonly name = "strands:null-conversation-manager";
     /**
-     * Registers callbacks with the hook registry.
-     * This implementation registers no hooks, providing a complete no-op behavior.
+     * No-op reduction — never modifies the conversation history.
      *
-     * @param _registry - The hook registry to register callbacks with (unused)
+     * @returns `false` always
      */
-    registerCallbacks(_registry: HookRegistry): void;
+    reduce(_args: ConversationManagerReduceOptions): boolean;
 }
 //# sourceMappingURL=null-conversation-manager.d.ts.map

package/dist/src/conversation-manager/null-conversation-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"null-conversation-manager.d.ts","sourceRoot":"","sources":["../../../src/conversation-manager/null-conversation-manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAExD;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,YAAY;IAC1D;;;;;OAKG;IACI,iBAAiB,CAAC,SAAS,EAAE,YAAY,GAAG,IAAI;CAGxD"}
+{"version":3,"file":"null-conversation-manager.d.ts","sourceRoot":"","sources":["../../../src/conversation-manager/null-conversation-manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,mBAAmB,EAAE,KAAK,gCAAgC,EAAE,MAAM,2BAA2B,CAAA;AAEtG;;;;;GAKG;AACH,qBAAa,uBAAwB,SAAQ,mBAAmB;IAC9D;;OAEG;IACH,QAAQ,CAAC,IAAI,uCAAsC;IAEnD;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,gCAAgC,GAAG,OAAO;CAGzD"}

package/dist/src/conversation-manager/null-conversation-manager.js

@@ -5,19 +5,25 @@
  * the conversation history. Useful for testing and scenarios where conversation
  * management is handled externally.
  */
+import { ConversationManager } from './conversation-manager.js';
 /**
  * A no-op conversation manager that does not modify the conversation history.
- * Implements HookProvider but registers zero hooks.
+ *
+ * Does not register any proactive hooks. Overflow errors will not be retried
+ * since `reduce` always returns `false`.
  */
-export class NullConversationManager {
+export class NullConversationManager extends ConversationManager {
+    /**
+     * Unique identifier for this conversation manager.
+     */
+    name = 'strands:null-conversation-manager';
     /**
-     * Registers callbacks with the hook registry.
-     * This implementation registers no hooks, providing a complete no-op behavior.
+     * No-op reduction — never modifies the conversation history.
      *
-     * @param _registry - The hook registry to register callbacks with (unused)
+     * @returns `false` always
      */
-    registerCallbacks(_registry) {
-        // No-op - register zero hooks
+    reduce(_args) {
+        return false;
     }
 }
 //# sourceMappingURL=null-conversation-manager.js.map

package/dist/src/conversation-manager/null-conversation-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"null-conversation-manager.js","sourceRoot":"","sources":["../../../src/conversation-manager/null-conversation-manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;;GAGG;AACH,MAAM,OAAO,uBAAuB;IAClC;;;;;OAKG;IACI,iBAAiB,CAAC,SAAuB;QAC9C,8BAA8B;IAChC,CAAC;CACF"}
+{"version":3,"file":"null-conversation-manager.js","sourceRoot":"","sources":["../../../src/conversation-manager/null-conversation-manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,mBAAmB,EAAyC,MAAM,2BAA2B,CAAA;AAEtG;;;;;GAKG;AACH,MAAM,OAAO,uBAAwB,SAAQ,mBAAmB;IAC9D;;OAEG;IACM,IAAI,GAAG,mCAAmC,CAAA;IAEnD;;;;OAIG;IACH,MAAM,CAAC,KAAuC;QAC5C,OAAO,KAAK,CAAA;IACd,CAAC;CACF"}

package/dist/src/conversation-manager/sliding-window-conversation-manager.d.ts

@@ -4,8 +4,8 @@
  * This module provides a sliding window strategy for managing conversation history
  * that preserves tool usage pairs and avoids invalid window states.
  */
-import type { HookProvider } from '../hooks/types.js';
-import type { HookRegistry } from '../hooks/registry.js';
+import type { LocalAgent } from '../types/agent.js';
+import { ConversationManager, type ConversationManagerReduceOptions } from './conversation-manager.js';
 /**
  * Configuration for the sliding window conversation manager.
  */
@@ -29,13 +29,17 @@ export type SlidingWindowConversationManagerConfig = {
  * the window size, it will either truncate large tool results or remove the oldest
  * messages while ensuring tool use/result pairs remain valid.
  *
- * As a HookProvider, it registers callbacks for:
+ * Registers hooks for:
  * - AfterInvocationEvent: Applies sliding window management after each invocation
- * - AfterModelCallEvent: Reduces context on overflow errors and requests retry
+ * - AfterModelCallEvent: Reduces context on overflow errors and requests retry (via super)
  */
-export declare class SlidingWindowConversationManager implements HookProvider {
+export declare class SlidingWindowConversationManager extends ConversationManager {
     private readonly _windowSize;
     private readonly _shouldTruncateResults;
+    /**
+     * Unique identifier for this conversation manager.
+     */
+    readonly name = "strands:sliding-window-conversation-manager";
     /**
      * Initialize the sliding window conversation manager.
      *
@@ -43,25 +47,32 @@ export declare class SlidingWindowConversationManager implements HookProvider {
      */
     constructor(config?: SlidingWindowConversationManagerConfig);
     /**
-     * Registers callbacks with the hook registry.
+     * Initialize the plugin by registering hooks with the agent.
      *
      * Registers:
      * - AfterInvocationEvent callback to apply sliding window management
-     * - AfterModelCallEvent callback to handle context overflow and request retry
+     * - AfterModelCallEvent callback to handle context overflow and request retry (via super)
      *
-     * @param registry - The hook registry to register callbacks with
+     * @param agent - The agent to register hooks with
      */
-    registerCallbacks(registry: HookRegistry): void;
+    initAgent(agent: LocalAgent): void;
+    /**
+     * Reduce the conversation history in response to a context overflow.
+     *
+     * Attempts to truncate large tool results first before falling back to message trimming.
+     *
+     * @param options - The reduction options
+     * @returns `true` if the history was reduced, `false` otherwise
+     */
+    reduce({ agent, error }: ConversationManagerReduceOptions): boolean;
     /**
      * Apply the sliding window to the messages array to maintain a manageable history size.
      *
-     * This method is called after every agent loop cycle to apply a sliding window if the message
-     * count exceeds the window size. If the number of messages is within the window size, no action
-     * is taken.
+     * Called after every agent invocation. No-op if within the window size.
      *
      * @param messages - The message array to manage. Modified in-place.
      */
-    private applyManagement;
+    private _applyManagement;
     /**
      * Trim the oldest messages to reduce the conversation context size.
      *
@@ -76,11 +87,9 @@ export declare class SlidingWindowConversationManager implements HookProvider {
      *
      * @param messages - The message array to reduce. Modified in-place.
      * @param _error - The error that triggered the context reduction, if any.
-     *
-     * @throws ContextWindowOverflowError If the context cannot be reduced further,
-     *         such as when the conversation is already minimal or when no valid trim point exists.
+     * @returns `true` if any reduction occurred, `false` otherwise.
      */
-    private reduceContext;
+    private _reduceContext;
     /**
      * Truncate tool results in a message to reduce context size.
      *
@@ -91,7 +100,7 @@ export declare class SlidingWindowConversationManager implements HookProvider {
      * @param msgIdx - Index of the message containing tool results to truncate.
      * @returns True if any changes were made to the message, false otherwise.
      */
-    private truncateToolResults;
+    private _truncateToolResults;
     /**
      * Find the index of the last message containing tool results.
      *
@@ -100,6 +109,6 @@ export declare class SlidingWindowConversationManager implements HookProvider {
      * @param messages - The conversation message history.
      * @returns Index of the last message with tool results, or undefined if no such message exists.
      */
-    private findLastMessageWithToolResults;
+    private _findLastMessageWithToolResults;
 }
 //# sourceMappingURL=sliding-window-conversation-manager.d.ts.map

package/dist/src/conversation-manager/sliding-window-conversation-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sliding-window-conversation-manager.d.ts","sourceRoot":"","sources":["../../../src/conversation-manager/sliding-window-conversation-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAGxD;;GAEG;AACH,MAAM,MAAM,sCAAsC,GAAG;IACnD;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAChC,CAAA;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,gCAAiC,YAAW,YAAY;IACnE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IACpC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAS;IAEhD;;;;OAIG;gBACS,MAAM,CAAC,EAAE,sCAAsC;IAK3D;;;;;;;;OAQG;IACI,iBAAiB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAetD;;;;;;;;OAQG;IACH,OAAO,CAAC,eAAe;IAQvB;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,aAAa;IAuDrB;;;;;;;;;OASG;IACH,OAAO,CAAC,mBAAmB;IA0D3B;;;;;;;OAOG;IACH,OAAO,CAAC,8BAA8B;CAcvC"}
+{"version":3,"file":"sliding-window-conversation-manager.d.ts","sourceRoot":"","sources":["../../../src/conversation-manager/sliding-window-conversation-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAEnD,OAAO,EAAE,mBAAmB,EAAE,KAAK,gCAAgC,EAAE,MAAM,2BAA2B,CAAA;AAGtG;;GAEG;AACH,MAAM,MAAM,sCAAsC,GAAG;IACnD;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAChC,CAAA;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,gCAAiC,SAAQ,mBAAmB;IACvE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IACpC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAS;IAEhD;;OAEG;IACH,QAAQ,CAAC,IAAI,iDAAgD;IAE7D;;;;OAIG;gBACS,MAAM,CAAC,EAAE,sCAAsC;IAM3D;;;;;;;;OAQG;IACa,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAQlD;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,gCAAgC,GAAG,OAAO;IAInE;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,cAAc;IA2DtB;;;;;;;;;OASG;IACH,OAAO,CAAC,oBAAoB;IA0D5B;;;;;;;OAOG;IACH,OAAO,CAAC,+BAA+B;CAcxC"}

package/dist/src/conversation-manager/sliding-window-conversation-manager.js

@@ -4,9 +4,10 @@
  * This module provides a sliding window strategy for managing conversation history
  * that preserves tool usage pairs and avoids invalid window states.
  */
-import { ContextWindowOverflowError } from '../errors.js';
 import { Message, TextBlock, ToolResultBlock } from '../types/messages.js';
-import { AfterInvocationEvent, AfterModelCallEvent } from '../hooks/events.js';
+import { AfterInvocationEvent } from '../hooks/events.js';
+import { ConversationManager } from './conversation-manager.js';
+import { logger } from '../logging/logger.js';
 /**
  * Implements a sliding window strategy for managing conversation history.
  *
@@ -15,58 +16,65 @@ import { AfterInvocationEvent, AfterModelCallEvent } from '../hooks/events.js';
  * the window size, it will either truncate large tool results or remove the oldest
  * messages while ensuring tool use/result pairs remain valid.
  *
- * As a HookProvider, it registers callbacks for:
+ * Registers hooks for:
  * - AfterInvocationEvent: Applies sliding window management after each invocation
- * - AfterModelCallEvent: Reduces context on overflow errors and requests retry
+ * - AfterModelCallEvent: Reduces context on overflow errors and requests retry (via super)
  */
-export class SlidingWindowConversationManager {
+export class SlidingWindowConversationManager extends ConversationManager {
     _windowSize;
     _shouldTruncateResults;
+    /**
+     * Unique identifier for this conversation manager.
+     */
+    name = 'strands:sliding-window-conversation-manager';
     /**
      * Initialize the sliding window conversation manager.
      *
      * @param config - Configuration options for the sliding window manager.
      */
     constructor(config) {
+        super();
         this._windowSize = config?.windowSize ?? 40;
         this._shouldTruncateResults = config?.shouldTruncateResults ?? true;
     }
     /**
-     * Registers callbacks with the hook registry.
+     * Initialize the plugin by registering hooks with the agent.
      *
      * Registers:
      * - AfterInvocationEvent callback to apply sliding window management
-     * - AfterModelCallEvent callback to handle context overflow and request retry
+     * - AfterModelCallEvent callback to handle context overflow and request retry (via super)
      *
-     * @param registry - The hook registry to register callbacks with
+     * @param agent - The agent to register hooks with
      */
-    registerCallbacks(registry) {
-        // Apply sliding window management after each invocation
-        registry.addCallback(AfterInvocationEvent, (event) => {
-            this.applyManagement(event.agent.messages);
-        });
-        // Handle context overflow errors
-        registry.addCallback(AfterModelCallEvent, (event) => {
-            if (event.error instanceof ContextWindowOverflowError) {
-                this.reduceContext(event.agent.messages, event.error);
-                event.retry = true;
-            }
+    initAgent(agent) {
+        super.initAgent(agent);
+        agent.addHook(AfterInvocationEvent, (event) => {
+            this._applyManagement(event.agent.messages);
         });
     }
+    /**
+     * Reduce the conversation history in response to a context overflow.
+     *
+     * Attempts to truncate large tool results first before falling back to message trimming.
+     *
+     * @param options - The reduction options
+     * @returns `true` if the history was reduced, `false` otherwise
+     */
+    reduce({ agent, error }) {
+        return this._reduceContext(agent.messages, error);
+    }
     /**
      * Apply the sliding window to the messages array to maintain a manageable history size.
      *
-     * This method is called after every agent loop cycle to apply a sliding window if the message
-     * count exceeds the window size. If the number of messages is within the window size, no action
-     * is taken.
+     * Called after every agent invocation. No-op if within the window size.
      *
      * @param messages - The message array to manage. Modified in-place.
      */
-    applyManagement(messages) {
+    _applyManagement(messages) {
         if (messages.length <= this._windowSize) {
             return;
         }
-        this.reduceContext(messages);
+        this._reduceContext(messages, undefined);
     }
     /**
      * Trim the oldest messages to reduce the conversation context size.
@@ -82,17 +90,15 @@ export class SlidingWindowConversationManager {
      *
      * @param messages - The message array to reduce. Modified in-place.
      * @param _error - The error that triggered the context reduction, if any.
-     *
-     * @throws ContextWindowOverflowError If the context cannot be reduced further,
-     *         such as when the conversation is already minimal or when no valid trim point exists.
+     * @returns `true` if any reduction occurred, `false` otherwise.
      */
-    reduceContext(messages, _error) {
+    _reduceContext(messages, _error) {
         // Only truncate tool results when handling a context overflow error, not for window size enforcement
-        const lastMessageIdxWithToolResults = this.findLastMessageWithToolResults(messages);
+        const lastMessageIdxWithToolResults = this._findLastMessageWithToolResults(messages);
         if (_error && lastMessageIdxWithToolResults !== undefined && this._shouldTruncateResults) {
-            const resultsTruncated = this.truncateToolResults(messages, lastMessageIdxWithToolResults);
+            const resultsTruncated = this._truncateToolResults(messages, lastMessageIdxWithToolResults);
             if (resultsTruncated) {
-                return;
+                return true;
             }
         }
         // Try to trim messages when tool result cannot be truncated anymore
@@ -125,12 +131,14 @@ export class SlidingWindowConversationManager {
             // Valid trim point found
             break;
         }
-        // If we didn't find a valid trim_index, then we throw
+        // If no valid trim point was found, return false and let the caller handle it
         if (trimIndex >= messages.length) {
-            throw new ContextWindowOverflowError('Unable to trim conversation context!');
+            logger.warn(`window_size=<${this._windowSize}>, messages=<${messages.length}> | unable to trim conversation context, no valid trim point found`);
+            return false;
         }
-        // Overwrite message history
+        // trimIndex is guaranteed to be < messages.length here, so splice always removes at least one message
         messages.splice(0, trimIndex);
+        return true;
     }
     /**
      * Truncate tool results in a message to reduce context size.
@@ -142,7 +150,7 @@ export class SlidingWindowConversationManager {
      * @param msgIdx - Index of the message containing tool results to truncate.
      * @returns True if any changes were made to the message, false otherwise.
      */
-    truncateToolResults(messages, msgIdx) {
+    _truncateToolResults(messages, msgIdx) {
         if (msgIdx >= messages.length || msgIdx < 0) {
             return false;
         }
@@ -197,7 +205,7 @@ export class SlidingWindowConversationManager {
      * @param messages - The conversation message history.
      * @returns Index of the last message with tool results, or undefined if no such message exists.
      */
-    findLastMessageWithToolResults(messages) {
+    _findLastMessageWithToolResults(messages) {
         // Iterate backwards through all messages (from newest to oldest)
         for (let idx = messages.length - 1; idx >= 0; idx--) {
             const currentMessage = messages[idx];

package/dist/src/conversation-manager/sliding-window-conversation-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"sliding-window-conversation-manager.js","sourceRoot":"","sources":["../../../src/conversation-manager/sliding-window-conversation-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sliding-window-conversation-manager.js","sourceRoot":"","sources":["../../../src/conversation-manager/sliding-window-conversation-manager.ts"],"names":[],"mappings":"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"}