@strands-agents/sdk 0.5.0 → 0.7.0

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

@@ -0,0 +1,74 @@
+/**
+ * Plugin interface for extending agent functionality.
+ *
+ * This module defines the Plugin interface, which provides a composable way to
+ * add behavior changes to agents through hook registration and custom initialization.
+ */
+import type { Tool } from '../tools/tool.js';
+import type { LocalAgent } from '../types/agent.js';
+/**
+ * Interface for objects that extend agent functionality.
+ *
+ * Plugins provide a composable way to add behavior changes to agents by registering
+ * hook callbacks in their `initAgent` method. Each plugin must have a unique name
+ * for identification, logging, and duplicate prevention.
+ *
+ * @example
+ * ```typescript
+ * class LoggingPlugin implements Plugin {
+ *   get name(): string {
+ *     return 'logging-plugin'
+ *   }
+ *
+ *   initAgent(agent: LocalAgent): void {
+ *     agent.addHook(BeforeInvocationEvent, (event) => {
+ *       console.log('Agent invocation started')
+ *     })
+ *   }
+ * }
+ *
+ * const agent = new Agent({
+ *   model,
+ *   plugins: [new LoggingPlugin()],
+ * })
+ * ```
+ *
+ * @example With tools
+ * ```typescript
+ * class MyToolPlugin implements Plugin {
+ *   get name(): string {
+ *     return 'my-tool-plugin'
+ *   }
+ *
+ *   getTools(): Tool[] {
+ *     return [myTool]
+ *   }
+ * }
+ * ```
+ */
+export interface Plugin {
+    /**
+     * A stable string identifier for the plugin.
+     * Used for logging, duplicate detection, and plugin management.
+     *
+     * For strands-vended plugins, names should be prefixed with `strands:`.
+     */
+    readonly name: string;
+    /**
+     * Initialize the plugin with the agent instance.
+     *
+     * Implement this method to register hooks and perform custom initialization.
+     * Tool registration from {@link getTools} is handled automatically by the PluginRegistry.
+     *
+     * @param agent - The agent instance this plugin is being attached to
+     */
+    initAgent(agent: LocalAgent): void | Promise<void>;
+    /**
+     * Returns tools provided by this plugin for auto-registration.
+     * Implement to provide plugin-specific tools.
+     *
+     * @returns Array of tools to register with the agent
+     */
+    getTools?(): Tool[];
+}
+//# sourceMappingURL=plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,WAAW,MAAM;IACrB;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;;;;;;OAOG;IACH,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAElD;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAA;CACpB"}

package/dist/src/plugins/plugin.js

@@ -0,0 +1,8 @@
+/**
+ * Plugin interface for extending agent functionality.
+ *
+ * This module defines the Plugin interface, which provides a composable way to
+ * add behavior changes to agents through hook registration and custom initialization.
+ */
+export {};
+//# sourceMappingURL=plugin.js.map

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

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

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

@@ -0,0 +1,25 @@
+/**
+ * Plugin registry for managing plugins attached to an agent.
+ */
+import type { Plugin } from './plugin.js';
+import type { LocalAgent } from '../types/agent.js';
+/**
+ * Registry for managing plugins attached to an agent.
+ *
+ * Holds pending plugins and initializes them on first use.
+ * Handles duplicate detection, tool registration, and calls each plugin's initAgent method.
+ */
+export declare class PluginRegistry {
+    private readonly _plugins;
+    private readonly _pending;
+    constructor(plugins?: Plugin[]);
+    /**
+     * Initialize all pending plugins with the agent.
+     * Safe to call multiple times — only runs once per pending batch.
+     *
+     * @param agent - The agent instance to initialize plugins with
+     */
+    initialize(agent: LocalAgent): Promise<void>;
+    private _addAndInit;
+}
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/plugins/registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAEnD;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;gBAEvB,OAAO,GAAE,MAAM,EAAO;IAKlC;;;;;OAKG;IACG,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;YAOpC,WAAW;CAa1B"}

package/dist/src/plugins/registry.js

