@jshookmcp/jshook 0.1.2

package/dist/utils/config.js

@@ -0,0 +1,109 @@
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { config as dotenvConfig } from 'dotenv';
+import { z } from 'zod';
+const currentFilename = fileURLToPath(import.meta.url);
+const currentDirname = dirname(currentFilename);
+export const projectRoot = join(currentDirname, '..', '..');
+const envPath = join(projectRoot, '.env');
+const result = dotenvConfig({ path: envPath, quiet: true });
+if (result.error) {
+    console.error('[Config] Warning: Failed to load .env file from configured path');
+    console.error(`[Config] Error: ${result.error.message}`);
+    console.error('[Config] Will use environment variables or defaults');
+}
+else if (process.env.DEBUG === 'true') {
+    console.info('[Config] .env file loaded (debug mode)');
+}
+const envInt = (fallback) => z.string().optional()
+    .transform((v) => (v ? parseInt(v, 10) : fallback))
+    .pipe(z.number().int().finite());
+const envBool = (fallback) => z.string().optional()
+    .transform((v) => (v === undefined ? fallback : v === 'true'));
+const ConfigSchema = z.object({
+    DEFAULT_LLM_PROVIDER: z.enum(['openai', 'anthropic']).optional().default('openai'),
+    OPENAI_API_KEY: z.string().optional().default(''),
+    OPENAI_MODEL: z.string().optional().default('gpt-4-turbo-preview'),
+    OPENAI_BASE_URL: z.string().optional(),
+    ANTHROPIC_API_KEY: z.string().optional().default(''),
+    ANTHROPIC_MODEL: z.string().optional().default('claude-3-5-sonnet-20241022'),
+    ANTHROPIC_BASE_URL: z.string().optional(),
+    PUPPETEER_HEADLESS: envBool(false),
+    PUPPETEER_TIMEOUT: envInt(30000).pipe(z.number().min(1000).max(300000)),
+    PUPPETEER_EXECUTABLE_PATH: z.string().optional(),
+    CHROME_PATH: z.string().optional(),
+    BROWSER_EXECUTABLE_PATH: z.string().optional(),
+    MCP_SERVER_NAME: z.string().optional().default('jshookmcp'),
+    MCP_SERVER_VERSION: z.string().optional().default('0.1.0'),
+    ENABLE_CACHE: envBool(false),
+    CACHE_DIR: z.string().optional().default('.cache'),
+    CACHE_TTL: envInt(3600).pipe(z.number().min(0)),
+    MAX_CONCURRENT_ANALYSIS: envInt(3).pipe(z.number().min(1).max(32)),
+    MAX_CODE_SIZE_MB: envInt(10).pipe(z.number().min(1).max(500)),
+});
+export function getConfig() {
+    const parsed = ConfigSchema.safeParse(process.env);
+    if (!parsed.success) {
+        const issues = parsed.error.issues.map((i) => `  ${i.path.join('.')}: ${i.message}`);
+        console.error(`[Config] Validation errors:\n${issues.join('\n')}`);
+        console.error('[Config] Falling back to safe defaults for invalid fields');
+    }
+    const env = parsed.success ? parsed.data : process.env;
+    const cacheDir = env.CACHE_DIR || '.cache';
+    const configuredExecutablePath = (env.PUPPETEER_EXECUTABLE_PATH ||
+        env.CHROME_PATH ||
+        env.BROWSER_EXECUTABLE_PATH);
+    const absoluteCacheDir = cacheDir.startsWith('/') || cacheDir.match(/^[A-Za-z]:/)
+        ? cacheDir
+        : join(projectRoot, cacheDir);
+    return {
+        llm: {
+            provider: (env.DEFAULT_LLM_PROVIDER || 'openai'),
+            openai: {
+                apiKey: env.OPENAI_API_KEY || '',
+                model: env.OPENAI_MODEL || 'gpt-4-turbo-preview',
+                baseURL: env.OPENAI_BASE_URL,
+            },
+            anthropic: {
+                apiKey: env.ANTHROPIC_API_KEY || '',
+                model: env.ANTHROPIC_MODEL || 'claude-3-5-sonnet-20241022',
+                baseURL: env.ANTHROPIC_BASE_URL,
+            },
+        },
+        puppeteer: {
+            headless: parsed.success ? env.PUPPETEER_HEADLESS : process.env.PUPPETEER_HEADLESS === 'true',
+            timeout: parsed.success ? env.PUPPETEER_TIMEOUT : parseInt(process.env.PUPPETEER_TIMEOUT || '30000', 10),
+            executablePath: configuredExecutablePath?.trim() || undefined,
+        },
+        mcp: {
+            name: env.MCP_SERVER_NAME || 'jshookmcp',
+            version: env.MCP_SERVER_VERSION || '0.1.0',
+        },
+        cache: {
+            enabled: parsed.success ? env.ENABLE_CACHE : process.env.ENABLE_CACHE === 'true',
+            dir: absoluteCacheDir,
+            ttl: parsed.success ? env.CACHE_TTL : parseInt(process.env.CACHE_TTL || '3600', 10),
+        },
+        performance: {
+            maxConcurrentAnalysis: parsed.success ? env.MAX_CONCURRENT_ANALYSIS : parseInt(process.env.MAX_CONCURRENT_ANALYSIS || '3', 10),
+            maxCodeSizeMB: parsed.success ? env.MAX_CODE_SIZE_MB : parseInt(process.env.MAX_CODE_SIZE_MB || '10', 10),
+        },
+    };
+}
+export function validateConfig(config) {
+    const errors = [];
+    if (config.performance.maxConcurrentAnalysis < 1) {
+        errors.push('maxConcurrentAnalysis must be at least 1');
+    }
+    if (config.performance.maxCodeSizeMB < 1) {
+        errors.push('maxCodeSizeMB must be at least 1');
+    }
+    if (config.puppeteer.timeout < 1000) {
+        errors.push('puppeteer.timeout must be at least 1000ms');
+    }
+    if (config.cache.ttl < 0) {
+        errors.push('cache.ttl must be non-negative');
+    }
+    return { valid: errors.length === 0, errors };
+}
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,MAAM,IAAI,YAAY,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,eAAe,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACvD,MAAM,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;AAChD,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAE5D,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AAC1C,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAE5D,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;IACjB,OAAO,CAAC,KAAK,CAAC,iEAAiE,CAAC,CAAC;IACjF,OAAO,CAAC,KAAK,CAAC,mBAAmB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACzD,OAAO,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;AACvE,CAAC;KAAM,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;IACxC,OAAO,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;AACzD,CAAC;AAID,MAAM,MAAM,GAAG,CAAC,QAAgB,EAAE,EAAE,CAClC,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAClB,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;KAClD,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;AAErC,MAAM,OAAO,GAAG,CAAC,QAAiB,EAAE,EAAE,CACpC,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAClB,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC;AAEnE,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAE5B,oBAAoB,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC;IAClF,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACjD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,qBAAqB,CAAC;IAClE,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACpD,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,4BAA4B,CAAC;IAC5E,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAGzC,kBAAkB,EAAE,OAAO,CAAC,KAAK,CAAC;IAClC,iBAAiB,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACvE,yBAAyB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,uBAAuB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAG9C,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC;IAC3D,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;IAG1D,YAAY,EAAE,OAAO,CAAC,KAAK,CAAC;IAC5B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC;IAClD,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAG/C,uBAAuB,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClE,gBAAgB,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CAC9D,CAAC,CAAC;AAEH,MAAM,UAAU,SAAS;IACvB,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAEnD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CACpC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAC7C,CAAC;QACF,OAAO,CAAC,KAAK,CAAC,gCAAgC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnE,OAAO,CAAC,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC7E,CAAC;IAGD,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;IAEvD,MAAM,QAAQ,GAAI,GAAG,CAAC,SAAoB,IAAI,QAAQ,CAAC;IACvD,MAAM,wBAAwB,GAAG,CAC9B,GAAG,CAAC,yBAAoC;QACxC,GAAG,CAAC,WAAsB;QAC1B,GAAG,CAAC,uBAAkC,CACxC,CAAC;IACF,MAAM,gBAAgB,GACpB,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC;QACtD,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAElC,OAAO;QACL,GAAG,EAAE;YACH,QAAQ,EAAE,CAAE,GAAG,CAAC,oBAA+B,IAAI,QAAQ,CAA2B;YACtF,MAAM,EAAE;gBACN,MAAM,EAAG,GAAG,CAAC,cAAyB,IAAI,EAAE;gBAC5C,KAAK,EAAG,GAAG,CAAC,YAAuB,IAAI,qBAAqB;gBAC5D,OAAO,EAAE,GAAG,CAAC,eAAqC;aACnD;YACD,SAAS,EAAE;gBACT,MAAM,EAAG,GAAG,CAAC,iBAA4B,IAAI,EAAE;gBAC/C,KAAK,EAAG,GAAG,CAAC,eAA0B,IAAI,4BAA4B;gBACtE,OAAO,EAAE,GAAG,CAAC,kBAAwC;aACtD;SACF;QACD,SAAS,EAAE;YACT,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAE,GAAG,CAAC,kBAAyC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,MAAM;YACrH,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAE,GAAG,CAAC,iBAAuC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,OAAO,EAAE,EAAE,CAAC;YAC/H,cAAc,EAAE,wBAAwB,EAAE,IAAI,EAAE,IAAI,SAAS;SAC9D;QACD,GAAG,EAAE;YACH,IAAI,EAAG,GAAG,CAAC,eAA0B,IAAI,WAAW;YACpD,OAAO,EAAG,GAAG,CAAC,kBAA6B,IAAI,OAAO;SACvD;QACD,KAAK,EAAE;YACL,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAE,GAAG,CAAC,YAAmC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,MAAM;YACxG,GAAG,EAAE,gBAAgB;YACrB,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAE,GAAG,CAAC,SAA+B,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM,EAAE,EAAE,CAAC;SAC3G;QACD,WAAW,EAAE;YACX,qBAAqB,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAE,GAAG,CAAC,uBAA6C,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,GAAG,EAAE,EAAE,CAAC;YACrJ,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAE,GAAG,CAAC,gBAAsC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,IAAI,EAAE,EAAE,CAAC;SACjI;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,MAAM,CAAC,WAAW,CAAC,qBAAqB,GAAG,CAAC,EAAE,CAAC;QACjD,MAAM,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,MAAM,CAAC,WAAW,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC;QACzC,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IAClD,CAAC;IAED,IAAI,MAAM,CAAC,SAAS,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AAChD,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,16 @@
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+declare class Logger {
+    private level;
+    constructor(level?: LogLevel);
+    private shouldLog;
+    private formatMessage;
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+    success(message: string, ...args: unknown[]): void;
+    setLevel(level: LogLevel): void;
+}
+export declare const logger: Logger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAmBA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,cAAM,MAAM;IACV,OAAO,CAAC,KAAK,CAAW;gBAEZ,KAAK,GAAE,QAAiB;IAIpC,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,aAAa;IAcrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAOhD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMhD,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMlD,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;CAGhC;AAED,eAAO,MAAM,MAAM,QAA4D,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,66 @@
+import chalk from 'chalk';
+const SENSITIVE_KEYS = /^(auth(orization)?|cookie|set[_-]?cookie|x[_-]?api[_-]?key|token|access[_-]?token|refresh[_-]?token|id[_-]?token|secret|client[_-]?secret|password|passwd|api[_-]?key|private[_-]?key|credentials?|session[_-]?id|csrf[_-]?token)$/i;
+const SENSITIVE_VALUE_PATTERNS = /^(Bearer\s+\S|eyJ[A-Za-z0-9_-]{10,}|[A-Fa-f0-9]{32,}|sk[_-][A-Za-z0-9]{20,})/;
+function sensitiveReplacer(key, value) {
+    if (key && SENSITIVE_KEYS.test(key) && typeof value === 'string') {
+        return '[REDACTED]';
+    }
+    if (typeof value === 'string' && SENSITIVE_VALUE_PATTERNS.test(value)) {
+        return '[REDACTED]';
+    }
+    return value;
+}
+class Logger {
+    level;
+    constructor(level = 'info') {
+        this.level = level;
+    }
+    shouldLog(level) {
+        const levels = ['debug', 'info', 'warn', 'error'];
+        return levels.indexOf(level) >= levels.indexOf(this.level);
+    }
+    formatMessage(level, message, ...args) {
+        const timestamp = new Date().toISOString();
+        const prefix = `[${timestamp}] [${level.toUpperCase()}]`;
+        let formattedArgs = '';
+        if (args.length > 0) {
+            try {
+                formattedArgs = ' ' + JSON.stringify(args, sensitiveReplacer, undefined);
+            }
+            catch {
+                formattedArgs = ' [unserializable]';
+            }
+        }
+        return `${prefix} ${message}${formattedArgs}`;
+    }
+    debug(message, ...args) {
+        if (this.shouldLog('debug')) {
+            console.error(chalk.gray(this.formatMessage('debug', message, ...args)));
+        }
+    }
+    info(message, ...args) {
+        if (this.shouldLog('info')) {
+            console.error(chalk.blue(this.formatMessage('info', message, ...args)));
+        }
+    }
+    warn(message, ...args) {
+        if (this.shouldLog('warn')) {
+            console.error(chalk.yellow(this.formatMessage('warn', message, ...args)));
+        }
+    }
+    error(message, ...args) {
+        if (this.shouldLog('error')) {
+            console.error(chalk.red(this.formatMessage('error', message, ...args)));
+        }
+    }
+    success(message, ...args) {
+        if (this.shouldLog('info')) {
+            console.error(chalk.green(this.formatMessage('info', message, ...args)));
+        }
+    }
+    setLevel(level) {
+        this.level = level;
+    }
+}
+export const logger = new Logger(process.env.LOG_LEVEL || 'info');
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/outputPaths.d.ts

