@_deep4wee/agent-lens 1.1.0 → 1.2.0

package/dist/index.d.mts

@@ -1,193 +1,146 @@
+import { V as VisualScenario, A as AgentLensPlugin, C as ConsoleEntry, S as SnapshotMetadata, b as CaptureOptions, c as CaptureBurstOptions, R as ReportData, P as PluginHookContext, D as DriverLaunchResult, T as TestContext } from './dsl-BIjVN1M0.mjs';
+export { a as MockIpcEntry, M as MockIpcResponseType, d as MockRouteEntry, e as ReportSection, f as VIEWPORT_PRESETS, g as ViewportPreset, h as definePlugin, i as defineVisualTest } from './dsl-BIjVN1M0.mjs';
 import { Page, BrowserContext } from 'playwright';
 
-interface ConsoleEntry {
-    level: 'error' | 'warning' | 'info' | 'log' | 'debug';
-    text: string;
-    url: string;
-    timestamp: string;
-    stack?: string;
+interface RunOptions {
+    scenario: VisualScenario;
+    targetMode?: 'desktop' | 'preview' | string;
+    artifactsRoot?: string;
+    autoLaunchDesktop?: boolean;
+    port?: number;
+    wwwrootDir?: string;
+    executablePath?: string;
+    desktopArgs?: string[];
+    desktopEnv?: Record<string, string>;
+    cleanPaths?: string[];
+    url?: string;
+    startCommand?: string;
+    startCwd?: string;
+    cleanArtifacts?: boolean;
+    headed?: boolean;
+    detach?: boolean;
+    globalMocks?: any[];
+    plugins?: (string | AgentLensPlugin)[];
 }
-
-/**
- * Generic Mock IPC Registry for Preview Mode
- *
- * Injects a global `window.__mockIpc` that web apps or mocked electron/tauri APIs can call.
- */
-type MockIpcResponseType = 'SUCCESS' | 'ERROR';
-
-interface ViewportPreset {
-    name: string;
-    width: number;
-    height: number;
-}
-declare const VIEWPORT_PRESETS: {
-    /** Minimum supported window size (e.g., ) */
-    MIN_SUPPORTED: ViewportPreset;
-    /** Standard default window size (e.g., ) */
-    DEFAULT: ViewportPreset;
-    /** Wide screen for checking grids and tables */
-    WIDE: ViewportPreset;
-    /** Full HD */
-    FULL_HD: ViewportPreset;
-};
-interface MockRouteEntry {
-    url: string;
-    method?: string;
-    status?: number;
-    body: any;
-    delayMs?: number;
-    headers?: Record<string, string>;
+interface RunResult {
+    scenarioId: string;
+    targetMode: 'desktop' | 'preview' | string;
+    success: boolean;
+    totalSnapshots: number;
+    consoleErrors: number;
+    consoleWarnings: number;
+    reportPath: string;
+    artifactsDir: string;
+    error?: string;
 }
-interface CaptureOptions {
+declare function runVisualScenario(options: RunOptions): Promise<RunResult>;
+
+interface SnapCliOptions {
+    url?: string;
+    start?: string;
+    startCwd?: string;
     selector?: string;
+    viewports?: string[];
+    waitMs?: number;
+    name?: string;
+    clean?: string[];
+    cleanArtifacts?: boolean;
+    headed?: boolean;
+    detach?: boolean;
+    outDir?: string;
+    mode?: 'desktop' | 'preview';
+    exe?: string;
+    port?: number;
+    plugins?: (string | any)[];
     fullPage?: boolean;
-    mask?: string[];
 }
-interface CaptureBurstOptions {
-    /** Total duration of burst animation capture in milliseconds */
-    durationMs: number;
-    /** Interval between frames in milliseconds (default: 80ms) */
-    intervalMs?: number;
-    /** Restrict capture to a specific element */
-    selector?: string;
-}
-interface SnapshotMetadata {
-    index: number;
-    name: string;
-    fileName: string;
-    filePath: string;
-    relativeUri: string;
-    viewport: {
-        width: number;
-        height: number;
-    };
-    timestamp: string;
-    isBurstFrame?: boolean;
-    burstGroup?: string;
-    frameIndex?: number;
-    selector?: string;
+declare function runQuickSnap(options: SnapCliOptions): Promise<boolean>;
+
+declare class ConsoleTracker {
+    private entries;
+    private attached;
+    attach(page: Page): void;
+    getErrors(): ConsoleEntry[];
+    getWarnings(): ConsoleEntry[];
+    getAll(): ConsoleEntry[];
+    get errorCount(): number;
+    get warningCount(): number;
+    get hasErrors(): boolean;
+    clear(): void;
+    private mapConsoleType;
+    private isIgnoredWarning;
 }
-interface TestContext {
-    page: Page;
-    context: BrowserContext;
-    targetMode: 'desktop' | 'preview';
-    currentViewport: {
-        width: number;
-        height: number;
-    };
-    /** Capture a single high-quality snapshot of the window or element */
-    capture: (name: string, options?: CaptureOptions) => Promise<SnapshotMetadata>;
-    /** Capture a series of frames for animations (Framer Motion, modals, lists) */
-    captureBurst: (name: string, options: CaptureBurstOptions) => Promise<SnapshotMetadata[]>;
-    /**
-     * Dynamically navigate to another page during the test.
-     * Example: await ctx.navigate('/settings');
-     */
-    navigate: (route: string) => Promise<void>;
-    /** Change window / viewport size */
-    resize: (width: number, height: number) => Promise<void>;
-    /** Set one of the standard presets (MIN_SUPPORTED, DEFAULT, WIDE) */
-    setPreset: (preset: ViewportPreset) => Promise<void>;
-    /**
-     * Dynamically resize the window so it perfectly fits the specified element (or body).
-     * Useful when an agent wants to test an isolated component without background clutter.
-     */
-    resizeToFit: (selector?: string, padding?: number) => Promise<void>;
-    /** Wait the specified amount of milliseconds */
-    wait: (ms: number) => Promise<void>;
-    /** Wait for the selector to appear in the DOM */
-    waitForSelector: (selector: string, timeoutMs?: number) => Promise<void>;
-    /** Left-click the element */
-    click: (selector: string) => Promise<void>;
-    /** Right-click the element (Context Menu) */
-    rightClick: (selector: string) => Promise<void>;
-    /** Type text into an input field */
-    type: (selector: string, text: string) => Promise<void>;
-    /** Select an option in a <select> by its value */
-    selectOption: (selector: string, value: string) => Promise<void>;
-    /** Hover the cursor to check highlights / tooltips */
-    hover: (selector: string) => Promise<void>;
-    /** Scroll the element (or window) down by the specified number of pixels */
-    scroll: (selector: string, deltaY: number) => Promise<void>;
-    /** Log a step for the agent */
-    log: (message: string) => void;
+
+declare class CaptureEngine {
+    private outputDir;
+    private currentStepIndex;
+    private recordedSnapshots;
+    constructor(outputDir: string);
+    getSnapshots(): SnapshotMetadata[];
+    getOutputDir(): string;
     /**
-     * Set a mock response for an IPC action.
-     * Changes the data returned by window.__mockIpc.invoke or hybrid bridges in preview mode.
-     * Ignored in desktop mode (IPC goes through real backend).
      */
-    setMockIpc: (action: string, data: any, options?: {
-        type?: MockIpcResponseType;
-        delayMs?: number;
-    }) => Promise<void>;
+    takeSnapshot(page: Page, name: string, viewport: {
+        width: number;
+        height: number;
+    }, options?: CaptureOptions): Promise<SnapshotMetadata>;
     /**
-     * Mock an HTTP REST or GraphQL network request in preview mode.
-     * Intercepts fetch/axios calls matching the URL pattern and returns mock data.
-     *
-     * Example:
-     *   await ctx.setMockRoute('/api/user', { id: 1, name: 'Agent' });
-     *   await ctx.setMockRoute('**\/api/items*', [], { status: 200, delayMs: 50 });
      */
-    setMockRoute: (url: string, body: any, options?: {
-        method?: string;
-        status?: number;
-        delayMs?: number;
-        headers?: Record<string, string>;
-    }) => Promise<void>;
-    /** Return all intercepted console.error and pageerror logs */
-    getConsoleErrors: () => ConsoleEntry[];
-    /** Return all intercepted console.warn logs */
-    getConsoleWarnings: () => ConsoleEntry[];
-    /** Returns true if there are critical errors in the console */
-    hasConsoleErrors: () => boolean;
-    /** Get the visible text of a specific element */
-    readText: (selector: string) => Promise<string | null>;
-    /** Get ALL visible text on the page (useful for quick analysis without Vision) */
-    getPageText: () => Promise<string>;
-    /** Check if the element is visible on the screen */
-    isVisible: (selector: string) => Promise<boolean>;
-    /** Count the number of elements matching the selector */
-    getElementCount: (selector: string) => Promise<number>;
+    takeBurst(page: Page, name: string, viewport: {
+        width: number;
+        height: number;
+    }, options: CaptureBurstOptions): Promise<SnapshotMetadata[]>;
 }
-interface VisualScenario {
-    /** Unique scenario identifier (kebab-case) */
-    id: string;
-    /** Human-readable title for the report */
-    title: string;
-    /** Description of what is being tested */
-    description?: string;
-    /** Initial route to navigate to (e.g., '/instances', '/settings') */
-    route?: string;
-    /** List of viewport sizes to test */
-    viewports?: ViewportPreset[];
-    /**
-   * Initial IPC mock data for preview mode.
-   * Applied BEFORE navigation to the route.
-   */
-    mockIpc?: Array<{
-        action: string;
-        data: any;
-        type?: MockIpcResponseType;
-        delayMs?: number;
-    }>;
-    /**
-     * Initial HTTP REST/GraphQL route mocks for preview mode.
-     * Applied BEFORE navigation to the route.
-     */
-    mockRoutes?: MockRouteEntry[];
-    /**
-     * Optional setup hook: executed before the browser navigates and scenario runs.
-     * Ideal for preparing mock files, test directories, or initial state.
-     */
-    setup?: () => Promise<void> | void;
-    /** The main body of the scenario */
-    run: (ctx: TestContext) => Promise<void>;
-    /**
-     * Optional teardown hook: guaranteed to execute in finally, even if run() fails.
-     * Ideal for cleaning up test artifacts, cache directories, or temporary state.
-     */
-    teardown?: () => Promise<void> | void;
+
+declare class VisualReporter {
+    static generateReport(data: ReportData): string;
+    private static getHealthStatus;
+}
+
+interface AgentLensConfigFile {
+    mode?: 'desktop' | 'preview';
+    port?: number;
+    headed?: boolean;
+    detach?: boolean;
+    buildCommand?: string;
+    autoBuild?: boolean;
+    startCommand?: string;
+    startCwd?: string;
+    cleanArtifacts?: boolean;
+    url?: string;
+    executablePath?: string;
+    clean?: string | string[];
+    scenarios?: string;
+    wwwroot?: string;
+    outDir?: string;
+    env?: Record<string, string>;
+    plugins?: string[];
+}
+declare function loadConfig(cwd?: string): AgentLensConfigFile;
+declare function detectStartCwd(providedCwd?: string): string | undefined;
+declare function resolveWwwrootDir(customDir?: string): string;
+
+declare class PluginManager {
+    private plugins;
+    private jiti;
+    register(plugin: AgentLensPlugin): void;
+    load(pluginSpec: string | AgentLensPlugin): Promise<void>;
+    private loadFromFile;
+    loadAll(specs: (string | AgentLensPlugin)[]): Promise<void>;
+    runSetup(hookContext: PluginHookContext): Promise<void>;
+    launchSession(options: {
+        currentViewport: {
+            width: number;
+            height: number;
+        };
+        headed?: boolean;
+    }, hookContext: PluginHookContext): Promise<DriverLaunchResult | undefined>;
+    runOnContextCreated(context: BrowserContext, hookContext: PluginHookContext): Promise<void>;
+    runOnPageCreated(page: Page, context: BrowserContext, hookContext: PluginHookContext): Promise<void>;
+    extendContext(ctx: TestContext, page: Page, hookContext: PluginHookContext): Promise<void>;
+    runOnAfterRun(reportData: ReportData, hookContext: PluginHookContext): Promise<void>;
+    runTeardown(hookContext: PluginHookContext): Promise<void>;
+    get loadedPlugins(): AgentLensPlugin[];
 }
-declare function defineVisualTest(scenario: VisualScenario): VisualScenario;
 
-export { type CaptureBurstOptions, type CaptureOptions, type MockRouteEntry, type SnapshotMetadata, type TestContext, VIEWPORT_PRESETS, type ViewportPreset, type VisualScenario, defineVisualTest };
+export { type AgentLensConfigFile, AgentLensPlugin, CaptureBurstOptions, CaptureEngine, CaptureOptions, ConsoleEntry, ConsoleTracker, DriverLaunchResult, PluginHookContext, PluginManager, ReportData, type RunOptions, type RunResult, type SnapCliOptions, SnapshotMetadata, TestContext, VisualReporter, VisualScenario, detectStartCwd, loadConfig, resolveWwwrootDir, runQuickSnap, runVisualScenario };

package/dist/index.d.ts

@@ -1,193 +1,146 @@
+import { V as VisualScenario, A as AgentLensPlugin, C as ConsoleEntry, S as SnapshotMetadata, b as CaptureOptions, c as CaptureBurstOptions, R as ReportData, P as PluginHookContext, D as DriverLaunchResult, T as TestContext } from './dsl-BIjVN1M0.js';
+export { a as MockIpcEntry, M as MockIpcResponseType, d as MockRouteEntry, e as ReportSection, f as VIEWPORT_PRESETS, g as ViewportPreset, h as definePlugin, i as defineVisualTest } from './dsl-BIjVN1M0.js';
 import { Page, BrowserContext } from 'playwright';
 
-interface ConsoleEntry {
-    level: 'error' | 'warning' | 'info' | 'log' | 'debug';
-    text: string;
-    url: string;
-    timestamp: string;
-    stack?: string;
+interface RunOptions {
+    scenario: VisualScenario;
+    targetMode?: 'desktop' | 'preview' | string;
+    artifactsRoot?: string;
+    autoLaunchDesktop?: boolean;
+    port?: number;
+    wwwrootDir?: string;
+    executablePath?: string;
+    desktopArgs?: string[];
+    desktopEnv?: Record<string, string>;
+    cleanPaths?: string[];
+    url?: string;
+    startCommand?: string;
+    startCwd?: string;
+    cleanArtifacts?: boolean;
+    headed?: boolean;
+    detach?: boolean;
+    globalMocks?: any[];
+    plugins?: (string | AgentLensPlugin)[];
 }
-
-/**
- * Generic Mock IPC Registry for Preview Mode
- *
- * Injects a global `window.__mockIpc` that web apps or mocked electron/tauri APIs can call.
- */
-type MockIpcResponseType = 'SUCCESS' | 'ERROR';
-
-interface ViewportPreset {
-    name: string;
-    width: number;
-    height: number;
-}
-declare const VIEWPORT_PRESETS: {
-    /** Minimum supported window size (e.g., ) */
-    MIN_SUPPORTED: ViewportPreset;
-    /** Standard default window size (e.g., ) */
-    DEFAULT: ViewportPreset;
-    /** Wide screen for checking grids and tables */
-    WIDE: ViewportPreset;
-    /** Full HD */
-    FULL_HD: ViewportPreset;
-};
-interface MockRouteEntry {
-    url: string;
-    method?: string;
-    status?: number;
-    body: any;
-    delayMs?: number;
-    headers?: Record<string, string>;
+interface RunResult {
+    scenarioId: string;
+    targetMode: 'desktop' | 'preview' | string;
+    success: boolean;
+    totalSnapshots: number;
+    consoleErrors: number;
+    consoleWarnings: number;
+    reportPath: string;
+    artifactsDir: string;
+    error?: string;
 }
-interface CaptureOptions {
+declare function runVisualScenario(options: RunOptions): Promise<RunResult>;
+
+interface SnapCliOptions {
+    url?: string;
+    start?: string;
+    startCwd?: string;
     selector?: string;
+    viewports?: string[];
+    waitMs?: number;
+    name?: string;
+    clean?: string[];
+    cleanArtifacts?: boolean;
+    headed?: boolean;
+    detach?: boolean;
+    outDir?: string;
+    mode?: 'desktop' | 'preview';
+    exe?: string;
+    port?: number;
+    plugins?: (string | any)[];
     fullPage?: boolean;
-    mask?: string[];
 }
-interface CaptureBurstOptions {
-    /** Total duration of burst animation capture in milliseconds */
-    durationMs: number;
-    /** Interval between frames in milliseconds (default: 80ms) */
-    intervalMs?: number;
-    /** Restrict capture to a specific element */
-    selector?: string;
-}
-interface SnapshotMetadata {
-    index: number;
-    name: string;
-    fileName: string;
-    filePath: string;
-    relativeUri: string;
-    viewport: {
-        width: number;
-        height: number;
-    };
-    timestamp: string;
-    isBurstFrame?: boolean;
-    burstGroup?: string;
-    frameIndex?: number;
-    selector?: string;
+declare function runQuickSnap(options: SnapCliOptions): Promise<boolean>;
+
+declare class ConsoleTracker {
+    private entries;
+    private attached;
+    attach(page: Page): void;
+    getErrors(): ConsoleEntry[];
+    getWarnings(): ConsoleEntry[];
+    getAll(): ConsoleEntry[];
+    get errorCount(): number;
+    get warningCount(): number;
+    get hasErrors(): boolean;
+    clear(): void;
+    private mapConsoleType;
+    private isIgnoredWarning;
 }
-interface TestContext {
-    page: Page;
-    context: BrowserContext;
-    targetMode: 'desktop' | 'preview';
-    currentViewport: {
-        width: number;
-        height: number;
-    };
-    /** Capture a single high-quality snapshot of the window or element */
-    capture: (name: string, options?: CaptureOptions) => Promise<SnapshotMetadata>;
-    /** Capture a series of frames for animations (Framer Motion, modals, lists) */
-    captureBurst: (name: string, options: CaptureBurstOptions) => Promise<SnapshotMetadata[]>;
-    /**
-     * Dynamically navigate to another page during the test.
-     * Example: await ctx.navigate('/settings');
-     */
-    navigate: (route: string) => Promise<void>;
-    /** Change window / viewport size */
-    resize: (width: number, height: number) => Promise<void>;
-    /** Set one of the standard presets (MIN_SUPPORTED, DEFAULT, WIDE) */
-    setPreset: (preset: ViewportPreset) => Promise<void>;
-    /**
-     * Dynamically resize the window so it perfectly fits the specified element (or body).
-     * Useful when an agent wants to test an isolated component without background clutter.
-     */
-    resizeToFit: (selector?: string, padding?: number) => Promise<void>;
-    /** Wait the specified amount of milliseconds */
-    wait: (ms: number) => Promise<void>;
-    /** Wait for the selector to appear in the DOM */
-    waitForSelector: (selector: string, timeoutMs?: number) => Promise<void>;
-    /** Left-click the element */
-    click: (selector: string) => Promise<void>;
-    /** Right-click the element (Context Menu) */
-    rightClick: (selector: string) => Promise<void>;
-    /** Type text into an input field */
-    type: (selector: string, text: string) => Promise<void>;
-    /** Select an option in a <select> by its value */
-    selectOption: (selector: string, value: string) => Promise<void>;
-    /** Hover the cursor to check highlights / tooltips */
-    hover: (selector: string) => Promise<void>;
-    /** Scroll the element (or window) down by the specified number of pixels */
-    scroll: (selector: string, deltaY: number) => Promise<void>;
-    /** Log a step for the agent */
-    log: (message: string) => void;
+
+declare class CaptureEngine {
+    private outputDir;
+    private currentStepIndex;
+    private recordedSnapshots;
+    constructor(outputDir: string);
+    getSnapshots(): SnapshotMetadata[];
+    getOutputDir(): string;
     /**
-     * Set a mock response for an IPC action.
-     * Changes the data returned by window.__mockIpc.invoke or hybrid bridges in preview mode.
-     * Ignored in desktop mode (IPC goes through real backend).
      */
-    setMockIpc: (action: string, data: any, options?: {
-        type?: MockIpcResponseType;
-        delayMs?: number;
-    }) => Promise<void>;
+    takeSnapshot(page: Page, name: string, viewport: {
+        width: number;
+        height: number;
+    }, options?: CaptureOptions): Promise<SnapshotMetadata>;
     /**
-     * Mock an HTTP REST or GraphQL network request in preview mode.
-     * Intercepts fetch/axios calls matching the URL pattern and returns mock data.
-     *
-     * Example:
-     *   await ctx.setMockRoute('/api/user', { id: 1, name: 'Agent' });
-     *   await ctx.setMockRoute('**\/api/items*', [], { status: 200, delayMs: 50 });
      */
-    setMockRoute: (url: string, body: any, options?: {
-        method?: string;
-        status?: number;
-        delayMs?: number;
-        headers?: Record<string, string>;
-    }) => Promise<void>;
-    /** Return all intercepted console.error and pageerror logs */
-    getConsoleErrors: () => ConsoleEntry[];
-    /** Return all intercepted console.warn logs */
-    getConsoleWarnings: () => ConsoleEntry[];
-    /** Returns true if there are critical errors in the console */
-    hasConsoleErrors: () => boolean;
-    /** Get the visible text of a specific element */
-    readText: (selector: string) => Promise<string | null>;
-    /** Get ALL visible text on the page (useful for quick analysis without Vision) */
-    getPageText: () => Promise<string>;
-    /** Check if the element is visible on the screen */
-    isVisible: (selector: string) => Promise<boolean>;
-    /** Count the number of elements matching the selector */
-    getElementCount: (selector: string) => Promise<number>;
+    takeBurst(page: Page, name: string, viewport: {
+        width: number;
+        height: number;
+    }, options: CaptureBurstOptions): Promise<SnapshotMetadata[]>;
 }
-interface VisualScenario {
-    /** Unique scenario identifier (kebab-case) */
-    id: string;
-    /** Human-readable title for the report */
-    title: string;
-    /** Description of what is being tested */
-    description?: string;
-    /** Initial route to navigate to (e.g., '/instances', '/settings') */
-    route?: string;
-    /** List of viewport sizes to test */
-    viewports?: ViewportPreset[];
-    /**
-   * Initial IPC mock data for preview mode.
-   * Applied BEFORE navigation to the route.
-   */
-    mockIpc?: Array<{
-        action: string;
-        data: any;
-        type?: MockIpcResponseType;
-        delayMs?: number;
-    }>;
-    /**
-     * Initial HTTP REST/GraphQL route mocks for preview mode.
-     * Applied BEFORE navigation to the route.
-     */
-    mockRoutes?: MockRouteEntry[];
-    /**
-     * Optional setup hook: executed before the browser navigates and scenario runs.
-     * Ideal for preparing mock files, test directories, or initial state.
-     */
-    setup?: () => Promise<void> | void;
-    /** The main body of the scenario */
-    run: (ctx: TestContext) => Promise<void>;
-    /**
-     * Optional teardown hook: guaranteed to execute in finally, even if run() fails.
-     * Ideal for cleaning up test artifacts, cache directories, or temporary state.
-     */
-    teardown?: () => Promise<void> | void;
+
+declare class VisualReporter {
+    static generateReport(data: ReportData): string;
+    private static getHealthStatus;
+}
+
+interface AgentLensConfigFile {
+    mode?: 'desktop' | 'preview';
+    port?: number;
+    headed?: boolean;
+    detach?: boolean;
+    buildCommand?: string;
+    autoBuild?: boolean;
+    startCommand?: string;
+    startCwd?: string;
+    cleanArtifacts?: boolean;
+    url?: string;
+    executablePath?: string;
+    clean?: string | string[];
+    scenarios?: string;
+    wwwroot?: string;
+    outDir?: string;
+    env?: Record<string, string>;
+    plugins?: string[];
+}
+declare function loadConfig(cwd?: string): AgentLensConfigFile;
+declare function detectStartCwd(providedCwd?: string): string | undefined;
+declare function resolveWwwrootDir(customDir?: string): string;
+
+declare class PluginManager {
+    private plugins;
+    private jiti;
+    register(plugin: AgentLensPlugin): void;
+    load(pluginSpec: string | AgentLensPlugin): Promise<void>;
+    private loadFromFile;
+    loadAll(specs: (string | AgentLensPlugin)[]): Promise<void>;
+    runSetup(hookContext: PluginHookContext): Promise<void>;
+    launchSession(options: {
+        currentViewport: {
+            width: number;
+            height: number;
+        };
+        headed?: boolean;
+    }, hookContext: PluginHookContext): Promise<DriverLaunchResult | undefined>;
+    runOnContextCreated(context: BrowserContext, hookContext: PluginHookContext): Promise<void>;
+    runOnPageCreated(page: Page, context: BrowserContext, hookContext: PluginHookContext): Promise<void>;
+    extendContext(ctx: TestContext, page: Page, hookContext: PluginHookContext): Promise<void>;
+    runOnAfterRun(reportData: ReportData, hookContext: PluginHookContext): Promise<void>;
+    runTeardown(hookContext: PluginHookContext): Promise<void>;
+    get loadedPlugins(): AgentLensPlugin[];
 }
-declare function defineVisualTest(scenario: VisualScenario): VisualScenario;
 
-export { type CaptureBurstOptions, type CaptureOptions, type MockRouteEntry, type SnapshotMetadata, type TestContext, VIEWPORT_PRESETS, type ViewportPreset, type VisualScenario, defineVisualTest };
+export { type AgentLensConfigFile, AgentLensPlugin, CaptureBurstOptions, CaptureEngine, CaptureOptions, ConsoleEntry, ConsoleTracker, DriverLaunchResult, PluginHookContext, PluginManager, ReportData, type RunOptions, type RunResult, type SnapCliOptions, SnapshotMetadata, TestContext, VisualReporter, VisualScenario, detectStartCwd, loadConfig, resolveWwwrootDir, runQuickSnap, runVisualScenario };