@tai42/api-client 20.0.0 → 22.0.0

package/dist/schemas/interactions.d.ts

@@ -2,78 +2,68 @@
 import { z } from 'zod';
 export declare const answerFormat: z.ZodEnum<{
     text: "text";
-    external: "external";
+    free: "free";
     confirm: "confirm";
-    select: "select";
     form: "form";
+    select: "select";
+    external: "external";
 }>;
 export type AnswerFormat = z.infer<typeof answerFormat>;
-/** The kind of a question's display-only media item: a remote/inline image, or a link. */
+/** The kind of a display-only media item: an image, a link, or a document, video or audio file. */
 export declare const mediaKind: z.ZodEnum<{
-    link: "link";
     image: "image";
+    link: "link";
+    document: "document";
+    video: "video";
+    audio: "audio";
 }>;
 export type MediaKind = z.infer<typeof mediaKind>;
 /**
- * One item of a question's display-only media. Applied PER ITEM by the renderer
- * (never as a strict array on the frame): the frame's `media` field is a loose
- * `z.array(z.unknown())`, and the renderer `safeParse`s each item with this schema
- * so one malformed/hostile item is a loud per-item notice, not a whole-frame parse
- * failure that would silently vanish an answerable question.
- *
- * `caption` is `.nullish()` (absent OR `null` both parse to a caption-less item):
- * a caption-less item may arrive with the key omitted OR with an explicit `null`, so
- * `.optional()` here would false-fail the explicit `null` and render a good image as
- * malformed. `url` and `kind` are the only load-bearing fields; the image
- * src scheme gate and the link neutralization are enforced by the renderer.
+ * One item of a question's display-only media. The renderer resolves `url` (the image src
+ * scheme gate and the link neutralization are enforced there); `caption` and `filename`
+ * are `null` when absent.
  */
 export declare const interactionMediaItem: z.ZodObject<{
+    caption: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    filename: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     kind: z.ZodEnum<{
-        link: "link";
         image: "image";
+        link: "link";
+        document: "document";
+        video: "video";
+        audio: "audio";
     }>;
     url: z.ZodString;
-    caption: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, z.core.$strip>;
+}, z.core.$strict>;
 export type InteractionMediaItem = z.infer<typeof interactionMediaItem>;
