@tangle-network/browser-agent-driver 0.33.3 → 0.34.0

package/dist/types/design-tokens.d.ts

@@ -0,0 +1,138 @@
+export interface DesignTokens {
+    url: string;
+    extractedAt: string;
+    viewportsAudited: string[];
+    customProperties: Record<string, string>;
+    colors: ColorToken[];
+    typography: {
+        families: FontFamily[];
+        scale: TypeScaleEntry[];
+    };
+    brand: {
+        title?: string;
+        description?: string;
+        themeColor?: string;
+        favicon?: string;
+        ogImage?: string;
+        appleTouchIcon?: string;
+        manifestUrl?: string;
+    };
+    logos: LogoAsset[];
+    icons: SvgIcon[];
+    fontFiles: FontFile[];
+    images: ImageAsset[];
+    videos: VideoAsset[];
+    stylesheets: Array<{
+        url: string;
+        localPath?: string;
+    }>;
+    responsive: Record<string, ViewportTokens>;
+    detectedLibraries: string[];
+}
+export interface VideoAsset {
+    url: string;
+    type: 'video' | 'video-source';
+    poster?: string;
+    localPath?: string;
+    mimeType?: string;
+    sizeBytes?: number;
+}
+export interface ColorToken {
+    value: string;
+    hex: string;
+    count: number;
+    properties: string[];
+    cluster?: 'primary' | 'secondary' | 'accent' | 'neutral' | 'background' | 'border';
+}
+export interface FontFamily {
+    family: string;
+    weights: number[];
+    classification: 'heading' | 'body' | 'mono' | 'display';
+}
+export interface TypeScaleEntry {
+    fontSize: string;
+    fontWeight: string;
+    lineHeight: string;
+    letterSpacing: string;
+    fontFamily: string;
+    usage: 'heading' | 'body' | 'caption' | 'label';
+    tag?: string;
+    count: number;
+}
+export interface LogoAsset {
+    type: 'svg' | 'img';
+    src?: string;
+    alt?: string;
+    width?: number;
+    height?: number;
+    svgContent?: string;
+}
+export interface SvgIcon {
+    selector: string;
+    viewBox?: string;
+    width?: number;
+    height?: number;
+    content: string;
+}
+export interface ViewportTokens {
+    width: number;
+    height: number;
+    spacing: SpacingToken[];
+    gridBaseUnit?: number;
+    borders: BorderToken[];
+    shadows: ShadowToken[];
+    components: {
+        buttons: ComponentFingerprint[];
+        inputs: ComponentFingerprint[];
+        cards: ComponentFingerprint[];
+        nav: NavPattern[];
+    };
+    animations: AnimationToken[];
+    screenshotPath?: string;
+}
+export interface SpacingToken {
+    value: string;
+    count: number;
+    properties: string[];
+}
+export interface BorderToken {
+    borderRadius: string;
+    count: number;
+}
+export interface ShadowToken {
+    value: string;
+    count: number;
+}
+export interface ComponentFingerprint {
+    fingerprint: string;
+    count: number;
+    exampleText?: string;
+    styles: Record<string, string>;
+}
+export interface NavPattern {
+    selector: string;
+    layout: Record<string, string>;
+    linkCount: number;
+    linkStyles: Record<string, string>;
+}
+export interface AnimationToken {
+    property: string;
+    value: string;
+    count: number;
+}
+export interface FontFile {
+    family: string;
+    weight: string;
+    style: string;
+    src: string;
+    format: string;
+    localPath?: string;
+}
+export interface ImageAsset {
+    url: string;
+    type: 'img' | 'background' | 'favicon' | 'og-image' | 'icon' | 'video-poster' | 'lazy-load';
+    localPath?: string;
+    mimeType?: string;
+    sizeBytes?: number;
+}
+//# sourceMappingURL=design-tokens.d.ts.map

package/dist/types/design-tokens.d.ts.map

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

