@jshookmcp/jshook 0.1.3 → 0.1.5

package/dist/cli/doctor.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/doctor.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { formatEnvironmentDoctorReport, runEnvironmentDoctor } from '../utils/environmentDoctor.js';
+const report = await runEnvironmentDoctor({ includeBridgeHealth: true });
+process.stdout.write(`${formatEnvironmentDoctorReport(report)}\n`);
+process.exit(0);

package/dist/constants.d.ts

@@ -58,6 +58,17 @@ export declare const WORKFLOW_JS_BUNDLE_MAX_REDIRECTS: number;
 export declare const WORKFLOW_JS_BUNDLE_FETCH_TIMEOUT_MS: number;
 export declare const WORKFLOW_BUNDLE_CACHE_TTL_MS: number;
 export declare const WORKFLOW_BUNDLE_CACHE_MAX_BYTES: number;
+export declare const SEARCH_WORKFLOW_BOOST_TIERS: Set<string>;
+export declare const SEARCH_WORKFLOW_DOMAIN_BOOST_MULTIPLIER: number;
+export type SearchIntentToolBoostRuleConfig = {
+    pattern: string;
+    flags?: string;
+    boosts: Array<{
+        tool: string;
+        bonus: number;
+    }>;
+};
+export declare const SEARCH_INTENT_TOOL_BOOST_RULES_OVERRIDE: SearchIntentToolBoostRuleConfig[] | null;
 export declare const EXTENSION_GIT_CLONE_TIMEOUT_MS: number;
 export declare const EXTENSION_GIT_CHECKOUT_TIMEOUT_MS: number;
 export declare const PROCESS_LIST_MAX_BUFFER_BYTES: number;
@@ -102,4 +113,3 @@ export declare const PROCESS_LAUNCH_WAIT_MS: number;
 export declare const WIN_DEBUG_PORT_POLL_ATTEMPTS: number;
 export declare const WIN_DEBUG_PORT_POLL_INTERVAL_MS: number;
 export declare const PACKER_SANDBOX_TIMEOUT_MS: number;
-//# sourceMappingURL=constants.d.ts.map

package/dist/constants.js

@@ -5,6 +5,13 @@ const int = (key, fallback) => {
     const n = parseInt(v, 10);
     return Number.isFinite(n) ? n : fallback;
 };
