Hi-AI

Instructions

Implementation Reference

• src/tools/memory/searchMemories.ts:23-51 (handler)

  The main execution handler for the search_memories tool. It uses MemoryManager to search memories by query, optionally filters by category, formats the results as a bulleted list, and returns a ToolResult with the findings or error.

  export async function searchMemoriesHandler(args: { query: string; category?: string }): Promise<ToolResult> {
    const { query, category } = args;
  
    try {
      const mm = MemoryManager.getInstance();
      let results = mm.search(query);
  
      // Filter by category if specified
      if (category) {
        results = results.filter(m => m.category === category);
      }
  
      const resultList = results.map(m =>
        `• ${m.key} (${m.category}): ${m.value.substring(0, 100)}${m.value.length > 100 ? '...' : ''}`
      ).join('\n');
  
      const categoryInfo = category ? ` in category "${category}"` : '';
      return {
        content: [{
          type: 'text',
          text: `✓ Found ${results.length} matches for "${query}"${categoryInfo}:\n${resultList || 'None'}`
        }]
      };
    } catch (error) {
      return {
        content: [{ type: 'text', text: `✗ Error: ${error instanceof Error ? error.message : 'Unknown error'}` }]
      };
    }
  }

• src/tools/memory/searchMemories.ts:6-21 (schema)

  The ToolDefinition object defining the tool's name, description, input schema (requiring 'query' string, optional 'category'), and annotations.

  export const searchMemoriesDefinition: ToolDefinition = {
    name: 'search_memories',
    description: 'find|search|look for|query memories - Search memories by content',
    inputSchema: {
      type: 'object',
      properties: {
        query: { type: 'string', description: 'Search query' },
        category: { type: 'string', description: 'Category to search in' }
      },
      required: ['query']
    },
    annotations: {
      title: 'Search Memories',
      audience: ['user', 'assistant']
    }
  };

• src/index.ts:124-134 (registration)

  Registration of searchMemoriesDefinition in the main tools array, which is used by the MCP server's listTools handler with pagination support.

  // Memory Management Tools
  saveMemoryDefinition,
  recallMemoryDefinition,
  listMemoriesDefinition,
  deleteMemoryDefinition,
  searchMemoriesDefinition,
  updateMemoryDefinition,
  autoSaveContextDefinition,
  restoreSessionContextDefinition,
  prioritizeMemoryDefinition,
  startSessionDefinition,

• src/index.ts:644-645 (registration)

  Dispatch case in the central executeToolCall switch statement that routes calls to the searchMemoriesHandler.

  case 'search_memories':
    return await searchMemoriesHandler(args as any) as CallToolResult;

• src/index.ts:66-66 (registration)

  Import statement bringing in the tool definition and handler from the implementation file.

  import { searchMemoriesDefinition, searchMemoriesHandler } from './tools/memory/searchMemories.js';