/**
 * Zod schema for {@link DataContract} — the canonical wire shape for
 * agent-authored contract declarations.
 *
 * ## Why this file exists
 *
 * Output-side seams that type-narrow contract on the wire —
 * `renderOutputSchema.contract` and the various `decision` echoes — use
 * `z.custom<DataContract>()` because they trust the shape (it
 * originates from internal server state).
 *
 * The input seam is different: agents author contract on
 * `story.contract` and the handler MUST plumb them to the generator.
 * `z.custom<DataContract>()` does NOT work on input schemas — the
 * MCP SDK serializes input schemas as JSON Schema for `tools/list`,
 * and `z.custom<T>()` has no JSON-Schema representation (it's a
 * TypeScript-only escape hatch). The narrow alternative
 * (`z.record(z.string(), z.unknown())`) erases the type and forces
 * `as DataContract` casts downstream, which violates the project's
 * Zero Workarounds Policy + Strict Typing First principle.
 *
 * The fundamental fix is this file: a real zod schema mirroring the
 * `DataContract` interface field-for-field. Both the protocol's
 * `handshakeInputSchema` and the OSS handler's `inputSchema` build
 * their `contract?` field from `dataContractSchema`, the type derives
 * via `z.infer`, and JSON-Schema serialization for MCP `tools/list`
 * advertises the contract surface to agents.
 *
 * ## Shape source of truth
 *
 * The TS interface in `../types/data-contract.ts` remains the
 * declared source of truth (consumers import the type). This file's
 * schemas are a structural mirror — `dataContractSchema` is typed
 * `z.ZodType<DataContract>` so any drift between schema and
 * interface fails compile. A future cleanup can flip the relationship
 * (TS via `z.infer`), but that's a broader refactor.
 *
 * ## JsonSchema posture
 *
 * Every nested `schema: JsonSchema` field on contract entries
 * (PropEntry, ActionEntry, StreamChannelEntry, ContextEntry, ...)
 * accepts `jsonSchemaSchema` — a permissive `z.object` over the
 * known JSON Schema draft-07 subset {@link JsonSchema} declares,
 * with `passthrough()` for fields the shape doesn't enumerate. We
 * deliberately do NOT enforce JSON Schema's full grammar at this
 * layer — that work belongs in
 * `@ggui-ai/protocol/validation/schema-subset` and runs at
 * render-time + blueprint-registration-time as the F4 schema
 * compatibility checker. Agents authoring malformed schemas surface
 * at that pass with a named violation reason; this layer's job is
 * just to accept the contract and pass it to the generator.
 */
import { z } from 'zod';
import type { DataContract, JsonValue, JsonSchema, JsonObject } from '../types/data-contract.js';
/**
 * Recursive {@link JsonValue} — string | number | boolean | null |
 * array | object. All fields on contract entries that carry default
 * values, examples, or arbitrary JSON payloads use this.
 */
export declare const jsonValueSchema: z.ZodType<JsonValue>;
/** A JSON object — the protocol's `JsonObject`, never a bare `Record`. */
export declare const jsonObjectSchema: z.ZodType<JsonObject>;
export declare const jsonSchemaSchema: z.ZodType<JsonSchema>;
/**
 * {@link PropEntry} — per-prop metadata in a {@link PropsSpec}.
 *
 * Shape: `{schema: {type:'string', ...}, required?, default?, ...}`.
 * The JSON Schema NEVER sits flat at the entry level — every entry's
 * schema lives in `.schema`. Authors writing `{type:'string'}` instead
 * of `{schema: {type:'string'}}` will hit a shape error at render time.
 */
export declare const propEntrySchema: z.ZodObject<{
    description: z.ZodOptional<z.ZodString>;
    schema: z.ZodType<JsonSchema, unknown, z.core.$ZodTypeInternals<JsonSchema, unknown>>;
    required: z.ZodOptional<z.ZodBoolean>;
    default: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
    example: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
    sourceTool: z.ZodOptional<z.ZodString>;
}, z.core.$strict>;
/** {@link PropsSpec} — wrapper `{description?, properties}` over the per-prop map. */
export declare const propsSpecSchema: z.ZodObject<{
    description: z.ZodOptional<z.ZodString>;
    properties: z.ZodRecord<z.ZodString, z.ZodObject<{
        description: z.ZodOptional<z.ZodString>;
        schema: z.ZodType<JsonSchema, unknown, z.core.$ZodTypeInternals<JsonSchema, unknown>>;
        required: z.ZodOptional<z.ZodBoolean>;
        default: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
        example: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
        sourceTool: z.ZodOptional<z.ZodString>;
    }, z.core.$strict>>;
}, z.core.$strict>;
/**
 * {@link ActionEntry} — per-action metadata in an {@link ActionSpec}.
 *
 * Actions are agent-routed gestures; no dispatch discriminator. Optional
 * `nextStep` hints at the agent's intended next tool call (must resolve
 * to an `agentCapabilities.tools[*]` key on the same contract —
 * cross-ref enforced by the `CTR_REF_NEXT_STEP` linter).
 *
 * Anti-pattern: do NOT write `dispatch: {kind: 'tool', tool: '...'}` —
 * that vocabulary is retired. Use a flat optional `nextStep: '<toolName>'`.
 */