@@ -0,0 +1,13 @@
+export declare function getProjectRoot(): string;
+export declare function resolveOutputDirectory(inputDir: string | undefined, fallbackDir?: string): string;
+export declare function resolveScreenshotOutputPath(options: {
+    requestedPath?: string;
+    type?: 'png' | 'jpeg';
+    fallbackName?: string;
+    fallbackDir?: string;
+}): Promise<{
+    absolutePath: string;
+    displayPath: string;
+    pathRewritten: boolean;
+}>;
+//# sourceMappingURL=outputPaths.d.ts.map

package/dist/utils/outputPaths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outputPaths.d.ts","sourceRoot":"","sources":["../../src/utils/outputPaths.ts"],"names":[],"mappings":"AA4CA,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,WAAW,SAAgB,GAAG,MAAM,CAWxG;AAED,wBAAsB,2BAA2B,CAAC,OAAO,EAAE;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,OAAO,CAAA;CAAE,CAAC,CAgCjF"}

package/dist/utils/outputPaths.js

@@ -0,0 +1,71 @@
+import { mkdir } from 'node:fs/promises';
+import { basename, dirname, extname, isAbsolute, normalize, relative, resolve, sep, } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const currentFile = fileURLToPath(import.meta.url);
+const currentDir = dirname(currentFile);
+const projectRoot = resolve(currentDir, '..', '..');
+function isInside(baseDir, targetPath) {
+    const rel = relative(baseDir, targetPath);
+    if (!rel || rel === '..' || rel.startsWith(`..${sep}`) || isAbsolute(rel)) {
+        return false;
+    }
+    return true;
+}
+function resolveWithinProject(inputPath) {
+    const candidate = isAbsolute(inputPath) ? normalize(inputPath) : resolve(projectRoot, inputPath);
+    return isInside(projectRoot, candidate)
+        ? candidate
+        : resolve(projectRoot, 'screenshots', 'external', normalize(inputPath).split(/[\\/]/).pop() || 'output.bin');
+}
+function withDefaultExtension(filePath, extension) {
+    if (extname(filePath)) {
+        return filePath;
+    }
+    return `${filePath}.${extension.replace(/^\./, '')}`;
+}
+export function getProjectRoot() {
+    return projectRoot;
+}
+export function resolveOutputDirectory(inputDir, fallbackDir = 'screenshots') {
+    const requested = inputDir?.trim();
+    if (!requested) {
+        return resolve(projectRoot, fallbackDir);
+    }
+    const resolved = resolveWithinProject(requested);
+    if (isInside(projectRoot, resolved)) {
+        return resolved;
+    }
+    return resolve(projectRoot, fallbackDir);
+}
+export async function resolveScreenshotOutputPath(options) {
+    const extension = options.type === 'jpeg' ? 'jpg' : 'png';
+    const fallbackDir = options.fallbackDir || 'screenshots/manual';
+    const fallbackName = options.fallbackName || 'page';
+    const screenshotRoot = resolveOutputDirectory(process.env.MCP_SCREENSHOT_DIR, fallbackDir);
+    const requested = options.requestedPath?.trim();
+    let absolutePath;
+    let pathRewritten = false;
+    if (!requested) {
+        absolutePath = resolve(screenshotRoot, `${fallbackName}-${Date.now()}.${extension}`);
+        pathRewritten = true;
+    }
+    else {
+        const requestedWithExt = withDefaultExtension(requested, extension);
+        if (isAbsolute(requestedWithExt)) {
+            absolutePath = normalize(requestedWithExt);
+        }
+        else {
+            absolutePath = resolve(screenshotRoot, requestedWithExt);
+            if (!isInside(screenshotRoot, absolutePath)) {
+                absolutePath = resolve(screenshotRoot, basename(absolutePath));
+                pathRewritten = true;
+            }
+        }
+    }
+    await mkdir(dirname(absolutePath), { recursive: true });
+    const displayPath = isAbsolute(requested || '')
+        ? absolutePath.replace(/\\/g, '/')
+        : relative(projectRoot, absolutePath).replace(/\\/g, '/');
+    return { absolutePath, displayPath, pathRewritten };
+}
+//# sourceMappingURL=outputPaths.js.map

