@strands-agents/sdk 0.0.1

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

@@ -0,0 +1,70 @@
+import type { InvokableTool, ToolContext } from './tool';
+import type { JSONValue } from '../types/json';
+import { z } from 'zod';
+/**
+ * Configuration for creating a Zod-based tool.
+ *
+ * @typeParam TInput - Zod schema type for input validation
+ * @typeParam TReturn - Return type of the callback function
+ */
+export interface ToolConfig<TInput extends z.ZodType, TReturn extends JSONValue = JSONValue> {
+    /** The name of the tool */
+    name: string;
+    /** A description of what the tool does (optional) */
+    description?: string;
+    /** Zod schema for input validation and JSON schema generation */
+    inputSchema: TInput;
+    /**
+     * Callback function that implements the tool's functionality.
+     *
+     * @param input - Validated input matching the Zod schema
+     * @param context - Optional execution context
+     * @returns The result (can be a value, Promise, or AsyncGenerator)
+     */
+    callback: (input: z.infer<TInput>, context?: ToolContext) => AsyncGenerator<unknown, TReturn, never> | Promise<TReturn> | TReturn;
+}
+/**
+ * Creates an InvokableTool from a Zod schema and callback function.
+ *
+ * The tool() function validates input against the schema and generates JSON schema
+ * for model providers using Zod v4's built-in z.toJSONSchema() method.
+ *
+ * @example
+ * ```typescript
+ * import { tool } from '@strands-agents/sdk'
+ * import { z } from 'zod'
+ *
+ * const calculator = tool({
+ *   name: 'calculator',
+ *   description: 'Performs basic arithmetic',
+ *   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
+ *     }
+ *   }
+ * })
+ *
+ * // Direct invocation
+ * const result = await calculator.invoke({ operation: 'add', a: 5, b: 3 })
+ *
+ * // Agent usage
+ * for await (const event of calculator.stream(context)) {
+ *   console.log(event)
+ * }
+ * ```
+ *
+ * @typeParam TInput - Zod schema type for input validation
+ * @typeParam TReturn - Return type of the callback function
+ * @param config - Tool configuration
+ * @returns An InvokableTool that implements the Tool interface with invoke() method
+ */
+export declare function tool<TInput extends z.ZodType, TReturn extends JSONValue = JSONValue>(config: ToolConfig<TInput, TReturn>): InvokableTool<z.infer<TInput>, TReturn>;
+//# sourceMappingURL=zod-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"zod-tool.d.ts","sourceRoot":"","sources":["../../src/tools/zod-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAuB,MAAM,QAAQ,CAAA;AAC7E,OAAO,KAAK,EAAc,SAAS,EAAE,MAAM,eAAe,CAAA;AAE1D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;GAKG;AACH,MAAM,WAAW,UAAU,CAAC,MAAM,SAAS,CAAC,CAAC,OAAO,EAAE,OAAO,SAAS,SAAS,GAAG,SAAS;IACzF,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAA;IAEZ,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAA;IAEnB;;;;;;OAMG;IACH,QAAQ,EAAE,CACR,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,EACtB,OAAO,CAAC,EAAE,WAAW,KAClB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAA;CAC1E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,IAAI,CAAC,MAAM,SAAS,CAAC,CAAC,OAAO,EAAE,OAAO,SAAS,SAAS,GAAG,SAAS,EAClF,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CA8DzC"}

package/dist/tools/zod-tool.js

