@strands-agents/sdk 0.0.1

package/dist/tools/__tests__/zod-tool.test.js

@@ -0,0 +1,342 @@
+import { describe, it, expect, vi } from 'vitest';
+import { z } from 'zod';
+import { tool } from '../zod-tool';
+import { createMockContext } from '../../__fixtures__/tool-helpers';
+import { collectGenerator } from '../../__fixtures__/model-test-helpers';
+describe('tool', () => {
+    describe('tool creation and properties', () => {
+        it('creates tool with correct properties', () => {
+            const myTool = tool({
+                name: 'testTool',
+                description: 'Test description',
+                inputSchema: z.object({ value: z.string() }),
+                callback: (input) => input.value,
+            });
+            expect(myTool.toolName).toBe('testTool');
+            expect(myTool.description).toBe('Test description');
+            expect(myTool.toolSpec).toEqual({
+                name: 'testTool',
+                description: 'Test description',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        value: { type: 'string' },
+                    },
+                    required: ['value'],
+                    additionalProperties: false,
+                },
+            });
+        });
+        it('handles optional description', () => {
+            const myTool = tool({
+                name: 'testTool',
+                inputSchema: z.object({ value: z.string() }),
+                callback: (input) => input.value,
+            });
+            expect(myTool.toolName).toBe('testTool');
+            expect(myTool.description).toBe('');
+        });
+    });
+    describe('invoke() method', () => {
+        describe('basic return types', () => {
+            it('handles synchronous callback', async () => {
+                const myTool = tool({
+                    name: 'sync',
+                    description: 'Synchronous tool',
+                    inputSchema: z.object({ a: z.number(), b: z.number() }),
+                    callback: (input) => input.a + input.b,
+                });
+                const result = await myTool.invoke({ a: 5, b: 3 });
+                expect(result).toBe(8);
+            });
+            it('handles promise callback', async () => {
+                const myTool = tool({
+                    name: 'async',
+                    description: 'Async tool',
+                    inputSchema: z.object({ value: z.string() }),
+                    callback: async (input) => `Result: ${input.value}`,
+                });
+                const result = await myTool.invoke({ value: 'test' });
+                expect(result).toBe('Result: test');
+            });
+            it('handles async generator callback', async () => {
+                const myTool = tool({
+                    name: 'generator',
+                    description: 'Generator tool',
+                    inputSchema: z.object({ count: z.number() }),
+                    callback: async function* (input) {
+                        for (let i = 1; i <= input.count; i++) {
+                            yield i;
+                        }
+                        return 0;
+                    },
+                });
+                const result = await myTool.invoke({ count: 3 });
+                expect(result).toBe(3);
+            });
+        });
+        describe('validation', () => {
+            it('throws on invalid input', async () => {
+                const myTool = tool({
+                    name: 'validator',
+                    description: 'Validates input',
+                    inputSchema: z.object({ age: z.number().min(0).max(120) }),
+                    callback: (input) => input.age,
+                });
+                await expect(myTool.invoke({ age: -1 })).rejects.toThrow();
+                await expect(myTool.invoke({ age: 150 })).rejects.toThrow();
+            });
+            it('validates required fields', async () => {
+                const myTool = tool({
+                    name: 'required',
+                    description: 'Required fields',
+                    inputSchema: z.object({
+                        name: z.string(),
+                        email: z.string().email(),
+                    }),
+                    callback: (input) => `${input.name}: ${input.email}`,
+                });
+                await expect(myTool.invoke({ name: 'John' })).rejects.toThrow();
+                await expect(myTool.invoke({ email: 'invalid-email' })).rejects.toThrow();
+            });
+        });
+        describe('context handling', () => {
+            it('passes context to callback', async () => {
+                const callback = vi.fn((input, context) => {
+                    expect(context).toBeDefined();
+                    expect(context?.invocationState).toBeDefined();
+                    return input.value;
+                });
+                const myTool = tool({
+                    name: 'context',
+                    description: 'Uses context',
+                    inputSchema: z.object({ value: z.string() }),
+                    callback,
+                });
+                const mockContext = createMockContext({ value: 'test' }, { userId: 'user-123' });
+                await myTool.invoke({ value: 'test' }, mockContext);
+                expect(callback).toHaveBeenCalled();
+            });
+        });
+    });
+    describe('stream() method', () => {
+        describe('basic return types', () => {
+            it('streams synchronous callback result', async () => {
+                const myTool = tool({
+                    name: 'sync',
+                    description: 'Synchronous tool',
+                    inputSchema: z.object({ value: z.string() }),
+                    callback: (input) => input.value,
+                });
+                const context = createMockContext({ value: 'hello' });
+                const { items: events, result } = await collectGenerator(myTool.stream(context));
+                expect(events).toHaveLength(0); // No stream events for sync
+                expect(result.status).toBe('success');
+                expect(result.content).toHaveLength(1);
+                expect(result.content[0]).toEqual({ type: 'toolResultTextContent', text: 'hello' });
+            });
+            it('streams promise callback result', async () => {
+                const myTool = tool({
+                    name: 'async',
+                    description: 'Async tool',
+                    inputSchema: z.object({ value: z.number() }),
+                    callback: async (input) => input.value * 2,
+                });
+                const context = createMockContext({ value: 21 });
+                const { items: events, result } = await collectGenerator(myTool.stream(context));
+                expect(events).toHaveLength(0); // No stream events for promise
+                expect(result.status).toBe('success');
+                expect(result.content).toHaveLength(1);
+                expect(result.content[0]).toEqual({ type: 'toolResultTextContent', text: '42' });
+            });
+            it('streams async generator callback results', async () => {
+                const myTool = tool({
+                    name: 'generator',
+                    description: 'Generator tool',
+                    inputSchema: z.object({ count: z.number() }),
+                    callback: async function* (input) {
+                        for (let i = 1; i <= input.count; i++) {
+                            yield `Step ${i}`;
+                        }
+                        return 0;
+                    },
+                });
+                const context = createMockContext({ count: 3 });
+                const { items: events, result } = await collectGenerator(myTool.stream(context));
+                expect(events).toHaveLength(3);
+                const eventData = events.map((e) => e.data);
+                expect(eventData).toEqual(['Step 1', 'Step 2', 'Step 3']);
+                expect(result.status).toBe('success');
+            });
+        });
+        describe('validation', () => {
+            it('returns error result on validation failure', async () => {
+                const myTool = tool({
+                    name: 'validator',
+                    description: 'Validates input',
+                    inputSchema: z.object({ age: z.number().min(0) }),
+                    callback: (input) => input.age,
+                });
+                const context = createMockContext({ age: -5 });
+                const { items: events, result } = await collectGenerator(myTool.stream(context));
+                expect(events).toHaveLength(0);
+                expect(result.status).toBe('error');
+                expect(result.content.length).toBeGreaterThan(0);
+                const firstContent = result.content[0];
+                if (firstContent && firstContent.type === 'toolResultTextContent') {
+                    expect(firstContent.text).toContain('age');
+                }
+            });
+            it('returns error result on missing required fields', async () => {
+                const myTool = tool({
+                    name: 'required',
+                    description: 'Required fields',
+                    inputSchema: z.object({
+                        name: z.string(),
+                        value: z.number(),
+                    }),
+                    callback: (input) => `${input.name}: ${input.value}`,
+                });
+                const context = createMockContext({ name: 'test' });
+                const { items: events, result } = await collectGenerator(myTool.stream(context));
+                expect(events).toHaveLength(0);
+                expect(result.status).toBe('error');
+            });
+        });
+        describe('error handling', () => {
+            it('catches callback errors and returns error result', async () => {
+                const myTool = tool({
+                    name: 'error',
+                    description: 'Throws error',
+                    inputSchema: z.object({ value: z.string() }),
+                    callback: () => {
+                        throw new Error('Callback error');
+                    },
+                });
+                const context = createMockContext({ value: 'test' });
+                const { items: events, result } = await collectGenerator(myTool.stream(context));
+                expect(events).toHaveLength(0);
+                expect(result.status).toBe('error');
+                expect(result.content.length).toBeGreaterThan(0);
+                const firstContent = result.content[0];
+                if (firstContent && firstContent.type === 'toolResultTextContent') {
+                    expect(firstContent.text).toBe('Error: Callback error');
+                }
+            });
+            it('catches async callback errors', async () => {
+                const myTool = tool({
+                    name: 'asyncError',
+                    description: 'Throws async error',
+                    inputSchema: z.object({ value: z.string() }),
+                    callback: async () => {
+                        throw new Error('Async error');
+                    },
+                });
+                const context = createMockContext({ value: 'test' });
+                const { items: events, result } = await collectGenerator(myTool.stream(context));
+                expect(events).toHaveLength(0);
+                expect(result.status).toBe('error');
+                expect(result.content.length).toBeGreaterThan(0);
+                const firstContent = result.content[0];
+                if (firstContent && firstContent.type === 'toolResultTextContent') {
+                    expect(firstContent.text).toBe('Error: Async error');
+                }
+            });
+        });
+    });
+    describe('complex scenarios', () => {
+        it('handles nested object schemas', async () => {
+            const myTool = tool({
+                name: 'nested',
+                description: 'Nested objects',
+                inputSchema: z.object({
+                    user: z.object({
+                        name: z.string(),
+                        age: z.number(),
+                    }),
+                    metadata: z.object({
+                        timestamp: z.number(),
+                    }),
+                }),
+                callback: (input) => `${input.user.name} (${input.user.age})`,
+            });
+            const result = await myTool.invoke({
+                user: { name: 'Alice', age: 30 },
+                metadata: { timestamp: Date.now() },
+            });
+            expect(result).toBe('Alice (30)');
+        });
+        it('handles enum schemas', async () => {
+            const myTool = tool({
+                name: 'calculator',
+                description: 'Basic calculator',
+                inputSchema: z.object({
+                    operation: z.enum(['add', 'subtract', 'multiply', 'divide']),
+                    a: z.number(),
+                    b: z.number(),
+                }),
+                callback: (input) => {
+                    switch (input.operation) {
+                        case 'add':
+                            return input.a + input.b;
+                        case 'subtract':
+                            return input.a - input.b;
+                        case 'multiply':
+                            return input.a * input.b;
+                        case 'divide':
+                            return input.a / input.b;
+                    }
+                },
+            });
+            expect(await myTool.invoke({ operation: 'add', a: 5, b: 3 })).toBe(8);
+            expect(await myTool.invoke({ operation: 'multiply', a: 4, b: 7 })).toBe(28);
+        });
+        it('handles optional fields', async () => {
+            const myTool = tool({
+                name: 'greeting',
+                description: 'Generates greeting',
+                inputSchema: z.object({
+                    name: z.string(),
+                    title: z.string().optional(),
+                }),
+                callback: (input) => {
+                    return input.title ? `${input.title} ${input.name}` : input.name;
+                },
+            });
+            expect(await myTool.invoke({ name: 'Smith' })).toBe('Smith');
+            expect(await myTool.invoke({ name: 'Smith', title: 'Dr.' })).toBe('Dr. Smith');
+        });
+        it('handles array schemas', async () => {
+            const myTool = tool({
+                name: 'sum',
+                description: 'Sums numbers',
+                inputSchema: z.object({
+                    numbers: z.array(z.number()),
+                }),
+                callback: (input) => input.numbers.reduce((a, b) => a + b, 0),
+            });
+            expect(await myTool.invoke({ numbers: [1, 2, 3, 4, 5] })).toBe(15);
+        });
+    });
+    describe('JSON schema generation', () => {
+        it('generates valid JSON schema from Zod schema', () => {
+            const myTool = tool({
+                name: 'test',
+                description: 'Test tool',
+                inputSchema: z.object({
+                    name: z.string(),
+                    age: z.number(),
+                    email: z.string().email(),
+                }),
+                callback: () => 'result',
+            });
+            const schema = myTool.toolSpec.inputSchema;
+            expect(schema.type).toBe('object');
+            expect(schema.properties).toBeDefined();
+            expect(schema.required).toContain('name');
+            expect(schema.required).toContain('age');
+            expect(schema.required).toContain('email');
+        });
+    });
+});
+//# sourceMappingURL=zod-tool.test.js.map

