recker 1.0.79 → 1.0.80-next.70ea84d

package/dist/mcp/client.js

@@ -2,6 +2,18 @@ import { EventEmitter } from 'events';
 import { createClient } from '../core/client.js';
 import { StateError, ProtocolError } from '../core/errors.js';
 import { consoleLogger } from '../types/logger.js';
+function normalizeJsonRpcParams(params) {
+    if (params === undefined)
+        return undefined;
+    if (params === null)
+        return { value: null };
+    if (Array.isArray(params))
+        return params;
+    if (typeof params === 'object') {
+        return params;
+    }
+    return { value: params };
+}
 export class MCPClient extends EventEmitter {
     client;
     endpoint;
@@ -137,7 +149,7 @@ export class MCPClient extends EventEmitter {
             jsonrpc: '2.0',
             id: ++this.requestId,
             method,
-            params: params,
+            params: normalizeJsonRpcParams(params),
         };
         this.emit('request', request);
         const response = await this.client
@@ -154,6 +166,9 @@ export class MCPClient extends EventEmitter {
             error.data = response.error.data;
             throw error;
         }
+        if (response.result === undefined) {
+            return {};
+        }
         return response.result;
     }
     async connectSSE() {
@@ -173,8 +188,11 @@ export class MCPClient extends EventEmitter {
         }
     }
     handleSSEEvent(event) {
+        const payload = typeof event === 'string' ? event : event.data;
+        if (!payload)
+            return;
         try {
-            const data = JSON.parse(event.data);
+            const data = JSON.parse(payload);
             switch (data.method) {
                 case 'notifications/progress':
                     this.emit('progress', data.params);

package/dist/mcp/contract.d.ts

@@ -45,7 +45,7 @@ export declare function createMCPBatch<T extends MCPContractDefinition>(mcp: MCP
     args?: T[K]["inputSchema"] extends ZodSchema ? z.infer<T[K]["inputSchema"]> : Record<string, unknown>;
 }>) => Promise<Array<{
     success: boolean;
-    result?: any;
+    result?: unknown;
     error?: Error;
 }>>;
 export interface SSEStreamOptions {

package/dist/mcp/profiles.js

@@ -1,3 +1,4 @@
+import { ValidationError } from '../core/errors.js';
 export const categories = {
     minimal: {
         name: 'minimal',
@@ -216,7 +217,10 @@ export function resolveCategories(categoryNames) {
     for (const name of names) {
         const category = categories[name];
         if (!category) {
-            throw new Error(`Unknown category: ${name}. Available: ${Object.keys(categories).join(', ')}`);
+            throw new ValidationError(`Unknown category: ${name}.`, {
+                field: 'categoryNames',
+                value: name,
+            });
         }
         for (const tool of category.tools) {
             toolSet.add(tool);

package/dist/mcp/prompts/index.js

@@ -1,3 +1,4 @@
+import { ValidationError } from '../../core/errors.js';
 export class PromptRegistry {
     prompts = new Map();
     constructor() {
@@ -12,7 +13,7 @@ export class PromptRegistry {
     async getPrompt(name, args) {
         const prompt = this.prompts.get(name);
         if (!prompt) {
-            throw new Error(`Prompt not found: ${name}`);
+            throw new ValidationError(`Prompt not found: ${name}`, { field: 'name', value: name });
         }
         return prompt.handler(args);
     }
@@ -508,10 +509,13 @@ const client = createClient();
 // Rotate user agents
 client.use(userAgent({ rotate: true, type: 'desktop' }));
 
-// Rotate proxies
+// Rotate proxies (or pass the list directly to createClient)
+const client2 = createClient({
+  proxy: ['http://proxy1:8080', 'socks5://proxy2:1080', 'socks5h://proxy3:1080'],
+});
+// Alternative via plugin
 client.use(proxyRotator({
-  proxies: ['http://proxy1:8080', 'http://proxy2:8080'],
-  strategy: 'round-robin',
+  proxies: ['http://proxy1:8080', 'socks5://proxy2:1080'],
 }));
 
 // Respect rate limits

package/dist/mcp/resources/index.js

@@ -1,4 +1,5 @@
 import { listCategories } from '../tools/categories.js';
+import { ConfigurationError, NotFoundError } from '../../core/errors.js';
 export class ResourceRegistry {
     resources = new Map();
     templates = [];
@@ -41,7 +42,7 @@ export class ResourceRegistry {
                 return template.handler(params);
             }
         }
-        throw new Error(`Resource not found: ${uri}`);
+        throw new NotFoundError(`Resource not found: ${uri}`, { resource: uri });
     }
     recordRequest(method, url, status, duration) {
         this.requestHistory.push({
@@ -359,9 +360,9 @@ export class ResourceRegistry {
     async loadPresetDetails(name) {
         try {
             const { presetRegistry } = await import('../../presets/registry.js');
-            const preset = presetRegistry.find(p => p.name === name);
+            const preset = presetRegistry.find((p) => p.name === name);
             if (!preset) {
-                throw new Error(`Preset not found: ${name}`);
+                throw new NotFoundError(`Preset not found: ${name}`, { resource: name });
             }
             const envVar = `${name.toUpperCase().replace(/-/g, '_')}_API_KEY`;
             return {
@@ -386,7 +387,9 @@ const response = await client.get('/endpoint').json();
             };
         }
         catch (e) {
-            throw new Error(`Failed to load preset '${name}': ${e.message}`);
+            throw new ConfigurationError(`Failed to load preset '${name}': ${getErrorMessage(e)}`, {
+                configKey: `preset.${name}`,
+            });
         }
     }
     async getReckerInfo() {
@@ -467,7 +470,7 @@ pnpm bench:json         # JSON output
             };
         }
         catch (e) {
-            results.checks.dns = { status: 'error', error: e.message };
+            results.checks.dns = { status: 'error', error: getErrorMessage(e) };
         }
         try {
             const { inspectTLS } = await import('../../utils/tls-inspector.js');
@@ -485,7 +488,7 @@ pnpm bench:json         # JSON output
             };
         }
         catch (e) {
-            results.checks.tls = { status: 'error', error: e.message };
+            results.checks.tls = { status: 'error', error: getErrorMessage(e) };
         }
         try {
             const { createClient } = await import('../../core/client.js');
@@ -505,7 +508,7 @@ pnpm bench:json         # JSON output
             };
         }
         catch (e) {
-            results.checks.http = { status: 'error', error: e.message };
+            results.checks.http = { status: 'error', error: getErrorMessage(e) };
         }
         return results;
     }
@@ -527,16 +530,16 @@ pnpm bench:json         # JSON output
             return {
                 url,
                 status: 'healthy',
-                statusCode: lastResponse.status,
+                statusCode: lastResponse?.status,
                 latency: {
                     avg: `${avgLatency}ms`,
                     min: `${minLatency}ms`,
                     max: `${maxLatency}ms`,
                 },
                 headers: {
-                    server: lastResponse.headers.get('server'),
-                    contentType: lastResponse.headers.get('content-type'),
-                    cacheControl: lastResponse.headers.get('cache-control'),
+                    server: lastResponse?.headers.get('server'),
+                    contentType: lastResponse?.headers.get('content-type'),
+                    cacheControl: lastResponse?.headers.get('cache-control'),
                 },
                 checkedAt: new Date().toISOString(),
             };
@@ -545,7 +548,7 @@ pnpm bench:json         # JSON output
             return {
                 url,
                 status: 'unhealthy',
-                error: e.message,
+                error: getErrorMessage(e),
                 latency: `${Date.now() - startTime}ms (failed)`,
                 checkedAt: new Date().toISOString(),
             };
@@ -671,7 +674,12 @@ import { userAgent, proxyRotator } from 'recker/plugins';
 
 const client = createClient();
 client.use(userAgent({ rotate: true }));
-client.use(proxyRotator({ proxies: ['http://proxy1:8080', 'http://proxy2:8080'] }));
+// Proxy list directly in createClient (recommended):
+const client2 = createClient({
+  proxy: ['http://proxy1:8080', 'socks5://proxy2:1080', 'socks5h://proxy3:1080'],
+});
+// Or via plugin:
+client.use(proxyRotator({ proxies: ['http://proxy1:8080', 'socks5://proxy2:1080'] }));
 
 const doc = await client.scrape('https://protected-site.com');
 \`\`\`
@@ -1003,19 +1011,20 @@ Make sure the URL is accessible and try again.
         const pricing = [];
         for (const provider of catalog.providers) {
             for (const model of provider.models) {
+                const features = [
+                    model.vision && 'vision',
+                    model.tools && 'tools',
+                    model.reasoning && 'reasoning',
+                    model.fast && 'fast',
+                    model.coding && 'coding',
+                ].filter((value) => Boolean(value));
                 pricing.push({
                     provider: provider.name,
                     model: model.id,
                     input: `$${model.inputPrice?.toFixed(2) || 'N/A'}`,
                     output: `$${model.outputPrice?.toFixed(2) || 'N/A'}`,
                     context: model.context?.toLocaleString() || 'N/A',
-                    features: [
-                        model.vision && 'vision',
-                        model.tools && 'tools',
-                        model.reasoning && 'reasoning',
-                        model.fast && 'fast',
-                        model.coding && 'coding',
-                    ].filter(Boolean),
+                    features,
                 });
             }
         }
@@ -1042,7 +1051,7 @@ Make sure the URL is accessible and try again.
         const provider = catalog.providers.find((p) => p.name === name);
         if (!provider) {
             const available = catalog.providers.map((p) => p.name).join(', ');
-            throw new Error(`Provider '${name}' not found. Available: ${available}`);
+            throw new NotFoundError(`Provider '${name}' not found. Available: ${available}`, { resource: name });
         }
         return {
             name: provider.name,
@@ -1061,10 +1070,24 @@ Make sure the URL is accessible and try again.
             }[name] || null,
             features: {
                 streaming: true,
-                functionCalling: provider.models.some((m) => m.tools),
-                vision: provider.models.some((m) => m.vision),
+                functionCalling: provider.models.some((m) => Boolean(m.tools)),
+                vision: provider.models.some((m) => Boolean(m.vision)),
                 embeddings: ['openai', 'google', 'mistral'].includes(name),
             },
         };
     }
 }
+function getErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    if (typeof error === 'string') {
+        return error;
+    }
+    try {
+        return JSON.stringify(error);
+    }
+    catch {
+        return String(error);
+    }
+}

package/dist/mcp/server.js

@@ -3,7 +3,7 @@ import { readFileSync, readdirSync, statSync, existsSync } from 'fs';
 import { join, relative, extname, basename, dirname } from 'path';
 import { createInterface } from 'readline';
 import { fileURLToPath } from 'url';
-import { UnsupportedError } from '../core/errors.js';
+import { NotFoundError, UnsupportedError } from '../core/errors.js';
 import { getIpInfo, isValidIP, isGeoIPAvailable, isBogon, isIPv6 } from './ip-intel.js';
 import { networkTools, networkToolHandlers } from './tools/network.js';
 import { seoTools, seoToolHandlers } from './tools/seo.js';
@@ -298,8 +298,9 @@ export class MCPServer {
         return 'general';
     }
     inferComplexity(content, docComment) {
-        if (/@complexity\s+(basic|intermediate|advanced)/i.test(docComment)) {
-            return docComment.match(/@complexity\s+(basic|intermediate|advanced)/i)[1].toLowerCase();
+        const complexityMatch = docComment.match(/@complexity\s+(basic|intermediate|advanced)/i);
+        if (complexityMatch?.[1]) {
+            return complexityMatch[1].toLowerCase();
         }
         const lines = content.split('\n').length;
         const hasAsyncAwait = /async|await/.test(content);
@@ -518,7 +519,7 @@ export class MCPServer {
             const path = uri.slice(7);
             const doc = this.docsIndex.find(d => d.path === path);
             if (!doc) {
-                throw new Error(`Documentation not found: ${path}`);
+                throw new NotFoundError(`Documentation not found: ${path}`, { resource: path });
             }
             return [{
                     uri,
@@ -531,7 +532,7 @@ export class MCPServer {
             const id = uri.slice(10);
             const example = this.codeExamples.find(e => e.id === id);
             if (!example) {
-                throw new Error(`Example not found: ${id}`);
+                throw new NotFoundError(`Example not found: ${id}`, { resource: id });
             }
             return [{
                     uri,
@@ -540,7 +541,9 @@ export class MCPServer {
                     type: 'resource',
                 }];
         }
-        throw new Error(`Unknown resource scheme: ${uri}`);
+        throw new UnsupportedError(`Unknown resource scheme: ${uri}`, {
+            feature: 'recker://, docs://, example://',
+        });
     }
     getResourceRegistry() {
         return this.resourceRegistry;

package/dist/mcp/tools/protocols.js

@@ -2,6 +2,7 @@ import { createFTP } from '../../protocols/ftp.js';
 import { createSFTP } from '../../protocols/sftp.js';
 import { createTelnet } from '../../protocols/telnet.js';
 import { createWebSocket } from '../../websocket/client.js';
+import { ProtocolError } from '../../core/errors.js';
 export const ftpConnectTool = {
     name: 'rek_ftp_connect',
     description: 'Connect to an FTP server and list directory contents. Supports FTPS (implicit TLS).',
@@ -143,7 +144,10 @@ export const ftpDownloadTool = {
             await ftp.close();
             const content = downloadResult.data;
             if (!content) {
-                throw new Error('Failed to download file');
+                throw new ProtocolError('Failed to download file', {
+                    protocol: 'ftp',
+                    phase: 'download',
+                });
             }
             let textContent;
             let isText = true;
@@ -334,7 +338,10 @@ export const sftpDownloadTool = {
             await sftp.close();
             const content = downloadResult.data;
             if (!content) {
-                throw new Error('Failed to download file');
+                throw new ProtocolError('Failed to download file', {
+                    protocol: 'sftp',
+                    phase: 'download',
+                });
             }
             let textContent;
             let isText = true;

package/dist/mcp/tools/registry.js

@@ -1,5 +1,6 @@
 import { matchesPattern } from '../profiles.js';
 import { getToolCategory, listCategories } from './categories.js';
+import { StateError, ValidationError } from '../../core/errors.js';
 export class ToolRegistry {
     tools = new Map();
     handlers = new Map();
@@ -13,7 +14,10 @@ export class ToolRegistry {
     }
     registerTool(tool, handler) {
         if (this.tools.has(tool.name)) {
-            throw new Error(`Tool already registered: ${tool.name}`);
+            throw new ValidationError(`Tool already registered: ${tool.name}`, {
+                field: 'tool.name',
+                value: tool.name,
+            });
         }
         this.tools.set(tool.name, tool);
         this.handlers.set(tool.name, handler);
@@ -22,7 +26,10 @@ export class ToolRegistry {
         for (const tool of module.tools) {
             const handler = module.handlers[tool.name];
             if (!handler) {
-                throw new Error(`Handler missing for tool: ${tool.name}`);
+                throw new ValidationError(`Handler missing for tool: ${tool.name}`, {
+                    field: `handlers["${tool.name}"]`,
+                    value: undefined,
+                });
             }
             this.registerTool(tool, handler);
         }
@@ -100,7 +107,10 @@ export class ToolRegistry {
     async callTool(name, args) {
         const handler = this.handlers.get(name);
         if (!handler) {
-            throw new Error(`Unknown tool: ${name}`);
+            throw new StateError(`Unknown tool: ${name}`, {
+                expectedState: 'registered tool',
+                actualState: name,
+            });
         }
         return handler(args);
     }