@strands-agents/sdk 0.2.2 → 0.4.0

package/dist/src/structured-output/__tests__/utils.test.js

@@ -0,0 +1,183 @@
+import { describe, expect, it } from 'vitest';
+import { z } from 'zod';
+import { convertSchemaToToolSpec, getSchemaDescription } from '../utils.js';
+import { StructuredOutputException } from '../exceptions.js';
+describe('convertSchemaToToolSpec', () => {
+    it('converts basic schema to tool spec', () => {
+        const schema = z.object({
+            name: z.string(),
+            age: z.number(),
+        });
+        const toolSpec = convertSchemaToToolSpec(schema, 'TestTool');
+        expect(toolSpec.name).toBe('TestTool');
+        expect(toolSpec.description).toContain('StructuredOutputTool');
+        expect(toolSpec.inputSchema).toStrictEqual({
+            type: 'object',
+            properties: {
+                name: { type: 'string' },
+                age: { type: 'number' },
+            },
+            required: ['name', 'age'],
+            additionalProperties: false,
+        });
+    });
+    it('includes schema description in tool spec', () => {
+        const schema = z
+            .object({
+            name: z.string(),
+        })
+            .describe('A person object');
+        const toolSpec = convertSchemaToToolSpec(schema, 'TestTool');
+        expect(toolSpec.description).toContain('A person object');
+    });
+    it('throws error for schema with refinements', () => {
+        const schema = z.object({
+            name: z.string().refine((val) => val.length > 0, 'Name cannot be empty'),
+        });
+        expect(() => convertSchemaToToolSpec(schema, 'TestTool')).toThrow(StructuredOutputException);
+        expect(() => convertSchemaToToolSpec(schema, 'TestTool')).toThrow('Zod refinements and transforms are not supported');
+    });
+    it('throws error for schema with transforms', () => {
+        const schema = z.string().transform((val) => val.toUpperCase());
+        expect(() => convertSchemaToToolSpec(schema, 'TestTool')).toThrow(StructuredOutputException);
+        expect(() => convertSchemaToToolSpec(schema, 'TestTool')).toThrow('Zod refinements and transforms are not supported');
+    });
+    it('throws error for schema with superRefine', () => {
+        const schema = z.object({ name: z.string() }).superRefine((val, ctx) => {
+            if (val.name.length === 0) {
+                ctx.addIssue({ code: z.ZodIssueCode.custom, message: 'Name required' });
+            }
+        });
+        expect(() => convertSchemaToToolSpec(schema, 'TestTool')).toThrow(StructuredOutputException);
+    });
+    it('accepts schema with basic validations', () => {
+        const schema = z.object({
+            name: z.string().min(1).max(100),
+            age: z.number().int().positive(),
+            email: z.string().email(),
+        });
+        const toolSpec = convertSchemaToToolSpec(schema, 'TestTool');
+        expect(toolSpec.inputSchema).toMatchObject({
+            type: 'object',
+            properties: {
+                name: {
+                    type: 'string',
+                    minLength: 1,
+                    maxLength: 100,
+                },
+                age: {
+                    type: 'integer',
+                },
+                email: {
+                    type: 'string',
+                    format: 'email',
+                },
+            },
+            required: ['name', 'age', 'email'],
+            additionalProperties: false,
+        });
+    });
+    it('throws error for nested schema with refinements', () => {
+        const schema = z.object({
+            user: z.object({
+                name: z.string().refine((val) => val.length > 0),
+            }),
+        });
+        expect(() => convertSchemaToToolSpec(schema, 'TestTool')).toThrow(StructuredOutputException);
+    });
+    it('accepts nested schema without refinements', () => {
+        const schema = z.object({
+            user: z.object({
+                name: z.string(),
+                age: z.number(),
+            }),
+            items: z.array(z.string()),
+        });
+        const toolSpec = convertSchemaToToolSpec(schema, 'TestTool');
+        expect(toolSpec.inputSchema).toStrictEqual({
+            type: 'object',
+            properties: {
+                user: {
+                    type: 'object',
+                    properties: {
+                        name: { type: 'string' },
+                        age: { type: 'number' },
+                    },
+                    required: ['name', 'age'],
+                    additionalProperties: false,
+                },
+                items: {
+                    type: 'array',
+                    items: { type: 'string' },
+                },
+            },
+            required: ['user', 'items'],
+            additionalProperties: false,
+        });
+    });
+    it('throws error for array with refinements', () => {
+        const schema = z.array(z.string().refine((val) => val.length > 0));
+        expect(() => convertSchemaToToolSpec(schema, 'TestTool')).toThrow(StructuredOutputException);
+    });
+    it('accepts union types', () => {
+        const schema = z.union([z.string(), z.number()]);
+        expect(() => convertSchemaToToolSpec(schema, 'TestTool')).not.toThrow();
+    });
+    it('accepts optional fields', () => {
+        const schema = z.object({
+            name: z.string(),
+            age: z.number().optional(),
+        });
+        const toolSpec = convertSchemaToToolSpec(schema, 'TestTool');
+        expect(toolSpec.inputSchema).toStrictEqual({
+            type: 'object',
+            properties: {
+                name: { type: 'string' },
+                age: { type: 'number' },
+            },
+            required: ['name'],
+            additionalProperties: false,
+        });
+    });
+    it('throws error for deeply nested refinements', () => {
+        const schema = z.object({
+            level1: z.object({
+                level2: z.object({
+                    level3: z.string().refine((val) => val.length > 0),
+                }),
+            }),
+        });
+        expect(() => convertSchemaToToolSpec(schema, 'TestTool')).toThrow(StructuredOutputException);
+    });
+    it('throws error for refinements in union types', () => {
+        const schema = z.union([z.string().refine((val) => val.length > 0), z.number()]);
+        expect(() => convertSchemaToToolSpec(schema, 'TestTool')).toThrow(StructuredOutputException);
+    });
+    it('throws error for refinements in array items', () => {
+        const schema = z.object({
+            items: z.array(z.object({
+                name: z.string().refine((val) => val.length > 0),
+            })),
+        });
+        expect(() => convertSchemaToToolSpec(schema, 'TestTool')).toThrow(StructuredOutputException);
+    });
+});
+describe('getSchemaDescription', () => {
+    it('returns description from schema metadata', () => {
+        const schema = z.object({ name: z.string() }).describe('Test description');
+        const description = getSchemaDescription(schema);
+        expect(description).toBe('Test description');
+    });
+    it('returns empty string when no description', () => {
+        const schema = z.object({ name: z.string() });
+        const description = getSchemaDescription(schema);
+        expect(description).toBe('');
+    });
+    it('returns description from _def', () => {
+        const schema = z.object({ name: z.string() });
+        schema._def.description = 'Description in _def';
+        const description = getSchemaDescription(schema);
+        expect(description).toBe('Description in _def');
+    });
+});
+//# sourceMappingURL=utils.test.js.map

