Hi-AI

Instructions

Implementation Reference

• src/tools/memory/startSession.ts:58-122 (handler)

  The async handler function `startSession` that implements the core logic for the `start_session` tool. It loads project memories, coding guides, and previous session context based on input parameters, constructs a session summary, and returns it as a ToolResult.
  export async function startSession(args: { greeting?: string; loadMemory?: boolean; loadGuides?: boolean; restoreContext?: boolean }): Promise<ToolResult> { const { greeting = '', loadMemory = true, loadGuides: shouldLoadGuides = true, restoreContext = true } = args; try { const memoryManager = MemoryManager.getInstance(); let summary = `${greeting ? greeting + '! ' : ''}Session started.\n`; // Load relevant project memories if (loadMemory) { const projectMemories = memoryManager.list('project'); const codeMemories = memoryManager.list('code'); const memories = [...projectMemories, ...codeMemories].slice(0, 5); if (memories.length > 0) { summary += `\nRecent Project Info:\n`; memories.forEach(mem => { const preview = mem.value.substring(0, 80); summary += ` • ${mem.key}: ${preview}${mem.value.length > 80 ? '...' : ''}\n`; }); } } // Load coding guides if (shouldLoadGuides) { const allGuides = await loadGuides(); const guides = allGuides .sort((a, b) => new Date(b.lastUpdated).getTime() - new Date(a.lastUpdated).getTime()) .slice(0, 3); if (guides.length > 0) { summary += `\nActive Coding Guides:\n`; guides.forEach(guide => { summary += ` • ${guide.name} (${guide.category}): ${guide.description}\n`; }); } } // Restore context if (restoreContext) { const contextMemories = memoryManager.list('context').slice(0, 3); if (contextMemories.length > 0) { summary += `\nPrevious Context:\n`; contextMemories.forEach(ctx => { try { const data = JSON.parse(ctx.value); summary += ` • ${data.urgency?.toUpperCase() || 'MEDIUM'} priority from ${new Date(ctx.timestamp).toLocaleString()}\n`; } catch { summary += ` • Context from ${new Date(ctx.timestamp).toLocaleString()}\n`; } }); } } summary += '\nReady to continue development! What would you like to work on?'; return { content: [{ type: 'text', text: summary }] }; } catch (error) { return { content: [{ type: 'text', text: `${greeting ? greeting + '! ' : ''}Session started.\n\nReady to begin! What can I help you with?` }] }; } }
• src/tools/memory/startSession.ts:39-56 (schema)

  The `ToolDefinition` object `startSessionDefinition` defining the `start_session` tool, including name, description, inputSchema with parameters like greeting, loadMemory, loadGuides, restoreContext, and annotations.
  export const startSessionDefinition: ToolDefinition = { name: 'start_session', description: 'hi-ai|hello|start|begin session - Start session with context', inputSchema: { type: 'object', properties: { greeting: { type: 'string', description: 'Greeting message that triggered this action (e.g., "hi-ai", "hello")' }, loadMemory: { type: 'boolean', description: 'Load relevant project memories (default: true)' }, loadGuides: { type: 'boolean', description: 'Load applicable coding guides (default: true)' }, restoreContext: { type: 'boolean', description: 'Restore previous session context (default: true)' } }, required: [] }, annotations: { title: 'Start Session', audience: ['user', 'assistant'] } };
• src/index.ts:654-655 (registration)

  Registration of the `start_session` tool in the main switch statement that dispatches tool calls to the `startSession` handler function.
  case 'start_session': return await startSession(args as any) as CallToolResult;
• src/index.ts:134-134 (registration)

  Inclusion of `startSessionDefinition` in the `tools` array for tool listing and discovery.
  startSessionDefinition,
• src/index.ts:67-67 (registration)

  Import statement bringing in `startSession` handler and `startSessionDefinition` schema from the tool file.
  import { startSession, startSessionDefinition } from './tools/memory/startSession.js';