+const float = (key, fallback) => {
+    const v = process.env[key];
+    if (v === undefined || v === '')
+        return fallback;
+    const n = Number.parseFloat(v);
+    return Number.isFinite(n) ? n : fallback;
+};
 const str = (key, fallback) => process.env[key] || fallback;
 const list = (key, fallback) => {
     const v = process.env[key];
@@ -12,6 +19,27 @@ const list = (key, fallback) => {
         return fallback;
     return v.split(',').map(Number).filter(Number.isFinite);
 };
+const csv = (key, fallback) => {
+    const v = process.env[key];
+    if (!v)
+        return fallback;
+    const parsed = v
+        .split(',')
+        .map((item) => item.trim().toLowerCase())
+        .filter(Boolean);
+    return parsed.length > 0 ? parsed : fallback;
+};
+const json = (key, fallback) => {
+    const v = process.env[key];
+    if (!v)
+        return fallback;
+    try {
+        return JSON.parse(v);
+    }
+    catch {
+        return fallback;
+    }
+};
 export const DEBUG_PORT_CANDIDATES = list('DEBUG_PORT_CANDIDATES', [9222, 9229, 9333, 2039]);
 export const DEFAULT_DEBUG_PORT = int('DEFAULT_DEBUG_PORT', 9222);
 export const GHIDRA_BRIDGE_ENDPOINT = str('GHIDRA_BRIDGE_URL', 'http://127.0.0.1:18080');
@@ -72,6 +100,9 @@ export const WORKFLOW_JS_BUNDLE_MAX_REDIRECTS = int('WORKFLOW_JS_BUNDLE_MAX_REDI
 export const WORKFLOW_JS_BUNDLE_FETCH_TIMEOUT_MS = int('WORKFLOW_JS_BUNDLE_FETCH_TIMEOUT_MS', 30_000);
 export const WORKFLOW_BUNDLE_CACHE_TTL_MS = int('WORKFLOW_BUNDLE_CACHE_TTL_MS', 5 * 60 * 1000);
 export const WORKFLOW_BUNDLE_CACHE_MAX_BYTES = int('WORKFLOW_BUNDLE_CACHE_MAX_BYTES', 100 * 1024 * 1024);
+export const SEARCH_WORKFLOW_BOOST_TIERS = new Set(csv('SEARCH_WORKFLOW_BOOST_TIERS', ['workflow', 'full']));
+export const SEARCH_WORKFLOW_DOMAIN_BOOST_MULTIPLIER = float('SEARCH_WORKFLOW_DOMAIN_BOOST_MULTIPLIER', 1.5);
+export const SEARCH_INTENT_TOOL_BOOST_RULES_OVERRIDE = json('SEARCH_INTENT_TOOL_BOOST_RULES_JSON', null);
 export const EXTENSION_GIT_CLONE_TIMEOUT_MS = int('EXTENSION_GIT_CLONE_TIMEOUT_MS', 60_000);
 export const EXTENSION_GIT_CHECKOUT_TIMEOUT_MS = int('EXTENSION_GIT_CHECKOUT_TIMEOUT_MS', 30_000);
 export const PROCESS_LIST_MAX_BUFFER_BYTES = int('PROCESS_LIST_MAX_BUFFER_BYTES', 1024 * 1024 * 10);
@@ -116,4 +147,3 @@ export const PROCESS_LAUNCH_WAIT_MS = int('PROCESS_LAUNCH_WAIT_MS', 2_000);
 export const WIN_DEBUG_PORT_POLL_ATTEMPTS = int('WIN_DEBUG_PORT_POLL_ATTEMPTS', 20);
 export const WIN_DEBUG_PORT_POLL_INTERVAL_MS = int('WIN_DEBUG_PORT_POLL_INTERVAL_MS', 500);
 export const PACKER_SANDBOX_TIMEOUT_MS = int('PACKER_SANDBOX_TIMEOUT_MS', 3_000);
-//# sourceMappingURL=constants.js.map

package/dist/errors/PrerequisiteError.d.ts

@@ -2,4 +2,3 @@ import { ToolError } from './ToolError.js';
 export declare class PrerequisiteError extends ToolError {
     constructor(message: string);
 }
-//# sourceMappingURL=PrerequisiteError.d.ts.map

package/dist/errors/PrerequisiteError.js

@@ -5,4 +5,3 @@ export class PrerequisiteError extends ToolError {
         this.name = 'PrerequisiteError';
     }
 }
-//# sourceMappingURL=PrerequisiteError.js.map

package/dist/errors/ToolError.d.ts

@@ -10,4 +10,3 @@ export declare class ToolError extends Error {
         cause?: Error;
     });
 }
-//# sourceMappingURL=ToolError.d.ts.map

package/dist/errors/ToolError.js

@@ -15,4 +15,3 @@ export class ToolError extends Error {
         this.details = options?.details;
     }
 }
-//# sourceMappingURL=ToolError.js.map

package/dist/index.d.ts

@@ -1,3 +1,2 @@
 #!/usr/bin/env node
 export {};
-//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -4,6 +4,7 @@ import { getConfig, validateConfig } from './utils/config.js';
 import { logger } from './utils/logger.js';
 import { initRegistry } from './server/registry/index.js';
 import { resolveCliFastPath } from './utils/cliFastPath.js';
