@strands-agents/sdk 0.0.1

package/dist/src/types/__tests__/messages.test.js

@@ -0,0 +1,364 @@
+import { describe, expect, test, it } from 'vitest';
+import { Message, TextBlock, ToolUseBlock, ToolResultBlock, ReasoningBlock, CachePointBlock, GuardContentBlock, JsonBlock, systemPromptFromData, } from '../messages.js';
+import { ImageBlock, VideoBlock, DocumentBlock } from '../media.js';
+describe('Message', () => {
+    test('creates message with role and content', () => {
+        const content = [new TextBlock('test')];
+        const message = new Message({ role: 'user', content });
+        expect(message).toEqual({
+            type: 'message',
+            role: 'user',
+            content,
+        });
+    });
+});
+describe('TextBlock', () => {
+    test('creates text block with text', () => {
+        const block = new TextBlock('hello');
+        expect(block).toEqual({
+            type: 'textBlock',
+            text: 'hello',
+        });
+    });
+});
+describe('ToolUseBlock', () => {
+    test('creates tool use block', () => {
+        const block = new ToolUseBlock({
+            name: 'test-tool',
+            toolUseId: '123',
+            input: { param: 'value' },
+        });
+        expect(block).toEqual({
+            type: 'toolUseBlock',
+            name: 'test-tool',
+            toolUseId: '123',
+            input: { param: 'value' },
+        });
+    });
+});
+describe('ToolResultBlock', () => {
+    test('creates tool result block', () => {
+        const block = new ToolResultBlock({
+            toolUseId: '123',
+            status: 'success',
+            content: [{ type: 'textBlock', text: 'result' }],
+        });
+        expect(block).toEqual({
+            type: 'toolResultBlock',
+            toolUseId: '123',
+            status: 'success',
+            content: [{ type: 'textBlock', text: 'result' }],
+        });
+    });
+});
+describe('ReasoningBlock', () => {
+    test('creates reasoning block with text', () => {
+        const block = new ReasoningBlock({ text: 'thinking...' });
+        expect(block).toEqual({
+            type: 'reasoningBlock',
+            text: 'thinking...',
+        });
+    });
+});
+describe('CachePointBlock', () => {
+    test('creates cache point block', () => {
+        const block = new CachePointBlock({ cacheType: 'default' });
+        expect(block).toEqual({
+            type: 'cachePointBlock',
+            cacheType: 'default',
+        });
+    });
+});
+describe('JsonBlock', () => {
+    test('creates json block', () => {
+        const block = new JsonBlock({ json: { key: 'value' } });
+        expect(block).toEqual({
+            type: 'jsonBlock',
+            json: { key: 'value' },
+        });
+    });
+});
+describe('Message.fromMessageData', () => {
+    it('converts text block data to TextBlock', () => {
+        const messageData = {
+            role: 'user',
+            content: [{ text: 'hello world' }],
+        };
+        const message = Message.fromMessageData(messageData);
+        expect(message.content).toHaveLength(1);
+        expect(message.content[0]).toEqual(new TextBlock('hello world'));
+    });
+    it('converts tool use block data to ToolUseBlock', () => {
+        const messageData = {
+            role: 'assistant',
+            content: [
+                {
+                    toolUse: {
+                        toolUseId: 'tool-123',
+                        name: 'test-tool',
+                        input: { key: 'value' },
+                    },
+                },
+            ],
+        };
+        const message = Message.fromMessageData(messageData);
+        expect(message.content).toHaveLength(1);
+        expect(message.content[0]).toBeInstanceOf(ToolUseBlock);
+        expect(message.content[0].type).toBe('toolUseBlock');
+    });
+    it('converts tool result block data to ToolResultBlock with text content', () => {
+        const messageData = {
+            role: 'user',
+            content: [
+                {
+                    toolResult: {
+                        toolUseId: 'tool-123',
+                        status: 'success',
+                        content: [{ text: 'result text' }],
+                    },
+                },
+            ],
+        };
+        const message = Message.fromMessageData(messageData);
+        expect(message.content).toHaveLength(1);
+        expect(message.content[0]).toBeInstanceOf(ToolResultBlock);
+        const toolResultBlock = message.content[0];
+        expect(toolResultBlock.content).toHaveLength(1);
+        expect(toolResultBlock.content[0]).toBeInstanceOf(TextBlock);
+    });
+    it('converts tool result block data to ToolResultBlock with json content', () => {
+        const messageData = {
+            role: 'user',
+            content: [
+                {
+                    toolResult: {
+                        toolUseId: 'tool-123',
+                        status: 'success',
+                        content: [{ json: { result: 'value' } }],
+                    },
+                },
+            ],
+        };
+        const message = Message.fromMessageData(messageData);
+        expect(message.content).toHaveLength(1);
+        const toolResultBlock = message.content[0];
+        expect(toolResultBlock.content).toHaveLength(1);
+        expect(toolResultBlock.content[0]).toBeInstanceOf(JsonBlock);
+    });
+    it('converts reasoning block data to ReasoningBlock', () => {
+        const messageData = {
+            role: 'assistant',
+            content: [
+                {
+                    reasoning: { text: 'thinking about it...' },
+                },
+            ],
+        };
+        const message = Message.fromMessageData(messageData);
+        expect(message.content).toHaveLength(1);
+        expect(message.content[0]).toBeInstanceOf(ReasoningBlock);
+        expect(message.content[0].type).toBe('reasoningBlock');
+    });
+    it('converts cache point block data to CachePointBlock', () => {
+        const messageData = {
+            role: 'user',
+            content: [
+                {
+                    cachePoint: { cacheType: 'default' },
+                },
+            ],
+        };
+        const message = Message.fromMessageData(messageData);
+        expect(message.content).toHaveLength(1);
+        expect(message.content[0]).toBeInstanceOf(CachePointBlock);
+        expect(message.content[0].type).toBe('cachePointBlock');
+    });
+    it('converts guard content block data to GuardContentBlock', () => {
+        const messageData = {
+            role: 'user',
+            content: [
+                {
+                    guardContent: {
+                        text: {
+                            text: 'guard this content',
+                            qualifiers: ['guard_content'],
+                        },
+                    },
+                },
+            ],
+        };
+        const message = Message.fromMessageData(messageData);
+        expect(message.content).toHaveLength(1);
+        expect(message.content[0].type).toBe('guardContentBlock');
+    });
+    it('converts image block data to ImageBlock', () => {
+        const messageData = {
+            role: 'user',
+            content: [
+                {
+                    image: {
+                        format: 'jpeg',
+                        source: { bytes: new Uint8Array([1, 2, 3]) },
+                    },
+                },
+            ],
+        };
+        const message = Message.fromMessageData(messageData);
+        expect(message.content).toHaveLength(1);
+        expect(message.content[0]).toBeInstanceOf(ImageBlock);
+        expect(message.content[0].type).toBe('imageBlock');
+    });
+    it('converts video block data to VideoBlock', () => {
+        const messageData = {
+            role: 'user',
+            content: [
+                {
+                    video: {
+                        format: 'mp4',
+                        source: { bytes: new Uint8Array([1, 2, 3]) },
+                    },
+                },
+            ],
+        };
+        const message = Message.fromMessageData(messageData);
+        expect(message.content).toHaveLength(1);
+        expect(message.content[0]).toBeInstanceOf(VideoBlock);
+        expect(message.content[0].type).toBe('videoBlock');
+    });
+    it('converts document block data to DocumentBlock', () => {
+        const messageData = {
+            role: 'user',
+            content: [
+                {
+                    document: {
+                        name: 'test.pdf',
+                        format: 'pdf',
+                        source: { bytes: new Uint8Array([1, 2, 3]) },
+                    },
+                },
+            ],
+        };
+        const message = Message.fromMessageData(messageData);
+        expect(message.content).toHaveLength(1);
+        expect(message.content[0]).toBeInstanceOf(DocumentBlock);
+        expect(message.content[0].type).toBe('documentBlock');
+    });
+    it('converts multiple content blocks', () => {
+        const messageData = {
+            role: 'user',
+            content: [
+                { text: 'first block' },
+                { image: { format: 'png', source: { bytes: new Uint8Array([1, 2, 3]) } } },
+                { text: 'second block' },
+            ],
+        };
+        const message = Message.fromMessageData(messageData);
+        expect(message.content).toHaveLength(3);
+        expect(message.content[0]).toBeInstanceOf(TextBlock);
+        expect(message.content[1]).toBeInstanceOf(ImageBlock);
+        expect(message.content[2]).toBeInstanceOf(TextBlock);
+    });
+    it('throws error for unknown content block type', () => {
+        const messageData = {
+            role: 'user',
+            content: [{ unknownType: { data: 'value' } }],
+        };
+        expect(() => Message.fromMessageData(messageData)).toThrow('Unknown ContentBlockData type');
+    });
+});
+describe('systemPromptFromData', () => {
+    describe('when called with string', () => {
+        it('returns the string unchanged', () => {
+            const data = 'You are a helpful assistant';
+            const result = systemPromptFromData(data);
+            expect(result).toBe('You are a helpful assistant');
+        });
+    });
+    describe('when called with TextBlockData', () => {
+        it('converts to TextBlock', () => {
+            const data = [{ text: 'System prompt text' }];
+            const result = systemPromptFromData(data);
+            expect(result).toEqual([new TextBlock('System prompt text')]);
+        });
+    });
+    describe('when called with CachePointBlockData', () => {
+        it('converts to CachePointBlock', () => {
+            const data = [{ text: 'prompt' }, { cachePoint: { cacheType: 'default' } }];
+            const result = systemPromptFromData(data);
+            expect(result).toEqual([new TextBlock('prompt'), new CachePointBlock({ cacheType: 'default' })]);
+        });
+    });
+    describe('when called with GuardContentBlockData', () => {
+        it('converts to GuardContentBlock', () => {
+            const data = [
+                {
+                    guardContent: {
+                        text: {
+                            text: 'guard this content',
+                            qualifiers: ['guard_content'],
+                        },
+                    },
+                },
+            ];
+            const result = systemPromptFromData(data);
+            expect(result).toEqual([
+                new GuardContentBlock({
+                    text: {
+                        text: 'guard this content',
+                        qualifiers: ['guard_content'],
+                    },
+                }),
+            ]);
+        });
+    });
+    describe('when called with mixed content blocks', () => {
+        it('converts all block types correctly', () => {
+            const data = [
+                { text: 'First text block' },
+                { cachePoint: { cacheType: 'default' } },
+                { text: 'Second text block' },
+                {
+                    guardContent: {
+                        text: {
+                            text: 'guard content',
+                            qualifiers: ['guard_content'],
+                        },
+                    },
+                },
+            ];
+            const result = systemPromptFromData(data);
+            expect(result).toEqual([
+                new TextBlock('First text block'),
+                new CachePointBlock({ cacheType: 'default' }),
+                new TextBlock('Second text block'),
+                new GuardContentBlock({
+                    text: {
+                        text: 'guard content',
+                        qualifiers: ['guard_content'],
+                    },
+                }),
+            ]);
+        });
+    });
+    describe('when called with empty array', () => {
+        it('returns empty array', () => {
+            const data = [];
+            const result = systemPromptFromData(data);
+            expect(result).toEqual([]);
+        });
+    });
+    describe('when called with unknown block type', () => {
+        it('throws error', () => {
+            const data = [{ unknownType: { data: 'value' } }];
+            expect(() => systemPromptFromData(data)).toThrow('Unknown SystemContentBlockData type');
+        });
+    });
+    describe('when called with class instances', () => {
+        it('returns them unchanged', () => {
+            const systemPrompt = [new TextBlock('prompt'), new CachePointBlock({ cacheType: 'default' })];
+            const result = systemPromptFromData(systemPrompt);
+            expect(result).toEqual(systemPrompt);
+        });
+    });
+});
+//# sourceMappingURL=messages.test.js.map