export declare const actionEntrySchema: z.ZodObject<{
    description: z.ZodOptional<z.ZodString>;
    label: z.ZodString;
    schema: z.ZodOptional<z.ZodType<JsonSchema, unknown, z.core.$ZodTypeInternals<JsonSchema, unknown>>>;
    example: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
    icon: z.ZodOptional<z.ZodString>;
    confirm: z.ZodOptional<z.ZodBoolean>;
    oneShot: z.ZodOptional<z.ZodBoolean>;
    nextStep: z.ZodOptional<z.ZodString>;
}, z.core.$strict>;
/** {@link ActionSpec} — flat `Record<name, ActionEntry>`. */
export declare const actionSpecSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
    description: z.ZodOptional<z.ZodString>;
    label: z.ZodString;
    schema: z.ZodOptional<z.ZodType<JsonSchema, unknown, z.core.$ZodTypeInternals<JsonSchema, unknown>>>;
    example: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
    icon: z.ZodOptional<z.ZodString>;
    confirm: z.ZodOptional<z.ZodBoolean>;
    oneShot: z.ZodOptional<z.ZodBoolean>;
    nextStep: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
/** {@link StreamChannelEntry} — per-channel metadata in a {@link StreamSpec}. */
export declare const streamChannelEntrySchema: z.ZodObject<{
    description: z.ZodOptional<z.ZodString>;
    schema: z.ZodType<JsonSchema, unknown, z.core.$ZodTypeInternals<JsonSchema, unknown>>;
    example: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
    mode: z.ZodOptional<z.ZodEnum<{
        append: "append";
        replace: "replace";
    }>>;
    replay: z.ZodOptional<z.ZodEnum<{
        latest: "latest";
        all: "all";
        none: "none";
    }>>;
    complete: z.ZodOptional<z.ZodBoolean>;
    source: z.ZodOptional<z.ZodObject<{
        tool: z.ZodString;
        args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>>;
    }, z.core.$strict>>;
}, z.core.$strict>;
/** {@link StreamSpec} — flat `Record<channel, StreamChannelEntry>`. */
export declare const streamSpecSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
    description: z.ZodOptional<z.ZodString>;
    schema: z.ZodType<JsonSchema, unknown, z.core.$ZodTypeInternals<JsonSchema, unknown>>;
    example: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
    mode: z.ZodOptional<z.ZodEnum<{
        append: "append";
        replace: "replace";
    }>>;
    replay: z.ZodOptional<z.ZodEnum<{
        latest: "latest";
        all: "all";
        none: "none";
    }>>;
    complete: z.ZodOptional<z.ZodBoolean>;
    source: z.ZodOptional<z.ZodObject<{
        tool: z.ZodString;
        args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>>;
    }, z.core.$strict>>;
}, z.core.$strict>>;
/** {@link ContextEntry} — per-slot metadata in a {@link ContextSpec}. */
export declare const contextEntrySchema: z.ZodObject<{
    description: z.ZodOptional<z.ZodString>;
    schema: z.ZodType<JsonSchema, unknown, z.core.$ZodTypeInternals<JsonSchema, unknown>>;
    default: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
    debounceMs: z.ZodOptional<z.ZodNumber>;
    example: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
}, z.core.$strict>;
/** {@link ContextSpec} — flat `Record<slot, ContextEntry>`. */
export declare const contextSpecSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
    description: z.ZodOptional<z.ZodString>;
    schema: z.ZodType<JsonSchema, unknown, z.core.$ZodTypeInternals<JsonSchema, unknown>>;
    default: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
    debounceMs: z.ZodOptional<z.ZodNumber>;
    example: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
}, z.core.$strict>>;
/** {@link AgentToolEntry} — per-tool metadata in an {@link AgentCapabilitiesSpec}. */
export declare const agentToolEntrySchema: z.ZodObject<{
    serverInfo: z.ZodOptional<z.ZodObject<{
        name: z.ZodString;
        version: z.ZodOptional<z.ZodString>;
    }, z.core.$strict>>;
    toolInfo: z.ZodObject<{
        inputSchema: z.ZodType<JsonSchema, unknown, z.core.$ZodTypeInternals<JsonSchema, unknown>>;
        description: z.ZodOptional<z.ZodString>;
        outputSchema: z.ZodOptional<z.ZodType<JsonSchema, unknown, z.core.$ZodTypeInternals<JsonSchema, unknown>>>;
    }, z.core.$strict>;
    usage: z.ZodOptional<z.ZodString>;
    example: z.ZodOptional<z.ZodObject<{
        input: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
        output: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
    }, z.core.$strict>>;
}, z.core.$strict>;
/** {@link AgentCapabilitiesSpec} — wrapper over the per-tool map. */
export declare const agentCapabilitiesSpecSchema: z.ZodObject<{
    tools: z.ZodRecord<z.ZodString, z.ZodObject<{
        serverInfo: z.ZodOptional<z.ZodObject<{
            name: z.ZodString;
            version: z.ZodOptional<z.ZodString>;
        }, z.core.$strict>>;
        toolInfo: z.ZodObject<{
            inputSchema: z.ZodType<JsonSchema, unknown, z.core.$ZodTypeInternals<JsonSchema, unknown>>;
            description: z.ZodOptional<z.ZodString>;
            outputSchema: z.ZodOptional<z.ZodType<JsonSchema, unknown, z.core.$ZodTypeInternals<JsonSchema, unknown>>>;
        }, z.core.$strict>;
        usage: z.ZodOptional<z.ZodString>;
        example: z.ZodOptional<z.ZodObject<{
            input: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
            output: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
        }, z.core.$strict>>;
    }, z.core.$strict>>;
}, z.core.$loose>;
/**
 * Single source of truth for the `requires[]` field shape on gadget
 * descriptors. The wire-permissive `gadgetDescriptorSchema`, the
 * strict `strictGadgetDescriptorSchema`, AND the author-facing
 * `@ggui-ai/artifact-manifest#gadgetManifestSchema` all need an
 * identical `z.array(z.string().regex(PUBLIC_ENV_APP_KEY_RE))`.
 * Exported here so any future tightening (e.g., cap count, dedupe
 * refinement) lives in one place.
 *
 * Entries are App.publicEnv key names — `GGUI_PUBLIC_APP_*`. Wrappers
 * that declare a `requires` key must have a corresponding App-side
 * publicEnv value at render time (gate: `assertPublicEnvSatisfied`).
 */
