/**
 * The view channel's contract: what a compiled screen looks like on its way to a
 * slot.
 *
 * Before this, the channel carried `UIPayload` — `{ formatVersion: string;
 * [key: string]: unknown }`, an open bag whose seven real fields were read by
 * inline cast at each consumer. A deployed host frontend had nothing to hold us
 * to. This declares the fields, and versions them: renderers dispatch on
 * `formatVersion`, an unregistered tag is a contained failure, additive fields are
 * fine, and a changed or removed field means a NEW tag.
 *
 * Two laws are in the shape itself:
 *
 * 1. **No data.** A description says what to fetch (`queries`), never what came
 *    back. The slot asks for its own values, as the viewer, through the one
 *    guarded query path. `data` on this channel would be a server deciding what a
 *    viewer may see at paint time instead of at ask time, so the schema refuses
 *    the key outright rather than merely omitting it.
 * 2. **No islands.** `components`/`componentTools` are not part of this contract.
 *    Legacy island apps keep flowing through the open payload shape they always
 *    did; nothing new enters through here.
 */
import { z } from "zod";
import { type TreeNode } from "@vendoai/core";
import { type TreeQuery } from "./tree.js";
/**
 * The view channel's version tag — the SAME tag the tree format already carries,
 * named once so there is one literal and one thing to bump. A second constant
 * with the same value would be two versions of one version.
 */
export declare const VENDO_SCREEN_FORMAT: "vendo-genui/v2";
/**
 * One drifted pin as it rides a description. The full shape belongs to
 * `@vendoai/apps` (`PinDrift`, which core may not import); declared here as the
 * part the channel promises, and passthrough so the rest travels intact.
 */
export interface ScreenSeedDrift {
    slot: string;
    component: string;
}
/** The described screen, as the view channel carries it. */
export interface ScreenDescription {
    formatVersion: typeof VENDO_SCREEN_FORMAT;
    root: string;
    nodes: TreeNode[];
    /** WHAT to fetch — never the results. */
    queries?: TreeQuery[];
    /** Still forming. MUST flip false on the final paint — while it is true the
     *  renderer holds the skeleton and never reaches a verdict. */
    streaming?: boolean;
    /** A query FAILED. Distinct from "empty": every unresolved binding renders "—",
     *  so without this a failed load is indistinguishable from "you have nothing". */
    dataUnavailable?: boolean;
    /** Inline in the conversation, or on the staging surface. The STARTING
     *  posture only — inline keeps Expand, staged keeps Back-to-chat, so a wrong
     *  hint costs one tap. */
    display?: "inline" | "stage";
    /** Legacy in-client verdict field. In-client native execution is gone and no
     *  verdict is authored anymore, but the field stays in the schema so the server
     *  keeps STRIPPING any forged one (`stripServerAuthoritativeFields`) — a client
     *  still carrying the executor must never be handed a `granted`. */
    inClient?: {
        granted: boolean;
        versionHash: string;
    };
    pinDrift?: ScreenSeedDrift[];
}
/**
 * Structural gate for the view channel, in the types+zod pairing convention.
 *
 * Passthrough, like every core schema, so an additive field and a legacy island
 * app's extra keys both travel — with ONE exception: `data` is refused. That is
 * the field this contract exists to keep off the channel, so a passthrough that
 * let it slide would make the law unenforceable.
 */