package/dist/types/design-tokens.js

@@ -0,0 +1,5 @@
+// ============================================================================
+// Design Token Extraction Types
+// ============================================================================
+export {};
+//# sourceMappingURL=design-tokens.js.map

package/dist/types/design-tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-tokens.js","sourceRoot":"","sources":["../../src/types/design-tokens.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,gCAAgC;AAChC,+EAA+E"}

package/dist/types/page.d.ts

@@ -0,0 +1,16 @@
+import type { SnapshotDiff } from '../drivers/snapshot.js';
+export interface PageState {
+    /** Current URL */
+    url: string;
+    /** Page title */
+    title: string;
+    /** Simplified DOM snapshot (text format) */
+    snapshot: string;
+    /** Screenshot as base64 JPEG (optional, for debugging) */
+    screenshot?: string;
+    /** Diff from previous snapshot (undefined on first observe) */
+    snapshotDiff?: string;
+    /** Structured diff for programmatic use (undefined on first observe) */
+    snapshotDiffRaw?: SnapshotDiff;
+}
+//# sourceMappingURL=page.d.ts.map

package/dist/types/page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../src/types/page.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAM3D,MAAM,WAAW,SAAS;IACxB,kBAAkB;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,eAAe,CAAC,EAAE,YAAY,CAAC;CAChC"}

package/dist/types/page.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=page.js.map

package/dist/types/page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.js","sourceRoot":"","sources":["../../src/types/page.ts"],"names":[],"mappings":""}

package/dist/types/plan.d.ts

@@ -0,0 +1,50 @@
+import type { Action } from './actions.js';
+/**
+ * A single step in a Plan. Wraps an action with a verification checkpoint
+ * and optional recovery hint. The runner executes steps deterministically;
+ * `expectedEffect` is the post-condition that must hold for the next step
+ * to fire.
+ */
+export interface PlanStep {
+    /**
+     * The action to execute deterministically. Use batch verbs (`fill`,
+     * `clickSequence`) wherever possible to minimize step count.
+     */
+    action: Action;
+    /**
+     * Post-condition the runner verifies before advancing. Same shape as
+     * the existing `expectedEffect` on Turn — natural-language assertion
+     * checked against the post-action snapshot.
+     */
+    expectedEffect: string;
+    /**
+     * Optional human-readable description of what this step does. Surfaced
+     * in plan-step-executed events for observability and the live viewer.
+     */
+    rationale?: string;
+}
+/**
+ * A complete plan from `Brain.plan()`. The runner attempts to execute
+ * every step deterministically. On the first verification failure or
+ * selector miss, the runner falls back to the existing per-action
+ * decide loop with a `[REPLAN]` hint in extraContext.
+ *
+ * Plans are NOT trees — they're flat sequences. Branching is handled
+ * by the per-action fallback loop, which decide()'s its way through
+ * the unexpected state then potentially re-enters the planner.
+ */
+export interface Plan {
+    /** Steps to execute in order */
+    steps: PlanStep[];
+    /**
+     * Final result text the runner should emit as `complete` if all steps
+     * pass verification. If absent, the runner emits a generic completion.
+     */
+    finalResult?: string;
+    /**
+     * Plan-level reasoning — what's the strategy, why this sequence?
+     * Surfaced in plan-completed events for observability.
+     */
+    reasoning?: string;
+}
+//# sourceMappingURL=plan.d.ts.map

package/dist/types/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/types/plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAM3C;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,IAAI;IACnB,gCAAgC;IAChC,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/types/plan.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plan.js.map

package/dist/types/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/types/plan.ts"],"names":[],"mappings":""}

package/dist/types/preview.d.ts

@@ -0,0 +1,9 @@
+export interface PreviewVerification {
+    previewUrl: string;
+    appLoaded: boolean;
+    title: string;
+    snapshot: string;
+    screenshot?: string;
+    errors: string[];
+}
+//# sourceMappingURL=preview.d.ts.map

