@recall_v3/mcp-server 0.1.0 → 3.0.0

package/README.md

@@ -0,0 +1,66 @@
+# @recall_v3/mcp-server
+
+Team memory for AI coding assistants. Recall captures session context, summarizes with AI, and makes it available to your whole team.
+
+## Installation
+
+```bash
+npx @recall_v3/mcp-server install
+```
+
+This will:
+1. Generate an API token
+2. Configure your Claude Code MCP settings
+3. Connect to your team's Recall workspace
+
+## Manual Configuration
+
+Add to your Claude Code MCP config (`~/.config/claude/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "recall": {
+      "command": "npx",
+      "args": ["@recall_v3/mcp-server"],
+      "env": {
+        "RECALL_API_TOKEN": "your_token_here"
+      }
+    }
+  }
+}
+```
+
+## Available Tools
+
+Once installed, the following MCP tools are available in Claude Code:
+
+| Tool | Description |
+|------|-------------|
+| `recall_get_context` | Load team context at session start |
+| `recall_get_history` | Get recent session summaries |
+| `recall_get_transcripts` | Deep dive into full transcripts (Pro) |
+| `recall_save_session` | Save session summary at end |
+| `recall_log_decision` | Log an important decision |
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `RECALL_API_TOKEN` | Your API token | Required |
+| `RECALL_API_URL` | API base URL | `https://api-v3.recall.team` |
+
+## Requirements
+
+- Node.js 18+
+- Claude Code or compatible MCP client
+
+## Links
+
+- [Documentation](https://v3.recall.team/docs)
+- [Dashboard](https://v3.recall.team/app)
+- [Support](mailto:support@recall.team)
+
+## License
+
+MIT

package/dist/api/client.d.ts

@@ -61,21 +61,123 @@ export declare class RecallApiClient {
      * Called by saveSession tool after reading JSONL from disk
      */
     summarize(request: SummarizeRequest): Promise<SummarizeResponse>;
+    /**
+     * Summarize a session transcript using the actual API format
+     * This bypasses the strict shared types which don't match the real API
+     * Uses 2 minute timeout since AI summarization can take time
+     */
+    summarizeRaw<TRequest, TResponse>(request: TRequest): Promise<TResponse>;
     /**
      * Save a session with manual input (not from transcript)
      * Used when user provides summary directly via MCP tool
+     * @deprecated Use saveSessionV3 for proper encrypted format
      */
     saveSession(repoId: string, data: SaveSessionRequest): Promise<SaveSessionResponse>;
+    /**
+     * Save a session with encrypted content (v3 format)
+     * This is the correct format for the v3 API
+     */
+    saveSessionV3(repoId: string, data: {
+        encrypted_content: string;
+        tldr: {
+            summary: string;
+            status: 'complete' | 'in-progress' | 'blocked';
+            decisions?: string[];
+            mistakes?: string[];
+            tags?: string[];
+            files_changed?: string[];
+            blockers?: string | null;
+            next_steps?: string | null;
+        };
+        started_at: string;
+        ended_at: string;
+        tool?: string;
+    }): Promise<{
+        id: string;
+        created_at: string;
+        warnings?: string[];
+    }>;
     /**
      * Get context for a repository (context.md)
      * Returns the distilled team brain for this repo
+     * @deprecated Use getContextV3 for proper v3 API format
      */
     getContext(repoId: string): Promise<GetContextResponse>;
+    /**
+     * Get context for a repository (v3 format)
+     * Returns sessions with encrypted content for client-side decryption
+     */
+    getContextV3(repoId: string): Promise<{
+        sessions: Array<{
+            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;
+            };
+        }>;
+        cached_context: string;
+        updated_at: string;
+        session_count: number;
+        tier: string;
+    }>;
     /**
      * Get history for a repository (context.md + history.md)
      * Returns more detail than getContext
+     * @deprecated Use getHistoryV3 for proper v3 API format
      */
     getHistory(repoId: string): Promise<GetHistoryResponse>;
+    /**
+     * Get history for a repository (v3 format)
+     * Returns sessions, decisions, and mistakes with encrypted content
+     */
+    getHistoryV3(repoId: string, days?: number): Promise<{
+        sessions: Array<{
+            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;
+            };
+        }>;
+        decisions: Array<{
+            id: string;
+            title: string;
+            encrypted_content: string;
+            created_at: string;
+            user: {
+                id: string;
+                name: string | null;
+                github_username: string | null;
+                avatar_url: string | null;
+            };
+        }>;
+        mistakes: Array<{
+            id: string;
+            title: string;
+            encrypted_content: string;
+            created_at: string;
+            user: {
+                id: string;
+                name: string | null;
+                github_username: string | null;
+                avatar_url: string | null;
+            };
+        }>;
+        token_warning?: string;
+    }>;
     /**
      * Get full transcripts for a repository
      * WARNING: Can be very large, uses many tokens

package/dist/api/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EAElB,MAAM,mBAAmB,CAAC;AAG3B,qBAAa,cAAe,SAAQ,KAAK;aAGrB,IAAI,EAAE,MAAM;aACZ,UAAU,CAAC,EAAE,MAAM;aACnB,SAAS,EAAE,OAAO;gBAHlC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,SAAS,GAAE,OAAe;CAK7C;AAED,qBAAa,YAAa,SAAQ,cAAc;aACD,KAAK,CAAC,EAAE,KAAK;gBAA9C,OAAO,EAAE,MAAM,EAAkB,KAAK,CAAC,EAAE,KAAK,YAAA;CAI3D;AAED,qBAAa,mBAAoB,SAAQ,cAAc;gBACzC,OAAO,GAAE,MAAgC;CAItD;AAED,qBAAa,YAAa,SAAQ,cAAc;gBAClC,OAAO,GAAE,MAA4B;CAIlD;AAGD,UAAU,qBAAqB;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAE5B,MAAM,EAAE,qBAAqB;IAQzC;;OAEG;YACW,OAAO;IAoGrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;OAEG;IACH,OAAO,CAAC,KAAK;IAQb;;;OAGG;IACG,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAItE;;;OAGG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAIzF;;;OAGG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAI7D;;;OAGG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAI7D;;;OAGG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAIrE;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAIzF;;;OAGG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAI1D;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAI7C;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAIhD;;;OAGG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAMzG"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"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"}

package/dist/api/client.js

@@ -69,13 +69,14 @@ class RecallApiClient {
     /**
      * Internal fetch wrapper with timeout and retry logic
      */
-    async request(method, path, body) {
+    async request(method, path, body, options) {
         const url = `${this.baseUrl}${path}`;
+        const timeout = options?.timeout ?? this.timeout;
         let lastError;
         for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
             try {
                 const controller = new AbortController();
-                const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+                const timeoutId = setTimeout(() => controller.abort(), timeout);
                 try {
                     const response = await fetch(url, {
                         method,
@@ -104,11 +105,18 @@ class RecallApiClient {
                         throw new RecallApiError(errorMessage, errorCode, response.status, false);
                     }
                     // Parse successful response
-                    const data = await response.json();
-                    if (!data.success && data.error) {
-                        throw new RecallApiError(data.error.message, data.error.code, response.status, false);
+                    // API may return { success: true, data: T } or T directly
+                    const rawData = await response.json();
+                    // Check if it's a wrapped response
+                    if (rawData && typeof rawData === 'object' && 'success' in rawData) {
+                        const wrapped = rawData;
+                        if (!wrapped.success && wrapped.error) {
+                            throw new RecallApiError(wrapped.error.message, wrapped.error.code, response.status, false);
+                        }
+                        return wrapped.data;
                     }
-                    return data.data;
+                    // Direct response (not wrapped)
+                    return rawData;
                 }
                 finally {
                     clearTimeout(timeoutId);
@@ -175,67 +183,108 @@ class RecallApiClient {
      * Called by saveSession tool after reading JSONL from disk
      */
     async summarize(request) {
-        return this.request('POST', '/api/v1/summarize', request);
+        return this.request('POST', '/v1/summarize', request);
+    }
+    /**
+     * Summarize a session transcript using the actual API format
+     * This bypasses the strict shared types which don't match the real API
+     * Uses 2 minute timeout since AI summarization can take time
+     */
+    async summarizeRaw(request) {
+        return this.request('POST', '/v1/summarize', request, { timeout: 120000 });
     }
     /**
      * Save a session with manual input (not from transcript)
      * Used when user provides summary directly via MCP tool
+     * @deprecated Use saveSessionV3 for proper encrypted format
      */
     async saveSession(repoId, data) {
-        return this.request('POST', `/api/v1/repos/${repoId}/sessions`, data);
+        return this.request('POST', `/v1/repos/${repoId}/sessions`, data);
+    }
+    /**
+     * Save a session with encrypted content (v3 format)
+     * This is the correct format for the v3 API
+     */
+    async saveSessionV3(repoId, data) {
+        return this.request('POST', `/v1/repos/${repoId}/sessions`, data);
     }
     /**
      * Get context for a repository (context.md)
      * Returns the distilled team brain for this repo
+     * @deprecated Use getContextV3 for proper v3 API format
      */
     async getContext(repoId) {
-        return this.request('GET', `/api/v1/repos/${repoId}/context`);
+        return this.request('GET', `/v1/repos/${repoId}/context`);
+    }
+    /**
+     * Get context for a repository (v3 format)
+     * Returns sessions with encrypted content for client-side decryption
+     */
+    async getContextV3(repoId) {
+        return this.request('GET', `/v1/repos/${repoId}/context`);
     }
     /**
      * Get history for a repository (context.md + history.md)
      * Returns more detail than getContext
+     * @deprecated Use getHistoryV3 for proper v3 API format
      */
     async getHistory(repoId) {
-        return this.request('GET', `/api/v1/repos/${repoId}/history`);
+        return this.request('GET', `/v1/repos/${repoId}/history`);
+    }
+    /**
+     * Get history for a repository (v3 format)
+     * Returns sessions, decisions, and mistakes with encrypted content
+     */
+    async getHistoryV3(repoId, days = 30) {
+        return this.request('GET', `/v1/repos/${repoId}/history?days=${days}`);
     }
     /**
      * Get full transcripts for a repository
      * WARNING: Can be very large, uses many tokens
      */
     async getTranscripts(repoId) {
-        return this.request('GET', `/api/v1/repos/${repoId}/transcripts`);
+        return this.request('GET', `/v1/repos/${repoId}/transcripts`);
     }
     /**
      * Log a decision for a repository
      */
     async logDecision(repoId, data) {
-        return this.request('POST', `/api/v1/repos/${repoId}/decisions`, data);
+        return this.request('POST', `/v1/repos/${repoId}/decisions`, data);
     }
     /**
      * Get the encryption key for a team
      * Used to decrypt content locally
      */
     async getTeamKey(teamId) {
-        return this.request('GET', `/api/v1/teams/${teamId}/key`);
+        // API returns { hasAccess, key, keyVersion, teamId, teamName, teamSlug, tier }
+        // Map to TeamKeyResponse type
+        const response = await this.request('GET', '/v1/keys/team');
+        return {
+            teamId: response.teamId,
+            encryptionKey: response.key,
+            keyVersion: response.keyVersion,
+            teamName: response.teamName,
+            tier: response.tier,
+        };
     }
     /**
      * List teams the user belongs to
      */
     async listTeams() {
-        return this.request('GET', '/api/v1/teams');
+        return this.request('GET', '/v1/teams');
     }
     /**
      * Get authentication status
      */
     async getStatus() {
-        return this.request('GET', '/api/v1/status');
+        return this.request('GET', '/v1/status');
     }
     /**
      * Lookup or create repo by GitHub repo info
      * Returns the repo ID for subsequent API calls
      */
     async resolveRepo(fullName, defaultBranch) {
-        return this.request('POST', '/api/v1/repos/resolve', {
+        return this.request('POST', '/v1/repos/resolve', {
             fullName,
             defaultBranch,
         });

package/dist/cli.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * Recall v3 CLI
+ *
+ * Command-line interface for Recall MCP operations.
+ * Used by Claude Code hooks and for manual operations.
+ *
+ * Commands:
+ *   recall-mcp context     Load and display team context
+ *   recall-mcp save        Save current session
+ *   recall-mcp status      Check authentication status
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;GAUG"}

package/dist/cli.js

@@ -0,0 +1,297 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Recall v3 CLI
+ *
+ * Command-line interface for Recall MCP operations.
+ * Used by Claude Code hooks and for manual operations.
+ *
+ * Commands:
+ *   recall-mcp context     Load and display team context
+ *   recall-mcp save        Save current session
+ *   recall-mcp status      Check authentication status
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const getContext_js_1 = require("./tools/getContext.js");
+const saveSession_js_1 = require("./tools/saveSession.js");
+const index_js_1 = require("./config/index.js");
+const client_js_1 = require("./api/client.js");
+// Parse command line arguments
+const args = process.argv.slice(2);
+const command = args[0];
+const flags = args.slice(1);
+// Check for --quiet flag
+const quiet = flags.includes('--quiet') || flags.includes('-q');
+// Helper to log only if not quiet
+function log(message) {
+    if (!quiet) {
+        console.log(message);
+    }
+}
+// Helper to log errors (always shown)
+function logError(message) {
+    console.error(message);
+}
+/**
+ * Parse --project-path flag from args
+ */
+function getProjectPathFromFlags(flagList) {
+    const projectPathIndex = flagList.findIndex(f => f === '--project-path' || f === '-p');
+    if (projectPathIndex !== -1 && flagList[projectPathIndex + 1]) {
+        return flagList[projectPathIndex + 1];
+    }
+    return undefined;
+}
+// Parse --project-path flag
+const projectPath = getProjectPathFromFlags(flags);
+/**
+ * Display usage information
+ */
+function showHelp() {
+    console.log(`
+Recall v3 CLI - Team memory for AI coding assistants
+
+Usage:
+  recall-mcp <command> [options]
+
+Commands:
+  context         Load team context for current repository
+  save            Save current session (with AI summarization)
+  status          Check authentication and connection status
+  help            Show this help message
+
+Options:
+  --quiet, -q              Suppress non-essential output
+  --summary, -s            Provide a manual summary (skips AI summarization)
+  --project-path, -p PATH  Specify the git repository path (defaults to cwd)
+
+Save Command:
+  The save command supports three modes:
+
+  1. AI Summarization (recommended):
+     echo "<conversation transcript>" | recall-mcp save
+     - Pipes conversation to API for AI-powered summarization
+     - Extracts decisions, mistakes, files changed automatically
+
+  2. Manual Summary:
+     recall-mcp save --summary "Fixed authentication bug"
+     - Use when you want to write your own summary
+
+  3. Placeholder (fallback):
+     recall-mcp save --quiet
+     - Saves minimal placeholder when no transcript available
+     - Used by Claude Code stop hooks as a backup
+
+Examples:
+  recall-mcp context                              # Load context at session start
+  recall-mcp save --quiet                         # Save session quietly (for hooks)
+  recall-mcp save --summary "Fixed X"             # Save with manual summary
+  cat transcript.txt | recall-mcp save            # Save with AI summarization
+  recall-mcp save -p /path/to/repo --quiet        # Save for specific repo (Claude Code hooks)
+  recall-mcp context --project-path /path/to/repo # Load context for specific repo
+  recall-mcp status                               # Check if properly configured
+
+Environment Variables:
+  RECALL_API_URL      API base URL (default: https://api-v3.recall.team)
+  RECALL_API_TOKEN    Authentication token (required)
+`);
+}
+/**
+ * Load and display team context
+ */
+async function runContext() {
+    try {
+        const result = await (0, getContext_js_1.getContext)({ projectPath });
+        if (result.isError) {
+            logError(`Error: ${result.content[0]?.text || 'Unknown error'}`);
+            process.exit(1);
+        }
+        // Output the context (always, even in quiet mode - it's the primary output)
+        console.log(result.content[0]?.text || '');
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        logError(`Failed to load context: ${message}`);
+        process.exit(1);
+    }
+}
+/**
+ * Read from stdin if available (non-blocking)
+ * Handles large transcripts (Claude Code sessions can be 1MB+)
+ */
+async function readStdin() {
+    return new Promise((resolve) => {
+        // Check if stdin has data (is a pipe, not TTY)
+        if (process.stdin.isTTY) {
+            resolve(null);
+            return;
+        }
+        const chunks = [];
+        let resolved = false;
+        // Initial timeout - wait up to 500ms for first data
+        let timeout = setTimeout(() => {
+            if (!resolved) {
+                resolved = true;
+                resolve(chunks.length > 0 ? chunks.join('') : null);
+            }
+        }, 500);
+        process.stdin.setEncoding('utf8');
+        process.stdin.on('data', (chunk) => {
+            // Clear and reset timeout on each chunk (allows large files)
+            clearTimeout(timeout);
+            chunks.push(chunk);
+            // Set a shorter timeout between chunks (100ms idle = end of data)
+            timeout = setTimeout(() => {
+                if (!resolved) {
+                    resolved = true;
+                    resolve(chunks.join(''));
+                }
+            }, 100);
+        });
+        process.stdin.on('end', () => {
+            clearTimeout(timeout);
+            if (!resolved) {
+                resolved = true;
+                resolve(chunks.length > 0 ? chunks.join('') : null);
+            }
+        });
+        process.stdin.on('error', () => {
+            clearTimeout(timeout);
+            if (!resolved) {
+                resolved = true;
+                resolve(null);
+            }
+        });
+        // Start reading
+        process.stdin.resume();
+    });
+}
+/**
+ * Save current session
+ *
+ * Supports two modes:
+ * 1. With transcript via stdin: `echo "conversation..." | recall-mcp save`
+ *    - Sends transcript to API for AI summarization
+ * 2. Without transcript: `recall-mcp save`
+ *    - Saves a minimal placeholder (fallback)
+ *
+ * Usage with --summary flag: `recall-mcp save --summary "What we did"`
+ */
+async function runSave() {
+    try {
+        // Check for --summary flag
+        const summaryIndex = flags.findIndex(f => f === '--summary' || f === '-s');
+        let providedSummary;
+        if (summaryIndex !== -1 && flags[summaryIndex + 1]) {
+            providedSummary = flags[summaryIndex + 1];
+        }
+        // Try to read transcript from stdin
+        const transcript = await readStdin();
+        // Build saveSession args
+        const saveArgs = {};
+        // Add project path if specified
+        if (projectPath) {
+            saveArgs.projectPath = projectPath;
+        }
+        if (transcript && transcript.trim().length >= 50) {
+            // We have a transcript - send it for AI summarization
+            saveArgs.transcript = transcript;
+            log('Summarizing session with AI...');
+        }
+        else if (providedSummary) {
+            // Use provided summary
+            saveArgs.summary = providedSummary;
+        }
+        else {
+            // Fallback to placeholder - this is the minimal save case
+            saveArgs.summary = 'Session auto-saved by Recall hook';
+        }
+        const result = await (0, saveSession_js_1.saveSession)(saveArgs);
+        if (result.isError) {
+            logError(`Error: ${result.content[0]?.text || 'Unknown error'}`);
+            process.exit(1);
+        }
+        log(result.content[0]?.text || 'Session saved');
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        logError(`Failed to save session: ${message}`);
+        process.exit(1);
+    }
+}
+/**
+ * Check authentication and connection status
+ */
+async function runStatus() {
+    try {
+        const token = (0, index_js_1.getApiToken)();
+        const baseUrl = (0, index_js_1.getApiBaseUrl)();
+        console.log('Recall v3 Status');
+        console.log('================');
+        console.log(`Config: ${(0, index_js_1.getConfigPath)()}`);
+        console.log(`API URL: ${baseUrl}`);
+        console.log(`Token: ${token ? `${token.substring(0, 10)}...` : 'Not set'}`);
+        if (!token) {
+            logError('\nError: RECALL_API_TOKEN not set');
+            logError(`Set the environment variable or configure ${(0, index_js_1.getConfigPath)()}`);
+            process.exit(1);
+        }
+        // Test API connection
+        const client = new client_js_1.RecallApiClient({
+            baseUrl,
+            token,
+        });
+        console.log('\nTesting API connection...');
+        try {
+            const teams = await client.listTeams();
+            console.log(`✓ Connected successfully`);
+            console.log(`✓ Teams: ${teams.teams?.length || 0}`);
+            if (teams.teams && teams.teams.length > 0) {
+                for (const team of teams.teams) {
+                    console.log(`  - ${team.name} (${team.role})`);
+                }
+            }
+        }
+        catch (apiError) {
+            const message = apiError instanceof Error ? apiError.message : 'Unknown error';
+            logError(`✗ API connection failed: ${message}`);
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        logError(`Status check failed: ${message}`);
+        process.exit(1);
+    }
+}
+/**
+ * Main entry point
+ */
+async function main() {
+    switch (command) {
+        case 'context':
+            await runContext();
+            break;
+        case 'save':
+            await runSave();
+            break;
+        case 'status':
+            await runStatus();
+            break;
+        case 'help':
+        case '--help':
+        case '-h':
+        case undefined:
+            showHelp();
+            break;
+        default:
+            logError(`Unknown command: ${command}`);
+            logError('Run "recall-mcp help" for usage information');
+            process.exit(1);
+    }
+}
+// Run CLI
+main().catch((error) => {
+    logError(`Fatal error: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    process.exit(1);
+});