@everstateai/mcp 1.3.2 → 1.3.4

package/dist/setup/validators/mcp-config.js

@@ -0,0 +1,302 @@
+"use strict";
+/**
+ * MCP Configuration Validator
+ *
+ * Validates that all detected AI tools have correct MCP configuration.
+ * Uses the ToolEnvironment registry for multi-tool support.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mcpConfigValidator = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const types_js_1 = require("../types.js");
+const environments_js_1 = require("../environments.js");
+exports.mcpConfigValidator = {
+    name: 'MCP Configuration',
+    async validate(context) {
+        const results = [];
+        for (const env of environments_js_1.TOOL_ENVIRONMENTS) {
+            const toolResults = await validateToolConfig(env);
+            results.push(...toolResults);
+        }
+        return results;
+    },
+    async repair(result, context) {
+        if (result.repairAction?.type === 'install' || result.repairAction?.type === 'configure') {
+            const toolId = result.details?.toolId;
+            if (toolId) {
+                const env = environments_js_1.TOOL_ENVIRONMENTS.find((t) => t.id === toolId);
+                if (env) {
+                    return await repairToolConfig(env);
+                }
+            }
+            // Fallback: try to repair by check name (backwards compat)
+            if (result.check === 'Claude Code config' || result.check === 'Everstate MCP entry') {
+                const claudeCode = environments_js_1.TOOL_ENVIRONMENTS.find((t) => t.id === 'claude-code');
+                if (claudeCode)
+                    return await repairToolConfig(claudeCode);
+            }
+        }
+        return false;
+    },
+};
+/**
+ * Validate a single tool's MCP configuration.
+ */
+async function validateToolConfig(env) {
+    const results = [];
+    const configPath = env.getConfigPath();
+    // Skip tools without a config path (e.g. Linux Claude Desktop)
+    if (!configPath)
+        return results;
+    // If tool isn't installed, just note it
+    if (!env.isInstalled()) {
+        results.push({
+            component: 'MCP Config',
+            check: `${env.name}`,
+            status: 'warn',
+            message: `${env.name} not installed`,
+            details: { toolId: env.id, path: configPath },
+        });
+        return results;
+    }
+    // Check 1: Config file exists
+    if (!fs.existsSync(configPath)) {
+        results.push({
+            component: 'MCP Config',
+            check: `${env.name} config`,
+            status: 'fail',
+            message: `Config not found at ${configPath}`,
+            details: { toolId: env.id },
+            repairAction: {
+                type: 'install',
+                description: `Create ${env.name} configuration`,
+                automatic: true,
+            },
+        });
+        return results;
+    }
+    // Check 2: Valid JSON
+    let config;
+    try {
+        const content = fs.readFileSync(configPath, 'utf8');
+        config = JSON.parse(content);
+    }
+    catch (err) {
+        results.push({
+            component: 'MCP Config',
+            check: `${env.name} config`,
+            status: 'fail',
+            message: `Invalid JSON: ${err instanceof Error ? err.message : 'Parse error'}`,
+            details: { toolId: env.id },
+            repairAction: {
+                type: 'configure',
+                description: 'Fix JSON syntax or restore backup',
+                automatic: false,
+            },
+        });
+        return results;
+    }
+    results.push({
+        component: 'MCP Config',
+        check: `${env.name} config`,
+        status: 'pass',
+        message: `Valid at ${configPath}`,
+        details: { toolId: env.id },
+    });
+    // Check 3: mcpServers key exists
+    const mcpServers = config[env.mcpServersKey];
+    if (!mcpServers) {
+        results.push({
+            component: 'MCP Config',
+            check: `${env.name} mcpServers`,
+            status: 'fail',
+            message: `No ${env.mcpServersKey} section in config`,
+            details: { toolId: env.id },
+            repairAction: {
+                type: 'configure',
+                description: `Add ${env.mcpServersKey} configuration`,
+                automatic: true,
+            },
+        });
+        return results;
+    }
+    // Check 4: Everstate entry exists
+    const everstateConfig = mcpServers.everstate;
+    if (!everstateConfig) {
+        results.push({
+            component: 'MCP Config',
+            check: `${env.name} Everstate entry`,
+            status: 'fail',
+            message: `Everstate not configured in ${env.name}`,
+            details: { toolId: env.id },
+            repairAction: {
+                type: 'configure',
+                description: `Add Everstate MCP to ${env.name}`,
+                automatic: true,
+            },
+        });
+        return results;
+    }
+    results.push({
+        component: 'MCP Config',
+        check: `${env.name} Everstate entry`,
+        status: 'pass',
+        message: `Everstate configured in ${env.name}`,
+        details: { toolId: env.id },
+    });
+    // Check 5: Command is valid
+    const command = everstateConfig.command;
+    const args = everstateConfig.args;
+    if (command === 'npx' && args?.includes('@everstateai/mcp')) {
+        results.push({
+            component: 'MCP Config',
+            check: `${env.name} MCP command`,
+            status: 'pass',
+            message: 'Using npx @everstateai/mcp (recommended)',
+            details: { toolId: env.id },
+        });
+    }
+    else if (command === 'node') {
+        results.push({
+            component: 'MCP Config',
+            check: `${env.name} MCP command`,
+            status: 'warn',
+            message: 'Using local node path - consider using npx for auto-updates',
+            details: { toolId: env.id, command, args },
+        });
+    }
+    else {
+        results.push({
+            component: 'MCP Config',
+            check: `${env.name} MCP command`,
+            status: 'warn',
+            message: `Non-standard command: ${command}`,
+            details: { toolId: env.id, command, args },
+        });
+    }
+    // Check 6: API key (only for Claude Code which is the primary tool)
+    if (env.id === 'claude-code') {
+        const envVars = everstateConfig.env;
+        if (!envVars?.EVERSTATE_API_KEY) {
+            const apiKeyPath = `${(0, types_js_1.getEverstateDir)()}/api-key`;
+            if (!fs.existsSync(apiKeyPath)) {
+                results.push({
+                    component: 'MCP Config',
+                    check: 'API key configuration',
+                    status: 'fail',
+                    message: 'No API key in MCP config or key file',
+                    details: { toolId: env.id },
+                    repairAction: {
+                        type: 'configure',
+                        description: 'Configure API key',
+                        automatic: false,
+                    },
+                });
+            }
+            else {
+                results.push({
+                    component: 'MCP Config',
+                    check: 'API key configuration',
+                    status: 'pass',
+                    message: 'Using API key from file (hooks will read it)',
+                    details: { toolId: env.id },
+                });
+            }
+        }
+        else {
+            results.push({
+                component: 'MCP Config',
+                check: 'API key configuration',
+                status: 'pass',
+                message: 'API key configured in MCP env',
+                details: { toolId: env.id },
+            });
+        }
+    }
+    return results;
+}
+/**
+ * Repair a tool's MCP config by adding/fixing the Everstate entry.
+ */
+async function repairToolConfig(env) {
+    const configPath = env.getConfigPath();
+    if (!configPath)
+        return false;
+    try {
+        let config = {};
+        if (fs.existsSync(configPath)) {
+            try {
+                const content = fs.readFileSync(configPath, 'utf8');
+                config = JSON.parse(content);
+            }
+            catch {
+                // Invalid JSON - start fresh
+                config = {};
+            }
+            // Backup existing
+            fs.copyFileSync(configPath, `${configPath}.backup`);
+        }
+        if (!config[env.mcpServersKey]) {
+            config[env.mcpServersKey] = {};
+        }
+        const mcpServers = config[env.mcpServersKey];
+        const everstateEntry = {
+            command: 'npx',
+            args: ['-y', '@everstateai/mcp'],
+            env: {},
+        };
+        // Add API key if available
+        const apiKeyPath = `${(0, types_js_1.getEverstateDir)()}/api-key`;
+        if (fs.existsSync(apiKeyPath)) {
+            const apiKey = fs.readFileSync(apiKeyPath, 'utf8').trim();
+            if (apiKey) {
+                everstateEntry.env.EVERSTATE_API_KEY = apiKey;
+            }
+        }
+        mcpServers.everstate = everstateEntry;
+        const dir = path.dirname(configPath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=mcp-config.js.map

package/dist/setup/validators/mcp-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-config.js","sourceRoot":"","sources":["../../../src/setup/validators/mcp-config.ts"],"names":[],"mappings":"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"}

package/dist/setup/validators/project.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Project Validator
+ *
+ * Validates project-level configuration (.everstate.json).
+ */
+import { Validator } from '../types.js';
+export declare const projectValidator: Validator;
+//# sourceMappingURL=project.d.ts.map

package/dist/setup/validators/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../../src/setup/validators/project.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EACL,SAAS,EAIV,MAAM,aAAa,CAAC;AAErB,eAAO,MAAM,gBAAgB,EAAE,SAmK9B,CAAC"}

package/dist/setup/validators/project.js

@@ -0,0 +1,202 @@
+"use strict";
+/**
+ * Project Validator
+ *
+ * Validates project-level configuration (.everstate.json).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectValidator = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const types_js_1 = require("../types.js");
+exports.projectValidator = {
+    name: 'Project',
+    async validate(context) {
+        const results = [];
+        if (!context.projectDir) {
+            results.push({
+                component: 'Project',
+                check: 'Project directory',
+                status: 'warn',
+                message: 'No project directory specified (running globally)',
+            });
+            return results;
+        }
+        const configPath = path.join(context.projectDir, '.everstate.json');
+        // Check 1: Config file exists
+        if (!fs.existsSync(configPath)) {
+            results.push({
+                component: 'Project',
+                check: '.everstate.json exists',
+                status: 'fail',
+                message: `Not found at ${configPath}`,
+                repairAction: {
+                    type: 'install',
+                    description: 'Initialize project with everstate',
+                    automatic: false, // Requires user input for project name
+                },
+            });
+            return results;
+        }
+        results.push({
+            component: 'Project',
+            check: '.everstate.json exists',
+            status: 'pass',
+            message: `Found at ${configPath}`,
+        });
+        // Check 2: Valid JSON
+        let config;
+        try {
+            const content = fs.readFileSync(configPath, 'utf8');
+            config = JSON.parse(content);
+        }
+        catch (error) {
+            results.push({
+                component: 'Project',
+                check: '.everstate.json valid',
+                status: 'fail',
+                message: 'Invalid JSON syntax',
+                details: { error: String(error) },
+                repairAction: {
+                    type: 'configure',
+                    description: 'Fix JSON syntax in .everstate.json',
+                    automatic: false,
+                },
+            });
+            return results;
+        }
+        results.push({
+            component: 'Project',
+            check: '.everstate.json valid',
+            status: 'pass',
+            message: 'Valid JSON',
+        });
+        // Check 3: Has projectId
+        const projectId = config.projectId;
+        if (!projectId) {
+            results.push({
+                component: 'Project',
+                check: 'Project ID',
+                status: 'fail',
+                message: 'Missing projectId field',
+                repairAction: {
+                    type: 'configure',
+                    description: 'Add projectId to .everstate.json',
+                    automatic: false,
+                },
+            });
+            return results;
+        }
+        // Check 4: Valid projectId format
+        if (!projectId.startsWith('proj_')) {
+            results.push({
+                component: 'Project',
+                check: 'Project ID format',
+                status: 'warn',
+                message: `Unusual format: ${projectId} (expected proj_...)`,
+                details: { projectId },
+            });
+        }
+        else {
+            results.push({
+                component: 'Project',
+                check: 'Project ID format',
+                status: 'pass',
+                message: `Valid format: ${projectId.substring(0, 20)}...`,
+            });
+        }
+        // Check 5: Verify project exists on server (if not skipping network)
+        if (!context.skipNetwork && context.apiKey) {
+            try {
+                const response = await fetch(`${types_js_1.EVERSTATE_API_URL}/api/project/${projectId}`, {
+                    headers: {
+                        Authorization: `Bearer ${context.apiKey}`,
+                    },
+                });
+                if (response.ok) {
+                    const data = (await response.json());
+                    results.push({
+                        component: 'Project',
+                        check: 'Project exists on server',
+                        status: 'pass',
+                        message: `Project "${data.name || projectId}" found`,
+                    });
+                }
+                else if (response.status === 404) {
+                    results.push({
+                        component: 'Project',
+                        check: 'Project exists on server',
+                        status: 'warn',
+                        message: 'Project not found on server (may need to sync)',
+                        details: { projectId },
+                    });
+                }
+                else if (response.status === 401) {
+                    results.push({
+                        component: 'Project',
+                        check: 'Project exists on server',
+                        status: 'warn',
+                        message: 'Cannot verify - API key may not have access',
+                    });
+                }
+                else {
+                    results.push({
+                        component: 'Project',
+                        check: 'Project exists on server',
+                        status: 'warn',
+                        message: `Unexpected response: ${response.status}`,
+                    });
+                }
+            }
+            catch (error) {
+                results.push({
+                    component: 'Project',
+                    check: 'Project exists on server',
+                    status: 'warn',
+                    message: 'Could not verify (network error)',
+                    details: { error: String(error) },
+                });
+            }
+        }
+        return results;
+    },
+    async repair(result, context) {
+        // Project repairs typically require user input
+        // The setup command handles project initialization
+        return false;
+    },
+};
+//# sourceMappingURL=project.js.map

package/dist/setup/validators/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../../src/setup/validators/project.ts"],"names":[],"mappings":"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"}

package/dist/setup/version.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Version File Management
+ *
+ * Tracks installed component versions for upgrades and validation.
+ * Stored at ~/.everstate/version.json
+ */
+import { VersionFile, HOOK_VERSIONS } from './types.js';
+export { HOOK_VERSIONS };
+declare const VERSION_FILE_PATH: string;
+/**
+ * Get the current MCP proxy version from package.json
+ */
+export declare function getMcpProxyVersion(): string;
+/**
+ * Read the current version file
+ */
+export declare function readVersionFile(): VersionFile | null;
+/**
+ * Write the version file
+ */
+export declare function writeVersionFile(versionFile: VersionFile): boolean;
+/**
+ * Create a fresh version file with current versions
+ */
+export declare function createVersionFile(installedBy?: 'setup' | 'npx' | 'manual'): VersionFile;
+/**
+ * Update the version file after setup or repair
+ */
+export declare function updateVersionFile(updates: Partial<VersionFile>): boolean;
+/**
+ * Record a project installation
+ */
+export declare function recordProjectInstallation(projectId: string, configVersion: string, hooksVersion: string): boolean;
+/**
+ * Check if components need updating
+ */
+export declare function checkForUpdates(): {
+    needsUpdate: boolean;
+    outdated: string[];
+};
+export { VERSION_FILE_PATH };
+/**
+ * Server update info (matches dashboard UI)
+ */
+export interface ServerUpdate {
+    id: string;
+    version: string;
+    category: 'hooks' | 'mcp-proxy' | 'config';
+    title: string;
+    description: string;
+    breaking: boolean;
+}
+/**
+ * Check for updates from the Everstate server
+ * This is the same data shown in the dashboard UI
+ */
+export declare function checkServerUpdates(apiKey: string): Promise<ServerUpdate[]>;
+//# sourceMappingURL=version.d.ts.map

package/dist/setup/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/setup/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,WAAW,EAAE,aAAa,EAAuF,MAAM,YAAY,CAAC;AAG7I,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB,QAAA,MAAM,iBAAiB,QAAsC,CAAC;AAE9D;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAmB3C;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,WAAW,GAAG,IAAI,CAWpD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAiBlE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,GAAE,OAAO,GAAG,KAAK,GAAG,QAAkB,GAAG,WAAW,CAsBhG;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,OAAO,CA8BxE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,GACnB,OAAO,CAWT;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI;IACjC,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAkCA;AAoBD,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CA6BhF"}