package/dist/src/structured-output/__tests__/utils.test.js.map

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

package/dist/src/structured-output/context.d.ts

@@ -0,0 +1,91 @@
+import { z } from 'zod';
+import type { ToolRegistry } from '../registry/tool-registry.js';
+/**
+ * Interface for structured output context operations.
+ * Allows for null object pattern implementation.
+ */
+export interface IStructuredOutputContext {
+    registerTool(registry: ToolRegistry): void;
+    storeResult(toolUseId: string, result: unknown): void;
+    hasResult(): boolean;
+    getResult(): unknown | undefined;
+    getToolName(): string;
+    cleanup(registry: ToolRegistry): void;
+    readonly isEnabled: boolean;
+}
+/**
+ * Null object implementation that does nothing.
+ * Used when no structured output schema is provided.
+ */
+export declare class NullStructuredOutputContext implements IStructuredOutputContext {
+    readonly isEnabled = false;
+    registerTool(_registry: ToolRegistry): void;
+    storeResult(_toolUseId: string, _result: unknown): void;
+    hasResult(): boolean;
+    getResult(): unknown | undefined;
+    getToolName(): string;
+    cleanup(_registry: ToolRegistry): void;
+}
+/**
+ * Context for managing structured output tool lifecycle per-invocation.
+ * Handles tool registration, result storage, and cleanup.
+ */
+export declare class StructuredOutputContext implements IStructuredOutputContext {
+    readonly isEnabled = true;
+    private _schema;
+    private _tool?;
+    private _result;
+    /**
+     * Creates a new StructuredOutputContext.
+     *
+     * @param schema - Zod schema for structured output
+     */
+    constructor(schema: z.ZodSchema);
+    /**
+     * Registers the structured output tool with the tool registry.
+     *
+     * @param registry - The tool registry to register with
+     */
+    registerTool(registry: ToolRegistry): void;
+    /**
+     * Stores the validated result from the structured output tool.
+     * If called multiple times, only the latest result is kept.
+     *
+     * @param toolUseId - The tool use ID (unused, kept for interface compatibility)
+     * @param result - The validated result
+     */
+    storeResult(toolUseId: string, result: unknown): void;
+    /**
+     * Checks if a result has been stored.
+     *
+     * @returns true if a result has been stored
+     */
+    hasResult(): boolean;
+    /**
+     * Retrieves the stored result, if available.
+     *
+     * @returns The validated result or undefined if not yet stored
+     */
+    getResult(): unknown | undefined;
+    /**
+     * Gets the tool name for forcing.
+     *
+     * @returns The tool name or 'strands_structured_output' as fallback
+     */
+    getToolName(): string;
+    /**
+     * Cleans up the structured output tool by removing it from the registry.
+     * Should be called in a finally block to ensure cleanup happens regardless of success/failure.
+     *
+     * @param registry - The tool registry to clean up from
+     */
+    cleanup(registry: ToolRegistry): void;
+}
+/**
+ * Factory function to create the appropriate context based on schema presence.
+ *
+ * @param schema - Optional Zod schema for structured output
+ * @returns StructuredOutputContext if schema provided, NullStructuredOutputContext otherwise
+ */
+export declare function createStructuredOutputContext(schema?: z.ZodSchema): IStructuredOutputContext;
+//# sourceMappingURL=context.d.ts.map