+import { cleanupArtifacts, getArtifactRetentionConfig, startArtifactRetentionScheduler } from './utils/artifactRetention.js';
 const FATAL_ERROR_CODES = new Set([
     'ERR_WORKER_OUT_OF_MEMORY',
     'ERR_MEMORY_ALLOCATION_FAILED',
@@ -53,9 +54,17 @@ async function main() {
         if (config.llm.provider === 'anthropic' && !config.llm.anthropic?.apiKey) {
             logger.warn('ANTHROPIC_API_KEY is not configured. AI-assisted tools may return configuration errors.');
         }
+        const artifactRetention = getArtifactRetentionConfig();
+        if (artifactRetention.cleanupOnStart && artifactRetention.enabled) {
+            const cleanup = await cleanupArtifacts();
+            if (cleanup.removedFiles > 0) {
+                logger.info(`[artifacts] Startup cleanup removed ${cleanup.removedFiles} files (${cleanup.removedBytes} bytes)`);
+            }
+        }
         logger.info('Creating MCP server instance...');
         await initRegistry();
         const server = new MCPServer(config);
+        const stopArtifactRetentionScheduler = startArtifactRetentionScheduler();
         const recoveryWindowMs = Math.max(1000, parseInt(process.env.RUNTIME_ERROR_WINDOW_MS ?? '60000', 10));
         const maxRecoverableErrors = Math.max(1, parseInt(process.env.RUNTIME_ERROR_THRESHOLD ?? '5', 10));
         const runtimeRecovery = {
@@ -83,11 +92,13 @@ async function main() {
         };
         process.on('SIGINT', async () => {
             logger.info('Received SIGINT, shutting down...');
+            stopArtifactRetentionScheduler?.();
             await server.close();
             process.exit(0);
         });
         process.on('SIGTERM', async () => {
             logger.info('Received SIGTERM, shutting down...');
+            stopArtifactRetentionScheduler?.();
             await server.close();
             process.exit(0);
         });
@@ -126,4 +137,3 @@ if (cliFastPath.handled) {
     process.exit(cliFastPath.exitCode);
 }
 main();
-//# sourceMappingURL=index.js.map

package/dist/modules/analyzer/AISummarizer.d.ts

@@ -37,4 +37,3 @@ export declare class AISummarizer {
     private parseSummaryResponse;
     private basicAnalysis;
 }
-//# sourceMappingURL=AISummarizer.d.ts.map

package/dist/modules/analyzer/AISummarizer.js

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

package/dist/modules/analyzer/CodeAnalyzer.d.ts

@@ -13,4 +13,3 @@ export declare class CodeAnalyzer {
     private calculateComplexity;
     private analyzeDataFlow;
 }
-//# sourceMappingURL=CodeAnalyzer.d.ts.map

package/dist/modules/analyzer/CodeAnalyzer.js

@@ -365,4 +365,3 @@ export class CodeAnalyzer {
         return analyzeDataFlowWithTaint(code, this.llm);
     }
 }
-//# sourceMappingURL=CodeAnalyzer.js.map

package/dist/modules/analyzer/CodeAnalyzerDataFlow.d.ts

@@ -1,4 +1,3 @@
 import type { DataFlow } from '../../types/index.js';
 import type { LLMService } from '../../services/LLMService.js';
 export declare function analyzeDataFlowWithTaint(code: string, llm?: LLMService): Promise<DataFlow>;
-//# sourceMappingURL=CodeAnalyzerDataFlow.d.ts.map

package/dist/modules/analyzer/CodeAnalyzerDataFlow.js

@@ -399,4 +399,3 @@ function checkTaintedArguments(args, taintMap, taintPaths, _funcName, line) {
         }
     });
 }
-//# sourceMappingURL=CodeAnalyzerDataFlow.js.map

package/dist/modules/analyzer/IntelligentAnalyzer.d.ts

@@ -96,4 +96,3 @@ export declare class IntelligentAnalyzer {
         exceptions: ExceptionInfo[];
     }): Promise<AnalysisResult>;
 }
-//# sourceMappingURL=IntelligentAnalyzer.d.ts.map

package/dist/modules/analyzer/IntelligentAnalyzer.js

@@ -246,4 +246,3 @@ export class IntelligentAnalyzer {
         return ruleBasedResult;
     }
 }
-//# sourceMappingURL=IntelligentAnalyzer.js.map

package/dist/modules/analyzer/PatternDetector.d.ts

@@ -19,4 +19,3 @@ export declare function detectTokenPatterns(requests: NetworkRequest[], _logs: C
 export declare function detectAntiDebugPatterns(logs: ConsoleMessage[]): AntiDebugPattern[];
 export declare function extractSuspiciousAPIs(requests: NetworkRequest[]): string[];
 export declare function extractKeyFunctions(logs: ConsoleMessage[]): string[];
-//# sourceMappingURL=PatternDetector.d.ts.map

package/dist/modules/analyzer/PatternDetector.js

@@ -273,4 +273,3 @@ export function extractKeyFunctions(logs) {
     }
     return Array.from(functions).slice(0, 30);
 }
-//# sourceMappingURL=PatternDetector.js.map

package/dist/modules/analyzer/PatternDetectorAuthPatterns.d.ts