package/dist/types/preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../src/types/preview.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB"}

package/dist/types/preview.js

@@ -0,0 +1,5 @@
+// ============================================================================
+// Preview Verification Types
+// ============================================================================
+export {};
+//# sourceMappingURL=preview.js.map

package/dist/types/preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.js","sourceRoot":"","sources":["../../src/types/preview.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,6BAA6B;AAC7B,+EAA+E"}

package/dist/types/result.d.ts

@@ -0,0 +1,62 @@
+import type { Turn } from './turn.js';
+export interface AgentResult {
+    success: boolean;
+    result?: string;
+    reason?: string;
+    turns: Turn[];
+    totalMs: number;
+    /** Phase timing instrumentation for the run */
+    phaseTimings?: RunPhaseTimings;
+    /** Startup-path instrumentation for the run */
+    startupDiagnostics?: RunStartupDiagnostics;
+    /** Wasted-turn instrumentation for the run */
+    wasteMetrics?: RunWasteMetrics;
+    /** Quality evaluation (if qualityThreshold is set or agent used "evaluate" action) */
+    evaluation?: {
+        score: number;
+        assessment: string;
+        strengths: string[];
+        issues: string[];
+        suggestions: string[];
+    };
+    /** Goal achievement verification (if goalVerification is enabled) */
+    goalVerification?: GoalVerification;
+}
+export interface GoalVerification {
+    /** Did the LLM judge the goal as achieved? */
+    achieved: boolean;
+    /** Confidence 0-1 */
+    confidence: number;
+    /** Evidence supporting achievement */
+    evidence: string[];
+    /** Missing criteria (empty if achieved) */
+    missing: string[];
+}
+export interface RunPhaseTimings {
+    initialNavigateMs?: number;
+    firstObserveMs?: number;
+    firstDecideMs?: number;
+    firstExecuteMs?: number;
+    /** Per-phase wall-time summed across ALL turns — the real "where does time go"
+     *  breakdown (observe/execute are browser I/O; decide is the LLM round-trip). */
+    totalObserveMs?: number;
+    totalDecideMs?: number;
+    totalExecuteMs?: number;
+    /** Turns whose decision came from the LLM vs a deterministic-pattern/cache skip
+     *  (the lazy-decision optimization's actual hit rate). */
+    decideLlmCalls?: number;
+    decideSkips?: number;
+}
+export interface RunStartupDiagnostics {
+    firstTurnSeen: boolean;
+    timeToFirstTurnMs?: number;
+    zeroTurnFailureClass?: 'pre_first_turn_timeout' | 'provider_or_credentials' | 'runner_startup_error' | 'unknown';
+    startupReason?: string;
+}
+export interface RunWasteMetrics {
+    repeatedQueryCount: number;
+    verificationRejectionCount: number;
+    turnsAfterSufficientEvidence: number;
+    errorTurns: number;
+}
+//# sourceMappingURL=result.d.ts.map

package/dist/types/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/types/result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAMtC,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,eAAe,CAAC;IAC/B,+CAA+C;IAC/C,kBAAkB,CAAC,EAAE,qBAAqB,CAAC;IAC3C,8CAA8C;IAC9C,YAAY,CAAC,EAAE,eAAe,CAAC;IAC/B,sFAAsF;IACtF,UAAU,CAAC,EAAE;QACX,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,WAAW,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC;IACF,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,QAAQ,EAAE,OAAO,CAAC;IAClB,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;qFACiF;IACjF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;8DAC0D;IAC1D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,OAAO,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oBAAoB,CAAC,EAAE,wBAAwB,GAAG,yBAAyB,GAAG,sBAAsB,GAAG,SAAS,CAAC;IACjH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,0BAA0B,EAAE,MAAM,CAAC;IACnC,4BAA4B,EAAE,MAAM,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/types/result.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=result.js.map