package/dist/src/structured-output/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/structured-output/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAGhE;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,YAAY,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAA;IAC1C,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAAA;IACrD,SAAS,IAAI,OAAO,CAAA;IACpB,SAAS,IAAI,OAAO,GAAG,SAAS,CAAA;IAChC,WAAW,IAAI,MAAM,CAAA;IACrB,OAAO,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAA;IACrC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC5B;AAED;;;GAGG;AACH,qBAAa,2BAA4B,YAAW,wBAAwB;IAC1E,QAAQ,CAAC,SAAS,SAAQ;IAE1B,YAAY,CAAC,SAAS,EAAE,YAAY,GAAG,IAAI;IAI3C,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAIvD,SAAS,IAAI,OAAO;IAIpB,SAAS,IAAI,OAAO,GAAG,SAAS;IAIhC,WAAW,IAAI,MAAM;IAIrB,OAAO,CAAC,SAAS,EAAE,YAAY,GAAG,IAAI;CAGvC;AAED;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,wBAAwB;IACtE,QAAQ,CAAC,SAAS,QAAO;IAEzB,OAAO,CAAC,OAAO,CAAa;IAE5B,OAAO,CAAC,KAAK,CAAC,CAAkC;IAChD,OAAO,CAAC,OAAO,CAAqB;IAEpC;;;;OAIG;gBACS,MAAM,EAAE,CAAC,CAAC,SAAS;IAI/B;;;;OAIG;IACH,YAAY,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAO1C;;;;;;OAMG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAIrD;;;;OAIG;IACH,SAAS,IAAI,OAAO;IAIpB;;;;OAIG;IACH,SAAS,IAAI,OAAO,GAAG,SAAS;IAIhC;;;;OAIG;IACH,WAAW,IAAI,MAAM;IAIrB;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;CAMtC;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,GAAG,wBAAwB,CAE5F"}

