@jshookmcp/jshook 0.2.2 → 0.2.5

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

@@ -16,7 +16,10 @@ export class SandboxToolHandlers {
         if (!code || typeof code !== 'string') {
             return {
                 content: [
-                    { type: 'text', text: JSON.stringify({ ok: false, error: 'code parameter is required' }) },
+                    {
+                        type: 'text',
+                        text: JSON.stringify({ ok: false, error: 'code parameter is required' }),
+                    },
                 ],
             };
         }
@@ -30,7 +33,7 @@ export class SandboxToolHandlers {
             options.sessionId = sessionId;
             const scratchpadState = this.scratchpad.getAll(sessionId);
             options.globals = {
-                ...(options.globals ?? {}),
+                ...options.globals,
                 __scratchpad: scratchpadState,
             };
         }
@@ -53,7 +56,9 @@ export class SandboxToolHandlers {
             `**Status:** ${result.ok ? '✓ Success' : '✗ Failed'}`,
             result.timedOut ? '**Timed out:** yes' : '',
             `**Duration:** ${result.durationMs}ms`,
-            result.logs.length > 0 ? `**Console output:**\n\`\`\`\n${result.logs.join('\n')}\n\`\`\`` : '',
+            result.logs.length > 0
+                ? `**Console output:**\n\`\`\`\n${result.logs.join('\n')}\n\`\`\``
+                : '',
             result.output !== undefined ? `**Result:** ${JSON.stringify(result.output)}` : '',
             result.error ? `**Error:** ${result.error}` : '',
         ]

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

@@ -0,0 +1,209 @@
+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

@@ -0,0 +1,48 @@
+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

@@ -16,8 +16,6 @@ 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 { AIHookGenerator } from '../../../modules/hook/AIHookGenerator.js';
-export type { AIHookRequest } from '../../../modules/hook/AIHookGenerator.js';
 export { HookManager } from '../../../modules/hook/HookManager.js';
 export { ConsoleMonitor } from '../../../modules/monitor/ConsoleMonitor.js';
 export { PerformanceMonitor } from '../../../modules/monitor/PerformanceMonitor.js';

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

@@ -15,7 +15,6 @@ 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 { AIHookGenerator } from '../../../modules/hook/AIHookGenerator.js';
 export { HookManager } from '../../../modules/hook/HookManager.js';
 export { ConsoleMonitor } from '../../../modules/monitor/ConsoleMonitor.js';
 export { PerformanceMonitor } from '../../../modules/monitor/PerformanceMonitor.js';

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

@@ -1,113 +1,29 @@
+import { tool } from '../../registry/tool-builder.js';
 export const sourcemapTools = [
-    {
-        name: 'sourcemap_discover',
-        description: '自动发现页面中的 SourceMap。通过 CDP Debugger.scriptParsed 事件收集 sourceMapURL，并回退检查脚本尾部 //# sourceMappingURL= 注释。',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                includeInline: {
-                    type: 'boolean',
-                    description: '是否包含 data: URI 内联 SourceMap（默认: true）',
-                    default: true,
-                },
-            },
-        },
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: false,
-            openWorldHint: false,
-        },
-    },
-    {
-        name: 'sourcemap_fetch_and_parse',
-        description: '获取并解析 SourceMap v3（纯 TypeScript VLQ 解码，不依赖 source-map 包），还原 generated → original 映射统计。',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                sourceMapUrl: {
-                    type: 'string',
-                    description: 'SourceMap URL（支持绝对 URL、相对 URL、data: URI）',
-                },
-                scriptUrl: {
-                    type: 'string',
-                    description: '可选。用于解析相对 sourceMapUrl 的脚本 URL',
-                },
-            },
-            required: ['sourceMapUrl'],
-        },
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: false,
-            openWorldHint: false,
-        },
-    },
-    {
-        name: 'sourcemap_reconstruct_tree',
-        description: '从 SourceMap 重建原始项目文件树，将 sources + sourcesContent 写出到目录（通过 resolveArtifactPath 生成输出目录）。',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                sourceMapUrl: {
-                    type: 'string',
-                    description: 'SourceMap URL（支持绝对 URL、相对 URL、data: URI）',
-                },
-                outputDir: {
-                    type: 'string',
-                    description: '可选输出目录（相对项目根目录或绝对路径）',
-                },
-            },
-            required: ['sourceMapUrl'],
-        },
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: false,
-            openWorldHint: false,
-        },
-    },
-    {
-        name: 'extension_list_installed',
-        description: "列出已安装的 Chrome 扩展。通过 CDP Target.getTargets 检测 type='service_worker' 或 'background_page' 的 chrome-extension:// targets。",
-        inputSchema: {
-            type: 'object',
-            properties: {},
-        },
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: false,
-            openWorldHint: false,
-        },
-    },
-    {
-        name: 'extension_execute_in_context',
-        description: '在指定 Chrome 扩展的 background context 中执行代码。通过 Target.attachToTarget 附加后调用 Runtime.evaluate。',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                extensionId: {
-                    type: 'string',
-                    description: 'Chrome 扩展 ID（32 位 a-p 字符）',
-                },
-                code: {
-                    type: 'string',
-                    description: '要在扩展 background context 执行的 JavaScript 代码',
-                },
-                returnByValue: {
-                    type: 'boolean',
-                    description: 'Runtime.evaluate 是否按值返回（默认: true）',
-                    default: true,
-                },
-            },
-            required: ['extensionId', 'code'],
-        },
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: false,
-            openWorldHint: false,
-        },
-    },
+    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.impl.sourcemap-common.js

