@jshookmcp/jshook 0.2.5 → 0.2.7

package/dist/src/server/domains/sandbox/manifest.d.ts

@@ -1,57 +0,0 @@
-import type { MCPServerContext } from '../../domains/shared/registry.js';
-import { SandboxToolHandlers } from '../../domains/sandbox/handlers.js';
-type H = SandboxToolHandlers;
-declare function ensure(ctx: MCPServerContext): H;
-declare const manifest: {
-    kind: "domain-manifest";
-    version: 1;
-    domain: "sandbox";
-    depKey: "sandboxHandlers";
-    profiles: "full"[];
-    ensure: typeof ensure;
-    registrations: {
-        tool: {
-            inputSchema: {
-                [x: string]: unknown;
-                type: "object";
-                properties?: {
-                    [x: string]: object;
-                } | undefined;
-                required?: string[] | undefined;
-            };
-            name: string;
-            description?: string | undefined;
-            outputSchema?: {
-                [x: string]: unknown;
-                type: "object";
-                properties?: {
-                    [x: string]: object;
-                } | undefined;
-                required?: string[] | undefined;
-            } | undefined;
-            annotations?: {
-                title?: string | undefined;
-                readOnlyHint?: boolean | undefined;
-                destructiveHint?: boolean | undefined;
-                idempotentHint?: boolean | undefined;
-                openWorldHint?: boolean | undefined;
-            } | undefined;
-            execution?: {
-                taskSupport?: "optional" | "required" | "forbidden" | undefined;
-            } | undefined;
-            _meta?: {
-                [x: string]: unknown;
-            } | undefined;
-            icons?: {
-                src: string;
-                mimeType?: string | undefined;
-                sizes?: string[] | undefined;
-                theme?: "light" | "dark" | undefined;
-            }[] | undefined;
-            title?: string | undefined;
-        };
-        domain: "sandbox";
-        bind: (deps: import("../../domains/shared/registry.js").ToolHandlerDeps) => (args: import("../../types.js").ToolArgs) => Promise<unknown>;
-    }[];
-};
-export default manifest;

package/dist/src/server/domains/sandbox/manifest.js

@@ -1,31 +0,0 @@
-import { bindByDepKey, toolLookup } from '../../domains/shared/registry.js';
-import { sandboxTools } from '../../domains/sandbox/definitions.js';
-import { SandboxToolHandlers } from '../../domains/sandbox/handlers.js';
-const DOMAIN = 'sandbox';
-const DEP_KEY = 'sandboxHandlers';
-const t = toolLookup(sandboxTools);
-const b = (invoke) => bindByDepKey(DEP_KEY, invoke);
-function ensure(ctx) {
-    const existing = ctx.getDomainInstance(DEP_KEY);
-    if (existing)
-        return existing;
-    const handlers = new SandboxToolHandlers(ctx);
-    ctx.setDomainInstance(DEP_KEY, handlers);
-    return handlers;
-}
-const manifest = {
-    kind: 'domain-manifest',
-    version: 1,
-    domain: DOMAIN,
-    depKey: DEP_KEY,
-    profiles: ['full'],
-    ensure,
-    registrations: [
-        {
-            tool: t('execute_sandbox_script'),
-            domain: DOMAIN,
-            bind: b((h, a) => h.handleExecuteSandboxScript(a)),
-        },
-    ],
-};
-export default manifest;

package/dist/src/server/domains/shared/ResponseBuilder.d.ts

