@rolepod/uiproof 0.4.1 → 0.6.0

package/dist/index.d.ts

@@ -3,10 +3,18 @@ import { z } from 'zod';
 import { Page } from 'playwright';
 
 /**
- * Writes artifacts under `./.rolepod-uiproof/artifacts/{run_id}/` (D-026).
+ * Writes run artifacts. In **standalone** mode (default) — and in v0.4 and
+ * earlier — runs live under `./.rolepod-uiproof/artifacts/{prefix}_{ts}_{uuid}/`.
  *
- * v0.1 emits two formats: PNG screenshots and a JSON replay bundle. Future
- * milestones extend the format set (HAR, console log, a11y tree, video).
+ * In **with-parent** mode — activated automatically when the env var
+ * `ROLEPOD_PARENT=1` is set by the parent `rolepod` plugin's SessionStart
+ * hook — runs live under `./.rolepod/evidence/{ts}-rolepod-uiproof-{skill}/`,
+ * per the Extension Protocol v1 evidence-path convention. Parent's
+ * `check-work` skill aggregates manifest.json files from this directory.
+ *
+ * Baselines for `visual_diff` always live in `./.rolepod-uiproof/baselines/`
+ * regardless of mode — they are user-curated configuration, not per-run
+ * evidence.
  */
 type ReplayStep = Record<string, unknown>;
 type ReplayBundle = {
@@ -17,16 +25,45 @@ type ReplayBundle = {
     steps: ReplayStep[];
     expect: ReplayStep[];
 };
+type ArtifactMode = "standalone" | "with-parent";
+type StartRunOptions = {
+    /**
+     * Skill name as it appears in marketplace (`verify-ui`, `audit-a11y`,
+     * `visual-diff`, `scaffold-e2e`, `check-errors`). REQUIRED when emitting
+     * a manifest.json (Extension Protocol v1) so parent's `check-work` can
+     * route artifacts to the right phase.
+     *
+     * In `with-parent` mode the run dirname is derived from this field; if
+     * omitted the `prefix` argument is used as a fallback (legacy).
+     */
+    skill?: string;
+};
+type StartRunResult = {
+    runId: string;
+    runDir: string;
+    skill: string;
+    mode: ArtifactMode;
+};
 declare class ArtifactStore {
     readonly rootDir: string;
+    readonly mode: ArtifactMode;
+    private readonly baselineRoot;
     constructor(opts?: {
         rootDir?: string;
+        mode?: ArtifactMode;
     });
-    /** Allocate a fresh run id and ensure its directory exists. */
-    startRun(prefix?: string): Promise<{
-        runId: string;
-        runDir: string;
-    }>;
+    /**
+     * Allocate a fresh run dir and ensure it exists.
+     *
+     * - standalone: `./.rolepod-uiproof/artifacts/{prefix}_{ts}_{uuid}/`
+     * - with-parent: `./.rolepod/evidence/{ts}-rolepod-uiproof-{skill}/`
+     *
+     * `prefix` is preserved for back-compat with v0.5 callers; new callers
+     * should also pass `opts.skill` so the with-parent path can be derived
+     * unambiguously and the manifest can be emitted with the canonical
+     * skill name.
+     */
+    startRun(prefix?: string, opts?: StartRunOptions): Promise<StartRunResult>;
     writeScreenshot(runDir: string, buf: Buffer, name: string): Promise<string>;
     writeReplayBundle(runDir: string, bundle: ReplayBundle, name?: string): Promise<string>;
     writeReport(runDir: string, name: string, body: string): Promise<string>;
@@ -238,6 +275,269 @@ declare const browserNavigateSchema: z.ZodObject<{
     session_id: z.ZodString;
     url: z.ZodString;
 }, z.core.$strip>;
+declare const browserHoverShape: {
+    readonly session_id: z.ZodString;
+    readonly ref: z.ZodString;
+};
+declare const browserHoverSchema: z.ZodObject<{
+    session_id: z.ZodString;
+    ref: z.ZodString;
+}, z.core.$strip>;
+declare const browserDragShape: {
+    readonly session_id: z.ZodString;
+    readonly from_ref: z.ZodString;
+    readonly to_ref: z.ZodString;
+};
+declare const browserDragSchema: z.ZodObject<{
+    session_id: z.ZodString;
+    from_ref: z.ZodString;
+    to_ref: z.ZodString;
+}, z.core.$strip>;
+declare const browserFillFormShape: {
+    readonly session_id: z.ZodString;
+    readonly fields: z.ZodArray<z.ZodObject<{
+        ref: z.ZodString;
+        value: z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>;
+        kind: z.ZodOptional<z.ZodEnum<{
+            input: "input";
+            select: "select";
+            checkbox: "checkbox";
+            radio: "radio";
+        }>>;
+    }, z.core.$strip>>;
+};
+declare const browserFillFormSchema: z.ZodObject<{
+    session_id: z.ZodString;
+    fields: z.ZodArray<z.ZodObject<{
+        ref: z.ZodString;
+        value: z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>;
+        kind: z.ZodOptional<z.ZodEnum<{
+            input: "input";
+            select: "select";
+            checkbox: "checkbox";
+            radio: "radio";
+        }>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const browserUploadFileShape: {
+    readonly session_id: z.ZodString;
+    readonly ref: z.ZodString;
+    readonly file_path: z.ZodString;
+};
+declare const browserUploadFileSchema: z.ZodObject<{
+    session_id: z.ZodString;
+    ref: z.ZodString;
+    file_path: z.ZodString;
+}, z.core.$strip>;
+declare const browserHandleDialogShape: {
+    readonly session_id: z.ZodString;
+    readonly action: z.ZodEnum<{
+        accept: "accept";
+        dismiss: "dismiss";
+        accept_with_text: "accept_with_text";
+    }>;
+    /** Only used when action='accept_with_text'. */
+    readonly text: z.ZodOptional<z.ZodString>;
+    /**
+     * Arming behavior: registers a one-shot handler for the NEXT dialog
+     * raised on the page. Call this BEFORE the action that triggers the
+     * dialog (e.g. before clicking the button that calls `confirm()`).
+     * Default 30s if no dialog appears, handler is auto-removed.
+     */
+    readonly timeout_ms: z.ZodOptional<z.ZodNumber>;
+};
+declare const browserHandleDialogSchema: z.ZodObject<{
+    session_id: z.ZodString;
+    action: z.ZodEnum<{
+        accept: "accept";
+        dismiss: "dismiss";
+        accept_with_text: "accept_with_text";
+    }>;
+    text: z.ZodOptional<z.ZodString>;
+    timeout_ms: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+declare const browserConsoleShape: {
+    readonly session_id: z.ZodString;
+    /** Filter to only these levels. Default: errors+warnings. */
+    readonly levels: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        info: "info";
+        error: "error";
+        debug: "debug";
+        warning: "warning";
+        log: "log";
+        trace: "trace";
+    }>>>;
+    /** Substring match on message text. */
+    readonly contains: z.ZodOptional<z.ZodString>;
+    /** Drop all buffered messages after returning. */
+    readonly clear: z.ZodDefault<z.ZodBoolean>;
+    /** Cap on returned messages (artifact still holds full ring buffer). */
+    readonly limit: z.ZodDefault<z.ZodNumber>;
+};
+declare const browserConsoleSchema: z.ZodObject<{
+    session_id: z.ZodString;
+    levels: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        info: "info";
+        error: "error";
+        debug: "debug";
+        warning: "warning";
+        log: "log";
+        trace: "trace";
+    }>>>;
+    contains: z.ZodOptional<z.ZodString>;
+    clear: z.ZodDefault<z.ZodBoolean>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+declare const browserNetworkShape: {
+    readonly session_id: z.ZodString;
+    /** Substring or regex (per `pattern_kind`) match on URL. */
+    readonly url_pattern: z.ZodOptional<z.ZodString>;
+    readonly pattern_kind: z.ZodDefault<z.ZodEnum<{
+        substring: "substring";
+        regex: "regex";
+    }>>;
+    readonly method: z.ZodOptional<z.ZodString>;
+    /** Inclusive range — e.g. `{min: 400, max: 599}` for any error response. */
+    readonly status_range: z.ZodOptional<z.ZodObject<{
+        min: z.ZodNumber;
+        max: z.ZodNumber;
+    }, z.core.$strip>>;
+    readonly only_failed: z.ZodDefault<z.ZodBoolean>;
+    /** Write the full HAR file for this session to artifacts/{runId}/network.har. */
+    readonly export_har: z.ZodDefault<z.ZodBoolean>;
+    /** Drop buffered entries after returning. */
+    readonly clear: z.ZodDefault<z.ZodBoolean>;
+    readonly limit: z.ZodDefault<z.ZodNumber>;
+};
+declare const browserNetworkSchema: z.ZodObject<{
+    session_id: z.ZodString;
+    url_pattern: z.ZodOptional<z.ZodString>;
+    pattern_kind: z.ZodDefault<z.ZodEnum<{
+        substring: "substring";
+        regex: "regex";
+    }>>;
+    method: z.ZodOptional<z.ZodString>;
+    status_range: z.ZodOptional<z.ZodObject<{
+        min: z.ZodNumber;
+        max: z.ZodNumber;
+    }, z.core.$strip>>;
+    only_failed: z.ZodDefault<z.ZodBoolean>;
+    export_har: z.ZodDefault<z.ZodBoolean>;
+    clear: z.ZodDefault<z.ZodBoolean>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Runtime environment mutation. Merges resize+emulate. Fields here are
+ * the ones Playwright supports changing AFTER context creation. Things
+ * that must be set at context-creation time (user_agent, locale,
+ * timezone) live on `browser_open` and cannot be changed mid-session.
+ *
+ * `network_throttle` and `cpu_throttle` are chromium-only (CDP-backed).
+ */
+declare const browserSetEnvShape: {
+    readonly session_id: z.ZodString;
+    readonly viewport: z.ZodOptional<z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strip>>;
+    readonly offline: z.ZodOptional<z.ZodBoolean>;
+    readonly geolocation: z.ZodOptional<z.ZodObject<{
+        latitude: z.ZodNumber;
+        longitude: z.ZodNumber;
+        accuracy: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    readonly color_scheme: z.ZodOptional<z.ZodEnum<{
+        light: "light";
+        dark: "dark";
+        "no-preference": "no-preference";
+    }>>;
+    readonly reduced_motion: z.ZodOptional<z.ZodEnum<{
+        reduce: "reduce";
+        "no-preference": "no-preference";
+    }>>;
+    readonly extra_headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    readonly network_throttle: z.ZodOptional<z.ZodEnum<{
+        offline: "offline";
+        "slow-3g": "slow-3g";
+        "fast-3g": "fast-3g";
+        "slow-4g": "slow-4g";
+        "fast-4g": "fast-4g";
+        "no-throttling": "no-throttling";
+    }>>;
+    /** CPU slowdown multiplier (1 = no throttle, 4 = 4x slower). Chromium only. */
+    readonly cpu_throttle: z.ZodOptional<z.ZodNumber>;
+};
+declare const browserSetEnvSchema: z.ZodObject<{
+    session_id: z.ZodString;
+    viewport: z.ZodOptional<z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strip>>;
+    offline: z.ZodOptional<z.ZodBoolean>;
+    geolocation: z.ZodOptional<z.ZodObject<{
+        latitude: z.ZodNumber;
+        longitude: z.ZodNumber;
+        accuracy: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    color_scheme: z.ZodOptional<z.ZodEnum<{
+        light: "light";
+        dark: "dark";
+        "no-preference": "no-preference";
+    }>>;
+    reduced_motion: z.ZodOptional<z.ZodEnum<{
+        reduce: "reduce";
+        "no-preference": "no-preference";
+    }>>;
+    extra_headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    network_throttle: z.ZodOptional<z.ZodEnum<{
+        offline: "offline";
+        "slow-3g": "slow-3g";
+        "fast-3g": "fast-3g";
+        "slow-4g": "slow-4g";
+        "fast-4g": "fast-4g";
+        "no-throttling": "no-throttling";
+    }>>;
+    cpu_throttle: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Execute JavaScript in the page context. GATED: server must be started
+ * with env `ROLEPOD_ALLOW_EVAL=1`, otherwise the tool returns an
+ * `eval_disabled` error. Equivalent to arbitrary code execution — only
+ * enable for trusted automation scenarios.
+ *
+ * `script` is the body of an async function whose return value is sent
+ * back as `result`. Use `args` to pass JSON-serialisable values.
+ */
+declare const browserEvaluateShape: {
+    readonly session_id: z.ZodString;
+    readonly script: z.ZodString;
+    readonly args: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+};
+declare const browserEvaluateSchema: z.ZodObject<{
+    session_id: z.ZodString;
+    script: z.ZodString;
+    args: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+}, z.core.$strip>;
+/**
+ * Multi-page support. A session owns one browser context, which may
+ * have multiple pages (e.g. when an OAuth popup or `target="_blank"`
+ * link opens). The active page index is sticky — all subsequent
+ * tool calls operate on it until `switch_page` changes it.
+ */
+declare const browserPagesShape: {
+    readonly session_id: z.ZodString;
+};
+declare const browserPagesSchema: z.ZodObject<{
+    session_id: z.ZodString;
+}, z.core.$strip>;
+declare const browserSwitchPageShape: {
+    readonly session_id: z.ZodString;
+    readonly index: z.ZodNumber;
+};
+declare const browserSwitchPageSchema: z.ZodObject<{
+    session_id: z.ZodString;
+    index: z.ZodNumber;
+}, z.core.$strip>;
 declare const verifyUiFlowShape: {
     readonly mode: z.ZodDefault<z.ZodEnum<{
         assert: "assert";
@@ -297,6 +597,74 @@ declare const verifyUiFlowShape: {
     }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"navigate">;
         url: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"hover">;
+        query: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"drag">;
+        from_query: z.ZodString;
+        to_query: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"fill_form">;
+        fields: z.ZodArray<z.ZodObject<{
+            query: z.ZodString;
+            value: z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>;
+            kind: z.ZodOptional<z.ZodEnum<{
+                input: "input";
+                select: "select";
+                checkbox: "checkbox";
+                radio: "radio";
+            }>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"upload">;
+        query: z.ZodString;
+        file_path: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"dialog">;
+        action: z.ZodEnum<{
+            accept: "accept";
+            dismiss: "dismiss";
+            accept_with_text: "accept_with_text";
+        }>;
+        text: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"set_env">;
+        viewport: z.ZodOptional<z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strip>>;
+        offline: z.ZodOptional<z.ZodBoolean>;
+        geolocation: z.ZodOptional<z.ZodObject<{
+            latitude: z.ZodNumber;
+            longitude: z.ZodNumber;
+            accuracy: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        color_scheme: z.ZodOptional<z.ZodEnum<{
+            light: "light";
+            dark: "dark";
+            "no-preference": "no-preference";
+        }>>;
+        reduced_motion: z.ZodOptional<z.ZodEnum<{
+            reduce: "reduce";
+            "no-preference": "no-preference";
+        }>>;
+        extra_headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        network_throttle: z.ZodOptional<z.ZodEnum<{
+            offline: "offline";
+            "slow-3g": "slow-3g";
+            "fast-3g": "fast-3g";
+            "slow-4g": "slow-4g";
+            "fast-4g": "fast-4g";
+            "no-throttling": "no-throttling";
+        }>>;
+        cpu_throttle: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"switch_page">;
+        index: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"evaluate">;
+        script: z.ZodString;
     }, z.core.$strip>], "kind">>>;
     readonly expect: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"text_visible">;
@@ -315,8 +683,25 @@ declare const verifyUiFlowShape: {
             visible: "visible";
             enabled: "enabled";
         }>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"no_console_errors">;
+        exclude_patterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"no_failed_requests">;
+        exclude_patterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        allow_4xx: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"request_made">;
+        url_pattern: z.ZodString;
+        method: z.ZodOptional<z.ZodString>;
+        min_count: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"response_status">;
+        url_pattern: z.ZodString;
+        status: z.ZodNumber;
     }, z.core.$strip>], "kind">>>;
     readonly capture: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        trace: "trace";
         screenshot: "screenshot";
         har: "har";
         console: "console";
@@ -390,6 +775,74 @@ declare const verifyUiFlowSchema: z.ZodObject<{
     }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"navigate">;
         url: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"hover">;
+        query: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"drag">;
+        from_query: z.ZodString;
+        to_query: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"fill_form">;
+        fields: z.ZodArray<z.ZodObject<{
+            query: z.ZodString;
+            value: z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>;
+            kind: z.ZodOptional<z.ZodEnum<{
+                input: "input";
+                select: "select";
+                checkbox: "checkbox";
+                radio: "radio";
+            }>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"upload">;
+        query: z.ZodString;
+        file_path: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"dialog">;
+        action: z.ZodEnum<{
+            accept: "accept";
+            dismiss: "dismiss";
+            accept_with_text: "accept_with_text";
+        }>;
+        text: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"set_env">;
+        viewport: z.ZodOptional<z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strip>>;
+        offline: z.ZodOptional<z.ZodBoolean>;
+        geolocation: z.ZodOptional<z.ZodObject<{
+            latitude: z.ZodNumber;
+            longitude: z.ZodNumber;
+            accuracy: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        color_scheme: z.ZodOptional<z.ZodEnum<{
+            light: "light";
+            dark: "dark";
+            "no-preference": "no-preference";
+        }>>;
+        reduced_motion: z.ZodOptional<z.ZodEnum<{
+            reduce: "reduce";
+            "no-preference": "no-preference";
+        }>>;
+        extra_headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        network_throttle: z.ZodOptional<z.ZodEnum<{
+            offline: "offline";
+            "slow-3g": "slow-3g";
+            "fast-3g": "fast-3g";
+            "slow-4g": "slow-4g";
+            "fast-4g": "fast-4g";
+            "no-throttling": "no-throttling";
+        }>>;
+        cpu_throttle: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"switch_page">;
+        index: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"evaluate">;
+        script: z.ZodString;
     }, z.core.$strip>], "kind">>>;
     expect: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"text_visible">;
@@ -408,8 +861,25 @@ declare const verifyUiFlowSchema: z.ZodObject<{
             visible: "visible";
             enabled: "enabled";
         }>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"no_console_errors">;
+        exclude_patterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"no_failed_requests">;
+        exclude_patterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        allow_4xx: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"request_made">;
+        url_pattern: z.ZodString;
+        method: z.ZodOptional<z.ZodString>;
+        min_count: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"response_status">;
+        url_pattern: z.ZodString;
+        status: z.ZodNumber;
     }, z.core.$strip>], "kind">>>;
     capture: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        trace: "trace";
         screenshot: "screenshot";
         har: "har";
         console: "console";
@@ -664,6 +1134,17 @@ declare const ToolNames: {
     readonly browserWaitFor: "rolepod_browser_wait_for";
     readonly browserScreenshot: "rolepod_browser_screenshot";
     readonly browserNavigate: "rolepod_browser_navigate";
+    readonly browserHover: "rolepod_browser_hover";
+    readonly browserDrag: "rolepod_browser_drag";
+    readonly browserFillForm: "rolepod_browser_fill_form";
+    readonly browserUploadFile: "rolepod_browser_upload_file";
+    readonly browserHandleDialog: "rolepod_browser_handle_dialog";
+    readonly browserConsole: "rolepod_browser_console";
+    readonly browserNetwork: "rolepod_browser_network";
+    readonly browserSetEnv: "rolepod_browser_set_env";
+    readonly browserEvaluate: "rolepod_browser_evaluate";
+    readonly browserPages: "rolepod_browser_pages";
+    readonly browserSwitchPage: "rolepod_browser_switch_page";
     readonly verifyUiFlow: "rolepod_verify_ui_flow";
     readonly auditA11y: "rolepod_audit_a11y";
     readonly visualDiff: "rolepod_visual_diff";
@@ -710,6 +1191,30 @@ type OpenOptions = {
     app_package?: string;
     app_activity?: string;
     emulator?: string;
+    /**
+     * v0.5 capture lifecycle. Pass when the session needs HAR/video/trace
+     * recording. These MUST be requested at open time because Playwright
+     * wires recordHar/recordVideo at context creation.
+     */
+    capture?: {
+        har?: {
+            path: string;
+        };
+        video?: {
+            dir: string;
+            sizeWidth?: number;
+            sizeHeight?: number;
+        };
+        trace?: {
+            artifactDir: string;
+        };
+    };
+};
+type FillFieldKind = "input" | "select" | "checkbox" | "radio";
+type FillField = {
+    ref: string;
+    value: string | boolean;
+    kind?: FillFieldKind;
 };
 /** Opaque session handle returned by `Engine.open`. */
 interface Session {
@@ -742,6 +1247,21 @@ interface Engine {
     screenshot(session: Session, fullPage?: boolean): Promise<Buffer>;
     /** Web-only. Throws `unsupported_platform` on mobile sessions. */
     navigate(session: Session, url: string): Promise<void>;
+    /** Move pointer / hover over the element identified by `ref`. */
+    hover(session: Session, ref: string): Promise<void>;
+    /** Drag element `from` onto element `to`. */
+    drag(session: Session, fromRef: string, toRef: string): Promise<void>;
+    /**
+     * Batch-fill multiple form fields in a single call. Token-efficient
+     * alternative to a sequence of `type` calls; also handles checkboxes,
+     * radios, and `<select>` options.
+     */
+    fillForm(session: Session, fields: FillField[]): Promise<void>;
+    /**
+     * Attach a local file to the file input identified by `ref`.
+     * Path MUST be absolute on the host filesystem.
+     */
+    uploadFile(session: Session, ref: string, filePath: string): Promise<void>;
 }
 
 /**
@@ -775,7 +1295,7 @@ declare class SessionRegistry {
 }
 
 declare const SERVER_NAME = "rolepod-uiproof";
-declare const SERVER_VERSION = "0.4.1";
+declare const SERVER_VERSION = "0.6.0";
 type ServerHandle = {
     mcp: McpServer;
     registry: SessionRegistry;
@@ -792,6 +1312,23 @@ declare function buildServer(opts?: {
     idleTimeoutMs?: number;
 }): ServerHandle;
 
+type ConsoleEntry = {
+    level: "error" | "warning" | "info" | "log" | "debug" | "trace";
+    text: string;
+    ts: string;
+    /** Best-effort file:line if Playwright provides it. */
+    location?: string;
+};
+type NetworkEntry = {
+    id: number;
+    url: string;
+    method: string;
+    status?: number;
+    failure?: string;
+    resource_type: string;
+    ts: string;
+    duration_ms?: number;
+};
 /**
  * PlaywrightEngine — v0.1 web-only implementation backed by Playwright's
  * Chromium / Firefox / WebKit drivers and the built-in
@@ -826,6 +1363,86 @@ declare class PlaywrightEngine implements Engine {
     getPageForSession(sessionId: string): Page;
     /** Increment generation; the next ref-using call will see them as stale. */
     bumpGeneration(sessionId: string): void;
+    hover(session: Session, ref: string): Promise<void>;
+    drag(session: Session, fromRef: string, toRef: string): Promise<void>;
+    fillForm(session: Session, fields: FillField[]): Promise<void>;
+    uploadFile(session: Session, ref: string, filePath: string): Promise<void>;
+    /**
+     * Pre-arm a one-shot dialog handler for the next dialog raised on the
+     * active page. Returns when either the dialog fires (and is handled)
+     * or the timeout elapses. The caller is expected to trigger the
+     * dialog (via click etc.) AFTER arming.
+     */
+    handleDialog(sessionId: string, opts: {
+        action: "accept" | "dismiss" | "accept_with_text";
+        text?: string;
+        timeoutMs?: number;
+    }): Promise<{
+        handled: boolean;
+    }>;
+    getConsole(sessionId: string, opts?: {
+        levels?: ConsoleEntry["level"][];
+        contains?: string;
+        clear?: boolean;
+        limit?: number;
+    }): ConsoleEntry[];
+    getNetwork(sessionId: string, opts?: {
+        urlPattern?: string;
+        patternKind?: "substring" | "regex";
+        method?: string;
+        statusRange?: {
+            min: number;
+            max: number;
+        };
+        onlyFailed?: boolean;
+        clear?: boolean;
+        limit?: number;
+    }): NetworkEntry[];
+    /**
+     * Read the consoleBuffer/networkBuffer directly without filtering —
+     * used by verify_ui_flow expect evaluators.
+     */
+    peekBuffers(sessionId: string): {
+        console: ConsoleEntry[];
+        network: NetworkEntry[];
+    };
+    /**
+     * Runtime mutation of context-level emulation. CPU + network throttle
+     * use CDP and only work on chromium; everything else is cross-browser.
+     */
+    setEnv(sessionId: string, opts: {
+        viewport?: {
+            width: number;
+            height: number;
+        };
+        offline?: boolean;
+        geolocation?: {
+            latitude: number;
+            longitude: number;
+            accuracy?: number;
+        };
+        colorScheme?: "light" | "dark" | "no-preference";
+        reducedMotion?: "reduce" | "no-preference";
+        extraHeaders?: Record<string, string>;
+        networkThrottle?: "offline" | "slow-3g" | "fast-3g" | "slow-4g" | "fast-4g" | "no-throttling";
+        cpuThrottle?: number;
+    }): Promise<void>;
+    /**
+     * Execute a JavaScript function in the page context. ALWAYS gated by
+     * the tool layer (`ROLEPOD_ALLOW_EVAL=1`); this method does not enforce
+     * the env check.
+     */
+    evaluate(sessionId: string, script: string, args?: unknown[]): Promise<unknown>;
+    listPages(sessionId: string): {
+        index: number;
+        url: string;
+        title_promise: Promise<string>;
+        active: boolean;
+    }[];
+    switchPage(sessionId: string, index: number): Promise<void>;
+    private activePage;
+    private attachPageListeners;
+    private handlePageDialog;
     private requireSession;
     private resolveLocator;
     private invalidateRefs;
@@ -862,6 +1479,14 @@ declare class AppiumEngine implements Engine {
     waitFor(session: Session, cond: WaitCondition, timeoutMs?: number): Promise<void>;
     screenshot(session: Session, _fullPage?: boolean): Promise<Buffer>;
     navigate(_session: Session, _url: string): Promise<void>;
+    hover(_session: Session, _ref: string): Promise<void>;
+    drag(_session: Session, _fromRef: string, _toRef: string): Promise<void>;
+    fillForm(session: Session, fields: {
+        ref: string;
+        value: string | boolean;
+        kind?: string;
+    }[]): Promise<void>;
+    uploadFile(_session: Session, _ref: string, _filePath: string): Promise<void>;
     private loadWdio;
     private buildCapabilities;
     private screenIdentifier;
@@ -915,4 +1540,4 @@ declare class UnsupportedPlatformError extends RolepodMcpError {
     constructor(platform: string);
 }
 
-export { type A11yNode, type A11ySnapshot, AppiumEngine, ArtifactStore, type Engine, type OpenOptions, type Platform, PlaywrightEngine, RolepodMcpError, SERVER_NAME, SERVER_VERSION, type ServerHandle, type Session, SessionRegistry, StaleRefError, type ToolName, ToolNames, UnknownRefError, UnknownSessionError, UnsupportedPlatformError, type WaitCondition, auditA11ySchema, auditA11yShape, browserClickSchema, browserClickShape, browserCloseSchema, browserCloseShape, browserKeySchema, browserKeyShape, browserNavigateSchema, browserNavigateShape, browserOpenSchema, browserOpenShape, browserScreenshotSchema, browserScreenshotShape, browserScrollSchema, browserScrollShape, browserSnapshotSchema, browserSnapshotShape, browserTypeSchema, browserTypeShape, browserWaitForSchema, browserWaitForShape, buildServer, createEngine, createMobileEngine, createWebEngine, extractUiStateSchema, extractUiStateShape, scaffoldE2eSchema, scaffoldE2eShape, verifyUiFlowSchema, verifyUiFlowShape, visualDiffSchema, visualDiffShape };
+export { type A11yNode, type A11ySnapshot, AppiumEngine, ArtifactStore, type Engine, type OpenOptions, type Platform, PlaywrightEngine, RolepodMcpError, SERVER_NAME, SERVER_VERSION, type ServerHandle, type Session, SessionRegistry, StaleRefError, type ToolName, ToolNames, UnknownRefError, UnknownSessionError, UnsupportedPlatformError, type WaitCondition, auditA11ySchema, auditA11yShape, browserClickSchema, browserClickShape, browserCloseSchema, browserCloseShape, browserConsoleSchema, browserConsoleShape, browserDragSchema, browserDragShape, browserEvaluateSchema, browserEvaluateShape, browserFillFormSchema, browserFillFormShape, browserHandleDialogSchema, browserHandleDialogShape, browserHoverSchema, browserHoverShape, browserKeySchema, browserKeyShape, browserNavigateSchema, browserNavigateShape, browserNetworkSchema, browserNetworkShape, browserOpenSchema, browserOpenShape, browserPagesSchema, browserPagesShape, browserScreenshotSchema, browserScreenshotShape, browserScrollSchema, browserScrollShape, browserSetEnvSchema, browserSetEnvShape, browserSnapshotSchema, browserSnapshotShape, browserSwitchPageSchema, browserSwitchPageShape, browserTypeSchema, browserTypeShape, browserUploadFileSchema, browserUploadFileShape, browserWaitForSchema, browserWaitForShape, buildServer, createEngine, createMobileEngine, createWebEngine, extractUiStateSchema, extractUiStateShape, scaffoldE2eSchema, scaffoldE2eShape, verifyUiFlowSchema, verifyUiFlowShape, visualDiffSchema, visualDiffShape };