@mechris3/glassbox 0.1.0

package/dist/src/runner/run-all-journeys.js

@@ -0,0 +1,167 @@
+"use strict";
+/**
+ * Batch runner — headless CLI execution of journeys.
+ *
+ * Discovers journeys from the configured glob, launches a browser,
+ * runs each journey sequentially in an isolated browser context,
+ * prints results, and exits with code 0 (all pass) or 1 (any fail).
+ *
+ * Used by `glassbox run` CLI command.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runAllJourneys = runAllJourneys;
+const launcher_js_1 = require("../cdp/launcher.js");
+const browser_discovery_js_1 = require("../utils/browser-discovery.js");
+const journey_discovery_js_1 = require("../server/journey-discovery.js");
+const spawn_journey_js_1 = require("./spawn-journey.js");
+const lifecycle_hooks_js_1 = require("./lifecycle-hooks.js");
+/**
+ * Run journeys in batch mode. Returns results and an exit code.
+ */
+async function runAllJourneys(config, options) {
+    const results = [];
+    // 1. Discover journeys
+    const discovery = new journey_discovery_js_1.JourneyDiscovery(config.journeys);
+    const allJourneys = await discovery.discover();
+    if (allJourneys.length === 0) {
+        console.log('No journeys found matching pattern:', config.journeys);
+        return { results, exitCode: 1 };
+    }
+    // Filter by name if specified
+    const journeysToRun = options.journeyFilter.length > 0
+        ? allJourneys.filter((j) => options.journeyFilter.some((f) => j.id.includes(f) || j.name.toLowerCase().includes(f.toLowerCase())))
+        : allJourneys;
+    if (journeysToRun.length === 0) {
+        console.log('No journeys match filter:', options.journeyFilter.join(', '));
+        return { results, exitCode: 1 };
+    }
+    // 2. Find a browser
+    const browserPath = config.browser.executablePath ?? autoDetectBrowser();
+    if (!browserPath) {
+        console.error('No Chromium browser found. Set browser.executablePath in config.');
+        return { results, exitCode: 1 };
+    }
+    // 3. Launch browser
+    let browser;
+    try {
+        browser = await (0, launcher_js_1.launchBrowser)({
+            browserPath,
+            headless: !options.headed,
+            viewport: config.browser.defaultViewport,
+        });
+    }
+    catch (err) {
+        console.error('Failed to launch browser:', err instanceof Error ? err.message : err);
+        return { results, exitCode: 1 };
+    }
+    console.log(`\n  🚀 Running ${journeysToRun.length} journey(s)\n`);
+    // 4. Run globalSetup (abort entire run if it fails)
+    const hookContext = { targetUrl: options.targetUrl };
+    const setupOk = await (0, lifecycle_hooks_js_1.runGlobalSetup)(config.testData, hookContext);
+    if (!setupOk) {
+        console.error('  ❌ globalSetup failed — aborting run\n');
+        browser.process.kill();
+        return { results, exitCode: 1 };
+    }
+    // 5. Run each journey sequentially with beforeEach/afterEach
+    let failed = false;
+    for (const journey of journeysToRun) {
+        if (failed && !options.noFailFast) {
+            results.push({ journey: journey.path, name: journey.name, status: 'skipped', duration: '-' });
+            continue;
+        }
+        // beforeEach
+        const beforeCtx = { targetUrl: options.targetUrl, journeyName: journey.name, journeyPath: journey.path };
+        const beforeOk = await (0, lifecycle_hooks_js_1.runBeforeEach)(config.testData, beforeCtx);
+        if (!beforeOk) {
+            results.push({ journey: journey.path, name: journey.name, status: 'failed', duration: '0s', error: 'beforeEach hook failed' });
+            failed = true;
+            console.log(`  ❌ ${journey.name} (beforeEach failed)`);
+            continue;
+        }
+        // Run the journey
+        const result = await runSingleJourney(journey, browser.wsEndpoint, config, options);
+        results.push(result);
+        const icon = result.status === 'passed' ? '✅' : '❌';
+        console.log(`  ${icon} ${result.name} (${result.duration})`);
+        if (result.status === 'failed') {
+            failed = true;
+            if (result.error) {
+                console.log(`     ${result.error}\n`);
+            }
+        }
+        // afterEach (runs even if journey failed)
+        const afterCtx = { ...beforeCtx, journeyStatus: result.status };
+        await (0, lifecycle_hooks_js_1.runAfterEach)(config.testData, afterCtx);
+    }
+    // 6. Run globalTeardown (always runs)
+    await (0, lifecycle_hooks_js_1.runGlobalTeardown)(config.testData, hookContext);
+    // 7. Cleanup
+    browser.process.kill();
+    // 6. Print summary
+    printSummary(results);
+    return { results, exitCode: failed ? 1 : 0 };
+}
+/**
+ * Run a single journey as a child process. Returns its result.
+ */
+async function runSingleJourney(journey, wsEndpoint, config, options) {
+    const start = Date.now();
+    const spawned = (0, spawn_journey_js_1.spawnJourney)({
+        journeyPath: journey.path,
+        wsEndpoint,
+        targetUrl: options.targetUrl,
+        viewportWidth: config.browser.defaultViewport.width,
+        viewportHeight: config.browser.defaultViewport.height,
+        actionDelay: 0,
+        breakpoints: [],
+    });
+    let lastError = '';
+    spawned.process.stderr?.on('data', (chunk) => {
+        const lines = chunk.toString().split('\n');
+        for (const line of lines) {
+            if (line.startsWith('[JSON]')) {
+                try {
+                    const json = JSON.parse(line.slice(6));
+                    if (json.type === 'error')
+                        lastError = json.message;
+                }
+                catch { /* ignore */ }
+            }
+            else if (line.trim() && !line.includes('[JSON]')) {
+                lastError = line.trim();
+            }
+        }
+    });
+    const code = await spawned.exitCode;
+    const duration = `${((Date.now() - start) / 1000).toFixed(2)}s`;
+    return {
+        journey: journey.path,
+        name: journey.name,
+        status: code === 0 ? 'passed' : 'failed',
+        duration,
+        error: code !== 0 ? lastError : undefined,
+    };
+}
+/** Print a formatted results summary. */
+function printSummary(results) {
+    const passed = results.filter((r) => r.status === 'passed').length;
+    const failed = results.filter((r) => r.status === 'failed').length;
+    const skipped = results.filter((r) => r.status === 'skipped').length;
+    console.log('\n  ════════════════════════════════════════');
+    console.log('  📊 Results');
+    console.log('  ════════════════════════════════════════');
+    for (const r of results) {
+        const icon = r.status === 'passed' ? '✅' : r.status === 'failed' ? '❌' : '⏭️';
+        console.log(`    ${icon} ${r.name} ${r.status !== 'skipped' ? `(${r.duration})` : ''}`);
+    }
+    console.log('  ────────────────────────────────────────');
+    console.log(`    Passed: ${passed}  Failed: ${failed}  Skipped: ${skipped}`);
+    console.log('  ════════════════════════════════════════\n');
+}
+/** Auto-detect the first available Chromium browser. */
+function autoDetectBrowser() {
+    const browsers = (0, browser_discovery_js_1.discoverBrowsers)();
+    return browsers[0]?.executablePath;
+}
+//# sourceMappingURL=run-all-journeys.js.map

