recker 1.0.40 → 1.0.41-next.2e33802

package/dist/cli/index.js

@@ -4619,7 +4619,7 @@ ${colors.bold(colors.yellow('Tools provided:'))}
 ${colors.bold(colors.yellow('Claude Code config (~/.claude.json):'))}
   ${colors.gray(`{
     "mcpServers": {
-      "recker-docs": {
+      "recker": {
         "command": "npx",
         "args": ["recker", "mcp"]
       }

package/dist/cli/tui/shell-search.js

@@ -293,8 +293,8 @@ const { results, stats } = await client.batch([
             const data = await loadEmbeddings({ debug: false });
             if (data && data.documents && data.documents.length > 0) {
                 for (const doc of data.documents) {
-                    let content = '';
-                    if (!doc.section) {
+                    let content = doc.content || '';
+                    if (!content && !doc.section) {
                         const fullPath = join(this.docsPath, doc.path);
                         if (existsSync(fullPath)) {
                             content = readFileSync(fullPath, 'utf-8');

package/dist/mcp/prompts/index.d.ts

@@ -0,0 +1,16 @@
+import type { MCPPrompt, MCPPromptMessage } from '../types.js';
+export interface PromptHandler {
+    (args?: Record<string, string>): Promise<MCPPromptMessage[]> | MCPPromptMessage[];
+}
+export interface RegisteredPrompt {
+    definition: MCPPrompt;
+    handler: PromptHandler;
+}
+export declare class PromptRegistry {
+    private prompts;
+    constructor();
+    registerPrompt(definition: MCPPrompt, handler: PromptHandler): void;
+    listPrompts(): MCPPrompt[];
+    getPrompt(name: string, args?: Record<string, string>): Promise<MCPPromptMessage[]>;
+    private registerBuiltInPrompts;
+}

package/dist/mcp/prompts/index.js

@@ -0,0 +1,115 @@
+export class PromptRegistry {
+    prompts = new Map();
+    constructor() {
+        this.registerBuiltInPrompts();
+    }
+    registerPrompt(definition, handler) {
+        this.prompts.set(definition.name, { definition, handler });
+    }
+    listPrompts() {
+        return Array.from(this.prompts.values()).map(p => p.definition);
+    }
+    async getPrompt(name, args) {
+        const prompt = this.prompts.get(name);
+        if (!prompt) {
+            throw new Error(`Prompt not found: ${name}`);
+        }
+        return prompt.handler(args);
+    }
+    registerBuiltInPrompts() {
+        this.registerPrompt({
+            name: 'recker-expert',
+            description: 'Instructs the AI to act as a Recker SDK expert, focusing on best practices and idiomatic usage.',
+        }, () => [{
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `You are an expert in Recker, the AI & DevX focused Network SDK for Node.js.
+Your goal is to help developers build robust, efficient, and AI-powered network applications.
+
+Key Principles of Recker:
+1. **Zero-Config Defaults**: Prefer 'await recker.get()' over complex setup.
+2. **Unified API**: Use the same client for HTTP, DNS, WHOIS, and AI interactions.
+3. **Resilience**: Always suggest adding retries and circuit breakers for production code.
+4. **AI-Native**: Highlight features like 'stream().sse()' and 'recker.ai' when relevant.
+5. **Type Safety**: Emphasize Recker's strong TypeScript support.
+
+When providing code examples:
+- Use TypeScript.
+- Use 'import { recker, createClient } from "recker";'.
+- Prefer the functional API ('recker.get') for simple tasks.
+- Suggest 'createClient' for reusable configurations.
+- Use plugins (retry, cache, dedup) to solve reliability issues.`
+                }
+            }]);
+        this.registerPrompt({
+            name: 'generate-http-client',
+            description: 'Generates a robust Recker client configuration for a specific API.',
+            arguments: [
+                {
+                    name: 'apiName',
+                    description: 'Name of the API (e.g., "GitHub API", "Stripe")',
+                    required: true
+                },
+                {
+                    name: 'baseUrl',
+                    description: 'Base URL of the API',
+                    required: true
+                },
+                {
+                    name: 'authType',
+                    description: 'Authentication type (bearer, basic, api-key)',
+                    required: false
+                }
+            ]
+        }, (args) => {
+            const { apiName, baseUrl, authType = 'bearer' } = args || {};
+            return [{
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: `Generate a production-ready Recker client configuration for the ${apiName}.
+
+Target API: ${baseUrl}
+Auth Type: ${authType}
+
+Requirements:
+1. Use 'createClient'.
+2. Configure sensible defaults for retries (exponential backoff) and timeouts.
+3. Add a rate-limiting plugin if appropriate for this type of API.
+4. Include an example of how to use this client to make a request.
+5. If the API requires authentication, show how to inject the token securely (e.g., from process.env).`
+                    }
+                }];
+        });
+        this.registerPrompt({
+            name: 'seo-audit',
+            description: 'Guides the AI to perform a comprehensive SEO audit using Recker tools.',
+            arguments: [
+                {
+                    name: 'url',
+                    description: 'The URL to audit',
+                    required: true
+                }
+            ]
+        }, (args) => {
+            const { url } = args || {};
+            return [{
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: `I need to perform a comprehensive SEO audit for ${url}.
+
+Please use Recker's MCP tools to analyze the site. Follow this plan:
+
+1. **Initial Assessment**: Use 'rek_seo_analyze' to check the homepage for critical meta tag, structure, and performance issues.
+2. **Security Check**: Use 'rek_security_headers' and 'rek_tls_inspect' to ensure the site is secure and trusted.
+3. **Crawl**: Use 'rek_seo_spider' (limit to 20 pages) to identify broken links, duplicate content, or orphan pages.
+4. **Quick Wins**: Use 'rek_seo_quick_wins' to identify the high-impact, low-effort fixes.
+
+After running these tools, analyze the results and provide a prioritized action plan for improving the site's SEO.`
+                    }
+                }];
+        });
+    }
+}

