@terminai/core 0.21.0

package/dist/src/gui/protocol/schemas.d.ts

@@ -0,0 +1,960 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Desktop Automation Protocol (DAP) Zod Schemas
+ *
+ * Runtime validation for tool arguments and driver responses.
+ */
+import { z } from 'zod';
+export declare const DriverCapabilitiesSchema: z.ZodObject<{
+    canSnapshot: z.ZodBoolean;
+    canClick: z.ZodBoolean;
+    canType: z.ZodBoolean;
+    canScroll: z.ZodBoolean;
+    canKey: z.ZodBoolean;
+    canOcr: z.ZodBoolean;
+    canScreenshot: z.ZodBoolean;
+    canInjectInput: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    canSnapshot: boolean;
+    canClick: boolean;
+    canType: boolean;
+    canScroll: boolean;
+    canKey: boolean;
+    canOcr: boolean;
+    canScreenshot: boolean;
+    canInjectInput: boolean;
+}, {
+    canSnapshot: boolean;
+    canClick: boolean;
+    canType: boolean;
+    canScroll: boolean;
+    canKey: boolean;
+    canOcr: boolean;
+    canScreenshot: boolean;
+    canInjectInput: boolean;
+}>;
+export declare const DriverDescriptorSchema: z.ZodObject<{
+    name: z.ZodString;
+    kind: z.ZodEnum<["native", "remote", "mock"]>;
+    version: z.ZodString;
+    capabilities: z.ZodObject<{
+        canSnapshot: z.ZodBoolean;
+        canClick: z.ZodBoolean;
+        canType: z.ZodBoolean;
+        canScroll: z.ZodBoolean;
+        canKey: z.ZodBoolean;
+        canOcr: z.ZodBoolean;
+        canScreenshot: z.ZodBoolean;
+        canInjectInput: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        canSnapshot: boolean;
+        canClick: boolean;
+        canType: boolean;
+        canScroll: boolean;
+        canKey: boolean;
+        canOcr: boolean;
+        canScreenshot: boolean;
+        canInjectInput: boolean;
+    }, {
+        canSnapshot: boolean;
+        canClick: boolean;
+        canType: boolean;
+        canScroll: boolean;
+        canKey: boolean;
+        canOcr: boolean;
+        canScreenshot: boolean;
+        canInjectInput: boolean;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    version: string;
+    capabilities: {
+        canSnapshot: boolean;
+        canClick: boolean;
+        canType: boolean;
+        canScroll: boolean;
+        canKey: boolean;
+        canOcr: boolean;
+        canScreenshot: boolean;
+        canInjectInput: boolean;
+    };
+    kind: "native" | "remote" | "mock";
+}, {
+    name: string;
+    version: string;
+    capabilities: {
+        canSnapshot: boolean;
+        canClick: boolean;
+        canType: boolean;
+        canScroll: boolean;
+        canKey: boolean;
+        canOcr: boolean;
+        canScreenshot: boolean;
+        canInjectInput: boolean;
+    };
+    kind: "native" | "remote" | "mock";
+}>;
+export declare const ElementNodeSchema: z.ZodType<unknown>;
+export declare const VisualDOMSnapshotSchema: z.ZodObject<{
+    snapshotId: z.ZodString;
+    timestamp: z.ZodString;
+    activeApp: z.ZodObject<{
+        pid: z.ZodNumber;
+        appId: z.ZodOptional<z.ZodString>;
+        processName: z.ZodOptional<z.ZodString>;
+        title: z.ZodString;
+        windowHandle: z.ZodOptional<z.ZodString>;
+        bounds: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            w: z.ZodNumber;
+            h: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            w: number;
+            x: number;
+            y: number;
+            h: number;
+        }, {
+            w: number;
+            x: number;
+            y: number;
+            h: number;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        pid: number;
+        title: string;
+        bounds?: {
+            w: number;
+            x: number;
+            y: number;
+            h: number;
+        } | undefined;
+        appId?: string | undefined;
+        processName?: string | undefined;
+        windowHandle?: string | undefined;
+    }, {
+        pid: number;
+        title: string;
+        bounds?: {
+            w: number;
+            x: number;
+            y: number;
+            h: number;
+        } | undefined;
+        appId?: string | undefined;
+        processName?: string | undefined;
+        windowHandle?: string | undefined;
+    }>;
+    tree: z.ZodOptional<z.ZodType<unknown, z.ZodTypeDef, unknown>>;
+    textIndex: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        text: z.ZodString;
+        bounds: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            w: z.ZodNumber;
+            h: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            w: number;
+            x: number;
+            y: number;
+            h: number;
+        }, {
+            w: number;
+            x: number;
+            y: number;
+            h: number;
+        }>;
+        source: z.ZodEnum<["structure", "ocr"]>;
+        confidence: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        text: string;
+        source: "structure" | "ocr";
+        confidence: number;
+        bounds: {
+            w: number;
+            x: number;
+            y: number;
+            h: number;
+        };
+    }, {
+        text: string;
+        source: "structure" | "ocr";
+        confidence: number;
+        bounds: {
+            w: number;
+            x: number;
+            y: number;
+            h: number;
+        };
+    }>, "many">>;
+    screenshot: z.ZodOptional<z.ZodObject<{
+        hash: z.ZodString;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        encoding: z.ZodEnum<["png", "jpeg"]>;
+    }, "strip", z.ZodTypeAny, {
+        encoding: "png" | "jpeg";
+        hash: string;
+        width: number;
+        height: number;
+    }, {
+        encoding: "png" | "jpeg";
+        hash: string;
+        width: number;
+        height: number;
+    }>>;
+    limits: z.ZodOptional<z.ZodObject<{
+        maxDepth: z.ZodOptional<z.ZodNumber>;
+        maxNodes: z.ZodOptional<z.ZodNumber>;
+        nodeCount: z.ZodOptional<z.ZodNumber>;
+        truncated: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        truncated?: boolean | undefined;
+        maxDepth?: number | undefined;
+        maxNodes?: number | undefined;
+        nodeCount?: number | undefined;
+    }, {
+        truncated?: boolean | undefined;
+        maxDepth?: number | undefined;
+        maxNodes?: number | undefined;
+        nodeCount?: number | undefined;
+    }>>;
+    driver: z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodEnum<["native", "remote", "mock"]>;
+        version: z.ZodString;
+        capabilities: z.ZodObject<{
+            canSnapshot: z.ZodBoolean;
+            canClick: z.ZodBoolean;
+            canType: z.ZodBoolean;
+            canScroll: z.ZodBoolean;
+            canKey: z.ZodBoolean;
+            canOcr: z.ZodBoolean;
+            canScreenshot: z.ZodBoolean;
+            canInjectInput: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            canSnapshot: boolean;
+            canClick: boolean;
+            canType: boolean;
+            canScroll: boolean;
+            canKey: boolean;
+            canOcr: boolean;
+            canScreenshot: boolean;
+            canInjectInput: boolean;
+        }, {
+            canSnapshot: boolean;
+            canClick: boolean;
+            canType: boolean;
+            canScroll: boolean;
+            canKey: boolean;
+            canOcr: boolean;
+            canScreenshot: boolean;
+            canInjectInput: boolean;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        version: string;
+        capabilities: {
+            canSnapshot: boolean;
+            canClick: boolean;
+            canType: boolean;
+            canScroll: boolean;
+            canKey: boolean;
+            canOcr: boolean;
+            canScreenshot: boolean;
+            canInjectInput: boolean;
+        };
+        kind: "native" | "remote" | "mock";
+    }, {
+        name: string;
+        version: string;
+        capabilities: {
+            canSnapshot: boolean;
+            canClick: boolean;
+            canType: boolean;
+            canScroll: boolean;
+            canKey: boolean;
+            canOcr: boolean;
+            canScreenshot: boolean;
+            canInjectInput: boolean;
+        };
+        kind: "native" | "remote" | "mock";
+    }>;
+}, "strip", z.ZodTypeAny, {
+    timestamp: string;
+    snapshotId: string;
+    activeApp: {
+        pid: number;
+        title: string;
+        bounds?: {
+            w: number;
+            x: number;
+            y: number;
+            h: number;
+        } | undefined;
+        appId?: string | undefined;
+        processName?: string | undefined;
+        windowHandle?: string | undefined;
+    };
+    driver: {
+        name: string;
+        version: string;
+        capabilities: {
+            canSnapshot: boolean;
+            canClick: boolean;
+            canType: boolean;
+            canScroll: boolean;
+            canKey: boolean;
+            canOcr: boolean;
+            canScreenshot: boolean;
+            canInjectInput: boolean;
+        };
+        kind: "native" | "remote" | "mock";
+    };
+    tree?: unknown;
+    textIndex?: {
+        text: string;
+        source: "structure" | "ocr";
+        confidence: number;
+        bounds: {
+            w: number;
+            x: number;
+            y: number;
+            h: number;
+        };
+    }[] | undefined;
+    screenshot?: {
+        encoding: "png" | "jpeg";
+        hash: string;
+        width: number;
+        height: number;
+    } | undefined;
+    limits?: {
+        truncated?: boolean | undefined;
+        maxDepth?: number | undefined;
+        maxNodes?: number | undefined;
+        nodeCount?: number | undefined;
+    } | undefined;
+}, {
+    timestamp: string;
+    snapshotId: string;
+    activeApp: {
+        pid: number;
+        title: string;
+        bounds?: {
+            w: number;
+            x: number;
+            y: number;
+            h: number;
+        } | undefined;
+        appId?: string | undefined;
+        processName?: string | undefined;
+        windowHandle?: string | undefined;
+    };
+    driver: {
+        name: string;
+        version: string;
+        capabilities: {
+            canSnapshot: boolean;
+            canClick: boolean;
+            canType: boolean;
+            canScroll: boolean;
+            canKey: boolean;
+            canOcr: boolean;
+            canScreenshot: boolean;
+            canInjectInput: boolean;
+        };
+        kind: "native" | "remote" | "mock";
+    };
+    tree?: unknown;
+    textIndex?: {
+        text: string;
+        source: "structure" | "ocr";
+        confidence: number;
+        bounds: {
+            w: number;
+            x: number;
+            y: number;
+            h: number;
+        };
+    }[] | undefined;
+    screenshot?: {
+        encoding: "png" | "jpeg";
+        hash: string;
+        width: number;
+        height: number;
+    } | undefined;
+    limits?: {
+        truncated?: boolean | undefined;
+        maxDepth?: number | undefined;
+        maxNodes?: number | undefined;
+        nodeCount?: number | undefined;
+    } | undefined;
+}>;
+export declare const UiSnapshotSchema: z.ZodObject<{
+    scope: z.ZodOptional<z.ZodEnum<["screen", "window"]>>;
+    windowId: z.ZodOptional<z.ZodString>;
+    includeTree: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    includeScreenshot: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    includeTextIndex: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    maxDepth: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    maxNodes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    maxDepth: number;
+    maxNodes: number;
+    includeTree: boolean;
+    includeScreenshot: boolean;
+    includeTextIndex: boolean;
+    scope?: "screen" | "window" | undefined;
+    windowId?: string | undefined;
+}, {
+    scope?: "screen" | "window" | undefined;
+    maxDepth?: number | undefined;
+    maxNodes?: number | undefined;
+    windowId?: string | undefined;
+    includeTree?: boolean | undefined;
+    includeScreenshot?: boolean | undefined;
+    includeTextIndex?: boolean | undefined;
+}>;
+export declare const UiQuerySchema: z.ZodObject<{
+    selector: z.ZodString;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    selector: string;
+    limit: number;
+    timeoutMs?: number | undefined;
+}, {
+    selector: string;
+    limit?: number | undefined;
+    timeoutMs?: number | undefined;
+}>;
+export declare const UiDescribeSchema: z.ZodObject<{
+    target: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    target: string;
+}, {
+    target: string;
+}>;
+export declare const UiClickSchema: z.ZodObject<{
+    target: z.ZodString;
+    button: z.ZodDefault<z.ZodOptional<z.ZodEnum<["left", "right", "middle"]>>>;
+    clickCount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    modifiers: z.ZodOptional<z.ZodArray<z.ZodEnum<["ctrl", "alt", "shift", "meta"]>, "many">>;
+    verify: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    target: string;
+    button: "left" | "right" | "middle";
+    clickCount: number;
+    verify: boolean;
+    modifiers?: ("shift" | "ctrl" | "alt" | "meta")[] | undefined;
+}, {
+    target: string;
+    button?: "left" | "right" | "middle" | undefined;
+    clickCount?: number | undefined;
+    modifiers?: ("shift" | "ctrl" | "alt" | "meta")[] | undefined;
+    verify?: boolean | undefined;
+}>;
+export declare const UiTypeSchema: z.ZodObject<{
+    text: z.ZodString;
+    target: z.ZodOptional<z.ZodString>;
+    mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["insert", "replace", "append"]>>>;
+    redactInLogs: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    verify: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    mode: "replace" | "append" | "insert";
+    text: string;
+    verify: boolean;
+    redactInLogs: boolean;
+    target?: string | undefined;
+}, {
+    text: string;
+    mode?: "replace" | "append" | "insert" | undefined;
+    target?: string | undefined;
+    verify?: boolean | undefined;
+    redactInLogs?: boolean | undefined;
+}>;
+export declare const UiKeySchema: z.ZodObject<{
+    keys: z.ZodArray<z.ZodString, "many">;
+    target: z.ZodOptional<z.ZodString>;
+    verify: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    keys: string[];
+    verify: boolean;
+    target?: string | undefined;
+}, {
+    keys: string[];
+    target?: string | undefined;
+    verify?: boolean | undefined;
+}>;
+export declare const UiScrollSchema: z.ZodObject<{
+    target: z.ZodOptional<z.ZodString>;
+    deltaX: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    deltaY: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    verify: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    verify: boolean;
+    deltaX: number;
+    deltaY: number;
+    target?: string | undefined;
+}, {
+    target?: string | undefined;
+    verify?: boolean | undefined;
+    deltaX?: number | undefined;
+    deltaY?: number | undefined;
+}>;
+export declare const UiFocusSchema: z.ZodObject<{
+    target: z.ZodString;
+    verify: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    target: string;
+    verify: boolean;
+}, {
+    target: string;
+    verify?: boolean | undefined;
+}>;
+export declare const UiWaitSchema: z.ZodObject<{
+    selector: z.ZodString;
+    state: z.ZodDefault<z.ZodOptional<z.ZodEnum<["visible", "hidden", "exists", "removed"]>>>;
+    timeoutMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    intervalMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    state: "removed" | "visible" | "hidden" | "exists";
+    selector: string;
+    timeoutMs: number;
+    intervalMs: number;
+}, {
+    selector: string;
+    state?: "removed" | "visible" | "hidden" | "exists" | undefined;
+    timeoutMs?: number | undefined;
+    intervalMs?: number | undefined;
+}>;
+export declare const UiAssertSchema: z.ZodObject<{
+    target: z.ZodString;
+    assertion: z.ZodEnum<["exists", "not_exists", "contains_text", "equals_text"]>;
+    value: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    target: string;
+    assertion: "exists" | "not_exists" | "contains_text" | "equals_text";
+    value?: string | undefined;
+}, {
+    target: string;
+    assertion: "exists" | "not_exists" | "contains_text" | "equals_text";
+    value?: string | undefined;
+}>;
+export declare const UiClickXySchema: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    coordinateSpace: z.ZodDefault<z.ZodOptional<z.ZodEnum<["screen", "window"]>>>;
+    verify: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    x: number;
+    y: number;
+    verify: boolean;
+    coordinateSpace: "screen" | "window";
+}, {
+    x: number;
+    y: number;
+    verify?: boolean | undefined;
+    coordinateSpace?: "screen" | "window" | undefined;
+}>;
+export type UiSnapshotArgs = z.infer<typeof UiSnapshotSchema>;
+export type UiQueryArgs = z.infer<typeof UiQuerySchema>;
+export type UiClickArgs = z.infer<typeof UiClickSchema>;
+export type UiTypeArgs = z.infer<typeof UiTypeSchema>;
+export type UiKeyArgs = z.infer<typeof UiKeySchema>;
+export type UiScrollArgs = z.infer<typeof UiScrollSchema>;
+export type UiFocusArgs = z.infer<typeof UiFocusSchema>;
+export type UiWaitArgs = z.infer<typeof UiWaitSchema>;
+export type UiAssertArgs = z.infer<typeof UiAssertSchema>;
+export type UiDescribeArgs = z.infer<typeof UiDescribeSchema>;
+export type UiClickXyArgs = z.infer<typeof UiClickXySchema>;
+export declare const UiActionResultSchema: z.ZodObject<{
+    status: z.ZodEnum<["success", "error"]>;
+    driver: z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodEnum<["native", "remote", "mock"]>;
+        version: z.ZodString;
+        capabilities: z.ZodObject<{
+            canSnapshot: z.ZodBoolean;
+            canClick: z.ZodBoolean;
+            canType: z.ZodBoolean;
+            canScroll: z.ZodBoolean;
+            canKey: z.ZodBoolean;
+            canOcr: z.ZodBoolean;
+            canScreenshot: z.ZodBoolean;
+            canInjectInput: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            canSnapshot: boolean;
+            canClick: boolean;
+            canType: boolean;
+            canScroll: boolean;
+            canKey: boolean;
+            canOcr: boolean;
+            canScreenshot: boolean;
+            canInjectInput: boolean;
+        }, {
+            canSnapshot: boolean;
+            canClick: boolean;
+            canType: boolean;
+            canScroll: boolean;
+            canKey: boolean;
+            canOcr: boolean;
+            canScreenshot: boolean;
+            canInjectInput: boolean;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        version: string;
+        capabilities: {
+            canSnapshot: boolean;
+            canClick: boolean;
+            canType: boolean;
+            canScroll: boolean;
+            canKey: boolean;
+            canOcr: boolean;
+            canScreenshot: boolean;
+            canInjectInput: boolean;
+        };
+        kind: "native" | "remote" | "mock";
+    }, {
+        name: string;
+        version: string;
+        capabilities: {
+            canSnapshot: boolean;
+            canClick: boolean;
+            canType: boolean;
+            canScroll: boolean;
+            canKey: boolean;
+            canOcr: boolean;
+            canScreenshot: boolean;
+            canInjectInput: boolean;
+        };
+        kind: "native" | "remote" | "mock";
+    }>;
+    message: z.ZodOptional<z.ZodString>;
+    resolvedTarget: z.ZodOptional<z.ZodObject<{
+        elementId: z.ZodString;
+        bounds: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            w: z.ZodNumber;
+            h: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            w: number;
+            x: number;
+            y: number;
+            h: number;
+        }, {
+            w: number;
+            x: number;
+            y: number;
+            h: number;
+        }>>;
+        role: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        confidence: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        role: string;
+        confidence: number;
+        elementId: string;
+        name?: string | undefined;
+        bounds?: {
+            w: number;
+            x: number;
+            y: number;
+            h: number;
+        } | undefined;
+    }, {
+        role: string;
+        confidence: number;
+        elementId: string;
+        name?: string | undefined;
+        bounds?: {
+            w: number;
+            x: number;
+            y: number;
+            h: number;
+        } | undefined;
+    }>>;
+    evidence: z.ZodOptional<z.ZodObject<{
+        snapshotId: z.ZodString;
+        screenshotHash: z.ZodOptional<z.ZodString>;
+        cropHash: z.ZodOptional<z.ZodString>;
+        redactions: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        snapshotId: string;
+        redactions?: boolean | undefined;
+        screenshotHash?: string | undefined;
+        cropHash?: string | undefined;
+    }, {
+        snapshotId: string;
+        redactions?: boolean | undefined;
+        screenshotHash?: string | undefined;
+        cropHash?: string | undefined;
+    }>>;
+    verification: z.ZodOptional<z.ZodObject<{
+        passed: z.ZodBoolean;
+        details: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        details: string;
+        passed: boolean;
+    }, {
+        details: string;
+        passed: boolean;
+    }>>;
+    data: z.ZodOptional<z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    status: "error" | "success";
+    driver: {
+        name: string;
+        version: string;
+        capabilities: {
+            canSnapshot: boolean;
+            canClick: boolean;
+            canType: boolean;
+            canScroll: boolean;
+            canKey: boolean;
+            canOcr: boolean;
+            canScreenshot: boolean;
+            canInjectInput: boolean;
+        };
+        kind: "native" | "remote" | "mock";
+    };
+    message?: string | undefined;
+    data?: unknown;
+    resolvedTarget?: {
+        role: string;
+        confidence: number;
+        elementId: string;
+        name?: string | undefined;
+        bounds?: {
+            w: number;
+            x: number;
+            y: number;
+            h: number;
+        } | undefined;
+    } | undefined;
+    evidence?: {
+        snapshotId: string;
+        redactions?: boolean | undefined;
+        screenshotHash?: string | undefined;
+        cropHash?: string | undefined;
+    } | undefined;
+    verification?: {
+        details: string;
+        passed: boolean;
+    } | undefined;
+}, {
+    status: "error" | "success";
+    driver: {
+        name: string;
+        version: string;
+        capabilities: {
+            canSnapshot: boolean;
+            canClick: boolean;
+            canType: boolean;
+            canScroll: boolean;
+            canKey: boolean;
+            canOcr: boolean;
+            canScreenshot: boolean;
+            canInjectInput: boolean;
+        };
+        kind: "native" | "remote" | "mock";
+    };
+    message?: string | undefined;
+    data?: unknown;
+    resolvedTarget?: {
+        role: string;
+        confidence: number;
+        elementId: string;
+        name?: string | undefined;
+        bounds?: {
+            w: number;
+            x: number;
+            y: number;
+            h: number;
+        } | undefined;
+    } | undefined;
+    evidence?: {
+        snapshotId: string;
+        redactions?: boolean | undefined;
+        screenshotHash?: string | undefined;
+        cropHash?: string | undefined;
+    } | undefined;
+    verification?: {
+        details: string;
+        passed: boolean;
+    } | undefined;
+}>;
+export declare const UiDiagnoseSchema: z.ZodObject<{
+    depth: z.ZodOptional<z.ZodNumber>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    sampleLimit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    timeoutMs?: number | undefined;
+    depth?: number | undefined;
+    sampleLimit?: number | undefined;
+}, {
+    timeoutMs?: number | undefined;
+    depth?: number | undefined;
+    sampleLimit?: number | undefined;
+}>;
+export declare const UiDiagnosticsReportSchema: z.ZodObject<{
+    driver: z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodEnum<["native", "remote", "mock"]>;
+        version: z.ZodString;
+        capabilities: z.ZodObject<{
+            canSnapshot: z.ZodBoolean;
+            canClick: z.ZodBoolean;
+            canType: z.ZodBoolean;
+            canScroll: z.ZodBoolean;
+            canKey: z.ZodBoolean;
+            canOcr: z.ZodBoolean;
+            canScreenshot: z.ZodBoolean;
+            canInjectInput: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            canSnapshot: boolean;
+            canClick: boolean;
+            canType: boolean;
+            canScroll: boolean;
+            canKey: boolean;
+            canOcr: boolean;
+            canScreenshot: boolean;
+            canInjectInput: boolean;
+        }, {
+            canSnapshot: boolean;
+            canClick: boolean;
+            canType: boolean;
+            canScroll: boolean;
+            canKey: boolean;
+            canOcr: boolean;
+            canScreenshot: boolean;
+            canInjectInput: boolean;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        version: string;
+        capabilities: {
+            canSnapshot: boolean;
+            canClick: boolean;
+            canType: boolean;
+            canScroll: boolean;
+            canKey: boolean;
+            canOcr: boolean;
+            canScreenshot: boolean;
+            canInjectInput: boolean;
+        };
+        kind: "native" | "remote" | "mock";
+    }, {
+        name: string;
+        version: string;
+        capabilities: {
+            canSnapshot: boolean;
+            canClick: boolean;
+            canType: boolean;
+            canScroll: boolean;
+            canKey: boolean;
+            canOcr: boolean;
+            canScreenshot: boolean;
+            canInjectInput: boolean;
+        };
+        kind: "native" | "remote" | "mock";
+    }>;
+    connection: z.ZodObject<{
+        connected: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        connected: boolean;
+        error?: string | undefined;
+    }, {
+        connected: boolean;
+        error?: string | undefined;
+    }>;
+    snapshotSanity: z.ZodObject<{
+        desktopRootChildren: z.ZodNumber;
+        applicationNamesSample: z.ZodArray<z.ZodString, "many">;
+        activeAppTitle: z.ZodString;
+        activeAppId: z.ZodOptional<z.ZodString>;
+        notes: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        desktopRootChildren: number;
+        applicationNamesSample: string[];
+        activeAppTitle: string;
+        notes: string[];
+        activeAppId?: string | undefined;
+    }, {
+        desktopRootChildren: number;
+        applicationNamesSample: string[];
+        activeAppTitle: string;
+        notes: string[];
+        activeAppId?: string | undefined;
+    }>;
+    warnings: z.ZodArray<z.ZodString, "many">;
+    suggestedFixes: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    connection: {
+        connected: boolean;
+        error?: string | undefined;
+    };
+    driver: {
+        name: string;
+        version: string;
+        capabilities: {
+            canSnapshot: boolean;
+            canClick: boolean;
+            canType: boolean;
+            canScroll: boolean;
+            canKey: boolean;
+            canOcr: boolean;
+            canScreenshot: boolean;
+            canInjectInput: boolean;
+        };
+        kind: "native" | "remote" | "mock";
+    };
+    snapshotSanity: {
+        desktopRootChildren: number;
+        applicationNamesSample: string[];
+        activeAppTitle: string;
+        notes: string[];
+        activeAppId?: string | undefined;
+    };
+    warnings: string[];
+    suggestedFixes: string[];
+}, {
+    connection: {
+        connected: boolean;
+        error?: string | undefined;
+    };
+    driver: {
+        name: string;
+        version: string;
+        capabilities: {
+            canSnapshot: boolean;
+            canClick: boolean;
+            canType: boolean;
+            canScroll: boolean;
+            canKey: boolean;
+            canOcr: boolean;
+            canScreenshot: boolean;
+            canInjectInput: boolean;
+        };
+        kind: "native" | "remote" | "mock";
+    };
+    snapshotSanity: {
+        desktopRootChildren: number;
+        applicationNamesSample: string[];
+        activeAppTitle: string;
+        notes: string[];
+        activeAppId?: string | undefined;
+    };
+    warnings: string[];
+    suggestedFixes: string[];
+}>;
+export type UiDiagnoseArgs = z.infer<typeof UiDiagnoseSchema>;