@monoes/monobrowse 1.0.13 → 1.0.14

package/dist/src/cli/commands-trace.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Recording what the page does — network interception and capture, HAR export,
+ * video recording, DevTools traces, CPU profiles and Web Vitals.
+ */
+import type { Command } from './types.js';
+export declare const networkCommand: Command;
+export declare const recordCommand: Command;
+export declare const traceCommand: Command;
+export declare const profilerCommand: Command;
+export declare const vitalsCommand: Command;
+export declare const harCommand: Command;
+//# sourceMappingURL=commands-trace.d.ts.map

package/dist/src/cli/commands-trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands-trace.d.ts","sourceRoot":"","sources":["../../../src/cli/commands-trace.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAiC,MAAM,YAAY,CAAC;AAEzE,eAAO,MAAM,cAAc,EAAE,OA6I5B,CAAC;AAQF,eAAO,MAAM,aAAa,EAAE,OAuD3B,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,OAiC1B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,OAoC7B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,OAkB3B,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,OAuCxB,CAAC"}

package/dist/src/cli/commands-trace.js

@@ -0,0 +1,347 @@
+/**
+ * Recording what the page does — network interception and capture, HAR export,
+ * video recording, DevTools traces, CPU profiles and Web Vitals.
+ */
+import { output } from './output.js';
+import { ensureConnected, getBrowser, imageFormat, print, session } from './session.js';
+export const networkCommand = {
+    name: 'network',
+    description: 'Network interception and cookie management',
+    options: [
+        { name: 'pattern', type: 'string', description: 'URL pattern for route (glob)' },
+        { name: 'abort', type: 'boolean', description: 'Abort matching requests' },
+        { name: 'fulfill', type: 'string', description: 'JSON response body' },
+        { name: 'status', type: 'number', description: 'HTTP status for fulfill', default: 200 },
+        { name: 'headers', type: 'string', description: 'JSON headers object' },
+        { name: 'json', type: 'boolean', description: 'Output as JSON', default: false },
+        {
+            name: 'filter',
+            type: 'string',
+            description: 'Filter requests by URL substring (for network requests)',
+        },
+        {
+            name: 'method',
+            type: 'string',
+            description: 'Filter by HTTP method, e.g. GET, POST (for network requests)',
+        },
+        {
+            name: 'status-code',
+            type: 'number',
+            description: 'Filter by HTTP status code (for network requests)',
+        },
+        {
+            name: 'type',
+            type: 'string',
+            description: 'Filter by resource type: xhr|fetch|document|script|stylesheet|image (for network requests)',
+        },
+    ],
+    action: async (ctx) => {
+        const { client, sessionId } = await ensureConnected(session.port);
+        const browser = await getBrowser();
+        const action = ctx.args[0];
+        if (!action)
+            throw new Error('Usage: monomind browse network route|unroute|cookies|headers|requests');
+        switch (action) {
+            case 'route': {
+                const pattern = ctx.flags.pattern;
+                if (!pattern)
+                    throw new Error('--pattern required for network route');
+                const routes = [
+                    {
+                        pattern,
+                        action: ctx.flags.abort ? 'abort' : ctx.flags.fulfill ? 'fulfill' : 'continue',
+                        response: ctx.flags.fulfill
+                            ? {
+                                status: ctx.flags.status,
+                                body: ctx.flags.fulfill,
+                                headers: ctx.flags.headers ? JSON.parse(ctx.flags.headers) : {},
+                            }
+                            : undefined,
+                    },
+                ];
+                await browser.setupRoutes(client, sessionId, routes);
+                output.printSuccess(`Network route set: ${pattern}`);
+                break;
+            }
+            case 'unroute':
+                await browser.disableInterception(client, sessionId);
+                output.printSuccess('Network interception disabled');
+                break;
+            case 'cookies': {
+                const cookies = await browser.getCookies(client, sessionId);
+                print(JSON.stringify(cookies, null, 2));
+                return { success: true, data: { cookies } };
+            }
+            case 'headers': {
+                const headers = ctx.flags.headers;
+                if (!headers)
+                    throw new Error('--headers required (JSON string)');
+                await browser.setExtraHeaders(client, sessionId, JSON.parse(headers));
+                output.printSuccess('Extra headers set');
+                break;
+            }
+            case 'capture': {
+                const subAction = ctx.args[1] ?? 'start';
+                if (subAction === 'start') {
+                    browser.startRequestCapture(client, sessionId);
+                    output.printSuccess('Request capture started');
+                }
+                else if (subAction === 'stop') {
+                    browser.stopRequestCapture(sessionId);
+                    output.printSuccess('Request capture stopped');
+                }
+                else if (subAction === 'clear') {
+                    browser.clearCapturedRequests(sessionId);
+                    output.printSuccess('Captured requests cleared');
+                }
+                break;
+            }
+            case 'requests': {
+                let reqs = browser.getCapturedRequests(sessionId);
+                const filterUrl = ctx.flags.filter;
+                const filterMethod = ctx.flags.method;
+                const filterStatus = ctx.flags['status-code'];
+                const filterType = ctx.flags.type;
+                if (filterUrl)
+                    reqs = reqs.filter((r) => r.url.includes(filterUrl));
+                if (filterMethod)
+                    reqs = reqs.filter((r) => (r.method ?? 'GET').toUpperCase() === filterMethod.toUpperCase());
+                if (filterStatus)
+                    reqs = reqs.filter((r) => r.status === filterStatus);
+                if (filterType)
+                    reqs = reqs.filter((r) => r.resourceType === filterType ||
+                        r.type === filterType);
+                if (ctx.flags.json)
+                    print(JSON.stringify({ data: reqs }));
+                else {
+                    if (reqs.length === 0) {
+                        output.printInfo('No captured requests. Run: network capture start');
+                    }
+                    else
+                        for (const r of reqs)
+                            print(`  ${r.method ?? 'GET'} ${r.status ?? '-'} ${r.url}`);
+                }
+                return { success: true, data: { requests: reqs } };
+            }
+            case 'request': {
+                const reqId = ctx.args[1];
+                if (!reqId)
+                    throw new Error('Usage: monomind browse network request <requestId>');
+                const reqs = browser.getCapturedRequests(sessionId);
+                const req = reqs.find((r) => r.requestId === reqId ||
+                    r.id === reqId);
+                if (!req) {
+                    output.printWarning(`Request not found: ${reqId}`);
+                    return { success: false };
+                }
+                if (ctx.flags.json)
+                    print(JSON.stringify({ data: req }));
+                else
+                    print(JSON.stringify(req, null, 2));
+                return { success: true, data: { request: req } };
+            }
+            default:
+                throw new Error(`Unknown: ${action}. Use: route|unroute|cookies|headers|capture|requests|request`);
+        }
+        return { success: true };
+    },
+};
+// Default output cap for eval when --max-output isn't passed explicitly —
+// print(String(result)) had NO limit at all (unlike snapshot's --max-output),
+// so e.g. `eval "document.documentElement.outerHTML"` could dump megabytes
+// straight into an agent's context. An explicit --max-output still overrides
+// this default.
+export const recordCommand = {
+    name: 'record',
+    description: 'Screen recording. Usage: monomind browse record start|stop|restart|status [path]',
+    options: [
+        { name: 'format', type: 'string', description: 'jpeg|png', default: 'jpeg' },
+        { name: 'quality', type: 'number', description: 'Quality 0-100', default: 80 },
+        { name: 'json', type: 'boolean', description: 'Output as JSON', default: false },
+    ],
+    action: async (ctx) => {
+        const { client, sessionId } = await ensureConnected(session.port);
+        const browser = await getBrowser();
+        const action = ctx.args[0];
+        if (!action)
+            throw new Error('Usage: monomind browse record start|stop|restart|status');
+        switch (action) {
+            case 'start':
+                await browser.startRecording(client, sessionId, {
+                    format: imageFormat(ctx.flags.format, ['jpeg', 'png'], 'jpeg'),
+                    quality: ctx.flags.quality,
+                });
+                output.printSuccess('Recording started');
+                return { success: true };
+            case 'stop': {
+                const path = await browser.stopRecording(client, sessionId, ctx.args[1]);
+                if (ctx.flags.json)
+                    print(JSON.stringify({ data: { path } }));
+                else
+                    output.printSuccess(`Recording saved: ${path}`);
+                return { success: true, data: { path } };
+            }
+            case 'restart': {
+                const prevStatus = browser.getRecordingStatus(sessionId);
+                let prevPath;
+                if (prevStatus.recording || prevStatus.autoStopped) {
+                    prevPath = await browser.stopRecording(client, sessionId, ctx.args[1]);
+                    output.printInfo(`Previous recording saved: ${prevPath}`);
+                }
+                await browser.startRecording(client, sessionId, {
+                    format: imageFormat(ctx.flags.format, ['jpeg', 'png'], 'jpeg'),
+                    quality: ctx.flags.quality,
+                });
+                output.printSuccess('Recording restarted');
+                return { success: true, data: { previous: prevPath } };
+            }
+            case 'status': {
+                const status = browser.getRecordingStatus(sessionId);
+                if (ctx.flags.json)
+                    print(JSON.stringify({ data: status }));
+                else
+                    print(`Recording: ${status.recording} | Frames: ${status.frames}${status.autoStopped ? ' (auto-stopped: buffer limit reached — run "record stop" to save)' : ''}`);
+                return { success: true, data: status };
+            }
+            default:
+                throw new Error('Usage: monomind browse record start|stop|restart|status [path]');
+        }
+    },
+};
+export const traceCommand = {
+    name: 'trace',
+    description: 'CDP performance trace. Usage: monomind browse trace start|stop [path]',
+    options: [
+        { name: 'screenshots', type: 'boolean', description: 'Include screenshots', default: false },
+        { name: 'json', type: 'boolean', description: 'Output as JSON', default: false },
+    ],
+    action: async (ctx) => {
+        const { client, sessionId } = await ensureConnected(session.port);
+        const browser = await getBrowser();
+        const action = ctx.args[0];
+        if (!action)
+            throw new Error('Usage: monomind browse trace start|stop [path]');
+        switch (action) {
+            case 'start':
+                await browser.startTrace(client, sessionId, {
+                    screenshots: ctx.flags.screenshots,
+                });
+                output.printSuccess('Trace started');
+                return { success: true };
+            case 'stop': {
+                const path = await browser.stopTrace(client, sessionId, ctx.args[1]);
+                if (ctx.flags.json)
+                    print(JSON.stringify({ data: { path } }));
+                else
+                    output.printSuccess(`Trace saved: ${path}`);
+                return { success: true, data: { path } };
+            }
+            case 'status':
+                print(browser.getTraceStatus(sessionId) ? 'Tracing active' : 'Not tracing');
+                return { success: true };
+            default:
+                throw new Error('Usage: monomind browse trace start|stop|status [path]');
+        }
+    },
+};
+export const profilerCommand = {
+    name: 'profiler',
+    description: 'CPU profiler. Usage: monomind browse profiler start|stop|heap [path]',
+    options: [
+        { name: 'interval', type: 'number', description: 'Sampling interval µs', default: 1000 },
+        { name: 'json', type: 'boolean', description: 'Output as JSON', default: false },
+    ],
+    action: async (ctx) => {
+        const { client, sessionId } = await ensureConnected(session.port);
+        const browser = await getBrowser();
+        const action = ctx.args[0];
+        if (!action)
+            throw new Error('Usage: monomind browse profiler start|stop|heap [path]');
+        switch (action) {
+            case 'start':
+                await browser.startCpuProfile(client, sessionId, {
+                    samplingInterval: ctx.flags.interval,
+                });
+                output.printSuccess('CPU profiler started');
+                return { success: true };
+            case 'stop': {
+                const path = await browser.stopCpuProfile(client, sessionId, ctx.args[1]);
+                if (ctx.flags.json)
+                    print(JSON.stringify({ data: { path } }));
+                else
+                    output.printSuccess(`Profile saved: ${path}`);
+                return { success: true, data: { path } };
+            }
+            case 'heap': {
+                const path = await browser.startHeapSnapshot(client, sessionId, ctx.args[1]);
+                if (ctx.flags.json)
+                    print(JSON.stringify({ data: { path } }));
+                else
+                    output.printSuccess(`Heap snapshot saved: ${path}`);
+                return { success: true, data: { path } };
+            }
+            default:
+                throw new Error('Usage: monomind browse profiler start|stop|heap [path]');
+        }
+    },
+};
+export const vitalsCommand = {
+    name: 'vitals',
+    description: 'Collect Core Web Vitals. Usage: monomind browse vitals [--wait 2000]',
+    options: [
+        { name: 'wait', type: 'number', description: 'Wait ms for observers', default: 2000 },
+        { name: 'json', type: 'boolean', description: 'Output as JSON', default: false },
+    ],
+    action: async (ctx) => {
+        const { client, sessionId } = await ensureConnected(session.port);
+        const browser = await getBrowser();
+        const vitals = await browser.collectVitals(client, sessionId, ctx.flags.wait);
+        if (ctx.flags.json) {
+            print(JSON.stringify({ data: vitals }));
+        }
+        else {
+            print(browser.formatVitals(vitals));
+        }
+        return { success: true, data: vitals };
+    },
+};
+export const harCommand = {
+    name: 'har',
+    description: 'HAR network recording. Usage: monomind browse har start|stop|status [path]',
+    options: [
+        { name: 'bodies', type: 'boolean', description: 'Capture response bodies', default: false },
+        { name: 'json', type: 'boolean', description: 'Output as JSON', default: false },
+    ],
+    action: async (ctx) => {
+        const { client, sessionId } = await ensureConnected(session.port);
+        const browser = await getBrowser();
+        const action = ctx.args[0];
+        if (!action)
+            throw new Error('Usage: monomind browse har start|stop|status [path]');
+        switch (action) {
+            case 'start':
+                await browser.startHarRecording(client, sessionId);
+                output.printSuccess('HAR recording started');
+                return { success: true };
+            case 'stop': {
+                const path = await browser.stopHarRecording(client, sessionId, ctx.args[1], ctx.flags.bodies);
+                if (ctx.flags.json)
+                    print(JSON.stringify({ data: { path } }));
+                else
+                    output.printSuccess(`HAR saved: ${path}`);
+                return { success: true, data: { path } };
+            }
+            case 'status': {
+                const status = browser.getHarStatus(sessionId);
+                if (ctx.flags.json)
+                    print(JSON.stringify({ data: status }));
+                else
+                    print(`Recording: ${status.recording} | Requests: ${status.requestCount}`);
+                return { success: true, data: status };
+            }
+            default:
+                throw new Error('Usage: monomind browse har start|stop|status [path]');
+        }
+    },
+};
+//# sourceMappingURL=commands-trace.js.map

