@strands-agents/sdk 0.3.0 → 0.5.0

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

@@ -0,0 +1,249 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { Agent } from '../agent.js';
+import { SNAPSHOT_SCHEMA_VERSION, ALL_SNAPSHOT_FIELDS, SNAPSHOT_PRESETS, createTimestamp, resolveSnapshotFields, takeSnapshot, loadSnapshot, } from '../snapshot.js';
+import { Message, TextBlock, ToolUseBlock, ToolResultBlock } from '../../types/messages.js';
+import { TestModelProvider } from '../../__fixtures__/model-test-helpers.js';
+// Fixed timestamp for testing
+const MOCK_TIMESTAMP = '2026-01-15T12:00:00.000Z';
+/**
+ * Helper to create a test agent with a mock model
+ */
+function createTestAgent() {
+    return new Agent({
+        model: new TestModelProvider(),
+        tools: [],
+    });
+}
+describe('Snapshot API', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+        vi.setSystemTime(new Date(MOCK_TIMESTAMP));
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    describe('constants', () => {
+        it('exports snapshot constants with correct values', () => {
+            expect(SNAPSHOT_SCHEMA_VERSION).toBe('1.0');
+            expect(ALL_SNAPSHOT_FIELDS).toEqual(['messages', 'state', 'systemPrompt']);
+            expect(SNAPSHOT_PRESETS).toEqual({
+                session: ['messages', 'state', 'systemPrompt'],
+            });
+        });
+    });
+    describe('createTimestamp', () => {
+        it('returns ISO 8601 formatted timestamp', () => {
+            expect(createTimestamp()).toBe(MOCK_TIMESTAMP);
+        });
+    });
+    describe('resolveSnapshotFields', () => {
+        it('throws error when no fields would be included', () => {
+            expect(() => resolveSnapshotFields({})).toThrow('No fields to include in snapshot');
+        });
+        it('returns session preset fields when preset is "session"', () => {
+            const fields = resolveSnapshotFields({ preset: 'session' });
+            expect(fields).toEqual(new Set(['messages', 'state', 'systemPrompt']));
+        });
+        it('returns explicit fields when include is specified', () => {
+            const fields = resolveSnapshotFields({ include: ['messages', 'state'] });
+            expect(fields).toEqual(new Set(['messages', 'state']));
+        });
+        it('applies exclude after preset', () => {
+            const fields = resolveSnapshotFields({ preset: 'session', exclude: ['state'] });
+            expect(fields).toEqual(new Set(['messages', 'systemPrompt']));
+        });
+        it('throws error for invalid preset', () => {
+            expect(() => resolveSnapshotFields({ preset: 'invalid' })).toThrow('Invalid preset: invalid');
+        });
+        it('throws error for invalid field names', () => {
+            expect(() => resolveSnapshotFields({ include: ['invalidField'] })).toThrow('Invalid snapshot field: invalidField');
+        });
+    });
+    describe('takeSnapshot', () => {
+        let agent;
+        beforeEach(() => {
+            agent = createTestAgent();
+        });
+        it('creates snapshot with session preset', () => {
+            agent.messages.push(new Message({ role: 'user', content: [new TextBlock('Hello')] }));
+            agent.state.set('key', 'value');
+            agent.systemPrompt = 'Test prompt';
+            const snapshot = takeSnapshot(agent, { preset: 'session' });
+            expect(snapshot).toEqual({
+                scope: 'agent',
+                schemaVersion: SNAPSHOT_SCHEMA_VERSION,
+                createdAt: MOCK_TIMESTAMP,
+                data: {
+                    messages: [{ role: 'user', content: [{ text: 'Hello' }] }],
+                    state: { key: 'value' },
+                    systemPrompt: 'Test prompt',
+                },
+                appData: {},
+            });
+        });
+        it('includes appData in snapshot', () => {
+            const snapshot = takeSnapshot(agent, {
+                preset: 'session',
+                appData: { customKey: 'customValue' },
+            });
+            expect(snapshot.appData).toEqual({ customKey: 'customValue' });
+        });
+        it('excludes specified fields', () => {
+            agent.messages.push(new Message({ role: 'user', content: [new TextBlock('Hello')] }));
+            agent.state.set('key', 'value');
+            const snapshot = takeSnapshot(agent, { preset: 'session', exclude: ['messages'] });
+            expect(snapshot.data.messages).toBeUndefined();
+            expect(snapshot.data.state).toBeDefined();
+        });
+    });
+    describe('loadSnapshot', () => {
+        let agent;
+        beforeEach(() => {
+            agent = createTestAgent();
+        });
+        it('throws error for incompatible schema version', () => {
+            const snapshot = {
+                scope: 'agent',
+                schemaVersion: '2.0',
+                createdAt: createTimestamp(),
+                data: {},
+                appData: {},
+            };
+            expect(() => loadSnapshot(agent, snapshot)).toThrow('Unsupported snapshot schema version: 2.0. Current version: 1.0');
+        });
+        it('restores messages from snapshot', () => {
+            const snapshot = {
+                scope: 'agent',
+                schemaVersion: '1.0',
+                createdAt: createTimestamp(),
+                data: {
+                    messages: [{ role: 'user', content: [{ text: 'Restored message' }] }],
+                },
+                appData: {},
+            };
+            loadSnapshot(agent, snapshot);
+            expect(agent.messages).toHaveLength(1);
+            expect(agent.messages[0]).toEqual(new Message({ role: 'user', content: [new TextBlock('Restored message')] }));
+        });
+        it('restores state from snapshot', () => {
+            const snapshot = {
+                scope: 'agent',
+                schemaVersion: '1.0',
+                createdAt: createTimestamp(),
+                data: {
+                    state: { restoredKey: 'restoredValue' },
+                },
+                appData: {},
+            };
+            loadSnapshot(agent, snapshot);
+            expect(agent.state.get('restoredKey')).toBe('restoredValue');
+        });
+        it('restores systemPrompt from snapshot', () => {
+            const snapshot = {
+                scope: 'agent',
+                schemaVersion: '1.0',
+                createdAt: createTimestamp(),
+                data: {
+                    systemPrompt: 'Restored system prompt',
+                },
+                appData: {},
+            };
+            loadSnapshot(agent, snapshot);
+            expect(agent.systemPrompt).toBe('Restored system prompt');
+        });
+        it('leaves systemPrompt unchanged when snapshot has null systemPrompt', () => {
+            agent.systemPrompt = 'Original prompt';
+            const snapshot = {
+                scope: 'agent',
+                schemaVersion: '1.0',
+                createdAt: createTimestamp(),
+                data: { systemPrompt: null },
+                appData: {},
+            };
+            loadSnapshot(agent, snapshot);
+            // systemPrompt should remain unchanged since snapshot had null
+            expect(agent.systemPrompt).toBe('Original prompt');
+        });
+    });
+    describe('round-trip', () => {
+        let agent;
+        beforeEach(() => {
+            agent = createTestAgent();
+        });
+        it('preserves messages through save/load cycle', () => {
+            const originalMessages = [
+                new Message({ role: 'user', content: [new TextBlock('Hello')] }),
+                new Message({ role: 'assistant', content: [new TextBlock('Hi!')] }),
+            ];
+            agent.messages.push(...originalMessages);
+            const snapshot = takeSnapshot(agent, { preset: 'session' });
+            // Modify agent
+            agent.messages.length = 0;
+            agent.messages.push(new Message({ role: 'user', content: [new TextBlock('Different')] }));
+            // Restore
+            loadSnapshot(agent, snapshot);
+            expect(agent.messages).toEqual(originalMessages);
+        });
+        it('preserves state through save/load cycle', () => {
+            agent.state.set('userId', 'user-123');
+            agent.state.set('counter', 42);
+            const snapshot = takeSnapshot(agent, { preset: 'session' });
+            // Modify state
+            agent.state.clear();
+            agent.state.set('different', 'value');
+            // Restore
+            loadSnapshot(agent, snapshot);
+            expect(agent.state.getAll()).toEqual({ userId: 'user-123', counter: 42 });
+        });
+        it('handles complex message content', () => {
+            const toolUseBlock = new ToolUseBlock({
+                name: 'calculator',
+                toolUseId: 'tool-123',
+                input: { operation: 'add', numbers: [1, 2, 3] },
+            });
+            const toolResultBlock = new ToolResultBlock({
+                toolUseId: 'tool-123',
+                status: 'success',
+                content: [new TextBlock('6')],
+            });
+            const originalMessages = [
+                new Message({ role: 'assistant', content: [toolUseBlock] }),
+                new Message({ role: 'user', content: [toolResultBlock] }),
+            ];
+            agent.messages.push(...originalMessages);
+            const snapshot = takeSnapshot(agent, { include: ['messages'] });
+            agent.messages.length = 0;
+            loadSnapshot(agent, snapshot);
+            expect(agent.messages).toEqual(originalMessages);
+        });
+    });
+    describe('JSON serialization', () => {
+        it('snapshot survives JSON.stringify/JSON.parse round-trip', () => {
+            const agent = createTestAgent();
+            agent.messages.push(new Message({ role: 'user', content: [new TextBlock('Hello')] }));
+            agent.state.set('userId', 'user-123');
+            agent.systemPrompt = 'You are a helpful assistant';
+            const snapshot = takeSnapshot(agent, { preset: 'session' });
+            // Serialize to JSON string and parse back
+            const jsonString = JSON.stringify(snapshot);
+            const parsed = JSON.parse(jsonString);
+            // Verify structure is preserved
+            expect(parsed).toEqual(snapshot);
+        });
+        it('snapshot can be stored and retrieved as JSON string', () => {
+            const agent = createTestAgent();
+            agent.messages.push(new Message({ role: 'user', content: [new TextBlock('Test message')] }));
+            agent.state.set('key', 'value');
+            const snapshot = takeSnapshot(agent, { preset: 'session' });
+            // Simulate storing to a database or file as JSON
+            const stored = JSON.stringify(snapshot);
+            // Simulate retrieving and restoring
+            const retrieved = JSON.parse(stored);
+            const newAgent = createTestAgent();
+            loadSnapshot(newAgent, retrieved);
+            expect(newAgent.messages).toHaveLength(1);
+            expect(newAgent.state.getAll()).toEqual({ key: 'value' });
+        });
+    });
+});
+//# sourceMappingURL=snapshot.test.js.map

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

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

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

