@recall_v3/mcp-server 0.1.0 → 3.0.0

package/dist/config/index.d.ts

@@ -1,14 +1,21 @@
 /**
- * Recall Configuration Management
+ * Recall v3 Configuration Management
  *
- * Manages the local config file at ~/.recall/config.json.
+ * Manages the local config file at ~/.config/recall/config.json.
+ * This is intentionally SEPARATE from v2's ~/.recall/ directory.
  * Handles secure storage of API tokens and team keys.
  */
 import type { RecallConfig } from '@recall_v3/shared';
 /**
- * Get the path to the Recall config directory
+ * Get the path to the Recall v3 config directory
+ * Uses ~/.config/recall/ (XDG-compliant, separate from v2)
  */
 export declare function getConfigDir(): string;
+/**
+ * Get the path to the legacy v2 config directory
+ * (used only for migration checking)
+ */
+export declare function getLegacyConfigDir(): string;
 /**
  * Get the path to the config file
  */

package/dist/config/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAQtD;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAwCD;;;GAGG;AACH,wBAAgB,UAAU,IAAI,YAAY,CAwBzC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAe9D;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAQtC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,GAAG,IAAI,CAS3C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAE/C;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,GAAG,IAAI,CAG/C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEpD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAErD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGxD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAI5D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAEpG;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAErD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,IAAI,CAQhC;AAED;;;GAGG;AACH,MAAM,WAAW,cAAe,SAAQ,YAAY;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAOlD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AActD;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAqGD;;;GAGG;AACH,wBAAgB,UAAU,IAAI,YAAY,CA2BzC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAe9D;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAQtC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,GAAG,IAAI,CAS3C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAE/C;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,GAAG,IAAI,CAG/C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEpD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAErD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGxD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAI5D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAEpG;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAErD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,IAAI,CAQhC;AAED;;;GAGG;AACH,MAAM,WAAW,cAAe,SAAQ,YAAY;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAOlD"}

package/dist/config/index.js