package/dist/src/cli/commands-trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands-trace.js","sourceRoot":"","sources":["../../../src/cli/commands-trace.ts"],"names":[],"mappings":"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"}

package/dist/src/cli/commands.d.ts

@@ -1,51 +1,31 @@
 /**
  * Browse Command — Native browser automation via Chrome DevTools Protocol
  * Provides ref-based element model and token-efficient accessibility snapshots
- */
-import type { Command } from './types.js';
-/**
- * Splits one line of a `batch` command string into a subcommand name, its
- * args, and any recognized leading flags.
  *
- * `eval` is special-cased: its sole argument is a raw JS expression, which
- * legitimately contains its own string-literal quotes (e.g.
- * `eval document.querySelector('a')`). tokenizeBatchCommand's shell-style
- * word-splitting treats `'...'`/`"..."` as grouping delimiters and discards
- * them — correct for a value like `fill @e1 "some text"`, but for `eval` it
- * silently deletes the expression's own quotes, turning a string literal
- * into a bare (undefined) identifier reference and producing a
- * ReferenceError instead of evaluating the intended expression. For `eval`,
- * only its own known --flags are consumed from the front; everything after
- * them is taken verbatim as one argument, untouched by tokenization.
+ * This file is the command CATALOGUE: it assembles the `browse` root command
+ * from the subcommand modules beside it and stays the single import point for
+ * the package. The subcommands themselves are grouped by what the user is
+ * doing:
  *
-/**
- * `get box`'s output shape: browser.getElementBox() returns the element's
- * CENTER point under x/y (correct for internal click-target callers), but
- * `get box` is a bounding-box accessor where x/y conventionally means the
- * top-left origin — a caller computing its own center as `box.x + width/2`
- * would otherwise double-offset away from the element (issue #15). Expose
- * both conventions, explicitly labeled, so neither is ambiguous.
- *
- * Exported for direct unit testing — not part of the CLI's public API.
+ *  - `session.ts`            the live CDP session every subcommand acts on,
+ *                            plus the shared flag/output helpers.
+ *  - `commands-session.ts`   open / connect / close / resize.
+ *  - `commands-context.ts`   frame / tab / window / state.
+ *  - `commands-page.ts`      snapshot / get / diff.
+ *  - `commands-navigate.ts`  wait / scroll / navigate / set / pushstate.
+ *  - `commands-input.ts`     mouse, keyboard, touch and drag input.
+ *  - `commands-element.ts`   find / is / isvisible / isenabled / ischecked /
+ *                            highlight.
+ *  - `commands-files.ts`     screenshot / pdf / upload / download.
+ *  - `commands-data.ts`      storage / cookies / clipboard / dialog /
+ *                            console / errors.
+ *  - `commands-trace.ts`     network / record / trace / profiler / vitals / har.
+ *  - `commands-script.ts`    eval / batch / init scripts.
+ *  - `commands-report.ts`    the one-command page report.
  */
-export declare function deriveBoxOutput(center: {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-} | null): {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-    centerX: number;
-    centerY: number;
-} | null;
-export declare function parseBatchCommandLine(cmdStr: string): {
-    subName: string;
-    subArgs: string[];
-    flags: Record<string, unknown>;
-};
+import type { Command } from './types.js';
+export { deriveBoxOutput } from './commands-page.js';
+export { parseBatchCommandLine } from './commands-script.js';
 declare const browseCommand: Command;
 export default browseCommand;
 //# sourceMappingURL=commands.d.ts.map

package/dist/src/cli/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../src/cli/commands.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAiC,MAAM,YAAY,CAAC;AA+4GzE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GACrE;IACD,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,IAAI,CAUP;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CA4BA;AA4fD,QAAA,MAAM,aAAa,EAAE,OA+JpB,CAAC;eAEa,aAAa"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../src/cli/commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAoEH,OAAO,KAAK,EAAE,OAAO,EAAiC,MAAM,YAAY,CAAC;AAIzE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAyH7D,QAAA,MAAM,aAAa,EAAE,OA+JpB,CAAC;eAEa,aAAa"}