@recall_v3/mcp-server 0.1.0 → 3.0.0

package/src/tools/getContext.ts

@@ -1,13 +1,13 @@
 /**
  * getContext Tool Implementation
  *
- * Fetches the team brain (context.md) for the current repository.
+ * Fetches the team brain (context) for the current repository from Recall v3 API.
  * This is the distilled current state - loaded at every session start.
  */
 
 import { RecallApiClient, AuthenticationError, RecallApiError } from '../api/client.js';
 import { getApiBaseUrl, getApiToken, getTeamKey, setTeamKey } from '../config/index.js';
-import { decryptContent } from '../crypto/index.js';
+import { decryptFromApi } from '../crypto/index.js';
 import { successResponse, errorResponse, formattedResponse, type ToolResponse } from './types.js';
 import { resolveProjectPath, getRepoInfo } from './utils.js';
 
@@ -15,11 +15,100 @@ export interface GetContextArgs {
   projectPath?: string;
 }
 
+interface SessionFromApi {
+  id: string;
+  encrypted_content: string;
+  started_at: string;
+  ended_at: string;
+  status: string;
+  tldr_summary: string | null;
+  user: {
+    id: string;
+    name: string | null;
+    github_username: string | null;
+    avatar_url: string | null;
+  };
+}
+
+interface ContextApiResponse {
+  sessions: SessionFromApi[];
+  cached_context: string;
+  updated_at: string;
+  session_count: number;
+  tier: string;
+}
+
+/**
+ * Build context markdown from sessions
+ */
+function buildContextFromSessions(
+  sessions: SessionFromApi[],
+  teamKey: string,
+  repoName: string
+): string {
+  const parts: string[] = [];
+
+  parts.push(`# Team Memory - ${repoName}`);
+  parts.push('');
+  parts.push(`Last updated: ${new Date().toISOString().split('T')[0]}`);
+  parts.push('');
+
+  if (sessions.length === 0) {
+    parts.push('No sessions recorded yet. Use `recall save` to save your first session.');
+    return parts.join('\n');
+  }
+
+  parts.push('## Recent Sessions');
+  parts.push('');
+
+  // Show last 10 sessions for context
+  const recentSessions = sessions.slice(0, 10);
+
+  for (const session of recentSessions) {
+    const date = session.started_at.split('T')[0];
+    const developer = session.user.github_username || session.user.name || 'Unknown';
+
+    parts.push(`### ${date} - ${developer}`);
+    parts.push('');
+
+    // Use TLDR summary for quick context
+    if (session.tldr_summary) {
+      parts.push(session.tldr_summary);
+      parts.push('');
+    }
+
+    // Try to decrypt and include full content if available
+    if (session.encrypted_content && session.encrypted_content.startsWith('RECALL_ENCRYPTED:')) {
+      try {
+        const decrypted = decryptFromApi(session.encrypted_content, teamKey);
+        parts.push(decrypted);
+        parts.push('');
+      } catch (error) {
+        // If decryption fails, just use the TLDR
+        if (!session.tldr_summary) {
+          parts.push('(Session content encrypted)');
+          parts.push('');
+        }
+      }
+    }
+
+    parts.push('---');
+    parts.push('');
+  }
+
+  if (sessions.length > 10) {
+    parts.push(`*${sessions.length - 10} more sessions available. Use recall_get_history for full history.*`);
+    parts.push('');
+  }
+
+  return parts.join('\n');
+}
+
 /**
  * Execute the getContext tool
  *
  * @param args - Tool arguments (projectPath is optional)
- * @returns MCP tool response with context.md content
+ * @returns MCP tool response with context content
  */
 export async function getContext(args: GetContextArgs): Promise<ToolResponse> {
   try {
@@ -61,25 +150,18 @@ export async function getContext(args: GetContextArgs): Promise<ToolResponse> {
     }
 
     // Fetch context from API
-    const response = await client.getContext(repoId);
-
-    // The contextMd comes encrypted from the API, decrypt it
-    let contextMd: string;
-    try {
-      // Check if content is encrypted
-      if (response.contextMd.startsWith('{') || response.contextMd.includes(':')) {
-        contextMd = decryptContent(response.contextMd, teamKey);
-      } else {
-        // Already plaintext (shouldn't happen, but handle gracefully)
-        contextMd = response.contextMd;
-      }
-    } catch (decryptError) {
-      // If decryption fails, it might already be plaintext
-      contextMd = response.contextMd;
-    }
+    const response = await client.getContextV3(repoId) as ContextApiResponse;
+
+    // Build context markdown from sessions
+    const contextMd = buildContextFromSessions(
+      response.sessions,
+      teamKey,
+      repoInfo.fullName
+    );
 
     // Format output with metadata
-    const header = `Reading from: ${projectPath}/.recall`;
+    const header = `# Team Memory (Recall)\n\nThe following is your team's shared context for this repository.\nUse this to understand what has been built, why decisions were made,\nand what mistakes to avoid.\n\n---`;
+
     return formattedResponse(header, contextMd);
 
   } catch (error) {

package/src/tools/getHistory.ts

@@ -1,13 +1,13 @@
 /**
  * getHistory Tool Implementation
  *
- * Fetches context.md + recent session history for the repository.
+ * Fetches context + recent session history for the repository from Recall v3 API.
  * This provides more detail than getContext but uses more tokens.
  */
 
 import { RecallApiClient, AuthenticationError, RecallApiError } from '../api/client.js';
 import { getApiBaseUrl, getApiToken, getTeamKey, setTeamKey } from '../config/index.js';
-import { decryptContent } from '../crypto/index.js';
+import { decryptFromApi } from '../crypto/index.js';
 import { successResponse, errorResponse, formattedResponse, type ToolResponse } from './types.js';
 import { resolveProjectPath, getRepoInfo } from './utils.js';
 
@@ -15,6 +15,151 @@ export interface GetHistoryArgs {
   projectPath: string;
 }
 
+interface SessionFromApi {
+  id: string;
+  encrypted_content: string;
+  started_at: string;
+  ended_at: string;
+  status: string;
+  tldr_summary: string | null;
+  user: {
+    id: string;
+    name: string | null;
+    github_username: string | null;
+    avatar_url: string | null;
+  };
+}
+
+interface DecisionFromApi {
+  id: string;
+  title: string;
+  encrypted_content: string;
+  created_at: string;
+  user: {
+    id: string;
+    name: string | null;
+    github_username: string | null;
+    avatar_url: string | null;
+  };
+}
+
+interface MistakeFromApi {
+  id: string;
+  title: string;
+  encrypted_content: string;
+  created_at: string;
+  user: {
+    id: string;
+    name: string | null;
+    github_username: string | null;
+    avatar_url: string | null;
+  };
+}
+
+interface HistoryApiResponse {
+  sessions: SessionFromApi[];
+  decisions: DecisionFromApi[];
+  mistakes: MistakeFromApi[];
+  token_warning?: string;
+}
+
+/**
+ * Build history markdown from API response
+ */
+function buildHistoryMarkdown(
+  response: HistoryApiResponse,
+  teamKey: string,
+  repoName: string
+): string {
+  const parts: string[] = [];
+
+  parts.push(`# Team Memory History - ${repoName}`);
+  parts.push('');
+  parts.push(`Generated: ${new Date().toISOString()}`);
+  parts.push('');
+
+  // Decisions section
+  if (response.decisions.length > 0) {
+    parts.push('## Key Decisions');
+    parts.push('');
+    for (const decision of response.decisions) {
+      const date = decision.created_at.split('T')[0];
+      const author = decision.user.github_username || decision.user.name || 'Unknown';
+      parts.push(`### ${date} - ${author}`);
+      parts.push('');
+      parts.push(`**${decision.title}**`);
+      parts.push('');
+
+      // Try to decrypt full content
+      if (decision.encrypted_content && decision.encrypted_content.startsWith('RECALL_ENCRYPTED:')) {
+        try {
+          const decrypted = decryptFromApi(decision.encrypted_content, teamKey);
+          parts.push(decrypted);
+        } catch {
+          // Use title only
+        }
+      }
+      parts.push('');
+    }
+    parts.push('---');
+    parts.push('');
+  }
+
+  // Mistakes section
+  if (response.mistakes.length > 0) {
+    parts.push('## Mistakes & Gotchas');
+    parts.push('');
+    parts.push('*Things the team learned the hard way - avoid repeating these.*');
+    parts.push('');
+    for (const mistake of response.mistakes) {
+      const date = mistake.created_at.split('T')[0];
+      const author = mistake.user.github_username || mistake.user.name || 'Unknown';
+      parts.push(`- **${mistake.title}** (${date}, ${author})`);
+    }
+    parts.push('');
+    parts.push('---');
+    parts.push('');
+  }
+
+  // Sessions section
+  parts.push('## Session History');
+  parts.push('');
+
+  if (response.sessions.length === 0) {
+    parts.push('No sessions recorded yet.');
+  } else {
+    for (const session of response.sessions) {
+      const date = session.started_at.split('T')[0];
+      const developer = session.user.github_username || session.user.name || 'Unknown';
+
+      parts.push(`### ${date} - ${developer}`);
+      parts.push('');
+
+      // TLDR summary
+      if (session.tldr_summary) {
+        parts.push(`**Summary:** ${session.tldr_summary}`);
+        parts.push('');
+      }
+
+      // Full content if available
+      if (session.encrypted_content && session.encrypted_content.startsWith('RECALL_ENCRYPTED:')) {
+        try {
+          const decrypted = decryptFromApi(session.encrypted_content, teamKey);
+          parts.push(decrypted);
+        } catch {
+          // Use TLDR only
+        }
+      }
+
+      parts.push('');
+      parts.push('---');
+      parts.push('');
+    }
+  }
+
+  return parts.join('\n');
+}
+
 /**
  * Execute the getHistory tool
  *
@@ -61,38 +206,19 @@ export async function getHistory(args: GetHistoryArgs): Promise<ToolResponse> {
     }
 
     // Fetch history from API
-    const response = await client.getHistory(repoId);
-
-    // Decrypt content
-    let contextMd: string;
-    let historyMd: string;
-
-    try {
-      // Decrypt context
-      if (response.contextMd.startsWith('{') || response.contextMd.includes(':')) {
-        contextMd = decryptContent(response.contextMd, teamKey);
-      } else {
-        contextMd = response.contextMd;
-      }
-
-      // Decrypt history
-      if (response.historyMd.startsWith('{') || response.historyMd.includes(':')) {
-        historyMd = decryptContent(response.historyMd, teamKey);
-      } else {
-        historyMd = response.historyMd;
-      }
-    } catch (decryptError) {
-      // If decryption fails, use as-is
-      contextMd = response.contextMd;
-      historyMd = response.historyMd;
-    }
+    const response = await client.getHistoryV3(repoId) as HistoryApiResponse;
 
-    // Combine context and history
-    const combinedContent = `# Recall Context\n\n${contextMd}\n\n---\n\n# Session History\n\n${historyMd}`;
+    // Build history markdown
+    const historyMd = buildHistoryMarkdown(response, teamKey, repoInfo.fullName);
 
     // Format output with metadata
-    const header = `Reading history from: ${projectPath}/.recall (${response.sessionCount} sessions)`;
-    return formattedResponse(header, combinedContent);
+    const sessionCount = response.sessions.length;
+    const decisionCount = response.decisions.length;
+    const mistakeCount = response.mistakes.length;
+
+    const header = `# Team Memory (Recall)\n\nRepository: ${repoInfo.fullName}\nSessions: ${sessionCount} | Decisions: ${decisionCount} | Mistakes: ${mistakeCount}\n\n---`;
+
+    return formattedResponse(header, historyMd);
 
   } catch (error) {
     if (error instanceof AuthenticationError) {

package/src/tools/getTranscripts.ts

@@ -123,7 +123,7 @@ export async function getTranscripts(args: GetTranscriptsArgs): Promise<ToolResp
     ].join('\n');
 
     // Format output
-    const header = `Reading full transcripts from: ${projectPath}/.recall`;
+    const header = `Full session transcripts for: ${repoInfo.fullName}`;
     return formattedResponse(header, combinedContent);
 
   } catch (error) {