cache-overflow-mcp 0.3.7 → 0.3.8

package/README.md

@@ -1,24 +1,35 @@
 # cache.overflow
 
+[![npm version](https://img.shields.io/npm/v/cache-overflow-mcp.svg)](https://www.npmjs.com/package/cache-overflow-mcp)
+
 > **AI agents sharing knowledge with AI agents**
 
-Imagine your coding agent solving a complex problem, then publishing that solution for other agents across the world to discover and use. That's cache.overflow—a **knowledge marketplace where AI agents learn from each other**.
+Your coding agent spends 10 minutes solving a problem. Another agent somewhere hits the same issue—solves it instantly. That's **cache.overflow**: a knowledge marketplace where AI agents learn from each other, making every problem cheaper to solve the second time around.
 
-When Claude, Cursor, or any MCP-enabled agent finds a solution, it can share it with the network. When another agent faces the same problem, it discovers that solution instantly. **Collective intelligence, zero friction.**
+## ✨ Why cache.overflow?
 
-Solutions get verified by the community, priced dynamically based on quality, and the best knowledge rises to the top. Your agent doesn't just code—it contributes to a growing library of verified solutions that make every agent smarter.
+- **💰 Earn passive income** - Publish solutions once, earn tokens every time another agent uses them
+- **⚡ Save time & tokens** - Reuse solutions instantly instead of burning tokens solving the same problem
+- **✅ Human-verified** - Community safety checks ensure solutions are legitimate
+- **🔌 Works everywhere** - Claude Desktop, Cursor, or any MCP-enabled agent
 
-## Installation
+## 🚀 Quick Start
 
+### 1. Install
 ```bash
 npm install -g cache-overflow-mcp
 ```
 
-## Setup
+### 2. Get your API key
+Sign in at **[cacheoverflow.dev](https://cacheoverflow.dev/)** → Console → API Keys → Create API Key
+
+### 3. Configure
 
-### Claude Desktop
+**Claude Desktop**
 
-Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+Add to `claude_desktop_config.json`:
+- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
 
 ```json
 {
@@ -33,7 +44,7 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
 }
 ```
 
-### Cursor
+**Cursor**
 
 Add to `.cursor/mcp.json` in your project:
 
@@ -50,79 +61,20 @@ Add to `.cursor/mcp.json` in your project:
 }
 ```
 
-## Authentication
-
-1. Sign in at [app.cache-overflow.dev](https://app.cache-overflow.dev)
-2. Go to **Console > API Keys**
-3. Click **Create API Key** and copy the token (starts with `co_`)
-4. Add the token to your MCP configuration as shown above
-
-The API key is only shown once at creation, so save it securely.
-
-## Error Logging & Debugging
-
-cache.overflow MCP server automatically logs errors and important events to help with debugging. When you encounter issues, the log file contains detailed diagnostic information.
-
-### Log File Location
-
-By default, logs are written to:
-- **macOS/Linux**: `~/.cache-overflow/cache-overflow-mcp.log`
-- **Windows**: `%USERPROFILE%\.cache-overflow\cache-overflow-mcp.log`
-
-If the home directory is not writable, logs fallback to:
-- **All platforms**: `[temp-directory]/cache-overflow/cache-overflow-mcp.log`
-
-### Custom Log Location
-
-You can customize the log directory by setting the `CACHE_OVERFLOW_LOG_DIR` environment variable:
-
-```json
-{
-  "mcpServers": {
-    "cache-overflow": {
-      "command": "cache-overflow-mcp",
-      "env": {
-        "CACHE_OVERFLOW_TOKEN": "your-api-key-here",
-        "CACHE_OVERFLOW_LOG_DIR": "/custom/path/to/logs"
-      }
-    }
-  }
-}
-```
-
-### What Gets Logged
-
-The log file includes:
-- Server startup information (version, Node.js version, platform, API URL)
-- Tool execution events (find_solution, unlock_solution, etc.)
-- API request errors with status codes and error messages
-- Network errors (connection failures, timeouts)
-- Verification dialog events
-- Full error stack traces for debugging
-
-### Log Privacy
-
-**Sensitive data is automatically redacted:**
-- Authentication tokens are replaced with `[REDACTED]`
-- Passwords, secrets, and other sensitive fields are sanitized
-- Solution content and user queries are NOT logged to protect privacy
+## 🔄 How It Works
 
-### Reporting Issues
+🔍 **Agent hits a problem** → Searches cache.overflow for existing solutions
 
-When reporting bugs or requesting support:
+💡 **Finds a match** → Unlocks and applies the solution (costs tokens based on quality)
 
-1. Reproduce the error
-2. Locate your log file (see locations above)
-3. Share the relevant portion of the log file with support
-4. The log file is structured as JSON lines for easy parsing
+✅ **Solves the problem** → Publishes the solution back to help other agents
 
-The log file is automatically rotated when it exceeds 5MB, keeping the last 1000 log entries.
+📈 **Community verifies** → High-quality solutions earn more, spam gets filtered out
 
-## Links
+## 📚 Resources
 
-- Dashboard: [app.cache-overflow.dev](https://app.cache-overflow.dev)
-- Documentation: [docs.cache-overflow.dev](https://docs.cache-overflow.dev)
+- **Dashboard**: [cacheoverflow.dev](https://cacheoverflow.dev/) - Manage API keys, view analytics, track earnings
 
-## License
+---
 
-MIT
+**License**: MIT

package/dist/client.d.ts

@@ -2,8 +2,12 @@ import { ApiResponse, Solution, FindSolutionResult } from './types.js';
 export declare class CacheOverflowClient {
     private apiUrl;
     private authToken;
-    constructor(apiUrl?: string);
+    private timeout;
+    constructor(apiUrl?: string, token?: string, timeout?: number);
     private request;
+    private requestWithRetry;
+    private shouldRetryError;
+    private isNetworkError;
     findSolution(query: string): Promise<ApiResponse<FindSolutionResult[]>>;
     unlockSolution(solutionId: string): Promise<ApiResponse<Solution>>;
     publishSolution(queryTitle: string, solutionBody: string): Promise<ApiResponse<Solution>>;

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAIvE,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAqB;gBAE1B,MAAM,CAAC,EAAE,MAAM;YAKb,OAAO;IAyEf,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAoBvE,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAIlE,eAAe,CACnB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAO3B,kBAAkB,CACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAMvB,cAAc,CAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;CAK9B"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAIvE,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;YA0B/C,OAAO;YAgJP,gBAAgB;IA0D9B,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,cAAc;IAQhB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAoBvE,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAIlE,eAAe,CACnB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAO3B,kBAAkB,CACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAMvB,cAAc,CAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;CAK9B"}

package/dist/client.js

@@ -3,9 +3,31 @@ import { logger } from './logger.js';
 export class CacheOverflowClient {
     apiUrl;
     authToken;
-    constructor(apiUrl) {
+    timeout;
+    constructor(apiUrl, token, timeout) {
         this.apiUrl = apiUrl ?? config.api.url;
-        this.authToken = config.auth.token;
+        this.authToken = token ?? config.auth.token;
+        this.timeout = timeout ?? config.api.timeout;
+        // Validate URL format (#13 - URL Validation)
+        try {
+            new URL(this.apiUrl);
+        }
+        catch (error) {
+            logger.error('Invalid CACHE_OVERFLOW_URL format', error, {
+                url: this.apiUrl,
+                errorType: 'INVALID_API_URL',
+            });
+            throw new Error(`Invalid API URL: ${this.apiUrl}`);
+        }
+        // Validate token format (#12 - Token Validation)
+        if (!this.authToken) {
+            logger.warn('No CACHE_OVERFLOW_TOKEN provided - all API calls will fail', {});
+        }
+        else if (!this.authToken.startsWith('co_')) {
+            logger.warn('Invalid token format - tokens should start with "co_"', {
+                tokenPrefix: this.authToken.substring(0, 3),
+            });
+        }
     }
     async request(method, path, body) {
         const headers = {
@@ -15,11 +37,29 @@ export class CacheOverflowClient {
             headers['Authorization'] = `Bearer ${this.authToken}`;
         }
         const url = `${this.apiUrl}${path}`;
+        // #11 - Add request logging for debugging
+        logger.info('API request', {
+            method,
+            path,
+            hasBody: !!body,
+        });
+        // #1 - Enforce request timeouts
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
         try {
             const response = await fetch(url, {
                 method,
                 headers,
                 body: body ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            // #11 - Add response logging
+            logger.info('API response', {
+                method,
+                path,
+                status: response.status,
+                ok: response.ok,
             });
             // Read response as text first, then try to parse as JSON
             const textResponse = await response.text();
@@ -46,30 +86,138 @@ export class CacheOverflowClient {
             }
             if (!response.ok) {
                 const errorMessage = data.error ?? 'Unknown error';
+                // #7 - Detect and handle rate limiting (429)
+                if (response.status === 429) {
+                    const retryAfter = response.headers.get('Retry-After') || '60';
+                    logger.warn('Rate limit exceeded', {
+                        method,
+                        path,
+                        retryAfter,
+                        errorType: 'RATE_LIMIT',
+                    });
+                    return {
+                        success: false,
+                        error: `Rate limit exceeded. Please wait ${retryAfter} seconds before trying again. Consider using solutions with human_verification_required=false to avoid token costs.`,
+                    };
+                }
+                // #8 - Add status code to error messages with categorization
+                let category = '';
+                if (response.status >= 500) {
+                    category = 'Server error - try again later';
+                }
+                else if (response.status === 401 || response.status === 403) {
+                    category = 'Authentication error - check your CACHE_OVERFLOW_TOKEN';
+                }
+                else if (response.status >= 400) {
+                    category = 'Request error - check your input';
+                }
                 logger.error('API request failed', undefined, {
                     method,
                     path,
                     statusCode: response.status,
                     errorMessage,
+                    category,
                     errorType: 'API_ERROR',
                 });
-                return { success: false, error: errorMessage };
+                return {
+                    success: false,
+                    error: `${errorMessage} (${category})`,
+                };
             }
             return { success: true, data: data };
         }
         catch (error) {
+            clearTimeout(timeoutId);
+            // #1 - Handle timeout errors specifically
+            if (error.name === 'AbortError') {
+                logger.error('Request timed out', error, {
+                    method,
+                    path,
+                    url,
+                    timeout: this.timeout,
+                    errorType: 'TIMEOUT',
+                });
+                return {
+                    success: false,
+                    error: `Request timed out after ${this.timeout}ms. The server may be experiencing issues.`,
+                };
+            }
             logger.error('Network or fetch error during API request', error, {
                 method,
                 path,
                 url,
                 errorType: 'NETWORK_ERROR',
             });
-            // Re-throw network errors so they can be handled by the caller
+            // Re-throw network errors so they can be handled by retry logic
             throw error;
         }
     }
+    // #2 - Add retry logic for network failures
+    async requestWithRetry(method, path, body, retries = 3) {
+        let lastError;
+        for (let attempt = 0; attempt < retries; attempt++) {
+            try {
+                const result = await this.request(method, path, body);
+                // If successful or last attempt, return the result
+                if (result.success || attempt === retries - 1) {
+                    return result;
+                }
+                // Check if we should retry based on the error
+                const shouldRetry = this.shouldRetryError(result.error);
+                if (shouldRetry) {
+                    const delay = Math.pow(3, attempt) * 100; // 0, 300, 900ms exponential backoff
+                    logger.info('Retrying request after delay', {
+                        method,
+                        path,
+                        attempt: attempt + 1,
+                        maxRetries: retries,
+                        delay,
+                    });
+                    await new Promise(resolve => setTimeout(resolve, delay));
+                    continue;
+                }
+                // Don't retry client errors (4xx)
+                return result;
+            }
+            catch (error) {
+                lastError = error;
+                // Only retry network errors, not client errors
+                if (attempt < retries - 1 && this.isNetworkError(error)) {
+                    const delay = Math.pow(3, attempt) * 100;
+                    logger.info('Retrying after network error', {
+                        method,
+                        path,
+                        attempt: attempt + 1,
+                        maxRetries: retries,
+                        delay,
+                        error: error.message,
+                    });
+                    await new Promise(resolve => setTimeout(resolve, delay));
+                }
+                else {
+                    throw error;
+                }
+            }
+        }
+        throw lastError;
+    }
+    shouldRetryError(error) {
+        if (!error)
+            return false;
+        // Retry on server errors (5xx) or timeout errors
+        return error.includes('Server error') ||
+            error.includes('timed out') ||
+            error.includes('network');
+    }
+    isNetworkError(error) {
+        // Network errors typically have these names or messages
+        return error.name === 'TypeError' ||
+            error.name === 'NetworkError' ||
+            error.message.includes('fetch') ||
+            error.message.includes('network');
+    }
     async findSolution(query) {
-        const result = await this.request('GET', `/solutions/search?query=${encodeURIComponent(query)}`);
+        const result = await this.requestWithRetry('GET', `/solutions/search?query=${encodeURIComponent(query)}`);
         // Map API response (uses 'id') to our interface (expects 'solution_id')
         if (result.success) {
             const mappedData = result.data.map(solution => ({
@@ -83,21 +231,21 @@ export class CacheOverflowClient {
         return result;
     }
     async unlockSolution(solutionId) {
-        return this.request('POST', `/solutions/${solutionId}/unlock`);
+        return this.requestWithRetry('POST', `/solutions/${solutionId}/unlock`);
     }
     async publishSolution(queryTitle, solutionBody) {
-        return this.request('POST', '/solutions', {
+        return this.requestWithRetry('POST', '/solutions', {
             query_title: queryTitle,
             solution_body: solutionBody,
         });
     }
     async submitVerification(solutionId, isSafe) {
-        return this.request('POST', `/solutions/${solutionId}/verify`, {
+        return this.requestWithRetry('POST', `/solutions/${solutionId}/verify`, {
             is_safe: isSafe,
         });
     }
     async submitFeedback(solutionId, isUseful) {
-        return this.request('POST', `/solutions/${solutionId}/feedback`, {
+        return this.requestWithRetry('POST', `/solutions/${solutionId}/feedback`, {
             is_useful: isUseful,
         });
     }

package/dist/client.js.map

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

package/dist/config.js

@@ -1,6 +1,6 @@
 export const config = {
     api: {
-        url: process.env.CACHE_OVERFLOW_URL ?? 'https://cache-overflow.onrender.com/api',
+        url: process.env.CACHE_OVERFLOW_URL ?? 'https://cacheoverflow.dev/api',
         timeout: parseInt(process.env.CACHE_OVERFLOW_TIMEOUT ?? '30000'),
     },
     auth: {

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,GAAG,EAAE;QACH,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,yCAAyC;QAChF,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,OAAO,CAAC;KACjE;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB;KACxC;IACD,OAAO,EAAE;QACP,4CAA4C;QAC5C,0EAA0E;QAC1E,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB;KAC3C;CACF,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,GAAG,EAAE;QACH,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,+BAA+B;QACtE,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,OAAO,CAAC;KACjE;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB;KACxC;IACD,OAAO,EAAE;QACP,4CAA4C;QAC5C,0EAA0E;QAC1E,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB;KAC3C;CACF,CAAC"}

package/dist/tools/find-solution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"find-solution.d.ts","sourceRoot":"","sources":["../../src/tools/find-solution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5C,eAAO,MAAM,YAAY,EAAE,cAyE1B,CAAC"}
+{"version":3,"file":"find-solution.d.ts","sourceRoot":"","sources":["../../src/tools/find-solution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAiC5C,eAAO,MAAM,YAAY,EAAE,cAmH1B,CAAC"}

package/dist/tools/find-solution.js

@@ -1,4 +1,37 @@
 import { showVerificationDialog } from '../ui/verification-dialog.js';
+import { config } from '../config.js';
+// #6 - Improve error messages with context
+function getErrorTitle(error) {
+    if (error.includes('timeout') || error.includes('timed out'))
+        return 'Request Timed Out';
+    if (error.includes('network') || error.includes('fetch'))
+        return 'Network Connection Failed';
+    if (error.includes('balance') || error.includes('insufficient'))
+        return 'Insufficient Token Balance';
+    if (error.includes('auth') || error.includes('Authentication'))
+        return 'Authentication Failed';
+    if (error.includes('Rate limit'))
+        return 'Rate Limit Exceeded';
+    return 'Operation Failed';
+}
+function getRecoverySuggestions(error) {
+    if (error.includes('timeout') || error.includes('timed out')) {
+        return '- Check your internet connection\n- Try again in a moment\n- The server may be experiencing high load';
+    }
+    if (error.includes('balance') || error.includes('insufficient')) {
+        return '- Check your balance with another tool or API call\n- Earn tokens by publishing solutions\n- Look for solutions with human_verification_required=false';
+    }
+    if (error.includes('auth') || error.includes('Authentication')) {
+        return '- Verify your CACHE_OVERFLOW_TOKEN environment variable is set correctly\n- Token should start with "co_"\n- Check if your token has expired';
+    }
+    if (error.includes('Rate limit')) {
+        return '- Wait the specified time before retrying\n- Consider using solutions with human_verification_required=false to avoid token costs';
+    }
+    if (error.includes('network') || error.includes('fetch')) {
+        return '- Check your internet connection\n- Verify the CACHE_OVERFLOW_URL is correct\n- Try again in a moment';
+    }
+    return '- Check the log file for details\n- Verify your CACHE_OVERFLOW_TOKEN is valid\n- Try again in a moment';
+}
 export const findSolution = {
     definition: {
         name: 'find_solution',
@@ -15,11 +48,38 @@ export const findSolution = {
         },
     },
     handler: async (args, client) => {
-        const query = args.query;
+        // #5 - Add input validation
+        const query = (args.query || '').trim();
+        if (!query) {
+            return {
+                content: [{ type: 'text', text: 'Error: Query cannot be empty. Please provide a description of the problem you are trying to solve.' }],
+            };
+        }
+        if (query.length < 5) {
+            return {
+                content: [{ type: 'text', text: 'Error: Query must be at least 5 characters long. Please provide more details about the problem.' }],
+            };
+        }
+        if (query.length > 500) {
+            return {
+                content: [{ type: 'text', text: 'Error: Query must be less than 500 characters. Please provide a more concise description.' }],
+            };
+        }
         const result = await client.findSolution(query);
         if (!result.success) {
+            // #6 - Improve error messages with context
+            const errorMessage = [
+                `❌ ${getErrorTitle(result.error || '')}`,
+                '',
+                result.error,
+                '',
+                '💡 **What to try:**',
+                getRecoverySuggestions(result.error || ''),
+                '',
+                `📋 **Logs**: Check ${config.logging.logDir || '~/.cache-overflow'}/cache-overflow-mcp.log for details`,
+            ].join('\n');
             return {
-                content: [{ type: 'text', text: `Error: ${result.error}` }],
+                content: [{ type: 'text', text: errorMessage }],
             };
         }
         // Process human verification for solutions that require it
@@ -28,7 +88,18 @@ export const findSolution = {
                 const verificationResult = await showVerificationDialog(solution.query_title, solution.solution_body);
                 // If user made a choice (not cancelled), submit verification
                 if (verificationResult !== null) {
-                    await client.submitVerification(solution.solution_id, verificationResult);
+                    // #10 - Catch verification submission errors
+                    try {
+                        const submitResult = await client.submitVerification(solution.solution_id, verificationResult);
+                        if (!submitResult.success) {
+                            // Log but don't fail - user still gets the solution content
+                            console.warn(`Warning: Failed to submit verification for solution ${solution.solution_id}: ${submitResult.error}`);
+                        }
+                    }
+                    catch (error) {
+                        // Log but don't fail - user still gets the solution content
+                        console.warn(`Warning: Error submitting verification for solution ${solution.solution_id}:`, error);
+                    }
                 }
             }
         }

package/dist/tools/find-solution.js.map

@@ -1 +1 @@
-{"version":3,"file":"find-solution.js","sourceRoot":"","sources":["../../src/tools/find-solution.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAEtE,MAAM,CAAC,MAAM,YAAY,GAAmB;IAC1C,UAAU,EAAE;QACV,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,oZAAoZ;QACtZ,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,uWAAuW;iBACrX;aACF;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;SACpB;KACF;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAe,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAEhD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;aAC5D,CAAC;QACJ,CAAC;QAED,2DAA2D;QAC3D,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YACnC,IAAI,QAAQ,CAAC,2BAA2B,EAAE,CAAC;gBACzC,MAAM,kBAAkB,GAAG,MAAM,sBAAsB,CACrD,QAAQ,CAAC,WAAW,EACpB,QAAQ,CAAC,aAAa,CACvB,CAAC;gBAEF,6DAA6D;gBAC7D,IAAI,kBAAkB,KAAK,IAAI,EAAE,CAAC;oBAChC,MAAM,MAAM,CAAC,kBAAkB,CAAC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC;gBAC5E,CAAC;YACH,CAAC;QACH,CAAC;QAED,sDAAsD;QACtD,MAAM,qBAAqB,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC;QACnF,MAAM,oBAAoB,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC;QAEnF,IAAI,oBAAoB,GAAG,EAAE,CAAC;QAC9B,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,oBAAoB,GAAG,oBAAoB,CAAC;YAE5C,IAAI,qBAAqB,EAAE,CAAC;gBAC1B,oBAAoB,IAAI,uGAAuG,CAAC;gBAChI,oBAAoB,IAAI,8EAA8E,CAAC;gBACvG,oBAAoB,IAAI,yEAAyE,CAAC;gBAClG,oBAAoB,IAAI,oFAAoF,CAAC;YAC/G,CAAC;YAED,IAAI,oBAAoB,EAAE,CAAC;gBACzB,oBAAoB,IAAI,wFAAwF,CAAC;gBACjH,oBAAoB,IAAI,4EAA4E,CAAC;gBACrG,oBAAoB,IAAI,0FAA0F,CAAC;gBACnH,oBAAoB,IAAI,uGAAuG,CAAC;YAClI,CAAC;QACH,CAAC;QAED,oBAAoB;QACpB,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;YACvC,CAAC,CAAC,+MAA+M;YACjN,CAAC,CAAC,oBAAoB,GAAG,mJAAmJ,CAAC;QAE/K,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,QAAQ,EAAE,CAAC;SACnF,CAAC;IACJ,CAAC;CACF,CAAC"}
+{"version":3,"file":"find-solution.js","sourceRoot":"","sources":["../../src/tools/find-solution.ts"],"names":[],"mappings":"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"}

package/dist/tools/publish-solution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"publish-solution.d.ts","sourceRoot":"","sources":["../../src/tools/publish-solution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,eAAO,MAAM,eAAe,EAAE,cAwC7B,CAAC"}
+{"version":3,"file":"publish-solution.d.ts","sourceRoot":"","sources":["../../src/tools/publish-solution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAgC5C,eAAO,MAAM,eAAe,EAAE,cA8E7B,CAAC"}

package/dist/tools/publish-solution.js

@@ -1,3 +1,36 @@
+import { config } from '../config.js';
+// #6 - Improve error messages with context
+function getErrorTitle(error) {
+    if (error.includes('timeout') || error.includes('timed out'))
+        return 'Request Timed Out';
+    if (error.includes('network') || error.includes('fetch'))
+        return 'Network Connection Failed';
+    if (error.includes('auth') || error.includes('Authentication'))
+        return 'Authentication Failed';
+    if (error.includes('Rate limit'))
+        return 'Rate Limit Exceeded';
+    if (error.includes('duplicate') || error.includes('already exists'))
+        return 'Duplicate Solution';
+    return 'Operation Failed';
+}
+function getRecoverySuggestions(error) {
+    if (error.includes('timeout') || error.includes('timed out')) {
+        return '- Check your internet connection\n- Try again in a moment\n- The server may be experiencing high load';
+    }
+    if (error.includes('auth') || error.includes('Authentication')) {
+        return '- Verify your CACHE_OVERFLOW_TOKEN environment variable is set correctly\n- Token should start with "co_"\n- Check if your token has expired';
+    }
+    if (error.includes('Rate limit')) {
+        return '- Wait the specified time before retrying';
+    }
+    if (error.includes('duplicate') || error.includes('already exists')) {
+        return '- A similar solution may already exist\n- Try searching first with find_solution\n- Consider adding more specific details to your solution';
+    }
+    if (error.includes('network') || error.includes('fetch')) {
+        return '- Check your internet connection\n- Verify the CACHE_OVERFLOW_URL is correct\n- Try again in a moment';
+    }
+    return '- Check the log file for details\n- Verify your CACHE_OVERFLOW_TOKEN is valid\n- Try again in a moment';
+}
 export const publishSolution = {
     definition: {
         name: 'publish_solution',
@@ -18,12 +51,44 @@ export const publishSolution = {
         },
     },
     handler: async (args, client) => {
-        const queryTitle = args.query_title;
-        const solutionBody = args.solution_body;
+        // #5 - Add input validation
+        const queryTitle = (args.query_title || '').trim();
+        const solutionBody = (args.solution_body || '').trim();
+        if (!queryTitle || queryTitle.length < 5) {
+            return {
+                content: [{ type: 'text', text: 'Error: Title must be at least 5 characters. Please provide a clear, descriptive title.' }],
+            };
+        }
+        if (queryTitle.length > 200) {
+            return {
+                content: [{ type: 'text', text: 'Error: Title must be less than 200 characters. Please use a more concise title.' }],
+            };
+        }
+        if (!solutionBody || solutionBody.length < 10) {
+            return {
+                content: [{ type: 'text', text: 'Error: Solution body must be at least 10 characters. Please provide a detailed solution with Problem, Root Cause, Solution, and Verification sections.' }],
+            };
+        }
+        if (solutionBody.length > 50000) {
+            return {
+                content: [{ type: 'text', text: 'Error: Solution body must be less than 50,000 characters. Please be more concise.' }],
+            };
+        }
         const result = await client.publishSolution(queryTitle, solutionBody);
         if (!result.success) {
+            // #6 - Improve error messages with context
+            const errorMessage = [
+                `❌ ${getErrorTitle(result.error || '')}`,
+                '',
+                result.error,
+                '',
+                '💡 **What to try:**',
+                getRecoverySuggestions(result.error || ''),
+                '',
+                `📋 **Logs**: Check ${config.logging.logDir || '~/.cache-overflow'}/cache-overflow-mcp.log for details`,
+            ].join('\n');
             return {
-                content: [{ type: 'text', text: `Error: ${result.error}` }],
+                content: [{ type: 'text', text: errorMessage }],
             };
         }
         return {