package/dist/utils/outputPaths.js.map

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

package/dist/utils/parallel.d.ts

@@ -0,0 +1,40 @@
+export interface ParallelOptions {
+    maxConcurrency?: number;
+    timeout?: number;
+    retryOnError?: boolean;
+    maxRetries?: number;
+}
+export interface TaskResult<T> {
+    success: boolean;
+    data?: T;
+    error?: Error;
+    duration: number;
+}
+export declare function parallelExecute<T, R>(items: T[], executor: (item: T, index: number) => Promise<R>, options?: ParallelOptions): Promise<TaskResult<R>[]>;
+export declare function batchProcess<T, R>(items: T[], executor: (batch: T[]) => Promise<R[]>, batchSize?: number): Promise<R[]>;
+export declare class TaskQueue<T, R> {
+    private queue;
+    private running;
+    private maxConcurrency;
+    private executor;
+    constructor(executor: (item: T) => Promise<R>, maxConcurrency?: number);
+    add(item: T): Promise<R>;
+    private process;
+    getStatus(): {
+        queueLength: number;
+        running: number;
+        maxConcurrency: number;
+    };
+    clear(): void;
+}
+export declare class RateLimiter {
+    private tokens;
+    private maxTokens;
+    private refillRate;
+    private lastRefill;
+    constructor(maxTokens: number, refillRate: number);
+    private refill;
+    acquire(tokens?: number): Promise<void>;
+    getTokens(): number;
+}
+//# sourceMappingURL=parallel.d.ts.map

