recker 1.0.15-next.0e216c0 → 1.0.15-next.0eabd39

package/dist/mcp/embeddings-loader.js

@@ -1,6 +1,7 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
+import { DownloadError } from '../core/errors.js';
 function getPackageVersionFromPkg() {
     try {
         const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -78,14 +79,23 @@ export async function downloadEmbeddings(version) {
     try {
         const response = await fetch(url);
         if (!response.ok) {
-            throw new Error(`Failed to download embeddings: ${response.status} ${response.statusText}`);
+            throw new DownloadError(`Failed to download embeddings: ${response.status} ${response.statusText}`, {
+                url,
+                statusCode: response.status,
+                retriable: response.status >= 500,
+            });
         }
         const data = await response.json();
         saveLocalEmbeddings(data, ver);
         return data;
     }
     catch (error) {
-        throw new Error(`Failed to download embeddings from ${url}: ${error}`);
+        if (error instanceof DownloadError)
+            throw error;
+        throw new DownloadError(`Failed to download embeddings from ${url}: ${error}`, {
+            url,
+            retriable: true,
+        });
     }
 }
 export async function loadBundledEmbeddings() {

package/dist/mcp/geoip-loader.d.ts

@@ -0,0 +1,11 @@
+export declare function getGeoIPDatabasePath(): string;
+export declare function hasLocalGeoIPDatabase(): boolean;
+export declare function downloadGeoIPDatabase(): Promise<string>;
+export interface LoadGeoIPOptions {
+    forceDownload?: boolean;
+    offline?: boolean;
+    debug?: boolean;
+}
+export declare function ensureGeoIPDatabase(options?: LoadGeoIPOptions): Promise<string | null>;
+export declare function clearGeoIPCache(): void;
+//# sourceMappingURL=geoip-loader.d.ts.map

package/dist/mcp/geoip-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geoip-loader.d.ts","sourceRoot":"","sources":["../../src/mcp/geoip-loader.ts"],"names":[],"mappings":"AA4CA,wBAAgB,oBAAoB,IAAI,MAAM,CAG7C;AAKD,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAKD,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,MAAM,CAAC,CAiD7D;AAED,MAAM,WAAW,gBAAgB;IAE/B,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAuBD,wBAAsB,mBAAmB,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAoChG;AAKD,wBAAgB,eAAe,IAAI,IAAI,CAUtC"}

package/dist/mcp/geoip-loader.js

@@ -0,0 +1,107 @@
+import { existsSync, mkdirSync, createWriteStream, unlinkSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { createGunzip } from 'zlib';
+import { pipeline } from 'stream/promises';
+import { Readable } from 'stream';
+import { DownloadError } from '../core/errors.js';
+const GEOLITE2_CDN_URL = 'https://cdn.jsdelivr.net/npm/geolite2-city/GeoLite2-City.mmdb.gz';
+const DB_FILENAME = 'GeoLite2-City.mmdb';
+function getCacheDir() {
+    const homeDir = process.env.HOME || process.env.USERPROFILE || '';
+    if (homeDir) {
+        return join(homeDir, '.cache', 'recker');
+    }
+    try {
+        const __dirname = dirname(fileURLToPath(import.meta.url));
+        return join(__dirname, '..', '..', 'node_modules', '.cache', 'recker');
+    }
+    catch {
+        return join(process.cwd(), 'node_modules', '.cache', 'recker');
+    }
+}
+export function getGeoIPDatabasePath() {
+    const cacheDir = getCacheDir();
+    return join(cacheDir, DB_FILENAME);
+}
+export function hasLocalGeoIPDatabase() {
+    return existsSync(getGeoIPDatabasePath());
+}
+export async function downloadGeoIPDatabase() {
+    const dbPath = getGeoIPDatabasePath();
+    const cacheDir = dirname(dbPath);
+    if (!existsSync(cacheDir)) {
+        mkdirSync(cacheDir, { recursive: true });
+    }
+    try {
+        const response = await fetch(GEOLITE2_CDN_URL);
+        if (!response.ok) {
+            throw new DownloadError(`Failed to download GeoLite2 database: ${response.status} ${response.statusText}`, {
+                url: GEOLITE2_CDN_URL,
+                statusCode: response.status,
+                retriable: response.status >= 500,
+            });
+        }
+        if (!response.body) {
+            throw new DownloadError('No response body received', {
+                url: GEOLITE2_CDN_URL,
+                retriable: true,
+            });
+        }
+        const tempPath = dbPath + '.tmp';
+        const gunzip = createGunzip();
+        const writeStream = createWriteStream(tempPath);
+        const nodeStream = Readable.fromWeb(response.body);
+        await pipeline(nodeStream, gunzip, writeStream);
+        const fs = await import('fs/promises');
+        await fs.rename(tempPath, dbPath);
+        return dbPath;
+    }
+    catch (error) {
+        if (error instanceof DownloadError)
+            throw error;
+        throw new DownloadError(`Failed to download GeoLite2 database: ${error}`, {
+            url: GEOLITE2_CDN_URL,
+            retriable: true,
+        });
+    }
+}
+export async function ensureGeoIPDatabase(options = {}) {
+    const { forceDownload = false, offline = false, debug = false } = options;
+    const log = (msg) => {
+        if (debug)
+            console.log(`[geoip-loader] ${msg}`);
+    };
+    const dbPath = getGeoIPDatabasePath();
+    if (!forceDownload && hasLocalGeoIPDatabase()) {
+        log(`Using cached database: ${dbPath}`);
+        return dbPath;
+    }
+    if (!offline) {
+        try {
+            log('Downloading GeoLite2-City database...');
+            const downloaded = await downloadGeoIPDatabase();
+            log(`Downloaded and cached: ${downloaded}`);
+            return downloaded;
+        }
+        catch (error) {
+            log(`Download failed: ${error}`);
+        }
+    }
+    if (hasLocalGeoIPDatabase()) {
+        log(`Using stale cached database: ${dbPath}`);
+        return dbPath;
+    }
+    log('No GeoIP database available');
+    return null;
+}
+export function clearGeoIPCache() {
+    const dbPath = getGeoIPDatabasePath();
+    try {
+        if (existsSync(dbPath)) {
+            unlinkSync(dbPath);
+        }
+    }
+    catch {
+    }
+}

package/dist/mcp/ip-intel.d.ts

@@ -0,0 +1,28 @@
+export interface IpInfo {
+    ip: string;
+    hostname?: string;
+    city?: string;
+    region?: string;
+    country?: string;
+    countryCode?: string;
+    continent?: string;
+    loc?: string;
+    org?: string;
+    asn?: number;
+    timezone?: string;
+    postal?: string;
+    accuracy?: number;
+    bogon?: boolean;
+    bogonType?: string;
+    isIPv6?: boolean;
+}
+export declare function isIPv6(ip: string): boolean;
+export declare function isBogon(ip: string): {
+    isBogon: boolean;
+    type?: string;
+};
+export declare function isValidIP(ip: string): boolean;
+export declare function getIpInfo(ip: string): Promise<IpInfo>;
+export declare function isGeoIPAvailable(): boolean;
+export { getGeoIPDatabasePath } from './geoip-loader.js';
+//# sourceMappingURL=ip-intel.d.ts.map

package/dist/mcp/ip-intel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ip-intel.d.ts","sourceRoot":"","sources":["../../src/mcp/ip-intel.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAyID,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE1C;AAKD,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAKvE;AAKD,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAoB7C;AAsCD,wBAAsB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAqD3D;AAKD,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAKD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}

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":"AAiBA,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;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;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"}

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

@@ -1,6 +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;
@@ -68,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}"`);

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

@@ -51,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;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;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;IAgBtB,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;
@@ -505,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));
@@ -546,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}` }],
@@ -820,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: {
@@ -1127,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"}