export declare const gadgetRequiresSchema: z.ZodArray<z.ZodString>;
/**
 * SRI hash format for gadget bundles. Registry install writes
 * `bundleSri` in this shape; iframe-runtime emits it verbatim into
 * the `<script integrity>` attribute. Only `sha384` is accepted on
 * purpose:
 *
 *   - SHA-384 is the strongest hash routinely allowed by browsers
 *     for SRI without compatibility caveats (SHA-512 is allowed but
 *     adds no real security over -384 here).
 *   - Pinning a single algorithm makes the publish Lambda's hash
 *     computation and the iframe's verification trivially aligned —
 *     no algorithm negotiation, no ambiguity at audit time.
 *
 * Base64 body is the standard SRI body (RFC 3548 `+/=`, NOT
 * url-safe). The regex permits zero or two `=` pad chars (SHA-384
 * digest is 48 bytes = base64 length 64 with no padding).
 */
export declare const BUNDLE_SRI_RE: RegExp;
/**
 * Bare npm package name. Either an unscoped name (`leaflet`) or a
 * scoped name (`@my-org/leaflet`). Mirrors the
 * `validate-npm-package-name` subset that nearly every modern
 * registry accepts:
 *
 *   - Lowercase alphanumerics + `.` + `_` + `-`.
 *   - First char of name (and scope, if present) MUST be alphanumeric
 *     — leading `.`/`_`/`-` rejected to match historical npm bans.
 *   - At most one optional `@scope/` prefix.
 *
 * Examples that pass:
 *   - `leaflet`, `react-router`, `@ggui-ai/gadgets`, `@my-org/foo.bar`
 *
 * Examples that fail:
 *   - `@scope/@other/name` (multi-scope)
 *   - `https://registry.ggui.ai/foo` (URL — registry choice lives on
 *     `bundleUrl` / `typesUrl`, not `package`)
 *   - `Leaflet` (uppercase)
 *   - `.foo` / `_foo` / `-foo` (leading non-alphanumeric)
 */
export declare const NPM_PACKAGE_NAME_RE: RegExp;
/**
 * Exact semver pin (e.g., `0.0.1`, `1.2.3-beta.1`, `2.0.0+build.7`).
 * No ranges (`^`, `~`, `>=`), no leading `v`, no wildcards.
 *
 * Why pin-only: the cache key for a generated UI is
 * `hashContract(wire, intent)` — making the wire carry an exact
 * version means cache invalidation is a pure function of the wire
 * bytes (no canonicalize step). Version bumps produce new wire →
 * fresh generation; forensics are observable from storage alone.
 *
 * Grammar mirrors semver 2.0 spec:
 *   `MAJOR.MINOR.PATCH(-PRERELEASE)?(+BUILD)?`
 * Pre-release + build identifiers match `[\w.]+` (semver's
 * dot-separated alphanumeric identifiers).
 */