package/dist/src/structured-output/context.js

@@ -0,0 +1,112 @@
+import { z } from 'zod';
+import { StructuredOutputTool } from './tool.js';
+/**
+ * Null object implementation that does nothing.
+ * Used when no structured output schema is provided.
+ */
+export class NullStructuredOutputContext {
+    isEnabled = false;
+    registerTool(_registry) {
+        // No-op
+    }
+    storeResult(_toolUseId, _result) {
+        // No-op
+    }
+    hasResult() {
+        return true; // Always "has result" to skip forcing logic
+    }
+    getResult() {
+        return undefined;
+    }
+    getToolName() {
+        return 'strands_structured_output';
+    }
+    cleanup(_registry) {
+        // No-op
+    }
+}
+/**
+ * Context for managing structured output tool lifecycle per-invocation.
+ * Handles tool registration, result storage, and cleanup.
+ */
+export class StructuredOutputContext {
+    isEnabled = true;
+    _schema;
+    // The `| undefined` is needed for `exactOptionalPropertyTypes` since we assign undefined in cleanup()
+    _tool;
+    _result = undefined;
+    /**
+     * Creates a new StructuredOutputContext.
+     *
+     * @param schema - Zod schema for structured output
+     */
+    constructor(schema) {
+        this._schema = schema;
+    }
+    /**
+     * Registers the structured output tool with the tool registry.
+     *
+     * @param registry - The tool registry to register with
+     */
+    registerTool(registry) {
+        this._tool = new StructuredOutputTool(this._schema, 'strands_structured_output', this);
+        // Register tool (will be removed in cleanup)
+        registry.add(this._tool);
+    }
+    /**
+     * Stores the validated result from the structured output tool.
+     * If called multiple times, only the latest result is kept.
+     *
+     * @param toolUseId - The tool use ID (unused, kept for interface compatibility)
+     * @param result - The validated result
+     */
+    storeResult(toolUseId, result) {
+        this._result = result;
+    }
+    /**
+     * Checks if a result has been stored.
+     *
+     * @returns true if a result has been stored
+     */
+    hasResult() {
+        return this._result !== undefined;
+    }
+    /**
+     * Retrieves the stored result, if available.
+     *
+     * @returns The validated result or undefined if not yet stored
+     */
+    getResult() {
+        return this._result;
+    }
+    /**
+     * Gets the tool name for forcing.
+     *
+     * @returns The tool name or 'strands_structured_output' as fallback
+     */
+    getToolName() {
+        return this._tool?.name ?? 'strands_structured_output';
+    }
+    /**
+     * Cleans up the structured output tool by removing it from the registry.
+     * Should be called in a finally block to ensure cleanup happens regardless of success/failure.
+     *
+     * @param registry - The tool registry to clean up from
+     */
+    cleanup(registry) {
+        if (this._tool) {
+            registry.removeByName(this._tool.name);
+            this._tool = undefined;
+        }
+    }
+}
+/**
+ * Factory function to create the appropriate context based on schema presence.
+ *
+ * @param schema - Optional Zod schema for structured output
+ * @returns StructuredOutputContext if schema provided, NullStructuredOutputContext otherwise
+ */
+export function createStructuredOutputContext(schema) {
+    return schema ? new StructuredOutputContext(schema) : new NullStructuredOutputContext();
+}
+//# sourceMappingURL=context.js.map

