@strands-agents/sdk 1.10.0 → 1.11.1

package/dist/src/tools/executors/executor.js

@@ -0,0 +1,193 @@
+import { normalizeError } from '../../errors.js';
+import { AfterToolCallEvent, BeforeToolCallEvent, ToolStreamUpdateEvent } from '../../hooks/events.js';
+import { InterruptError, interruptFromAgent } from '../../interrupt.js';
+import { createMiddlewareInterrupt } from '../../middleware/interrupt.js';
+import { ExecuteToolStage } from '../../middleware/index.js';
+import { deepCopy } from '../../types/json.js';
+import { TextBlock, ToolResultBlock } from '../../types/messages.js';
+/**
+ * Shared pipeline for executing tool calls.
+ *
+ * @internal
+ */
+export class ToolExecutor {
+    // Tool lookup and tool-body failures become ToolResultBlocks so the model can
+    // respond to them; lifecycle and middleware failures may still propagate.
+    async *executeTool(options, toolUseBlock, invocationState) {
+        const registryTool = options.agent.toolRegistry.get(toolUseBlock.name);
+        // Callbacks may replace or mutate this value inside BeforeToolCallEvent.
+        let toolUse = {
+            name: toolUseBlock.name,
+            toolUseId: toolUseBlock.toolUseId,
+            input: toolUseBlock.input,
+        };
+        while (true) {
+            const beforeToolCallEvent = new BeforeToolCallEvent({
+                agent: options.agent,
+                toolUse,
+                tool: registryTool,
+                invocationState,
+            });
+            yield beforeToolCallEvent;
+            toolUse = {
+                ...beforeToolCallEvent.toolUse,
+                toolUseId: toolUseBlock.toolUseId,
+            };
+            // selectedTool takes precedence over resolving a hook-renamed toolUse;
+            // otherwise retain the original registry lookup. Resolve before cancellation
+            // so AfterToolCallEvent reports the same effective tool on every path.
+            const effectiveTool = beforeToolCallEvent.selectedTool ??
+                (toolUse.name !== toolUseBlock.name ? options.agent.toolRegistry.get(toolUse.name) : registryTool);
+            if (beforeToolCallEvent.cancel) {
+                const cancelMessage = typeof beforeToolCallEvent.cancel === 'string' ? beforeToolCallEvent.cancel : 'Tool cancelled by hook';
+                const cancelResult = new ToolResultBlock({
+                    toolUseId: toolUse.toolUseId,
+                    status: 'error',
+                    content: [new TextBlock(cancelMessage)],
+                });
+                const afterToolCallEvent = new AfterToolCallEvent({
+                    agent: options.agent,
+                    toolUse,
+                    tool: effectiveTool,
+                    result: cancelResult,
+                    invocationState,
+                });
+                yield afterToolCallEvent;
+                if (this._shouldRetry(options.agent, afterToolCallEvent)) {
+                    continue;
+                }
+                return this._normalizeToolResultId(afterToolCallEvent.result, toolUseBlock.toolUseId);
+            }
+            const toolResult = this._normalizeToolResultId(yield* this._executeToolWithMiddleware(options, effectiveTool, toolUse, invocationState), toolUseBlock.toolUseId);
+            const error = toolResult.error;
+            const afterToolCallEvent = new AfterToolCallEvent({
+                agent: options.agent,
+                toolUse,
+                tool: effectiveTool,
+                result: toolResult,
+                invocationState,
+                ...(error !== undefined && { error }),
+            });
+            yield afterToolCallEvent;
+            if (this._shouldRetry(options.agent, afterToolCallEvent)) {
+                continue;
+            }
+            // Return the hook-transformed result so downstream events and the model
+            // observe the same value.
+            return this._normalizeToolResultId(afterToolCallEvent.result, toolUseBlock.toolUseId);
+        }
+    }
+    _shouldRetry(agent, afterToolCallEvent) {
+        return afterToolCallEvent.retry === true && !agent.cancelSignal.aborted;
+    }
+    _normalizeToolResultId(result, toolUseId) {
+        if (result.toolUseId === toolUseId) {
+            return result;
+        }
+        return new ToolResultBlock({
+            toolUseId,
+            status: result.status,
+            content: result.content,
+            ...(result.error !== undefined && { error: result.error }),
+        });
+    }
+    // Keys and serialized results use model-issued toolUseIds so resume and
+    // provider correlation match the assistant's tool-use blocks.
+    _storePendingToolExecution(options, assistantMessage, completedToolResults) {
+        const serializedResults = {};
+        for (const [toolUseId, result] of completedToolResults) {
+            serializedResults[toolUseId] = result.toJSON();
+        }
+        options.agent._interruptState.setPendingToolExecution({
+            assistantMessageData: assistantMessage.toJSON(),
+            completedToolResults: serializedResults,
+        });
+    }
+    async *_executeToolWithMiddleware(options, tool, toolUse, invocationState) {
+        const context = {
+            agent: options.agent,
+            tool,
+            toolUse: deepCopy(toolUse),
+            invocationState,
+            interrupt: createMiddlewareInterrupt(options.agent._interruptState, `middleware:executeTool:${toolUse.toolUseId}`),
+        };
+        // async function* does not bind lexical `this`; capture the executor for the terminal callback.
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        const executor = this;
+        const middlewareResult = yield* options.middlewareRegistry.invoke(ExecuteToolStage, context, async function* (middlewareContext) {
+            const result = yield* executor._executeToolCore(options, middlewareContext.tool, middlewareContext.toolUse, middlewareContext.invocationState);
+            return { result };
+        });
+        return middlewareResult.result;
+    }
+    async *_executeToolCore(options, effectiveTool, toolUse, invocationState) {
+        const toolSpan = options.tracer.startToolCallSpan({ tool: toolUse });
+        const toolStartTime = Date.now();
+        let toolResult;
+        let error;
+        try {
+            if (!effectiveTool) {
+                toolResult = new ToolResultBlock({
+                    toolUseId: toolUse.toolUseId,
+                    status: 'error',
+                    content: [new TextBlock(`Tool '${toolUse.name}' not found in registry`)],
+                });
+            }
+            else {
+                const toolContext = {
+                    toolUse: {
+                        name: toolUse.name,
+                        toolUseId: toolUse.toolUseId,
+                        input: toolUse.input,
+                    },
+                    agent: options.agent,
+                    invocationState,
+                    interrupt: (params) => interruptFromAgent(options.agent, `tool:${toolUse.toolUseId}:${params.name}`, params, 'tool'),
+                };
+                // Iterate manually to wrap raw tool events at the agent boundary and
+                // re-enter the tool span for every asynchronous step.
+                const toolGenerator = options.tracer.withSpanContext(toolSpan, () => effectiveTool.stream(toolContext));
+                let toolNext = await options.tracer.withSpanContext(toolSpan, () => toolGenerator.next());
+                while (!toolNext.done) {
+                    yield new ToolStreamUpdateEvent({ agent: options.agent, event: toolNext.value, invocationState });
+                    toolNext = await options.tracer.withSpanContext(toolSpan, () => toolGenerator.next());
+                }
+                toolResult =
+                    toolNext.value ??
+                        new ToolResultBlock({
+                            toolUseId: toolUse.toolUseId,
+                            status: 'error',
+                            content: [new TextBlock(`Tool '${toolUse.name}' did not return a result`)],
+                        });
+                error = toolNext.value?.error;
+            }
+            return toolResult;
+        }
+        catch (caughtError) {
+            if (caughtError instanceof InterruptError) {
+                throw caughtError;
+            }
+            error = normalizeError(caughtError);
+            toolResult = new ToolResultBlock({
+                toolUseId: toolUse.toolUseId,
+                status: 'error',
+                content: [new TextBlock(error.message)],
+                error,
+            });
+            return toolResult;
+        }
+        finally {
+            // Record the raw execution outcome before AfterToolCallEvent can transform it.
+            options.tracer.endToolCallSpan(toolSpan, {
+                ...(toolResult !== undefined && { toolResult }),
+                ...(error !== undefined && { error }),
+            });
+            options.meter.endToolCall({
+                tool: toolUse,
+                duration: Date.now() - toolStartTime,
+                success: toolResult?.status === 'success',
+            });
+        }
+    }
+}
+//# sourceMappingURL=executor.js.map