package/dist/utils/parallel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel.d.ts","sourceRoot":"","sources":["../../src/utils/parallel.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,eAAe;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,eAAe,CAAC,CAAC,EAAE,CAAC,EACxC,KAAK,EAAE,CAAC,EAAE,EACV,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EAChD,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CA4D1B;AAED,wBAAsB,YAAY,CAAC,CAAC,EAAE,CAAC,EACrC,KAAK,EAAE,CAAC,EAAE,EACV,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,EACtC,SAAS,GAAE,MAAW,GACrB,OAAO,CAAC,CAAC,EAAE,CAAC,CAmBd;AAED,qBAAa,SAAS,CAAC,CAAC,EAAE,CAAC;IACzB,OAAO,CAAC,KAAK,CAIL;IACR,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAA0B;gBAE9B,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,cAAc,GAAE,MAAU;IAKnE,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;YAOhB,OAAO;IAqBrB,SAAS;;;;;IAQT,KAAK,IAAI,IAAI;CAMd;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAS;gBAEf,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAOjD,OAAO,CAAC,MAAM;IASR,OAAO,CAAC,MAAM,GAAE,MAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAchD,SAAS,IAAI,MAAM;CAIpB"}

package/dist/utils/parallel.js

@@ -0,0 +1,149 @@
+import { logger } from './logger.js';
+import { PARALLEL_DEFAULT_CONCURRENCY, PARALLEL_DEFAULT_TIMEOUT_MS, PARALLEL_DEFAULT_MAX_RETRIES, PARALLEL_RETRY_BACKOFF_BASE_MS, } from '../constants.js';
+export async function parallelExecute(items, executor, options = {}) {
+    const { maxConcurrency = PARALLEL_DEFAULT_CONCURRENCY, timeout = PARALLEL_DEFAULT_TIMEOUT_MS, retryOnError = false, maxRetries = PARALLEL_DEFAULT_MAX_RETRIES } = options;
+    const results = [];
+    const executing = new Set();
+    for (let i = 0; i < items.length; i++) {
+        const item = items[i];
+        if (item === undefined)
+            continue;
+        const task = (async () => {
+            const startTime = Date.now();
+            let lastError;
+            for (let attempt = 0; attempt <= (retryOnError ? maxRetries : 0); attempt++) {
+                try {
+                    const result = await new Promise((resolve, reject) => {
+                        const timer = setTimeout(() => reject(new Error('Task timeout')), timeout);
+                        executor(item, i).then((v) => { clearTimeout(timer); resolve(v); }, (e) => { clearTimeout(timer); reject(e); });
+                    });
+                    results[i] = {
+                        success: true,
+                        data: result,
+                        duration: Date.now() - startTime,
+                    };
+                    return;
+                }
+                catch (error) {
+                    lastError = error instanceof Error ? error : new Error(String(error));
+                    if (attempt < (retryOnError ? maxRetries : 0)) {
+                        logger.warn(`Task ${i} failed, retrying (${attempt + 1}/${maxRetries})...`);
+                        await new Promise((resolve) => setTimeout(resolve, PARALLEL_RETRY_BACKOFF_BASE_MS * (attempt + 1)));
+                    }
+                }
+            }
+            results[i] = {
+                success: false,
+                error: lastError,
+                duration: Date.now() - startTime,
+            };
+        })();
+        const wrappedTask = task.then(() => { executing.delete(wrappedTask); }, () => { executing.delete(wrappedTask); });
+        executing.add(wrappedTask);
+        if (executing.size >= maxConcurrency) {
+            await Promise.race(executing);
+        }
+    }
+    await Promise.all(executing);
+    return results;
+}
+export async function batchProcess(items, executor, batchSize = 10) {
+    const results = [];
+    for (let i = 0; i < items.length; i += batchSize) {
+        const batch = items.slice(i, i + batchSize);
+        logger.debug(`Processing batch ${Math.floor(i / batchSize) + 1}/${Math.ceil(items.length / batchSize)}`);
+        try {
+            const batchResults = await executor(batch);
+            results.push(...batchResults);
+        }
+        catch (error) {
+            logger.error(`Batch processing failed at index ${i}`, error);
+            throw error;
+        }
+    }
+    return results;
+}
+export class TaskQueue {
+    queue = [];
+    running = 0;
+    maxConcurrency;
+    executor;
+    constructor(executor, maxConcurrency = 3) {
+        this.executor = executor;
+        this.maxConcurrency = maxConcurrency;
+    }
+    async add(item) {
+        return new Promise((resolve, reject) => {
+            this.queue.push({ item, resolve, reject });
+            this.process();
+        });
+    }
+    async process() {
+        if (this.running >= this.maxConcurrency || this.queue.length === 0) {
+            return;
+        }
+        const task = this.queue.shift();
+        if (!task)
+            return;
+        this.running++;
+        try {
+            const result = await this.executor(task.item);
+            task.resolve(result);
+        }
+        catch (error) {
+            task.reject(error instanceof Error ? error : new Error(String(error)));
+        }
+        finally {
+            this.running--;
+            this.process();
+        }
+    }
+    getStatus() {
+        return {
+            queueLength: this.queue.length,
+            running: this.running,
+            maxConcurrency: this.maxConcurrency,
+        };
+    }
+    clear() {
+        this.queue.forEach((task) => {
+            task.reject(new Error('Queue cleared'));
+        });
+        this.queue = [];
+    }
+}
+export class RateLimiter {
+    tokens;
+    maxTokens;
+    refillRate;
+    lastRefill;
+    constructor(maxTokens, refillRate) {
+        this.maxTokens = maxTokens;
+        this.tokens = maxTokens;
+        this.refillRate = refillRate;
+        this.lastRefill = Date.now();
+    }
+    refill() {
+        const now = Date.now();
+        const elapsed = (now - this.lastRefill) / 1000;
+        const tokensToAdd = elapsed * this.refillRate;
+        this.tokens = Math.min(this.maxTokens, this.tokens + tokensToAdd);
+        this.lastRefill = now;
+    }
+    async acquire(tokens = 1) {
+        while (true) {
+            this.refill();
+            if (this.tokens >= tokens) {
+                this.tokens -= tokens;
+                return;
+            }
+            const waitTime = ((tokens - this.tokens) / this.refillRate) * 1000;
+            await new Promise((resolve) => setTimeout(resolve, Math.min(waitTime, 1000)));
+        }
+    }
+    getTokens() {
+        this.refill();
+        return this.tokens;
+    }
+}
+//# sourceMappingURL=parallel.js.map

