@strands-agents/sdk 1.0.0 → 1.2.0

package/dist/src/index.js

@@ -10,10 +10,13 @@ export { Agent } from './agent/agent.js';
 export { StateStore } from './state-store.js';
 // Agent types
 export { AgentResult } from './types/agent.js';
+// Snapshot types
+export { SNAPSHOT_SCHEMA_VERSION } from './types/snapshot.js';
 // Error types
 // Note: CancelledError is intentionally not exported — it is an internal
 // control-flow mechanism, never thrown to consumers. See its docstring in errors.ts.
 export { ModelError, ContextWindowOverflowError, MaxTokensError, JsonValidationError, ConcurrentInvocationError, ModelThrottledError, ToolValidationError, StructuredOutputError, } from './errors.js';
+export { InterruptResponseContent } from './types/interrupt.js';
 // Message classes
 export { TextBlock, ToolUseBlock, ToolResultBlock, ReasoningBlock, CachePointBlock, GuardContentBlock, Message, JsonBlock, contentBlockFromData, toolResultContentFromData, } from './types/messages.js';
 // Citation class
@@ -34,7 +37,9 @@ export { Model } from './models/model.js';
 // Bedrock model provider
 export { BedrockModel as BedrockModel } from './models/bedrock.js';
 // Hooks system
-export { HookRegistry, StreamEvent, HookableEvent, InitializedEvent, BeforeInvocationEvent, AfterInvocationEvent, MessageAddedEvent, BeforeToolCallEvent, AfterToolCallEvent, BeforeModelCallEvent, AfterModelCallEvent, BeforeToolsEvent, AfterToolsEvent, ContentBlockEvent, ModelMessageEvent, ToolResultEvent, ToolStreamUpdateEvent, AgentResultEvent, ModelStreamUpdateEvent, } from './hooks/index.js';
+export { HookRegistry, HookOrder, StreamEvent, HookableEvent, InitializedEvent, BeforeInvocationEvent, AfterInvocationEvent, MessageAddedEvent, BeforeToolCallEvent, AfterToolCallEvent, BeforeModelCallEvent, AfterModelCallEvent, BeforeToolsEvent, AfterToolsEvent, ContentBlockEvent, ModelMessageEvent, ToolResultEvent, ToolStreamUpdateEvent, AgentResultEvent, InterruptEvent, ModelStreamUpdateEvent, } from './hooks/index.js';
+// Retry
+export { ConstantBackoff, LinearBackoff, ExponentialBackoff, ModelRetryStrategy, DefaultModelRetryStrategy, } from './retry/index.js';
 // Conversation Manager
 export { ConversationManager, } from './conversation-manager/conversation-manager.js';
 export { NullConversationManager } from './conversation-manager/null-conversation-manager.js';
@@ -43,7 +48,7 @@ export { SummarizingConversationManager, } from './conversation-manager/summariz
 // Logging
 export { configureLogging } from './logging/logger.js';
 // MCP Client types and implementations
-export { McpClient } from './mcp.js';
+export { McpClient, } from './mcp.js';
 // Session management
 export { SessionManager } from './session/session-manager.js';
 export { FileStorage } from './session/file-storage.js';

package/dist/src/index.js.map

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

package/dist/src/interrupt.d.ts