@@ -54,8 +54,13 @@ export class SourcemapToolHandlersCommon extends SourcemapToolHandlersParseBase
         return parts.join('/');
     }
     sanitizePathSegment(segment) {
-        const sanitized = segment
-            .replace(/[<>:"|?*\u0000-\u001F]/g, '_')
+        const sanitized = Array.from(segment, (char) => {
+            const codePoint = char.codePointAt(0);
+            return codePoint !== undefined && (codePoint <= 0x1f || '<>:"|?*'.includes(char))
+                ? '_'
+                : char;
+        })
+            .join('')
             .replace(/\s+/g, ' ')
             .trim();
         if (!sanitized || sanitized === '.' || sanitized === '..') {

package/dist/src/server/domains/sourcemap/handlers.impl.sourcemap-main.js

@@ -61,7 +61,7 @@ export class SourcemapToolHandlersMain extends SourcemapToolHandlersExtension {
             const result = Array.from(scripts.values())
                 .filter((item) => item.sourceMapUrl.length > 0)
                 .filter((item) => includeInline || !item.isInline)
-                .sort((left, right) => {
+                .toSorted((left, right) => {
                 const leftKey = `${left.scriptUrl}|${left.scriptId}`;
                 const rightKey = `${right.scriptUrl}|${right.scriptId}`;
                 return leftKey.localeCompare(rightKey);

package/dist/src/server/domains/sourcemap/handlers.impl.sourcemap-parse-base.js

@@ -177,7 +177,7 @@ export class SourcemapToolHandlersParseBase {
             }
             catch (err) {
                 if (err.name === 'AbortError') {
-                    throw new Error(`SourceMap fetch timed out after 10s: ${resolvedUrl}`);
+                    throw new Error(`SourceMap fetch timed out after 10s: ${resolvedUrl}`, { cause: err });
                 }
             }
             finally {

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

@@ -7,7 +7,7 @@ declare const manifest: {
     version: 1;
     domain: "sourcemap";
     depKey: "sourcemapHandlers";
-    profiles: "full"[];
+    profiles: ("workflow" | "full")[];
     ensure: typeof ensure;
     registrations: {
         tool: {

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

@@ -20,7 +20,7 @@ const manifest = {
     version: 1,
     domain: DOMAIN,
     depKey: DEP_KEY,
-    profiles: ['full'],
+    profiles: ['workflow', 'full'],
     ensure,
     registrations: [
         {