raven-mcp 1.6.2 → 1.8.0

package/README.md

@@ -18,6 +18,7 @@ Raven gives Claude access to a comprehensive design knowledge base:
 - **Brand & visual** — Logo usage (clear space, min sizes, variants, placement, restraint), gradient usage (hierarchy, palette, contrast, trend vs signature), imagery (consistency, representation, purpose), visual hierarchy, brand-as-system, and current (2026) visual-design trends
 - **Business** — Monetization models, retention strategies, onboarding optimization, growth mechanics, and product metrics frameworks
 - **Tokens** — Design system tokens for Stripe, Linear, and more
+- **Creative studio** — Local-first brand profiles, asset references, character reference profiles, provider-agnostic image/video/3D/audio generation jobs, campaign plans, and transparent creative scoring. Raven does not ship media-provider credentials; set `RAVEN_CREATIVE_RUNNER` to route jobs to your own renderer.
 
 ## Install
 
@@ -54,7 +55,7 @@ cd raven-mcp && npm install && npm run build
 | `get_principles` | Get design principles relevant to a UI context |
 | `get_pattern` | Get proven patterns for a specific UI type |
 | `get_business_strategy` | Get business/monetization strategies |
-| `evaluate_design` | Evaluate a design description against principles |
+| `evaluate_design` | Evaluate a design description against principles. Pass base64 PNG screenshots (`before_screenshot`/`after_screenshot`) for a structured before/after pixel diff with `fix_confirmed`, `changed_ratio`, and changed region. |
 | `search_knowledge` | Search across all principles, patterns, and strategies |
 | `get_checklist` | Get a pre-publish checklist for a UI type |
 | `get_d4d_framework` | Get Design for Delight framework templates |
@@ -62,8 +63,10 @@ cd raven-mcp && npm install && npm run build
 | `get_design_system` | Get tokens for a specific design system |
 | `compose_system` | Mix tokens from different systems |
 | `get_brand_system` | Get a full system styled like a well-known brand |
-| `audit_page` | Audit HTML/CSS against Raven's quality standards (optional `containerMaxWidth` makes the container check token-aware) |
+| `audit_page` | Audit HTML/CSS against Raven's quality standards — pass `html` for static audit, or `url` to render headless with optional `scroll_settle` (scroll to bottom + settle reveals) and `viewport` parameters; `containerMaxWidth` makes container checks token-aware |
 | `audit_layout` | Evaluate visual rhythm, alignment, and optical balance |
+| `audit_responsive_visibility` | Render a URL at multiple breakpoints and flag content elements that are visible on desktop but hidden on mobile (display:none/opacity:0/zero-size) — categorises each as likely-oversight (content vanishing on mobile) vs intentional (decorative) |
+| `audit_contrast` | Compute WCAG contrast ratios for every text element on a rendered page and report AA (4.5:1 / 3:1 large) and AAA pass-fail per element, with delta-to-pass for failures |
 | `audit_swiftui` | Audit SwiftUI source against Apple HIG — Dynamic Type, semantic colors, 44pt targets, 4/8pt spacing, AccentColor |
 | `audit_ios_screen` | Score a rendered iOS screen from an accessibility/view-hierarchy snapshot — 44pt targets + contrast + rhythm, in points |
 | `audit_ios_privacy` | Audit Info.plist (or Expo app.json) /PRIVACY.md/entitlements/source — usage-string honesty, ATS, Android permissions, bundled secrets, undisclosed default data-egress |
@@ -80,8 +83,33 @@ cd raven-mcp && npm install && npm run build
 | `generate_service_blueprint` | Render a service blueprint as HTML — current state, or current vs. ideal side-by-side |
 | `get_brand_principles` | Get brand/visual principles — logo, gradient, imagery, hierarchy, brand-as-system |
 | `get_brand_trends` | Get current (2026) brand and visual-design trends with usage guidance |