export declare const SEMVER_PIN_RE: RegExp;
/**
 * Hostname-only regex for `bundleHost` — the registry hostname (no
 * scheme, no path) that the server prepends `https://` to and
 * appends the canonical
 * `/bundles/public/<scope>/<name>/<version>/{bundle.js,style.css}`
 * suffix to when resolving a gadget's URLs at render time (the PUBLIC
 * prefix of the registry's visibility-split bundle layout).
 *
 * Examples that pass:
 *   - `registry.ggui.ai` (spec default)
 *   - `dev.registry.sandbox.ggui.ai`
 *   - `sandbox-ggui-main.registry.sandbox.ggui.ai`
 *   - `localhost:8787` (port permitted for local registries)
 *
 * Examples that fail (caught at register-time):
 *   - `https://registry.ggui.ai` (scheme not allowed; use `bundleUrl`
 *     full-URL escape hatch if you need non-HTTPS or a non-standard path)
 *   - `/leaflet@0.0.1/bundle.js` (path not allowed)
 *   - `Registry.Ggui.Ai` (must be lowercase; DNS names are
 *     case-insensitive but we pin lower for canonicalization)
 */
export declare const BUNDLE_HOST_RE: RegExp;
/**
 * Spec-default registry hostname applied when neither operator
 * (`app.gadgets[*].bundleHost`) nor gadget manifest
 * (`ggui.gadget.json#bundleHost`) declares one. The server's URL
 * resolver falls through here last, so first-party + hosted-registry
 * publishes "just work" without explicit operator config.
 */
export declare const DEFAULT_BUNDLE_HOST = "registry.ggui.ai";
/**
 * Loopback `bundleHost` predicate — anchored regex matching the three
 * IP/hostname pairs that resolve to localhost: `localhost`, `127.0.0.1`,
 * `0.0.0.0` (each optionally suffixed with a port). Anchoring at both
 * ends prevents `localhost-evil.com` from being treated as loopback.
 *
 * Used symmetrically by:
 *   - `buildInstallCommand` (publish CLI) to emit `http://localhost:PORT`
 *     in the printed `ggui gadget install ...` line.
 *   - `resolveGadgetUrls` (render-time bootstrap derivation) to compute
 *     `http://localhost:PORT/bundles/...` so iframe fetches a reachable
 *     URL during local-dev / sandbox-registry workflows.
 *
 * If install + render disagreed on scheme, an operator running a local
 * registry would publish via `http://` then have render emit `https://`
 * and silently fail in the iframe (mixed-content block in the host's
 * sandboxed context).
 */
export declare const LOOPBACK_HOST_RE: RegExp;
/**
 * Compute the scheme (`http` / `https`) for a given `bundleHost`.
 * Loopback hosts get `http://`; everything else gets `https://`.
 *
 * Centralized so any future scheme-policy change (e.g., allowing
 * `https://` on a self-signed local cert) updates one site.
 */
export declare function bundleHostScheme(host: string): 'http' | 'https';
/**
 * `HOOK_NAME_RE` + `COMPONENT_NAME_RE` are defined in the
 * dependency-free leaf {@link module:schemas/gadget-name-grammar} and
 * re-exported here so the package barrel surface is unchanged. The
 * leaf placement breaks the import cycle that would otherwise form
 * between this module and `validation/hygiene-rules.ts` (which also
 * needs the grammars and which this module imports
 * `KNOWN_PERMISSION_NAMES` from).
 */
export { HOOK_NAME_RE, COMPONENT_NAME_RE } from './gadget-name-grammar.js';
/**
 * Wire-permissive {@link GadgetExport} schema — a union of a
 * hook-export shape (carries `hook`) and a component-export shape
 * (carries `component`); the identifier field present is the natural
 * discriminator. Each member is `.strict()`, so an entry carrying
 * BOTH `hook` and `component` is rejected. Teaching text is optional
 * so contract authoring stays cheap; the registry-side
 * {@link strictGadgetExportSchema} requires it.
 */
export declare const gadgetExportSchema: z.ZodUnion<readonly [z.ZodObject<{
    description: z.ZodOptional<z.ZodString>;
    usage: z.ZodOptional<z.ZodString>;
    example: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
    permission: z.ZodOptional<z.ZodString>;
    gotchas: z.ZodOptional<z.ZodString>;
    hook: z.ZodString;
}, z.core.$strict>, z.ZodObject<{
    description: z.ZodOptional<z.ZodString>;
    usage: z.ZodOptional<z.ZodString>;
    example: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
    permission: z.ZodOptional<z.ZodString>;
    gotchas: z.ZodOptional<z.ZodString>;
    component: z.ZodString;
}, z.core.$strict>]>;
/**
 * Registry-strict {@link GadgetExport} schema — teaching text
 * REQUIRED, `permission` enum-tight. Used as the `exports` element
 * schema inside {@link strictGadgetDescriptorSchema}.
 */