package/dist/src/structured-output/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/structured-output/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAgBhD;;;GAGG;AACH,MAAM,OAAO,2BAA2B;IAC7B,SAAS,GAAG,KAAK,CAAA;IAE1B,YAAY,CAAC,SAAuB;QAClC,QAAQ;IACV,CAAC;IAED,WAAW,CAAC,UAAkB,EAAE,OAAgB;QAC9C,QAAQ;IACV,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAA,CAAC,4CAA4C;IAC1D,CAAC;IAED,SAAS;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,WAAW;QACT,OAAO,2BAA2B,CAAA;IACpC,CAAC;IAED,OAAO,CAAC,SAAuB;QAC7B,QAAQ;IACV,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,uBAAuB;IACzB,SAAS,GAAG,IAAI,CAAA;IAEjB,OAAO,CAAa;IAC5B,sGAAsG;IAC9F,KAAK,CAAmC;IACxC,OAAO,GAAY,SAAS,CAAA;IAEpC;;;;OAIG;IACH,YAAY,MAAmB;QAC7B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;IACvB,CAAC;IAED;;;;OAIG;IACH,YAAY,CAAC,QAAsB;QACjC,IAAI,CAAC,KAAK,GAAG,IAAI,oBAAoB,CAAC,IAAI,CAAC,OAAO,EAAE,2BAA2B,EAAE,IAAI,CAAC,CAAA;QAEtF,6CAA6C;QAC7C,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC1B,CAAC;IAED;;;;;;OAMG;IACH,WAAW,CAAC,SAAiB,EAAE,MAAe;QAC5C,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;IACvB,CAAC;IAED;;;;OAIG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,OAAO,KAAK,SAAS,CAAA;IACnC,CAAC;IAED;;;;OAIG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,OAAO,CAAA;IACrB,CAAC;IAED;;;;OAIG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,KAAK,EAAE,IAAI,IAAI,2BAA2B,CAAA;IACxD,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,QAAsB;QAC5B,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YACtC,IAAI,CAAC,KAAK,GAAG,SAAS,CAAA;QACxB,CAAC;IACH,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAAC,MAAoB;IAChE,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,uBAAuB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,2BAA2B,EAAE,CAAA;AACzF,CAAC"}

package/dist/src/structured-output/exceptions.d.ts

@@ -0,0 +1,18 @@
+import type { z } from 'zod';
+/**
+ * Exception raised when the model fails to produce structured output.
+ * This is raised only when the LLM refuses to use the structured output tool
+ * even after being forced via toolChoice.
+ */
+export declare class StructuredOutputException extends Error {
+    constructor(message: string);
+}
+/**
+ * Formats Zod validation errors into a human-readable bullet list.
+ * Used to provide LLM-friendly error feedback for retry attempts.
+ *
+ * @param issues - Array of Zod validation issues
+ * @returns Formatted error message with bullet points
+ */
+export declare function formatValidationErrors(issues: z.ZodIssue[]): string;
+//# sourceMappingURL=exceptions.d.ts.map

package/dist/src/structured-output/exceptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions.d.ts","sourceRoot":"","sources":["../../../src/structured-output/exceptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAE5B;;;;GAIG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;gBACtC,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,GAAG,MAAM,CASnE"}

package/dist/src/structured-output/exceptions.js

@@ -0,0 +1,28 @@
+/**
+ * Exception raised when the model fails to produce structured output.
+ * This is raised only when the LLM refuses to use the structured output tool
+ * even after being forced via toolChoice.
+ */
+export class StructuredOutputException extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'StructuredOutputException';
+    }
+}
+/**
+ * Formats Zod validation errors into a human-readable bullet list.
+ * Used to provide LLM-friendly error feedback for retry attempts.
+ *
+ * @param issues - Array of Zod validation issues
+ * @returns Formatted error message with bullet points
+ */
+export function formatValidationErrors(issues) {
+    const formatted = issues
+        .map((issue) => {
+        const path = issue.path.length > 0 ? issue.path.join('.') : 'root';
+        return `- Field '${path}': ${issue.message}`;
+    })
+        .join('\n');
+    return formatted;
+}
+//# sourceMappingURL=exceptions.js.map