package/dist/types/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/types/result.ts"],"names":[],"mappings":""}

package/dist/types/scenario.d.ts

@@ -0,0 +1,20 @@
+export interface Scenario {
+    /** Natural language goal */
+    goal: string;
+    /** Starting URL (optional - uses current page if not set) */
+    startUrl?: string;
+    /** Optional task tags, used by adaptive runtime policies */
+    tags?: string[];
+    /** Explicit host allowlist for navigation/result selection (for benchmark and policy constraints) */
+    allowedDomains?: string[];
+    /** Max turns before giving up */
+    maxTurns?: number;
+    /** Abort signal for external cancellation (e.g., story timeout) */
+    signal?: AbortSignal;
+    /** Session ID for cross-run continuity. Runs with the same ID share session
+     *  history regardless of domain. When omitted, sessions are scoped to domain. */
+    sessionId?: string;
+    /** Parent run ID — set when this run is a resume or fork of a previous run. */
+    parentRunId?: string;
+}
+//# sourceMappingURL=scenario.d.ts.map

package/dist/types/scenario.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario.d.ts","sourceRoot":"","sources":["../../src/types/scenario.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,QAAQ;IACvB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,qGAAqG;IACrG,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;qFACiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/types/scenario.js

@@ -0,0 +1,5 @@
+// ============================================================================
+// Scenario - What the agent should accomplish
+// ============================================================================
+export {};
+//# sourceMappingURL=scenario.js.map

package/dist/types/scenario.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario.js","sourceRoot":"","sources":["../../src/types/scenario.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,8CAA8C;AAC9C,+EAA+E"}

package/dist/types/test-runner.d.ts

