@recall_v3/mcp-server 0.1.0

package/dist/api/client.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Recall API Client
+ *
+ * HTTP client for communicating with the Recall backend API.
+ * Handles authentication, retries, and error handling.
+ */
+import type { SummarizeRequest, SummarizeResponse, SaveSessionRequest, SaveSessionResponse, GetContextResponse, GetHistoryResponse, GetTranscriptsResponse, LogDecisionRequest, LogDecisionResponse, TeamKeyResponse, RecallStatusResponse, ListTeamsResponse } from '@recall_v3/shared';
+export declare class RecallApiError extends Error {
+    readonly code: string;
+    readonly statusCode?: number | undefined;
+    readonly retryable: boolean;
+    constructor(message: string, code: string, statusCode?: number | undefined, retryable?: boolean);
+}
+export declare class NetworkError extends RecallApiError {
+    readonly cause?: Error | undefined;
+    constructor(message: string, cause?: Error | undefined);
+}
+export declare class AuthenticationError extends RecallApiError {
+    constructor(message?: string);
+}
+export declare class TimeoutError extends RecallApiError {
+    constructor(message?: string);
+}
+interface RecallApiClientConfig {
+    baseUrl: string;
+    token: string;
+    timeout?: number;
+    maxRetries?: number;
+    retryBaseDelay?: number;
+}
+/**
+ * RecallApiClient - Thin HTTP client for Recall API
+ *
+ * Features:
+ * - Bearer token authentication
+ * - Exponential backoff retry on 5xx errors
+ * - Configurable timeout (default 30s)
+ * - Typed responses using @recall_v3/shared types
+ */
+export declare class RecallApiClient {
+    private readonly baseUrl;
+    private readonly token;
+    private readonly timeout;
+    private readonly maxRetries;
+    private readonly retryBaseDelay;
+    constructor(config: RecallApiClientConfig);
+    /**
+     * Internal fetch wrapper with timeout and retry logic
+     */
+    private request;
+    /**
+     * Calculate exponential backoff delay
+     */
+    private calculateBackoff;
+    /**
+     * Sleep for a given number of milliseconds
+     */
+    private sleep;
+    /**
+     * Summarize a session transcript
+     * Called by saveSession tool after reading JSONL from disk
+     */
+    summarize(request: SummarizeRequest): Promise<SummarizeResponse>;
+    /**
+     * Save a session with manual input (not from transcript)
+     * Used when user provides summary directly via MCP tool
+     */
+    saveSession(repoId: string, data: SaveSessionRequest): Promise<SaveSessionResponse>;
+    /**
+     * Get context for a repository (context.md)
+     * Returns the distilled team brain for this repo
+     */
+    getContext(repoId: string): Promise<GetContextResponse>;
+    /**
+     * Get history for a repository (context.md + history.md)
+     * Returns more detail than getContext
+     */
+    getHistory(repoId: string): Promise<GetHistoryResponse>;
+    /**
+     * Get full transcripts for a repository
+     * WARNING: Can be very large, uses many tokens
+     */
+    getTranscripts(repoId: string): Promise<GetTranscriptsResponse>;
+    /**
+     * Log a decision for a repository
+     */
+    logDecision(repoId: string, data: LogDecisionRequest): Promise<LogDecisionResponse>;
+    /**
+     * Get the encryption key for a team
+     * Used to decrypt content locally
+     */
+    getTeamKey(teamId: string): Promise<TeamKeyResponse>;
+    /**
+     * List teams the user belongs to
+     */
+    listTeams(): Promise<ListTeamsResponse>;
+    /**
+     * Get authentication status
+     */
+    getStatus(): Promise<RecallStatusResponse>;
+    /**
+     * Lookup or create repo by GitHub repo info
+     * Returns the repo ID for subsequent API calls
+     */
+    resolveRepo(fullName: string, defaultBranch?: string): Promise<{
+        repoId: string;
+        teamId: string;
+    }>;
+}
+export {};
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +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"}

package/dist/api/client.js