package/dist/src/runner/run-all-journeys.js.map

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

package/dist/src/runner/run-journey.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Journey runner — child process entry point.
+ *
+ * Spawned by TestExecutor (one process per journey). Connects to Chrome via CDP,
+ * creates an isolated browser context, loads the journey module, executes it,
+ * and reports results via stderr JSON.
+ *
+ * Expected environment variables:
+ * - GLASSBOX_JOURNEY_PATH: absolute path to the journey file
+ * - GLASSBOX_WS_ENDPOINT: Chrome DevTools WebSocket URL
+ * - TEST_DOMAIN: base URL of the app under test
+ * - VIEWPORT_WIDTH, VIEWPORT_HEIGHT: browser content area dimensions
+ * - ACTION_DELAY: slow mode delay in ms
+ * - TEST_BREAKPOINTS: JSON array of action indices
+ */
+export {};
+//# sourceMappingURL=run-journey.d.ts.map

package/dist/src/runner/run-journey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-journey.d.ts","sourceRoot":"","sources":["../../../src/runner/run-journey.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}

package/dist/src/runner/run-journey.js

@@ -0,0 +1,179 @@
+"use strict";
+/**
+ * Journey runner — child process entry point.
+ *
+ * Spawned by TestExecutor (one process per journey). Connects to Chrome via CDP,
+ * creates an isolated browser context, loads the journey module, executes it,
+ * and reports results via stderr JSON.
+ *
+ * Expected environment variables:
+ * - GLASSBOX_JOURNEY_PATH: absolute path to the journey file
+ * - GLASSBOX_WS_ENDPOINT: Chrome DevTools WebSocket URL
+ * - TEST_DOMAIN: base URL of the app under test
+ * - VIEWPORT_WIDTH, VIEWPORT_HEIGHT: browser content area dimensions
+ * - ACTION_DELAY: slow mode delay in ms
+ * - TEST_BREAKPOINTS: JSON array of action indices
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const connection_js_1 = require("../cdp/connection.js");
+const domains_js_1 = require("../cdp/domains.js");
+const cdp_adapter_js_1 = require("../adapters/cdp-adapter.js");
+const collectors_js_1 = require("../ai/collectors.js");
+async function main() {
+    const journeyPath = process.env.GLASSBOX_JOURNEY_PATH;
+    const wsEndpoint = process.env.GLASSBOX_WS_ENDPOINT;
+    if (!journeyPath) {
+        emitError('GLASSBOX_JOURNEY_PATH environment variable is required');
+        process.exit(1);
+    }
+    if (!wsEndpoint) {
+        emitError('GLASSBOX_WS_ENDPOINT environment variable is required');
+        process.exit(1);
+    }
+    let connection = null;
+    try {
+        // 1. Connect to browser-level CDP endpoint
+        connection = await connection_js_1.CDPConnection.connect(wsEndpoint);
+        const targets = new domains_js_1.TargetDomain(connection);
+        // 2. Close any existing tabs from previous runs (keep only one window)
+        const existingTargets = await connection.send('Target.getTargets');
+        const existingPages = existingTargets.targetInfos.filter((t) => t.type === 'page');
+        let targetId;
+        if (existingPages.length > 0) {
+            // Reuse the first existing page tab — navigate it rather than creating a new one
+            targetId = existingPages[0].targetId;
+            // Close any extra tabs
+            for (const t of existingPages.slice(1)) {
+                await targets.closeTarget(t.targetId).catch(() => { });
+            }
+        }
+        else {
+            // No existing tabs — create one in the default context
+            const targetResult = await targets.createTarget('about:blank');
+            targetId = targetResult.targetId;
+        }
+        // 3. Attach to the target with flattened session
+        const attachResult = await targets.attachToTarget(targetId, true);
+        const sessionId = attachResult.sessionId;
+        // 5. Enable CDP domains
+        const page = new domains_js_1.PageDomain(connection, sessionId);
+        const runtime = new domains_js_1.RuntimeDomain(connection, sessionId);
+        const network = new domains_js_1.NetworkDomain(connection, sessionId);
+        const dom = new domains_js_1.DOMDomain(connection, sessionId);
+        const performance = new domains_js_1.PerformanceDomain(connection, sessionId);
+        await page.enable();
+        await runtime.enable();
+        await network.enable();
+        await dom.enable();
+        await performance.enable();
+        // 5b. Set viewport dimensions if specified
+        const viewportWidth = parseInt(process.env.VIEWPORT_WIDTH ?? '1280', 10);
+        const viewportHeight = parseInt(process.env.VIEWPORT_HEIGHT ?? '720', 10);
+        await connection.send('Emulation.setDeviceMetricsOverride', {
+            width: viewportWidth,
+            height: viewportHeight,
+            deviceScaleFactor: 1,
+            mobile: false,
+        }, sessionId);
+        // 6. Start diagnostic collector
+        const diagnostics = new collectors_js_1.DiagnosticCollector(connection, sessionId);
+        // 7. Create the adapter
+        const adapter = new cdp_adapter_js_1.CDPAdapter(connection, sessionId);
+        // 8. Load the journey module
+        const journeyModule = await importJourney(journeyPath);
+        // 9. Execute the journey
+        await executeJourney(journeyModule, adapter);
+        // 10. Capture final metrics
+        await diagnostics.captureMetricsSnapshot('journey-complete');
+        // 11. Output diagnostic data for the server to collect
+        const diagnosticData = {
+            consoleErrors: diagnostics.getConsoleErrors(),
+            exceptions: diagnostics.getExceptions(),
+            networkLog: diagnostics.getNetworkLog(),
+            networkFailures: diagnostics.getNetworkFailures(),
+            metrics: diagnostics.getMetricsReport(),
+            timeline: diagnostics.getTimeline(),
+        };
+        process.stdout.write(JSON.stringify({ type: 'diagnostics', data: diagnosticData }) + '\n');
+        // 12. Clean up
+        diagnostics.dispose();
+        await connection.send('Network.clearBrowserCookies', undefined, sessionId);
+        connection.close();
+        process.exit(0);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        const stack = error instanceof Error ? error.stack : undefined;
+        emitError(message);
+        if (stack) {
+            process.stderr.write(stack + '\n');
+        }
+        // Attempt cleanup
+        if (connection) {
+            connection.close();
+        }
+        process.exit(1);
+    }
+}
+/**
+ * Dynamically import a journey file and detect its export shape.
+ */
+async function importJourney(journeyPath) {
+    const module = await import(journeyPath);
+    return module;
+}
+/**
+ * Execute a journey module — supports class-based and function-based journeys.
+ *
+ * Class-based: exports a class with constructor(adapter) and execute() method.
+ * Function-based: exports a function that receives the adapter.
+ */
+async function executeJourney(module, adapter) {
+    // Find the journey export — check default first, then named exports
+    const journeyExport = module.default ?? findJourneyExport(module);
+    if (!journeyExport) {
+        throw new Error('Journey file must export a class with execute() method or a function');
+    }
+    // Class-based journey (has prototype with execute method)
+    if (isJourneyClass(journeyExport)) {
+        const instance = new journeyExport(adapter);
+        await instance.execute();
+        return;
+    }
+    // Function-based journey
+    if (typeof journeyExport === 'function') {
+        await journeyExport(adapter);
+        return;
+    }
+    throw new Error('Journey export must be a class with execute() method or a function');
+}
+/**
+ * Find a journey export from named exports (first class or function found).
+ */
+function findJourneyExport(module) {
+    const candidates = Object.values(module).filter((v) => v !== undefined);
+    // Prefer class with execute method
+    const classExport = candidates.find(isJourneyClass);
+    if (classExport)
+        return classExport;
+    // Fall back to function
+    const fnExport = candidates.find((v) => typeof v === 'function');
+    return fnExport;
+}
+/**
+ * Type guard: checks if a value is a class constructor with an execute() method on its prototype.
+ */
+function isJourneyClass(value) {
+    if (typeof value !== 'function')
+        return false;
+    const proto = value.prototype;
+    return proto !== undefined && typeof proto.execute === 'function';
+}
+/**
+ * Emit a structured JSON error to stderr.
+ */
+function emitError(message) {
+    process.stderr.write(`[JSON]${JSON.stringify({ type: 'error', message })}\n`);
+}
+main();
+//# sourceMappingURL=run-journey.js.map

