Hi-AI

Instructions

Implementation Reference

• src/tools/memory/recallMemory.ts:31-52 (handler)

  The handler function implementing the core logic of the 'recall_memory' tool. It retrieves a specific memory by key using MemoryManager, formats the result, and handles not-found or error cases.

  export async function recallMemory(args: { key: string; category?: string }): Promise<ToolResult> {
    const { key: recallKey } = args;
  
    try {
      const memoryManager = MemoryManager.getInstance();
      const memory = memoryManager.recall(recallKey);
  
      if (memory) {
        return {
          content: [{ type: 'text', text: `${memory.key}: ${memory.value}\n[${memory.category}]` }]
        };
      } else {
        return {
          content: [{ type: 'text', text: `✗ Not found: "${recallKey}"` }]
        };
      }
    } catch (error) {
      return {
        content: [{ type: 'text', text: `✗ Error: ${error instanceof Error ? error.message : 'Unknown error'}` }]
      };
    }
  }

• src/tools/memory/recallMemory.ts:6-29 (schema)

  The ToolDefinition schema defining the input schema, description, required parameters (key), optional (category), and annotations for the 'recall_memory' tool.

  export const recallMemoryDefinition: ToolDefinition = {
    name: 'recall_memory',
    description: `특정 메모리를 키로 조회합니다.
  
  키워드: 떠올려, recall, 기억나, remember what, what was, remind
  
  💡 전체 컨텍스트가 필요하면 get_session_context를 먼저 사용하세요.`,
    inputSchema: {
      type: 'object',
      properties: {
        key: { type: 'string', description: 'Memory key to retrieve' },
        category: { type: 'string', description: 'Memory category to search in' }
      },
      required: ['key']
    },
    annotations: {
      title: 'Recall Memory',
      audience: ['user', 'assistant'],
      readOnlyHint: true,
      destructiveHint: false,
      idempotentHint: true,
      openWorldHint: false
    }
  };

• src/index.ts:94-99 (registration)

  Registration of the recallMemoryDefinition in the 'tools' array, which is returned by ListToolsRequestHandler for tool discovery.

  saveMemoryDefinition,
  recallMemoryDefinition,
  updateMemoryDefinition,
  deleteMemoryDefinition,
  listMemoriesDefinition,
  prioritizeMemoryDefinition,

• src/index.ts:161-166 (registration)

  Registration of the recallMemory handler in the 'toolHandlers' object, used by CallToolRequestHandler for dynamic dispatch to execute the tool.

  'save_memory': saveMemory,
  'recall_memory': recallMemory,
  'update_memory': updateMemory,
  'delete_memory': deleteMemory,
  'list_memories': listMemories,
  'prioritize_memory': prioritizeMemory,

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

  Import statement bringing in the recallMemoryDefinition and recallMemory handler from the implementation file.

  import { recallMemoryDefinition, recallMemory } from './tools/memory/recallMemory.js';