@@ -2,4 +2,3 @@ import type { NetworkRequest } from '../monitor/ConsoleMonitor.js';
 import type { SignaturePattern, TokenPattern } from '../analyzer/IntelligentAnalyzer.js';
 export declare function detectSignaturePatternsInternal(requests: NetworkRequest[]): SignaturePattern[];
 export declare function detectTokenPatternsInternal(requests: NetworkRequest[]): TokenPattern[];
-//# sourceMappingURL=PatternDetectorAuthPatterns.d.ts.map

package/dist/modules/analyzer/PatternDetectorAuthPatterns.js

@@ -271,4 +271,3 @@ export function detectTokenPatternsInternal(requests) {
     }
     return patterns;
 }
-//# sourceMappingURL=PatternDetectorAuthPatterns.js.map

package/dist/modules/analyzer/QualityAnalyzer.d.ts

@@ -39,4 +39,3 @@ export declare function detectDuplicateCode(ast: t.File): Array<{
 export declare function computeASTHash(node: t.Node): string;
 export declare function normalizeCode(node: t.Node): string;
 export declare function calculateCodeSimilarity(code1: string, code2: string): number;
-//# sourceMappingURL=QualityAnalyzer.d.ts.map

package/dist/modules/analyzer/QualityAnalyzer.js

@@ -431,4 +431,3 @@ export function calculateCodeSimilarity(code1, code2) {
     const maxLen = Math.max(len1, len2);
     return 1 - distance / maxLen;
 }
-//# sourceMappingURL=QualityAnalyzer.js.map

package/dist/modules/analyzer/SecurityCodeAnalyzer.d.ts

@@ -3,4 +3,3 @@ import type { SecurityRisk } from '../../types/index.js';
 export declare function getMemberExpressionName(node: t.MemberExpression): string;
 export declare function checkSanitizer(node: t.CallExpression, sanitizers: Set<string>): boolean;
 export declare function identifySecurityRisks(code: string, aiAnalysis: Record<string, unknown>): SecurityRisk[];
-//# sourceMappingURL=SecurityCodeAnalyzer.d.ts.map

package/dist/modules/analyzer/SecurityCodeAnalyzer.js

@@ -184,4 +184,3 @@ export function identifySecurityRisks(code, aiAnalysis) {
         self.findIndex((r) => r.type === risk.type && r.location.line === risk.location.line));
     return uniqueRisks;
 }
-//# sourceMappingURL=SecurityCodeAnalyzer.js.map

package/dist/modules/browser/BrowserDiscovery.d.ts

@@ -27,4 +27,3 @@ export declare class BrowserDiscovery {
     private checkDebugPortFromCommandLine;
     private checkPort;
 }
-//# sourceMappingURL=BrowserDiscovery.d.ts.map

package/dist/modules/browser/BrowserDiscovery.js

@@ -247,4 +247,3 @@ export class BrowserDiscovery {
         }
     }
 }
-//# sourceMappingURL=BrowserDiscovery.js.map

package/dist/modules/browser/BrowserModeManager.d.ts

@@ -29,4 +29,3 @@ export declare class BrowserModeManager {
     getCurrentPage(): Page | null;
     isHeadlessMode(): boolean;
 }
-//# sourceMappingURL=BrowserModeManager.d.ts.map

package/dist/modules/browser/BrowserModeManager.js

@@ -282,4 +282,3 @@ export class BrowserModeManager {
         return this.isHeadless;
     }
 }
-//# sourceMappingURL=BrowserModeManager.js.map

package/dist/modules/browser/CamoufoxBrowserManager.d.ts

@@ -42,4 +42,3 @@ export declare class CamoufoxBrowserManager {
     getBrowser(): CamoufoxBrowserLike | null;
     getCDPSession(page: CamoufoxPageLike): Promise<unknown>;
 }
-//# sourceMappingURL=CamoufoxBrowserManager.d.ts.map

package/dist/modules/browser/CamoufoxBrowserManager.js

@@ -1,4 +1,5 @@
 import { logger } from '../../utils/logger.js';