@@ -1,8 +1,9 @@
 "use strict";
 /**
- * Recall Configuration Management
+ * Recall v3 Configuration Management
  *
- * Manages the local config file at ~/.recall/config.json.
+ * Manages the local config file at ~/.config/recall/config.json.
+ * This is intentionally SEPARATE from v2's ~/.recall/ directory.
  * Handles secure storage of API tokens and team keys.
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
@@ -40,6 +41,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getConfigDir = getConfigDir;
+exports.getLegacyConfigDir = getLegacyConfigDir;
 exports.getConfigPath = getConfigPath;
 exports.loadConfig = loadConfig;
 exports.saveConfig = saveConfig;
@@ -63,11 +65,23 @@ const os = __importStar(require("node:os"));
 const CONFIG_VERSION = 1;
 // Default API base URL (v3)
 const DEFAULT_API_BASE_URL = 'https://api-v3.recall.team';
+// v3 uses ~/.config/recall/ (XDG-compliant, separate from v2's ~/.recall/)
+const V3_CONFIG_DIR = path.join(os.homedir(), '.config', 'recall');
+// v2 used ~/.recall/ - we check this for migration
+const V2_CONFIG_DIR = path.join(os.homedir(), '.recall');
 /**
- * Get the path to the Recall config directory
+ * Get the path to the Recall v3 config directory
+ * Uses ~/.config/recall/ (XDG-compliant, separate from v2)
  */
 function getConfigDir() {
-    return path.join(os.homedir(), '.recall');
+    return V3_CONFIG_DIR;
+}
+/**
+ * Get the path to the legacy v2 config directory
+ * (used only for migration checking)
+ */
+function getLegacyConfigDir() {
+    return V2_CONFIG_DIR;
 }
 /**
  * Get the path to the config file
@@ -108,11 +122,64 @@ function migrateConfig(config) {
     migrated.version = CONFIG_VERSION;
     return migrated;
 }
+/**
+ * Check if a config file at a given path is a v3 config
+ * v3 configs have teamKeys and a version field (v2 didn't)
+ */
+function isV3Config(config) {
+    // v3 configs always have version field
+    return typeof config.version === 'number' && config.version >= 1;
+}
+/**
+ * Migrate v3 config from old v2 location (~/.recall/) to new v3 location (~/.config/recall/)
+ * This only migrates if:
+ * 1. No config exists at new v3 location
+ * 2. A v3 config exists at old v2 location (has version field)
+ *
+ * v2 configs (without version field) are left alone - they belong to v2
+ */
+function migrateFromV2Location() {
+    const v3ConfigPath = getConfigPath();
+    const v2ConfigPath = path.join(getLegacyConfigDir(), 'config.json');
+    // If v3 config already exists at new location, nothing to migrate
+    if (fs.existsSync(v3ConfigPath)) {
+        return;
+    }
+    // If no config exists at old v2 location, nothing to migrate
+    if (!fs.existsSync(v2ConfigPath)) {
+        return;
+    }
+    try {
+        const raw = fs.readFileSync(v2ConfigPath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        // Only migrate if it's a v3 config (has version field)
+        // v2 configs don't have version field and belong to v2
+        if (!isV3Config(parsed)) {
+            return;
+        }
+        // This is a v3 config in the old location - migrate it
+        console.log(`[Recall v3] Migrating config from ~/.recall/ to ~/.config/recall/`);
+        // Ensure new directory exists
+        ensureConfigDir();
+        // Copy config to new location
+        fs.writeFileSync(v3ConfigPath, JSON.stringify(parsed, null, 2), { mode: 0o600 });
+        // Remove config from old location (but leave other v2 artifacts)
+        // Note: We only remove config.json, not the whole directory
+        fs.unlinkSync(v2ConfigPath);
+        console.log(`[Recall v3] Migration complete. v3 config is now at ~/.config/recall/config.json`);
+    }
+    catch (error) {
+        // Migration failed - not critical, user can manually migrate
+        console.warn(`[Recall v3] Could not migrate config from ~/.recall/ (non-critical)`);
+    }
+}
 /**
  * Load configuration from disk
  * Returns a default config if the file doesn't exist
  */
 function loadConfig() {
+    // First, try to migrate from old v2 location if needed
+    migrateFromV2Location();
     const configPath = getConfigPath();
     if (!fs.existsSync(configPath)) {
         return createDefaultConfig();

package/dist/crypto/index.d.ts

@@ -53,4 +53,14 @@ export declare function decryptContent(encrypted: string, keyBase64: string): st
  * Encrypt content and return as JSON string
  */
 export declare function encryptContent(plaintext: string, keyBase64: string): string;
+/**
+ * Encrypt content and return in Recall format: RECALL_ENCRYPTED:v1:iv:tag:ciphertext
+ * This is the format expected by the v3 API.
+ */
+export declare function encryptForApi(plaintext: string, keyBase64: string): string;
+/**
+ * Decrypt content in Recall format: RECALL_ENCRYPTED:v1:iv:tag:ciphertext
+ * This is the format returned by the v3 API.
+ */
+export declare function decryptFromApi(encrypted: string, keyBase64: string): string;
 //# sourceMappingURL=index.d.ts.map

package/dist/crypto/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/crypto/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAO1D;;GAEG;AACH,wBAAgB,UAAU,IAAI,UAAU,CAEvC;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAGpC;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,gBAAgB,CA+B9E;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CA0C5E;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAWxE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAEpE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CA8BtD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAY3E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAG3E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/crypto/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAO1D;;GAEG;AACH,wBAAgB,UAAU,IAAI,UAAU,CAEvC;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAGpC;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,gBAAgB,CA+B9E;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CA0C5E;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAWxE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAEpE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CA8BtD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAY3E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAG3E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAG1E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAkB3E"}

package/dist/crypto/index.js

@@ -48,6 +48,8 @@ exports.serializeEncrypted = serializeEncrypted;
 exports.isEncryptedString = isEncryptedString;
 exports.decryptContent = decryptContent;
 exports.encryptContent = encryptContent;
+exports.encryptForApi = encryptForApi;
+exports.decryptFromApi = decryptFromApi;
 const crypto = __importStar(require("node:crypto"));
 // AES-256-GCM constants
 const ALGORITHM = 'aes-256-gcm';
@@ -222,3 +224,30 @@ function encryptContent(plaintext, keyBase64) {
     const payload = encrypt(plaintext, keyBase64);
     return JSON.stringify(payload);
 }
+/**
+ * Encrypt content and return in Recall format: RECALL_ENCRYPTED:v1:iv:tag:ciphertext
+ * This is the format expected by the v3 API.
+ */
+function encryptForApi(plaintext, keyBase64) {
+    const payload = encrypt(plaintext, keyBase64);
+    return `RECALL_ENCRYPTED:v1:${payload.iv}:${payload.tag}:${payload.ciphertext}`;
+}
+/**
+ * Decrypt content in Recall format: RECALL_ENCRYPTED:v1:iv:tag:ciphertext
+ * This is the format returned by the v3 API.
+ */
+function decryptFromApi(encrypted, keyBase64) {
+    if (!encrypted.startsWith('RECALL_ENCRYPTED:')) {
+        throw new Error('Invalid encrypted format: must start with RECALL_ENCRYPTED:');
+    }
+    const parts = encrypted.split(':');
+    if (parts.length !== 5) {
+        throw new Error('Invalid encrypted format: expected RECALL_ENCRYPTED:v1:iv:tag:ciphertext');
+    }
+    const [, version, iv, tag, ciphertext] = parts;
+    if (version !== 'v1') {
+        throw new Error(`Unsupported encryption version: ${version}`);
+    }
+    const payload = { iv, tag, ciphertext };
+    return decrypt(payload, keyBase64);
+}

package/dist/index.js

@@ -16,8 +16,8 @@ const index_js_2 = require("./tools/index.js");
 // Tool definitions
 const TOOLS = [
     {
-        name: 'recall_get_context',
-        description: "Get team brain (context.md) for the current repository. This is the distilled current state - loads automatically at every session start. Use recall_get_history for the full encyclopedia.",
+        name: 'recall3_get_context',
+        description: "Get team brain (context.md) for the current repository. This is the distilled current state - loads automatically at every session start. Use recall3_get_history for the full encyclopedia.",
         inputSchema: {
             type: 'object',
             properties: {
@@ -29,8 +29,8 @@ const TOOLS = [
         },
     },
     {
-        name: 'recall_get_history',
-        description: "Get detailed session history (context.md + recent sessions). This includes more context than recall_get_context but uses more tokens.",
+        name: 'recall3_get_history',
+        description: "Get detailed session history (context.md + recent sessions). This includes more context than recall3_get_context but uses more tokens.",
         inputSchema: {
             type: 'object',
             properties: {
@@ -43,7 +43,7 @@ const TOOLS = [
         },
     },
     {
-        name: 'recall_get_transcripts',
+        name: 'recall3_get_transcripts',
         description: "Get full session transcripts (context.md + history.md). WARNING: This can be very large and use many tokens. Only use when you need complete historical details.",
         inputSchema: {
             type: 'object',
@@ -57,7 +57,7 @@ const TOOLS = [
         },
     },
     {
-        name: 'recall_save_session',
+        name: 'recall3_save_session',
         description: "Save a summary of what was accomplished in this coding session. This updates the team memory files.",
         inputSchema: {
             type: 'object',
@@ -101,7 +101,7 @@ const TOOLS = [
         },
     },
     {
-        name: 'recall_log_decision',
+        name: 'recall3_log_decision',
         description: "Log an important decision made during coding. Quick way to capture why something was done.",
         inputSchema: {
             type: 'object',
@@ -143,19 +143,19 @@ class RecallMCPServer {
             try {
                 let result;
                 switch (name) {
-                    case 'recall_get_context':
+                    case 'recall3_get_context':
                         result = await (0, index_js_2.getContext)(args);
                         break;
-                    case 'recall_get_history':
+                    case 'recall3_get_history':
                         result = await (0, index_js_2.getHistory)(args);
                         break;
-                    case 'recall_get_transcripts':
+                    case 'recall3_get_transcripts':
                         result = await (0, index_js_2.getTranscripts)(args);
                         break;
-                    case 'recall_save_session':
+                    case 'recall3_save_session':
                         result = await (0, index_js_2.saveSession)(args);
                         break;
-                    case 'recall_log_decision':
+                    case 'recall3_log_decision':
                         result = await (0, index_js_2.logDecision)(args);
                         break;
                     default:

package/dist/tools/getContext.d.ts

@@ -1,7 +1,7 @@
 /**
  * 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 { type ToolResponse } from './types.js';
@@ -12,7 +12,7 @@ export interface GetContextArgs {
  * 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 declare function getContext(args: GetContextArgs): Promise<ToolResponse>;
 //# sourceMappingURL=getContext.d.ts.map

package/dist/tools/getContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getContext.d.ts","sourceRoot":"","sources":["../../src/tools/getContext.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAqD,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAGlG,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAkF5E"}
+{"version":3,"file":"getContext.d.ts","sourceRoot":"","sources":["../../src/tools/getContext.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAqD,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAGlG,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA2FD;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CA2E5E"}

package/dist/tools/getContext.js

@@ -2,7 +2,7 @@
 /**
  * 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.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
@@ -12,11 +12,62 @@ const index_js_1 = require("../config/index.js");
 const index_js_2 = require("../crypto/index.js");
 const types_js_1 = require("./types.js");
 const utils_js_1 = require("./utils.js");
+/**
+ * Build context markdown from sessions
+ */
+function buildContextFromSessions(sessions, teamKey, repoName) {
+    const parts = [];
+    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 = (0, index_js_2.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
  */
 async function getContext(args) {
     try {
@@ -48,25 +99,11 @@ async function getContext(args) {
             (0, index_js_1.setTeamKey)(teamId, teamKey);
         }
         // Fetch context from API
-        const response = await client.getContext(repoId);
-        // The contextMd comes encrypted from the API, decrypt it
-        let contextMd;
-        try {
-            // Check if content is encrypted
-            if (response.contextMd.startsWith('{') || response.contextMd.includes(':')) {
-                contextMd = (0, index_js_2.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);
+        // 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 (0, types_js_1.formattedResponse)(header, contextMd);
     }
     catch (error) {

package/dist/tools/getHistory.d.ts

@@ -1,7 +1,7 @@
 /**
  * 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 { type ToolResponse } from './types.js';

package/dist/tools/getHistory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getHistory.d.ts","sourceRoot":"","sources":["../../src/tools/getHistory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAqD,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAGlG,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CA8F5E"}
+{"version":3,"file":"getHistory.d.ts","sourceRoot":"","sources":["../../src/tools/getHistory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAqD,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAGlG,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;CACrB;AAmJD;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CA2E5E"}

package/dist/tools/getHistory.js

@@ -2,7 +2,7 @@
 /**
  * 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.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
@@ -12,6 +12,90 @@ const index_js_1 = require("../config/index.js");
 const index_js_2 = require("../crypto/index.js");
 const types_js_1 = require("./types.js");
 const utils_js_1 = require("./utils.js");
+/**
+ * Build history markdown from API response
+ */
+function buildHistoryMarkdown(response, teamKey, repoName) {
+    const parts = [];
+    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 = (0, index_js_2.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 = (0, index_js_2.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
  *
@@ -48,36 +132,15 @@ async function getHistory(args) {
             (0, index_js_1.setTeamKey)(teamId, teamKey);
         }
         // Fetch history from API
-        const response = await client.getHistory(repoId);
-        // Decrypt content
-        let contextMd;
-        let historyMd;
-        try {
-            // Decrypt context
-            if (response.contextMd.startsWith('{') || response.contextMd.includes(':')) {
-                contextMd = (0, index_js_2.decryptContent)(response.contextMd, teamKey);
-            }
-            else {
-                contextMd = response.contextMd;
-            }
-            // Decrypt history
-            if (response.historyMd.startsWith('{') || response.historyMd.includes(':')) {
-                historyMd = (0, index_js_2.decryptContent)(response.historyMd, teamKey);
-            }
-            else {
-                historyMd = response.historyMd;
-            }
-        }
-        catch (decryptError) {
-            // If decryption fails, use as-is
-            contextMd = response.contextMd;
-            historyMd = response.historyMd;
-        }
-        // Combine context and history
-        const combinedContent = `# Recall Context\n\n${contextMd}\n\n---\n\n# Session History\n\n${historyMd}`;
+        const response = await client.getHistoryV3(repoId);
+        // 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 (0, types_js_1.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 (0, types_js_1.formattedResponse)(header, historyMd);
     }
     catch (error) {
         if (error instanceof client_js_1.AuthenticationError) {

package/dist/tools/getTranscripts.js

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

package/dist/tools/saveSession.d.ts

@@ -2,11 +2,16 @@
  * saveSession Tool Implementation
  *
  * Saves a summary of what was accomplished in this coding session.
- * Updates the team memory files via the Recall API.
+ * Encrypts content with team key and sends to Recall v3 API.
  */
 import { type ToolResponse } from './types.js';
 export interface SaveSessionArgs {
-    summary: string;
+    /** Pre-written summary (if transcript not provided) */
+    summary?: string;
+    /** Raw conversation transcript - will be summarized by AI */
+    transcript?: string;
+    /** Git repository path (defaults to cwd if not provided) */
+    projectPath?: string;
     decisions?: Array<{
         what: string;
         why: string;
@@ -19,7 +24,7 @@ export interface SaveSessionArgs {
 /**
  * Execute the saveSession tool
  *
- * @param args - Tool arguments with session summary and metadata
+ * @param args - Tool arguments with session summary/transcript and metadata
  * @returns MCP tool response with save confirmation
  */
 export declare function saveSession(args: SaveSessionArgs): Promise<ToolResponse>;

package/dist/tools/saveSession.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"saveSession.d.ts","sourceRoot":"","sources":["../../src/tools/saveSession.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAkC,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/E,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;KACb,CAAC,CAAC;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC,CA8H9E"}
+{"version":3,"file":"saveSession.d.ts","sourceRoot":"","sources":["../../src/tools/saveSession.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAkC,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/E,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;KACb,CAAC,CAAC;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA4JD;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC,CAwM9E"}