@@ -1,10 +1,13 @@
 import { AgentResult, type AgentStreamEvent, type ContentBlock, type ContentBlockData, type JSONValue, McpClient, Message, type MessageData, type SystemPrompt, type SystemPromptData, type Tool } from '../index.js';
-import type { BaseModelConfig, Model } from '../models/model.js';
+import { Model } from '../models/model.js';
+import type { BaseModelConfig } from '../models/model.js';
 import { ToolRegistry } from '../registry/tool-registry.js';
-import { AgentState } from './state.js';
+import { AppState } from '../app-state.js';
 import type { AgentData } from '../types/agent.js';
 import type { HookProvider } from '../hooks/types.js';
 import { HookRegistryImplementation } from '../hooks/registry.js';
+import type { z } from 'zod';
+import type { AttributeValue } from '@opentelemetry/api';
 /**
  * Recursive type definition for nested tool arrays.
  * Allows tools to be organized in nested arrays of any depth.
@@ -66,6 +69,24 @@ export type AgentConfig = {
      * Hooks enable observing and extending agent behavior.
      */
     hooks?: HookProvider[];
+    /**
+     * Zod schema for structured output validation.
+     */
+    structuredOutputSchema?: z.ZodSchema;
+    /**
+     * Custom trace attributes to include in all spans.
+     * These attributes are merged with standard attributes in telemetry spans.
+     * Telemetry must be enabled globally via telemetry.setupTracer() for these to take effect.
+     */
+    traceAttributes?: Record<string, AttributeValue>;
+    /**
+     * Optional name for the agent. Defaults to "Strands Agent".
+     */
+    name?: string;
+    /**
+     * Optional unique identifier for the agent. Defaults to "default".
+     */
+    agentId?: string;
 };
 /**
  * Arguments for invoking an agent.
@@ -76,6 +97,15 @@ export type AgentConfig = {
  * - `Message[]` | `MessageData[]` - Array of messages (appends all to conversation)
  */
 export type InvokeArgs = string | ContentBlock[] | ContentBlockData[] | Message[] | MessageData[];
