@strands-agents/sdk 0.4.0 → 0.6.0

package/dist/src/multiagent/swarm.d.ts

@@ -0,0 +1,102 @@
+import { Agent } from '../agent/agent.js';
+import type { InvokeArgs } from '../agent/agent.js';
+import { HookRegistryImplementation } from '../hooks/registry.js';
+import type { HookProvider } from '../hooks/types.js';
+import type { AgentNodeOptions } from './nodes.js';
+import { AgentNode } from './nodes.js';
+import { MultiAgentResult } from './state.js';
+import type { MultiAgentBase } from './base.js';
+import type { MultiAgentStreamEvent } from './events.js';
+/**
+ * Runtime configuration for swarm execution.
+ */
+export interface SwarmConfig {
+    /** Max total agent executions (including start). Defaults to Infinity. */
+    maxSteps?: number;
+}
+/**
+ * Options for creating a Swarm instance.
+ */
+/**
+ * Input type for swarm nodes. Pass an {@link Agent} directly for the simple case,
+ * or {@link AgentNodeOptions} for per-node config.
+ */
+export type SwarmNodeDefinition = Agent | AgentNodeOptions;
+export interface SwarmOptions extends SwarmConfig {
+    /** Unique identifier. Defaults to `'swarm'`. */
+    id?: string;
+    /** Swarm agents. Pass agents directly or use {@link AgentNodeOptions} for per-node config. */
+    nodes: SwarmNodeDefinition[];
+    /** Agent id that receives the initial input. */
+    start: string;
+    /** Hook providers for event-driven extensibility. */
+    hooks?: HookProvider[];
+}
+/**
+ * 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 declare class Swarm implements MultiAgentBase {
+    readonly id: string;
+    readonly nodes: ReadonlyMap<string, AgentNode>;
+    readonly config: Required<SwarmConfig>;
+    readonly hooks: HookRegistryImplementation;
+    private readonly _start;
+    private readonly _handoffSchema;
+    private _initialized;
+    constructor(options: SwarmOptions);
+    /**
+     * Initialize the swarm. Invokes the {@link MultiAgentInitializedEvent} callback.
+     * Called automatically on first invocation.
+     */
+    initialize(): Promise<void>;
+    /**
+     * 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
+     */
+    invoke(input: InvokeArgs): Promise<MultiAgentResult>;
+    /**
+     * 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
+     */
+    stream(input: InvokeArgs): AsyncGenerator<MultiAgentStreamEvent, MultiAgentResult, undefined>;
+    private _stream;
+    private _streamNode;
+    private _validateConfig;
+    private _resolveNodes;
+    private _resolveStart;
+    private _resolveContent;
+    private _resolveNodeInput;
+    private _checkSteps;
+    private _buildHandoffSchema;
+}
+//# sourceMappingURL=swarm.d.ts.map

package/dist/src/multiagent/swarm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm.d.ts","sourceRoot":"","sources":["../../../src/multiagent/swarm.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAGnD,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAA;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACtC,OAAO,EAAmB,gBAAgB,EAAsB,MAAM,YAAY,CAAA;AAClF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC/C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAYxD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAiBD;;GAEG;AACH;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG,gBAAgB,CAAA;AAE1D,MAAM,WAAW,YAAa,SAAQ,WAAW;IAC/C,gDAAgD;IAChD,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,8FAA8F;IAC9F,KAAK,EAAE,mBAAmB,EAAE,CAAA;IAC5B,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAA;IACb,qDAAqD;IACrD,KAAK,CAAC,EAAE,YAAY,EAAE,CAAA;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,KAAM,YAAW,cAAc;IAC1C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IAC9C,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAA;IACtC,QAAQ,CAAC,KAAK,EAAE,0BAA0B,CAAA;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA0B;IACzD,OAAO,CAAC,YAAY,CAAS;gBAEjB,OAAO,EAAE,YAAY;IAoBjC;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC;;;;;OAKG;IACG,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAS1D;;;;;;OAMG;IACI,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc,CAAC,qBAAqB,EAAE,gBAAgB,EAAE,SAAS,CAAC;YAerF,OAAO;YA8CP,WAAW;IA4C1B,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,mBAAmB;CAsB5B"}

package/dist/src/multiagent/swarm.js