@@ -0,0 +1,145 @@
+import type { AgentConfig } from './config.js';
+import type { AgentResult, RunPhaseTimings, RunStartupDiagnostics, RunWasteMetrics } from './result.js';
+export interface SuccessCriterion {
+    type: 'url-contains' | 'url-matches' | 'element-visible' | 'element-text' | 'element-count' | 'custom';
+    /** CSS/Playwright selector for element-based criteria */
+    selector?: string;
+    /** Expected value (URL substring, text content, element count) */
+    value?: string;
+    /** Custom check function (receives Playwright page) */
+    check?: (page: import('playwright').Page) => Promise<boolean>;
+    /** Human-readable description of what this checks */
+    description?: string;
+}
+export interface TestCase {
+    /** Unique identifier */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Detailed description */
+    description?: string;
+    /** Category for grouping */
+    category?: string;
+    /** Tags for filtering */
+    tags?: string[];
+    /** Starting URL */
+    startUrl: string;
+    /** Natural language goal for the agent */
+    goal: string;
+    /** Explicit host allowlist for navigation/result selection */
+    allowedDomains?: string[];
+    /** Max turns allowed (default: 30) */
+    maxTurns?: number;
+    /** Timeout in ms */
+    timeoutMs?: number;
+    /** Priority (lower = runs first) */
+    priority?: number;
+    /** IDs of prerequisite test cases that must pass first */
+    dependsOn?: string[];
+    /** Session ID for cross-run continuity. Runs with the same ID share session
+     *  history regardless of domain. When omitted, sessions are scoped to domain. */
+    sessionId?: string;
+    /** Parent run ID — set when this run is a resume or fork of a previous run. */
+    parentRunId?: string;
+    /** Run before the agent starts (e.g., seed data, reset state) */
+    setup?: (page: import('playwright').Page) => Promise<void>;
+    /** Run after the agent finishes (e.g., cleanup) */
+    teardown?: (page: import('playwright').Page) => Promise<void>;
+    /** Ground-truth criteria verified AFTER the agent completes */
+    successCriteria?: SuccessCriterion[];
+    /** Natural-language criteria appended to the goal for LLM awareness */
+    successDescription?: string;
+}
+export interface CriterionResult {
+    criterion: SuccessCriterion;
+    passed: boolean;
+    detail?: string;
+}
+export interface TestResult {
+    testCase: TestCase;
+    agentResult: AgentResult;
+    /** Agent's self-reported success */
+    agentSuccess: boolean;
+    /** Ground-truth verification (true if no criteria defined OR all pass) */
+    verified: boolean;
+    /** Per-criterion verification results */
+    criteriaResults?: CriterionResult[];
+    /** Human-readable pass/fail explanation */
+    verdict: string;
+    /** Number of turns used */
+    turnsUsed: number;
+    /** Total tokens consumed */
+    tokensUsed: number;
+    /** Total input (prompt) tokens */
+    inputTokens?: number;
+    /** Total output (completion) tokens */
+    outputTokens?: number;
+    /** Estimated cost in USD (based on model pricing) */
+    estimatedCostUsd?: number;
+    /** Duration in ms */
+    durationMs: number;
+    /** Phase timing instrumentation copied from agentResult for report consumers */
+    phaseTimings?: RunPhaseTimings;
+    /** Startup-path instrumentation copied from agentResult for report consumers */
+    startupDiagnostics?: RunStartupDiagnostics;
+    /** Wasted-turn instrumentation copied from agentResult for report consumers */
+    wasteMetrics?: RunWasteMetrics;
+    startedAt: Date;
+    endedAt: Date;
+    /** Screenshots captured during execution */
+    screenshots?: {
+        turn: number;
+        base64: string;
+    }[];
+    /** Whether this test was skipped (unmet dependencies) */
+    skipped?: boolean;
+    skipReason?: string;
+    /** Runtime/backend configuration that produced this result */
+    runtime?: RunRuntimeConfig;
+}
+/**
+ * Current on-disk schema version for `report.json` / `TestSuiteResult`.
+ *
+ * Consumers that parse `<sink>/report.json` should pin or range-check this.
+ * The contract: bump on any breaking shape change (removed fields, renamed
+ * fields, changed value semantics). Adding an optional field is non-breaking
+ * and does NOT bump the version.
+ */
+export declare const TEST_SUITE_SCHEMA_VERSION: "1";
+export interface TestSuiteResult {
+    /**
+     * On-disk schema version. See {@link TEST_SUITE_SCHEMA_VERSION}. Consumers
+     * should verify this matches their expected version before destructuring.
+     */
+    schemaVersion: string;
+    /** Model used */
+    model: string;
+    /** Runtime/backend configuration for the suite */
+    runtime?: RunRuntimeConfig;
+    /** Run timestamp */
+    timestamp: string;
+    /** Per-test results */
+    results: TestResult[];
+    /** Aggregate metrics */
+    summary: {
+        total: number;
+        passed: number;
+        failed: number;
+        skipped: number;
+        passRate: number;
+        avgTurns: number;
+        avgTokens: number;
+        avgDurationMs: number;
+        p50DurationMs: number;
+        p95DurationMs: number;
+        totalDurationMs: number;
+    };
+}
+export interface RunRuntimeConfig {
+    provider: NonNullable<AgentConfig['provider']>;
+    model: string;
+    sandboxBackendType?: string;
+    sandboxBackendProfile?: string;
+    sandboxBackendProvider?: string;
+}
+//# sourceMappingURL=test-runner.d.ts.map

package/dist/types/test-runner.d.ts.map

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

package/dist/types/test-runner.js

@@ -0,0 +1,10 @@
+/**
+ * Current on-disk schema version for `report.json` / `TestSuiteResult`.
+ *
+ * Consumers that parse `<sink>/report.json` should pin or range-check this.
+ * The contract: bump on any breaking shape change (removed fields, renamed
+ * fields, changed value semantics). Adding an optional field is non-breaking
+ * and does NOT bump the version.
+ */
+export const TEST_SUITE_SCHEMA_VERSION = '1';
+//# sourceMappingURL=test-runner.js.map