export declare const strictGadgetExportSchema: z.ZodUnion<readonly [z.ZodObject<{
    description: z.ZodString;
    usage: z.ZodString;
    example: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
    permission: z.ZodOptional<z.ZodEnum<{
        camera: "camera";
        "clipboard-read": "clipboard-read";
        "clipboard-write": "clipboard-write";
        geolocation: "geolocation";
        microphone: "microphone";
        notifications: "notifications";
        "persistent-storage": "persistent-storage";
        midi: "midi";
        "speaker-selection": "speaker-selection";
        "storage-access": "storage-access";
        "background-sync": "background-sync";
        accelerometer: "accelerometer";
        gyroscope: "gyroscope";
        magnetometer: "magnetometer";
        "ambient-light-sensor": "ambient-light-sensor";
        "screen-wake-lock": "screen-wake-lock";
    }>>;
    gotchas: z.ZodOptional<z.ZodString>;
    hook: z.ZodString;
}, z.core.$strict>, z.ZodObject<{
    description: z.ZodString;
    usage: z.ZodString;
    example: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
    permission: z.ZodOptional<z.ZodEnum<{
        camera: "camera";
        "clipboard-read": "clipboard-read";
        "clipboard-write": "clipboard-write";
        geolocation: "geolocation";
        microphone: "microphone";
        notifications: "notifications";
        "persistent-storage": "persistent-storage";
        midi: "midi";
        "speaker-selection": "speaker-selection";
        "storage-access": "storage-access";
        "background-sync": "background-sync";
        accelerometer: "accelerometer";
        gyroscope: "gyroscope";
        magnetometer: "magnetometer";
        "ambient-light-sensor": "ambient-light-sensor";
        "screen-wake-lock": "screen-wake-lock";
    }>>;
    gotchas: z.ZodOptional<z.ZodString>;
    component: z.ZodString;
}, z.core.$strict>]>;
/**
 * {@link GadgetDescriptor} — a gadget PACKAGE: identity + transport
 * metadata + an `exports` array (≥1). Permissive shape: per-export
 * teaching text is optional so contract authoring stays cheap.
 * Registry-side registration uses the stricter
 * {@link strictGadgetDescriptorSchema}.
 */
export declare const gadgetDescriptorSchema: z.ZodObject<{
    exports: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
        description: z.ZodOptional<z.ZodString>;
        usage: z.ZodOptional<z.ZodString>;
        example: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
        permission: z.ZodOptional<z.ZodString>;
        gotchas: z.ZodOptional<z.ZodString>;
        hook: z.ZodString;
    }, z.core.$strict>, z.ZodObject<{
        description: z.ZodOptional<z.ZodString>;
        usage: z.ZodOptional<z.ZodString>;
        example: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
        permission: z.ZodOptional<z.ZodString>;
        gotchas: z.ZodOptional<z.ZodString>;
        component: z.ZodString;
    }, z.core.$strict>]>>;
    version: z.ZodString;
    package: z.ZodString;
    bundleUrl: z.ZodOptional<z.ZodURL>;
    bundleHost: z.ZodOptional<z.ZodString>;
    bundleSri: z.ZodOptional<z.ZodString>;
    styleUrl: z.ZodOptional<z.ZodURL>;
    connect: z.ZodOptional<z.ZodArray<z.ZodURL>>;
    requires: z.ZodOptional<z.ZodArray<z.ZodString>>;
    typesUrl: z.ZodOptional<z.ZodURL>;
    typesSri: z.ZodOptional<z.ZodString>;
}, z.core.$strict>;
/**
 * Registry-side {@link GadgetDescriptor} validator. Stricter than the
 * wire schema: every export's `description` / `usage` / `example` is
 * REQUIRED and `permission` is enum-tight — via
 * {@link strictGadgetExportSchema} as the `exports` element schema.
 *
 * Used by:
 *   - `createGguiGadget` SDK factory (validates wrapper specs).
 *   - `App.gadgets` registration handlers (ggui.json seed,
 *     `ggui gadget install`, config push).
 *
 * Same TS interface as the wire schema — the strictness lives in zod
 * refinements, not the type system.
 */