@@ -0,0 +1,41 @@
+/**
+ * Plugin registry for managing plugins attached to an agent.
+ */
+/**
+ * Registry for managing plugins attached to an agent.
+ *
+ * Holds pending plugins and initializes them on first use.
+ * Handles duplicate detection, tool registration, and calls each plugin's initAgent method.
+ */
+export class PluginRegistry {
+    _plugins;
+    _pending;
+    constructor(plugins = []) {
+        this._plugins = new Map();
+        this._pending = [...plugins];
+    }
+    /**
+     * Initialize all pending plugins with the agent.
+     * Safe to call multiple times — only runs once per pending batch.
+     *
+     * @param agent - The agent instance to initialize plugins with
+     */
+    async initialize(agent) {
+        while (this._pending.length > 0) {
+            const plugin = this._pending.shift();
+            await this._addAndInit(plugin, agent);
+        }
+    }
+    async _addAndInit(plugin, agent) {
+        if (this._plugins.has(plugin.name)) {
+            throw new Error(`plugin_name=<${plugin.name}> | plugin already registered`);
+        }
+        this._plugins.set(plugin.name, plugin);
+        const tools = plugin.getTools?.() ?? [];
+        if (tools.length > 0) {
+            agent.toolRegistry.add(tools);
+        }
+        await plugin.initAgent(agent);
+    }
+}
+//# sourceMappingURL=registry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/plugins/registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;;;;GAKG;AACH,MAAM,OAAO,cAAc;IACR,QAAQ,CAAqB;IAC7B,QAAQ,CAAU;IAEnC,YAAY,UAAoB,EAAE;QAChC,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAA;QACzB,IAAI,CAAC,QAAQ,GAAG,CAAC,GAAG,OAAO,CAAC,CAAA;IAC9B,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,UAAU,CAAC,KAAiB;QAChC,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAG,CAAA;YACrC,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QACvC,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,MAAc,EAAE,KAAiB;QACzD,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,gBAAgB,MAAM,CAAC,IAAI,+BAA+B,CAAC,CAAA;QAC7E,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QAEtC,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAA;QACvC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAC/B,CAAC;QAED,MAAM,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IAC/B,CAAC;CACF"}

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"}

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

