@jshookmcp/jshook 0.2.3 → 0.2.6

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: [
         {

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

@@ -1,150 +1,38 @@
+import { tool } from '../../registry/tool-builder.js';
 export const streamingTools = [
-    {
-        name: 'ws_monitor_enable',
-        description: 'Enable WebSocket frame capture via CDP Network events (webSocketFrameSent / webSocketFrameReceived).',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                urlFilter: {
-                    type: 'string',
-                    description: 'Optional regex filter for WebSocket URL (only matching connections are tracked).',
-                },
-                maxFrames: {
-                    type: 'number',
-                    description: 'Maximum frames to keep in memory (default: 1000).',
-                    default: 1000,
-                },
-            },
-        },
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: false,
-            openWorldHint: false,
-        },
-    },
-    {
-        name: 'ws_monitor_disable',
-        description: 'Disable WebSocket monitoring and return capture summary.',
-        inputSchema: {
-            type: 'object',
-            properties: {},
-        },
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: true,
-            idempotentHint: false,
-            openWorldHint: false,
-        },
-    },
-    {
-        name: 'ws_get_frames',
-        description: 'Get captured WebSocket frames with pagination and optional payload regex filter.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                direction: {
-                    type: 'string',
-                    enum: ['sent', 'received', 'all'],
-                    description: 'Frame direction filter (default: all).',
-                    default: 'all',
-                },
-                limit: {
-                    type: 'number',
-                    description: 'Maximum frames to return (default: 100, max: 5000).',
-                    default: 100,
-                },
-                offset: {
-                    type: 'number',
-                    description: 'Pagination offset (default: 0).',
-                    default: 0,
-                },
-                payloadFilter: {
-                    type: 'string',
-                    description: 'Optional regex filter applied to frame payload sample.',
-                },
-            },
-        },
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: false,
-            openWorldHint: false,
-        },
-    },
-    {
-        name: 'ws_get_connections',
-        description: 'Get tracked WebSocket connections and frame counts.',
-        inputSchema: {
-            type: 'object',
-            properties: {},
-        },
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: false,
-            openWorldHint: false,
-        },
-    },
-    {
-        name: 'sse_monitor_enable',
-        description: 'Enable SSE monitoring by injecting an EventSource constructor interceptor in page context. Supports persistent mode to survive navigations.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                urlFilter: {
-                    type: 'string',
-                    description: 'Optional regex filter for EventSource URL.',
-                },
-                maxEvents: {
-                    type: 'number',
-                    description: 'Maximum SSE events to keep in memory (default: 2000).',
-                    default: 2000,
-                },
-                persistent: {
-                    type: 'boolean',
-                    description: 'When true, interceptor survives page navigations (uses evaluateOnNewDocument). Default: false.',
-                },
-            },
-        },
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: false,
-            openWorldHint: false,
-        },
-    },
-    {
-        name: 'sse_get_events',
-        description: 'Get captured SSE events with filters and pagination.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                sourceUrl: {
-                    type: 'string',
-                    description: 'Filter by EventSource URL (exact match).',
-                },
-                eventType: {
-                    type: 'string',
-                    description: 'Filter by SSE event type (e.g. "message", custom event name).',
-                },
-                limit: {
-                    type: 'number',
-                    description: 'Maximum events to return (default: 100, max: 5000).',
-                    default: 100,
-                },
-                offset: {
-                    type: 'number',
-                    description: 'Pagination offset (default: 0).',
-                    default: 0,
-                },
-            },
-        },
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: false,
-            openWorldHint: false,
-        },
-    },
+    tool('ws_monitor_enable')
+        .desc('Enable WebSocket frame capture via CDP Network events')
+        .string('urlFilter', 'Regex filter for WebSocket URL')
+        .number('maxFrames', 'Maximum frames in memory', { default: 1000 })
+        .build(),
+    tool('ws_monitor_disable')
+        .desc('Disable WebSocket monitoring and return capture summary')
+        .destructive()
+        .build(),
+    tool('ws_get_frames')
+        .desc('Get captured WebSocket frames with pagination and payload filter')
+        .enum('direction', ['sent', 'received', 'all'], 'Frame direction filter', { default: 'all' })
+        .number('limit', 'Maximum frames to return', { default: 100 })
+        .number('offset', 'Pagination offset', { default: 0 })
+        .string('payloadFilter', 'Regex filter on frame payload')
+        .readOnly()
+        .build(),
+    tool('ws_get_connections')
+        .desc('Get tracked WebSocket connections and frame counts')
+        .readOnly()
+        .build(),
+    tool('sse_monitor_enable')
+        .desc('Enable SSE monitoring by injecting EventSource interceptor')
+        .string('urlFilter', 'Regex filter for EventSource URL')
+        .number('maxEvents', 'Maximum SSE events in memory', { default: 2000 })
+        .boolean('persistent', 'Survive page navigations via evaluateOnNewDocument')
+        .build(),
+    tool('sse_get_events')
+        .desc('Get captured SSE events with filters and pagination')
+        .string('sourceUrl', 'Filter by EventSource URL')
+        .string('eventType', 'Filter by SSE event type')
+        .number('limit', 'Maximum events', { default: 100 })
+        .number('offset', 'Pagination offset', { default: 0 })
+        .readOnly()
+        .build(),
 ];