+| `list_creative_models` | Browse provider-agnostic creative model slots for image, video, 3D, audio, character consistency, and analysis |
+| `list_creative_presets` | Browse creative presets: product photoshoot, marketplace cards, UGC ads, TV spots, social packs, storyboards, infographics |
+| `create_brand_profile` | Create or update a local brand profile for brand-aware creative jobs |
+| `get_brand_profile` | Read a local creative brand profile |
+| `list_brand_profiles` | List local creative brand profiles |
+| `register_creative_asset` | Register a local path or URL as a creative asset reference — no file bytes are uploaded by Raven |
+| `create_character_profile` | Create a local character/identity reference profile from registered assets |
+| `create_generation_job` | Create a provider-agnostic image, video, audio, 3D, campaign, or analysis job payload; optionally execute via `RAVEN_CREATIVE_RUNNER` |
+| `get_generation_job` | Read a creative generation job and its provider payload/output state |
+| `list_generation_jobs` | List local creative generation jobs |
+| `plan_creative_campaign` | Plan a multi-asset campaign and optionally create draft generation jobs |
+| `score_creative` | Score a prompt/script/concept for hook, benefit clarity, product signal, CTA, channel fit, audience fit, and brand fit |
 | `raven_reflect` | Summarize your local Raven usage log to find patterns + gaps |
 
+## Creative studio
+
+Raven now covers the creative-production workflow around media generation without copying or depending on any closed vendor. The tools are orchestration primitives:
+
+- Store brand kits locally with `create_brand_profile`.
+- Register product photos, logos, references, or URLs with `register_creative_asset`.
+- Create character/identity reference sets with `create_character_profile`.
+- Generate provider-ready payloads with `create_generation_job`.
+- Build full campaign shot lists with `plan_creative_campaign`.
+- Score creative concepts with `score_creative`.
+
+By default, jobs are saved as local draft payloads under `~/.raven/creative` (override with `RAVEN_CREATIVE_HOME`). To run real media generation, set `RAVEN_CREATIVE_RUNNER` to an executable that reads one job JSON object from stdin and returns JSON on stdout. That runner can call any provider you choose; Raven never stores API keys in source.
+
 ## iOS / SwiftUI audits
 
 Raven audits native iOS apps against the **Apple Human Interface Guidelines**, not web/CSS conventions. None of the web-only rules (`lang`, `title`, `flex-wrap`, `clamp`, `max-width`, CSS custom properties, bare hex) run on iOS input — and `get_checklist`/`get_principles` take `platform: "ios"` to return HIG items (Dynamic Type, 44pt targets, SF Symbols, safe areas, dark-mode parity, App Review privacy) instead of the web set.