package/dist/src/types/__tests__/messages.test.js.map

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

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

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

package/dist/src/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/src/types/__tests__/validation.test.js

@@ -0,0 +1,30 @@
+import { describe, it, expect } from 'vitest';
+import { ensureDefined } from '../validation.js';
+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/src/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,kBAAkB,CAAA;AAEhD,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/src/types/agent.d.ts

@@ -0,0 +1,57 @@
+import type { AgentState } from '../agent/state.js';
+import type { Message } from './messages.js';
+import type { ModelStreamEvent } from '../models/streaming.js';
+import { ToolStreamEvent } from '../tools/tool.js';
+import type { ContentBlock } from './messages.js';
+import type { BeforeInvocationEvent, AfterInvocationEvent, BeforeModelCallEvent, AfterModelCallEvent, BeforeToolsEvent, AfterToolsEvent, BeforeToolCallEvent, AfterToolCallEvent, MessageAddedEvent, ModelStreamEventHook } from '../hooks/events.js';
+/**
+ * Interface for objects that provide agent state.
+ * Allows ToolContext to work with different agent types.
+ */
+export interface AgentData {
+    /**
+     * Agent state storage accessible to tools and application logic.
+     */
+    state: AgentState;
+    /**
+     * The conversation history of messages between user and assistant.
+     */
+    messages: Message[];
+}
+/**
+ * Result returned by the agent loop.
+ */
+export declare class AgentResult {
+    readonly type: "agentResult";
+    /**
+     * The stop reason from the final model response.
+     */
+    readonly stopReason: string;
+    /**
+     * The last message added to the messages array.
+     */
+    readonly lastMessage: Message;
+    constructor(data: {
+        stopReason: string;
+        lastMessage: Message;
+    });
+    /**
+     * Extracts and concatenates all text content from the last message.
+     * Includes text from TextBlock and ReasoningBlock content blocks.
+     *
+     * @returns The agent's last message as a string, with multiple blocks joined by newlines.
+     */
+    toString(): string;
+}
+/**
+ * Union type representing all possible streaming events from an agent.
+ * This includes model events, tool events, and agent-specific lifecycle events.
+ *
+ * This is a discriminated union where each event has a unique type field,
+ * allowing for type-safe event handling using switch statements.
+ *
+ * Note: All agent lifecycle events are Hook Event instances, providing
+ * consistent structure with agent reference and extensibility features.
+ */
+export type AgentStreamEvent = ModelStreamEvent | ContentBlock | ToolStreamEvent | BeforeInvocationEvent | AfterInvocationEvent | BeforeModelCallEvent | AfterModelCallEvent | BeforeToolsEvent | AfterToolsEvent | BeforeToolCallEvent | AfterToolCallEvent | MessageAddedEvent | ModelStreamEventHook | AgentResult;
+//# sourceMappingURL=agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/types/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AACjD,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,oBAAoB,CAAA;AAE3B;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,KAAK,EAAE,UAAU,CAAA;IAEjB;;OAEG;IACH,QAAQ,EAAE,OAAO,EAAE,CAAA;CACpB;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,QAAQ,CAAC,IAAI,EAAG,aAAa,CAAS;IAEtC;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAE3B;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;gBAEjB,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,OAAO,CAAA;KAAE;IAK9D;;;;;OAKG;IACI,QAAQ,IAAI,MAAM;CAuB1B;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,gBAAgB,GACxB,gBAAgB,GAChB,YAAY,GACZ,eAAe,GACf,qBAAqB,GACrB,oBAAoB,GACpB,oBAAoB,GACpB,mBAAmB,GACnB,gBAAgB,GAChB,eAAe,GACf,mBAAmB,GACnB,kBAAkB,GAClB,iBAAiB,GACjB,oBAAoB,GACpB,WAAW,CAAA"}