-/**
- * The kind of a byte-backed inbound attachment carried on a transcript record. A
- * fetchable file — `image`/`document`/`audio`/`video` — never a `link`: a labelled
- * anchor is question CONTEXT (see {@link mediaKind}), not a participant's sent file.
- */
+/** The kind of an inbound attachment carried on a transcript record. */
 export declare const attachmentMediaKind: z.ZodEnum<{
     image: "image";
-    audio: "audio";
+    link: "link";
     document: "document";
     video: "video";
+    audio: "audio";
 }>;
 export type AttachmentMediaKind = z.infer<typeof attachmentMediaKind>;
 /**
  * One inbound attachment a participant sent, projected onto a transcript record's
- * `inbound_attachments`. Applied PER ITEM by the renderer (the record's array is a
- * loose `z.array(z.unknown())`, `safeParse`d per member) so one malformed/hostile
- * item is a loud per-item notice, never a whole-record parse failure that would
- * vanish the transcript.
- *
- * `url` is the served-media reference the renderer resolves to the API origin (the
- * same served-url discipline the ask-media renderer uses); the image src scheme gate
- * and the per-item load-failure notice are enforced there. `caption` and `filename`
- * are `.nullish()` (absent OR explicit `null` both parse to absent): the projection
- * may omit the key OR emit `null`, so `.optional()` alone would false-fail an explicit
- * `null`. `filename` is meaningful only for a `document`; the renderer shows it as the
- * download label.
+ * `inbound_attachments`. `url` is the served-media reference the renderer resolves to the
+ * API origin (the same served-url discipline the ask-media renderer uses); the image src
+ * scheme gate and the per-item load-failure notice are enforced there. `filename` is
+ * meaningful only for a `document`; the renderer shows it as the download label.
  */
 export declare const attachmentMediaItem: z.ZodObject<{
+    caption: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    filename: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     kind: z.ZodEnum<{
         image: "image";
-        audio: "audio";
+        link: "link";
         document: "document";
         video: "video";
+        audio: "audio";
     }>;
     url: z.ZodString;
-    caption: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    filename: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, z.core.$strip>;
+}, z.core.$strict>;
 export type AttachmentMediaItem = z.infer<typeof attachmentMediaItem>;
 /**
  * One per-send choice for a `form` property whose schema is a string (or array of
@@ -83,9 +73,9 @@ export type AttachmentMediaItem = z.infer<typeof attachmentMediaItem>;
  * the form preview (safeParsed), so a malformed entry is a loud notice, never silent.
  */
 export declare const formOption: z.ZodObject<{
+    label: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     value: z.ZodString;
-    label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, z.core.$strip>;
+}, z.core.$strict>;
 export type FormOption = z.infer<typeof formOption>;
 /**
  * Per-send `form` data: `values` prefills top-level properties (keyed by property
@@ -94,18 +84,18 @@ export type FormOption = z.infer<typeof formOption>;
  * malformed block is a loud notice rather than a whole-frame parse failure.
  */
 export declare const formData: z.ZodObject<{
-    values: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     options: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+        label: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         value: z.ZodString;
-        label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    }, z.core.$strip>>>>;
-}, z.core.$strip>;
+    }, z.core.$strict>>>>;
+    values: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>;
 export type FormData = z.infer<typeof formData>;
 /** The kind of an ordered display block a page may carry alongside its input fields. */
 export declare const displayBlockKind: z.ZodEnum<{
-    image: "image";
     heading: "heading";
     body: "body";
+    image: "image";
 }>;
 export type DisplayBlockKind = z.infer<typeof displayBlockKind>;
 /**
@@ -120,16 +110,16 @@ export type DisplayBlockKind = z.infer<typeof displayBlockKind>;
  * so a malformed block is a loud notice, never silent.
  */
 export declare const displayBlock: z.ZodObject<{
+    alt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     kind: z.ZodEnum<{
-        image: "image";
         heading: "heading";
         body: "body";
+        image: "image";
     }>;
-    text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    src: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    alt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    slot: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, z.core.$strip>;
+    slot: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    src: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    text: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
 export type DisplayBlock = z.infer<typeof displayBlock>;
 /** A page's role: an ordinary `input` page (default) or a terminal `review` summary. */
 export declare const formPageKind: z.ZodEnum<{
@@ -146,50 +136,299 @@ export type FormPageKind = z.infer<typeof formPageKind>;
  * instead of, for a review page) its input fields; it defaults to empty, so a page that
  * carries none renders exactly as before. `kind` marks a `review` page — a terminal
  * summary step that shows the readback of entered values and the confirm/submit footer
- * and carries no new input fields; it defaults to `input`. Both are additive: an older
+ * and carries no new input fields; it defaults to `input`. `button_label` is the text of
+ * the page's primary button — the one that advances from an input page, or submits from
+ * the last — in the sender's words and the end-user's language; absent (`null`), the
+ * surface shows its own generic word ("Next"/"Submit"/"Confirm"). All additive: an older
  * payload ({title, fields}) parses unchanged.
  */
 export declare const formPage: z.ZodObject<{
-    title: z.ZodString;
-    fields: z.ZodArray<z.ZodString>;
     display: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        alt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         kind: z.ZodEnum<{
-            image: "image";
             heading: "heading";
             body: "body";
+            image: "image";
         }>;
-        text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        src: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        alt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        slot: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    }, z.core.$strip>>>;
+        slot: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        src: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        text: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>>>;
+    fields: z.ZodArray<z.ZodString>;
     kind: z.ZodDefault<z.ZodEnum<{
         input: "input";
         review: "review";
     }>>;
-}, z.core.$strip>;
+    title: z.ZodString;
+    button_label: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
 export type FormPage = z.infer<typeof formPage>;
 /** The `form` pages list (`format_payload.pages`), safeParsed as a whole by the preview. */
 export declare const formPages: z.ZodArray<z.ZodObject<{
-    title: z.ZodString;
-    fields: z.ZodArray<z.ZodString>;
     display: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        alt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         kind: z.ZodEnum<{
-            image: "image";
             heading: "heading";
             body: "body";
+            image: "image";
         }>;
-        text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        src: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        alt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        slot: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    }, z.core.$strip>>>;
+        slot: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        src: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        text: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>>>;
+    fields: z.ZodArray<z.ZodString>;
     kind: z.ZodDefault<z.ZodEnum<{
         input: "input";
         review: "review";
     }>>;