@@ -1,180 +1,82 @@
-import { Registry, ValidationError } from './registry.js';
-import { ToolStreamEvent } from '../tools/tool.js';
-import { ToolResultBlock } from '../types/messages.js';
+import { ToolValidationError } from '../errors.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 class ToolRegistry extends Registry {
+export class ToolRegistry {
+    _tools = new Map();
     /**
-     * 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) {
+        if (tools) {
+            this.add(tools);
+        }
+    }
+    /**
+     * 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
      */
-    generateId(tool) {
-        return tool;
+    add(tool) {
+        const tools = Array.isArray(tool) ? tool : [tool];
+        for (const t of tools) {
+            this._validate(t);
+            this._tools.set(t.name, t);
+        }
     }
     /**
-     * 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
      */
-    validate(tool) {
-        // Validate tool name is a string
+    get(name) {
+        return this._tools.get(name);
+    }
+    /**
+     * Removes a tool by name. No-op if the tool does not exist.
+     *
+     * @param name - The name of the tool to remove
+     */
+    remove(name) {
+        this._tools.delete(name);
+    }
+    /**
+     * Returns all registered tools.
+     *
+     * @returns Array of all registered tools
+     */
+    list() {
+        return Array.from(this._tools.values());
+    }
+    /**
+     * Validates a tool before registration.
+     *
+     * @param tool - The tool to validate
+     * @throws ToolValidationError If the tool's properties are invalid or its name is already registered
+     */
+    _validate(tool) {
         if (typeof tool.name !== 'string') {
-            throw new ValidationError('Tool name must be a string');
+            throw new ToolValidationError('Tool name must be a string');
         }
-        // Validate tool name length (1-64 characters)
         if (tool.name.length < 1 || tool.name.length > 64) {
-            throw new ValidationError('Tool name must be between 1 and 64 characters');
+            throw new ToolValidationError('Tool name must be between 1 and 64 characters');
         }
-        // Validate tool name pattern
         const validNamePattern = /^[a-zA-Z0-9_-]+$/;
         if (!validNamePattern.test(tool.name)) {
-            throw new ValidationError('Tool name must contain only alphanumeric characters, hyphens, and underscores');
+            throw new ToolValidationError('Tool name must contain only alphanumeric characters, hyphens, and underscores');
         }
-        // Validate tool description if present
         if (tool.description !== undefined && tool.description !== null) {
             if (typeof tool.description !== 'string' || tool.description.length < 1) {
-                throw new ValidationError('Tool description must be a non-empty string');
+                throw new ToolValidationError('Tool description must be a non-empty string');
             }
         }
-        // Check for duplicate names
-        const hasDuplicate = this.values().some((t) => t.name === tool.name);
-        if (hasDuplicate) {
-            throw new ValidationError(`Tool with name '${tool.name}' already registered`);
+        if (this._tools.has(tool.name)) {
+            throw new ToolValidationError(`Tool with name '${tool.name}' already registered`);
         }
     }
-    /**
-     * Retrieves the first tool that matches the given name.
-     *
-     * @param name - The name of the tool to retrieve.
-     * @returns The tool if found, otherwise undefined.
-     */
-    getByName(name) {
-        return this.values().find((tool) => tool.name === name);
-    }
-    /**
-     * Finds and removes the first tool that matches the given name.
-     *
-     * @param name - The name of the tool to remove.
-     */
-    removeByName(name) {
-        this.findRemove((tool) => tool.name === name);
-    }
-}
-// Unit tests
-if (import.meta.vitest) {
-    const { describe, it, expect, beforeEach } = import.meta.vitest;
-    // Mock Tool definition for testing purposes
-    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* () {
-            // Mock stream implementation
-            yield new ToolStreamEvent({ data: 'mock data' });
-            return new ToolResultBlock({ toolUseId: '', status: 'success', content: [] });
-        },
-        ...overrides,
-    });
-    describe('ToolRegistry', () => {
-        let registry;
-        beforeEach(() => {
-            registry = new ToolRegistry();
-        });
-        it('should register a valid tool successfully', () => {
-            const tool = createMockTool();
-            expect(() => registry.add(tool)).not.toThrow();
-            expect(registry.values()).toHaveLength(1);
-            expect(registry.values()[0]?.name).toBe('valid-tool');
-        });
-        it('should throw ValidationError for a duplicate tool name', () => {
-            const tool1 = createMockTool({ name: 'duplicate-name' });
-            const tool2 = createMockTool({ name: 'duplicate-name' });
-            registry.add(tool1);
-            expect(() => registry.add(tool2)).toThrow(ValidationError);
-            expect(() => registry.add(tool2)).toThrow("Tool with name 'duplicate-name' already registered");
-        });
-        it('should throw ValidationError for an invalid tool name pattern', () => {
-            const tool = createMockTool({ name: 'invalid name!' });
-            expect(() => registry.add(tool)).toThrow(ValidationError);
-            expect(() => registry.add(tool)).toThrow('Tool name must contain only alphanumeric characters, hyphens, and underscores');
-        });
-        it('should throw ValidationError for a tool name that is too long', () => {
-            const longName = 'a'.repeat(65);
-            const tool = createMockTool({ name: longName });
-            expect(() => registry.add(tool)).toThrow(ValidationError);
-            expect(() => registry.add(tool)).toThrow('Tool name must be between 1 and 64 characters');
-        });
-        it('should throw ValidationError for a tool name that is too short', () => {
-            const tool = createMockTool({ name: '' });
-            expect(() => registry.add(tool)).toThrow(ValidationError);
-            expect(() => registry.add(tool)).toThrow('Tool name must be between 1 and 64 characters');
-        });
-        it('should throw ValidationError for an invalid description', () => {
-            // @ts-expect-error - Testing invalid type for description
-            const tool = createMockTool({ description: 123 });
-            expect(() => registry.add(tool)).toThrow(ValidationError);
-            expect(() => registry.add(tool)).toThrow('Tool description must be a non-empty string');
-        });
-        it('should throw ValidationError for an empty string description', () => {
-            const tool = createMockTool({ description: '' });
-            expect(() => registry.add(tool)).toThrow(ValidationError);
-            expect(() => registry.add(tool)).toThrow('Tool description must be a non-empty string');
-        });
-        it('should allow a tool with a null or undefined description', () => {
-            const tool1 = createMockTool();
-            // @ts-expect-error - Testing explicit undefined description
-            tool1.description = undefined;
-            const tool2 = createMockTool();
-            tool2.name = 'another-valid-tool';
-            // @ts-expect-error - Testing explicit null description
-            tool2.description = null;
-            expect(() => registry.add(tool1)).not.toThrow();
-            expect(() => registry.add(tool2)).not.toThrow();
-        });
-        it('should retrieve a tool by its name', () => {
-            const tool = createMockTool({ name: 'find-me' });
-            registry.add(tool);
-            const foundTool = registry.getByName('find-me');
-            expect(foundTool).toBe(tool);
-        });
-        it('should return undefined when getting a tool by a name that does not exist', () => {
-            const foundTool = registry.getByName('non-existent');
-            expect(foundTool).toBeUndefined();
-        });
-        it('should remove a tool by its name', () => {
-            const tool = createMockTool({ name: 'remove-me' });
-            registry.add(tool);
-            expect(registry.getByName('remove-me')).toBeDefined();
-            registry.removeByName('remove-me');
-            expect(registry.getByName('remove-me')).toBeUndefined();
-        });
-        it('should not throw when removing a tool by a name that does not exist', () => {
-            expect(() => registry.removeByName('non-existent')).not.toThrow();
-        });
-        it('should generate a valid ToolIdentifier', () => {
-            const tool = createMockTool();
-            const id = registry['generateId'](tool);
-            expect(id).toBe(tool);
-        });
-        it('should register a tool with a name at the maximum length', () => {
-            const longName = 'a'.repeat(64);
-            const tool = createMockTool({ name: longName });
-            expect(() => registry.add(tool)).not.toThrow();
-        });
-        it('should throw ValidationError for a non-string tool name', () => {
-            // @ts-expect-error - Testing invalid type for name
-            const tool = createMockTool({ name: 123 });
-            expect(() => registry.add(tool)).toThrow(ValidationError);
-            expect(() => registry.add(tool)).toThrow('Tool name must be a string');
-        });
-    });
 }
 //# sourceMappingURL=tool-registry.js.map