@@ -103,6 +131,63 @@ Anyone building a React Native or Expo app gets the same treatment. RN renders t
 
 **One command:** `node scripts/rn-audit.mjs <app-dir> [--snapshot snap.json] [--md report.md]` discovers screens + `app.json` (reading `userInterfaceStyle` so dark-only apps aren't false-flagged) and runs everything.
 
+## Responsive visibility audits
+
+`audit_responsive_visibility` renders a page at multiple breakpoints (default: 390px mobile, 768px tablet, 1440px desktop, 2160px ultra-wide) and flags content elements that are visible on desktop but hidden on mobile — catching the "vanishes on mobile" bug class. Each flagged element is categorised as **likely-oversight** (content that shouldn't be hidden) or **intentional** (decorative elements). Detects hiding via CSS (`hidden`, `display:none`, `opacity:0`, `visibility:hidden`) and responsive Tailwind classes (`hidden md:block`, etc.).
+
+**Usage:**
+- `audit_responsive_visibility(url)` — render at default breakpoints and flag mismatches.
+- `audit_responsive_visibility(url, [390, 768, 1440])` — custom breakpoints.
+- Optional `viewportHeight` (default: 900px) for tall content.
+
+Returns flagged elements with selector, hiding class, visibility at each breakpoint, and category.
+
+## Contrast audits
+
+`audit_contrast` computes WCAG contrast ratios for every text element on a rendered page, reporting AA (4.5:1 normal text, 3:1 large) and AAA (7:1 normal, 4.5:1 large) pass-fail. Useful for catching small-text / low-contrast pairs that a screenshot eyedropper would catch manually — Raven replaces the math.
+
+**Usage:**
+- `audit_contrast(url)` — render a live page and audit all text.
+- `audit_contrast(dom_snapshot: [{ selector, color, bgColor, fontPx?, bold?, text? }])` — audit a pre-captured snapshot (useful for dynamic or cookie-protected pages).
+
+Returns all text elements scored, failures highlighted with delta-to-pass, and a summary of AA/AAA failure count.
+
+**WCAG math:** Contrast ratio uses linearised luminance (WCAG 2.1 § 1.4.3) — black-on-white is exactly 21, white-on-black is exactly 21. Large text (18.66pt+ bold or 24pt+) needs only 3:1 / 4.5:1 AAA; regular text needs 4.5:1 / 7:1.
+
+## Headless browser audits
+
+`audit_page` can render a live URL in headless Chromium, scroll to settle reveal-on-scroll elements, and play preload=none videos before capturing — preventing false "blank section" reports caused by whileInView states that haven't fired yet.
+
+**Usage:**
+- **Static HTML mode** — pass `html` string for immediate static analysis (existing behavior, no change).
+- **Rendered URL mode** — pass `url` (full HTTP/HTTPS URL). Raven launches Chromium, renders the page, optionally scrolls, and audits the live DOM.
+  - `scroll_settle: true` — scroll from top to bottom in viewport-height steps, then wait 300ms for `IntersectionObserver` / whileInView reveals to fire. Unloaded videos (preload="none") are played to detect if they render blank. This surfaces the real rendered state and avoids false positives on reveal-on-scroll or lazy-loaded content.
+  - `viewport: { w, h }` — set the render viewport (default: `{ w: 1440, h: 900 }`).
+
+**Video artifacts detection:** If any `<video>` with `preload="none"` (or missing preload) renders with `readyState < 2` (i.e. would show a black box in a screenshot), Raven flags it as an `unloaded-video-artifact` in the result. This is **informational** — not a pass/fail — since preload=none is often intentional. On cookie-protected hosts, video requests may fail because iOS/Android media daemons don't send cookies; Raven notes this to help you troubleshoot (e.g. disable deployment protection, use a token-based bypass).
+
+**Adversarial verification:** Set `adversarial_verify: true` to independently re-check each finding against the live DOM using a different method. Findings are tagged:
+- `confirmed` — the finding is real on the live page (e.g. missing `<title>` in the rendered DOM)
+- `likely-artifact` — the finding is an artifact of the static audit method (e.g. a `<video preload="none">` rendered blank, which is expected behavior, not a missing resource)
+- `inconclusive` — the finding cannot be independently verified (e.g. aggregate rules like color-palette size)
+
+The result includes `adversarial_verification: { debunked_count, confirmed_count, inconclusive_count }`, where debunked_count is the number of likely-artifacts. This surfaces false positives so you only fix real issues. Backwards-compatible: when `adversarial_verify` is absent or false, the output is identical to prior versions.
+
+**Setup:** First time only, run `npx playwright install chromium` to download the browser binary. If the binary is missing when you call audit_page with `url`, you'll see a clear instruction to run the install command.
+
+## Before/after design diffs
+
+`evaluate_design` can now accept base64-encoded PNG screenshots to measure whether a fix actually changed the rendered output.
+
+**Usage:**
+- Pass `before_screenshot` and `after_screenshot` (both base64 PNGs, with or without the `data:image/png;base64,` prefix).
+- Raven returns `fix_confirmed: true` if the images differ by > 0.1% of pixels (accounting for jpeg/PNG decode variance).
+- `changed_ratio` — exact fraction of pixels that changed (0–1).
+- `changed_region` — bounding box `{ x, y, w, h }` of the changed pixels (null if no changes detected).
+- `dimensions` — image-derived measurements (canvas size, brightness, color shift) as context, with the caveat that these are pixel-level proxies, not Raven principle scores.
+
+When before/after screenshots are provided alongside a `description`, `evaluate_design` returns both the principle-based evaluation and the pixel diff. When screenshots are provided without a description, the evaluation gracefully skips the principle search and returns the diff only. Backwards-compatible: without screenshots, the tool behaves identically to prior versions.
+
 ## Release updates
 
 Raven ships new principles, patterns, and brand systems regularly. For one email per minor/major release (patches stay quiet):

package/dist/api-contract.d.ts

@@ -0,0 +1,36 @@
+export type ShapeSchema = {
+    required?: string[];
+    types?: Record<string, "string" | "number" | "boolean" | "object" | "array">;
+};
+export type Query = {
+    name: string;
+    method?: "GET" | "POST";
+    path?: string;
+    headers?: Record<string, string>;
+    body?: unknown;
+    expect?: {
+        contains?: string[];
+        equals?: Record<string, unknown>;
+    };
+};
+export type QueryVerdict = {
+    name: string;
+    verdict: "shape-valid" | "shape-invalid" | "confident-wrong" | "uncertain";
+    reason: string;
+    offending?: string;
+    status?: number;
+};
+export type ApiContractResult = {
+    results: QueryVerdict[];
+    shape_valid_count: number;
+    confident_wrong_count: number;
+    shape_invalid_count: number;
+    uncertain_count: number;
+};
+export declare function getPath(obj: unknown, path: string): unknown;
+export declare function validateShape(response: unknown, schema: ShapeSchema): {
+    valid: boolean;
+    offending?: string;
+    reason: string;
+};
+export declare function runApiContract(endpointUrl: string, queries: Query[], schema: ShapeSchema): Promise<ApiContractResult>;

package/dist/api-contract.js

@@ -0,0 +1,235 @@
+export function getPath(obj, path) {
+    const segments = path.split(".");
+    let current = obj;
+    for (let index = 0; index < segments.length; index += 1) {
+        const segment = segments[index];
+        if (Array.isArray(current)) {
+            if (!isArrayIndex(segment)) {
+                return undefined;
+            }
+            const arrayIndex = Number(segment);
+            if (arrayIndex >= current.length) {
+                return undefined;
+            }
+            current = current[arrayIndex];
+            continue;
+        }
+        if (!isRecord(current)) {
+            return undefined;
+        }
+        if (!Object.prototype.hasOwnProperty.call(current, segment)) {
+            return undefined;
+        }
+        current = current[segment];
+    }
+    return current;
+}
+export function validateShape(response, schema) {
+    const required = schema.required || [];
+    for (let index = 0; index < required.length; index += 1) {
+        const path = required[index];
+        if (getPath(response, path) === undefined) {
+            return {
+                valid: false,
+                offending: path,
+                reason: "missing required path: " + path
+            };
+        }
+    }
+    const types = schema.types || {};
+    const entries = Object.entries(types);
+    for (let index = 0; index < entries.length; index += 1) {
+        const path = entries[index][0];
+        const expected = entries[index][1];
+        const value = getPath(response, path);
+        if (value === undefined) {
+            continue;
+        }
+        if (!matchesType(value, expected)) {
+            return {
+                valid: false,
+                offending: path,
+                reason: "type mismatch at " + path + ": expected " + expected
+            };
+        }
+    }
+    return { valid: true, reason: "all checks passed" };
+}
+export async function runApiContract(endpointUrl, queries, schema) {
+    const results = [];
+    for (let index = 0; index < queries.length; index += 1) {
+        const query = queries[index];
+        const controller = new AbortController();
+        const timeout = setTimeout(function abortRequest() {
+            controller.abort();
+        }, 10000);
+        let response;
+        try {
+            response = await fetch(endpointUrl + (query.path || ""), {
+                method: query.method || "GET",
+                headers: requestHeaders(query),
+                body: query.method === "POST" ? JSON.stringify(query.body) : undefined,
+                signal: controller.signal
+            });
+        }
+        catch (error) {
+            results.push({
+                name: query.name,
+                verdict: "uncertain",
+                reason: errorMessage(error)
+            });
+            clearTimeout(timeout);
+            continue;
+        }
+        clearTimeout(timeout);
+        let parsed;
+        try {
+            parsed = await response.json();
+        }
+        catch {
+            results.push({
+                name: query.name,
+                verdict: "uncertain",
+                reason: "non-JSON response",
+                status: response.status
+            });
+            continue;
+        }
+        if (response.status < 200 || response.status >= 300) {
+            results.push({
+                name: query.name,
+                verdict: "uncertain",
+                reason: "HTTP " + response.status,
+                status: response.status
+            });
+            continue;
+        }
+        const shape = validateShape(parsed, schema);
+        if (!shape.valid) {
+            results.push({
+                name: query.name,
+                verdict: "shape-invalid",
+                reason: shape.reason,
+                offending: shape.offending,
+                status: response.status
+            });
+            continue;
+        }
+        const expected = query.expect;
+        const confidentWrong = expected ? checkExpectations(parsed, expected) : null;
+        if (confidentWrong) {
+            results.push({
+                name: query.name,
+                verdict: "confident-wrong",
+                reason: confidentWrong.reason,
+                offending: confidentWrong.offending,
+                status: response.status
+            });
+            continue;
+        }
+        results.push({
+            name: query.name,
+            verdict: "shape-valid",
+            reason: "all checks passed",
+            status: response.status
+        });
+    }
+    return tallyResults(results);
+}
+function isArrayIndex(segment) {
+    return /^\d+$/.test(segment);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function matchesType(value, expected) {
+    if (expected === "array") {
+        return Array.isArray(value);
+    }
+    if (expected === "object") {
+        return typeof value === "object" && value !== null && !Array.isArray(value);
+    }
+    return typeof value === expected;
+}
+function requestHeaders(query) {
+    if (!query.headers && query.method !== "POST") {
+        return undefined;
+    }
+    const headers = { ...(query.headers || {}) };
+    if (query.method === "POST" && !hasHeader(headers, "content-type")) {
+        headers["Content-Type"] = "application/json";
+    }
+    return headers;
+}
+function hasHeader(headers, name) {
+    const names = Object.keys(headers);
+    const target = name.toLowerCase();
+    for (let index = 0; index < names.length; index += 1) {
+        if (names[index].toLowerCase() === target) {
+            return true;
+        }
+    }
+    return false;
+}
+function checkExpectations(parsed, expected) {
+    const serialized = JSON.stringify(parsed);
+    const contains = expected.contains || [];
+    for (let index = 0; index < contains.length; index += 1) {
+        const expectedString = contains[index];
+        if (!serialized.includes(expectedString)) {
+            return {
+                reason: "expected string not found: " + expectedString,
+                offending: expectedString
+            };
+        }
+    }
+    const equals = expected.equals || {};
+    const entries = Object.entries(equals);
+    for (let index = 0; index < entries.length; index += 1) {
+        const path = entries[index][0];
+        const expectedValue = entries[index][1];
+        const actualValue = getPath(parsed, path);
+        if (JSON.stringify(actualValue) !== JSON.stringify(expectedValue)) {
+            return {
+                reason: "value mismatch at " + path,
+                offending: path
+            };
+        }
+    }
+    return null;
+}
+function tallyResults(results) {
+    let shapeValidCount = 0;
+    let confidentWrongCount = 0;
+    let shapeInvalidCount = 0;
+    let uncertainCount = 0;
+    for (let index = 0; index < results.length; index += 1) {
+        const result = results[index];
+        if (result.verdict === "shape-valid") {
+            shapeValidCount += 1;
+        }
+        else if (result.verdict === "confident-wrong") {
+            confidentWrongCount += 1;
+        }
+        else if (result.verdict === "shape-invalid") {
+            shapeInvalidCount += 1;
+        }
+        else if (result.verdict === "uncertain") {
+            uncertainCount += 1;
+        }
+    }
+    return {
+        results,
+        shape_valid_count: shapeValidCount,
+        confident_wrong_count: confidentWrongCount,
+        shape_invalid_count: shapeInvalidCount,
+        uncertain_count: uncertainCount
+    };
+}
+function errorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+//# sourceMappingURL=api-contract.js.map

package/dist/api-contract.js.map

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

package/dist/asset-integrity.d.ts

@@ -0,0 +1,13 @@
+export type AssetIntegrityResult = {
+    path: string;
+    bottom_variance: number;
+    verdict: "clean" | "likely-sliced";
+    confidence: number;
+    warnings: string[];
+};
+export type AssetIntegrityOptions = {
+    bottomFraction?: number;
+    minRows?: number;
+    varianceThreshold?: number;
+};
+export declare function auditAssetIntegrity(imagePaths: string[], opts?: AssetIntegrityOptions): Promise<AssetIntegrityResult[]>;

package/dist/asset-integrity.js

@@ -0,0 +1,104 @@
+import { readFileSync } from "node:fs";
+const DATA_URL_PREFIX = /^data:image\/png;base64,/i;
+export async function auditAssetIntegrity(imagePaths, opts = {}) {
+    // @ts-ignore pngjs is intentionally optional; absence falls back to clean-with-warning.
+    const pngMod = (await import("pngjs").catch(() => null));
+    const PNG = pngMod?.PNG;
+    const readPng = PNG?.sync?.read;
+    return imagePaths.map(function (imagePath) {
+        let buffer;
+        try {
+            buffer = readFileSync(imagePath);
+        }
+        catch (error) {
+            return fallbackResult(imagePath, [
+                "Could not read file: " + errorMessage(error)
+            ]);
+        }
+        if (!readPng) {
+            return fallbackResult(imagePath, [
+                "pngjs not installed — cannot analyze asset integrity"
+            ]);
+        }
+        try {
+            return auditPng(imagePath, readPng(buffer), opts);
+        }
+        catch (error) {
+            return fallbackResult(imagePath, [
+                "Failed to decode PNG: " + errorMessage(error)
+            ]);
+        }
+    });
+}
+function stripPngPrefix(base64) {
+    return base64.replace(DATA_URL_PREFIX, "");
+}
+function fallbackResult(path, warnings) {
+    return {
+        path,
+        bottom_variance: 0,
+        verdict: "clean",
+        confidence: 0,
+        warnings
+    };
+}
+function auditPng(path, png, opts) {
+    const threshold = opts.varianceThreshold ?? 100;
+    const bottomFraction = opts.bottomFraction ?? 0.05;
+    const minRows = opts.minRows ?? 20;
+    const stripHeight = Math.min(png.height, Math.max(minRows, Math.round(png.height * bottomFraction)));
+    const bottomVariance = bottomLuminanceVariance(png, stripHeight);
+    const verdict = bottomVariance > threshold ? "likely-sliced" : "clean";
+    // Confidence is monotonic around the variance threshold: clean approaches 1 as
+    // variance approaches 0; likely-sliced starts at 0.5 and approaches 1 by 4x threshold.
+    const confidence = verdict === "clean"
+        ? clamp(1 - bottomVariance / threshold, 0, 1)
+        : Math.max(0.5, clamp(bottomVariance / (threshold * 4), 0, 1));
+    return {
+        path,
+        bottom_variance: bottomVariance,
+        verdict,
+        confidence,
+        warnings: []
+    };
+}
+function bottomLuminanceVariance(png, stripHeight) {
+    const startY = png.height - stripHeight;
+    const pixelCount = png.width * stripHeight;
+    if (pixelCount <= 0) {
+        return 0;
+    }
+    let lumaTotal = 0;
+    const luminances = [];
+    for (let y = startY; y < png.height; y += 1) {
+        for (let x = 0; x < png.width; x += 1) {
+            const index = (y * png.width + x) * 4;
+            const r = png.data[index];
+            const g = png.data[index + 1];
+            const b = png.data[index + 2];
+            const luminance = pixelLuminance(r, g, b);
+            luminances.push(luminance);
+            lumaTotal += luminance;
+        }
+    }
+    const mean = lumaTotal / pixelCount;
+    let squaredDeltaTotal = 0;
+    for (let i = 0; i < luminances.length; i += 1) {
+        const delta = luminances[i] - mean;
+        squaredDeltaTotal += delta * delta;
+    }
+    return squaredDeltaTotal / pixelCount;
+}
+function pixelLuminance(r, g, b) {
+    return 0.2126 * r + 0.7152 * g + 0.0722 * b;
+}
+function clamp(value, min, max) {
+    return Math.min(max, Math.max(min, value));
+}
+function errorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+//# sourceMappingURL=asset-integrity.js.map

package/dist/asset-integrity.js.map

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

package/dist/capture.d.ts

@@ -0,0 +1,61 @@
+export declare class CaptureUnavailableError extends Error {
+    constructor(message?: string);
+}
+export type VideoArtifact = {
+    selector: string;
+    preload: string;
+    renderedBlank: boolean;
+    reason: "unloaded-video-artifact";
+};
+export type CaptureResult = {
+    url: string;
+    renderedHtml: string;
+    screenshotBase64: string;
+    viewport: {
+        w: number;
+        h: number;
+    };
+    scrolledToBottom: boolean;
+    videoArtifacts: VideoArtifact[];
+    warnings: string[];
+};
+export type Interaction = {
+    selector: string;
+    event: "hover" | "click" | "focus";
+    delay_ms: number;
+};
+export type CaptureOptions = {
+    interactions?: Interaction[];
+    scroll_settle?: boolean;
+    viewport?: {
+        w: number;
+        h: number;
+    };
+    timeoutMs?: number;
+};
+export declare function capturePage(url: string, opts?: CaptureOptions): Promise<CaptureResult>;
+export declare function annotateVideoArtifacts(elements: any[]): VideoArtifact[];
+export type Verdict = "confirmed" | "likely-artifact" | "inconclusive";
+export type VerifiableFinding = {
+    key: string;
+    rule: string;
+    message: string;
+    kind: "issue" | "video-artifact";
+    selector?: string;
+};
+export type FindingVerdict = {
+    key: string;
+    verdict: Verdict;
+    evidence: string;
+};
+export type VerifyTarget = {
+    url?: string;
+    html?: string;
+};
+export declare function verifyFindings(target: VerifyTarget, findings: VerifiableFinding[], opts?: {
+    viewport?: {
+        w: number;
+        h: number;
+    };
+    timeoutMs?: number;
+}): Promise<FindingVerdict[]>;