export declare const screenDescriptionSchema: z.ZodObject<{
    formatVersion: z.ZodLiteral<"vendo-genui/v2">;
    root: z.ZodString;
    nodes: z.ZodArray<z.ZodObject<{
        id: z.ZodString;
        component: z.ZodString;
        source: z.ZodOptional<z.ZodEnum<["prewired", "host", "generated", "ported"]>>;
        props: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
        children: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
        id: z.ZodString;
        component: z.ZodString;
        source: z.ZodOptional<z.ZodEnum<["prewired", "host", "generated", "ported"]>>;
        props: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
        children: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
        id: z.ZodString;
        component: z.ZodString;
        source: z.ZodOptional<z.ZodEnum<["prewired", "host", "generated", "ported"]>>;
        props: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
        children: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
    }, z.ZodTypeAny, "passthrough">>, "many">;
    queries: z.ZodOptional<z.ZodArray<z.ZodObject<{
        name: z.ZodString;
        tool: z.ZodString;
        input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
        name: z.ZodString;
        tool: z.ZodString;
        input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
        name: z.ZodString;
        tool: z.ZodString;
        input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
    }, z.ZodTypeAny, "passthrough">>, "many">>;
    streaming: z.ZodOptional<z.ZodBoolean>;
    dataUnavailable: z.ZodOptional<z.ZodBoolean>;
    display: z.ZodOptional<z.ZodEnum<["inline", "stage"]>>;
    inClient: z.ZodOptional<z.ZodObject<{
        granted: z.ZodBoolean;
        versionHash: z.ZodString;
    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
        granted: z.ZodBoolean;
        versionHash: z.ZodString;
    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
        granted: z.ZodBoolean;
        versionHash: z.ZodString;
    }, z.ZodTypeAny, "passthrough">>>;
    pinDrift: z.ZodOptional<z.ZodArray<z.ZodObject<{
        slot: z.ZodString;
        component: z.ZodString;
    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
        slot: z.ZodString;
        component: z.ZodString;
    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
        slot: z.ZodString;
        component: z.ZodString;
    }, z.ZodTypeAny, "passthrough">>, "many">>;
    data: z.ZodOptional<z.ZodNever>;
}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
    formatVersion: z.ZodLiteral<"vendo-genui/v2">;
    root: z.ZodString;
    nodes: z.ZodArray<z.ZodObject<{
        id: z.ZodString;
        component: z.ZodString;
        source: z.ZodOptional<z.ZodEnum<["prewired", "host", "generated", "ported"]>>;
        props: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
        children: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
        id: z.ZodString;
        component: z.ZodString;
        source: z.ZodOptional<z.ZodEnum<["prewired", "host", "generated", "ported"]>>;
        props: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
        children: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
        id: z.ZodString;
        component: z.ZodString;
        source: z.ZodOptional<z.ZodEnum<["prewired", "host", "generated", "ported"]>>;
        props: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
        children: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
    }, z.ZodTypeAny, "passthrough">>, "many">;
    queries: z.ZodOptional<z.ZodArray<z.ZodObject<{
        name: z.ZodString;
        tool: z.ZodString;
        input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
        name: z.ZodString;
        tool: z.ZodString;
        input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
        name: z.ZodString;
        tool: z.ZodString;
        input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
    }, z.ZodTypeAny, "passthrough">>, "many">>;
    streaming: z.ZodOptional<z.ZodBoolean>;
    dataUnavailable: z.ZodOptional<z.ZodBoolean>;
    display: z.ZodOptional<z.ZodEnum<["inline", "stage"]>>;
    inClient: z.ZodOptional<z.ZodObject<{
        granted: z.ZodBoolean;
        versionHash: z.ZodString;
    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
        granted: z.ZodBoolean;
        versionHash: z.ZodString;
    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
        granted: z.ZodBoolean;
        versionHash: z.ZodString;
    }, z.ZodTypeAny, "passthrough">>>;
    pinDrift: z.ZodOptional<z.ZodArray<z.ZodObject<{
        slot: z.ZodString;
        component: z.ZodString;
    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
        slot: z.ZodString;
        component: z.ZodString;
    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
        slot: z.ZodString;
        component: z.ZodString;
    }, z.ZodTypeAny, "passthrough">>, "many">>;
    data: z.ZodOptional<z.ZodNever>;
}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
    formatVersion: z.ZodLiteral<"vendo-genui/v2">;
    root: z.ZodString;
    nodes: z.ZodArray<z.ZodObject<{
        id: z.ZodString;
        component: z.ZodString;
        source: z.ZodOptional<z.ZodEnum<["prewired", "host", "generated", "ported"]>>;
        props: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
        children: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
        id: z.ZodString;
        component: z.ZodString;
        source: z.ZodOptional<z.ZodEnum<["prewired", "host", "generated", "ported"]>>;
        props: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
        children: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
        id: z.ZodString;
        component: z.ZodString;
        source: z.ZodOptional<z.ZodEnum<["prewired", "host", "generated", "ported"]>>;
        props: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
        children: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
    }, z.ZodTypeAny, "passthrough">>, "many">;
    queries: z.ZodOptional<z.ZodArray<z.ZodObject<{
        name: z.ZodString;
        tool: z.ZodString;
        input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
        name: z.ZodString;
        tool: z.ZodString;
        input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
        name: z.ZodString;
        tool: z.ZodString;
        input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
    }, z.ZodTypeAny, "passthrough">>, "many">>;
    streaming: z.ZodOptional<z.ZodBoolean>;
    dataUnavailable: z.ZodOptional<z.ZodBoolean>;
    display: z.ZodOptional<z.ZodEnum<["inline", "stage"]>>;
    inClient: z.ZodOptional<z.ZodObject<{
        granted: z.ZodBoolean;
        versionHash: z.ZodString;
    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
        granted: z.ZodBoolean;
        versionHash: z.ZodString;
    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
        granted: z.ZodBoolean;
        versionHash: z.ZodString;
    }, z.ZodTypeAny, "passthrough">>>;
    pinDrift: z.ZodOptional<z.ZodArray<z.ZodObject<{
        slot: z.ZodString;
        component: z.ZodString;
    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
        slot: z.ZodString;
        component: z.ZodString;
    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
        slot: z.ZodString;
        component: z.ZodString;
    }, z.ZodTypeAny, "passthrough">>, "many">>;
    data: z.ZodOptional<z.ZodNever>;
}, z.ZodTypeAny, "passthrough">>;
//# sourceMappingURL=screen.d.ts.map