@nativemason/contracts 0.0.0-stage → 0.3.0

package/dist/diagnostics.d.ts

@@ -0,0 +1,580 @@
+import { z } from 'zod';
+/** Browser trials across explicit device profiles; native acceptance remains separate. */
+export declare const SuggestionProfileSchema: z.ZodObject<{
+    id: z.ZodString;
+    profile: z.ZodObject<{
+        window: z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strict>;
+        pixelRatio: z.ZodNumber;
+        fontScale: z.ZodNumber;
+        insets: z.ZodObject<{
+            top: z.ZodNumber;
+            right: z.ZodNumber;
+            bottom: z.ZodNumber;
+            left: z.ZodNumber;
+        }, z.core.$strict>;
+        root: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strict>;
+        orientation: z.ZodEnum<{
+            portrait: "portrait";
+            landscape: "landscape";
+        }>;
+    }, z.core.$strict>;
+    script: z.ZodOptional<z.ZodObject<{
+        scenarioId: z.ZodString;
+        reset: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"navigate">;
+            url: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"tap">;
+            elementId: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"press">;
+            elementId: z.ZodString;
+            phase: z.ZodEnum<{
+                down: "down";
+                up: "up";
+            }>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"input">;
+            elementId: z.ZodString;
+            text: z.ZodString;
+            mode: z.ZodDefault<z.ZodEnum<{
+                replace: "replace";
+                append: "append";
+            }>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"swipe">;
+            elementId: z.ZodString;
+            direction: z.ZodEnum<{
+                UP: "UP";
+                DOWN: "DOWN";
+                LEFT: "LEFT";
+                RIGHT: "RIGHT";
+            }>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"scroll">;
+            elementId: z.ZodString;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"keyboard">;
+            visible: z.ZodBoolean;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"wait">;
+            elementId: z.ZodString;
+            timeoutMs: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"hook">;
+            name: z.ZodString;
+            value: z.ZodOptional<z.ZodUnknown>;
+        }, z.core.$strip>], "type">>;
+        actions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"navigate">;
+            url: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"tap">;
+            elementId: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"press">;
+            elementId: z.ZodString;
+            phase: z.ZodEnum<{
+                down: "down";
+                up: "up";
+            }>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"input">;
+            elementId: z.ZodString;
+            text: z.ZodString;
+            mode: z.ZodDefault<z.ZodEnum<{
+                replace: "replace";
+                append: "append";
+            }>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"swipe">;
+            elementId: z.ZodString;
+            direction: z.ZodEnum<{
+                UP: "UP";
+                DOWN: "DOWN";
+                LEFT: "LEFT";
+                RIGHT: "RIGHT";
+            }>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"scroll">;
+            elementId: z.ZodString;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"keyboard">;
+            visible: z.ZodBoolean;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"wait">;
+            elementId: z.ZodString;
+            timeoutMs: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"hook">;
+            name: z.ZodString;
+            value: z.ZodOptional<z.ZodUnknown>;
+        }, z.core.$strip>], "type">>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type SuggestionProfile = z.infer<typeof SuggestionProfileSchema>;
+export declare const SuggestionProfilesSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    profile: z.ZodObject<{
+        window: z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strict>;
+        pixelRatio: z.ZodNumber;
+        fontScale: z.ZodNumber;
+        insets: z.ZodObject<{
+            top: z.ZodNumber;
+            right: z.ZodNumber;
+            bottom: z.ZodNumber;
+            left: z.ZodNumber;
+        }, z.core.$strict>;
+        root: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strict>;
+        orientation: z.ZodEnum<{
+            portrait: "portrait";
+            landscape: "landscape";
+        }>;
+    }, z.core.$strict>;
+    script: z.ZodOptional<z.ZodObject<{
+        scenarioId: z.ZodString;
+        reset: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"navigate">;
+            url: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"tap">;
+            elementId: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"press">;
+            elementId: z.ZodString;
+            phase: z.ZodEnum<{
+                down: "down";
+                up: "up";
+            }>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"input">;
+            elementId: z.ZodString;
+            text: z.ZodString;
+            mode: z.ZodDefault<z.ZodEnum<{
+                replace: "replace";
+                append: "append";
+            }>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"swipe">;
+            elementId: z.ZodString;
+            direction: z.ZodEnum<{
+                UP: "UP";
+                DOWN: "DOWN";
+                LEFT: "LEFT";
+                RIGHT: "RIGHT";
+            }>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"scroll">;
+            elementId: z.ZodString;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"keyboard">;
+            visible: z.ZodBoolean;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"wait">;
+            elementId: z.ZodString;
+            timeoutMs: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"hook">;
+            name: z.ZodString;
+            value: z.ZodOptional<z.ZodUnknown>;
+        }, z.core.$strip>], "type">>;
+        actions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"navigate">;
+            url: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"tap">;
+            elementId: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"press">;
+            elementId: z.ZodString;
+            phase: z.ZodEnum<{
+                down: "down";
+                up: "up";
+            }>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"input">;
+            elementId: z.ZodString;
+            text: z.ZodString;
+            mode: z.ZodDefault<z.ZodEnum<{
+                replace: "replace";
+                append: "append";
+            }>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"swipe">;
+            elementId: z.ZodString;
+            direction: z.ZodEnum<{
+                UP: "UP";
+                DOWN: "DOWN";
+                LEFT: "LEFT";
+                RIGHT: "RIGHT";
+            }>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"scroll">;
+            elementId: z.ZodString;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"keyboard">;
+            visible: z.ZodBoolean;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"wait">;
+            elementId: z.ZodString;
+            timeoutMs: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"hook">;
+            name: z.ZodString;
+            value: z.ZodOptional<z.ZodUnknown>;
+        }, z.core.$strip>], "type">>;
+    }, z.core.$strict>>;
+}, z.core.$strict>>;
+export declare const SuggestionProfileEvidenceSchema: z.ZodObject<{
+    profileId: z.ZodString;
+    platform: z.ZodLiteral<"web">;
+    profile: z.ZodObject<{
+        window: z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strict>;
+        pixelRatio: z.ZodNumber;
+        fontScale: z.ZodNumber;
+        insets: z.ZodObject<{
+            top: z.ZodNumber;
+            right: z.ZodNumber;
+            bottom: z.ZodNumber;
+            left: z.ZodNumber;
+        }, z.core.$strict>;
+        root: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strict>;
+        orientation: z.ZodEnum<{
+            portrait: "portrait";
+            landscape: "landscape";
+        }>;
+    }, z.core.$strict>;
+    scenarioState: z.ZodOptional<z.ZodEnum<{
+        baseline: "baseline";
+        scripted: "scripted";
+        initial: "initial";
+    }>>;
+    status: z.ZodEnum<{
+        unavailable: "unavailable";
+        passed: "passed";
+        failed: "failed";
+        unsupported: "unsupported";
+    }>;
+    snapshotId: z.ZodOptional<z.ZodString>;
+    results: z.ZodArray<z.ZodObject<{
+        constraintId: z.ZodString;
+        status: z.ZodEnum<{
+            unavailable: "unavailable";
+            pass: "pass";
+            fail: "fail";
+        }>;
+        elementIds: z.ZodArray<z.ZodString>;
+        deviation: z.ZodNullable<z.ZodNumber>;
+        tolerance: z.ZodNumber;
+        message: z.ZodString;
+    }, z.core.$strict>>;
+    regressions: z.ZodNumber;
+    warnings: z.ZodNumber;
+    error: z.ZodOptional<z.ZodObject<{
+        code: z.ZodEnum<{
+            INVALID_INPUT: "INVALID_INPUT";
+            MISSING_ELEMENT: "MISSING_ELEMENT";
+            DUPLICATE_ELEMENT: "DUPLICATE_ELEMENT";
+            STALE_SNAPSHOT: "STALE_SNAPSHOT";
+            STALE_SOURCE: "STALE_SOURCE";
+            UNSUPPORTED_EDIT: "UNSUPPORTED_EDIT";
+            UNSUPPORTED_PROFILE: "UNSUPPORTED_PROFILE";
+            UNSTABLE_LAYOUT: "UNSTABLE_LAYOUT";
+            NATIVE_DISCONNECTED: "NATIVE_DISCONNECTED";
+            TIMEOUT: "TIMEOUT";
+            VERIFICATION_FAILED: "VERIFICATION_FAILED";
+            SESSION_NOT_FOUND: "SESSION_NOT_FOUND";
+            TRIAL_NOT_FOUND: "TRIAL_NOT_FOUND";
+            SOURCE_OUTSIDE_PROJECT: "SOURCE_OUTSIDE_PROJECT";
+            INTERNAL_ERROR: "INTERNAL_ERROR";
+            RECOVERY_CONFLICT: "RECOVERY_CONFLICT";
+            TRANSACTION_CONFLICT: "TRANSACTION_CONFLICT";
+            UNSUPPORTED_ACTION: "UNSUPPORTED_ACTION";
+            PROTOCOL_MISMATCH: "PROTOCOL_MISMATCH";
+        }>;
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type SuggestionProfileEvidence = z.infer<typeof SuggestionProfileEvidenceSchema>;
+/** Fresh native baseline seeds proposals only; candidates are still browser trials. */
+export declare const NativeSuggestionEvidenceSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        unavailable: "unavailable";
+        unsupported: "unsupported";
+        captured: "captured";
+    }>;
+    snapshot: z.ZodOptional<z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        sessionId: z.ZodString;
+        snapshotId: z.ZodString;
+        platform: z.ZodEnum<{
+            web: "web";
+            android: "android";
+            ios: "ios";
+        }>;
+        scenarioId: z.ZodString;
+        profile: z.ZodObject<{
+            window: z.ZodObject<{
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strict>;
+            pixelRatio: z.ZodNumber;
+            fontScale: z.ZodNumber;
+            insets: z.ZodObject<{
+                top: z.ZodNumber;
+                right: z.ZodNumber;
+                bottom: z.ZodNumber;
+                left: z.ZodNumber;
+            }, z.core.$strict>;
+            root: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strict>;
+            orientation: z.ZodEnum<{
+                portrait: "portrait";
+                landscape: "landscape";
+            }>;
+        }, z.core.$strict>;
+        revisions: z.ZodRecord<z.ZodString, z.ZodString>;
+        nodes: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            parentId: z.ZodNullable<z.ZodString>;
+            kind: z.ZodEnum<{
+                View: "View";
+                Text: "Text";
+                Pressable: "Pressable";
+                TextInput: "TextInput";
+                ScrollView: "ScrollView";
+                Image: "Image";
+            }>;
+            role: z.ZodNullable<z.ZodString>;
+            rect: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strict>;
+            styles: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            source: z.ZodNullable<z.ZodObject<{
+                path: z.ZodString;
+                styleForm: z.ZodOptional<z.ZodLiteral<"pressable-state">>;
+                dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                hash: z.ZodString;
+                start: z.ZodNumber;
+                end: z.ZodNumber;
+                line: z.ZodNumber;
+                column: z.ZodNumber;
+            }, z.core.$strict>>;
+            editable: z.ZodBoolean;
+            editReason: z.ZodNullable<z.ZodString>;
+            pressableState: z.ZodOptional<z.ZodEnum<{
+                pressed: "pressed";
+                rest: "rest";
+            }>>;
+            accessibility: z.ZodOptional<z.ZodObject<{
+                authoredLabel: z.ZodOptional<z.ZodString>;
+                authoredHint: z.ZodOptional<z.ZodString>;
+                accessible: z.ZodOptional<z.ZodBoolean>;
+                focusable: z.ZodOptional<z.ZodBoolean>;
+                hidden: z.ZodOptional<z.ZodBoolean>;
+                disabled: z.ZodOptional<z.ZodBoolean>;
+                direction: z.ZodEnum<{
+                    unknown: "unknown";
+                    ltr: "ltr";
+                    rtl: "rtl";
+                }>;
+                directionSource: z.ZodOptional<z.ZodEnum<{
+                    unknown: "unknown";
+                    authored: "authored";
+                    "native-global": "native-global";
+                    "browser-computed": "browser-computed";
+                }>>;
+                browser: z.ZodOptional<z.ZodObject<{
+                    name: z.ZodNullable<z.ZodString>;
+                    focusOrder: z.ZodNullable<z.ZodNumber>;
+                    focusOrderSource: z.ZodLiteral<"dom-sequential-estimate">;
+                    contrast: z.ZodObject<{
+                        status: z.ZodEnum<{
+                            measured: "measured";
+                            unavailable: "unavailable";
+                        }>;
+                        ratio: z.ZodOptional<z.ZodNumber>;
+                        requiredRatio: z.ZodOptional<z.ZodNumber>;
+                        reason: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>>;
+            textFit: z.ZodOptional<z.ZodObject<{
+                status: z.ZodEnum<{
+                    unavailable: "unavailable";
+                    supported: "supported";
+                }>;
+                fullLineCount: z.ZodOptional<z.ZodNumber>;
+                limitedLineCount: z.ZodOptional<z.ZodNumber>;
+                fullHeight: z.ZodOptional<z.ZodNumber>;
+                availableHeight: z.ZodOptional<z.ZodNumber>;
+                reason: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+            authoredTextProps: z.ZodOptional<z.ZodObject<{
+                fontSize: z.ZodOptional<z.ZodNumber>;
+                lineHeight: z.ZodOptional<z.ZodNumber>;
+                numberOfLines: z.ZodOptional<z.ZodNumber>;
+                allowFontScaling: z.ZodOptional<z.ZodBoolean>;
+                ellipsizeMode: z.ZodOptional<z.ZodEnum<{
+                    head: "head";
+                    middle: "middle";
+                    tail: "tail";
+                    clip: "clip";
+                }>>;
+            }, z.core.$strict>>;
+            measuredLineCount: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        status: z.ZodEnum<{
+            stable: "stable";
+            unstable: "unstable";
+        }>;
+        generation: z.ZodNumber;
+        nativeTarget: z.ZodOptional<z.ZodObject<{
+            targetId: z.ZodString;
+            platform: z.ZodEnum<{
+                android: "android";
+                ios: "ios";
+            }>;
+            kind: z.ZodEnum<{
+                physical: "physical";
+                emulator: "emulator";
+                simulator: "simulator";
+            }>;
+        }, z.core.$strict>>;
+        webDiagnostics: z.ZodOptional<z.ZodObject<{
+            nodes: z.ZodRecord<z.ZodString, z.ZodObject<{
+                clipping: z.ZodEnum<{
+                    unknown: "unknown";
+                    confirmed: "confirmed";
+                    clear: "clear";
+                }>;
+                centerHitTest: z.ZodEnum<{
+                    unknown: "unknown";
+                    confirmed: "confirmed";
+                    clear: "clear";
+                }>;
+                scrollOverflow: z.ZodObject<{
+                    horizontal: z.ZodBoolean;
+                    vertical: z.ZodBoolean;
+                }, z.core.$strict>;
+                paintOrder: z.ZodNullable<z.ZodNumber>;
+                fonts: z.ZodArray<z.ZodObject<{
+                    family: z.ZodString;
+                    glyphCount: z.ZodNumber;
+                    isCustom: z.ZodNullable<z.ZodBoolean>;
+                }, z.core.$strict>>;
+                lineBoxCount: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strict>>;
+            warnings: z.ZodArray<z.ZodObject<{
+                elementId: z.ZodString;
+                code: z.ZodEnum<{
+                    CLIPPED: "CLIPPED";
+                    OCCLUDED: "OCCLUDED";
+                    FONT_LOAD_FAILED: "FONT_LOAD_FAILED";
+                    EVIDENCE_UNAVAILABLE: "EVIDENCE_UNAVAILABLE";
+                }>;
+                severity: z.ZodEnum<{
+                    confirmed: "confirmed";
+                    uncertain: "uncertain";
+                }>;
+                message: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    results: z.ZodArray<z.ZodObject<{
+        constraintId: z.ZodString;
+        status: z.ZodEnum<{
+            unavailable: "unavailable";
+            pass: "pass";
+            fail: "fail";
+        }>;
+        elementIds: z.ZodArray<z.ZodString>;
+        deviation: z.ZodNullable<z.ZodNumber>;
+        tolerance: z.ZodNumber;
+        message: z.ZodString;
+    }, z.core.$strict>>;
+    error: z.ZodOptional<z.ZodObject<{
+        code: z.ZodEnum<{
+            INVALID_INPUT: "INVALID_INPUT";
+            MISSING_ELEMENT: "MISSING_ELEMENT";
+            DUPLICATE_ELEMENT: "DUPLICATE_ELEMENT";
+            STALE_SNAPSHOT: "STALE_SNAPSHOT";
+            STALE_SOURCE: "STALE_SOURCE";
+            UNSUPPORTED_EDIT: "UNSUPPORTED_EDIT";
+            UNSUPPORTED_PROFILE: "UNSUPPORTED_PROFILE";
+            UNSTABLE_LAYOUT: "UNSTABLE_LAYOUT";
+            NATIVE_DISCONNECTED: "NATIVE_DISCONNECTED";
+            TIMEOUT: "TIMEOUT";
+            VERIFICATION_FAILED: "VERIFICATION_FAILED";
+            SESSION_NOT_FOUND: "SESSION_NOT_FOUND";
+            TRIAL_NOT_FOUND: "TRIAL_NOT_FOUND";
+            SOURCE_OUTSIDE_PROJECT: "SOURCE_OUTSIDE_PROJECT";
+            INTERNAL_ERROR: "INTERNAL_ERROR";
+            RECOVERY_CONFLICT: "RECOVERY_CONFLICT";
+            TRANSACTION_CONFLICT: "TRANSACTION_CONFLICT";
+            UNSUPPORTED_ACTION: "UNSUPPORTED_ACTION";
+            PROTOCOL_MISMATCH: "PROTOCOL_MISMATCH";
+        }>;
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type NativeSuggestionEvidence = z.infer<typeof NativeSuggestionEvidenceSchema>;
+/** Required callback interaction evidence, checked again after reload and on native. */
+export declare const InteractionRequirementSchema: z.ZodObject<{
+    elementId: z.ZodString;
+    pressed: z.ZodBoolean;
+}, z.core.$strict>;
+export type InteractionRequirement = z.infer<typeof InteractionRequirementSchema>;
+/** Bounded native-driver failure output; a failed process is never acceptance evidence. */
+export declare const NativeScenarioFailureEvidenceSchema: z.ZodObject<{
+    driver: z.ZodLiteral<"maestro">;
+    message: z.ZodString;
+    exitCode: z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodNull]>;
+    signal: z.ZodNullable<z.ZodString>;
+    terminated: z.ZodBoolean;
+    stdout: z.ZodString;
+    stderr: z.ZodString;
+    outputTruncated: z.ZodBoolean;
+}, z.core.$strict>;
+export type NativeScenarioFailureEvidence = z.infer<typeof NativeScenarioFailureEvidenceSchema>;

package/dist/diagnostics.js

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+import { DeviceProfileSchema } from './geometry.js';
+import { ConstraintResultSchema } from './constraints.js';
+import { BridgeErrorSchema } from './source.js';
+import { SpatialSnapshotSchema } from './graph.js';
+import { ScenarioScriptSchema } from './workflow.js';
+/** Browser trials across explicit device profiles; native acceptance remains separate. */
+export const SuggestionProfileSchema = z.object({ id: z.string().min(1), profile: DeviceProfileSchema, script: ScenarioScriptSchema.optional() }).strict();
+export const SuggestionProfilesSchema = z.array(SuggestionProfileSchema).min(1).max(6).refine(profiles => new Set(profiles.map(profile => profile.id)).size === profiles.length && !profiles.some(profile => profile.id === 'baseline'), 'Profile IDs must be unique; baseline is reserved');
+export const SuggestionProfileEvidenceSchema = z.object({
+    profileId: z.string(), platform: z.literal('web'), profile: DeviceProfileSchema, scenarioState: z.enum(['baseline', 'scripted', 'initial']).optional(),
+    status: z.enum(['passed', 'failed', 'unsupported', 'unavailable']),
+    snapshotId: z.string().optional(), results: z.array(ConstraintResultSchema),
+    regressions: z.number().int().nonnegative(), warnings: z.number().int().nonnegative(),
+    error: BridgeErrorSchema.optional(),
+}).strict();
+/** Fresh native baseline seeds proposals only; candidates are still browser trials. */
+export const NativeSuggestionEvidenceSchema = z.object({
+    status: z.enum(['captured', 'unsupported', 'unavailable']), snapshot: SpatialSnapshotSchema.optional(),
+    results: z.array(ConstraintResultSchema), error: BridgeErrorSchema.optional(),
+}).strict().superRefine((value, ctx) => {
+    if (value.status === 'captured' && (!value.snapshot || value.snapshot.platform === 'web'))
+        ctx.addIssue({ code: 'custom', message: 'Captured native evidence requires a native snapshot' });
+    if (value.status !== 'captured' && value.snapshot)
+        ctx.addIssue({ code: 'custom', message: 'Unavailable native evidence cannot contain a snapshot' });
+});
+/** Required callback interaction evidence, checked again after reload and on native. */
+export const InteractionRequirementSchema = z.object({ elementId: z.string().min(1), pressed: z.boolean() }).strict();
+/** Bounded native-driver failure output; a failed process is never acceptance evidence. */
+export const NativeScenarioFailureEvidenceSchema = z.object({
+    driver: z.literal('maestro'), message: z.string().max(2048),
+    exitCode: z.union([z.number().int(), z.string().min(1).max(64), z.null()]),
+    signal: z.string().max(64).nullable(), terminated: z.boolean(),
+    stdout: z.string().max(16384), stderr: z.string().max(16384), outputTruncated: z.boolean(),
+}).strict();