@vostride/agent-qa-core 0.1.21 → 0.2.2

package/dist/index.d.cts

@@ -1,512 +1,9 @@
 import { z } from 'zod';
-import * as ai from 'ai';
-import { LanguageModel, wrapLanguageModel, LanguageModelMiddleware } from 'ai';
-import * as better_sqlite3 from 'better-sqlite3';
-export { generateObservationId } from '@vostride/agent-qa-ids';
-
-type StepStatus = 'passed' | 'failed' | 'healed' | 'skipped' | 'cancelled';
-type TestStatus = 'passed' | 'failed' | 'skipped' | 'cancelled';
-interface StepAnnotation {
-    clickPoint?: {
-        x: number;
-        y: number;
-    };
-    boundingBox?: {
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-    };
-    failureHighlight?: {
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-    };
-    type: 'click' | 'fill' | 'tap' | 'hover' | 'scroll' | 'swipe' | 'pinch' | 'navigate' | 'other';
-    viewport?: {
-        width: number;
-        height: number;
-    };
-    startPoint?: {
-        x: number;
-        y: number;
-    };
-    endPoint?: {
-        x: number;
-        y: number;
-    };
-    direction?: 'up' | 'down' | 'left' | 'right';
-    pinchScale?: 'in' | 'out';
-}
-interface HealingAttempt {
-    action: Action;
-    observationBefore: string;
-    observationAfter?: string;
-    success: boolean;
-    attemptNumber?: number;
-    strategy?: string;
-    reasoning?: string;
-    confidence?: number;
-}
-interface TokenUsage {
-    promptTokens: number;
-    completionTokens: number;
-    totalTokens: number;
-}
-interface SubActionTrace {
-    index: number;
-    observation: string;
-    reasoning: string;
-    plannedAction: Action;
-    result: 'success' | 'failure';
-    error?: string;
-    screenStateBefore: string;
-    screenStateAfter?: string;
-    screenContextBefore?: string;
-    screenContextAfter?: string;
-    confidence?: number;
-    verifierReasoning?: string;
-    cached: boolean;
-    tokenUsage?: TokenUsage;
-    phaseDurations?: {
-        observe?: number;
-        plan?: number;
-        execute?: number;
-        verify?: number;
-    };
-    screenshotBefore?: Buffer;
-    screenshotAfter?: Buffer;
-    annotation?: StepAnnotation;
-    data?: unknown;
-}
-interface StepTrace {
-    observation: string;
-    reasoning: string;
-    plannedAction: Action;
-    result: 'success' | 'failure';
-    error?: string;
-    screenStateBefore: string;
-    screenStateAfter?: string;
-    screenContextBefore?: string;
-    screenContextAfter?: string;
-    confidence?: number;
-    verifierReasoning?: string;
-    tokenUsage?: TokenUsage;
-    phaseDurations?: {
-        observe?: number;
-        plan?: number;
-        execute?: number;
-        verify?: number;
-        heal?: number;
-    };
-    subActions?: SubActionTrace[];
-}
-interface StepPhaseEvent {
-    phase: 'observe' | 'plan' | 'execute' | 'verify' | 'heal';
-    subActionIndex?: number;
-    phaseOrdinal?: number;
-    text?: string;
-    confidence?: number;
-    action?: unknown;
-    success?: boolean;
-    duration?: number;
-}
-interface AccessibilityViolation {
-    ruleId: string;
-    impact: 'minor' | 'moderate' | 'serious' | 'critical';
-    description: string;
-    help: string;
-    helpUrl: string;
-    nodes: Array<{
-        html: string;
-        target: string[];
-    }>;
-}
-interface ConsoleLogEntry {
-    level: string;
-    text: string;
-    location?: {
-        url: string;
-        lineNumber: number;
-        columnNumber: number;
-    };
-    timestamp: number;
-}
-interface NetworkLogEntry {
-    url: string;
-    method: string;
-    status: number;
-    requestHeaders: Record<string, string>;
-    responseHeaders: Record<string, string>;
-    body?: string;
-    requestBody?: string;
-    startTime: number;
-    endTime: number;
-    timing?: Record<string, number>;
-}
-interface StepResult {
-    id?: string;
-    name: string;
-    status: StepStatus;
-    duration: number;
-    action?: Action;
-    observation?: string;
-    error?: string;
-    screenshot?: Buffer;
-    screenshotBefore?: Buffer;
-    healingAttempts?: HealingAttempt[];
-    trace?: StepTrace;
-    retryCount?: number;
-    capturedVariables?: Record<string, string>;
-    annotation?: StepAnnotation;
-    healingScreenshots?: Buffer[];
-    accessibilityViolations?: AccessibilityViolation[];
-    consoleLogs?: ConsoleLogEntry[];
-    networkLogs?: NetworkLogEntry[];
-    variableSnapshot?: Record<string, {
-        value: string;
-        source: string;
-    }>;
-    originalStepName?: string;
-}
-interface TestResult {
-    runId?: string;
-    name: string;
-    filePath: string;
-    status: TestStatus;
-    steps: StepResult[];
-    duration: number;
-    metadata?: Record<string, unknown>;
-    retryCount?: number;
-    videoPath?: string;
-    failureSummary?: string;
-}
-
-interface ObserveOptions {
-    extractDom?: boolean;
-}
-interface PlatformAdapter {
-    readonly platform: 'web' | 'android' | 'ios';
-    setup(config: PlatformConfig): Promise<void>;
-    cleanup(): Promise<void>;
-    observe(options?: ObserveOptions): Promise<ScreenState>;
-    execute(action: Action): Promise<ActionResult>;
-    screenshot?(): Promise<Buffer | undefined>;
-    drainConsoleLogs?(level?: string): ConsoleLogEntry[];
-    drainNetworkLogs?(urlPattern?: string): NetworkLogEntry[];
-}
-interface ScreenStateMetadata {
-    coordSpace: 'viewport';
-    viewportWidth: number;
-    viewportHeight: number;
-    refMap?: Record<string, unknown>;
-    imageWidth?: number;
-    imageHeight?: number;
-    domContext?: string;
-}
-interface ScreenState {
-    tree: string;
-    elements: ElementInfo[];
-    url?: string;
-    timestamp: number;
-    metadata: ScreenStateMetadata;
-}
-interface ElementInfo {
-    ref: string;
-    role: string;
-    name: string;
-    value?: string;
-    attributes: Record<string, string>;
-}
-type Action = {
-    type: 'click';
-    ref: string;
-    clickDelay?: number;
-} | {
-    type: 'fill';
-    ref: string;
-    value: string;
-} | {
-    type: 'select';
-    ref: string;
-    value: string;
-} | {
-    type: 'nativeSelect';
-    ref: string;
-    value: string;
-} | {
-    type: 'navigate';
-    url: string;
-} | {
-    type: 'scroll';
-    scrollType: 'vertical' | 'horizontal';
-    value: number;
-    ref?: string;
-    duration?: number;
-} | {
-    type: 'waitFor';
-    condition: string;
-    timeout?: number;
-} | {
-    type: 'delay';
-    ms: number;
-} | {
-    type: 'assert';
-    condition: string;
-    expected?: string;
-    visual?: boolean;
-} | {
-    type: 'keypress';
-    keys: string[];
-    convertPlatformKeys?: boolean;
-} | {
-    type: 'hover';
-    ref: string;
-} | {
-    type: 'paste';
-    ref: string;
-    value: string;
-} | {
-    type: 'keyDown';
-    key: string;
-} | {
-    type: 'keyUp';
-    key: string;
-} | {
-    type: 'refresh';
-} | {
-    type: 'navigateHistory';
-    direction: 'back' | 'forward';
-} | {
-    type: 'readConsoleLogs';
-    level?: 'log' | 'info' | 'warn' | 'error';
-    tab?: {
-        index?: number;
-        title?: string;
-        url?: string;
-    };
-} | {
-    type: 'readNetworkLogs';
-    urlPattern?: string;
-    tab?: {
-        index?: number;
-        title?: string;
-        url?: string;
-    };
-} | {
-    type: 'readCookies';
-    name?: string;
-} | {
-    type: 'setCookies';
-    cookies: Array<{
-        name: string;
-        value: string;
-        domain?: string;
-        path?: string;
-        httpOnly?: boolean;
-        secure?: boolean;
-        sameSite?: 'Strict' | 'Lax' | 'None';
-        expires?: number;
-    }>;
-} | {
-    type: 'readLocalStorage';
-    key?: string;
-} | {
-    type: 'setLocalStorage';
-    entries: Array<{
-        key: string;
-        value: string;
-    }>;
-} | {
-    type: 'newTab';
-    url: string;
-} | {
-    type: 'switchTab';
-    index?: number;
-    title?: string;
-    url?: string;
-} | {
-    type: 'doubleClick';
-    ref: string;
-    relativePosition?: {
-        x: number;
-        y: number;
-    };
-    clickDelay?: number;
-} | {
-    type: 'rightClick';
-    ref: string;
-    relativePosition?: {
-        x: number;
-        y: number;
-    };
-    clickDelay?: number;
-} | {
-    type: 'waitForUrl';
-    pattern: string;
-} | {
-    type: 'fileUpload';
-    ref: string;
-    files: string[];
-} | {
-    type: 'copy';
-    ref: string;
-} | {
-    type: 'tap';
-    ref: string;
-} | {
-    type: 'swipe';
-    direction: 'up' | 'down' | 'left' | 'right';
-    ref?: string;
-    startX?: number;
-    startY?: number;
-    endX?: number;
-    endY?: number;
-    duration?: number;
-} | {
-    type: 'longpress';
-    ref: string;
-    duration?: number;
-} | {
-    type: 'hideKeyboard';
-} | {
-    type: 'clearText';
-    ref: string;
-} | {
-    type: 'openLink';
-    url: string;
-    appId?: string;
-    bundleId?: string;
-    appPackage?: string;
-    waitForLaunch?: boolean;
-} | {
-    type: 'drag';
-    fromRef: string;
-    toRef: string;
-} | {
-    type: 'doubleTap';
-    ref: string;
-} | {
-    type: 'launchApp';
-    bundleId: string;
-} | {
-    type: 'stopApp';
-    bundleId: string;
-} | {
-    type: 'setOrientation';
-    orientation: 'portrait' | 'landscape';
-} | {
-    type: 'pinch';
-    scale: number;
-    x?: number;
-    y?: number;
-    ref?: string;
-} | {
-    type: 'multiTap';
-    fingers: number;
-    x?: number;
-    y?: number;
-    ref?: string;
-} | {
-    type: 'tapCoordinate';
-    x: number;
-    y: number;
-} | {
-    type: 'executeScript';
-    command: string;
-    args?: unknown;
-} | {
-    type: 'setVariable';
-    name: string;
-    value: string;
-};
-interface ActionResult {
-    success: boolean;
-    error?: string;
-    screenshot?: Buffer;
-    metadata?: Record<string, unknown>;
-    coordinates?: {
-        x: number;
-        y: number;
-    };
-    boundingBox?: {
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-    };
-    startCoordinates?: {
-        x: number;
-        y: number;
-    };
-    endCoordinates?: {
-        x: number;
-        y: number;
-    };
-    data?: unknown;
-}
-interface RuntimeAuthStateConfig {
-    version: number;
-    kind: 'web';
-    targetName: string;
-    stateName: string;
-    capturedAt: string;
-    storageStatePath: string;
-}
-interface PlatformConfig {
-    platform: 'web' | 'android' | 'ios';
-    browser?: BrowserConfig;
-    device?: DeviceConfig;
-    bundleId?: string;
-    appPackage?: string;
-    appActivity?: string;
-    deepLinkAppId?: string;
-    appState?: 'preserve' | 'reset';
-    appPath?: string;
-    browserstackApp?: string;
-    appiumUrl?: string;
-    timeouts?: TimeoutConfig;
-    recording?: {
-        enabled: boolean;
-        videoDir: string;
-        videoSize?: {
-            width: number;
-            height: number;
-        };
-    };
-    verbose?: boolean;
-    farmSession?: {
-        hostname: string;
-        port: number;
-        path: string;
-        capabilities: Record<string, unknown>;
-    };
-    logCapture?: {
-        console?: boolean;
-        network?: boolean;
-    };
-    authState?: RuntimeAuthStateConfig;
-}
-interface BrowserConfig {
-    name: 'chromium' | 'firefox' | 'webkit';
-    headless?: boolean;
-    viewport?: {
-        width: number;
-        height: number;
-    };
-}
-interface DeviceConfig {
-    name: string;
-    platform: 'android' | 'ios';
-    transport: 'local' | 'browserstack';
-    match: Record<string, unknown>;
-}
-interface TimeoutConfig {
-    step?: number;
-    test?: number;
-    navigation?: number;
-}
+import { TestResult, TokenUsage, Action, InterimNode, RefBinding, DocumentScrollOffsets, Direction, SwipeSignal, SecretRedactor, BrowserConfig, PlatformAdapter, PlatformConfig, Planner as Planner$1, Verifier as Verifier$1, ActionPlanCache, WorkingMemoryPort, StorageStatePort, ScreenshotCompressor, HookDefinition, SandboxRunnerOptions, AccessibilityViolation, RuntimeAuthStateConfig, SecretStore } from '@vostride/agent-qa-runner';
+export { AUTH_STATE_HOOK_CONTAINER_STORAGE_STATE_PATH, AUTH_STATE_HOOK_JSON_ENV, AUTH_STATE_HOOK_STORAGE_STATE_FILENAME, AUTH_STATE_HOOK_STORAGE_STATE_PATH_ENV, AUTH_STATE_HOOK_WORKSPACE_DIR, HookDefinition, HookResult, HookRuntime, RUNTIME_IMAGE_MAP, buildAuthStateHookEnv, isReservedAuthStateHookEnvKey, parseEnvFile, serializeEnvFile, stripReservedAuthStateHookEnv } from '@vostride/agent-qa-runner';
+import { CST, Document } from 'yaml';
+import { TestEditPatchSet, ScreenState } from '@vostride/agent-qa-schema';
+import { LanguageModel } from 'ai';
 
 declare const CaptureConfigSchema: z.ZodObject<{
     variable: z.ZodString;
@@ -535,7 +32,6 @@ declare const TestStepSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
         selector: z.ZodOptional<z.ZodString>;
         description: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
-    maxAttempts: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>]>;
 declare const TestMetaSchema: z.ZodObject<{
     timeout: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>>;
@@ -547,7 +43,7 @@ declare const TestDefinitionSchema: z.ZodObject<{
     name: z.ZodString;
     target: z.ZodString;
     context: z.ZodOptional<z.ZodString>;
-    use: z.ZodOptional<z.ZodObject<{
+    use: z.ZodOptional<z.ZodPipe<z.ZodAny, z.ZodObject<{
         browser: z.ZodOptional<z.ZodObject<{
             name: z.ZodOptional<z.ZodEnum<{
                 chromium: "chromium";
@@ -565,11 +61,9 @@ declare const TestDefinitionSchema: z.ZodObject<{
             test: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>>;
             navigation: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>>;
         }, z.core.$strict>>;
-        healing: z.ZodOptional<z.ZodObject<{
-            maxAttempts: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strict>>;
         planner: z.ZodOptional<z.ZodObject<{
-            maxSubActions: z.ZodOptional<z.ZodNumber>;
+            maxActions: z.ZodOptional<z.ZodNumber>;
+            maxPlanningTurns: z.ZodOptional<z.ZodNumber>;
             previousStepCount: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
         logCapture: z.ZodOptional<z.ZodObject<{
@@ -590,8 +84,9 @@ declare const TestDefinitionSchema: z.ZodObject<{
         }, z.core.$strict>>;
         llm: z.ZodOptional<z.ZodString>;
         parallel: z.ZodOptional<z.ZodBoolean>;
+        workers: z.ZodOptional<z.ZodNumber>;
         device: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>>;
+    }, z.core.$strict>>>;
     meta: z.ZodOptional<z.ZodObject<{
         timeout: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>>;
         retries: z.ZodOptional<z.ZodNumber>;
@@ -615,7 +110,6 @@ declare const TestDefinitionSchema: z.ZodObject<{
             selector: z.ZodOptional<z.ZodString>;
             description: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>;
-        maxAttempts: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>]>>;
 }, z.core.$strict>;
 
@@ -672,11 +166,9 @@ declare const UseSchema: z.ZodObject<{
         test: z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>;
         navigation: z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>;
     }, z.core.$strict>>;
-    healing: z.ZodOptional<z.ZodObject<{
-        maxAttempts: z.ZodNumber;
-    }, z.core.$strict>>;
     planner: z.ZodOptional<z.ZodObject<{
-        maxSubActions: z.ZodNumber;
+        maxActions: z.ZodOptional<z.ZodNumber>;
+        maxPlanningTurns: z.ZodOptional<z.ZodNumber>;
         previousStepCount: z.ZodNumber;
     }, z.core.$strict>>;
     logCapture: z.ZodOptional<z.ZodObject<{
@@ -685,7 +177,9 @@ declare const UseSchema: z.ZodObject<{
     }, z.core.$strict>>;
     cache: z.ZodOptional<z.ZodBoolean>;
     llm: z.ZodOptional<z.ZodString>;
+    buildTag: z.ZodOptional<z.ZodString>;
     parallel: z.ZodOptional<z.ZodBoolean>;
+    workers: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>;
 declare const UseOverrideSchema: z.ZodObject<{
     browser: z.ZodOptional<z.ZodObject<{
@@ -705,11 +199,9 @@ declare const UseOverrideSchema: z.ZodObject<{
         test: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>>;
         navigation: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>>;
     }, z.core.$strict>>;
-    healing: z.ZodOptional<z.ZodObject<{
-        maxAttempts: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strict>>;
     planner: z.ZodOptional<z.ZodObject<{
-        maxSubActions: z.ZodOptional<z.ZodNumber>;
+        maxActions: z.ZodOptional<z.ZodNumber>;
+        maxPlanningTurns: z.ZodOptional<z.ZodNumber>;
         previousStepCount: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>;
     logCapture: z.ZodOptional<z.ZodObject<{
@@ -730,6 +222,7 @@ declare const UseOverrideSchema: z.ZodObject<{
     }, z.core.$strict>>;
     llm: z.ZodOptional<z.ZodString>;
     parallel: z.ZodOptional<z.ZodBoolean>;
+    workers: z.ZodOptional<z.ZodNumber>;
     device: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 
@@ -744,7 +237,6 @@ declare const WorkspaceSchema: z.ZodObject<{
     suiteMatch: z.ZodArray<z.ZodString>;
     testPathIgnore: z.ZodOptional<z.ZodArray<z.ZodString>>;
     hooksFile: z.ZodString;
-    agentRules: z.ZodString;
     envFile: z.ZodString;
     secretsFile: z.ZodString;
 }, z.core.$strict>;
@@ -753,14 +245,29 @@ declare const DashboardConfigSchema: z.ZodObject<{
     port: z.ZodOptional<z.ZodNumber>;
     dbPath: z.ZodOptional<z.ZodString>;
     artifactsDir: z.ZodOptional<z.ZodString>;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    workspace: z.ZodOptional<z.ZodString>;
+    host: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
+/**
+ * THE ONE MEMBER SET FOR "this host is loopback" (402-05 D-07 — T-402-18).
+ *
+ * Exported because two mechanisms now decide loopback membership and they must not be two
+ * spellings: `LoopbackHostSchema` below refuses a non-loopback MCP host at PARSE time, and
+ * `startServer`'s pre-listen bind guard refuses a non-loopback DASHBOARD host at RUNTIME, with no
+ * exemption. A second literal list would let the two drift, and the direction it would drift in is
+ * a host one mechanism calls loopback and the other does not.
+ */
+declare const LOOPBACK_HOSTS: readonly string[];
+/** Whether a configured host names a loopback interface. The one predicate over the one set. */
+declare function isLoopbackHost(host: string): boolean;
 declare const McpConfigSchema: z.ZodObject<{
     enabled: z.ZodOptional<z.ZodBoolean>;
     transport: z.ZodOptional<z.ZodEnum<{
         http: "http";
         stdio: "stdio";
     }>>;
-    host: z.ZodOptional<z.ZodString & z.ZodType<"localhost" | "127.0.0.1" | "::1", string, z.core.$ZodTypeInternals<"localhost" | "127.0.0.1" | "::1", string>>>;
+    host: z.ZodOptional<z.ZodString>;
     port: z.ZodOptional<z.ZodNumber>;
     path: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
@@ -773,15 +280,16 @@ declare const AuthStateConfigSchema: z.ZodObject<{
 }, z.core.$strict>;
 declare const LoggingConfigSchema: z.ZodObject<{
     level: z.ZodEnum<{
-        info: "info";
-        warn: "warn";
         error: "error";
         silent: "silent";
+        warn: "warn";
+        info: "info";
         debug: "debug";
     }>;
 }, z.core.$strict>;
 declare const RecordingConfigSchema: z.ZodObject<{
-    enabled: z.ZodOptional<z.ZodBoolean>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    keepFailuresOnly: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
 declare const AccessibilityConfigSchema: z.ZodObject<{
     enabled: z.ZodBoolean;
@@ -804,6 +312,9 @@ declare const ServicesSchema: z.ZodObject<{
         port: z.ZodOptional<z.ZodNumber>;
         dbPath: z.ZodOptional<z.ZodString>;
         artifactsDir: z.ZodOptional<z.ZodString>;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        workspace: z.ZodOptional<z.ZodString>;
+        host: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
     mcp: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodOptional<z.ZodBoolean>;
@@ -811,7 +322,7 @@ declare const ServicesSchema: z.ZodObject<{
             http: "http";
             stdio: "stdio";
         }>>;
-        host: z.ZodOptional<z.ZodString & z.ZodType<"localhost" | "127.0.0.1" | "::1", string, z.core.$ZodTypeInternals<"localhost" | "127.0.0.1" | "::1", string>>>;
+        host: z.ZodOptional<z.ZodString>;
         port: z.ZodOptional<z.ZodNumber>;
         path: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
@@ -824,16 +335,17 @@ declare const ServicesSchema: z.ZodObject<{
     }, z.core.$strict>>;
     logging: z.ZodOptional<z.ZodObject<{
         level: z.ZodEnum<{
-            info: "info";
-            warn: "warn";
             error: "error";
             silent: "silent";
+            warn: "warn";
+            info: "info";
             debug: "debug";
         }>;
     }, z.core.$strict>>;
-    recording: z.ZodOptional<z.ZodObject<{
-        enabled: z.ZodOptional<z.ZodBoolean>;
-    }, z.core.$strict>>;
+    recording: z.ZodOptional<z.ZodPrefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        keepFailuresOnly: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>>;
     accessibility: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodBoolean;
         standard: z.ZodOptional<z.ZodEnum<{
@@ -850,26 +362,21 @@ declare const ServicesSchema: z.ZodObject<{
         disableRules: z.ZodOptional<z.ZodArray<z.ZodString>>;
         exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>>;
-    memory: z.ZodOptional<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-        provider: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
-            local: "local";
-        }>>>;
-        dir: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-        minTrust: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-        maxInjections: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-        curatorEnabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-        curatorLockTimeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-        trustConfirmDelta: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-        trustContradictDelta: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-        ablationEnabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-        circuitBreakerEnabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-        circuitBreakerWindowSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-        circuitBreakerBaselineSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-        circuitBreakerThreshold: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    vision: z.ZodOptional<z.ZodObject<{
+        screenshotSize: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>>;
+        effectiveResolution: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>;
 }, z.core.$strict>;
 
+declare const KnowledgeConfigSchema: z.ZodObject<{
+    dir: z.ZodDefault<z.ZodString>;
+    commitArtifacts: z.ZodDefault<z.ZodEnum<{
+        none: "none";
+        thumbnails: "thumbnails";
+    }>>;
+    contextBudgetTokens: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+
 declare const TargetSchema: z.ZodObject<{
     product: z.ZodOptional<z.ZodString>;
     platform: z.ZodEnum<{
@@ -885,6 +392,11 @@ declare const TargetSchema: z.ZodObject<{
         browserstack: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
     url: z.ZodOptional<z.ZodString>;
+    environment: z.ZodOptional<z.ZodEnum<{
+        local: "local";
+        shared: "shared";
+        production: "production";
+    }>>;
 }, z.core.$strict>;
 declare const DeviceProfileSchema: z.ZodObject<{
     platform: z.ZodEnum<{
@@ -904,8 +416,7 @@ declare const RegistrySchema: z.ZodObject<{
         model: z.ZodString;
         baseURL: z.ZodOptional<z.ZodString>;
         providerHeaders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-        screenshotSize: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>>;
-        effectiveResolution: z.ZodOptional<z.ZodNumber>;
+        vision: z.ZodDefault<z.ZodBoolean>;
         name: z.ZodString;
         contextWindow: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>>;
     }, z.core.$strict>>>>;
@@ -924,6 +435,11 @@ declare const RegistrySchema: z.ZodObject<{
             browserstack: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>;
         url: z.ZodOptional<z.ZodString>;
+        environment: z.ZodOptional<z.ZodEnum<{
+            local: "local";
+            shared: "shared";
+            production: "production";
+        }>>;
     }, z.core.$strict>>>;
     devices: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         platform: z.ZodEnum<{
@@ -955,22 +471,18 @@ declare const ModelConfigSchema: z.ZodObject<{
     model: z.ZodString;
     baseURL: z.ZodOptional<z.ZodString>;
     providerHeaders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    screenshotSize: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>>;
-    effectiveResolution: z.ZodOptional<z.ZodNumber>;
+    vision: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strict>;
+declare const NameSlugSchema: z.ZodString;
 declare const NamedLLMConfigSchema: z.ZodObject<{
     provider: z.ZodString;
     model: z.ZodString;
     baseURL: z.ZodOptional<z.ZodString>;
     providerHeaders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    screenshotSize: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>>;
-    effectiveResolution: z.ZodOptional<z.ZodNumber>;
+    vision: z.ZodDefault<z.ZodBoolean>;
     name: z.ZodString;
     contextWindow: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>>;
 }, z.core.$strict>;
-declare const HealingConfigSchema: z.ZodObject<{
-    maxAttempts: z.ZodNumber;
-}, z.core.$strict>;
 declare const TimeoutConfigSchema: z.ZodObject<{
     step: z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>;
     test: z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>;
@@ -993,7 +505,8 @@ declare const TransportSchema: z.ZodEnum<{
     browserstack: "browserstack";
 }>;
 declare const PlannerConfigSchema: z.ZodObject<{
-    maxSubActions: z.ZodNumber;
+    maxActions: z.ZodOptional<z.ZodNumber>;
+    maxPlanningTurns: z.ZodOptional<z.ZodNumber>;
     previousStepCount: z.ZodNumber;
 }, z.core.$strict>;
 declare const LogCaptureConfigSchema: z.ZodObject<{
@@ -1006,28 +519,40 @@ declare const AuthPluginDeclarationSchema: z.ZodUnion<readonly [z.ZodObject<{
 }, z.core.$strict>, z.ZodObject<{
     path: z.ZodString;
 }, z.core.$strict>]>;
+declare const ProviderPluginDeclarationSchema: z.ZodUnion<readonly [z.ZodObject<{
+    package: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    path: z.ZodString;
+}, z.core.$strict>]>;
 declare const PluginsSchema: z.ZodObject<{
     auth: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
         package: z.ZodString;
     }, z.core.$strict>, z.ZodObject<{
         path: z.ZodString;
     }, z.core.$strict>]>>>>;
+    providers: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        package: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        path: z.ZodString;
+    }, z.core.$strict>]>>>>;
 }, z.core.$strict>;
-declare const AgentQaConfigSchema: z.ZodObject<{
+declare const AgentQaConfigSchema: z.ZodPipe<z.ZodAny, z.ZodObject<{
     workspace: z.ZodObject<{
         testMatch: z.ZodArray<z.ZodString>;
         suiteMatch: z.ZodArray<z.ZodString>;
         testPathIgnore: z.ZodOptional<z.ZodArray<z.ZodString>>;
         hooksFile: z.ZodString;
-        agentRules: z.ZodString;
         envFile: z.ZodString;
         secretsFile: z.ZodString;
     }, z.core.$strict>;
-    services: z.ZodOptional<z.ZodObject<{
+    services: z.ZodOptional<z.ZodPrefault<z.ZodObject<{
         dashboard: z.ZodOptional<z.ZodObject<{
             port: z.ZodOptional<z.ZodNumber>;
             dbPath: z.ZodOptional<z.ZodString>;
             artifactsDir: z.ZodOptional<z.ZodString>;
+            baseUrl: z.ZodOptional<z.ZodString>;
+            workspace: z.ZodOptional<z.ZodString>;
+            host: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>;
         mcp: z.ZodOptional<z.ZodObject<{
             enabled: z.ZodOptional<z.ZodBoolean>;
@@ -1035,7 +560,7 @@ declare const AgentQaConfigSchema: z.ZodObject<{
                 http: "http";
                 stdio: "stdio";
             }>>;
-            host: z.ZodOptional<z.ZodString & z.ZodType<"localhost" | "127.0.0.1" | "::1", string, z.core.$ZodTypeInternals<"localhost" | "127.0.0.1" | "::1", string>>>;
+            host: z.ZodOptional<z.ZodString>;
             port: z.ZodOptional<z.ZodNumber>;
             path: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>;
@@ -1048,16 +573,17 @@ declare const AgentQaConfigSchema: z.ZodObject<{
         }, z.core.$strict>>;
         logging: z.ZodOptional<z.ZodObject<{
             level: z.ZodEnum<{
-                info: "info";
-                warn: "warn";
                 error: "error";
                 silent: "silent";
+                warn: "warn";
+                info: "info";
                 debug: "debug";
             }>;
         }, z.core.$strict>>;
-        recording: z.ZodOptional<z.ZodObject<{
-            enabled: z.ZodOptional<z.ZodBoolean>;
-        }, z.core.$strict>>;
+        recording: z.ZodOptional<z.ZodPrefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            keepFailuresOnly: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>>;
         accessibility: z.ZodOptional<z.ZodObject<{
             enabled: z.ZodBoolean;
             standard: z.ZodOptional<z.ZodEnum<{
@@ -1074,24 +600,18 @@ declare const AgentQaConfigSchema: z.ZodObject<{
             disableRules: z.ZodOptional<z.ZodArray<z.ZodString>>;
             exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strict>>;
-        memory: z.ZodOptional<z.ZodObject<{
-            enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-            provider: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
-                local: "local";
-            }>>>;
-            dir: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-            minTrust: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-            maxInjections: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-            curatorEnabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-            curatorLockTimeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-            trustConfirmDelta: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-            trustContradictDelta: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-            ablationEnabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-            circuitBreakerEnabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-            circuitBreakerWindowSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-            circuitBreakerBaselineSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-            circuitBreakerThreshold: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        vision: z.ZodOptional<z.ZodObject<{
+            screenshotSize: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>>;
+            effectiveResolution: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
+    }, z.core.$strict>>>;
+    knowledge: z.ZodPrefault<z.ZodObject<{
+        dir: z.ZodDefault<z.ZodString>;
+        commitArtifacts: z.ZodDefault<z.ZodEnum<{
+            none: "none";
+            thumbnails: "thumbnails";
+        }>>;
+        contextBudgetTokens: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>;
     registry: z.ZodOptional<z.ZodObject<{
         llms: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -1099,8 +619,7 @@ declare const AgentQaConfigSchema: z.ZodObject<{
             model: z.ZodString;
             baseURL: z.ZodOptional<z.ZodString>;
             providerHeaders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-            screenshotSize: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>>;
-            effectiveResolution: z.ZodOptional<z.ZodNumber>;
+            vision: z.ZodDefault<z.ZodBoolean>;
             name: z.ZodString;
             contextWindow: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>>;
         }, z.core.$strict>>>>;
@@ -1119,6 +638,11 @@ declare const AgentQaConfigSchema: z.ZodObject<{
                 browserstack: z.ZodOptional<z.ZodString>;
             }, z.core.$strict>>;
             url: z.ZodOptional<z.ZodString>;
+            environment: z.ZodOptional<z.ZodEnum<{
+                local: "local";
+                shared: "shared";
+                production: "production";
+            }>>;
         }, z.core.$strict>>>;
         devices: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
             platform: z.ZodEnum<{
@@ -1157,11 +681,9 @@ declare const AgentQaConfigSchema: z.ZodObject<{
             test: z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>;
             navigation: z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>;
         }, z.core.$strict>>;
-        healing: z.ZodOptional<z.ZodObject<{
-            maxAttempts: z.ZodNumber;
-        }, z.core.$strict>>;
         planner: z.ZodOptional<z.ZodObject<{
-            maxSubActions: z.ZodNumber;
+            maxActions: z.ZodOptional<z.ZodNumber>;
+            maxPlanningTurns: z.ZodOptional<z.ZodNumber>;
             previousStepCount: z.ZodNumber;
         }, z.core.$strict>>;
         logCapture: z.ZodOptional<z.ZodObject<{
@@ -1170,7 +692,9 @@ declare const AgentQaConfigSchema: z.ZodObject<{
         }, z.core.$strict>>;
         cache: z.ZodOptional<z.ZodBoolean>;
         llm: z.ZodOptional<z.ZodString>;
+        buildTag: z.ZodOptional<z.ZodString>;
         parallel: z.ZodOptional<z.ZodBoolean>;
+        workers: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>;
     plugins: z.ZodOptional<z.ZodObject<{
         auth: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
@@ -1178,6 +702,11 @@ declare const AgentQaConfigSchema: z.ZodObject<{
         }, z.core.$strict>, z.ZodObject<{
             path: z.ZodString;
         }, z.core.$strict>]>>>>;
+        providers: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            package: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            path: z.ZodString;
+        }, z.core.$strict>]>>>>;
     }, z.core.$strict>>;
     analytics: z.ZodOptional<z.ZodObject<{
         privacy: z.ZodOptional<z.ZodLiteral<true>>;
@@ -1187,7 +716,31 @@ declare const AgentQaConfigSchema: z.ZodObject<{
             }, z.core.$strict>]>>>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
-}, z.core.$strict>;
+    allowProduction: z.ZodOptional<z.ZodBoolean>;
+    eval: z.ZodOptional<z.ZodObject<{
+        judge: z.ZodOptional<z.ZodString>;
+        judges: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        judgeAllowSameFamily: z.ZodOptional<z.ZodBoolean>;
+        k: z.ZodOptional<z.ZodNumber>;
+        seed: z.ZodOptional<z.ZodNumber>;
+        gate1: z.ZodOptional<z.ZodObject<{
+            maxScreens: z.ZodOptional<z.ZodNumber>;
+            maxPerJob: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        gate2: z.ZodOptional<z.ZodObject<{
+            maxAblations: z.ZodOptional<z.ZodNumber>;
+            canaryHorizonBuilds: z.ZodOptional<z.ZodNumber>;
+            maxLowerTrustPerScope: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        adversarial: z.ZodOptional<z.ZodObject<{
+            maxSeedsPerRefresh: z.ZodOptional<z.ZodNumber>;
+            maxProbeCalls: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        seeding: z.ZodOptional<z.ZodObject<{
+            silverPerTestCap: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>>;
 
 type AgentQaConfig = z.infer<typeof AgentQaConfigSchema>;
 type WorkspaceConfig = z.infer<typeof WorkspaceSchema>;
@@ -1206,6 +759,16 @@ declare const ActionPlanSchema: z.ZodObject<{
 }, z.core.$strip>;
 type ActionPlan = z.infer<typeof ActionPlanSchema>;
 
+/**
+ * Resolve the repo-relative directory validated by KnowledgeConfigSchema. `configDir` is the
+ * directory containing agent-qa.config.yaml (the repository root by the committed-root
+ * convention). Composition roots call this helper; Phase 374 has no live producer, so the first
+ * runtime caller is Phase 378's Curator binding (D-01/D-14).
+ */
+declare function resolveKnowledgeRoot(knowledge: {
+    dir: string;
+}, configDir: string): string;
+
 declare const SuiteTestEntrySchema: z.ZodObject<{
     test: z.ZodString;
     id: z.ZodString;
@@ -1221,7 +784,7 @@ declare const SuiteDefinitionSchema: z.ZodObject<{
         test: z.ZodString;
         id: z.ZodString;
     }, z.core.$strict>>;
-    use: z.ZodOptional<z.ZodObject<{
+    use: z.ZodOptional<z.ZodPipe<z.ZodAny, z.ZodObject<{
         browser: z.ZodOptional<z.ZodObject<{
             name: z.ZodOptional<z.ZodEnum<{
                 chromium: "chromium";
@@ -1239,11 +802,9 @@ declare const SuiteDefinitionSchema: z.ZodObject<{
             test: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>>;
             navigation: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>>;
         }, z.core.$strict>>;
-        healing: z.ZodOptional<z.ZodObject<{
-            maxAttempts: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strict>>;
         planner: z.ZodOptional<z.ZodObject<{
-            maxSubActions: z.ZodOptional<z.ZodNumber>;
+            maxActions: z.ZodOptional<z.ZodNumber>;
+            maxPlanningTurns: z.ZodOptional<z.ZodNumber>;
             previousStepCount: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
         logCapture: z.ZodOptional<z.ZodObject<{
@@ -1264,8 +825,9 @@ declare const SuiteDefinitionSchema: z.ZodObject<{
         }, z.core.$strict>>;
         llm: z.ZodOptional<z.ZodString>;
         parallel: z.ZodOptional<z.ZodBoolean>;
+        workers: z.ZodOptional<z.ZodNumber>;
         device: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>>;
+    }, z.core.$strict>>>;
 }, z.core.$strict>;
 
 declare const HookDefinitionSchema: z.ZodObject<{
@@ -1320,11 +882,26 @@ interface ParseResult {
     tests: TestDefinition[];
     errors: ParseError[];
 }
-declare function parseTestFile(content: string, filePath: string): ParseResult;
-declare function parseAllTests(filePaths: string[]): Promise<ParseResult>;
-
-interface FileAttachment {
-    name: string;
+/**
+ * One parsed test paired with the exact source that produced it. ABRF-02 stable identity is
+ * `filePath + test.name`; the legacy flattened parse result cannot retain that association and
+ * caused multi-file direct runs to stamp every member with the first discovered file (CR-02).
+ */
+interface ParsedTestBinding {
+    test: TestDefinition;
+    filePath: string;
+    fileContent: string;
+}
+interface ParseAllTestBindingsResult {
+    bindings: ParsedTestBinding[];
+    errors: ParseError[];
+}
+declare function parseTestFile(content: string, filePath: string): ParseResult;
+declare function parseAllTestBindings(filePaths: string[]): Promise<ParseAllTestBindingsResult>;
+declare function parseAllTests(filePaths: string[]): Promise<ParseResult>;
+
+interface FileAttachment {
+    name: string;
     path: string;
     content: Buffer;
     mimeType: string;
@@ -1346,167 +923,92 @@ interface SuiteResult {
 
 declare function parseSuiteFile(filePath: string): Promise<SuiteDefinition>;
 
-type LogLevel = 'silent' | 'error' | 'warn' | 'info' | 'debug';
-declare const LOG_LEVEL_PRIORITY: Record<LogLevel, number>;
-type LogSource = 'agent' | 'adapter' | 'cache' | 'planner' | 'healer' | 'hook' | 'runner';
-interface LogEntry {
-    id: string;
-    stepId: string | null;
-    runId: string;
-    level: Exclude<LogLevel, 'silent'>;
-    source: LogSource;
-    message: string;
-    data: Record<string, unknown>;
-    timestamp: string;
-}
-interface LogStorage {
-    insertLogs(entries: LogEntry[]): void;
-    getLogs(opts: {
-        runId?: string;
-        stepId?: string;
-        level?: string;
-        source?: string;
-        limit?: number;
-        offset?: number;
-    }): LogEntry[];
-}
-interface ScopedLogger {
-    debug(msg: string, data?: Record<string, unknown>): void;
-    info(msg: string, data?: Record<string, unknown>): void;
-    warn(msg: string, data?: Record<string, unknown>): void;
-    error(msg: string, data?: Record<string, unknown>): void;
-}
-declare const AgentLogDataSchema: z.ZodObject<{
-    extractDom: z.ZodOptional<z.ZodBoolean>;
-    hasScreenshot: z.ZodOptional<z.ZodBoolean>;
-    duration: z.ZodOptional<z.ZodNumber>;
-    elementCount: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
-declare const AdapterLogDataSchema: z.ZodObject<{
-    actionType: z.ZodOptional<z.ZodString>;
-    selector: z.ZodOptional<z.ZodString>;
-    coordinates: z.ZodOptional<z.ZodObject<{
-        x: z.ZodNumber;
-        y: z.ZodNumber;
-    }, z.core.$strip>>;
-    elementProperties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    duration: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
-declare const CacheLogDataSchema: z.ZodObject<{
-    operation: z.ZodEnum<{
-        set: "set";
-        get: "get";
-        invalidate: "invalidate";
-        bypass: "bypass";
-        "batch-purge": "batch-purge";
-    }>;
-    stepHash: z.ZodOptional<z.ZodString>;
-    screenHash: z.ZodOptional<z.ZodString>;
-    hit: z.ZodOptional<z.ZodBoolean>;
-    age: z.ZodOptional<z.ZodNumber>;
-    entriesDeleted: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
-declare const PlannerLogDataSchema: z.ZodObject<{
-    model: z.ZodOptional<z.ZodString>;
-    promptTokens: z.ZodOptional<z.ZodNumber>;
-    completionTokens: z.ZodOptional<z.ZodNumber>;
-    latencyMs: z.ZodOptional<z.ZodNumber>;
-    confidence: z.ZodOptional<z.ZodNumber>;
-    actionType: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-declare const HealerLogDataSchema: z.ZodObject<{
-    strategy: z.ZodOptional<z.ZodString>;
-    attempt: z.ZodOptional<z.ZodNumber>;
-    maxAttempts: z.ZodOptional<z.ZodNumber>;
-    stateDiffDetected: z.ZodOptional<z.ZodBoolean>;
-    success: z.ZodOptional<z.ZodBoolean>;
-}, z.core.$strip>;
-declare const HookLogDataSchema: z.ZodObject<{
-    hookName: z.ZodOptional<z.ZodString>;
-    phase: z.ZodOptional<z.ZodEnum<{
-        setup: "setup";
-        teardown: "teardown";
-    }>>;
-    duration: z.ZodOptional<z.ZodNumber>;
-    success: z.ZodOptional<z.ZodBoolean>;
-}, z.core.$strip>;
-declare const RunnerLogDataSchema: z.ZodObject<{
-    stepIndex: z.ZodOptional<z.ZodNumber>;
-    totalSteps: z.ZodOptional<z.ZodNumber>;
-    testName: z.ZodOptional<z.ZodString>;
-    variablesCaptured: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
-declare const LogSourceDataSchemas: Record<LogSource, z.ZodType>;
-
-interface SecretTemplate {
-    pattern: string;
-    name: string;
+/**
+ * A test document parsed so that BOTH halves survive: the composed model a pointer resolves
+ * against, and the token array the render concatenates.
+ *
+ * The two are not redundant. Pointer resolution needs the model (`getIn`-shaped navigation over
+ * maps and sequences); byte preservation needs the tokens. Handing a caller only one of them would
+ * force it to re-parse to get the other, and a second parse is a second opinion about the source.
+ */
+interface ParsedTestDocument {
+    readonly source: string;
+    readonly filePath: string;
+    readonly tokens: CST.Token[];
+    readonly doc: Document;
+}
+/** A pointer addressed a document root outside `EDITABLE_POINTER_ROOTS` (T-394-10). */
+declare class PatchPointerOutsideEditableRegionError extends Error {
+    readonly pointer: string;
+    constructor(pointer: string);
+}
+/** A pointer named a node the document does not have. */
+declare class PatchPointerUnresolvableError extends Error {
+    readonly pointer: string;
+    readonly detail: string;
+    constructor(pointer: string, detail: string);
 }
-interface SecretFileMetadata {
-    count: number;
-}
-declare class SecretConfigError extends Error {
-    constructor(message: string);
-}
-declare class MissingSecretError extends Error {
-    constructor(name: string);
-}
-declare class SecretStore {
-    private storage;
-    constructor(secrets?: Record<string, string>);
-    static empty(): SecretStore;
-    static fromEnvContent(content: string): SecretStore;
-    private set;
-    get(name: string): string | undefined;
-    require(name: string): string;
-    has(name: string): boolean;
-    count(): number;
-    metadata(): SecretFileMetadata;
-    forEachSecret(callback: (name: string, value: string) => void): void;
-}
-declare function findSecretTemplates(text: string): SecretTemplate[];
-declare function interpolateSecretTemplates(template: string, store: SecretStore): string;
-declare function resolveSecretTemplatesInValue<T>(value: T, store?: SecretStore): T;
-declare function redactSecretValue<T>(value: T, redactor?: SecretRedactor): T;
-declare class SecretRedactor {
-    private readonly store;
-    private readonly genericMarker;
-    private valuePatterns;
-    constructor(store: SecretStore, genericMarker?: string);
-    redactString(value: string): string;
-    redactValue(value: unknown): unknown;
+/**
+ * The op cannot be applied to the node its pointer reached.
+ *
+ * `add` and `remove` operate on block-sequence items only. Adding or removing a top-level KEY
+ * changes the document's shape rather than its content, and D-02 already routes a shape change
+ * through whole-document emission with a full schema validation — so admitting it here would
+ * publish a second, weaker path to the same outcome.
+ */
+declare class PatchOpUnsupportedTargetError extends Error {
+    readonly pointer: string;
+    readonly detail: string;
+    constructor(pointer: string, detail: string);
 }
-
-declare class LogManager {
-    private buffer;
-    private currentStepId;
-    private runId;
-    private runIdSet;
-    private readonly displayLevel;
-    private readonly storage?;
-    private readonly ndjson;
-    private redactor?;
-    constructor(opts: {
-        runId?: string;
-        displayLevel: LogLevel;
-        storage?: LogStorage;
-        ndjson?: boolean;
-        redactor?: SecretRedactor;
-    });
-    setRedactor(redactor: SecretRedactor | undefined): void;
-    log(level: Exclude<LogLevel, 'silent'>, source: LogSource, message: string, data?: Record<string, unknown>): void;
-    private shouldDisplay;
-    private emitNdjson;
-    setCurrentStep(stepId: string): void;
-    clearCurrentStep(): void;
-    setRunId(runId: string): void;
-    flush(): void;
-    getBuffer(): LogEntry[];
-    createScopedLogger(source: LogSource): ScopedLogger;
+/**
+ * A document this project cannot run — checked on the SOURCE before anything is applied and on the
+ * RENDERED bytes before anything may be written.
+ *
+ * Both directions matter. Validating only the render would let a pre-existing invalidity be
+ * blamed on the patch; validating only the source would let a CST mutation that produced
+ * structurally broken YAML reach a file. Same predicate, same evidence, two call sites.
+ */
+declare class PatchedDocumentInvalidError extends Error {
+    readonly phase: 'source' | 'rendered';
+    readonly detail: string;
+    constructor(phase: 'source' | 'rendered', detail: string);
 }
+/**
+ * Parse a test file retaining the CST token array beside the composed document.
+ *
+ * The composer is given `keepSourceTokens` so every node carries a `srcToken` back-reference; that
+ * back-reference is the entire bridge between a pointer (which addresses the model) and a mutation
+ * (which must land on the syntax).
+ */
+declare function parseTestFileWithTokens(source: string, filePath: string): ParsedTestDocument;
+/**
+ * Apply a patch set in document order, mutating `parsed.doc` and its tokens in place.
+ *
+ * TWO PROPERTIES THE ORDER BUYS. First, the fence runs over the WHOLE set before any mutation, so
+ * a set mixing a legitimate op with an out-of-region one leaves nothing behind — a per-op check
+ * would have already rewritten the legitimate target by the time it refused. Second, each pointer
+ * resolves against the document as PRIOR ops left it, which is what RFC-6902 means by a sequence
+ * of operations: an `add` earlier in an array shifts every later index, and resolving every
+ * pointer against the original document would edit a plausible, schema-valid, wrong step.
+ */
+declare function applyPatchSetToTestDoc(parsed: ParsedTestDocument, patchSet: TestEditPatchSet): void;
+/**
+ * Concatenate the whole token array back to bytes, then refuse anything unrunnable.
+ *
+ * THE RENDER IS OVER `parsed.tokens`, NEVER OVER THE DOCUMENT TOKEN ALONE. `CST.stringify`'s own
+ * doc comment states it "applies no validation whatsoever, and simply concatenates the sources in
+ * their logical order" — that concatenation IS the byte-preservation guarantee. A file's leading
+ * comment is a separate token in the parser's output stream, positioned BEFORE the document token,
+ * so `CST.stringify(documentToken)` drops it. That is the one genuinely non-obvious line here, it
+ * was measured rather than reasoned about, and the frozen corpus's untouched-round-trip row is
+ * the cell that catches a regression to it.
+ */
+declare function renderPatchedTestDoc(parsed: ParsedTestDocument, filePath?: string): string;
 
 interface PlannerConfig {
-    maxSubActions: number;
+    maxActions: number;
+    maxPlanningTurns: number;
     previousStepCount: number;
 }
 interface PlanResult {
@@ -1517,36 +1019,11 @@ interface VerifyResult {
     verification: VerificationResult;
     tokenUsage?: TokenUsage;
 }
-type AgentPhase = {
-    type: 'observe';
-} | {
-    type: 'plan';
-    screenState: ScreenState;
-} | {
-    type: 'execute';
-    action: Action;
-    screenStateBefore: ScreenState;
-} | {
-    type: 'verify';
-    action: Action;
-    screenStateBefore: ScreenState;
-    result: ActionResult;
-} | {
-    type: 'heal';
-    error: string;
-    attempts: HealingAttempt[];
-    screenStateBefore: ScreenState;
-    failedAction: Action;
-} | {
-    type: 'done';
-    result: StepResult;
-};
 interface StepContext {
     stepInstruction: string;
     testName: string;
     testContext?: string;
     suiteContext?: string;
-    agentRules?: string;
     previousSteps: {
         instruction: string;
         outcome: string;
@@ -1557,7 +1034,6 @@ interface StepContext {
     contextWindow?: number;
     plannerModel: LanguageModel;
     verifierModel: LanguageModel;
-    healingConfig: HealingConfig;
     modelId?: string;
     variables?: Record<string, string>;
     memoryContext?: string;
@@ -1574,79 +1050,24 @@ interface StepContext {
     }[];
     plannerConfig?: PlannerConfig;
     screenshot?: Buffer;
-}
-interface HealingConfig {
-    maxAttempts: number;
-}
-interface AgentLoopConfig {
-    adapter: PlatformAdapter;
-    planner: Planner;
-    verifier?: Verifier;
-    cache?: ActionCache;
-    healingConfig: HealingConfig;
-    plannerConfig?: PlannerConfig;
-    /** Wall-clock timeout for a single step (ms). 0 or undefined = no timeout. */
-    stepTimeout?: number;
-    /** Override the consecutive failure limit for this step. */
-    maxAttempts?: number;
-    logger?: LogManager;
-    configContent?: string;
-    testFileContent?: string;
-    testFilePath?: string;
-    stepIndex?: number;
-    suiteFileContent?: string;
-    suiteTestIndex?: number;
-    cacheState?: {
-        invalidated: boolean;
-    };
-    logCapture?: {
-        console?: boolean;
-        network?: boolean;
-    };
-    screenshotSize?: number;
-    /** Max image edge (pixels) to resize screenshots to before sending to LLM. From ModelConfig. */
-    effectiveResolution?: number;
-    onSetVariable?: (name: string, value: string) => void;
-    onPhase?: (event: StepPhaseEvent) => void | Promise<void>;
-    abortSignal?: AbortSignal;
-    secretStore?: SecretStore;
-    secretRedactor?: SecretRedactor;
+    /**
+     * Vision-gate prompt note for this run (D-11). Non-empty only for text-only
+     * models; injected into the planner prompt when present. Threaded from the
+     * loop's `visionGate.promptNote` — a structural value, not a model import.
+     */
+    promptNote?: string;
 }
 interface Planner {
     plan(step: string, screenState: ScreenState, context: StepContext, abortSignal?: AbortSignal): Promise<PlanResult>;
 }
 interface Verifier {
-    verify(step: string, before: ScreenState, after: ScreenState, action: Action, screenshot?: Buffer, abortSignal?: AbortSignal): Promise<VerifyResult>;
+    verify(step: string, before: ScreenState, after: ScreenState, action: Action, screenshot?: Buffer, abortSignal?: AbortSignal, promptNote?: string): Promise<VerifyResult>;
 }
 interface VerificationResult {
     success: boolean;
     reasoning: string;
     isAppError: boolean;
 }
-interface ActionCache {
-    get(stepHash: string, screenHash: string): Promise<ActionPlan | null>;
-    set(stepHash: string, screenHash: string, plan: ActionPlan): Promise<void>;
-    invalidate(stepHash: string, screenHash: string): Promise<void>;
-    getSubAction(stepHash: string, index: number): Promise<ActionPlan | null>;
-    setSubAction(stepHash: string, index: number, plan: ActionPlan): Promise<void>;
-    invalidateSubActionsFrom(stepHash: string, fromIndex: number): Promise<void>;
-}
-type AssertionType = 'text-presence' | 'element-visibility' | 'url-match' | 'element-count' | 'ai';
-interface AssertionResult {
-    passed: boolean;
-    assertionType: AssertionType;
-    expected: string;
-    actual: string;
-    reasoning: string;
-}
-interface Asserter {
-    evaluate(assertion: AssertionInput, screenState: ScreenState): Promise<AssertionResult>;
-}
-interface AssertionInput {
-    type: AssertionType;
-    value: string;
-    expected?: string;
-}
 type ExtractionMethod = 'regex' | 'selector' | 'ai';
 interface ExtractorInput {
     method: ExtractionMethod;
@@ -1665,844 +1086,8 @@ interface VariableExtractor {
     extract(input: ExtractorInput, screenState: ScreenState): Promise<CaptureResult>;
 }
 
-declare function truncateScreenState(state: ScreenState): string;
-declare function hashScreenState(state: ScreenState): string;
-interface StepHashInputs {
-    step: string;
-    platform?: string;
-    configContent?: string;
-    testFileContent?: string;
-    stepIndex?: number;
-    suiteFileContent?: string;
-    suiteTestIndex?: number;
-}
-declare function hashStepInstruction(inputs: StepHashInputs): string;
-declare function hashStepInstruction(step: string, platform?: string, configContent?: string, testFileContent?: string, stepIndex?: number): string;
-
 declare function estimateTokens(text: string): number;
 
-declare const SUPPORTED_PROVIDERS: readonly ["openai-compatible", "anthropic-compatible", "openai-subscription", "anthropic-subscription", "gemini"];
-type BuiltInProviderMode = typeof SUPPORTED_PROVIDERS[number];
-type ProviderMode = BuiltInProviderMode | (string & {});
-type LLMModelAdapter$1 = 'openai-responses' | 'anthropic-messages';
-interface ModelConfig {
-    provider: ProviderMode;
-    model: string;
-    modelAdapter?: LLMModelAdapter$1;
-    apiKey?: string;
-    authToken?: string;
-    baseURL?: string;
-    providerHeaders?: Record<string, string>;
-    fetch?: typeof globalThis.fetch;
-}
-type JSONValue = string | number | boolean | null | JSONValue[] | {
-    [key: string]: JSONValue | undefined;
-};
-type ProviderOptions = Record<string, Record<string, JSONValue | undefined>> | undefined;
-declare function getProviderOptions(config: ModelConfig): ProviderOptions;
-declare function createModel(config: ModelConfig): Promise<LanguageModel>;
-
-declare class LLMPlanner implements Planner {
-    private model;
-    private platform;
-    private providerOptions;
-    private logger?;
-    private agentRules?;
-    constructor(model: LanguageModel, platform?: 'web' | 'android' | 'ios', providerOptions?: ProviderOptions, logger?: ScopedLogger, agentRules?: string);
-    plan(step: string, screenState: ScreenState, context: StepContext, abortSignal?: AbortSignal): Promise<PlanResult>;
-}
-
-declare const VerificationResultSchema: z.ZodObject<{
-    success: z.ZodBoolean;
-    reasoning: z.ZodString;
-    isAppError: z.ZodBoolean;
-}, z.core.$strip>;
-declare class LLMVerifier implements Verifier {
-    private model;
-    private providerOptions;
-    constructor(model: LanguageModel, providerOptions?: ProviderOptions);
-    verify(step: string, before: ScreenState, after: ScreenState, action: Action, screenshot?: Buffer, abortSignal?: AbortSignal): Promise<VerifyResult>;
-}
-
-declare function buildSystemPrompt(platform?: 'web' | 'android' | 'ios', agentRules?: string): string;
-declare function buildStepPrompt(step: string, screenState: ScreenState, context: StepContext, logger?: ScopedLogger, systemPromptContext?: {
-    platform?: 'web' | 'android' | 'ios';
-    agentRules?: string;
-}): string;
-declare function buildVerificationPrompt(step: string, beforeState: ScreenState, afterState: ScreenState, action: Action, hasScreenshot?: boolean): string;
-declare function buildAssertionPrompt(assertion: AssertionInput, screenState: ScreenState): string;
-declare function buildExtractionPrompt(input: ExtractorInput, screenState: ScreenState): string;
-
-type ToolCategory = 'action' | 'file' | 'network';
-interface ToolDefinition<T extends z.ZodType = z.ZodType> {
-    name: string;
-    description: string;
-    category: ToolCategory;
-    platform?: ('web' | 'android' | 'ios')[];
-    schema: T;
-}
-
-declare class ToolRegistry {
-    private tools;
-    register<T extends z.ZodType>(def: ToolDefinition<T>): this;
-    get(name: string): ToolDefinition | undefined;
-    getAll(): ToolDefinition[];
-    getFiltered(options: {
-        platform?: string;
-        categories?: ToolCategory[];
-    }): ToolDefinition[];
-    getSchema(name: string): z.ZodType;
-    generateDocs(platform?: string): string;
-}
-declare const defaultRegistry: ToolRegistry;
-
-declare const MOBILE_ONLY_ACTIONS: Set<string>;
-declare const WEB_ONLY_ACTIONS: Set<string>;
-
-declare function buildTools(registry: ToolRegistry, options: {
-    platform: 'web' | 'android' | 'ios';
-    categories?: ToolCategory[];
-}): Record<string, ai.Tool<any, any>>;
-declare function toolCallToActionPlan(toolName: string, args: Record<string, unknown>, registry: ToolRegistry): {
-    reasoning: string;
-    confidence: number;
-    stepComplete: boolean;
-    stepFailed: boolean;
-    action: {
-        type: string;
-    };
-};
-
-declare const toolSchemaMiddleware: LanguageModelMiddleware;
-declare function createWrappedModel(baseModel: Parameters<typeof wrapLanguageModel>[0]['model']): LanguageModel;
-
-declare const AssertionResultSchema: z.ZodObject<{
-    passed: z.ZodBoolean;
-    reasoning: z.ZodString;
-    evidence: z.ZodString;
-}, z.core.$strip>;
-declare class AssertionEvaluator implements Asserter {
-    evaluate(assertion: AssertionInput, screenState: ScreenState): Promise<AssertionResult>;
-    private evaluateTextPresence;
-    private evaluateElementVisibility;
-    private evaluateUrlMatch;
-    private evaluateElementCount;
-}
-declare class LLMAssertionEvaluator implements Asserter {
-    private model;
-    constructor(model: LanguageModel);
-    evaluate(assertion: AssertionInput, screenState: ScreenState): Promise<AssertionResult>;
-}
-declare function createAsserter(model?: LanguageModel): Asserter;
-
-declare function executeStep(stepInstruction: string, config: AgentLoopConfig, context: StepContext): Promise<StepResult>;
-
-interface RebuildCommand {
-    command: string;
-    args: string[];
-}
-declare function isBetterSqlite3AbiMismatch(error: unknown): boolean;
-declare function isBetterSqlite3NativeModuleError(error: unknown): boolean;
-declare function isBetterSqlite3NodeGypSymlinkConflict(error: unknown): boolean;
-declare function resolveBetterSqliteRebuildCommand(): RebuildCommand;
-type BetterSqlite3Database = better_sqlite3.Database;
-declare function createBetterSqlite3Database(path: string): BetterSqlite3Database;
-
-interface MemoryIndexParams {
-    product: string;
-    suiteId?: string;
-    testId: string;
-    memoryRoot: string;
-    currentSuiteTests?: Array<{
-        test: string;
-        id: string;
-    }>;
-    currentPosition?: number;
-}
-declare function buildMemoryIndex(params: MemoryIndexParams): Promise<BetterSqlite3Database | null>;
-
-declare const BaseObservationSchema: z.ZodObject<{
-    id: z.ZodString;
-    title: z.ZodString;
-    content: z.ZodString;
-    trust: z.ZodNumber;
-    created: z.ZodString;
-    last_confirmed: z.ZodString;
-    confirmed_count: z.ZodNumber;
-    contradicted_count: z.ZodNumber;
-    source_test: z.ZodString;
-}, z.core.$strip>;
-declare const SuiteObservationSchema: z.ZodObject<{
-    id: z.ZodString;
-    title: z.ZodString;
-    content: z.ZodString;
-    trust: z.ZodNumber;
-    created: z.ZodString;
-    last_confirmed: z.ZodString;
-    confirmed_count: z.ZodNumber;
-    contradicted_count: z.ZodNumber;
-    source_test: z.ZodString;
-    position: z.ZodNumber;
-    suite_snapshot: z.ZodArray<z.ZodObject<{
-        test: z.ZodString;
-        id: z.ZodString;
-    }, z.core.$strict>>;
-}, z.core.$strip>;
-type BaseObservation = z.infer<typeof BaseObservationSchema>;
-type SuiteObservation = z.infer<typeof SuiteObservationSchema>;
-
-interface MemoryObservationSnippet {
-    id: string;
-    title: string;
-    content: string;
-    trust: number;
-}
-interface MemoryQueryResult {
-    observations: MemoryObservationSnippet[];
-    formatted: string;
-}
-interface MemoryProvider {
-    init(params: MemoryIndexParams): Promise<void>;
-    queryForStep(stepText: string, stepIndex: number): MemoryQueryResult | null;
-    destroy(): void;
-    acquireLock(): Promise<void>;
-    releaseLock(): Promise<void>;
-    writeObservation(tier: 'products' | 'suites' | 'tests', scope: string, data: BaseObservation | SuiteObservation): Promise<string>;
-    deleteObservation(tier: 'products' | 'suites' | 'tests', scope: string, id: string): Promise<void>;
-    searchForDuplicates(content: string): MemoryObservationSnippet[];
-    getAllObservations(): MemoryObservationSnippet[];
-    getInjectedObservations(stepIndex: number): string[];
-    getRunAnalytics(): unknown;
-}
-
-interface CircuitBreakerConfig {
-    windowSize: number;
-    baselineSize: number;
-    threshold: number;
-}
-declare class CircuitBreaker {
-    private config;
-    private window;
-    private _tripped;
-    constructor(config?: Partial<CircuitBreakerConfig>);
-    record(outcome: {
-        withMemory: boolean;
-        passed: boolean;
-    }): void;
-    isTripped(): boolean;
-    private evaluate;
-}
-
-type RunAttributes = Record<string, string>;
-declare const INTERNAL_ATTRIBUTE_PREFIX = "agent-qa.";
-declare const ATTR_TRIGGER = "agent-qa.trigger";
-declare const ATTR_RUNNER = "agent-qa.runner";
-type RunAttributeTrigger = 'cli' | 'dashboard' | 'api' | 'mcp';
-type RunAttributeRunner = 'local' | 'browserstack';
-declare const RUN_ATTRIBUTE_KEY_MAX_LENGTH = 256;
-declare const RUN_ATTRIBUTE_VALUE_MAX_LENGTH = 4096;
-interface ParsedRunAttrFlags {
-    attributes: RunAttributes;
-    duplicateKeys: string[];
-}
-declare function validateUserRunAttributes(input: unknown, sourceLabel?: string): RunAttributes;
-declare function validateTrustedRunAttributes(input: unknown, sourceLabel?: string): RunAttributes;
-declare function parseRunAttrFlags(flags: string[] | undefined): ParsedRunAttrFlags;
-declare function buildInternalRunAttributes(input: {
-    trigger: RunAttributeTrigger;
-    runner: RunAttributeRunner;
-}): RunAttributes;
-declare function mergeRunAttributes(internal: RunAttributes, user: RunAttributes): RunAttributes;
-declare function sortRunAttributesForDisplay(attributes: RunAttributes, activeKeys?: string[]): Array<[string, string]>;
-declare function formatRunAttributesBlock(attributes: RunAttributes): string;
-
-declare const RUN_ARTIFACT_SCHEMA_VERSION: 1;
-type RunArtifactKind = 'test' | 'suite-parent' | 'suite-child' | 'unknown';
-type JsonPrimitive = string | number | boolean | null;
-type JsonValue = JsonPrimitive | JsonObject | JsonArray;
-interface JsonObject {
-    [key: string]: JsonValue;
-}
-type JsonArray = JsonValue[];
-type ArtifactRecord = Record<string, unknown>;
-interface RunArtifactMetadata extends ArtifactRecord {
-    attributes?: RunAttributes;
-}
-interface RunArtifactTerminalError {
-    code: string;
-    message: string;
-    phase: string;
-    details?: unknown;
-}
-interface RunArtifactConfigSnapshot {
-    rawConfigContent?: string | null;
-    parsedConfig?: unknown;
-    effectiveConfig?: unknown;
-    envFile?: {
-        path: string | null;
-        content: string | null;
-        variables: Record<string, string>;
-    };
-    secretsFile?: {
-        path: string | null;
-        status: 'loaded' | 'missing' | 'unreadable' | 'invalid';
-        count?: number;
-    } | null;
-    cliVars?: Record<string, string>;
-    inlineVars?: Record<string, string>;
-    hooks?: Array<{
-        id: string;
-        name: string;
-        runtime?: string;
-        sourcePath?: string;
-    }>;
-    model?: {
-        planner?: {
-            provider?: string;
-            model?: string;
-        };
-        verifier?: {
-            provider?: string;
-            model?: string;
-        };
-    };
-    runtime?: ArtifactRecord;
-    timeouts?: ArtifactRecord;
-    cache?: ArtifactRecord;
-    memory?: ArtifactRecord;
-}
-interface RunArtifactTestSourceSnapshot {
-    kind: 'test';
-    testId?: string | null;
-    name?: string | null;
-    filePath?: string | null;
-    rawYaml?: string | null;
-    resolvedDefinition?: unknown;
-    loadStatus?: 'queued' | 'loaded' | 'parse-error' | 'setup-error' | 'runtime-error' | 'missing' | 'validation-error' | 'skipped';
-    error?: RunArtifactTerminalError;
-}
-interface RunArtifactSuiteMemberSnapshot {
-    index: number;
-    ref: {
-        test: string;
-        id?: string;
-    };
-    filePath?: string | null;
-    testId?: string | null;
-    name?: string | null;
-    target?: string | null;
-    rawYaml?: string | null;
-    resolvedDefinition?: unknown | null;
-    loadStatus: 'loaded' | 'missing' | 'parse-error' | 'validation-error' | 'skipped';
-    error?: RunArtifactTerminalError;
-    childRunId?: string;
-    skipReason?: string;
-}
-interface RunArtifactSuiteSourceSnapshot {
-    kind: 'suite';
-    suiteId?: string | null;
-    name?: string | null;
-    filePath?: string | null;
-    rawYaml?: string | null;
-    resolvedDefinition?: unknown;
-    loadStatus?: 'queued' | 'loaded' | 'parse-error' | 'setup-error' | 'runtime-error' | 'missing' | 'validation-error' | 'skipped';
-    members?: RunArtifactSuiteMemberSnapshot[];
-    error?: RunArtifactTerminalError;
-}
-interface RunArtifactRuntimeSnapshot extends ArtifactRecord {
-    status?: string;
-    duration?: number;
-    startedAt?: string;
-    endedAt?: string;
-    videoPath?: string | null;
-    failureSummary?: string | null;
-}
-type RunArtifactMemoryDeltaAction = 'add' | 'confirm' | 'deprecate' | 'delete';
-interface RunArtifactMemoryObservationSnapshot {
-    id: string;
-    title: string;
-    content: string;
-    trust: number;
-    created: string;
-    last_confirmed: string;
-    confirmed_count: number;
-    contradicted_count: number;
-    source_test: string;
-    position?: number;
-    suite_snapshot?: Array<{
-        test: string;
-        id: string;
-    }>;
-}
-interface RunArtifactMemoryDelta {
-    action: RunArtifactMemoryDeltaAction;
-    tier: 'products' | 'suites' | 'tests';
-    scope: string;
-    observationId: string;
-    reasoning: string;
-    before: RunArtifactMemoryObservationSnapshot | null;
-    after: RunArtifactMemoryObservationSnapshot | null;
-    error?: string;
-}
-interface RunArtifactMemorySnapshot {
-    log?: {
-        added: number;
-        confirmed: number;
-        deprecated: number;
-        deleted?: number;
-        deltas?: RunArtifactMemoryDelta[];
-        errors: string[];
-        curatorDuration: number;
-        tokenUsage?: {
-            promptTokens: number;
-            completionTokens: number;
-            totalTokens: number;
-        };
-    };
-    aggregate?: ArtifactRecord;
-}
-interface RunArtifactPayload {
-    schemaVersion: typeof RUN_ARTIFACT_SCHEMA_VERSION;
-    config?: RunArtifactConfigSnapshot | ArtifactRecord;
-    source?: RunArtifactTestSourceSnapshot | RunArtifactSuiteSourceSnapshot | ArtifactRecord;
-    runtime?: RunArtifactRuntimeSnapshot;
-    memory?: RunArtifactMemorySnapshot | ArtifactRecord;
-    errors?: RunArtifactTerminalError[];
-    metadata?: RunArtifactMetadata;
-}
-interface RunArtifactStageInput extends Partial<Omit<RunArtifactPayload, 'schemaVersion'>> {
-    schemaVersion?: typeof RUN_ARTIFACT_SCHEMA_VERSION;
-}
-interface RunArtifactFinalizeInput extends RunArtifactStageInput {
-    finalizedAt?: string;
-}
-interface RunArtifactReporterContext {
-    runId?: string;
-    parentRunId?: string | null;
-    artifact?: RunArtifactStageInput & {
-        kind?: RunArtifactKind;
-        suiteIndex?: number;
-        parentRunId?: string | null;
-    };
-}
-
-interface RunSummary {
-    results: TestResult[];
-    duration: number;
-    passed: number;
-    failed: number;
-    skipped: number;
-}
-interface SuiteSummary {
-    runId?: string;
-    name: string;
-    status: 'passed' | 'failed' | 'cancelled';
-    tests: TestResult[];
-    duration: number;
-    passed: number;
-    failed: number;
-    skipped: number;
-}
-interface HookEvent {
-    hookId?: string;
-    hookName: string;
-    phase: 'setup' | 'teardown' | 'inline';
-    hookExecutionId: string;
-    runId?: string;
-    stepId?: string;
-}
-interface StepEventContext {
-    runId?: string;
-    parentRunId?: string | null;
-    suiteIndex?: number;
-    suiteTotal?: number;
-    testIndex?: number;
-    stepIndex?: number;
-    stepId?: string;
-}
-interface HookResultEvent extends HookEvent {
-    status: 'passed' | 'failed';
-    duration: number;
-    stdout: string;
-    stderr: string;
-    variables: Record<string, string>;
-    error?: string;
-    type?: 'hook' | 'appium-script' | 'runjs';
-}
-interface Reporter {
-    onSuiteStart?(suite: SuiteDefinition, context?: RunArtifactReporterContext): void | Promise<void>;
-    onSuiteEnd?(summary: SuiteSummary): void | Promise<void>;
-    onRunStart?(tests: TestDefinition[]): void | Promise<void>;
-    onTestStart?(test: TestDefinition, filePath: string, context?: RunArtifactReporterContext): void | Promise<void>;
-    onStepStart?(step: string, testName: string, context?: StepEventContext): void | Promise<void>;
-    onStepEnd?(result: StepResult, testName: string, context?: StepEventContext): void | Promise<void>;
-    onTestEnd?(result: TestResult): void | Promise<void>;
-    onRunEnd?(summary: RunSummary): void | Promise<void>;
-    onStepPhase?(phase: StepPhaseEvent, stepName: string, testName: string, context?: StepEventContext): void | Promise<void>;
-    onHookStart?(event: HookEvent): void | Promise<void>;
-    onHookEnd?(event: HookResultEvent): void | Promise<void>;
-}
-type ReporterEvent = {
-    type: 'suite-start';
-    suite: SuiteDefinition;
-    context?: RunArtifactReporterContext;
-} | {
-    type: 'suite-end';
-    summary: SuiteSummary;
-} | {
-    type: 'run-start';
-    tests: TestDefinition[];
-} | {
-    type: 'test-start';
-    test: TestDefinition;
-    filePath: string;
-    context?: RunArtifactReporterContext;
-} | {
-    type: 'step-start';
-    step: string;
-    testName: string;
-    context?: StepEventContext;
-} | {
-    type: 'step-end';
-    result: StepResult;
-    testName: string;
-    context?: StepEventContext;
-} | {
-    type: 'test-end';
-    result: TestResult;
-} | {
-    type: 'run-end';
-    summary: RunSummary;
-} | {
-    type: 'step-phase';
-    phase: StepPhaseEvent;
-    stepName: string;
-    testName: string;
-    context?: StepEventContext;
-} | {
-    type: 'hook-start';
-    event: HookEvent;
-} | {
-    type: 'hook-end';
-    event: HookResultEvent;
-};
-declare class FatalReporterError extends Error {
-    readonly fatal = true;
-    constructor(message: string, options?: ErrorOptions);
-}
-declare class MultiReporter implements Reporter {
-    private reporters;
-    constructor(reporters: Reporter[]);
-    private handleReporterError;
-    onSuiteStart(suite: SuiteDefinition, context?: RunArtifactReporterContext): Promise<void>;
-    onSuiteEnd(summary: SuiteSummary): Promise<void>;
-    onRunStart(tests: TestDefinition[]): Promise<void>;
-    onTestStart(test: TestDefinition, filePath: string, context?: RunArtifactReporterContext): Promise<void>;
-    onStepStart(step: string, testName: string, context?: StepEventContext): Promise<void>;
-    onStepEnd(result: StepResult, testName: string, context?: StepEventContext): Promise<void>;
-    onTestEnd(result: TestResult): Promise<void>;
-    onRunEnd(summary: RunSummary): Promise<void>;
-    onStepPhase(phase: StepPhaseEvent, stepName: string, testName: string, context?: StepEventContext): Promise<void>;
-    onHookStart(event: HookEvent): Promise<void>;
-    onHookEnd(event: HookResultEvent): Promise<void>;
-}
-
-type HookRuntime = 'node' | 'bun' | 'python' | 'bash';
-interface HookDefinition {
-    id: string;
-    name: string;
-    runtime: HookRuntime;
-    file: string;
-    deps: string[];
-    packageFile?: string;
-    timeout: number;
-    network: boolean;
-}
-interface HookResult {
-    success: boolean;
-    variables: Record<string, string>;
-    output: string;
-    stdout: string;
-    stderr: string;
-    duration: number;
-    error?: string;
-}
-declare const RUNTIME_IMAGE_MAP: Record<HookRuntime, string>;
-
-interface SandboxRunnerOptions {
-    dockerBin?: string;
-    pullPolicy?: 'always' | 'if-not-present' | 'never';
-    envVars?: Record<string, string>;
-    secretStore?: SecretStore;
-    secretRedactor?: SecretRedactor;
-    authState?: RuntimeAuthStateConfig;
-}
-declare function checkDockerAvailable(dockerBin?: string): Promise<boolean>;
-declare function runHookInSandbox(hook: HookDefinition, options?: SandboxRunnerOptions): Promise<HookResult>;
-
-interface AccessibilityCheckOptions {
-    standard?: 'wcag2a' | 'wcag2aa' | 'wcag2aaa';
-    disableRules?: string[];
-    exclude?: string[];
-}
-type AccessibilityCheck = (page: unknown, options: AccessibilityCheckOptions) => Promise<AccessibilityViolation[]>;
-interface RunTestConfig {
-    runId?: string;
-    parentRunId?: string | null;
-    adapter: PlatformAdapter;
-    planner: Planner;
-    verifier?: Verifier;
-    cache?: ActionCache;
-    healingConfig: HealingConfig;
-    plannerModel: LanguageModel;
-    verifierModel: LanguageModel;
-    reporters?: Reporter[];
-    captureScreenshots?: boolean;
-    screenshotMode?: 'failure' | 'every-step';
-    timeouts?: {
-        step?: number;
-        test?: number;
-        navigation?: number;
-    };
-    recording?: {
-        enabled: boolean;
-        videoDir: string;
-        videoSize?: {
-            width: number;
-            height: number;
-        };
-    };
-    accessibility?: {
-        enabled: boolean;
-        standard?: 'wcag2a' | 'wcag2aa' | 'wcag2aaa';
-        runAfter?: 'every-step' | 'navigation' | 'test-end';
-        failOnViolation?: boolean;
-        disableRules?: string[];
-        exclude?: string[];
-    };
-    accessibilityCheck?: AccessibilityCheck;
-    plannerConfig?: PlannerConfig;
-    logger?: LogManager;
-    configContent?: string;
-    testFileContent?: string;
-    envFileVars?: Record<string, string>;
-    inlineVars?: Record<string, string>;
-    suiteVars?: Record<string, string>;
-    cliVars?: Record<string, string>;
-    hookSetupVars?: Record<string, string>;
-    inlineHookDefs?: Map<string, HookDefinition>;
-    inlineHookSandboxOptions?: SandboxRunnerOptions;
-    suiteFileContent?: string;
-    suiteTestIndex?: number;
-    suiteContext?: string;
-    logCapture?: {
-        console?: boolean;
-        network?: boolean;
-    };
-    screenshotSize?: number;
-    effectiveResolution?: number;
-    contextWindow?: number;
-    memoryProvider?: MemoryProvider;
-    memoryInitParams?: MemoryIndexParams;
-    circuitBreaker?: CircuitBreaker;
-    skipReporterOnTestStart?: boolean;
-    skipReporterOnTestEnd?: boolean;
-    secretStore?: SecretStore;
-    secretRedactor?: SecretRedactor;
-    secretsFileMetadata?: {
-        path: string | null;
-        status: string;
-        count?: number;
-    } | null;
-}
-declare function runTest(test: TestDefinition, config: RunTestConfig, filePath: string, failureContext?: string): Promise<TestResult>;
-declare function runTestWithRetry(test: TestDefinition, config: RunTestConfig, filePath: string): Promise<TestResult>;
-
-interface InlineHookCall {
-    hookId: string;
-    fullMatch: string;
-}
-declare function parseHookInline(text: string): InlineHookCall[];
-declare function stripHookInline(text: string): string;
-
-declare function generateFailureSummary(steps: StepResult[]): string;
-
-declare const ExtractionResultSchema: z.ZodObject<{
-    value: z.ZodString;
-    reasoning: z.ZodString;
-}, z.core.$strip>;
-type VariableSource = 'env' | 'inline' | 'suite' | 'cli' | 'capture' | 'hook' | 'step';
-declare class VariableStore {
-    private storage;
-    set(name: string, value: string, source?: VariableSource): void;
-    get(name: string): string | undefined;
-    has(name: string): boolean;
-    getSource(name: string): VariableSource | undefined;
-    getAll(): Map<string, string>;
-    setAll(vars: Record<string, string>, source?: VariableSource): void;
-    snapshot(): Record<string, {
-        value: string;
-        source: VariableSource;
-    }>;
-}
-declare function parseEnvFile(content: string): Record<string, string>;
-declare function serializeEnvFile(vars: Record<string, string>): string;
-declare function interpolateVariables(template: string, store: VariableStore): string;
-interface UnresolvedTemplate {
-    pattern: string;
-    message: string;
-}
-declare function findUnresolvedTemplates(text: string): UnresolvedTemplate[];
-declare function findBareVariables(text: string): string[];
-declare class ExplicitExtractor implements VariableExtractor {
-    extract(input: ExtractorInput, screenState: ScreenState): Promise<CaptureResult>;
-    private extractByRegex;
-    private extractBySelector;
-}
-declare class LLMVariableExtractor implements VariableExtractor {
-    private model;
-    constructor(model: LanguageModel);
-    extract(input: ExtractorInput, screenState: ScreenState): Promise<CaptureResult>;
-}
-declare function createExtractor(model?: LanguageModel, method?: string): VariableExtractor;
-
-declare class FileActionCache implements ActionCache {
-    private dir;
-    private ttlMs;
-    private logger?;
-    constructor(config: {
-        dir: string;
-        ttl: number | string;
-        logger?: ScopedLogger;
-    });
-    get(stepHash: string, screenHash: string): Promise<ActionPlan | null>;
-    set(stepHash: string, screenHash: string, plan: ActionPlan, metadata?: {
-        model: string;
-        provider: string;
-        stepInstruction: string;
-    }): Promise<void>;
-    invalidate(stepHash: string, screenHash: string): Promise<void>;
-    getSubAction(stepHash: string, index: number): Promise<ActionPlan | null>;
-    setSubAction(stepHash: string, index: number, plan: ActionPlan): Promise<void>;
-    invalidateSubActionsFrom(stepHash: string, fromIndex: number): Promise<void>;
-    private buildPath;
-}
-declare function parseTTL(ttl: string): number;
-
-declare class NullActionCache implements ActionCache {
-    get(_stepHash: string, _screenHash: string): Promise<ActionPlan | null>;
-    set(_stepHash: string, _screenHash: string, _plan: ActionPlan): Promise<void>;
-    invalidate(_stepHash: string, _screenHash: string): Promise<void>;
-    getSubAction(_stepHash: string, _index: number): Promise<ActionPlan | null>;
-    setSubAction(_stepHash: string, _index: number, _plan: ActionPlan): Promise<void>;
-    invalidateSubActionsFrom(_stepHash: string, _fromIndex: number): Promise<void>;
-}
-
-declare const CACHE_SCHEMA_VERSION = 9;
-interface CacheEntry {
-    schemaVersion?: number;
-    stepInstruction: string;
-    stepHash: string;
-    screenHash: string;
-    plan: ActionPlan;
-    createdAt: string;
-    model: string;
-    provider: string;
-}
-
-interface ConsoleReporterOptions {
-    verbose?: boolean;
-    colorize?: boolean;
-    logLevel?: string;
-    plain?: boolean;
-}
-declare class ConsoleReporter implements Reporter {
-    private verbose;
-    private colorize;
-    private plain;
-    private inSuite;
-    private hookPhaseStarted;
-    private lastHookPhase;
-    private canOverwrite;
-    private stepsPassed;
-    private stepsFailed;
-    private stepsSkipped;
-    private cacheHits;
-    private cacheMisses;
-    private lastWriteLen;
-    constructor(options?: ConsoleReporterOptions);
-    private c;
-    private stripAnsi;
-    private clearWrappedLines;
-    private writeLine;
-    private printLine;
-    private testBadge;
-    private resetCounters;
-    private formatStepsLine;
-    private formatCacheLine;
-    onSuiteStart(suite: SuiteDefinition): void;
-    onRunStart(tests: TestDefinition[]): void;
-    onTestStart(test: TestDefinition, filePath: string): void;
-    onStepStart(step: string, _testName: string): void;
-    onStepEnd(result: StepResult, _testName: string): void;
-    onHookStart(event: HookEvent): void;
-    onHookEnd(event: HookResultEvent): void;
-    onTestEnd(result: TestResult): void;
-    onRunEnd(summary: RunSummary): void;
-    onSuiteEnd(summary: SuiteSummary): void;
-    private printStandaloneSummary;
-    private printFailedTests;
-    private statusIcon;
-}
-
-interface JUnitReporterOptions {
-    outputPath: string;
-}
-declare class JUnitReporter implements Reporter {
-    private outputPath;
-    private results;
-    private inSuiteRun;
-    constructor(options: JUnitReporterOptions);
-    onSuiteStart(_suite: SuiteDefinition): void;
-    onTestEnd(result: TestResult): void;
-    onRunEnd(summary: RunSummary): Promise<void>;
-    onSuiteEnd(summary: SuiteSummary): Promise<void>;
-    private writeXml;
-    private buildXml;
-    private buildSuiteXml;
-    private buildTestCase;
-    private getFailureMessage;
-    private buildFailureDetails;
-    private buildStepSummary;
-}
-
-declare function captureFailureScreenshot(adapter: PlatformAdapter): Promise<Buffer | undefined>;
-
-interface StdoutLiveReporterOptions {
-    active?: boolean;
-    redactor?: SecretRedactor;
-}
-declare class StdoutLiveReporter implements Reporter {
-    private active;
-    private heartbeatInterval;
-    private activeRunId;
-    private activeParentRunId;
-    private activeSuiteIndex;
-    private activeSuiteTotal;
-    private redactor?;
-    constructor(options?: StdoutLiveReporterOptions);
-    private emit;
-    private withRunId;
-    private withRunContext;
-    onTestStart(test: TestDefinition, filePath: string, context?: RunArtifactReporterContext): void;
-    onStepStart(step: string, testName: string, context?: StepEventContext): void;
-    onStepEnd(result: StepResult, testName: string, context?: StepEventContext): void;
-    onStepPhase(phase: StepPhaseEvent, stepName: string, testName: string, context?: StepEventContext): void;
-    onHookStart(event: HookEvent): void;
-    onHookEnd(event: HookResultEvent): void;
-    onTestEnd(result: TestResult): void;
-}
-
 interface MobileNode {
     index: number;
     type: string;
@@ -2517,10 +1102,16 @@ interface MobileNode {
     enabled?: boolean;
     children: MobileNode[];
 }
-type MobileRefMap = Record<string, {
+/**
+ * Execute-time resolution record for a single builder-minted ref. Reconstructed by
+ * `buildRefEntries` from the interim nodes + the builder's ref->node binding, this is
+ * how the mobile adapters keep the v1 `lastRefs` locator pattern alive after the
+ * shared builder took over ref minting (D-01/D-03). Every field here is one that
+ * `element-resolver.ts`/`gestures.ts` actually read at execute time.
+ */
+interface RefEntry {
     role: string;
     name?: string;
-    nth?: number;
     bounds?: {
         x: number;
         y: number;
@@ -2529,20 +1120,50 @@ type MobileRefMap = Record<string, {
     };
     nativeType?: string;
     value?: string;
-}>;
-interface ParsedMobileTree {
-    tree: string;
-    elements: ElementInfo[];
-    refs: MobileRefMap;
+    editable?: boolean;
+    /** Android's raw `input-type` bitmask from the observed node (437 D-15). */
+    inputType?: number;
+}
+/** Execute-time ref -> resolution record map (adapter-private `lastRefs`). */
+type MobileRefMap = Record<string, RefEntry>;
+/** parseMobileSource result — a plain interim-node list; ref minting, tree rendering,
+ * and the viewport-summary header all moved into the shared builder (Plan 352-01). */
+interface ParsedMobileSource {
+    nodes: InterimNode[];
 }
 
 declare function parseMobileSource(xml: string, platform: 'android' | 'ios', viewport?: {
     width: number;
     height: number;
-}): ParsedMobileTree;
+}): ParsedMobileSource;
+/**
+ * Reconstruct the execute-time `lastRefs` record from the interim nodes plus the shared
+ * builder's ref->node binding (D-01/D-03). The mobile adapters store this privately so
+ * planner-ref -> live-node resolution survives the builder taking over ref minting. No
+ * position lives anywhere: not here, not on the binding, not on ElementInfo (438 D-13).
+ */
+declare function buildRefEntries(nodes: InterimNode[], binding: Record<string, RefBinding>): Record<string, RefEntry>;
+/**
+ * Best-effort mobile scroll metadata (D-10). Unlike web — which reads the exact window
+ * scroll offset and document content size — mobile page source exposes no true scroll
+ * position, so this is a documented approximation, explicit and never silently precise:
+ * contentWidth/contentHeight are the maximum element extent across all node bounds
+ * (falling back to the viewport dimensions when no node carries bounds), and
+ * offsetX/offsetY stay 0 (no reliable scroll-offset signal in the source).
+ */
+declare function deriveMobileScroll(nodes: InterimNode[], viewport: {
+    width: number;
+    height: number;
+}): {
+    offsetX: number;
+    offsetY: number;
+    contentWidth: number;
+    contentHeight: number;
+};
 
 declare const ANDROID_ROLE_MAP: Record<string, string>;
 declare const IOS_ROLE_MAP: Record<string, string>;
+declare const IOS_EDITABLE_TYPES: ReadonlySet<string>;
 declare function normalizeRole(type: string, platform: 'android' | 'ios'): string;
 
 declare class MobileElementResolver {
@@ -2699,12 +1320,33 @@ declare function localAppiumBinaryNames(platform?: NodeJS.Platform): string[];
 declare function resolveAppiumExecutable(opts?: ResolveAppiumExecutableOptions): ResolvedAppiumExecutable;
 declare function formatAppiumInstallGuidance(): string;
 
-declare const AUTH_STATE_SCHEMA_VERSION = 1;
+/** One WebView scroller with a structural identity: `document`, or a flat-tree path plus tag, id and class. */
+interface IdentifiedScrollOffsets extends DocumentScrollOffsets {
+    id: string;
+}
+/**
+ * A WebDriver `execute` function body. It answers `null` when a frame (`iframe`, `frame`, `embed`,
+ * `object`, `fencedframe`) with positive area intersects the viewport, because a swipe over it
+ * moves content the page cannot measure. Otherwise it answers the document scroller first (id
+ * `document`), then every on-screen element scroller in the document and its open shadow roots,
+ * in tree order. A body whose overflow propagates to the viewport is not a member. Nothing is
+ * written to the page: ids derive from structure alone. Closed shadow roots are unreachable.
+ */
+declare const WEBVIEW_SCROLLERS_SCRIPT: string;
+/** A non-empty array of members with string ids, finite offsets and no duplicate id; else undefined. */
+declare function parseWebViewScrollers(raw: unknown): IdentifiedScrollOffsets[] | undefined;
+/**
+ * Before and after are paired by id. The same membership is judged by the scroller-set rule; a
+ * changed membership is `moved` only when a member present in both reads moved, else `unknown`.
+ */
+declare function webViewSwipeSignal(direction: Direction, before: readonly IdentifiedScrollOffsets[] | undefined, after: readonly IdentifiedScrollOffsets[] | undefined): SwipeSignal;
+
+declare const AUTH_STATE_SCHEMA_VERSION = 2;
 declare const AUTH_STATE_SLUG_PATTERN: RegExp;
 declare const AuthStateNameSchema: z.ZodString;
 declare const TargetNameSchema: z.ZodString;
 declare const AuthStateMetadataSchema: z.ZodObject<{
-    version: z.ZodLiteral<1>;
+    version: z.ZodLiteral<2>;
     kind: z.ZodLiteral<"web">;
     target: z.ZodString;
     name: z.ZodString;
@@ -2788,27 +1430,6 @@ interface ResolvedAuthStateForRun {
 }
 declare function resolveAuthStateForRun(input: ResolveAuthStateForRunInput): Promise<ResolvedAuthStateForRun>;
 
-declare const AUTH_STATE_HOOK_JSON_ENV = "AGENT_QA_AUTH_STATE_JSON";
-declare const AUTH_STATE_HOOK_STORAGE_STATE_PATH_ENV = "AGENT_QA_AUTH_STATE_STORAGE_STATE_PATH";
-declare const AUTH_STATE_HOOK_WORKSPACE_DIR = ".agent-qa-auth-state";
-declare const AUTH_STATE_HOOK_STORAGE_STATE_FILENAME = "storage-state.json";
-declare const AUTH_STATE_HOOK_CONTAINER_STORAGE_STATE_PATH = "/workspace/.agent-qa-auth-state/storage-state.json";
-declare function isReservedAuthStateHookEnvKey(key: string): boolean;
-declare function stripReservedAuthStateHookEnv(variables: Record<string, string>): Record<string, string>;
-declare function buildAuthStateHookEnv(authState: RuntimeAuthStateConfig | undefined, storageStatePath?: string): Record<string, string>;
-
-declare const AUTH_STATE_REDACTION_MARKER = "[auth state redacted]";
-interface AuthStateRedactionContext {
-    secretRedactor?: SecretRedactor;
-    authState?: RuntimeAuthStateConfig;
-    storageStatePath?: string;
-    hookStorageStatePath?: string;
-    hookJsonEnv?: string;
-    redactAuthLikeKeys?: boolean;
-}
-declare function redactAuthStateString(value: string, context?: AuthStateRedactionContext): string;
-declare function redactAuthStateValue<T>(value: T, context?: AuthStateRedactionContext): T;
-
 type AuthProvider = string;
 type LLMModelAdapter = 'openai-responses' | 'anthropic-messages';
 type BuiltInLLMProviderMode = 'openai-compatible' | 'anthropic-compatible' | 'openai-subscription' | 'anthropic-subscription' | 'gemini';
@@ -2877,6 +1498,7 @@ interface LLMAuthConfig {
     baseURL?: string;
     providerHeaders?: Record<string, string>;
 }
+declare const PUBLIC_PROVIDER_API_HOSTS: readonly string[];
 declare function resolveLLMAuth(configName: string, llmConfig: LLMAuthConfig, authPath?: string): Promise<ResolvedLLMAuth>;
 
 type DashboardAuthMode = 'browser-poll' | 'manual-code';
@@ -2950,6 +1572,195 @@ interface CreateAuthFetchOptions {
 }
 declare function createAuthFetch(options: CreateAuthFetchOptions): typeof globalThis.fetch;
 
+type ProviderPluginDeclaration = {
+    package: string;
+    path?: never;
+} | {
+    path: string;
+    package?: never;
+};
+interface ProviderPluginDescriptor {
+    id: string;
+    label: string;
+    adapter: (transport: unknown, modelId: string) => unknown;
+    authModes: string[];
+    needsBaseURL?: boolean;
+    subscription?: boolean;
+    credentialOptional?: boolean;
+    modelAdapter?: string;
+    baseURLPlaceholder?: string;
+    defaultModel?: string;
+}
+interface LoadProviderPluginsOptions {
+    baseDir?: string;
+}
+declare function loadProviderPlugins(declarations: ProviderPluginDeclaration[] | undefined, options?: LoadProviderPluginsOptions): Promise<ProviderPluginDescriptor[]>;
+declare function clearLoadedProviderPluginModules(): void;
+
+type LogLevel = 'silent' | 'error' | 'warn' | 'info' | 'debug';
+declare const LOG_LEVEL_PRIORITY: Record<LogLevel, number>;
+type LogSource = 'agent' | 'adapter' | 'cache' | 'planner' | 'hook' | 'runner';
+interface LogEntry {
+    id: string;
+    stepId: string | null;
+    runId: string;
+    level: Exclude<LogLevel, 'silent'>;
+    source: LogSource;
+    message: string;
+    data: Record<string, unknown>;
+    timestamp: string;
+}
+interface LogStorage {
+    insertLogs(entries: LogEntry[]): void;
+    getLogs(opts: {
+        runId?: string;
+        stepId?: string;
+        level?: string;
+        source?: string;
+        limit?: number;
+        offset?: number;
+    }): LogEntry[];
+}
+interface ScopedLogger {
+    debug(msg: string, data?: Record<string, unknown>): void;
+    info(msg: string, data?: Record<string, unknown>): void;
+    warn(msg: string, data?: Record<string, unknown>): void;
+    error(msg: string, data?: Record<string, unknown>): void;
+}
+declare const AgentLogDataSchema: z.ZodObject<{
+    extractDom: z.ZodOptional<z.ZodBoolean>;
+    hasScreenshot: z.ZodOptional<z.ZodBoolean>;
+    duration: z.ZodOptional<z.ZodNumber>;
+    elementCount: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+declare const AdapterLogDataSchema: z.ZodObject<{
+    actionType: z.ZodOptional<z.ZodString>;
+    selector: z.ZodOptional<z.ZodString>;
+    coordinates: z.ZodOptional<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>>;
+    elementProperties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    duration: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+declare const CacheLogDataSchema: z.ZodObject<{
+    operation: z.ZodEnum<{
+        set: "set";
+        get: "get";
+        invalidate: "invalidate";
+        bypass: "bypass";
+        "batch-purge": "batch-purge";
+    }>;
+    stepHash: z.ZodOptional<z.ZodString>;
+    screenHash: z.ZodOptional<z.ZodString>;
+    hit: z.ZodOptional<z.ZodBoolean>;
+    age: z.ZodOptional<z.ZodNumber>;
+    entriesDeleted: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+declare const PlannerLogDataSchema: z.ZodObject<{
+    model: z.ZodOptional<z.ZodString>;
+    promptTokens: z.ZodOptional<z.ZodNumber>;
+    completionTokens: z.ZodOptional<z.ZodNumber>;
+    latencyMs: z.ZodOptional<z.ZodNumber>;
+    confidence: z.ZodOptional<z.ZodNumber>;
+    actionType: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const HookLogDataSchema: z.ZodObject<{
+    hookName: z.ZodOptional<z.ZodString>;
+    phase: z.ZodOptional<z.ZodEnum<{
+        setup: "setup";
+        teardown: "teardown";
+    }>>;
+    duration: z.ZodOptional<z.ZodNumber>;
+    success: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+declare const RunnerLogDataSchema: z.ZodObject<{
+    stepIndex: z.ZodOptional<z.ZodNumber>;
+    totalSteps: z.ZodOptional<z.ZodNumber>;
+    testName: z.ZodOptional<z.ZodString>;
+    variablesCaptured: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+declare const LogSourceDataSchemas: Record<LogSource, z.ZodType>;
+
+/**
+ * One member's run-id binding, held in async context rather than on the manager (WINDOWS #233).
+ *
+ * `pending` is that member's own not-yet-attributed entries — the lines it wrote before it minted
+ * its run id. Only these are backfilled by its `setRunId`, so a sibling can never adopt them.
+ */
+interface MemberLogScope {
+    runId: string;
+    readonly pending: LogEntry[];
+}
+/**
+ * The host's async-context primitive, named STRUCTURALLY so this package never imports
+ * `node:async_hooks`.
+ *
+ * `packages/core`'s host baseline is a regenerable DEBT record with a per-area clearance map — a
+ * list that is meant to shrink — so a new host import here would be new debt, not a permission.
+ * The composition root already owns every other reach into the world, so it owns this one too and
+ * injects it. `node:async_hooks`'s `AsyncLocalStorage<MemberLogScope>` satisfies this exactly, with
+ * no adapter.
+ */
+interface AsyncScopeStore<T> {
+    getStore(): T | undefined;
+    run<R>(store: T, fn: () => R): R;
+}
+/** Thrown when a caller asks for member isolation the composition root never wired up. */
+declare class MemberLogScopeUnavailableError extends Error {
+    constructor();
+}
+declare class LogManager {
+    private buffer;
+    private currentStepId;
+    private runId;
+    private runIdSet;
+    private readonly displayLevel;
+    private readonly storage?;
+    private readonly ndjson;
+    private redactor?;
+    private readonly memberScope?;
+    constructor(opts: {
+        runId?: string;
+        displayLevel: LogLevel;
+        storage?: LogStorage;
+        ndjson?: boolean;
+        redactor?: SecretRedactor;
+        memberScope?: AsyncScopeStore<MemberLogScope>;
+    });
+    setRedactor(redactor: SecretRedactor | undefined): void;
+    /**
+     * Run `fn` with its own run-id binding, so concurrent members cannot overwrite each other.
+     *
+     * ONE `LogManager` SERVES EVERY MEMBER of a run — `commands/run.ts` builds it once, outside the
+     * per-member closure — and since 402-02/402-03 the direct path runs members concurrently. Without
+     * a scope, `setRunId` is a single mutable field plus a whole-buffer backfill, so the LAST member
+     * to mint an id claims every line in the buffer, its siblings' included (measured, not inferred).
+     *
+     * Outside a scope nothing changes: `setRunId` keeps its original whole-buffer behaviour, which is
+     * what the sequential path and the run-level `onRunCreated` stamp rely on.
+     */
+    runInMemberScope<T>(fn: () => T): T;
+    log(level: Exclude<LogLevel, 'silent'>, source: LogSource, message: string, data?: Record<string, unknown>): void;
+    private shouldDisplay;
+    /**
+     * The SECOND writer on the `AGENT_QA_EVENT:` stdout channel — the first is the CLI's
+     * `reporters/wire-reporter.ts`, which prints run-event envelopes on the same prefix. Both are
+     * armed by `AGENT_QA_LIVE_EVENTS=true` (this one indirectly: `commands/run.ts` passes
+     * `ndjson: process.env.AGENT_QA_LIVE_EVENTS === 'true'`), both are off by default, and nothing in
+     * the product sets that variable. Entries are already redacted above, and are printed verbatim.
+     * A supported opt-in; the user-facing contract for both writers is the CLI README's
+     * "Live events on stdout (opt-in)". Do not change this line shape without mirroring it there.
+     */
+    private emitNdjson;
+    setCurrentStep(stepId: string): void;
+    clearCurrentStep(): void;
+    setRunId(runId: string): void;
+    flush(): void;
+    getBuffer(): LogEntry[];
+    createScopedLogger(source: LogSource): ScopedLogger;
+}
+
 declare function formatLogEntry(entry: LogEntry): string;
 
 interface FarmProvider {
@@ -3031,106 +1842,41 @@ declare function mapMobileCapabilities(match: Record<string, unknown>, platform:
 
 declare const browserstackProvider: FarmProvider;
 
-interface MemoryLog {
-    added: number;
-    confirmed: number;
-    deprecated: number;
-    deleted: number;
-    deltas: MemoryDelta[];
-    errors: string[];
-    curatorDuration: number;
-    tokenUsage?: {
-        promptTokens: number;
-        completionTokens: number;
-        totalTokens: number;
-    };
-}
-type MemoryDeltaAction = 'add' | 'confirm' | 'deprecate' | 'delete';
-interface MemoryObservationSnapshot {
-    id: string;
-    title: string;
-    content: string;
-    trust: number;
-    created: string;
-    last_confirmed: string;
-    confirmed_count: number;
-    contradicted_count: number;
-    source_test: string;
-    position?: number;
-    suite_snapshot?: Array<{
-        test: string;
-        id: string;
-    }>;
-}
-interface MemoryDelta {
-    action: MemoryDeltaAction;
-    tier: 'products' | 'suites' | 'tests';
-    scope: string;
-    observationId: string;
-    reasoning: string;
-    before: MemoryObservationSnapshot | null;
-    after: MemoryObservationSnapshot | null;
-    error?: string;
-}
-interface CuratorContext {
-    testResult: TestResult;
-    provider: MemoryProvider;
-    model: LanguageModel;
-    providerOptions?: ProviderOptions;
-    memoryRoot: string;
-    product: string;
-    testId: string;
-    suiteId?: string;
-    suiteContext?: {
-        tests: Array<{
-            test: string;
-            id: string;
-        }>;
-        position: number;
-    };
-    injectedObservationIds: Map<number, string[]>;
-    trustConfirmDelta?: number;
-    trustContradictDelta?: number;
-}
-declare const CuratorResponseSchema: z.ZodObject<{
-    decisions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
-        action: z.ZodLiteral<"add">;
-        title: z.ZodString;
-        content: z.ZodString;
-        scope: z.ZodEnum<{
-            test: "test";
-            product: "product";
-            suite: "suite";
-        }>;
-        reasoning: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
-        action: z.ZodLiteral<"update">;
-        observationId: z.ZodString;
-        reasoning: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
-        action: z.ZodLiteral<"deprecate">;
-        observationId: z.ZodString;
-        reasoning: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
-        action: z.ZodLiteral<"noop">;
-        reasoning: z.ZodString;
-    }, z.core.$strip>], "action">>;
-}, z.core.$strip>;
-declare function runCurator(ctx: CuratorContext): Promise<MemoryLog>;
-declare function deprecateOnFailure(ctx: Pick<CuratorContext, 'testResult' | 'provider' | 'memoryRoot' | 'injectedObservationIds' | 'trustContradictDelta'>): Promise<MemoryLog>;
-
+/**
+ * Suite run configuration — a types-only contract consumed by the CLI composition root.
+ * The former `runSuite`/`executeSuiteMember` orchestration moved onto runner soil
+ * (`runMemberTest`) in Phase 363; the CLI now composes per-member execution directly and
+ * this interface only describes the shape it passes through. Field types that used to be
+ * borrowed from the (deleted) `RunTestConfig` are inlined here so the module carries no
+ * value dependency on the retired core run path.
+ */
 interface RunSuiteConfig {
     runId?: string;
     adapter: PlatformAdapter;
     platformConfig: PlatformConfig;
-    planner: Planner;
-    verifier?: Verifier;
-    cache?: ActionCache;
-    healingConfig: HealingConfig;
+    planner: Planner$1;
+    verifier: Verifier$1;
+    cache?: ActionPlanCache;
+    /**
+     * WM-01 run-scoped working-memory store (Phase 358). ONE store spans all suite member tests
+     * (run-scoped, not test-scoped) and is threaded into each test's runner loop; the CLI flushes
+     * it once at suite end.
+     */
+    workingMemory?: WorkingMemoryPort;
+    /**
+     * D-14 storage-state store (Phase 360). ONE run-scoped store spans all suite member tests and is
+     * threaded into each test's runner loop; the CLI constructs it at the composition root.
+     */
+    storageState?: StorageStatePort;
+    /**
+     * D-08/Q10 screenshot compressor (Phase 363). ONE runner-local `SharpScreenshotCompressor`
+     * constructed at the CLI composition root, threaded into each member's runner loop (sharp left
+     * core). Absent ⇒ compressor-less loop.
+     */
+    compressor?: ScreenshotCompressor;
     plannerModel: LanguageModel;
     verifierModel: LanguageModel;
-    providerOptions?: ProviderOptions;
-    reporters?: Reporter[];
+    reporters?: never[];
     captureScreenshots?: boolean;
     screenshotMode?: 'failure' | 'every-step';
     timeouts?: {
@@ -3150,24 +1896,32 @@ interface RunSuiteConfig {
         console?: boolean;
         network?: boolean;
     };
-    accessibility?: RunTestConfig['accessibility'];
-    accessibilityCheck?: RunTestConfig['accessibilityCheck'];
-    screenshotSize?: number;
-    effectiveResolution?: number;
-    memoryProvider?: MemoryProvider;
-    memoryRoot?: string;
-    memoryConfig?: {
-        enabled?: boolean;
-        curatorEnabled?: boolean;
-        ablationEnabled?: boolean;
-        trustConfirmDelta?: number;
-        trustContradictDelta?: number;
+    accessibility?: {
+        enabled: boolean;
+        standard?: 'wcag2a' | 'wcag2aa' | 'wcag2aaa';
+        runAfter?: 'every-step' | 'navigation' | 'test-end';
+        failOnViolation?: boolean;
+        disableRules?: string[];
+        exclude?: string[];
+    };
+    accessibilityCheck?: (page: unknown, options: {
+        standard?: 'wcag2a' | 'wcag2aa' | 'wcag2aaa';
+        disableRules?: string[];
+        exclude?: string[];
+    }) => Promise<AccessibilityViolation[]>;
+    vision?: {
+        screenshotSize?: number;
+        effectiveResolution?: number;
+    };
+    /** Vision gate resolved once per run at the composition root (D-11); passed through to each test. */
+    visionGate?: {
+        attachImage: boolean;
+        captureMode: 'full' | 'textOnly';
+        promptNote: string;
     };
-    circuitBreaker?: CircuitBreaker;
     product?: string;
     createAdapter?: () => Promise<PlatformAdapter>;
     resolveUrl?: (targetName: string) => string | undefined;
-    onCuratorComplete?: (testName: string, memoryLog: MemoryLog) => void;
     artifactContext?: Record<string, unknown>;
     authStateCapture?: {
         capture: () => Promise<RuntimeAuthStateConfig>;
@@ -3176,7 +1930,14 @@ interface RunSuiteConfig {
     secretStore?: SecretStore;
     secretRedactor?: SecretRedactor;
 }
-declare function runSuite(suite: SuiteDefinition, testEntries: [TestDefinition, string][], config: RunSuiteConfig): Promise<SuiteResult>;
+
+/**
+ * Merge the suite's target/use into a member test and strip its own `url` (the suite owns
+ * startup navigation). The per-member execution body (formerly `executeSuiteMember`) moved onto
+ * runner soil (`runMemberTest`) in Phase 363; the CLI composition root patches each member with
+ * this helper before running it.
+ */
+declare function patchTestForSuite(test: TestDefinition, suite: SuiteDefinition, _index: number): TestDefinition;
 
 type WorkspaceFileKind = 'test' | 'suite';
 interface ResolvedWorkspaceFile {
@@ -3196,7 +1957,6 @@ interface ResolvedWorkspacePaths {
     suiteMatch: string[];
     testPathIgnore: string[];
     hooksFile: ResolvedWorkspaceFile;
-    agentRules: ResolvedWorkspaceFile;
     envFile: ResolvedWorkspaceFile;
     secretsFile: ResolvedWorkspaceFile;
 }
@@ -3205,6 +1965,26 @@ interface ResolveWorkspacePathsInput {
     configPath: string;
     requireExistingFiles?: boolean;
 }
+/**
+ * The ONE spelling of the durable workspace-relative IDENTITY recipe (390-08 / CR-02, D-01).
+ *
+ * `configDir`-rooted, forward-slashed, `./`-trimmed, and escape-refusing — literally
+ * {@link assertInsideWorkspace} with {@link resolveWorkspaceFileTarget}'s resolution step in front,
+ * exported rather than re-derived so no second spelling of the rule can drift from this one.
+ *
+ * WHY IT EXISTS: the committed `quarantine.jsonl` keys entries on this string and compares it with
+ * `===`. An absolute path is bytes only the machine that wrote them can produce, so a ledger
+ * carrying absolute identities could never match on a fresh CI checkout — it would be committed for
+ * an inheritance it structurally cannot deliver. These bytes are IDENTITY ONLY and are never used
+ * for file access; readers keep the absolute path they already resolved.
+ *
+ * Accepting an already-relative input (resolved against `configDir`, as
+ * {@link resolveWorkspaceFileTarget} does) makes the mint idempotent: handing an identity through a
+ * second layer cannot silently re-anchor it on `process.cwd()`.
+ *
+ * @throws when the path resolves outside `configDir` — an escaping file cannot mint an identity.
+ */
+declare function workspaceRelativeIdentityPath(configDir: string, filePath: string): string;
 declare function resolveWorkspacePaths(input: ResolveWorkspacePathsInput): ResolvedWorkspacePaths;
 declare function discoverWorkspaceFiles(input: {
     workspace: ResolvedWorkspacePaths;
@@ -3254,6 +2034,34 @@ declare function validateProject(options?: {
     workspace?: ResolvedWorkspacePaths;
 }): Promise<ValidationResult>;
 
+/**
+ * A yaml parse failure as a POSITION, and as nothing else (395-10 · GAP 1 / CR-01 · 395-14 · F-01).
+ *
+ * THE ERROR IS NOT A MESSAGE SOURCE HERE. `yaml`'s `YAMLParseError` carries `linePos` — where the
+ * parser gave up — beside a `message` that is pretty-printed with a verbatim excerpt of the
+ * offending source line and a caret beneath the column. Every other property (`message`, `code`,
+ * the object's own stringification) is derived from the person's file content and is therefore not
+ * this product's to publish: the strings built from this one are persisted in blocked records,
+ * printed by `proposals show`, thrown out of every config op, printed by `agent-qa validate`, and —
+ * through `refusalMessage` — carried into a chat turn's answer and its session jsonl. So this
+ * function reads two NUMBERS and composes a sentence of its own.
+ *
+ * THE FALLBACK IS VALUE-FREE TOO, and that is the point of having one. A throw with no `linePos` is
+ * not a yaml parse error this product recognises, and the tempting repair — fall back to the error's
+ * message when the position is missing — would reopen the whole channel for exactly the inputs
+ * nobody anticipated.
+ *
+ * IT LIVES IN CORE AND HAS THREE CALLERS (395-14). It was a private copy in the cli composition
+ * root; the loader guard and core's own `validateConfig` arm need the SAME sentence, and two
+ * spellings of one sentence are two things that can drift apart. One primitive, three callers:
+ * `cli/src/config.ts`, `core/src/validation/validate.ts`, and the cli validate port.
+ *
+ * THE ARGUMENT IS GUARDED BEFORE IT IS READ (395-14 · WR-08 / F-09). A `throw null` or a
+ * `throw 'boom'` is a legal throw; the 395-10 copy reached for `.linePos` unguarded and answered a
+ * TypeError for `null` — a crash inside the code whose whole job is to turn a fault into a sentence.
+ */
+declare function yamlParseFailureMessage(error: unknown): string;
+
 declare function formatDiagnostics(result: ValidationResult): string;
 declare function formatDiagnosticsPlain(result: ValidationResult): string;
 
@@ -3270,364 +2078,42 @@ declare function parseHooksFile(filePath: string): Promise<{
     errors: string[];
 }>;
 
-declare const DEFAULT_CLEANUP_TARGETS: readonly [".agent-qa"];
-type CleanupTarget = (typeof DEFAULT_CLEANUP_TARGETS)[number];
-interface HookReferenceRewriteFile {
-    path: string;
-    content: string;
-}
-interface HookReferenceMigrationSuccess {
-    ok: true;
-    hookNameToId: Record<string, string>;
-    rewriteFiles: HookReferenceRewriteFile[];
-    cleanupTargets: CleanupTarget[];
-}
-interface HookReferenceMigrationFailure {
-    ok: false;
-    errors: string[];
-    rewriteFiles: [];
-    cleanupTargets: [];
-}
-type HookReferenceMigrationAudit = HookReferenceMigrationSuccess | HookReferenceMigrationFailure;
-interface HookReferenceMigrationOptions {
-    workspaceDir: string;
-    configPath?: string;
-    generateId?: () => string;
-}
-declare class HookReferenceMigrationError extends Error {
-    readonly errors: string[];
-    constructor(errors: string[]);
-}
-declare function auditWorkspaceHookReferenceMigration(options: HookReferenceMigrationOptions): Promise<HookReferenceMigrationAudit>;
-declare function applyWorkspaceHookReferenceMigration(options: HookReferenceMigrationOptions): Promise<HookReferenceMigrationSuccess>;
-
-interface HookOrchestrationResult {
-    results: Map<string, HookResult>;
-    variables: Record<string, string>;
-    allPassed: boolean;
-    duration: number;
-}
-declare function runHooks(hooks: HookDefinition[], options?: SandboxRunnerOptions): Promise<HookOrchestrationResult>;
-
-interface ObservationFrontmatter {
-    id: string;
-    title: string;
-    trust: number;
-    created: string;
-    last_confirmed: string;
-    confirmed_count: number;
-    contradicted_count: number;
-    source_test: string;
-}
-interface SuiteObservationFrontmatter extends ObservationFrontmatter {
-    position: number;
-    suite_snapshot: Array<{
-        test: string;
-        id: string;
-    }>;
-}
-
-declare function ensureMemoryDirs(root: string): Promise<void>;
-declare function writeObservation(root: string, tier: 'products' | 'suites' | 'tests', scope: string, data: BaseObservation | SuiteObservation): Promise<string>;
-declare function parseObservation(content: string, filename: string): {
-    data: BaseObservation | SuiteObservation | null;
-    error: string | null;
-};
-declare function listObservations(dir: string): Promise<string[]>;
-
-declare function scanContent(text: string): {
-    safe: boolean;
-    matchedPattern?: string;
-};
-
-declare function escapeXml(str: string): string;
-
-declare function createMemoryProvider(config: {
-    provider: string;
-    memoryRoot?: string;
-    curatorLockTimeout?: number;
-}): Promise<MemoryProvider>;
-
-declare class LocalMemoryProvider implements MemoryProvider {
-    private db;
-    private minTrust;
-    private maxInjections;
-    private injectedMap;
-    private memoryRoot;
-    private lockManager;
-    constructor(opts?: {
-        memoryRoot?: string;
-        minTrust?: number;
-        maxInjections?: number;
-        curatorLockTimeout?: number;
-    });
-    init(params: MemoryIndexParams): Promise<void>;
-    queryForStep(stepText: string, stepIndex: number): MemoryQueryResult | null;
-    private formatMemoryContext;
-    destroy(): void;
-    getInjectedObservations(stepIndex: number): string[];
-    acquireLock(): Promise<void>;
-    releaseLock(): Promise<void>;
-    writeObservation(tier: 'products' | 'suites' | 'tests', scope: string, data: BaseObservation | SuiteObservation): Promise<string>;
-    deleteObservation(tier: 'products' | 'suites' | 'tests', scope: string, id: string): Promise<void>;
-    getAllObservations(): MemoryObservationSnippet[];
-    searchForDuplicates(content: string): MemoryObservationSnippet[];
-    getRunAnalytics(): unknown;
-}
-
-declare const DEFAULT_MEMORY_DIR = "agent-qa-memory";
-interface MemoryRootConfig {
-    services?: {
-        memory?: {
-            dir?: string;
-        };
-    };
-}
-declare function resolveMemoryRoot(config: MemoryRootConfig | undefined, configDir: string): string;
-
-declare class LockManager {
-    private lockPath;
-    private timeout;
-    constructor(lockPath: string, timeout?: number);
-    acquire(): Promise<void>;
-    release(): Promise<void>;
-    private isStale;
-}
-
-declare function shouldAblate(result: {
-    status: string;
-    steps: Array<unknown>;
-}, provider: MemoryProvider): boolean;
-declare function collectAllInjectedIds(result: {
-    steps: Array<unknown>;
-}, provider: MemoryProvider): Map<number, string[]>;
+declare function generateHookId(): string;
 
 declare function generateRunId(): string;
+/**
+ * Is this an id the run mint above would have produced? (2026-08-23, 401-20 · CR-04)
+ *
+ * THE MINT'S OWN INVERSE, re-exported one line under it and from the same package, so the two can
+ * never answer about different id shapes. The invocation core takes this as a REQUIRED option
+ * beside `mintRunId` for the reason the mint is one: `agent-local` may not name the ids package,
+ * and a shape check invented there would be a second spelling of a run's identity.
+ */
+declare function isCanonicalRunId(value: string): boolean;
 
-type AnalyticsRuntimeContext = 'user' | 'ci' | 'agent';
-type AnalyticsAgentProduct = 'claude_code' | 'cursor' | 'gemini_cli' | 'augment' | 'goose' | 'opencode' | 'codex' | 'cline' | 'amp';
-interface AnalyticsIdentity {
-    distinctId: string;
-    runtimeContext: AnalyticsRuntimeContext;
-    agentProduct?: AnalyticsAgentProduct;
-    isInternal?: boolean;
-}
-interface AnalyticsIdentityStore {
-    distinctId: string;
-    is_internal: boolean;
-}
-interface ResolveAnalyticsIdentityOptions {
-    env?: Record<string, string | undefined>;
-    identityPath?: string;
-    homeDir?: string;
-}
-declare function getAnalyticsIdentityPath(env?: Record<string, string | undefined>, homeDir?: string): string;
-declare function generateAnalyticsUserId(): string;
-declare function readAnalyticsIdentity(path?: string): Promise<AnalyticsIdentityStore | null>;
-declare function writeAnalyticsIdentity(distinctId: string, path?: string, isInternal?: boolean): Promise<void>;
-declare function resolveAnalyticsAgentProduct(env?: Record<string, string | undefined>): AnalyticsAgentProduct | undefined;
-declare function resolveAnalyticsIdentity(options?: ResolveAnalyticsIdentityOptions): Promise<AnalyticsIdentity>;
-
-type AnalyticsEventName = 'agent-qa.analytics.initialized' | 'agent-qa.analytics.test_event' | 'agent-qa.test_run.completed' | 'agent-qa.suite_run.completed' | 'agent-qa.dashboard.opened' | 'agent-qa.dashboard.live_mode.started' | 'agent-qa.dashboard.entity.created' | 'agent-qa.mcp.server.lifecycle' | 'agent-qa.mcp.tool.invoked';
-type AnalyticsSurface = 'core' | 'cli' | 'dashboard-server' | 'dashboard-ui' | 'mcp';
-type AnalyticsTransportKind = 'posthog' | 'noop' | 'mock';
-interface AnalyticsEventProperties {
-    agent_qa_version?: string;
-    surface?: AnalyticsSurface;
-    runtime_context?: AnalyticsRuntimeContext;
-    agent_product?: AnalyticsAgentProduct;
-    transport?: AnalyticsTransportKind;
-    privacy_enabled?: boolean;
-    posthog_key_present?: boolean;
-    trigger_source?: 'cli' | 'dashboard' | 'api' | 'mcp' | 'unknown';
-    runner?: 'local' | 'browserstack' | 'unknown';
-    platform?: 'web' | 'android' | 'ios' | 'unknown';
-    entity_type?: 'test' | 'suite' | 'hook' | 'unknown';
-    outcome?: 'created';
-    status?: 'passed' | 'failed' | 'skipped' | 'cancelled' | 'timeout' | 'unknown';
-    duration_ms?: number;
-    run_id?: string;
-    parent_run_id?: string;
-    test_id?: string;
-    suite_id?: string;
-    model_name?: string;
-    provider?: string;
-    provider_mode?: string;
-    planner_model?: string;
-    verifier_model?: string;
-    input_tokens?: number;
-    output_tokens?: number;
-    total_tokens?: number;
-    planner_call_count?: number;
-    verifier_call_count?: number;
-    step_count?: number;
-    passed_step_count?: number;
-    failed_step_count?: number;
-    skipped_step_count?: number;
-    subaction_count?: number;
-    cached_subaction_count?: number;
-    failed_subaction_count?: number;
-    healing_attempt_count?: number;
-    hook_count?: number;
-    failed_hook_count?: number;
-    retry_count?: number;
-    is_flaky?: boolean;
-    cancelled?: boolean;
-    timed_out?: boolean;
-    failure_category?: 'assertion' | 'timeout' | 'cancelled' | 'setup' | 'hook' | 'appium' | 'browser_install' | 'llm_context' | 'llm_provider' | 'memory' | 'framework' | 'unknown';
-    browser_name?: string;
-    mobile_transport?: string;
-    mobile_provider?: string;
-    app_state?: string;
-    execution_destination?: string;
-    memory_enabled?: boolean;
-    memory_injected_observation_count?: number;
-    memory_curator_input_tokens?: number;
-    memory_curator_output_tokens?: number;
-    memory_curator_total_tokens?: number;
-    memory_added_count?: number;
-    memory_confirmed_count?: number;
-    memory_deprecated_count?: number;
-    memory_deleted_count?: number;
-    memory_error_count?: number;
-    suite_child_count?: number;
-    suite_passed_count?: number;
-    suite_failed_count?: number;
-    suite_skipped_count?: number;
-    suite_execution_mode?: 'sequential' | 'parallel' | 'unknown';
-    mcp_tool_count?: number;
-    mcp_server_state?: 'started' | 'disabled';
-    mcp_transport?: 'stdio' | 'http';
-    mcp_host_kind?: 'loopback' | 'other';
-    mcp_port_kind?: 'default' | 'custom';
-    mcp_path_kind?: 'default' | 'custom';
-    tool_name?: string;
-    mcp_tool_category?: 'discovery' | 'schema' | 'id' | 'authoring' | 'hook' | 'run' | 'triage' | 'unknown';
-    mcp_tool_status?: 'success' | 'error';
-    mcp_error_category?: 'validation' | 'dashboard_unavailable' | 'dashboard_error' | 'config' | 'tool_error' | 'unknown';
-    '$process_person_profile'?: false;
-}
-type BuiltAnalyticsEventProperties = Record<string, string | number | boolean | undefined>;
-interface AnalyticsEventInput {
-    name: AnalyticsEventName | string;
-    properties?: Record<string, unknown>;
-}
-interface BuiltAnalyticsEvent {
-    name: AnalyticsEventName;
-    properties: BuiltAnalyticsEventProperties;
-}
-
-declare const ANALYTICS_EVENT_NAMES: readonly ["agent-qa.analytics.initialized", "agent-qa.analytics.test_event", "agent-qa.test_run.completed", "agent-qa.suite_run.completed", "agent-qa.dashboard.opened", "agent-qa.dashboard.live_mode.started", "agent-qa.dashboard.entity.created", "agent-qa.mcp.server.lifecycle", "agent-qa.mcp.tool.invoked"];
-declare const ANALYTICS_SURFACES: readonly ["core", "cli", "dashboard-server", "dashboard-ui", "mcp"];
-declare const ANALYTICS_RUNTIME_CONTEXTS: readonly ["user", "ci", "agent"];
-declare const ANALYTICS_AGENT_PRODUCTS: readonly ["claude_code", "cursor", "gemini_cli", "augment", "goose", "opencode", "codex", "cline", "amp"];
-declare const ANALYTICS_TRANSPORT_KINDS: readonly ["posthog", "noop", "mock"];
-declare const ANALYTICS_TRIGGER_SOURCES: readonly ["cli", "dashboard", "api", "mcp", "unknown"];
-declare const ANALYTICS_RUNNERS: readonly ["local", "browserstack", "unknown"];
-declare const ANALYTICS_PLATFORMS: readonly ["web", "android", "ios", "unknown"];
-declare const ANALYTICS_DASHBOARD_ENTITY_TYPES: readonly ["test", "suite", "hook", "unknown"];
-declare const ANALYTICS_DASHBOARD_OUTCOMES: readonly ["created"];
-declare const ANALYTICS_RUN_STATUSES: readonly ["passed", "failed", "skipped", "cancelled", "timeout", "unknown"];
-declare const ANALYTICS_MCP_SERVER_STATES: readonly ["started", "disabled"];
-declare const ANALYTICS_MCP_TRANSPORTS: readonly ["stdio", "http"];
-declare const ANALYTICS_MCP_HOST_KINDS: readonly ["loopback", "other"];
-declare const ANALYTICS_MCP_PORT_KINDS: readonly ["default", "custom"];
-declare const ANALYTICS_MCP_PATH_KINDS: readonly ["default", "custom"];
-declare const ANALYTICS_MCP_TOOL_CATEGORIES: readonly ["discovery", "schema", "id", "authoring", "hook", "run", "triage", "unknown"];
-declare const ANALYTICS_MCP_TOOL_STATUSES: readonly ["success", "error"];
-declare const ANALYTICS_MCP_ERROR_CATEGORIES: readonly ["validation", "dashboard_unavailable", "dashboard_error", "config", "tool_error", "unknown"];
-declare const ANALYTICS_FAILURE_CATEGORIES: readonly ["assertion", "timeout", "cancelled", "setup", "hook", "appium", "browser_install", "llm_context", "llm_provider", "memory", "framework", "unknown"];
-declare const ANALYTICS_SUITE_EXECUTION_MODES: readonly ["sequential", "parallel", "unknown"];
-declare function buildAnalyticsEvent(input: AnalyticsEventInput): BuiltAnalyticsEvent;
-
-interface AnalyticsCapturePayload {
-    distinctId: string;
-    isInternal?: boolean;
-    event: BuiltAnalyticsEvent;
-}
-interface AnalyticsTransport {
-    capture(payload: AnalyticsCapturePayload): void | Promise<void>;
-    flush(): void | Promise<void>;
-}
-declare class NoopAnalyticsTransport implements AnalyticsTransport {
-    capture(): void;
-    flush(): void;
-}
-declare class MockAnalyticsTransport implements AnalyticsTransport {
-    readonly events: AnalyticsCapturePayload[];
-    flushCount: number;
-    capture(payload: AnalyticsCapturePayload): void;
-    flush(): void;
-}
-
-declare const EMPTY_POSTHOG_KEY_WARNING = "PostHog analytics initialization failed because AGENT_QA_POSTHOG_KEY is empty. Analytics telemetry is disabled.";
-interface AnalyticsServiceConfig {
-    analytics?: {
-        privacy?: true;
-    };
+type RunAttributes = Record<string, string>;
+declare const INTERNAL_ATTRIBUTE_PREFIX = "agent-qa.";
+declare const ATTR_TRIGGER = "agent-qa.trigger";
+declare const ATTR_RUNNER = "agent-qa.runner";
+declare const ATTR_GATE_RUN = "agent-qa.gate-run";
+type RunAttributeTrigger = 'cli' | 'dashboard' | 'api' | 'mcp';
+type RunAttributeRunner = 'local' | 'browserstack';
+declare const RUN_ATTRIBUTE_KEY_MAX_LENGTH = 256;
+declare const RUN_ATTRIBUTE_VALUE_MAX_LENGTH = 4096;
+interface ParsedRunAttrFlags {
+    attributes: RunAttributes;
+    duplicateKeys: string[];
 }
-interface AnalyticsPostHogTransportFactoryOptions {
-    projectKey: string;
-    host: string;
-    disableGeoip: false;
-}
-interface AnalyticsServiceOptions {
-    config?: AnalyticsServiceConfig;
-    surface?: AnalyticsSurface;
-    transport?: AnalyticsTransport;
-    warningSink?: (message: string) => void;
-    projectKey?: string;
-    projectHost?: string;
-    identityPath?: string;
-    env?: Record<string, string | undefined>;
-    posthogTransportFactory?: (options: AnalyticsPostHogTransportFactoryOptions) => AnalyticsTransport;
-}
-interface AnalyticsService {
-    capture(event: BuiltAnalyticsEvent): Promise<void>;
-    flush(): Promise<void>;
-}
-interface AnalyticsStandardPropertiesOptions {
-    surface?: AnalyticsSurface;
-    identityPath?: string;
-    env?: Record<string, string | undefined>;
-    agentQaVersion?: string;
-}
-declare function resolveAnalyticsStandardProperties(options?: AnalyticsStandardPropertiesOptions): Promise<AnalyticsEventProperties>;
-declare function createAnalyticsService(options?: AnalyticsServiceOptions): AnalyticsService;
-declare function getAnalyticsService(options?: AnalyticsServiceOptions): AnalyticsService;
-declare function resetAnalyticsServiceForTests(): void;
-declare function captureAnalytics(event: BuiltAnalyticsEvent, options?: AnalyticsServiceOptions): Promise<void>;
-declare function flushAnalytics(options?: AnalyticsServiceOptions): Promise<void>;
-
-declare const AGENT_QA_POSTHOG_KEY = "phc_siDVZ3DEoSCiBSocn2GZMRhx5UcRwekJDVtap5Zteii3";
-declare const AGENT_QA_POSTHOG_HOST = "https://us.i.posthog.com";
-
-interface AnalyticsRunReporterOptions extends Omit<AnalyticsServiceOptions, 'transport'> {
-    surface?: AnalyticsSurface;
-    service?: AnalyticsService;
-    transport?: AnalyticsTransport;
-}
-declare class AnalyticsRunReporter implements Reporter {
-    private readonly service;
-    private readonly surface;
-    private readonly identityPath?;
-    private readonly env?;
-    private readonly disabled;
-    private readonly runStates;
-    private readonly suiteStates;
-    constructor(options?: AnalyticsRunReporterOptions);
-    onSuiteStart(suite: SuiteDefinition, context?: RunArtifactReporterContext): Promise<void>;
-    onTestStart(test: TestDefinition, _filePath: string, context?: RunArtifactReporterContext): Promise<void>;
-    onHookEnd(event: HookResultEvent): Promise<void>;
-    onTestEnd(): Promise<void>;
-    onRunEnd(summary: RunSummary): Promise<void>;
-    onSuiteEnd(summary: SuiteSummary): Promise<void>;
-    flush(): Promise<void>;
-    private findStateForResult;
-    private captureTestResult;
-    private captureSuiteResult;
-}
-declare function createAnalyticsRunReporter(options?: AnalyticsRunReporterOptions): AnalyticsRunReporter;
+declare function validateUserRunAttributes(input: unknown, sourceLabel?: string): RunAttributes;
+declare function validateTrustedRunAttributes(input: unknown, sourceLabel?: string): RunAttributes;
+declare function parseRunAttrFlags(flags: string[] | undefined): ParsedRunAttrFlags;
+declare function buildInternalRunAttributes(input: {
+    trigger: RunAttributeTrigger;
+    runner: RunAttributeRunner;
+}): RunAttributes;
+declare function mergeRunAttributes(internal: RunAttributes, user: RunAttributes): RunAttributes;
+declare function sortRunAttributesForDisplay(attributes: RunAttributes, activeKeys?: string[]): Array<[string, string]>;
+declare function formatRunAttributesBlock(attributes: RunAttributes): string;
 
 declare const AGENT_QA_VERSION: string;
 declare function getAgentQaVersion(): string;
@@ -3660,57 +2146,13 @@ declare const DEFAULT_AGENT_QA_SCREENSHOTS_DIR = ".agent-qa/artifacts/screenshot
 declare const DEFAULT_AGENT_QA_VIDEOS_DIR = ".agent-qa/artifacts/videos";
 declare const DEFAULT_AGENT_QA_RUNS_DB_PATH = ".agent-qa/runs.db";
 declare const LEGACY_AGENT_QA_DASHBOARD_DB_PATH = ".agent-qa/dashboard.db";
-
-interface CompressOptions {
-    effectiveResolution: number;
-    maxBytes?: number;
-    actionSpaceWidth: number;
-}
-interface CompressResult {
-    buffer: Buffer;
-    imageWidth: number;
-    imageHeight: number;
-}
-declare function compressScreenshot(buffer: Buffer, opts: CompressOptions, logger?: ScopedLogger): Promise<CompressResult>;
-
-interface AlignOptions {
-    width: number;
-    height: number;
-}
-/** Resize buffer to exact window dimensions. Used by mobile adapters for
- *  action-space alignment (e.g., iOS physical pixels → logical points). */
-declare function alignToWindow(buffer: Buffer, opts: AlignOptions): Promise<Buffer>;
-
-interface ImageDimensions {
-    width: number;
-    height: number;
-}
-/** Read image buffer width/height without decoding pixels.
- *  Used by mobile adapters for action-space drift assertions (D-06/D-07). */
-declare function getImageDimensions(buffer: Buffer): Promise<ImageDimensions | undefined>;
-
-/**
- * Converts "Meta" tokens in keyboard combo strings to "Control" on non-Mac platforms.
- *
- * Users write combos like "Meta+k" and we route them to Cmd+K on Mac, Ctrl+K on
- * Windows/Linux. Uses split/join (not regex) to avoid edge-case bugs with adjacent
- * tokens like "Shift+Meta+Meta+T".
- *
- * @param keys - Array of key/combo strings (e.g., ["Meta+k", "Enter"])
- * @param options.enabled - When false, keys are returned unchanged
- * @param options.isMac - When true, keys are returned unchanged (Meta is native)
- * @returns New array with Meta tokens replaced by Control (when applicable)
- */
-declare function convertKeysForPlatform(keys: string[], options: {
-    enabled: boolean;
-    isMac: boolean;
-}): string[];
 /**
- * Returns true when running on macOS. Reads process.platform at call time so
- * tests can override it via Object.defineProperty(process, 'platform', ...).
+ * The runs database a config names, without migrating anything: the configured path, else the
+ * default, else a legacy dashboard.db nothing has renamed yet. The writer's resolver renames that
+ * legacy file on top of this; the CLI reader binds only the configured or default path.
  */
-declare function isMacPlatform(): boolean;
+declare function locateRunsDbPath(configDir: string, configuredDbPath?: string): string;
 
 declare function isPathInsideDir(childPath: string, parentDir: string): boolean;
 
-export { AGENT_QA_POSTHOG_HOST, AGENT_QA_POSTHOG_KEY, AGENT_QA_VERSION, ANALYTICS_AGENT_PRODUCTS, ANALYTICS_DASHBOARD_ENTITY_TYPES, ANALYTICS_DASHBOARD_OUTCOMES, ANALYTICS_EVENT_NAMES, ANALYTICS_FAILURE_CATEGORIES, ANALYTICS_MCP_ERROR_CATEGORIES, ANALYTICS_MCP_HOST_KINDS, ANALYTICS_MCP_PATH_KINDS, ANALYTICS_MCP_PORT_KINDS, ANALYTICS_MCP_SERVER_STATES, ANALYTICS_MCP_TOOL_CATEGORIES, ANALYTICS_MCP_TOOL_STATUSES, ANALYTICS_MCP_TRANSPORTS, ANALYTICS_PLATFORMS, ANALYTICS_RUNNERS, ANALYTICS_RUNTIME_CONTEXTS, ANALYTICS_RUN_STATUSES, ANALYTICS_SUITE_EXECUTION_MODES, ANALYTICS_SURFACES, ANALYTICS_TRANSPORT_KINDS, ANALYTICS_TRIGGER_SOURCES, ANDROID_ROLE_MAP, ATTR_RUNNER, ATTR_TRIGGER, AUTH_STATE_HOOK_CONTAINER_STORAGE_STATE_PATH, AUTH_STATE_HOOK_JSON_ENV, AUTH_STATE_HOOK_STORAGE_STATE_FILENAME, AUTH_STATE_HOOK_STORAGE_STATE_PATH_ENV, AUTH_STATE_HOOK_WORKSPACE_DIR, AUTH_STATE_REDACTION_MARKER, AUTH_STATE_SCHEMA_VERSION, AUTH_STATE_SLUG_PATTERN, type AccessibilityCheck, type AccessibilityCheckOptions, AccessibilityConfigSchema, type AccessibilityViolation, type Action, type ActionCache, type ActionPlan, ActionPlanSchema, type ActionResult, AdapterLogDataSchema, AgentLogDataSchema, type AgentLoopConfig, type AgentPhase, type AgentQaConfig, AgentQaConfigSchema, type AgentQaUpdateStatus, type AlignOptions, type AnalyticsAgentProduct, type AnalyticsCapturePayload, type AnalyticsEventInput, type AnalyticsEventName, type AnalyticsEventProperties, type AnalyticsIdentity, type AnalyticsIdentityStore, type AnalyticsPostHogTransportFactoryOptions, AnalyticsRunReporter, type AnalyticsRunReporterOptions, type AnalyticsRuntimeContext, AnalyticsSchema, type AnalyticsService, type AnalyticsServiceConfig, type AnalyticsServiceOptions, type AnalyticsStandardPropertiesOptions, type AnalyticsSurface, type AnalyticsTransport, type AnalyticsTransportKind, type AppiumExecutableSource, type ArtifactRecord, type Asserter, AssertionEvaluator, type AssertionInput, type AssertionResult, AssertionResultSchema, type AssertionType, type AuthCredential, type AuthPluginBundle, type AuthPluginDeclaration, AuthPluginDeclarationSchema, type AuthProvider, AuthStateConfigSchema, type AuthStateMetadata, AuthStateMetadataSchema, AuthStateNameSchema, type AuthStateRedactionContext, type AuthStateTargetPlatform, AuthStateUseSchema, type AuthStore, type BaseObservation, BaseObservationSchema, type BetterSqlite3Database, type BrowserConfig, BrowserConfigSchema, type BuiltAnalyticsEvent, type BuiltAnalyticsEventProperties, CACHE_SCHEMA_VERSION, CacheConfigSchema, type CacheEntry, CacheLogDataSchema, type CaptureConfig, CaptureConfigSchema, type CaptureResult, CircuitBreaker, type CircuitBreakerConfig, type CompressOptions, type CompressResult, type ConsoleLogEntry, ConsoleReporter, type ConsoleReporterOptions, type CreateAuthFetchContext, type CreateAuthFetchOptions, type CuratorContext, CuratorResponseSchema, DEFAULT_AGENT_QA_ARTIFACTS_DIR, DEFAULT_AGENT_QA_AUTH_STATES_DIR, DEFAULT_AGENT_QA_CACHE_DIR, DEFAULT_AGENT_QA_RUNS_DB_PATH, DEFAULT_AGENT_QA_RUNTIME_DIR, DEFAULT_AGENT_QA_SCREENSHOTS_DIR, DEFAULT_AGENT_QA_VIDEOS_DIR, DEFAULT_MEMORY_DIR, type DashboardAuthMetadata, type DashboardAuthMode, DashboardConfigSchema, type DeviceConfig, DeviceProfileSchema, DurationString, EMPTY_POSTHOG_KEY_WARNING, type ElementInfo, type ExchangeCodeContext, ExplicitExtractor, type ExtractionMethod, ExtractionResultSchema, type ExtractorInput, type FarmMobileConfig, type FarmProvider, type FarmProviderConfig, type FarmWebConfig, FatalReporterError, FileActionCache, type FileAttachment, HealerLogDataSchema, type HealingAttempt, type HealingConfig, HealingConfigSchema, type HookDefinition, HookDefinitionSchema, type HookEvent, HookLogDataSchema, type HookOrchestrationResult, HookReferenceMigrationError, type HookResult, type HookResultEvent, type HookRuntime, type HooksFileConfig, HooksFileSchema, INTERNAL_ATTRIBUTE_PREFIX, IOS_ROLE_MAP, type ImageDimensions, JUnitReporter, type JUnitReporterOptions, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, KEY_MAP, LEGACY_AGENT_QA_DASHBOARD_DB_PATH, LLMAssertionEvaluator, type LLMAuthProviderPlugin, type LLMModelAdapter, LLMPlanner, type LLMProviderMode, LLMVariableExtractor, LLMVerifier, LOG_LEVEL_PRIORITY, type ListAuthStateMetadataInput, type LoadLLMAuthPluginsOptions, LocalMemoryProvider, LockManager, LogCaptureConfigSchema, type LogEntry, type LogLevel, LogManager, type LogSource, LogSourceDataSchemas, type LogStorage, LoggingConfigSchema, MOBILE_ONLY_ACTIONS, McpConfigSchema, type MemoryDelta, type MemoryDeltaAction, type MemoryIndexParams, type MemoryLog, type MemoryObservationSnapshot, type MemoryProvider, type MemoryQueryResult, MissingSecretError, type MobileAppState, MobileAppStateSchema, MobileElementResolver, type MobileNode, type MobilePlatform, type MobileRefMap, MobileSetupError, type MobileSetupErrorCategory, type MobileSetupErrorOptions, type MobileTransport, MobileUseOverrideSchema, MobileUseSchema, MockAnalyticsTransport, type ModelConfig, ModelConfigSchema, MultiReporter, NamedLLMConfigSchema, type NetworkLogEntry, NoopAnalyticsTransport, type NormalizedAuthStateUse, NullActionCache, type OAuthTokens, type ObservationFrontmatter, type ObserveOptions, type ParseError, type ParseResult, type ParsedMobileTree, type ParsedRunAttrFlags, type PlanResult, type Planner, type PlannerConfig, PlannerConfigSchema, PlannerLogDataSchema, type PlatformAdapter, type PlatformConfig, PluginsSchema, ProviderConfigSchema, type ProviderOptions, RUNTIME_IMAGE_MAP, RUN_ARTIFACT_SCHEMA_VERSION, RUN_ATTRIBUTE_KEY_MAX_LENGTH, RUN_ATTRIBUTE_VALUE_MAX_LENGTH, RecordingConfigSchema, type RegistryConfig, RegistrySchema, type RemoveAuthStateFilesInput, type RemoveAuthStateTargetInput, type Reporter, type ReporterEvent, type ResolveAnalyticsIdentityOptions, type ResolveAppiumExecutableOptions, type ResolveAuthStateForRunInput, type ResolveAuthStatePathsInput, type ResolveAuthStateRootInput, type ResolveMobileRunConfigInput, type ResolvedAppiumExecutable, type ResolvedAuthStateForRun, type ResolvedAuthStatePaths, type ResolvedLLMAuth, type ResolvedMobileApp, type ResolvedMobileAppInstall, type ResolvedMobileDevice, type ResolvedMobileRunConfig, type ResolvedWorkspaceFile, type ResolvedWorkspacePaths, type RunArtifactConfigSnapshot, type RunArtifactFinalizeInput, type RunArtifactKind, type RunArtifactMemoryDelta, type RunArtifactMemoryDeltaAction, type RunArtifactMemoryObservationSnapshot, type RunArtifactMemorySnapshot, type RunArtifactMetadata, type RunArtifactPayload, type RunArtifactReporterContext, type RunArtifactRuntimeSnapshot, type RunArtifactStageInput, type RunArtifactSuiteMemberSnapshot, type RunArtifactSuiteSourceSnapshot, type RunArtifactTerminalError, type RunArtifactTestSourceSnapshot, type RunAttributeRunner, type RunAttributeTrigger, type RunAttributes, type RunSuiteConfig, type RunSummary, type RunTestConfig, RunnerLogDataSchema, type SandboxRunnerOptions, type ScopedLogger, type ScreenState, type ScreenStateMetadata, SecretConfigError, type SecretFileMetadata, SecretRedactor, SecretStore, type SecretTemplate, type ServicesConfig, ServicesSchema, SizeString, type StartAuthContext, type StartAuthResult, StdoutLiveReporter, type StepAnnotation, type StepContext, type StepHashInputs, type StepPhaseEvent, type StepResult, type StepStatus, type StepTrace, type SuiteDefinition, SuiteDefinitionSchema, type SuiteObservation, type SuiteObservationFrontmatter, SuiteObservationSchema, type SuiteResult, type SuiteSummary, SuiteTestEntrySchema, TargetNameSchema, TargetSchema, type TestConfig, type TestDefinition, TestDefinitionSchema, type TestMeta, TestMetaSchema, type TestResult, type TestStatus, type TestStep, TestStepSchema, type TimeoutConfig, TimeoutConfigSchema, type TokenRefreshFn, type TokenUsage, type ToolCategory, type ToolDefinition, ToolRegistry, TransportSchema, type UseConfig, UseSchema, VALID_FILENAME_RE, VERSION_CHECK_CACHE_TTL_MS, VERSION_CHECK_TIMEOUT_MS, type ValidationDiagnostic, type ValidationResult, type VariableExtractor, type VariableSource, VariableStore, type VerificationResult, VerificationResultSchema, type Verifier, type VerifyResult, type VersionCheckOptions, WEB_ONLY_ACTIONS, type WorkspaceConfig, type WorkspaceFileKind, type WorkspaceFileRecord, WorkspaceSchema, type WriteAuthStateFilesInput, alignToWindow, applyWorkspaceHookReferenceMigration, auditWorkspaceHookReferenceMigration, browserstackProvider, buildAnalyticsEvent, buildAssertionPrompt, buildAuthStateHookEnv, buildExtractionPrompt, buildInternalRunAttributes, buildMemoryIndex, buildStepPrompt, buildSystemPrompt, buildTools, buildVerificationPrompt, captureAnalytics, captureFailureScreenshot, checkDockerAvailable, clearLLMAuthProviderPlugins, clearLoadedLLMAuthPluginModules, collectAllInjectedIds, compressScreenshot, computeFingerPositions, computePinch, computeSwipe, convertKeysForPlatform, createAnalyticsRunReporter, createAnalyticsService, createAsserter, createAuthFetch, createBetterSqlite3Database, createExtractor, createMemoryProvider, createModel, createWrappedModel, defaultRegistry, deprecateOnFailure, detectGlobOverlap, detectPlaywrightVersion, discoverWorkspaceFiles, ensureMemoryDirs, escapeXml, estimateTokens, executeStep, findBareVariables, findSecretTemplates, findUnresolvedTemplates, flushAnalytics, formatAppiumInstallGuidance, formatDiagnostics, formatDiagnosticsPlain, formatLogEntry, formatParseError, formatRunAttributesBlock, generateAnalyticsUserId, generateFailureSummary, generatePKCE, generateRunId, generateState, getAgentQaUpdateStatus, getAgentQaVersion, getAgentQaVersionCheckCachePath, getAnalyticsIdentityPath, getAnalyticsService, getAuthPath, getCredential, getImageDimensions, getLLMAuthProviderPlugin, getProvider, getProviderOptions, hashScreenState, hashStepInstruction, interpolateSecretTemplates, interpolateVariables, isBetterSqlite3AbiMismatch, isBetterSqlite3NativeModuleError, isBetterSqlite3NodeGypSymlinkConflict, isMacPlatform, isPathInsideDir, isReservedAuthStateHookEnvKey, isWorkspacePathMatch, listAuthStateMetadata, listLLMAuthProviderPlugins, listObservations, listProviders, loadLLMAuthPlugins, localAppiumBinaryNames, mapMobileCapabilities, mapWebCapabilities, mergeRunAttributes, normalizeAuthStateUse, normalizeRole, parseAllTests, parseEnvFile, parseHookInline, parseHooksFile, parseMobileSource, parseObservation, parseRunAttrFlags, parseSuiteFile, parseTTL, parseTestFile, readAnalyticsIdentity, readAuth, readAuthStateMetadata, redactAuthStateString, redactAuthStateValue, redactSecretValue, registerAllProviders, registerLLMAuthProviderPlugin, registerLLMAuthProviderPlugins, registerProvider, removeAuth, removeAuthStateFiles, removeAuthStateTarget, resetAnalyticsServiceForTests, resolveAnalyticsAgentProduct, resolveAnalyticsIdentity, resolveAnalyticsStandardProperties, resolveAppiumExecutable, resolveAuthStateForRun, resolveAuthStatePaths, resolveAuthStateRoot, resolveBetterSqliteRebuildCommand, resolveFarmCredentials, resolveFileReferences, resolveLLMAuth, resolveMemoryRoot, resolveMobileRunConfig, resolveSecretTemplatesInValue, resolveWorkspaceFileTarget, resolveWorkspacePaths, runCurator, runHookInSandbox, runHooks, runSuite, runTest, runTestWithRetry, scanContent, serializeEnvFile, shouldAblate, sortRunAttributesForDisplay, stripHookInline, stripReservedAuthStateHookEnv, toolCallToActionPlan, toolSchemaMiddleware, truncateScreenState, validateConfig, validateFilename, validateFiles, validateProject, validateSuiteFile, validateTestFile, validateTrustedRunAttributes, validateUserRunAttributes, warnIfOutOfBounds, writeAnalyticsIdentity, writeAuth, writeAuthStateFiles, writeObservation };
+export { AGENT_QA_VERSION, ANDROID_ROLE_MAP, ATTR_GATE_RUN, ATTR_RUNNER, ATTR_TRIGGER, AUTH_STATE_SCHEMA_VERSION, AUTH_STATE_SLUG_PATTERN, AccessibilityConfigSchema, type ActionPlan, ActionPlanSchema, AdapterLogDataSchema, AgentLogDataSchema, type AgentQaConfig, AgentQaConfigSchema, type AgentQaUpdateStatus, AnalyticsSchema, type AppiumExecutableSource, type AsyncScopeStore, type AuthCredential, type AuthPluginBundle, type AuthPluginDeclaration, AuthPluginDeclarationSchema, type AuthProvider, AuthStateConfigSchema, type AuthStateMetadata, AuthStateMetadataSchema, AuthStateNameSchema, type AuthStateTargetPlatform, AuthStateUseSchema, type AuthStore, BrowserConfigSchema, CacheConfigSchema, CacheLogDataSchema, type CaptureConfig, CaptureConfigSchema, type CaptureResult, type CreateAuthFetchContext, type CreateAuthFetchOptions, DEFAULT_AGENT_QA_ARTIFACTS_DIR, DEFAULT_AGENT_QA_AUTH_STATES_DIR, DEFAULT_AGENT_QA_CACHE_DIR, DEFAULT_AGENT_QA_RUNS_DB_PATH, DEFAULT_AGENT_QA_RUNTIME_DIR, DEFAULT_AGENT_QA_SCREENSHOTS_DIR, DEFAULT_AGENT_QA_VIDEOS_DIR, type DashboardAuthMetadata, type DashboardAuthMode, DashboardConfigSchema, DeviceProfileSchema, DurationString, type ExchangeCodeContext, type ExtractionMethod, type ExtractorInput, type FarmMobileConfig, type FarmProvider, type FarmProviderConfig, type FarmWebConfig, type FileAttachment, HookDefinitionSchema, HookLogDataSchema, type HooksFileConfig, HooksFileSchema, INTERNAL_ATTRIBUTE_PREFIX, IOS_EDITABLE_TYPES, IOS_ROLE_MAP, type IdentifiedScrollOffsets, KEY_MAP, KnowledgeConfigSchema, LEGACY_AGENT_QA_DASHBOARD_DB_PATH, type LLMAuthProviderPlugin, type LLMModelAdapter, type LLMProviderMode, LOG_LEVEL_PRIORITY, LOOPBACK_HOSTS, type ListAuthStateMetadataInput, type LoadLLMAuthPluginsOptions, LogCaptureConfigSchema, type LogEntry, type LogLevel, LogManager, type LogSource, LogSourceDataSchemas, type LogStorage, LoggingConfigSchema, McpConfigSchema, type MemberLogScope, MemberLogScopeUnavailableError, type MobileAppState, MobileAppStateSchema, MobileElementResolver, type MobileNode, type MobilePlatform, type MobileRefMap, MobileSetupError, type MobileSetupErrorCategory, type MobileSetupErrorOptions, type MobileTransport, MobileUseOverrideSchema, MobileUseSchema, ModelConfigSchema, NameSlugSchema, NamedLLMConfigSchema, type NormalizedAuthStateUse, type OAuthTokens, PUBLIC_PROVIDER_API_HOSTS, type ParseAllTestBindingsResult, type ParseError, type ParseResult, type ParsedMobileSource, type ParsedRunAttrFlags, type ParsedTestBinding, type ParsedTestDocument, PatchOpUnsupportedTargetError, PatchPointerOutsideEditableRegionError, PatchPointerUnresolvableError, PatchedDocumentInvalidError, type PlanResult, type Planner, type PlannerConfig, PlannerConfigSchema, PlannerLogDataSchema, PluginsSchema, ProviderConfigSchema, type ProviderPluginDeclaration, ProviderPluginDeclarationSchema, type ProviderPluginDescriptor, RUN_ATTRIBUTE_KEY_MAX_LENGTH, RUN_ATTRIBUTE_VALUE_MAX_LENGTH, RecordingConfigSchema, type RefEntry, type RegistryConfig, RegistrySchema, type RemoveAuthStateFilesInput, type RemoveAuthStateTargetInput, type ResolveAppiumExecutableOptions, type ResolveAuthStateForRunInput, type ResolveAuthStatePathsInput, type ResolveAuthStateRootInput, type ResolveMobileRunConfigInput, type ResolvedAppiumExecutable, type ResolvedAuthStateForRun, type ResolvedAuthStatePaths, type ResolvedLLMAuth, type ResolvedMobileApp, type ResolvedMobileAppInstall, type ResolvedMobileDevice, type ResolvedMobileRunConfig, type ResolvedWorkspaceFile, type ResolvedWorkspacePaths, type RunAttributeRunner, type RunAttributeTrigger, type RunAttributes, type RunSuiteConfig, RunnerLogDataSchema, type ScopedLogger, type ServicesConfig, ServicesSchema, SizeString, type StartAuthContext, type StartAuthResult, type StepContext, type SuiteDefinition, SuiteDefinitionSchema, type SuiteResult, SuiteTestEntrySchema, TargetNameSchema, TargetSchema, type TestConfig, type TestDefinition, TestDefinitionSchema, type TestMeta, TestMetaSchema, type TestStep, TestStepSchema, TimeoutConfigSchema, type TokenRefreshFn, TransportSchema, type UseConfig, UseSchema, VALID_FILENAME_RE, VERSION_CHECK_CACHE_TTL_MS, VERSION_CHECK_TIMEOUT_MS, type ValidationDiagnostic, type ValidationResult, type VariableExtractor, type VerificationResult, type Verifier, type VerifyResult, type VersionCheckOptions, WEBVIEW_SCROLLERS_SCRIPT, type WorkspaceConfig, type WorkspaceFileKind, type WorkspaceFileRecord, WorkspaceSchema, type WriteAuthStateFilesInput, applyPatchSetToTestDoc, browserstackProvider, buildInternalRunAttributes, buildRefEntries, clearLLMAuthProviderPlugins, clearLoadedLLMAuthPluginModules, clearLoadedProviderPluginModules, computeFingerPositions, computePinch, computeSwipe, createAuthFetch, deriveMobileScroll, detectGlobOverlap, detectPlaywrightVersion, discoverWorkspaceFiles, estimateTokens, formatAppiumInstallGuidance, formatDiagnostics, formatDiagnosticsPlain, formatLogEntry, formatParseError, formatRunAttributesBlock, generateHookId, generatePKCE, generateRunId, generateState, getAgentQaUpdateStatus, getAgentQaVersion, getAgentQaVersionCheckCachePath, getAuthPath, getCredential, getLLMAuthProviderPlugin, getProvider, isCanonicalRunId, isLoopbackHost, isPathInsideDir, isWorkspacePathMatch, listAuthStateMetadata, listLLMAuthProviderPlugins, listProviders, loadLLMAuthPlugins, loadProviderPlugins, localAppiumBinaryNames, locateRunsDbPath, mapMobileCapabilities, mapWebCapabilities, mergeRunAttributes, normalizeAuthStateUse, normalizeRole, parseAllTestBindings, parseAllTests, parseHooksFile, parseMobileSource, parseRunAttrFlags, parseSuiteFile, parseTestFile, parseTestFileWithTokens, parseWebViewScrollers, patchTestForSuite, readAuth, readAuthStateMetadata, registerAllProviders, registerLLMAuthProviderPlugin, registerLLMAuthProviderPlugins, registerProvider, removeAuth, removeAuthStateFiles, removeAuthStateTarget, renderPatchedTestDoc, resolveAppiumExecutable, resolveAuthStateForRun, resolveAuthStatePaths, resolveAuthStateRoot, resolveFarmCredentials, resolveFileReferences, resolveKnowledgeRoot, resolveLLMAuth, resolveMobileRunConfig, resolveWorkspaceFileTarget, resolveWorkspacePaths, sortRunAttributesForDisplay, validateConfig, validateFilename, validateFiles, validateProject, validateSuiteFile, validateTestFile, validateTrustedRunAttributes, validateUserRunAttributes, warnIfOutOfBounds, webViewSwipeSignal, workspaceRelativeIdentityPath, writeAuth, writeAuthStateFiles, yamlParseFailureMessage };