@jshookmcp/jshook 0.1.2

package/dist/modules/emulator/templates/chrome-env.js

@@ -0,0 +1,253 @@
+export const chromeEnvironmentTemplate = {
+    window: {
+        innerWidth: 1920,
+        innerHeight: 1080,
+        outerWidth: 1920,
+        outerHeight: 1080,
+        screenX: 0,
+        screenY: 0,
+        screenLeft: 0,
+        screenTop: 0,
+        devicePixelRatio: 1,
+        name: '',
+        closed: false,
+        length: 0,
+        opener: null,
+        parent: null,
+        top: null,
+        self: null,
+        frameElement: null,
+        frames: [],
+    },
+    navigator: {
+        userAgent: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
+        appVersion: '5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
+        platform: 'Win32',
+        vendor: 'Google Inc.',
+        language: 'zh-CN',
+        languages: ['zh-CN', 'zh', 'en-US', 'en'],
+        onLine: true,
+        cookieEnabled: true,
+        doNotTrack: null,
+        maxTouchPoints: 0,
+        hardwareConcurrency: 8,
+        deviceMemory: 8,
+        webdriver: false,
+        pdfViewerEnabled: true,
+        product: 'Gecko',
+        productSub: '20030107',
+        vendorSub: '',
+        appName: 'Netscape',
+        appCodeName: 'Mozilla',
+    },
+    screen: {
+        width: 1920,
+        height: 1080,
+        availWidth: 1920,
+        availHeight: 1040,
+        colorDepth: 24,
+        pixelDepth: 24,
+        orientation: {
+            type: 'landscape-primary',
+            angle: 0,
+        },
+    },
+    location: {
+        href: 'https://www.example.com/',
+        origin: 'https://www.example.com',
+        protocol: 'https:',
+        host: 'www.example.com',
+        hostname: 'www.example.com',
+        port: '',
+        pathname: '/',
+        search: '',
+        hash: '',
+    },
+    document: {
+        documentElement: {},
+        head: {},
+        body: {},
+        title: '',
+        URL: 'https://www.example.com/',
+        domain: 'www.example.com',
+        referrer: '',
+        cookie: '',
+        readyState: 'complete',
+        characterSet: 'UTF-8',
+        charset: 'UTF-8',
+        inputEncoding: 'UTF-8',
+        contentType: 'text/html',
+        doctype: {},
+        hidden: false,
+        visibilityState: 'visible',
+    },
+    performance: {
+        timeOrigin: Date.now(),
+        timing: {
+            navigationStart: Date.now(),
+            unloadEventStart: 0,
+            unloadEventEnd: 0,
+            redirectStart: 0,
+            redirectEnd: 0,
+            fetchStart: Date.now(),
+            domainLookupStart: Date.now(),
+            domainLookupEnd: Date.now(),
+            connectStart: Date.now(),
+            connectEnd: Date.now(),
+            secureConnectionStart: Date.now(),
+            requestStart: Date.now(),
+            responseStart: Date.now(),
+            responseEnd: Date.now(),
+            domLoading: Date.now(),
+            domInteractive: Date.now(),
+            domContentLoadedEventStart: Date.now(),
+            domContentLoadedEventEnd: Date.now(),
+            domComplete: Date.now(),
+            loadEventStart: Date.now(),
+            loadEventEnd: Date.now(),
+        },
+    },
+    history: {
+        length: 1,
+        scrollRestoration: 'auto',
+        state: null,
+    },
+    console: {
+        log: () => { },
+        warn: () => { },
+        error: () => { },
+        info: () => { },
+        debug: () => { },
+        trace: () => { },
+        dir: () => { },
+        dirxml: () => { },
+        table: () => { },
+        group: () => { },
+        groupCollapsed: () => { },
+        groupEnd: () => { },
+        clear: () => { },
+        count: () => { },
+        countReset: () => { },
+        assert: () => { },
+        time: () => { },
+        timeEnd: () => { },
+        timeLog: () => { },
+    },
+    crypto: {
+        subtle: {},
+        getRandomValues: (arr) => {
+            for (let i = 0; i < arr.length; i++) {
+                arr[i] = Math.floor(Math.random() * 256);
+            }
+            return arr;
+        },
+    },
+    globalFunctions: {
+        setTimeout: (_fn, _delay) => 0,
+        setInterval: (_fn, _delay) => 0,
+        clearTimeout: (_id) => { },
+        clearInterval: (_id) => { },
+        requestAnimationFrame: (_callback) => 0,
+        cancelAnimationFrame: (_id) => { },
+        atob: (str) => Buffer.from(str, 'base64').toString('binary'),
+        btoa: (str) => Buffer.from(str, 'binary').toString('base64'),
+        fetch: () => Promise.resolve(new Response()),
+    },
+    constructors: {
+        XMLHttpRequest: class XMLHttpRequest {
+            open() { }
+            send() { }
+            setRequestHeader() { }
+            addEventListener() { }
+        },
+        WebSocket: class WebSocket {
+            constructor(_url) { }
+            send() { }
+            close() { }
+            addEventListener() { }
+        },
+        Blob: class Blob {
+            constructor(_parts, _options) { }
+        },
+        File: class File extends Blob {
+            constructor(parts, _name, options) {
+                super(parts, options);
+            }
+        },
+        FormData: class FormData {
+            append() { }
+            delete() { }
+            get() { }
+            getAll() { }
+            has() { }
+            set() { }
+        },
+        Headers: class Headers {
+            append() { }
+            delete() { }
+            get() { }
+            has() { }
+            set() { }
+        },
+        Request: class Request {
+            constructor(_input, _init) { }
+        },
+        Response: class Response {
+            constructor(_body, _init) { }
+        },
+        URL: class URL {
+            constructor(_url, _base) { }
+        },
+        URLSearchParams: class URLSearchParams {
+            constructor(_init) { }
+            append() { }
+            delete() { }
+            get() { }
+            getAll() { }
+            has() { }
+            set() { }
+        },
+    },
+    storage: {
+        localStorage: {
+            length: 0,
+            clear: () => { },
+            getItem: (_key) => null,
+            setItem: (_key, _value) => { },
+            removeItem: (_key) => { },
+            key: (_index) => null,
+        },
+        sessionStorage: {
+            length: 0,
+            clear: () => { },
+            getItem: (_key) => null,
+            setItem: (_key, _value) => { },
+            removeItem: (_key) => { },
+            key: (_index) => null,
+        },
+    },
+    other: {
+        JSON: JSON,
+        Math: Math,
+        Date: Date,
+        Array: Array,
+        Object: Object,
+        String: String,
+        Number: Number,
+        Boolean: Boolean,
+        RegExp: RegExp,
+        Error: Error,
+        Promise: Promise,
+        Map: Map,
+        Set: Set,
+        WeakMap: WeakMap,
+        WeakSet: WeakSet,
+        Symbol: Symbol,
+        Proxy: Proxy,
+        Reflect: Reflect,
+    },
+};
+export function getChromeEnvironment() {
+    return JSON.parse(JSON.stringify(chromeEnvironmentTemplate));
+}
+//# sourceMappingURL=chrome-env.js.map

