@strands-agents/sdk 0.0.1

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

@@ -0,0 +1,73 @@
+/**
+ * Abstract interface for conversation history management.
+ *
+ * This module provides the base class for implementing conversation management strategies
+ * to control the size of message arrays, helping to manage memory usage, control context
+ * length, and maintain relevant conversation state.
+ */
+import type { Message } from '../types/messages.js';
+/**
+ * Interface for conversation context that can be managed.
+ *
+ * This interface defines the minimal set of properties required by conversation managers
+ * to perform their operations. Using an interface allows for backwards-compatible
+ * API evolution and better decoupling from specific implementations.
+ */
+export interface ConversationContext {
+    /**
+     * The conversation history of messages that will be managed.
+     * This array is modified in-place by conversation management operations.
+     */
+    messages: Message[];
+}
+/**
+ * Abstract base class for managing conversation history.
+ *
+ * This class provides an interface for implementing conversation management strategies
+ * to control the size of message arrays/conversation histories, helping to:
+ *
+ * - Manage memory usage
+ * - Control context length
+ * - Maintain relevant conversation state
+ */
+export declare abstract class ConversationManager {
+    /**
+     * Creates a new ConversationManager instance.
+     */
+    constructor();
+    /**
+     * Applies management strategy to the provided conversation context.
+     *
+     * Processes the conversation history to maintain appropriate size by modifying
+     * the messages list in-place. Implementations should handle message pruning,
+     * summarization, or other size management techniques to keep the conversation
+     * context within desired bounds.
+     *
+     * @param context - The conversation context whose message history will be managed.
+     *                  The messages array is modified in-place.
+     */
+    abstract applyManagement(context: ConversationContext): void;
+    /**
+     * Called when the model's context window is exceeded.
+     *
+     * This method should implement the specific strategy for reducing the window size
+     * when a context overflow occurs. It is typically called after a ContextWindowOverflowError
+     * is caught during model invocation.
+     *
+     * Implementations might use strategies such as:
+     * - Removing the N oldest messages
+     * - Summarizing older context
+     * - Applying importance-based filtering
+     * - Maintaining critical conversation markers
+     *
+     * @param context - The conversation context whose message history will be reduced.
+     *                  The messages array is 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 tool result
+     *         messages cannot be properly converted.
+     */
+    abstract reduceContext(context: ConversationContext, error?: Error): void;
+}
+//# sourceMappingURL=conversation-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-manager.d.ts","sourceRoot":"","sources":["../../../src/conversation-manager/conversation-manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAEnD;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,QAAQ,EAAE,OAAO,EAAE,CAAA;CACpB;AAED;;;;;;;;;GASG;AACH,8BAAsB,mBAAmB;IACvC;;OAEG;;IAGH;;;;;;;;;;OAUG;aACa,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAEnE;;;;;;;;;;;;;;;;;;;;OAoBG;aACa,aAAa,CAAC,OAAO,EAAE,mBAAmB,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI;CACjF"}

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

@@ -0,0 +1,24 @@
+/**
+ * Abstract interface for conversation history management.
+ *
+ * This module provides the base class for implementing conversation management strategies
+ * to control the size of message arrays, helping to manage memory usage, control context
+ * length, and maintain relevant conversation state.
+ */
+/**
+ * Abstract base class for managing conversation history.
+ *
+ * This class provides an interface for implementing conversation management strategies
+ * to control the size of message arrays/conversation histories, helping to:
+ *
+ * - Manage memory usage
+ * - Control context length
+ * - Maintain relevant conversation state
+ */
+export class ConversationManager {
+    /**
+     * Creates a new ConversationManager instance.
+     */
+    constructor() { }
+}
+//# 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;;;;;;GAMG;AAmBH;;;;;;;;;GASG;AACH,MAAM,OAAgB,mBAAmB;IACvC;;OAEG;IACH,gBAAe,CAAC;CAqCjB"}

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

@@ -0,0 +1,8 @@
+/**
+ * Conversation Manager exports.
+ *
+ * This module exports conversation manager implementations.
+ */
+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

@@ -0,0 +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"}

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

@@ -0,0 +1,8 @@
+/**
+ * Conversation Manager exports.
+ *
+ * This module exports conversation manager implementations.
+ */
+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

@@ -0,0 +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"}

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