@@ -0,0 +1,96 @@
+import { FunctionTool } from './function-tool';
+import { z } from 'zod';
+/**
+ * Creates an InvokableTool from a Zod schema and callback function.
+ *
+ * The tool() function validates input against the schema and generates JSON schema
+ * for model providers using Zod v4's built-in z.toJSONSchema() method.
+ *
+ * @example
+ * ```typescript
+ * import { tool } from '@strands-agents/sdk'
+ * import { z } from 'zod'
+ *
+ * const calculator = tool({
+ *   name: 'calculator',
+ *   description: 'Performs basic arithmetic',
+ *   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
+ *     }
+ *   }
+ * })
+ *
+ * // Direct invocation
+ * const result = await calculator.invoke({ operation: 'add', a: 5, b: 3 })
+ *
+ * // Agent usage
+ * for await (const event of calculator.stream(context)) {
+ *   console.log(event)
+ * }
+ * ```
+ *
+ * @typeParam TInput - Zod schema type for input validation
+ * @typeParam TReturn - Return type of the callback function
+ * @param config - Tool configuration
+ * @returns An InvokableTool that implements the Tool interface with invoke() method
+ */
+export function tool(config) {
+    const { name, description = '', inputSchema, callback } = config;
+    // Generate JSON Schema from Zod and strip $schema property to reduce token usage
+    const generatedSchema = z.toJSONSchema(inputSchema);
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    const { $schema, ...schemaWithoutMeta } = generatedSchema;
+    // Create a FunctionTool with a validation wrapper
+    const functionTool = new FunctionTool({
+        name,
+        description,
+        inputSchema: schemaWithoutMeta,
+        callback: (input, toolContext) => {
+            // Validate input using Zod schema (throws on validation error)
+            const validatedInput = inputSchema.parse(input);
+            // Execute user callback with validated input
+            return callback(validatedInput, toolContext);
+        },
+    });
+    // Create an invokable tool that extends the FunctionTool
+    const invokableTool = {
+        toolName: functionTool.toolName,
+        description: functionTool.description,
+        toolSpec: functionTool.toolSpec,
+        // Delegate stream to FunctionTool
+        stream(toolContext) {
+            return functionTool.stream(toolContext);
+        },
+        // Type-safe invoke method
+        async invoke(input, context) {
+            // Validate input using Zod schema (throws on validation error)
+            const validatedInput = inputSchema.parse(input);
+            // Execute callback with validated input
+            const result = callback(validatedInput, context);
+            // Handle different return types
+            if (result && typeof result === 'object' && Symbol.asyncIterator in result) {
+                // AsyncGenerator - consume all yielded values and return the last one
+                let lastValue = undefined;
+                for await (const value of result) {
+                    lastValue = value;
+                }
+                return lastValue;
+            }
+            else {
+                // Regular value or Promise - return directly
+                return await result;
+            }
+        },
+    };
+    return invokableTool;
+}
+//# sourceMappingURL=zod-tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"zod-tool.js","sourceRoot":"","sources":["../../src/tools/zod-tool.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AA+BvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,MAAM,UAAU,IAAI,CAClB,MAAmC;IAEnC,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAA;IAEhE,iFAAiF;IACjF,MAAM,eAAe,GAAG,CAAC,CAAC,YAAY,CAAC,WAAW,CAAsC,CAAA;IACxF,6DAA6D;IAC7D,MAAM,EAAE,OAAO,EAAE,GAAG,iBAAiB,EAAE,GAAG,eAAe,CAAA;IAEzD,kDAAkD;IAClD,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC;QACpC,IAAI;QACJ,WAAW;QACX,WAAW,EAAE,iBAA+B;QAC5C,QAAQ,EAAE,CACR,KAAc,EACd,WAAwB,EACsD,EAAE;YAChF,+DAA+D;YAC/D,MAAM,cAAc,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;YAC/C,6CAA6C;YAC7C,OAAO,QAAQ,CAAC,cAAc,EAAE,WAAW,CAG9B,CAAA;QACf,CAAC;KACF,CAAC,CAAA;IAEF,yDAAyD;IACzD,MAAM,aAAa,GAA4C;QAC7D,QAAQ,EAAE,YAAY,CAAC,QAAQ;QAC/B,WAAW,EAAE,YAAY,CAAC,WAAW;QACrC,QAAQ,EAAE,YAAY,CAAC,QAAQ;QAE/B,kCAAkC;QAClC,MAAM,CAAC,WAAwB;YAC7B,OAAO,YAAY,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;QACzC,CAAC;QAED,0BAA0B;QAC1B,KAAK,CAAC,MAAM,CAAC,KAAsB,EAAE,OAAqB;YACxD,+DAA+D;YAC/D,MAAM,cAAc,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;YAE/C,wCAAwC;YACxC,MAAM,MAAM,GAAG,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC,CAAA;YAEhD,gCAAgC;YAChC,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,IAAI,MAAM,EAAE,CAAC;gBAC3E,sEAAsE;gBACtE,IAAI,SAAS,GAAwB,SAAS,CAAA;gBAC9C,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAqD,EAAE,CAAC;oBAChF,SAAS,GAAG,KAAgB,CAAA;gBAC9B,CAAC;gBACD,OAAO,SAAoB,CAAA;YAC7B,CAAC;iBAAM,CAAC;gBACN,6CAA6C;gBAC7C,OAAO,MAAM,MAAM,CAAA;YACrB,CAAC;QACH,CAAC;KACF,CAAA;IAED,OAAO,aAAa,CAAA;AACtB,CAAC"}