package/dist/modules/emulator/templates/chrome-env.js.map

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

package/dist/modules/external/ExternalToolRunner.d.ts

@@ -0,0 +1,11 @@
+import { ToolRegistry } from '../external/ToolRegistry.js';
+import type { ToolRunRequest, ToolRunResult } from '../external/types.js';
+export declare class ExternalToolRunner {
+    private readonly registry;
+    constructor(registry: ToolRegistry);
+    probeAll(force?: boolean): Promise<Record<import("../external/types.js").ExternalToolName, import("./ToolProbe.js").ProbeResult>>;
+    run(request: ToolRunRequest): Promise<ToolRunResult>;
+    private _run;
+    private validateCwd;
+}
+//# sourceMappingURL=ExternalToolRunner.d.ts.map

package/dist/modules/external/ExternalToolRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExternalToolRunner.d.ts","sourceRoot":"","sources":["../../../src/modules/external/ExternalToolRunner.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACd,MAAM,yBAAyB,CAAC;AAYjC,qBAAa,kBAAkB;IACjB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,YAAY;IAK7C,QAAQ,CAAC,KAAK,UAAQ;IAQtB,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;YAI5C,IAAI;IAuJlB,OAAO,CAAC,WAAW;CAkCpB"}

package/dist/modules/external/ExternalToolRunner.js

