@strands-agents/sdk 0.5.0 → 0.7.0

package/dist/src/multiagent/swarm.js

@@ -0,0 +1,256 @@
+import { logger } from '../logging/logger.js';
+import { z } from 'zod';
+import { HookableEvent } from '../hooks/events.js';
+import { HookRegistryImplementation } from '../hooks/registry.js';
+import { MultiAgentPluginRegistry } from './plugins.js';
+import { TextBlock } from '../types/messages.js';
+import { AgentNode } from './nodes.js';
+import { MultiAgentState, MultiAgentResult, NodeResult, Status } from './state.js';
+import { AfterMultiAgentInvocationEvent, AfterNodeCallEvent, BeforeMultiAgentInvocationEvent, BeforeNodeCallEvent, MultiAgentHandoffEvent, MultiAgentInitializedEvent, MultiAgentResultEvent, NodeCancelEvent, } from './events.js';
+/**
+ * Swarm multi-agent orchestration pattern.
+ *
+ * Agents execute sequentially, each deciding whether to hand off to another agent or
+ * produce a final response. Routing is driven by structured output: each agent receives
+ * a Zod schema with `agentId`, `message`, and optional `context` fields. When `agentId`
+ * is present, the swarm hands off to that agent with `message` as input. When omitted,
+ * `message` becomes the final response.
+ *
+ * Key design choices vs the Python SDK:
+ * - Handoffs use structured output rather than an injected `handoff_to_agent` tool.
+ *   Routing logic stays in the orchestrator, not inside tool callbacks.
+ * - Context is passed as serialized JSON text blocks rather than a mutable SharedContext.
+ * - A single `maxSteps` limit replaces Python's separate `max_handoffs`/`max_iterations`.
+ * - Agent descriptions are embedded in the structured output schema for routing decisions.
+ * - Exceeding `maxSteps` throws an exception. Python returns a FAILED result.
+ *
+ * @example
+ * ```typescript
+ * const swarm = new Swarm({
+ *   nodes: [researcher, writer],
+ *   start: 'researcher',
+ *   maxSteps: 10,
+ * })
+ *
+ * const result = await swarm.invoke('Explain quantum computing')
+ * ```
+ */
+export class Swarm {
+    id;
+    nodes;
+    config;
+    _pluginRegistry;
+    _hookRegistry;
+    start;
+    _handoffSchema;
+    _initialized;
+    constructor(options) {
+        const { id, nodes, start, plugins, ...config } = options;
+        this.id = id ?? 'swarm';
+        this.config = {
+            maxSteps: config.maxSteps ?? Infinity,
+        };
+        this._validateConfig();
+        this.nodes = this._resolveNodes(nodes);
+        this.start = this._resolveStart(start);
+        this._handoffSchema = this._buildHandoffSchema();
+        this._hookRegistry = new HookRegistryImplementation();
+        this._pluginRegistry = new MultiAgentPluginRegistry(plugins);
+        this._initialized = false;
+    }
+    /**
+     * Initialize the swarm. Invokes the {@link MultiAgentInitializedEvent} callback.
+     * Called automatically on first invocation.
+     */
+    async initialize() {
+        if (this._initialized)
+            return;
+        await this._pluginRegistry.initialize(this);
+        await this._hookRegistry.invokeCallbacks(new MultiAgentInitializedEvent({ orchestrator: this }));
+        this._initialized = true;
+    }
+    /**
+     * Register a hook callback for a specific swarm event type.
+     *
+     * @param eventType - The event class constructor to register the callback for
+     * @param callback - The callback function to invoke when the event occurs
+     * @returns Cleanup function that removes the callback when invoked
+     */
+    addHook(eventType, callback) {
+        return this._hookRegistry.addCallback(eventType, callback);
+    }
+    /**
+     * Invoke swarm and return final result (consumes stream).
+     *
+     * @param input - The input to pass to the start agent
+     * @returns Promise resolving to the final MultiAgentResult
+     */
+    async invoke(input) {
+        const gen = this.stream(input);
+        let next = await gen.next();
+        while (!next.done) {
+            next = await gen.next();
+        }
+        return next.value;
+    }
+    /**
+     * Stream swarm execution, yielding events as agents execute.
+     * Invokes hook callbacks for each event before yielding.
+     *
+     * @param input - The input to pass to the start agent
+     * @returns Async generator yielding streaming events and returning a MultiAgentResult
+     */
+    async *stream(input) {
+        await this.initialize();
+        const gen = this._stream(input);
+        let next = await gen.next();
+        while (!next.done) {
+            if (next.value instanceof HookableEvent) {
+                await this._hookRegistry.invokeCallbacks(next.value);
+            }
+            yield next.value;
+            next = await gen.next();
+        }
+        return next.value;
+    }
+    async *_stream(input) {
+        const state = new MultiAgentState({
+            nodeIds: [...this.nodes.keys()],
+            structuredOutputSchema: this._handoffSchema,
+        });
+        yield new BeforeMultiAgentInvocationEvent({ orchestrator: this, state });
+        let node = this.start;
+        let handoff;
+        try {
+            while (state.steps < this.config.maxSteps) {
+                state.steps++;
+                // Execute current node
+                const result = yield* this._streamNode(node, input, state, handoff);
+                handoff = result.structuredOutput;
+                state.results.push(result);
+                // Check for terminal conditions
+                if (result.status === Status.FAILED || !handoff?.agentId) {
+                    break;
+                }
+                // Hand off to next agent
+                const target = this.nodes.get(handoff.agentId);
+                yield new MultiAgentHandoffEvent({ source: node.id, targets: [target.id], state });
+                logger.debug(`source=<${node.id}>, target=<${target.id}> | swarm handoff`);
+                node = target;
+            }
+            this._checkSteps(state);
+        }
+        finally {
+            yield new AfterMultiAgentInvocationEvent({ orchestrator: this, state });
+        }
+        const result = new MultiAgentResult({
+            results: state.results,
+            content: this._resolveContent(state),
+            duration: Date.now() - state.startTime,
+        });
+        yield new MultiAgentResultEvent({ result });
+        return result;
+    }
+    async *_streamNode(node, input, state, handoff) {
+        const nodeState = state.node(node.id);
+        const beforeEvent = new BeforeNodeCallEvent({ orchestrator: this, state, nodeId: node.id });
+        yield beforeEvent;
+        if (beforeEvent.cancel) {
+            const message = typeof beforeEvent.cancel === 'string' ? beforeEvent.cancel : 'node cancelled by hook';
+            const result = new NodeResult({ nodeId: node.id, status: Status.CANCELLED, duration: 0 });
+            nodeState.status = Status.CANCELLED;
+            nodeState.results.push(result);
+            yield new NodeCancelEvent({ nodeId: node.id, state, message });
+            yield new AfterNodeCallEvent({ orchestrator: this, state, nodeId: node.id });
+            return result;
+        }
+        const nodeInput = this._resolveNodeInput(input, handoff);
+        try {
+            const gen = node.stream(nodeInput, state);
+            let next = await gen.next();
+            while (!next.done) {
+                yield next.value;
+                next = await gen.next();
+            }
+            yield new AfterNodeCallEvent({ orchestrator: this, state, nodeId: node.id });
+            return next.value;
+        }
+        catch (error) {
+            yield new AfterNodeCallEvent({
+                orchestrator: this,
+                state,
+                nodeId: node.id,
+                error: error instanceof Error ? error : new Error(String(error)),
+            });
+            throw error;
+        }
+    }
+    _validateConfig() {
+        if (this.config.maxSteps < 1) {
+            throw new Error(`max_steps=<${this.config.maxSteps}> | must be at least 1`);
+        }
+    }
+    _resolveNodes(definitions) {
+        if (definitions.length === 0) {
+            throw new Error('nodes list is empty');
+        }
+        const nodes = new Map();
+        for (const definition of definitions) {
+            const node = 'agent' in definition ? new AgentNode(definition) : new AgentNode({ agent: definition });
+            if (nodes.has(node.id)) {
+                throw new Error(`agent_id=<${node.id}> | duplicate agent id`);
+            }
+            nodes.set(node.id, node);
+        }
+        return nodes;
+    }
+    _resolveStart(start) {
+        if (start === undefined) {
+            return this.nodes.values().next().value;
+        }
+        const node = this.nodes.get(start);
+        if (!node) {
+            throw new Error(`start=<${start}> | start references unknown agent`);
+        }
+        return node;
+    }
+    _resolveContent(state) {
+        const last = state.results[state.results.length - 1];
+        state.node(last.nodeId).terminus = true;
+        return [...last.content];
+    }
+    _resolveNodeInput(input, handoff) {
+        if (!handoff)
+            return input;
+        const blocks = [new TextBlock(handoff.message)];
+        if (handoff.context) {
+            blocks.push(new TextBlock('Context:\n' + JSON.stringify(handoff.context, null, 2)));
+        }
+        return blocks;
+    }
+    _checkSteps(state) {
+        if (state.steps >= this.config.maxSteps) {
+            throw new Error(`max_steps=<${this.config.maxSteps}> | swarm reached step limit`);
+        }
+    }
+    _buildHandoffSchema() {
+        const agentIds = [...this.nodes.keys()];
+        const agentDescriptions = agentIds
+            .map((id) => {
+            const desc = this.nodes.get(id).config.description;
+            return desc ? `- ${id}: ${desc}` : `- ${id}`;
+        })
+            .join('\n');
+        return z
+            .object({
+            agentId: z
+                .enum(agentIds)
+                .optional()
+                .describe(`Target agent to hand off to. Omit to end the conversation.\n\nAvailable agents:\n${agentDescriptions}`),
+            message: z.string().describe('Instructions for the next agent, or the final response if no handoff.'),
+            context: z.record(z.string(), z.unknown()).optional().describe('Structured data to pass to the next agent.'),
+        })
+            .describe('Decide whether to hand off to another agent or produce a final response.');
+    }
+}
+//# sourceMappingURL=swarm.js.map

