claude-eidetic 0.1.0 → 0.1.1

package/dist/config.js

@@ -49,10 +49,6 @@ export function loadConfig() {
         throw new ConfigError(`Invalid configuration:\n${issues}`);
     }
     const config = result.data;
-    if (config.embeddingProvider === 'openai' && !config.openaiApiKey) {
-        throw new ConfigError('OPENAI_API_KEY is required when EMBEDDING_PROVIDER is "openai" (the default). ' +
-            'Set EMBEDDING_PROVIDER=ollama or EMBEDDING_PROVIDER=local to use a local embedding server.');
-    }
     cachedConfig = config;
     return cachedConfig;
 }

package/dist/index.js

@@ -17,6 +17,7 @@ import { bootstrapQdrant } from './infra/qdrant-bootstrap.js';
 import { StateManager, cleanupOrphanedSnapshots } from './state/snapshot.js';
 import { ToolHandlers } from './tools.js';
 import { TOOL_DEFINITIONS } from './tool-schemas.js';
+import { getSetupErrorMessage } from './setup-message.js';
 const WORKFLOW_GUIDANCE = `# Eidetic Code Search Workflow
 
 **Before searching:** Ensure the codebase is indexed.
@@ -43,31 +44,49 @@ const WORKFLOW_GUIDANCE = `# Eidetic Code Search Workflow
 async function main() {
     const config = loadConfig();
     console.log(`Config loaded. Provider: ${config.vectordbProvider}, Model: ${config.embeddingModel}`);
-    const embedding = createEmbedding(config);
-    await embedding.initialize();
-    let vectordb;
-    if (config.vectordbProvider === 'milvus') {
-        const { MilvusVectorDB } = await import('./vectordb/milvus.js');
-        vectordb = new MilvusVectorDB();
-        console.log(`Using Milvus at ${config.milvusAddress}`);
-    }
-    else {
-        const qdrantUrl = await bootstrapQdrant();
-        vectordb = new QdrantVectorDB(qdrantUrl);
-        console.log(`Using Qdrant at ${qdrantUrl}`);
+    let handlers = null;
+    let setupError = null;
+    try {
+        const embedding = createEmbedding(config);
+        await embedding.initialize();
+        let vectordb;
+        if (config.vectordbProvider === 'milvus') {
+            const { MilvusVectorDB } = await import('./vectordb/milvus.js');
+            vectordb = new MilvusVectorDB();
+            console.log(`Using Milvus at ${config.milvusAddress}`);
+        }
+        else {
+            const qdrantUrl = await bootstrapQdrant();
+            vectordb = new QdrantVectorDB(qdrantUrl);
+            console.log(`Using Qdrant at ${qdrantUrl}`);
+        }
+        const cleaned = await cleanupOrphanedSnapshots(vectordb);
+        if (cleaned > 0) {
+            console.log(`Cleaned ${cleaned} orphaned snapshot(s).`);
+        }
+        const state = new StateManager();
+        handlers = new ToolHandlers(embedding, vectordb, state);
     }
-    const cleaned = await cleanupOrphanedSnapshots(vectordb);
-    if (cleaned > 0) {
-        console.log(`Cleaned ${cleaned} orphaned snapshot(s).`);
+    catch (err) {
+        setupError = err instanceof Error ? err.message : String(err);
+        console.warn(`Eidetic initialization failed: ${setupError}`);
+        console.warn('Server will start in setup-required mode. All tool calls will return setup instructions.');
     }
-    const state = new StateManager();
-    const handlers = new ToolHandlers(embedding, vectordb, state);
     const server = new Server({ name: 'claude-eidetic', version: '0.1.0' }, { capabilities: { tools: {} } });
     server.setRequestHandler(ListToolsRequestSchema, async () => ({
         tools: [...TOOL_DEFINITIONS],
     }));
     server.setRequestHandler(CallToolRequestSchema, async (request) => {
         const { name, arguments: args } = request.params;
+        if (!handlers) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: getSetupErrorMessage(setupError ?? 'Unknown error'),
+                    }],
+                isError: true,
+            };
+        }
         switch (name) {
             case 'index_codebase':
                 return handlers.handleIndexCodebase(args ?? {});

package/dist/setup-message.d.ts

@@ -0,0 +1,3 @@
+/** Centralized setup/error messages — easy to update links and instructions. */
+export declare function getSetupErrorMessage(errorDetail: string): string;
+//# sourceMappingURL=setup-message.d.ts.map

package/dist/setup-message.js

@@ -0,0 +1,23 @@
+/** Centralized setup/error messages — easy to update links and instructions. */
+const OPENAI_KEY_URL = 'https://platform.openai.com/api-keys';
+export function getSetupErrorMessage(errorDetail) {
+    return (`Eidetic setup required: ${errorDetail}\n\n` +
+        '## How to fix\n\n' +
+        `1. **Get an API key**: ${OPENAI_KEY_URL}\n` +
+        '2. **Add it to your config** (pick one):\n\n' +
+        '### Quick (CLI)\n\n' +
+        '```\nclaude mcp update claude-eidetic -e OPENAI_API_KEY=sk-your-key-here\n```\n\n' +
+        '### Manual\n\n' +
+        'Edit `~/.claude/plugins/claude-eidetic/config.json`:\n' +
+        '```json\n' +
+        '{\n' +
+        '  "env": {\n' +
+        '    "OPENAI_API_KEY": "sk-your-key-here"\n' +
+        '  }\n' +
+        '}\n' +
+        '```\n\n' +
+        '### Using Ollama instead (free, local)\n\n' +
+        'Set `EMBEDDING_PROVIDER=ollama` in the same env block (requires Ollama running locally with `nomic-embed-text`).\n\n' +
+        '3. **Restart Claude Code** for changes to take effect.');
+}
+//# sourceMappingURL=setup-message.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-eidetic",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Semantic code search MCP server — lean, correct, fast",
   "type": "module",
   "main": "dist/index.js",