@@ -0,0 +1,244 @@
+"use strict";
+/**
+ * Recall API Client
+ *
+ * HTTP client for communicating with the Recall backend API.
+ * Handles authentication, retries, and error handling.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RecallApiClient = exports.TimeoutError = exports.AuthenticationError = exports.NetworkError = exports.RecallApiError = void 0;
+// Error types for the API client
+class RecallApiError extends Error {
+    code;
+    statusCode;
+    retryable;
+    constructor(message, code, statusCode, retryable = false) {
+        super(message);
+        this.code = code;
+        this.statusCode = statusCode;
+        this.retryable = retryable;
+        this.name = 'RecallApiError';
+    }
+}
+exports.RecallApiError = RecallApiError;
+class NetworkError extends RecallApiError {
+    cause;
+    constructor(message, cause) {
+        super(message, 'NETWORK_ERROR', undefined, true);
+        this.cause = cause;
+        this.name = 'NetworkError';
+    }
+}
+exports.NetworkError = NetworkError;
+class AuthenticationError extends RecallApiError {
+    constructor(message = 'Authentication failed') {
+        super(message, 'AUTH_ERROR', 401, false);
+        this.name = 'AuthenticationError';
+    }
+}
+exports.AuthenticationError = AuthenticationError;
+class TimeoutError extends RecallApiError {
+    constructor(message = 'Request timed out') {
+        super(message, 'TIMEOUT', undefined, true);
+        this.name = 'TimeoutError';
+    }
+}
+exports.TimeoutError = TimeoutError;
+/**
+ * RecallApiClient - Thin HTTP client for Recall API
+ *
+ * Features:
+ * - Bearer token authentication
+ * - Exponential backoff retry on 5xx errors
+ * - Configurable timeout (default 30s)
+ * - Typed responses using @recall_v3/shared types
+ */
+class RecallApiClient {
+    baseUrl;
+    token;
+    timeout;
+    maxRetries;
+    retryBaseDelay;
+    constructor(config) {
+        this.baseUrl = config.baseUrl.replace(/\/$/, ''); // Remove trailing slash
+        this.token = config.token;
+        this.timeout = config.timeout ?? 30000; // 30s default
+        this.maxRetries = config.maxRetries ?? 3;
+        this.retryBaseDelay = config.retryBaseDelay ?? 1000; // 1s base delay
+    }
+    /**
+     * Internal fetch wrapper with timeout and retry logic
+     */
+    async request(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        let lastError;
+        for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+            try {
+                const controller = new AbortController();
+                const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+                try {
+                    const response = await fetch(url, {
+                        method,
+                        headers: {
+                            'Content-Type': 'application/json',
+                            'Authorization': `Bearer ${this.token}`,
+                        },
+                        body: body ? JSON.stringify(body) : undefined,
+                        signal: controller.signal,
+                    });
+                    clearTimeout(timeoutId);
+                    // Handle non-OK responses
+                    if (!response.ok) {
+                        const errorBody = await response.json().catch(() => ({}));
+                        const errorCode = errorBody?.error?.code ?? 'UNKNOWN_ERROR';
+                        const errorMessage = errorBody?.error?.message ?? `HTTP ${response.status}`;
+                        // 401 = auth error, don't retry
+                        if (response.status === 401) {
+                            throw new AuthenticationError(errorMessage);
+                        }
+                        // 5xx = server error, retry with backoff
+                        if (response.status >= 500) {
+                            throw new RecallApiError(errorMessage, errorCode, response.status, true);
+                        }
+                        // 4xx = client error, don't retry
+                        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);
+                    }
+                    return data.data;
+                }
+                finally {
+                    clearTimeout(timeoutId);
+                }
+            }
+            catch (error) {
+                // Handle abort (timeout)
+                if (error instanceof Error && error.name === 'AbortError') {
+                    lastError = new TimeoutError();
+                    // Timeout is retryable
+                    if (attempt < this.maxRetries) {
+                        await this.sleep(this.calculateBackoff(attempt));
+                        continue;
+                    }
+                    throw lastError;
+                }
+                // Handle network errors
+                if (error instanceof TypeError && error.message.includes('fetch')) {
+                    lastError = new NetworkError('Network request failed', error);
+                    // Network errors are retryable
+                    if (attempt < this.maxRetries) {
+                        await this.sleep(this.calculateBackoff(attempt));
+                        continue;
+                    }
+                    throw lastError;
+                }
+                // Handle retryable API errors
+                if (error instanceof RecallApiError && error.retryable) {
+                    lastError = error;
+                    if (attempt < this.maxRetries) {
+                        await this.sleep(this.calculateBackoff(attempt));
+                        continue;
+                    }
+                    throw error;
+                }
+                // Non-retryable errors throw immediately
+                throw error;
+            }
+        }
+        // Should not reach here, but just in case
+        throw lastError ?? new RecallApiError('Unknown error', 'UNKNOWN_ERROR');
+    }
+    /**
+     * Calculate exponential backoff delay
+     */
+    calculateBackoff(attempt) {
+        // Exponential backoff: 1s, 2s, 4s, 8s...
+        const delay = this.retryBaseDelay * Math.pow(2, attempt);
+        // Add jitter (0-25% of delay)
+        const jitter = delay * Math.random() * 0.25;
+        return delay + jitter;
+    }
+    /**
+     * Sleep for a given number of milliseconds
+     */
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    // =========================================================================
+    // API Methods
+    // =========================================================================
+    /**
+     * Summarize a session transcript
+     * Called by saveSession tool after reading JSONL from disk
+     */
+    async summarize(request) {
+        return this.request('POST', '/api/v1/summarize', request);
+    }
+    /**
+     * Save a session with manual input (not from transcript)
+     * Used when user provides summary directly via MCP tool
+     */
+    async saveSession(repoId, data) {
+        return this.request('POST', `/api/v1/repos/${repoId}/sessions`, data);
+    }
+    /**
+     * Get context for a repository (context.md)
+     * Returns the distilled team brain for this repo
+     */
+    async getContext(repoId) {
+        return this.request('GET', `/api/v1/repos/${repoId}/context`);
+    }
+    /**
+     * Get history for a repository (context.md + history.md)
+     * Returns more detail than getContext
+     */
+    async getHistory(repoId) {
+        return this.request('GET', `/api/v1/repos/${repoId}/history`);
+    }
+    /**
+     * 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`);
+    }
+    /**
+     * Log a decision for a repository
+     */
+    async logDecision(repoId, data) {
+        return this.request('POST', `/api/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`);
+    }
+    /**
+     * List teams the user belongs to
+     */
+    async listTeams() {
+        return this.request('GET', '/api/v1/teams');
+    }
+    /**
+     * Get authentication status
+     */
+    async getStatus() {
+        return this.request('GET', '/api/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', {
+            fullName,
+            defaultBranch,
+        });
+    }
+}
+exports.RecallApiClient = RecallApiClient;