@@ -1,209 +0,0 @@
-import type { ToolResponse } from '../../types.js';
-export declare class ResponseBuilder {
-    private payload;
-    private _isError;
-    ok(): this;
-    fail(error: unknown): this;
-    set(key: string, value: unknown): this;
-    merge(fields: Record<string, unknown>): this;
-    mcpError(): this;
-    json(): ToolResponse;
-    static raw(data: unknown): ToolResponse;
-    static text(text: string, isError?: boolean): ToolResponse;
-}
-export declare const R: {
-    ok: () => ResponseBuilder;
-    fail: (error: unknown) => ResponseBuilder;
-    raw: (data: unknown) => {
-        [x: string]: unknown;
-        content: ({
-            type: "text";
-            text: string;
-            annotations?: {
-                audience?: ("user" | "assistant")[] | undefined;
-                priority?: number | undefined;
-                lastModified?: string | undefined;
-            } | undefined;
-            _meta?: {
-                [x: string]: unknown;
-            } | undefined;
-        } | {
-            type: "image";
-            data: string;
-            mimeType: string;
-            annotations?: {
-                audience?: ("user" | "assistant")[] | undefined;
-                priority?: number | undefined;
-                lastModified?: string | undefined;
-            } | undefined;
-            _meta?: {
-                [x: string]: unknown;
-            } | undefined;
-        } | {
-            type: "audio";
-            data: string;
-            mimeType: string;
-            annotations?: {
-                audience?: ("user" | "assistant")[] | undefined;
-                priority?: number | undefined;
-                lastModified?: string | undefined;
-            } | undefined;
-            _meta?: {
-                [x: string]: unknown;
-            } | undefined;
-        } | {
-            uri: string;
-            name: string;
-            type: "resource_link";
-            description?: string | undefined;
-            mimeType?: string | undefined;
-            annotations?: {
-                audience?: ("user" | "assistant")[] | undefined;
-                priority?: number | undefined;
-                lastModified?: string | undefined;
-            } | undefined;
-            _meta?: {
-                [x: string]: unknown;
-            } | undefined;
-            icons?: {
-                src: string;
-                mimeType?: string | undefined;
-                sizes?: string[] | undefined;
-                theme?: "light" | "dark" | undefined;
-            }[] | undefined;
-            title?: string | undefined;
-        } | {
-            type: "resource";
-            resource: {
-                uri: string;
-                text: string;
-                mimeType?: string | undefined;
-                _meta?: {
-                    [x: string]: unknown;
-                } | undefined;
-            } | {
-                uri: string;
-                blob: string;
-                mimeType?: string | undefined;
-                _meta?: {
-                    [x: string]: unknown;
-                } | undefined;
-            };
-            annotations?: {
-                audience?: ("user" | "assistant")[] | undefined;
-                priority?: number | undefined;
-                lastModified?: string | undefined;
-            } | undefined;
-            _meta?: {
-                [x: string]: unknown;
-            } | undefined;
-        })[];
-        _meta?: {
-            [x: string]: unknown;
-            progressToken?: string | number | undefined;
-            "io.modelcontextprotocol/related-task"?: {
-                taskId: string;
-            } | undefined;
-        } | undefined;
-        structuredContent?: {
-            [x: string]: unknown;
-        } | undefined;
-        isError?: boolean | undefined;
-    };
-    text: (text: string, isError?: boolean) => {
-        [x: string]: unknown;
-        content: ({
-            type: "text";
-            text: string;
-            annotations?: {
-                audience?: ("user" | "assistant")[] | undefined;
-                priority?: number | undefined;
-                lastModified?: string | undefined;
-            } | undefined;
-            _meta?: {
-                [x: string]: unknown;
-            } | undefined;
-        } | {
-            type: "image";
-            data: string;
-            mimeType: string;
-            annotations?: {
-                audience?: ("user" | "assistant")[] | undefined;
-                priority?: number | undefined;
-                lastModified?: string | undefined;
-            } | undefined;
-            _meta?: {
-                [x: string]: unknown;
-            } | undefined;
-        } | {
-            type: "audio";
-            data: string;
-            mimeType: string;
-            annotations?: {
-                audience?: ("user" | "assistant")[] | undefined;
-                priority?: number | undefined;
-                lastModified?: string | undefined;
-            } | undefined;
-            _meta?: {
-                [x: string]: unknown;
-            } | undefined;
-        } | {
-            uri: string;
-            name: string;
-            type: "resource_link";
-            description?: string | undefined;
-            mimeType?: string | undefined;
-            annotations?: {
-                audience?: ("user" | "assistant")[] | undefined;
-                priority?: number | undefined;
-                lastModified?: string | undefined;
-            } | undefined;
-            _meta?: {
-                [x: string]: unknown;
-            } | undefined;
-            icons?: {
-                src: string;
-                mimeType?: string | undefined;
-                sizes?: string[] | undefined;
-                theme?: "light" | "dark" | undefined;
-            }[] | undefined;
-            title?: string | undefined;
-        } | {
-            type: "resource";
-            resource: {
-                uri: string;
-                text: string;
-                mimeType?: string | undefined;
-                _meta?: {
-                    [x: string]: unknown;
-                } | undefined;
-            } | {
-                uri: string;
-                blob: string;
-                mimeType?: string | undefined;
-                _meta?: {
-                    [x: string]: unknown;
-                } | undefined;
-            };
-            annotations?: {
-                audience?: ("user" | "assistant")[] | undefined;
-                priority?: number | undefined;
-                lastModified?: string | undefined;
-            } | undefined;
-            _meta?: {
-                [x: string]: unknown;
-            } | undefined;
-        })[];
-        _meta?: {
-            [x: string]: unknown;
-            progressToken?: string | number | undefined;
-            "io.modelcontextprotocol/related-task"?: {
-                taskId: string;
-            } | undefined;
-        } | undefined;
-        structuredContent?: {
-            [x: string]: unknown;
-        } | undefined;
-        isError?: boolean | undefined;
-    };
-};