package/dist/src/structured-output/exceptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions.js","sourceRoot":"","sources":["../../../src/structured-output/exceptions.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAClD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAA;IACzC,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAoB;IACzD,MAAM,SAAS,GAAG,MAAM;SACrB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;QAClE,OAAO,YAAY,IAAI,MAAM,KAAK,CAAC,OAAO,EAAE,CAAA;IAC9C,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAA;IAEb,OAAO,SAAS,CAAA;AAClB,CAAC"}

package/dist/src/structured-output/tool.d.ts

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+import { Tool, type ToolContext, type ToolStreamGenerator } from '../tools/tool.js';
+import type { ToolSpec } from '../tools/types.js';
+import type { StructuredOutputContext } from './context.js';
+/**
+ * Tool implementation that validates LLM output against a Zod schema.
+ * Provides validation feedback to the LLM for retry on failures.
+ */
+export declare class StructuredOutputTool extends Tool {
+    readonly name: string;
+    readonly description: string;
+    readonly toolSpec: ToolSpec;
+    private _schema;
+    private _context;
+    /**
+     * Creates a new StructuredOutputTool.
+     *
+     * @param schema - The Zod schema to validate against
+     * @param toolName - The name of the tool
+     * @param context - The structured output context for result storage
+     */
+    constructor(schema: z.ZodSchema, toolName: string, context: StructuredOutputContext);
+    /**
+     * Executes the tool by validating input against the schema.
+     * On success, stores the validated result in context.
+     * On failure, returns formatted validation errors for LLM retry.
+     *
+     * @param toolContext - The tool execution context
+     * @returns Generator that returns a ToolResultBlock
+     */
+    stream(toolContext: ToolContext): ToolStreamGenerator;
+}
+//# sourceMappingURL=tool.d.ts.map

package/dist/src/structured-output/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../src/structured-output/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AACnF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAIjD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAA;AAE3D;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,IAAI;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAE3B,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,QAAQ,CAAyB;IAEzC;;;;;;OAMG;gBACS,MAAM,EAAE,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB;IASnF;;;;;;;OAOG;IAGI,MAAM,CAAC,WAAW,EAAE,WAAW,GAAG,mBAAmB;CAmC7D"}

package/dist/src/structured-output/tool.js

