@jshookmcp/jshook 0.1.3 → 0.1.5

package/dist/services/prompts/environment.d.ts

@@ -14,4 +14,3 @@ export declare function generateMissingAPIImplementationsMessages(missingAPIs: A
     type: string;
 }>, code: string): LLMMessage[];
 export declare function generateMissingVariablesMessages(browserType: string, missingPaths: string[], code: string, existingManifest: Record<string, unknown>): LLMMessage[];
-//# sourceMappingURL=environment.d.ts.map

package/dist/services/prompts/environment.js

@@ -370,4 +370,3 @@ Return ONLY the JSON object:`;
         { role: 'user', content: userPrompt },
     ];
 }
-//# sourceMappingURL=environment.js.map

package/dist/services/prompts/intelligence.d.ts

@@ -2,4 +2,3 @@ import type { LLMMessage } from '../LLMService.js';
 export declare function generateRequestAnalysisMessages(requestSummary: object): LLMMessage[];
 export declare function generateLogAnalysisMessages(logSummary: object[]): LLMMessage[];
 export declare function generateKeywordExpansionMessages(domain: string, urlPatterns: object[], logKeywords: string[]): LLMMessage[];
-//# sourceMappingURL=intelligence.d.ts.map

package/dist/services/prompts/intelligence.js

@@ -248,4 +248,3 @@ Now analyze the data and return ONLY the JSON output.`;
         { role: 'user', content: userPrompt },
     ];
 }
-//# sourceMappingURL=intelligence.js.map

package/dist/services/prompts/taint.d.ts

@@ -1,3 +1,2 @@
 import type { LLMMessage } from '../LLMService.js';
 export declare function generateTaintAnalysisPrompt(code: string, sources: string[], sinks: string[]): LLMMessage[];
-//# sourceMappingURL=taint.d.ts.map

package/dist/services/prompts/taint.js