package/dist/src/server/domains/shared/ResponseBuilder.js

@@ -1,48 +0,0 @@
-export class ResponseBuilder {
-    payload = {};
-    _isError = false;
-    ok() {
-        this.payload.success = true;
-        return this;
-    }
-    fail(error) {
-        this.payload.success = false;
-        this.payload.error = error instanceof Error ? error.message : String(error);
-        return this;
-    }
-    set(key, value) {
-        this.payload[key] = value;
-        return this;
-    }
-    merge(fields) {
-        Object.assign(this.payload, fields);
-        return this;
-    }
-    mcpError() {
-        this._isError = true;
-        return this;
-    }
-    json() {
-        return {
-            content: [{ type: 'text', text: JSON.stringify(this.payload, null, 2) }],
-            ...(this._isError ? { isError: true } : {}),
-        };
-    }
-    static raw(data) {
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
-    }
-    static text(text, isError = false) {
-        return {
-            content: [{ type: 'text', text }],
-            ...(isError ? { isError: true } : {}),
-        };
-    }
-}
-export const R = {
-    ok: () => new ResponseBuilder().ok(),
-    fail: (error) => new ResponseBuilder().fail(error),
-    raw: (data) => ResponseBuilder.raw(data),
-    text: (text, isError = false) => ResponseBuilder.text(text, isError),
-};

package/dist/src/server/domains/shared/modules.d.ts

@@ -1,23 +0,0 @@
-export { CodeAnalyzer } from '../../../modules/analyzer/CodeAnalyzer.js';
-export { CamoufoxBrowserManager } from '../../../modules/browser/CamoufoxBrowserManager.js';
-export { AICaptchaDetector } from '../../../modules/captcha/AICaptchaDetector.js';
-export type { CaptchaType, CaptchaProviderHint, CaptchaDetectionResult, AICaptchaDetectionResult, CaptchaDetectionConfig, } from '../../../modules/captcha/types.js';
-export { CodeCollector } from '../../../modules/collector/CodeCollector.js';
-export { DOMInspector } from '../../../modules/collector/DOMInspector.js';
-export { PageController } from '../../../modules/collector/PageController.js';
-export { CryptoDetector } from '../../../modules/crypto/CryptoDetector.js';
-export { ASTOptimizer } from '../../../modules/deobfuscator/ASTOptimizer.js';
-export { AdvancedDeobfuscator } from '../../../modules/deobfuscator/AdvancedDeobfuscator.js';
-export { Deobfuscator } from '../../../modules/deobfuscator/Deobfuscator.js';
-export { ObfuscationDetector } from '../../../modules/detector/ObfuscationDetector.js';
-export { DebuggerManager } from '../../../modules/debugger/DebuggerManager.js';
-export { RuntimeInspector } from '../../../modules/debugger/RuntimeInspector.js';
-export { ScriptManager } from '../../../modules/debugger/ScriptManager.js';
-export { BlackboxManager } from '../../../modules/debugger/BlackboxManager.js';
-export { ExternalToolRunner } from '../../../modules/external/ExternalToolRunner.js';
-export { ToolRegistry } from '../../../modules/external/ToolRegistry.js';
-export { HookManager } from '../../../modules/hook/HookManager.js';
-export { ConsoleMonitor } from '../../../modules/monitor/ConsoleMonitor.js';
-export { PerformanceMonitor } from '../../../modules/monitor/PerformanceMonitor.js';
-export { MemoryManager, UnifiedProcessManager } from '../../../modules/process/index.js';
-export { StealthScripts } from '../../../modules/stealth/StealthScripts.js';