package/dist/src/runner/run-journey.js.map

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

package/dist/src/runner/spawn-journey.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Shared journey spawning logic.
+ *
+ * Both the server-driven TestExecutor and the CLI batch runner need to spawn
+ * a child process per journey with identical environment setup. This module
+ * is the single source of truth for that logic.
+ */
+import { type ChildProcess } from 'child_process';
+export interface SpawnJourneyOptions {
+    /** Absolute path to the journey file. */
+    journeyPath: string;
+    /** Chrome DevTools WebSocket endpoint URL. */
+    wsEndpoint: string;
+    /** Target URL of the app under test. */
+    targetUrl: string;
+    /** Viewport width in pixels. */
+    viewportWidth: number;
+    /** Viewport height in pixels. */
+    viewportHeight: number;
+    /** Delay between actions in milliseconds. */
+    actionDelay: number;
+    /** Action indices where the runner should pause. */
+    breakpoints: number[];
+}
+export interface SpawnedJourney {
+    /** The child process handle. */
+    process: ChildProcess;
+    /** Promise that resolves with exit code when the process exits. */
+    exitCode: Promise<number>;
+}
+/**
+ * Spawn a journey runner child process with the correct environment.
+ * Returns the process handle and a promise for the exit code.
+ */
+export declare function spawnJourney(options: SpawnJourneyOptions): SpawnedJourney;
+//# sourceMappingURL=spawn-journey.d.ts.map

