recker 1.0.15 → 1.0.17

package/dist/mcp/ip-intel.js

@@ -0,0 +1,209 @@
+import { Reader } from '@maxmind/geoip2-node';
+import { ensureGeoIPDatabase, hasLocalGeoIPDatabase } from './geoip-loader.js';
+const IPV4_BOGON_RANGES = [
+    { prefix: '0.', desc: 'This Network (RFC 1122)' },
+    { prefix: '10.', desc: 'Private-Use (RFC 1918)' },
+    { prefix: '100.64.', desc: 'Carrier-Grade NAT (RFC 6598)' },
+    { prefix: '127.', desc: 'Loopback (RFC 1122)' },
+    { prefix: '169.254.', desc: 'Link-Local (RFC 3927)' },
+    { prefix: '172.16.', desc: 'Private-Use (RFC 1918)' },
+    { prefix: '172.17.', desc: 'Private-Use (RFC 1918)' },
+    { prefix: '172.18.', desc: 'Private-Use (RFC 1918)' },
+    { prefix: '172.19.', desc: 'Private-Use (RFC 1918)' },
+    { prefix: '172.20.', desc: 'Private-Use (RFC 1918)' },
+    { prefix: '172.21.', desc: 'Private-Use (RFC 1918)' },
+    { prefix: '172.22.', desc: 'Private-Use (RFC 1918)' },
+    { prefix: '172.23.', desc: 'Private-Use (RFC 1918)' },
+    { prefix: '172.24.', desc: 'Private-Use (RFC 1918)' },
+    { prefix: '172.25.', desc: 'Private-Use (RFC 1918)' },
+    { prefix: '172.26.', desc: 'Private-Use (RFC 1918)' },
+    { prefix: '172.27.', desc: 'Private-Use (RFC 1918)' },
+    { prefix: '172.28.', desc: 'Private-Use (RFC 1918)' },
+    { prefix: '172.29.', desc: 'Private-Use (RFC 1918)' },
+    { prefix: '172.30.', desc: 'Private-Use (RFC 1918)' },
+    { prefix: '172.31.', desc: 'Private-Use (RFC 1918)' },
+    { prefix: '192.0.0.', desc: 'IETF Protocol Assignments (RFC 6890)' },
+    { prefix: '192.0.2.', desc: 'Documentation TEST-NET-1 (RFC 5737)' },
+    { prefix: '192.88.99.', desc: '6to4 Relay Anycast (RFC 3068)' },
+    { prefix: '192.168.', desc: 'Private-Use (RFC 1918)' },
+    { prefix: '198.18.', desc: 'Benchmarking (RFC 2544)' },
+    { prefix: '198.19.', desc: 'Benchmarking (RFC 2544)' },
+    { prefix: '198.51.100.', desc: 'Documentation TEST-NET-2 (RFC 5737)' },
+    { prefix: '203.0.113.', desc: 'Documentation TEST-NET-3 (RFC 5737)' },
+    { prefix: '224.', desc: 'Multicast (RFC 5771)' },
+    { prefix: '240.', desc: 'Reserved for Future Use (RFC 1112)' },
+    { prefix: '255.255.255.255', desc: 'Limited Broadcast (RFC 919)' }
+];
+function checkIPv4Bogon(ip) {
+    if (ip.startsWith('100.')) {
+        const secondOctet = parseInt(ip.split('.')[1], 10);
+        if (secondOctet >= 64 && secondOctet <= 127) {
+            return { isBogon: true, type: 'Carrier-Grade NAT (RFC 6598)' };
+        }
+    }
+    const firstOctet = parseInt(ip.split('.')[0], 10);
+    if (firstOctet >= 224 && firstOctet <= 239) {
+        return { isBogon: true, type: 'Multicast (RFC 5771)' };
+    }
+    for (const range of IPV4_BOGON_RANGES) {
+        if (ip.startsWith(range.prefix) || ip === range.prefix.slice(0, -1)) {
+            return { isBogon: true, type: range.desc };
+        }
+    }
+    return { isBogon: false };
+}
+function normalizeIPv6(ip) {
+    const lower = ip.toLowerCase();
+    if (lower.includes('.')) {
+        if (lower.startsWith('::ffff:')) {
+            return '0000:0000:0000:0000:0000:ffff:' + lower.slice(7);
+        }
+        if (lower.startsWith('::')) {
+            return '0000:0000:0000:0000:0000:0000:' + lower.slice(2);
+        }
+        return lower;
+    }
+    const parts = lower.split(':');
+    const emptyIndex = parts.findIndex((p, i) => p === '' && parts[i + 1] === '');
+    if (emptyIndex !== -1) {
+        const nonEmptyParts = parts.filter(p => p !== '');
+        const missingParts = 8 - nonEmptyParts.length;
+        const expansion = Array(missingParts).fill('0000');
+        const before = parts.slice(0, emptyIndex).filter(p => p !== '');
+        const after = parts.slice(emptyIndex).filter(p => p !== '');
+        const expanded = [...before, ...expansion, ...after];
+        return expanded.map(p => p.padStart(4, '0')).join(':');
+    }
+    if (parts[0] === '') {
+        const nonEmpty = parts.filter(p => p !== '');
+        const padding = Array(8 - nonEmpty.length).fill('0000');
+        return [...padding, ...nonEmpty].map(p => p.padStart(4, '0')).join(':');
+    }
+    return parts.map(p => p.padStart(4, '0')).join(':');
+}
+function checkIPv6Bogon(ip) {
+    const normalized = normalizeIPv6(ip);
+    if (normalized === '0000:0000:0000:0000:0000:0000:0000:0000') {
+        return { isBogon: true, type: 'Unspecified Address (RFC 4291)' };
+    }
+    if (normalized === '0000:0000:0000:0000:0000:0000:0000:0001') {
+        return { isBogon: true, type: 'Loopback (RFC 4291)' };
+    }
+    if (normalized.startsWith('0000:0000:0000:0000:0000:ffff:')) {
+        return { isBogon: true, type: 'IPv4-Mapped IPv6 (RFC 4291)' };
+    }
+    if (normalized.startsWith('fe8') || normalized.startsWith('fe9') ||
+        normalized.startsWith('fea') || normalized.startsWith('feb')) {
+        return { isBogon: true, type: 'Link-Local Unicast (RFC 4291)' };
+    }
+    if (normalized.startsWith('fc') || normalized.startsWith('fd')) {
+        return { isBogon: true, type: 'Unique Local Address (RFC 4193)' };
+    }
+    if (normalized.startsWith('ff')) {
+        return { isBogon: true, type: 'Multicast (RFC 4291)' };
+    }
+    if (normalized.startsWith('2001:0db8:')) {
+        return { isBogon: true, type: 'Documentation (RFC 3849)' };
+    }
+    return { isBogon: false };
+}
+export function isIPv6(ip) {
+    return ip.includes(':');
+}
+export function isBogon(ip) {
+    if (isIPv6(ip)) {
+        return checkIPv6Bogon(ip);
+    }
+    return checkIPv4Bogon(ip);
+}
+export function isValidIP(ip) {
+    if (!ip.includes(':')) {
+        const parts = ip.split('.');
+        if (parts.length !== 4)
+            return false;
+        return parts.every(p => {
+            const num = parseInt(p, 10);
+            return !isNaN(num) && num >= 0 && num <= 255 && p === num.toString();
+        });
+    }
+    const parts = ip.split(':');
+    if (parts.length < 2 || parts.length > 8)
+        return false;
+    const emptyParts = parts.filter(p => p === '').length;
+    if (emptyParts > 1 && !(emptyParts === 2 && parts[0] === '' && parts[1] === ''))
+        return false;
+    return parts.every(p => {
+        if (p === '')
+            return true;
+        if (p.includes('.'))
+            return isValidIP(p);
+        return /^[0-9a-fA-F]{1,4}$/.test(p);
+    });
+}
+let _reader = null;
+async function getReader() {
+    if (_reader) {
+        return _reader;
+    }
+    const dbPath = await ensureGeoIPDatabase();
+    if (!dbPath) {
+        return null;
+    }
+    try {
+        _reader = await Reader.open(dbPath);
+        return _reader;
+    }
+    catch {
+        return null;
+    }
+}
+export async function getIpInfo(ip) {
+    const ipv6 = isIPv6(ip);
+    const bogonCheck = isBogon(ip);
+    if (bogonCheck.isBogon) {
+        return {
+            ip,
+            bogon: true,
+            bogonType: bogonCheck.type,
+            isIPv6: ipv6,
+            org: bogonCheck.type
+        };
+    }
+    const reader = await getReader();
+    if (!reader) {
+        return {
+            ip,
+            isIPv6: ipv6,
+            org: 'GeoIP database not available'
+        };
+    }
+    try {
+        const result = reader.city(ip);
+        return {
+            ip,
+            city: result.city?.names?.en,
+            region: result.subdivisions?.[0]?.names?.en,
+            country: result.country?.names?.en,
+            countryCode: result.country?.isoCode,
+            continent: result.continent?.names?.en,
+            loc: result.location?.latitude && result.location?.longitude
+                ? `${result.location.latitude},${result.location.longitude}`
+                : undefined,
+            timezone: result.location?.timeZone,
+            postal: result.postal?.code,
+            accuracy: result.location?.accuracyRadius,
+            isIPv6: ipv6,
+        };
+    }
+    catch (error) {
+        return {
+            ip,
+            isIPv6: ipv6,
+            org: 'IP not found in GeoIP database'
+        };
+    }
+}
+export function isGeoIPAvailable() {
+    return hasLocalGeoIPDatabase();
+}
+export { getGeoIPDatabasePath } from './geoip-loader.js';