package/dist/tools/__tests__/zod-tool.test.js.map

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

package/dist/tools/function-tool.d.ts

@@ -0,0 +1,156 @@
+import type { Tool, ToolContext, ToolStreamEvent } from './tool';
+import type { ToolSpec, ToolResult } from './types';
+import type { JSONSchema, JSONValue } from '../types/json';
+/**
+ * Callback function for FunctionTool implementations.
+ * The callback can return values in multiple ways, and FunctionTool handles the conversion to ToolResult.
+ *
+ * @param input - The input parameters conforming to the tool's inputSchema
+ * @param toolContext - The tool execution context with invocation state
+ * @returns Can return:
+ *   - AsyncGenerator: Each yielded value becomes a ToolStreamEvent, final value wrapped in ToolResult
+ *   - Promise: Resolved value is wrapped in ToolResult
+ *   - Synchronous value: Value is wrapped in ToolResult
+ *   - If an error is thrown, it's handled and returned as an error ToolResult
+ *
+ * @example
+ * ```typescript
+ * // Async generator example
+ * async function* calculator(input: unknown, context: ToolContext) {
+ *   yield 'Calculating...'
+ *   const result = input.a + input.b
+ *   yield `Result: ${result}`
+ *   return result
+ * }
+ *
+ * // Promise example
+ * async function fetchData(input: unknown, context: ToolContext) {
+ *   const response = await fetch(input.url)
+ *   return await response.json()
+ * }
+ *
+ * // Synchronous example
+ * function multiply(input: unknown, context: ToolContext) {
+ *   return input.a * input.b
+ * }
+ * ```
+ */
+export type FunctionToolCallback = (input: unknown, toolContext: ToolContext) => AsyncGenerator<JSONValue, JSONValue, never> | Promise<JSONValue> | JSONValue;
+/**
+ * Configuration options for creating a FunctionTool.
+ */
+export interface FunctionToolConfig {
+    /** The unique name of the tool */
+    name: string;
+    /** Human-readable description of the tool's purpose */
+    description: string;
+    /** JSON Schema defining the expected input structure */
+    inputSchema: JSONSchema;
+    /** Function that implements the tool logic */
+    callback: FunctionToolCallback;
+}
+/**
+ * A Tool implementation that wraps a callback function and handles all ToolResult conversion.
+ *
+ * FunctionTool allows creating tools from existing functions without needing to manually
+ * handle ToolResult formatting or error handling. It supports multiple callback patterns:
+ * - Async generators for streaming responses
+ * - Promises for async operations
+ * - Synchronous functions for immediate results
+ *
+ * All return values are automatically wrapped in ToolResult, and errors are caught and
+ * returned as error ToolResults.
+ *
+ * @example
+ * ```typescript
+ * // Create a tool with streaming
+ * const streamingTool = new FunctionTool({
+ *   name: 'processor',
+ *   description: 'Processes data with progress updates',
+ *   inputSchema: { type: 'object', properties: { data: { type: 'string' } } },
+ *   callback: async function* (input: any) {
+ *     yield 'Starting processing...'
+ *     // Do some work
+ *     yield 'Halfway done...'
+ *     // More work
+ *     return 'Processing complete!'
+ *   }
+ * })
+ * ```
+ */
+export declare class FunctionTool implements Tool {
+    /**
+     * The unique name of the tool.
+     */
+    readonly toolName: string;
+    /**
+     * Human-readable description of what the tool does.
+     */
+    readonly description: string;
+    /**
+     * OpenAPI JSON specification for the tool.
+     */
+    readonly toolSpec: ToolSpec;
+    /**
+     * The callback function that implements the tool's logic.
+     */
+    private readonly _callback;
+    /**
+     * Creates a new FunctionTool instance.
+     *
+     * @param config - Configuration object for the tool
+     *
+     * @example
+     * ```typescript
+     * const tool = new FunctionTool({
+     *   name: 'greeter',
+     *   description: 'Greets a person by name',
+     *   inputSchema: {
+     *     type: 'object',
+     *     properties: { name: { type: 'string' } },
+     *     required: ['name']
+     *   },
+     *   callback: (input: any) => `Hello, ${input.name}!`
+     * })
+     * ```
+     */
+    constructor(config: FunctionToolConfig);
+    /**
+     * Executes the tool with streaming support.
+     * Handles all callback patterns (async generator, promise, sync) and converts results to ToolResult.
+     *
+     * @param toolContext - Context information including the tool use request and invocation state
+     * @returns Async generator that yields ToolStreamEvents and returns a ToolResult
+     */
+    stream(toolContext: ToolContext): AsyncGenerator<ToolStreamEvent, ToolResult, unknown>;
+    /**
+     * Wraps a value in a ToolResult with success status.
+     *
+     * Due to AWS Bedrock limitations (only accepts objects as JSON content), the following
+     * rules are applied:
+     * - Strings → toolResultTextContent
+     * - Numbers, Booleans → toolResultTextContent (converted to string)
+     * - null, undefined → toolResultTextContent (special string representation)
+     * - Objects → toolResultJsonContent (with deep copy)
+     * - Arrays → toolResultJsonContent wrapped in \{ $value: array \} (with deep copy)
+     *
+     * @param value - The value to wrap (can be any type)
+     * @param toolUseId - The tool use ID for the ToolResult
+     * @returns A ToolResult containing the value
+     */
+    private _wrapInToolResult;
+    /**
+     * Creates an error ToolResult from an error object.
+     * Ensures all errors are normalized to Error objects and includes the original error
+     * in the ToolResult for inspection by hooks, error handlers, and event loop.
+     *
+     * TODO: Implement consistent logging format as defined in #30
+     * This error should be logged to the caller using the established logging pattern.
+     *
+     * @param error - The error that occurred (can be Error object or any thrown value)
+     * @param toolUseId - The tool use ID for the ToolResult
+     * @returns A ToolResult with error status, error message content, and original error object
+     */
+    private _createErrorResult;
+}
+//# sourceMappingURL=function-tool.d.ts.map

package/dist/tools/function-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"function-tool.d.ts","sourceRoot":"","sources":["../../src/tools/function-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAA;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAG1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,MAAM,oBAAoB,GAAG,CACjC,KAAK,EAAE,OAAO,EACd,WAAW,EAAE,WAAW,KACrB,cAAc,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,SAAS,CAAA;AAEjF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAA;IACnB,wDAAwD;IACxD,WAAW,EAAE,UAAU,CAAA;IACvB,8CAA8C;IAC9C,QAAQ,EAAE,oBAAoB,CAAA;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,YAAa,YAAW,IAAI;IACvC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IAEzB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAE5B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAE3B;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAEhD;;;;;;;;;;;;;;;;;;OAkBG;gBACS,MAAM,EAAE,kBAAkB;IAWtC;;;;;;OAMG;IACI,MAAM,CAAC,WAAW,EAAE,WAAW,GAAG,cAAc,CAAC,eAAe,EAAE,UAAU,EAAE,OAAO,CAAC;IAuC7F;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,iBAAiB;IA8EzB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,kBAAkB;CAgB3B"}