package/dist/src/multiagent/swarm.js.map

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

package/dist/src/plugins/__tests__/plugin.test.d.ts

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

package/dist/src/plugins/__tests__/plugin.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.test.d.ts","sourceRoot":"","sources":["../../../../src/plugins/__tests__/plugin.test.ts"],"names":[],"mappings":""}

package/dist/src/plugins/__tests__/plugin.test.js

@@ -0,0 +1,114 @@
+import { describe, it, expect } from 'vitest';
+import { BeforeInvocationEvent } from '../../hooks/events.js';
+import { ToolRegistry } from '../../registry/tool-registry.js';
+import { createRandomTool } from '../../__fixtures__/tool-helpers.js';
+/**
+ * Concrete implementation of Plugin for testing purposes.
+ */
+class TestPlugin {
+    callbacks = [];
+    get name() {
+        return 'test-plugin';
+    }
+    initAgent(agent) {
+        agent.addHook(BeforeInvocationEvent, () => {
+            // No-op for testing
+        });
+    }
+}
+/**
+ * Plugin with custom name for testing.
+ */
+class CustomNamePlugin {
+    _name;
+    constructor(name) {
+        this._name = name;
+    }
+    get name() {
+        return this._name;
+    }
+    initAgent(_agent) { }
+}
+/**
+ * Plugin with initAgent implementation for testing.
+ */
+class InitializablePlugin {
+    initialized = false;
+    get name() {
+        return 'initializable-plugin';
+    }
+    initAgent(_agent) {
+        this.initialized = true;
+    }
+}
+describe('Plugin', () => {
+    describe('name', () => {
+        it('returns the plugin name', () => {
+            const plugin = new TestPlugin();
+            expect(plugin.name).toBe('test-plugin');
+        });
+        it('supports custom names via constructor', () => {
+            const plugin = new CustomNamePlugin('my-custom-plugin');
+            expect(plugin.name).toBe('my-custom-plugin');
+        });
+    });
+    describe('initAgent', () => {
+        it('registers callbacks via agent.addHook', () => {
+            const plugin = new TestPlugin();
+            const callbacks = [];
+            const mockAgent = {
+                addHook: (eventType, callback) => {
+                    callbacks.push({
+                        eventType: eventType,
+                        callback: callback,
+                    });
+                    return () => { };
+                },
+                toolRegistry: new ToolRegistry(),
+            };
+            plugin.initAgent(mockAgent);
+            expect(callbacks).toHaveLength(1);
+            expect(callbacks[0]?.eventType).toBe(BeforeInvocationEvent);
+        });
+        it('has a no-op default when not overridden', () => {
+            const plugin = new CustomNamePlugin('test');
+            const mockAgent = {
+                addHook: () => () => { },
+                toolRegistry: new ToolRegistry(),
+            };
+            // Should not throw and return undefined
+            const result = plugin.initAgent(mockAgent);
+            expect(result).toBeUndefined();
+        });
+        it('can be implemented for custom initialization', () => {
+            const plugin = new InitializablePlugin();
+            const mockAgent = {
+                addHook: () => () => { },
+                toolRegistry: new ToolRegistry(),
+            };
+            expect(plugin.initialized).toBe(false);
+            plugin.initAgent(mockAgent);
+            expect(plugin.initialized).toBe(true);
+        });
+    });
+    describe('getTools', () => {
+        it('is optional — plugins without getTools are valid', () => {
+            const plugin = new TestPlugin();
+            expect(plugin.getTools).toBeUndefined();
+        });
+        it('can be implemented to provide tools', () => {
+            const mockTool = createRandomTool();
+            class ToolPlugin {
+                get name() {
+                    return 'tool-plugin';
+                }
+                initAgent(_agent) { }
+                getTools() {
+                    return [mockTool];
+                }
+            }
+            expect(new ToolPlugin().getTools()).toStrictEqual([mockTool]);
+        });
+    });
+});
+//# sourceMappingURL=plugin.test.js.map