package/dist/types/test-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-runner.js","sourceRoot":"","sources":["../../src/types/test-runner.ts"],"names":[],"mappings":"AAmHA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAY,CAAC"}

package/dist/types/trajectory.d.ts

@@ -0,0 +1,38 @@
+import type { Action } from './actions.js';
+export interface TrajectoryStep {
+    /** URL at this step */
+    url: string;
+    /** Action taken */
+    action: Action;
+    /** Hash of snapshot for similarity comparison */
+    snapshotHash: string;
+    /** Whether the expected effect was verified */
+    verified?: boolean;
+    /**
+     * The action's expected effect at record time (from `Turn.expectedEffect`).
+     * Persisted so ZERO-LLM workflow replay can re-assert a precise post-action
+     * effect via the runner's own `verifyExpectedEffect`. Optional: trajectories
+     * recorded before this field existed, and turns the brain emitted without an
+     * expectedEffect, simply omit it.
+     */
+    expectedEffect?: string;
+}
+export interface Trajectory {
+    /** Unique ID */
+    id: string;
+    /** Goal that was achieved */
+    goal: string;
+    /** Normalized origin for environment scoping (e.g. https://app.example.com) */
+    origin?: string;
+    /** Steps taken */
+    steps: TrajectoryStep[];
+    /** Whether this trajectory succeeded */
+    success: boolean;
+    /** Total duration */
+    durationMs: number;
+    /** Model used */
+    model: string;
+    /** When this was recorded */
+    timestamp: string;
+}
+//# sourceMappingURL=trajectory.d.ts.map

package/dist/types/trajectory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trajectory.d.ts","sourceRoot":"","sources":["../../src/types/trajectory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAM3C,MAAM,WAAW,cAAc;IAC7B,uBAAuB;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,gBAAgB;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/types/trajectory.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=trajectory.js.map

package/dist/types/trajectory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trajectory.js","sourceRoot":"","sources":["../../src/types/trajectory.ts"],"names":[],"mappings":""}

package/dist/types/turn.d.ts

@@ -0,0 +1,50 @@
+import type { Action } from './actions.js';
+import type { PageState } from './page.js';
+export interface Turn {
+    turn: number;
+    state: PageState;
+    action: Action;
+    /** Raw LLM response text */
+    rawLLMResponse?: string;
+    /** LLM's reasoning/thinking (if provided) */
+    reasoning?: string;
+    /** Multi-step plan from brain */
+    plan?: string[];
+    /** Actual action sequence executed this turn (primary action first) */
+    executedActions?: Action[];
+    /** Current step in the plan */
+    currentStep?: number;
+    /** Expected effect of the action (for verification) */
+    expectedEffect?: string;
+    /** Whether the expected effect was verified */
+    verified?: boolean;
+    /** Verification failure message */
+    verificationFailure?: string;
+    /** Tokens used for this turn */
+    tokensUsed?: number;
+    /** Input (prompt) tokens for this turn */
+    inputTokens?: number;
+    /** Output (completion) tokens for this turn */
+    outputTokens?: number;
+    /**
+     * Prompt-cache hit tokens (provider-agnostic). Populated by OpenAI/ZAI/GLM
+     * automatic server-side caching and by Anthropic explicit cache_control.
+     */
+    cacheReadInputTokens?: number;
+    /** Prompt-cache write tokens (cache miss, first turn) */
+    cacheCreationInputTokens?: number;
+    /** Which model handled this turn (for adaptive routing cost tracking) */
+    modelUsed?: string;
+    /** Time taken for this turn in ms */
+    durationMs: number;
+    /** Error message if turn failed */
+    error?: string;
+    /** Bounding box of the target element at action time (for replay overlays) */
+    actionBounds?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+}
+//# sourceMappingURL=turn.d.ts.map