@terreno/blocks 57.10.1

package/dist/asks/schema.d.ts

@@ -0,0 +1,826 @@
+import { z } from "zod";
+import { type AskFileAccept } from "./files";
+/** Ask kinds in the catalog. Each kind is offered to the model as the tool `ask_<kind>`. */
+export declare const ASK_KINDS: readonly ["choice", "confirm", "markdown", "form", "files"];
+export type AskKind = (typeof ASK_KINDS)[number];
+/**
+ * Where the user answers. `compact` is a small screen, such as a watch: the model is offered only
+ * asks whose simple card shows every option, so the user never has to continue on a phone.
+ */
+export declare const ASK_SURFACES: readonly ["full", "compact"];
+export type AskSurface = (typeof ASK_SURFACES)[number];
+/** Ask kinds the compact surface offers, each with a narrowed input schema. */
+export declare const COMPACT_ASK_KINDS: readonly ["choice", "confirm"];
+export type CompactAskKind = (typeof COMPACT_ASK_KINDS)[number];
+/** Reasons the server records when it answers an ask with `cancel` on the user's behalf. */
+export declare const ASK_CANCEL_REASONS: {
+    readonly oneAskAtATime: "one_ask_at_a_time";
+    readonly userSentMessage: "user_sent_message";
+};
+export declare const choiceOptionSchema: z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    label: z.ZodString;
+}, z.core.$strict>;
+export type ChoiceOption = z.infer<typeof choiceOptionSchema>;
+/** How many options a `choice` lets the user pick. */
+export declare const CHOICE_SELECT_MODES: readonly ["one", "many"];
+export type ChoiceSelectMode = (typeof CHOICE_SELECT_MODES)[number];
+/** The fields of a `choice` input that its semantic rules read. */
+interface ChoiceRuleInput {
+    allowOther?: boolean;
+    default?: string[];
+    maxSelected?: number;
+    minSelected?: number;
+    options: ChoiceOption[];
+    otherLabel?: string;
+    select: ChoiceSelectMode;
+}
+/**
+ * How many choices an answer to a `choice` must make, counting a typed Other answer as one.
+ * `select: "one"` is always exactly one. `select: "many"` defaults to at least 1 and at most every
+ * choice the ask offers: each option, plus Other when `allowOther` is true.
+ */
+export declare const choiceSelectionBounds: (input: ChoiceRuleInput) => {
+    max: number;
+    min: number;
+};
+/**
+ * A label as its button shows it. Spaces at either end don't show, so "Go " and "Go" look the same
+ * and are compared, and put on simple card buttons, without them.
+ */
+export declare const visibleLabel: (label: string) => string;
+/** Input for `ask_choice`: pick one option, or several with `select: "many"`, from a list. */
+export declare const choiceAskInputSchema: z.ZodObject<{
+    allowOther: z.ZodOptional<z.ZodBoolean>;
+    maxSelected: z.ZodOptional<z.ZodNumber>;
+    minSelected: z.ZodOptional<z.ZodNumber>;
+    otherLabel: z.ZodOptional<z.ZodString>;
+    select: z.ZodEnum<{
+        one: "one";
+        many: "many";
+    }>;
+    default: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    options: z.ZodArray<z.ZodObject<{
+        description: z.ZodOptional<z.ZodString>;
+        id: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strict>>;
+    allowDecline: z.ZodOptional<z.ZodBoolean>;
+    prompt: z.ZodString;
+    submitLabel: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type ChoiceAskInput = z.infer<typeof choiceAskInputSchema>;
+/**
+ * Input for `ask_choice` on the compact surface: pick one option by tapping its button, so the
+ * card never hands off. At most 3 options, labels of at most 20 characters (each emoji counts as 2
+ * or more), and no two labels alike. `select: "many"` and Other are not offered.
+ */
+export declare const compactChoiceAskInputSchema: z.ZodObject<{
+    select: z.ZodLiteral<"one">;
+    default: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    options: z.ZodArray<z.ZodObject<{
+        description: z.ZodOptional<z.ZodString>;
+        id: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strict>>;
+    allowDecline: z.ZodOptional<z.ZodBoolean>;
+    prompt: z.ZodString;
+    submitLabel: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/** The fields of a `confirm` input that its semantic rules read. */
+interface ConfirmRuleInput {
+    confirmLabel?: string;
+    denyLabel?: string;
+}
+/** The labels of a `confirm` ask's approve and deny buttons, with the defaults filled in. */
+export declare const confirmButtonLabels: (input: ConfirmRuleInput) => {
+    confirm: string;
+    deny: string;
+};
+/**
+ * Input for `ask_confirm`: approve or deny one action. It has no Submit, so no `submitLabel`, and
+ * `allowDecline` defaults to false because deny is already the negative answer.
+ */
+export declare const confirmAskInputSchema: z.ZodObject<{
+    allowDecline: z.ZodOptional<z.ZodBoolean>;
+    confirmLabel: z.ZodOptional<z.ZodString>;
+    denyLabel: z.ZodOptional<z.ZodString>;
+    destructive: z.ZodOptional<z.ZodBoolean>;
+    prompt: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type ConfirmAskInput = z.infer<typeof confirmAskInputSchema>;
+/** The fields of a `markdown` input that its length rules read. */
+interface MarkdownRuleInput {
+    initial?: string;
+    maxLength?: number;
+    minLength?: number;
+}
+/**
+ * How long an answer to a `markdown` ask may be. `max` counts UTF-16 code units (the `length` of a
+ * JavaScript string, so most emoji count as 2 or more) and defaults to the 20,000 cap. `min`
+ * counts the text without spaces at either end and defaults to 0.
+ */
+export declare const markdownLengthBounds: (input: MarkdownRuleInput) => {
+    max: number;
+    min: number;
+};
+/** Input for `ask_markdown`: the user edits a markdown draft and sends it back. */
+export declare const markdownAskInputSchema: z.ZodObject<{
+    initial: z.ZodOptional<z.ZodString>;
+    maxLength: z.ZodOptional<z.ZodNumber>;
+    minLength: z.ZodOptional<z.ZodNumber>;
+    placeholder: z.ZodOptional<z.ZodString>;
+    allowDecline: z.ZodOptional<z.ZodBoolean>;
+    prompt: z.ZodString;
+    submitLabel: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type MarkdownAskInput = z.infer<typeof markdownAskInputSchema>;
+/** The field types a `form` offers. Every field is flat: no nesting and no conditional fields. */
+export declare const FORM_FIELD_TYPES: readonly ["text", "textarea", "email", "url", "phone", "number", "date", "time", "datetime", "boolean", "select", "multiselect"];
+export type FormFieldType = (typeof FORM_FIELD_TYPES)[number];
+export declare const formFieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    default: z.ZodOptional<z.ZodString>;
+    maxLength: z.ZodOptional<z.ZodNumber>;
+    minLength: z.ZodOptional<z.ZodNumber>;
+    helperText: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    label: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"text">;
+}, z.core.$strict>, z.ZodObject<{
+    default: z.ZodOptional<z.ZodString>;
+    maxLength: z.ZodOptional<z.ZodNumber>;
+    minLength: z.ZodOptional<z.ZodNumber>;
+    helperText: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    label: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"textarea">;
+}, z.core.$strict>, z.ZodObject<{
+    default: z.ZodOptional<z.ZodString>;
+    helperText: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    label: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"email">;
+}, z.core.$strict>, z.ZodObject<{
+    default: z.ZodOptional<z.ZodString>;
+    helperText: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    label: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"url">;
+}, z.core.$strict>, z.ZodObject<{
+    default: z.ZodOptional<z.ZodString>;
+    helperText: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    label: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"phone">;
+}, z.core.$strict>, z.ZodObject<{
+    default: z.ZodOptional<z.ZodNumber>;
+    integer: z.ZodOptional<z.ZodBoolean>;
+    max: z.ZodOptional<z.ZodNumber>;
+    min: z.ZodOptional<z.ZodNumber>;
+    helperText: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    label: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"number">;
+}, z.core.$strict>, z.ZodObject<{
+    default: z.ZodOptional<z.ZodString>;
+    helperText: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    label: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"date">;
+}, z.core.$strict>, z.ZodObject<{
+    default: z.ZodOptional<z.ZodString>;
+    helperText: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    label: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"time">;
+}, z.core.$strict>, z.ZodObject<{
+    default: z.ZodOptional<z.ZodString>;
+    helperText: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    label: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"datetime">;
+}, z.core.$strict>, z.ZodObject<{
+    default: z.ZodOptional<z.ZodBoolean>;
+    helperText: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    label: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"boolean">;
+}, z.core.$strict>, z.ZodObject<{
+    default: z.ZodOptional<z.ZodString>;
+    options: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strict>>;
+    helperText: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    label: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"select">;
+}, z.core.$strict>, z.ZodObject<{
+    default: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    options: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strict>>;
+    helperText: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    label: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"multiselect">;
+}, z.core.$strict>], "type">;
+export type FormField = z.infer<typeof formFieldSchema>;
+/** Input for `ask_form`: a few flat fields the user fills in and submits at once. */
+export declare const formAskInputSchema: z.ZodObject<{
+    fields: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        default: z.ZodOptional<z.ZodString>;
+        maxLength: z.ZodOptional<z.ZodNumber>;
+        minLength: z.ZodOptional<z.ZodNumber>;
+        helperText: z.ZodOptional<z.ZodString>;
+        id: z.ZodString;
+        label: z.ZodString;
+        required: z.ZodOptional<z.ZodBoolean>;
+        type: z.ZodLiteral<"text">;
+    }, z.core.$strict>, z.ZodObject<{
+        default: z.ZodOptional<z.ZodString>;
+        maxLength: z.ZodOptional<z.ZodNumber>;
+        minLength: z.ZodOptional<z.ZodNumber>;
+        helperText: z.ZodOptional<z.ZodString>;
+        id: z.ZodString;
+        label: z.ZodString;
+        required: z.ZodOptional<z.ZodBoolean>;
+        type: z.ZodLiteral<"textarea">;
+    }, z.core.$strict>, z.ZodObject<{
+        default: z.ZodOptional<z.ZodString>;
+        helperText: z.ZodOptional<z.ZodString>;
+        id: z.ZodString;
+        label: z.ZodString;
+        required: z.ZodOptional<z.ZodBoolean>;
+        type: z.ZodLiteral<"email">;
+    }, z.core.$strict>, z.ZodObject<{
+        default: z.ZodOptional<z.ZodString>;
+        helperText: z.ZodOptional<z.ZodString>;
+        id: z.ZodString;
+        label: z.ZodString;
+        required: z.ZodOptional<z.ZodBoolean>;
+        type: z.ZodLiteral<"url">;
+    }, z.core.$strict>, z.ZodObject<{
+        default: z.ZodOptional<z.ZodString>;
+        helperText: z.ZodOptional<z.ZodString>;
+        id: z.ZodString;
+        label: z.ZodString;
+        required: z.ZodOptional<z.ZodBoolean>;
+        type: z.ZodLiteral<"phone">;
+    }, z.core.$strict>, z.ZodObject<{
+        default: z.ZodOptional<z.ZodNumber>;
+        integer: z.ZodOptional<z.ZodBoolean>;
+        max: z.ZodOptional<z.ZodNumber>;
+        min: z.ZodOptional<z.ZodNumber>;
+        helperText: z.ZodOptional<z.ZodString>;
+        id: z.ZodString;
+        label: z.ZodString;
+        required: z.ZodOptional<z.ZodBoolean>;
+        type: z.ZodLiteral<"number">;
+    }, z.core.$strict>, z.ZodObject<{
+        default: z.ZodOptional<z.ZodString>;
+        helperText: z.ZodOptional<z.ZodString>;
+        id: z.ZodString;
+        label: z.ZodString;
+        required: z.ZodOptional<z.ZodBoolean>;
+        type: z.ZodLiteral<"date">;
+    }, z.core.$strict>, z.ZodObject<{
+        default: z.ZodOptional<z.ZodString>;
+        helperText: z.ZodOptional<z.ZodString>;
+        id: z.ZodString;
+        label: z.ZodString;
+        required: z.ZodOptional<z.ZodBoolean>;
+        type: z.ZodLiteral<"time">;
+    }, z.core.$strict>, z.ZodObject<{
+        default: z.ZodOptional<z.ZodString>;
+        helperText: z.ZodOptional<z.ZodString>;
+        id: z.ZodString;
+        label: z.ZodString;
+        required: z.ZodOptional<z.ZodBoolean>;
+        type: z.ZodLiteral<"datetime">;
+    }, z.core.$strict>, z.ZodObject<{
+        default: z.ZodOptional<z.ZodBoolean>;
+        helperText: z.ZodOptional<z.ZodString>;
+        id: z.ZodString;
+        label: z.ZodString;
+        required: z.ZodOptional<z.ZodBoolean>;
+        type: z.ZodLiteral<"boolean">;
+    }, z.core.$strict>, z.ZodObject<{
+        default: z.ZodOptional<z.ZodString>;
+        options: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strict>>;
+        helperText: z.ZodOptional<z.ZodString>;
+        id: z.ZodString;
+        label: z.ZodString;
+        required: z.ZodOptional<z.ZodBoolean>;
+        type: z.ZodLiteral<"select">;
+    }, z.core.$strict>, z.ZodObject<{
+        default: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        options: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strict>>;
+        helperText: z.ZodOptional<z.ZodString>;
+        id: z.ZodString;
+        label: z.ZodString;
+        required: z.ZodOptional<z.ZodBoolean>;
+        type: z.ZodLiteral<"multiselect">;
+    }, z.core.$strict>], "type">>;
+    allowDecline: z.ZodOptional<z.ZodBoolean>;
+    prompt: z.ZodString;
+    submitLabel: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type FormAskInput = z.infer<typeof formAskInputSchema>;
+/** The `content` of an accepted answer from any client, before its values meet their fields. */
+export declare const formAnswerEnvelopeSchema: z.ZodObject<{
+    values: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strict>;
+/**
+ * The `content` of an accepted `form` answer: one value per answered field, keyed by field id.
+ * Unanswered optional fields are left out.
+ */
+export declare const formAnswerSchema: z.ZodObject<{
+    values: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+}, z.core.$strict>;
+export type FormAnswer = z.infer<typeof formAnswerSchema>;
+/** The fields of a `files` input that its count rules read. */
+interface FilesRuleInput {
+    accept: AskFileAccept[];
+    maxFiles?: number;
+    minFiles?: number;
+}
+/** How many files an answer to a `files` ask must carry: 1 to 10 unless the ask narrows it. */
+export declare const filesCountBounds: (input: FilesRuleInput) => {
+    max: number;
+    min: number;
+};
+/** Input for `ask_files`: the user uploads one or more images or documents. */
+export declare const filesAskInputSchema: z.ZodObject<{
+    accept: z.ZodArray<z.ZodEnum<{
+        text: "text";
+        image: "image";
+        pdf: "pdf";
+        csv: "csv";
+        json: "json";
+    }>>;
+    maxFiles: z.ZodOptional<z.ZodNumber>;
+    minFiles: z.ZodOptional<z.ZodNumber>;
+    allowDecline: z.ZodOptional<z.ZodBoolean>;
+    prompt: z.ZodString;
+    submitLabel: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type FilesAskInput = z.infer<typeof filesAskInputSchema>;
+/** One file in an accepted `files` answer: an upload (`fileId`) or inline bytes (`url`). */
+export declare const askFileRefSchema: z.ZodObject<{
+    fileId: z.ZodOptional<z.ZodString>;
+    filename: z.ZodString;
+    mimeType: z.ZodString;
+    size: z.ZodNumber;
+    url: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type AskFileRef = z.infer<typeof askFileRefSchema>;
+/** The `content` of an accepted `files` answer: the files the user sent, in the order they chose. */
+export declare const filesAnswerSchema: z.ZodObject<{
+    files: z.ZodArray<z.ZodObject<{
+        fileId: z.ZodOptional<z.ZodString>;
+        filename: z.ZodString;
+        mimeType: z.ZodString;
+        size: z.ZodNumber;
+        url: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type FilesAnswer = z.infer<typeof filesAnswerSchema>;
+/** The `content` of an accepted `choice` answer. */
+export declare const choiceAnswerSchema: z.ZodObject<{
+    other: z.ZodOptional<z.ZodString>;
+    selected: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export type ChoiceAnswer = z.infer<typeof choiceAnswerSchema>;
+export declare const askAcceptResponseSchema: z.ZodObject<{
+    action: z.ZodLiteral<"accept">;
+    content: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strict>;
+export declare const askDeclineResponseSchema: z.ZodObject<{
+    action: z.ZodLiteral<"decline">;
+}, z.core.$strict>;
+export declare const askCancelResponseSchema: z.ZodObject<{
+    action: z.ZodLiteral<"cancel">;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/**
+ * The answer envelope for every ask (the MCP elicitation shape). `accept` carries the kind's
+ * answer in `content`; `decline` means the user pressed Skip; `cancel` means the ask was dropped.
+ */
+export declare const askResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    action: z.ZodLiteral<"accept">;
+    content: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"decline">;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"cancel">;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>], "action">;
+export type AskResponse = z.infer<typeof askResponseSchema>;
+/** The answer envelope for `ask_choice`, with `content` typed. Used as the tool's output schema. */
+export declare const choiceAskResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    action: z.ZodLiteral<"accept">;
+    content: z.ZodObject<{
+        other: z.ZodOptional<z.ZodString>;
+        selected: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"decline">;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"cancel">;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>], "action">;
+export type ChoiceAskResponse = z.infer<typeof choiceAskResponseSchema>;
+/** The `content` of an accepted `confirm` answer: true approves the action, false denies it. */
+export declare const confirmAnswerSchema: z.ZodObject<{
+    confirmed: z.ZodBoolean;
+}, z.core.$strict>;
+export type ConfirmAnswer = z.infer<typeof confirmAnswerSchema>;
+/** The answer envelope for `ask_confirm`, with `content` typed. Used as the tool's output schema. */
+export declare const confirmAskResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    action: z.ZodLiteral<"accept">;
+    content: z.ZodObject<{
+        confirmed: z.ZodBoolean;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"decline">;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"cancel">;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>], "action">;
+export type ConfirmAskResponse = z.infer<typeof confirmAskResponseSchema>;
+/**
+ * The `content` of an accepted `markdown` answer: the text the user sends back, and whether it
+ * differs from the ask's `initial` draft.
+ */
+export declare const markdownAnswerSchema: z.ZodObject<{
+    changed: z.ZodBoolean;
+    markdown: z.ZodString;
+}, z.core.$strict>;
+export type MarkdownAnswer = z.infer<typeof markdownAnswerSchema>;
+/** The answer envelope for `ask_markdown`, with `content` typed. Used as the tool's output schema. */
+export declare const markdownAskResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    action: z.ZodLiteral<"accept">;
+    content: z.ZodObject<{
+        changed: z.ZodBoolean;
+        markdown: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"decline">;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"cancel">;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>], "action">;
+export type MarkdownAskResponse = z.infer<typeof markdownAskResponseSchema>;
+/** The answer envelope for `ask_form`, with `content` typed. Used as the tool's output schema. */
+export declare const formAskResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    action: z.ZodLiteral<"accept">;
+    content: z.ZodObject<{
+        values: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"decline">;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"cancel">;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>], "action">;
+export type FormAskResponse = z.infer<typeof formAskResponseSchema>;
+/** The answer envelope for `ask_files`, with `content` typed. Used as the tool's output schema. */
+export declare const filesAskResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    action: z.ZodLiteral<"accept">;
+    content: z.ZodObject<{
+        files: z.ZodArray<z.ZodObject<{
+            fileId: z.ZodOptional<z.ZodString>;
+            filename: z.ZodString;
+            mimeType: z.ZodString;
+            size: z.ZodNumber;
+            url: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"decline">;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"cancel">;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>], "action">;
+export type FilesAskResponse = z.infer<typeof filesAskResponseSchema>;
+/** Input schemas by kind. */
+export declare const askInputSchemas: {
+    readonly choice: z.ZodObject<{
+        allowOther: z.ZodOptional<z.ZodBoolean>;
+        maxSelected: z.ZodOptional<z.ZodNumber>;
+        minSelected: z.ZodOptional<z.ZodNumber>;
+        otherLabel: z.ZodOptional<z.ZodString>;
+        select: z.ZodEnum<{
+            one: "one";
+            many: "many";
+        }>;
+        default: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        options: z.ZodArray<z.ZodObject<{
+            description: z.ZodOptional<z.ZodString>;
+            id: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strict>>;
+        allowDecline: z.ZodOptional<z.ZodBoolean>;
+        prompt: z.ZodString;
+        submitLabel: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly confirm: z.ZodObject<{
+        allowDecline: z.ZodOptional<z.ZodBoolean>;
+        confirmLabel: z.ZodOptional<z.ZodString>;
+        denyLabel: z.ZodOptional<z.ZodString>;
+        destructive: z.ZodOptional<z.ZodBoolean>;
+        prompt: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly files: z.ZodObject<{
+        accept: z.ZodArray<z.ZodEnum<{
+            text: "text";
+            image: "image";
+            pdf: "pdf";
+            csv: "csv";
+            json: "json";
+        }>>;
+        maxFiles: z.ZodOptional<z.ZodNumber>;
+        minFiles: z.ZodOptional<z.ZodNumber>;
+        allowDecline: z.ZodOptional<z.ZodBoolean>;
+        prompt: z.ZodString;
+        submitLabel: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly form: z.ZodObject<{
+        fields: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            default: z.ZodOptional<z.ZodString>;
+            maxLength: z.ZodOptional<z.ZodNumber>;
+            minLength: z.ZodOptional<z.ZodNumber>;
+            helperText: z.ZodOptional<z.ZodString>;
+            id: z.ZodString;
+            label: z.ZodString;
+            required: z.ZodOptional<z.ZodBoolean>;
+            type: z.ZodLiteral<"text">;
+        }, z.core.$strict>, z.ZodObject<{
+            default: z.ZodOptional<z.ZodString>;
+            maxLength: z.ZodOptional<z.ZodNumber>;
+            minLength: z.ZodOptional<z.ZodNumber>;
+            helperText: z.ZodOptional<z.ZodString>;
+            id: z.ZodString;
+            label: z.ZodString;
+            required: z.ZodOptional<z.ZodBoolean>;
+            type: z.ZodLiteral<"textarea">;
+        }, z.core.$strict>, z.ZodObject<{
+            default: z.ZodOptional<z.ZodString>;
+            helperText: z.ZodOptional<z.ZodString>;
+            id: z.ZodString;
+            label: z.ZodString;
+            required: z.ZodOptional<z.ZodBoolean>;
+            type: z.ZodLiteral<"email">;
+        }, z.core.$strict>, z.ZodObject<{
+            default: z.ZodOptional<z.ZodString>;
+            helperText: z.ZodOptional<z.ZodString>;
+            id: z.ZodString;
+            label: z.ZodString;
+            required: z.ZodOptional<z.ZodBoolean>;
+            type: z.ZodLiteral<"url">;
+        }, z.core.$strict>, z.ZodObject<{
+            default: z.ZodOptional<z.ZodString>;
+            helperText: z.ZodOptional<z.ZodString>;
+            id: z.ZodString;
+            label: z.ZodString;
+            required: z.ZodOptional<z.ZodBoolean>;
+            type: z.ZodLiteral<"phone">;
+        }, z.core.$strict>, z.ZodObject<{
+            default: z.ZodOptional<z.ZodNumber>;
+            integer: z.ZodOptional<z.ZodBoolean>;
+            max: z.ZodOptional<z.ZodNumber>;
+            min: z.ZodOptional<z.ZodNumber>;
+            helperText: z.ZodOptional<z.ZodString>;
+            id: z.ZodString;
+            label: z.ZodString;
+            required: z.ZodOptional<z.ZodBoolean>;
+            type: z.ZodLiteral<"number">;
+        }, z.core.$strict>, z.ZodObject<{
+            default: z.ZodOptional<z.ZodString>;
+            helperText: z.ZodOptional<z.ZodString>;
+            id: z.ZodString;
+            label: z.ZodString;
+            required: z.ZodOptional<z.ZodBoolean>;
+            type: z.ZodLiteral<"date">;
+        }, z.core.$strict>, z.ZodObject<{
+            default: z.ZodOptional<z.ZodString>;
+            helperText: z.ZodOptional<z.ZodString>;
+            id: z.ZodString;
+            label: z.ZodString;
+            required: z.ZodOptional<z.ZodBoolean>;
+            type: z.ZodLiteral<"time">;
+        }, z.core.$strict>, z.ZodObject<{
+            default: z.ZodOptional<z.ZodString>;
+            helperText: z.ZodOptional<z.ZodString>;
+            id: z.ZodString;
+            label: z.ZodString;
+            required: z.ZodOptional<z.ZodBoolean>;
+            type: z.ZodLiteral<"datetime">;
+        }, z.core.$strict>, z.ZodObject<{
+            default: z.ZodOptional<z.ZodBoolean>;
+            helperText: z.ZodOptional<z.ZodString>;
+            id: z.ZodString;
+            label: z.ZodString;
+            required: z.ZodOptional<z.ZodBoolean>;
+            type: z.ZodLiteral<"boolean">;
+        }, z.core.$strict>, z.ZodObject<{
+            default: z.ZodOptional<z.ZodString>;
+            options: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+            }, z.core.$strict>>;
+            helperText: z.ZodOptional<z.ZodString>;
+            id: z.ZodString;
+            label: z.ZodString;
+            required: z.ZodOptional<z.ZodBoolean>;
+            type: z.ZodLiteral<"select">;
+        }, z.core.$strict>, z.ZodObject<{
+            default: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            options: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+            }, z.core.$strict>>;
+            helperText: z.ZodOptional<z.ZodString>;
+            id: z.ZodString;
+            label: z.ZodString;
+            required: z.ZodOptional<z.ZodBoolean>;
+            type: z.ZodLiteral<"multiselect">;
+        }, z.core.$strict>], "type">>;
+        allowDecline: z.ZodOptional<z.ZodBoolean>;
+        prompt: z.ZodString;
+        submitLabel: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly markdown: z.ZodObject<{
+        initial: z.ZodOptional<z.ZodString>;
+        maxLength: z.ZodOptional<z.ZodNumber>;
+        minLength: z.ZodOptional<z.ZodNumber>;
+        placeholder: z.ZodOptional<z.ZodString>;
+        allowDecline: z.ZodOptional<z.ZodBoolean>;
+        prompt: z.ZodString;
+        submitLabel: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+};
+/** Input schemas by kind on the compact surface. Every compact input is also a valid full input. */
+export declare const compactAskInputSchemas: {
+    readonly choice: z.ZodObject<{
+        select: z.ZodLiteral<"one">;
+        default: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        options: z.ZodArray<z.ZodObject<{
+            description: z.ZodOptional<z.ZodString>;
+            id: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strict>>;
+        allowDecline: z.ZodOptional<z.ZodBoolean>;
+        prompt: z.ZodString;
+        submitLabel: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly confirm: z.ZodObject<{
+        allowDecline: z.ZodOptional<z.ZodBoolean>;
+        confirmLabel: z.ZodOptional<z.ZodString>;
+        denyLabel: z.ZodOptional<z.ZodString>;
+        destructive: z.ZodOptional<z.ZodBoolean>;
+        prompt: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+};
+export declare const isCompactAskKind: (kind: AskKind) => kind is CompactAskKind;
+/** The kinds a surface offers, in the given order. The compact surface drops kinds it cannot show. */
+export declare const askKindsForSurface: ({ kinds, surface, }: {
+    kinds: readonly AskKind[];
+    surface: AskSurface;
+}) => AskKind[];
+/**
+ * The input schema for a kind on a surface. Throws for an unknown kind or surface, and when the
+ * compact surface does not offer the kind.
+ */
+export declare const askInputSchemaFor: ({ kind, surface, }: {
+    kind: AskKind;
+    surface?: AskSurface;
+}) => (typeof askInputSchemas)[AskKind] | (typeof compactAskInputSchemas)[CompactAskKind];
+/** Output (answer envelope) schemas by kind. */
+export declare const askOutputSchemas: {
+    readonly choice: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        action: z.ZodLiteral<"accept">;
+        content: z.ZodObject<{
+            other: z.ZodOptional<z.ZodString>;
+            selected: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        action: z.ZodLiteral<"decline">;
+    }, z.core.$strict>, z.ZodObject<{
+        action: z.ZodLiteral<"cancel">;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>], "action">;
+    readonly confirm: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        action: z.ZodLiteral<"accept">;
+        content: z.ZodObject<{
+            confirmed: z.ZodBoolean;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        action: z.ZodLiteral<"decline">;
+    }, z.core.$strict>, z.ZodObject<{
+        action: z.ZodLiteral<"cancel">;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>], "action">;
+    readonly files: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        action: z.ZodLiteral<"accept">;
+        content: z.ZodObject<{
+            files: z.ZodArray<z.ZodObject<{
+                fileId: z.ZodOptional<z.ZodString>;
+                filename: z.ZodString;
+                mimeType: z.ZodString;
+                size: z.ZodNumber;
+                url: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        action: z.ZodLiteral<"decline">;
+    }, z.core.$strict>, z.ZodObject<{
+        action: z.ZodLiteral<"cancel">;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>], "action">;
+    readonly form: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        action: z.ZodLiteral<"accept">;
+        content: z.ZodObject<{
+            values: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        action: z.ZodLiteral<"decline">;
+    }, z.core.$strict>, z.ZodObject<{
+        action: z.ZodLiteral<"cancel">;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>], "action">;
+    readonly markdown: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        action: z.ZodLiteral<"accept">;
+        content: z.ZodObject<{
+            changed: z.ZodBoolean;
+            markdown: z.ZodString;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        action: z.ZodLiteral<"decline">;
+    }, z.core.$strict>, z.ZodObject<{
+        action: z.ZodLiteral<"cancel">;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>], "action">;
+};
+export interface ChoiceAsk {
+    input: ChoiceAskInput;
+    kind: "choice";
+}
+export interface ConfirmAsk {
+    input: ConfirmAskInput;
+    kind: "confirm";
+}
+export interface MarkdownAsk {
+    input: MarkdownAskInput;
+    kind: "markdown";
+}
+export interface FormAsk {
+    input: FormAskInput;
+    kind: "form";
+}
+export interface FilesAsk {
+    input: FilesAskInput;
+    kind: "files";
+}
+/** A validated ask: its kind and its input. */
+export type Ask = ChoiceAsk | ConfirmAsk | MarkdownAsk | FormAsk | FilesAsk;
+/**
+ * Whether the user may skip the ask. `allowDecline` defaults to true, except on `confirm`, where
+ * deny is already the negative answer.
+ */
+export declare const askAllowsDecline: ({ input, kind }: Ask) => boolean;
+export {};