get_conversation_snapshot

Capture current conversation context for resuming discussions or analyzing architectural decisions. Specify recent turn count to control snapshot scope.

Instructions

Phase 3: Get current conversation context snapshot for resumption or analysis

Input Schema

TableJSON Schema

Name	Required	Description	Default
`recentTurnCount`	No	Number of recent turns to include

Implementation Reference

src/tools/conversation-memory-tool.ts:177-260 (handler)

The primary handler implementation for the 'get_conversation_snapshot' tool. This async function receives arguments (recentTurnCount optional), retrieves a context snapshot from the ConversationMemoryManager, and formats a comprehensive markdown report including session ID, recent turns, active intents, recorded decisions, and conversation focus.

export async function getConversationSnapshot(
  args: {
    recentTurnCount?: number;
  },
  memoryManager: ConversationMemoryManager
): Promise<CallToolResult> {
  try {
    const snapshot = await memoryManager.getContextSnapshot(args.recentTurnCount ?? 5);

    if (!snapshot) {
      return {
        content: [
          {
            type: 'text',
            text: 'No active conversation session found.',
          },
        ],
      };
    }

    let output = `# Conversation Context Snapshot\n\n`;
    output += `**Session ID**: ${snapshot.sessionId}\n\n`;

    // Recent turns
    output += `## Recent Turns (${snapshot.recentTurns.length})\n\n`;
    snapshot.recentTurns.forEach(turn => {
      output += `### Turn ${turn.turnNumber} - ${turn.timestamp}\n`;
      output += `- **Request**: ${turn.request.toolName || 'message'}\n`;
      output += `- **Tokens**: ${turn.response.tokenCount}\n`;
      if (turn.response.expandableId) {
        output += `- **Expandable ID**: ${turn.response.expandableId}\n`;
      }
      output += `\n`;
    });

    // Active intents
    if (snapshot.activeIntents.length > 0) {
      output += `## Active Knowledge Graph Intents\n\n`;
      snapshot.activeIntents.forEach(intent => {
        output += `- **${intent.intent}**: ${intent.status}\n`;
      });
      output += `\n`;
    }

    // Decisions recorded
    if (snapshot.decisionsRecorded.length > 0) {
      output += `## Decisions Recorded\n\n`;
      snapshot.decisionsRecorded.forEach(decision => {
        output += `- **${decision.title}** (${decision.adrId}) - ${decision.timestamp}\n`;
      });
      output += `\n`;
    }

    // Conversation focus
    if (snapshot.conversationFocus) {
      output += `## Conversation Focus\n\n`;
      output += `- **Topic**: ${snapshot.conversationFocus.topic}\n`;
      output += `- **Phase**: ${snapshot.conversationFocus.phase}\n`;
      output += `- **Next Steps**:\n`;
      snapshot.conversationFocus.nextSteps.forEach(step => {
        output += `  - ${step}\n`;
      });
    }

    return {
      content: [
        {
          type: 'text',
          text: output,
        },
      ],
    };
  } catch (error) {
    return {
      content: [
        {
          type: 'text',
          text: `❌ Failed to get conversation snapshot: ${error instanceof Error ? error.message : String(error)}`,
        },
      ],
      isError: true,
    };
  }
}

src/tools/tool-catalog.ts:941-958 (schema)

Central tool catalog metadata and input schema definition for 'get_conversation_snapshot'. Defines description, category ('memory'), complexity ('simple'), estimated token costs, related tools, and a basic input schema (note: catalog schema uses 'includeMetadata' while handler uses 'recentTurnCount'). Used for dynamic tool discovery and MCP ListTools responses.

TOOL_CATALOG.set('get_conversation_snapshot', {
  name: 'get_conversation_snapshot',
  shortDescription: 'Get conversation snapshot',
  fullDescription: 'Gets a snapshot of the current conversation state.',
  category: 'memory',
  complexity: 'simple',
  tokenCost: { min: 300, max: 800 },
  hasCEMCPDirective: true, // Phase 4.3: Simple tool - state snapshot
  relatedTools: ['query_conversation_history', 'get_memory_stats'],
  keywords: ['conversation', 'snapshot', 'state'],
  requiresAI: false,
  inputSchema: {
    type: 'object',
    properties: {
      includeMetadata: { type: 'boolean', default: false },
    },
  },
});

src/utils/server-context-generator.ts:329-331 (helper)
Tool listing entry in server context generator's hardcoded tool list under 'Memory & Context' category, used to generate human-readable documentation of available tools.
```
  name: 'get_conversation_snapshot',
  description: 'Get current conversation context snapshot',
},
```

mcp-adr-analysis-server