package/dist/src/tools/executors/executor.js.map

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

package/dist/src/tools/executors/sequential.d.ts

@@ -0,0 +1,30 @@
+import { ToolExecutor } from './executor.js';
+import type { AgentStreamEvent } from '../../types/agent.js';
+import type { ToolExecutionInput, ToolExecutorOptions } from './executor.js';
+/**
+ * Executes tool calls one at a time.
+ *
+ * @example
+ * ```typescript
+ * import { Agent, SequentialToolExecutor } from '@strands-agents/sdk'
+ *
+ * // The string shorthand keeps imports minimal.
+ * const agent = new Agent({ toolExecutor: 'sequential' })
+ *
+ * // Passing an instance is equivalent if you prefer to be explicit.
+ * const explicitAgent = new Agent({ toolExecutor: new SequentialToolExecutor() })
+ * ```
+ */
+export declare class SequentialToolExecutor extends ToolExecutor {
+    /**
+     * Executes tool calls in source order, honoring `agent.cancelSignal` between
+     * calls to short-circuit tools that have not started.
+     *
+     * @param options - Agent dependencies used to execute tools
+     * @param input - Tool calls and invocation state
+     * @returns Stream of tool lifecycle events
+     * @internal
+     */
+    execute(options: ToolExecutorOptions, input: ToolExecutionInput): AsyncGenerator<AgentStreamEvent, void, undefined>;
+}
+//# sourceMappingURL=sequential.d.ts.map