package/dist/types/__tests__/json.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=json.test.d.ts.map

package/dist/types/__tests__/json.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.test.d.ts","sourceRoot":"","sources":["../../../src/types/__tests__/json.test.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/json.test.js

@@ -0,0 +1,129 @@
+import { describe, it, expect } from 'vitest';
+import { deepCopy } from '../json';
+describe('deepCopy', () => {
+    describe('primitive values', () => {
+        it('copies strings', () => {
+            const result = deepCopy('hello');
+            expect(result).toBe('hello');
+        });
+        it('copies numbers', () => {
+            const result = deepCopy(42);
+            expect(result).toBe(42);
+        });
+        it('copies booleans', () => {
+            const result = deepCopy(true);
+            expect(result).toBe(true);
+        });
+        it('copies null', () => {
+            const result = deepCopy(null);
+            expect(result).toBe(null);
+        });
+    });
+    describe('object values', () => {
+        it('creates a deep copy of objects', () => {
+            const original = { nested: { value: 'test' } };
+            const copy = deepCopy(original);
+            expect(copy).toEqual(original);
+            expect(copy).not.toBe(original); // Different reference
+            // Verify deep copy - modifying original shouldn't affect copy
+            original.nested.value = 'changed';
+            expect(copy.nested.value).toBe('test');
+        });
+        it('copies empty objects', () => {
+            const result = deepCopy({});
+            expect(result).toEqual({});
+        });
+        it('copies objects with multiple properties', () => {
+            const original = { a: 1, b: 'two', c: true, d: null };
+            const copy = deepCopy(original);
+            expect(copy).toEqual(original);
+        });
+    });
+    describe('array values', () => {
+        it('creates a deep copy of arrays', () => {
+            const original = [1, 2, 3, { nested: 'value' }];
+            const copy = deepCopy(original);
+            expect(copy).toEqual(original);
+            expect(copy).not.toBe(original); // Different reference
+            // Verify deep copy - modifying original shouldn't affect copy
+            original[0] = 999;
+            expect(copy[0]).toBe(1);
+        });
+        it('copies empty arrays', () => {
+            const result = deepCopy([]);
+            expect(result).toEqual([]);
+        });
+        it('copies nested arrays', () => {
+            const original = [
+                [1, 2],
+                [3, 4],
+            ];
+            const copy = deepCopy(original);
+            expect(copy).toEqual(original);
+        });
+    });
+    describe('error handling', () => {
+        it('throws error for circular references', () => {
+            const circular = {};
+            circular.self = circular;
+            expect(() => deepCopy(circular)).toThrow('Unable to serialize tool result');
+        });
+        it('silently drops functions from objects', () => {
+            const withFunction = {
+                normalProp: 'value',
+                funcProp: () => 'test',
+            };
+            const result = deepCopy(withFunction);
+            expect(result).toEqual({ normalProp: 'value' });
+            expect(result).not.toHaveProperty('funcProp');
+        });
+        it('silently drops symbols from objects', () => {
+            const sym = Symbol('test');
+            const withSymbol = {
+                normalProp: 'value',
+                [sym]: 'symbolValue',
+            };
+            const result = deepCopy(withSymbol);
+            expect(result).toEqual({ normalProp: 'value' });
+            // Symbols are dropped during JSON serialization
+            expect(Object.getOwnPropertySymbols(result)).toHaveLength(0);
+        });
+        it('silently drops undefined values from objects', () => {
+            const withUndefined = {
+                normalProp: 'value',
+                undefinedProp: undefined,
+            };
+            const result = deepCopy(withUndefined);
+            expect(result).toEqual({ normalProp: 'value' });
+            expect(result).not.toHaveProperty('undefinedProp');
+        });
+    });
+    describe('complex nested structures', () => {
+        it('copies deeply nested structures', () => {
+            const original = {
+                level1: {
+                    level2: {
+                        level3: {
+                            array: [1, 2, { deep: 'value' }],
+                            string: 'test',
+                        },
+                    },
+                },
+            };
+            const copy = deepCopy(original);
+            expect(copy).toEqual(original);
+            expect(copy).not.toBe(original);
+        });
+        it('copies arrays of objects', () => {
+            const original = [
+                { id: 1, name: 'first' },
+                { id: 2, name: 'second' },
+                { id: 3, name: 'third' },
+            ];
+            const copy = deepCopy(original);
+            expect(copy).toEqual(original);
+            expect(copy).not.toBe(original);
+        });
+    });
+});
+//# sourceMappingURL=json.test.js.map