export declare const strictGadgetDescriptorSchema: z.ZodObject<{
    exports: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
        description: z.ZodString;
        usage: z.ZodString;
        example: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
        permission: z.ZodOptional<z.ZodEnum<{
            camera: "camera";
            "clipboard-read": "clipboard-read";
            "clipboard-write": "clipboard-write";
            geolocation: "geolocation";
            microphone: "microphone";
            notifications: "notifications";
            "persistent-storage": "persistent-storage";
            midi: "midi";
            "speaker-selection": "speaker-selection";
            "storage-access": "storage-access";
            "background-sync": "background-sync";
            accelerometer: "accelerometer";
            gyroscope: "gyroscope";
            magnetometer: "magnetometer";
            "ambient-light-sensor": "ambient-light-sensor";
            "screen-wake-lock": "screen-wake-lock";
        }>>;
        gotchas: z.ZodOptional<z.ZodString>;
        hook: z.ZodString;
    }, z.core.$strict>, z.ZodObject<{
        description: z.ZodString;
        usage: z.ZodString;
        example: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
        permission: z.ZodOptional<z.ZodEnum<{
            camera: "camera";
            "clipboard-read": "clipboard-read";
            "clipboard-write": "clipboard-write";
            geolocation: "geolocation";
            microphone: "microphone";
            notifications: "notifications";
            "persistent-storage": "persistent-storage";
            midi: "midi";
            "speaker-selection": "speaker-selection";
            "storage-access": "storage-access";
            "background-sync": "background-sync";
            accelerometer: "accelerometer";
            gyroscope: "gyroscope";
            magnetometer: "magnetometer";
            "ambient-light-sensor": "ambient-light-sensor";
            "screen-wake-lock": "screen-wake-lock";
        }>>;
        gotchas: z.ZodOptional<z.ZodString>;
        component: z.ZodString;
    }, z.core.$strict>]>>;
    version: z.ZodString;
    package: z.ZodString;
    bundleUrl: z.ZodOptional<z.ZodURL>;
    bundleHost: z.ZodOptional<z.ZodString>;
    bundleSri: z.ZodOptional<z.ZodString>;
    styleUrl: z.ZodOptional<z.ZodURL>;
    connect: z.ZodOptional<z.ZodArray<z.ZodURL>>;
    requires: z.ZodOptional<z.ZodArray<z.ZodString>>;
    typesUrl: z.ZodOptional<z.ZodURL>;
    typesSri: z.ZodOptional<z.ZodString>;
}, z.core.$strict>;
/**
 * Types-pipeline descriptor validator — PARKED (2026-08-09 gadget
 * catalog foundations): no catalog-serving boundary consumes it.
 * {@link strictGadgetDescriptorSchema} plus the refinement that every
 * non-stdlib package MUST carry a `typesUrl`.
 *
 * Every live catalog boundary — descriptor writes, catalog reads, and
 * the generation-time catalog adapter — validates with
 * `strictGadgetDescriptorSchema`, where `typesUrl` is optional:
 * nothing in the publish→install chain stamps `typesUrl` yet, and the
 * types fetcher already skips descriptors without one, so generation
 * degrades gracefully to no-types codegen.
 *
 * The one surviving consumer is the wrapper-author build helper
 * (`writeDescriptorJson` in `@ggui-ai/gadgets/codegen`) — the
 * authoring-side front half of the types pipeline, where the wrapper
 * build HAS just emitted a `.d.ts` and stamped `typesUrl` +
 * `typesSri`, so requiring them is coherent there.
 *
 * The export stays because it is the already-written contract for the
 * types-pipeline follow-up: publish stamps `typesUrl` + `typesSri` on
 * the descriptor after the build emits the `.d.ts`, descriptor
 * projections carry both fields through, and the generation-time
 * catalog adapter adopts this schema as its posture again — the
 * code-gen sandbox then loads the `.d.ts` the URL points at to
 * typecheck generated component code against the package's real
 * export signatures. Stdlib (`@ggui-ai/gadgets`) is exempt — the
 * sandbox loads its types directly.
 */