@@ -0,0 +1,176 @@
+import { spawn } from 'node:child_process';
+import { resolve, relative, sep } from 'node:path';
+import { getProjectRoot } from '../../utils/outputPaths.js';
+import { logger } from '../../utils/logger.js';
+import { ioLimit } from '../../utils/concurrency.js';
+import { EXTERNAL_TOOL_TIMEOUT_MS, EXTERNAL_TOOL_MAX_STDOUT_BYTES, EXTERNAL_TOOL_MAX_STDERR_BYTES, EXTERNAL_TOOL_FORCE_KILL_GRACE_MS, } from '../../constants.js';
+const DEFAULT_TIMEOUT_MS = EXTERNAL_TOOL_TIMEOUT_MS;
+const DEFAULT_MAX_STDOUT = EXTERNAL_TOOL_MAX_STDOUT_BYTES;
+const DEFAULT_MAX_STDERR = EXTERNAL_TOOL_MAX_STDERR_BYTES;
+export class ExternalToolRunner {
+    registry;
+    constructor(registry) {
+        this.registry = registry;
+    }
+    async probeAll(force = false) {
+        return this.registry.probeAll(force);
+    }
+    async run(request) {
+        return ioLimit(() => this._run(request));
+    }
+    async _run(request) {
+        const spec = this.registry.getSpec(request.tool);
+        const probe = this.registry.getCachedProbe(request.tool);
+        if (probe && !probe.available) {
+            return {
+                ok: false,
+                exitCode: null,
+                signal: null,
+                stdout: '',
+                stderr: `Tool '${request.tool}' (${spec.command}) is not available: ${probe.reason}`,
+                durationMs: 0,
+                truncated: false,
+            };
+        }
+        const cwd = this.validateCwd(request.cwd);
+        const args = [...(spec.defaultArgs || []), ...request.args];
+        const env = { PATH: process.env.PATH || '' };
+        if (process.platform === 'win32') {
+            env.SYSTEMROOT = process.env.SYSTEMROOT || 'C:\\Windows';
+            env.TEMP = process.env.TEMP || '';
+            env.TMP = process.env.TMP || '';
+        }
+        if (spec.envAllowlist) {
+            for (const key of spec.envAllowlist) {
+                if (process.env[key]) {
+                    env[key] = process.env[key];
+                }
+            }
+        }
+        const timeoutMs = request.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        const maxStdout = request.maxStdoutBytes ?? DEFAULT_MAX_STDOUT;
+        const maxStderr = request.maxStderrBytes ?? DEFAULT_MAX_STDERR;
+        logger.debug(`[ExternalToolRunner] Running: ${spec.command} ${args.join(' ')}`);
+        const startTime = Date.now();
+        return new Promise((resolvePromise) => {
+            const child = spawn(spec.command, args, {
+                cwd,
+                env,
+                shell: false,
+                windowsHide: true,
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            let stdout = '';
+            let stderr = '';
+            let stdoutTruncated = false;
+            let stderrTruncated = false;
+            let settled = false;
+            let timeoutHandle;
+            const finish = (exitCode, signal) => {
+                if (settled)
+                    return;
+                settled = true;
+                if (timeoutHandle)
+                    clearTimeout(timeoutHandle);
+                const durationMs = Date.now() - startTime;
+                const result = {
+                    ok: exitCode === 0,
+                    exitCode,
+                    signal,
+                    stdout,
+                    stderr,
+                    durationMs,
+                    truncated: stdoutTruncated || stderrTruncated,
+                };
+                if (result.ok) {
+                    logger.debug(`[ExternalToolRunner] ${spec.command} completed in ${durationMs}ms`);
+                }
+                else {
+                    logger.warn(`[ExternalToolRunner] ${spec.command} failed (exit=${exitCode}, signal=${signal}) in ${durationMs}ms`);
+                }
+                resolvePromise(result);
+            };
+            timeoutHandle = setTimeout(() => {
+                if (!settled) {
+                    child.kill('SIGTERM');
+                    setTimeout(() => {
+                        if (!settled) {
+                            child.kill('SIGKILL');
+                            finish(null, 'SIGKILL');
+                        }
+                    }, EXTERNAL_TOOL_FORCE_KILL_GRACE_MS);
+                    request.onProgress?.({ phase: 'timeout', ts: Date.now() });
+                }
+            }, timeoutMs);
+            if (request.stdin) {
+                child.stdin.write(request.stdin);
+                child.stdin.end();
+            }
+            else {
+                child.stdin.end();
+            }
+            child.stdout.on('data', (chunk) => {
+                if (stdout.length < maxStdout) {
+                    const remaining = maxStdout - stdout.length;
+                    stdout += chunk.toString('utf-8', 0, Math.min(chunk.length, remaining));
+                    if (stdout.length >= maxStdout)
+                        stdoutTruncated = true;
+                }
+                request.onProgress?.({
+                    phase: 'stdout',
+                    bytesRead: stdout.length,
+                    ts: Date.now(),
+                });
+            });
+            child.stderr.on('data', (chunk) => {
+                if (stderr.length < maxStderr) {
+                    const remaining = maxStderr - stderr.length;
+                    stderr += chunk.toString('utf-8', 0, Math.min(chunk.length, remaining));
+                    if (stderr.length >= maxStderr)
+                        stderrTruncated = true;
+                }
+                request.onProgress?.({
+                    phase: 'stderr',
+                    bytesRead: stderr.length,
+                    ts: Date.now(),
+                });
+            });
+            child.on('close', (code, signal) => {
+                finish(code, signal);
+            });
+            child.on('error', (err) => {
+                stderr += `\nSpawn error: ${err.message}`;
+                finish(1, null);
+            });
+            request.onProgress?.({ phase: 'spawn', ts: Date.now() });
+        });
+    }
+    validateCwd(requestedCwd) {
+        if (!requestedCwd) {
+            return getProjectRoot();
+        }
+        const resolved = resolve(requestedCwd);
+        const projectRoot = getProjectRoot();
+        const rel = relative(projectRoot, resolved);
+        if (rel && !rel.startsWith('..') && !resolve(rel).startsWith(sep)) {
+            return resolved;
+        }
+        const tmpDirs = [
+            process.env.TEMP,
+            process.env.TMP,
+            '/tmp',
+            '/var/tmp',
+        ].filter(Boolean);
+        for (const tmp of tmpDirs) {
+            if (!tmp)
+                continue;
+            const resolvedTmp = resolve(tmp);
+            if (resolved === resolvedTmp || resolved.startsWith(resolvedTmp + sep)) {
+                return resolved;
+            }
+        }
+        logger.warn(`[ExternalToolRunner] CWD '${requestedCwd}' outside allowed boundaries, using project root`);
+        return projectRoot;
+    }
+}
+//# sourceMappingURL=ExternalToolRunner.js.map

package/dist/modules/external/ExternalToolRunner.js.map

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

package/dist/modules/external/ToolProbe.d.ts

@@ -0,0 +1,12 @@
+export interface ProbeResult {
+    available: boolean;
+    path?: string;
+    version?: string;
+    reason?: string;
+}
+export declare function probeCommand(command: string, versionArgs?: string[], timeoutMs?: number): Promise<ProbeResult>;
+export declare function probeAll(specs: Array<{
+    command: string;
+    versionArgs?: string[];
+}>): Promise<Map<string, ProbeResult>>;
+//# sourceMappingURL=ToolProbe.d.ts.map

package/dist/modules/external/ToolProbe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolProbe.d.ts","sourceRoot":"","sources":["../../../src/modules/external/ToolProbe.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAKD,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,WAAW,GAAE,MAAM,EAAkB,EACrC,SAAS,SAAiC,GACzC,OAAO,CAAC,WAAW,CAAC,CAyCtB;AAKD,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,GACxD,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAenC"}

package/dist/modules/external/ToolProbe.js

@@ -0,0 +1,59 @@
+import { EXTERNAL_TOOL_PROBE_TIMEOUT_MS } from '../../constants.js';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { logger } from '../../utils/logger.js';
+const execFileAsync = promisify(execFile);
+export async function probeCommand(command, versionArgs = ['--version'], timeoutMs = EXTERNAL_TOOL_PROBE_TIMEOUT_MS) {
+    try {
+        const whichCmd = process.platform === 'win32' ? 'where' : 'which';
+        const { stdout: pathOutput } = await execFileAsync(whichCmd, [command], {
+            timeout: timeoutMs,
+            windowsHide: true,
+        });
+        const resolvedPath = pathOutput.trim().split(/\r?\n/)[0];
+        let version;
+        try {
+            const { stdout: versionOutput } = await execFileAsync(command, versionArgs, {
+                timeout: timeoutMs,
+                windowsHide: true,
+            });
+            const firstLine = versionOutput.trim().split(/\r?\n/)[0];
+            version = firstLine ? firstLine.substring(0, 100) : undefined;
+        }
+        catch {
+        }
+        return { available: true, path: resolvedPath, version };
+    }
+    catch (err) {
+        const errorCode = typeof err === 'object' && err !== null && 'code' in err
+            ? err.code
+            : undefined;
+        const errorMessage = err instanceof Error
+            ? err.message
+            : typeof err === 'object' && err !== null && 'message' in err
+                ? String(err.message ?? '')
+                : String(err ?? '');
+        return {
+            available: false,
+            reason: errorCode === 'ENOENT'
+                ? `Command '${command}' not found in PATH`
+                : `Probe failed: ${errorMessage.substring(0, 200)}`,
+        };
+    }
+}
+export async function probeAll(specs) {
+    const results = new Map();
+    const promises = specs.map(async (spec) => {
+        const result = await probeCommand(spec.command, spec.versionArgs);
+        results.set(spec.command, result);
+        if (result.available) {
+            logger.debug(`[ToolProbe] ${spec.command}: available at ${result.path} (${result.version || 'unknown version'})`);
+        }
+        else {
+            logger.debug(`[ToolProbe] ${spec.command}: not available — ${result.reason}`);
+        }
+    });
+    await Promise.all(promises);
+    return results;
+}
+//# sourceMappingURL=ToolProbe.js.map

package/dist/modules/external/ToolProbe.js.map

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

package/dist/modules/external/ToolRegistry.d.ts

@@ -0,0 +1,16 @@
+import type { ExternalToolName, ExternalToolSpec } from '../external/types.js';
+import { type ProbeResult } from '../external/ToolProbe.js';
+export declare class ToolRegistry {
+    private specs;
+    private probeCache;
+    private probeCacheExpiry;
+    private readonly PROBE_CACHE_TTL;
+    constructor(additionalSpecs?: ExternalToolSpec[]);
+    getSpec(name: ExternalToolName): ExternalToolSpec;
+    isRegistered(name: string): name is ExternalToolName;
+    getRegisteredTools(): ExternalToolName[];
+    probeAll(force?: boolean): Promise<Record<ExternalToolName, ProbeResult>>;
+    getCachedProbe(name: ExternalToolName): ProbeResult | undefined;
+    register(spec: ExternalToolSpec): void;
+}
+//# sourceMappingURL=ToolRegistry.d.ts.map

package/dist/modules/external/ToolRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolRegistry.d.ts","sourceRoot":"","sources":["../../../src/modules/external/ToolRegistry.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAgB,KAAK,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAuE7E,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAiD;IAC9D,OAAO,CAAC,UAAU,CAA4C;IAC9D,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAoC;gBAExD,eAAe,CAAC,EAAE,gBAAgB,EAAE;IAchD,OAAO,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB;IAWjD,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,gBAAgB;IAOpD,kBAAkB,IAAI,gBAAgB,EAAE;IAOlC,QAAQ,CAAC,KAAK,UAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC;IA8B7E,cAAc,CAAC,IAAI,EAAE,gBAAgB,GAAG,WAAW,GAAG,SAAS;IAO/D,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;CAKvC"}