-}, z.core.$strip>>;
+    title: z.ZodString;
+    button_label: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>>;
 export type FormPages = z.infer<typeof formPages>;
+/**
+ * One form field's platform-drawn words (`wording.form.fields[name]`): `choice_label` is
+ * the placeholder of the field's picker (its empty-state prompt).
+ */
+export declare const fieldWording: z.ZodObject<{
+    choice_label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type FieldWording = z.infer<typeof fieldWording>;
+/**
+ * A form's platform-drawn chrome (`wording.form`): `title` heads the form surface;
+ * `open`/`cancel` label the buttons that open and close it; `back` the button that returns
+ * to the previous step; `submit` the terminal button of a form with no pages;
+ * `review_empty` the review step's line before anything is filled; `fields` carries
+ * per-field words keyed by property name. The inbox draws the form inline, so it reads
+ * `back`, `submit` and `fields`; `title`/`open`/`cancel`/`review_empty` parse unused.
+ */
+export declare const formWording: z.ZodObject<{
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    open: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    cancel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    back: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    submit: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    review_empty: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    fields: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodObject<{
+        choice_label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>>;
+}, z.core.$strip>;
+export type FormWording = z.infer<typeof formWording>;
+/**
+ * A choice list's platform-drawn words (`wording.choice`): `label` is the word on the
+ * control that presents the list, `reply_hint` the line under a numbered-text list, and
+ * `group_label` the accessible name of a flat group of option buttons. The inbox reads
+ * `label` (the select field's label and picker placeholder); the rest parse unused.
+ */
+export declare const choiceWording: z.ZodObject<{
+    label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    reply_hint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    group_label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type ChoiceWording = z.infer<typeof choiceWording>;
+/**
+ * A non-form question's answer controls and refusal sentences (`wording.answer`): `open`
+ * labels the control that opens a `confirm`/`external` question's answer page, `confirm`
+ * its affirmative control, `decline` its negative control, `submit` the button that sends a
+ * typed or picked answer, `reply_hint` the hint in an empty reply input. `rejected` /
+ * `rejected_final` are the sentences the end user reads when an answer is refused; the
+ * inbox draws neither (web-only). The inbox reads `open`, `confirm`, `decline`, `submit`
+ * and `reply_hint` where it draws the matching control.
+ */
+export declare const answerWording: z.ZodObject<{
+    open: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    confirm: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    decline: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    submit: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    reply_hint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    rejected: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    rejected_final: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type AnswerWording = z.infer<typeof answerWording>;
+/**
+ * The lines of a delivery message (`wording.lines`): `answer_link` carries the tappable
+ * answer link, `deadline` names the deadline, `reply` tells the end user how to reply, and
+ * `options` lists the choices. Drawn by the chat channels; the inbox draws none of them.
+ */
+export declare const lineWording: z.ZodObject<{
+    answer_link: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    deadline: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    reply: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    options: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type LineWording = z.infer<typeof lineWording>;
+/** The heading and sentence of one platform-drawn answer page (`wording.answer_page.*`). */
+export declare const pageCopy: z.ZodObject<{
+    heading: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type PageCopy = z.infer<typeof pageCopy>;
+/**
+ * The form page's own sentences (`wording.answer_page.form`): `failed` when a send did not
+ * land, `network_error` when the browser could not reach the server, `update_failed` when a
+ * reacting form could not refresh, `choose_one` for an empty required multi-choice, and
+ * `date_unavailable` for a blocked date. Drawn by the callback form page; the inbox draws
+ * none of them.
+ */
+export declare const formPageWording: z.ZodObject<{
+    failed: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    network_error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    update_failed: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    choose_one: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    date_unavailable: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type FormPageWording = z.infer<typeof formPageWording>;
+/**
+ * The pages a question's link opens (`wording.answer_page`): `confirm` the confirm page's
+ * copy, `done` the already-answered page's, `awaiting` the reply-on-the-channel page's,
+ * `submitted` the form page's post-submit copy, and `form` the form page's own
+ * validation/error sentences. Drawn by the callback pages; the inbox draws none of them.
+ */
+export declare const answerPageWording: z.ZodObject<{
+    confirm: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        heading: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+    done: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        heading: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+    awaiting: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        heading: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+    submitted: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        heading: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+    form: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        failed: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        network_error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        update_failed: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        choose_one: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        date_unavailable: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type AnswerPageWording = z.infer<typeof answerPageWording>;
+/**
+ * A live question card's countdown words (`wording.status.countdown`): `seconds_left` the
+ * visible plural line, `one_second_left` the visible singular, and `under_minute` /
+ * `under_half_minute` / `under_ten_seconds` the spoken lines at the three thresholds. Drawn
+ * by the web widget; the inbox draws no countdown.
+ */
+export declare const countdownWording: z.ZodObject<{
+    seconds_left: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    one_second_left: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    under_minute: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    under_half_minute: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    under_ten_seconds: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type CountdownWording = z.infer<typeof countdownWording>;
+/**
+ * In-flight and settled status copy (`wording.status`): `sending` the screen-reader label
+ * while a send is in flight, `answered` / `expired` / `closed` the badges once a question
+ * settles, `sent` the badge after an ask-less form is submitted, `unavailable` the line
+ * when a form's door no longer resolves, and `countdown` the live-countdown words. Drawn by
+ * the web widget; the inbox draws none of them.
+ */
+export declare const statusWording: z.ZodObject<{
+    sending: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    answered: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    expired: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    closed: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    sent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    unavailable: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    countdown: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        seconds_left: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        one_second_left: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        under_minute: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        under_half_minute: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        under_ten_seconds: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type StatusWording = z.infer<typeof statusWording>;
+/**
+ * The one catalogue of a send's platform-drawn texts (`format_payload.wording`), grouped
+ * by what each word decorates: the form (`form`), the choice list (`choice`), a question's
+ * answer controls and refusal sentences (`answer`), the lines of the delivery message
+ * (`lines`), the pages a question's link opens (`answer_page`), and in-flight and settled
+ * status (`status`). A page's primary button is the one text not here — it is on the page
+ * (`pages[].button_label`). Every leaf is the sender's own words in the end-user's
+ * language; absent (or `null`), the surface shows its own word.
+ */
+export declare const wording: z.ZodObject<{
+    form: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        open: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        cancel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        back: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        submit: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        review_empty: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        fields: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodObject<{
+            choice_label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>>>;
+    }, z.core.$strip>>>;
+    choice: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        reply_hint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        group_label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+    answer: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        open: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        confirm: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        decline: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        submit: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        reply_hint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        rejected: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        rejected_final: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+    lines: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        answer_link: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        deadline: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        reply: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        options: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+    answer_page: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        confirm: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            heading: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>>;
+        done: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            heading: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>>;
+        awaiting: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            heading: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>>;
+        submitted: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            heading: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>>;
+        form: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            failed: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            network_error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            update_failed: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            choose_one: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            date_unavailable: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+    status: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        sending: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        answered: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        expired: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        closed: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        sent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        unavailable: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        countdown: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            seconds_left: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            one_second_left: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            under_minute: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            under_half_minute: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            under_ten_seconds: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type Wording = z.infer<typeof wording>;
 /**
  * When a `form` reacts while it is open (`format_payload.reactions`): the plain,
  * renderer-readable description of WHEN the form calls its reaction handler. Absent ⇒ a
@@ -209,68 +448,89 @@ export declare const formReactions: z.ZodObject<{
 }, z.core.$strip>;
 export type FormReactions = z.infer<typeof formReactions>;
 /**
- * The form update a reaction door returns (`POST /api/interactions/{id}/react`): the
- * same kind of data a form is sent with, applied to the open form. `values` sets field
- * values; `options` replaces the per-send choice list of option-bearing fields; `errors`
- * shows per-field messages (keyed by field name); `display` fills display slots (keyed by
- * slot name) — a computed total among them. Every member defaults to empty, so a reaction
- * that touches only one of them returns only that one. The door response is safeParsed, so
+ * The form update a reaction door returns (`POST /api/interactions/{id}/react`, its
+ * `update`): the same kind of data a form is sent with, applied to the open form. `values`
+ * sets field values; `options` replaces the per-send choice list of option-bearing fields;
+ * `errors` shows per-field messages (keyed by field name); `display` fills display slots
+ * (keyed by slot name) — a computed total among them. Every member defaults to empty, so a
+ * reaction that touches only one of them returns only that one. The door response is safeParsed, so
  * a malformed update surfaces loudly rather than applying a half-understood change.
  */
 export declare const formUpdate: z.ZodObject<{
     values: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     options: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+        label: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         value: z.ZodString;
-        label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    }, z.core.$strip>>>>;
+    }, z.core.$strict>>>>;
     errors: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
     display: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
 export type FormUpdate = z.infer<typeof formUpdate>;
 /**
- * The event a reaction round-trip reports to the door: `kind` is which of the three
- * declared events fired, `field` names the changed field for a `field_changed` event, and
- * `page` names the advanced-from page (by title) for a `page_advanced` event. A
- * `submitted` event carries neither. The body also carries the partial `values` filled so
- * far (see {@link interactionsClient}'s `reactInteraction`).
+ * The event a reaction round-trip reports to the door (the contract's `FormReactionEvent`
+ * document): `kind` is which of the three declared events fired, `field` names the changed
+ * field for a `field_changed` event, and `page` names the advanced-from page (by title) for a
+ * `page_advanced` event. A `submitted` event carries neither. The body also carries the
+ * partial `values` filled so far (see {@link interactionsClient}'s `reactInteraction`).
  */
-export declare const reactionEventKind: z.ZodEnum<{
-    field_changed: "field_changed";
-    page_advanced: "page_advanced";
-    submitted: "submitted";
-}>;
-export type ReactionEventKind = z.infer<typeof reactionEventKind>;
-export declare const reactionEvent: z.ZodObject<{
-    kind: z.ZodEnum<{
-        field_changed: "field_changed";
-        page_advanced: "page_advanced";
-        submitted: "submitted";
-    }>;
-    field: z.ZodOptional<z.ZodString>;
-    page: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
+export declare const reactionEvent: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    field: z.ZodString;
+    kind: z.ZodDefault<z.ZodLiteral<"field_changed">>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodDefault<z.ZodLiteral<"page_advanced">>;
+    page: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodDefault<z.ZodLiteral<"submitted">>;
+}, z.core.$strict>], "kind">;
 export type ReactionEvent = z.infer<typeof reactionEvent>;
-export declare const interaction: z.ZodObject<{
+export type ReactionEventKind = ReactionEvent['kind'];
+/** The reaction door's reply: the interaction id and the form `update` to apply. */
+export declare const interactionReaction: z.ZodObject<{
     interaction_id: z.ZodString;
-    group_id: z.ZodString;
-    question: z.ZodDefault<z.ZodString>;
+    update: z.ZodObject<{
+        values: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        options: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+            label: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            value: z.ZodString;
+        }, z.core.$strict>>>>;
+        errors: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        display: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type InteractionReaction = z.infer<typeof interactionReaction>;
+export declare const interaction: z.ZodObject<{
     answer_format: z.ZodEnum<{
         text: "text";
-        external: "external";
+        free: "free";
         confirm: "confirm";
-        select: "select";
         form: "form";
+        select: "select";
+        external: "external";
     }>;
-    format_payload: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>, z.ZodTransform<Record<string, unknown>, Record<string, unknown> | null | undefined>>;
+    audience: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    channel: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     created_at: z.ZodString;
+    group_id: z.ZodString;
+    interaction_id: z.ZodString;
+    media: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        caption: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        filename: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        kind: z.ZodEnum<{
+            image: "image";
+            link: "link";
+            document: "document";
+            video: "video";
+            audio: "audio";
+        }>;
+        url: z.ZodString;
+    }, z.core.$strict>>>>;
+    origin: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    question: z.ZodString;
+    recipient: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    sensitive: z.ZodBoolean;
+    server_verified: z.ZodDefault<z.ZodNullable<z.ZodBoolean>>;
     timeout_at: z.ZodString;
-    sensitive: z.ZodDefault<z.ZodBoolean>;
-    server_verified: z.ZodOptional<z.ZodBoolean>;
-    channel: z.ZodOptional<z.ZodString>;
-    recipient: z.ZodOptional<z.ZodString>;
-    origin: z.ZodOptional<z.ZodString>;
-    audience: z.ZodOptional<z.ZodString>;
-    media: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    format_payload: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>, z.ZodTransform<Record<string, unknown>, Record<string, unknown> | null | undefined>>;
 }, z.core.$strip>;
 export type Interaction = z.infer<typeof interaction>;
 /** The answer door's response — the blocked caller was woken. */
@@ -296,32 +556,44 @@ export type InteractionCancelled = z.infer<typeof interactionCancelled>;
  * set is the paged base the tail-only stream applies live deltas over.
  */
 export declare const interactionsPage: z.ZodObject<{
-    total: z.ZodNumber;
+    next_page: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
     page: z.ZodNumber;
     page_size: z.ZodNumber;
-    next_page: z.ZodNullable<z.ZodNumber>;
+    total: z.ZodNumber;
     truncated: z.ZodBoolean;
     items: z.ZodArray<z.ZodObject<{
-        interaction_id: z.ZodString;
-        group_id: z.ZodString;
-        question: z.ZodDefault<z.ZodString>;
         answer_format: z.ZodEnum<{
             text: "text";
-            external: "external";
+            free: "free";
             confirm: "confirm";
-            select: "select";
             form: "form";
+            select: "select";
+            external: "external";
         }>;
-        format_payload: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>, z.ZodTransform<Record<string, unknown>, Record<string, unknown> | null | undefined>>;
+        audience: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        channel: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         created_at: z.ZodString;
+        group_id: z.ZodString;
+        interaction_id: z.ZodString;
+        media: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodObject<{
+            caption: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            filename: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            kind: z.ZodEnum<{
+                image: "image";
+                link: "link";
+                document: "document";
+                video: "video";
+                audio: "audio";
+            }>;
+            url: z.ZodString;
+        }, z.core.$strict>>>>;
+        origin: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        question: z.ZodString;
+        recipient: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        sensitive: z.ZodBoolean;
+        server_verified: z.ZodDefault<z.ZodNullable<z.ZodBoolean>>;
         timeout_at: z.ZodString;
-        sensitive: z.ZodDefault<z.ZodBoolean>;
-        server_verified: z.ZodOptional<z.ZodBoolean>;
-        channel: z.ZodOptional<z.ZodString>;
-        recipient: z.ZodOptional<z.ZodString>;
-        origin: z.ZodOptional<z.ZodString>;
-        audience: z.ZodOptional<z.ZodString>;
-        media: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+        format_payload: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>, z.ZodTransform<Record<string, unknown>, Record<string, unknown> | null | undefined>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type InteractionsPage = z.infer<typeof interactionsPage>;