@claudetools/tools 0.1.0

package/dist/setup.js

@@ -0,0 +1,206 @@
+// =============================================================================
+// ClaudeTools Memory Interactive Setup Wizard
+// =============================================================================
+// Guides users through initial configuration with validation
+import readline from 'readline';
+import { stdin as input, stdout as output } from 'process';
+import { loadConfigFromFile, saveConfig, ensureConfigDir, getConfigPath, DEFAULT_CONFIG, } from './helpers/config-manager.js';
+// -----------------------------------------------------------------------------
+// Prompt Helpers
+// -----------------------------------------------------------------------------
+/**
+ * Prompt user for input with optional default value
+ */
+function prompt(question, defaultValue) {
+    const rl = readline.createInterface({ input, output });
+    return new Promise((resolve) => {
+        const displayQuestion = defaultValue
+            ? `${question} [${defaultValue}]: `
+            : `${question}: `;
+        rl.question(displayQuestion, (answer) => {
+            rl.close();
+            resolve(answer.trim() || defaultValue || '');
+        });
+    });
+}
+/**
+ * Prompt user for yes/no confirmation
+ */
+async function confirm(question, defaultValue = true) {
+    const defaultStr = defaultValue ? 'Y/n' : 'y/N';
+    const answer = await prompt(`${question} (${defaultStr})`);
+    if (!answer) {
+        return defaultValue;
+    }
+    return answer.toLowerCase().startsWith('y');
+}
+// -----------------------------------------------------------------------------
+// API Validation
+// -----------------------------------------------------------------------------
+/**
+ * Validate API connection and authentication
+ */
+async function validateApiConnection(apiUrl, apiKey) {
+    try {
+        const headers = {
+            'Content-Type': 'application/json',
+        };
+        if (apiKey) {
+            headers['Authorization'] = `Bearer ${apiKey}`;
+        }
+        const response = await fetch(`${apiUrl}/health`, {
+            headers,
+            signal: AbortSignal.timeout(10000), // 10 second timeout
+        });
+        return response.ok;
+    }
+    catch (error) {
+        return false;
+    }
+}
+/**
+ * Register this system with the ClaudeTools API
+ */
+async function registerSystem(config) {
+    try {
+        const hostname = require('os').hostname();
+        const platform = process.platform;
+        const cwd = process.cwd();
+        const response = await fetch(`${config.apiUrl}/api/v1/systems/register`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': config.apiKey ? `Bearer ${config.apiKey}` : '',
+            },
+            body: JSON.stringify({
+                name: hostname,
+                platform,
+                working_directory: cwd,
+            }),
+        });
+        if (!response.ok) {
+            throw new Error(`Registration failed: ${response.status} ${response.statusText}`);
+        }
+        const data = await response.json();
+        return data.system_id;
+    }
+    catch (error) {
+        throw new Error(`Failed to register system: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+// -----------------------------------------------------------------------------
+// Setup Wizard
+// -----------------------------------------------------------------------------
+export async function runSetup() {
+    console.log('\n🧠 ClaudeTools Memory Setup\n');
+    console.log('This wizard will guide you through the initial configuration.\n');
+    try {
+        // 1. Ensure config directory exists
+        await ensureConfigDir();
+        // 2. Load existing config or use defaults
+        const loadedConfig = await loadConfigFromFile();
+        // Merge with defaults to ensure all fields exist
+        let config = { ...DEFAULT_CONFIG, ...loadedConfig };
+        // 3. API URL configuration
+        console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+        console.log('API Configuration');
+        console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n');
+        const useDefaultApi = await confirm(`Use default API URL (${DEFAULT_CONFIG.apiUrl})?`, true);
+        if (!useDefaultApi) {
+            const customApiUrl = await prompt('Enter custom API URL');
+            if (customApiUrl) {
+                config.apiUrl = customApiUrl;
+            }
+        }
+        // 4. API Key configuration
+        console.log('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+        console.log('Authentication');
+        console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n');
+        if (config.apiKey) {
+            console.log(`Current API key: ${config.apiKey.substring(0, 10)}...`);
+            const replaceKey = await confirm('Replace existing API key?', false);
+            if (replaceKey) {
+                const newApiKey = await prompt('Enter new API key (from claudetools.dev/dashboard)');
+                if (newApiKey) {
+                    config.apiKey = newApiKey;
+                }
+            }
+        }
+        else {
+            console.log('Get your API key from: https://claudetools.dev/dashboard\n');
+            const apiKey = await prompt('Enter API key (leave blank to skip)');
+            if (apiKey) {
+                config.apiKey = apiKey;
+            }
+        }
+        // 5. Validate API connection
+        console.log('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+        console.log('Validation');
+        console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n');
+        console.log('Validating API connection...');
+        const isValid = await validateApiConnection(config.apiUrl || DEFAULT_CONFIG.apiUrl, config.apiKey);
+        if (!isValid) {
+            console.error('❌ Could not connect to API.');
+            console.error('   Check your API URL and key, or continue without validation.\n');
+            const continueAnyway = await confirm('Continue anyway?', false);
+            if (!continueAnyway) {
+                console.log('\nSetup cancelled.');
+                process.exit(1);
+            }
+        }
+        else {
+            console.log('✅ API connection validated');
+        }
+        // 6. Auto-inject context configuration
+        console.log('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+        console.log('Context Injection');
+        console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n');
+        console.log('Auto-inject context automatically adds relevant memory to every request.');
+        console.log('This uses tokens but provides more contextual responses.\n');
+        const enableAutoInject = await confirm('Enable automatic context injection?', config.autoInjectContext);
+        config.autoInjectContext = enableAutoInject;
+        // 7. System registration (optional)
+        if (isValid && config.apiKey) {
+            console.log('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+            console.log('System Registration');
+            console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n');
+            const shouldRegister = await confirm('Register this system?', true);
+            if (shouldRegister) {
+                try {
+                    console.log('Registering system...');
+                    const systemId = await registerSystem(config);
+                    console.log(`✅ System registered: ${systemId}`);
+                }
+                catch (error) {
+                    console.error(`❌ Registration failed: ${error instanceof Error ? error.message : String(error)}`);
+                    console.error('   You can continue without registration.');
+                }
+            }
+        }
+        // 8. Save configuration
+        console.log('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+        console.log('Saving Configuration');
+        console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n');
+        await saveConfig(config);
+        console.log(`✅ Configuration saved to ${getConfigPath()}`);
+        // 9. Show next steps
+        console.log('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+        console.log('Next Steps');
+        console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n');
+        console.log('1. Add to Claude Code MCP settings:');
+        console.log('   Location: ~/.claude/mcp.json\n');
+        console.log('   {');
+        console.log('     "mcpServers": {');
+        console.log('       "claudetools-memory": {');
+        console.log('         "command": "claudetools-memory"');
+        console.log('       }');
+        console.log('     }');
+        console.log('   }\n');
+        console.log('2. Restart Claude Code\n');
+        console.log('Done! 🎉\n');
+    }
+    catch (error) {
+        console.error('\n❌ Setup failed:', error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+}

package/dist/tools.d.ts

@@ -0,0 +1,2 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+export declare function registerToolDefinitions(server: Server): void;