@jshookmcp/jshook 0.2.0 → 0.2.2

package/dist/src/server/domains/network/handlers.impl.core.runtime.performance.js

@@ -1,264 +0,0 @@
-import { AdvancedToolHandlersRequests } from '../../domains/network/handlers.impl.core.runtime.requests.js';
-const isObjectRecord = (value) => typeof value === 'object' && value !== null;
-const asOptionalString = (value) => typeof value === 'string' ? value : undefined;
-const asOptionalBoolean = (value) => typeof value === 'boolean' ? value : undefined;
-const asOptionalNumber = (value) => typeof value === 'number' && Number.isFinite(value) ? value : undefined;
-const asOptionalStringArray = (value) => {
-    if (!Array.isArray(value)) {
-        return undefined;
-    }
-    return value.every((item) => typeof item === 'string') ? value : undefined;
-};
-const isCpuProfileNodePayload = (value) => {
-    if (!isObjectRecord(value)) {
-        return false;
-    }
-    if (value.hitCount !== undefined && typeof value.hitCount !== 'number') {
-        return false;
-    }
-    if (value.callFrame !== undefined && !isObjectRecord(value.callFrame)) {
-        return false;
-    }
-    if (isObjectRecord(value.callFrame)) {
-        if (value.callFrame.functionName !== undefined &&
-            typeof value.callFrame.functionName !== 'string') {
-            return false;
-        }
-        if (value.callFrame.url !== undefined && typeof value.callFrame.url !== 'string') {
-            return false;
-        }
-        if (value.callFrame.lineNumber !== undefined && typeof value.callFrame.lineNumber !== 'number') {
-            return false;
-        }
-    }
-    return true;
-};
-const toCpuProfilePayload = (value) => {
-    if (!isObjectRecord(value)) {
-        return null;
-    }
-    if (!Array.isArray(value.nodes)) {
-        return null;
-    }
-    if (typeof value.startTime !== 'number' || typeof value.endTime !== 'number') {
-        return null;
-    }
-    if (!value.nodes.every((node) => isCpuProfileNodePayload(node))) {
-        return null;
-    }
-    return {
-        nodes: value.nodes,
-        samples: Array.isArray(value.samples) ? value.samples : undefined,
-        startTime: value.startTime,
-        endTime: value.endTime,
-    };
-};
-export class AdvancedToolHandlersPerformance extends AdvancedToolHandlersRequests {
-    async handlePerformanceGetMetrics(args) {
-        const includeTimeline = args.includeTimeline === true;
-        const monitor = this.getPerformanceMonitor();
-        const metrics = await monitor.getPerformanceMetrics();
-        const result = {
-            success: true,
-            metrics,
-        };
-        if (includeTimeline) {
-            result.timeline = await monitor.getPerformanceTimeline();
-        }
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify(result, null, 2),
-                },
-            ],
-        };
-    }
-    async handlePerformanceStartCoverage(_args) {
-        const monitor = this.getPerformanceMonitor();
-        await monitor.startCoverage();
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify({
-                        success: true,
-                        message: 'Code coverage collection started',
-                    }, null, 2),
-                },
-            ],
-        };
-    }
-    async handlePerformanceStopCoverage(_args) {
-        const monitor = this.getPerformanceMonitor();
-        const coverage = await monitor.stopCoverage();
-        const avgCoverage = coverage.length > 0
-            ? coverage.reduce((sum, info) => sum + info.coveragePercentage, 0) / coverage.length
-            : 0;
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify({
-                        success: true,
-                        coverage,
-                        totalScripts: coverage.length,
-                        avgCoverage,
-                    }, null, 2),
-                },
-            ],
-        };
-    }
-    async handlePerformanceTakeHeapSnapshot(_args) {
-        const monitor = this.getPerformanceMonitor();
-        const snapshot = await monitor.takeHeapSnapshot();
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify({
-                        success: true,
-                        snapshotSize: snapshot.length,
-                        message: 'Heap snapshot taken (data too large to return, saved internally)',
-                    }, null, 2),
-                },
-            ],
-        };
-    }
-    async handlePerformanceTraceStart(args) {
-        const monitor = this.getPerformanceMonitor();
-        const categories = asOptionalStringArray(args.categories);
-        const screenshots = asOptionalBoolean(args.screenshots);
-        await monitor.startTracing({ categories, screenshots });
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify({
-                        success: true,
-                        message: 'Performance tracing started. Call performance_trace_stop to save the trace.',
-                    }),
-                },
-            ],
-        };
-    }
-    async handlePerformanceTraceStop(args) {
-        const monitor = this.getPerformanceMonitor();
-        const artifactPath = asOptionalString(args.artifactPath);
-        const result = await monitor.stopTracing({ artifactPath });
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify({
-                        success: true,
-                        artifactPath: result.artifactPath,
-                        eventCount: result.eventCount,
-                        sizeBytes: result.sizeBytes,
-                        sizeKB: (result.sizeBytes / 1024).toFixed(1),
-                        hint: 'Open the trace file in Chrome DevTools → Performance tab → Load profile',
-                    }, null, 2),
-                },
-            ],
-        };
-    }
-    async handleProfilerCpuStart(_args) {
-        const monitor = this.getPerformanceMonitor();
-        await monitor.startCPUProfiling();
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify({
-                        success: true,
-                        message: 'CPU profiling started. Call profiler_cpu_stop to save the profile.',
-                    }),
-                },
-            ],
-        };
-    }
-    async handleProfilerCpuStop(args) {
-        const monitor = this.getPerformanceMonitor();
-        const profileRaw = await monitor.stopCPUProfiling();
-        const profile = toCpuProfilePayload(profileRaw) || profileRaw;
-        const { writeFile } = await import('node:fs/promises');
-        const { resolveArtifactPath } = await import('../../../utils/artifacts.js');
-        const artifactPath = asOptionalString(args.artifactPath);
-        const profileJson = JSON.stringify(profile, null, 2);
-        let savedPath;
-        if (artifactPath) {
-            await writeFile(artifactPath, profileJson, 'utf-8');
-            savedPath = artifactPath;
-        }
-        else {
-            const { absolutePath, displayPath } = await resolveArtifactPath({
-                category: 'profiles',
-                toolName: 'cpu-profile',
-                ext: 'cpuprofile',
-            });
-            await writeFile(absolutePath, profileJson, 'utf-8');
-            savedPath = displayPath;
-        }
-        const hotFunctions = profile.nodes
-            .filter((n) => (n.hitCount || 0) > 0)
-            .sort((a, b) => (b.hitCount || 0) - (a.hitCount || 0))
-            .slice(0, 20)
-            .map((n) => ({
-            functionName: n.callFrame?.functionName || '(anonymous)',
-            url: n.callFrame?.url,
-            line: n.callFrame?.lineNumber,
-            hitCount: n.hitCount,
-        }));
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify({
-                        success: true,
-                        artifactPath: savedPath,
-                        totalNodes: profile.nodes.length,
-                        totalSamples: profile.samples?.length || 0,
-                        durationMs: profile.endTime - profile.startTime,
-                        hotFunctions,
-                        hint: 'Open the .cpuprofile file in Chrome DevTools → Performance tab',
-                    }, null, 2),
-                },
-            ],
-        };
-    }
-    async handleProfilerHeapSamplingStart(args) {
-        const monitor = this.getPerformanceMonitor();
-        const samplingInterval = asOptionalNumber(args.samplingInterval);
-        await monitor.startHeapSampling({ samplingInterval });
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify({
-                        success: true,
-                        message: 'Heap sampling started. Call profiler_heap_sampling_stop to save the report.',
-                    }),
-                },
-            ],
-        };
-    }
-    async handleProfilerHeapSamplingStop(args) {
-        const monitor = this.getPerformanceMonitor();
-        const artifactPath = asOptionalString(args.artifactPath);
-        const topN = asOptionalNumber(args.topN);
-        const result = await monitor.stopHeapSampling({ artifactPath, topN });
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify({
-                        success: true,
-                        artifactPath: result.artifactPath,
-                        sampleCount: result.sampleCount,
-                        topAllocations: result.topAllocations,
-                    }, null, 2),
-                },
-            ],
-        };
-    }
-}