@@ -52,4 +52,3 @@ Return ONLY the JSON output.`;
         { role: 'user', content: userPrompt },
     ];
 }
-//# sourceMappingURL=taint.js.map

package/dist/types/analysis.d.ts

@@ -133,4 +133,3 @@ export interface SecurityRisk {
     description: string;
     recommendation: string;
 }
-//# sourceMappingURL=analysis.d.ts.map

package/dist/types/analysis.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=analysis.js.map

package/dist/types/browser.d.ts

@@ -14,4 +14,3 @@ declare global {
         }>;
     }
 }
-//# sourceMappingURL=browser.d.ts.map

package/dist/types/browser.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=browser.js.map

package/dist/types/collector.d.ts

@@ -54,4 +54,3 @@ export interface DependencyEdge {
     to: string;
     type: 'import' | 'require' | 'script';
 }
-//# sourceMappingURL=collector.d.ts.map

package/dist/types/collector.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=collector.js.map

package/dist/types/common.d.ts

@@ -9,4 +9,3 @@ export interface Result<T> {
     error?: string;
     message?: string;
 }
-//# sourceMappingURL=common.d.ts.map

package/dist/types/common.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=common.js.map

package/dist/types/config.d.ts

@@ -46,4 +46,3 @@ export interface PerformanceConfig {
     maxConcurrentAnalysis: number;
     maxCodeSizeMB: number;
 }
-//# sourceMappingURL=config.d.ts.map

package/dist/types/config.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=config.js.map

package/dist/types/crypto.d.ts

@@ -27,4 +27,3 @@ export interface CryptoLibrary {
     version?: string;
     confidence: number;
 }
-//# sourceMappingURL=crypto.d.ts.map

package/dist/types/crypto.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=crypto.js.map

package/dist/types/debugger.d.ts

@@ -84,4 +84,3 @@ export interface SessionData {
     crypto?: DetectCryptoResult;
     hooks?: HookRecord[];
 }
-//# sourceMappingURL=debugger.d.ts.map

package/dist/types/debugger.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=debugger.js.map

package/dist/types/deobfuscator.d.ts

@@ -20,4 +20,3 @@ export interface DeobfuscateResult {
     transformations: Transformation[];
     analysis: string;
 }
-//# sourceMappingURL=deobfuscator.d.ts.map

package/dist/types/deobfuscator.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=deobfuscator.js.map

package/dist/types/emulator.d.ts

@@ -39,4 +39,3 @@ export interface EnvironmentEmulatorResult {
     };
     aiAnalysis?: unknown;
 }
-//# sourceMappingURL=emulator.d.ts.map

package/dist/types/emulator.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=emulator.js.map

package/dist/types/hook.d.ts

@@ -40,4 +40,3 @@ export interface HookRecord {
     timestamp: number;
     context: HookContext;
 }
-//# sourceMappingURL=hook.d.ts.map

package/dist/types/hook.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=hook.js.map

package/dist/types/index.d.ts

@@ -9,4 +9,3 @@ export type { HookOptions, HookCondition, HookHandler, HookContext, CallStackFra
 export type { ScopeVariable, BreakpointHitEvent, BreakpointHitCallback, DebuggerSession, GetScopeVariablesOptions, GetScopeVariablesResult, Session, SessionData, } from './debugger.js';
 export type { DetectedEnvironmentVariables, MissingAPI, EmulationCode, EnvironmentEmulatorOptions, EnvironmentEmulatorResult, } from './emulator.js';
 export type { VMType, InstructionType, ComplexityLevel, VMInstruction, VMFeatures, UnresolvedPart, JSVMPDeobfuscatorOptions, JSVMPDeobfuscatorResult, } from './vm.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/types/index.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=index.js.map

package/dist/types/vm.d.ts

@@ -44,4 +44,3 @@ export interface JSVMPDeobfuscatorResult {
         processingTime: number;
     };
 }
-//# sourceMappingURL=vm.d.ts.map

package/dist/types/vm.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=vm.js.map

package/dist/utils/AdaptiveDataSerializer.d.ts

@@ -27,4 +27,3 @@ export declare class AdaptiveDataSerializer {
     private getFunctionTreeName;
     private simplifyFunctionTree;
 }
-//# sourceMappingURL=AdaptiveDataSerializer.d.ts.map

package/dist/utils/AdaptiveDataSerializer.js

@@ -229,4 +229,3 @@ export class AdaptiveDataSerializer {
         };
     }
 }
-//# sourceMappingURL=AdaptiveDataSerializer.js.map

package/dist/utils/CacheAdapters.d.ts

@@ -27,4 +27,3 @@ export declare class CodeCompressorAdapter implements CacheInstance {
     private estimateSize;
 }
 export declare function createCacheAdapters(detailedDataManager: DetailedDataManager, codeCache: CodeCache, codeCompressor: CodeCompressor): CacheInstance[];
-//# sourceMappingURL=CacheAdapters.d.ts.map

package/dist/utils/CacheAdapters.js

@@ -80,4 +80,3 @@ export function createCacheAdapters(detailedDataManager, codeCache, codeCompress
         new CodeCompressorAdapter(codeCompressor),
     ];
 }
-//# sourceMappingURL=CacheAdapters.js.map

package/dist/utils/DetailedDataManager.d.ts

@@ -64,4 +64,3 @@ export declare class DetailedDataManager {
     }[];
     clear(): void;
 }
-//# sourceMappingURL=DetailedDataManager.d.ts.map

package/dist/utils/DetailedDataManager.js

@@ -232,4 +232,3 @@ export class DetailedDataManager {
         logger.info('Cleared all detailed data cache');
     }
 }
-//# sourceMappingURL=DetailedDataManager.js.map

package/dist/utils/RingBuffer.d.ts

@@ -14,4 +14,3 @@ export declare class RingBuffer<T> {
     map<U>(fn: (item: T, index: number) => U): U[];
     private grow;
 }
-//# sourceMappingURL=RingBuffer.d.ts.map

package/dist/utils/RingBuffer.js

@@ -72,4 +72,3 @@ export class RingBuffer {
         this.tail = this.count;
     }
 }
-//# sourceMappingURL=RingBuffer.js.map

package/dist/utils/TokenBudgetManager.d.ts

@@ -63,4 +63,3 @@ export declare class TokenBudgetManager {
     isTrackingEnabled(): boolean;
     reset(): void;
 }
-//# sourceMappingURL=TokenBudgetManager.d.ts.map

package/dist/utils/TokenBudgetManager.js

@@ -307,4 +307,3 @@ export class TokenBudgetManager {
         logger.info('Token budget reset complete');
     }
 }
-//# sourceMappingURL=TokenBudgetManager.js.map

package/dist/utils/UnifiedCacheManager.d.ts

@@ -52,4 +52,3 @@ export declare class UnifiedCacheManager {
     preheat(urls: string[]): Promise<void>;
     private generateRecommendations;
 }
-//# sourceMappingURL=UnifiedCacheManager.d.ts.map

package/dist/utils/UnifiedCacheManager.js

@@ -203,4 +203,3 @@ export class UnifiedCacheManager {
         return recommendations;
     }
 }
-//# sourceMappingURL=UnifiedCacheManager.js.map

package/dist/utils/WorkerPool.d.ts

@@ -36,4 +36,3 @@ export declare class WorkerPool<TPayload extends Record<string, unknown>, TResul
     private terminateWorker;
     private toError;
 }
-//# sourceMappingURL=WorkerPool.d.ts.map

package/dist/utils/WorkerPool.js

@@ -270,4 +270,3 @@ export class WorkerPool {
         return new Error(`[${this.name}] ${message}`);
     }
 }
-//# sourceMappingURL=WorkerPool.js.map

package/dist/utils/artifactRetention.d.ts

@@ -0,0 +1,30 @@
+export interface ArtifactRetentionConfig {
+    enabled: boolean;
+    retentionDays: number;
+    maxTotalBytes: number;
+    cleanupOnStart: boolean;
+    cleanupIntervalMinutes: number;
+}
+export interface ArtifactCleanupResult {
+    success: boolean;
+    scannedFiles: number;
+    removedFiles: number;
+    removedBytes: number;
+    removedByAge: number;
+    removedBySize: number;
+    remainingFiles: number;
+    remainingBytes: number;
+    dryRun: boolean;
+    directories: string[];
+    removedSample: string[];
+    config: ArtifactRetentionConfig;
+}
+export declare function getArtifactRetentionConfig(env?: NodeJS.ProcessEnv): ArtifactRetentionConfig;
+export declare function cleanupArtifacts(options?: {
+    retentionDays?: number;
+    maxTotalBytes?: number;
+    dryRun?: boolean;
+    now?: number;
+    directories?: string[];
+}): Promise<ArtifactCleanupResult>;
+export declare function startArtifactRetentionScheduler(): (() => void) | null;

package/dist/utils/artifactRetention.js

@@ -0,0 +1,188 @@
+import { readdir, rm, stat } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { getArtifactDir, getArtifactsRoot } from './artifacts.js';
+import { getProjectRoot, resolveOutputDirectory } from './outputPaths.js';
+import { logger } from './logger.js';
+const DAY_MS = 24 * 60 * 60 * 1000;
+export function getArtifactRetentionConfig(env = process.env) {
+    const retentionDays = Math.max(0, parseInt(env.MCP_ARTIFACT_RETENTION_DAYS ?? '0', 10) || 0);
+    const maxTotalMb = Math.max(0, parseInt(env.MCP_ARTIFACT_MAX_TOTAL_MB ?? '0', 10) || 0);
+    const cleanupIntervalMinutes = Math.max(0, parseInt(env.MCP_ARTIFACT_CLEANUP_INTERVAL_MINUTES ?? '0', 10) || 0);
+    const cleanupOnStart = ['1', 'true'].includes((env.MCP_ARTIFACT_CLEANUP_ON_START ?? '').toLowerCase());
+    return {
+        enabled: retentionDays > 0 || maxTotalMb > 0,
+        retentionDays,
+        maxTotalBytes: maxTotalMb * 1024 * 1024,
+        cleanupOnStart,
+        cleanupIntervalMinutes,
+    };
+}
+export async function cleanupArtifacts(options) {
+    const envConfig = getArtifactRetentionConfig();
+    const config = {
+        ...envConfig,
+        retentionDays: options?.retentionDays ?? envConfig.retentionDays,
+        maxTotalBytes: options?.maxTotalBytes ?? envConfig.maxTotalBytes,
+    };
+    const now = options?.now ?? Date.now();
+    const dryRun = options?.dryRun ?? false;
+    const directories = options?.directories ?? getManagedArtifactDirectories();
+    const entries = await collectArtifactFiles(directories);
+    let remaining = [...entries];
+    const removedSample = [];
+    let removedFiles = 0;
+    let removedBytes = 0;
+    let removedByAge = 0;
+    let removedBySize = 0;
+    const cutoff = config.retentionDays > 0 ? now - config.retentionDays * DAY_MS : 0;
+    if (cutoff > 0) {
+        const agedOut = remaining.filter((entry) => entry.mtimeMs < cutoff).sort((a, b) => a.mtimeMs - b.mtimeMs);
+        if (agedOut.length > 0) {
+            const agedOutPaths = new Set(agedOut.map((entry) => entry.path));
+            remaining = remaining.filter((entry) => !agedOutPaths.has(entry.path));
+            removedFiles += agedOut.length;
+            removedBytes += agedOut.reduce((sum, entry) => sum + entry.size, 0);
+            removedByAge += agedOut.reduce((sum, entry) => sum + entry.size, 0);
+            removedSample.push(...agedOut.slice(0, 20 - removedSample.length).map((entry) => entry.relativePath));
+            if (!dryRun) {
+                await Promise.all(agedOut.map((entry) => rm(entry.path, { force: true })));
+            }
+        }
+    }
+    if (config.maxTotalBytes > 0) {
+        let totalBytes = remaining.reduce((sum, entry) => sum + entry.size, 0);
+        if (totalBytes > config.maxTotalBytes) {
+            const sizeCandidates = [...remaining].sort((a, b) => a.mtimeMs - b.mtimeMs);
+            const removedPaths = new Set();
+            for (const entry of sizeCandidates) {
+                if (totalBytes <= config.maxTotalBytes)
+                    break;
+                totalBytes -= entry.size;
+                removedPaths.add(entry.path);
+                removedFiles += 1;
+                removedBytes += entry.size;
+                removedBySize += entry.size;
+                if (removedSample.length < 20)
+                    removedSample.push(entry.relativePath);
+                if (!dryRun) {
+                    await rm(entry.path, { force: true });
+                }
+            }
+            remaining = remaining.filter((entry) => !removedPaths.has(entry.path));
+        }
+    }
+    if (!dryRun) {
+        await Promise.all(directories.map((dir) => pruneEmptyDirectories(dir)));
+    }
+    return {
+        success: true,
+        scannedFiles: entries.length,
+        removedFiles,
+        removedBytes,
+        removedByAge,
+        removedBySize,
+        remainingFiles: remaining.length,
+        remainingBytes: remaining.reduce((sum, entry) => sum + entry.size, 0),
+        dryRun,
+        directories,
+        removedSample,
+        config,
+    };
+}
+export function startArtifactRetentionScheduler() {
+    const config = getArtifactRetentionConfig();
+    if (!config.enabled || config.cleanupIntervalMinutes <= 0) {
+        return null;
+    }
+    const handle = setInterval(() => {
+        void cleanupArtifacts().then((result) => {
+            if (result.removedFiles > 0) {
+                logger.info(`[artifacts] retention cleanup removed ${result.removedFiles} files (${result.removedBytes} bytes)`);
+            }
+        }).catch((error) => {
+            logger.warn('[artifacts] retention cleanup failed', error);
+        });
+    }, config.cleanupIntervalMinutes * 60 * 1000);
+    handle.unref();
+    return () => clearInterval(handle);
+}
+function getManagedArtifactDirectories() {
+    const projectRoot = getProjectRoot();
+    const directories = new Set([
+        getArtifactsRoot(),
+        resolveOutputDirectory(process.env.MCP_SCREENSHOT_DIR, 'screenshots'),
+        resolve(projectRoot, 'debugger-sessions'),
+        resolve(process.cwd(), 'debugger-sessions'),
+    ]);
+    const categories = ['wasm', 'traces', 'profiles', 'dumps', 'reports', 'har', 'sessions', 'tmp'];
+    for (const category of categories) {
+        directories.add(getArtifactDir(category));
+    }
+    return [...directories];
+}
+async function collectArtifactFiles(directories) {
+    const root = getProjectRoot();
+    const files = [];
+    for (const directory of directories) {
+        await walk(directory, async (path) => {
+            const info = await stat(path);
+            if (!info.isFile())
+                return;
+            files.push({
+                path,
+                relativePath: relativePathFromRoot(root, path),
+                size: info.size,
+                mtimeMs: info.mtimeMs,
+            });
+        });
+    }
+    return dedupeFiles(files);
+}
+async function walk(directory, onFile) {
+    let entries;
+    try {
+        entries = await readdir(directory, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        const path = join(directory, entry.name);
+        if (entry.isDirectory()) {
+            await walk(path, onFile);
+        }
+        else if (entry.isFile()) {
+            await onFile(path);
+        }
+    }
+}
+async function pruneEmptyDirectories(directory) {
+    let entries;
+    try {
+        entries = await readdir(directory, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    await Promise.all(entries
+        .filter((entry) => entry.isDirectory())
+        .map((entry) => pruneEmptyDirectories(join(directory, entry.name))));
+    try {
+        const after = await readdir(directory);
+        if (after.length === 0) {
+            await rm(directory, { recursive: true, force: true });
+        }
+    }
+    catch {
+    }
+}
+function dedupeFiles(files) {
+    const byPath = new Map();
+    for (const file of files) {
+        byPath.set(file.path, file);
+    }
+    return [...byPath.values()];
+}
+function relativePathFromRoot(root, path) {
+    return path.startsWith(root) ? path.slice(root.length).replace(/^[\\/]/, '').replace(/\\/g, '/') : path.replace(/\\/g, '/');
+}

package/dist/utils/artifacts.d.ts

@@ -11,4 +11,3 @@ export declare function resolveArtifactPath(options: {
 }>;
 export declare function getArtifactsRoot(): string;
 export declare function getArtifactDir(category: ArtifactCategory): string;
-//# sourceMappingURL=artifacts.d.ts.map

package/dist/utils/artifacts.js

@@ -37,4 +37,3 @@ function sanitizeFilename(name) {
         .replace(/^_|_$/g, '')
         .substring(0, 60);
 }
-//# sourceMappingURL=artifacts.js.map

package/dist/utils/browserExecutable.d.ts

@@ -2,4 +2,3 @@ export declare function findBrowserExecutable(): string | undefined;
 export declare function clearBrowserPathCache(): void;
 export declare function getCachedBrowserPath(): string | undefined;
 export declare const resolveBrowserExecutablePath: typeof findBrowserExecutable;
-//# sourceMappingURL=browserExecutable.d.ts.map

package/dist/utils/browserExecutable.js

@@ -39,4 +39,3 @@ export function getCachedBrowserPath() {
     return cachedBrowserPath ?? undefined;
 }
 export const resolveBrowserExecutablePath = findBrowserExecutable;
-//# sourceMappingURL=browserExecutable.js.map

package/dist/utils/cache.d.ts

@@ -10,4 +10,3 @@ export declare class CacheManager {
     delete(key: string): Promise<void>;
     clear(): Promise<void>;
 }
-//# sourceMappingURL=cache.d.ts.map

package/dist/utils/cache.js

@@ -95,4 +95,3 @@ export class CacheManager {
         }
     }
 }
-//# sourceMappingURL=cache.js.map

package/dist/utils/cliFastPath.d.ts

@@ -4,4 +4,3 @@ export interface CliFastPathResult {
     output?: string;
 }
 export declare function resolveCliFastPath(args: string[], moduleUrl: string): CliFastPathResult;
-//# sourceMappingURL=cliFastPath.d.ts.map

package/dist/utils/cliFastPath.js

@@ -52,4 +52,3 @@ export function resolveCliFastPath(args, moduleUrl) {
         exitCode: 0,
     };
 }
-//# sourceMappingURL=cliFastPath.js.map

package/dist/utils/concurrency.d.ts

@@ -3,4 +3,3 @@ export declare const ioLimit: LimitFunction;
 export declare const cpuLimit: LimitFunction;
 export declare const cdpLimit: LimitFunction;
 export {};
-//# sourceMappingURL=concurrency.d.ts.map

package/dist/utils/concurrency.js

@@ -39,4 +39,3 @@ function pLimit(concurrency) {
 export const ioLimit = pLimit(parseInt(process.env.jshook_IO_CONCURRENCY || '4', 10));
 export const cpuLimit = pLimit(parseInt(process.env.jshook_CPU_CONCURRENCY || '2', 10));
 export const cdpLimit = pLimit(parseInt(process.env.jshook_CDP_CONCURRENCY || '2', 10));
-//# sourceMappingURL=concurrency.js.map

package/dist/utils/config.d.ts

@@ -5,4 +5,3 @@ export declare function validateConfig(config: Config): {
     valid: boolean;
     errors: string[];
 };
-//# sourceMappingURL=config.d.ts.map

package/dist/utils/config.js

@@ -106,4 +106,3 @@ export function validateConfig(config) {
     }
     return { valid: errors.length === 0, errors };
 }
-//# sourceMappingURL=config.js.map

package/dist/utils/environmentDoctor.d.ts

@@ -0,0 +1,27 @@
+export type DoctorStatus = 'ok' | 'warn' | 'missing' | 'error';
+export interface DoctorCheck {
+    name: string;
+    status: DoctorStatus;
+    detail: string;
+}
+export interface EnvironmentDoctorReport {
+    success: boolean;
+    generatedAt: string;
+    runtime: {
+        platform: NodeJS.Platform;
+        arch: string;
+        node: string;
+        cwd: string;
+        projectRoot: string;
+    };
+    packages: DoctorCheck[];
+    commands: DoctorCheck[];
+    bridges: DoctorCheck[];
+    config: Record<string, unknown>;
+    limitations: string[];
+    recommendations: string[];
+}
+export declare function runEnvironmentDoctor(options?: {
+    includeBridgeHealth?: boolean;
+}): Promise<EnvironmentDoctorReport>;
+export declare function formatEnvironmentDoctorReport(report: EnvironmentDoctorReport): string;