package/dist/src/server/domains/shared/modules.js

@@ -1,22 +0,0 @@
-export { CodeAnalyzer } from '../../../modules/analyzer/CodeAnalyzer.js';
-export { CamoufoxBrowserManager } from '../../../modules/browser/CamoufoxBrowserManager.js';
-export { AICaptchaDetector } from '../../../modules/captcha/AICaptchaDetector.js';
-export { CodeCollector } from '../../../modules/collector/CodeCollector.js';
-export { DOMInspector } from '../../../modules/collector/DOMInspector.js';
-export { PageController } from '../../../modules/collector/PageController.js';
-export { CryptoDetector } from '../../../modules/crypto/CryptoDetector.js';
-export { ASTOptimizer } from '../../../modules/deobfuscator/ASTOptimizer.js';
-export { AdvancedDeobfuscator } from '../../../modules/deobfuscator/AdvancedDeobfuscator.js';
-export { Deobfuscator } from '../../../modules/deobfuscator/Deobfuscator.js';
-export { ObfuscationDetector } from '../../../modules/detector/ObfuscationDetector.js';
-export { DebuggerManager } from '../../../modules/debugger/DebuggerManager.js';
-export { RuntimeInspector } from '../../../modules/debugger/RuntimeInspector.js';
-export { ScriptManager } from '../../../modules/debugger/ScriptManager.js';
-export { BlackboxManager } from '../../../modules/debugger/BlackboxManager.js';
-export { ExternalToolRunner } from '../../../modules/external/ExternalToolRunner.js';
-export { ToolRegistry } from '../../../modules/external/ToolRegistry.js';
-export { HookManager } from '../../../modules/hook/HookManager.js';
-export { ConsoleMonitor } from '../../../modules/monitor/ConsoleMonitor.js';
-export { PerformanceMonitor } from '../../../modules/monitor/PerformanceMonitor.js';
-export { MemoryManager, UnifiedProcessManager } from '../../../modules/process/index.js';
-export { StealthScripts } from '../../../modules/stealth/StealthScripts.js';

package/dist/src/server/domains/shared/parse-args.d.ts

@@ -1,14 +0,0 @@
-type Args = Record<string, unknown>;
-export declare function argString(args: Args, key: string, fallback: string): string;
-export declare function argString(args: Args, key: string): string | undefined;
-export declare function argNumber(args: Args, key: string, fallback: number): number;
-export declare function argNumber(args: Args, key: string): number | undefined;
-export declare function argBool(args: Args, key: string, fallback: boolean): boolean;
-export declare function argBool(args: Args, key: string): boolean | undefined;
-export declare function argEnum<T extends string>(args: Args, key: string, allowed: ReadonlySet<T>, fallback: T): T;
-export declare function argEnum<T extends string>(args: Args, key: string, allowed: ReadonlySet<T>): T | undefined;
-export declare function argStringRequired(args: Args, key: string): string;
-export declare function argNumberRequired(args: Args, key: string): number;
-export declare function argStringArray(args: Args, key: string): string[];
-export declare function argObject(args: Args, key: string): Record<string, unknown> | undefined;
-export {};

package/dist/src/server/domains/shared/parse-args.js