package/dist/types/__tests__/json.test.js.map

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

package/dist/types/__tests__/validation.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validation.test.d.ts.map

package/dist/types/__tests__/validation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.test.d.ts","sourceRoot":"","sources":["../../../src/types/__tests__/validation.test.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/validation.test.js

@@ -0,0 +1,30 @@
+import { describe, it, expect } from 'vitest';
+import { ensureDefined } from '../validation';
+describe('ensureDefined', () => {
+    describe('when value is defined', () => {
+        it('returns the value', () => {
+            const value = 'test';
+            const result = ensureDefined(value, 'testField');
+            expect(result).toBe('test');
+        });
+        it('returns zero', () => {
+            const result = ensureDefined(0, 'numberField');
+            expect(result).toBe(0);
+        });
+        it('returns empty string', () => {
+            const result = ensureDefined('', 'stringField');
+            expect(result).toBe('');
+        });
+    });
+    describe('when value is null', () => {
+        it('throws error with field name', () => {
+            expect(() => ensureDefined(null, 'testField')).toThrow('Expected testField to be defined, but got null');
+        });
+    });
+    describe('when value is undefined', () => {
+        it('throws error with field name', () => {
+            expect(() => ensureDefined(undefined, 'testField')).toThrow('Expected testField to be defined, but got undefined');
+        });
+    });
+});
+//# sourceMappingURL=validation.test.js.map

package/dist/types/__tests__/validation.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.test.js","sourceRoot":"","sources":["../../../src/types/__tests__/validation.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAE7C,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;QACrC,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;YAC3B,MAAM,KAAK,GAAG,MAAM,CAAA;YACpB,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,WAAW,CAAC,CAAA;YAChD,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC7B,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,cAAc,EAAE,GAAG,EAAE;YACtB,MAAM,MAAM,GAAG,aAAa,CAAC,CAAC,EAAE,aAAa,CAAC,CAAA;YAC9C,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACxB,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;YAC9B,MAAM,MAAM,GAAG,aAAa,CAAC,EAAE,EAAE,aAAa,CAAC,CAAA;YAC/C,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACzB,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAClC,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;YACtC,MAAM,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,gDAAgD,CAAC,CAAA;QAC1G,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACvC,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;YACtC,MAAM,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,qDAAqD,CAAC,CAAA;QACpH,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/types/json.d.ts

@@ -0,0 +1,45 @@
+import type { JSONSchema7 } from 'json-schema';
+/**
+ * Represents any valid JSON value.
+ * This type ensures type safety for JSON-serializable data.
+ *
+ * @example
+ * ```typescript
+ * const value: JSONValue = { key: 'value', nested: { arr: [1, 2, 3] } }
+ * const text: JSONValue = 'hello'
+ * const num: JSONValue = 42
+ * const bool: JSONValue = true
+ * const nothing: JSONValue = null
+ * ```
+ */
+export type JSONValue = string | number | boolean | null | {
+    [key: string]: JSONValue;
+} | JSONValue[];
+/**
+ * Represents a JSON Schema definition.
+ * Used for defining the structure of tool inputs and outputs.
+ *
+ * This is based on JSON Schema Draft 7 specification.
+ *
+ * @example
+ * ```typescript
+ * const schema: JSONSchema = {
+ *   type: 'object',
+ *   properties: {
+ *     name: { type: 'string' },
+ *     age: { type: 'number' }
+ *   },
+ *   required: ['name']
+ * }
+ * ```
+ */
+export type JSONSchema = JSONSchema7;
+/**
+ * Creates a deep copy of a value using JSON serialization.
+ *
+ * @param value - The value to copy
+ * @returns A deep copy of the value
+ * @throws Error if the value cannot be JSON serialized
+ */
+export declare function deepCopy(value: unknown): JSONValue;
+//# sourceMappingURL=json.d.ts.map

package/dist/types/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/types/json.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAAG,SAAS,EAAE,CAAA;AAErG;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,UAAU,GAAG,WAAW,CAAA;AAEpC;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAOlD"}

package/dist/types/json.js

