@strands-agents/sdk 0.0.1

package/dist/src/agent/__tests__/state.test.js

@@ -0,0 +1,231 @@
+import { describe, expect, it } from 'vitest';
+import { AgentState } from '../state.js';
+describe('AgentState', () => {
+    describe('constructor', () => {
+        it('creates empty state when no initial state provided', () => {
+            const state = new AgentState();
+            expect(state.keys()).toEqual([]);
+        });
+        it('creates state with initial values', () => {
+            const state = new AgentState({ key1: 'value1', key2: 42 });
+            expect(state.get('key1')).toBe('value1');
+            expect(state.get('key2')).toBe(42);
+        });
+        it('stores deep copy of initial state', () => {
+            const initial = { nested: { value: 'test' } };
+            const state = new AgentState(initial);
+            // Mutate original
+            initial.nested.value = 'changed';
+            // State should not be affected
+            expect(state.get('nested')).toEqual({ value: 'test' });
+        });
+        it('throws error for function in initial state', () => {
+            const invalidState = { func: () => 'test', value: 'keep' };
+            expect(() => new AgentState(invalidState)).toThrow('initialState.func contains a function which cannot be serialized');
+        });
+        it('throws error for symbol in initial state', () => {
+            const sym = Symbol('test');
+            const invalidState = { sym, value: 'keep' };
+            expect(() => new AgentState(invalidState)).toThrow('initialState.sym contains a symbol which cannot be serialized');
+        });
+        it('throws error for undefined in initial state', () => {
+            const invalidState = { undef: undefined, value: 'keep' };
+            expect(() => new AgentState(invalidState)).toThrow('initialState.undef is undefined which cannot be serialized');
+        });
+        it('throws error for nested function in initial state', () => {
+            const invalidState = { nested: { func: () => 'test' } };
+            expect(() => new AgentState(invalidState)).toThrow('initialState.nested.func contains a function which cannot be serialized');
+        });
+        it('throws error for function in array in initial state', () => {
+            const invalidState = { arr: [1, () => 'test', 3] };
+            expect(() => new AgentState(invalidState)).toThrow('initialState.arr[1] contains a function which cannot be serialized');
+        });
+    });
+    describe('get', () => {
+        it('throws error when key is null or undefined', () => {
+            const state = new AgentState();
+            expect(() => state.get(null)).toThrow('key is required');
+            expect(() => state.get(undefined)).toThrow('key is required');
+        });
+        it('returns undefined when key does not exist', () => {
+            const state = new AgentState();
+            expect(state.get('nonexistent')).toBeUndefined();
+        });
+        it('returns value when key exists', () => {
+            const state = new AgentState({ key1: 'value1' });
+            expect(state.get('key1')).toBe('value1');
+        });
+        it('returns deep copy that cannot mutate stored state', () => {
+            const state = new AgentState({ nested: { value: 'test' } });
+            const retrieved = state.get('nested');
+            // Mutate retrieved value
+            retrieved.value = 'changed';
+            // Stored state should not be affected
+            expect(state.get('nested')).toEqual({ value: 'test' });
+        });
+        it('infers correct type with generic state interface', () => {
+            const state = new AgentState({ user: { name: 'John', age: 30 }, count: 5, items: ['a', 'b'] });
+            // Type inference tests
+            const user = state.get('user');
+            const count = state.get('count');
+            const items = state.get('items');
+            expect(user).toEqual({ name: 'John', age: 30 });
+            expect(count).toBe(5);
+            expect(items).toEqual(['a', 'b']);
+        });
+        it('returns undefined for non-existent key with typed interface', () => {
+            const state = new AgentState({ existing: 'value' });
+            const result = state.get('existing');
+            expect(result).toBe('value');
+            // Non-existent key
+            const state2 = new AgentState();
+            const missing = state2.get('existing');
+            expect(missing).toBeUndefined();
+            // @ts-expect-error properties not on the TestsState are an error
+            state2.get('not-really');
+        });
+    });
+    describe('set', () => {
+        it('sets string value successfully', () => {
+            const state = new AgentState();
+            state.set('key1', 'value1');
+            expect(state.get('key1')).toBe('value1');
+        });
+        it('sets number value successfully', () => {
+            const state = new AgentState();
+            state.set('key1', 42);
+            expect(state.get('key1')).toBe(42);
+        });
+        it('sets boolean value successfully', () => {
+            const state = new AgentState();
+            state.set('key1', true);
+            expect(state.get('key1')).toBe(true);
+        });
+        it('sets null value successfully', () => {
+            const state = new AgentState();
+            state.set('key1', null);
+            expect(state.get('key1')).toBeNull();
+        });
+        it('sets object value successfully', () => {
+            const state = new AgentState();
+            state.set('key1', { nested: 'value' });
+            expect(state.get('key1')).toEqual({ nested: 'value' });
+        });
+        it('sets array value successfully', () => {
+            const state = new AgentState();
+            state.set('key1', [1, 2, 3]);
+            expect(state.get('key1')).toEqual([1, 2, 3]);
+        });
+        it('overwrites existing value', () => {
+            const state = new AgentState({ key1: 'old' });
+            state.set('key1', 'new');
+            expect(state.get('key1')).toBe('new');
+        });
+        it('stores deep copy that cannot mutate stored state', () => {
+            const state = new AgentState();
+            const value = { nested: { value: 'test' } };
+            state.set('key1', value);
+            // Mutate original
+            value.nested.value = 'changed';
+            // Stored state should not be affected
+            expect(state.get('key1')).toEqual({ nested: { value: 'test' } });
+        });
+        it('throws error for function in value', () => {
+            const state = new AgentState({ existing: 'value' });
+            const obj = { func: () => 'test', value: 'keep' };
+            expect(() => state.set('key1', obj)).toThrow('value for key "key1".func contains a function which cannot be serialized');
+        });
+        it('throws error for symbol in value', () => {
+            const state = new AgentState();
+            const sym = Symbol('test');
+            expect(() => state.set('key1', { sym })).toThrow('value for key "key1".sym contains a symbol which cannot be serialized');
+        });
+        it('throws error for nested function in value', () => {
+            const state = new AgentState();
+            const obj = { nested: { func: () => 'test' } };
+            expect(() => state.set('key1', obj)).toThrow('value for key "key1".nested.func contains a function which cannot be serialized');
+        });
+        it('throws error for function in array', () => {
+            const state = new AgentState();
+            const arr = [1, () => 'test', 3];
+            expect(() => state.set('key1', arr)).toThrow('value for key "key1"[1] contains a function which cannot be serialized');
+        });
+        it('throws error for top-level symbol values', () => {
+            const state = new AgentState();
+            expect(() => state.set('key1', Symbol('test'))).toThrow('value for key "key1" contains a symbol which cannot be serialized');
+        });
+        it('throws error for top-level undefined values', () => {
+            const state = new AgentState();
+            expect(() => state.set('key1', undefined)).toThrow('value for key "key1" is undefined which cannot be serialized');
+        });
+        it('accepts typed value with generic state interface', () => {
+            const state = new AgentState();
+            state.set('user', { name: 'Alice', age: 25 });
+            state.set('count', 10);
+            expect(state.get('user')).toEqual({ name: 'Alice', age: 25 });
+            expect(state.get('count')).toBe(10);
+            // @ts-expect-error properties not on the TestsState are an error
+            state.set('not-really', 'nope');
+        });
+    });
+    describe('delete', () => {
+        it('removes existing key', () => {
+            const state = new AgentState({ key1: 'value1', key2: 'value2' });
+            state.delete('key1');
+            expect(state.get('key1')).toBeUndefined();
+            expect(state.get('key2')).toBe('value2');
+        });
+        it('does not throw error for non-existent key', () => {
+            const state = new AgentState();
+            expect(() => state.delete('nonexistent')).not.toThrow();
+        });
+        it('supports typed usage with generic state interface', () => {
+            const state = new AgentState({ user: { name: 'Alice' }, count: 5 });
+            // Typed delete
+            state.delete('user');
+            expect(state.get('user')).toBeUndefined();
+            expect(state.get('count')).toBe(5);
+        });
+    });
+    describe('clear', () => {
+        it('removes all values', () => {
+            const state = new AgentState({ key1: 'value1', key2: 'value2' });
+            state.clear();
+            expect(state.keys()).toEqual([]);
+            expect(state.get('key1')).toBeUndefined();
+            expect(state.get('key2')).toBeUndefined();
+        });
+        it('works on empty state', () => {
+            const state = new AgentState();
+            expect(() => state.clear()).not.toThrow();
+            expect(state.keys()).toEqual([]);
+        });
+    });
+    describe('getAll', () => {
+        it('returns object with all state', () => {
+            const state = new AgentState({ key1: 'value1', key2: 42 });
+            expect(state.getAll()).toEqual({ key1: 'value1', key2: 42 });
+        });
+        it('returns empty object for empty state', () => {
+            const state = new AgentState();
+            expect(state.getAll()).toEqual({});
+        });
+    });
+    describe('keys', () => {
+        it('returns array of all keys', () => {
+            const state = new AgentState({ key1: 'value1', key2: 'value2' });
+            expect(state.keys().sort()).toEqual(['key1', 'key2']);
+        });
+        it('returns empty array for empty state', () => {
+            const state = new AgentState();
+            expect(state.keys()).toEqual([]);
+        });
+        it('returns new array each time', () => {
+            const state = new AgentState({ key1: 'value1' });
+            const keys1 = state.keys();
+            const keys2 = state.keys();
+            expect(keys1).not.toBe(keys2);
+        });
+    });
+});
+//# sourceMappingURL=state.test.js.map