export declare const registeredGadgetDescriptorSchema: z.ZodObject<{
    exports: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
        description: z.ZodString;
        usage: z.ZodString;
        example: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
        permission: z.ZodOptional<z.ZodEnum<{
            camera: "camera";
            "clipboard-read": "clipboard-read";
            "clipboard-write": "clipboard-write";
            geolocation: "geolocation";
            microphone: "microphone";
            notifications: "notifications";
            "persistent-storage": "persistent-storage";
            midi: "midi";
            "speaker-selection": "speaker-selection";
            "storage-access": "storage-access";
            "background-sync": "background-sync";
            accelerometer: "accelerometer";
            gyroscope: "gyroscope";
            magnetometer: "magnetometer";
            "ambient-light-sensor": "ambient-light-sensor";
            "screen-wake-lock": "screen-wake-lock";
        }>>;
        gotchas: z.ZodOptional<z.ZodString>;
        hook: z.ZodString;
    }, z.core.$strict>, z.ZodObject<{
        description: z.ZodString;
        usage: z.ZodString;
        example: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
        permission: z.ZodOptional<z.ZodEnum<{
            camera: "camera";
            "clipboard-read": "clipboard-read";
            "clipboard-write": "clipboard-write";
            geolocation: "geolocation";
            microphone: "microphone";
            notifications: "notifications";
            "persistent-storage": "persistent-storage";
            midi: "midi";
            "speaker-selection": "speaker-selection";
            "storage-access": "storage-access";
            "background-sync": "background-sync";
            accelerometer: "accelerometer";
            gyroscope: "gyroscope";
            magnetometer: "magnetometer";
            "ambient-light-sensor": "ambient-light-sensor";
            "screen-wake-lock": "screen-wake-lock";
        }>>;
        gotchas: z.ZodOptional<z.ZodString>;
        component: z.ZodString;
    }, z.core.$strict>]>>;
    version: z.ZodString;
    package: z.ZodString;
    bundleUrl: z.ZodOptional<z.ZodURL>;
    bundleHost: z.ZodOptional<z.ZodString>;
    bundleSri: z.ZodOptional<z.ZodString>;
    styleUrl: z.ZodOptional<z.ZodURL>;
    connect: z.ZodOptional<z.ZodArray<z.ZodURL>>;
    requires: z.ZodOptional<z.ZodArray<z.ZodString>>;
    typesUrl: z.ZodOptional<z.ZodURL>;
    typesSri: z.ZodOptional<z.ZodString>;
}, z.core.$strict>;
/**
 * Wire-side per-export USE entry on `clientCapabilities.gadgets`.
 *
 * The export NAME is the map key (see {@link gadgetPackageUseSchema});
 * its grammar discriminates kind — a `use`-prefixed key is a hook, a
 * PascalCase key is a component. Kind is therefore never a field.
 *
 * The only wire-authored payload is optional intent-specific prose:
 *
 *   - `description?` / `usage?` — when present the agent's prose wins
 *     over the registered export's text; when omitted, render-time
 *     resolution inherits the registered text verbatim.
 *
 * Everything else — `version`, transport metadata, `permission`,
 * `example`, `gotchas` — is registry-side and resolves from the
 * `App.gadgets` catalog. `.strict()` so a hallucinated registry field
 * fails loudly instead of being silently dropped.
 */
export declare const gadgetExportUseSchema: z.ZodObject<{
    description: z.ZodOptional<z.ZodString>;
    usage: z.ZodOptional<z.ZodString>;
}, z.core.$strict>;
/**
 * Wire-side per-PACKAGE gadget use — the value type of
 * `clientCapabilities.gadgets` (which is keyed by npm package name).
 *
 * A map of export name → {@link gadgetExportUseSchema}; at least one
 * entry. The export name key is a `use`-prefixed hook
 * ({@link HOOK_NAME_RE}) or a PascalCase component
 * ({@link COMPONENT_NAME_RE}). The wire carries identity only —
 * `(package, export name)` — never `version` or transport metadata;
 * there is no package-level wire field, so the package entry IS its
 * export map (no `exports` wrapper).
 */
export declare const gadgetPackageUseSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
    description: z.ZodOptional<z.ZodString>;
    usage: z.ZodOptional<z.ZodString>;
}, z.core.$strict>>;
/**
 * {@link ClientCapabilitiesSpec} — wrapper over the package-keyed
 * gadget map.
 *
 * `gadgets` is keyed by npm PACKAGE name; each value is a
 * {@link gadgetPackageUseSchema} listing the exports of that package
 * the UI uses. The wire carries identity only — `(package, export
 * name)` — never `version` or transport metadata: the ggui server
 * resolves the full {@link GadgetDescriptor} from the `App.gadgets`
 * catalog at render time onto the `ComponentGguiSession.gadgetDescriptors`
 * sidecar (the `gadgetDescriptors` field of the `GguiSession` union member).
 *
 * `.strict()` (not `.passthrough()`): the retired `libraries` field
 * (renamed to `gadgets`) and any other stale sibling field MUST fail
 * loudly at parse time.
 */
export declare const clientCapabilitiesSpecSchema: z.ZodObject<{
    gadgets: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodObject<{
        description: z.ZodOptional<z.ZodString>;
        usage: z.ZodOptional<z.ZodString>;
    }, z.core.$strict>>>;
}, z.core.$strict>;
/**
 * Zod schema for `App.publicEnv`.
 *
 * Flat `Record<string, string>` with key-regex enforcement
 * ({@link PUBLIC_ENV_APP_KEY_RE}). Empty-string values are allowed
 * (operator may want "intentionally absent" without dropping the key).
 *
 * Consumed by:
 *   - OSS `ggui.json#app.publicEnv` boot-time parse.
 *   - Cloud AppRecord persistence layer.
 *   - Defensive re-validation in the iframe-runtime slice-meta
 *     extractors (`parseMetaFromGlobal`, `parseMetaFromToolResult`).
 */