+/**
+ * Options for a single agent invocation.
+ */
+export interface InvokeOptions {
+    /**
+     * Zod schema for structured output validation, overriding the constructor-provided schema for this invocation only.
+     */
+    structuredOutputSchema?: z.ZodSchema;
+}
 /**
  * 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
@@ -87,10 +117,10 @@ export declare class Agent implements AgentData {
      */
     readonly messages: Message[];
     /**
-     * Agent state storage accessible to tools and application logic.
+     * App state storage accessible to tools and application logic.
      * State is not passed to the model during inference.
      */
-    readonly state: AgentState;
+    readonly state: AppState;
     /**
      * Conversation manager for handling message history and context overflow.
      */
@@ -108,11 +138,24 @@ export declare class Agent implements AgentData {
      * The system prompt to pass to the model provider.
      */
     systemPrompt?: SystemPrompt;
+    /**
+     * The name of the agent.
+     */
+    readonly name: string;
+    /**
+     * The unique identifier of the agent instance.
+     */
+    readonly agentId: string;
     private _toolRegistry;
     private _mcpClients;
     private _initialized;
     private _isInvoking;
     private _printer?;
+    private _structuredOutputSchema?;
+    /** Tracer instance for creating and managing OpenTelemetry spans. */
+    private _tracer;
+    /** Running total of token usage across all model invocations in the current invocation. */
+    private _accumulatedTokenUsage;
     /**
      * Creates an instance of the Agent.
      * @param config - The configuration for the agent.
@@ -140,6 +183,7 @@ export declare class Agent implements AgentData {
      * streaming events.
      *
      * @param args - Arguments for invoking the agent
+     * @param options - Optional per-invocation options
      * @returns Promise that resolves to the final AgentResult
      *
      * @example
@@ -149,7 +193,7 @@ export declare class Agent implements AgentData {
      * console.log(result.lastMessage) // Agent's response
      * ```
      */
-    invoke(args: InvokeArgs): Promise<AgentResult>;
+    invoke(args: InvokeArgs, options?: InvokeOptions): Promise<AgentResult>;
     /**
      * Streams the agent execution, yielding events and returning the final result.
      *
@@ -167,6 +211,7 @@ export declare class Agent implements AgentData {
      * with valid toolResponses
      *
      * @param args - Arguments for invoking the agent
+     * @param options - Optional per-invocation options
      * @returns Async generator that yields AgentStreamEvent objects and returns AgentResult
      *
      * @example
@@ -179,12 +224,13 @@ export declare class Agent implements AgentData {
      * // Messages array is mutated in place and contains the full conversation
      * ```
      */
-    stream(args: InvokeArgs): AsyncGenerator<AgentStreamEvent, AgentResult, undefined>;
+    stream(args: InvokeArgs, options?: InvokeOptions): 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
+     * @param options - Optional per-invocation options
      * @returns Async generator that yields AgentStreamEvent objects and returns AgentResult
      */
     private _stream;
@@ -199,11 +245,21 @@ export declare class Agent implements AgentData {
      * Invokes the model provider and streams all events.
      *
      * @param args - Optional arguments for invoking the model
+     * @param toolChoice - Optional tool choice to force specific tool usage
      * @returns Object containing the assistant message and stop reason
      */
     private invokeModel;
     /**
-     * Streams events from the model and fires ModelStreamEventHook for each event.
+     * Streams events from the model and dispatches appropriate events for each.
+     *
+     * The model's `streamAggregated()` yields two kinds of output:
+     * - **ModelStreamEvent**: Transient streaming deltas (partial data while generating).
+     *   Wrapped in {@link ModelStreamUpdateEvent} before yielding.
+     * - **ContentBlock**: Fully assembled results (after all deltas accumulate).
+     *   Wrapped in {@link ContentBlockEvent} before yielding.
+     *
+     * These are separate event classes because they represent different granularities
+     * (partial deltas vs finished blocks). Both are yielded in the stream and hookable.
      *
      * @param messages - Messages to send to the model
      * @param streamOptions - Options for streaming
@@ -230,12 +286,24 @@ export declare class Agent implements AgentData {
      */
     private executeTool;
     /**
-     * Appends a message to the conversation history, invokes MessageAddedEvent hook,
-     * and returns the event for yielding.
+     * Appends a message to the conversation history and returns the event for yielding.
      *
      * @param message - The message to append
-     * @returns MessageAddedEvent to be yielded (hook already invoked)
+     * @returns MessageAddedEvent to be yielded
      */
     private _appendMessage;
+    /**
+     * Creates an empty Usage object with all counters set to zero.
+     *
+     * @returns A Usage object with zeroed counters
+     */
+    private static _createEmptyUsage;
+    /**
+     * Accumulates token usage from a source into a target Usage object.
+     *
+     * @param target - The Usage object to accumulate into (mutated in place)
+     * @param source - The Usage object to accumulate from
+     */
+    private static _accumulateUsage;
 }
 //# sourceMappingURL=agent.d.ts.map

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

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