@@ -1,50 +0,0 @@
-export function argString(args, key, fallback) {
-    const v = args[key];
-    return typeof v === 'string' ? v : fallback;
-}
-export function argNumber(args, key, fallback) {
-    const v = args[key];
-    return typeof v === 'number' ? v : fallback;
-}
-export function argBool(args, key, fallback) {
-    const v = args[key];
-    return typeof v === 'boolean' ? v : fallback;
-}
-export function argEnum(args, key, allowed, fallback) {
-    const v = args[key];
-    if (v === undefined || v === null)
-        return fallback;
-    if (typeof v !== 'string')
-        return fallback;
-    if (!allowed.has(v)) {
-        throw new Error(`Invalid ${key}: "${v}". Expected one of: ${[...allowed].join(', ')}`);
-    }
-    return v;
-}
-export function argStringRequired(args, key) {
-    const v = args[key];
-    if (typeof v !== 'string') {
-        throw new Error(`Missing required string argument: "${key}"`);
-    }
-    return v;
-}
-export function argNumberRequired(args, key) {
-    const v = args[key];
-    if (typeof v !== 'number') {
-        throw new Error(`Missing required number argument: "${key}"`);
-    }
-    return v;
-}
-export function argStringArray(args, key) {
-    const v = args[key];
-    if (!Array.isArray(v))
-        return [];
-    return v.filter((item) => typeof item === 'string');
-}
-export function argObject(args, key) {
-    const v = args[key];
-    if (v !== null && typeof v === 'object' && !Array.isArray(v)) {
-        return v;
-    }
-    return undefined;
-}

package/dist/src/server/domains/shared/registry.d.ts

@@ -1,5 +0,0 @@
-export type { DomainManifest, ToolHandlerDeps } from '../../registry/contracts.js';
-export { toolLookup } from '../../registry/types.js';
-export { bindByDepKey, getDep } from '../../registry/bind-helpers.js';
-export { ensureBrowserCore } from '../../registry/ensure-browser-core.js';
-export type { MCPServerContext } from '../../MCPServer.context.js';

package/dist/src/server/domains/shared/registry.js

@@ -1,3 +0,0 @@
-export { toolLookup } from '../../registry/types.js';
-export { bindByDepKey, getDep } from '../../registry/bind-helpers.js';
-export { ensureBrowserCore } from '../../registry/ensure-browser-core.js';

package/dist/src/server/domains/shared/response.d.ts

@@ -1,9 +0,0 @@
-import type { ToolResponse } from '../../types.js';
-export declare function asTextResponse(text: string, isError?: boolean): ToolResponse;
-export declare function asJsonResponse(payload: unknown): ToolResponse;
-export declare function asErrorResponse(error: unknown): ToolResponse;
-export declare function serializeError(error: unknown): {
-    success: false;
-    error: string;
-};
-export declare function toolErrorToResponse(error: unknown): ToolResponse;

package/dist/src/server/domains/shared/response.js

@@ -1,41 +0,0 @@
-import { ToolError, USER_CORRECTABLE_CODES } from '../../../errors/ToolError.js';
-function toErrorMessage(error) {
-    if (error instanceof Error) {
-        return error.message;
-    }
-    return String(error);
-}
-export function asTextResponse(text, isError = false) {
-    return {
-        content: [{ type: 'text', text }],
-        ...(isError ? { isError: true } : {}),
-    };
-}
-export function asJsonResponse(payload) {
-    return asTextResponse(JSON.stringify(payload, null, 2));
-}
-export function asErrorResponse(error) {
-    return asTextResponse(`Error: ${toErrorMessage(error)}`, true);
-}
-export function serializeError(error) {
-    return {
-        success: false,
-        error: toErrorMessage(error),
-    };
-}
-export function toolErrorToResponse(error) {
-    if (error instanceof ToolError) {
-        const isUserCorrectable = USER_CORRECTABLE_CODES.has(error.code);
-        const payload = {
-            success: false,
-            code: error.code,
-            message: error.message,
-        };
-        if (error.toolName)
-            payload.tool = error.toolName;
-        if (error.details)
-            payload.details = error.details;
-        return asTextResponse(JSON.stringify(payload, null, 2), !isUserCorrectable);
-    }
-    return asErrorResponse(error);
-}

package/dist/src/server/domains/sourcemap/definitions.d.ts

