Hi-AI

Instructions

Implementation Reference

• src/tools/memory/listMemories.ts:23-46 (handler)

  The core handler function that executes the list_memories tool. Retrieves memories using MemoryManager, filters by category and limit, formats them into a list, and returns as ToolResult.

  export async function listMemories(args: { category?: string; limit?: number }): Promise<ToolResult> {
    const { category: listCategory, limit = 10 } = args;
  
    try {
      const mm = MemoryManager.getInstance();
      const allMemories = mm.list(listCategory);
      const limitedMemories = allMemories.slice(0, limit);
  
      const memoryList = limitedMemories.map(m =>
        `• ${m.key} (${m.category}): ${m.value.substring(0, 50)}${m.value.length > 50 ? '...' : ''}`
      ).join('\n');
  
      return {
        content: [{
          type: 'text',
          text: `✓ Found ${allMemories.length} memories${listCategory ? ` in '${listCategory}'` : ''}:\n${memoryList || 'None'}`
        }]
      };
    } catch (error) {
      return {
        content: [{ type: 'text', text: `✗ Error: ${error instanceof Error ? error.message : 'Unknown error'}` }]
      };
    }
  }

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

  The ToolDefinition object defining the list_memories tool, including its name, description, input schema, and annotations.

  export const listMemoriesDefinition: ToolDefinition = {
    name: 'list_memories',
    description: 'list|saved items|show saved|what memories - List saved memories',
    inputSchema: {
      type: 'object',
      properties: {
        category: { type: 'string', description: 'Filter by category' },
        limit: { type: 'number', description: 'Maximum number of results' }
      },
      required: []
    },
    annotations: {
      title: 'List Memories',
      audience: ['user', 'assistant']
    }
  };

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

  Registration of listMemoriesDefinition within the main tools array (lines 104-160), specifically in the Memory Management Tools section, enabling it for ListTools requests.

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

• src/index.ts:640-641 (handler)

  Dispatcher in executeToolCall switch statement that routes 'list_memories' calls to the listMemories handler.

  case 'list_memories':
    return await listMemories(args as any) as CallToolResult;

• src/tools/memory/listMemories.ts:3-3 (helper)

  Import of MemoryManager, the underlying helper used by listMemories to access stored memories.

  import { MemoryManager } from '../../lib/MemoryManager.js';