package/dist/src/server/domains/network/handlers.impl.core.runtime.requests.d.ts

@@ -1,21 +0,0 @@
-import { AdvancedToolHandlersBase } from '../../domains/network/handlers.impl.core.runtime.base.js';
-export declare class AdvancedToolHandlersRequests extends AdvancedToolHandlersBase {
-    handleNetworkGetRequests(args: Record<string, unknown>): Promise<{
-        content: {
-            type: string;
-            text: string;
-        }[];
-    }>;
-    handleNetworkGetResponseBody(args: Record<string, unknown>): Promise<{
-        content: {
-            type: string;
-            text: string;
-        }[];
-    }>;
-    handleNetworkGetStats(_args: Record<string, unknown>): Promise<{
-        content: {
-            type: string;
-            text: string;
-        }[];
-    }>;
-}

package/dist/src/server/domains/network/handlers.impl.core.runtime.requests.js

@@ -1,417 +0,0 @@
-import { AdvancedToolHandlersBase } from '../../domains/network/handlers.impl.core.runtime.base.js';
-const isObjectRecord = (value) => typeof value === 'object' && value !== null;
-const isNetworkRequestPayload = (value) => {
-    if (!isObjectRecord(value)) {
-        return false;
-    }
-    return typeof value.url === 'string' && typeof value.method === 'string';
-};
-const isNetworkResponsePayload = (value) => {
-    if (!isObjectRecord(value)) {
-        return false;
-    }
-    return typeof value.status === 'number';
-};
-const isFiniteNumber = (value) => typeof value === 'number' && Number.isFinite(value);
-const asOptionalString = (value) => typeof value === 'string' ? value : undefined;
-export class AdvancedToolHandlersRequests extends AdvancedToolHandlersBase {
-    async handleNetworkGetRequests(args) {
-        let result;
-        const autoEnable = this.parseBooleanArg(args.autoEnable, true);
-        const enableExceptions = this.parseBooleanArg(args.enableExceptions, true);
-        const networkState = await this.ensureNetworkEnabled({
-            autoEnable,
-            enableExceptions,
-        });
-        if (!networkState.enabled) {
-            if (autoEnable && networkState.error) {
-                result = {
-                    success: false,
-                    message: 'Failed to auto-enable network monitoring',
-                    detail: networkState.error,
-                    solution: {
-                        step1: 'Ensure browser page is active and reachable',
-                        step2: 'Call network_enable manually',
-                        step3: 'Navigate to target page: page_navigate(url)',
-                        step4: 'Get requests: network_get_requests',
-                    },
-                };
-            }
-            else {
-                result = {
-                    success: false,
-                    message: ' Network monitoring is not enabled',
-                    requests: [],
-                    total: 0,
-                    solution: {
-                        step1: 'Enable network monitoring: network_enable',
-                        step2: 'Navigate to target page: page_navigate(url)',
-                        step3: 'Get requests: network_get_requests',
-                    },
-                    tip: 'Set autoEnable=true to auto-enable monitoring in this call',
-                };
-            }
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result, null, 2),
-                    },
-                ],
-            };
-        }
-        const url = asOptionalString(args.url);
-        const urlRegex = asOptionalString(args.urlRegex);
-        const method = asOptionalString(args.method);
-        const sinceTimestamp = isFiniteNumber(args.sinceTimestamp) ? args.sinceTimestamp : undefined;
-        const sinceRequestId = asOptionalString(args.sinceRequestId);
-        const tail = isFiniteNumber(args.tail) && args.tail > 0 ? Math.floor(args.tail) : undefined;
-        const limit = this.parseNumberArg(args.limit, {
-            defaultValue: 100,
-            min: 1,
-            max: 1000,
-            integer: true,
-        });
-        const offset = this.parseNumberArg(args.offset, {
-            defaultValue: 0,
-            min: 0,
-            integer: true,
-        });
-        let requests = this.consoleMonitor
-            .getNetworkRequests()
-            .filter((req) => isNetworkRequestPayload(req));
-        if (requests.length === 0) {
-            result = {
-                success: true,
-                message: 'No network requests captured yet',
-                requests: [],
-                total: 0,
-                hint: 'Network monitoring is enabled, but no requests have been captured',
-                possibleReasons: [
-                    "1. You haven't navigated to any page yet (use page_navigate)",
-                    '2. The page has already loaded before network monitoring was enabled',
-                    "3. The page doesn't make any network requests",
-                    '4. The page uses frontend-wrapped fetch/XHR not captured by CDP',
-                ],
-                recommended_actions: [
-                    'console_inject_fetch_interceptor() — capture frontend-wrapped fetch calls (SPAs, React, Vue)',
-                    'console_inject_xhr_interceptor() — capture XMLHttpRequest calls',
-                    'page_navigate(url, enableNetworkMonitoring=true) — re-navigate with monitoring enabled',
-                ],
-                nextAction: 'Call console_inject_fetch_interceptor(), then re-navigate or trigger the target action',
-                monitoring: {
-                    autoEnabled: networkState.autoEnabled,
-                },
-            };
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result, null, 2),
-                    },
-                ],
-            };
-        }
-        const originalCount = requests.length;
-        const allUrls = requests.map((r) => r.url);
-        if (sinceRequestId) {
-            const idx = requests.findIndex((r) => r.requestId === sinceRequestId);
-            if (idx >= 0) {
-                requests = requests.slice(idx + 1);
-            }
-        }
-        if (sinceTimestamp !== undefined) {
-            requests = requests.filter((r) => (r.timestamp ?? 0) > sinceTimestamp);
-        }
-        if (urlRegex) {
-            if (urlRegex.length > 500) {
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: JSON.stringify({
-                                success: false,
-                                error: 'urlRegex too long (max 500 characters)',
-                            }, null, 2),
-                        },
-                    ],
-                };
-            }
-            try {
-                const re = new RegExp(urlRegex, 'i');
-                requests = requests.filter((req) => re.test(req.url));
-            }
-            catch {
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: JSON.stringify({
-                                success: false,
-                                error: `Invalid urlRegex pattern: ${urlRegex}`,
-                            }, null, 2),
-                        },
-                    ],
-                };
-            }
-        }
-        else if (url) {
-            const urlLower = url.toLowerCase();
-            requests = requests.filter((req) => req.url.toLowerCase().includes(urlLower));
-        }
-        if (method && method.toUpperCase() !== 'ALL') {
-            requests = requests.filter((req) => req.method.toUpperCase() === method.toUpperCase());
-        }
-        if (tail !== undefined && requests.length > tail) {
-            requests = requests.slice(-tail);
-        }
-        const beforeLimit = requests.length;
-        requests = requests.slice(offset, offset + limit);
-        const hasMore = offset + requests.length < beforeLimit;
-        const filterMiss = beforeLimit === 0 && originalCount > 0 && !!(url || (method && method.toUpperCase() !== 'ALL'));
-        const urlSamples = filterMiss ? allUrls.slice(0, 10).map((u) => u.substring(0, 120)) : undefined;
-        result = {
-            success: true,
-            message: ` Retrieved ${requests.length} network request(s)`,
-            requests,
-            total: requests.length,
-            page: {
-                offset,
-                limit,
-                returned: requests.length,
-                totalAfterFilter: beforeLimit,
-                hasMore,
-                nextOffset: hasMore ? offset + requests.length : null,
-            },
-            stats: {
-                totalCaptured: originalCount,
-                afterFilter: beforeLimit,
-                returned: requests.length,
-                truncated: beforeLimit > offset + limit,
-            },
-            filtered: !!(url || urlRegex || (method && method.toUpperCase() !== 'ALL') || sinceTimestamp || sinceRequestId || tail),
-            filters: { url, urlRegex, method, sinceTimestamp, sinceRequestId, tail, limit, offset },
-            monitoring: {
-                autoEnabled: networkState.autoEnabled,
-            },
-            ...(filterMiss && {
-                filterMiss: true,
-                hint: `URL filter "${url}" matched 0 of ${originalCount} captured requests. Check urlSamples to verify the correct filter substring.`,
-                urlSamples,
-            }),
-            tip: requests.length > 0
-                ? 'Use network_get_response_body(requestId) to get response content'
-                : undefined,
-        };
-        const processedResult = this.detailedDataManager.smartHandle(result, 51200);
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify(processedResult, null, 2),
-                },
-            ],
-        };
-    }
-    async handleNetworkGetResponseBody(args) {
-        const requestId = asOptionalString(args.requestId) || '';
-        const maxSize = this.parseNumberArg(args.maxSize, {
-            defaultValue: 100000,
-            min: 1024,
-            max: 20 * 1024 * 1024,
-            integer: true,
-        });
-        const returnSummary = this.parseBooleanArg(args.returnSummary, false);
-        const retries = this.parseNumberArg(args.retries, {
-            defaultValue: 3,
-            min: 0,
-            max: 10,
-            integer: true,
-        });
-        const retryIntervalMs = this.parseNumberArg(args.retryIntervalMs, {
-            defaultValue: 500,
-            min: 50,
-            max: 5000,
-            integer: true,
-        });
-        const autoEnable = this.parseBooleanArg(args.autoEnable, false);
-        const enableExceptions = this.parseBooleanArg(args.enableExceptions, true);
-        let result;
-        if (!requestId) {
-            result = {
-                success: false,
-                message: 'requestId parameter is required',
-                hint: 'Get requestId from network_get_requests tool',
-            };
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result, null, 2),
-                    },
-                ],
-            };
-        }
-        const networkState = await this.ensureNetworkEnabled({
-            autoEnable,
-            enableExceptions,
-        });
-        if (!networkState.enabled) {
-            result = {
-                success: false,
-                message: 'Network monitoring is not enabled',
-                hint: autoEnable
-                    ? 'Auto-enable failed. Check active page and call network_enable manually.'
-                    : 'Use network_enable tool first, or set autoEnable=true',
-                detail: networkState.error,
-            };
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result, null, 2),
-                    },
-                ],
-            };
-        }
-        let body = null;
-        let attemptsMade = 0;
-        for (let attempt = 0; attempt <= retries; attempt += 1) {
-            attemptsMade = attempt + 1;
-            body = await this.consoleMonitor.getResponseBody(requestId);
-            if (body) {
-                break;
-            }
-            if (attempt < retries) {
-                await this.sleep(retryIntervalMs);
-            }
-        }
-        if (!body) {
-            result = {
-                success: false,
-                message: `No response body found for requestId: ${requestId}`,
-                hint: 'The request may not have completed yet, or the requestId is invalid',
-                attempts: attemptsMade,
-                waitedMs: retries * retryIntervalMs,
-                retryConfig: {
-                    retries,
-                    retryIntervalMs,
-                },
-            };
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result, null, 2),
-                    },
-                ],
-            };
-        }
-        const originalSize = body.body.length;
-        const isTooLarge = originalSize > maxSize;
-        if (returnSummary || isTooLarge) {
-            const preview = body.body.substring(0, 500);
-            result = {
-                success: true,
-                requestId,
-                attempts: attemptsMade,
-                summary: {
-                    size: originalSize,
-                    sizeKB: (originalSize / 1024).toFixed(2),
-                    base64Encoded: body.base64Encoded,
-                    preview: preview + (originalSize > 500 ? '...' : ''),
-                    truncated: isTooLarge,
-                    reason: isTooLarge
-                        ? `Response too large (${(originalSize / 1024).toFixed(2)} KB > ${(maxSize / 1024).toFixed(2)} KB)`
-                        : 'Summary mode enabled',
-                },
-                tip: isTooLarge
-                    ? 'Use collect_code tool to collect and compress this script, or increase maxSize parameter'
-                    : 'Set returnSummary=false to get full body',
-            };
-        }
-        else {
-            result = {
-                success: true,
-                requestId,
-                attempts: attemptsMade,
-                body: body.body,
-                base64Encoded: body.base64Encoded,
-                size: originalSize,
-                sizeKB: (originalSize / 1024).toFixed(2),
-            };
-        }
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify(result, null, 2),
-                },
-            ],
-        };
-    }
-    async handleNetworkGetStats(_args) {
-        if (!this.consoleMonitor.isNetworkEnabled()) {
-            const result = {
-                success: false,
-                message: 'Network monitoring is not enabled',
-                hint: 'Use network_enable tool first',
-            };
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result, null, 2),
-                    },
-                ],
-            };
-        }
-        const requests = this.consoleMonitor
-            .getNetworkRequests()
-            .filter((req) => isNetworkRequestPayload(req));
-        const responses = this.consoleMonitor
-            .getNetworkResponses()
-            .filter((res) => isNetworkResponsePayload(res));
-        const byMethod = {};
-        requests.forEach((req) => {
-            byMethod[req.method] = (byMethod[req.method] || 0) + 1;
-        });
-        const byStatus = {};
-        responses.forEach((res) => {
-            byStatus[res.status] = (byStatus[res.status] || 0) + 1;
-        });
-        const byType = {};
-        requests.forEach((req) => {
-            const type = req.type || 'unknown';
-            byType[type] = (byType[type] || 0) + 1;
-        });
-        const timestamps = requests.map((r) => r.timestamp).filter((t) => isFiniteNumber(t));
-        const timeStats = timestamps.length > 0
-            ? {
-                earliest: Math.min(...timestamps),
-                latest: Math.max(...timestamps),
-                duration: Math.max(...timestamps) - Math.min(...timestamps),
-            }
-            : null;
-        const result = {
-            success: true,
-            stats: {
-                totalRequests: requests.length,
-                totalResponses: responses.length,
-                byMethod,
-                byStatus,
-                byType,
-                timeStats,
-                monitoringEnabled: true,
-            },
-        };
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify(result, null, 2),
-                },
-            ],
-        };
-    }
-}