@jshookmcp/jshook 0.1.2

package/dist/server/domains/browser/handlers/js-heap.js

@@ -0,0 +1,195 @@
+import { DetailedDataManager } from '../../../../utils/DetailedDataManager.js';
+import { cdpLimit } from '../../../../utils/concurrency.js';
+import { logger } from '../../../../utils/logger.js';
+const NODE_TYPE_NAMES = [
+    'hidden',
+    'array',
+    'string',
+    'object',
+    'code',
+    'closure',
+    'regexp',
+    'number',
+    'native',
+    'synthetic',
+    'concatenated string',
+    'sliced string',
+    'symbol',
+    'bigint',
+];
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function isCDPPageLike(value) {
+    return isRecord(value) && typeof value.createCDPSession === 'function';
+}
+function isHeapSnapshotChunk(value) {
+    return isRecord(value) && typeof value.chunk === 'string';
+}
+function toStringArray(value) {
+    return Array.isArray(value) ? value.filter((v) => typeof v === 'string') : [];
+}
+function toNumberArray(value) {
+    return Array.isArray(value) ? value.filter((v) => typeof v === 'number') : [];
+}
+export class JSHeapSearchHandlers {
+    deps;
+    detailedDataManager;
+    constructor(deps) {
+        this.deps = deps;
+        this.detailedDataManager = DetailedDataManager.getInstance();
+    }
+    async handleJSHeapSearch(args) {
+        const pattern = typeof args.pattern === 'string' ? args.pattern : '';
+        const maxResults = typeof args.maxResults === 'number' ? args.maxResults : 50;
+        const caseSensitive = typeof args.caseSensitive === 'boolean' ? args.caseSensitive : false;
+        if (!pattern) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({ success: false, error: 'pattern is required' }, null, 2),
+                    }],
+            };
+        }
+        return cdpLimit(async () => {
+            let cdpSession = null;
+            let ownedSession = false;
+            try {
+                const page = await this.deps.getActivePage();
+                if (!isCDPPageLike(page)) {
+                    throw new Error('Active page does not support CDP session creation');
+                }
+                cdpSession = await page.createCDPSession();
+                ownedSession = true;
+                logger.info('[js_heap_search] Taking heap snapshot', {
+                    patternLength: pattern.length,
+                    caseSensitive,
+                    maxResults,
+                });
+                await cdpSession.send('HeapProfiler.enable');
+                let snapshotData = '';
+                cdpSession.on('HeapProfiler.addHeapSnapshotChunk', (params) => {
+                    if (isHeapSnapshotChunk(params)) {
+                        snapshotData += params.chunk;
+                    }
+                });
+                await cdpSession.send('HeapProfiler.takeHeapSnapshot', {
+                    reportProgress: false,
+                    treatGlobalObjectsAsRoots: true,
+                    captureNumericValue: false,
+                });
+                await cdpSession.send('HeapProfiler.disable');
+                logger.info(`[js_heap_search] Snapshot size: ${(snapshotData.length / 1024).toFixed(1)} KB`);
+                const matches = this.searchSnapshot(snapshotData, pattern, maxResults, caseSensitive);
+                const result = {
+                    success: true,
+                    pattern,
+                    caseSensitive,
+                    snapshotSizeKB: Math.round(snapshotData.length / 1024),
+                    matchCount: matches.length,
+                    truncated: matches.length >= maxResults,
+                    matches,
+                    tip: matches.length > 0
+                        ? 'Use page_evaluate to inspect the objects at the paths found. E.g., eval the objectPath as a JS expression.'
+                        : 'No matches found. The value may be encrypted, compressed, or stored in a non-string form.',
+                };
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify(this.detailedDataManager.smartHandle(result, 51200), null, 2),
+                        }],
+                };
+            }
+            catch (error) {
+                logger.error('[js_heap_search] Error:', error);
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: false,
+                                error: error instanceof Error ? error.message : String(error),
+                            }, null, 2),
+                        }],
+                };
+            }
+            finally {
+                if (ownedSession && cdpSession) {
+                    try {
+                        await cdpSession.detach();
+                    }
+                    catch {
+                    }
+                }
+            }
+        });
+    }
+    searchSnapshot(snapshotData, pattern, maxResults, caseSensitive) {
+        try {
+            const parsed = JSON.parse(snapshotData);
+            if (!isRecord(parsed)) {
+                return [];
+            }
+            const snapshot = parsed;
+            const strings = toStringArray(snapshot.strings);
+            const nodes = toNumberArray(snapshot.nodes);
+            const nodeFields = toStringArray(snapshot.snapshot?.meta?.node_fields);
+            const nodeTypesRaw = snapshot.snapshot?.meta?.node_types;
+            const nodeTypeTable = Array.isArray(nodeTypesRaw) && Array.isArray(nodeTypesRaw[0])
+                ? nodeTypesRaw[0]
+                : [];
+            const nodeFieldCount = nodeFields.length;
+            if (nodeFieldCount === 0 || strings.length === 0) {
+                return [];
+            }
+            const typeIdx = nodeFields.indexOf('type');
+            const nameIdx = nodeFields.indexOf('name');
+            const idIdx = nodeFields.indexOf('id');
+            if (typeIdx < 0 || nameIdx < 0) {
+                return [];
+            }
+            const searchStr = caseSensitive ? pattern : pattern.toLowerCase();
+            const matches = [];
+            const nodeCount = Math.floor(nodes.length / nodeFieldCount);
+            for (let i = 0; i < nodeCount && matches.length < maxResults; i++) {
+                const base = i * nodeFieldCount;
+                const typeOrdinal = nodes[base + typeIdx] ?? 0;
+                const nameOrdinal = nodes[base + nameIdx];
+                if (nameOrdinal === undefined || nameOrdinal >= strings.length) {
+                    continue;
+                }
+                const tableName = nodeTypeTable[typeOrdinal];
+                const nodeTypeName = (typeof tableName === 'string' ? tableName : undefined) ??
+                    NODE_TYPE_NAMES[typeOrdinal] ??
+                    `type_${typeOrdinal}`;
+                if (nodeTypeName !== 'string' &&
+                    nodeTypeName !== 'concatenated string' &&
+                    nodeTypeName !== 'sliced string') {
+                    continue;
+                }
+                const value = strings[nameOrdinal];
+                if (typeof value !== 'string') {
+                    continue;
+                }
+                const haystack = caseSensitive ? value : value.toLowerCase();
+                if (!haystack.includes(searchStr)) {
+                    continue;
+                }
+                const rawId = idIdx >= 0 ? nodes[base + idIdx] : undefined;
+                const nodeId = rawId !== undefined ? rawId : i;
+                matches.push({
+                    nodeId,
+                    nodeType: nodeTypeName,
+                    value: value.length > 200 ? `${value.slice(0, 200)}…` : value,
+                    objectPath: `[HeapNode #${nodeId}]`,
+                    nameHint: value.slice(0, 80),
+                });
+            }
+            return matches;
+        }
+        catch (error) {
+            logger.warn('[js_heap_search] Snapshot parse error:', error);
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=js-heap.js.map

package/dist/server/domains/browser/handlers/js-heap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"js-heap.js","sourceRoot":"","sources":["../../../../../src/server/domains/browser/handlers/js-heap.ts"],"names":[],"mappings":"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"}

package/dist/server/domains/browser/handlers/page-data.d.ts

@@ -0,0 +1,66 @@
+import type { PageController } from '../../../domains/shared/modules.js';
+interface PageDataHandlersDeps {
+    pageController: PageController;
+    getActiveDriver: () => 'chrome' | 'camoufox';
+    getCamoufoxPage: () => Promise<unknown>;
+}
+export declare class PageDataHandlers {
+    private deps;
+    constructor(deps: PageDataHandlersDeps);
+    handlePageGetPerformance(_args: Record<string, unknown>): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+    handlePageSetCookies(args: Record<string, unknown>): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+    handlePageGetCookies(_args: Record<string, unknown>): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+    handlePageClearCookies(_args: Record<string, unknown>): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+    handlePageSetViewport(args: Record<string, unknown>): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+    handlePageEmulateDevice(args: Record<string, unknown>): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+    handlePageGetLocalStorage(_args: Record<string, unknown>): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+    handlePageSetLocalStorage(args: Record<string, unknown>): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+    handlePageGetAllLinks(_args: Record<string, unknown>): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+}
+export {};
+//# sourceMappingURL=page-data.d.ts.map

package/dist/server/domains/browser/handlers/page-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-data.d.ts","sourceRoot":"","sources":["../../../../../src/server/domains/browser/handlers/page-data.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAarE,UAAU,oBAAoB;IAC5B,cAAc,EAAE,cAAc,CAAC;IAC/B,eAAe,EAAE,MAAM,QAAQ,GAAG,UAAU,CAAC;IAC7C,eAAe,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CACzC;AAED,qBAAa,gBAAgB;IACf,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,oBAAoB;IAExC,wBAAwB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;IAoBvD,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;IAsBlD,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;IAoBnD,sBAAsB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;IAoBrD,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;IAuBnD,uBAAuB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;IAsBrD,yBAAyB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;IAoBxD,yBAAyB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;IAuBvD,qBAAqB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;CAmB3D"}

package/dist/server/domains/browser/handlers/page-data.js

@@ -0,0 +1,139 @@
+export class PageDataHandlers {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async handlePageGetPerformance(_args) {
+        const metrics = await this.deps.pageController.getPerformanceMetrics();
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        metrics,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    async handlePageSetCookies(args) {
+        const cookies = args.cookies;
+        await this.deps.pageController.setCookies(cookies);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        message: `Set ${cookies.length} cookies`,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    async handlePageGetCookies(_args) {
+        const cookies = await this.deps.pageController.getCookies();
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        count: cookies.length,
+                        cookies,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    async handlePageClearCookies(_args) {
+        await this.deps.pageController.clearCookies();
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        message: 'Cookies cleared',
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    async handlePageSetViewport(args) {
+        const width = args.width;
+        const height = args.height;
+        await this.deps.pageController.setViewport(width, height);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        viewport: { width, height },
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    async handlePageEmulateDevice(args) {
+        const device = args.device;
+        await this.deps.pageController.emulateDevice(device);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        device,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    async handlePageGetLocalStorage(_args) {
+        const storage = await this.deps.pageController.getLocalStorage();
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        count: Object.keys(storage).length,
+                        storage,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    async handlePageSetLocalStorage(args) {
+        const key = args.key;
+        const value = args.value;
+        await this.deps.pageController.setLocalStorage(key, value);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        key,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    async handlePageGetAllLinks(_args) {
+        const links = await this.deps.pageController.getAllLinks();
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        count: links.length,
+                        links,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+}
+//# sourceMappingURL=page-data.js.map

package/dist/server/domains/browser/handlers/page-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-data.js","sourceRoot":"","sources":["../../../../../src/server/domains/browser/handlers/page-data.ts"],"names":[],"mappings":"AAmBA,MAAM,OAAO,gBAAgB;IACP;IAApB,YAAoB,IAA0B;QAA1B,SAAI,GAAJ,IAAI,CAAsB;IAAG,CAAC;IAElD,KAAK,CAAC,wBAAwB,CAAC,KAA8B;QAC3D,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,qBAAqB,EAAE,CAAC;QAEvE,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,OAAO,EAAE,IAAI;wBACb,OAAO;qBACR,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,IAA6B;QACtD,MAAM,OAAO,GAAG,IAAI,CAAC,OAA4B,CAAC;QAElD,MAAM,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAEnD,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,OAAO,EAAE,IAAI;wBACb,OAAO,EAAE,OAAO,OAAO,CAAC,MAAM,UAAU;qBACzC,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,KAA8B;QACvD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,CAAC;QAE5D,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,KAAK,EAAE,OAAO,CAAC,MAAM;wBACrB,OAAO;qBACR,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,sBAAsB,CAAC,KAA8B;QACzD,MAAM,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC;QAE9C,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,OAAO,EAAE,IAAI;wBACb,OAAO,EAAE,iBAAiB;qBAC3B,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,qBAAqB,CAAC,IAA6B;QACvD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAe,CAAC;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAgB,CAAC;QAErC,MAAM,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAE1D,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,OAAO,EAAE,IAAI;wBACb,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;qBAC5B,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,uBAAuB,CAAC,IAA6B;QACzD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAuC,CAAC;QAE5D,MAAM,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAErD,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,OAAO,EAAE,IAAI;wBACb,MAAM;qBACP,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,yBAAyB,CAAC,KAA8B;QAC5D,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,eAAe,EAAE,CAAC;QAEjE,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM;wBAClC,OAAO;qBACR,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,yBAAyB,CAAC,IAA6B;QAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAa,CAAC;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAe,CAAC;QAEnC,MAAM,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAE3D,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,OAAO,EAAE,IAAI;wBACb,GAAG;qBACJ,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,qBAAqB,CAAC,KAA8B;QACxD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,CAAC;QAE3D,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,KAAK,EAAE,KAAK,CAAC,MAAM;wBACnB,KAAK;qBACN,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/server/domains/browser/handlers/page-evaluation.d.ts

@@ -0,0 +1,38 @@
+import type { PageController } from '../../../domains/shared/modules.js';
+import type { DetailedDataManager } from '../../../../utils/DetailedDataManager.js';
+interface PageEvaluationHandlersDeps {
+    pageController: PageController;
+    detailedDataManager: DetailedDataManager;
+    getActiveDriver: () => 'chrome' | 'camoufox';
+    getCamoufoxPage: () => Promise<unknown>;
+}
+export declare class PageEvaluationHandlers {
+    private deps;
+    constructor(deps: PageEvaluationHandlersDeps);
+    handlePageEvaluate(args: Record<string, unknown>): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+    handlePageScreenshot(args: Record<string, unknown>): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+    handlePageInjectScript(args: Record<string, unknown>): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+    handlePageWaitForSelector(args: Record<string, unknown>): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+}
+export {};
+//# sourceMappingURL=page-evaluation.d.ts.map

package/dist/server/domains/browser/handlers/page-evaluation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-evaluation.d.ts","sourceRoot":"","sources":["../../../../../src/server/domains/browser/handlers/page-evaluation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAsBtE,UAAU,0BAA0B;IAClC,cAAc,EAAE,cAAc,CAAC;IAC/B,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,eAAe,EAAE,MAAM,QAAQ,GAAG,UAAU,CAAC;IAC7C,eAAe,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CACzC;AAgDD,qBAAa,sBAAsB;IACrB,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,0BAA0B;IAE9C,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;IA8DhD,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;IAiGlD,sBAAsB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;IAsBpD,yBAAyB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;CAe9D"}

package/dist/server/domains/browser/handlers/page-evaluation.js

@@ -0,0 +1,205 @@
+import { resolveScreenshotOutputPath } from '../../../../utils/outputPaths.js';
+function filterFields(value, fields) {
+    if (Array.isArray(value)) {
+        return value.map((item) => filterFields(item, fields));
+    }
+    if (value !== null && typeof value === 'object') {
+        const obj = value;
+        const out = {};
+        for (const [k, v] of Object.entries(obj)) {
+            if (!fields.has(k)) {
+                out[k] = filterFields(v, fields);
+            }
+        }
+        return out;
+    }
+    return value;
+}
+function stripBase64Values(value) {
+    if (typeof value === 'string') {
+        if (/^data:[a-z+\-]+\/[a-z+\-]+;base64,/i.test(value)) {
+            return `[base64 ~${Math.round(value.length / 1024)}KB stripped]`;
+        }
+        if (value.length > 500 && /^[A-Za-z0-9+/=\r\n]+$/.test(value.replace(/\s/g, ''))) {
+            return `[base64 ~${value.length}chars stripped]`;
+        }
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => stripBase64Values(item));
+    }
+    if (value !== null && typeof value === 'object') {
+        const obj = value;
+        const out = {};
+        for (const [k, v] of Object.entries(obj)) {
+            out[k] = stripBase64Values(v);
+        }
+        return out;
+    }
+    return value;
+}
+export class PageEvaluationHandlers {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async handlePageEvaluate(args) {
+        const code = (args.script ?? args.code);
+        const autoSummarize = args.autoSummarize ?? true;
+        const maxSize = args.maxSize ?? 51200;
+        const fieldFilterArg = args.fieldFilter;
+        const doStripBase64 = args.stripBase64 ?? false;
+        const applyPostFilters = (raw) => {
+            let out = raw;
+            if (fieldFilterArg && fieldFilterArg.length > 0) {
+                out = filterFields(out, new Set(fieldFilterArg));
+            }
+            if (doStripBase64) {
+                out = stripBase64Values(out);
+            }
+            return out;
+        };
+        if (this.deps.getActiveDriver() === 'camoufox') {
+            const page = (await this.deps.getCamoufoxPage());
+            const evaluateExpression = new Function(`return (${code})`);
+            const result = await page.evaluate(evaluateExpression);
+            const processedResult = applyPostFilters(autoSummarize ? this.deps.detailedDataManager.smartHandle(result, maxSize) : result);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({ success: true, driver: 'camoufox', result: processedResult }, null, 2),
+                    },
+                ],
+            };
+        }
+        const result = await this.deps.pageController.evaluate(code);
+        const processedResult = applyPostFilters(autoSummarize ? this.deps.detailedDataManager.smartHandle(result, maxSize) : result);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        result: processedResult,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    async handlePageScreenshot(args) {
+        const requestedPath = args.path;
+        const type = (args.type || 'png');
+        const quality = args.quality;
+        const fullPage = args.fullPage;
+        const selectorRaw = typeof args.selector === 'string' ? args.selector.trim() : '';
+        const selector = selectorRaw.length > 0 && selectorRaw.toLowerCase() !== 'all' ? selectorRaw : '';
+        const { absolutePath, displayPath, pathRewritten } = await resolveScreenshotOutputPath({
+            requestedPath,
+            type,
+            fallbackName: selector ? 'element' : 'page',
+            fallbackDir: 'screenshots/manual',
+        });
+        if (this.deps.getActiveDriver() === 'camoufox') {
+            const page = (await this.deps.getCamoufoxPage());
+            let buffer;
+            if (selector) {
+                const element = await page.$(selector);
+                if (!element) {
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: JSON.stringify({ success: false, error: `Element not found: ${selector}` }, null, 2),
+                            }],
+                    };
+                }
+                buffer = await element.screenshot({ path: absolutePath, type, quality });
+            }
+            else {
+                buffer = await page.screenshot({ path: absolutePath, type, quality, fullPage });
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: true,
+                            driver: 'camoufox',
+                            selector: selector || undefined,
+                            message: `Screenshot taken: ${displayPath}`,
+                            path: displayPath,
+                            pathRewritten,
+                            size: buffer?.length ?? 0,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        let buffer;
+        if (selector) {
+            const page = await this.deps.pageController.getPage();
+            const element = await page.$(selector);
+            if (!element) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({ success: false, error: `Element not found: ${selector}` }, null, 2),
+                        }],
+                };
+            }
+            buffer = (await element.screenshot({ path: absolutePath, type, quality }));
+        }
+        else {
+            buffer = await this.deps.pageController.screenshot({
+                path: absolutePath,
+                type,
+                quality,
+                fullPage,
+            });
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        selector: selector || undefined,
+                        message: `Screenshot taken: ${displayPath}`,
+                        path: displayPath,
+                        pathRewritten,
+                        size: buffer.length,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    async handlePageInjectScript(args) {
+        const script = args.script;
+        await this.deps.pageController.injectScript(script);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        message: 'Script injected',
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    async handlePageWaitForSelector(args) {
+        const selector = args.selector;
+        const timeout = args.timeout;
+        const result = await this.deps.pageController.waitForSelector(selector, timeout);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    }
+}
+//# sourceMappingURL=page-evaluation.js.map