package/dist/config/index.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Recall Configuration Management
+ *
+ * Manages the local config file at ~/.recall/config.json.
+ * Handles secure storage of API tokens and team keys.
+ */
+import type { RecallConfig } from '@recall_v3/shared';
+/**
+ * Get the path to the Recall config directory
+ */
+export declare function getConfigDir(): string;
+/**
+ * Get the path to the config file
+ */
+export declare function getConfigPath(): string;
+/**
+ * Load configuration from disk
+ * Returns a default config if the file doesn't exist
+ */
+export declare function loadConfig(): RecallConfig;
+/**
+ * Save configuration to disk with secure permissions (0600)
+ */
+export declare function saveConfig(config: Partial<RecallConfig>): void;
+/**
+ * Get the API base URL from config or environment
+ */
+export declare function getApiBaseUrl(): string;
+/**
+ * Get the API token from config or environment
+ */
+export declare function getApiToken(): string | null;
+/**
+ * Store the API token securely
+ */
+export declare function setApiToken(token: string): void;
+/**
+ * Get the active team ID
+ */
+export declare function getActiveTeamId(): string | null;
+/**
+ * Set the active team ID for this session
+ */
+export declare function setActiveTeamId(teamId: string): void;
+/**
+ * Set the default team ID
+ */
+export declare function setDefaultTeamId(teamId: string): void;
+/**
+ * Get a cached team encryption key
+ */
+export declare function getTeamKey(teamId: string): string | null;
+/**
+ * Cache a team encryption key
+ */
+export declare function setTeamKey(teamId: string, key: string): void;
+/**
+ * Update cached user info
+ */
+export declare function setUserInfo(user: {
+    id: string;
+    email: string | null;
+    githubUsername: string;
+}): void;
+/**
+ * Update last sync timestamp
+ */
+export declare function setLastSyncAt(timestamp: string): void;
+/**
+ * Check if the user is authenticated (has a token)
+ */
+export declare function isAuthenticated(): boolean;
+/**
+ * Clear all authentication data (logout)
+ */
+export declare function clearAuth(): void;
+/**
+ * Extended config interface for the MCP client
+ * Adds computed properties and convenience methods
+ */
+export interface ExtendedConfig extends RecallConfig {
+    apiBaseUrl: string;
+    isAuthenticated: boolean;
+}
+/**
+ * Get the full extended config
+ */
+export declare function getExtendedConfig(): ExtendedConfig;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}