@@ -0,0 +1,247 @@
+/**
+ * Human-in-the-loop interrupt system for agent workflows.
+ *
+ * Interrupt Flow:
+ * 1. Hook or tool calls `event.interrupt()` or `context.interrupt()`
+ * 2. If resuming (response exists), the response is returned
+ * 3. Otherwise, agent execution halts with `stopReason: 'interrupt'`
+ * 4. User resumes by invoking agent with `interruptResponse` content blocks
+ * 5. On resume, `interrupt()` returns the user's response
+ */
+import { InterruptResponseContent, type InterruptResponseContentData, type InterruptParams } from './types/interrupt.js';
+import type { JSONValue } from './types/json.js';
+import type { LocalAgent } from './types/agent.js';
+import { Message, ToolResultBlock, type MessageData, type ToolResultBlockData } from './types/messages.js';
+/**
+ * Origin of an interrupt:
+ * - `'tool'` — raised by a tool callback via `ToolContext.interrupt()`.
+ * - `'hook'` — raised by an agent-level hook (e.g. `BeforeToolCallEvent.interrupt()`).
+ * - `'multiagent-hook'` — raised by a multi-agent hook (e.g. `BeforeNodeCallEvent.interrupt()`).
+ */
+export type InterruptSource = 'tool' | 'hook' | 'multiagent-hook';
+/**
+ * Represents an interrupt that can pause agent execution for human-in-the-loop workflows.
+ */
+export declare class Interrupt {
+    /**
+     * Unique identifier for this interrupt.
+     */
+    readonly id: string;
+    /**
+     * User-defined name for the interrupt.
+     */
+    readonly name: string;
+    /**
+     * User-provided reason for raising the interrupt.
+     */
+    readonly reason?: JSONValue;
+    /**
+     * Human response provided when resuming the agent after an interrupt.
+     */
+    response?: JSONValue;
+    /**
+     * Where this interrupt was raised from — a tool callback, an agent-level hook, or
+     * a multi-agent orchestrator hook. Always populated. When deserializing a snapshot
+     * produced by an older SDK that did not record this field, defaults to `'hook'`.
+     */
+    readonly source: InterruptSource;
+    constructor(data: {
+        id: string;
+        name: string;
+        reason?: JSONValue;
+        response?: JSONValue;
+        source?: InterruptSource;
+    });
+    /**
+     * Serializes the interrupt to a JSON-compatible object.
+     */
+    toJSON(): {
+        id: string;
+        name: string;
+        reason?: JSONValue;
+        response?: JSONValue;
+        source: InterruptSource;
+    };
+    /**
+     * Creates an Interrupt instance from a JSON object.
+     *
+     * @param data - JSON data to deserialize
+     * @returns Interrupt instance
+     */
+    static fromJSON(data: {
+        id: string;
+        name: string;
+        reason?: JSONValue;
+        response?: JSONValue;
+        source?: InterruptSource;
+    }): Interrupt;
+}
+/**
+ * Error thrown when human input is required to continue agent execution.
+ * Caught by the agent loop to trigger an interrupt stop.
+ */
+export declare class InterruptError extends Error {
+    /**
+     * The interrupts that caused this error.
+     */
+    readonly interrupts: Interrupt[];
+    constructor(interrupt: Interrupt | Interrupt[]);
+}
+/**
+ * Data format for serialized interrupt state.
+ */
+export interface InterruptStateData {
+    /**
+     * Map of interrupt IDs to interrupt data.
+     */
+    interrupts: Record<string, {
+        id: string;
+        name: string;
+        reason?: JSONValue;
+        response?: JSONValue;
+    }>;
+    /**
+     * Resume responses that were provided when resuming from an interrupt.
+     */
+    resumeResponses?: InterruptResponseContentData[] | undefined;
+    /**
+     * Whether the agent is in an interrupted state.
+     */
+    activated: boolean;
+    /**
+     * Pending tool execution state for resume after interrupt.
+     */
+    pendingToolExecution?: PendingToolExecution | undefined;
+}
+/**
+ * Pending tool execution state stored when an interrupt occurs mid-execution.
+ * Contains all data needed to resume tool execution without re-calling the model.
+ */
+export interface PendingToolExecution {
+    /**
+     * The assistant message containing tool use blocks, serialized as MessageData.
+     */
+    assistantMessageData: MessageData;
+    /**
+     * Tool results that were completed before the interrupt.
+     * Maps toolUseId to serialized ToolResultBlock data.
+     */
+    completedToolResults: Record<string, {
+        toolResult: ToolResultBlockData;
+    }>;
+}
+/**
+ * Tracks the state of interrupt events raised during agent execution.
+ *
+ * Interrupt state is cleared after resuming.
+ */
+export declare class InterruptState implements InterruptStateData {
+    /** Record of interrupt IDs to Interrupt instances. */
+    interrupts: Record<string, Interrupt>;
+    /** Resume responses provided when resuming from an interrupt. */
+    resumeResponses?: InterruptResponseContent[] | undefined;
+    /** Whether the agent is in an interrupted state. */
+    activated: boolean;
+    /** Pending tool execution state for resume. */
+    pendingToolExecution?: PendingToolExecution | undefined;
+    constructor();
+    /**
+     * Gets the pending tool execution state with reconstructed Message and ToolResultBlock objects.
+     * Returns undefined if there is no pending execution.
+     */
+    getPendingExecution(): {
+        assistantMessage: Message;
+        completedToolResults: Map<string, ToolResultBlock>;
+    } | undefined;
+    /**
+     * Sets the pending tool execution state.
+     */
+    setPendingToolExecution(pending: PendingToolExecution): void;
+    /**
+     * Clears the pending tool execution state.
+     */
+    clearPendingToolExecution(): void;
+    /**
+     * Returns the list of interrupts as an array.
+     */
+    getInterruptsList(): Interrupt[];
+    /**
+     * Returns all interrupts that have no response (i.e., were raised but not yet answered).
+     */
+    getUnansweredInterrupts(): Interrupt[];
+    /**
+     * Returns the first interrupt that has no response (i.e., was raised but not yet answered).
+     */
+    getUnansweredInterrupt(): Interrupt | undefined;
+    /**
+     * Activates the interrupt state.
+     */
+    activate(): void;
+    /**
+     * Deactivates the interrupt state and clears all interrupts and context.
+     */
+    deactivate(): void;
+    /**
+     * Configures the interrupt state for resuming from an interrupt.
+     * Populates interrupt responses from the provided content blocks.
+     *
+     * @param responses - Array of interrupt response content blocks
+     * @throws Error if an interrupt ID is not found
+     */
+    resume(responses: InterruptResponseContent[]): void;
+    /**
+     * Gets or creates an interrupt with the given ID.
+     * If the interrupt already exists, returns it (potentially with a response).
+     * If a preemptive response is provided and the interrupt is new, the response
+     * is stored on the interrupt so it returns immediately without halting execution.
+     *
+     * @param id - Unique identifier for the interrupt
+     * @param name - User-defined name for the interrupt
+     * @param reason - Optional reason for the interrupt
+     * @param response - Optional preemptive response to skip the interrupt
+     * @param source - Where the interrupt was raised from (tool or hook callback)
+     * @returns The interrupt (may have a response if resuming or preemptive)
+     */
+    getOrCreateInterrupt(id: string, name: string, reason?: JSONValue, response?: JSONValue, source?: InterruptSource): Interrupt;
+    /**
+     * Serializes the interrupt state to a JSON-compatible object.
+     */
+    toJSON(): InterruptStateData;
+    /**
+     * Creates an InterruptState instance from a JSON object.
+     *
+     * @param data - JSON data to deserialize
+     * @returns InterruptState instance
+     */
+    static fromJSON(data: InterruptStateData): InterruptState;
+}
+/**
+ * Interface for objects that support human-in-the-loop interrupts.
+ * Implemented by hook events and tool contexts that can pause agent execution.
+ */
+export interface Interruptible {
+    interrupt<T = JSONValue>(params: InterruptParams): T;
+}
+/**
+ * Shared interrupt logic that accesses the agent's interrupt state to register or resume an interrupt.
+ *
+ * @param agent - The agent whose interrupt state to access
+ * @param interruptId - Unique identifier for this interrupt instance
+ * @param params - Interrupt parameters including name and optional reason
+ * @param source - Where the interrupt was raised from (tool callback vs hook callback)
+ * @returns The user's response when resuming from an interrupt
+ * @throws InterruptError when no response is available (first invocation)
+ *
+ * @internal
+ */
+export declare function interruptFromAgent<T>(agent: LocalAgent, interruptId: string, params: InterruptParams, source: InterruptSource): T;
+/**
+ * Interrupt-or-resume helper for multi-agent hooks where interrupts live on a per-node
+ * `Interrupt[]` list rather than on an agent's `InterruptState`. Mirrors the
+ * {@link interruptFromAgent} contract: returns the response if the interrupt already
+ * has one (resume path), otherwise records a new interrupt and throws `InterruptError`.
+ *
+ * @internal
+ */
+export declare function interruptFromMultiAgentNode<T>(interrupts: Interrupt[], interruptId: string, params: InterruptParams, source: InterruptSource): T;
+//# sourceMappingURL=interrupt.d.ts.map