package/dist/src/types/agent.js

@@ -0,0 +1,47 @@
+import { ToolStreamEvent } from '../tools/tool.js';
+/**
+ * Result returned by the agent loop.
+ */
+export class AgentResult {
+    type = 'agentResult';
+    /**
+     * The stop reason from the final model response.
+     */
+    stopReason;
+    /**
+     * The last message added to the messages array.
+     */
+    lastMessage;
+    constructor(data) {
+        this.stopReason = data.stopReason;
+        this.lastMessage = data.lastMessage;
+    }
+    /**
+     * Extracts and concatenates all text content from the last message.
+     * Includes text from TextBlock and ReasoningBlock content blocks.
+     *
+     * @returns The agent's last message as a string, with multiple blocks joined by newlines.
+     */
+    toString() {
+        const textParts = [];
+        for (const block of this.lastMessage.content) {
+            switch (block.type) {
+                case 'textBlock':
+                    textParts.push(block.text);
+                    break;
+                case 'reasoningBlock':
+                    if (block.text) {
+                        // Add indentation to reasoning content
+                        const indentedText = block.text.replace(/\n/g, '\n   ');
+                        textParts.push(`💭 Reasoning:\n   ${indentedText}`);
+                    }
+                    break;
+                default:
+                    console.debug(`Skipping content block type: ${block.type}`);
+                    break;
+            }
+        }
+        return textParts.join('\n');
+    }
+}
+//# sourceMappingURL=agent.js.map