@@ -0,0 +1,17 @@
+/**
+ * Creates a deep copy of a value using JSON serialization.
+ *
+ * @param value - The value to copy
+ * @returns A deep copy of the value
+ * @throws Error if the value cannot be JSON serialized
+ */
+export function deepCopy(value) {
+    try {
+        return JSON.parse(JSON.stringify(value));
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        throw new Error(`Unable to serialize tool result: ${errorMessage}`);
+    }
+}
+//# sourceMappingURL=json.js.map

package/dist/types/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/types/json.ts"],"names":[],"mappings":"AAqCA;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAc,CAAA;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAC3E,MAAM,IAAI,KAAK,CAAC,oCAAoC,YAAY,EAAE,CAAC,CAAA;IACrE,CAAC;AACH,CAAC"}

package/dist/types/messages.d.ts

@@ -0,0 +1,160 @@
+import type { JSONValue } from './json';
+import type { ToolResultContent } from '../tools/types';
+/**
+ * A message in a conversation between user and assistant.
+ * Each message has a role (user or assistant) and an array of content blocks.
+ */
+export interface Message {
+    /**
+     * Discriminator for message type.
+     */
+    type: 'message';
+    /**
+     * The role of the message sender.
+     */
+    role: Role;
+    /**
+     * Array of content blocks that make up this message.
+     */
+    content: ContentBlock[];
+}
+/**
+ * Role of a message in a conversation.
+ * Can be either 'user' (human input) or 'assistant' (model response).
+ */
+export type Role = 'user' | 'assistant';
+/**
+ * A block of content within a message.
+ * Content blocks can contain text, tool usage requests, tool results, reasoning content, or cache points.
+ *
+ * This is a discriminated union where the `type` field determines the content format.
+ */
+export type ContentBlock = TextBlock | ToolUseBlock | ToolResultBlock | ReasoningBlock | CachePointBlock;
+/**
+ * Text content block within a message.
+ */
+export interface TextBlock {
+    /**
+     * Discriminator for text content.
+     */
+    type: 'textBlock';
+    /**
+     * Plain text content.
+     */
+    text: string;
+}
+/**
+ * Tool use content block within a message.
+ */
+export interface ToolUseBlock {
+    /**
+     * Discriminator for tool use content.
+     */
+    type: 'toolUseBlock';
+    /**
+     * The name of the tool to execute.
+     */
+    name: string;
+    /**
+     * Unique identifier for this tool use instance.
+     */
+    toolUseId: string;
+    /**
+     * The input parameters for the tool.
+     * This can be any JSON-serializable value.
+     */
+    input: JSONValue;
+}
+/**
+ * Tool result content block within a message.
+ */
+export interface ToolResultBlock {
+    /**
+     * Discriminator for tool result content.
+     */
+    type: 'toolResultBlock';
+    /**
+     * The ID of the tool use that this result corresponds to.
+     */
+    toolUseId: string;
+    /**
+     * Status of the tool execution.
+     */
+    status: 'success' | 'error';
+    /**
+     * The content returned by the tool.
+     */
+    content: ToolResultContent[];
+}
+/**
+ * Reasoning content block within a message.
+ */
+export interface ReasoningBlock {
+    /**
+     * Discriminator for reasoning content.
+     */
+    type: 'reasoningBlock';
+    /**
+     * The text content of the reasoning process.
+     */
+    text?: string;
+    /**
+     * A cryptographic signature for verification purposes.
+     */
+    signature?: string;
+    /**
+     * The redacted content of the reasoning process.
+     */
+    redactedContent?: Uint8Array;
+}
+/**
+ * Cache point block for prompt caching.
+ * Marks a position in a message or system prompt where caching should occur.
+ */
+export interface CachePointBlock {
+    /**
+     * Discriminator for cache point.
+     */
+    type: 'cachePointBlock';
+    /**
+     * The cache type. Currently only 'default' is supported.
+     */
+    cacheType: 'default';
+}
+/**
+ * Reason why the model stopped generating content.
+ *
+ * - `contentFiltered` - Content was filtered by safety mechanisms
+ * - `endTurn` - Natural end of the model's turn
+ * - `guardrailIntervened` - A guardrail policy stopped generation
+ * - `maxTokens` - Maximum token limit was reached
+ * - `stopSequence` - A stop sequence was encountered
+ * - `toolUse` - Model wants to use a tool
+ */
+export type StopReason = 'contentFiltered' | 'endTurn' | 'guardrailIntervened' | 'maxTokens' | 'stopSequence' | 'toolUse' | 'modelContextWindowExceeded' | string;
+/**
+ * System prompt for guiding model behavior.
+ * Can be a simple string or an array of content blocks for advanced caching.
+ *
+ * @example
+ * ```typescript
+ * // Simple string
+ * const prompt: SystemPrompt = 'You are a helpful assistant'
+ *
+ * // Array with cache points for advanced caching
+ * const prompt: SystemPrompt = [
+ *   { type: 'textBlock', text: 'You are a helpful assistant' },
+ *   { type: 'textBlock', text: largeContextDocument },
+ *   { type: 'cachePointBlock', cacheType: 'default' }
+ * ]
+ * ```
+ */
+export type SystemPrompt = string | SystemContentBlock[];
+/**
+ * A block of content within a system prompt.
+ * Supports text content and cache points for prompt caching.
+ *
+ * This is a discriminated union where the `type` field determines the block format.
+ */
+export type SystemContentBlock = TextBlock | CachePointBlock;
+//# sourceMappingURL=messages.d.ts.map