package/dist/src/interrupt.d.ts.map

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

package/dist/src/interrupt.js

@@ -0,0 +1,316 @@
+/**
+ * Human-in-the-loop interrupt system for agent workflows.
+ *
+ * Interrupt Flow:
+ * 1. Hook or tool calls `event.interrupt()` or `context.interrupt()`
+ * 2. If resuming (response exists), the response is returned
+ * 3. Otherwise, agent execution halts with `stopReason: 'interrupt'`
+ * 4. User resumes by invoking agent with `interruptResponse` content blocks
+ * 5. On resume, `interrupt()` returns the user's response
+ */
+import { InterruptResponseContent } from './types/interrupt.js';
+import { Message, ToolResultBlock } from './types/messages.js';
+/**
+ * Represents an interrupt that can pause agent execution for human-in-the-loop workflows.
+ */
+export class Interrupt {
+    /**
+     * Unique identifier for this interrupt.
+     */
+    id;
+    /**
+     * User-defined name for the interrupt.
+     */
+    name;
+    /**
+     * User-provided reason for raising the interrupt.
+     */
+    reason;
+    /**
+     * Human response provided when resuming the agent after an interrupt.
+     */
+    response;
+    /**
+     * Where this interrupt was raised from — a tool callback, an agent-level hook, or
+     * a multi-agent orchestrator hook. Always populated. When deserializing a snapshot
+     * produced by an older SDK that did not record this field, defaults to `'hook'`.
+     */
+    source;
+    constructor(data) {
+        this.id = data.id;
+        this.name = data.name;
+        if (data.reason !== undefined) {
+            this.reason = data.reason;
+        }
+        if (data.response !== undefined) {
+            this.response = data.response;
+        }
+        // Default for legacy snapshots that predate the `source` field; current code
+        // paths always supply a value explicitly.
+        this.source = data.source ?? 'hook';
+    }
+    /**
+     * Serializes the interrupt to a JSON-compatible object.
+     */
+    toJSON() {
+        return {
+            id: this.id,
+            name: this.name,
+            ...(this.reason !== undefined && { reason: this.reason }),
+            ...(this.response !== undefined && { response: this.response }),
+            source: this.source,
+        };
+    }
+    /**
+     * Creates an Interrupt instance from a JSON object.
+     *
+     * @param data - JSON data to deserialize
+     * @returns Interrupt instance
+     */
+    static fromJSON(data) {
+        return new Interrupt(data);
+    }
+}
+/**
+ * Error thrown when human input is required to continue agent execution.
+ * Caught by the agent loop to trigger an interrupt stop.
+ */
+export class InterruptError extends Error {
+    /**
+     * The interrupts that caused this error.
+     */
+    interrupts;
+    constructor(interrupt) {
+        const all = Array.isArray(interrupt) ? interrupt : [interrupt];
+        const message = all.length === 1
+            ? `Interrupt raised: ${all[0].name}`
+            : `${all.length} interrupts raised: ${all.map((i) => i.name).join(', ')}`;
+        super(message);
+        this.name = 'InterruptError';
+        this.interrupts = all;
+    }
+}
+/**
+ * Tracks the state of interrupt events raised during agent execution.
+ *
+ * Interrupt state is cleared after resuming.
+ */
+export class InterruptState {
+    /** Record of interrupt IDs to Interrupt instances. */
+    interrupts;
+    /** Resume responses provided when resuming from an interrupt. */
+    resumeResponses;
+    /** Whether the agent is in an interrupted state. */
+    activated;
+    /** Pending tool execution state for resume. */
+    pendingToolExecution;
+    constructor() {
+        this.interrupts = {};
+        this.resumeResponses = undefined;
+        this.activated = false;
+        this.pendingToolExecution = undefined;
+    }
+    /**
+     * Gets the pending tool execution state with reconstructed Message and ToolResultBlock objects.
+     * Returns undefined if there is no pending execution.
+     */
+    getPendingExecution() {
+        if (!this.pendingToolExecution) {
+            return undefined;
+        }
+        const assistantMessage = Message.fromMessageData(this.pendingToolExecution.assistantMessageData);
+        const completedToolResults = new Map();
+        for (const [toolUseId, resultData] of Object.entries(this.pendingToolExecution.completedToolResults)) {
+            completedToolResults.set(toolUseId, ToolResultBlock.fromJSON(resultData));
+        }
+        return { assistantMessage, completedToolResults };
+    }
+    /**
+     * Sets the pending tool execution state.
+     */
+    setPendingToolExecution(pending) {
+        this.pendingToolExecution = pending;
+    }
+    /**
+     * Clears the pending tool execution state.
+     */
+    clearPendingToolExecution() {
+        this.pendingToolExecution = undefined;
+    }
+    /**
+     * Returns the list of interrupts as an array.
+     */
+    getInterruptsList() {
+        return Object.values(this.interrupts);
+    }
+    /**
+     * Returns all interrupts that have no response (i.e., were raised but not yet answered).
+     */
+    getUnansweredInterrupts() {
+        return Object.values(this.interrupts).filter((interrupt) => interrupt.response === undefined);
+    }
+    /**
+     * Returns the first interrupt that has no response (i.e., was raised but not yet answered).
+     */
+    getUnansweredInterrupt() {
+        for (const interrupt of Object.values(this.interrupts)) {
+            if (interrupt.response === undefined) {
+                return interrupt;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Activates the interrupt state.
+     */
+    activate() {
+        this.activated = true;
+    }
+    /**
+     * Deactivates the interrupt state and clears all interrupts and context.
+     */
+    deactivate() {
+        this.interrupts = {};
+        this.resumeResponses = undefined;
+        this.activated = false;
+        this.pendingToolExecution = undefined;
+    }
+    /**
+     * Configures the interrupt state for resuming from an interrupt.
+     * Populates interrupt responses from the provided content blocks.
+     *
+     * @param responses - Array of interrupt response content blocks
+     * @throws Error if an interrupt ID is not found
+     */
+    resume(responses) {
+        if (!this.activated) {
+            return;
+        }
+        for (const content of responses) {
+            const interruptId = content.interruptResponse.interruptId;
+            const response = content.interruptResponse.response;
+            const interrupt = this.interrupts[interruptId];
+            if (!interrupt) {
+                throw new Error(`interrupt_id=<${interruptId}> | no interrupt found`);
+            }
+            interrupt.response = response;
+        }
+        this.resumeResponses = responses;
+    }
+    /**
+     * Gets or creates an interrupt with the given ID.
+     * If the interrupt already exists, returns it (potentially with a response).
+     * If a preemptive response is provided and the interrupt is new, the response
+     * is stored on the interrupt so it returns immediately without halting execution.
+     *
+     * @param id - Unique identifier for the interrupt
+     * @param name - User-defined name for the interrupt
+     * @param reason - Optional reason for the interrupt
+     * @param response - Optional preemptive response to skip the interrupt
+     * @param source - Where the interrupt was raised from (tool or hook callback)
+     * @returns The interrupt (may have a response if resuming or preemptive)
+     */
+    getOrCreateInterrupt(id, name, reason, response, source) {
+        const existing = this.interrupts[id];
+        if (existing) {
+            return existing;
+        }
+        const interrupt = new Interrupt({
+            id,
+            name,
+            ...(reason !== undefined && { reason }),
+            ...(response !== undefined && { response }),
+            ...(source !== undefined && { source }),
+        });
+        this.interrupts[id] = interrupt;
+        return interrupt;
+    }
+    /**
+     * Serializes the interrupt state to a JSON-compatible object.
+     */
+    toJSON() {
+        const interrupts = {};
+        for (const [id, interrupt] of Object.entries(this.interrupts)) {
+            interrupts[id] = interrupt.toJSON();
+        }
+        return {
+            interrupts,
+            ...(this.resumeResponses && { resumeResponses: this.resumeResponses }),
+            activated: this.activated,
+            ...(this.pendingToolExecution && { pendingToolExecution: this.pendingToolExecution }),
+        };
+    }
+    /**
+     * Creates an InterruptState instance from a JSON object.
+     *
+     * @param data - JSON data to deserialize
+     * @returns InterruptState instance
+     */
+    static fromJSON(data) {
+        const state = new InterruptState();
+        state.activated = data.activated;
+        for (const [id, interruptData] of Object.entries(data.interrupts)) {
+            state.interrupts[id] = Interrupt.fromJSON(interruptData);
+        }
+        if (data.resumeResponses) {
+            state.resumeResponses = data.resumeResponses.map((r) => InterruptResponseContent.fromJSON(r));
+        }
+        if (data.pendingToolExecution) {
+            state.pendingToolExecution = data.pendingToolExecution;
+        }
+        return state;
+    }
+}
+/**
+ * Shared interrupt logic that accesses the agent's interrupt state to register or resume an interrupt.
+ *
+ * @param agent - The agent whose interrupt state to access
+ * @param interruptId - Unique identifier for this interrupt instance
+ * @param params - Interrupt parameters including name and optional reason
+ * @param source - Where the interrupt was raised from (tool callback vs hook callback)
+ * @returns The user's response when resuming from an interrupt
+ * @throws InterruptError when no response is available (first invocation)
+ *
+ * @internal
+ */
+export function interruptFromAgent(agent, interruptId, params, source) {
+    const interruptState = agent._interruptState;
+    if (!interruptState) {
+        throw new Error('Interrupt state not available');
+    }
+    const interrupt = interruptState.getOrCreateInterrupt(interruptId, params.name, params.reason, params.response, source);
+    if (interrupt.response !== undefined) {
+        return interrupt.response;
+    }
+    throw new InterruptError(interrupt);
+}
+/**
+ * Interrupt-or-resume helper for multi-agent hooks where interrupts live on a per-node
+ * `Interrupt[]` list rather than on an agent's `InterruptState`. Mirrors the
+ * {@link interruptFromAgent} contract: returns the response if the interrupt already
+ * has one (resume path), otherwise records a new interrupt and throws `InterruptError`.
+ *
+ * @internal
+ */
+export function interruptFromMultiAgentNode(interrupts, interruptId, params, source) {
+    const existing = interrupts.find((i) => i.id === interruptId);
+    if (existing?.response !== undefined) {
+        return existing.response;
+    }
+    const interrupt = existing ??
+        new Interrupt({
+            id: interruptId,
+            name: params.name,
+            ...(params.reason !== undefined && { reason: params.reason }),
+            ...(params.response !== undefined && { response: params.response }),
+            source,
+        });
+    if (!existing) {
+        interrupts.push(interrupt);
+        if (interrupt.response !== undefined) {
+            return interrupt.response;
+        }
+    }
+    throw new InterruptError(interrupt);
+}
+//# sourceMappingURL=interrupt.js.map

package/dist/src/interrupt.js.map

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