@@ -0,0 +1,23 @@
+/**
+ * Null implementation of conversation management.
+ *
+ * This module provides a no-op conversation manager that does not modify
+ * 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';
+/**
+ * A no-op conversation manager that does not modify the conversation history.
+ * Implements HookProvider but registers zero hooks.
+ */
+export declare class NullConversationManager implements HookProvider {
+    /**
+     * Registers callbacks with the hook registry.
+     * This implementation registers no hooks, providing a complete no-op behavior.
+     *
+     * @param _registry - The hook registry to register callbacks with (unused)
+     */
+    registerCallbacks(_registry: HookRegistry): void;
+}
+//# sourceMappingURL=null-conversation-manager.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,23 @@
+/**
+ * Null implementation of conversation management.
+ *
+ * This module provides a no-op conversation manager that does not modify
+ * the conversation history. Useful for testing and scenarios where conversation
+ * management is handled externally.
+ */
+/**
+ * A no-op conversation manager that does not modify the conversation history.
+ * Implements HookProvider but registers zero hooks.
+ */
+export class NullConversationManager {
+    /**
+     * Registers callbacks with the hook registry.
+     * This implementation registers no hooks, providing a complete no-op behavior.
+     *
+     * @param _registry - The hook registry to register callbacks with (unused)
+     */
+    registerCallbacks(_registry) {
+        // No-op - register zero hooks
+    }
+}
+//# sourceMappingURL=null-conversation-manager.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,105 @@
+/**
+ * Sliding window conversation history management.
+ *
+ * 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';
+/**
+ * Configuration for the sliding window conversation manager.
+ */
+export type SlidingWindowConversationManagerConfig = {
+    /**
+     * Maximum number of messages to keep in the conversation history.
+     * Defaults to 40 messages.
+     */
+    windowSize?: number;
+    /**
+     * Whether to truncate tool results when a message is too large for the model's context window.
+     * Defaults to true.
+     */
+    shouldTruncateResults?: boolean;
+};
+/**
+ * Implements a sliding window strategy for managing conversation history.
+ *
+ * This class handles the logic of maintaining a conversation window that preserves
+ * tool usage pairs and avoids invalid window states. When the message count exceeds
+ * 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:
+ * - AfterInvocationEvent: Applies sliding window management after each invocation
+ * - AfterModelCallEvent: Reduces context on overflow errors and requests retry
+ */
+export declare class SlidingWindowConversationManager implements HookProvider {
+    private readonly _windowSize;
+    private readonly _shouldTruncateResults;
+    /**
+     * Initialize the sliding window conversation manager.
+     *
+     * @param config - Configuration options for the sliding window manager.
+     */
+    constructor(config?: SlidingWindowConversationManagerConfig);
+    /**
+     * Registers callbacks with the hook registry.
+     *
+     * Registers:
+     * - AfterInvocationEvent callback to apply sliding window management
+     * - AfterModelCallEvent callback to handle context overflow and request retry
+     *
+     * @param registry - The hook registry to register callbacks with
+     */
+    registerCallbacks(registry: HookRegistry): void;
+    /**
+     * Apply the sliding window to the messages array to maintain a manageable history size.
+     *
+     * This method is called after every event 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.
+     *
+     * @param messages - The message array to manage. Modified in-place.
+     */
+    private applyManagement;
+    /**
+     * Trim the oldest messages to reduce the conversation context size.
+     *
+     * The method handles special cases where trimming the messages leads to:
+     * - toolResult with no corresponding toolUse
+     * - toolUse with no corresponding toolResult
+     *
+     * The strategy is:
+     * 1. First, attempt to truncate large tool results if shouldTruncateResults is true
+     * 2. If truncation is not possible or doesn't help, trim oldest messages
+     * 3. When trimming, skip invalid trim points (toolResult at start, or toolUse without following toolResult)
+     *
+     * @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.
+     */
+    private reduceContext;
+    /**
+     * Truncate tool results in a message to reduce context size.
+     *
+     * When a message contains tool results that are too large for the model's context window,
+     * this function replaces the content of those tool results with a simple error message.
+     *
+     * @param messages - The conversation message history.
+     * @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;
+    /**
+     * Find the index of the last message containing tool results.
+     *
+     * This is useful for identifying messages that might need to be truncated to reduce context size.
+     *
+     * @param messages - The conversation message history.
+     * @returns Index of the last message with tool results, or undefined if no such message exists.
+     */
+    private findLastMessageWithToolResults;
+}
+//# sourceMappingURL=sliding-window-conversation-manager.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,212 @@
+/**
+ * Sliding window conversation history management.
+ *
+ * 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';
+/**
+ * Implements a sliding window strategy for managing conversation history.
+ *
+ * This class handles the logic of maintaining a conversation window that preserves
+ * tool usage pairs and avoids invalid window states. When the message count exceeds
+ * 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:
+ * - AfterInvocationEvent: Applies sliding window management after each invocation
+ * - AfterModelCallEvent: Reduces context on overflow errors and requests retry
+ */
+export class SlidingWindowConversationManager {
+    _windowSize;
+    _shouldTruncateResults;
+    /**
+     * Initialize the sliding window conversation manager.
+     *
+     * @param config - Configuration options for the sliding window manager.
+     */
+    constructor(config) {
+        this._windowSize = config?.windowSize ?? 40;
+        this._shouldTruncateResults = config?.shouldTruncateResults ?? true;
+    }
+    /**
+     * Registers callbacks with the hook registry.
+     *
+     * Registers:
+     * - AfterInvocationEvent callback to apply sliding window management
+     * - AfterModelCallEvent callback to handle context overflow and request retry
+     *
+     * @param registry - The hook registry to register callbacks 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.retryModelCall = true;
+            }
+        });
+    }
+    /**
+     * Apply the sliding window to the messages array to maintain a manageable history size.
+     *
+     * This method is called after every event 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.
+     *
+     * @param messages - The message array to manage. Modified in-place.
+     */
+    applyManagement(messages) {
+        if (messages.length <= this._windowSize) {
+            return;
+        }
+        this.reduceContext(messages);
+    }
+    /**
+     * Trim the oldest messages to reduce the conversation context size.
+     *
+     * The method handles special cases where trimming the messages leads to:
+     * - toolResult with no corresponding toolUse
+     * - toolUse with no corresponding toolResult
+     *
+     * The strategy is:
+     * 1. First, attempt to truncate large tool results if shouldTruncateResults is true
+     * 2. If truncation is not possible or doesn't help, trim oldest messages
+     * 3. When trimming, skip invalid trim points (toolResult at start, or toolUse without following toolResult)
+     *
+     * @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.
+     */
+    reduceContext(messages, _error) {
+        // Only truncate tool results when handling a context overflow error, not for window size enforcement
+        const lastMessageIdxWithToolResults = this.findLastMessageWithToolResults(messages);
+        if (_error && lastMessageIdxWithToolResults !== undefined && this._shouldTruncateResults) {
+            const resultsTruncated = this.truncateToolResults(messages, lastMessageIdxWithToolResults);
+            if (resultsTruncated) {
+                return;
+            }
+        }
+        // Try to trim messages when tool result cannot be truncated anymore
+        // If the number of messages is less than the window_size, then we default to 2, otherwise, trim to window size
+        let trimIndex = messages.length <= this._windowSize ? 2 : messages.length - this._windowSize;
+        // Find the next valid trim_index
+        while (trimIndex < messages.length) {
+            const oldestMessage = messages[trimIndex];
+            if (!oldestMessage) {
+                break;
+            }
+            // Check if oldest message would be a toolResult (invalid - needs preceding toolUse)
+            const hasToolResult = oldestMessage.content.some((block) => block.type === 'toolResultBlock');
+            if (hasToolResult) {
+                trimIndex++;
+                continue;
+            }
+            // Check if oldest message would be a toolUse without immediately following toolResult
+            const hasToolUse = oldestMessage.content.some((block) => block.type === 'toolUseBlock');
+            if (hasToolUse) {
+                // Check if next message has toolResult
+                const nextMessage = messages[trimIndex + 1];
+                const nextHasToolResult = nextMessage && nextMessage.content.some((block) => block.type === 'toolResultBlock');
+                if (!nextHasToolResult) {
+                    // toolUse without following toolResult - invalid trim point
+                    trimIndex++;
+                    continue;
+                }
+            }
+            // Valid trim point found
+            break;
+        }
+        // If we didn't find a valid trim_index, then we throw
+        if (trimIndex >= messages.length) {
+            throw new ContextWindowOverflowError('Unable to trim conversation context!');
+        }
+        // Overwrite message history
+        messages.splice(0, trimIndex);
+    }
+    /**
+     * Truncate tool results in a message to reduce context size.
+     *
+     * When a message contains tool results that are too large for the model's context window,
+     * this function replaces the content of those tool results with a simple error message.
+     *
+     * @param messages - The conversation message history.
+     * @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) {
+        if (msgIdx >= messages.length || msgIdx < 0) {
+            return false;
+        }
+        const message = messages[msgIdx];
+        if (!message) {
+            return false;
+        }
+        const toolResultTooLargeMessage = 'The tool result was too large!';
+        let foundToolResultToTruncate = false;
+        // First, check if there's a tool result that needs truncation
+        for (const block of message.content) {
+            if (block.type === 'toolResultBlock') {
+                const toolResultBlock = block;
+                // Check if already truncated
+                const firstContent = toolResultBlock.content[0];
+                const contentText = firstContent && firstContent.type === 'textBlock' ? firstContent.text : '';
+                if (toolResultBlock.status === 'error' && contentText === toolResultTooLargeMessage) {
+                    return false;
+                }
+                foundToolResultToTruncate = true;
+                break;
+            }
+        }
+        if (!foundToolResultToTruncate) {
+            return false;
+        }
+        // Create new content array with truncated tool results
+        const newContent = message.content.map((block) => {
+            if (block.type === 'toolResultBlock') {
+                const toolResultBlock = block;
+                // Create new ToolResultBlock with truncated content
+                return new ToolResultBlock({
+                    toolUseId: toolResultBlock.toolUseId,
+                    status: 'error',
+                    content: [new TextBlock(toolResultTooLargeMessage)],
+                });
+            }
+            return block;
+        });
+        // Replace the message in the array with a new message containing the modified content
+        messages[msgIdx] = new Message({
+            role: message.role,
+            content: newContent,
+        });
+        return true;
+    }
+    /**
+     * Find the index of the last message containing tool results.
+     *
+     * This is useful for identifying messages that might need to be truncated to reduce context size.
+     *
+     * @param messages - The conversation message history.
+     * @returns Index of the last message with tool results, or undefined if no such message exists.
+     */
+    findLastMessageWithToolResults(messages) {
+        // Iterate backwards through all messages (from newest to oldest)
+        for (let idx = messages.length - 1; idx >= 0; idx--) {
+            const currentMessage = messages[idx];
+            const hasToolResult = currentMessage.content.some((block) => block.type === 'toolResultBlock');
+            if (hasToolResult) {
+                return idx;
+            }
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=sliding-window-conversation-manager.js.map

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

@@ -0,0 +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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"}

package/dist/src/errors.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Error types for the Strands Agents TypeScript SDK.
+ *
+ * These error classes represent specific error conditions that can occur
+ * during agent execution and model provider interactions.
+ */
+import type { Message } from './types/messages.js';
+/**
+ * Error thrown when input exceeds the model's context window.
+ *
+ * This error indicates that the combined length of the input (prompt, messages,
+ * system prompt, and tool definitions) exceeds the maximum context window size
+ * supported by the model.
+ */
+export declare class ContextWindowOverflowError extends Error {
+    /**
+     * Creates a new ContextWindowOverflowError.
+     *
+     * @param message - Error message describing the context overflow
+     */
+    constructor(message: string);
+}
+/**
+ * Error thrown when the model reaches its maximum token limit during generation.
+ *
+ * This error indicates that the model stopped generating content because it reached
+ * the maximum number of tokens allowed for the response. This is an unrecoverable
+ * state that requires intervention, such as reducing the input size or adjusting
+ * the max tokens parameter.
+ */
+export declare class MaxTokensError extends Error {
+    /**
+     * The partial assistant message that was generated before hitting the token limit.
+     * This can be useful for understanding what the model was trying to generate.
+     */
+    readonly partialMessage: Message;
+    /**
+     * Creates a new MaxTokensError.
+     *
+     * @param message - Error message describing the max tokens condition
+     * @param partialMessage - The partial assistant message generated before the limit
+     */
+    constructor(message: string, partialMessage: Message);
+}
+/**
+ * Error thrown when attempting to serialize a value that is not JSON-serializable.
+ *
+ * This error indicates that a value contains non-serializable types such as functions,
+ * symbols, or undefined values that cannot be converted to JSON.
+ */
+export declare class JsonValidationError extends Error {
+    /**
+     * Creates a new JsonValidationError.
+     *
+     * @param message - Error message describing the validation failure
+     */
+    constructor(message: string);
+}
+/**
+ * Error thrown when attempting to invoke an agent that is already processing an invocation.
+ *
+ * This error indicates that invoke() or stream() was called while the agent is already
+ * executing. Agents can only process one invocation at a time to prevent state corruption.
+ */
+export declare class ConcurrentInvocationError extends Error {
+    /**
+     * Creates a new ConcurrentInvocationError.
+     *
+     * @param message - Error message describing the concurrent invocation attempt
+     */
+    constructor(message: string);
+}
+/**
+ * Normalizes an unknown error value to an Error instance.
+ *
+ * This helper ensures that any thrown value (Error, string, number, etc.)
+ * is converted to a proper Error object for consistent error handling.
+ *
+ * @param error - The error value to normalize
+ * @returns An Error instance
+ */
+export declare function normalizeError(error: unknown): Error;
+//# sourceMappingURL=errors.d.ts.map

package/dist/src/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD;;;;;;GAMG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;IACnD;;;;OAIG;gBACS,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;GAOG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC;;;OAGG;IACH,SAAgB,cAAc,EAAE,OAAO,CAAA;IAEvC;;;;;OAKG;gBACS,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO;CAKrD;AAED;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C;;;;OAIG;gBACS,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;GAKG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;IAClD;;;;OAIG;gBACS,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAEpD"}