@monoes/monomindcli 2.13.0 → 2.14.1

package/dist/src/mcp-tools/browser-instrument-tools.js

@@ -0,0 +1,359 @@
+/**
+ * Browser instrument tools: console output and network / HAR capture.
+ *
+ * monobrowse captures all of this already — these tools are the part an MCP
+ * client can reach. Output is shaped for an agent that has to decide what to
+ * do next: counts first, worst offenders first, long lists capped with an
+ * explicit note about what was dropped.
+ *
+ * Registered from `browser-tools.ts`; shared plumbing lives in
+ * `browser-session.ts`, and the performance/emulation half in
+ * `browser-profile-tools.ts`.
+ */
+import { fail, getConnection, ok, rejectFlagLike, resolveArtifactPath, touchSession, validateSessionId, } from './browser-session.js';
+/** Longest console message text returned before it is elided. */
+const MAX_MESSAGE_CHARS = 400;
+const DEFAULT_LIMIT = 50;
+const MAX_LIMIT = 500;
+export function clampLimit(value, fallback = DEFAULT_LIMIT) {
+    const n = Number(value ?? fallback);
+    if (!Number.isFinite(n) || n <= 0)
+        return fallback;
+    return Math.min(Math.floor(n), MAX_LIMIT);
+}
+function elide(text) {
+    return text.length > MAX_MESSAGE_CHARS
+        ? `${text.slice(0, MAX_MESSAGE_CHARS)}… (${text.length - MAX_MESSAGE_CHARS} more chars)`
+        : text;
+}
+const EXTENSION_TYPES = [
+    [/\.(js|mjs|cjs)$/, 'script'],
+    [/\.css$/, 'stylesheet'],
+    [/\.(png|jpe?g|gif|svg|webp|avif|ico|bmp)$/, 'image'],
+    [/\.(woff2?|ttf|otf|eot)$/, 'font'],
+    [/\.(mp4|webm|ogg|mp3|wav|m4a)$/, 'media'],
+    [/\.json$/, 'xhr'],
+    [/\.(html?|php)$/, 'document'],
+];
+/** Best-effort resource type — Chrome's capture records a MIME type, not a type. */
+export function resourceType(url, mimeType) {
+    const m = (mimeType ?? '').toLowerCase();
+    if (m.startsWith('image/'))
+        return 'image';
+    if (m.startsWith('font/') || m.includes('font'))
+        return 'font';
+    if (m.startsWith('video/') || m.startsWith('audio/'))
+        return 'media';
+    if (m.includes('html'))
+        return 'document';
+    if (m.includes('css'))
+        return 'stylesheet';
+    if (m.includes('javascript') || m.includes('ecmascript'))
+        return 'script';
+    if (m.includes('json') || m.includes('xml') || m.includes('x-www-form'))
+        return 'xhr';
+    let pathname = url;
+    try {
+        pathname = new URL(url).pathname;
+    }
+    catch {
+        /* relative or data: URL — match against the raw string */
+    }
+    for (const [re, type] of EXTENSION_TYPES)
+        if (re.test(pathname.toLowerCase()))
+            return type;
+    return 'other';
+}
+function normalizeRequest(r) {
+    const url = r.url ?? '';
+    const duration = r.startTime !== undefined && r.endTime !== undefined
+        ? Math.max(0, Math.round(r.endTime - r.startTime))
+        : undefined;
+    let outcome;
+    if (r.status === undefined)
+        outcome = r.endTime === undefined ? 'pending' : 'no-response';
+    else
+        outcome = r.status >= 400 ? 'http-error' : 'ok';
+    return {
+        url,
+        method: (r.method ?? 'GET').toUpperCase(),
+        status: r.status,
+        type: resourceType(url, r.mimeType),
+        durationMs: duration,
+        sizeBytes: r.encodedSize,
+        outcome,
+    };
+}
+function isFailure(r) {
+    return r.outcome === 'http-error' || r.outcome === 'no-response';
+}
+/** Glob → RegExp, matching the semantics monobrowse uses for route patterns. */
+export function globToRegex(pattern) {
+    const escaped = pattern
+        .replace(/[-[\]{}()+.,\\^$|#\s]/g, '\\$&')
+        .replace(/\*\*/g, '\x00')
+        .replace(/\*/g, '[^/]*')
+        .replace(/\x00/g, '.*')
+        .replace(/\?/g, '[^/]');
+    return new RegExp(`^${escaped}$`);
+}
+/**
+ * Every request monobrowse holds for this CDP session: the live request
+ * capture plus anything the HAR recorder has buffered, deduped by id.
+ */
+export async function collectRequests(cdpSessionId) {
+    const { getCapturedRequests, getRequests } = await import('@monoes/monobrowse');
+    const byKey = new Map();
+    for (const r of getRequests(cdpSessionId))
+        byKey.set(r.id ?? `${r.method}|${r.url}`, r);
+    for (const r of getCapturedRequests(cdpSessionId))
+        byKey.set(r.id ?? `${r.method}|${r.url}`, r);
+    return [...byKey.values()].map(normalizeRequest);
+}
+// ---------------------------------------------------------------------------
+// Tools
+// ---------------------------------------------------------------------------
+export const browserInstrumentTools = [
+    {
+        name: 'browser_console',
+        description: 'Read console output and uncaught page errors for a browser session — reach for this FIRST when a page misbehaves, before screenshotting or guessing. Capture is armed when the session connects (browser_open), so errors thrown during page load are included. Errors are listed before warnings before logs; filter with level, cap with limit, or clear the buffer to isolate the next interaction.',
+        category: 'browser',
+        tags: ['console', 'errors', 'debug'],
+        inputSchema: {
+            type: 'object',
+            properties: {
+                level: {
+                    type: 'string',
+                    enum: ['error', 'warning', 'all'],
+                    description: 'error = errors only; warning = warnings and errors; all = everything (default)',
+                },
+                limit: { type: 'number', description: `Max messages to return (default ${DEFAULT_LIMIT})` },
+                clear: {
+                    type: 'boolean',
+                    description: 'Clear the buffers after reporting, so the next call shows only new output',
+                },
+                session: { type: 'string', description: 'Session ID' },
+            },
+        },
+        handler: async (input) => {
+            const raw = input;
+            let sessionId;
+            try {
+                sessionId = validateSessionId(raw.session);
+            }
+            catch (e) {
+                return fail(e.message);
+            }
+            const level = typeof raw.level === 'string' ? raw.level : 'all';
+            if (!['error', 'warning', 'all'].includes(level))
+                return fail('level: must be one of error|warning|all');
+            const limit = clampLimit(raw.limit);
+            try {
+                const { enableConsoleCapture, getConsoleMessages, getPageErrors, clearConsoleMessages, clearPageErrors, } = await import('@monoes/monobrowse');
+                const conn = await getConnection(sessionId);
+                // Idempotent: re-assert the domains in case the target dropped them.
+                // Never calls setupConsoleCapture — that resets the buffer, which
+                // would throw away exactly the load-time errors we are here for.
+                try {
+                    await enableConsoleCapture(conn.client, conn.cdpSessionId);
+                }
+                catch {
+                    /* best-effort */
+                }
+                const messages = getConsoleMessages(conn.cdpSessionId);
+                const pageErrors = getPageErrors(conn.cdpSessionId);
+                const counts = {
+                    error: messages.filter((m) => m.type === 'error').length,
+                    warning: messages.filter((m) => m.type === 'warn').length,
+                    other: messages.filter((m) => m.type !== 'error' && m.type !== 'warn').length,
+                    pageErrors: pageErrors.length,
+                    total: messages.length + pageErrors.length,
+                };
+                const allowed = level === 'error'
+                    ? new Set(['error'])
+                    : level === 'warning'
+                        ? new Set(['error', 'warn'])
+                        : null;
+                const filtered = allowed ? messages.filter((m) => allowed.has(m.type)) : messages;
+                const severity = (t) => (t === 'error' ? 0 : t === 'warn' ? 1 : 2);
+                const ordered = [...filtered].sort((a, b) => severity(a.type) - severity(b.type) || a.timestamp - b.timestamp);
+                const shown = ordered.slice(0, limit);
+                if (raw.clear === true) {
+                    clearConsoleMessages(conn.cdpSessionId);
+                    clearPageErrors(conn.cdpSessionId);
+                }
+                touchSession(sessionId);
+                return ok({
+                    session: sessionId,
+                    // Buffers are armed when the CDP connection opens and keyed to it,
+                    // so this is the true start of the window the output covers.
+                    capturedSince: conn.openedAt,
+                    counts,
+                    pageErrors: pageErrors.slice(0, limit).map((e) => ({
+                        text: elide(e.text),
+                        url: e.url,
+                        line: e.lineNumber,
+                    })),
+                    messages: shown.map((m) => ({
+                        type: m.type,
+                        text: elide(m.text),
+                        url: m.url,
+                        line: m.lineNumber,
+                    })),
+                    truncated: ordered.length - shown.length,
+                    cleared: raw.clear === true,
+                });
+            }
+            catch (e) {
+                return fail(e.message);
+            }
+        },
+    },
+    {
+        name: 'browser_network',
+        description: 'Inspect the network traffic of a browser session: method, URL, status, type, duration and size, failures first. Call with action:"start" before the page load you care about (capture is off until then), then reload and list. Use failedOnly to see just broken requests, or action:"har" to write a .har file for a full trace. Reach for this when a page loads blank, data is missing, or something is slow.',
+        category: 'browser',
+        tags: ['network', 'har', 'debug'],
+        inputSchema: {
+            type: 'object',
+            properties: {
+                action: {
+                    type: 'string',
+                    enum: ['start', 'list', 'stop', 'har'],
+                    description: 'start = begin capturing; list = report what was captured (default); stop = stop capturing; har = write a .har file and stop',
+                },
+                failedOnly: {
+                    type: 'boolean',
+                    description: 'Only requests that failed (status >= 400 or no response)',
+                },
+                method: { type: 'string', description: 'Filter by HTTP method (GET, POST, …)' },
+                type: {
+                    type: 'string',
+                    description: 'Filter by resource type: document|script|stylesheet|image|font|xhr|media|other',
+                },
+                url: {
+                    type: 'string',
+                    description: 'Filter by URL glob, e.g. "https://api.example.com/**"',
+                },
+                limit: { type: 'number', description: `Max requests to return (default ${DEFAULT_LIMIT})` },
+                path: {
+                    type: 'string',
+                    description: 'HAR output file, relative to .monomind/network/ (action:"har" only)',
+                },
+                session: { type: 'string', description: 'Session ID' },
+            },
+        },
+        handler: async (input) => {
+            const raw = input;
+            let sessionId;
+            try {
+                sessionId = validateSessionId(raw.session);
+            }
+            catch (e) {
+                return fail(e.message);
+            }
+            const action = typeof raw.action === 'string' ? raw.action : 'list';
+            if (!['start', 'list', 'stop', 'har'].includes(action))
+                return fail('action: must be one of start|list|stop|har');
+            const limit = clampLimit(raw.limit);
+            try {
+                const { startRequestCapture, stopRequestCapture, startHarRecording, stopHarRecording, getHarStatus, getRequests, } = await import('@monoes/monobrowse');
+                const conn = await getConnection(sessionId);
+                const sid = conn.cdpSessionId;
+                touchSession(sessionId);
+                if (action === 'start') {
+                    startRequestCapture(conn.client, sid);
+                    // HAR recording rides along so action:"har" can export later without
+                    // a second arming step; both are stopped together.
+                    try {
+                        await startHarRecording(conn.client, sid);
+                    }
+                    catch (e) {
+                        if (!/already in progress/i.test(e.message))
+                            throw e;
+                    }
+                    return ok({
+                        session: sessionId,
+                        recording: true,
+                        note: 'Capture is live. Reload the page (browser_reload) so its requests are recorded, then call browser_network again.',
+                    });
+                }
+                if (action === 'stop' || action === 'har') {
+                    const harActive = getHarStatus(sid).recording;
+                    if (action === 'har' && !harActive) {
+                        return fail('No HAR recording for this session. Call browser_network with action:"start", reload the page, then export.');
+                    }
+                    const entries = harActive ? getRequests(sid).length : 0;
+                    let harPath;
+                    if (harActive) {
+                        const outPath = await resolveArtifactPath('network', raw.path, `session-${Date.now()}.har`);
+                        harPath = await stopHarRecording(conn.client, sid, outPath);
+                    }
+                    stopRequestCapture(sid);
+                    return ok({
+                        session: sessionId,
+                        recording: false,
+                        path: harPath,
+                        entries,
+                        note: harPath
+                            ? 'HAR written; capture stopped and the in-memory request list was released. Call action:"start" again to record more.'
+                            : 'Capture stopped.',
+                    });
+                }
+                // action === 'list'
+                const recording = getHarStatus(sid).recording;
+                let requests = await collectRequests(sid);
+                const total = requests.length;
+                const failed = requests.filter(isFailure).length;
+                const byType = {};
+                for (const r of requests)
+                    byType[r.type] = (byType[r.type] ?? 0) + 1;
+                if (raw.failedOnly === true)
+                    requests = requests.filter(isFailure);
+                if (raw.method !== undefined) {
+                    const want = rejectFlagLike(raw.method, 'method').toUpperCase();
+                    requests = requests.filter((r) => r.method === want);
+                }
+                if (raw.type !== undefined) {
+                    const want = rejectFlagLike(raw.type, 'type').toLowerCase();
+                    requests = requests.filter((r) => r.type === want);
+                }
+                if (raw.url !== undefined) {
+                    const re = globToRegex(rejectFlagLike(raw.url, 'url'));
+                    requests = requests.filter((r) => re.test(r.url));
+                }
+                // Worst offenders first: failures, then the slowest.
+                const ordered = [...requests].sort((a, b) => Number(isFailure(b)) - Number(isFailure(a)) ||
+                    (b.durationMs ?? 0) - (a.durationMs ?? 0));
+                const shown = ordered.slice(0, limit);
+                const withSize = requests.filter((r) => r.sizeBytes !== undefined);
+                return ok({
+                    session: sessionId,
+                    recording,
+                    total,
+                    failed,
+                    matched: requests.length,
+                    byType,
+                    slowest: [...requests]
+                        .sort((a, b) => (b.durationMs ?? 0) - (a.durationMs ?? 0))
+                        .slice(0, 3)
+                        .map((r) => ({ url: r.url, durationMs: r.durationMs })),
+                    largest: withSize
+                        .sort((a, b) => (b.sizeBytes ?? 0) - (a.sizeBytes ?? 0))
+                        .slice(0, 3)
+                        .map((r) => ({ url: r.url, sizeBytes: r.sizeBytes })),
+                    requests: shown,
+                    truncated: ordered.length - shown.length,
+                    note: recording
+                        ? undefined
+                        : 'Network capture is not running for this session — call browser_network with action:"start" and reload the page. An empty list here does not mean the page made no requests.',
+                });
+            }
+            catch (e) {
+                return fail(e.message);
+            }
+        },
+    },
+];
+export default browserInstrumentTools;
+//# sourceMappingURL=browser-instrument-tools.js.map

package/dist/src/mcp-tools/browser-instrument-tools.js.map

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

package/dist/src/mcp-tools/browser-metrics.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Turning raw browser instrument output into a verdict.
+ *
+ * Pure functions only — no CDP, no session, no I/O — so the judgement calls
+ * (what counts as a poor LCP, which function is actually hot) can be read and
+ * tested on their own. Used by the tools in `browser-profile-tools.ts`.
+ */
+export declare function gradeVitals(vitals: Record<string, number | undefined>): {
+    assessment: Record<string, string>;
+    worst: string[];
+};
+interface CpuProfileNode {
+    id: number;
+    callFrame: {
+        functionName?: string;
+        url?: string;
+        lineNumber?: number;
+    };
+    hitCount?: number;
+}
+export interface TopFunction {
+    functionName: string;
+    url?: string;
+    line?: number;
+    selfMs: number;
+    selfPercent: number;
+}
+/**
+ * Self time per function from a V8 .cpuprofile. Sampling profiles record a hit
+ * count per node; self time is that share of the wall-clock window.
+ */
+export declare function summarizeCpuProfile(profile: {
+    nodes?: CpuProfileNode[];
+    startTime?: number;
+    endTime?: number;
+}, top: number): {
+    durationMs: number;
+    totalSamples: number;
+    topFunctions: TopFunction[];
+};
+export {};
+//# sourceMappingURL=browser-metrics.d.ts.map

package/dist/src/mcp-tools/browser-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-metrics.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/browser-metrics.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAuBH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG;IACvE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAkBA;AAMD,UAAU,cAAc;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EAC3E,GAAG,EAAE,MAAM,GACV;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,WAAW,EAAE,CAAA;CAAE,CA2C3E"}

package/dist/src/mcp-tools/browser-metrics.js

@@ -0,0 +1,91 @@
+/**
+ * Turning raw browser instrument output into a verdict.
+ *
+ * Pure functions only — no CDP, no session, no I/O — so the judgement calls
+ * (what counts as a poor LCP, which function is actually hot) can be read and
+ * tested on their own. Used by the tools in `browser-profile-tools.ts`.
+ */
+// ---------------------------------------------------------------------------
+// Vitals grading
+// ---------------------------------------------------------------------------
+/** Core Web Vitals thresholds: [good below, poor at or above, unit]. */
+const VITAL_BUDGETS = {
+    lcp: [2500, 4000, 'ms'],
+    fcp: [1800, 3000, 'ms'],
+    cls: [0.1, 0.25, ''],
+    inp: [200, 500, 'ms'],
+    ttfb: [800, 1800, 'ms'],
+};
+const VITAL_LABELS = {
+    lcp: 'LCP',
+    fcp: 'FCP',
+    cls: 'CLS',
+    inp: 'INP',
+    ttfb: 'TTFB',
+};
+export function gradeVitals(vitals) {
+    const assessment = {};
+    const worst = [];
+    for (const [key, [good, poor, unit]] of Object.entries(VITAL_BUDGETS)) {
+        const value = vitals[key];
+        if (typeof value !== 'number')
+            continue;
+        const grade = value < good ? 'good' : value < poor ? 'needs-improvement' : 'poor';
+        assessment[key] = grade;
+        if (grade === 'good')
+            continue;
+        const shown = unit === 'ms' ? `${Math.round(value)}ms` : value.toFixed(4);
+        // Poor before needs-improvement; within a grade, the biggest overshoot first.
+        worst.push({
+            line: `${VITAL_LABELS[key]} ${shown} — ${grade} (good is under ${good}${unit})`,
+            rank: (grade === 'poor' ? 0 : 1000) + good / Math.max(value, 0.0001),
+        });
+    }
+    worst.sort((a, b) => a.rank - b.rank);
+    return { assessment, worst: worst.map((w) => w.line) };
+}
+/**
+ * Self time per function from a V8 .cpuprofile. Sampling profiles record a hit
+ * count per node; self time is that share of the wall-clock window.
+ */
+export function summarizeCpuProfile(profile, top) {
+    const nodes = profile.nodes ?? [];
+    const durationMs = Math.max(0, Math.round(((profile.endTime ?? 0) - (profile.startTime ?? 0)) / 1000));
+    const totalSamples = nodes.reduce((sum, n) => sum + (n.hitCount ?? 0), 0);
+    if (totalSamples === 0)
+        return { durationMs, totalSamples, topFunctions: [] };
+    const byFrame = new Map();
+    for (const node of nodes) {
+        const hits = node.hitCount ?? 0;
+        if (hits === 0)
+            continue;
+        const frame = node.callFrame ?? {};
+        const name = frame.functionName && frame.functionName.length > 0 ? frame.functionName : '(anonymous)';
+        const key = `${name}|${frame.url ?? ''}|${frame.lineNumber ?? -1}`;
+        const share = hits / totalSamples;
+        const existing = byFrame.get(key);
+        if (existing) {
+            existing.selfMs += share * durationMs;
+            existing.selfPercent += share * 100;
+        }
+        else {
+            byFrame.set(key, {
+                functionName: name,
+                url: frame.url || undefined,
+                line: frame.lineNumber !== undefined && frame.lineNumber >= 0 ? frame.lineNumber : undefined,
+                selfMs: share * durationMs,
+                selfPercent: share * 100,
+            });
+        }
+    }
+    const topFunctions = [...byFrame.values()]
+        .sort((a, b) => b.selfMs - a.selfMs)
+        .slice(0, top)
+        .map((f) => ({
+        ...f,
+        selfMs: Math.round(f.selfMs * 10) / 10,
+        selfPercent: Math.round(f.selfPercent * 10) / 10,
+    }));
+    return { durationMs, totalSamples, topFunctions };
+}
+//# sourceMappingURL=browser-metrics.js.map

package/dist/src/mcp-tools/browser-metrics.js.map

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

package/dist/src/mcp-tools/browser-profile-tools.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Browser performance tools: web vitals, CPU/heap profiling, device emulation.
+ *
+ * Profiles and heap snapshots are megabytes of JSON, so these tools write the
+ * artifact to a file under `.monomind/` and return the path plus a summary an
+ * agent can actually act on — never the raw dump.
+ *
+ * Registered from `browser-tools.ts`; shared plumbing lives in
+ * `browser-session.ts`, console/network capture in
+ * `browser-instrument-tools.ts`, and the grading/summarising in
+ * `browser-metrics.ts`.
+ */
+import type { MCPTool } from './types.js';
+export declare const browserProfileTools: MCPTool[];
+export default browserProfileTools;
+//# sourceMappingURL=browser-profile-tools.d.ts.map

package/dist/src/mcp-tools/browser-profile-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-profile-tools.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/browser-profile-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAcH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAa1C,eAAO,MAAM,mBAAmB,EAAE,OAAO,EAuTxC,CAAC;eAmBa,mBAAmB"}