Class InMemoryToolRegistry

In-memory implementation of ToolRegistry.

Provides fast, synchronous tool management with metadata and search capabilities. Suitable for development, testing, and single-instance deployments.

Example

const registry = new InMemoryToolRegistry();

// Register tools
await registry.register(new SearchTool(), {
  category: 'knowledge',
  tags: ['search', 'docs'],
  version: '1.0.0'
});

await registry.register(new CalculatorTool(), {
  category: 'math',
  tags: ['calculator', 'compute']
});

// Search for tools
const results = await registry.search({
  query: 'search',
  limit: 5
});

// Get definitions for LLM
const definitions = await registry.getDefinitions();

Implements

  • ToolRegistry

Constructors

constructor

Methods

register unregister get has listAll getMetadata search getDefinitions listCategories listTags getByCategory getByTag clear count

Constructors

constructor

Methods

register

  • register(
        tool: AgentTool<unknown, unknown>,
        metadata?: Partial<ToolMetadata>,
    ): Promise<void>

    Register a tool in the registry

    Parameters

    • tool: AgentTool<unknown, unknown>

      The tool to register

    • Optionalmetadata: Partial<ToolMetadata>

      Optional metadata for the tool

    Returns Promise<void>

    Throws

    If a tool with the same name already exists

unregister

  • unregister(name: string): Promise<boolean>

    Unregister a tool by name

    Parameters

    • name: string

      The tool name

    Returns Promise<boolean>

    true if tool was removed, false if not found

get

  • get(name: string): Promise<null | AgentTool<unknown, unknown>>

    Get a tool by name

    Parameters

    • name: string

      The tool name

    Returns Promise<null | AgentTool<unknown, unknown>>

    The tool, or null if not found

has

  • has(name: string): Promise<boolean>

    Check if a tool is registered

    Parameters

    • name: string

      The tool name

    Returns Promise<boolean>

    true if registered

listAll

  • listAll(): Promise<AgentTool<unknown, unknown>[]>

    List all registered tools

    Returns Promise<AgentTool<unknown, unknown>[]>

    Array of all registered tools

getMetadata

  • getMetadata(name: string): Promise<null | ToolMetadata>

    Get metadata for a tool

    Parameters

    • name: string

      The tool name

    Returns Promise<null | ToolMetadata>

    Tool metadata, or null if not found

search

  • search(options: ToolSearchOptions): Promise<ToolSearchResult[]>

    Search for tools matching criteria

    Parameters

    • options: ToolSearchOptions

      Search options

    Returns Promise<ToolSearchResult[]>

    Array of matching tools with scores

getDefinitions

  • getDefinitions(names?: string[]): Promise<ToolDefinition[]>

    Get tool definitions for LLM function calling

    Parameters

    • Optionalnames: string[]

      Optional array of tool names to include (all if not specified)

    Returns Promise<ToolDefinition[]>

    Array of tool definitions

listCategories

listTags

getByCategory

  • getByCategory(category: string): Promise<AgentTool<unknown, unknown>[]>

    Get tools by category

    Parameters

    • category: string

      The category name

    Returns Promise<AgentTool<unknown, unknown>[]>

    Array of tools in the category

getByTag

  • getByTag(tag: string): Promise<AgentTool<unknown, unknown>[]>

    Get tools by tag

    Parameters

    • tag: string

      The tag name

    Returns Promise<AgentTool<unknown, unknown>[]>

    Array of tools with the tag

clear

count

Settings

Member Visibility

On This Page

Constructors
Methods