+import { PrerequisiteError } from '../../errors/PrerequisiteError.js';
 export class CamoufoxBrowserManager {
     browser = null;
     browserServer = null;
@@ -16,7 +17,13 @@ export class CamoufoxBrowserManager {
     }
     async launch() {
         logger.info(`Launching Camoufox (Firefox) [os=${this.config.os}, headless=${this.config.headless}]...`);
-        const { Camoufox } = await import('camoufox-js');
+        let Camoufox;
+        try {
+            ({ Camoufox } = await import('camoufox-js'));
+        }
+        catch (error) {
+            throw new PrerequisiteError(`camoufox-js is not installed or its binaries are missing. Run \`pnpm run install:full\` or \`pnpm exec camoufox-js fetch\` before using the Camoufox driver. Root cause: ${error instanceof Error ? error.message : String(error)}`);
+        }
         this.browser = (await Camoufox({
             os: this.config.os,
             headless: this.config.headless,
@@ -52,7 +59,13 @@ export class CamoufoxBrowserManager {
     }
     async launchAsServer(port, ws_path) {
         logger.info(`Launching Camoufox server [os=${this.config.os}, port=${port ?? 'auto'}]...`);
-        const { launchServer } = await import('camoufox-js');
+        let launchServer;
+        try {
+            ({ launchServer } = await import('camoufox-js'));
+        }
+        catch (error) {
+            throw new PrerequisiteError(`camoufox-js server support is unavailable. Run \`pnpm run install:full\` or \`pnpm exec camoufox-js fetch\` before launching a Camoufox WebSocket server. Root cause: ${error instanceof Error ? error.message : String(error)}`);
+        }
         const serverOptions = {
             os: this.config.os,
             headless: this.config.headless,
@@ -96,4 +109,3 @@ export class CamoufoxBrowserManager {
         return context.newCDPSession(page);
     }
 }
-//# sourceMappingURL=CamoufoxBrowserManager.js.map

package/dist/modules/browser/TabRegistry.d.ts

@@ -64,4 +64,3 @@ export declare class TabRegistry<PageLike = unknown> {
     clear(): void;
     private getAliasesForPageId;
 }
-//# sourceMappingURL=TabRegistry.d.ts.map

package/dist/modules/browser/TabRegistry.js

@@ -235,4 +235,3 @@ export class TabRegistry {
         return aliases;
     }
 }
-//# sourceMappingURL=TabRegistry.js.map

package/dist/modules/browser/UnifiedBrowserManager.d.ts

@@ -74,4 +74,3 @@ export { CamoufoxBrowserManager } from '../browser/CamoufoxBrowserManager.js';
 export type { CamoufoxBrowserConfig } from '../browser/CamoufoxBrowserManager.js';
 export { BrowserDiscovery } from '../browser/BrowserDiscovery.js';
 export type { BrowserInfo, BrowserSignature } from '../browser/BrowserDiscovery.js';
-//# sourceMappingURL=UnifiedBrowserManager.d.ts.map

package/dist/modules/browser/UnifiedBrowserManager.js

@@ -214,4 +214,3 @@ export class UnifiedBrowserManager {
 export { BrowserModeManager } from '../browser/BrowserModeManager.js';
 export { CamoufoxBrowserManager } from '../browser/CamoufoxBrowserManager.js';
 export { BrowserDiscovery } from '../browser/BrowserDiscovery.js';
-//# sourceMappingURL=UnifiedBrowserManager.js.map

package/dist/modules/browser/index.d.ts

@@ -2,4 +2,3 @@ export { UnifiedBrowserManager, type BrowserDriver, type HeadlessMode, type Prox
 export { BrowserModeManager, type BrowserModeConfig } from '../browser/BrowserModeManager.js';
 export { CamoufoxBrowserManager, type CamoufoxBrowserConfig } from '../browser/CamoufoxBrowserManager.js';
 export { BrowserDiscovery, type BrowserInfo, type BrowserSignature } from '../browser/BrowserDiscovery.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/modules/browser/index.js

@@ -2,4 +2,3 @@ export { UnifiedBrowserManager, } from '../browser/UnifiedBrowserManager.js';
 export { BrowserModeManager } from '../browser/BrowserModeManager.js';
 export { CamoufoxBrowserManager } from '../browser/CamoufoxBrowserManager.js';
 export { BrowserDiscovery } from '../browser/BrowserDiscovery.js';
-//# sourceMappingURL=index.js.map

package/dist/modules/captcha/AICaptchaDetector.d.ts

@@ -30,4 +30,3 @@ export declare class AICaptchaDetector {
     private fallbackTextAnalysis;
     waitForCompletion(page: Page, timeout?: number): Promise<boolean>;
 }
-//# sourceMappingURL=AICaptchaDetector.d.ts.map