@strands-agents/sdk 0.0.1

package/dist/src/hooks/events.d.ts

@@ -0,0 +1,199 @@
+import type { AgentData } from '../types/agent.js';
+import type { ContentBlock, Message, ToolResultBlock } from '../types/messages.js';
+import type { Tool } from '../tools/tool.js';
+import type { JSONValue } from '../types/json.js';
+import type { ModelStreamEvent } from '../models/streaming.js';
+/**
+ * Base class for all hook events.
+ * Hook events are emitted at specific points in the agent lifecycle.
+ */
+export declare abstract class HookEvent {
+    /**
+     * @internal
+     * Check if callbacks should be reversed for this event.
+     * Used by HookRegistry for callback ordering.
+     */
+    _shouldReverseCallbacks(): boolean;
+}
+/**
+ * Event triggered at the beginning of a new agent request.
+ * Fired before any model inference or tool execution occurs.
+ */
+export declare class BeforeInvocationEvent extends HookEvent {
+    readonly type: "beforeInvocationEvent";
+    readonly agent: AgentData;
+    constructor(data: {
+        agent: AgentData;
+    });
+}
+/**
+ * Event triggered at the end of an agent request.
+ * Fired after all processing completes, regardless of success or error.
+ * Uses reverse callback ordering for proper cleanup semantics.
+ */
+export declare class AfterInvocationEvent extends HookEvent {
+    readonly type: "afterInvocationEvent";
+    readonly agent: AgentData;
+    constructor(data: {
+        agent: AgentData;
+    });
+    _shouldReverseCallbacks(): boolean;
+}
+/**
+ * Event triggered when the framework adds a message to the conversation history.
+ * Fired during the agent loop execution for framework-generated messages.
+ * Does not fire for initial messages from AgentConfig or user input messages.
+ */
+export declare class MessageAddedEvent extends HookEvent {
+    readonly type: "messageAddedEvent";
+    readonly agent: AgentData;
+    readonly message: Message;
+    constructor(data: {
+        agent: AgentData;
+        message: Message;
+    });
+}
+/**
+ * Event triggered just before a tool is executed.
+ * Fired after tool lookup but before execution begins.
+ */
+export declare class BeforeToolCallEvent extends HookEvent {
+    readonly type: "beforeToolCallEvent";
+    readonly agent: AgentData;
+    readonly toolUse: {
+        name: string;
+        toolUseId: string;
+        input: JSONValue;
+    };
+    readonly tool: Tool | undefined;
+    constructor(data: {
+        agent: AgentData;
+        toolUse: {
+            name: string;
+            toolUseId: string;
+            input: JSONValue;
+        };
+        tool: Tool | undefined;
+    });
+}
+/**
+ * Event triggered after a tool execution completes.
+ * Fired after tool execution finishes, whether successful or failed.
+ * Uses reverse callback ordering for proper cleanup semantics.
+ */
+export declare class AfterToolCallEvent extends HookEvent {
+    readonly type: "afterToolCallEvent";
+    readonly agent: AgentData;
+    readonly toolUse: {
+        name: string;
+        toolUseId: string;
+        input: JSONValue;
+    };
+    readonly tool: Tool | undefined;
+    readonly result: ToolResultBlock;
+    readonly error?: Error;
+    constructor(data: {
+        agent: AgentData;
+        toolUse: {
+            name: string;
+            toolUseId: string;
+            input: JSONValue;
+        };
+        tool: Tool | undefined;
+        result: ToolResultBlock;
+        error?: Error;
+    });
+    _shouldReverseCallbacks(): boolean;
+}
+/**
+ * Event triggered just before the model is invoked.
+ * Fired before sending messages to the model for inference.
+ */
+export declare class BeforeModelCallEvent extends HookEvent {
+    readonly type: "beforeModelCallEvent";
+    readonly agent: AgentData;
+    constructor(data: {
+        agent: AgentData;
+    });
+}
+/**
+ * Response from a model invocation containing the message and stop reason.
+ */
+export interface ModelStopData {
+    /**
+     * The message returned by the model.
+     */
+    readonly message: Message;
+    /**
+     * The reason the model stopped generating.
+     */
+    readonly stopReason: string;
+}
+/**
+ * Event triggered after the model invocation completes.
+ * Fired after the model finishes generating a response, whether successful or failed.
+ * Uses reverse callback ordering for proper cleanup semantics.
+ *
+ * Note: stopData may be undefined if an error occurs before the model completes.
+ */
+export declare class AfterModelCallEvent extends HookEvent {
+    readonly type: "afterModelCallEvent";
+    readonly agent: AgentData;
+    readonly stopData?: ModelStopData;
+    readonly error?: Error;
+    /**
+     * Optional flag that can be set by hook callbacks to request a retry of the model call.
+     * Only valid when an error is present. When set to true, the agent will retry the model invocation.
+     * Typically used after reducing context size in response to a ContextWindowOverflowError.
+     */
+    retryModelCall?: boolean;
+    constructor(data: {
+        agent: AgentData;
+        stopData?: ModelStopData;
+        error?: Error;
+    });
+    _shouldReverseCallbacks(): boolean;
+}
+/**
+ * Event triggered for each streaming event from the model.
+ * Allows hooks to observe individual streaming events during model inference.
+ * Provides read-only access to streaming events.
+ */
+export declare class ModelStreamEventHook extends HookEvent {
+    readonly type: "modelStreamEventHook";
+    readonly agent: AgentData;
+    readonly event: ModelStreamEvent | ContentBlock;
+    constructor(data: {
+        agent: AgentData;
+        event: ModelStreamEvent | ContentBlock;
+    });
+}
+/**
+ * Event triggered before executing tools.
+ * Fired when the model returns tool use blocks that need to be executed.
+ */
+export declare class BeforeToolsEvent extends HookEvent {
+    readonly type: "beforeToolsEvent";
+    readonly agent: AgentData;
+    readonly message: Message;
+    constructor(data: {
+        agent: AgentData;
+        message: Message;
+    });
+}
+/**
+ * Event triggered after all tools complete execution.
+ * Fired after tool results are collected and ready to be added to conversation.
+ * Uses reverse callback ordering for proper cleanup semantics.
+ */
+export declare class AfterToolsEvent extends HookEvent {
+    readonly type: "afterToolsEvent";
+    readonly agent: AgentData;
+    readonly message: Message;
+    constructor(data: {
+        agent: AgentData;
+        message: Message;
+    });
+    _shouldReverseCallbacks(): boolean;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/src/hooks/events.d.ts.map

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

package/dist/src/hooks/events.js

@@ -0,0 +1,191 @@
+/**
+ * Base class for all hook events.
+ * Hook events are emitted at specific points in the agent lifecycle.
+ */
+export class HookEvent {
+    /**
+     * @internal
+     * Check if callbacks should be reversed for this event.
+     * Used by HookRegistry for callback ordering.
+     */
+    _shouldReverseCallbacks() {
+        return false;
+    }
+}
+/**
+ * Event triggered at the beginning of a new agent request.
+ * Fired before any model inference or tool execution occurs.
+ */
+export class BeforeInvocationEvent extends HookEvent {
+    type = 'beforeInvocationEvent';
+    agent;
+    constructor(data) {
+        super();
+        this.agent = data.agent;
+    }
+}
+/**
+ * Event triggered at the end of an agent request.
+ * Fired after all processing completes, regardless of success or error.
+ * Uses reverse callback ordering for proper cleanup semantics.
+ */
+export class AfterInvocationEvent extends HookEvent {
+    type = 'afterInvocationEvent';
+    agent;
+    constructor(data) {
+        super();
+        this.agent = data.agent;
+    }
+    _shouldReverseCallbacks() {
+        return true;
+    }
+}
+/**
+ * Event triggered when the framework adds a message to the conversation history.
+ * Fired during the agent loop execution for framework-generated messages.
+ * Does not fire for initial messages from AgentConfig or user input messages.
+ */
+export class MessageAddedEvent extends HookEvent {
+    type = 'messageAddedEvent';
+    agent;
+    message;
+    constructor(data) {
+        super();
+        this.agent = data.agent;
+        this.message = data.message;
+    }
+}
+/**
+ * Event triggered just before a tool is executed.
+ * Fired after tool lookup but before execution begins.
+ */
+export class BeforeToolCallEvent extends HookEvent {
+    type = 'beforeToolCallEvent';
+    agent;
+    toolUse;
+    tool;
+    constructor(data) {
+        super();
+        this.agent = data.agent;
+        this.toolUse = data.toolUse;
+        this.tool = data.tool;
+    }
+}
+/**
+ * Event triggered after a tool execution completes.
+ * Fired after tool execution finishes, whether successful or failed.
+ * Uses reverse callback ordering for proper cleanup semantics.
+ */
+export class AfterToolCallEvent extends HookEvent {
+    type = 'afterToolCallEvent';
+    agent;
+    toolUse;
+    tool;
+    result;
+    error;
+    constructor(data) {
+        super();
+        this.agent = data.agent;
+        this.toolUse = data.toolUse;
+        this.tool = data.tool;
+        this.result = data.result;
+        if (data.error !== undefined) {
+            this.error = data.error;
+        }
+    }
+    _shouldReverseCallbacks() {
+        return true;
+    }
+}
+/**
+ * Event triggered just before the model is invoked.
+ * Fired before sending messages to the model for inference.
+ */
+export class BeforeModelCallEvent extends HookEvent {
+    type = 'beforeModelCallEvent';
+    agent;
+    constructor(data) {
+        super();
+        this.agent = data.agent;
+    }
+}
+/**
+ * Event triggered after the model invocation completes.
+ * Fired after the model finishes generating a response, whether successful or failed.
+ * Uses reverse callback ordering for proper cleanup semantics.
+ *
+ * Note: stopData may be undefined if an error occurs before the model completes.
+ */
+export class AfterModelCallEvent extends HookEvent {
+    type = 'afterModelCallEvent';
+    agent;
+    stopData;
+    error;
+    /**
+     * Optional flag that can be set by hook callbacks to request a retry of the model call.
+     * Only valid when an error is present. When set to true, the agent will retry the model invocation.
+     * Typically used after reducing context size in response to a ContextWindowOverflowError.
+     */
+    retryModelCall;
+    constructor(data) {
+        super();
+        this.agent = data.agent;
+        if (data.stopData !== undefined) {
+            this.stopData = data.stopData;
+        }
+        if (data.error !== undefined) {
+            this.error = data.error;
+        }
+    }
+    _shouldReverseCallbacks() {
+        return true;
+    }
+}
+/**
+ * Event triggered for each streaming event from the model.
+ * Allows hooks to observe individual streaming events during model inference.
+ * Provides read-only access to streaming events.
+ */
+export class ModelStreamEventHook extends HookEvent {
+    type = 'modelStreamEventHook';
+    agent;
+    event;
+    constructor(data) {
+        super();
+        this.agent = data.agent;
+        this.event = data.event;
+    }
+}
+/**
+ * Event triggered before executing tools.
+ * Fired when the model returns tool use blocks that need to be executed.
+ */
+export class BeforeToolsEvent extends HookEvent {
+    type = 'beforeToolsEvent';
+    agent;
+    message;
+    constructor(data) {
+        super();
+        this.agent = data.agent;
+        this.message = data.message;
+    }
+}
+/**
+ * Event triggered after all tools complete execution.
+ * Fired after tool results are collected and ready to be added to conversation.
+ * Uses reverse callback ordering for proper cleanup semantics.
+ */
+export class AfterToolsEvent extends HookEvent {
+    type = 'afterToolsEvent';
+    agent;
+    message;
+    constructor(data) {
+        super();
+        this.agent = data.agent;
+        this.message = data.message;
+    }
+    _shouldReverseCallbacks() {
+        return true;
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/src/hooks/events.js.map

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

package/dist/src/hooks/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Hooks module for event-driven extensibility.
+ *
+ * Hooks provide a composable mechanism for extending agent functionality
+ * by subscribing to events throughout the agent lifecycle.
+ */
+export { HookEvent, BeforeInvocationEvent, AfterInvocationEvent, MessageAddedEvent, BeforeToolCallEvent, AfterToolCallEvent, BeforeModelCallEvent, AfterModelCallEvent, ModelStreamEventHook, BeforeToolsEvent, AfterToolsEvent, } from './events.js';
+export type { ModelStopData as ModelStopResponse } from './events.js';
+export { HookRegistryImplementation as HookRegistry } from './registry.js';
+export type { HookCallback, HookProvider, HookEventConstructor } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,SAAS,EACT,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,GAChB,MAAM,aAAa,CAAA;AAGpB,YAAY,EAAE,aAAa,IAAI,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAGrE,OAAO,EAAE,0BAA0B,IAAI,YAAY,EAAE,MAAM,eAAe,CAAA;AAG1E,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA"}

package/dist/src/hooks/index.js

@@ -0,0 +1,11 @@
+/**
+ * Hooks module for event-driven extensibility.
+ *
+ * Hooks provide a composable mechanism for extending agent functionality
+ * by subscribing to events throughout the agent lifecycle.
+ */
+// Event classes
+export { HookEvent, BeforeInvocationEvent, AfterInvocationEvent, MessageAddedEvent, BeforeToolCallEvent, AfterToolCallEvent, BeforeModelCallEvent, AfterModelCallEvent, ModelStreamEventHook, BeforeToolsEvent, AfterToolsEvent, } from './events.js';
+// Registry
+export { HookRegistryImplementation as HookRegistry } from './registry.js';
+//# sourceMappingURL=index.js.map

package/dist/src/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,gBAAgB;AAChB,OAAO,EACL,SAAS,EACT,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,GAChB,MAAM,aAAa,CAAA;AAKpB,WAAW;AACX,OAAO,EAAE,0BAA0B,IAAI,YAAY,EAAE,MAAM,eAAe,CAAA"}

package/dist/src/hooks/registry.d.ts

@@ -0,0 +1,65 @@
+import type { HookEvent } from './events.js';
+import type { HookCallback, HookProvider, HookEventConstructor } from './types.js';
+/**
+ * Interface for hook registry operations.
+ * Enables registration of hook callbacks for event-driven extensibility.
+ */
+export interface HookRegistry {
+    /**
+     * Register a callback function for a specific event type.
+     *
+     * @param eventType - The event class constructor to register the callback for
+     * @param callback - The callback function to invoke when the event occurs
+     */
+    addCallback<T extends HookEvent>(eventType: HookEventConstructor<T>, callback: HookCallback<T>): void;
+    /**
+     * Register all callbacks from a hook provider.
+     *
+     * @param provider - The hook provider to register
+     */
+    addHook(provider: HookProvider): void;
+}
+/**
+ * Implementation of the hook registry for managing hook callbacks.
+ * Maintains mappings between event types and callback functions.
+ */
+export declare class HookRegistryImplementation implements HookRegistry {
+    private readonly _callbacks;
+    constructor();
+    /**
+     * Register a callback function for a specific event type.
+     *
+     * @param eventType - The event class constructor to register the callback for
+     * @param callback - The callback function to invoke when the event occurs
+     */
+    addCallback<T extends HookEvent>(eventType: HookEventConstructor<T>, callback: HookCallback<T>): void;
+    /**
+     * Register all callbacks from a hook provider.
+     *
+     * @param provider - The hook provider to register
+     */
+    addHook(provider: HookProvider): void;
+    /**
+     * Register all callbacks from multiple hook providers.
+     *
+     * @param providers - Array of hook providers to register
+     */
+    addAllHooks(providers: HookProvider[]): void;
+    /**
+     * Invoke all registered callbacks for the given event.
+     * Awaits each callback, supporting both sync and async.
+     *
+     * @param event - The event to invoke callbacks for
+     * @returns The event after all callbacks have been invoked
+     */
+    invokeCallbacks<T extends HookEvent>(event: T): Promise<T>;
+    /**
+     * Get callbacks for a specific event with proper ordering.
+     * Returns callbacks in reverse order if event should reverse callbacks.
+     *
+     * @param event - The event to get callbacks for
+     * @returns Array of callbacks for the event
+     */
+    private getCallbacksFor;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/src/hooks/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/hooks/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAElF;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;OAKG;IACH,WAAW,CAAC,CAAC,SAAS,SAAS,EAAE,SAAS,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;IAErG;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAA;CACtC;AAED;;;GAGG;AACH,qBAAa,0BAA2B,YAAW,YAAY;IAC7D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsD;;IAMjF;;;;;OAKG;IACH,WAAW,CAAC,CAAC,SAAS,SAAS,EAAE,SAAS,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAMrG;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAIrC;;;;OAIG;IACH,WAAW,CAAC,SAAS,EAAE,YAAY,EAAE,GAAG,IAAI;IAM5C;;;;;;OAMG;IACG,eAAe,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAQhE;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;CAIxB"}

package/dist/src/hooks/registry.js

@@ -0,0 +1,65 @@
+/**
+ * Implementation of the hook registry for managing hook callbacks.
+ * Maintains mappings between event types and callback functions.
+ */
+export class HookRegistryImplementation {
+    _callbacks;
+    constructor() {
+        this._callbacks = new Map();
+    }
+    /**
+     * Register a callback function for a specific event type.
+     *
+     * @param eventType - The event class constructor to register the callback for
+     * @param callback - The callback function to invoke when the event occurs
+     */
+    addCallback(eventType, callback) {
+        const callbacks = this._callbacks.get(eventType) ?? [];
+        callbacks.push(callback);
+        this._callbacks.set(eventType, callbacks);
+    }
+    /**
+     * Register all callbacks from a hook provider.
+     *
+     * @param provider - The hook provider to register
+     */
+    addHook(provider) {
+        provider.registerCallbacks(this);
+    }
+    /**
+     * Register all callbacks from multiple hook providers.
+     *
+     * @param providers - Array of hook providers to register
+     */
+    addAllHooks(providers) {
+        for (const provider of providers) {
+            this.addHook(provider);
+        }
+    }
+    /**
+     * Invoke all registered callbacks for the given event.
+     * Awaits each callback, supporting both sync and async.
+     *
+     * @param event - The event to invoke callbacks for
+     * @returns The event after all callbacks have been invoked
+     */
+    async invokeCallbacks(event) {
+        const callbacks = this.getCallbacksFor(event);
+        for (const callback of callbacks) {
+            await callback(event);
+        }
+        return event;
+    }
+    /**
+     * Get callbacks for a specific event with proper ordering.
+     * Returns callbacks in reverse order if event should reverse callbacks.
+     *
+     * @param event - The event to get callbacks for
+     * @returns Array of callbacks for the event
+     */
+    getCallbacksFor(event) {
+        const callbacks = this._callbacks.get(event.constructor) ?? [];
+        return (event._shouldReverseCallbacks() ? [...callbacks].reverse() : callbacks);
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/src/hooks/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/hooks/registry.ts"],"names":[],"mappings":"AAwBA;;;GAGG;AACH,MAAM,OAAO,0BAA0B;IACpB,UAAU,CAAsD;IAEjF;QACE,IAAI,CAAC,UAAU,GAAG,IAAI,GAAG,EAAE,CAAA;IAC7B,CAAC;IAED;;;;;OAKG;IACH,WAAW,CAAsB,SAAkC,EAAE,QAAyB;QAC5F,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAA;QACtD,SAAS,CAAC,IAAI,CAAC,QAAmC,CAAC,CAAA;QACnD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;IAC3C,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,QAAsB;QAC5B,QAAQ,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAA;IAClC,CAAC;IAED;;;;OAIG;IACH,WAAW,CAAC,SAAyB;QACnC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QACxB,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,eAAe,CAAsB,KAAQ;QACjD,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAA;QAC7C,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAA;QACvB,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC;IAED;;;;;;OAMG;IACK,eAAe,CAAsB,KAAQ;QACnD,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,WAAsC,CAAC,IAAI,EAAE,CAAA;QACzF,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,CAAsB,CAAA;IACtG,CAAC;CACF"}

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

@@ -0,0 +1,49 @@
+import type { HookEvent } from './events.js';
+import type { HookRegistry } from './registry.js';
+/**
+ * Type for a constructor function that creates HookEvent instances.
+ */
+export type HookEventConstructor<T extends HookEvent = HookEvent> = new (...args: any[]) => T;
+/**
+ * Type for callback functions that handle hook events.
+ * Callbacks can be synchronous or asynchronous.
+ *
+ * @example
+ * ```typescript
+ * const callback: HookCallback<BeforeInvocationEvent> = (event) => {
+ *   console.log('Agent invocation started')
+ * }
+ * ```
+ */
+export type HookCallback<T extends HookEvent> = (event: T) => void | Promise<void>;
+/**
+ * Protocol for objects that provide hook callbacks to an agent.
+ * Enables composable extension of agent functionality.
+ *
+ * @example
+ * ```typescript
+ * class MyHooks implements HookProvider {
+ *   registerCallbacks(registry: HookRegistry): void {
+ *     registry.addCallback(BeforeInvocationEvent, this.onStart)
+ *     registry.addCallback(AfterInvocationEvent, this.onEnd)
+ *   }
+ *
+ *   private onStart = (event: BeforeInvocationEvent): void => {
+ *     console.log('Agent started')
+ *   }
+ *
+ *   private onEnd = (event: AfterInvocationEvent): void => {
+ *     console.log('Agent completed')
+ *   }
+ * }
+ * ```
+ */
+export interface HookProvider {
+    /**
+     * Register callback functions for specific event types.
+     *
+     * @param registry - The hook registry to register callbacks with
+     */
+    registerCallbacks(registry: HookRegistry): void;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/hooks/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAEjD;;GAEG;AAEH,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;AAE7F;;;;;;;;;;GAUG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,SAAS,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAElF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,iBAAiB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAA;CAChD"}

package/dist/src/hooks/types.js

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

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

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

package/dist/src/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Main entry point for the Strands Agents TypeScript SDK.
+ *
+ * This is the primary export module for the SDK, providing access to all
+ * public APIs and functionality.
+ */
+export { Agent } from './agent/agent.js';
+export type { AgentState } from './agent/state.js';
+export type { AgentData } from './types/agent.js';
+export { AgentResult } from './types/agent.js';
+export type { AgentConfig, ToolList } from './agent/agent.js';
+export { ContextWindowOverflowError, MaxTokensError, JsonValidationError, ConcurrentInvocationError } from './errors.js';
+export type { JSONSchema, JSONValue } from './types/json.js';
+export type { Role, StopReason, TextBlockData, ToolUseBlockData, ToolResultBlockData, ReasoningBlockData, CachePointBlockData, GuardContentBlockData, GuardContentText, GuardContentImage, GuardQualifier, GuardImageFormat, GuardImageSource, ContentBlock, ContentBlockData, MessageData, SystemPrompt, SystemPromptData, SystemContentBlock, ToolResultContent, } from './types/messages.js';
+export { TextBlock, ToolUseBlock, ToolResultBlock, ReasoningBlock, CachePointBlock, GuardContentBlock, Message, JsonBlock, } from './types/messages.js';
+export { S3Location, ImageBlock, VideoBlock, DocumentBlock } from './types/media.js';
+export type { S3LocationData, ImageFormat, ImageSource, ImageSourceData, ImageBlockData, VideoFormat, VideoSource, VideoSourceData, VideoBlockData, DocumentFormat, DocumentSource, DocumentSourceData, DocumentBlockData, DocumentContentBlock, DocumentContentBlockData, } from './types/media.js';
+export type { ToolSpec, ToolUse, ToolResultStatus, ToolChoice } from './tools/types.js';
+export type { Tool, InvokableTool, ToolContext, ToolStreamEventData, ToolStreamEvent, ToolStreamGenerator, } from './tools/tool.js';
+export { FunctionTool } from './tools/function-tool.js';
+export { tool } from './tools/zod-tool.js';
+export type { Usage, Metrics, ModelMessageStartEventData, ModelMessageStartEvent, ToolUseStart, ContentBlockStart, ModelContentBlockStartEventData, ModelContentBlockStartEvent, TextDelta, ToolUseInputDelta, ReasoningContentDelta, ContentBlockDelta, ModelContentBlockDeltaEventData, ModelContentBlockDeltaEvent, ModelContentBlockStopEvent, ModelMessageStopEventData, ModelMessageStopEvent, ModelMetadataEventData, ModelMetadataEvent, ModelStreamEvent, } from './models/streaming.js';
+export type { BaseModelConfig, StreamOptions, Model } from './models/model.js';
+export { BedrockModel as BedrockModel } from './models/bedrock.js';
+export type { BedrockModelConfig, BedrockModelOptions } from './models/bedrock.js';
+export type { AgentStreamEvent } from './types/agent.js';
+export { HookRegistry, HookEvent, BeforeInvocationEvent, AfterInvocationEvent, MessageAddedEvent, BeforeToolCallEvent, AfterToolCallEvent, BeforeModelCallEvent, AfterModelCallEvent, BeforeToolsEvent, AfterToolsEvent, ModelStreamEventHook, } from './hooks/index.js';
+export type { HookCallback, HookProvider, HookEventConstructor, ModelStopResponse } from './hooks/index.js';
+export { NullConversationManager } from './conversation-manager/null-conversation-manager.js';
+export { SlidingWindowConversationManager, type SlidingWindowConversationManagerConfig, } from './conversation-manager/sliding-window-conversation-manager.js';
+export { type McpClientConfig, McpClient } from './mcp.js';
+//# sourceMappingURL=index.d.ts.map