package/dist/src/types/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../../src/types/agent.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AA+BlD;;GAEG;AACH,MAAM,OAAO,WAAW;IACb,IAAI,GAAG,aAAsB,CAAA;IAEtC;;OAEG;IACM,UAAU,CAAQ;IAE3B;;OAEG;IACM,WAAW,CAAS;IAE7B,YAAY,IAAkD;QAC5D,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAA;QACjC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAA;IACrC,CAAC;IAED;;;;;OAKG;IACI,QAAQ;QACb,MAAM,SAAS,GAAa,EAAE,CAAA;QAE9B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YAC7C,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;gBACnB,KAAK,WAAW;oBACd,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;oBAC1B,MAAK;gBACP,KAAK,gBAAgB;oBACnB,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;wBACf,uCAAuC;wBACvC,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;wBACvD,SAAS,CAAC,IAAI,CAAC,qBAAqB,YAAY,EAAE,CAAC,CAAA;oBACrD,CAAC;oBACD,MAAK;gBACP;oBACE,OAAO,CAAC,KAAK,CAAC,gCAAgC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;oBAC3D,MAAK;YACT,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC7B,CAAC;CACF"}

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

@@ -0,0 +1,55 @@
+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;
+/**
+ * Creates a deep copy of a value with explicit validation for non-serializable types.
+ * Uses JSON.stringify's replacer to detect and report non-serializable values with path information.
+ *
+ * @param value - The value to copy
+ * @param contextPath - Context path for error messages (e.g., 'initialState', 'value for key "config"')
+ * @returns A deep copy of the value
+ * @throws JsonValidationError if value contains functions, symbols, or undefined values
+ */
+export declare function deepCopyWithValidation(value: unknown, contextPath?: string): JSONValue;
+//# sourceMappingURL=json.d.ts.map

package/dist/src/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;AAG9C;;;;;;;;;;;;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;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,GAAE,MAAgB,GAAG,SAAS,CAiD/F"}