package/dist/src/tools/executors/sequential.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequential.d.ts","sourceRoot":"","sources":["../../../../src/tools/executors/sequential.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAE5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAE5E;;;;;;;;;;;;;GAaG;AACH,qBAAa,sBAAuB,SAAQ,YAAY;IACtD;;;;;;;;OAQG;IACa,OAAO,CACrB,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,kBAAkB,GACxB,cAAc,CAAC,gBAAgB,EAAE,IAAI,EAAE,SAAS,CAAC;CAwCrD"}

package/dist/src/tools/executors/sequential.js

@@ -0,0 +1,67 @@
+import { ToolResultEvent } from '../../hooks/events.js';
+import { InterruptError } from '../../interrupt.js';
+import { TextBlock, ToolResultBlock } from '../../types/messages.js';
+import { ToolExecutor } from './executor.js';
+/**
+ * Executes tool calls one at a time.
+ *
+ * @example
+ * ```typescript
+ * import { Agent, SequentialToolExecutor } from '@strands-agents/sdk'
+ *
+ * // The string shorthand keeps imports minimal.
+ * const agent = new Agent({ toolExecutor: 'sequential' })
+ *
+ * // Passing an instance is equivalent if you prefer to be explicit.
+ * const explicitAgent = new Agent({ toolExecutor: new SequentialToolExecutor() })
+ * ```
+ */
+export class SequentialToolExecutor extends ToolExecutor {
+    /**
+     * Executes tool calls in source order, honoring `agent.cancelSignal` between
+     * calls to short-circuit tools that have not started.
+     *
+     * @param options - Agent dependencies used to execute tools
+     * @param input - Tool calls and invocation state
+     * @returns Stream of tool lifecycle events
+     * @internal
+     */
+    async *execute(options, input) {
+        const { toolUseBlocks, toolResultBlocks, invocationState, assistantMessage, completedToolResults } = input;
+        // Keyed by the model-issued toolUseId so interrupt state matches the
+        // model's tool-use blocks.
+        const resultsByToolUseId = new Map(completedToolResults);
+        for (const toolUseBlock of toolUseBlocks) {
+            const completedResult = completedToolResults?.get(toolUseBlock.toolUseId);
+            if (completedResult) {
+                // Resume results belong in the final message without replaying lifecycle events.
+                toolResultBlocks.push(completedResult);
+                continue;
+            }
+            if (options.agent.cancelSignal.aborted) {
+                const cancelBlock = new ToolResultBlock({
+                    toolUseId: toolUseBlock.toolUseId,
+                    status: 'error',
+                    content: [new TextBlock('Tool execution cancelled')],
+                });
+                toolResultBlocks.push(cancelBlock);
+                resultsByToolUseId.set(toolUseBlock.toolUseId, cancelBlock);
+                yield new ToolResultEvent({ agent: options.agent, result: cancelBlock, invocationState });
+                continue;
+            }
+            try {
+                const toolResultBlock = yield* this.executeTool(options, toolUseBlock, invocationState);
+                toolResultBlocks.push(toolResultBlock);
+                resultsByToolUseId.set(toolUseBlock.toolUseId, toolResultBlock);
+                yield new ToolResultEvent({ agent: options.agent, result: toolResultBlock, invocationState });
+            }
+            catch (error) {
+                if (error instanceof InterruptError) {
+                    this._storePendingToolExecution(options, assistantMessage, resultsByToolUseId);
+                }
+                throw error;
+            }
+        }
+    }
+}
+//# sourceMappingURL=sequential.js.map