package/dist/src/runner/spawn-journey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-journey.d.ts","sourceRoot":"","sources":["../../../src/runner/spawn-journey.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAGzD,MAAM,WAAW,mBAAmB;IAClC,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,OAAO,EAAE,YAAY,CAAC;IACtB,mEAAmE;IACnE,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3B;AAKD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,cAAc,CAuBzE"}

package/dist/src/runner/spawn-journey.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * Shared journey spawning logic.
+ *
+ * Both the server-driven TestExecutor and the CLI batch runner need to spawn
+ * a child process per journey with identical environment setup. This module
+ * is the single source of truth for that logic.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.spawnJourney = spawnJourney;
+const child_process_1 = require("child_process");
+const path_1 = require("path");
+/** Path to the runner entry point — resolved from this module's location. */
+const RUNNER_ENTRY = (0, path_1.resolve)(__dirname, 'run-journey.js');
+/**
+ * Spawn a journey runner child process with the correct environment.
+ * Returns the process handle and a promise for the exit code.
+ */
+function spawnJourney(options) {
+    const env = {
+        ...process.env,
+        GLASSBOX_JOURNEY_PATH: options.journeyPath,
+        GLASSBOX_WS_ENDPOINT: options.wsEndpoint,
+        TEST_DOMAIN: options.targetUrl,
+        VIEWPORT_WIDTH: String(options.viewportWidth),
+        VIEWPORT_HEIGHT: String(options.viewportHeight),
+        ACTION_DELAY: String(options.actionDelay),
+        TEST_BREAKPOINTS: JSON.stringify(options.breakpoints),
+    };
+    const child = (0, child_process_1.spawn)(process.execPath, ['--import', 'tsx', RUNNER_ENTRY], {
+        env,
+        stdio: ['pipe', 'pipe', 'pipe'],
+        cwd: process.cwd(),
+    });
+    const exitCode = new Promise((resolve) => {
+        child.on('close', (code) => resolve(code ?? 1));
+    });
+    return { process: child, exitCode };
+}
+//# sourceMappingURL=spawn-journey.js.map