package/dist/src/agent/__tests__/state.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.test.js","sourceRoot":"","sources":["../../../../src/agent/__tests__/state.test.ts"],"names":[],"mappings":"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"}

package/dist/src/agent/agent.d.ts

@@ -0,0 +1,207 @@
+import { AgentResult, type AgentStreamEvent, type JSONValue, McpClient, Message, type MessageData, type SystemPrompt, type SystemPromptData, type Tool } from '../index.js';
+import type { BaseModelConfig, Model } from '../models/model.js';
+import { ToolRegistry } from '../registry/tool-registry.js';
+import { AgentState } from './state.js';
+import type { AgentData } from '../types/agent.js';
+import type { HookProvider } from '../hooks/types.js';
+import { HookRegistryImplementation } from '../hooks/registry.js';
+/**
+ * Recursive type definition for nested tool arrays.
+ * Allows tools to be organized in nested arrays of any depth.
+ */
+export type ToolList = (Tool | McpClient | ToolList)[];
+/**
+ * Configuration object for creating a new Agent.
+ */
+export type AgentConfig = {
+    /** The model instance that the agent will use to make decisions. */
+    model?: Model<BaseModelConfig>;
+    /** An initial set of messages to seed the agent's conversation history. */
+    messages?: Message[] | MessageData[];
+    /**
+     * An initial set of tools to register with the agent.
+     * Accepts nested arrays of tools at any depth, which will be flattened automatically.
+     */
+    tools?: ToolList;
+    /**
+     * A system prompt which guides model behavior.
+     */
+    systemPrompt?: SystemPrompt | SystemPromptData;
+    /** Optional initial state values for the agent. */
+    state?: Record<string, JSONValue>;
+    /**
+     * Enable automatic printing of agent output to console.
+     * When true, prints text generation, reasoning, and tool usage as they occur.
+     * Defaults to true.
+     */
+    printer?: boolean;
+    /**
+     * Conversation manager for handling message history and context overflow.
+     * Defaults to SlidingWindowConversationManager with windowSize of 40.
+     */
+    conversationManager?: HookProvider;
+    /**
+     * Hook providers to register with the agent.
+     * Hooks enable observing and extending agent behavior.
+     */
+    hooks?: HookProvider[];
+};
+/**
+ * Arguments for invoking an agent.
+ *
+ * A plain string represents user input to an agent.
+ */
+export type InvokeArgs = string;
+/**
+ * Orchestrates the interaction between a model, a set of tools, and MCP clients.
+ * The Agent is responsible for managing the lifecycle of tools and clients
+ * and invoking the core decision-making loop.
+ */
+export declare class Agent implements AgentData {
+    /**
+     * The conversation history of messages between user and assistant.
+     */
+    readonly messages: Message[];
+    /**
+     * Agent state storage accessible to tools and application logic.
+     * State is not passed to the model during inference.
+     */
+    readonly state: AgentState;
+    /**
+     * Conversation manager for handling message history and context overflow.
+     */
+    readonly conversationManager: HookProvider;
+    /**
+     * Hook registry for managing event callbacks.
+     * Hooks enable observing and extending agent behavior.
+     */
+    readonly hooks: HookRegistryImplementation;
+    /**
+     * The model provider used by the agent for inference.
+     */
+    model: Model;
+    private _toolRegistry;
+    private _mcpClients;
+    private _systemPrompt?;
+    private _initialized;
+    private _isInvoking;
+    private _printer?;
+    /**
+     * Creates an instance of the Agent.
+     * @param config - The configuration for the agent.
+     */
+    constructor(config?: AgentConfig);
+    initialize(): Promise<void>;
+    /**
+     * Acquires a lock to prevent concurrent invocations.
+     * Returns a Disposable that releases the lock when disposed.
+     */
+    private acquireLock;
+    /**
+     * The tools this agent can use.
+     */
+    get tools(): Tool[];
+    /**
+     * The tool registry for managing the agent's tools.
+     */
+    get toolRegistry(): ToolRegistry;
+    /**
+     * Invokes the agent and returns the final result.
+     *
+     * This is a convenience method that consumes the stream() method and returns
+     * only the final AgentResult. Use stream() if you need access to intermediate
+     * streaming events.
+     *
+     * @param args - Arguments for invoking the agent
+     * @returns Promise that resolves to the final AgentResult
+     *
+     * @example
+     * ```typescript
+     * const agent = new Agent({ model, tools })
+     * const result = await agent.invoke('What is 2 + 2?')
+     * console.log(result.lastMessage) // Agent's response
+     * ```
+     */
+    invoke(args: InvokeArgs): Promise<AgentResult>;
+    /**
+     * Streams the agent execution, yielding events and returning the final result.
+     *
+     * The agent loop manages the conversation flow by:
+     * 1. Streaming model responses and yielding all events
+     * 2. Executing tools when the model requests them
+     * 3. Continuing the loop until the model completes without tool use
+     *
+     * Use this method when you need access to intermediate streaming events.
+     * For simple request/response without streaming, use invoke() instead.
+     *
+     * An explicit goal of this method is to always leave the message array in a way that
+     * the agent can be reinvoked with a user prompt after this method completes. To that end
+     * assistant messages containing tool uses are only added after tool execution succeeds
+     * with valid toolResponses
+     *
+     * @param args - Arguments for invoking the agent
+     * @returns Async generator that yields AgentStreamEvent objects and returns AgentResult
+     *
+     * @example
+     * ```typescript
+     * const agent = new Agent({ model, tools })
+     *
+     * for await (const event of agent.stream('Hello')) {
+     *   console.log('Event:', event.type)
+     * }
+     * // Messages array is mutated in place and contains the full conversation
+     * ```
+     */
+    stream(args: InvokeArgs): AsyncGenerator<AgentStreamEvent, AgentResult, undefined>;
+    /**
+     * Internal implementation of the agent streaming logic.
+     * Separated to centralize printer event processing in the public stream method.
+     *
+     * @param args - Arguments for invoking the agent
+     * @returns Async generator that yields AgentStreamEvent objects and returns AgentResult
+     */
+    private _stream;
+    /**
+     * Invokes the model provider and streams all events.
+     *
+     * @param args - Optional arguments for invoking the model
+     * @returns Object containing the assistant message and stop reason
+     */
+    private invokeModel;
+    /**
+     * Streams events from the model and fires ModelStreamEventHook for each event.
+     *
+     * @param messages - Messages to send to the model
+     * @param streamOptions - Options for streaming
+     * @returns Object containing the assistant message and stop reason
+     */
+    private _streamFromModel;
+    /**
+     * Executes tools sequentially and streams all tool events.
+     *
+     * @param assistantMessage - The assistant message containing tool use blocks
+     * @param toolRegistry - Registry containing available tools
+     * @returns User message containing tool results
+     */
+    private executeTools;
+    /**
+     * Executes a single tool and returns the result.
+     * If the tool is not found or fails to return a result, returns an error ToolResult
+     * instead of throwing an exception. This allows the agent loop to continue and
+     * let the model handle the error gracefully.
+     *
+     * @param toolUseBlock - Tool use block to execute
+     * @param toolRegistry - Registry containing available tools
+     * @returns Tool result block
+     */
+    private executeTool;
+    /**
+     * Appends a message to the conversation history, invokes MessageAddedEvent hook,
+     * and returns the event for yielding.
+     *
+     * @param message - The message to append
+     * @returns MessageAddedEvent to be yielded (hook already invoked)
+     */
+    private _appendMessage;
+}
+//# sourceMappingURL=agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/agent/agent.ts"],"names":[],"mappings":"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"}