package/dist/src/plugins/__tests__/plugin.test.js.map

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

package/dist/src/plugins/__tests__/registry.test.d.ts

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

package/dist/src/plugins/__tests__/registry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.test.d.ts","sourceRoot":"","sources":["../../../../src/plugins/__tests__/registry.test.ts"],"names":[],"mappings":""}

package/dist/src/plugins/__tests__/registry.test.js

@@ -0,0 +1,147 @@
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { PluginRegistry } from '../registry.js';
+import { BeforeInvocationEvent } from '../../hooks/events.js';
+import { createMockAgent } from '../../__fixtures__/agent-helpers.js';
+import { createRandomTool } from '../../__fixtures__/tool-helpers.js';
+/**
+ * Test plugin implementation.
+ */
+class TestPlugin {
+    hookRegistered = false;
+    _name;
+    constructor(name = 'test-plugin') {
+        this._name = name;
+    }
+    get name() {
+        return this._name;
+    }
+    initAgent(agent) {
+        agent.addHook(BeforeInvocationEvent, () => {
+            this.hookRegistered = true;
+        });
+    }
+}
+/**
+ * Plugin with initAgent for testing initialization.
+ */
+class InitializableTestPlugin {
+    _name;
+    initialized = false;
+    constructor(_name = 'initializable-plugin') {
+        this._name = _name;
+    }
+    get name() {
+        return this._name;
+    }
+    initAgent(_agent) {
+        this.initialized = true;
+    }
+}
+/**
+ * Plugin that provides tools.
+ */
+class ToolProviderPlugin {
+    _name;
+    _tools;
+    constructor(_name, _tools) {
+        this._name = _name;
+        this._tools = _tools;
+    }
+    get name() {
+        return this._name;
+    }
+    initAgent(_agent) { }
+    getTools() {
+        return this._tools;
+    }
+}
+describe('PluginRegistry', () => {
+    let registry;
+    let mockAgent;
+    let registeredHooks;
+    beforeEach(() => {
+        registeredHooks = [];
+        mockAgent = createMockAgent({
+            extra: {
+                addHook: (eventType, callback) => {
+                    registeredHooks.push({
+                        eventType: eventType,
+                        callback: callback,
+                    });
+                    return () => { };
+                },
+            },
+        });
+    });
+    describe('initialize', () => {
+        it('initializes a plugin and calls initAgent', async () => {
+            const plugin = new InitializableTestPlugin();
+            registry = new PluginRegistry([plugin]);
+            await registry.initialize(mockAgent);
+            expect(plugin.initialized).toBe(true);
+        });
+        it('registers hooks via agent.addHook', async () => {
+            const plugin = new TestPlugin();
+            registry = new PluginRegistry([plugin]);
+            await registry.initialize(mockAgent);
+            expect(registeredHooks).toHaveLength(1);
+            expect(registeredHooks[0]?.eventType).toBe(BeforeInvocationEvent);
+        });
+        it('throws error when plugins have duplicate names', async () => {
+            const plugin1 = new TestPlugin('duplicate-name');
+            const plugin2 = new TestPlugin('duplicate-name');
+            registry = new PluginRegistry([plugin1, plugin2]);
+            await expect(registry.initialize(mockAgent)).rejects.toThrow('plugin_name=<duplicate-name> | plugin already registered');
+        });
+        it('initializes multiple plugins with different names', async () => {
+            const plugin1 = new TestPlugin('plugin-1');
+            const plugin2 = new TestPlugin('plugin-2');
+            registry = new PluginRegistry([plugin1, plugin2]);
+            await registry.initialize(mockAgent);
+            expect(registeredHooks).toHaveLength(2);
+        });
+        it('auto-registers tools from plugin.getTools()', async () => {
+            const mockTool = createRandomTool('mock-tool');
+            const plugin = new ToolProviderPlugin('tool-provider', [mockTool]);
+            registry = new PluginRegistry([plugin]);
+            await registry.initialize(mockAgent);
+            expect(mockAgent.toolRegistry.get(mockTool.name)).toBe(mockTool);
+        });
+        it('handles async initAgent', async () => {
+            class AsyncPlugin {
+                initialized = false;
+                get name() {
+                    return 'async-plugin';
+                }
+                async initAgent(_agent) {
+                    await vi.waitFor(() => Promise.resolve());
+                    this.initialized = true;
+                }
+            }
+            const plugin = new AsyncPlugin();
+            registry = new PluginRegistry([plugin]);
+            await registry.initialize(mockAgent);
+            expect(plugin.initialized).toBe(true);
+        });
+        it('is idempotent — calling initialize twice only runs plugins once', async () => {
+            const plugin = new InitializableTestPlugin();
+            registry = new PluginRegistry([plugin]);
+            await registry.initialize(mockAgent);
+            plugin.initialized = false; // reset to detect a second call
+            await registry.initialize(mockAgent);
+            expect(plugin.initialized).toBe(false);
+        });
+    });
+    describe('hook invocation', () => {
+        it('hooks are invoked when callbacks are called', async () => {
+            const plugin = new TestPlugin();
+            registry = new PluginRegistry([plugin]);
+            await registry.initialize(mockAgent);
+            const callback = registeredHooks[0]?.callback;
+            const mockAgentData = {};
+            callback?.(new BeforeInvocationEvent({ agent: mockAgentData }));
+            expect(plugin.hookRegistered).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=registry.test.js.map

package/dist/src/plugins/__tests__/registry.test.js.map

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

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

@@ -0,0 +1,30 @@
+/**
+ * Plugin system for extending agent functionality.
+ *
+ * This module provides the Plugin base class for extending agent behavior
+ * through hook callbacks and tool registration.
+ *
+ * @example
+ * ```typescript
+ * import { Plugin, BeforeInvocationEvent } from '@strands-agents/sdk'
+ *
+ * class MyPlugin extends Plugin {
+ *   get name(): string {
+ *     return 'my-plugin'
+ *   }
+ *
+ *   override initAgent(agent: LocalAgent): void {
+ *     agent.addHook(BeforeInvocationEvent, (event) => {
+ *       console.log('Before invocation')
+ *     })
+ *   }
+ * }
+ *
+ * const agent = new Agent({
+ *   model,
+ *   plugins: [new MyPlugin()],
+ * })
+ * ```
+ */
+export type { Plugin } from './plugin.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA"}

package/dist/src/plugins/index.js

@@ -0,0 +1,30 @@
+/**
+ * Plugin system for extending agent functionality.
+ *
+ * This module provides the Plugin base class for extending agent behavior
+ * through hook callbacks and tool registration.
+ *
+ * @example
+ * ```typescript
+ * import { Plugin, BeforeInvocationEvent } from '@strands-agents/sdk'
+ *
+ * class MyPlugin extends Plugin {
+ *   get name(): string {
+ *     return 'my-plugin'
+ *   }
+ *
+ *   override initAgent(agent: LocalAgent): void {
+ *     agent.addHook(BeforeInvocationEvent, (event) => {
+ *       console.log('Before invocation')
+ *     })
+ *   }
+ * }
+ *
+ * const agent = new Agent({
+ *   model,
+ *   plugins: [new MyPlugin()],
+ * })
+ * ```
+ */
+export {};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG"}