@strands-agents/sdk 0.3.0 → 0.5.0

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

@@ -1,10 +1,10 @@
-import type { JSONValue } from './json.js';
+import type { JSONValue, Serialized, MaybeSerializedInput, JSONSerializable } from './json.js';
 import type { ImageBlockData, VideoBlockData, DocumentBlockData } from './media.js';
 import { ImageBlock, VideoBlock, DocumentBlock } from './media.js';
 /**
  * Message types and content blocks for conversational AI interactions.
  *
- * This module follows a pattern where <name>Data interfaces define the structure
+ * This module follows a pattern where "Data" interfaces define the structure
  * for objects, while corresponding classes extend those interfaces with additional
  * functionality and type discrimination.
  */
@@ -25,7 +25,7 @@ export interface MessageData {
  * A message in a conversation between user and assistant.
  * Each message has a role (user or assistant) and an array of content blocks.
  */
-export declare class Message {
+export declare class Message implements JSONSerializable<MessageData> {
     /**
      * Discriminator for message type.
      */
@@ -46,6 +46,19 @@ export declare class Message {
      * Creates a Message instance from MessageData.
      */
     static fromMessageData(data: MessageData): Message;
+    /**
+     * Serializes the Message to a JSON-compatible MessageData object.
+     * Called automatically by JSON.stringify().
+     */
+    toJSON(): MessageData;
+    /**
+     * Creates a Message instance from MessageData.
+     * Alias for fromMessageData for API consistency.
+     *
+     * @param data - MessageData to deserialize
+     * @returns Message instance
+     */
+    static fromJSON(data: MessageData): Message;
 }
 /**
  * Role of a message in a conversation.
@@ -95,7 +108,7 @@ export interface TextBlockData {
 /**
  * Text content block within a message.
  */
-export declare class TextBlock implements TextBlockData {
+export declare class TextBlock implements TextBlockData, JSONSerializable<TextBlockData> {
     /**
      * Discriminator for text content.
      */
@@ -105,6 +118,18 @@ export declare class TextBlock implements TextBlockData {
      */
     readonly text: string;
     constructor(data: string);
+    /**
+     * Serializes the TextBlock to a JSON-compatible TextBlockData object.
+     * Called automatically by JSON.stringify().
+     */
+    toJSON(): TextBlockData;
+    /**
+     * Creates a TextBlock instance from TextBlockData.
+     *
+     * @param data - TextBlockData to deserialize
+     * @returns TextBlock instance
+     */
+    static fromJSON(data: TextBlockData): TextBlock;
 }
 /**
  * Data for a tool use block.
@@ -132,7 +157,9 @@ export interface ToolUseBlockData {
 /**
  * Tool use content block.
  */
-export declare class ToolUseBlock implements ToolUseBlockData {
+export declare class ToolUseBlock implements ToolUseBlockData, JSONSerializable<{
+    toolUse: ToolUseBlockData;
+}> {
     /**
      * Discriminator for tool use content.
      */
@@ -156,6 +183,22 @@ export declare class ToolUseBlock implements ToolUseBlockData {
      */
     readonly reasoningSignature?: string;
     constructor(data: ToolUseBlockData);
+    /**
+     * Serializes the ToolUseBlock to a JSON-compatible ContentBlockData object.
+     * Called automatically by JSON.stringify().
+     */
+    toJSON(): {
+        toolUse: ToolUseBlockData;
+    };
+    /**
+     * Creates a ToolUseBlock instance from its wrapped data format.
+     *
+     * @param data - Wrapped ToolUseBlockData to deserialize
+     * @returns ToolUseBlock instance
+     */
+    static fromJSON(data: {
+        toolUse: ToolUseBlockData;
+    }): ToolUseBlock;
 }
 /**
  * Content within a tool result.
@@ -183,7 +226,7 @@ export interface ToolResultBlockData {
     content: ToolResultContentData[];
     /**
      * The original error object when status is 'error'.
-     * Available for inspection by hooks, error handlers, and event loop.
+     * Available for inspection by hooks, error handlers, and agent loop.
      * Tools must wrap non-Error thrown values into Error objects.
      */
     error?: Error;
@@ -191,7 +234,9 @@ export interface ToolResultBlockData {
 /**
  * Tool result content block.
  */
-export declare class ToolResultBlock implements ToolResultBlockData {
+export declare class ToolResultBlock implements ToolResultBlockData, JSONSerializable<{
+    toolResult: ToolResultBlockData;
+}> {
     /**
      * Discriminator for tool result content.
      */
@@ -210,7 +255,7 @@ export declare class ToolResultBlock implements ToolResultBlockData {
     readonly content: ToolResultContent[];
     /**
      * The original error object when status is 'error'.
-     * Available for inspection by hooks, error handlers, and event loop.
+     * Available for inspection by hooks, error handlers, and agent loop.
      * Tools must wrap non-Error thrown values into Error objects.
      */
     readonly error?: Error;
@@ -220,6 +265,23 @@ export declare class ToolResultBlock implements ToolResultBlockData {
         content: ToolResultContent[];
         error?: Error;
     });
+    /**
+     * Serializes the ToolResultBlock to a JSON-compatible ContentBlockData object.
+     * Called automatically by JSON.stringify().
+     * Note: The error field is not serialized (deferred for future implementation).
+     */
+    toJSON(): {
+        toolResult: ToolResultBlockData;
+    };
+    /**
+     * Creates a ToolResultBlock instance from its wrapped data format.
+     *
+     * @param data - Wrapped ToolResultBlockData to deserialize
+     * @returns ToolResultBlock instance
+     */
+    static fromJSON(data: {
+        toolResult: ToolResultBlockData;
+    }): ToolResultBlock;
 }
 /**
  * Data for a reasoning block.
@@ -241,7 +303,9 @@ export interface ReasoningBlockData {
 /**
  * Reasoning content block within a message.
  */
-export declare class ReasoningBlock implements ReasoningBlockData {
+export declare class ReasoningBlock implements ReasoningBlockData, JSONSerializable<{
+    reasoning: Serialized<ReasoningBlockData>;
+}> {
     /**
      * Discriminator for reasoning content.
      */
@@ -259,6 +323,24 @@ export declare class ReasoningBlock implements ReasoningBlockData {
      */
     readonly redactedContent?: Uint8Array;
     constructor(data: ReasoningBlockData);
+    /**
+     * Serializes the ReasoningBlock to a JSON-compatible ContentBlockData object.
+     * Called automatically by JSON.stringify().
+     * Uint8Array redactedContent is encoded as base64 string.
+     */
+    toJSON(): {
+        reasoning: Serialized<ReasoningBlockData>;
+    };
+    /**
+     * Creates a ReasoningBlock instance from its wrapped data format.
+     * Base64-encoded redactedContent is decoded back to Uint8Array.
+     *
+     * @param data - Wrapped ReasoningBlockData to deserialize (accepts both string and Uint8Array for redactedContent)
+     * @returns ReasoningBlock instance
+     */
+    static fromJSON(data: {
+        reasoning: MaybeSerializedInput<ReasoningBlockData>;
+    }): ReasoningBlock;
 }
 /**
  * Data for a cache point block.
@@ -273,7 +355,9 @@ export interface CachePointBlockData {
  * Cache point block for prompt caching.
  * Marks a position in a message or system prompt where caching should occur.
  */
-export declare class CachePointBlock implements CachePointBlockData {
+export declare class CachePointBlock implements CachePointBlockData, JSONSerializable<{
+    cachePoint: CachePointBlockData;
+}> {
     /**
      * Discriminator for cache point.
      */
@@ -283,6 +367,22 @@ export declare class CachePointBlock implements CachePointBlockData {
      */
     readonly cacheType: 'default';
     constructor(data: CachePointBlockData);
+    /**
+     * Serializes the CachePointBlock to a JSON-compatible ContentBlockData object.
+     * Called automatically by JSON.stringify().
+     */
+    toJSON(): {
+        cachePoint: CachePointBlockData;
+    };
+    /**
+     * Creates a CachePointBlock instance from its wrapped data format.
+     *
+     * @param data - Wrapped CachePointBlockData to deserialize
+     * @returns CachePointBlock instance
+     */
+    static fromJSON(data: {
+        cachePoint: CachePointBlockData;
+    }): CachePointBlock;
 }
 /**
  * Data for a JSON block.
@@ -297,7 +397,7 @@ export interface JsonBlockData {
  * JSON content block within a message.
  * Used for structured data returned from tools or model responses.
  */
-export declare class JsonBlock implements JsonBlockData {
+export declare class JsonBlock implements JsonBlockData, JSONSerializable<JsonBlockData> {
     /**
      * Discriminator for JSON content.
      */
@@ -307,6 +407,18 @@ export declare class JsonBlock implements JsonBlockData {
      */
     readonly json: JSONValue;
     constructor(data: JsonBlockData);
+    /**
+     * Serializes the JsonBlock to a JSON-compatible JsonBlockData object.
+     * Called automatically by JSON.stringify().
+     */
+    toJSON(): JsonBlockData;
+    /**
+     * Creates a JsonBlock instance from JsonBlockData.
+     *
+     * @param data - JsonBlockData to deserialize
+     * @returns JsonBlock instance
+     */
+    static fromJSON(data: JsonBlockData): JsonBlock;
 }
 /**
  * Reason why the model stopped generating content.
@@ -342,7 +454,7 @@ export type SystemPrompt = string | SystemContentBlock[];
  * Data representation of a system prompt.
  * Can be a simple string or an array of system content block data for advanced caching.
  *
- * This is the data interface counterpart to SystemPrompt, following the <name>Data pattern.
+ * This is the data interface counterpart to SystemPrompt, following the "Data" pattern.
  */
 export type SystemPromptData = string | SystemContentBlockData[];
 /**
@@ -353,6 +465,13 @@ export type SystemPromptData = string | SystemContentBlockData[];
  * @returns SystemPrompt with class-based content blocks
  */
 export declare function systemPromptFromData(data: SystemPromptData | SystemPrompt): SystemPrompt;
+/**
+ * Converts a SystemPrompt to its data representation for serialization.
+ *
+ * @param prompt - System prompt to convert (string or content block array)
+ * @returns SystemPromptData suitable for JSON serialization
+ */
+export declare function systemPromptToData(prompt: SystemPrompt): SystemPromptData;
 /**
  * A block of content within a system prompt.
  * Supports text content, cache points, and guard content for prompt caching and guardrail evaluation.
@@ -431,7 +550,9 @@ export interface GuardContentBlockData {
  * Marks content that should be evaluated by guardrails for safety, grounding, or other policies.
  * Can be used in both message content and system prompts.
  */
-export declare class GuardContentBlock implements GuardContentBlockData {
+export declare class GuardContentBlock implements GuardContentBlockData, JSONSerializable<{
+    guardContent: Serialized<GuardContentBlockData>;
+}> {
     /**
      * Discriminator for guard content.
      */
@@ -445,6 +566,24 @@ export declare class GuardContentBlock implements GuardContentBlockData {
      */
     readonly image?: GuardContentImage;
     constructor(data: GuardContentBlockData);
+    /**
+     * Serializes the GuardContentBlock to a JSON-compatible ContentBlockData object.
+     * Called automatically by JSON.stringify().
+     * Uint8Array image bytes are encoded as base64 string.
+     */
+    toJSON(): {
+        guardContent: Serialized<GuardContentBlockData>;
+    };
+    /**
+     * Creates a GuardContentBlock instance from its wrapped data format.
+     * Base64-encoded image bytes are decoded back to Uint8Array.
+     *
+     * @param data - Wrapped GuardContentBlockData to deserialize (accepts both string and Uint8Array for image bytes)
+     * @returns GuardContentBlock instance
+     */
+    static fromJSON(data: {
+        guardContent: MaybeSerializedInput<GuardContentBlockData>;
+    }): GuardContentBlock;
 }
 /**
  * Converts ContentBlockData to a ContentBlock instance.

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

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

package/dist/src/types/messages.js

@@ -1,4 +1,5 @@
-import { ImageBlock, VideoBlock, DocumentBlock } from './media.js';
+import { omitUndefined } from './json.js';
+import { ImageBlock, VideoBlock, DocumentBlock, encodeBase64, decodeBase64 } from './media.js';
 /**
  * A message in a conversation between user and assistant.
  * Each message has a role (user or assistant) and an array of content blocks.
@@ -30,6 +31,26 @@ export class Message {
             content: contentBlocks,
         });
     }
+    /**
+     * Serializes the Message to a JSON-compatible MessageData object.
+     * Called automatically by JSON.stringify().
+     */
+    toJSON() {
+        return {
+            role: this.role,
+            content: this.content.map((block) => block.toJSON()),
+        };
+    }
+    /**
+     * Creates a Message instance from MessageData.
+     * Alias for fromMessageData for API consistency.
+     *
+     * @param data - MessageData to deserialize
+     * @returns Message instance
+     */
+    static fromJSON(data) {
+        return Message.fromMessageData(data);
+    }
 }
 /**
  * Text content block within a message.
@@ -46,6 +67,22 @@ export class TextBlock {
     constructor(data) {
         this.text = data;
     }
+    /**
+     * Serializes the TextBlock to a JSON-compatible TextBlockData object.
+     * Called automatically by JSON.stringify().
+     */
+    toJSON() {
+        return { text: this.text };
+    }
+    /**
+     * Creates a TextBlock instance from TextBlockData.
+     *
+     * @param data - TextBlockData to deserialize
+     * @returns TextBlock instance
+     */
+    static fromJSON(data) {
+        return new TextBlock(data.text);
+    }
 }
 /**
  * Tool use content block.
@@ -81,6 +118,29 @@ export class ToolUseBlock {
             this.reasoningSignature = data.reasoningSignature;
         }
     }
+    /**
+     * Serializes the ToolUseBlock to a JSON-compatible ContentBlockData object.
+     * Called automatically by JSON.stringify().
+     */
+    toJSON() {
+        return {
+            toolUse: omitUndefined({
+                name: this.name,
+                toolUseId: this.toolUseId,
+                input: this.input,
+                reasoningSignature: this.reasoningSignature,
+            }),
+        };
+    }
+    /**
+     * Creates a ToolUseBlock instance from its wrapped data format.
+     *
+     * @param data - Wrapped ToolUseBlockData to deserialize
+     * @returns ToolUseBlock instance
+     */
+    static fromJSON(data) {
+        return new ToolUseBlock(data.toolUse);
+    }
 }
 /**
  * Tool result content block.
@@ -104,7 +164,7 @@ export class ToolResultBlock {
     content;
     /**
      * The original error object when status is 'error'.
-     * Available for inspection by hooks, error handlers, and event loop.
+     * Available for inspection by hooks, error handlers, and agent loop.
      * Tools must wrap non-Error thrown values into Error objects.
      */
     error;
@@ -116,6 +176,44 @@ export class ToolResultBlock {
             this.error = data.error;
         }
     }
+    /**
+     * Serializes the ToolResultBlock to a JSON-compatible ContentBlockData object.
+     * Called automatically by JSON.stringify().
+     * Note: The error field is not serialized (deferred for future implementation).
+     */
+    toJSON() {
+        return {
+            toolResult: {
+                toolUseId: this.toolUseId,
+                status: this.status,
+                content: this.content.map((block) => block.toJSON()),
+            },
+        };
+    }
+    /**
+     * Creates a ToolResultBlock instance from its wrapped data format.
+     *
+     * @param data - Wrapped ToolResultBlockData to deserialize
+     * @returns ToolResultBlock instance
+     */
+    static fromJSON(data) {
+        const content = data.toolResult.content.map((contentItem) => {
+            if ('text' in contentItem) {
+                return new TextBlock(contentItem.text);
+            }
+            else if ('json' in contentItem) {
+                return new JsonBlock(contentItem);
+            }
+            else {
+                throw new Error('Unknown ToolResultContentData type');
+            }
+        });
+        return new ToolResultBlock({
+            toolUseId: data.toolResult.toolUseId,
+            status: data.toolResult.status,
+            content,
+        });
+    }
 }
 /**
  * Reasoning content block within a message.
@@ -148,6 +246,44 @@ export class ReasoningBlock {
             this.redactedContent = data.redactedContent;
         }
     }
+    /**
+     * Serializes the ReasoningBlock to a JSON-compatible ContentBlockData object.
+     * Called automatically by JSON.stringify().
+     * Uint8Array redactedContent is encoded as base64 string.
+     */
+    toJSON() {
+        return {
+            reasoning: omitUndefined({
+                text: this.text,
+                signature: this.signature,
+                redactedContent: this.redactedContent ? encodeBase64(this.redactedContent) : undefined,
+            }),
+        };
+    }
+    /**
+     * Creates a ReasoningBlock instance from its wrapped data format.
+     * Base64-encoded redactedContent is decoded back to Uint8Array.
+     *
+     * @param data - Wrapped ReasoningBlockData to deserialize (accepts both string and Uint8Array for redactedContent)
+     * @returns ReasoningBlock instance
+     */
+    static fromJSON(data) {
+        const reasoning = data.reasoning;
+        const result = {};
+        if (reasoning.text !== undefined) {
+            result.text = reasoning.text;
+        }
+        if (reasoning.signature !== undefined) {
+            result.signature = reasoning.signature;
+        }
+        if (reasoning.redactedContent !== undefined) {
+            result.redactedContent =
+                typeof reasoning.redactedContent === 'string'
+                    ? decodeBase64(reasoning.redactedContent)
+                    : reasoning.redactedContent;
+        }
+        return new ReasoningBlock(result);
+    }
 }
 /**
  * Cache point block for prompt caching.
@@ -165,6 +301,26 @@ export class CachePointBlock {
     constructor(data) {
         this.cacheType = data.cacheType;
     }
+    /**
+     * Serializes the CachePointBlock to a JSON-compatible ContentBlockData object.
+     * Called automatically by JSON.stringify().
+     */
+    toJSON() {
+        return {
+            cachePoint: {
+                cacheType: this.cacheType,
+            },
+        };
+    }
+    /**
+     * Creates a CachePointBlock instance from its wrapped data format.
+     *
+     * @param data - Wrapped CachePointBlockData to deserialize
+     * @returns CachePointBlock instance
+     */
+    static fromJSON(data) {
+        return new CachePointBlock(data.cachePoint);
+    }
 }
 /**
  * JSON content block within a message.
@@ -182,6 +338,22 @@ export class JsonBlock {
     constructor(data) {
         this.json = data.json;
     }
+    /**
+     * Serializes the JsonBlock to a JSON-compatible JsonBlockData object.
+     * Called automatically by JSON.stringify().
+     */
+    toJSON() {
+        return { json: this.json };
+    }
+    /**
+     * Creates a JsonBlock instance from JsonBlockData.
+     *
+     * @param data - JsonBlockData to deserialize
+     * @returns JsonBlock instance
+     */
+    static fromJSON(data) {
+        return new JsonBlock(data);
+    }
 }
 /**
  * Converts SystemPromptData to SystemPrompt by converting data blocks to class instances.
@@ -213,6 +385,19 @@ export function systemPromptFromData(data) {
         }
     });
 }
+/**
+ * Converts a SystemPrompt to its data representation for serialization.
+ *
+ * @param prompt - System prompt to convert (string or content block array)
+ * @returns SystemPromptData suitable for JSON serialization
+ */
+export function systemPromptToData(prompt) {
+    if (typeof prompt === 'string') {
+        return prompt;
+    }
+    // Convert content blocks to their data representation
+    return prompt.map((block) => block.toJSON());
+}
 /**
  * Guard content block for guardrail evaluation.
  * Marks content that should be evaluated by guardrails for safety, grounding, or other policies.
@@ -245,6 +430,48 @@ export class GuardContentBlock {
             this.image = data.image;
         }
     }
+    /**
+     * Serializes the GuardContentBlock to a JSON-compatible ContentBlockData object.
+     * Called automatically by JSON.stringify().
+     * Uint8Array image bytes are encoded as base64 string.
+     */
+    toJSON() {
+        const data = {};
+        if (this.text) {
+            data.text = this.text;
+        }
+        if (this.image) {
+            data.image = {
+                format: this.image.format,
+                source: { bytes: encodeBase64(this.image.source.bytes) },
+            };
+        }
+        return { guardContent: data };
+    }
+    /**
+     * Creates a GuardContentBlock instance from its wrapped data format.
+     * Base64-encoded image bytes are decoded back to Uint8Array.
+     *
+     * @param data - Wrapped GuardContentBlockData to deserialize (accepts both string and Uint8Array for image bytes)
+     * @returns GuardContentBlock instance
+     */
+    static fromJSON(data) {
+        const guardContent = data.guardContent;
+        const result = {};
+        if (guardContent.text) {
+            result.text = guardContent.text;
+        }
+        if (guardContent.image) {
+            const bytes = guardContent.image.source.bytes;
+            result.image = {
+                format: guardContent.image.format,
+                source: {
+                    bytes: typeof bytes === 'string' ? decodeBase64(bytes) : bytes,
+                },
+            };
+        }
+        return new GuardContentBlock(result);
+    }
 }
 /**
  * Converts ContentBlockData to a ContentBlock instance.
@@ -279,22 +506,22 @@ export function contentBlockFromData(data) {
         });
     }
     else if ('reasoning' in data) {
-        return new ReasoningBlock(data.reasoning);
+        return ReasoningBlock.fromJSON(data);
     }
     else if ('cachePoint' in data) {
-        return new CachePointBlock(data.cachePoint);
+        return CachePointBlock.fromJSON(data);
     }
     else if ('guardContent' in data) {
-        return new GuardContentBlock(data.guardContent);
+        return GuardContentBlock.fromJSON(data);
     }
     else if ('image' in data) {
-        return new ImageBlock(data.image);
+        return ImageBlock.fromJSON(data);
     }
     else if ('video' in data) {
-        return new VideoBlock(data.video);
+        return VideoBlock.fromJSON(data);
     }
     else if ('document' in data) {
-        return new DocumentBlock(data.document);
+        return DocumentBlock.fromJSON(data);
     }
     else {
         throw new Error('Unknown ContentBlockData type');