package/dist/src/tools/executors/sequential.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequential.js","sourceRoot":"","sources":["../../../../src/tools/executors/sequential.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAK5C;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,sBAAuB,SAAQ,YAAY;IACtD;;;;;;;;OAQG;IACM,KAAK,CAAC,CAAC,OAAO,CACrB,OAA4B,EAC5B,KAAyB;QAEzB,MAAM,EAAE,aAAa,EAAE,gBAAgB,EAAE,eAAe,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,GAAG,KAAK,CAAA;QAE1G,qEAAqE;QACrE,2BAA2B;QAC3B,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAA0B,oBAAoB,CAAC,CAAA;QAEjF,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;YACzC,MAAM,eAAe,GAAG,oBAAoB,EAAE,GAAG,CAAC,YAAY,CAAC,SAAS,CAAC,CAAA;YACzE,IAAI,eAAe,EAAE,CAAC;gBACpB,iFAAiF;gBACjF,gBAAgB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;gBACtC,SAAQ;YACV,CAAC;YAED,IAAI,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;gBACvC,MAAM,WAAW,GAAG,IAAI,eAAe,CAAC;oBACtC,SAAS,EAAE,YAAY,CAAC,SAAS;oBACjC,MAAM,EAAE,OAAO;oBACf,OAAO,EAAE,CAAC,IAAI,SAAS,CAAC,0BAA0B,CAAC,CAAC;iBACrD,CAAC,CAAA;gBACF,gBAAgB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;gBAClC,kBAAkB,CAAC,GAAG,CAAC,YAAY,CAAC,SAAS,EAAE,WAAW,CAAC,CAAA;gBAC3D,MAAM,IAAI,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC,CAAA;gBACzF,SAAQ;YACV,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,eAAe,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,eAAe,CAAC,CAAA;gBACvF,gBAAgB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;gBACtC,kBAAkB,CAAC,GAAG,CAAC,YAAY,CAAC,SAAS,EAAE,eAAe,CAAC,CAAA;gBAC/D,MAAM,IAAI,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,eAAe,EAAE,CAAC,CAAA;YAC/F,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;oBACpC,IAAI,CAAC,0BAA0B,CAAC,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,CAAC,CAAA;gBAChF,CAAC;gBACD,MAAM,KAAK,CAAA;YACb,CAAC;QACH,CAAC;IACH,CAAC;CACF"}