@@ -1,2 +0,0 @@
-import type { Tool } from '@modelcontextprotocol/sdk/types.js';
-export declare const sourcemapTools: Tool[];

package/dist/src/server/domains/sourcemap/definitions.js

@@ -1,29 +0,0 @@
-import { tool } from '../../registry/tool-builder.js';
-export const sourcemapTools = [
-    tool('sourcemap_discover')
-        .desc('自动发现页面中的 SourceMap（CDP scriptParsed + 脚本尾部注释回退）')
-        .boolean('includeInline', '包含 data: URI 内联 SourceMap', { default: true })
-        .build(),
-    tool('sourcemap_fetch_and_parse')
-        .desc('获取并解析 SourceMap v3（纯 TypeScript VLQ 解码），还原映射统计')
-        .string('sourceMapUrl', 'SourceMap URL（绝对/相对/data: URI）')
-        .string('scriptUrl', '用于解析相对路径的脚本 URL')
-        .required('sourceMapUrl')
-        .build(),
-    tool('sourcemap_reconstruct_tree')
-        .desc('从 SourceMap 重建原始项目文件树并写出到目录')
-        .string('sourceMapUrl', 'SourceMap URL')
-        .string('outputDir', '输出目录')
-        .required('sourceMapUrl')
-        .build(),
-    tool('extension_list_installed')
-        .desc('列出已安装的 Chrome 扩展（通过 CDP Target.getTargets 检测）')
-        .build(),
-    tool('extension_execute_in_context')
-        .desc('在 Chrome 扩展 background context 中执行代码')
-        .string('extensionId', 'Chrome 扩展 ID')
-        .string('code', 'JavaScript 代码')
-        .boolean('returnByValue', 'Runtime.evaluate 按值返回', { default: true })
-        .required('extensionId', 'code')
-        .build(),
-];

package/dist/src/server/domains/sourcemap/handlers.d.ts

@@ -1 +0,0 @@
-export { SourcemapToolHandlers } from '../../domains/sourcemap/handlers.impl.core.js';

package/dist/src/server/domains/sourcemap/handlers.impl.core.d.ts

@@ -1,3 +0,0 @@
-import { SourcemapToolHandlersMain } from '../../domains/sourcemap/handlers.impl.sourcemap-main.js';
-export declare class SourcemapToolHandlers extends SourcemapToolHandlersMain {
-}

package/dist/src/server/domains/sourcemap/handlers.impl.core.js

@@ -1,3 +0,0 @@
-import { SourcemapToolHandlersMain } from '../../domains/sourcemap/handlers.impl.sourcemap-main.js';
-export class SourcemapToolHandlers extends SourcemapToolHandlersMain {
-}

package/dist/src/server/domains/sourcemap/handlers.impl.sourcemap-common.d.ts

@@ -1,19 +0,0 @@
-import type { CdpSessionLike, JsonRecord, TextToolResponse } from '../../domains/sourcemap/handlers.impl.sourcemap-parse-base.js';
-import { SourcemapToolHandlersParseBase } from '../../domains/sourcemap/handlers.impl.sourcemap-parse-base.js';
-export declare class SourcemapToolHandlersCommon extends SourcemapToolHandlersParseBase {
-    protected combineSourceRoot(sourceRoot: string | undefined, sourcePath: string): string;
-    protected normalizeSourcePath(sourcePath: string, index: number): string;
-    protected sanitizePathSegment(segment: string): string;
-    protected safeTarget(value: string): string;
-    protected hasProtocol(value: string): boolean;
-    protected parseBooleanArg(value: unknown, defaultValue: boolean): boolean;
-    protected requiredStringArg(value: unknown, fieldName: string): string;
-    protected optionalStringArg(value: unknown): string | undefined;
-    protected asRecord(value: unknown): JsonRecord;
-    protected asString(value: unknown): string | undefined;
-    protected safeDetach(session: CdpSessionLike): Promise<void>;
-    protected trySend(session: CdpSessionLike, method: string, params?: JsonRecord): Promise<void>;
-    protected delay(ms: number): Promise<void>;
-    protected json(payload: unknown): TextToolResponse;
-    protected fail(tool: string, error: unknown): TextToolResponse;
-}