package/dist/types/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/types/messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AACvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAEvD;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,IAAI,EAAE,SAAS,CAAA;IAEf;;OAEG;IACH,IAAI,EAAE,IAAI,CAAA;IAEV;;OAEG;IACH,OAAO,EAAE,YAAY,EAAE,CAAA;CACxB;AAED;;;GAGG;AACH,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,WAAW,CAAA;AAEvC;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,YAAY,GAAG,eAAe,GAAG,cAAc,GAAG,eAAe,CAAA;AAExG;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,IAAI,EAAE,WAAW,CAAA;IAEjB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,IAAI,EAAE,cAAc,CAAA;IAEpB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IAEZ;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IAEjB;;;OAGG;IACH,KAAK,EAAE,SAAS,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,IAAI,EAAE,iBAAiB,CAAA;IAEvB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IAEjB;;OAEG;IACH,MAAM,EAAE,SAAS,GAAG,OAAO,CAAA;IAE3B;;OAEG;IACH,OAAO,EAAE,iBAAiB,EAAE,CAAA;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,IAAI,EAAE,gBAAgB,CAAA;IAEtB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;OAEG;IACH,eAAe,CAAC,EAAE,UAAU,CAAA;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,IAAI,EAAE,iBAAiB,CAAA;IAEvB;;OAEG;IACH,SAAS,EAAE,SAAS,CAAA;CACrB;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,UAAU,GAClB,iBAAiB,GACjB,SAAS,GACT,qBAAqB,GACrB,WAAW,GACX,cAAc,GACd,SAAS,GACT,4BAA4B,GAC5B,MAAM,CAAA;AAEV;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,kBAAkB,EAAE,CAAA;AAExD;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,eAAe,CAAA"}

package/dist/types/messages.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=messages.js.map

package/dist/types/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/types/messages.ts"],"names":[],"mappings":""}

package/dist/types/validation.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Ensures a value is defined, throwing an error if it's null or undefined.
+ *
+ * @param value - The value to check
+ * @param fieldName - Name of the field for error reporting
+ * @returns The value if defined
+ * @throws Error if value is null or undefined
+ */
+export declare function ensureDefined<T>(value: T | null | undefined, fieldName: string): T;
+//# sourceMappingURL=validation.d.ts.map

package/dist/types/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/types/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,CAAC,CAKlF"}

package/dist/types/validation.js

@@ -0,0 +1,15 @@
+/**
+ * Ensures a value is defined, throwing an error if it's null or undefined.
+ *
+ * @param value - The value to check
+ * @param fieldName - Name of the field for error reporting
+ * @returns The value if defined
+ * @throws Error if value is null or undefined
+ */
+export function ensureDefined(value, fieldName) {
+    if (value == null) {
+        throw new Error(`Expected ${fieldName} to be defined, but got ${value}`);
+    }
+    return value;
+}
+//# sourceMappingURL=validation.js.map

package/dist/types/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/types/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAI,KAA2B,EAAE,SAAiB;IAC7E,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,YAAY,SAAS,2BAA2B,KAAK,EAAE,CAAC,CAAA;IAC1E,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/vended_tools/bash/__tests__/bash.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=bash.test.d.ts.map

package/dist/vended_tools/bash/__tests__/bash.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash.test.d.ts","sourceRoot":"","sources":["../../../../vended_tools/bash/__tests__/bash.test.ts"],"names":[],"mappings":""}