package/dist/src/runner/spawn-journey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-journey.js","sourceRoot":"","sources":["../../../src/runner/spawn-journey.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAoCH,oCAuBC;AAzDD,iDAAyD;AACzD,+BAA+B;AA0B/B,6EAA6E;AAC7E,MAAM,YAAY,GAAG,IAAA,cAAO,EAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;AAE1D;;;GAGG;AACH,SAAgB,YAAY,CAAC,OAA4B;IACvD,MAAM,GAAG,GAA2B;QAClC,GAAG,OAAO,CAAC,GAA6B;QACxC,qBAAqB,EAAE,OAAO,CAAC,WAAW;QAC1C,oBAAoB,EAAE,OAAO,CAAC,UAAU;QACxC,WAAW,EAAE,OAAO,CAAC,SAAS;QAC9B,cAAc,EAAE,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC;QAC7C,eAAe,EAAE,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC;QAC/C,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC;QACzC,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC;KACtD,CAAC;IAEF,MAAM,KAAK,GAAG,IAAA,qBAAK,EAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,KAAK,EAAE,YAAY,CAAC,EAAE;QACvE,GAAG;QACH,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;QAC/B,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;KACnB,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;QAC/C,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AACtC,CAAC"}

package/dist/src/server/diagnostic-service.d.ts