package/dist/utils/parallel.js.map

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

package/package.json

@@ -0,0 +1,115 @@
+{
+  "name": "@jshookmcp/jshook",
+  "version": "0.1.2",
+  "packageManager": "pnpm@10.28.2",
+  "description": "MCP server with 242 built-in tools (234 domain tools across 16 domains) for AI-assisted JavaScript analysis and security analysis — browser automation, CDP debugging, network monitoring, JS hooks, code analysis, and workflow orchestration",
+  "mcpName": "io.github.vmoranv/jshookmcp",
+  "main": "dist/index.js",
+  "type": "module",
+  "files": [
+    "dist",
+    "src/native/scripts"
+  ],
+  "bin": {
+    "jshook": "dist/index.js",
+    "jshookmcp": "dist/index.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vmoranv/jshookmcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/vmoranv/jshookmcp/issues"
+  },
+  "homepage": "https://github.com/vmoranv/jshookmcp#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && tsc-alias -p tsconfig.json --resolve-full-paths && pnpm -C packages/extension-sdk build && node scripts/copy-native-scripts.mjs",
+    "typecheck": "tsc --noEmit -p tsconfig.json && pnpm -C packages/extension-sdk typecheck",
+    "dev": "tsx --conditions=development watch src/index.ts",
+    "start": "node dist/index.js",
+    "lint": "eslint src --ext .ts",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "test": "vitest run",
+    "prepare": "pnpm run build",
+    "audit:tools": "node scripts/audit-tools.mjs",
+    "check": "pnpm run lint && pnpm run typecheck && pnpm run test",
+    "package": "pnpm pack",
+    "prepublishOnly": "pnpm run check",
+    "install:full": "pnpm install && pnpm exec camoufox-js fetch"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "javascript",
+    "javascript-analysis",
+    "security-analysis",
+    "hook",
+    "hooking",
+    "deobfuscation",
+    "ai",
+    "claude",
+    "puppeteer",
+    "chrome-devtools",
+    "debugger",
+    "web-scraping",
+    "anti-detection",
+    "captcha",
+    "browser-automation",
+    "network-monitoring",
+    "ast",
+    "obfuscation",
+    "cryptography-detection",
+    "code-analysis"
+  ],
+  "author": {
+    "name": "vmoranv",
+    "url": "https://github.com/vmoranv"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.78.0",
+    "@babel/generator": "^7.29.1",
+    "@babel/parser": "^7.29.0",
+    "@babel/traverse": "^7.29.0",
+    "@babel/types": "^7.29.0",
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "dotenv": "^17.3.1",
+    "koffi": "^2.15.1",
+    "openai": "^6.25.0",
+    "ora": "^9.3.0",
+    "rebrowser-puppeteer-core": "^24.8.1",
+    "zod": "^4.3.6"
+  },
+  "optionalDependencies": {
+    "camoufox-js": "^0.9.1",
+    "playwright-core": "^1.58.2"
+  },
+  "devDependencies": {
+    "@types/babel__generator": "^7.27.0",
+    "@types/babel__traverse": "^7.28.0",
+    "@types/node": "^25.3.0",
+    "@typescript-eslint/eslint-plugin": "^8.56.1",
+    "@typescript-eslint/parser": "^8.56.1",
+    "eslint": "^10.0.2",
+    "nodemon": "^3.1.14",
+    "prettier": "^3.8.1",
+    "tsc-alias": "^1.8.16",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "esbuild",
+      "better-sqlite3"
+    ]
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}

package/src/native/scripts/linux/enum-windows.sh

@@ -0,0 +1,12 @@
+#!/bin/bash
+# enum-windows.sh
+# Linux window enumeration script (placeholder)
+
+TARGET_PID=$1
+
+# Use xdotool or wmctrl for window enumeration
+# This is a placeholder for future implementation
+
+if command -v xdotool &> /dev/null; then
+    xdotool search --pid "$TARGET_PID" --name "" get-window-name
+fi