package/dist/mcp/search/hybrid-search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hybrid-search.d.ts","sourceRoot":"","sources":["../../../src/mcp/search/hybrid-search.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EACV,UAAU,EACV,YAAY,EACZ,aAAa,EACb,kBAAkB,EAGnB,MAAM,YAAY,CAAC;AAkBpB,qBAAa,YAAY;IACvB,OAAO,CAAC,IAAI,CAAiC;IAC7C,OAAO,CAAC,IAAI,CAAoB;IAChC,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAA+B;gBAEjC,MAAM,GAAE,kBAAuB;IAYrC,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YA+BrC,yBAAyB;IAuDjC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAmDjF,OAAO,CAAC,WAAW;IAiCnB,OAAO,CAAC,cAAc;IA8GtB,OAAO,CAAC,cAAc;IAoDtB,OAAO,CAAC,MAAM,CAAC,UAAU,CAoCtB;IAKH,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,cAAc;IAmBtB,aAAa,IAAI,OAAO;IAOxB,QAAQ,IAAI;QACV,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB;IAYD,OAAO,CAAC,GAAG;CAKZ;AAKD,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,YAAY,CAE5E"}
+{"version":3,"file":"hybrid-search.d.ts","sourceRoot":"","sources":["../../../src/mcp/search/hybrid-search.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EACV,UAAU,EACV,YAAY,EACZ,aAAa,EACb,kBAAkB,EAGnB,MAAM,YAAY,CAAC;AAkBpB,qBAAa,YAAY;IACvB,OAAO,CAAC,IAAI,CAAiC;IAC7C,OAAO,CAAC,IAAI,CAAoB;IAChC,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAA+B;gBAEjC,MAAM,GAAE,kBAAuB;IAYrC,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YAmCrC,yBAAyB;IAoCjC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAsDjF,OAAO,CAAC,WAAW;IA4EnB,OAAO,CAAC,cAAc;IA8GtB,OAAO,CAAC,cAAc;IAoDtB,OAAO,CAAC,MAAM,CAAC,UAAU,CAoCtB;IAKH,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,cAAc;IAmBtB,aAAa,IAAI,OAAO;IAOxB,QAAQ,IAAI;QACV,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB;IAYD,OAAO,CAAC,GAAG;CAKZ;AAKD,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,YAAY,CAE5E"}

package/dist/mcp/search/hybrid-search.js

@@ -1,5 +1,7 @@
 import Fuse from 'fuse.js';
 import { cosineSimilarity, combineScores, levenshtein } from './math.js';
+import { loadEmbeddings } from '../embeddings-loader.js';
+import { StateError } from '../../core/errors.js';
 let cachedEmbeddings = null;
 export class HybridSearch {
     fuse = null;
@@ -10,7 +12,7 @@ export class HybridSearch {
     config;
     constructor(config = {}) {
         this.config = {
-            fuzzyThreshold: config.fuzzyThreshold ?? 0.6,
+            fuzzyThreshold: config.fuzzyThreshold ?? 0.3,
             fuzzyWeight: config.fuzzyWeight ?? 0.5,
             semanticWeight: config.semanticWeight ?? 0.5,
             debug: config.debug ?? false,
@@ -20,11 +22,11 @@ export class HybridSearch {
         this.docs = docs;
         this.fuse = new Fuse(docs, {
             keys: [
-                { name: 'keywords', weight: 6 },
-                { name: 'title', weight: 4 },
-                { name: 'section', weight: 3 },
-                { name: 'path', weight: 1 },
-                { name: 'content', weight: 0.3 },
+                { name: 'keywords', weight: 10 },
+                { name: 'title', weight: 6 },
+                { name: 'section', weight: 4 },
+                { name: 'path', weight: 2 },
+                { name: 'content', weight: 0.5 },
             ],
             includeScore: true,
             threshold: this.config.fuzzyThreshold,
@@ -43,27 +45,12 @@ export class HybridSearch {
                 this.embeddingsData = cachedEmbeddings;
             }
             else {
-                const embeddingsPath = new URL('../data/embeddings.json', import.meta.url);
-                try {
-                    const response = await fetch(embeddingsPath);
-                    if (response.ok) {
-                        this.embeddingsData = (await response.json());
-                        cachedEmbeddings = this.embeddingsData;
-                    }
-                }
-                catch {
-                    try {
-                        const fs = await import('fs');
-                        const path = await import('path');
-                        const embeddingsFile = path.join(path.dirname(new URL(import.meta.url).pathname), '../data/embeddings.json');
-                        if (fs.existsSync(embeddingsFile)) {
-                            const data = fs.readFileSync(embeddingsFile, 'utf-8');
-                            this.embeddingsData = JSON.parse(data);
-                            cachedEmbeddings = this.embeddingsData;
-                        }
-                    }
-                    catch {
-                    }
+                const data = await loadEmbeddings({
+                    debug: this.config.debug,
+                });
+                if (data) {
+                    this.embeddingsData = data;
+                    cachedEmbeddings = data;
                 }
             }
             if (this.embeddingsData) {
@@ -82,7 +69,10 @@ export class HybridSearch {
     async search(query, options = {}) {
         const { limit = 10, category, mode = 'hybrid', minScore = 0 } = options;
         if (!this.initialized) {
-            throw new Error('HybridSearch not initialized. Call initialize() first.');
+            throw new StateError('HybridSearch not initialized. Call initialize() first.', {
+                expectedState: 'initialized',
+                actualState: 'not-initialized',
+            });
         }
         const cleanedQuery = this.cleanQuery(query);
         this.log(`Original query: "${query}" → Cleaned: "${cleanedQuery}"`);
@@ -121,13 +111,44 @@ export class HybridSearch {
         if (category) {
             results = results.filter((r) => r.item.category.toLowerCase().includes(category.toLowerCase()));
         }
-        return results.slice(0, limit).map((r) => ({
+        const queryTerms = this.tokenize(query);
+        const scored = results.slice(0, limit).map((r) => {
+            const fuseScore = r.score || 0;
+            const baseScore = 1 - fuseScore;
+            let boost = 0;
+            if (fuseScore < 0.3) {
+                const keywords = r.item.keywords || [];
+                const titleLower = r.item.title.toLowerCase();
+                for (const term of queryTerms) {
+                    if (keywords.some(k => k.toLowerCase() === term)) {
+                        boost += 0.15;
+                    }
+                }
+                for (const term of queryTerms) {
+                    if (titleLower.includes(term)) {
+                        boost += 0.10;
+                    }
+                }
+            }
+            else {
+                boost = -0.3;
+            }
+            return {
+                item: r.item,
+                baseScore,
+                boost,
+                finalScore: baseScore + boost,
+            };
+        });
+        scored.sort((a, b) => b.finalScore - a.finalScore);
+        const maxScore = scored[0]?.finalScore || 1;
+        return scored.map((r) => ({
             id: r.item.id,
             path: r.item.path,
             title: r.item.title,
             content: r.item.content,
             snippet: this.extractSnippet(r.item.content, query),
-            score: 1 - (r.score || 0),
+            score: Math.max(0, Math.min(1, r.finalScore / maxScore)),
             source: 'fuzzy',
         }));
     }
@@ -272,14 +293,14 @@ export class HybridSearch {
         'sim', 'nao', 'ja', 'ainda', 'sempre', 'nunca', 'tambem', 'so', 'apenas',
         'muito', 'pouco', 'mais', 'menos', 'bem', 'mal', 'assim', 'entao', 'logo',
         'yo', 'hey', 'oi', 'ola', 'bom', 'boa', 'obrigado', 'por favor',
-        'configure', 'configuro', 'configurar', 'configurando',
-        'use', 'usar', 'using', 'usar',
-        'create', 'criar', 'creating', 'criando',
-        'setup', 'setar', 'setting', 'setando',
-        'add', 'adicionar', 'adding', 'adicionando',
-        'get', 'getting', 'pegar', 'pegando',
-        'set', 'setting', 'definir', 'definindo',
-        'make', 'making', 'fazer', 'fazendo',
+        'configure', 'configuro', 'configurar', 'configurando', 'configura',
+        'use', 'usar', 'using', 'uso', 'usa',
+        'create', 'criar', 'creating', 'criando', 'cria', 'crio',
+        'setup', 'setar', 'setting', 'setando', 'seta', 'seto',
+        'add', 'adicionar', 'adding', 'adicionando', 'adiciona', 'adiciono',
+        'get', 'getting', 'pegar', 'pegando', 'pega', 'pego',
+        'set', 'setting', 'definir', 'definindo', 'define', 'defino',
+        'make', 'making', 'fazer', 'fazendo', 'faz', 'faço', 'faco',
     ]);
     cleanQuery(query) {
         const words = query

package/dist/mcp/search/math.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../../../src/mcp/search/math.ts"],"names":[],"mappings":"AAoBA,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAqBjE;AAgBD,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAyCxD;AAeD,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAI7D;AAmBD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,SAAK,GAAG,MAAM,CAEpE;AAWD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,SAAK,GAAG,MAAM,CAK5E"}
+{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../../../src/mcp/search/math.ts"],"names":[],"mappings":"AAsBA,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAwBjE;AAgBD,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAyCxD;AAeD,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAI7D;AAmBD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,SAAK,GAAG,MAAM,CAEpE;AAWD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,SAAK,GAAG,MAAM,CAK5E"}

package/dist/mcp/search/math.js

@@ -1,6 +1,10 @@
+import { ValidationError } from '../../core/errors.js';
 export function cosineSimilarity(a, b) {
     if (a.length !== b.length) {
-        throw new Error(`Vector length mismatch: ${a.length} vs ${b.length}`);
+        throw new ValidationError(`Vector length mismatch: ${a.length} vs ${b.length}`, {
+            field: 'vectorLength',
+            value: { a: a.length, b: b.length },
+        });
     }
     if (a.length === 0) {
         return 0;

package/dist/mcp/server.d.ts

@@ -21,6 +21,8 @@ export declare class MCPServer {
     private sseClients;
     private initialized;
     constructor(options?: MCPServerOptions);
+    private indexReady;
+    private ensureIndexReady;
     private log;
     private findDocsPath;
     private findExamplesPath;
@@ -49,6 +51,10 @@ export declare class MCPServer {
     private getCodeExamples;
     private getApiSchema;
     private getSuggestions;
+    private ipLookupResult;
+    private ipLookupPending;
+    private ipLookup;
+    private formatIpResult;
     private getFeatureConfig;
     private getCombinedConfig;
     handleRequest(req: JsonRpcRequest): JsonRpcResponse;

package/dist/mcp/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EAMhB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;AAExD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AA0CD,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,MAAM,CAAC,CAAkC;IACjD,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,eAAe,CAAwB;IAC/C,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,GAAE,gBAAqB;IAiB1C,OAAO,CAAC,GAAG;IAUX,OAAO,CAAC,YAAY;IAyBpB,OAAO,CAAC,gBAAgB;IAiBxB,OAAO,CAAC,WAAW;YAwBL,UAAU;YAoBV,SAAS;IAiCvB,OAAO,CAAC,iBAAiB;IA6BzB,OAAO,CAAC,gBAAgB;IAqCxB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,YAAY;IA0BpB,OAAO,CAAC,eAAe;IA4BvB,OAAO,CAAC,mBAAmB;IA6B3B,OAAO,CAAC,oBAAoB;IA8B5B,OAAO,CAAC,sBAAsB;IA0E9B,OAAO,CAAC,wBAAwB;IAoBhC,OAAO,CAAC,OAAO;IAyBf,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,eAAe;IAqBvB,OAAO,CAAC,QAAQ;IAkHhB,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,cAAc;IAoBtB,OAAO,CAAC,UAAU;IA0ElB,OAAO,CAAC,cAAc;IA6BtB,OAAO,CAAC,MAAM;IAmCd,OAAO,CAAC,eAAe;IAgDvB,OAAO,CAAC,YAAY;IAmEpB,OAAO,CAAC,cAAc;IAmFtB,OAAO,CAAC,gBAAgB;IA+DxB,OAAO,CAAC,iBAAiB;IAuCzB,aAAa,CAAC,GAAG,EAAE,cAAc,GAAG,eAAe;IA8DnD,OAAO,CAAC,gBAAgB;YAOV,UAAU;YAgCV,SAAS;YA8CT,QAAQ;IAuFhB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAatB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAe3B,OAAO,IAAI,MAAM;IAIjB,YAAY,IAAI,MAAM;IAItB,gBAAgB,IAAI,MAAM;IAI1B,aAAa,IAAI,MAAM;IAIvB,YAAY,IAAI,gBAAgB;CAGjC;AAoBD,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAErE"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EAMhB,MAAM,YAAY,CAAC;AAIpB,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;AAExD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AA0CD,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,MAAM,CAAC,CAAkC;IACjD,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,eAAe,CAAwB;IAC/C,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,GAAE,gBAAqB;IAsB1C,OAAO,CAAC,UAAU,CAA8B;YAKlC,gBAAgB;IAO9B,OAAO,CAAC,GAAG;IAUX,OAAO,CAAC,YAAY;IAyBpB,OAAO,CAAC,gBAAgB;IAiBxB,OAAO,CAAC,WAAW;YAwBL,UAAU;YAoBV,SAAS;IAiCvB,OAAO,CAAC,iBAAiB;IA6BzB,OAAO,CAAC,gBAAgB;IAqCxB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,YAAY;IA0BpB,OAAO,CAAC,eAAe;IA4BvB,OAAO,CAAC,mBAAmB;IA6B3B,OAAO,CAAC,oBAAoB;IA8B5B,OAAO,CAAC,sBAAsB;IA0E9B,OAAO,CAAC,wBAAwB;IAoBhC,OAAO,CAAC,OAAO;IAyBf,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,eAAe;IAqBvB,OAAO,CAAC,QAAQ;IAgIhB,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,cAAc;IAsBtB,OAAO,CAAC,UAAU;IA0ElB,OAAO,CAAC,cAAc;IA6BtB,OAAO,CAAC,MAAM;IAmCd,OAAO,CAAC,eAAe;IAgDvB,OAAO,CAAC,YAAY;IAmEpB,OAAO,CAAC,cAAc;IAmFtB,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,eAAe,CAA8B;IAErD,OAAO,CAAC,QAAQ;IA+DhB,OAAO,CAAC,cAAc;IA6CtB,OAAO,CAAC,gBAAgB;IA+DxB,OAAO,CAAC,iBAAiB;IAuCzB,aAAa,CAAC,GAAG,EAAE,cAAc,GAAG,eAAe;IA8DnD,OAAO,CAAC,gBAAgB;YAOV,UAAU;YAgCV,SAAS;YA8CT,QAAQ;IAuFhB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAe3B,OAAO,IAAI,MAAM;IAIjB,YAAY,IAAI,MAAM;IAItB,gBAAgB,IAAI,MAAM;IAI1B,aAAa,IAAI,MAAM;IAIvB,YAAY,IAAI,gBAAgB;CAGjC;AAoBD,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAErE"}

package/dist/mcp/server.js

@@ -4,6 +4,8 @@ import { join, relative, extname, basename, dirname } from 'path';
 import { createInterface } from 'readline';
 import { fileURLToPath } from 'url';
 import { createHybridSearch } from './search/index.js';
+import { UnsupportedError } from '../core/errors.js';
+import { getIpInfo, isValidIP, isGeoIPAvailable, isBogon, isIPv6 } from './ip-intel.js';
 export class MCPServer {
     options;
     server;
@@ -26,7 +28,13 @@ export class MCPServer {
             toolsFilter: options.toolsFilter || [],
         };
         this.hybridSearch = createHybridSearch({ debug: this.options.debug });
-        this.buildIndex();
+    }
+    indexReady = null;
+    async ensureIndexReady() {
+        if (!this.indexReady) {
+            this.indexReady = this.buildIndex();
+        }
+        await this.indexReady;
     }
     log(message, data) {
         if (this.options.debug) {
@@ -499,6 +507,20 @@ export class MCPServer {
                     required: ['useCase'],
                 },
             },
+            {
+                name: 'ip_lookup',
+                description: 'Get geolocation and network information for an IP address using the local MaxMind GeoLite2 database. Returns city, country, coordinates, timezone, and more. Works offline after first download.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        ip: {
+                            type: 'string',
+                            description: 'IPv4 or IPv6 address to lookup (e.g., "8.8.8.8", "2001:4860:4860::8888")',
+                        },
+                    },
+                    required: ['ip'],
+                },
+            },
         ];
         if (this.options.toolsFilter.length > 0) {
             return allTools.filter(tool => this.isToolEnabled(tool.name));
@@ -540,6 +562,8 @@ export class MCPServer {
                 return this.getApiSchema(args);
             case 'suggest':
                 return this.getSuggestions(args);
+            case 'ip_lookup':
+                return this.ipLookup(args);
             default:
                 return {
                     content: [{ type: 'text', text: `Unknown tool: ${name}` }],
@@ -814,6 +838,99 @@ export class MCPServer {
                 }],
         };
     }
+    ipLookupResult = null;
+    ipLookupPending = null;
+    ipLookup(args) {
+        const ip = String(args.ip || '').trim();
+        if (!ip) {
+            return {
+                content: [{ type: 'text', text: 'Error: ip is required' }],
+                isError: true,
+            };
+        }
+        if (!isValidIP(ip)) {
+            return {
+                content: [{ type: 'text', text: `Error: "${ip}" is not a valid IP address` }],
+                isError: true,
+            };
+        }
+        const bogonCheck = isBogon(ip);
+        const ipv6 = isIPv6(ip);
+        if (bogonCheck.isBogon) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: this.formatIpResult({
+                            ip,
+                            bogon: true,
+                            bogonType: bogonCheck.type,
+                            isIPv6: ipv6,
+                            org: bogonCheck.type,
+                        }),
+                    }],
+            };
+        }
+        if (!isGeoIPAvailable()) {
+            getIpInfo(ip).catch(() => { });
+            return {
+                content: [{
+                        type: 'text',
+                        text: `# GeoIP Database Required\n\nThe MaxMind GeoLite2 database is being downloaded (~70MB).\n\nPlease try again in a few seconds, or use the CLI:\n\n\`\`\`bash\nrek ip ${ip}\n\`\`\``,
+                    }],
+            };
+        }
+        this.ipLookupPending = getIpInfo(ip).then(info => {
+            this.ipLookupResult = info;
+        });
+        return {
+            content: [{
+                    type: 'text',
+                    text: `# IP Intelligence: ${ip}\n\n**Status:** Public ${ipv6 ? 'IPv6' : 'IPv4'} Address\n\nFor detailed geolocation data (city, country, coordinates, timezone), use the CLI:\n\n\`\`\`bash\nrek ip ${ip}\n\`\`\`\n\n_Note: The MCP server uses a synchronous protocol. Full GeoIP lookups are available via CLI._`,
+                }],
+        };
+    }
+    formatIpResult(info) {
+        const lines = [`# IP Intelligence: ${info.ip}\n`];
+        if (info.bogon) {
+            lines.push(`**Type:** Private/Reserved IP (Bogon)`);
+            lines.push(`**Category:** ${info.bogonType}`);
+            lines.push(`\nThis is a non-routable IP address used for internal networks or special purposes.`);
+        }
+        else {
+            if (info.city || info.region || info.country) {
+                const location = [info.city, info.region, info.country].filter(Boolean).join(', ');
+                lines.push(`**Location:** ${location}`);
+            }
+            if (info.countryCode) {
+                lines.push(`**Country Code:** ${info.countryCode}`);
+            }
+            if (info.continent) {
+                lines.push(`**Continent:** ${info.continent}`);
+            }
+            if (info.loc) {
+                lines.push(`**Coordinates:** ${info.loc}`);
+            }
+            if (info.timezone) {
+                lines.push(`**Timezone:** ${info.timezone}`);
+            }
+            if (info.postal) {
+                lines.push(`**Postal Code:** ${info.postal}`);
+            }
+            if (info.org) {
+                lines.push(`**Organization:** ${info.org}`);
+            }
+            if (info.asn) {
+                lines.push(`**ASN:** ${info.asn}`);
+            }
+            if (info.accuracy) {
+                lines.push(`**Accuracy:** ~${info.accuracy} km`);
+            }
+        }
+        if (info.isIPv6) {
+            lines.push(`\n_IPv6 Address_`);
+        }
+        return lines.join('\n');
+    }
     getFeatureConfig(feature) {
         const configs = {
             retry: `retry: {
@@ -1112,6 +1229,7 @@ const client = createClient({
         });
     }
     async start() {
+        await this.ensureIndexReady();
         switch (this.options.transport) {
             case 'stdio':
                 return this.startStdio();
@@ -1120,7 +1238,9 @@ const client = createClient({
             case 'sse':
                 return this.startSSE();
             default:
-                throw new Error(`Unknown transport: ${this.options.transport}`);
+                throw new UnsupportedError(`Unknown transport: ${this.options.transport}`, {
+                    feature: this.options.transport,
+                });
         }
     }
     async stop() {

package/dist/plugins/compression.js

@@ -1,6 +1,6 @@
 import { gzip, deflate, brotliCompress } from 'node:zlib';
 import { promisify } from 'node:util';
-import { ReckerError } from '../core/errors.js';
+import { UnsupportedError } from '../core/errors.js';
 const gzipAsync = promisify(gzip);
 const deflateAsync = promisify(deflate);
 const brotliAsync = promisify(brotliCompress);
@@ -72,7 +72,9 @@ async function compress(data, algorithm) {
         case 'br':
             return await brotliAsync(data);
         default:
-            throw new ReckerError(`Unsupported compression algorithm: ${algorithm}`, undefined, undefined, ['Use one of: gzip, br, deflate.', 'Remove compression setting or switch to a supported algorithm.']);
+            throw new UnsupportedError(`Unsupported compression algorithm: ${algorithm}`, {
+                feature: algorithm,
+            });
     }
 }
 export function compression(options = {}) {

package/dist/plugins/har-player.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"har-player.d.ts","sourceRoot":"","sources":["../../src/plugins/har-player.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAA6C,MAAM,mBAAmB,CAAC;AAKtF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IAEb,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAgBD,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAuF3D"}
+{"version":3,"file":"har-player.d.ts","sourceRoot":"","sources":["../../src/plugins/har-player.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAA6C,MAAM,mBAAmB,CAAC;AAKtF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IAEb,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAgBD,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAgF3D"}

package/dist/plugins/har-player.js

@@ -1,6 +1,6 @@
 import { readFileSync } from 'node:fs';
 import { HttpResponse } from '../core/response.js';
-import { ReckerError } from '../core/errors.js';
+import { ParseError, NotFoundError } from '../core/errors.js';
 export function harPlayer(options) {
     let entries = [];
     try {
@@ -9,11 +9,9 @@ export function harPlayer(options) {
         entries = har.log.entries;
     }
     catch (err) {
-        throw new ReckerError(`Failed to load HAR file: ${options.path}`, undefined, undefined, [
-            'Ensure the HAR file exists at the specified path.',
-            'Check that the file is valid JSON.',
-            'Verify the HAR file has the correct structure (log.entries).'
-        ]);
+        throw new ParseError(`Failed to load HAR file: ${options.path}`, {
+            format: 'har',
+        });
     }
     const matchEntry = (req, entry) => {
         if (req.method !== entry.request.method)
@@ -48,11 +46,10 @@ export function harPlayer(options) {
             return new HttpResponse(nativeRes);
         }
         if (options.strict) {
-            throw new ReckerError(`[Recker HAR Player] No matching recording found for ${req.method} ${req.url}`, req, undefined, [
-                'Ensure the HAR file contains an entry for this URL/method.',
-                'Normalize query parameters or body to match the recorded request.',
-                'Regenerate the HAR with the exact same request.'
-            ]);
+            throw new NotFoundError(`[Recker HAR Player] No matching recording found for ${req.method} ${req.url}`, {
+                resource: `${req.method} ${req.url}`,
+                request: req,
+            });
         }
         return next(req);
     };