@@ -0,0 +1,69 @@
+/**
+ * DiagnosticService — server-side diagnostic data store.
+ *
+ * Accumulates diagnostic data streamed from runner child processes
+ * and exposes it via REST API endpoints for the AI bridge to consume.
+ *
+ * Data flow:
+ * 1. Runner collects diagnostics via CDP during journey execution
+ * 2. At journey end, runner outputs the data as JSON to stdout
+ * 3. TestExecutor catches it and calls ingestRunnerData()
+ * 4. REST API serves the accumulated data on demand
+ */
+import type { ConsoleError, ExceptionDetail, NetworkRequest, NetworkFailure, MetricsSnapshot, TimelineEntry } from '../ai/types.js';
+interface CollectedData {
+    consoleErrors: ConsoleError[];
+    exceptions: ExceptionDetail[];
+    networkLog: NetworkRequest[];
+    networkFailures: NetworkFailure[];
+    metrics: MetricsSnapshot[];
+    timeline: TimelineEntry[];
+}
+export declare class DiagnosticService {
+    private collectedData;
+    private liveSession;
+    /**
+     * Ingest diagnostic data streamed from a runner child process.
+     * Caps each category at MAX_ENTRIES to prevent memory issues on chatty apps.
+     */
+    ingestRunnerData(data: Partial<CollectedData>): void;
+    /** Push items into an array, keeping only the most recent MAX_ENTRIES. */
+    private cappedPush;
+    /** Reset all collected data. */
+    reset(): void;
+    getConsoleErrors(): ConsoleError[];
+    getExceptions(): ExceptionDetail[];
+    getNetworkLog(): NetworkRequest[];
+    getNetworkFailures(): NetworkFailure[];
+    getMetrics(): MetricsSnapshot[];
+    getTimeline(lastN?: number): TimelineEntry[];
+    /**
+     * Summary of collected data — minimal response for the AI to decide
+     * which detailed endpoints to query next.
+     */
+    getSummary(): {
+        consoleErrors: number;
+        exceptions: number;
+        networkFailures: number;
+        totalRequests: number;
+        timelineEvents: number;
+        liveSessionAvailable: boolean;
+    };
+    /**
+     * Store a live browser session for post-failure queries.
+     * Called by TestExecutor when a journey fails and the browser stays alive.
+     */
+    setLiveSession(wsEndpoint: string): Promise<void>;
+    /** Close the live session (called before a new run or on reset). */
+    closeLiveSession(): void;
+    /** Whether a live session is available for DOM/screenshot queries. */
+    get hasLiveSession(): boolean;
+    /** Get the DOM snapshot (outerHTML) of an element or the full page. */
+    getDomSnapshot(selector?: string): Promise<string>;
+    /** Capture a screenshot of the current page state (base64 PNG). */
+    getScreenshot(): Promise<string>;
+    /** Get the accessibility tree of the current page. */
+    getAccessibilityTree(): Promise<unknown>;
+}
+export {};
+//# sourceMappingURL=diagnostic-service.d.ts.map

package/dist/src/server/diagnostic-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic-service.d.ts","sourceRoot":"","sources":["../../../src/server/diagnostic-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGpI,UAAU,aAAa;IACrB,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAYD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,aAAa,CAOnB;IAEF,OAAO,CAAC,WAAW,CAA4B;IAE/C;;;OAGG;IACH,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI;IASpD,0EAA0E;IAC1E,OAAO,CAAC,UAAU;IAOlB,gCAAgC;IAChC,KAAK,IAAI,IAAI;IAab,gBAAgB,IAAI,YAAY,EAAE;IAIlC,aAAa,IAAI,eAAe,EAAE;IAIlC,aAAa,IAAI,cAAc,EAAE;IAIjC,kBAAkB,IAAI,cAAc,EAAE;IAItC,UAAU,IAAI,eAAe,EAAE;IAI/B,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE;IAK5C;;;OAGG;IACH,UAAU,IAAI;QACZ,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,MAAM,CAAC;QACxB,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,oBAAoB,EAAE,OAAO,CAAC;KAC/B;IAaD;;;OAGG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBvD,oEAAoE;IACpE,gBAAgB,IAAI,IAAI;IAOxB,sEAAsE;IACtE,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED,uEAAuE;IACjE,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBxD,mEAAmE;IAC7D,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAUtC,sDAAsD;IAChD,oBAAoB,IAAI,OAAO,CAAC,OAAO,CAAC;CAQ/C"}