package/dist/mcp/search/types.d.ts

@@ -32,6 +32,7 @@ export interface EmbeddingEntry {
     keywords: string[];
     section?: string;
     parentPath?: string;
+    content?: string;
     vector: number[];
 }
 export interface SearchOptions {

package/dist/mcp/server.d.ts

@@ -22,6 +22,7 @@ export declare class MCPServer {
     private sseClients;
     private initialized;
     private toolRegistry;
+    private promptRegistry;
     private aiClient?;
     constructor(options?: MCPServerOptions);
     private indexReady;

package/dist/mcp/server.js

@@ -13,6 +13,7 @@ import { scrapeTools, scrapeToolHandlers } from './tools/scrape.js';
 import { securityTools, securityToolHandlers } from './tools/security.js';
 import { ToolRegistry } from './tools/registry.js';
 import { loadToolModules } from './tools/loader.js';
+import { PromptRegistry } from './prompts/index.js';
 export class MCPServer {
     options;
     server;
@@ -23,10 +24,11 @@ export class MCPServer {
     sseClients = new Set();
     initialized = false;
     toolRegistry;
+    promptRegistry;
     aiClient;
     constructor(options = {}) {
         this.options = {
-            name: options.name || 'recker-docs',
+            name: options.name || 'recker',
             version: options.version || '1.0.0',
             docsPath: options.docsPath || this.findDocsPath(),
             examplesPath: options.examplesPath || this.findExamplesPath(),
@@ -43,6 +45,7 @@ export class MCPServer {
             embedder: (text, model) => this.generateEmbedding(text, model || 'BGESmallENV15'),
         });
         this.toolRegistry = new ToolRegistry();
+        this.promptRegistry = new PromptRegistry();
         this.registerInternalTools();
         this.toolRegistry.registerModule({
             tools: networkTools,
@@ -1150,8 +1153,24 @@ const client = createClient({
                         };
                     }
                 }
-                case 'prompts/list':
-                    return { jsonrpc: '2.0', id: id, result: { prompts: [] } };
+                case 'prompts/list': {
+                    const prompts = this.promptRegistry.listPrompts();
+                    return { jsonrpc: '2.0', id: id, result: { prompts } };
+                }
+                case 'prompts/get': {
+                    const { name, arguments: args } = params;
+                    try {
+                        const messages = await this.promptRegistry.getPrompt(name, args);
+                        return { jsonrpc: '2.0', id: id, result: { messages } };
+                    }
+                    catch (error) {
+                        return {
+                            jsonrpc: '2.0',
+                            id: id,
+                            error: { code: -32602, message: error.message },
+                        };
+                    }
+                }
                 default:
                     return {
                         jsonrpc: '2.0',

package/dist/mcp/tools/seo.js

@@ -76,7 +76,6 @@ function generateQuickWins(report) {
 async function seoAnalyze(args) {
     const url = String(args.url || '');
     const categories = args.categories;
-    const verbose = Boolean(args.verbose);
     if (!url) {
         return {
             content: [{ type: 'text', text: 'Error: url is required' }],
@@ -121,26 +120,21 @@ async function seoAnalyze(args) {
             }));
         }
         if (summary.warnings.length > 0) {
-            output.warnings = summary.warnings.slice(0, verbose ? undefined : 10).map(c => ({
+            output.warnings = summary.warnings.map(c => ({
                 name: c.name,
                 message: c.message,
                 recommendation: c.recommendation,
             }));
-            if (!verbose && summary.warnings.length > 10) {
-                output.warningsNote = `Showing 10 of ${summary.warnings.length} warnings. Use verbose=true to see all.`;
-            }
-        }
-        if (verbose) {
-            output.detailedAnalysis = {
-                title: report.title,
-                metaDescription: report.metaDescription,
-                headings: report.headings,
-                content: report.content,
-                links: report.links,
-                images: report.images,
-                technical: report.technical,
-            };
         }
+        output.detailedAnalysis = {
+            title: report.title,
+            metaDescription: report.metaDescription,
+            headings: report.headings,
+            content: report.content,
+            links: report.links,
+            images: report.images,
+            technical: report.technical,
+        };
         return {
             content: [{
                     type: 'text',
@@ -348,11 +342,6 @@ Perfect for analyzing your localhost dev server or any public URL. Categories in
                     items: { type: 'string' },
                     description: 'Filter by specific categories (e.g., ["meta", "security", "performance"]). Leave empty for all.',
                 },
-                verbose: {
-                    type: 'boolean',
-                    description: 'Include detailed analysis (headings, links, images breakdown)',
-                    default: false,
-                },
             },
             required: ['url'],
         },

package/dist/version.js

@@ -1,4 +1,4 @@
-const VERSION = '1.0.40';
+const VERSION = '1.0.41-next.2e33802';
 let _version = null;
 export async function getVersion() {
     if (_version)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "recker",
-  "version": "1.0.40",
+  "version": "1.0.41-next.2e33802",
   "description": "AI & DevX focused HTTP client for Node.js 18+",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",