@@ -0,0 +1,73 @@
+import { z } from 'zod';
+import { Tool } from '../tools/tool.js';
+import { TextBlock, ToolResultBlock } from '../types/messages.js';
+import { convertSchemaToToolSpec } from './utils.js';
+import { formatValidationErrors } from './exceptions.js';
+/**
+ * Tool implementation that validates LLM output against a Zod schema.
+ * Provides validation feedback to the LLM for retry on failures.
+ */
+export class StructuredOutputTool extends Tool {
+    name;
+    description;
+    toolSpec;
+    _schema;
+    _context;
+    /**
+     * Creates a new StructuredOutputTool.
+     *
+     * @param schema - The Zod schema to validate against
+     * @param toolName - The name of the tool
+     * @param context - The structured output context for result storage
+     */
+    constructor(schema, toolName, context) {
+        super();
+        this._schema = schema;
+        this._context = context;
+        this.toolSpec = convertSchemaToToolSpec(schema, toolName);
+        this.name = this.toolSpec.name;
+        this.description = this.toolSpec.description;
+    }
+    /**
+     * Executes the tool by validating input against the schema.
+     * On success, stores the validated result in context.
+     * On failure, returns formatted validation errors for LLM retry.
+     *
+     * @param toolContext - The tool execution context
+     * @returns Generator that returns a ToolResultBlock
+     */
+    // Validation is synchronous, so no streaming events are yielded - only the final result is returned
+    // eslint-disable-next-line require-yield
+    async *stream(toolContext) {
+        const { toolUse } = toolContext;
+        try {
+            // Validate input against schema
+            const validated = this._schema.parse(toolUse.input);
+            // Store validated result in context
+            this._context.storeResult(toolUse.toolUseId, validated);
+            // Return success result
+            return new ToolResultBlock({
+                toolUseId: toolUse.toolUseId,
+                status: 'success',
+                content: [new TextBlock(JSON.stringify(validated))],
+            });
+        }
+        catch (error) {
+            // Handle validation errors
+            if (error instanceof z.ZodError) {
+                const formattedErrors = formatValidationErrors(error.issues);
+                const errorMessage = `Validation failed for ${this.name}. Please fix the following errors:\n${formattedErrors}`;
+                // Return error result with formatted validation feedback
+                return new ToolResultBlock({
+                    toolUseId: toolUse.toolUseId,
+                    status: 'error',
+                    content: [new TextBlock(errorMessage)],
+                    error: error,
+                });
+            }
+            // Re-throw unexpected errors
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=tool.js.map

package/dist/src/structured-output/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../../src/structured-output/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,IAAI,EAA8C,MAAM,kBAAkB,CAAA;AAEnF,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAA;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAGxD;;;GAGG;AACH,MAAM,OAAO,oBAAqB,SAAQ,IAAI;IACnC,IAAI,CAAQ;IACZ,WAAW,CAAQ;IACnB,QAAQ,CAAU;IAEnB,OAAO,CAAa;IACpB,QAAQ,CAAyB;IAEzC;;;;;;OAMG;IACH,YAAY,MAAmB,EAAE,QAAgB,EAAE,OAAgC;QACjF,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;QACrB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAA;QACvB,IAAI,CAAC,QAAQ,GAAG,uBAAuB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;QACzD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAA;QAC9B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAA;IAC9C,CAAC;IAED;;;;;;;OAOG;IACH,oGAAoG;IACpG,yCAAyC;IACzC,KAAK,CAAC,CAAC,MAAM,CAAC,WAAwB;QACpC,MAAM,EAAE,OAAO,EAAE,GAAG,WAAW,CAAA;QAE/B,IAAI,CAAC;YACH,gCAAgC;YAChC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;YAEnD,oCAAoC;YACpC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;YAEvD,wBAAwB;YACxB,OAAO,IAAI,eAAe,CAAC;gBACzB,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,MAAM,EAAE,SAAS;gBACjB,OAAO,EAAE,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;aACpD,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,2BAA2B;YAC3B,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;gBAChC,MAAM,eAAe,GAAG,sBAAsB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;gBAC5D,MAAM,YAAY,GAAG,yBAAyB,IAAI,CAAC,IAAI,uCAAuC,eAAe,EAAE,CAAA;gBAE/G,yDAAyD;gBACzD,OAAO,IAAI,eAAe,CAAC;oBACzB,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,MAAM,EAAE,OAAO;oBACf,OAAO,EAAE,CAAC,IAAI,SAAS,CAAC,YAAY,CAAC,CAAC;oBACtC,KAAK,EAAE,KAAK;iBACb,CAAC,CAAA;YACJ,CAAC;YAED,6BAA6B;YAC7B,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC;CACF"}

package/dist/src/structured-output/utils.d.ts

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+import type { ToolSpec } from '../tools/types.js';
+/**
+ * Converts a Zod schema to a complete tool specification.
+ *
+ * Validates that the schema doesn't contain refinements or transforms, which cannot be
+ * properly represented in JSON Schema. Refinements are silently dropped by z.toJSONSchema(),
+ * creating a mismatch between what the LLM sees and what validation enforces.
+ *
+ * @param schema - The Zod schema to convert
+ * @param toolName - The name to use for the tool
+ * @returns Complete tool specification
+ * @throws StructuredOutputException if the schema contains unsupported features
+ */
+export declare function convertSchemaToToolSpec(schema: z.ZodSchema, toolName: string): ToolSpec;
+/**
+ * Extracts a description from the Zod schema if available.
+ *
+ * @param schema - The Zod schema to extract description from
+ * @returns The schema description or empty string if not available
+ */
+export declare function getSchemaDescription(schema: z.ZodSchema): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/src/structured-output/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/structured-output/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAIjD;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAevF;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,GAAG,MAAM,CAahE"}