export declare const appPublicEnvSchema: z.ZodRecord<z.ZodString, z.ZodString>;
/**
 * {@link DataContract} — the unified four-spec contract surface
 * agents author on `story.contract` and that the generator
 * constrains the LLM to honor.
 *
 * Fields per the TS interface: `propsSpec` / `actionSpec` / `streamSpec` /
 * `contextSpec` (the four typed surfaces), `agentCapabilities` (MCP
 * tool catalog) + `clientCapabilities` (browser-capability hook
 * catalog). All fields are optional — agents declare only what their UI
 * uses. `intent` is NOT a contract field; internal consumers (prompt
 * rendering, contract hash, cache scope) receive intent from the outer
 * pipeline (the flat `intent` field on `ggui_handshake`, the operator
 * prompt for harness benchmarks).
 *
 * No `interaction` mode field — the four specs describe the wire
 * surface exhaustively, so a categorical mode label would be
 * redundant. `passthrough()` below tolerates legacy payloads that
 * still carry it — the field is silently dropped on round-trip.
 *
 * No `broadcast` field — channel data sources are declared per-channel
 * via `streamSpec[ch].source` (flat `{tool, args?}` shape; transport
 * auto-negotiated at runtime by `@ggui-ai/wire`).
 *
 * `passthrough()` lets unknown fields ride through without rejection
 * — forward-compatible with future protocol additions, and matches
 * the protocol's general "input-shape lax / validator-shape strict"
 * posture (`handshakeInputSchema`, `renderInputSchema`, etc. all
 * `passthrough` for the same reason).
 */
/**
 * The one-paragraph shape rule every teaching surface quotes (ggui#523
 * item 1): the handshake's tool description, the loose `contract`
 * field the handshake publishes on `tools/list`, and the format doc.
 * One constant, so the wording cannot drift between them. Mechanism-
 * only and vendor-neutral — it ships as JSON-Schema metadata to every
 * agent that lists the tools.
 */
export declare const DATA_CONTRACT_SHAPE_RULE: string;
/**
 * A minimal, complete, valid example — published beside the rule so a
 * first-time caller can copy a shape that parses (JSON-Schema
 * `examples`). Deliberately tiny: one prop, one action with a payload,
 * one context slot.
 */
export declare const DATA_CONTRACT_MINIMAL_EXAMPLE: {
    readonly propsSpec: {
        readonly properties: {
            readonly items: {
                readonly schema: {
                    readonly type: "array";
                    readonly items: {
                        readonly type: "object";
                        readonly properties: {
                            readonly id: {
                                readonly type: "string";
                            };
                            readonly title: {
                                readonly type: "string";
                            };
                        };
                        readonly required: readonly ["id", "title"];
                    };
                };
                readonly required: true;
            };
        };
    };
    readonly actionSpec: {
        readonly toggle: {
            readonly label: "Toggle";
            readonly schema: {
                readonly type: "object";
                readonly properties: {
                    readonly id: {
                        readonly type: "string";
                    };
                };
                readonly required: readonly ["id"];
            };
        };
    };
    readonly contextSpec: {
        readonly filter: {
            readonly schema: {
                readonly type: "string";
            };
            readonly default: "all";
        };
    };
};
/**
 * The contract READ-door result (ggui#1115): the contract as this release
 * can read it, plus the entry members it had to strip to get there.
 */
export type DataContractReadDoorResult = {
    readonly ok: true;
    readonly contract: DataContract;
    readonly stripped: readonly string[];
} | {
    readonly ok: false;
    readonly issues: readonly string[];
};
/**
 * Parse a STORED contract at a READ door (ggui#1115).
 *
 * `dataContractSchema`'s outer object is `.passthrough()`, so a whole new
 * top-level spec was never the hazard — but its ENTRY schemas are
 * `.strict()`, and contracts are STORED (blueprint rows, artifact
 * manifests). So a release that adds a member to an action / prop / stream /
 * context / tool ENTRY makes every older reader fail the parse, and a reader
 * that turns a failed parse into "no candidate" drops the row from the match
 * set: the generator runs again, a different card is produced, and nothing
 * anywhere says a stored blueprint was skipped. A silent cache miss, not a
 * failure — which is why this door exists and why it NAMES what it stripped.
 *
 * WRITE doors keep entry strictness and MUST: it is what catches a typo in a
 * generated contract before it is stored, and relaxing it globally would
 * trade a silent cache miss for silently stored garbage. The asymmetry is by
 * DOOR, exactly as for `AppTheme` (`schemas/app-theme.ts`, VERSION-POLICY
 * §3.6): this is the INTERPRET side, so it strips and reports; a read whose
 * purpose is to REPRODUCE state (a writer's carry path) must not strip at
 * all.
 *
 * Everything the write door refuses is still refused — a missing required
 * field, a wrong type, a malformed spec. Only members this release does not
 * NAME are stripped, never members it finds INVALID.
 *
 * NOT COVERED, deliberately and named rather than discovered: the gadget
 * family under `clientCapabilities`. Its descriptors are validated per row
 * with their own salvage posture (`strictGadgetDescriptorSchema`), evolve on
 * their own surface, and folding them in here would put two different
 * evolution stories behind one door.
 */
export declare function parseDataContractAtReadDoor(input: unknown): DataContractReadDoorResult;
export declare const dataContractSchema: z.ZodType<DataContract>;
//# sourceMappingURL=data-contract.d.ts.map