/** Bumped on any BREAKING change to the shapes below. Additive/optional fields do not bump it. */
export declare const CARD_CONTRACT_VERSION: "1";
/** A card the agent/server asks the chat to render. `data` conforms to the card
 *  type's own published JSON Schema (one schema per `type`). */
export interface CardEnvelope<TType extends string = string, TData = unknown> {
    type: TType;
    id: string;
    data: TData;
    title?: string;
    /** Set when the user has resolved this card; renders the chromed read-only view. */
    resolution?: CardResolution;
}
/** Context the host pushes to every card; updated when it changes (theme, etc.). */
export interface CardContext {
    theme: {
        mode: 'light' | 'dark';
        tokens?: Record<string, string>;
    };
    locale: string;
    conversationId?: string;
    /** Remote (iframe) cards only: short-lived signed token. Never long-lived. */
    authToken?: string;
    /** Host-resolved a11y prefs (e.g. reduced-motion, which doesn't cross the iframe). */
    a11y?: {
        reducedMotion?: boolean;
    };
}
/** Everything a card can ask the host to do. The host authorizes + routes each. */
export type CardEvent = {
    kind: 'ready';
    cardId: string;
} | {
    kind: 'submit';
    cardId: string;
    data: unknown;
} | {
    kind: 'action';
    cardId: string;
    action: string;
    payload?: unknown;
} | {
    kind: 'send-prompt';
    cardId: string;
    text: string;
    mode?: 'compose' | 'send';
    context?: unknown;
} | {
    kind: 'open';
    cardId: string;
    url: string;
    target?: 'tab' | 'artifact';
} | {
    kind: 'resize';
    cardId: string;
    height: number;
} | {
    kind: 'state';
    cardId: string;
    patch: unknown;
} | {
    kind: 'dismiss';
    cardId: string;
} | {
    kind: 'reopen';
    cardId: string;
} | {
    kind: 'error';
    cardId: string;
    message: string;
};
export type CardEventKind = CardEvent['kind'];
/** How a card was resolved by the user — the re-hydration channel for the chromed
 *  read-only state. The terminal kinds (`action`/`submit`) mirror the two terminal
 *  CardEvents (minus `cardId`): the resolution is just the event that resolved the
 *  card. `dismissed` is a DEFERRED (non-terminal) state — the user set the card
 *  aside; it can be re-opened. `expired` is terminal — a dismissed card the host
 *  decided can no longer be re-opened (e.g. the agent proceeded, or it went stale).
 *  `at` is optional ISO-8601 provenance (data only; never rendered). Additive —
 *  does not bump the contract version. */
export type CardResolution = {
    kind: 'action';
    action: string;
    payload?: unknown;
    at?: string;
} | {
    kind: 'submit';
    data: unknown;
    at?: string;
} | {
    kind: 'dismissed';
    at?: string;
} | {
    kind: 'expired';
    reason?: string;
    at?: string;
};
/** What every card is handed (via native context or the iframe bridge). */
export interface CardHost {
    context(): CardContext;
    emit(event: CardEvent): void;
}
/** How the host routes each verb. Consumers supply handlers; defaults applied otherwise. */
export interface CardPolicy {
    onSubmit?: (cardId: string, data: unknown) => void;
    onAction?: (cardId: string, action: string, payload?: unknown) => void;
    onSendPrompt?: (text: string, opts: {
        mode: 'compose' | 'send';
        context?: unknown;
    }) => void;
    onOpen?: (url: string, target: 'tab' | 'artifact') => void;
    onState?: (cardId: string, patch: unknown) => void;
    onDismiss?: (cardId: string) => void;
    /** A dismissed card asked to be re-opened. The host decides whether it can come
     *  back (clear the resolution → live again) or has expired (stamp `expired`). */
    onReopen?: (cardId: string) => void;
    onError?: (cardId: string, message: string) => void;
    /** Cap on send-prompt: 'compose' (default) forbids silent sends. 'send' to allow. */
    maxSendPromptMode?: 'compose' | 'send';
}