@@ -0,0 +1,238 @@
+import { logger } from '../logging/logger.js';
+import { Agent } from '../agent/agent.js';
+import { z } from 'zod';
+import { HookableEvent } from '../hooks/events.js';
+import { HookRegistryImplementation } from '../hooks/registry.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;
+    hooks;
+    _start;
+    _handoffSchema;
+    _initialized;
+    constructor(options) {
+        const { id, nodes, start, hooks, ...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.hooks = new HookRegistryImplementation();
+        this.hooks.addAllHooks(hooks ?? []);
+        this._initialized = false;
+    }
+    /**
+     * Initialize the swarm. Invokes the {@link MultiAgentInitializedEvent} callback.
+     * Called automatically on first invocation.
+     */
+    async initialize() {
+        if (this._initialized)
+            return;
+        await this.hooks.invokeCallbacks(new MultiAgentInitializedEvent({ orchestrator: this }));
+        this._initialized = true;
+    }
+    /**
+     * 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.hooks.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] });
+                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, 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) {
+        const nodes = new Map();
+        for (const definition of definitions) {
+            const node = definition instanceof Agent ? new AgentNode({ agent: definition }) : new AgentNode(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) {
+        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/registry/__tests__/tool-registry.test.d.ts

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

package/dist/src/registry/__tests__/tool-registry.test.d.ts.map

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

package/dist/src/registry/__tests__/tool-registry.test.js

@@ -0,0 +1,124 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+import { ToolRegistry } from '../tool-registry.js';
+import { ToolValidationError } from '../../errors.js';
+import { ToolStreamEvent } from '../../tools/tool.js';
+import { ToolResultBlock } from '../../types/messages.js';
+const createMockTool = (overrides = {}) => ({
+    name: 'valid-tool',
+    description: 'A valid tool description.',
+    toolSpec: {
+        name: 'valid-tool',
+        description: 'A valid tool description.',
+        inputSchema: { type: 'object', properties: {} },
+    },
+    stream: async function* () {
+        yield new ToolStreamEvent({ data: 'mock data' });
+        return new ToolResultBlock({ toolUseId: '', status: 'success', content: [] });
+    },
+    ...overrides,
+});
+describe('ToolRegistry', () => {
+    let registry;
+    beforeEach(() => {
+        registry = new ToolRegistry();
+    });
+    describe('add', () => {
+        it('registers a single tool', () => {
+            const tool = createMockTool();
+            registry.add(tool);
+            expect(registry.list()).toStrictEqual([tool]);
+        });
+        it('registers an array of tools', () => {
+            const tool1 = createMockTool({ name: 'tool-1' });
+            const tool2 = createMockTool({ name: 'tool-2' });
+            registry.add([tool1, tool2]);
+            expect(registry.list()).toStrictEqual([tool1, tool2]);
+        });
+        it('throws ToolValidationError for a duplicate tool name', () => {
+            registry.add(createMockTool({ name: 'duplicate' }));
+            expect(() => registry.add(createMockTool({ name: 'duplicate' }))).toThrow(ToolValidationError);
+            expect(() => registry.add(createMockTool({ name: 'duplicate' }))).toThrow("Tool with name 'duplicate' already registered");
+        });
+        it('throws ToolValidationError for an invalid tool name pattern', () => {
+            expect(() => registry.add(createMockTool({ name: 'invalid name!' }))).toThrow(ToolValidationError);
+            expect(() => registry.add(createMockTool({ name: 'invalid name!' }))).toThrow('Tool name must contain only alphanumeric characters, hyphens, and underscores');
+        });
+        it('throws ToolValidationError for a tool name that is too long', () => {
+            expect(() => registry.add(createMockTool({ name: 'a'.repeat(65) }))).toThrow(ToolValidationError);
+            expect(() => registry.add(createMockTool({ name: 'a'.repeat(65) }))).toThrow('Tool name must be between 1 and 64 characters');
+        });
+        it('throws ToolValidationError for a tool name that is too short', () => {
+            expect(() => registry.add(createMockTool({ name: '' }))).toThrow(ToolValidationError);
+            expect(() => registry.add(createMockTool({ name: '' }))).toThrow('Tool name must be between 1 and 64 characters');
+        });
+        it('throws ToolValidationError for a non-string tool name', () => {
+            // @ts-expect-error - Testing invalid type for name
+            expect(() => registry.add(createMockTool({ name: 123 }))).toThrow(ToolValidationError);
+            // @ts-expect-error - Testing invalid type for name
+            expect(() => registry.add(createMockTool({ name: 123 }))).toThrow('Tool name must be a string');
+        });
+        it('throws ToolValidationError for an invalid description', () => {
+            // @ts-expect-error - Testing invalid type for description
+            expect(() => registry.add(createMockTool({ description: 123 }))).toThrow(ToolValidationError);
+            // @ts-expect-error - Testing invalid type for description
+            expect(() => registry.add(createMockTool({ description: 123 }))).toThrow('Tool description must be a non-empty string');
+        });
+        it('throws ToolValidationError for an empty string description', () => {
+            expect(() => registry.add(createMockTool({ description: '' }))).toThrow(ToolValidationError);
+            expect(() => registry.add(createMockTool({ description: '' }))).toThrow('Tool description must be a non-empty string');
+        });
+        it('allows a tool with a null or undefined description', () => {
+            const tool1 = createMockTool({ name: 'tool-1' });
+            // @ts-expect-error - Testing explicit undefined description
+            tool1.description = undefined;
+            const tool2 = createMockTool({ name: 'tool-2' });
+            // @ts-expect-error - Testing explicit null description
+            tool2.description = null;
+            registry.add([tool1, tool2]);
+            expect(registry.list()).toHaveLength(2);
+        });
+        it('registers a tool with a name at the maximum length', () => {
+            const tool = createMockTool({ name: 'a'.repeat(64) });
+            expect(() => registry.add(tool)).not.toThrow();
+        });
+    });
+    describe('get', () => {
+        it('retrieves a tool by name', () => {
+            const tool = createMockTool({ name: 'find-me' });
+            registry.add(tool);
+            expect(registry.get('find-me')).toBe(tool);
+        });
+        it('returns undefined for a non-existent tool', () => {
+            expect(registry.get('non-existent')).toBeUndefined();
+        });
+    });
+    describe('remove', () => {
+        it('removes a tool by name', () => {
+            registry.add(createMockTool({ name: 'remove-me' }));
+            registry.remove('remove-me');
+            expect(registry.get('remove-me')).toBeUndefined();
+        });
+        it('does not throw when removing a non-existent tool', () => {
+            expect(() => registry.remove('non-existent')).not.toThrow();
+        });
+    });
+    describe('list', () => {
+        it('returns an empty array when no tools are registered', () => {
+            expect(registry.list()).toStrictEqual([]);
+        });
+        it('returns all registered tools', () => {
+            const tool1 = createMockTool({ name: 'tool-1' });
+            const tool2 = createMockTool({ name: 'tool-2' });
+            registry.add([tool1, tool2]);
+            expect(registry.list()).toStrictEqual([tool1, tool2]);
+        });
+    });
+    describe('constructor', () => {
+        it('accepts initial tools', () => {
+            const tool = createMockTool();
+            const reg = new ToolRegistry([tool]);
+            expect(reg.list()).toStrictEqual([tool]);
+        });
+    });
+});
+//# sourceMappingURL=tool-registry.test.js.map

package/dist/src/registry/__tests__/tool-registry.test.js.map

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

package/dist/src/registry/tool-registry.d.ts

@@ -1,35 +1,47 @@
-import { Registry } from './registry.js';
 import type { Tool } from '../tools/tool.js';
 /**
- * A concrete implementation of the Registry for managing Tool instances.
- * It adds validation for tool properties and ensures unique tool names.
+ * Registry for managing Tool instances with name-based CRUDL operations.
  */
-export declare class ToolRegistry extends Registry<Tool, Tool> {
+export declare class ToolRegistry {
+    private _tools;
     /**
-     * Generates a unique identifier for a Tool.
-     * @override
-     * @returns The tool itself as the identifier.
+     * Creates a new ToolRegistry, optionally pre-populated with tools.
+     *
+     * @param tools - Optional initial tools to register
+     */
+    constructor(tools?: Tool[]);
+    /**
+     * Registers one or more tools.
+     *
+     * @param tool - A single tool or array of tools to register
+     * @throws ToolValidationError If a tool's properties are invalid or its name is already registered
      */
-    protected generateId(tool: Tool): Tool;
+    add(tool: Tool | Tool[]): void;
     /**
-     * Validates a tool before it is registered.
-     * @override
-     * @param tool - The tool to be validated.
-     * @throws ValidationError If the tool's properties are invalid or its name is already registered.
+     * Retrieves a tool by name.
+     *
+     * @param name - The name of the tool to retrieve
+     * @returns The tool if found, otherwise undefined
+     */
+    get(name: string): Tool | undefined;
+    /**
+     * Removes a tool by name. No-op if the tool does not exist.
+     *
+     * @param name - The name of the tool to remove
      */
-    protected validate(tool: Tool): void;
+    remove(name: string): void;
     /**
-     * Retrieves the first tool that matches the given name.
+     * Returns all registered tools.
      *
-     * @param name - The name of the tool to retrieve.
-     * @returns The tool if found, otherwise undefined.
+     * @returns Array of all registered tools
      */
-    getByName(name: string): Tool | undefined;
+    list(): Tool[];
     /**
-     * Finds and removes the first tool that matches the given name.
+     * Validates a tool before registration.
      *
-     * @param name - The name of the tool to remove.
+     * @param tool - The tool to validate
+     * @throws ToolValidationError If the tool's properties are invalid or its name is already registered
      */
-    removeByName(name: string): void;
+    private _validate;
 }
 //# sourceMappingURL=tool-registry.d.ts.map

package/dist/src/registry/tool-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../../src/registry/tool-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAmB,MAAM,eAAe,CAAA;AACzD,OAAO,KAAK,EAAE,IAAI,EAAuB,MAAM,kBAAkB,CAAA;AAIjE;;;GAGG;AACH,qBAAa,YAAa,SAAQ,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpD;;;;OAIG;IACH,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAItC;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IA+BpC;;;;;OAKG;IACI,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIhD;;;;OAIG;IACI,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAGxC"}
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../../src/registry/tool-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAG5C;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAA+B;IAE7C;;;;OAIG;gBACS,KAAK,CAAC,EAAE,IAAI,EAAE;IAM1B;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,GAAG,IAAI;IAQ9B;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAInC;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI1B;;;;OAIG;IACH,IAAI,IAAI,IAAI,EAAE;IAId;;;;;OAKG;IACH,OAAO,CAAC,SAAS;CAwBlB"}