From 80cc983e4f04e88f0c7060cd0196df5fd0ceb738 Mon Sep 17 00:00:00 2001
From: stlc-bot <stlc-bot@users.noreply.github.com>
Date: Fri, 9 Oct 2026 22:02:11 +0000
Subject: [PATCH 01/11] fix(sdk): one FormText model for the forms text node
 (PROD-10339)

Stainless-Generated-From: dd366eec324de39ef90093c3e47929a7c38a0343
---
 .../llamacloud/models/parsing/Form.kt         | 2991 +---------------
 .../llamacloud/models/parsing/FormField.kt    | 2995 +---------------
 .../llamacloud/models/parsing/FormSection.kt  | 2990 +---------------
 .../models/parsing/FormTableCellItems.kt      | 2996 +----------------
 .../llamacloud/models/parsing/FormText.kt     | 2855 ++++++++++++++++
 .../llamacloud/models/parsing/FormTextTest.kt |  474 +++
 6 files changed, 3377 insertions(+), 11924 deletions(-)
 create mode 100644 llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/FormText.kt
 create mode 100644 llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/parsing/FormTextTest.kt

diff --git a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/Form.kt b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/Form.kt
index 829db40..28f9d8c 100644
--- a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/Form.kt
+++ b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/Form.kt
@@ -4,7 +4,6 @@ package ai.llamaindex.llamacloud.models.parsing
 
 import ai.llamaindex.llamacloud.core.BaseDeserializer
 import ai.llamaindex.llamacloud.core.BaseSerializer
-import ai.llamaindex.llamacloud.core.Enum
 import ai.llamaindex.llamacloud.core.ExcludeMissing
 import ai.llamaindex.llamacloud.core.JsonField
 import ai.llamaindex.llamacloud.core.JsonMissing
@@ -186,19 +185,19 @@ private constructor(
             addJson(FormTable.builder().type(FormTable.Type.TABLE).rows(rows).build())
 
         /** Alias for calling [addJson] with `Json.ofText(text)`. */
-        fun addJson(text: Json.Text) = addJson(Json.ofText(text))
+        fun addJson(text: FormText) = addJson(Json.ofText(text))
 
         /**
          * Alias for calling [addJson] with the following:
          * ```java
-         * Json.Text.builder()
-         *     .type(Form.Json.Text.Type.TEXT)
+         * FormText.builder()
+         *     .type(FormText.Type.TEXT)
          *     .value(value)
          *     .build()
          * ```
          */
         fun addTextJson(value: String) =
-            addJson(Json.Text.builder().type(Form.Json.Text.Type.TEXT).value(value).build())
+            addJson(FormText.builder().type(FormText.Type.TEXT).value(value).build())
 
         /** Flattened list representation of the same content */
         fun list(list: FormListItem) = list(JsonField.of(list))
@@ -298,7 +297,7 @@ private constructor(
         private val field: FormField? = null,
         private val section: FormSection? = null,
         private val table: FormTable? = null,
-        private val text: Text? = null,
+        private val text: FormText? = null,
         private val _json: JsonValue? = null,
     ) {
 
@@ -315,7 +314,7 @@ private constructor(
          * Printed text that is not part of a field, section heading or table: a title, an
          * instruction, a note. With it the form JSON holds every printed word of its region.
          */
-        fun text(): Optional<Text> = Optional.ofNullable(text)
+        fun text(): Optional<FormText> = Optional.ofNullable(text)
 
         fun isField(): Boolean = field != null
 
@@ -338,7 +337,7 @@ private constructor(
          * Printed text that is not part of a field, section heading or table: a title, an
          * instruction, a note. With it the form JSON holds every printed word of its region.
          */
-        fun asText(): Text = text.getOrThrow("text")
+        fun asText(): FormText = text.getOrThrow("text")
 
         fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
 
@@ -410,7 +409,7 @@ private constructor(
                         table.validate()
                     }
 
-                    override fun visitText(text: Text) {
+                    override fun visitText(text: FormText) {
                         text.validate()
                     }
                 }
@@ -442,7 +441,7 @@ private constructor(
 
                     override fun visitTable(table: FormTable) = table.validity()
 
-                    override fun visitText(text: Text) = text.validity()
+                    override fun visitText(text: FormText) = text.validity()
 
                     override fun unknown(json: JsonValue?) = 0
                 }
@@ -487,7 +486,7 @@ private constructor(
              * Printed text that is not part of a field, section heading or table: a title, an
              * instruction, a note. With it the form JSON holds every printed word of its region.
              */
-            @JvmStatic fun ofText(text: Text) = Json(text = text)
+            @JvmStatic fun ofText(text: FormText) = Json(text = text)
         }
 
         /** An interface that defines how to map each variant of [Json] to a value of type [T]. */
@@ -506,7 +505,7 @@ private constructor(
              * Printed text that is not part of a field, section heading or table: a title, an
              * instruction, a note. With it the form JSON holds every printed word of its region.
              */
-            fun visitText(text: Text): T
+            fun visitText(text: FormText): T
 
             /**
              * Maps an unknown variant of [Json] to a value of type [T].
@@ -545,7 +544,7 @@ private constructor(
                         } ?: Json(_json = json)
                     }
                     "text" -> {
-                        return tryDeserialize(node, jacksonTypeRef<Text>())?.let {
+                        return tryDeserialize(node, jacksonTypeRef<FormText>())?.let {
                             Json(text = it, _json = json)
                         } ?: Json(_json = json)
                     }
@@ -572,2972 +571,6 @@ private constructor(
                 }
             }
         }
-
-        /**
-         * Printed text that is not part of a field, section heading or table: a title, an
-         * instruction, a note. With it the form JSON holds every printed word of its region.
-         */
-        class Text
-        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-        private constructor(
-            private val value: JsonField<String>,
-            private val bbox: JsonField<List<BBox>>,
-            private val grounding: JsonField<Grounding>,
-            private val type: JsonField<Type>,
-            private val additionalProperties: MutableMap<String, JsonValue>,
-        ) {
-
-            @JsonCreator
-            private constructor(
-                @JsonProperty("value") @ExcludeMissing value: JsonField<String> = JsonMissing.of(),
-                @JsonProperty("bbox")
-                @ExcludeMissing
-                bbox: JsonField<List<BBox>> = JsonMissing.of(),
-                @JsonProperty("grounding")
-                @ExcludeMissing
-                grounding: JsonField<Grounding> = JsonMissing.of(),
-                @JsonProperty("type") @ExcludeMissing type: JsonField<Type> = JsonMissing.of(),
-            ) : this(value, bbox, grounding, type, mutableMapOf())
-
-            /**
-             * The printed text, verbatim
-             *
-             * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type or is
-             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
-             *   value).
-             */
-            fun value(): String = value.getRequired("value")
-
-            /**
-             * Bounding boxes of the text on the page, if attributed.
-             *
-             * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g.
-             *   if the server responded with an unexpected value).
-             */
-            fun bbox(): Optional<List<BBox>> = bbox.getOptional("bbox")
-
-            /**
-             * Optional grounding for a field's printed text; boolean states have no text spans.
-             *
-             * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g.
-             *   if the server responded with an unexpected value).
-             */
-            fun grounding(): Optional<Grounding> = grounding.getOptional("grounding")
-
-            /**
-             * Form text node
-             *
-             * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g.
-             *   if the server responded with an unexpected value).
-             */
-            fun type(): Optional<Type> = type.getOptional("type")
-
-            /**
-             * Returns the raw JSON value of [value].
-             *
-             * Unlike [value], this method doesn't throw if the JSON field has an unexpected type.
-             */
-            @JsonProperty("value") @ExcludeMissing fun _value(): JsonField<String> = value
-
-            /**
-             * Returns the raw JSON value of [bbox].
-             *
-             * Unlike [bbox], this method doesn't throw if the JSON field has an unexpected type.
-             */
-            @JsonProperty("bbox") @ExcludeMissing fun _bbox(): JsonField<List<BBox>> = bbox
-
-            /**
-             * Returns the raw JSON value of [grounding].
-             *
-             * Unlike [grounding], this method doesn't throw if the JSON field has an unexpected
-             * type.
-             */
-            @JsonProperty("grounding")
-            @ExcludeMissing
-            fun _grounding(): JsonField<Grounding> = grounding
-
-            /**
-             * Returns the raw JSON value of [type].
-             *
-             * Unlike [type], this method doesn't throw if the JSON field has an unexpected type.
-             */
-            @JsonProperty("type") @ExcludeMissing fun _type(): JsonField<Type> = type
-
-            @JsonAnySetter
-            private fun putAdditionalProperty(key: String, value: JsonValue) {
-                additionalProperties.put(key, value)
-            }
-
-            @JsonAnyGetter
-            @ExcludeMissing
-            fun _additionalProperties(): Map<String, JsonValue> =
-                Collections.unmodifiableMap(additionalProperties)
-
-            fun toBuilder() = Builder().from(this)
-
-            companion object {
-
-                /**
-                 * Returns a mutable builder for constructing an instance of [Text].
-                 *
-                 * The following fields are required:
-                 * ```java
-                 * .value()
-                 * ```
-                 */
-                @JvmStatic fun builder() = Builder()
-            }
-
-            /** A builder for [Text]. */
-            class Builder internal constructor() {
-
-                private var value: JsonField<String>? = null
-                private var bbox: JsonField<MutableList<BBox>>? = null
-                private var grounding: JsonField<Grounding> = JsonMissing.of()
-                private var type: JsonField<Type> = JsonMissing.of()
-                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
-
-                @JvmSynthetic
-                internal fun from(text: Text) = apply {
-                    value = text.value
-                    bbox = text.bbox.map { it.toMutableList() }
-                    grounding = text.grounding
-                    type = text.type
-                    additionalProperties = text.additionalProperties.toMutableMap()
-                }
-
-                /** The printed text, verbatim */
-                fun value(value: String) = value(JsonField.of(value))
-
-                /**
-                 * Sets [Builder.value] to an arbitrary JSON value.
-                 *
-                 * You should usually call [Builder.value] with a well-typed [String] value instead.
-                 * This method is primarily for setting the field to an undocumented or not yet
-                 * supported value.
-                 */
-                fun value(value: JsonField<String>) = apply { this.value = value }
-
-                /** Bounding boxes of the text on the page, if attributed. */
-                fun bbox(bbox: List<BBox>?) = bbox(JsonField.ofNullable(bbox))
-
-                /** Alias for calling [Builder.bbox] with `bbox.orElse(null)`. */
-                fun bbox(bbox: Optional<List<BBox>>) = bbox(bbox.getOrNull())
-
-                /**
-                 * Sets [Builder.bbox] to an arbitrary JSON value.
-                 *
-                 * You should usually call [Builder.bbox] with a well-typed `List<BBox>` value
-                 * instead. This method is primarily for setting the field to an undocumented or not
-                 * yet supported value.
-                 */
-                fun bbox(bbox: JsonField<List<BBox>>) = apply {
-                    this.bbox = bbox.map { it.toMutableList() }
-                }
-
-                /**
-                 * Adds a single [BBox] to [Builder.bbox].
-                 *
-                 * @throws IllegalStateException if the field was previously set to a non-list.
-                 */
-                fun addBbox(bbox: BBox) = apply {
-                    this.bbox =
-                        (this.bbox ?: JsonField.of(mutableListOf())).also {
-                            checkKnown("bbox", it).add(bbox)
-                        }
-                }
-
-                /**
-                 * Optional grounding for a field's printed text; boolean states have no text spans.
-                 */
-                fun grounding(grounding: Grounding?) = grounding(JsonField.ofNullable(grounding))
-
-                /** Alias for calling [Builder.grounding] with `grounding.orElse(null)`. */
-                fun grounding(grounding: Optional<Grounding>) = grounding(grounding.getOrNull())
-
-                /**
-                 * Sets [Builder.grounding] to an arbitrary JSON value.
-                 *
-                 * You should usually call [Builder.grounding] with a well-typed [Grounding] value
-                 * instead. This method is primarily for setting the field to an undocumented or not
-                 * yet supported value.
-                 */
-                fun grounding(grounding: JsonField<Grounding>) = apply {
-                    this.grounding = grounding
-                }
-
-                /** Form text node */
-                fun type(type: Type) = type(JsonField.of(type))
-
-                /**
-                 * Sets [Builder.type] to an arbitrary JSON value.
-                 *
-                 * You should usually call [Builder.type] with a well-typed [Type] value instead.
-                 * This method is primarily for setting the field to an undocumented or not yet
-                 * supported value.
-                 */
-                fun type(type: JsonField<Type>) = apply { this.type = type }
-
-                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
-                    this.additionalProperties.clear()
-                    putAllAdditionalProperties(additionalProperties)
-                }
-
-                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                    additionalProperties.put(key, value)
-                }
-
-                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
-                    apply {
-                        this.additionalProperties.putAll(additionalProperties)
-                    }
-
-                fun removeAdditionalProperty(key: String) = apply {
-                    additionalProperties.remove(key)
-                }
-
-                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                    keys.forEach(::removeAdditionalProperty)
-                }
-
-                /**
-                 * Returns an immutable instance of [Text].
-                 *
-                 * Further updates to this [Builder] will not mutate the returned instance.
-                 *
-                 * The following fields are required:
-                 * ```java
-                 * .value()
-                 * ```
-                 *
-                 * @throws IllegalStateException if any required field is unset.
-                 */
-                fun build(): Text =
-                    Text(
-                        checkRequired("value", value),
-                        (bbox ?: JsonMissing.of()).map { it.toImmutable() },
-                        grounding,
-                        type,
-                        additionalProperties.toMutableMap(),
-                    )
-            }
-
-            private var validated: Boolean = false
-
-            /**
-             * Validates that the types of all values in this object match their expected types
-             * recursively.
-             *
-             * This method is _not_ forwards compatible with new types from the API for existing
-             * fields.
-             *
-             * @throws LlamaCloudInvalidDataException if any value type in this object doesn't match
-             *   its expected type.
-             */
-            fun validate(): Text = apply {
-                if (validated) {
-                    return@apply
-                }
-
-                value()
-                bbox().ifPresent { it.forEach { it.validate() } }
-                grounding().ifPresent { it.validate() }
-                type().ifPresent { it.validate() }
-                validated = true
-            }
-
-            fun isValid(): Boolean =
-                try {
-                    validate()
-                    true
-                } catch (e: LlamaCloudInvalidDataException) {
-                    false
-                }
-
-            /**
-             * Returns a score indicating how many valid values are contained in this object
-             * recursively.
-             *
-             * Used for best match union deserialization.
-             */
-            @JvmSynthetic
-            internal fun validity(): Int =
-                (if (value.asKnown().isPresent) 1 else 0) +
-                    (bbox.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
-                    (grounding.asKnown().getOrNull()?.validity() ?: 0) +
-                    (type.asKnown().getOrNull()?.validity() ?: 0)
-
-            /** Optional grounding for a field's printed text; boolean states have no text spans. */
-            class Grounding
-            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-            private constructor(
-                private val id: JsonField<Id>,
-                private val label: JsonField<Label>,
-                private val value: JsonField<Value>,
-                private val additionalProperties: MutableMap<String, JsonValue>,
-            ) {
-
-                @JsonCreator
-                private constructor(
-                    @JsonProperty("id") @ExcludeMissing id: JsonField<Id> = JsonMissing.of(),
-                    @JsonProperty("label")
-                    @ExcludeMissing
-                    label: JsonField<Label> = JsonMissing.of(),
-                    @JsonProperty("value")
-                    @ExcludeMissing
-                    value: JsonField<Value> = JsonMissing.of(),
-                ) : this(id, label, value, mutableMapOf())
-
-                /**
-                 * Supported text with half-open UTF-8 byte spans into the complete property string.
-                 *
-                 * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type
-                 *   (e.g. if the server responded with an unexpected value).
-                 */
-                fun id(): Optional<Id> = id.getOptional("id")
-
-                /**
-                 * Supported text with half-open UTF-8 byte spans into the complete property string.
-                 *
-                 * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type
-                 *   (e.g. if the server responded with an unexpected value).
-                 */
-                fun label(): Optional<Label> = label.getOptional("label")
-
-                /**
-                 * Supported text with half-open UTF-8 byte spans into the complete property string.
-                 *
-                 * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type
-                 *   (e.g. if the server responded with an unexpected value).
-                 */
-                fun value(): Optional<Value> = value.getOptional("value")
-
-                /**
-                 * Returns the raw JSON value of [id].
-                 *
-                 * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
-                 */
-                @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<Id> = id
-
-                /**
-                 * Returns the raw JSON value of [label].
-                 *
-                 * Unlike [label], this method doesn't throw if the JSON field has an unexpected
-                 * type.
-                 */
-                @JsonProperty("label") @ExcludeMissing fun _label(): JsonField<Label> = label
-
-                /**
-                 * Returns the raw JSON value of [value].
-                 *
-                 * Unlike [value], this method doesn't throw if the JSON field has an unexpected
-                 * type.
-                 */
-                @JsonProperty("value") @ExcludeMissing fun _value(): JsonField<Value> = value
-
-                @JsonAnySetter
-                private fun putAdditionalProperty(key: String, value: JsonValue) {
-                    additionalProperties.put(key, value)
-                }
-
-                @JsonAnyGetter
-                @ExcludeMissing
-                fun _additionalProperties(): Map<String, JsonValue> =
-                    Collections.unmodifiableMap(additionalProperties)
-
-                fun toBuilder() = Builder().from(this)
-
-                companion object {
-
-                    /** Returns a mutable builder for constructing an instance of [Grounding]. */
-                    @JvmStatic fun builder() = Builder()
-                }
-
-                /** A builder for [Grounding]. */
-                class Builder internal constructor() {
-
-                    private var id: JsonField<Id> = JsonMissing.of()
-                    private var label: JsonField<Label> = JsonMissing.of()
-                    private var value: JsonField<Value> = JsonMissing.of()
-                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
-
-                    @JvmSynthetic
-                    internal fun from(grounding: Grounding) = apply {
-                        id = grounding.id
-                        label = grounding.label
-                        value = grounding.value
-                        additionalProperties = grounding.additionalProperties.toMutableMap()
-                    }
-
-                    /**
-                     * Supported text with half-open UTF-8 byte spans into the complete property
-                     * string.
-                     */
-                    fun id(id: Id?) = id(JsonField.ofNullable(id))
-
-                    /** Alias for calling [Builder.id] with `id.orElse(null)`. */
-                    fun id(id: Optional<Id>) = id(id.getOrNull())
-
-                    /**
-                     * Sets [Builder.id] to an arbitrary JSON value.
-                     *
-                     * You should usually call [Builder.id] with a well-typed [Id] value instead.
-                     * This method is primarily for setting the field to an undocumented or not yet
-                     * supported value.
-                     */
-                    fun id(id: JsonField<Id>) = apply { this.id = id }
-
-                    /**
-                     * Supported text with half-open UTF-8 byte spans into the complete property
-                     * string.
-                     */
-                    fun label(label: Label?) = label(JsonField.ofNullable(label))
-
-                    /** Alias for calling [Builder.label] with `label.orElse(null)`. */
-                    fun label(label: Optional<Label>) = label(label.getOrNull())
-
-                    /**
-                     * Sets [Builder.label] to an arbitrary JSON value.
-                     *
-                     * You should usually call [Builder.label] with a well-typed [Label] value
-                     * instead. This method is primarily for setting the field to an undocumented or
-                     * not yet supported value.
-                     */
-                    fun label(label: JsonField<Label>) = apply { this.label = label }
-
-                    /**
-                     * Supported text with half-open UTF-8 byte spans into the complete property
-                     * string.
-                     */
-                    fun value(value: Value?) = value(JsonField.ofNullable(value))
-
-                    /** Alias for calling [Builder.value] with `value.orElse(null)`. */
-                    fun value(value: Optional<Value>) = value(value.getOrNull())
-
-                    /**
-                     * Sets [Builder.value] to an arbitrary JSON value.
-                     *
-                     * You should usually call [Builder.value] with a well-typed [Value] value
-                     * instead. This method is primarily for setting the field to an undocumented or
-                     * not yet supported value.
-                     */
-                    fun value(value: JsonField<Value>) = apply { this.value = value }
-
-                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
-                        this.additionalProperties.clear()
-                        putAllAdditionalProperties(additionalProperties)
-                    }
-
-                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                        additionalProperties.put(key, value)
-                    }
-
-                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
-                        apply {
-                            this.additionalProperties.putAll(additionalProperties)
-                        }
-
-                    fun removeAdditionalProperty(key: String) = apply {
-                        additionalProperties.remove(key)
-                    }
-
-                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                        keys.forEach(::removeAdditionalProperty)
-                    }
-
-                    /**
-                     * Returns an immutable instance of [Grounding].
-                     *
-                     * Further updates to this [Builder] will not mutate the returned instance.
-                     */
-                    fun build(): Grounding =
-                        Grounding(id, label, value, additionalProperties.toMutableMap())
-                }
-
-                private var validated: Boolean = false
-
-                /**
-                 * Validates that the types of all values in this object match their expected types
-                 * recursively.
-                 *
-                 * This method is _not_ forwards compatible with new types from the API for existing
-                 * fields.
-                 *
-                 * @throws LlamaCloudInvalidDataException if any value type in this object doesn't
-                 *   match its expected type.
-                 */
-                fun validate(): Grounding = apply {
-                    if (validated) {
-                        return@apply
-                    }
-
-                    id().ifPresent { it.validate() }
-                    label().ifPresent { it.validate() }
-                    value().ifPresent { it.validate() }
-                    validated = true
-                }
-
-                fun isValid(): Boolean =
-                    try {
-                        validate()
-                        true
-                    } catch (e: LlamaCloudInvalidDataException) {
-                        false
-                    }
-
-                /**
-                 * Returns a score indicating how many valid values are contained in this object
-                 * recursively.
-                 *
-                 * Used for best match union deserialization.
-                 */
-                @JvmSynthetic
-                internal fun validity(): Int =
-                    (id.asKnown().getOrNull()?.validity() ?: 0) +
-                        (label.asKnown().getOrNull()?.validity() ?: 0) +
-                        (value.asKnown().getOrNull()?.validity() ?: 0)
-
-                /**
-                 * Supported text with half-open UTF-8 byte spans into the complete property string.
-                 */
-                class Id
-                @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-                private constructor(
-                    private val lines: JsonField<List<Line>>,
-                    private val additionalProperties: MutableMap<String, JsonValue>,
-                ) {
-
-                    @JsonCreator
-                    private constructor(
-                        @JsonProperty("lines")
-                        @ExcludeMissing
-                        lines: JsonField<List<Line>> = JsonMissing.of()
-                    ) : this(lines, mutableMapOf())
-
-                    /**
-                     * Supported lines. Word requests include supported words; gaps are valid. Boxes
-                     * use final page coordinates and optional local rotation r.
-                     *
-                     * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected
-                     *   type or is unexpectedly missing or null (e.g. if the server responded with
-                     *   an unexpected value).
-                     */
-                    fun lines(): List<Line> = lines.getRequired("lines")
-
-                    /**
-                     * Returns the raw JSON value of [lines].
-                     *
-                     * Unlike [lines], this method doesn't throw if the JSON field has an unexpected
-                     * type.
-                     */
-                    @JsonProperty("lines")
-                    @ExcludeMissing
-                    fun _lines(): JsonField<List<Line>> = lines
-
-                    @JsonAnySetter
-                    private fun putAdditionalProperty(key: String, value: JsonValue) {
-                        additionalProperties.put(key, value)
-                    }
-
-                    @JsonAnyGetter
-                    @ExcludeMissing
-                    fun _additionalProperties(): Map<String, JsonValue> =
-                        Collections.unmodifiableMap(additionalProperties)
-
-                    fun toBuilder() = Builder().from(this)
-
-                    companion object {
-
-                        /**
-                         * Returns a mutable builder for constructing an instance of [Id].
-                         *
-                         * The following fields are required:
-                         * ```java
-                         * .lines()
-                         * ```
-                         */
-                        @JvmStatic fun builder() = Builder()
-                    }
-
-                    /** A builder for [Id]. */
-                    class Builder internal constructor() {
-
-                        private var lines: JsonField<MutableList<Line>>? = null
-                        private var additionalProperties: MutableMap<String, JsonValue> =
-                            mutableMapOf()
-
-                        @JvmSynthetic
-                        internal fun from(id: Id) = apply {
-                            lines = id.lines.map { it.toMutableList() }
-                            additionalProperties = id.additionalProperties.toMutableMap()
-                        }
-
-                        /**
-                         * Supported lines. Word requests include supported words; gaps are valid.
-                         * Boxes use final page coordinates and optional local rotation r.
-                         */
-                        fun lines(lines: List<Line>) = lines(JsonField.of(lines))
-
-                        /**
-                         * Sets [Builder.lines] to an arbitrary JSON value.
-                         *
-                         * You should usually call [Builder.lines] with a well-typed `List<Line>`
-                         * value instead. This method is primarily for setting the field to an
-                         * undocumented or not yet supported value.
-                         */
-                        fun lines(lines: JsonField<List<Line>>) = apply {
-                            this.lines = lines.map { it.toMutableList() }
-                        }
-
-                        /**
-                         * Adds a single [Line] to [lines].
-                         *
-                         * @throws IllegalStateException if the field was previously set to a
-                         *   non-list.
-                         */
-                        fun addLine(line: Line) = apply {
-                            lines =
-                                (lines ?: JsonField.of(mutableListOf())).also {
-                                    checkKnown("lines", it).add(line)
-                                }
-                        }
-
-                        fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
-                            apply {
-                                this.additionalProperties.clear()
-                                putAllAdditionalProperties(additionalProperties)
-                            }
-
-                        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                            additionalProperties.put(key, value)
-                        }
-
-                        fun putAllAdditionalProperties(
-                            additionalProperties: Map<String, JsonValue>
-                        ) = apply { this.additionalProperties.putAll(additionalProperties) }
-
-                        fun removeAdditionalProperty(key: String) = apply {
-                            additionalProperties.remove(key)
-                        }
-
-                        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                            keys.forEach(::removeAdditionalProperty)
-                        }
-
-                        /**
-                         * Returns an immutable instance of [Id].
-                         *
-                         * Further updates to this [Builder] will not mutate the returned instance.
-                         *
-                         * The following fields are required:
-                         * ```java
-                         * .lines()
-                         * ```
-                         *
-                         * @throws IllegalStateException if any required field is unset.
-                         */
-                        fun build(): Id =
-                            Id(
-                                checkRequired("lines", lines).map { it.toImmutable() },
-                                additionalProperties.toMutableMap(),
-                            )
-                    }
-
-                    private var validated: Boolean = false
-
-                    /**
-                     * Validates that the types of all values in this object match their expected
-                     * types recursively.
-                     *
-                     * This method is _not_ forwards compatible with new types from the API for
-                     * existing fields.
-                     *
-                     * @throws LlamaCloudInvalidDataException if any value type in this object
-                     *   doesn't match its expected type.
-                     */
-                    fun validate(): Id = apply {
-                        if (validated) {
-                            return@apply
-                        }
-
-                        lines().forEach { it.validate() }
-                        validated = true
-                    }
-
-                    fun isValid(): Boolean =
-                        try {
-                            validate()
-                            true
-                        } catch (e: LlamaCloudInvalidDataException) {
-                            false
-                        }
-
-                    /**
-                     * Returns a score indicating how many valid values are contained in this object
-                     * recursively.
-                     *
-                     * Used for best match union deserialization.
-                     */
-                    @JvmSynthetic
-                    internal fun validity(): Int =
-                        (lines.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
-
-                    /** One grounded line of text with an optional per-word breakdown. */
-                    class Line
-                    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-                    private constructor(
-                        private val bbox: JsonField<BBox>,
-                        private val span: JsonField<List<JsonValue>>,
-                        private val words: JsonField<List<Word>>,
-                        private val additionalProperties: MutableMap<String, JsonValue>,
-                    ) {
-
-                        @JsonCreator
-                        private constructor(
-                            @JsonProperty("bbox")
-                            @ExcludeMissing
-                            bbox: JsonField<BBox> = JsonMissing.of(),
-                            @JsonProperty("span")
-                            @ExcludeMissing
-                            span: JsonField<List<JsonValue>> = JsonMissing.of(),
-                            @JsonProperty("words")
-                            @ExcludeMissing
-                            words: JsonField<List<Word>> = JsonMissing.of(),
-                        ) : this(bbox, span, words, mutableMapOf())
-
-                        /**
-                         * Line bounding box
-                         *
-                         * @throws LlamaCloudInvalidDataException if the JSON field has an
-                         *   unexpected type or is unexpectedly missing or null (e.g. if the server
-                         *   responded with an unexpected value).
-                         */
-                        fun bbox(): BBox = bbox.getRequired("bbox")
-
-                        /**
-                         * `[start, end)` UTF-8 byte span in the complete source property string
-                         *
-                         * @throws LlamaCloudInvalidDataException if the JSON field has an
-                         *   unexpected type or is unexpectedly missing or null (e.g. if the server
-                         *   responded with an unexpected value).
-                         */
-                        fun span(): List<JsonValue> = span.getRequired("span")
-
-                        /**
-                         * Per-word grounding within the line, when available
-                         *
-                         * @throws LlamaCloudInvalidDataException if the JSON field has an
-                         *   unexpected type (e.g. if the server responded with an unexpected
-                         *   value).
-                         */
-                        fun words(): Optional<List<Word>> = words.getOptional("words")
-
-                        /**
-                         * Returns the raw JSON value of [bbox].
-                         *
-                         * Unlike [bbox], this method doesn't throw if the JSON field has an
-                         * unexpected type.
-                         */
-                        @JsonProperty("bbox") @ExcludeMissing fun _bbox(): JsonField<BBox> = bbox
-
-                        /**
-                         * Returns the raw JSON value of [span].
-                         *
-                         * Unlike [span], this method doesn't throw if the JSON field has an
-                         * unexpected type.
-                         */
-                        @JsonProperty("span")
-                        @ExcludeMissing
-                        fun _span(): JsonField<List<JsonValue>> = span
-
-                        /**
-                         * Returns the raw JSON value of [words].
-                         *
-                         * Unlike [words], this method doesn't throw if the JSON field has an
-                         * unexpected type.
-                         */
-                        @JsonProperty("words")
-                        @ExcludeMissing
-                        fun _words(): JsonField<List<Word>> = words
-
-                        @JsonAnySetter
-                        private fun putAdditionalProperty(key: String, value: JsonValue) {
-                            additionalProperties.put(key, value)
-                        }
-
-                        @JsonAnyGetter
-                        @ExcludeMissing
-                        fun _additionalProperties(): Map<String, JsonValue> =
-                            Collections.unmodifiableMap(additionalProperties)
-
-                        fun toBuilder() = Builder().from(this)
-
-                        companion object {
-
-                            /**
-                             * Returns a mutable builder for constructing an instance of [Line].
-                             *
-                             * The following fields are required:
-                             * ```java
-                             * .bbox()
-                             * .span()
-                             * ```
-                             */
-                            @JvmStatic fun builder() = Builder()
-                        }
-
-                        /** A builder for [Line]. */
-                        class Builder internal constructor() {
-
-                            private var bbox: JsonField<BBox>? = null
-                            private var span: JsonField<MutableList<JsonValue>>? = null
-                            private var words: JsonField<MutableList<Word>>? = null
-                            private var additionalProperties: MutableMap<String, JsonValue> =
-                                mutableMapOf()
-
-                            @JvmSynthetic
-                            internal fun from(line: Line) = apply {
-                                bbox = line.bbox
-                                span = line.span.map { it.toMutableList() }
-                                words = line.words.map { it.toMutableList() }
-                                additionalProperties = line.additionalProperties.toMutableMap()
-                            }
-
-                            /** Line bounding box */
-                            fun bbox(bbox: BBox) = bbox(JsonField.of(bbox))
-
-                            /**
-                             * Sets [Builder.bbox] to an arbitrary JSON value.
-                             *
-                             * You should usually call [Builder.bbox] with a well-typed [BBox] value
-                             * instead. This method is primarily for setting the field to an
-                             * undocumented or not yet supported value.
-                             */
-                            fun bbox(bbox: JsonField<BBox>) = apply { this.bbox = bbox }
-
-                            /**
-                             * `[start, end)` UTF-8 byte span in the complete source property string
-                             */
-                            fun span(span: List<JsonValue>) = span(JsonField.of(span))
-
-                            /**
-                             * Sets [Builder.span] to an arbitrary JSON value.
-                             *
-                             * You should usually call [Builder.span] with a well-typed
-                             * `List<JsonValue>` value instead. This method is primarily for setting
-                             * the field to an undocumented or not yet supported value.
-                             */
-                            fun span(span: JsonField<List<JsonValue>>) = apply {
-                                this.span = span.map { it.toMutableList() }
-                            }
-
-                            /**
-                             * Adds a single [JsonValue] to [Builder.span].
-                             *
-                             * @throws IllegalStateException if the field was previously set to a
-                             *   non-list.
-                             */
-                            fun addSpan(span: JsonValue) = apply {
-                                this.span =
-                                    (this.span ?: JsonField.of(mutableListOf())).also {
-                                        checkKnown("span", it).add(span)
-                                    }
-                            }
-
-                            /** Per-word grounding within the line, when available */
-                            fun words(words: List<Word>?) = words(JsonField.ofNullable(words))
-
-                            /** Alias for calling [Builder.words] with `words.orElse(null)`. */
-                            fun words(words: Optional<List<Word>>) = words(words.getOrNull())
-
-                            /**
-                             * Sets [Builder.words] to an arbitrary JSON value.
-                             *
-                             * You should usually call [Builder.words] with a well-typed
-                             * `List<Word>` value instead. This method is primarily for setting the
-                             * field to an undocumented or not yet supported value.
-                             */
-                            fun words(words: JsonField<List<Word>>) = apply {
-                                this.words = words.map { it.toMutableList() }
-                            }
-
-                            /**
-                             * Adds a single [Word] to [words].
-                             *
-                             * @throws IllegalStateException if the field was previously set to a
-                             *   non-list.
-                             */
-                            fun addWord(word: Word) = apply {
-                                words =
-                                    (words ?: JsonField.of(mutableListOf())).also {
-                                        checkKnown("words", it).add(word)
-                                    }
-                            }
-
-                            fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
-                                apply {
-                                    this.additionalProperties.clear()
-                                    putAllAdditionalProperties(additionalProperties)
-                                }
-
-                            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                                additionalProperties.put(key, value)
-                            }
-
-                            fun putAllAdditionalProperties(
-                                additionalProperties: Map<String, JsonValue>
-                            ) = apply { this.additionalProperties.putAll(additionalProperties) }
-
-                            fun removeAdditionalProperty(key: String) = apply {
-                                additionalProperties.remove(key)
-                            }
-
-                            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                                keys.forEach(::removeAdditionalProperty)
-                            }
-
-                            /**
-                             * Returns an immutable instance of [Line].
-                             *
-                             * Further updates to this [Builder] will not mutate the returned
-                             * instance.
-                             *
-                             * The following fields are required:
-                             * ```java
-                             * .bbox()
-                             * .span()
-                             * ```
-                             *
-                             * @throws IllegalStateException if any required field is unset.
-                             */
-                            fun build(): Line =
-                                Line(
-                                    checkRequired("bbox", bbox),
-                                    checkRequired("span", span).map { it.toImmutable() },
-                                    (words ?: JsonMissing.of()).map { it.toImmutable() },
-                                    additionalProperties.toMutableMap(),
-                                )
-                        }
-
-                        private var validated: Boolean = false
-
-                        /**
-                         * Validates that the types of all values in this object match their
-                         * expected types recursively.
-                         *
-                         * This method is _not_ forwards compatible with new types from the API for
-                         * existing fields.
-                         *
-                         * @throws LlamaCloudInvalidDataException if any value type in this object
-                         *   doesn't match its expected type.
-                         */
-                        fun validate(): Line = apply {
-                            if (validated) {
-                                return@apply
-                            }
-
-                            bbox().validate()
-                            span()
-                            words().ifPresent { it.forEach { it.validate() } }
-                            validated = true
-                        }
-
-                        fun isValid(): Boolean =
-                            try {
-                                validate()
-                                true
-                            } catch (e: LlamaCloudInvalidDataException) {
-                                false
-                            }
-
-                        /**
-                         * Returns a score indicating how many valid values are contained in this
-                         * object recursively.
-                         *
-                         * Used for best match union deserialization.
-                         */
-                        @JvmSynthetic
-                        internal fun validity(): Int =
-                            (bbox.asKnown().getOrNull()?.validity() ?: 0) +
-                                (span.asKnown().getOrNull()?.size ?: 0) +
-                                (words.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
-
-                        /**
-                         * One grounded word: a `[start, end)` span in the source text and its bbox.
-                         */
-                        class Word
-                        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-                        private constructor(
-                            private val bbox: JsonField<BBox>,
-                            private val span: JsonField<List<JsonValue>>,
-                            private val additionalProperties: MutableMap<String, JsonValue>,
-                        ) {
-
-                            @JsonCreator
-                            private constructor(
-                                @JsonProperty("bbox")
-                                @ExcludeMissing
-                                bbox: JsonField<BBox> = JsonMissing.of(),
-                                @JsonProperty("span")
-                                @ExcludeMissing
-                                span: JsonField<List<JsonValue>> = JsonMissing.of(),
-                            ) : this(bbox, span, mutableMapOf())
-
-                            /**
-                             * Word bounding box
-                             *
-                             * @throws LlamaCloudInvalidDataException if the JSON field has an
-                             *   unexpected type or is unexpectedly missing or null (e.g. if the
-                             *   server responded with an unexpected value).
-                             */
-                            fun bbox(): BBox = bbox.getRequired("bbox")
-
-                            /**
-                             * `[start, end)` UTF-8 byte span in the complete source property string
-                             *
-                             * @throws LlamaCloudInvalidDataException if the JSON field has an
-                             *   unexpected type or is unexpectedly missing or null (e.g. if the
-                             *   server responded with an unexpected value).
-                             */
-                            fun span(): List<JsonValue> = span.getRequired("span")
-
-                            /**
-                             * Returns the raw JSON value of [bbox].
-                             *
-                             * Unlike [bbox], this method doesn't throw if the JSON field has an
-                             * unexpected type.
-                             */
-                            @JsonProperty("bbox")
-                            @ExcludeMissing
-                            fun _bbox(): JsonField<BBox> = bbox
-
-                            /**
-                             * Returns the raw JSON value of [span].
-                             *
-                             * Unlike [span], this method doesn't throw if the JSON field has an
-                             * unexpected type.
-                             */
-                            @JsonProperty("span")
-                            @ExcludeMissing
-                            fun _span(): JsonField<List<JsonValue>> = span
-
-                            @JsonAnySetter
-                            private fun putAdditionalProperty(key: String, value: JsonValue) {
-                                additionalProperties.put(key, value)
-                            }
-
-                            @JsonAnyGetter
-                            @ExcludeMissing
-                            fun _additionalProperties(): Map<String, JsonValue> =
-                                Collections.unmodifiableMap(additionalProperties)
-
-                            fun toBuilder() = Builder().from(this)
-
-                            companion object {
-
-                                /**
-                                 * Returns a mutable builder for constructing an instance of [Word].
-                                 *
-                                 * The following fields are required:
-                                 * ```java
-                                 * .bbox()
-                                 * .span()
-                                 * ```
-                                 */
-                                @JvmStatic fun builder() = Builder()
-                            }
-
-                            /** A builder for [Word]. */
-                            class Builder internal constructor() {
-
-                                private var bbox: JsonField<BBox>? = null
-                                private var span: JsonField<MutableList<JsonValue>>? = null
-                                private var additionalProperties: MutableMap<String, JsonValue> =
-                                    mutableMapOf()
-
-                                @JvmSynthetic
-                                internal fun from(word: Word) = apply {
-                                    bbox = word.bbox
-                                    span = word.span.map { it.toMutableList() }
-                                    additionalProperties = word.additionalProperties.toMutableMap()
-                                }
-
-                                /** Word bounding box */
-                                fun bbox(bbox: BBox) = bbox(JsonField.of(bbox))
-
-                                /**
-                                 * Sets [Builder.bbox] to an arbitrary JSON value.
-                                 *
-                                 * You should usually call [Builder.bbox] with a well-typed [BBox]
-                                 * value instead. This method is primarily for setting the field to
-                                 * an undocumented or not yet supported value.
-                                 */
-                                fun bbox(bbox: JsonField<BBox>) = apply { this.bbox = bbox }
-
-                                /**
-                                 * `[start, end)` UTF-8 byte span in the complete source property
-                                 * string
-                                 */
-                                fun span(span: List<JsonValue>) = span(JsonField.of(span))
-
-                                /**
-                                 * Sets [Builder.span] to an arbitrary JSON value.
-                                 *
-                                 * You should usually call [Builder.span] with a well-typed
-                                 * `List<JsonValue>` value instead. This method is primarily for
-                                 * setting the field to an undocumented or not yet supported value.
-                                 */
-                                fun span(span: JsonField<List<JsonValue>>) = apply {
-                                    this.span = span.map { it.toMutableList() }
-                                }
-
-                                /**
-                                 * Adds a single [JsonValue] to [Builder.span].
-                                 *
-                                 * @throws IllegalStateException if the field was previously set to
-                                 *   a non-list.
-                                 */
-                                fun addSpan(span: JsonValue) = apply {
-                                    this.span =
-                                        (this.span ?: JsonField.of(mutableListOf())).also {
-                                            checkKnown("span", it).add(span)
-                                        }
-                                }
-
-                                fun additionalProperties(
-                                    additionalProperties: Map<String, JsonValue>
-                                ) = apply {
-                                    this.additionalProperties.clear()
-                                    putAllAdditionalProperties(additionalProperties)
-                                }
-
-                                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                                    additionalProperties.put(key, value)
-                                }
-
-                                fun putAllAdditionalProperties(
-                                    additionalProperties: Map<String, JsonValue>
-                                ) = apply { this.additionalProperties.putAll(additionalProperties) }
-
-                                fun removeAdditionalProperty(key: String) = apply {
-                                    additionalProperties.remove(key)
-                                }
-
-                                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                                    keys.forEach(::removeAdditionalProperty)
-                                }
-
-                                /**
-                                 * Returns an immutable instance of [Word].
-                                 *
-                                 * Further updates to this [Builder] will not mutate the returned
-                                 * instance.
-                                 *
-                                 * The following fields are required:
-                                 * ```java
-                                 * .bbox()
-                                 * .span()
-                                 * ```
-                                 *
-                                 * @throws IllegalStateException if any required field is unset.
-                                 */
-                                fun build(): Word =
-                                    Word(
-                                        checkRequired("bbox", bbox),
-                                        checkRequired("span", span).map { it.toImmutable() },
-                                        additionalProperties.toMutableMap(),
-                                    )
-                            }
-
-                            private var validated: Boolean = false
-
-                            /**
-                             * Validates that the types of all values in this object match their
-                             * expected types recursively.
-                             *
-                             * This method is _not_ forwards compatible with new types from the API
-                             * for existing fields.
-                             *
-                             * @throws LlamaCloudInvalidDataException if any value type in this
-                             *   object doesn't match its expected type.
-                             */
-                            fun validate(): Word = apply {
-                                if (validated) {
-                                    return@apply
-                                }
-
-                                bbox().validate()
-                                span()
-                                validated = true
-                            }
-
-                            fun isValid(): Boolean =
-                                try {
-                                    validate()
-                                    true
-                                } catch (e: LlamaCloudInvalidDataException) {
-                                    false
-                                }
-
-                            /**
-                             * Returns a score indicating how many valid values are contained in
-                             * this object recursively.
-                             *
-                             * Used for best match union deserialization.
-                             */
-                            @JvmSynthetic
-                            internal fun validity(): Int =
-                                (bbox.asKnown().getOrNull()?.validity() ?: 0) +
-                                    (span.asKnown().getOrNull()?.size ?: 0)
-
-                            override fun equals(other: Any?): Boolean {
-                                if (this === other) {
-                                    return true
-                                }
-
-                                return other is Word &&
-                                    bbox == other.bbox &&
-                                    span == other.span &&
-                                    additionalProperties == other.additionalProperties
-                            }
-
-                            private val hashCode: Int by lazy {
-                                Objects.hash(bbox, span, additionalProperties)
-                            }
-
-                            override fun hashCode(): Int = hashCode
-
-                            override fun toString() =
-                                "Word{bbox=$bbox, span=$span, additionalProperties=$additionalProperties}"
-                        }
-
-                        override fun equals(other: Any?): Boolean {
-                            if (this === other) {
-                                return true
-                            }
-
-                            return other is Line &&
-                                bbox == other.bbox &&
-                                span == other.span &&
-                                words == other.words &&
-                                additionalProperties == other.additionalProperties
-                        }
-
-                        private val hashCode: Int by lazy {
-                            Objects.hash(bbox, span, words, additionalProperties)
-                        }
-
-                        override fun hashCode(): Int = hashCode
-
-                        override fun toString() =
-                            "Line{bbox=$bbox, span=$span, words=$words, additionalProperties=$additionalProperties}"
-                    }
-
-                    override fun equals(other: Any?): Boolean {
-                        if (this === other) {
-                            return true
-                        }
-
-                        return other is Id &&
-                            lines == other.lines &&
-                            additionalProperties == other.additionalProperties
-                    }
-
-                    private val hashCode: Int by lazy { Objects.hash(lines, additionalProperties) }
-
-                    override fun hashCode(): Int = hashCode
-
-                    override fun toString() =
-                        "Id{lines=$lines, additionalProperties=$additionalProperties}"
-                }
-
-                /**
-                 * Supported text with half-open UTF-8 byte spans into the complete property string.
-                 */
-                class Label
-                @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-                private constructor(
-                    private val lines: JsonField<List<Line>>,
-                    private val additionalProperties: MutableMap<String, JsonValue>,
-                ) {
-
-                    @JsonCreator
-                    private constructor(
-                        @JsonProperty("lines")
-                        @ExcludeMissing
-                        lines: JsonField<List<Line>> = JsonMissing.of()
-                    ) : this(lines, mutableMapOf())
-
-                    /**
-                     * Supported lines. Word requests include supported words; gaps are valid. Boxes
-                     * use final page coordinates and optional local rotation r.
-                     *
-                     * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected
-                     *   type or is unexpectedly missing or null (e.g. if the server responded with
-                     *   an unexpected value).
-                     */
-                    fun lines(): List<Line> = lines.getRequired("lines")
-
-                    /**
-                     * Returns the raw JSON value of [lines].
-                     *
-                     * Unlike [lines], this method doesn't throw if the JSON field has an unexpected
-                     * type.
-                     */
-                    @JsonProperty("lines")
-                    @ExcludeMissing
-                    fun _lines(): JsonField<List<Line>> = lines
-
-                    @JsonAnySetter
-                    private fun putAdditionalProperty(key: String, value: JsonValue) {
-                        additionalProperties.put(key, value)
-                    }
-
-                    @JsonAnyGetter
-                    @ExcludeMissing
-                    fun _additionalProperties(): Map<String, JsonValue> =
-                        Collections.unmodifiableMap(additionalProperties)
-
-                    fun toBuilder() = Builder().from(this)
-
-                    companion object {
-
-                        /**
-                         * Returns a mutable builder for constructing an instance of [Label].
-                         *
-                         * The following fields are required:
-                         * ```java
-                         * .lines()
-                         * ```
-                         */
-                        @JvmStatic fun builder() = Builder()
-                    }
-
-                    /** A builder for [Label]. */
-                    class Builder internal constructor() {
-
-                        private var lines: JsonField<MutableList<Line>>? = null
-                        private var additionalProperties: MutableMap<String, JsonValue> =
-                            mutableMapOf()
-
-                        @JvmSynthetic
-                        internal fun from(label: Label) = apply {
-                            lines = label.lines.map { it.toMutableList() }
-                            additionalProperties = label.additionalProperties.toMutableMap()
-                        }
-
-                        /**
-                         * Supported lines. Word requests include supported words; gaps are valid.
-                         * Boxes use final page coordinates and optional local rotation r.
-                         */
-                        fun lines(lines: List<Line>) = lines(JsonField.of(lines))
-
-                        /**
-                         * Sets [Builder.lines] to an arbitrary JSON value.
-                         *
-                         * You should usually call [Builder.lines] with a well-typed `List<Line>`
-                         * value instead. This method is primarily for setting the field to an
-                         * undocumented or not yet supported value.
-                         */
-                        fun lines(lines: JsonField<List<Line>>) = apply {
-                            this.lines = lines.map { it.toMutableList() }
-                        }
-
-                        /**
-                         * Adds a single [Line] to [lines].
-                         *
-                         * @throws IllegalStateException if the field was previously set to a
-                         *   non-list.
-                         */
-                        fun addLine(line: Line) = apply {
-                            lines =
-                                (lines ?: JsonField.of(mutableListOf())).also {
-                                    checkKnown("lines", it).add(line)
-                                }
-                        }
-
-                        fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
-                            apply {
-                                this.additionalProperties.clear()
-                                putAllAdditionalProperties(additionalProperties)
-                            }
-
-                        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                            additionalProperties.put(key, value)
-                        }
-
-                        fun putAllAdditionalProperties(
-                            additionalProperties: Map<String, JsonValue>
-                        ) = apply { this.additionalProperties.putAll(additionalProperties) }
-
-                        fun removeAdditionalProperty(key: String) = apply {
-                            additionalProperties.remove(key)
-                        }
-
-                        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                            keys.forEach(::removeAdditionalProperty)
-                        }
-
-                        /**
-                         * Returns an immutable instance of [Label].
-                         *
-                         * Further updates to this [Builder] will not mutate the returned instance.
-                         *
-                         * The following fields are required:
-                         * ```java
-                         * .lines()
-                         * ```
-                         *
-                         * @throws IllegalStateException if any required field is unset.
-                         */
-                        fun build(): Label =
-                            Label(
-                                checkRequired("lines", lines).map { it.toImmutable() },
-                                additionalProperties.toMutableMap(),
-                            )
-                    }
-
-                    private var validated: Boolean = false
-
-                    /**
-                     * Validates that the types of all values in this object match their expected
-                     * types recursively.
-                     *
-                     * This method is _not_ forwards compatible with new types from the API for
-                     * existing fields.
-                     *
-                     * @throws LlamaCloudInvalidDataException if any value type in this object
-                     *   doesn't match its expected type.
-                     */
-                    fun validate(): Label = apply {
-                        if (validated) {
-                            return@apply
-                        }
-
-                        lines().forEach { it.validate() }
-                        validated = true
-                    }
-
-                    fun isValid(): Boolean =
-                        try {
-                            validate()
-                            true
-                        } catch (e: LlamaCloudInvalidDataException) {
-                            false
-                        }
-
-                    /**
-                     * Returns a score indicating how many valid values are contained in this object
-                     * recursively.
-                     *
-                     * Used for best match union deserialization.
-                     */
-                    @JvmSynthetic
-                    internal fun validity(): Int =
-                        (lines.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
-
-                    /** One grounded line of text with an optional per-word breakdown. */
-                    class Line
-                    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-                    private constructor(
-                        private val bbox: JsonField<BBox>,
-                        private val span: JsonField<List<JsonValue>>,
-                        private val words: JsonField<List<Word>>,
-                        private val additionalProperties: MutableMap<String, JsonValue>,
-                    ) {
-
-                        @JsonCreator
-                        private constructor(
-                            @JsonProperty("bbox")
-                            @ExcludeMissing
-                            bbox: JsonField<BBox> = JsonMissing.of(),
-                            @JsonProperty("span")
-                            @ExcludeMissing
-                            span: JsonField<List<JsonValue>> = JsonMissing.of(),
-                            @JsonProperty("words")
-                            @ExcludeMissing
-                            words: JsonField<List<Word>> = JsonMissing.of(),
-                        ) : this(bbox, span, words, mutableMapOf())
-
-                        /**
-                         * Line bounding box
-                         *
-                         * @throws LlamaCloudInvalidDataException if the JSON field has an
-                         *   unexpected type or is unexpectedly missing or null (e.g. if the server
-                         *   responded with an unexpected value).
-                         */
-                        fun bbox(): BBox = bbox.getRequired("bbox")
-
-                        /**
-                         * `[start, end)` UTF-8 byte span in the complete source property string
-                         *
-                         * @throws LlamaCloudInvalidDataException if the JSON field has an
-                         *   unexpected type or is unexpectedly missing or null (e.g. if the server
-                         *   responded with an unexpected value).
-                         */
-                        fun span(): List<JsonValue> = span.getRequired("span")
-
-                        /**
-                         * Per-word grounding within the line, when available
-                         *
-                         * @throws LlamaCloudInvalidDataException if the JSON field has an
-                         *   unexpected type (e.g. if the server responded with an unexpected
-                         *   value).
-                         */
-                        fun words(): Optional<List<Word>> = words.getOptional("words")
-
-                        /**
-                         * Returns the raw JSON value of [bbox].
-                         *
-                         * Unlike [bbox], this method doesn't throw if the JSON field has an
-                         * unexpected type.
-                         */
-                        @JsonProperty("bbox") @ExcludeMissing fun _bbox(): JsonField<BBox> = bbox
-
-                        /**
-                         * Returns the raw JSON value of [span].
-                         *
-                         * Unlike [span], this method doesn't throw if the JSON field has an
-                         * unexpected type.
-                         */
-                        @JsonProperty("span")
-                        @ExcludeMissing
-                        fun _span(): JsonField<List<JsonValue>> = span
-
-                        /**
-                         * Returns the raw JSON value of [words].
-                         *
-                         * Unlike [words], this method doesn't throw if the JSON field has an
-                         * unexpected type.
-                         */
-                        @JsonProperty("words")
-                        @ExcludeMissing
-                        fun _words(): JsonField<List<Word>> = words
-
-                        @JsonAnySetter
-                        private fun putAdditionalProperty(key: String, value: JsonValue) {
-                            additionalProperties.put(key, value)
-                        }
-
-                        @JsonAnyGetter
-                        @ExcludeMissing
-                        fun _additionalProperties(): Map<String, JsonValue> =
-                            Collections.unmodifiableMap(additionalProperties)
-
-                        fun toBuilder() = Builder().from(this)
-
-                        companion object {
-
-                            /**
-                             * Returns a mutable builder for constructing an instance of [Line].
-                             *
-                             * The following fields are required:
-                             * ```java
-                             * .bbox()
-                             * .span()
-                             * ```
-                             */
-                            @JvmStatic fun builder() = Builder()
-                        }
-
-                        /** A builder for [Line]. */
-                        class Builder internal constructor() {
-
-                            private var bbox: JsonField<BBox>? = null
-                            private var span: JsonField<MutableList<JsonValue>>? = null
-                            private var words: JsonField<MutableList<Word>>? = null
-                            private var additionalProperties: MutableMap<String, JsonValue> =
-                                mutableMapOf()
-
-                            @JvmSynthetic
-                            internal fun from(line: Line) = apply {
-                                bbox = line.bbox
-                                span = line.span.map { it.toMutableList() }
-                                words = line.words.map { it.toMutableList() }
-                                additionalProperties = line.additionalProperties.toMutableMap()
-                            }
-
-                            /** Line bounding box */
-                            fun bbox(bbox: BBox) = bbox(JsonField.of(bbox))
-
-                            /**
-                             * Sets [Builder.bbox] to an arbitrary JSON value.
-                             *
-                             * You should usually call [Builder.bbox] with a well-typed [BBox] value
-                             * instead. This method is primarily for setting the field to an
-                             * undocumented or not yet supported value.
-                             */
-                            fun bbox(bbox: JsonField<BBox>) = apply { this.bbox = bbox }
-
-                            /**
-                             * `[start, end)` UTF-8 byte span in the complete source property string
-                             */
-                            fun span(span: List<JsonValue>) = span(JsonField.of(span))
-
-                            /**
-                             * Sets [Builder.span] to an arbitrary JSON value.
-                             *
-                             * You should usually call [Builder.span] with a well-typed
-                             * `List<JsonValue>` value instead. This method is primarily for setting
-                             * the field to an undocumented or not yet supported value.
-                             */
-                            fun span(span: JsonField<List<JsonValue>>) = apply {
-                                this.span = span.map { it.toMutableList() }
-                            }
-
-                            /**
-                             * Adds a single [JsonValue] to [Builder.span].
-                             *
-                             * @throws IllegalStateException if the field was previously set to a
-                             *   non-list.
-                             */
-                            fun addSpan(span: JsonValue) = apply {
-                                this.span =
-                                    (this.span ?: JsonField.of(mutableListOf())).also {
-                                        checkKnown("span", it).add(span)
-                                    }
-                            }
-
-                            /** Per-word grounding within the line, when available */
-                            fun words(words: List<Word>?) = words(JsonField.ofNullable(words))
-
-                            /** Alias for calling [Builder.words] with `words.orElse(null)`. */
-                            fun words(words: Optional<List<Word>>) = words(words.getOrNull())
-
-                            /**
-                             * Sets [Builder.words] to an arbitrary JSON value.
-                             *
-                             * You should usually call [Builder.words] with a well-typed
-                             * `List<Word>` value instead. This method is primarily for setting the
-                             * field to an undocumented or not yet supported value.
-                             */
-                            fun words(words: JsonField<List<Word>>) = apply {
-                                this.words = words.map { it.toMutableList() }
-                            }
-
-                            /**
-                             * Adds a single [Word] to [words].
-                             *
-                             * @throws IllegalStateException if the field was previously set to a
-                             *   non-list.
-                             */
-                            fun addWord(word: Word) = apply {
-                                words =
-                                    (words ?: JsonField.of(mutableListOf())).also {
-                                        checkKnown("words", it).add(word)
-                                    }
-                            }
-
-                            fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
-                                apply {
-                                    this.additionalProperties.clear()
-                                    putAllAdditionalProperties(additionalProperties)
-                                }
-
-                            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                                additionalProperties.put(key, value)
-                            }
-
-                            fun putAllAdditionalProperties(
-                                additionalProperties: Map<String, JsonValue>
-                            ) = apply { this.additionalProperties.putAll(additionalProperties) }
-
-                            fun removeAdditionalProperty(key: String) = apply {
-                                additionalProperties.remove(key)
-                            }
-
-                            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                                keys.forEach(::removeAdditionalProperty)
-                            }
-
-                            /**
-                             * Returns an immutable instance of [Line].
-                             *
-                             * Further updates to this [Builder] will not mutate the returned
-                             * instance.
-                             *
-                             * The following fields are required:
-                             * ```java
-                             * .bbox()
-                             * .span()
-                             * ```
-                             *
-                             * @throws IllegalStateException if any required field is unset.
-                             */
-                            fun build(): Line =
-                                Line(
-                                    checkRequired("bbox", bbox),
-                                    checkRequired("span", span).map { it.toImmutable() },
-                                    (words ?: JsonMissing.of()).map { it.toImmutable() },
-                                    additionalProperties.toMutableMap(),
-                                )
-                        }
-
-                        private var validated: Boolean = false
-
-                        /**
-                         * Validates that the types of all values in this object match their
-                         * expected types recursively.
-                         *
-                         * This method is _not_ forwards compatible with new types from the API for
-                         * existing fields.
-                         *
-                         * @throws LlamaCloudInvalidDataException if any value type in this object
-                         *   doesn't match its expected type.
-                         */
-                        fun validate(): Line = apply {
-                            if (validated) {
-                                return@apply
-                            }
-
-                            bbox().validate()
-                            span()
-                            words().ifPresent { it.forEach { it.validate() } }
-                            validated = true
-                        }
-
-                        fun isValid(): Boolean =
-                            try {
-                                validate()
-                                true
-                            } catch (e: LlamaCloudInvalidDataException) {
-                                false
-                            }
-
-                        /**
-                         * Returns a score indicating how many valid values are contained in this
-                         * object recursively.
-                         *
-                         * Used for best match union deserialization.
-                         */
-                        @JvmSynthetic
-                        internal fun validity(): Int =
-                            (bbox.asKnown().getOrNull()?.validity() ?: 0) +
-                                (span.asKnown().getOrNull()?.size ?: 0) +
-                                (words.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
-
-                        /**
-                         * One grounded word: a `[start, end)` span in the source text and its bbox.
-                         */
-                        class Word
-                        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-                        private constructor(
-                            private val bbox: JsonField<BBox>,
-                            private val span: JsonField<List<JsonValue>>,
-                            private val additionalProperties: MutableMap<String, JsonValue>,
-                        ) {
-
-                            @JsonCreator
-                            private constructor(
-                                @JsonProperty("bbox")
-                                @ExcludeMissing
-                                bbox: JsonField<BBox> = JsonMissing.of(),
-                                @JsonProperty("span")
-                                @ExcludeMissing
-                                span: JsonField<List<JsonValue>> = JsonMissing.of(),
-                            ) : this(bbox, span, mutableMapOf())
-
-                            /**
-                             * Word bounding box
-                             *
-                             * @throws LlamaCloudInvalidDataException if the JSON field has an
-                             *   unexpected type or is unexpectedly missing or null (e.g. if the
-                             *   server responded with an unexpected value).
-                             */
-                            fun bbox(): BBox = bbox.getRequired("bbox")
-
-                            /**
-                             * `[start, end)` UTF-8 byte span in the complete source property string
-                             *
-                             * @throws LlamaCloudInvalidDataException if the JSON field has an
-                             *   unexpected type or is unexpectedly missing or null (e.g. if the
-                             *   server responded with an unexpected value).
-                             */
-                            fun span(): List<JsonValue> = span.getRequired("span")
-
-                            /**
-                             * Returns the raw JSON value of [bbox].
-                             *
-                             * Unlike [bbox], this method doesn't throw if the JSON field has an
-                             * unexpected type.
-                             */
-                            @JsonProperty("bbox")
-                            @ExcludeMissing
-                            fun _bbox(): JsonField<BBox> = bbox
-
-                            /**
-                             * Returns the raw JSON value of [span].
-                             *
-                             * Unlike [span], this method doesn't throw if the JSON field has an
-                             * unexpected type.
-                             */
-                            @JsonProperty("span")
-                            @ExcludeMissing
-                            fun _span(): JsonField<List<JsonValue>> = span
-
-                            @JsonAnySetter
-                            private fun putAdditionalProperty(key: String, value: JsonValue) {
-                                additionalProperties.put(key, value)
-                            }
-
-                            @JsonAnyGetter
-                            @ExcludeMissing
-                            fun _additionalProperties(): Map<String, JsonValue> =
-                                Collections.unmodifiableMap(additionalProperties)
-
-                            fun toBuilder() = Builder().from(this)
-
-                            companion object {
-
-                                /**
-                                 * Returns a mutable builder for constructing an instance of [Word].
-                                 *
-                                 * The following fields are required:
-                                 * ```java
-                                 * .bbox()
-                                 * .span()
-                                 * ```
-                                 */
-                                @JvmStatic fun builder() = Builder()
-                            }
-
-                            /** A builder for [Word]. */
-                            class Builder internal constructor() {
-
-                                private var bbox: JsonField<BBox>? = null
-                                private var span: JsonField<MutableList<JsonValue>>? = null
-                                private var additionalProperties: MutableMap<String, JsonValue> =
-                                    mutableMapOf()
-
-                                @JvmSynthetic
-                                internal fun from(word: Word) = apply {
-                                    bbox = word.bbox
-                                    span = word.span.map { it.toMutableList() }
-                                    additionalProperties = word.additionalProperties.toMutableMap()
-                                }
-
-                                /** Word bounding box */
-                                fun bbox(bbox: BBox) = bbox(JsonField.of(bbox))
-
-                                /**
-                                 * Sets [Builder.bbox] to an arbitrary JSON value.
-                                 *
-                                 * You should usually call [Builder.bbox] with a well-typed [BBox]
-                                 * value instead. This method is primarily for setting the field to
-                                 * an undocumented or not yet supported value.
-                                 */
-                                fun bbox(bbox: JsonField<BBox>) = apply { this.bbox = bbox }
-
-                                /**
-                                 * `[start, end)` UTF-8 byte span in the complete source property
-                                 * string
-                                 */
-                                fun span(span: List<JsonValue>) = span(JsonField.of(span))
-
-                                /**
-                                 * Sets [Builder.span] to an arbitrary JSON value.
-                                 *
-                                 * You should usually call [Builder.span] with a well-typed
-                                 * `List<JsonValue>` value instead. This method is primarily for
-                                 * setting the field to an undocumented or not yet supported value.
-                                 */
-                                fun span(span: JsonField<List<JsonValue>>) = apply {
-                                    this.span = span.map { it.toMutableList() }
-                                }
-
-                                /**
-                                 * Adds a single [JsonValue] to [Builder.span].
-                                 *
-                                 * @throws IllegalStateException if the field was previously set to
-                                 *   a non-list.
-                                 */
-                                fun addSpan(span: JsonValue) = apply {
-                                    this.span =
-                                        (this.span ?: JsonField.of(mutableListOf())).also {
-                                            checkKnown("span", it).add(span)
-                                        }
-                                }
-
-                                fun additionalProperties(
-                                    additionalProperties: Map<String, JsonValue>
-                                ) = apply {
-                                    this.additionalProperties.clear()
-                                    putAllAdditionalProperties(additionalProperties)
-                                }
-
-                                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                                    additionalProperties.put(key, value)
-                                }
-
-                                fun putAllAdditionalProperties(
-                                    additionalProperties: Map<String, JsonValue>
-                                ) = apply { this.additionalProperties.putAll(additionalProperties) }
-
-                                fun removeAdditionalProperty(key: String) = apply {
-                                    additionalProperties.remove(key)
-                                }
-
-                                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                                    keys.forEach(::removeAdditionalProperty)
-                                }
-
-                                /**
-                                 * Returns an immutable instance of [Word].
-                                 *
-                                 * Further updates to this [Builder] will not mutate the returned
-                                 * instance.
-                                 *
-                                 * The following fields are required:
-                                 * ```java
-                                 * .bbox()
-                                 * .span()
-                                 * ```
-                                 *
-                                 * @throws IllegalStateException if any required field is unset.
-                                 */
-                                fun build(): Word =
-                                    Word(
-                                        checkRequired("bbox", bbox),
-                                        checkRequired("span", span).map { it.toImmutable() },
-                                        additionalProperties.toMutableMap(),
-                                    )
-                            }
-
-                            private var validated: Boolean = false
-
-                            /**
-                             * Validates that the types of all values in this object match their
-                             * expected types recursively.
-                             *
-                             * This method is _not_ forwards compatible with new types from the API
-                             * for existing fields.
-                             *
-                             * @throws LlamaCloudInvalidDataException if any value type in this
-                             *   object doesn't match its expected type.
-                             */
-                            fun validate(): Word = apply {
-                                if (validated) {
-                                    return@apply
-                                }
-
-                                bbox().validate()
-                                span()
-                                validated = true
-                            }
-
-                            fun isValid(): Boolean =
-                                try {
-                                    validate()
-                                    true
-                                } catch (e: LlamaCloudInvalidDataException) {
-                                    false
-                                }
-
-                            /**
-                             * Returns a score indicating how many valid values are contained in
-                             * this object recursively.
-                             *
-                             * Used for best match union deserialization.
-                             */
-                            @JvmSynthetic
-                            internal fun validity(): Int =
-                                (bbox.asKnown().getOrNull()?.validity() ?: 0) +
-                                    (span.asKnown().getOrNull()?.size ?: 0)
-
-                            override fun equals(other: Any?): Boolean {
-                                if (this === other) {
-                                    return true
-                                }
-
-                                return other is Word &&
-                                    bbox == other.bbox &&
-                                    span == other.span &&
-                                    additionalProperties == other.additionalProperties
-                            }
-
-                            private val hashCode: Int by lazy {
-                                Objects.hash(bbox, span, additionalProperties)
-                            }
-
-                            override fun hashCode(): Int = hashCode
-
-                            override fun toString() =
-                                "Word{bbox=$bbox, span=$span, additionalProperties=$additionalProperties}"
-                        }
-
-                        override fun equals(other: Any?): Boolean {
-                            if (this === other) {
-                                return true
-                            }
-
-                            return other is Line &&
-                                bbox == other.bbox &&
-                                span == other.span &&
-                                words == other.words &&
-                                additionalProperties == other.additionalProperties
-                        }
-
-                        private val hashCode: Int by lazy {
-                            Objects.hash(bbox, span, words, additionalProperties)
-                        }
-
-                        override fun hashCode(): Int = hashCode
-
-                        override fun toString() =
-                            "Line{bbox=$bbox, span=$span, words=$words, additionalProperties=$additionalProperties}"
-                    }
-
-                    override fun equals(other: Any?): Boolean {
-                        if (this === other) {
-                            return true
-                        }
-
-                        return other is Label &&
-                            lines == other.lines &&
-                            additionalProperties == other.additionalProperties
-                    }
-
-                    private val hashCode: Int by lazy { Objects.hash(lines, additionalProperties) }
-
-                    override fun hashCode(): Int = hashCode
-
-                    override fun toString() =
-                        "Label{lines=$lines, additionalProperties=$additionalProperties}"
-                }
-
-                /**
-                 * Supported text with half-open UTF-8 byte spans into the complete property string.
-                 */
-                class Value
-                @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-                private constructor(
-                    private val lines: JsonField<List<Line>>,
-                    private val additionalProperties: MutableMap<String, JsonValue>,
-                ) {
-
-                    @JsonCreator
-                    private constructor(
-                        @JsonProperty("lines")
-                        @ExcludeMissing
-                        lines: JsonField<List<Line>> = JsonMissing.of()
-                    ) : this(lines, mutableMapOf())
-
-                    /**
-                     * Supported lines. Word requests include supported words; gaps are valid. Boxes
-                     * use final page coordinates and optional local rotation r.
-                     *
-                     * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected
-                     *   type or is unexpectedly missing or null (e.g. if the server responded with
-                     *   an unexpected value).
-                     */
-                    fun lines(): List<Line> = lines.getRequired("lines")
-
-                    /**
-                     * Returns the raw JSON value of [lines].
-                     *
-                     * Unlike [lines], this method doesn't throw if the JSON field has an unexpected
-                     * type.
-                     */
-                    @JsonProperty("lines")
-                    @ExcludeMissing
-                    fun _lines(): JsonField<List<Line>> = lines
-
-                    @JsonAnySetter
-                    private fun putAdditionalProperty(key: String, value: JsonValue) {
-                        additionalProperties.put(key, value)
-                    }
-
-                    @JsonAnyGetter
-                    @ExcludeMissing
-                    fun _additionalProperties(): Map<String, JsonValue> =
-                        Collections.unmodifiableMap(additionalProperties)
-
-                    fun toBuilder() = Builder().from(this)
-
-                    companion object {
-
-                        /**
-                         * Returns a mutable builder for constructing an instance of [Value].
-                         *
-                         * The following fields are required:
-                         * ```java
-                         * .lines()
-                         * ```
-                         */
-                        @JvmStatic fun builder() = Builder()
-                    }
-
-                    /** A builder for [Value]. */
-                    class Builder internal constructor() {
-
-                        private var lines: JsonField<MutableList<Line>>? = null
-                        private var additionalProperties: MutableMap<String, JsonValue> =
-                            mutableMapOf()
-
-                        @JvmSynthetic
-                        internal fun from(value: Value) = apply {
-                            lines = value.lines.map { it.toMutableList() }
-                            additionalProperties = value.additionalProperties.toMutableMap()
-                        }
-
-                        /**
-                         * Supported lines. Word requests include supported words; gaps are valid.
-                         * Boxes use final page coordinates and optional local rotation r.
-                         */
-                        fun lines(lines: List<Line>) = lines(JsonField.of(lines))
-
-                        /**
-                         * Sets [Builder.lines] to an arbitrary JSON value.
-                         *
-                         * You should usually call [Builder.lines] with a well-typed `List<Line>`
-                         * value instead. This method is primarily for setting the field to an
-                         * undocumented or not yet supported value.
-                         */
-                        fun lines(lines: JsonField<List<Line>>) = apply {
-                            this.lines = lines.map { it.toMutableList() }
-                        }
-
-                        /**
-                         * Adds a single [Line] to [lines].
-                         *
-                         * @throws IllegalStateException if the field was previously set to a
-                         *   non-list.
-                         */
-                        fun addLine(line: Line) = apply {
-                            lines =
-                                (lines ?: JsonField.of(mutableListOf())).also {
-                                    checkKnown("lines", it).add(line)
-                                }
-                        }
-
-                        fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
-                            apply {
-                                this.additionalProperties.clear()
-                                putAllAdditionalProperties(additionalProperties)
-                            }
-
-                        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                            additionalProperties.put(key, value)
-                        }
-
-                        fun putAllAdditionalProperties(
-                            additionalProperties: Map<String, JsonValue>
-                        ) = apply { this.additionalProperties.putAll(additionalProperties) }
-
-                        fun removeAdditionalProperty(key: String) = apply {
-                            additionalProperties.remove(key)
-                        }
-
-                        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                            keys.forEach(::removeAdditionalProperty)
-                        }
-
-                        /**
-                         * Returns an immutable instance of [Value].
-                         *
-                         * Further updates to this [Builder] will not mutate the returned instance.
-                         *
-                         * The following fields are required:
-                         * ```java
-                         * .lines()
-                         * ```
-                         *
-                         * @throws IllegalStateException if any required field is unset.
-                         */
-                        fun build(): Value =
-                            Value(
-                                checkRequired("lines", lines).map { it.toImmutable() },
-                                additionalProperties.toMutableMap(),
-                            )
-                    }
-
-                    private var validated: Boolean = false
-
-                    /**
-                     * Validates that the types of all values in this object match their expected
-                     * types recursively.
-                     *
-                     * This method is _not_ forwards compatible with new types from the API for
-                     * existing fields.
-                     *
-                     * @throws LlamaCloudInvalidDataException if any value type in this object
-                     *   doesn't match its expected type.
-                     */
-                    fun validate(): Value = apply {
-                        if (validated) {
-                            return@apply
-                        }
-
-                        lines().forEach { it.validate() }
-                        validated = true
-                    }
-
-                    fun isValid(): Boolean =
-                        try {
-                            validate()
-                            true
-                        } catch (e: LlamaCloudInvalidDataException) {
-                            false
-                        }
-
-                    /**
-                     * Returns a score indicating how many valid values are contained in this object
-                     * recursively.
-                     *
-                     * Used for best match union deserialization.
-                     */
-                    @JvmSynthetic
-                    internal fun validity(): Int =
-                        (lines.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
-
-                    /** One grounded line of text with an optional per-word breakdown. */
-                    class Line
-                    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-                    private constructor(
-                        private val bbox: JsonField<BBox>,
-                        private val span: JsonField<List<JsonValue>>,
-                        private val words: JsonField<List<Word>>,
-                        private val additionalProperties: MutableMap<String, JsonValue>,
-                    ) {
-
-                        @JsonCreator
-                        private constructor(
-                            @JsonProperty("bbox")
-                            @ExcludeMissing
-                            bbox: JsonField<BBox> = JsonMissing.of(),
-                            @JsonProperty("span")
-                            @ExcludeMissing
-                            span: JsonField<List<JsonValue>> = JsonMissing.of(),
-                            @JsonProperty("words")
-                            @ExcludeMissing
-                            words: JsonField<List<Word>> = JsonMissing.of(),
-                        ) : this(bbox, span, words, mutableMapOf())
-
-                        /**
-                         * Line bounding box
-                         *
-                         * @throws LlamaCloudInvalidDataException if the JSON field has an
-                         *   unexpected type or is unexpectedly missing or null (e.g. if the server
-                         *   responded with an unexpected value).
-                         */
-                        fun bbox(): BBox = bbox.getRequired("bbox")
-
-                        /**
-                         * `[start, end)` UTF-8 byte span in the complete source property string
-                         *
-                         * @throws LlamaCloudInvalidDataException if the JSON field has an
-                         *   unexpected type or is unexpectedly missing or null (e.g. if the server
-                         *   responded with an unexpected value).
-                         */
-                        fun span(): List<JsonValue> = span.getRequired("span")
-
-                        /**
-                         * Per-word grounding within the line, when available
-                         *
-                         * @throws LlamaCloudInvalidDataException if the JSON field has an
-                         *   unexpected type (e.g. if the server responded with an unexpected
-                         *   value).
-                         */
-                        fun words(): Optional<List<Word>> = words.getOptional("words")
-
-                        /**
-                         * Returns the raw JSON value of [bbox].
-                         *
-                         * Unlike [bbox], this method doesn't throw if the JSON field has an
-                         * unexpected type.
-                         */
-                        @JsonProperty("bbox") @ExcludeMissing fun _bbox(): JsonField<BBox> = bbox
-
-                        /**
-                         * Returns the raw JSON value of [span].
-                         *
-                         * Unlike [span], this method doesn't throw if the JSON field has an
-                         * unexpected type.
-                         */
-                        @JsonProperty("span")
-                        @ExcludeMissing
-                        fun _span(): JsonField<List<JsonValue>> = span
-
-                        /**
-                         * Returns the raw JSON value of [words].
-                         *
-                         * Unlike [words], this method doesn't throw if the JSON field has an
-                         * unexpected type.
-                         */
-                        @JsonProperty("words")
-                        @ExcludeMissing
-                        fun _words(): JsonField<List<Word>> = words
-
-                        @JsonAnySetter
-                        private fun putAdditionalProperty(key: String, value: JsonValue) {
-                            additionalProperties.put(key, value)
-                        }
-
-                        @JsonAnyGetter
-                        @ExcludeMissing
-                        fun _additionalProperties(): Map<String, JsonValue> =
-                            Collections.unmodifiableMap(additionalProperties)
-
-                        fun toBuilder() = Builder().from(this)
-
-                        companion object {
-
-                            /**
-                             * Returns a mutable builder for constructing an instance of [Line].
-                             *
-                             * The following fields are required:
-                             * ```java
-                             * .bbox()
-                             * .span()
-                             * ```
-                             */
-                            @JvmStatic fun builder() = Builder()
-                        }
-
-                        /** A builder for [Line]. */
-                        class Builder internal constructor() {
-
-                            private var bbox: JsonField<BBox>? = null
-                            private var span: JsonField<MutableList<JsonValue>>? = null
-                            private var words: JsonField<MutableList<Word>>? = null
-                            private var additionalProperties: MutableMap<String, JsonValue> =
-                                mutableMapOf()
-
-                            @JvmSynthetic
-                            internal fun from(line: Line) = apply {
-                                bbox = line.bbox
-                                span = line.span.map { it.toMutableList() }
-                                words = line.words.map { it.toMutableList() }
-                                additionalProperties = line.additionalProperties.toMutableMap()
-                            }
-
-                            /** Line bounding box */
-                            fun bbox(bbox: BBox) = bbox(JsonField.of(bbox))
-
-                            /**
-                             * Sets [Builder.bbox] to an arbitrary JSON value.
-                             *
-                             * You should usually call [Builder.bbox] with a well-typed [BBox] value
-                             * instead. This method is primarily for setting the field to an
-                             * undocumented or not yet supported value.
-                             */
-                            fun bbox(bbox: JsonField<BBox>) = apply { this.bbox = bbox }
-
-                            /**
-                             * `[start, end)` UTF-8 byte span in the complete source property string
-                             */
-                            fun span(span: List<JsonValue>) = span(JsonField.of(span))
-
-                            /**
-                             * Sets [Builder.span] to an arbitrary JSON value.
-                             *
-                             * You should usually call [Builder.span] with a well-typed
-                             * `List<JsonValue>` value instead. This method is primarily for setting
-                             * the field to an undocumented or not yet supported value.
-                             */
-                            fun span(span: JsonField<List<JsonValue>>) = apply {
-                                this.span = span.map { it.toMutableList() }
-                            }
-
-                            /**
-                             * Adds a single [JsonValue] to [Builder.span].
-                             *
-                             * @throws IllegalStateException if the field was previously set to a
-                             *   non-list.
-                             */
-                            fun addSpan(span: JsonValue) = apply {
-                                this.span =
-                                    (this.span ?: JsonField.of(mutableListOf())).also {
-                                        checkKnown("span", it).add(span)
-                                    }
-                            }
-
-                            /** Per-word grounding within the line, when available */
-                            fun words(words: List<Word>?) = words(JsonField.ofNullable(words))
-
-                            /** Alias for calling [Builder.words] with `words.orElse(null)`. */
-                            fun words(words: Optional<List<Word>>) = words(words.getOrNull())
-
-                            /**
-                             * Sets [Builder.words] to an arbitrary JSON value.
-                             *
-                             * You should usually call [Builder.words] with a well-typed
-                             * `List<Word>` value instead. This method is primarily for setting the
-                             * field to an undocumented or not yet supported value.
-                             */
-                            fun words(words: JsonField<List<Word>>) = apply {
-                                this.words = words.map { it.toMutableList() }
-                            }
-
-                            /**
-                             * Adds a single [Word] to [words].
-                             *
-                             * @throws IllegalStateException if the field was previously set to a
-                             *   non-list.
-                             */
-                            fun addWord(word: Word) = apply {
-                                words =
-                                    (words ?: JsonField.of(mutableListOf())).also {
-                                        checkKnown("words", it).add(word)
-                                    }
-                            }
-
-                            fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
-                                apply {
-                                    this.additionalProperties.clear()
-                                    putAllAdditionalProperties(additionalProperties)
-                                }
-
-                            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                                additionalProperties.put(key, value)
-                            }
-
-                            fun putAllAdditionalProperties(
-                                additionalProperties: Map<String, JsonValue>
-                            ) = apply { this.additionalProperties.putAll(additionalProperties) }
-
-                            fun removeAdditionalProperty(key: String) = apply {
-                                additionalProperties.remove(key)
-                            }
-
-                            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                                keys.forEach(::removeAdditionalProperty)
-                            }
-
-                            /**
-                             * Returns an immutable instance of [Line].
-                             *
-                             * Further updates to this [Builder] will not mutate the returned
-                             * instance.
-                             *
-                             * The following fields are required:
-                             * ```java
-                             * .bbox()
-                             * .span()
-                             * ```
-                             *
-                             * @throws IllegalStateException if any required field is unset.
-                             */
-                            fun build(): Line =
-                                Line(
-                                    checkRequired("bbox", bbox),
-                                    checkRequired("span", span).map { it.toImmutable() },
-                                    (words ?: JsonMissing.of()).map { it.toImmutable() },
-                                    additionalProperties.toMutableMap(),
-                                )
-                        }
-
-                        private var validated: Boolean = false
-
-                        /**
-                         * Validates that the types of all values in this object match their
-                         * expected types recursively.
-                         *
-                         * This method is _not_ forwards compatible with new types from the API for
-                         * existing fields.
-                         *
-                         * @throws LlamaCloudInvalidDataException if any value type in this object
-                         *   doesn't match its expected type.
-                         */
-                        fun validate(): Line = apply {
-                            if (validated) {
-                                return@apply
-                            }
-
-                            bbox().validate()
-                            span()
-                            words().ifPresent { it.forEach { it.validate() } }
-                            validated = true
-                        }
-
-                        fun isValid(): Boolean =
-                            try {
-                                validate()
-                                true
-                            } catch (e: LlamaCloudInvalidDataException) {
-                                false
-                            }
-
-                        /**
-                         * Returns a score indicating how many valid values are contained in this
-                         * object recursively.
-                         *
-                         * Used for best match union deserialization.
-                         */
-                        @JvmSynthetic
-                        internal fun validity(): Int =
-                            (bbox.asKnown().getOrNull()?.validity() ?: 0) +
-                                (span.asKnown().getOrNull()?.size ?: 0) +
-                                (words.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
-
-                        /**
-                         * One grounded word: a `[start, end)` span in the source text and its bbox.
-                         */
-                        class Word
-                        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-                        private constructor(
-                            private val bbox: JsonField<BBox>,
-                            private val span: JsonField<List<JsonValue>>,
-                            private val additionalProperties: MutableMap<String, JsonValue>,
-                        ) {
-
-                            @JsonCreator
-                            private constructor(
-                                @JsonProperty("bbox")
-                                @ExcludeMissing
-                                bbox: JsonField<BBox> = JsonMissing.of(),
-                                @JsonProperty("span")
-                                @ExcludeMissing
-                                span: JsonField<List<JsonValue>> = JsonMissing.of(),
-                            ) : this(bbox, span, mutableMapOf())
-
-                            /**
-                             * Word bounding box
-                             *
-                             * @throws LlamaCloudInvalidDataException if the JSON field has an
-                             *   unexpected type or is unexpectedly missing or null (e.g. if the
-                             *   server responded with an unexpected value).
-                             */
-                            fun bbox(): BBox = bbox.getRequired("bbox")
-
-                            /**
-                             * `[start, end)` UTF-8 byte span in the complete source property string
-                             *
-                             * @throws LlamaCloudInvalidDataException if the JSON field has an
-                             *   unexpected type or is unexpectedly missing or null (e.g. if the
-                             *   server responded with an unexpected value).
-                             */
-                            fun span(): List<JsonValue> = span.getRequired("span")
-
-                            /**
-                             * Returns the raw JSON value of [bbox].
-                             *
-                             * Unlike [bbox], this method doesn't throw if the JSON field has an
-                             * unexpected type.
-                             */
-                            @JsonProperty("bbox")
-                            @ExcludeMissing
-                            fun _bbox(): JsonField<BBox> = bbox
-
-                            /**
-                             * Returns the raw JSON value of [span].
-                             *
-                             * Unlike [span], this method doesn't throw if the JSON field has an
-                             * unexpected type.
-                             */
-                            @JsonProperty("span")
-                            @ExcludeMissing
-                            fun _span(): JsonField<List<JsonValue>> = span
-
-                            @JsonAnySetter
-                            private fun putAdditionalProperty(key: String, value: JsonValue) {
-                                additionalProperties.put(key, value)
-                            }
-
-                            @JsonAnyGetter
-                            @ExcludeMissing
-                            fun _additionalProperties(): Map<String, JsonValue> =
-                                Collections.unmodifiableMap(additionalProperties)
-
-                            fun toBuilder() = Builder().from(this)
-
-                            companion object {
-
-                                /**
-                                 * Returns a mutable builder for constructing an instance of [Word].
-                                 *
-                                 * The following fields are required:
-                                 * ```java
-                                 * .bbox()
-                                 * .span()
-                                 * ```
-                                 */
-                                @JvmStatic fun builder() = Builder()
-                            }
-
-                            /** A builder for [Word]. */
-                            class Builder internal constructor() {
-
-                                private var bbox: JsonField<BBox>? = null
-                                private var span: JsonField<MutableList<JsonValue>>? = null
-                                private var additionalProperties: MutableMap<String, JsonValue> =
-                                    mutableMapOf()
-
-                                @JvmSynthetic
-                                internal fun from(word: Word) = apply {
-                                    bbox = word.bbox
-                                    span = word.span.map { it.toMutableList() }
-                                    additionalProperties = word.additionalProperties.toMutableMap()
-                                }
-
-                                /** Word bounding box */
-                                fun bbox(bbox: BBox) = bbox(JsonField.of(bbox))
-
-                                /**
-                                 * Sets [Builder.bbox] to an arbitrary JSON value.
-                                 *
-                                 * You should usually call [Builder.bbox] with a well-typed [BBox]
-                                 * value instead. This method is primarily for setting the field to
-                                 * an undocumented or not yet supported value.
-                                 */
-                                fun bbox(bbox: JsonField<BBox>) = apply { this.bbox = bbox }
-
-                                /**
-                                 * `[start, end)` UTF-8 byte span in the complete source property
-                                 * string
-                                 */
-                                fun span(span: List<JsonValue>) = span(JsonField.of(span))
-
-                                /**
-                                 * Sets [Builder.span] to an arbitrary JSON value.
-                                 *
-                                 * You should usually call [Builder.span] with a well-typed
-                                 * `List<JsonValue>` value instead. This method is primarily for
-                                 * setting the field to an undocumented or not yet supported value.
-                                 */
-                                fun span(span: JsonField<List<JsonValue>>) = apply {
-                                    this.span = span.map { it.toMutableList() }
-                                }
-
-                                /**
-                                 * Adds a single [JsonValue] to [Builder.span].
-                                 *
-                                 * @throws IllegalStateException if the field was previously set to
-                                 *   a non-list.
-                                 */
-                                fun addSpan(span: JsonValue) = apply {
-                                    this.span =
-                                        (this.span ?: JsonField.of(mutableListOf())).also {
-                                            checkKnown("span", it).add(span)
-                                        }
-                                }
-
-                                fun additionalProperties(
-                                    additionalProperties: Map<String, JsonValue>
-                                ) = apply {
-                                    this.additionalProperties.clear()
-                                    putAllAdditionalProperties(additionalProperties)
-                                }
-
-                                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                                    additionalProperties.put(key, value)
-                                }
-
-                                fun putAllAdditionalProperties(
-                                    additionalProperties: Map<String, JsonValue>
-                                ) = apply { this.additionalProperties.putAll(additionalProperties) }
-
-                                fun removeAdditionalProperty(key: String) = apply {
-                                    additionalProperties.remove(key)
-                                }
-
-                                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                                    keys.forEach(::removeAdditionalProperty)
-                                }
-
-                                /**
-                                 * Returns an immutable instance of [Word].
-                                 *
-                                 * Further updates to this [Builder] will not mutate the returned
-                                 * instance.
-                                 *
-                                 * The following fields are required:
-                                 * ```java
-                                 * .bbox()
-                                 * .span()
-                                 * ```
-                                 *
-                                 * @throws IllegalStateException if any required field is unset.
-                                 */
-                                fun build(): Word =
-                                    Word(
-                                        checkRequired("bbox", bbox),
-                                        checkRequired("span", span).map { it.toImmutable() },
-                                        additionalProperties.toMutableMap(),
-                                    )
-                            }
-
-                            private var validated: Boolean = false
-
-                            /**
-                             * Validates that the types of all values in this object match their
-                             * expected types recursively.
-                             *
-                             * This method is _not_ forwards compatible with new types from the API
-                             * for existing fields.
-                             *
-                             * @throws LlamaCloudInvalidDataException if any value type in this
-                             *   object doesn't match its expected type.
-                             */
-                            fun validate(): Word = apply {
-                                if (validated) {
-                                    return@apply
-                                }
-
-                                bbox().validate()
-                                span()
-                                validated = true
-                            }
-
-                            fun isValid(): Boolean =
-                                try {
-                                    validate()
-                                    true
-                                } catch (e: LlamaCloudInvalidDataException) {
-                                    false
-                                }
-
-                            /**
-                             * Returns a score indicating how many valid values are contained in
-                             * this object recursively.
-                             *
-                             * Used for best match union deserialization.
-                             */
-                            @JvmSynthetic
-                            internal fun validity(): Int =
-                                (bbox.asKnown().getOrNull()?.validity() ?: 0) +
-                                    (span.asKnown().getOrNull()?.size ?: 0)
-
-                            override fun equals(other: Any?): Boolean {
-                                if (this === other) {
-                                    return true
-                                }
-
-                                return other is Word &&
-                                    bbox == other.bbox &&
-                                    span == other.span &&
-                                    additionalProperties == other.additionalProperties
-                            }
-
-                            private val hashCode: Int by lazy {
-                                Objects.hash(bbox, span, additionalProperties)
-                            }
-
-                            override fun hashCode(): Int = hashCode
-
-                            override fun toString() =
-                                "Word{bbox=$bbox, span=$span, additionalProperties=$additionalProperties}"
-                        }
-
-                        override fun equals(other: Any?): Boolean {
-                            if (this === other) {
-                                return true
-                            }
-
-                            return other is Line &&
-                                bbox == other.bbox &&
-                                span == other.span &&
-                                words == other.words &&
-                                additionalProperties == other.additionalProperties
-                        }
-
-                        private val hashCode: Int by lazy {
-                            Objects.hash(bbox, span, words, additionalProperties)
-                        }
-
-                        override fun hashCode(): Int = hashCode
-
-                        override fun toString() =
-                            "Line{bbox=$bbox, span=$span, words=$words, additionalProperties=$additionalProperties}"
-                    }
-
-                    override fun equals(other: Any?): Boolean {
-                        if (this === other) {
-                            return true
-                        }
-
-                        return other is Value &&
-                            lines == other.lines &&
-                            additionalProperties == other.additionalProperties
-                    }
-
-                    private val hashCode: Int by lazy { Objects.hash(lines, additionalProperties) }
-
-                    override fun hashCode(): Int = hashCode
-
-                    override fun toString() =
-                        "Value{lines=$lines, additionalProperties=$additionalProperties}"
-                }
-
-                override fun equals(other: Any?): Boolean {
-                    if (this === other) {
-                        return true
-                    }
-
-                    return other is Grounding &&
-                        id == other.id &&
-                        label == other.label &&
-                        value == other.value &&
-                        additionalProperties == other.additionalProperties
-                }
-
-                private val hashCode: Int by lazy {
-                    Objects.hash(id, label, value, additionalProperties)
-                }
-
-                override fun hashCode(): Int = hashCode
-
-                override fun toString() =
-                    "Grounding{id=$id, label=$label, value=$value, additionalProperties=$additionalProperties}"
-            }
-
-            /** Form text node */
-            class Type @JsonCreator private constructor(private val value: JsonField<String>) :
-                Enum {
-
-                /**
-                 * Returns this class instance's raw value.
-                 *
-                 * This is usually only useful if this instance was deserialized from data that
-                 * doesn't match any known member, and you want to know that value. For example, if
-                 * the SDK is on an older version than the API, then the API may respond with new
-                 * members that the SDK is unaware of.
-                 */
-                @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
-
-                companion object {
-
-                    @JvmField val TEXT = of("text")
-
-                    @JvmStatic fun of(value: String) = Type(JsonField.of(value))
-                }
-
-                /** An enum containing [Type]'s known values. */
-                enum class Known {
-                    TEXT
-                }
-
-                /**
-                 * An enum containing [Type]'s known values, as well as an [_UNKNOWN] member.
-                 *
-                 * An instance of [Type] can contain an unknown value in a couple of cases:
-                 * - It was deserialized from data that doesn't match any known member. For example,
-                 *   if the SDK is on an older version than the API, then the API may respond with
-                 *   new members that the SDK is unaware of.
-                 * - It was constructed with an arbitrary value using the [of] method.
-                 */
-                enum class Value {
-                    TEXT,
-                    /**
-                     * An enum member indicating that [Type] was instantiated with an unknown value.
-                     */
-                    _UNKNOWN,
-                }
-
-                /**
-                 * Returns an enum member corresponding to this class instance's value, or
-                 * [Value._UNKNOWN] if the class was instantiated with an unknown value.
-                 *
-                 * Use the [known] method instead if you're certain the value is always known or if
-                 * you want to throw for the unknown case.
-                 */
-                fun value(): Value =
-                    when (this) {
-                        TEXT -> Value.TEXT
-                        else -> Value._UNKNOWN
-                    }
-
-                /**
-                 * Returns an enum member corresponding to this class instance's value.
-                 *
-                 * Use the [value] method instead if you're uncertain the value is always known and
-                 * don't want to throw for the unknown case.
-                 *
-                 * @throws LlamaCloudInvalidDataException if this class instance's value is a not a
-                 *   known member.
-                 */
-                fun known(): Known =
-                    when (this) {
-                        TEXT -> Known.TEXT
-                        else -> throw LlamaCloudInvalidDataException("Unknown Type: $value")
-                    }
-
-                /**
-                 * Returns this class instance's primitive wire representation.
-                 *
-                 * This differs from the [toString] method because that method is primarily for
-                 * debugging and generally doesn't throw.
-                 *
-                 * @throws LlamaCloudInvalidDataException if this class instance's value does not
-                 *   have the expected primitive type.
-                 */
-                fun asString(): String =
-                    _value().asString().orElseThrow {
-                        LlamaCloudInvalidDataException("Value is not a String")
-                    }
-
-                private var validated: Boolean = false
-
-                /**
-                 * Validates that the types of all values in this object match their expected types
-                 * recursively.
-                 *
-                 * This method is _not_ forwards compatible with new types from the API for existing
-                 * fields.
-                 *
-                 * @throws LlamaCloudInvalidDataException if any value type in this object doesn't
-                 *   match its expected type.
-                 */
-                fun validate(): Type = apply {
-                    if (validated) {
-                        return@apply
-                    }
-
-                    known()
-                    validated = true
-                }
-
-                fun isValid(): Boolean =
-                    try {
-                        validate()
-                        true
-                    } catch (e: LlamaCloudInvalidDataException) {
-                        false
-                    }
-
-                /**
-                 * Returns a score indicating how many valid values are contained in this object
-                 * recursively.
-                 *
-                 * Used for best match union deserialization.
-                 */
-                @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
-
-                override fun equals(other: Any?): Boolean {
-                    if (this === other) {
-                        return true
-                    }
-
-                    return other is Type && value == other.value
-                }
-
-                override fun hashCode() = value.hashCode()
-
-                override fun toString() = value.toString()
-            }
-
-            override fun equals(other: Any?): Boolean {
-                if (this === other) {
-                    return true
-                }
-
-                return other is Text &&
-                    value == other.value &&
-                    bbox == other.bbox &&
-                    grounding == other.grounding &&
-                    type == other.type &&
-                    additionalProperties == other.additionalProperties
-            }
-
-            private val hashCode: Int by lazy {
-                Objects.hash(value, bbox, grounding, type, additionalProperties)
-            }
-
-            override fun hashCode(): Int = hashCode
-
-            override fun toString() =
-                "Text{value=$value, bbox=$bbox, grounding=$grounding, type=$type, additionalProperties=$additionalProperties}"
-        }
     }
 
     override fun equals(other: Any?): Boolean {
diff --git a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/FormField.kt b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/FormField.kt
index 4067d8e..1f7a6b3 100644
--- a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/FormField.kt
+++ b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/FormField.kt
@@ -471,24 +471,19 @@ private constructor(
             addValueItem(FormTable.builder().type(FormTable.Type.TABLE).rows(rows).build())
 
         /** Alias for calling [addValueItem] with `ValueItem.ofText(text)`. */
-        fun addValueItem(text: ValueItem.Text) = addValueItem(ValueItem.ofText(text))
+        fun addValueItem(text: FormText) = addValueItem(ValueItem.ofText(text))
 
         /**
          * Alias for calling [addValueItem] with the following:
          * ```java
-         * ValueItem.Text.builder()
-         *     .type(FormField.ValueItem.Text.Type.TEXT)
+         * FormText.builder()
+         *     .type(FormText.Type.TEXT)
          *     .value(value)
          *     .build()
          * ```
          */
         fun addTextValueItem(value: String) =
-            addValueItem(
-                ValueItem.Text.builder()
-                    .type(FormField.ValueItem.Text.Type.TEXT)
-                    .value(value)
-                    .build()
-            )
+            addValueItem(FormText.builder().type(FormText.Type.TEXT).value(value).build())
 
         fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
             this.additionalProperties.clear()
@@ -3499,7 +3494,7 @@ private constructor(
         private val field: FormField? = null,
         private val section: FormSection? = null,
         private val table: FormTable? = null,
-        private val text: Text? = null,
+        private val text: FormText? = null,
         private val _json: JsonValue? = null,
     ) {
 
@@ -3516,7 +3511,7 @@ private constructor(
          * Printed text that is not part of a field, section heading or table: a title, an
          * instruction, a note. With it the form JSON holds every printed word of its region.
          */
-        fun text(): Optional<Text> = Optional.ofNullable(text)
+        fun text(): Optional<FormText> = Optional.ofNullable(text)
 
         fun isField(): Boolean = field != null
 
@@ -3539,7 +3534,7 @@ private constructor(
          * Printed text that is not part of a field, section heading or table: a title, an
          * instruction, a note. With it the form JSON holds every printed word of its region.
          */
-        fun asText(): Text = text.getOrThrow("text")
+        fun asText(): FormText = text.getOrThrow("text")
 
         fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
 
@@ -3611,7 +3606,7 @@ private constructor(
                         table.validate()
                     }
 
-                    override fun visitText(text: Text) {
+                    override fun visitText(text: FormText) {
                         text.validate()
                     }
                 }
@@ -3643,7 +3638,7 @@ private constructor(
 
                     override fun visitTable(table: FormTable) = table.validity()
 
-                    override fun visitText(text: Text) = text.validity()
+                    override fun visitText(text: FormText) = text.validity()
 
                     override fun unknown(json: JsonValue?) = 0
                 }
@@ -3688,7 +3683,7 @@ private constructor(
              * Printed text that is not part of a field, section heading or table: a title, an
              * instruction, a note. With it the form JSON holds every printed word of its region.
              */
-            @JvmStatic fun ofText(text: Text) = ValueItem(text = text)
+            @JvmStatic fun ofText(text: FormText) = ValueItem(text = text)
         }
 
         /**
@@ -3709,7 +3704,7 @@ private constructor(
              * Printed text that is not part of a field, section heading or table: a title, an
              * instruction, a note. With it the form JSON holds every printed word of its region.
              */
-            fun visitText(text: Text): T
+            fun visitText(text: FormText): T
 
             /**
              * Maps an unknown variant of [ValueItem] to a value of type [T].
@@ -3749,7 +3744,7 @@ private constructor(
                         } ?: ValueItem(_json = json)
                     }
                     "text" -> {
-                        return tryDeserialize(node, jacksonTypeRef<Text>())?.let {
+                        return tryDeserialize(node, jacksonTypeRef<FormText>())?.let {
                             ValueItem(text = it, _json = json)
                         } ?: ValueItem(_json = json)
                     }
@@ -3776,2972 +3771,6 @@ private constructor(
                 }
             }
         }
-
-        /**
-         * Printed text that is not part of a field, section heading or table: a title, an
-         * instruction, a note. With it the form JSON holds every printed word of its region.
-         */
-        class Text
-        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-        private constructor(
-            private val value: JsonField<String>,
-            private val bbox: JsonField<List<BBox>>,
-            private val grounding: JsonField<Grounding>,
-            private val type: JsonField<Type>,
-            private val additionalProperties: MutableMap<String, JsonValue>,
-        ) {
-
-            @JsonCreator
-            private constructor(
-                @JsonProperty("value") @ExcludeMissing value: JsonField<String> = JsonMissing.of(),
-                @JsonProperty("bbox")
-                @ExcludeMissing
-                bbox: JsonField<List<BBox>> = JsonMissing.of(),
-                @JsonProperty("grounding")
-                @ExcludeMissing
-                grounding: JsonField<Grounding> = JsonMissing.of(),
-                @JsonProperty("type") @ExcludeMissing type: JsonField<Type> = JsonMissing.of(),
-            ) : this(value, bbox, grounding, type, mutableMapOf())
-
-            /**
-             * The printed text, verbatim
-             *
-             * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type or is
-             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
-             *   value).
-             */
-            fun value(): String = value.getRequired("value")
-
-            /**
-             * Bounding boxes of the text on the page, if attributed.
-             *
-             * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g.
-             *   if the server responded with an unexpected value).
-             */
-            fun bbox(): Optional<List<BBox>> = bbox.getOptional("bbox")
-
-            /**
-             * Optional grounding for a field's printed text; boolean states have no text spans.
-             *
-             * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g.
-             *   if the server responded with an unexpected value).
-             */
-            fun grounding(): Optional<Grounding> = grounding.getOptional("grounding")
-
-            /**
-             * Form text node
-             *
-             * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g.
-             *   if the server responded with an unexpected value).
-             */
-            fun type(): Optional<Type> = type.getOptional("type")
-
-            /**
-             * Returns the raw JSON value of [value].
-             *
-             * Unlike [value], this method doesn't throw if the JSON field has an unexpected type.
-             */
-            @JsonProperty("value") @ExcludeMissing fun _value(): JsonField<String> = value
-
-            /**
-             * Returns the raw JSON value of [bbox].
-             *
-             * Unlike [bbox], this method doesn't throw if the JSON field has an unexpected type.
-             */
-            @JsonProperty("bbox") @ExcludeMissing fun _bbox(): JsonField<List<BBox>> = bbox
-
-            /**
-             * Returns the raw JSON value of [grounding].
-             *
-             * Unlike [grounding], this method doesn't throw if the JSON field has an unexpected
-             * type.
-             */
-            @JsonProperty("grounding")
-            @ExcludeMissing
-            fun _grounding(): JsonField<Grounding> = grounding
-
-            /**
-             * Returns the raw JSON value of [type].
-             *
-             * Unlike [type], this method doesn't throw if the JSON field has an unexpected type.
-             */
-            @JsonProperty("type") @ExcludeMissing fun _type(): JsonField<Type> = type
-
-            @JsonAnySetter
-            private fun putAdditionalProperty(key: String, value: JsonValue) {
-                additionalProperties.put(key, value)
-            }
-
-            @JsonAnyGetter
-            @ExcludeMissing
-            fun _additionalProperties(): Map<String, JsonValue> =
-                Collections.unmodifiableMap(additionalProperties)
-
-            fun toBuilder() = Builder().from(this)
-
-            companion object {
-
-                /**
-                 * Returns a mutable builder for constructing an instance of [Text].
-                 *
-                 * The following fields are required:
-                 * ```java
-                 * .value()
-                 * ```
-                 */
-                @JvmStatic fun builder() = Builder()
-            }
-
-            /** A builder for [Text]. */
-            class Builder internal constructor() {
-
-                private var value: JsonField<String>? = null
-                private var bbox: JsonField<MutableList<BBox>>? = null
-                private var grounding: JsonField<Grounding> = JsonMissing.of()
-                private var type: JsonField<Type> = JsonMissing.of()
-                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
-
-                @JvmSynthetic
-                internal fun from(text: Text) = apply {
-                    value = text.value
-                    bbox = text.bbox.map { it.toMutableList() }
-                    grounding = text.grounding
-                    type = text.type
-                    additionalProperties = text.additionalProperties.toMutableMap()
-                }
-
-                /** The printed text, verbatim */
-                fun value(value: String) = value(JsonField.of(value))
-
-                /**
-                 * Sets [Builder.value] to an arbitrary JSON value.
-                 *
-                 * You should usually call [Builder.value] with a well-typed [String] value instead.
-                 * This method is primarily for setting the field to an undocumented or not yet
-                 * supported value.
-                 */
-                fun value(value: JsonField<String>) = apply { this.value = value }
-
-                /** Bounding boxes of the text on the page, if attributed. */
-                fun bbox(bbox: List<BBox>?) = bbox(JsonField.ofNullable(bbox))
-
-                /** Alias for calling [Builder.bbox] with `bbox.orElse(null)`. */
-                fun bbox(bbox: Optional<List<BBox>>) = bbox(bbox.getOrNull())
-
-                /**
-                 * Sets [Builder.bbox] to an arbitrary JSON value.
-                 *
-                 * You should usually call [Builder.bbox] with a well-typed `List<BBox>` value
-                 * instead. This method is primarily for setting the field to an undocumented or not
-                 * yet supported value.
-                 */
-                fun bbox(bbox: JsonField<List<BBox>>) = apply {
-                    this.bbox = bbox.map { it.toMutableList() }
-                }
-
-                /**
-                 * Adds a single [BBox] to [Builder.bbox].
-                 *
-                 * @throws IllegalStateException if the field was previously set to a non-list.
-                 */
-                fun addBbox(bbox: BBox) = apply {
-                    this.bbox =
-                        (this.bbox ?: JsonField.of(mutableListOf())).also {
-                            checkKnown("bbox", it).add(bbox)
-                        }
-                }
-
-                /**
-                 * Optional grounding for a field's printed text; boolean states have no text spans.
-                 */
-                fun grounding(grounding: Grounding?) = grounding(JsonField.ofNullable(grounding))
-
-                /** Alias for calling [Builder.grounding] with `grounding.orElse(null)`. */
-                fun grounding(grounding: Optional<Grounding>) = grounding(grounding.getOrNull())
-
-                /**
-                 * Sets [Builder.grounding] to an arbitrary JSON value.
-                 *
-                 * You should usually call [Builder.grounding] with a well-typed [Grounding] value
-                 * instead. This method is primarily for setting the field to an undocumented or not
-                 * yet supported value.
-                 */
-                fun grounding(grounding: JsonField<Grounding>) = apply {
-                    this.grounding = grounding
-                }
-
-                /** Form text node */
-                fun type(type: Type) = type(JsonField.of(type))
-
-                /**
-                 * Sets [Builder.type] to an arbitrary JSON value.
-                 *
-                 * You should usually call [Builder.type] with a well-typed [Type] value instead.
-                 * This method is primarily for setting the field to an undocumented or not yet
-                 * supported value.
-                 */
-                fun type(type: JsonField<Type>) = apply { this.type = type }
-
-                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
-                    this.additionalProperties.clear()
-                    putAllAdditionalProperties(additionalProperties)
-                }
-
-                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                    additionalProperties.put(key, value)
-                }
-
-                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
-                    apply {
-                        this.additionalProperties.putAll(additionalProperties)
-                    }
-
-                fun removeAdditionalProperty(key: String) = apply {
-                    additionalProperties.remove(key)
-                }
-
-                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                    keys.forEach(::removeAdditionalProperty)
-                }
-
-                /**
-                 * Returns an immutable instance of [Text].
-                 *
-                 * Further updates to this [Builder] will not mutate the returned instance.
-                 *
-                 * The following fields are required:
-                 * ```java
-                 * .value()
-                 * ```
-                 *
-                 * @throws IllegalStateException if any required field is unset.
-                 */
-                fun build(): Text =
-                    Text(
-                        checkRequired("value", value),
-                        (bbox ?: JsonMissing.of()).map { it.toImmutable() },
-                        grounding,
-                        type,
-                        additionalProperties.toMutableMap(),
-                    )
-            }
-
-            private var validated: Boolean = false
-
-            /**
-             * Validates that the types of all values in this object match their expected types
-             * recursively.
-             *
-             * This method is _not_ forwards compatible with new types from the API for existing
-             * fields.
-             *
-             * @throws LlamaCloudInvalidDataException if any value type in this object doesn't match
-             *   its expected type.
-             */
-            fun validate(): Text = apply {
-                if (validated) {
-                    return@apply
-                }
-
-                value()
-                bbox().ifPresent { it.forEach { it.validate() } }
-                grounding().ifPresent { it.validate() }
-                type().ifPresent { it.validate() }
-                validated = true
-            }
-
-            fun isValid(): Boolean =
-                try {
-                    validate()
-                    true
-                } catch (e: LlamaCloudInvalidDataException) {
-                    false
-                }
-
-            /**
-             * Returns a score indicating how many valid values are contained in this object
-             * recursively.
-             *
-             * Used for best match union deserialization.
-             */
-            @JvmSynthetic
-            internal fun validity(): Int =
-                (if (value.asKnown().isPresent) 1 else 0) +
-                    (bbox.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
-                    (grounding.asKnown().getOrNull()?.validity() ?: 0) +
-                    (type.asKnown().getOrNull()?.validity() ?: 0)
-
-            /** Optional grounding for a field's printed text; boolean states have no text spans. */
-            class Grounding
-            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-            private constructor(
-                private val id: JsonField<Id>,
-                private val label: JsonField<Label>,
-                private val value: JsonField<Value>,
-                private val additionalProperties: MutableMap<String, JsonValue>,
-            ) {
-
-                @JsonCreator
-                private constructor(
-                    @JsonProperty("id") @ExcludeMissing id: JsonField<Id> = JsonMissing.of(),
-                    @JsonProperty("label")
-                    @ExcludeMissing
-                    label: JsonField<Label> = JsonMissing.of(),
-                    @JsonProperty("value")
-                    @ExcludeMissing
-                    value: JsonField<Value> = JsonMissing.of(),
-                ) : this(id, label, value, mutableMapOf())
-
-                /**
-                 * Supported text with half-open UTF-8 byte spans into the complete property string.
-                 *
-                 * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type
-                 *   (e.g. if the server responded with an unexpected value).
-                 */
-                fun id(): Optional<Id> = id.getOptional("id")
-
-                /**
-                 * Supported text with half-open UTF-8 byte spans into the complete property string.
-                 *
-                 * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type
-                 *   (e.g. if the server responded with an unexpected value).
-                 */
-                fun label(): Optional<Label> = label.getOptional("label")
-
-                /**
-                 * Supported text with half-open UTF-8 byte spans into the complete property string.
-                 *
-                 * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type
-                 *   (e.g. if the server responded with an unexpected value).
-                 */
-                fun value(): Optional<Value> = value.getOptional("value")
-
-                /**
-                 * Returns the raw JSON value of [id].
-                 *
-                 * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
-                 */
-                @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<Id> = id
-
-                /**
-                 * Returns the raw JSON value of [label].
-                 *
-                 * Unlike [label], this method doesn't throw if the JSON field has an unexpected
-                 * type.
-                 */
-                @JsonProperty("label") @ExcludeMissing fun _label(): JsonField<Label> = label
-
-                /**
-                 * Returns the raw JSON value of [value].
-                 *
-                 * Unlike [value], this method doesn't throw if the JSON field has an unexpected
-                 * type.
-                 */
-                @JsonProperty("value") @ExcludeMissing fun _value(): JsonField<Value> = value
-
-                @JsonAnySetter
-                private fun putAdditionalProperty(key: String, value: JsonValue) {
-                    additionalProperties.put(key, value)
-                }
-
-                @JsonAnyGetter
-                @ExcludeMissing
-                fun _additionalProperties(): Map<String, JsonValue> =
-                    Collections.unmodifiableMap(additionalProperties)
-
-                fun toBuilder() = Builder().from(this)
-
-                companion object {
-
-                    /** Returns a mutable builder for constructing an instance of [Grounding]. */
-                    @JvmStatic fun builder() = Builder()
-                }
-
-                /** A builder for [Grounding]. */
-                class Builder internal constructor() {
-
-                    private var id: JsonField<Id> = JsonMissing.of()
-                    private var label: JsonField<Label> = JsonMissing.of()
-                    private var value: JsonField<Value> = JsonMissing.of()
-                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
-
-                    @JvmSynthetic
-                    internal fun from(grounding: Grounding) = apply {
-                        id = grounding.id
-                        label = grounding.label
-                        value = grounding.value
-                        additionalProperties = grounding.additionalProperties.toMutableMap()
-                    }
-
-                    /**
-                     * Supported text with half-open UTF-8 byte spans into the complete property
-                     * string.
-                     */
-                    fun id(id: Id?) = id(JsonField.ofNullable(id))
-
-                    /** Alias for calling [Builder.id] with `id.orElse(null)`. */
-                    fun id(id: Optional<Id>) = id(id.getOrNull())
-
-                    /**
-                     * Sets [Builder.id] to an arbitrary JSON value.
-                     *
-                     * You should usually call [Builder.id] with a well-typed [Id] value instead.
-                     * This method is primarily for setting the field to an undocumented or not yet
-                     * supported value.
-                     */
-                    fun id(id: JsonField<Id>) = apply { this.id = id }
-
-                    /**
-                     * Supported text with half-open UTF-8 byte spans into the complete property
-                     * string.
-                     */
-                    fun label(label: Label?) = label(JsonField.ofNullable(label))
-
-                    /** Alias for calling [Builder.label] with `label.orElse(null)`. */
-                    fun label(label: Optional<Label>) = label(label.getOrNull())
-
-                    /**
-                     * Sets [Builder.label] to an arbitrary JSON value.
-                     *
-                     * You should usually call [Builder.label] with a well-typed [Label] value
-                     * instead. This method is primarily for setting the field to an undocumented or
-                     * not yet supported value.
-                     */
-                    fun label(label: JsonField<Label>) = apply { this.label = label }
-
-                    /**
-                     * Supported text with half-open UTF-8 byte spans into the complete property
-                     * string.
-                     */
-                    fun value(value: Value?) = value(JsonField.ofNullable(value))
-
-                    /** Alias for calling [Builder.value] with `value.orElse(null)`. */
-                    fun value(value: Optional<Value>) = value(value.getOrNull())
-
-                    /**
-                     * Sets [Builder.value] to an arbitrary JSON value.
-                     *
-                     * You should usually call [Builder.value] with a well-typed [Value] value
-                     * instead. This method is primarily for setting the field to an undocumented or
-                     * not yet supported value.
-                     */
-                    fun value(value: JsonField<Value>) = apply { this.value = value }
-
-                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
-                        this.additionalProperties.clear()
-                        putAllAdditionalProperties(additionalProperties)
-                    }
-
-                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                        additionalProperties.put(key, value)
-                    }
-
-                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
-                        apply {
-                            this.additionalProperties.putAll(additionalProperties)
-                        }
-
-                    fun removeAdditionalProperty(key: String) = apply {
-                        additionalProperties.remove(key)
-                    }
-
-                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                        keys.forEach(::removeAdditionalProperty)
-                    }
-
-                    /**
-                     * Returns an immutable instance of [Grounding].
-                     *
-                     * Further updates to this [Builder] will not mutate the returned instance.
-                     */
-                    fun build(): Grounding =
-                        Grounding(id, label, value, additionalProperties.toMutableMap())
-                }
-
-                private var validated: Boolean = false
-
-                /**
-                 * Validates that the types of all values in this object match their expected types
-                 * recursively.
-                 *
-                 * This method is _not_ forwards compatible with new types from the API for existing
-                 * fields.
-                 *
-                 * @throws LlamaCloudInvalidDataException if any value type in this object doesn't
-                 *   match its expected type.
-                 */
-                fun validate(): Grounding = apply {
-                    if (validated) {
-                        return@apply
-                    }
-
-                    id().ifPresent { it.validate() }
-                    label().ifPresent { it.validate() }
-                    value().ifPresent { it.validate() }
-                    validated = true
-                }
-
-                fun isValid(): Boolean =
-                    try {
-                        validate()
-                        true
-                    } catch (e: LlamaCloudInvalidDataException) {
-                        false
-                    }
-
-                /**
-                 * Returns a score indicating how many valid values are contained in this object
-                 * recursively.
-                 *
-                 * Used for best match union deserialization.
-                 */
-                @JvmSynthetic
-                internal fun validity(): Int =
-                    (id.asKnown().getOrNull()?.validity() ?: 0) +
-                        (label.asKnown().getOrNull()?.validity() ?: 0) +
-                        (value.asKnown().getOrNull()?.validity() ?: 0)
-
-                /**
-                 * Supported text with half-open UTF-8 byte spans into the complete property string.
-                 */
-                class Id
-                @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-                private constructor(
-                    private val lines: JsonField<List<Line>>,
-                    private val additionalProperties: MutableMap<String, JsonValue>,
-                ) {
-
-                    @JsonCreator
-                    private constructor(
-                        @JsonProperty("lines")
-                        @ExcludeMissing
-                        lines: JsonField<List<Line>> = JsonMissing.of()
-                    ) : this(lines, mutableMapOf())
-
-                    /**
-                     * Supported lines. Word requests include supported words; gaps are valid. Boxes
-                     * use final page coordinates and optional local rotation r.
-                     *
-                     * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected
-                     *   type or is unexpectedly missing or null (e.g. if the server responded with
-                     *   an unexpected value).
-                     */
-                    fun lines(): List<Line> = lines.getRequired("lines")
-
-                    /**
-                     * Returns the raw JSON value of [lines].
-                     *
-                     * Unlike [lines], this method doesn't throw if the JSON field has an unexpected
-                     * type.
-                     */
-                    @JsonProperty("lines")
-                    @ExcludeMissing
-                    fun _lines(): JsonField<List<Line>> = lines
-
-                    @JsonAnySetter
-                    private fun putAdditionalProperty(key: String, value: JsonValue) {
-                        additionalProperties.put(key, value)
-                    }
-
-                    @JsonAnyGetter
-                    @ExcludeMissing
-                    fun _additionalProperties(): Map<String, JsonValue> =
-                        Collections.unmodifiableMap(additionalProperties)
-
-                    fun toBuilder() = Builder().from(this)
-
-                    companion object {
-
-                        /**
-                         * Returns a mutable builder for constructing an instance of [Id].
-                         *
-                         * The following fields are required:
-                         * ```java
-                         * .lines()
-                         * ```
-                         */
-                        @JvmStatic fun builder() = Builder()
-                    }
-
-                    /** A builder for [Id]. */
-                    class Builder internal constructor() {
-
-                        private var lines: JsonField<MutableList<Line>>? = null
-                        private var additionalProperties: MutableMap<String, JsonValue> =
-                            mutableMapOf()
-
-                        @JvmSynthetic
-                        internal fun from(id: Id) = apply {
-                            lines = id.lines.map { it.toMutableList() }
-                            additionalProperties = id.additionalProperties.toMutableMap()
-                        }
-
-                        /**
-                         * Supported lines. Word requests include supported words; gaps are valid.
-                         * Boxes use final page coordinates and optional local rotation r.
-                         */
-                        fun lines(lines: List<Line>) = lines(JsonField.of(lines))
-
-                        /**
-                         * Sets [Builder.lines] to an arbitrary JSON value.
-                         *
-                         * You should usually call [Builder.lines] with a well-typed `List<Line>`
-                         * value instead. This method is primarily for setting the field to an
-                         * undocumented or not yet supported value.
-                         */
-                        fun lines(lines: JsonField<List<Line>>) = apply {
-                            this.lines = lines.map { it.toMutableList() }
-                        }
-
-                        /**
-                         * Adds a single [Line] to [lines].
-                         *
-                         * @throws IllegalStateException if the field was previously set to a
-                         *   non-list.
-                         */
-                        fun addLine(line: Line) = apply {
-                            lines =
-                                (lines ?: JsonField.of(mutableListOf())).also {
-                                    checkKnown("lines", it).add(line)
-                                }
-                        }
-
-                        fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
-                            apply {
-                                this.additionalProperties.clear()
-                                putAllAdditionalProperties(additionalProperties)
-                            }
-
-                        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                            additionalProperties.put(key, value)
-                        }
-
-                        fun putAllAdditionalProperties(
-                            additionalProperties: Map<String, JsonValue>
-                        ) = apply { this.additionalProperties.putAll(additionalProperties) }
-
-                        fun removeAdditionalProperty(key: String) = apply {
-                            additionalProperties.remove(key)
-                        }
-
-                        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                            keys.forEach(::removeAdditionalProperty)
-                        }
-
-                        /**
-                         * Returns an immutable instance of [Id].
-                         *
-                         * Further updates to this [Builder] will not mutate the returned instance.
-                         *
-                         * The following fields are required:
-                         * ```java
-                         * .lines()
-                         * ```
-                         *
-                         * @throws IllegalStateException if any required field is unset.
-                         */
-                        fun build(): Id =
-                            Id(
-                                checkRequired("lines", lines).map { it.toImmutable() },
-                                additionalProperties.toMutableMap(),
-                            )
-                    }
-
-                    private var validated: Boolean = false
-
-                    /**
-                     * Validates that the types of all values in this object match their expected
-                     * types recursively.
-                     *
-                     * This method is _not_ forwards compatible with new types from the API for
-                     * existing fields.
-                     *
-                     * @throws LlamaCloudInvalidDataException if any value type in this object
-                     *   doesn't match its expected type.
-                     */
-                    fun validate(): Id = apply {
-                        if (validated) {
-                            return@apply
-                        }
-
-                        lines().forEach { it.validate() }
-                        validated = true
-                    }
-
-                    fun isValid(): Boolean =
-                        try {
-                            validate()
-                            true
-                        } catch (e: LlamaCloudInvalidDataException) {
-                            false
-                        }
-
-                    /**
-                     * Returns a score indicating how many valid values are contained in this object
-                     * recursively.
-                     *
-                     * Used for best match union deserialization.
-                     */
-                    @JvmSynthetic
-                    internal fun validity(): Int =
-                        (lines.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
-
-                    /** One grounded line of text with an optional per-word breakdown. */
-                    class Line
-                    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-                    private constructor(
-                        private val bbox: JsonField<BBox>,
-                        private val span: JsonField<List<JsonValue>>,
-                        private val words: JsonField<List<Word>>,
-                        private val additionalProperties: MutableMap<String, JsonValue>,
-                    ) {
-
-                        @JsonCreator
-                        private constructor(
-                            @JsonProperty("bbox")
-                            @ExcludeMissing
-                            bbox: JsonField<BBox> = JsonMissing.of(),
-                            @JsonProperty("span")
-                            @ExcludeMissing
-                            span: JsonField<List<JsonValue>> = JsonMissing.of(),
-                            @JsonProperty("words")
-                            @ExcludeMissing
-                            words: JsonField<List<Word>> = JsonMissing.of(),
-                        ) : this(bbox, span, words, mutableMapOf())
-
-                        /**
-                         * Line bounding box
-                         *
-                         * @throws LlamaCloudInvalidDataException if the JSON field has an
-                         *   unexpected type or is unexpectedly missing or null (e.g. if the server
-                         *   responded with an unexpected value).
-                         */
-                        fun bbox(): BBox = bbox.getRequired("bbox")
-
-                        /**
-                         * `[start, end)` UTF-8 byte span in the complete source property string
-                         *
-                         * @throws LlamaCloudInvalidDataException if the JSON field has an
-                         *   unexpected type or is unexpectedly missing or null (e.g. if the server
-                         *   responded with an unexpected value).
-                         */
-                        fun span(): List<JsonValue> = span.getRequired("span")
-
-                        /**
-                         * Per-word grounding within the line, when available
-                         *
-                         * @throws LlamaCloudInvalidDataException if the JSON field has an
-                         *   unexpected type (e.g. if the server responded with an unexpected
-                         *   value).
-                         */
-                        fun words(): Optional<List<Word>> = words.getOptional("words")
-
-                        /**
-                         * Returns the raw JSON value of [bbox].
-                         *
-                         * Unlike [bbox], this method doesn't throw if the JSON field has an
-                         * unexpected type.
-                         */
-                        @JsonProperty("bbox") @ExcludeMissing fun _bbox(): JsonField<BBox> = bbox
-
-                        /**
-                         * Returns the raw JSON value of [span].
-                         *
-                         * Unlike [span], this method doesn't throw if the JSON field has an
-                         * unexpected type.
-                         */
-                        @JsonProperty("span")
-                        @ExcludeMissing
-                        fun _span(): JsonField<List<JsonValue>> = span
-
-                        /**
-                         * Returns the raw JSON value of [words].
-                         *
-                         * Unlike [words], this method doesn't throw if the JSON field has an
-                         * unexpected type.
-                         */
-                        @JsonProperty("words")
-                        @ExcludeMissing
-                        fun _words(): JsonField<List<Word>> = words
-
-                        @JsonAnySetter
-                        private fun putAdditionalProperty(key: String, value: JsonValue) {
-                            additionalProperties.put(key, value)
-                        }
-
-                        @JsonAnyGetter
-                        @ExcludeMissing
-                        fun _additionalProperties(): Map<String, JsonValue> =
-                            Collections.unmodifiableMap(additionalProperties)
-
-                        fun toBuilder() = Builder().from(this)
-
-                        companion object {
-
-                            /**
-                             * Returns a mutable builder for constructing an instance of [Line].
-                             *
-                             * The following fields are required:
-                             * ```java
-                             * .bbox()
-                             * .span()
-                             * ```
-                             */
-                            @JvmStatic fun builder() = Builder()
-                        }
-
-                        /** A builder for [Line]. */
-                        class Builder internal constructor() {
-
-                            private var bbox: JsonField<BBox>? = null
-                            private var span: JsonField<MutableList<JsonValue>>? = null
-                            private var words: JsonField<MutableList<Word>>? = null
-                            private var additionalProperties: MutableMap<String, JsonValue> =
-                                mutableMapOf()
-
-                            @JvmSynthetic
-                            internal fun from(line: Line) = apply {
-                                bbox = line.bbox
-                                span = line.span.map { it.toMutableList() }
-                                words = line.words.map { it.toMutableList() }
-                                additionalProperties = line.additionalProperties.toMutableMap()
-                            }
-
-                            /** Line bounding box */
-                            fun bbox(bbox: BBox) = bbox(JsonField.of(bbox))
-
-                            /**
-                             * Sets [Builder.bbox] to an arbitrary JSON value.
-                             *
-                             * You should usually call [Builder.bbox] with a well-typed [BBox] value
-                             * instead. This method is primarily for setting the field to an
-                             * undocumented or not yet supported value.
-                             */
-                            fun bbox(bbox: JsonField<BBox>) = apply { this.bbox = bbox }
-
-                            /**
-                             * `[start, end)` UTF-8 byte span in the complete source property string
-                             */
-                            fun span(span: List<JsonValue>) = span(JsonField.of(span))
-
-                            /**
-                             * Sets [Builder.span] to an arbitrary JSON value.
-                             *
-                             * You should usually call [Builder.span] with a well-typed
-                             * `List<JsonValue>` value instead. This method is primarily for setting
-                             * the field to an undocumented or not yet supported value.
-                             */
-                            fun span(span: JsonField<List<JsonValue>>) = apply {
-                                this.span = span.map { it.toMutableList() }
-                            }
-
-                            /**
-                             * Adds a single [JsonValue] to [Builder.span].
-                             *
-                             * @throws IllegalStateException if the field was previously set to a
-                             *   non-list.
-                             */
-                            fun addSpan(span: JsonValue) = apply {
-                                this.span =
-                                    (this.span ?: JsonField.of(mutableListOf())).also {
-                                        checkKnown("span", it).add(span)
-                                    }
-                            }
-
-                            /** Per-word grounding within the line, when available */
-                            fun words(words: List<Word>?) = words(JsonField.ofNullable(words))
-
-                            /** Alias for calling [Builder.words] with `words.orElse(null)`. */
-                            fun words(words: Optional<List<Word>>) = words(words.getOrNull())
-
-                            /**
-                             * Sets [Builder.words] to an arbitrary JSON value.
-                             *
-                             * You should usually call [Builder.words] with a well-typed
-                             * `List<Word>` value instead. This method is primarily for setting the
-                             * field to an undocumented or not yet supported value.
-                             */
-                            fun words(words: JsonField<List<Word>>) = apply {
-                                this.words = words.map { it.toMutableList() }
-                            }
-
-                            /**
-                             * Adds a single [Word] to [words].
-                             *
-                             * @throws IllegalStateException if the field was previously set to a
-                             *   non-list.
-                             */
-                            fun addWord(word: Word) = apply {
-                                words =
-                                    (words ?: JsonField.of(mutableListOf())).also {
-                                        checkKnown("words", it).add(word)
-                                    }
-                            }
-
-                            fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
-                                apply {
-                                    this.additionalProperties.clear()
-                                    putAllAdditionalProperties(additionalProperties)
-                                }
-
-                            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                                additionalProperties.put(key, value)
-                            }
-
-                            fun putAllAdditionalProperties(
-                                additionalProperties: Map<String, JsonValue>
-                            ) = apply { this.additionalProperties.putAll(additionalProperties) }
-
-                            fun removeAdditionalProperty(key: String) = apply {
-                                additionalProperties.remove(key)
-                            }
-
-                            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                                keys.forEach(::removeAdditionalProperty)
-                            }
-
-                            /**
-                             * Returns an immutable instance of [Line].
-                             *
-                             * Further updates to this [Builder] will not mutate the returned
-                             * instance.
-                             *
-                             * The following fields are required:
-                             * ```java
-                             * .bbox()
-                             * .span()
-                             * ```
-                             *
-                             * @throws IllegalStateException if any required field is unset.
-                             */
-                            fun build(): Line =
-                                Line(
-                                    checkRequired("bbox", bbox),
-                                    checkRequired("span", span).map { it.toImmutable() },
-                                    (words ?: JsonMissing.of()).map { it.toImmutable() },
-                                    additionalProperties.toMutableMap(),
-                                )
-                        }
-
-                        private var validated: Boolean = false
-
-                        /**
-                         * Validates that the types of all values in this object match their
-                         * expected types recursively.
-                         *
-                         * This method is _not_ forwards compatible with new types from the API for
-                         * existing fields.
-                         *
-                         * @throws LlamaCloudInvalidDataException if any value type in this object
-                         *   doesn't match its expected type.
-                         */
-                        fun validate(): Line = apply {
-                            if (validated) {
-                                return@apply
-                            }
-
-                            bbox().validate()
-                            span()
-                            words().ifPresent { it.forEach { it.validate() } }
-                            validated = true
-                        }
-
-                        fun isValid(): Boolean =
-                            try {
-                                validate()
-                                true
-                            } catch (e: LlamaCloudInvalidDataException) {
-                                false
-                            }
-
-                        /**
-                         * Returns a score indicating how many valid values are contained in this
-                         * object recursively.
-                         *
-                         * Used for best match union deserialization.
-                         */
-                        @JvmSynthetic
-                        internal fun validity(): Int =
-                            (bbox.asKnown().getOrNull()?.validity() ?: 0) +
-                                (span.asKnown().getOrNull()?.size ?: 0) +
-                                (words.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
-
-                        /**
-                         * One grounded word: a `[start, end)` span in the source text and its bbox.
-                         */
-                        class Word
-                        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-                        private constructor(
-                            private val bbox: JsonField<BBox>,
-                            private val span: JsonField<List<JsonValue>>,
-                            private val additionalProperties: MutableMap<String, JsonValue>,
-                        ) {
-
-                            @JsonCreator
-                            private constructor(
-                                @JsonProperty("bbox")
-                                @ExcludeMissing
-                                bbox: JsonField<BBox> = JsonMissing.of(),
-                                @JsonProperty("span")
-                                @ExcludeMissing
-                                span: JsonField<List<JsonValue>> = JsonMissing.of(),
-                            ) : this(bbox, span, mutableMapOf())
-
-                            /**
-                             * Word bounding box
-                             *
-                             * @throws LlamaCloudInvalidDataException if the JSON field has an
-                             *   unexpected type or is unexpectedly missing or null (e.g. if the
-                             *   server responded with an unexpected value).
-                             */
-                            fun bbox(): BBox = bbox.getRequired("bbox")
-
-                            /**
-                             * `[start, end)` UTF-8 byte span in the complete source property string
-                             *
-                             * @throws LlamaCloudInvalidDataException if the JSON field has an
-                             *   unexpected type or is unexpectedly missing or null (e.g. if the
-                             *   server responded with an unexpected value).
-                             */
-                            fun span(): List<JsonValue> = span.getRequired("span")
-
-                            /**
-                             * Returns the raw JSON value of [bbox].
-                             *
-                             * Unlike [bbox], this method doesn't throw if the JSON field has an
-                             * unexpected type.
-                             */
-                            @JsonProperty("bbox")
-                            @ExcludeMissing
-                            fun _bbox(): JsonField<BBox> = bbox
-
-                            /**
-                             * Returns the raw JSON value of [span].
-                             *
-                             * Unlike [span], this method doesn't throw if the JSON field has an
-                             * unexpected type.
-                             */
-                            @JsonProperty("span")
-                            @ExcludeMissing
-                            fun _span(): JsonField<List<JsonValue>> = span
-
-                            @JsonAnySetter
-                            private fun putAdditionalProperty(key: String, value: JsonValue) {
-                                additionalProperties.put(key, value)
-                            }
-
-                            @JsonAnyGetter
-                            @ExcludeMissing
-                            fun _additionalProperties(): Map<String, JsonValue> =
-                                Collections.unmodifiableMap(additionalProperties)
-
-                            fun toBuilder() = Builder().from(this)
-
-                            companion object {
-
-                                /**
-                                 * Returns a mutable builder for constructing an instance of [Word].
-                                 *
-                                 * The following fields are required:
-                                 * ```java
-                                 * .bbox()
-                                 * .span()
-                                 * ```
-                                 */
-                                @JvmStatic fun builder() = Builder()
-                            }
-
-                            /** A builder for [Word]. */
-                            class Builder internal constructor() {
-
-                                private var bbox: JsonField<BBox>? = null
-                                private var span: JsonField<MutableList<JsonValue>>? = null
-                                private var additionalProperties: MutableMap<String, JsonValue> =
-                                    mutableMapOf()
-
-                                @JvmSynthetic
-                                internal fun from(word: Word) = apply {
-                                    bbox = word.bbox
-                                    span = word.span.map { it.toMutableList() }
-                                    additionalProperties = word.additionalProperties.toMutableMap()
-                                }
-
-                                /** Word bounding box */
-                                fun bbox(bbox: BBox) = bbox(JsonField.of(bbox))
-
-                                /**
-                                 * Sets [Builder.bbox] to an arbitrary JSON value.
-                                 *
-                                 * You should usually call [Builder.bbox] with a well-typed [BBox]
-                                 * value instead. This method is primarily for setting the field to
-                                 * an undocumented or not yet supported value.
-                                 */
-                                fun bbox(bbox: JsonField<BBox>) = apply { this.bbox = bbox }
-
-                                /**
-                                 * `[start, end)` UTF-8 byte span in the complete source property
-                                 * string
-                                 */
-                                fun span(span: List<JsonValue>) = span(JsonField.of(span))
-
-                                /**
-                                 * Sets [Builder.span] to an arbitrary JSON value.
-                                 *
-                                 * You should usually call [Builder.span] with a well-typed
-                                 * `List<JsonValue>` value instead. This method is primarily for
-                                 * setting the field to an undocumented or not yet supported value.
-                                 */
-                                fun span(span: JsonField<List<JsonValue>>) = apply {
-                                    this.span = span.map { it.toMutableList() }
-                                }
-
-                                /**
-                                 * Adds a single [JsonValue] to [Builder.span].
-                                 *
-                                 * @throws IllegalStateException if the field was previously set to
-                                 *   a non-list.
-                                 */
-                                fun addSpan(span: JsonValue) = apply {
-                                    this.span =
-                                        (this.span ?: JsonField.of(mutableListOf())).also {
-                                            checkKnown("span", it).add(span)
-                                        }
-                                }
-
-                                fun additionalProperties(
-                                    additionalProperties: Map<String, JsonValue>
-                                ) = apply {
-                                    this.additionalProperties.clear()
-                                    putAllAdditionalProperties(additionalProperties)
-                                }
-
-                                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                                    additionalProperties.put(key, value)
-                                }
-
-                                fun putAllAdditionalProperties(
-                                    additionalProperties: Map<String, JsonValue>
-                                ) = apply { this.additionalProperties.putAll(additionalProperties) }
-
-                                fun removeAdditionalProperty(key: String) = apply {
-                                    additionalProperties.remove(key)
-                                }
-
-                                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                                    keys.forEach(::removeAdditionalProperty)
-                                }
-
-                                /**
-                                 * Returns an immutable instance of [Word].
-                                 *
-                                 * Further updates to this [Builder] will not mutate the returned
-                                 * instance.
-                                 *
-                                 * The following fields are required:
-                                 * ```java
-                                 * .bbox()
-                                 * .span()
-                                 * ```
-                                 *
-                                 * @throws IllegalStateException if any required field is unset.
-                                 */
-                                fun build(): Word =
-                                    Word(
-                                        checkRequired("bbox", bbox),
-                                        checkRequired("span", span).map { it.toImmutable() },
-                                        additionalProperties.toMutableMap(),
-                                    )
-                            }
-
-                            private var validated: Boolean = false
-
-                            /**
-                             * Validates that the types of all values in this object match their
-                             * expected types recursively.
-                             *
-                             * This method is _not_ forwards compatible with new types from the API
-                             * for existing fields.
-                             *
-                             * @throws LlamaCloudInvalidDataException if any value type in this
-                             *   object doesn't match its expected type.
-                             */
-                            fun validate(): Word = apply {
-                                if (validated) {
-                                    return@apply
-                                }
-
-                                bbox().validate()
-                                span()
-                                validated = true
-                            }
-
-                            fun isValid(): Boolean =
-                                try {
-                                    validate()
-                                    true
-                                } catch (e: LlamaCloudInvalidDataException) {
-                                    false
-                                }
-
-                            /**
-                             * Returns a score indicating how many valid values are contained in
-                             * this object recursively.
-                             *
-                             * Used for best match union deserialization.
-                             */
-                            @JvmSynthetic
-                            internal fun validity(): Int =
-                                (bbox.asKnown().getOrNull()?.validity() ?: 0) +
-                                    (span.asKnown().getOrNull()?.size ?: 0)
-
-                            override fun equals(other: Any?): Boolean {
-                                if (this === other) {
-                                    return true
-                                }
-
-                                return other is Word &&
-                                    bbox == other.bbox &&
-                                    span == other.span &&
-                                    additionalProperties == other.additionalProperties
-                            }
-
-                            private val hashCode: Int by lazy {
-                                Objects.hash(bbox, span, additionalProperties)
-                            }
-
-                            override fun hashCode(): Int = hashCode
-
-                            override fun toString() =
-                                "Word{bbox=$bbox, span=$span, additionalProperties=$additionalProperties}"
-                        }
-
-                        override fun equals(other: Any?): Boolean {
-                            if (this === other) {
-                                return true
-                            }
-
-                            return other is Line &&
-                                bbox == other.bbox &&
-                                span == other.span &&
-                                words == other.words &&
-                                additionalProperties == other.additionalProperties
-                        }
-
-                        private val hashCode: Int by lazy {
-                            Objects.hash(bbox, span, words, additionalProperties)
-                        }
-
-                        override fun hashCode(): Int = hashCode
-
-                        override fun toString() =
-                            "Line{bbox=$bbox, span=$span, words=$words, additionalProperties=$additionalProperties}"
-                    }
-
-                    override fun equals(other: Any?): Boolean {
-                        if (this === other) {
-                            return true
-                        }
-
-                        return other is Id &&
-                            lines == other.lines &&
-                            additionalProperties == other.additionalProperties
-                    }
-
-                    private val hashCode: Int by lazy { Objects.hash(lines, additionalProperties) }
-
-                    override fun hashCode(): Int = hashCode
-
-                    override fun toString() =
-                        "Id{lines=$lines, additionalProperties=$additionalProperties}"
-                }
-
-                /**
-                 * Supported text with half-open UTF-8 byte spans into the complete property string.
-                 */
-                class Label
-                @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-                private constructor(
-                    private val lines: JsonField<List<Line>>,
-                    private val additionalProperties: MutableMap<String, JsonValue>,
-                ) {
-
-                    @JsonCreator
-                    private constructor(
-                        @JsonProperty("lines")
-                        @ExcludeMissing
-                        lines: JsonField<List<Line>> = JsonMissing.of()
-                    ) : this(lines, mutableMapOf())
-
-                    /**
-                     * Supported lines. Word requests include supported words; gaps are valid. Boxes
-                     * use final page coordinates and optional local rotation r.
-                     *
-                     * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected
-                     *   type or is unexpectedly missing or null (e.g. if the server responded with
-                     *   an unexpected value).
-                     */
-                    fun lines(): List<Line> = lines.getRequired("lines")
-
-                    /**
-                     * Returns the raw JSON value of [lines].
-                     *
-                     * Unlike [lines], this method doesn't throw if the JSON field has an unexpected
-                     * type.
-                     */
-                    @JsonProperty("lines")
-                    @ExcludeMissing
-                    fun _lines(): JsonField<List<Line>> = lines
-
-                    @JsonAnySetter
-                    private fun putAdditionalProperty(key: String, value: JsonValue) {
-                        additionalProperties.put(key, value)
-                    }
-
-                    @JsonAnyGetter
-                    @ExcludeMissing
-                    fun _additionalProperties(): Map<String, JsonValue> =
-                        Collections.unmodifiableMap(additionalProperties)
-
-                    fun toBuilder() = Builder().from(this)
-
-                    companion object {
-
-                        /**
-                         * Returns a mutable builder for constructing an instance of [Label].
-                         *
-                         * The following fields are required:
-                         * ```java
-                         * .lines()
-                         * ```
-                         */
-                        @JvmStatic fun builder() = Builder()
-                    }
-
-                    /** A builder for [Label]. */
-                    class Builder internal constructor() {
-
-                        private var lines: JsonField<MutableList<Line>>? = null
-                        private var additionalProperties: MutableMap<String, JsonValue> =
-                            mutableMapOf()
-
-                        @JvmSynthetic
-                        internal fun from(label: Label) = apply {
-                            lines = label.lines.map { it.toMutableList() }
-                            additionalProperties = label.additionalProperties.toMutableMap()
-                        }
-
-                        /**
-                         * Supported lines. Word requests include supported words; gaps are valid.
-                         * Boxes use final page coordinates and optional local rotation r.
-                         */
-                        fun lines(lines: List<Line>) = lines(JsonField.of(lines))
-
-                        /**
-                         * Sets [Builder.lines] to an arbitrary JSON value.
-                         *
-                         * You should usually call [Builder.lines] with a well-typed `List<Line>`
-                         * value instead. This method is primarily for setting the field to an
-                         * undocumented or not yet supported value.
-                         */
-                        fun lines(lines: JsonField<List<Line>>) = apply {
-                            this.lines = lines.map { it.toMutableList() }
-                        }
-
-                        /**
-                         * Adds a single [Line] to [lines].
-                         *
-                         * @throws IllegalStateException if the field was previously set to a
-                         *   non-list.
-                         */
-                        fun addLine(line: Line) = apply {
-                            lines =
-                                (lines ?: JsonField.of(mutableListOf())).also {
-                                    checkKnown("lines", it).add(line)
-                                }
-                        }
-
-                        fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
-                            apply {
-                                this.additionalProperties.clear()
-                                putAllAdditionalProperties(additionalProperties)
-                            }
-
-                        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                            additionalProperties.put(key, value)
-                        }
-
-                        fun putAllAdditionalProperties(
-                            additionalProperties: Map<String, JsonValue>
-                        ) = apply { this.additionalProperties.putAll(additionalProperties) }
-
-                        fun removeAdditionalProperty(key: String) = apply {
-                            additionalProperties.remove(key)
-                        }
-
-                        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                            keys.forEach(::removeAdditionalProperty)
-                        }
-
-                        /**
-                         * Returns an immutable instance of [Label].
-                         *
-                         * Further updates to this [Builder] will not mutate the returned instance.
-                         *
-                         * The following fields are required:
-                         * ```java
-                         * .lines()
-                         * ```
-                         *
-                         * @throws IllegalStateException if any required field is unset.
-                         */
-                        fun build(): Label =
-                            Label(
-                                checkRequired("lines", lines).map { it.toImmutable() },
-                                additionalProperties.toMutableMap(),
-                            )
-                    }
-
-                    private var validated: Boolean = false
-
-                    /**
-                     * Validates that the types of all values in this object match their expected
-                     * types recursively.
-                     *
-                     * This method is _not_ forwards compatible with new types from the API for
-                     * existing fields.
-                     *
-                     * @throws LlamaCloudInvalidDataException if any value type in this object
-                     *   doesn't match its expected type.
-                     */
-                    fun validate(): Label = apply {
-                        if (validated) {
-                            return@apply
-                        }
-
-                        lines().forEach { it.validate() }
-                        validated = true
-                    }
-
-                    fun isValid(): Boolean =
-                        try {
-                            validate()
-                            true
-                        } catch (e: LlamaCloudInvalidDataException) {
-                            false
-                        }
-
-                    /**
-                     * Returns a score indicating how many valid values are contained in this object
-                     * recursively.
-                     *
-                     * Used for best match union deserialization.
-                     */
-                    @JvmSynthetic
-                    internal fun validity(): Int =
-                        (lines.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
-
-                    /** One grounded line of text with an optional per-word breakdown. */
-                    class Line
-                    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-                    private constructor(
-                        private val bbox: JsonField<BBox>,
-                        private val span: JsonField<List<JsonValue>>,
-                        private val words: JsonField<List<Word>>,
-                        private val additionalProperties: MutableMap<String, JsonValue>,
-                    ) {
-
-                        @JsonCreator
-                        private constructor(
-                            @JsonProperty("bbox")
-                            @ExcludeMissing
-                            bbox: JsonField<BBox> = JsonMissing.of(),
-                            @JsonProperty("span")
-                            @ExcludeMissing
-                            span: JsonField<List<JsonValue>> = JsonMissing.of(),
-                            @JsonProperty("words")
-                            @ExcludeMissing
-                            words: JsonField<List<Word>> = JsonMissing.of(),
-                        ) : this(bbox, span, words, mutableMapOf())
-
-                        /**
-                         * Line bounding box
-                         *
-                         * @throws LlamaCloudInvalidDataException if the JSON field has an
-                         *   unexpected type or is unexpectedly missing or null (e.g. if the server
-                         *   responded with an unexpected value).
-                         */
-                        fun bbox(): BBox = bbox.getRequired("bbox")
-
-                        /**
-                         * `[start, end)` UTF-8 byte span in the complete source property string
-                         *
-                         * @throws LlamaCloudInvalidDataException if the JSON field has an
-                         *   unexpected type or is unexpectedly missing or null (e.g. if the server
-                         *   responded with an unexpected value).
-                         */
-                        fun span(): List<JsonValue> = span.getRequired("span")
-
-                        /**
-                         * Per-word grounding within the line, when available
-                         *
-                         * @throws LlamaCloudInvalidDataException if the JSON field has an
-                         *   unexpected type (e.g. if the server responded with an unexpected
-                         *   value).
-                         */
-                        fun words(): Optional<List<Word>> = words.getOptional("words")
-
-                        /**
-                         * Returns the raw JSON value of [bbox].
-                         *
-                         * Unlike [bbox], this method doesn't throw if the JSON field has an
-                         * unexpected type.
-                         */
-                        @JsonProperty("bbox") @ExcludeMissing fun _bbox(): JsonField<BBox> = bbox
-
-                        /**
-                         * Returns the raw JSON value of [span].
-                         *
-                         * Unlike [span], this method doesn't throw if the JSON field has an
-                         * unexpected type.
-                         */
-                        @JsonProperty("span")
-                        @ExcludeMissing
-                        fun _span(): JsonField<List<JsonValue>> = span
-
-                        /**
-                         * Returns the raw JSON value of [words].
-                         *
-                         * Unlike [words], this method doesn't throw if the JSON field has an
-                         * unexpected type.
-                         */
-                        @JsonProperty("words")
-                        @ExcludeMissing
-                        fun _words(): JsonField<List<Word>> = words
-
-                        @JsonAnySetter
-                        private fun putAdditionalProperty(key: String, value: JsonValue) {
-                            additionalProperties.put(key, value)
-                        }
-
-                        @JsonAnyGetter
-                        @ExcludeMissing
-                        fun _additionalProperties(): Map<String, JsonValue> =
-                            Collections.unmodifiableMap(additionalProperties)
-
-                        fun toBuilder() = Builder().from(this)
-
-                        companion object {
-
-                            /**
-                             * Returns a mutable builder for constructing an instance of [Line].
-                             *
-                             * The following fields are required:
-                             * ```java
-                             * .bbox()
-                             * .span()
-                             * ```
-                             */
-                            @JvmStatic fun builder() = Builder()
-                        }
-
-                        /** A builder for [Line]. */
-                        class Builder internal constructor() {
-
-                            private var bbox: JsonField<BBox>? = null
-                            private var span: JsonField<MutableList<JsonValue>>? = null
-                            private var words: JsonField<MutableList<Word>>? = null
-                            private var additionalProperties: MutableMap<String, JsonValue> =
-                                mutableMapOf()
-
-                            @JvmSynthetic
-                            internal fun from(line: Line) = apply {
-                                bbox = line.bbox
-                                span = line.span.map { it.toMutableList() }
-                                words = line.words.map { it.toMutableList() }
-                                additionalProperties = line.additionalProperties.toMutableMap()
-                            }
-
-                            /** Line bounding box */
-                            fun bbox(bbox: BBox) = bbox(JsonField.of(bbox))
-
-                            /**
-                             * Sets [Builder.bbox] to an arbitrary JSON value.
-                             *
-                             * You should usually call [Builder.bbox] with a well-typed [BBox] value
-                             * instead. This method is primarily for setting the field to an
-                             * undocumented or not yet supported value.
-                             */
-                            fun bbox(bbox: JsonField<BBox>) = apply { this.bbox = bbox }
-
-                            /**
-                             * `[start, end)` UTF-8 byte span in the complete source property string
-                             */
-                            fun span(span: List<JsonValue>) = span(JsonField.of(span))
-
-                            /**
-                             * Sets [Builder.span] to an arbitrary JSON value.
-                             *
-                             * You should usually call [Builder.span] with a well-typed
-                             * `List<JsonValue>` value instead. This method is primarily for setting
-                             * the field to an undocumented or not yet supported value.
-                             */
-                            fun span(span: JsonField<List<JsonValue>>) = apply {
-                                this.span = span.map { it.toMutableList() }
-                            }
-
-                            /**
-                             * Adds a single [JsonValue] to [Builder.span].
-                             *
-                             * @throws IllegalStateException if the field was previously set to a
-                             *   non-list.
-                             */
-                            fun addSpan(span: JsonValue) = apply {
-                                this.span =
-                                    (this.span ?: JsonField.of(mutableListOf())).also {
-                                        checkKnown("span", it).add(span)
-                                    }
-                            }
-
-                            /** Per-word grounding within the line, when available */
-                            fun words(words: List<Word>?) = words(JsonField.ofNullable(words))
-
-                            /** Alias for calling [Builder.words] with `words.orElse(null)`. */
-                            fun words(words: Optional<List<Word>>) = words(words.getOrNull())
-
-                            /**
-                             * Sets [Builder.words] to an arbitrary JSON value.
-                             *
-                             * You should usually call [Builder.words] with a well-typed
-                             * `List<Word>` value instead. This method is primarily for setting the
-                             * field to an undocumented or not yet supported value.
-                             */
-                            fun words(words: JsonField<List<Word>>) = apply {
-                                this.words = words.map { it.toMutableList() }
-                            }
-
-                            /**
-                             * Adds a single [Word] to [words].
-                             *
-                             * @throws IllegalStateException if the field was previously set to a
-                             *   non-list.
-                             */
-                            fun addWord(word: Word) = apply {
-                                words =
-                                    (words ?: JsonField.of(mutableListOf())).also {
-                                        checkKnown("words", it).add(word)
-                                    }
-                            }
-
-                            fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
-                                apply {
-                                    this.additionalProperties.clear()
-                                    putAllAdditionalProperties(additionalProperties)
-                                }
-
-                            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                                additionalProperties.put(key, value)
-                            }
-
-                            fun putAllAdditionalProperties(
-                                additionalProperties: Map<String, JsonValue>
-                            ) = apply { this.additionalProperties.putAll(additionalProperties) }
-
-                            fun removeAdditionalProperty(key: String) = apply {
-                                additionalProperties.remove(key)
-                            }
-
-                            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                                keys.forEach(::removeAdditionalProperty)
-                            }
-
-                            /**
-                             * Returns an immutable instance of [Line].
-                             *
-                             * Further updates to this [Builder] will not mutate the returned
-                             * instance.
-                             *
-                             * The following fields are required:
-                             * ```java
-                             * .bbox()
-                             * .span()
-                             * ```
-                             *
-                             * @throws IllegalStateException if any required field is unset.
-                             */
-                            fun build(): Line =
-                                Line(
-                                    checkRequired("bbox", bbox),
-                                    checkRequired("span", span).map { it.toImmutable() },
-                                    (words ?: JsonMissing.of()).map { it.toImmutable() },
-                                    additionalProperties.toMutableMap(),
-                                )
-                        }
-
-                        private var validated: Boolean = false
-
-                        /**
-                         * Validates that the types of all values in this object match their
-                         * expected types recursively.
-                         *
-                         * This method is _not_ forwards compatible with new types from the API for
-                         * existing fields.
-                         *
-                         * @throws LlamaCloudInvalidDataException if any value type in this object
-                         *   doesn't match its expected type.
-                         */
-                        fun validate(): Line = apply {
-                            if (validated) {
-                                return@apply
-                            }
-
-                            bbox().validate()
-                            span()
-                            words().ifPresent { it.forEach { it.validate() } }
-                            validated = true
-                        }
-
-                        fun isValid(): Boolean =
-                            try {
-                                validate()
-                                true
-                            } catch (e: LlamaCloudInvalidDataException) {
-                                false
-                            }
-
-                        /**
-                         * Returns a score indicating how many valid values are contained in this
-                         * object recursively.
-                         *
-                         * Used for best match union deserialization.
-                         */
-                        @JvmSynthetic
-                        internal fun validity(): Int =
-                            (bbox.asKnown().getOrNull()?.validity() ?: 0) +
-                                (span.asKnown().getOrNull()?.size ?: 0) +
-                                (words.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
-
-                        /**
-                         * One grounded word: a `[start, end)` span in the source text and its bbox.
-                         */
-                        class Word
-                        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-                        private constructor(
-                            private val bbox: JsonField<BBox>,
-                            private val span: JsonField<List<JsonValue>>,
-                            private val additionalProperties: MutableMap<String, JsonValue>,
-                        ) {
-
-                            @JsonCreator
-                            private constructor(
-                                @JsonProperty("bbox")
-                                @ExcludeMissing
-                                bbox: JsonField<BBox> = JsonMissing.of(),
-                                @JsonProperty("span")
-                                @ExcludeMissing
-                                span: JsonField<List<JsonValue>> = JsonMissing.of(),
-                            ) : this(bbox, span, mutableMapOf())
-
-                            /**
-                             * Word bounding box
-                             *
-                             * @throws LlamaCloudInvalidDataException if the JSON field has an
-                             *   unexpected type or is unexpectedly missing or null (e.g. if the
-                             *   server responded with an unexpected value).
-                             */
-                            fun bbox(): BBox = bbox.getRequired("bbox")
-
-                            /**
-                             * `[start, end)` UTF-8 byte span in the complete source property string
-                             *
-                             * @throws LlamaCloudInvalidDataException if the JSON field has an
-                             *   unexpected type or is unexpectedly missing or null (e.g. if the
-                             *   server responded with an unexpected value).
-                             */
-                            fun span(): List<JsonValue> = span.getRequired("span")
-
-                            /**
-                             * Returns the raw JSON value of [bbox].
-                             *
-                             * Unlike [bbox], this method doesn't throw if the JSON field has an
-                             * unexpected type.
-                             */
-                            @JsonProperty("bbox")
-                            @ExcludeMissing
-                            fun _bbox(): JsonField<BBox> = bbox
-
-                            /**
-                             * Returns the raw JSON value of [span].
-                             *
-                             * Unlike [span], this method doesn't throw if the JSON field has an
-                             * unexpected type.
-                             */
-                            @JsonProperty("span")
-                            @ExcludeMissing
-                            fun _span(): JsonField<List<JsonValue>> = span
-
-                            @JsonAnySetter
-                            private fun putAdditionalProperty(key: String, value: JsonValue) {
-                                additionalProperties.put(key, value)
-                            }
-
-                            @JsonAnyGetter
-                            @ExcludeMissing
-                            fun _additionalProperties(): Map<String, JsonValue> =
-                                Collections.unmodifiableMap(additionalProperties)
-
-                            fun toBuilder() = Builder().from(this)
-
-                            companion object {
-
-                                /**
-                                 * Returns a mutable builder for constructing an instance of [Word].
-                                 *
-                                 * The following fields are required:
-                                 * ```java
-                                 * .bbox()
-                                 * .span()
-                                 * ```
-                                 */
-                                @JvmStatic fun builder() = Builder()
-                            }
-
-                            /** A builder for [Word]. */
-                            class Builder internal constructor() {
-
-                                private var bbox: JsonField<BBox>? = null
-                                private var span: JsonField<MutableList<JsonValue>>? = null
-                                private var additionalProperties: MutableMap<String, JsonValue> =
-                                    mutableMapOf()
-
-                                @JvmSynthetic
-                                internal fun from(word: Word) = apply {
-                                    bbox = word.bbox
-                                    span = word.span.map { it.toMutableList() }
-                                    additionalProperties = word.additionalProperties.toMutableMap()
-                                }
-
-                                /** Word bounding box */
-                                fun bbox(bbox: BBox) = bbox(JsonField.of(bbox))
-
-                                /**
-                                 * Sets [Builder.bbox] to an arbitrary JSON value.
-                                 *
-                                 * You should usually call [Builder.bbox] with a well-typed [BBox]
-                                 * value instead. This method is primarily for setting the field to
-                                 * an undocumented or not yet supported value.
-                                 */
-                                fun bbox(bbox: JsonField<BBox>) = apply { this.bbox = bbox }
-
-                                /**
-                                 * `[start, end)` UTF-8 byte span in the complete source property
-                                 * string
-                                 */
-                                fun span(span: List<JsonValue>) = span(JsonField.of(span))
-
-                                /**
-                                 * Sets [Builder.span] to an arbitrary JSON value.
-                                 *
-                                 * You should usually call [Builder.span] with a well-typed
-                                 * `List<JsonValue>` value instead. This method is primarily for
-                                 * setting the field to an undocumented or not yet supported value.
-                                 */
-                                fun span(span: JsonField<List<JsonValue>>) = apply {
-                                    this.span = span.map { it.toMutableList() }
-                                }
-
-                                /**
-                                 * Adds a single [JsonValue] to [Builder.span].
-                                 *
-                                 * @throws IllegalStateException if the field was previously set to
-                                 *   a non-list.
-                                 */
-                                fun addSpan(span: JsonValue) = apply {
-                                    this.span =
-                                        (this.span ?: JsonField.of(mutableListOf())).also {
-                                            checkKnown("span", it).add(span)
-                                        }
-                                }
-
-                                fun additionalProperties(
-                                    additionalProperties: Map<String, JsonValue>
-                                ) = apply {
-                                    this.additionalProperties.clear()
-                                    putAllAdditionalProperties(additionalProperties)
-                                }
-
-                                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                                    additionalProperties.put(key, value)
-                                }
-
-                                fun putAllAdditionalProperties(
-                                    additionalProperties: Map<String, JsonValue>
-                                ) = apply { this.additionalProperties.putAll(additionalProperties) }
-
-                                fun removeAdditionalProperty(key: String) = apply {
-                                    additionalProperties.remove(key)
-                                }
-
-                                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                                    keys.forEach(::removeAdditionalProperty)
-                                }
-
-                                /**
-                                 * Returns an immutable instance of [Word].
-                                 *
-                                 * Further updates to this [Builder] will not mutate the returned
-                                 * instance.
-                                 *
-                                 * The following fields are required:
-                                 * ```java
-                                 * .bbox()
-                                 * .span()
-                                 * ```
-                                 *
-                                 * @throws IllegalStateException if any required field is unset.
-                                 */
-                                fun build(): Word =
-                                    Word(
-                                        checkRequired("bbox", bbox),
-                                        checkRequired("span", span).map { it.toImmutable() },
-                                        additionalProperties.toMutableMap(),
-                                    )
-                            }
-
-                            private var validated: Boolean = false
-
-                            /**
-                             * Validates that the types of all values in this object match their
-                             * expected types recursively.
-                             *
-                             * This method is _not_ forwards compatible with new types from the API
-                             * for existing fields.
-                             *
-                             * @throws LlamaCloudInvalidDataException if any value type in this
-                             *   object doesn't match its expected type.
-                             */
-                            fun validate(): Word = apply {
-                                if (validated) {
-                                    return@apply
-                                }
-
-                                bbox().validate()
-                                span()
-                                validated = true
-                            }
-
-                            fun isValid(): Boolean =
-                                try {
-                                    validate()
-                                    true
-                                } catch (e: LlamaCloudInvalidDataException) {
-                                    false
-                                }
-
-                            /**
-                             * Returns a score indicating how many valid values are contained in
-                             * this object recursively.
-                             *
-                             * Used for best match union deserialization.
-                             */
-                            @JvmSynthetic
-                            internal fun validity(): Int =
-                                (bbox.asKnown().getOrNull()?.validity() ?: 0) +
-                                    (span.asKnown().getOrNull()?.size ?: 0)
-
-                            override fun equals(other: Any?): Boolean {
-                                if (this === other) {
-                                    return true
-                                }
-
-                                return other is Word &&
-                                    bbox == other.bbox &&
-                                    span == other.span &&
-                                    additionalProperties == other.additionalProperties
-                            }
-
-                            private val hashCode: Int by lazy {
-                                Objects.hash(bbox, span, additionalProperties)
-                            }
-
-                            override fun hashCode(): Int = hashCode
-
-                            override fun toString() =
-                                "Word{bbox=$bbox, span=$span, additionalProperties=$additionalProperties}"
-                        }
-
-                        override fun equals(other: Any?): Boolean {
-                            if (this === other) {
-                                return true
-                            }
-
-                            return other is Line &&
-                                bbox == other.bbox &&
-                                span == other.span &&
-                                words == other.words &&
-                                additionalProperties == other.additionalProperties
-                        }
-
-                        private val hashCode: Int by lazy {
-                            Objects.hash(bbox, span, words, additionalProperties)
-                        }
-
-                        override fun hashCode(): Int = hashCode
-
-                        override fun toString() =
-                            "Line{bbox=$bbox, span=$span, words=$words, additionalProperties=$additionalProperties}"
-                    }
-
-                    override fun equals(other: Any?): Boolean {
-                        if (this === other) {
-                            return true
-                        }
-
-                        return other is Label &&
-                            lines == other.lines &&
-                            additionalProperties == other.additionalProperties
-                    }
-
-                    private val hashCode: Int by lazy { Objects.hash(lines, additionalProperties) }
-
-                    override fun hashCode(): Int = hashCode
-
-                    override fun toString() =
-                        "Label{lines=$lines, additionalProperties=$additionalProperties}"
-                }
-
-                /**
-                 * Supported text with half-open UTF-8 byte spans into the complete property string.
-                 */
-                class Value
-                @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-                private constructor(
-                    private val lines: JsonField<List<Line>>,
-                    private val additionalProperties: MutableMap<String, JsonValue>,
-                ) {
-
-                    @JsonCreator
-                    private constructor(
-                        @JsonProperty("lines")
-                        @ExcludeMissing
-                        lines: JsonField<List<Line>> = JsonMissing.of()
-                    ) : this(lines, mutableMapOf())
-
-                    /**
-                     * Supported lines. Word requests include supported words; gaps are valid. Boxes
-                     * use final page coordinates and optional local rotation r.
-                     *
-                     * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected
-                     *   type or is unexpectedly missing or null (e.g. if the server responded with
-                     *   an unexpected value).
-                     */
-                    fun lines(): List<Line> = lines.getRequired("lines")
-
-                    /**
-                     * Returns the raw JSON value of [lines].
-                     *
-                     * Unlike [lines], this method doesn't throw if the JSON field has an unexpected
-                     * type.
-                     */
-                    @JsonProperty("lines")
-                    @ExcludeMissing
-                    fun _lines(): JsonField<List<Line>> = lines
-
-                    @JsonAnySetter
-                    private fun putAdditionalProperty(key: String, value: JsonValue) {
-                        additionalProperties.put(key, value)
-                    }
-
-                    @JsonAnyGetter
-                    @ExcludeMissing
-                    fun _additionalProperties(): Map<String, JsonValue> =
-                        Collections.unmodifiableMap(additionalProperties)
-
-                    fun toBuilder() = Builder().from(this)
-
-                    companion object {
-
-                        /**
-                         * Returns a mutable builder for constructing an instance of [Value].
-                         *
-                         * The following fields are required:
-                         * ```java
-                         * .lines()
-                         * ```
-                         */
-                        @JvmStatic fun builder() = Builder()
-                    }
-
-                    /** A builder for [Value]. */
-                    class Builder internal constructor() {
-
-                        private var lines: JsonField<MutableList<Line>>? = null
-                        private var additionalProperties: MutableMap<String, JsonValue> =
-                            mutableMapOf()
-
-                        @JvmSynthetic
-                        internal fun from(value: Value) = apply {
-                            lines = value.lines.map { it.toMutableList() }
-                            additionalProperties = value.additionalProperties.toMutableMap()
-                        }
-
-                        /**
-                         * Supported lines. Word requests include supported words; gaps are valid.
-                         * Boxes use final page coordinates and optional local rotation r.
-                         */
-                        fun lines(lines: List<Line>) = lines(JsonField.of(lines))
-
-                        /**
-                         * Sets [Builder.lines] to an arbitrary JSON value.
-                         *
-                         * You should usually call [Builder.lines] with a well-typed `List<Line>`
-                         * value instead. This method is primarily for setting the field to an
-                         * undocumented or not yet supported value.
-                         */
-                        fun lines(lines: JsonField<List<Line>>) = apply {
-                            this.lines = lines.map { it.toMutableList() }
-                        }
-
-                        /**
-                         * Adds a single [Line] to [lines].
-                         *
-                         * @throws IllegalStateException if the field was previously set to a
-                         *   non-list.
-                         */
-                        fun addLine(line: Line) = apply {
-                            lines =
-                                (lines ?: JsonField.of(mutableListOf())).also {
-                                    checkKnown("lines", it).add(line)
-                                }
-                        }
-
-                        fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
-                            apply {
-                                this.additionalProperties.clear()
-                                putAllAdditionalProperties(additionalProperties)
-                            }
-
-                        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                            additionalProperties.put(key, value)
-                        }
-
-                        fun putAllAdditionalProperties(
-                            additionalProperties: Map<String, JsonValue>
-                        ) = apply { this.additionalProperties.putAll(additionalProperties) }
-
-                        fun removeAdditionalProperty(key: String) = apply {
-                            additionalProperties.remove(key)
-                        }
-
-                        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                            keys.forEach(::removeAdditionalProperty)
-                        }
-
-                        /**
-                         * Returns an immutable instance of [Value].
-                         *
-                         * Further updates to this [Builder] will not mutate the returned instance.
-                         *
-                         * The following fields are required:
-                         * ```java
-                         * .lines()
-                         * ```
-                         *
-                         * @throws IllegalStateException if any required field is unset.
-                         */
-                        fun build(): Value =
-                            Value(
-                                checkRequired("lines", lines).map { it.toImmutable() },
-                                additionalProperties.toMutableMap(),
-                            )
-                    }
-
-                    private var validated: Boolean = false
-
-                    /**
-                     * Validates that the types of all values in this object match their expected
-                     * types recursively.
-                     *
-                     * This method is _not_ forwards compatible with new types from the API for
-                     * existing fields.
-                     *
-                     * @throws LlamaCloudInvalidDataException if any value type in this object
-                     *   doesn't match its expected type.
-                     */
-                    fun validate(): Value = apply {
-                        if (validated) {
-                            return@apply
-                        }
-
-                        lines().forEach { it.validate() }
-                        validated = true
-                    }
-
-                    fun isValid(): Boolean =
-                        try {
-                            validate()
-                            true
-                        } catch (e: LlamaCloudInvalidDataException) {
-                            false
-                        }
-
-                    /**
-                     * Returns a score indicating how many valid values are contained in this object
-                     * recursively.
-                     *
-                     * Used for best match union deserialization.
-                     */
-                    @JvmSynthetic
-                    internal fun validity(): Int =
-                        (lines.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
-
-                    /** One grounded line of text with an optional per-word breakdown. */
-                    class Line
-                    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-                    private constructor(
-                        private val bbox: JsonField<BBox>,
-                        private val span: JsonField<List<JsonValue>>,
-                        private val words: JsonField<List<Word>>,
-                        private val additionalProperties: MutableMap<String, JsonValue>,
-                    ) {
-
-                        @JsonCreator
-                        private constructor(
-                            @JsonProperty("bbox")
-                            @ExcludeMissing
-                            bbox: JsonField<BBox> = JsonMissing.of(),
-                            @JsonProperty("span")
-                            @ExcludeMissing
-                            span: JsonField<List<JsonValue>> = JsonMissing.of(),
-                            @JsonProperty("words")
-                            @ExcludeMissing
-                            words: JsonField<List<Word>> = JsonMissing.of(),
-                        ) : this(bbox, span, words, mutableMapOf())
-
-                        /**
-                         * Line bounding box
-                         *
-                         * @throws LlamaCloudInvalidDataException if the JSON field has an
-                         *   unexpected type or is unexpectedly missing or null (e.g. if the server
-                         *   responded with an unexpected value).
-                         */
-                        fun bbox(): BBox = bbox.getRequired("bbox")
-
-                        /**
-                         * `[start, end)` UTF-8 byte span in the complete source property string
-                         *
-                         * @throws LlamaCloudInvalidDataException if the JSON field has an
-                         *   unexpected type or is unexpectedly missing or null (e.g. if the server
-                         *   responded with an unexpected value).
-                         */
-                        fun span(): List<JsonValue> = span.getRequired("span")
-
-                        /**
-                         * Per-word grounding within the line, when available
-                         *
-                         * @throws LlamaCloudInvalidDataException if the JSON field has an
-                         *   unexpected type (e.g. if the server responded with an unexpected
-                         *   value).
-                         */
-                        fun words(): Optional<List<Word>> = words.getOptional("words")
-
-                        /**
-                         * Returns the raw JSON value of [bbox].
-                         *
-                         * Unlike [bbox], this method doesn't throw if the JSON field has an
-                         * unexpected type.
-                         */
-                        @JsonProperty("bbox") @ExcludeMissing fun _bbox(): JsonField<BBox> = bbox
-
-                        /**
-                         * Returns the raw JSON value of [span].
-                         *
-                         * Unlike [span], this method doesn't throw if the JSON field has an
-                         * unexpected type.
-                         */
-                        @JsonProperty("span")
-                        @ExcludeMissing
-                        fun _span(): JsonField<List<JsonValue>> = span
-
-                        /**
-                         * Returns the raw JSON value of [words].
-                         *
-                         * Unlike [words], this method doesn't throw if the JSON field has an
-                         * unexpected type.
-                         */
-                        @JsonProperty("words")
-                        @ExcludeMissing
-                        fun _words(): JsonField<List<Word>> = words
-
-                        @JsonAnySetter
-                        private fun putAdditionalProperty(key: String, value: JsonValue) {
-                            additionalProperties.put(key, value)
-                        }
-
-                        @JsonAnyGetter
-                        @ExcludeMissing
-                        fun _additionalProperties(): Map<String, JsonValue> =
-                            Collections.unmodifiableMap(additionalProperties)
-
-                        fun toBuilder() = Builder().from(this)
-
-                        companion object {
-
-                            /**
-                             * Returns a mutable builder for constructing an instance of [Line].
-                             *
-                             * The following fields are required:
-                             * ```java
-                             * .bbox()
-                             * .span()
-                             * ```
-                             */
-                            @JvmStatic fun builder() = Builder()
-                        }
-
-                        /** A builder for [Line]. */
-                        class Builder internal constructor() {
-
-                            private var bbox: JsonField<BBox>? = null
-                            private var span: JsonField<MutableList<JsonValue>>? = null
-                            private var words: JsonField<MutableList<Word>>? = null
-                            private var additionalProperties: MutableMap<String, JsonValue> =
-                                mutableMapOf()
-
-                            @JvmSynthetic
-                            internal fun from(line: Line) = apply {
-                                bbox = line.bbox
-                                span = line.span.map { it.toMutableList() }
-                                words = line.words.map { it.toMutableList() }
-                                additionalProperties = line.additionalProperties.toMutableMap()
-                            }
-
-                            /** Line bounding box */
-                            fun bbox(bbox: BBox) = bbox(JsonField.of(bbox))
-
-                            /**
-                             * Sets [Builder.bbox] to an arbitrary JSON value.
-                             *
-                             * You should usually call [Builder.bbox] with a well-typed [BBox] value
-                             * instead. This method is primarily for setting the field to an
-                             * undocumented or not yet supported value.
-                             */
-                            fun bbox(bbox: JsonField<BBox>) = apply { this.bbox = bbox }
-
-                            /**
-                             * `[start, end)` UTF-8 byte span in the complete source property string
-                             */
-                            fun span(span: List<JsonValue>) = span(JsonField.of(span))
-
-                            /**
-                             * Sets [Builder.span] to an arbitrary JSON value.
-                             *
-                             * You should usually call [Builder.span] with a well-typed
-                             * `List<JsonValue>` value instead. This method is primarily for setting
-                             * the field to an undocumented or not yet supported value.
-                             */
-                            fun span(span: JsonField<List<JsonValue>>) = apply {
-                                this.span = span.map { it.toMutableList() }
-                            }
-
-                            /**
-                             * Adds a single [JsonValue] to [Builder.span].
-                             *
-                             * @throws IllegalStateException if the field was previously set to a
-                             *   non-list.
-                             */
-                            fun addSpan(span: JsonValue) = apply {
-                                this.span =
-                                    (this.span ?: JsonField.of(mutableListOf())).also {
-                                        checkKnown("span", it).add(span)
-                                    }
-                            }
-
-                            /** Per-word grounding within the line, when available */
-                            fun words(words: List<Word>?) = words(JsonField.ofNullable(words))
-
-                            /** Alias for calling [Builder.words] with `words.orElse(null)`. */
-                            fun words(words: Optional<List<Word>>) = words(words.getOrNull())
-
-                            /**
-                             * Sets [Builder.words] to an arbitrary JSON value.
-                             *
-                             * You should usually call [Builder.words] with a well-typed
-                             * `List<Word>` value instead. This method is primarily for setting the
-                             * field to an undocumented or not yet supported value.
-                             */
-                            fun words(words: JsonField<List<Word>>) = apply {
-                                this.words = words.map { it.toMutableList() }
-                            }
-
-                            /**
-                             * Adds a single [Word] to [words].
-                             *
-                             * @throws IllegalStateException if the field was previously set to a
-                             *   non-list.
-                             */
-                            fun addWord(word: Word) = apply {
-                                words =
-                                    (words ?: JsonField.of(mutableListOf())).also {
-                                        checkKnown("words", it).add(word)
-                                    }
-                            }
-
-                            fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
-                                apply {
-                                    this.additionalProperties.clear()
-                                    putAllAdditionalProperties(additionalProperties)
-                                }
-
-                            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                                additionalProperties.put(key, value)
-                            }
-
-                            fun putAllAdditionalProperties(
-                                additionalProperties: Map<String, JsonValue>
-                            ) = apply { this.additionalProperties.putAll(additionalProperties) }
-
-                            fun removeAdditionalProperty(key: String) = apply {
-                                additionalProperties.remove(key)
-                            }
-
-                            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                                keys.forEach(::removeAdditionalProperty)
-                            }
-
-                            /**
-                             * Returns an immutable instance of [Line].
-                             *
-                             * Further updates to this [Builder] will not mutate the returned
-                             * instance.
-                             *
-                             * The following fields are required:
-                             * ```java
-                             * .bbox()
-                             * .span()
-                             * ```
-                             *
-                             * @throws IllegalStateException if any required field is unset.
-                             */
-                            fun build(): Line =
-                                Line(
-                                    checkRequired("bbox", bbox),
-                                    checkRequired("span", span).map { it.toImmutable() },
-                                    (words ?: JsonMissing.of()).map { it.toImmutable() },
-                                    additionalProperties.toMutableMap(),
-                                )
-                        }
-
-                        private var validated: Boolean = false
-
-                        /**
-                         * Validates that the types of all values in this object match their
-                         * expected types recursively.
-                         *
-                         * This method is _not_ forwards compatible with new types from the API for
-                         * existing fields.
-                         *
-                         * @throws LlamaCloudInvalidDataException if any value type in this object
-                         *   doesn't match its expected type.
-                         */
-                        fun validate(): Line = apply {
-                            if (validated) {
-                                return@apply
-                            }
-
-                            bbox().validate()
-                            span()
-                            words().ifPresent { it.forEach { it.validate() } }
-                            validated = true
-                        }
-
-                        fun isValid(): Boolean =
-                            try {
-                                validate()
-                                true
-                            } catch (e: LlamaCloudInvalidDataException) {
-                                false
-                            }
-
-                        /**
-                         * Returns a score indicating how many valid values are contained in this
-                         * object recursively.
-                         *
-                         * Used for best match union deserialization.
-                         */
-                        @JvmSynthetic
-                        internal fun validity(): Int =
-                            (bbox.asKnown().getOrNull()?.validity() ?: 0) +
-                                (span.asKnown().getOrNull()?.size ?: 0) +
-                                (words.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
-
-                        /**
-                         * One grounded word: a `[start, end)` span in the source text and its bbox.
-                         */
-                        class Word
-                        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-                        private constructor(
-                            private val bbox: JsonField<BBox>,
-                            private val span: JsonField<List<JsonValue>>,
-                            private val additionalProperties: MutableMap<String, JsonValue>,
-                        ) {
-
-                            @JsonCreator
-                            private constructor(
-                                @JsonProperty("bbox")
-                                @ExcludeMissing
-                                bbox: JsonField<BBox> = JsonMissing.of(),
-                                @JsonProperty("span")
-                                @ExcludeMissing
-                                span: JsonField<List<JsonValue>> = JsonMissing.of(),
-                            ) : this(bbox, span, mutableMapOf())
-
-                            /**
-                             * Word bounding box
-                             *
-                             * @throws LlamaCloudInvalidDataException if the JSON field has an
-                             *   unexpected type or is unexpectedly missing or null (e.g. if the
-                             *   server responded with an unexpected value).
-                             */
-                            fun bbox(): BBox = bbox.getRequired("bbox")
-
-                            /**
-                             * `[start, end)` UTF-8 byte span in the complete source property string
-                             *
-                             * @throws LlamaCloudInvalidDataException if the JSON field has an
-                             *   unexpected type or is unexpectedly missing or null (e.g. if the
-                             *   server responded with an unexpected value).
-                             */
-                            fun span(): List<JsonValue> = span.getRequired("span")
-
-                            /**
-                             * Returns the raw JSON value of [bbox].
-                             *
-                             * Unlike [bbox], this method doesn't throw if the JSON field has an
-                             * unexpected type.
-                             */
-                            @JsonProperty("bbox")
-                            @ExcludeMissing
-                            fun _bbox(): JsonField<BBox> = bbox
-
-                            /**
-                             * Returns the raw JSON value of [span].
-                             *
-                             * Unlike [span], this method doesn't throw if the JSON field has an
-                             * unexpected type.
-                             */
-                            @JsonProperty("span")
-                            @ExcludeMissing
-                            fun _span(): JsonField<List<JsonValue>> = span
-
-                            @JsonAnySetter
-                            private fun putAdditionalProperty(key: String, value: JsonValue) {
-                                additionalProperties.put(key, value)
-                            }
-
-                            @JsonAnyGetter
-                            @ExcludeMissing
-                            fun _additionalProperties(): Map<String, JsonValue> =
-                                Collections.unmodifiableMap(additionalProperties)
-
-                            fun toBuilder() = Builder().from(this)
-
-                            companion object {
-
-                                /**
-                                 * Returns a mutable builder for constructing an instance of [Word].
-                                 *
-                                 * The following fields are required:
-                                 * ```java
-                                 * .bbox()
-                                 * .span()
-                                 * ```
-                                 */
-                                @JvmStatic fun builder() = Builder()
-                            }
-
-                            /** A builder for [Word]. */
-                            class Builder internal constructor() {
-
-                                private var bbox: JsonField<BBox>? = null
-                                private var span: JsonField<MutableList<JsonValue>>? = null
-                                private var additionalProperties: MutableMap<String, JsonValue> =
-                                    mutableMapOf()
-
-                                @JvmSynthetic
-                                internal fun from(word: Word) = apply {
-                                    bbox = word.bbox
-                                    span = word.span.map { it.toMutableList() }
-                                    additionalProperties = word.additionalProperties.toMutableMap()
-                                }
-
-                                /** Word bounding box */
-                                fun bbox(bbox: BBox) = bbox(JsonField.of(bbox))
-
-                                /**
-                                 * Sets [Builder.bbox] to an arbitrary JSON value.
-                                 *
-                                 * You should usually call [Builder.bbox] with a well-typed [BBox]
-                                 * value instead. This method is primarily for setting the field to
-                                 * an undocumented or not yet supported value.
-                                 */
-                                fun bbox(bbox: JsonField<BBox>) = apply { this.bbox = bbox }
-
-                                /**
-                                 * `[start, end)` UTF-8 byte span in the complete source property
-                                 * string
-                                 */
-                                fun span(span: List<JsonValue>) = span(JsonField.of(span))
-
-                                /**
-                                 * Sets [Builder.span] to an arbitrary JSON value.
-                                 *
-                                 * You should usually call [Builder.span] with a well-typed
-                                 * `List<JsonValue>` value instead. This method is primarily for
-                                 * setting the field to an undocumented or not yet supported value.
-                                 */
-                                fun span(span: JsonField<List<JsonValue>>) = apply {
-                                    this.span = span.map { it.toMutableList() }
-                                }
-
-                                /**
-                                 * Adds a single [JsonValue] to [Builder.span].
-                                 *
-                                 * @throws IllegalStateException if the field was previously set to
-                                 *   a non-list.
-                                 */
-                                fun addSpan(span: JsonValue) = apply {
-                                    this.span =
-                                        (this.span ?: JsonField.of(mutableListOf())).also {
-                                            checkKnown("span", it).add(span)
-                                        }
-                                }
-
-                                fun additionalProperties(
-                                    additionalProperties: Map<String, JsonValue>
-                                ) = apply {
-                                    this.additionalProperties.clear()
-                                    putAllAdditionalProperties(additionalProperties)
-                                }
-
-                                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                                    additionalProperties.put(key, value)
-                                }
-
-                                fun putAllAdditionalProperties(
-                                    additionalProperties: Map<String, JsonValue>
-                                ) = apply { this.additionalProperties.putAll(additionalProperties) }
-
-                                fun removeAdditionalProperty(key: String) = apply {
-                                    additionalProperties.remove(key)
-                                }
-
-                                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                                    keys.forEach(::removeAdditionalProperty)
-                                }
-
-                                /**
-                                 * Returns an immutable instance of [Word].
-                                 *
-                                 * Further updates to this [Builder] will not mutate the returned
-                                 * instance.
-                                 *
-                                 * The following fields are required:
-                                 * ```java
-                                 * .bbox()
-                                 * .span()
-                                 * ```
-                                 *
-                                 * @throws IllegalStateException if any required field is unset.
-                                 */
-                                fun build(): Word =
-                                    Word(
-                                        checkRequired("bbox", bbox),
-                                        checkRequired("span", span).map { it.toImmutable() },
-                                        additionalProperties.toMutableMap(),
-                                    )
-                            }
-
-                            private var validated: Boolean = false
-
-                            /**
-                             * Validates that the types of all values in this object match their
-                             * expected types recursively.
-                             *
-                             * This method is _not_ forwards compatible with new types from the API
-                             * for existing fields.
-                             *
-                             * @throws LlamaCloudInvalidDataException if any value type in this
-                             *   object doesn't match its expected type.
-                             */
-                            fun validate(): Word = apply {
-                                if (validated) {
-                                    return@apply
-                                }
-
-                                bbox().validate()
-                                span()
-                                validated = true
-                            }
-
-                            fun isValid(): Boolean =
-                                try {
-                                    validate()
-                                    true
-                                } catch (e: LlamaCloudInvalidDataException) {
-                                    false
-                                }
-
-                            /**
-                             * Returns a score indicating how many valid values are contained in
-                             * this object recursively.
-                             *
-                             * Used for best match union deserialization.
-                             */
-                            @JvmSynthetic
-                            internal fun validity(): Int =
-                                (bbox.asKnown().getOrNull()?.validity() ?: 0) +
-                                    (span.asKnown().getOrNull()?.size ?: 0)
-
-                            override fun equals(other: Any?): Boolean {
-                                if (this === other) {
-                                    return true
-                                }
-
-                                return other is Word &&
-                                    bbox == other.bbox &&
-                                    span == other.span &&
-                                    additionalProperties == other.additionalProperties
-                            }
-
-                            private val hashCode: Int by lazy {
-                                Objects.hash(bbox, span, additionalProperties)
-                            }
-
-                            override fun hashCode(): Int = hashCode
-
-                            override fun toString() =
-                                "Word{bbox=$bbox, span=$span, additionalProperties=$additionalProperties}"
-                        }
-
-                        override fun equals(other: Any?): Boolean {
-                            if (this === other) {
-                                return true
-                            }
-
-                            return other is Line &&
-                                bbox == other.bbox &&
-                                span == other.span &&
-                                words == other.words &&
-                                additionalProperties == other.additionalProperties
-                        }
-
-                        private val hashCode: Int by lazy {
-                            Objects.hash(bbox, span, words, additionalProperties)
-                        }
-
-                        override fun hashCode(): Int = hashCode
-
-                        override fun toString() =
-                            "Line{bbox=$bbox, span=$span, words=$words, additionalProperties=$additionalProperties}"
-                    }
-
-                    override fun equals(other: Any?): Boolean {
-                        if (this === other) {
-                            return true
-                        }
-
-                        return other is Value &&
-                            lines == other.lines &&
-                            additionalProperties == other.additionalProperties
-                    }
-
-                    private val hashCode: Int by lazy { Objects.hash(lines, additionalProperties) }
-
-                    override fun hashCode(): Int = hashCode
-
-                    override fun toString() =
-                        "Value{lines=$lines, additionalProperties=$additionalProperties}"
-                }
-
-                override fun equals(other: Any?): Boolean {
-                    if (this === other) {
-                        return true
-                    }
-
-                    return other is Grounding &&
-                        id == other.id &&
-                        label == other.label &&
-                        value == other.value &&
-                        additionalProperties == other.additionalProperties
-                }
-
-                private val hashCode: Int by lazy {
-                    Objects.hash(id, label, value, additionalProperties)
-                }
-
-                override fun hashCode(): Int = hashCode
-
-                override fun toString() =
-                    "Grounding{id=$id, label=$label, value=$value, additionalProperties=$additionalProperties}"
-            }
-
-            /** Form text node */
-            class Type @JsonCreator private constructor(private val value: JsonField<String>) :
-                Enum {
-
-                /**
-                 * Returns this class instance's raw value.
-                 *
-                 * This is usually only useful if this instance was deserialized from data that
-                 * doesn't match any known member, and you want to know that value. For example, if
-                 * the SDK is on an older version than the API, then the API may respond with new
-                 * members that the SDK is unaware of.
-                 */
-                @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
-
-                companion object {
-
-                    @JvmField val TEXT = of("text")
-
-                    @JvmStatic fun of(value: String) = Type(JsonField.of(value))
-                }
-
-                /** An enum containing [Type]'s known values. */
-                enum class Known {
-                    TEXT
-                }
-
-                /**
-                 * An enum containing [Type]'s known values, as well as an [_UNKNOWN] member.
-                 *
-                 * An instance of [Type] can contain an unknown value in a couple of cases:
-                 * - It was deserialized from data that doesn't match any known member. For example,
-                 *   if the SDK is on an older version than the API, then the API may respond with
-                 *   new members that the SDK is unaware of.
-                 * - It was constructed with an arbitrary value using the [of] method.
-                 */
-                enum class Value {
-                    TEXT,
-                    /**
-                     * An enum member indicating that [Type] was instantiated with an unknown value.
-                     */
-                    _UNKNOWN,
-                }
-
-                /**
-                 * Returns an enum member corresponding to this class instance's value, or
-                 * [Value._UNKNOWN] if the class was instantiated with an unknown value.
-                 *
-                 * Use the [known] method instead if you're certain the value is always known or if
-                 * you want to throw for the unknown case.
-                 */
-                fun value(): Value =
-                    when (this) {
-                        TEXT -> Value.TEXT
-                        else -> Value._UNKNOWN
-                    }
-
-                /**
-                 * Returns an enum member corresponding to this class instance's value.
-                 *
-                 * Use the [value] method instead if you're uncertain the value is always known and
-                 * don't want to throw for the unknown case.
-                 *
-                 * @throws LlamaCloudInvalidDataException if this class instance's value is a not a
-                 *   known member.
-                 */
-                fun known(): Known =
-                    when (this) {
-                        TEXT -> Known.TEXT
-                        else -> throw LlamaCloudInvalidDataException("Unknown Type: $value")
-                    }
-
-                /**
-                 * Returns this class instance's primitive wire representation.
-                 *
-                 * This differs from the [toString] method because that method is primarily for
-                 * debugging and generally doesn't throw.
-                 *
-                 * @throws LlamaCloudInvalidDataException if this class instance's value does not
-                 *   have the expected primitive type.
-                 */
-                fun asString(): String =
-                    _value().asString().orElseThrow {
-                        LlamaCloudInvalidDataException("Value is not a String")
-                    }
-
-                private var validated: Boolean = false
-
-                /**
-                 * Validates that the types of all values in this object match their expected types
-                 * recursively.
-                 *
-                 * This method is _not_ forwards compatible with new types from the API for existing
-                 * fields.
-                 *
-                 * @throws LlamaCloudInvalidDataException if any value type in this object doesn't
-                 *   match its expected type.
-                 */
-                fun validate(): Type = apply {
-                    if (validated) {
-                        return@apply
-                    }
-
-                    known()
-                    validated = true
-                }
-
-                fun isValid(): Boolean =
-                    try {
-                        validate()
-                        true
-                    } catch (e: LlamaCloudInvalidDataException) {
-                        false
-                    }
-
-                /**
-                 * Returns a score indicating how many valid values are contained in this object
-                 * recursively.
-                 *
-                 * Used for best match union deserialization.
-                 */
-                @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
-
-                override fun equals(other: Any?): Boolean {
-                    if (this === other) {
-                        return true
-                    }
-
-                    return other is Type && value == other.value
-                }
-
-                override fun hashCode() = value.hashCode()
-
-                override fun toString() = value.toString()
-            }
-
-            override fun equals(other: Any?): Boolean {
-                if (this === other) {
-                    return true
-                }
-
-                return other is Text &&
-                    value == other.value &&
-                    bbox == other.bbox &&
-                    grounding == other.grounding &&
-                    type == other.type &&
-                    additionalProperties == other.additionalProperties
-            }
-
-            private val hashCode: Int by lazy {
-                Objects.hash(value, bbox, grounding, type, additionalProperties)
-            }
-
-            override fun hashCode(): Int = hashCode
-
-            override fun toString() =
-                "Text{value=$value, bbox=$bbox, grounding=$grounding, type=$type, additionalProperties=$additionalProperties}"
-        }
     }
 
     override fun equals(other: Any?): Boolean {
diff --git a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/FormSection.kt b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/FormSection.kt
index c87df7d..325ca54 100644
--- a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/FormSection.kt
+++ b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/FormSection.kt
@@ -243,19 +243,19 @@ private constructor(
             addItem(FormTable.builder().type(FormTable.Type.TABLE).rows(rows).build())
 
         /** Alias for calling [addItem] with `Item.ofText(text)`. */
-        fun addItem(text: Item.Text) = addItem(Item.ofText(text))
+        fun addItem(text: FormText) = addItem(Item.ofText(text))
 
         /**
          * Alias for calling [addItem] with the following:
          * ```java
-         * Item.Text.builder()
-         *     .type(FormSection.Item.Text.Type.TEXT)
+         * FormText.builder()
+         *     .type(FormText.Type.TEXT)
          *     .value(value)
          *     .build()
          * ```
          */
         fun addTextItem(value: String) =
-            addItem(Item.Text.builder().type(FormSection.Item.Text.Type.TEXT).value(value).build())
+            addItem(FormText.builder().type(FormText.Type.TEXT).value(value).build())
 
         /** Identifier printed on the form (e.g. 'Part III'), if any */
         fun id(id: String?) = id(JsonField.ofNullable(id))
@@ -405,7 +405,7 @@ private constructor(
         private val field: FormField? = null,
         private val section: FormSection? = null,
         private val table: FormTable? = null,
-        private val text: Text? = null,
+        private val text: FormText? = null,
         private val _json: JsonValue? = null,
     ) {
 
@@ -422,7 +422,7 @@ private constructor(
          * Printed text that is not part of a field, section heading or table: a title, an
          * instruction, a note. With it the form JSON holds every printed word of its region.
          */
-        fun text(): Optional<Text> = Optional.ofNullable(text)
+        fun text(): Optional<FormText> = Optional.ofNullable(text)
 
         fun isField(): Boolean = field != null
 
@@ -445,7 +445,7 @@ private constructor(
          * Printed text that is not part of a field, section heading or table: a title, an
          * instruction, a note. With it the form JSON holds every printed word of its region.
          */
-        fun asText(): Text = text.getOrThrow("text")
+        fun asText(): FormText = text.getOrThrow("text")
 
         fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
 
@@ -517,7 +517,7 @@ private constructor(
                         table.validate()
                     }
 
-                    override fun visitText(text: Text) {
+                    override fun visitText(text: FormText) {
                         text.validate()
                     }
                 }
@@ -549,7 +549,7 @@ private constructor(
 
                     override fun visitTable(table: FormTable) = table.validity()
 
-                    override fun visitText(text: Text) = text.validity()
+                    override fun visitText(text: FormText) = text.validity()
 
                     override fun unknown(json: JsonValue?) = 0
                 }
@@ -594,7 +594,7 @@ private constructor(
              * Printed text that is not part of a field, section heading or table: a title, an
              * instruction, a note. With it the form JSON holds every printed word of its region.
              */
-            @JvmStatic fun ofText(text: Text) = Item(text = text)
+            @JvmStatic fun ofText(text: FormText) = Item(text = text)
         }
 
         /** An interface that defines how to map each variant of [Item] to a value of type [T]. */
@@ -613,7 +613,7 @@ private constructor(
              * Printed text that is not part of a field, section heading or table: a title, an
              * instruction, a note. With it the form JSON holds every printed word of its region.
              */
-            fun visitText(text: Text): T
+            fun visitText(text: FormText): T
 
             /**
              * Maps an unknown variant of [Item] to a value of type [T].
@@ -652,7 +652,7 @@ private constructor(
                         } ?: Item(_json = json)
                     }
                     "text" -> {
-                        return tryDeserialize(node, jacksonTypeRef<Text>())?.let {
+                        return tryDeserialize(node, jacksonTypeRef<FormText>())?.let {
                             Item(text = it, _json = json)
                         } ?: Item(_json = json)
                     }
@@ -679,2972 +679,6 @@ private constructor(
                 }
             }
         }
-
-        /**
-         * Printed text that is not part of a field, section heading or table: a title, an
-         * instruction, a note. With it the form JSON holds every printed word of its region.
-         */
-        class Text
-        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-        private constructor(
-            private val value: JsonField<String>,
-            private val bbox: JsonField<List<BBox>>,
-            private val grounding: JsonField<Grounding>,
-            private val type: JsonField<Type>,
-            private val additionalProperties: MutableMap<String, JsonValue>,
-        ) {
-
-            @JsonCreator
-            private constructor(
-                @JsonProperty("value") @ExcludeMissing value: JsonField<String> = JsonMissing.of(),
-                @JsonProperty("bbox")
-                @ExcludeMissing
-                bbox: JsonField<List<BBox>> = JsonMissing.of(),
-                @JsonProperty("grounding")
-                @ExcludeMissing
-                grounding: JsonField<Grounding> = JsonMissing.of(),
-                @JsonProperty("type") @ExcludeMissing type: JsonField<Type> = JsonMissing.of(),
-            ) : this(value, bbox, grounding, type, mutableMapOf())
-
-            /**
-             * The printed text, verbatim
-             *
-             * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type or is
-             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
-             *   value).
-             */
-            fun value(): String = value.getRequired("value")
-
-            /**
-             * Bounding boxes of the text on the page, if attributed.
-             *
-             * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g.
-             *   if the server responded with an unexpected value).
-             */
-            fun bbox(): Optional<List<BBox>> = bbox.getOptional("bbox")
-
-            /**
-             * Optional grounding for a field's printed text; boolean states have no text spans.
-             *
-             * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g.
-             *   if the server responded with an unexpected value).
-             */
-            fun grounding(): Optional<Grounding> = grounding.getOptional("grounding")
-
-            /**
-             * Form text node
-             *
-             * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g.
-             *   if the server responded with an unexpected value).
-             */
-            fun type(): Optional<Type> = type.getOptional("type")
-
-            /**
-             * Returns the raw JSON value of [value].
-             *
-             * Unlike [value], this method doesn't throw if the JSON field has an unexpected type.
-             */
-            @JsonProperty("value") @ExcludeMissing fun _value(): JsonField<String> = value
-
-            /**
-             * Returns the raw JSON value of [bbox].
-             *
-             * Unlike [bbox], this method doesn't throw if the JSON field has an unexpected type.
-             */
-            @JsonProperty("bbox") @ExcludeMissing fun _bbox(): JsonField<List<BBox>> = bbox
-
-            /**
-             * Returns the raw JSON value of [grounding].
-             *
-             * Unlike [grounding], this method doesn't throw if the JSON field has an unexpected
-             * type.
-             */
-            @JsonProperty("grounding")
-            @ExcludeMissing
-            fun _grounding(): JsonField<Grounding> = grounding
-
-            /**
-             * Returns the raw JSON value of [type].
-             *
-             * Unlike [type], this method doesn't throw if the JSON field has an unexpected type.
-             */
-            @JsonProperty("type") @ExcludeMissing fun _type(): JsonField<Type> = type
-
-            @JsonAnySetter
-            private fun putAdditionalProperty(key: String, value: JsonValue) {
-                additionalProperties.put(key, value)
-            }
-
-            @JsonAnyGetter
-            @ExcludeMissing
-            fun _additionalProperties(): Map<String, JsonValue> =
-                Collections.unmodifiableMap(additionalProperties)
-
-            fun toBuilder() = Builder().from(this)
-
-            companion object {
-
-                /**
-                 * Returns a mutable builder for constructing an instance of [Text].
-                 *
-                 * The following fields are required:
-                 * ```java
-                 * .value()
-                 * ```
-                 */
-                @JvmStatic fun builder() = Builder()
-            }
-
-            /** A builder for [Text]. */
-            class Builder internal constructor() {
-
-                private var value: JsonField<String>? = null
-                private var bbox: JsonField<MutableList<BBox>>? = null
-                private var grounding: JsonField<Grounding> = JsonMissing.of()
-                private var type: JsonField<Type> = JsonMissing.of()
-                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
-
-                @JvmSynthetic
-                internal fun from(text: Text) = apply {
-                    value = text.value
-                    bbox = text.bbox.map { it.toMutableList() }
-                    grounding = text.grounding
-                    type = text.type
-                    additionalProperties = text.additionalProperties.toMutableMap()
-                }
-
-                /** The printed text, verbatim */
-                fun value(value: String) = value(JsonField.of(value))
-
-                /**
-                 * Sets [Builder.value] to an arbitrary JSON value.
-                 *
-                 * You should usually call [Builder.value] with a well-typed [String] value instead.
-                 * This method is primarily for setting the field to an undocumented or not yet
-                 * supported value.
-                 */
-                fun value(value: JsonField<String>) = apply { this.value = value }
-
-                /** Bounding boxes of the text on the page, if attributed. */
-                fun bbox(bbox: List<BBox>?) = bbox(JsonField.ofNullable(bbox))
-
-                /** Alias for calling [Builder.bbox] with `bbox.orElse(null)`. */
-                fun bbox(bbox: Optional<List<BBox>>) = bbox(bbox.getOrNull())
-
-                /**
-                 * Sets [Builder.bbox] to an arbitrary JSON value.
-                 *
-                 * You should usually call [Builder.bbox] with a well-typed `List<BBox>` value
-                 * instead. This method is primarily for setting the field to an undocumented or not
-                 * yet supported value.
-                 */
-                fun bbox(bbox: JsonField<List<BBox>>) = apply {
-                    this.bbox = bbox.map { it.toMutableList() }
-                }
-
-                /**
-                 * Adds a single [BBox] to [Builder.bbox].
-                 *
-                 * @throws IllegalStateException if the field was previously set to a non-list.
-                 */
-                fun addBbox(bbox: BBox) = apply {
-                    this.bbox =
-                        (this.bbox ?: JsonField.of(mutableListOf())).also {
-                            checkKnown("bbox", it).add(bbox)
-                        }
-                }
-
-                /**
-                 * Optional grounding for a field's printed text; boolean states have no text spans.
-                 */
-                fun grounding(grounding: Grounding?) = grounding(JsonField.ofNullable(grounding))
-
-                /** Alias for calling [Builder.grounding] with `grounding.orElse(null)`. */
-                fun grounding(grounding: Optional<Grounding>) = grounding(grounding.getOrNull())
-
-                /**
-                 * Sets [Builder.grounding] to an arbitrary JSON value.
-                 *
-                 * You should usually call [Builder.grounding] with a well-typed [Grounding] value
-                 * instead. This method is primarily for setting the field to an undocumented or not
-                 * yet supported value.
-                 */
-                fun grounding(grounding: JsonField<Grounding>) = apply {
-                    this.grounding = grounding
-                }
-
-                /** Form text node */
-                fun type(type: Type) = type(JsonField.of(type))
-
-                /**
-                 * Sets [Builder.type] to an arbitrary JSON value.
-                 *
-                 * You should usually call [Builder.type] with a well-typed [Type] value instead.
-                 * This method is primarily for setting the field to an undocumented or not yet
-                 * supported value.
-                 */
-                fun type(type: JsonField<Type>) = apply { this.type = type }
-
-                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
-                    this.additionalProperties.clear()
-                    putAllAdditionalProperties(additionalProperties)
-                }
-
-                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                    additionalProperties.put(key, value)
-                }
-
-                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
-                    apply {
-                        this.additionalProperties.putAll(additionalProperties)
-                    }
-
-                fun removeAdditionalProperty(key: String) = apply {
-                    additionalProperties.remove(key)
-                }
-
-                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                    keys.forEach(::removeAdditionalProperty)
-                }
-
-                /**
-                 * Returns an immutable instance of [Text].
-                 *
-                 * Further updates to this [Builder] will not mutate the returned instance.
-                 *
-                 * The following fields are required:
-                 * ```java
-                 * .value()
-                 * ```
-                 *
-                 * @throws IllegalStateException if any required field is unset.
-                 */
-                fun build(): Text =
-                    Text(
-                        checkRequired("value", value),
-                        (bbox ?: JsonMissing.of()).map { it.toImmutable() },
-                        grounding,
-                        type,
-                        additionalProperties.toMutableMap(),
-                    )
-            }
-
-            private var validated: Boolean = false
-
-            /**
-             * Validates that the types of all values in this object match their expected types
-             * recursively.
-             *
-             * This method is _not_ forwards compatible with new types from the API for existing
-             * fields.
-             *
-             * @throws LlamaCloudInvalidDataException if any value type in this object doesn't match
-             *   its expected type.
-             */
-            fun validate(): Text = apply {
-                if (validated) {
-                    return@apply
-                }
-
-                value()
-                bbox().ifPresent { it.forEach { it.validate() } }
-                grounding().ifPresent { it.validate() }
-                type().ifPresent { it.validate() }
-                validated = true
-            }
-
-            fun isValid(): Boolean =
-                try {
-                    validate()
-                    true
-                } catch (e: LlamaCloudInvalidDataException) {
-                    false
-                }
-
-            /**
-             * Returns a score indicating how many valid values are contained in this object
-             * recursively.
-             *
-             * Used for best match union deserialization.
-             */
-            @JvmSynthetic
-            internal fun validity(): Int =
-                (if (value.asKnown().isPresent) 1 else 0) +
-                    (bbox.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
-                    (grounding.asKnown().getOrNull()?.validity() ?: 0) +
-                    (type.asKnown().getOrNull()?.validity() ?: 0)
-
-            /** Optional grounding for a field's printed text; boolean states have no text spans. */
-            class Grounding
-            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-            private constructor(
-                private val id: JsonField<Id>,
-                private val label: JsonField<Label>,
-                private val value: JsonField<Value>,
-                private val additionalProperties: MutableMap<String, JsonValue>,
-            ) {
-
-                @JsonCreator
-                private constructor(
-                    @JsonProperty("id") @ExcludeMissing id: JsonField<Id> = JsonMissing.of(),
-                    @JsonProperty("label")
-                    @ExcludeMissing
-                    label: JsonField<Label> = JsonMissing.of(),
-                    @JsonProperty("value")
-                    @ExcludeMissing
-                    value: JsonField<Value> = JsonMissing.of(),
-                ) : this(id, label, value, mutableMapOf())
-
-                /**
-                 * Supported text with half-open UTF-8 byte spans into the complete property string.
-                 *
-                 * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type
-                 *   (e.g. if the server responded with an unexpected value).
-                 */
-                fun id(): Optional<Id> = id.getOptional("id")
-
-                /**
-                 * Supported text with half-open UTF-8 byte spans into the complete property string.
-                 *
-                 * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type
-                 *   (e.g. if the server responded with an unexpected value).
-                 */
-                fun label(): Optional<Label> = label.getOptional("label")
-
-                /**
-                 * Supported text with half-open UTF-8 byte spans into the complete property string.
-                 *
-                 * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type
-                 *   (e.g. if the server responded with an unexpected value).
-                 */
-                fun value(): Optional<Value> = value.getOptional("value")
-
-                /**
-                 * Returns the raw JSON value of [id].
-                 *
-                 * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
-                 */
-                @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<Id> = id
-
-                /**
-                 * Returns the raw JSON value of [label].
-                 *
-                 * Unlike [label], this method doesn't throw if the JSON field has an unexpected
-                 * type.
-                 */
-                @JsonProperty("label") @ExcludeMissing fun _label(): JsonField<Label> = label
-
-                /**
-                 * Returns the raw JSON value of [value].
-                 *
-                 * Unlike [value], this method doesn't throw if the JSON field has an unexpected
-                 * type.
-                 */
-                @JsonProperty("value") @ExcludeMissing fun _value(): JsonField<Value> = value
-
-                @JsonAnySetter
-                private fun putAdditionalProperty(key: String, value: JsonValue) {
-                    additionalProperties.put(key, value)
-                }
-
-                @JsonAnyGetter
-                @ExcludeMissing
-                fun _additionalProperties(): Map<String, JsonValue> =
-                    Collections.unmodifiableMap(additionalProperties)
-
-                fun toBuilder() = Builder().from(this)
-
-                companion object {
-
-                    /** Returns a mutable builder for constructing an instance of [Grounding]. */
-                    @JvmStatic fun builder() = Builder()
-                }
-
-                /** A builder for [Grounding]. */
-                class Builder internal constructor() {
-
-                    private var id: JsonField<Id> = JsonMissing.of()
-                    private var label: JsonField<Label> = JsonMissing.of()
-                    private var value: JsonField<Value> = JsonMissing.of()
-                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
-
-                    @JvmSynthetic
-                    internal fun from(grounding: Grounding) = apply {
-                        id = grounding.id
-                        label = grounding.label
-                        value = grounding.value
-                        additionalProperties = grounding.additionalProperties.toMutableMap()
-                    }
-
-                    /**
-                     * Supported text with half-open UTF-8 byte spans into the complete property
-                     * string.
-                     */
-                    fun id(id: Id?) = id(JsonField.ofNullable(id))
-
-                    /** Alias for calling [Builder.id] with `id.orElse(null)`. */
-                    fun id(id: Optional<Id>) = id(id.getOrNull())
-
-                    /**
-                     * Sets [Builder.id] to an arbitrary JSON value.
-                     *
-                     * You should usually call [Builder.id] with a well-typed [Id] value instead.
-                     * This method is primarily for setting the field to an undocumented or not yet
-                     * supported value.
-                     */
-                    fun id(id: JsonField<Id>) = apply { this.id = id }
-
-                    /**
-                     * Supported text with half-open UTF-8 byte spans into the complete property
-                     * string.
-                     */
-                    fun label(label: Label?) = label(JsonField.ofNullable(label))
-
-                    /** Alias for calling [Builder.label] with `label.orElse(null)`. */
-                    fun label(label: Optional<Label>) = label(label.getOrNull())
-
-                    /**
-                     * Sets [Builder.label] to an arbitrary JSON value.
-                     *
-                     * You should usually call [Builder.label] with a well-typed [Label] value
-                     * instead. This method is primarily for setting the field to an undocumented or
-                     * not yet supported value.
-                     */
-                    fun label(label: JsonField<Label>) = apply { this.label = label }
-
-                    /**
-                     * Supported text with half-open UTF-8 byte spans into the complete property
-                     * string.
-                     */
-                    fun value(value: Value?) = value(JsonField.ofNullable(value))
-
-                    /** Alias for calling [Builder.value] with `value.orElse(null)`. */
-                    fun value(value: Optional<Value>) = value(value.getOrNull())
-
-                    /**
-                     * Sets [Builder.value] to an arbitrary JSON value.
-                     *
-                     * You should usually call [Builder.value] with a well-typed [Value] value
-                     * instead. This method is primarily for setting the field to an undocumented or
-                     * not yet supported value.
-                     */
-                    fun value(value: JsonField<Value>) = apply { this.value = value }
-
-                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
-                        this.additionalProperties.clear()
-                        putAllAdditionalProperties(additionalProperties)
-                    }
-
-                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                        additionalProperties.put(key, value)
-                    }
-
-                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
-                        apply {
-                            this.additionalProperties.putAll(additionalProperties)
-                        }
-
-                    fun removeAdditionalProperty(key: String) = apply {
-                        additionalProperties.remove(key)
-                    }
-
-                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                        keys.forEach(::removeAdditionalProperty)
-                    }
-
-                    /**
-                     * Returns an immutable instance of [Grounding].
-                     *
-                     * Further updates to this [Builder] will not mutate the returned instance.
-                     */
-                    fun build(): Grounding =
-                        Grounding(id, label, value, additionalProperties.toMutableMap())
-                }
-
-                private var validated: Boolean = false
-
-                /**
-                 * Validates that the types of all values in this object match their expected types
-                 * recursively.
-                 *
-                 * This method is _not_ forwards compatible with new types from the API for existing
-                 * fields.
-                 *
-                 * @throws LlamaCloudInvalidDataException if any value type in this object doesn't
-                 *   match its expected type.
-                 */
-                fun validate(): Grounding = apply {
-                    if (validated) {
-                        return@apply
-                    }
-
-                    id().ifPresent { it.validate() }
-                    label().ifPresent { it.validate() }
-                    value().ifPresent { it.validate() }
-                    validated = true
-                }
-
-                fun isValid(): Boolean =
-                    try {
-                        validate()
-                        true
-                    } catch (e: LlamaCloudInvalidDataException) {
-                        false
-                    }
-
-                /**
-                 * Returns a score indicating how many valid values are contained in this object
-                 * recursively.
-                 *
-                 * Used for best match union deserialization.
-                 */
-                @JvmSynthetic
-                internal fun validity(): Int =
-                    (id.asKnown().getOrNull()?.validity() ?: 0) +
-                        (label.asKnown().getOrNull()?.validity() ?: 0) +
-                        (value.asKnown().getOrNull()?.validity() ?: 0)
-
-                /**
-                 * Supported text with half-open UTF-8 byte spans into the complete property string.
-                 */
-                class Id
-                @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-                private constructor(
-                    private val lines: JsonField<List<Line>>,
-                    private val additionalProperties: MutableMap<String, JsonValue>,
-                ) {
-
-                    @JsonCreator
-                    private constructor(
-                        @JsonProperty("lines")
-                        @ExcludeMissing
-                        lines: JsonField<List<Line>> = JsonMissing.of()
-                    ) : this(lines, mutableMapOf())
-
-                    /**
-                     * Supported lines. Word requests include supported words; gaps are valid. Boxes
-                     * use final page coordinates and optional local rotation r.
-                     *
-                     * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected
-                     *   type or is unexpectedly missing or null (e.g. if the server responded with
-                     *   an unexpected value).
-                     */
-                    fun lines(): List<Line> = lines.getRequired("lines")
-
-                    /**
-                     * Returns the raw JSON value of [lines].
-                     *
-                     * Unlike [lines], this method doesn't throw if the JSON field has an unexpected
-                     * type.
-                     */
-                    @JsonProperty("lines")
-                    @ExcludeMissing
-                    fun _lines(): JsonField<List<Line>> = lines
-
-                    @JsonAnySetter
-                    private fun putAdditionalProperty(key: String, value: JsonValue) {
-                        additionalProperties.put(key, value)
-                    }
-
-                    @JsonAnyGetter
-                    @ExcludeMissing
-                    fun _additionalProperties(): Map<String, JsonValue> =
-                        Collections.unmodifiableMap(additionalProperties)
-
-                    fun toBuilder() = Builder().from(this)
-
-                    companion object {
-
-                        /**
-                         * Returns a mutable builder for constructing an instance of [Id].
-                         *
-                         * The following fields are required:
-                         * ```java
-                         * .lines()
-                         * ```
-                         */
-                        @JvmStatic fun builder() = Builder()
-                    }
-
-                    /** A builder for [Id]. */
-                    class Builder internal constructor() {
-
-                        private var lines: JsonField<MutableList<Line>>? = null
-                        private var additionalProperties: MutableMap<String, JsonValue> =
-                            mutableMapOf()
-
-                        @JvmSynthetic
-                        internal fun from(id: Id) = apply {
-                            lines = id.lines.map { it.toMutableList() }
-                            additionalProperties = id.additionalProperties.toMutableMap()
-                        }
-
-                        /**
-                         * Supported lines. Word requests include supported words; gaps are valid.
-                         * Boxes use final page coordinates and optional local rotation r.
-                         */
-                        fun lines(lines: List<Line>) = lines(JsonField.of(lines))
-
-                        /**
-                         * Sets [Builder.lines] to an arbitrary JSON value.
-                         *
-                         * You should usually call [Builder.lines] with a well-typed `List<Line>`
-                         * value instead. This method is primarily for setting the field to an
-                         * undocumented or not yet supported value.
-                         */
-                        fun lines(lines: JsonField<List<Line>>) = apply {
-                            this.lines = lines.map { it.toMutableList() }
-                        }
-
-                        /**
-                         * Adds a single [Line] to [lines].
-                         *
-                         * @throws IllegalStateException if the field was previously set to a
-                         *   non-list.
-                         */
-                        fun addLine(line: Line) = apply {
-                            lines =
-                                (lines ?: JsonField.of(mutableListOf())).also {
-                                    checkKnown("lines", it).add(line)
-                                }
-                        }
-
-                        fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
-                            apply {
-                                this.additionalProperties.clear()
-                                putAllAdditionalProperties(additionalProperties)
-                            }
-
-                        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                            additionalProperties.put(key, value)
-                        }
-
-                        fun putAllAdditionalProperties(
-                            additionalProperties: Map<String, JsonValue>
-                        ) = apply { this.additionalProperties.putAll(additionalProperties) }
-
-                        fun removeAdditionalProperty(key: String) = apply {
-                            additionalProperties.remove(key)
-                        }
-
-                        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                            keys.forEach(::removeAdditionalProperty)
-                        }
-
-                        /**
-                         * Returns an immutable instance of [Id].
-                         *
-                         * Further updates to this [Builder] will not mutate the returned instance.
-                         *
-                         * The following fields are required:
-                         * ```java
-                         * .lines()
-                         * ```
-                         *
-                         * @throws IllegalStateException if any required field is unset.
-                         */
-                        fun build(): Id =
-                            Id(
-                                checkRequired("lines", lines).map { it.toImmutable() },
-                                additionalProperties.toMutableMap(),
-                            )
-                    }
-
-                    private var validated: Boolean = false
-
-                    /**
-                     * Validates that the types of all values in this object match their expected
-                     * types recursively.
-                     *
-                     * This method is _not_ forwards compatible with new types from the API for
-                     * existing fields.
-                     *
-                     * @throws LlamaCloudInvalidDataException if any value type in this object
-                     *   doesn't match its expected type.
-                     */
-                    fun validate(): Id = apply {
-                        if (validated) {
-                            return@apply
-                        }
-
-                        lines().forEach { it.validate() }
-                        validated = true
-                    }
-
-                    fun isValid(): Boolean =
-                        try {
-                            validate()
-                            true
-                        } catch (e: LlamaCloudInvalidDataException) {
-                            false
-                        }
-
-                    /**
-                     * Returns a score indicating how many valid values are contained in this object
-                     * recursively.
-                     *
-                     * Used for best match union deserialization.
-                     */
-                    @JvmSynthetic
-                    internal fun validity(): Int =
-                        (lines.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
-
-                    /** One grounded line of text with an optional per-word breakdown. */
-                    class Line
-                    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-                    private constructor(
-                        private val bbox: JsonField<BBox>,
-                        private val span: JsonField<List<JsonValue>>,
-                        private val words: JsonField<List<Word>>,
-                        private val additionalProperties: MutableMap<String, JsonValue>,
-                    ) {
-
-                        @JsonCreator
-                        private constructor(
-                            @JsonProperty("bbox")
-                            @ExcludeMissing
-                            bbox: JsonField<BBox> = JsonMissing.of(),
-                            @JsonProperty("span")
-                            @ExcludeMissing
-                            span: JsonField<List<JsonValue>> = JsonMissing.of(),
-                            @JsonProperty("words")
-                            @ExcludeMissing
-                            words: JsonField<List<Word>> = JsonMissing.of(),
-                        ) : this(bbox, span, words, mutableMapOf())
-
-                        /**
-                         * Line bounding box
-                         *
-                         * @throws LlamaCloudInvalidDataException if the JSON field has an
-                         *   unexpected type or is unexpectedly missing or null (e.g. if the server
-                         *   responded with an unexpected value).
-                         */
-                        fun bbox(): BBox = bbox.getRequired("bbox")
-
-                        /**
-                         * `[start, end)` UTF-8 byte span in the complete source property string
-                         *
-                         * @throws LlamaCloudInvalidDataException if the JSON field has an
-                         *   unexpected type or is unexpectedly missing or null (e.g. if the server
-                         *   responded with an unexpected value).
-                         */
-                        fun span(): List<JsonValue> = span.getRequired("span")
-
-                        /**
-                         * Per-word grounding within the line, when available
-                         *
-                         * @throws LlamaCloudInvalidDataException if the JSON field has an
-                         *   unexpected type (e.g. if the server responded with an unexpected
-                         *   value).
-                         */
-                        fun words(): Optional<List<Word>> = words.getOptional("words")
-
-                        /**
-                         * Returns the raw JSON value of [bbox].
-                         *
-                         * Unlike [bbox], this method doesn't throw if the JSON field has an
-                         * unexpected type.
-                         */
-                        @JsonProperty("bbox") @ExcludeMissing fun _bbox(): JsonField<BBox> = bbox
-
-                        /**
-                         * Returns the raw JSON value of [span].
-                         *
-                         * Unlike [span], this method doesn't throw if the JSON field has an
-                         * unexpected type.
-                         */
-                        @JsonProperty("span")
-                        @ExcludeMissing
-                        fun _span(): JsonField<List<JsonValue>> = span
-
-                        /**
-                         * Returns the raw JSON value of [words].
-                         *
-                         * Unlike [words], this method doesn't throw if the JSON field has an
-                         * unexpected type.
-                         */
-                        @JsonProperty("words")
-                        @ExcludeMissing
-                        fun _words(): JsonField<List<Word>> = words
-
-                        @JsonAnySetter
-                        private fun putAdditionalProperty(key: String, value: JsonValue) {
-                            additionalProperties.put(key, value)
-                        }
-
-                        @JsonAnyGetter
-                        @ExcludeMissing
-                        fun _additionalProperties(): Map<String, JsonValue> =
-                            Collections.unmodifiableMap(additionalProperties)
-
-                        fun toBuilder() = Builder().from(this)
-
-                        companion object {
-
-                            /**
-                             * Returns a mutable builder for constructing an instance of [Line].
-                             *
-                             * The following fields are required:
-                             * ```java
-                             * .bbox()
-                             * .span()
-                             * ```
-                             */
-                            @JvmStatic fun builder() = Builder()
-                        }
-
-                        /** A builder for [Line]. */
-                        class Builder internal constructor() {
-
-                            private var bbox: JsonField<BBox>? = null
-                            private var span: JsonField<MutableList<JsonValue>>? = null
-                            private var words: JsonField<MutableList<Word>>? = null
-                            private var additionalProperties: MutableMap<String, JsonValue> =
-                                mutableMapOf()
-
-                            @JvmSynthetic
-                            internal fun from(line: Line) = apply {
-                                bbox = line.bbox
-                                span = line.span.map { it.toMutableList() }
-                                words = line.words.map { it.toMutableList() }
-                                additionalProperties = line.additionalProperties.toMutableMap()
-                            }
-
-                            /** Line bounding box */
-                            fun bbox(bbox: BBox) = bbox(JsonField.of(bbox))
-
-                            /**
-                             * Sets [Builder.bbox] to an arbitrary JSON value.
-                             *
-                             * You should usually call [Builder.bbox] with a well-typed [BBox] value
-                             * instead. This method is primarily for setting the field to an
-                             * undocumented or not yet supported value.
-                             */
-                            fun bbox(bbox: JsonField<BBox>) = apply { this.bbox = bbox }
-
-                            /**
-                             * `[start, end)` UTF-8 byte span in the complete source property string
-                             */
-                            fun span(span: List<JsonValue>) = span(JsonField.of(span))
-
-                            /**
-                             * Sets [Builder.span] to an arbitrary JSON value.
-                             *
-                             * You should usually call [Builder.span] with a well-typed
-                             * `List<JsonValue>` value instead. This method is primarily for setting
-                             * the field to an undocumented or not yet supported value.
-                             */
-                            fun span(span: JsonField<List<JsonValue>>) = apply {
-                                this.span = span.map { it.toMutableList() }
-                            }
-
-                            /**
-                             * Adds a single [JsonValue] to [Builder.span].
-                             *
-                             * @throws IllegalStateException if the field was previously set to a
-                             *   non-list.
-                             */
-                            fun addSpan(span: JsonValue) = apply {
-                                this.span =
-                                    (this.span ?: JsonField.of(mutableListOf())).also {
-                                        checkKnown("span", it).add(span)
-                                    }
-                            }
-
-                            /** Per-word grounding within the line, when available */
-                            fun words(words: List<Word>?) = words(JsonField.ofNullable(words))
-
-                            /** Alias for calling [Builder.words] with `words.orElse(null)`. */
-                            fun words(words: Optional<List<Word>>) = words(words.getOrNull())
-
-                            /**
-                             * Sets [Builder.words] to an arbitrary JSON value.
-                             *
-                             * You should usually call [Builder.words] with a well-typed
-                             * `List<Word>` value instead. This method is primarily for setting the
-                             * field to an undocumented or not yet supported value.
-                             */
-                            fun words(words: JsonField<List<Word>>) = apply {
-                                this.words = words.map { it.toMutableList() }
-                            }
-
-                            /**
-                             * Adds a single [Word] to [words].
-                             *
-                             * @throws IllegalStateException if the field was previously set to a
-                             *   non-list.
-                             */
-                            fun addWord(word: Word) = apply {
-                                words =
-                                    (words ?: JsonField.of(mutableListOf())).also {
-                                        checkKnown("words", it).add(word)
-                                    }
-                            }
-
-                            fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
-                                apply {
-                                    this.additionalProperties.clear()
-                                    putAllAdditionalProperties(additionalProperties)
-                                }
-
-                            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                                additionalProperties.put(key, value)
-                            }
-
-                            fun putAllAdditionalProperties(
-                                additionalProperties: Map<String, JsonValue>
-                            ) = apply { this.additionalProperties.putAll(additionalProperties) }
-
-                            fun removeAdditionalProperty(key: String) = apply {
-                                additionalProperties.remove(key)
-                            }
-
-                            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                                keys.forEach(::removeAdditionalProperty)
-                            }
-
-                            /**
-                             * Returns an immutable instance of [Line].
-                             *
-                             * Further updates to this [Builder] will not mutate the returned
-                             * instance.
-                             *
-                             * The following fields are required:
-                             * ```java
-                             * .bbox()
-                             * .span()
-                             * ```
-                             *
-                             * @throws IllegalStateException if any required field is unset.
-                             */
-                            fun build(): Line =
-                                Line(
-                                    checkRequired("bbox", bbox),
-                                    checkRequired("span", span).map { it.toImmutable() },
-                                    (words ?: JsonMissing.of()).map { it.toImmutable() },
-                                    additionalProperties.toMutableMap(),
-                                )
-                        }
-
-                        private var validated: Boolean = false
-
-                        /**
-                         * Validates that the types of all values in this object match their
-                         * expected types recursively.
-                         *
-                         * This method is _not_ forwards compatible with new types from the API for
-                         * existing fields.
-                         *
-                         * @throws LlamaCloudInvalidDataException if any value type in this object
-                         *   doesn't match its expected type.
-                         */
-                        fun validate(): Line = apply {
-                            if (validated) {
-                                return@apply
-                            }
-
-                            bbox().validate()
-                            span()
-                            words().ifPresent { it.forEach { it.validate() } }
-                            validated = true
-                        }
-
-                        fun isValid(): Boolean =
-                            try {
-                                validate()
-                                true
-                            } catch (e: LlamaCloudInvalidDataException) {
-                                false
-                            }
-
-                        /**
-                         * Returns a score indicating how many valid values are contained in this
-                         * object recursively.
-                         *
-                         * Used for best match union deserialization.
-                         */
-                        @JvmSynthetic
-                        internal fun validity(): Int =
-                            (bbox.asKnown().getOrNull()?.validity() ?: 0) +
-                                (span.asKnown().getOrNull()?.size ?: 0) +
-                                (words.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
-
-                        /**
-                         * One grounded word: a `[start, end)` span in the source text and its bbox.
-                         */
-                        class Word
-                        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-                        private constructor(
-                            private val bbox: JsonField<BBox>,
-                            private val span: JsonField<List<JsonValue>>,
-                            private val additionalProperties: MutableMap<String, JsonValue>,
-                        ) {
-
-                            @JsonCreator
-                            private constructor(
-                                @JsonProperty("bbox")
-                                @ExcludeMissing
-                                bbox: JsonField<BBox> = JsonMissing.of(),
-                                @JsonProperty("span")
-                                @ExcludeMissing
-                                span: JsonField<List<JsonValue>> = JsonMissing.of(),
-                            ) : this(bbox, span, mutableMapOf())
-
-                            /**
-                             * Word bounding box
-                             *
-                             * @throws LlamaCloudInvalidDataException if the JSON field has an
-                             *   unexpected type or is unexpectedly missing or null (e.g. if the
-                             *   server responded with an unexpected value).
-                             */
-                            fun bbox(): BBox = bbox.getRequired("bbox")
-
-                            /**
-                             * `[start, end)` UTF-8 byte span in the complete source property string
-                             *
-                             * @throws LlamaCloudInvalidDataException if the JSON field has an
-                             *   unexpected type or is unexpectedly missing or null (e.g. if the
-                             *   server responded with an unexpected value).
-                             */
-                            fun span(): List<JsonValue> = span.getRequired("span")
-
-                            /**
-                             * Returns the raw JSON value of [bbox].
-                             *
-                             * Unlike [bbox], this method doesn't throw if the JSON field has an
-                             * unexpected type.
-                             */
-                            @JsonProperty("bbox")
-                            @ExcludeMissing
-                            fun _bbox(): JsonField<BBox> = bbox
-
-                            /**
-                             * Returns the raw JSON value of [span].
-                             *
-                             * Unlike [span], this method doesn't throw if the JSON field has an
-                             * unexpected type.
-                             */
-                            @JsonProperty("span")
-                            @ExcludeMissing
-                            fun _span(): JsonField<List<JsonValue>> = span
-
-                            @JsonAnySetter
-                            private fun putAdditionalProperty(key: String, value: JsonValue) {
-                                additionalProperties.put(key, value)
-                            }
-
-                            @JsonAnyGetter
-                            @ExcludeMissing
-                            fun _additionalProperties(): Map<String, JsonValue> =
-                                Collections.unmodifiableMap(additionalProperties)
-
-                            fun toBuilder() = Builder().from(this)
-
-                            companion object {
-
-                                /**
-                                 * Returns a mutable builder for constructing an instance of [Word].
-                                 *
-                                 * The following fields are required:
-                                 * ```java
-                                 * .bbox()
-                                 * .span()
-                                 * ```
-                                 */
-                                @JvmStatic fun builder() = Builder()
-                            }
-
-                            /** A builder for [Word]. */
-                            class Builder internal constructor() {
-
-                                private var bbox: JsonField<BBox>? = null
-                                private var span: JsonField<MutableList<JsonValue>>? = null
-                                private var additionalProperties: MutableMap<String, JsonValue> =
-                                    mutableMapOf()
-
-                                @JvmSynthetic
-                                internal fun from(word: Word) = apply {
-                                    bbox = word.bbox
-                                    span = word.span.map { it.toMutableList() }
-                                    additionalProperties = word.additionalProperties.toMutableMap()
-                                }
-
-                                /** Word bounding box */
-                                fun bbox(bbox: BBox) = bbox(JsonField.of(bbox))
-
-                                /**
-                                 * Sets [Builder.bbox] to an arbitrary JSON value.
-                                 *
-                                 * You should usually call [Builder.bbox] with a well-typed [BBox]
-                                 * value instead. This method is primarily for setting the field to
-                                 * an undocumented or not yet supported value.
-                                 */
-                                fun bbox(bbox: JsonField<BBox>) = apply { this.bbox = bbox }
-
-                                /**
-                                 * `[start, end)` UTF-8 byte span in the complete source property
-                                 * string
-                                 */
-                                fun span(span: List<JsonValue>) = span(JsonField.of(span))
-
-                                /**
-                                 * Sets [Builder.span] to an arbitrary JSON value.
-                                 *
-                                 * You should usually call [Builder.span] with a well-typed
-                                 * `List<JsonValue>` value instead. This method is primarily for
-                                 * setting the field to an undocumented or not yet supported value.
-                                 */
-                                fun span(span: JsonField<List<JsonValue>>) = apply {
-                                    this.span = span.map { it.toMutableList() }
-                                }
-
-                                /**
-                                 * Adds a single [JsonValue] to [Builder.span].
-                                 *
-                                 * @throws IllegalStateException if the field was previously set to
-                                 *   a non-list.
-                                 */
-                                fun addSpan(span: JsonValue) = apply {
-                                    this.span =
-                                        (this.span ?: JsonField.of(mutableListOf())).also {
-                                            checkKnown("span", it).add(span)
-                                        }
-                                }
-
-                                fun additionalProperties(
-                                    additionalProperties: Map<String, JsonValue>
-                                ) = apply {
-                                    this.additionalProperties.clear()
-                                    putAllAdditionalProperties(additionalProperties)
-                                }
-
-                                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                                    additionalProperties.put(key, value)
-                                }
-
-                                fun putAllAdditionalProperties(
-                                    additionalProperties: Map<String, JsonValue>
-                                ) = apply { this.additionalProperties.putAll(additionalProperties) }
-
-                                fun removeAdditionalProperty(key: String) = apply {
-                                    additionalProperties.remove(key)
-                                }
-
-                                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                                    keys.forEach(::removeAdditionalProperty)
-                                }
-
-                                /**
-                                 * Returns an immutable instance of [Word].
-                                 *
-                                 * Further updates to this [Builder] will not mutate the returned
-                                 * instance.
-                                 *
-                                 * The following fields are required:
-                                 * ```java
-                                 * .bbox()
-                                 * .span()
-                                 * ```
-                                 *
-                                 * @throws IllegalStateException if any required field is unset.
-                                 */
-                                fun build(): Word =
-                                    Word(
-                                        checkRequired("bbox", bbox),
-                                        checkRequired("span", span).map { it.toImmutable() },
-                                        additionalProperties.toMutableMap(),
-                                    )
-                            }
-
-                            private var validated: Boolean = false
-
-                            /**
-                             * Validates that the types of all values in this object match their
-                             * expected types recursively.
-                             *
-                             * This method is _not_ forwards compatible with new types from the API
-                             * for existing fields.
-                             *
-                             * @throws LlamaCloudInvalidDataException if any value type in this
-                             *   object doesn't match its expected type.
-                             */
-                            fun validate(): Word = apply {
-                                if (validated) {
-                                    return@apply
-                                }
-
-                                bbox().validate()
-                                span()
-                                validated = true
-                            }
-
-                            fun isValid(): Boolean =
-                                try {
-                                    validate()
-                                    true
-                                } catch (e: LlamaCloudInvalidDataException) {
-                                    false
-                                }
-
-                            /**
-                             * Returns a score indicating how many valid values are contained in
-                             * this object recursively.
-                             *
-                             * Used for best match union deserialization.
-                             */
-                            @JvmSynthetic
-                            internal fun validity(): Int =
-                                (bbox.asKnown().getOrNull()?.validity() ?: 0) +
-                                    (span.asKnown().getOrNull()?.size ?: 0)
-
-                            override fun equals(other: Any?): Boolean {
-                                if (this === other) {
-                                    return true
-                                }
-
-                                return other is Word &&
-                                    bbox == other.bbox &&
-                                    span == other.span &&
-                                    additionalProperties == other.additionalProperties
-                            }
-
-                            private val hashCode: Int by lazy {
-                                Objects.hash(bbox, span, additionalProperties)
-                            }
-
-                            override fun hashCode(): Int = hashCode
-
-                            override fun toString() =
-                                "Word{bbox=$bbox, span=$span, additionalProperties=$additionalProperties}"
-                        }
-
-                        override fun equals(other: Any?): Boolean {
-                            if (this === other) {
-                                return true
-                            }
-
-                            return other is Line &&
-                                bbox == other.bbox &&
-                                span == other.span &&
-                                words == other.words &&
-                                additionalProperties == other.additionalProperties
-                        }
-
-                        private val hashCode: Int by lazy {
-                            Objects.hash(bbox, span, words, additionalProperties)
-                        }
-
-                        override fun hashCode(): Int = hashCode
-
-                        override fun toString() =
-                            "Line{bbox=$bbox, span=$span, words=$words, additionalProperties=$additionalProperties}"
-                    }
-
-                    override fun equals(other: Any?): Boolean {
-                        if (this === other) {
-                            return true
-                        }
-
-                        return other is Id &&
-                            lines == other.lines &&
-                            additionalProperties == other.additionalProperties
-                    }
-
-                    private val hashCode: Int by lazy { Objects.hash(lines, additionalProperties) }
-
-                    override fun hashCode(): Int = hashCode
-
-                    override fun toString() =
-                        "Id{lines=$lines, additionalProperties=$additionalProperties}"
-                }
-
-                /**
-                 * Supported text with half-open UTF-8 byte spans into the complete property string.
-                 */
-                class Label
-                @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-                private constructor(
-                    private val lines: JsonField<List<Line>>,
-                    private val additionalProperties: MutableMap<String, JsonValue>,
-                ) {
-
-                    @JsonCreator
-                    private constructor(
-                        @JsonProperty("lines")
-                        @ExcludeMissing
-                        lines: JsonField<List<Line>> = JsonMissing.of()
-                    ) : this(lines, mutableMapOf())
-
-                    /**
-                     * Supported lines. Word requests include supported words; gaps are valid. Boxes
-                     * use final page coordinates and optional local rotation r.
-                     *
-                     * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected
-                     *   type or is unexpectedly missing or null (e.g. if the server responded with
-                     *   an unexpected value).
-                     */
-                    fun lines(): List<Line> = lines.getRequired("lines")
-
-                    /**
-                     * Returns the raw JSON value of [lines].
-                     *
-                     * Unlike [lines], this method doesn't throw if the JSON field has an unexpected
-                     * type.
-                     */
-                    @JsonProperty("lines")
-                    @ExcludeMissing
-                    fun _lines(): JsonField<List<Line>> = lines
-
-                    @JsonAnySetter
-                    private fun putAdditionalProperty(key: String, value: JsonValue) {
-                        additionalProperties.put(key, value)
-                    }
-
-                    @JsonAnyGetter
-                    @ExcludeMissing
-                    fun _additionalProperties(): Map<String, JsonValue> =
-                        Collections.unmodifiableMap(additionalProperties)
-
-                    fun toBuilder() = Builder().from(this)
-
-                    companion object {
-
-                        /**
-                         * Returns a mutable builder for constructing an instance of [Label].
-                         *
-                         * The following fields are required:
-                         * ```java
-                         * .lines()
-                         * ```
-                         */
-                        @JvmStatic fun builder() = Builder()
-                    }
-
-                    /** A builder for [Label]. */
-                    class Builder internal constructor() {
-
-                        private var lines: JsonField<MutableList<Line>>? = null
-                        private var additionalProperties: MutableMap<String, JsonValue> =
-                            mutableMapOf()
-
-                        @JvmSynthetic
-                        internal fun from(label: Label) = apply {
-                            lines = label.lines.map { it.toMutableList() }
-                            additionalProperties = label.additionalProperties.toMutableMap()
-                        }
-
-                        /**
-                         * Supported lines. Word requests include supported words; gaps are valid.
-                         * Boxes use final page coordinates and optional local rotation r.
-                         */
-                        fun lines(lines: List<Line>) = lines(JsonField.of(lines))
-
-                        /**
-                         * Sets [Builder.lines] to an arbitrary JSON value.
-                         *
-                         * You should usually call [Builder.lines] with a well-typed `List<Line>`
-                         * value instead. This method is primarily for setting the field to an
-                         * undocumented or not yet supported value.
-                         */
-                        fun lines(lines: JsonField<List<Line>>) = apply {
-                            this.lines = lines.map { it.toMutableList() }
-                        }
-
-                        /**
-                         * Adds a single [Line] to [lines].
-                         *
-                         * @throws IllegalStateException if the field was previously set to a
-                         *   non-list.
-                         */
-                        fun addLine(line: Line) = apply {
-                            lines =
-                                (lines ?: JsonField.of(mutableListOf())).also {
-                                    checkKnown("lines", it).add(line)
-                                }
-                        }
-
-                        fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
-                            apply {
-                                this.additionalProperties.clear()
-                                putAllAdditionalProperties(additionalProperties)
-                            }
-
-                        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                            additionalProperties.put(key, value)
-                        }
-
-                        fun putAllAdditionalProperties(
-                            additionalProperties: Map<String, JsonValue>
-                        ) = apply { this.additionalProperties.putAll(additionalProperties) }
-
-                        fun removeAdditionalProperty(key: String) = apply {
-                            additionalProperties.remove(key)
-                        }
-
-                        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                            keys.forEach(::removeAdditionalProperty)
-                        }
-
-                        /**
-                         * Returns an immutable instance of [Label].
-                         *
-                         * Further updates to this [Builder] will not mutate the returned instance.
-                         *
-                         * The following fields are required:
-                         * ```java
-                         * .lines()
-                         * ```
-                         *
-                         * @throws IllegalStateException if any required field is unset.
-                         */
-                        fun build(): Label =
-                            Label(
-                                checkRequired("lines", lines).map { it.toImmutable() },
-                                additionalProperties.toMutableMap(),
-                            )
-                    }
-
-                    private var validated: Boolean = false
-
-                    /**
-                     * Validates that the types of all values in this object match their expected
-                     * types recursively.
-                     *
-                     * This method is _not_ forwards compatible with new types from the API for
-                     * existing fields.
-                     *
-                     * @throws LlamaCloudInvalidDataException if any value type in this object
-                     *   doesn't match its expected type.
-                     */
-                    fun validate(): Label = apply {
-                        if (validated) {
-                            return@apply
-                        }
-
-                        lines().forEach { it.validate() }
-                        validated = true
-                    }
-
-                    fun isValid(): Boolean =
-                        try {
-                            validate()
-                            true
-                        } catch (e: LlamaCloudInvalidDataException) {
-                            false
-                        }
-
-                    /**
-                     * Returns a score indicating how many valid values are contained in this object
-                     * recursively.
-                     *
-                     * Used for best match union deserialization.
-                     */
-                    @JvmSynthetic
-                    internal fun validity(): Int =
-                        (lines.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
-
-                    /** One grounded line of text with an optional per-word breakdown. */
-                    class Line
-                    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-                    private constructor(
-                        private val bbox: JsonField<BBox>,
-                        private val span: JsonField<List<JsonValue>>,
-                        private val words: JsonField<List<Word>>,
-                        private val additionalProperties: MutableMap<String, JsonValue>,
-                    ) {
-
-                        @JsonCreator
-                        private constructor(
-                            @JsonProperty("bbox")
-                            @ExcludeMissing
-                            bbox: JsonField<BBox> = JsonMissing.of(),
-                            @JsonProperty("span")
-                            @ExcludeMissing
-                            span: JsonField<List<JsonValue>> = JsonMissing.of(),
-                            @JsonProperty("words")
-                            @ExcludeMissing
-                            words: JsonField<List<Word>> = JsonMissing.of(),
-                        ) : this(bbox, span, words, mutableMapOf())
-
-                        /**
-                         * Line bounding box
-                         *
-                         * @throws LlamaCloudInvalidDataException if the JSON field has an
-                         *   unexpected type or is unexpectedly missing or null (e.g. if the server
-                         *   responded with an unexpected value).
-                         */
-                        fun bbox(): BBox = bbox.getRequired("bbox")
-
-                        /**
-                         * `[start, end)` UTF-8 byte span in the complete source property string
-                         *
-                         * @throws LlamaCloudInvalidDataException if the JSON field has an
-                         *   unexpected type or is unexpectedly missing or null (e.g. if the server
-                         *   responded with an unexpected value).
-                         */
-                        fun span(): List<JsonValue> = span.getRequired("span")
-
-                        /**
-                         * Per-word grounding within the line, when available
-                         *
-                         * @throws LlamaCloudInvalidDataException if the JSON field has an
-                         *   unexpected type (e.g. if the server responded with an unexpected
-                         *   value).
-                         */
-                        fun words(): Optional<List<Word>> = words.getOptional("words")
-
-                        /**
-                         * Returns the raw JSON value of [bbox].
-                         *
-                         * Unlike [bbox], this method doesn't throw if the JSON field has an
-                         * unexpected type.
-                         */
-                        @JsonProperty("bbox") @ExcludeMissing fun _bbox(): JsonField<BBox> = bbox
-
-                        /**
-                         * Returns the raw JSON value of [span].
-                         *
-                         * Unlike [span], this method doesn't throw if the JSON field has an
-                         * unexpected type.
-                         */
-                        @JsonProperty("span")
-                        @ExcludeMissing
-                        fun _span(): JsonField<List<JsonValue>> = span
-
-                        /**
-                         * Returns the raw JSON value of [words].
-                         *
-                         * Unlike [words], this method doesn't throw if the JSON field has an
-                         * unexpected type.
-                         */
-                        @JsonProperty("words")
-                        @ExcludeMissing
-                        fun _words(): JsonField<List<Word>> = words
-
-                        @JsonAnySetter
-                        private fun putAdditionalProperty(key: String, value: JsonValue) {
-                            additionalProperties.put(key, value)
-                        }
-
-                        @JsonAnyGetter
-                        @ExcludeMissing
-                        fun _additionalProperties(): Map<String, JsonValue> =
-                            Collections.unmodifiableMap(additionalProperties)
-
-                        fun toBuilder() = Builder().from(this)
-
-                        companion object {
-
-                            /**
-                             * Returns a mutable builder for constructing an instance of [Line].
-                             *
-                             * The following fields are required:
-                             * ```java
-                             * .bbox()
-                             * .span()
-                             * ```
-                             */
-                            @JvmStatic fun builder() = Builder()
-                        }
-
-                        /** A builder for [Line]. */
-                        class Builder internal constructor() {
-
-                            private var bbox: JsonField<BBox>? = null
-                            private var span: JsonField<MutableList<JsonValue>>? = null
-                            private var words: JsonField<MutableList<Word>>? = null
-                            private var additionalProperties: MutableMap<String, JsonValue> =
-                                mutableMapOf()
-
-                            @JvmSynthetic
-                            internal fun from(line: Line) = apply {
-                                bbox = line.bbox
-                                span = line.span.map { it.toMutableList() }
-                                words = line.words.map { it.toMutableList() }
-                                additionalProperties = line.additionalProperties.toMutableMap()
-                            }
-
-                            /** Line bounding box */
-                            fun bbox(bbox: BBox) = bbox(JsonField.of(bbox))
-
-                            /**
-                             * Sets [Builder.bbox] to an arbitrary JSON value.
-                             *
-                             * You should usually call [Builder.bbox] with a well-typed [BBox] value
-                             * instead. This method is primarily for setting the field to an
-                             * undocumented or not yet supported value.
-                             */
-                            fun bbox(bbox: JsonField<BBox>) = apply { this.bbox = bbox }
-
-                            /**
-                             * `[start, end)` UTF-8 byte span in the complete source property string
-                             */
-                            fun span(span: List<JsonValue>) = span(JsonField.of(span))
-
-                            /**
-                             * Sets [Builder.span] to an arbitrary JSON value.
-                             *
-                             * You should usually call [Builder.span] with a well-typed
-                             * `List<JsonValue>` value instead. This method is primarily for setting
-                             * the field to an undocumented or not yet supported value.
-                             */
-                            fun span(span: JsonField<List<JsonValue>>) = apply {
-                                this.span = span.map { it.toMutableList() }
-                            }
-
-                            /**
-                             * Adds a single [JsonValue] to [Builder.span].
-                             *
-                             * @throws IllegalStateException if the field was previously set to a
-                             *   non-list.
-                             */
-                            fun addSpan(span: JsonValue) = apply {
-                                this.span =
-                                    (this.span ?: JsonField.of(mutableListOf())).also {
-                                        checkKnown("span", it).add(span)
-                                    }
-                            }
-
-                            /** Per-word grounding within the line, when available */
-                            fun words(words: List<Word>?) = words(JsonField.ofNullable(words))
-
-                            /** Alias for calling [Builder.words] with `words.orElse(null)`. */
-                            fun words(words: Optional<List<Word>>) = words(words.getOrNull())
-
-                            /**
-                             * Sets [Builder.words] to an arbitrary JSON value.
-                             *
-                             * You should usually call [Builder.words] with a well-typed
-                             * `List<Word>` value instead. This method is primarily for setting the
-                             * field to an undocumented or not yet supported value.
-                             */
-                            fun words(words: JsonField<List<Word>>) = apply {
-                                this.words = words.map { it.toMutableList() }
-                            }
-
-                            /**
-                             * Adds a single [Word] to [words].
-                             *
-                             * @throws IllegalStateException if the field was previously set to a
-                             *   non-list.
-                             */
-                            fun addWord(word: Word) = apply {
-                                words =
-                                    (words ?: JsonField.of(mutableListOf())).also {
-                                        checkKnown("words", it).add(word)
-                                    }
-                            }
-
-                            fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
-                                apply {
-                                    this.additionalProperties.clear()
-                                    putAllAdditionalProperties(additionalProperties)
-                                }
-
-                            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                                additionalProperties.put(key, value)
-                            }
-
-                            fun putAllAdditionalProperties(
-                                additionalProperties: Map<String, JsonValue>
-                            ) = apply { this.additionalProperties.putAll(additionalProperties) }
-
-                            fun removeAdditionalProperty(key: String) = apply {
-                                additionalProperties.remove(key)
-                            }
-
-                            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                                keys.forEach(::removeAdditionalProperty)
-                            }
-
-                            /**
-                             * Returns an immutable instance of [Line].
-                             *
-                             * Further updates to this [Builder] will not mutate the returned
-                             * instance.
-                             *
-                             * The following fields are required:
-                             * ```java
-                             * .bbox()
-                             * .span()
-                             * ```
-                             *
-                             * @throws IllegalStateException if any required field is unset.
-                             */
-                            fun build(): Line =
-                                Line(
-                                    checkRequired("bbox", bbox),
-                                    checkRequired("span", span).map { it.toImmutable() },
-                                    (words ?: JsonMissing.of()).map { it.toImmutable() },
-                                    additionalProperties.toMutableMap(),
-                                )
-                        }
-
-                        private var validated: Boolean = false
-
-                        /**
-                         * Validates that the types of all values in this object match their
-                         * expected types recursively.
-                         *
-                         * This method is _not_ forwards compatible with new types from the API for
-                         * existing fields.
-                         *
-                         * @throws LlamaCloudInvalidDataException if any value type in this object
-                         *   doesn't match its expected type.
-                         */
-                        fun validate(): Line = apply {
-                            if (validated) {
-                                return@apply
-                            }
-
-                            bbox().validate()
-                            span()
-                            words().ifPresent { it.forEach { it.validate() } }
-                            validated = true
-                        }
-
-                        fun isValid(): Boolean =
-                            try {
-                                validate()
-                                true
-                            } catch (e: LlamaCloudInvalidDataException) {
-                                false
-                            }
-
-                        /**
-                         * Returns a score indicating how many valid values are contained in this
-                         * object recursively.
-                         *
-                         * Used for best match union deserialization.
-                         */
-                        @JvmSynthetic
-                        internal fun validity(): Int =
-                            (bbox.asKnown().getOrNull()?.validity() ?: 0) +
-                                (span.asKnown().getOrNull()?.size ?: 0) +
-                                (words.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
-
-                        /**
-                         * One grounded word: a `[start, end)` span in the source text and its bbox.
-                         */
-                        class Word
-                        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-                        private constructor(
-                            private val bbox: JsonField<BBox>,
-                            private val span: JsonField<List<JsonValue>>,
-                            private val additionalProperties: MutableMap<String, JsonValue>,
-                        ) {
-
-                            @JsonCreator
-                            private constructor(
-                                @JsonProperty("bbox")
-                                @ExcludeMissing
-                                bbox: JsonField<BBox> = JsonMissing.of(),
-                                @JsonProperty("span")
-                                @ExcludeMissing
-                                span: JsonField<List<JsonValue>> = JsonMissing.of(),
-                            ) : this(bbox, span, mutableMapOf())
-
-                            /**
-                             * Word bounding box
-                             *
-                             * @throws LlamaCloudInvalidDataException if the JSON field has an
-                             *   unexpected type or is unexpectedly missing or null (e.g. if the
-                             *   server responded with an unexpected value).
-                             */
-                            fun bbox(): BBox = bbox.getRequired("bbox")
-
-                            /**
-                             * `[start, end)` UTF-8 byte span in the complete source property string
-                             *
-                             * @throws LlamaCloudInvalidDataException if the JSON field has an
-                             *   unexpected type or is unexpectedly missing or null (e.g. if the
-                             *   server responded with an unexpected value).
-                             */
-                            fun span(): List<JsonValue> = span.getRequired("span")
-
-                            /**
-                             * Returns the raw JSON value of [bbox].
-                             *
-                             * Unlike [bbox], this method doesn't throw if the JSON field has an
-                             * unexpected type.
-                             */
-                            @JsonProperty("bbox")
-                            @ExcludeMissing
-                            fun _bbox(): JsonField<BBox> = bbox
-
-                            /**
-                             * Returns the raw JSON value of [span].
-                             *
-                             * Unlike [span], this method doesn't throw if the JSON field has an
-                             * unexpected type.
-                             */
-                            @JsonProperty("span")
-                            @ExcludeMissing
-                            fun _span(): JsonField<List<JsonValue>> = span
-
-                            @JsonAnySetter
-                            private fun putAdditionalProperty(key: String, value: JsonValue) {
-                                additionalProperties.put(key, value)
-                            }
-
-                            @JsonAnyGetter
-                            @ExcludeMissing
-                            fun _additionalProperties(): Map<String, JsonValue> =
-                                Collections.unmodifiableMap(additionalProperties)
-
-                            fun toBuilder() = Builder().from(this)
-
-                            companion object {
-
-                                /**
-                                 * Returns a mutable builder for constructing an instance of [Word].
-                                 *
-                                 * The following fields are required:
-                                 * ```java
-                                 * .bbox()
-                                 * .span()
-                                 * ```
-                                 */
-                                @JvmStatic fun builder() = Builder()
-                            }
-
-                            /** A builder for [Word]. */
-                            class Builder internal constructor() {
-
-                                private var bbox: JsonField<BBox>? = null
-                                private var span: JsonField<MutableList<JsonValue>>? = null
-                                private var additionalProperties: MutableMap<String, JsonValue> =
-                                    mutableMapOf()
-
-                                @JvmSynthetic
-                                internal fun from(word: Word) = apply {
-                                    bbox = word.bbox
-                                    span = word.span.map { it.toMutableList() }
-                                    additionalProperties = word.additionalProperties.toMutableMap()
-                                }
-
-                                /** Word bounding box */
-                                fun bbox(bbox: BBox) = bbox(JsonField.of(bbox))
-
-                                /**
-                                 * Sets [Builder.bbox] to an arbitrary JSON value.
-                                 *
-                                 * You should usually call [Builder.bbox] with a well-typed [BBox]
-                                 * value instead. This method is primarily for setting the field to
-                                 * an undocumented or not yet supported value.
-                                 */
-                                fun bbox(bbox: JsonField<BBox>) = apply { this.bbox = bbox }
-
-                                /**
-                                 * `[start, end)` UTF-8 byte span in the complete source property
-                                 * string
-                                 */
-                                fun span(span: List<JsonValue>) = span(JsonField.of(span))
-
-                                /**
-                                 * Sets [Builder.span] to an arbitrary JSON value.
-                                 *
-                                 * You should usually call [Builder.span] with a well-typed
-                                 * `List<JsonValue>` value instead. This method is primarily for
-                                 * setting the field to an undocumented or not yet supported value.
-                                 */
-                                fun span(span: JsonField<List<JsonValue>>) = apply {
-                                    this.span = span.map { it.toMutableList() }
-                                }
-
-                                /**
-                                 * Adds a single [JsonValue] to [Builder.span].
-                                 *
-                                 * @throws IllegalStateException if the field was previously set to
-                                 *   a non-list.
-                                 */
-                                fun addSpan(span: JsonValue) = apply {
-                                    this.span =
-                                        (this.span ?: JsonField.of(mutableListOf())).also {
-                                            checkKnown("span", it).add(span)
-                                        }
-                                }
-
-                                fun additionalProperties(
-                                    additionalProperties: Map<String, JsonValue>
-                                ) = apply {
-                                    this.additionalProperties.clear()
-                                    putAllAdditionalProperties(additionalProperties)
-                                }
-
-                                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                                    additionalProperties.put(key, value)
-                                }
-
-                                fun putAllAdditionalProperties(
-                                    additionalProperties: Map<String, JsonValue>
-                                ) = apply { this.additionalProperties.putAll(additionalProperties) }
-
-                                fun removeAdditionalProperty(key: String) = apply {
-                                    additionalProperties.remove(key)
-                                }
-
-                                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                                    keys.forEach(::removeAdditionalProperty)
-                                }
-
-                                /**
-                                 * Returns an immutable instance of [Word].
-                                 *
-                                 * Further updates to this [Builder] will not mutate the returned
-                                 * instance.
-                                 *
-                                 * The following fields are required:
-                                 * ```java
-                                 * .bbox()
-                                 * .span()
-                                 * ```
-                                 *
-                                 * @throws IllegalStateException if any required field is unset.
-                                 */
-                                fun build(): Word =
-                                    Word(
-                                        checkRequired("bbox", bbox),
-                                        checkRequired("span", span).map { it.toImmutable() },
-                                        additionalProperties.toMutableMap(),
-                                    )
-                            }
-
-                            private var validated: Boolean = false
-
-                            /**
-                             * Validates that the types of all values in this object match their
-                             * expected types recursively.
-                             *
-                             * This method is _not_ forwards compatible with new types from the API
-                             * for existing fields.
-                             *
-                             * @throws LlamaCloudInvalidDataException if any value type in this
-                             *   object doesn't match its expected type.
-                             */
-                            fun validate(): Word = apply {
-                                if (validated) {
-                                    return@apply
-                                }
-
-                                bbox().validate()
-                                span()
-                                validated = true
-                            }
-
-                            fun isValid(): Boolean =
-                                try {
-                                    validate()
-                                    true
-                                } catch (e: LlamaCloudInvalidDataException) {
-                                    false
-                                }
-
-                            /**
-                             * Returns a score indicating how many valid values are contained in
-                             * this object recursively.
-                             *
-                             * Used for best match union deserialization.
-                             */
-                            @JvmSynthetic
-                            internal fun validity(): Int =
-                                (bbox.asKnown().getOrNull()?.validity() ?: 0) +
-                                    (span.asKnown().getOrNull()?.size ?: 0)
-
-                            override fun equals(other: Any?): Boolean {
-                                if (this === other) {
-                                    return true
-                                }
-
-                                return other is Word &&
-                                    bbox == other.bbox &&
-                                    span == other.span &&
-                                    additionalProperties == other.additionalProperties
-                            }
-
-                            private val hashCode: Int by lazy {
-                                Objects.hash(bbox, span, additionalProperties)
-                            }
-
-                            override fun hashCode(): Int = hashCode
-
-                            override fun toString() =
-                                "Word{bbox=$bbox, span=$span, additionalProperties=$additionalProperties}"
-                        }
-
-                        override fun equals(other: Any?): Boolean {
-                            if (this === other) {
-                                return true
-                            }
-
-                            return other is Line &&
-                                bbox == other.bbox &&
-                                span == other.span &&
-                                words == other.words &&
-                                additionalProperties == other.additionalProperties
-                        }
-
-                        private val hashCode: Int by lazy {
-                            Objects.hash(bbox, span, words, additionalProperties)
-                        }
-
-                        override fun hashCode(): Int = hashCode
-
-                        override fun toString() =
-                            "Line{bbox=$bbox, span=$span, words=$words, additionalProperties=$additionalProperties}"
-                    }
-
-                    override fun equals(other: Any?): Boolean {
-                        if (this === other) {
-                            return true
-                        }
-
-                        return other is Label &&
-                            lines == other.lines &&
-                            additionalProperties == other.additionalProperties
-                    }
-
-                    private val hashCode: Int by lazy { Objects.hash(lines, additionalProperties) }
-
-                    override fun hashCode(): Int = hashCode
-
-                    override fun toString() =
-                        "Label{lines=$lines, additionalProperties=$additionalProperties}"
-                }
-
-                /**
-                 * Supported text with half-open UTF-8 byte spans into the complete property string.
-                 */
-                class Value
-                @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-                private constructor(
-                    private val lines: JsonField<List<Line>>,
-                    private val additionalProperties: MutableMap<String, JsonValue>,
-                ) {
-
-                    @JsonCreator
-                    private constructor(
-                        @JsonProperty("lines")
-                        @ExcludeMissing
-                        lines: JsonField<List<Line>> = JsonMissing.of()
-                    ) : this(lines, mutableMapOf())
-
-                    /**
-                     * Supported lines. Word requests include supported words; gaps are valid. Boxes
-                     * use final page coordinates and optional local rotation r.
-                     *
-                     * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected
-                     *   type or is unexpectedly missing or null (e.g. if the server responded with
-                     *   an unexpected value).
-                     */
-                    fun lines(): List<Line> = lines.getRequired("lines")
-
-                    /**
-                     * Returns the raw JSON value of [lines].
-                     *
-                     * Unlike [lines], this method doesn't throw if the JSON field has an unexpected
-                     * type.
-                     */
-                    @JsonProperty("lines")
-                    @ExcludeMissing
-                    fun _lines(): JsonField<List<Line>> = lines
-
-                    @JsonAnySetter
-                    private fun putAdditionalProperty(key: String, value: JsonValue) {
-                        additionalProperties.put(key, value)
-                    }
-
-                    @JsonAnyGetter
-                    @ExcludeMissing
-                    fun _additionalProperties(): Map<String, JsonValue> =
-                        Collections.unmodifiableMap(additionalProperties)
-
-                    fun toBuilder() = Builder().from(this)
-
-                    companion object {
-
-                        /**
-                         * Returns a mutable builder for constructing an instance of [Value].
-                         *
-                         * The following fields are required:
-                         * ```java
-                         * .lines()
-                         * ```
-                         */
-                        @JvmStatic fun builder() = Builder()
-                    }
-
-                    /** A builder for [Value]. */
-                    class Builder internal constructor() {
-
-                        private var lines: JsonField<MutableList<Line>>? = null
-                        private var additionalProperties: MutableMap<String, JsonValue> =
-                            mutableMapOf()
-
-                        @JvmSynthetic
-                        internal fun from(value: Value) = apply {
-                            lines = value.lines.map { it.toMutableList() }
-                            additionalProperties = value.additionalProperties.toMutableMap()
-                        }
-
-                        /**
-                         * Supported lines. Word requests include supported words; gaps are valid.
-                         * Boxes use final page coordinates and optional local rotation r.
-                         */
-                        fun lines(lines: List<Line>) = lines(JsonField.of(lines))
-
-                        /**
-                         * Sets [Builder.lines] to an arbitrary JSON value.
-                         *
-                         * You should usually call [Builder.lines] with a well-typed `List<Line>`
-                         * value instead. This method is primarily for setting the field to an
-                         * undocumented or not yet supported value.
-                         */
-                        fun lines(lines: JsonField<List<Line>>) = apply {
-                            this.lines = lines.map { it.toMutableList() }
-                        }
-
-                        /**
-                         * Adds a single [Line] to [lines].
-                         *
-                         * @throws IllegalStateException if the field was previously set to a
-                         *   non-list.
-                         */
-                        fun addLine(line: Line) = apply {
-                            lines =
-                                (lines ?: JsonField.of(mutableListOf())).also {
-                                    checkKnown("lines", it).add(line)
-                                }
-                        }
-
-                        fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
-                            apply {
-                                this.additionalProperties.clear()
-                                putAllAdditionalProperties(additionalProperties)
-                            }
-
-                        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                            additionalProperties.put(key, value)
-                        }
-
-                        fun putAllAdditionalProperties(
-                            additionalProperties: Map<String, JsonValue>
-                        ) = apply { this.additionalProperties.putAll(additionalProperties) }
-
-                        fun removeAdditionalProperty(key: String) = apply {
-                            additionalProperties.remove(key)
-                        }
-
-                        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                            keys.forEach(::removeAdditionalProperty)
-                        }
-
-                        /**
-                         * Returns an immutable instance of [Value].
-                         *
-                         * Further updates to this [Builder] will not mutate the returned instance.
-                         *
-                         * The following fields are required:
-                         * ```java
-                         * .lines()
-                         * ```
-                         *
-                         * @throws IllegalStateException if any required field is unset.
-                         */
-                        fun build(): Value =
-                            Value(
-                                checkRequired("lines", lines).map { it.toImmutable() },
-                                additionalProperties.toMutableMap(),
-                            )
-                    }
-
-                    private var validated: Boolean = false
-
-                    /**
-                     * Validates that the types of all values in this object match their expected
-                     * types recursively.
-                     *
-                     * This method is _not_ forwards compatible with new types from the API for
-                     * existing fields.
-                     *
-                     * @throws LlamaCloudInvalidDataException if any value type in this object
-                     *   doesn't match its expected type.
-                     */
-                    fun validate(): Value = apply {
-                        if (validated) {
-                            return@apply
-                        }
-
-                        lines().forEach { it.validate() }
-                        validated = true
-                    }
-
-                    fun isValid(): Boolean =
-                        try {
-                            validate()
-                            true
-                        } catch (e: LlamaCloudInvalidDataException) {
-                            false
-                        }
-
-                    /**
-                     * Returns a score indicating how many valid values are contained in this object
-                     * recursively.
-                     *
-                     * Used for best match union deserialization.
-                     */
-                    @JvmSynthetic
-                    internal fun validity(): Int =
-                        (lines.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
-
-                    /** One grounded line of text with an optional per-word breakdown. */
-                    class Line
-                    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-                    private constructor(
-                        private val bbox: JsonField<BBox>,
-                        private val span: JsonField<List<JsonValue>>,
-                        private val words: JsonField<List<Word>>,
-                        private val additionalProperties: MutableMap<String, JsonValue>,
-                    ) {
-
-                        @JsonCreator
-                        private constructor(
-                            @JsonProperty("bbox")
-                            @ExcludeMissing
-                            bbox: JsonField<BBox> = JsonMissing.of(),
-                            @JsonProperty("span")
-                            @ExcludeMissing
-                            span: JsonField<List<JsonValue>> = JsonMissing.of(),
-                            @JsonProperty("words")
-                            @ExcludeMissing
-                            words: JsonField<List<Word>> = JsonMissing.of(),
-                        ) : this(bbox, span, words, mutableMapOf())
-
-                        /**
-                         * Line bounding box
-                         *
-                         * @throws LlamaCloudInvalidDataException if the JSON field has an
-                         *   unexpected type or is unexpectedly missing or null (e.g. if the server
-                         *   responded with an unexpected value).
-                         */
-                        fun bbox(): BBox = bbox.getRequired("bbox")
-
-                        /**
-                         * `[start, end)` UTF-8 byte span in the complete source property string
-                         *
-                         * @throws LlamaCloudInvalidDataException if the JSON field has an
-                         *   unexpected type or is unexpectedly missing or null (e.g. if the server
-                         *   responded with an unexpected value).
-                         */
-                        fun span(): List<JsonValue> = span.getRequired("span")
-
-                        /**
-                         * Per-word grounding within the line, when available
-                         *
-                         * @throws LlamaCloudInvalidDataException if the JSON field has an
-                         *   unexpected type (e.g. if the server responded with an unexpected
-                         *   value).
-                         */
-                        fun words(): Optional<List<Word>> = words.getOptional("words")
-
-                        /**
-                         * Returns the raw JSON value of [bbox].
-                         *
-                         * Unlike [bbox], this method doesn't throw if the JSON field has an
-                         * unexpected type.
-                         */
-                        @JsonProperty("bbox") @ExcludeMissing fun _bbox(): JsonField<BBox> = bbox
-
-                        /**
-                         * Returns the raw JSON value of [span].
-                         *
-                         * Unlike [span], this method doesn't throw if the JSON field has an
-                         * unexpected type.
-                         */
-                        @JsonProperty("span")
-                        @ExcludeMissing
-                        fun _span(): JsonField<List<JsonValue>> = span
-
-                        /**
-                         * Returns the raw JSON value of [words].
-                         *
-                         * Unlike [words], this method doesn't throw if the JSON field has an
-                         * unexpected type.
-                         */
-                        @JsonProperty("words")
-                        @ExcludeMissing
-                        fun _words(): JsonField<List<Word>> = words
-
-                        @JsonAnySetter
-                        private fun putAdditionalProperty(key: String, value: JsonValue) {
-                            additionalProperties.put(key, value)
-                        }
-
-                        @JsonAnyGetter
-                        @ExcludeMissing
-                        fun _additionalProperties(): Map<String, JsonValue> =
-                            Collections.unmodifiableMap(additionalProperties)
-
-                        fun toBuilder() = Builder().from(this)
-
-                        companion object {
-
-                            /**
-                             * Returns a mutable builder for constructing an instance of [Line].
-                             *
-                             * The following fields are required:
-                             * ```java
-                             * .bbox()
-                             * .span()
-                             * ```
-                             */
-                            @JvmStatic fun builder() = Builder()
-                        }
-
-                        /** A builder for [Line]. */
-                        class Builder internal constructor() {
-
-                            private var bbox: JsonField<BBox>? = null
-                            private var span: JsonField<MutableList<JsonValue>>? = null
-                            private var words: JsonField<MutableList<Word>>? = null
-                            private var additionalProperties: MutableMap<String, JsonValue> =
-                                mutableMapOf()
-
-                            @JvmSynthetic
-                            internal fun from(line: Line) = apply {
-                                bbox = line.bbox
-                                span = line.span.map { it.toMutableList() }
-                                words = line.words.map { it.toMutableList() }
-                                additionalProperties = line.additionalProperties.toMutableMap()
-                            }
-
-                            /** Line bounding box */
-                            fun bbox(bbox: BBox) = bbox(JsonField.of(bbox))
-
-                            /**
-                             * Sets [Builder.bbox] to an arbitrary JSON value.
-                             *
-                             * You should usually call [Builder.bbox] with a well-typed [BBox] value
-                             * instead. This method is primarily for setting the field to an
-                             * undocumented or not yet supported value.
-                             */
-                            fun bbox(bbox: JsonField<BBox>) = apply { this.bbox = bbox }
-
-                            /**
-                             * `[start, end)` UTF-8 byte span in the complete source property string
-                             */
-                            fun span(span: List<JsonValue>) = span(JsonField.of(span))
-
-                            /**
-                             * Sets [Builder.span] to an arbitrary JSON value.
-                             *
-                             * You should usually call [Builder.span] with a well-typed
-                             * `List<JsonValue>` value instead. This method is primarily for setting
-                             * the field to an undocumented or not yet supported value.
-                             */
-                            fun span(span: JsonField<List<JsonValue>>) = apply {
-                                this.span = span.map { it.toMutableList() }
-                            }
-
-                            /**
-                             * Adds a single [JsonValue] to [Builder.span].
-                             *
-                             * @throws IllegalStateException if the field was previously set to a
-                             *   non-list.
-                             */
-                            fun addSpan(span: JsonValue) = apply {
-                                this.span =
-                                    (this.span ?: JsonField.of(mutableListOf())).also {
-                                        checkKnown("span", it).add(span)
-                                    }
-                            }
-
-                            /** Per-word grounding within the line, when available */
-                            fun words(words: List<Word>?) = words(JsonField.ofNullable(words))
-
-                            /** Alias for calling [Builder.words] with `words.orElse(null)`. */
-                            fun words(words: Optional<List<Word>>) = words(words.getOrNull())
-
-                            /**
-                             * Sets [Builder.words] to an arbitrary JSON value.
-                             *
-                             * You should usually call [Builder.words] with a well-typed
-                             * `List<Word>` value instead. This method is primarily for setting the
-                             * field to an undocumented or not yet supported value.
-                             */
-                            fun words(words: JsonField<List<Word>>) = apply {
-                                this.words = words.map { it.toMutableList() }
-                            }
-
-                            /**
-                             * Adds a single [Word] to [words].
-                             *
-                             * @throws IllegalStateException if the field was previously set to a
-                             *   non-list.
-                             */
-                            fun addWord(word: Word) = apply {
-                                words =
-                                    (words ?: JsonField.of(mutableListOf())).also {
-                                        checkKnown("words", it).add(word)
-                                    }
-                            }
-
-                            fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
-                                apply {
-                                    this.additionalProperties.clear()
-                                    putAllAdditionalProperties(additionalProperties)
-                                }
-
-                            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                                additionalProperties.put(key, value)
-                            }
-
-                            fun putAllAdditionalProperties(
-                                additionalProperties: Map<String, JsonValue>
-                            ) = apply { this.additionalProperties.putAll(additionalProperties) }
-
-                            fun removeAdditionalProperty(key: String) = apply {
-                                additionalProperties.remove(key)
-                            }
-
-                            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                                keys.forEach(::removeAdditionalProperty)
-                            }
-
-                            /**
-                             * Returns an immutable instance of [Line].
-                             *
-                             * Further updates to this [Builder] will not mutate the returned
-                             * instance.
-                             *
-                             * The following fields are required:
-                             * ```java
-                             * .bbox()
-                             * .span()
-                             * ```
-                             *
-                             * @throws IllegalStateException if any required field is unset.
-                             */
-                            fun build(): Line =
-                                Line(
-                                    checkRequired("bbox", bbox),
-                                    checkRequired("span", span).map { it.toImmutable() },
-                                    (words ?: JsonMissing.of()).map { it.toImmutable() },
-                                    additionalProperties.toMutableMap(),
-                                )
-                        }
-
-                        private var validated: Boolean = false
-
-                        /**
-                         * Validates that the types of all values in this object match their
-                         * expected types recursively.
-                         *
-                         * This method is _not_ forwards compatible with new types from the API for
-                         * existing fields.
-                         *
-                         * @throws LlamaCloudInvalidDataException if any value type in this object
-                         *   doesn't match its expected type.
-                         */
-                        fun validate(): Line = apply {
-                            if (validated) {
-                                return@apply
-                            }
-
-                            bbox().validate()
-                            span()
-                            words().ifPresent { it.forEach { it.validate() } }
-                            validated = true
-                        }
-
-                        fun isValid(): Boolean =
-                            try {
-                                validate()
-                                true
-                            } catch (e: LlamaCloudInvalidDataException) {
-                                false
-                            }
-
-                        /**
-                         * Returns a score indicating how many valid values are contained in this
-                         * object recursively.
-                         *
-                         * Used for best match union deserialization.
-                         */
-                        @JvmSynthetic
-                        internal fun validity(): Int =
-                            (bbox.asKnown().getOrNull()?.validity() ?: 0) +
-                                (span.asKnown().getOrNull()?.size ?: 0) +
-                                (words.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
-
-                        /**
-                         * One grounded word: a `[start, end)` span in the source text and its bbox.
-                         */
-                        class Word
-                        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-                        private constructor(
-                            private val bbox: JsonField<BBox>,
-                            private val span: JsonField<List<JsonValue>>,
-                            private val additionalProperties: MutableMap<String, JsonValue>,
-                        ) {
-
-                            @JsonCreator
-                            private constructor(
-                                @JsonProperty("bbox")
-                                @ExcludeMissing
-                                bbox: JsonField<BBox> = JsonMissing.of(),
-                                @JsonProperty("span")
-                                @ExcludeMissing
-                                span: JsonField<List<JsonValue>> = JsonMissing.of(),
-                            ) : this(bbox, span, mutableMapOf())
-
-                            /**
-                             * Word bounding box
-                             *
-                             * @throws LlamaCloudInvalidDataException if the JSON field has an
-                             *   unexpected type or is unexpectedly missing or null (e.g. if the
-                             *   server responded with an unexpected value).
-                             */
-                            fun bbox(): BBox = bbox.getRequired("bbox")
-
-                            /**
-                             * `[start, end)` UTF-8 byte span in the complete source property string
-                             *
-                             * @throws LlamaCloudInvalidDataException if the JSON field has an
-                             *   unexpected type or is unexpectedly missing or null (e.g. if the
-                             *   server responded with an unexpected value).
-                             */
-                            fun span(): List<JsonValue> = span.getRequired("span")
-
-                            /**
-                             * Returns the raw JSON value of [bbox].
-                             *
-                             * Unlike [bbox], this method doesn't throw if the JSON field has an
-                             * unexpected type.
-                             */
-                            @JsonProperty("bbox")
-                            @ExcludeMissing
-                            fun _bbox(): JsonField<BBox> = bbox
-
-                            /**
-                             * Returns the raw JSON value of [span].
-                             *
-                             * Unlike [span], this method doesn't throw if the JSON field has an
-                             * unexpected type.
-                             */
-                            @JsonProperty("span")
-                            @ExcludeMissing
-                            fun _span(): JsonField<List<JsonValue>> = span
-
-                            @JsonAnySetter
-                            private fun putAdditionalProperty(key: String, value: JsonValue) {
-                                additionalProperties.put(key, value)
-                            }
-
-                            @JsonAnyGetter
-                            @ExcludeMissing
-                            fun _additionalProperties(): Map<String, JsonValue> =
-                                Collections.unmodifiableMap(additionalProperties)
-
-                            fun toBuilder() = Builder().from(this)
-
-                            companion object {
-
-                                /**
-                                 * Returns a mutable builder for constructing an instance of [Word].
-                                 *
-                                 * The following fields are required:
-                                 * ```java
-                                 * .bbox()
-                                 * .span()
-                                 * ```
-                                 */
-                                @JvmStatic fun builder() = Builder()
-                            }
-
-                            /** A builder for [Word]. */
-                            class Builder internal constructor() {
-
-                                private var bbox: JsonField<BBox>? = null
-                                private var span: JsonField<MutableList<JsonValue>>? = null
-                                private var additionalProperties: MutableMap<String, JsonValue> =
-                                    mutableMapOf()
-
-                                @JvmSynthetic
-                                internal fun from(word: Word) = apply {
-                                    bbox = word.bbox
-                                    span = word.span.map { it.toMutableList() }
-                                    additionalProperties = word.additionalProperties.toMutableMap()
-                                }
-
-                                /** Word bounding box */
-                                fun bbox(bbox: BBox) = bbox(JsonField.of(bbox))
-
-                                /**
-                                 * Sets [Builder.bbox] to an arbitrary JSON value.
-                                 *
-                                 * You should usually call [Builder.bbox] with a well-typed [BBox]
-                                 * value instead. This method is primarily for setting the field to
-                                 * an undocumented or not yet supported value.
-                                 */
-                                fun bbox(bbox: JsonField<BBox>) = apply { this.bbox = bbox }
-
-                                /**
-                                 * `[start, end)` UTF-8 byte span in the complete source property
-                                 * string
-                                 */
-                                fun span(span: List<JsonValue>) = span(JsonField.of(span))
-
-                                /**
-                                 * Sets [Builder.span] to an arbitrary JSON value.
-                                 *
-                                 * You should usually call [Builder.span] with a well-typed
-                                 * `List<JsonValue>` value instead. This method is primarily for
-                                 * setting the field to an undocumented or not yet supported value.
-                                 */
-                                fun span(span: JsonField<List<JsonValue>>) = apply {
-                                    this.span = span.map { it.toMutableList() }
-                                }
-
-                                /**
-                                 * Adds a single [JsonValue] to [Builder.span].
-                                 *
-                                 * @throws IllegalStateException if the field was previously set to
-                                 *   a non-list.
-                                 */
-                                fun addSpan(span: JsonValue) = apply {
-                                    this.span =
-                                        (this.span ?: JsonField.of(mutableListOf())).also {
-                                            checkKnown("span", it).add(span)
-                                        }
-                                }
-
-                                fun additionalProperties(
-                                    additionalProperties: Map<String, JsonValue>
-                                ) = apply {
-                                    this.additionalProperties.clear()
-                                    putAllAdditionalProperties(additionalProperties)
-                                }
-
-                                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                                    additionalProperties.put(key, value)
-                                }
-
-                                fun putAllAdditionalProperties(
-                                    additionalProperties: Map<String, JsonValue>
-                                ) = apply { this.additionalProperties.putAll(additionalProperties) }
-
-                                fun removeAdditionalProperty(key: String) = apply {
-                                    additionalProperties.remove(key)
-                                }
-
-                                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                                    keys.forEach(::removeAdditionalProperty)
-                                }
-
-                                /**
-                                 * Returns an immutable instance of [Word].
-                                 *
-                                 * Further updates to this [Builder] will not mutate the returned
-                                 * instance.
-                                 *
-                                 * The following fields are required:
-                                 * ```java
-                                 * .bbox()
-                                 * .span()
-                                 * ```
-                                 *
-                                 * @throws IllegalStateException if any required field is unset.
-                                 */
-                                fun build(): Word =
-                                    Word(
-                                        checkRequired("bbox", bbox),
-                                        checkRequired("span", span).map { it.toImmutable() },
-                                        additionalProperties.toMutableMap(),
-                                    )
-                            }
-
-                            private var validated: Boolean = false
-
-                            /**
-                             * Validates that the types of all values in this object match their
-                             * expected types recursively.
-                             *
-                             * This method is _not_ forwards compatible with new types from the API
-                             * for existing fields.
-                             *
-                             * @throws LlamaCloudInvalidDataException if any value type in this
-                             *   object doesn't match its expected type.
-                             */
-                            fun validate(): Word = apply {
-                                if (validated) {
-                                    return@apply
-                                }
-
-                                bbox().validate()
-                                span()
-                                validated = true
-                            }
-
-                            fun isValid(): Boolean =
-                                try {
-                                    validate()
-                                    true
-                                } catch (e: LlamaCloudInvalidDataException) {
-                                    false
-                                }
-
-                            /**
-                             * Returns a score indicating how many valid values are contained in
-                             * this object recursively.
-                             *
-                             * Used for best match union deserialization.
-                             */
-                            @JvmSynthetic
-                            internal fun validity(): Int =
-                                (bbox.asKnown().getOrNull()?.validity() ?: 0) +
-                                    (span.asKnown().getOrNull()?.size ?: 0)
-
-                            override fun equals(other: Any?): Boolean {
-                                if (this === other) {
-                                    return true
-                                }
-
-                                return other is Word &&
-                                    bbox == other.bbox &&
-                                    span == other.span &&
-                                    additionalProperties == other.additionalProperties
-                            }
-
-                            private val hashCode: Int by lazy {
-                                Objects.hash(bbox, span, additionalProperties)
-                            }
-
-                            override fun hashCode(): Int = hashCode
-
-                            override fun toString() =
-                                "Word{bbox=$bbox, span=$span, additionalProperties=$additionalProperties}"
-                        }
-
-                        override fun equals(other: Any?): Boolean {
-                            if (this === other) {
-                                return true
-                            }
-
-                            return other is Line &&
-                                bbox == other.bbox &&
-                                span == other.span &&
-                                words == other.words &&
-                                additionalProperties == other.additionalProperties
-                        }
-
-                        private val hashCode: Int by lazy {
-                            Objects.hash(bbox, span, words, additionalProperties)
-                        }
-
-                        override fun hashCode(): Int = hashCode
-
-                        override fun toString() =
-                            "Line{bbox=$bbox, span=$span, words=$words, additionalProperties=$additionalProperties}"
-                    }
-
-                    override fun equals(other: Any?): Boolean {
-                        if (this === other) {
-                            return true
-                        }
-
-                        return other is Value &&
-                            lines == other.lines &&
-                            additionalProperties == other.additionalProperties
-                    }
-
-                    private val hashCode: Int by lazy { Objects.hash(lines, additionalProperties) }
-
-                    override fun hashCode(): Int = hashCode
-
-                    override fun toString() =
-                        "Value{lines=$lines, additionalProperties=$additionalProperties}"
-                }
-
-                override fun equals(other: Any?): Boolean {
-                    if (this === other) {
-                        return true
-                    }
-
-                    return other is Grounding &&
-                        id == other.id &&
-                        label == other.label &&
-                        value == other.value &&
-                        additionalProperties == other.additionalProperties
-                }
-
-                private val hashCode: Int by lazy {
-                    Objects.hash(id, label, value, additionalProperties)
-                }
-
-                override fun hashCode(): Int = hashCode
-
-                override fun toString() =
-                    "Grounding{id=$id, label=$label, value=$value, additionalProperties=$additionalProperties}"
-            }
-
-            /** Form text node */
-            class Type @JsonCreator private constructor(private val value: JsonField<String>) :
-                Enum {
-
-                /**
-                 * Returns this class instance's raw value.
-                 *
-                 * This is usually only useful if this instance was deserialized from data that
-                 * doesn't match any known member, and you want to know that value. For example, if
-                 * the SDK is on an older version than the API, then the API may respond with new
-                 * members that the SDK is unaware of.
-                 */
-                @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
-
-                companion object {
-
-                    @JvmField val TEXT = of("text")
-
-                    @JvmStatic fun of(value: String) = Type(JsonField.of(value))
-                }
-
-                /** An enum containing [Type]'s known values. */
-                enum class Known {
-                    TEXT
-                }
-
-                /**
-                 * An enum containing [Type]'s known values, as well as an [_UNKNOWN] member.
-                 *
-                 * An instance of [Type] can contain an unknown value in a couple of cases:
-                 * - It was deserialized from data that doesn't match any known member. For example,
-                 *   if the SDK is on an older version than the API, then the API may respond with
-                 *   new members that the SDK is unaware of.
-                 * - It was constructed with an arbitrary value using the [of] method.
-                 */
-                enum class Value {
-                    TEXT,
-                    /**
-                     * An enum member indicating that [Type] was instantiated with an unknown value.
-                     */
-                    _UNKNOWN,
-                }
-
-                /**
-                 * Returns an enum member corresponding to this class instance's value, or
-                 * [Value._UNKNOWN] if the class was instantiated with an unknown value.
-                 *
-                 * Use the [known] method instead if you're certain the value is always known or if
-                 * you want to throw for the unknown case.
-                 */
-                fun value(): Value =
-                    when (this) {
-                        TEXT -> Value.TEXT
-                        else -> Value._UNKNOWN
-                    }
-
-                /**
-                 * Returns an enum member corresponding to this class instance's value.
-                 *
-                 * Use the [value] method instead if you're uncertain the value is always known and
-                 * don't want to throw for the unknown case.
-                 *
-                 * @throws LlamaCloudInvalidDataException if this class instance's value is a not a
-                 *   known member.
-                 */
-                fun known(): Known =
-                    when (this) {
-                        TEXT -> Known.TEXT
-                        else -> throw LlamaCloudInvalidDataException("Unknown Type: $value")
-                    }
-
-                /**
-                 * Returns this class instance's primitive wire representation.
-                 *
-                 * This differs from the [toString] method because that method is primarily for
-                 * debugging and generally doesn't throw.
-                 *
-                 * @throws LlamaCloudInvalidDataException if this class instance's value does not
-                 *   have the expected primitive type.
-                 */
-                fun asString(): String =
-                    _value().asString().orElseThrow {
-                        LlamaCloudInvalidDataException("Value is not a String")
-                    }
-
-                private var validated: Boolean = false
-
-                /**
-                 * Validates that the types of all values in this object match their expected types
-                 * recursively.
-                 *
-                 * This method is _not_ forwards compatible with new types from the API for existing
-                 * fields.
-                 *
-                 * @throws LlamaCloudInvalidDataException if any value type in this object doesn't
-                 *   match its expected type.
-                 */
-                fun validate(): Type = apply {
-                    if (validated) {
-                        return@apply
-                    }
-
-                    known()
-                    validated = true
-                }
-
-                fun isValid(): Boolean =
-                    try {
-                        validate()
-                        true
-                    } catch (e: LlamaCloudInvalidDataException) {
-                        false
-                    }
-
-                /**
-                 * Returns a score indicating how many valid values are contained in this object
-                 * recursively.
-                 *
-                 * Used for best match union deserialization.
-                 */
-                @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
-
-                override fun equals(other: Any?): Boolean {
-                    if (this === other) {
-                        return true
-                    }
-
-                    return other is Type && value == other.value
-                }
-
-                override fun hashCode() = value.hashCode()
-
-                override fun toString() = value.toString()
-            }
-
-            override fun equals(other: Any?): Boolean {
-                if (this === other) {
-                    return true
-                }
-
-                return other is Text &&
-                    value == other.value &&
-                    bbox == other.bbox &&
-                    grounding == other.grounding &&
-                    type == other.type &&
-                    additionalProperties == other.additionalProperties
-            }
-
-            private val hashCode: Int by lazy {
-                Objects.hash(value, bbox, grounding, type, additionalProperties)
-            }
-
-            override fun hashCode(): Int = hashCode
-
-            override fun toString() =
-                "Text{value=$value, bbox=$bbox, grounding=$grounding, type=$type, additionalProperties=$additionalProperties}"
-        }
     }
 
     /** Optional grounding for printed identifiers and headings. */
diff --git a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/FormTableCellItems.kt b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/FormTableCellItems.kt
index 94621b9..91c034b 100644
--- a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/FormTableCellItems.kt
+++ b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/FormTableCellItems.kt
@@ -4,7 +4,6 @@ package ai.llamaindex.llamacloud.models.parsing
 
 import ai.llamaindex.llamacloud.core.BaseDeserializer
 import ai.llamaindex.llamacloud.core.BaseSerializer
-import ai.llamaindex.llamacloud.core.Enum
 import ai.llamaindex.llamacloud.core.ExcludeMissing
 import ai.llamaindex.llamacloud.core.JsonField
 import ai.llamaindex.llamacloud.core.JsonMissing
@@ -165,24 +164,19 @@ private constructor(
             addItem(FormTable.builder().type(FormTable.Type.TABLE).rows(rows).build())
 
         /** Alias for calling [addItem] with `Item.ofText(text)`. */
-        fun addItem(text: Item.Text) = addItem(Item.ofText(text))
+        fun addItem(text: FormText) = addItem(Item.ofText(text))
 
         /**
          * Alias for calling [addItem] with the following:
          * ```java
-         * Item.Text.builder()
-         *     .type(FormTableCellItems.Item.Text.Type.TEXT)
+         * FormText.builder()
+         *     .type(FormText.Type.TEXT)
          *     .value(value)
          *     .build()
          * ```
          */
         fun addTextItem(value: String) =
-            addItem(
-                Item.Text.builder()
-                    .type(FormTableCellItems.Item.Text.Type.TEXT)
-                    .value(value)
-                    .build()
-            )
+            addItem(FormText.builder().type(FormText.Type.TEXT).value(value).build())
 
         fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
             this.additionalProperties.clear()
@@ -266,7 +260,7 @@ private constructor(
         private val field: FormField? = null,
         private val section: FormSection? = null,
         private val table: FormTable? = null,
-        private val text: Text? = null,
+        private val text: FormText? = null,
         private val _json: JsonValue? = null,
     ) {
 
@@ -283,7 +277,7 @@ private constructor(
          * Printed text that is not part of a field, section heading or table: a title, an
          * instruction, a note. With it the form JSON holds every printed word of its region.
          */
-        fun text(): Optional<Text> = Optional.ofNullable(text)
+        fun text(): Optional<FormText> = Optional.ofNullable(text)
 
         fun isField(): Boolean = field != null
 
@@ -306,7 +300,7 @@ private constructor(
          * Printed text that is not part of a field, section heading or table: a title, an
          * instruction, a note. With it the form JSON holds every printed word of its region.
          */
-        fun asText(): Text = text.getOrThrow("text")
+        fun asText(): FormText = text.getOrThrow("text")
 
         fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
 
@@ -378,7 +372,7 @@ private constructor(
                         table.validate()
                     }
 
-                    override fun visitText(text: Text) {
+                    override fun visitText(text: FormText) {
                         text.validate()
                     }
                 }
@@ -410,7 +404,7 @@ private constructor(
 
                     override fun visitTable(table: FormTable) = table.validity()
 
-                    override fun visitText(text: Text) = text.validity()
+                    override fun visitText(text: FormText) = text.validity()
 
                     override fun unknown(json: JsonValue?) = 0
                 }
@@ -455,7 +449,7 @@ private constructor(
              * Printed text that is not part of a field, section heading or table: a title, an
              * instruction, a note. With it the form JSON holds every printed word of its region.
              */
-            @JvmStatic fun ofText(text: Text) = Item(text = text)
+            @JvmStatic fun ofText(text: FormText) = Item(text = text)
         }
 
         /** An interface that defines how to map each variant of [Item] to a value of type [T]. */
@@ -474,7 +468,7 @@ private constructor(
              * Printed text that is not part of a field, section heading or table: a title, an
              * instruction, a note. With it the form JSON holds every printed word of its region.
              */
-            fun visitText(text: Text): T
+            fun visitText(text: FormText): T
 
             /**
              * Maps an unknown variant of [Item] to a value of type [T].
@@ -513,7 +507,7 @@ private constructor(
                         } ?: Item(_json = json)
                     }
                     "text" -> {
-                        return tryDeserialize(node, jacksonTypeRef<Text>())?.let {
+                        return tryDeserialize(node, jacksonTypeRef<FormText>())?.let {
                             Item(text = it, _json = json)
                         } ?: Item(_json = json)
                     }
@@ -540,2972 +534,6 @@ private constructor(
                 }
             }
         }
-
-        /**
-         * Printed text that is not part of a field, section heading or table: a title, an
-         * instruction, a note. With it the form JSON holds every printed word of its region.
-         */
-        class Text
-        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-        private constructor(
-            private val value: JsonField<String>,
-            private val bbox: JsonField<List<BBox>>,
-            private val grounding: JsonField<Grounding>,
-            private val type: JsonField<Type>,
-            private val additionalProperties: MutableMap<String, JsonValue>,
-        ) {
-
-            @JsonCreator
-            private constructor(
-                @JsonProperty("value") @ExcludeMissing value: JsonField<String> = JsonMissing.of(),
-                @JsonProperty("bbox")
-                @ExcludeMissing
-                bbox: JsonField<List<BBox>> = JsonMissing.of(),
-                @JsonProperty("grounding")
-                @ExcludeMissing
-                grounding: JsonField<Grounding> = JsonMissing.of(),
-                @JsonProperty("type") @ExcludeMissing type: JsonField<Type> = JsonMissing.of(),
-            ) : this(value, bbox, grounding, type, mutableMapOf())
-
-            /**
-             * The printed text, verbatim
-             *
-             * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type or is
-             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
-             *   value).
-             */
-            fun value(): String = value.getRequired("value")
-
-            /**
-             * Bounding boxes of the text on the page, if attributed.
-             *
-             * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g.
-             *   if the server responded with an unexpected value).
-             */
-            fun bbox(): Optional<List<BBox>> = bbox.getOptional("bbox")
-
-            /**
-             * Optional grounding for a field's printed text; boolean states have no text spans.
-             *
-             * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g.
-             *   if the server responded with an unexpected value).
-             */
-            fun grounding(): Optional<Grounding> = grounding.getOptional("grounding")
-
-            /**
-             * Form text node
-             *
-             * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g.
-             *   if the server responded with an unexpected value).
-             */
-            fun type(): Optional<Type> = type.getOptional("type")
-
-            /**
-             * Returns the raw JSON value of [value].
-             *
-             * Unlike [value], this method doesn't throw if the JSON field has an unexpected type.
-             */
-            @JsonProperty("value") @ExcludeMissing fun _value(): JsonField<String> = value
-
-            /**
-             * Returns the raw JSON value of [bbox].
-             *
-             * Unlike [bbox], this method doesn't throw if the JSON field has an unexpected type.
-             */
-            @JsonProperty("bbox") @ExcludeMissing fun _bbox(): JsonField<List<BBox>> = bbox
-
-            /**
-             * Returns the raw JSON value of [grounding].
-             *
-             * Unlike [grounding], this method doesn't throw if the JSON field has an unexpected
-             * type.
-             */
-            @JsonProperty("grounding")
-            @ExcludeMissing
-            fun _grounding(): JsonField<Grounding> = grounding
-
-            /**
-             * Returns the raw JSON value of [type].
-             *
-             * Unlike [type], this method doesn't throw if the JSON field has an unexpected type.
-             */
-            @JsonProperty("type") @ExcludeMissing fun _type(): JsonField<Type> = type
-
-            @JsonAnySetter
-            private fun putAdditionalProperty(key: String, value: JsonValue) {
-                additionalProperties.put(key, value)
-            }
-
-            @JsonAnyGetter
-            @ExcludeMissing
-            fun _additionalProperties(): Map<String, JsonValue> =
-                Collections.unmodifiableMap(additionalProperties)
-
-            fun toBuilder() = Builder().from(this)
-
-            companion object {
-
-                /**
-                 * Returns a mutable builder for constructing an instance of [Text].
-                 *
-                 * The following fields are required:
-                 * ```java
-                 * .value()
-                 * ```
-                 */
-                @JvmStatic fun builder() = Builder()
-            }
-
-            /** A builder for [Text]. */
-            class Builder internal constructor() {
-
-                private var value: JsonField<String>? = null
-                private var bbox: JsonField<MutableList<BBox>>? = null
-                private var grounding: JsonField<Grounding> = JsonMissing.of()
-                private var type: JsonField<Type> = JsonMissing.of()
-                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
-
-                @JvmSynthetic
-                internal fun from(text: Text) = apply {
-                    value = text.value
-                    bbox = text.bbox.map { it.toMutableList() }
-                    grounding = text.grounding
-                    type = text.type
-                    additionalProperties = text.additionalProperties.toMutableMap()
-                }
-
-                /** The printed text, verbatim */
-                fun value(value: String) = value(JsonField.of(value))
-
-                /**
-                 * Sets [Builder.value] to an arbitrary JSON value.
-                 *
-                 * You should usually call [Builder.value] with a well-typed [String] value instead.
-                 * This method is primarily for setting the field to an undocumented or not yet
-                 * supported value.
-                 */
-                fun value(value: JsonField<String>) = apply { this.value = value }
-
-                /** Bounding boxes of the text on the page, if attributed. */
-                fun bbox(bbox: List<BBox>?) = bbox(JsonField.ofNullable(bbox))
-
-                /** Alias for calling [Builder.bbox] with `bbox.orElse(null)`. */
-                fun bbox(bbox: Optional<List<BBox>>) = bbox(bbox.getOrNull())
-
-                /**
-                 * Sets [Builder.bbox] to an arbitrary JSON value.
-                 *
-                 * You should usually call [Builder.bbox] with a well-typed `List<BBox>` value
-                 * instead. This method is primarily for setting the field to an undocumented or not
-                 * yet supported value.
-                 */
-                fun bbox(bbox: JsonField<List<BBox>>) = apply {
-                    this.bbox = bbox.map { it.toMutableList() }
-                }
-
-                /**
-                 * Adds a single [BBox] to [Builder.bbox].
-                 *
-                 * @throws IllegalStateException if the field was previously set to a non-list.
-                 */
-                fun addBbox(bbox: BBox) = apply {
-                    this.bbox =
-                        (this.bbox ?: JsonField.of(mutableListOf())).also {
-                            checkKnown("bbox", it).add(bbox)
-                        }
-                }
-
-                /**
-                 * Optional grounding for a field's printed text; boolean states have no text spans.
-                 */
-                fun grounding(grounding: Grounding?) = grounding(JsonField.ofNullable(grounding))
-
-                /** Alias for calling [Builder.grounding] with `grounding.orElse(null)`. */
-                fun grounding(grounding: Optional<Grounding>) = grounding(grounding.getOrNull())
-
-                /**
-                 * Sets [Builder.grounding] to an arbitrary JSON value.
-                 *
-                 * You should usually call [Builder.grounding] with a well-typed [Grounding] value
-                 * instead. This method is primarily for setting the field to an undocumented or not
-                 * yet supported value.
-                 */
-                fun grounding(grounding: JsonField<Grounding>) = apply {
-                    this.grounding = grounding
-                }
-
-                /** Form text node */
-                fun type(type: Type) = type(JsonField.of(type))
-
-                /**
-                 * Sets [Builder.type] to an arbitrary JSON value.
-                 *
-                 * You should usually call [Builder.type] with a well-typed [Type] value instead.
-                 * This method is primarily for setting the field to an undocumented or not yet
-                 * supported value.
-                 */
-                fun type(type: JsonField<Type>) = apply { this.type = type }
-
-                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
-                    this.additionalProperties.clear()
-                    putAllAdditionalProperties(additionalProperties)
-                }
-
-                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                    additionalProperties.put(key, value)
-                }
-
-                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
-                    apply {
-                        this.additionalProperties.putAll(additionalProperties)
-                    }
-
-                fun removeAdditionalProperty(key: String) = apply {
-                    additionalProperties.remove(key)
-                }
-
-                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                    keys.forEach(::removeAdditionalProperty)
-                }
-
-                /**
-                 * Returns an immutable instance of [Text].
-                 *
-                 * Further updates to this [Builder] will not mutate the returned instance.
-                 *
-                 * The following fields are required:
-                 * ```java
-                 * .value()
-                 * ```
-                 *
-                 * @throws IllegalStateException if any required field is unset.
-                 */
-                fun build(): Text =
-                    Text(
-                        checkRequired("value", value),
-                        (bbox ?: JsonMissing.of()).map { it.toImmutable() },
-                        grounding,
-                        type,
-                        additionalProperties.toMutableMap(),
-                    )
-            }
-
-            private var validated: Boolean = false
-
-            /**
-             * Validates that the types of all values in this object match their expected types
-             * recursively.
-             *
-             * This method is _not_ forwards compatible with new types from the API for existing
-             * fields.
-             *
-             * @throws LlamaCloudInvalidDataException if any value type in this object doesn't match
-             *   its expected type.
-             */
-            fun validate(): Text = apply {
-                if (validated) {
-                    return@apply
-                }
-
-                value()
-                bbox().ifPresent { it.forEach { it.validate() } }
-                grounding().ifPresent { it.validate() }
-                type().ifPresent { it.validate() }
-                validated = true
-            }
-
-            fun isValid(): Boolean =
-                try {
-                    validate()
-                    true
-                } catch (e: LlamaCloudInvalidDataException) {
-                    false
-                }
-
-            /**
-             * Returns a score indicating how many valid values are contained in this object
-             * recursively.
-             *
-             * Used for best match union deserialization.
-             */
-            @JvmSynthetic
-            internal fun validity(): Int =
-                (if (value.asKnown().isPresent) 1 else 0) +
-                    (bbox.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
-                    (grounding.asKnown().getOrNull()?.validity() ?: 0) +
-                    (type.asKnown().getOrNull()?.validity() ?: 0)
-
-            /** Optional grounding for a field's printed text; boolean states have no text spans. */
-            class Grounding
-            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-            private constructor(
-                private val id: JsonField<Id>,
-                private val label: JsonField<Label>,
-                private val value: JsonField<Value>,
-                private val additionalProperties: MutableMap<String, JsonValue>,
-            ) {
-
-                @JsonCreator
-                private constructor(
-                    @JsonProperty("id") @ExcludeMissing id: JsonField<Id> = JsonMissing.of(),
-                    @JsonProperty("label")
-                    @ExcludeMissing
-                    label: JsonField<Label> = JsonMissing.of(),
-                    @JsonProperty("value")
-                    @ExcludeMissing
-                    value: JsonField<Value> = JsonMissing.of(),
-                ) : this(id, label, value, mutableMapOf())
-
-                /**
-                 * Supported text with half-open UTF-8 byte spans into the complete property string.
-                 *
-                 * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type
-                 *   (e.g. if the server responded with an unexpected value).
-                 */
-                fun id(): Optional<Id> = id.getOptional("id")
-
-                /**
-                 * Supported text with half-open UTF-8 byte spans into the complete property string.
-                 *
-                 * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type
-                 *   (e.g. if the server responded with an unexpected value).
-                 */
-                fun label(): Optional<Label> = label.getOptional("label")
-
-                /**
-                 * Supported text with half-open UTF-8 byte spans into the complete property string.
-                 *
-                 * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type
-                 *   (e.g. if the server responded with an unexpected value).
-                 */
-                fun value(): Optional<Value> = value.getOptional("value")
-
-                /**
-                 * Returns the raw JSON value of [id].
-                 *
-                 * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
-                 */
-                @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<Id> = id
-
-                /**
-                 * Returns the raw JSON value of [label].
-                 *
-                 * Unlike [label], this method doesn't throw if the JSON field has an unexpected
-                 * type.
-                 */
-                @JsonProperty("label") @ExcludeMissing fun _label(): JsonField<Label> = label
-
-                /**
-                 * Returns the raw JSON value of [value].
-                 *
-                 * Unlike [value], this method doesn't throw if the JSON field has an unexpected
-                 * type.
-                 */
-                @JsonProperty("value") @ExcludeMissing fun _value(): JsonField<Value> = value
-
-                @JsonAnySetter
-                private fun putAdditionalProperty(key: String, value: JsonValue) {
-                    additionalProperties.put(key, value)
-                }
-
-                @JsonAnyGetter
-                @ExcludeMissing
-                fun _additionalProperties(): Map<String, JsonValue> =
-                    Collections.unmodifiableMap(additionalProperties)
-
-                fun toBuilder() = Builder().from(this)
-
-                companion object {
-
-                    /** Returns a mutable builder for constructing an instance of [Grounding]. */
-                    @JvmStatic fun builder() = Builder()
-                }
-
-                /** A builder for [Grounding]. */
-                class Builder internal constructor() {
-
-                    private var id: JsonField<Id> = JsonMissing.of()
-                    private var label: JsonField<Label> = JsonMissing.of()
-                    private var value: JsonField<Value> = JsonMissing.of()
-                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
-
-                    @JvmSynthetic
-                    internal fun from(grounding: Grounding) = apply {
-                        id = grounding.id
-                        label = grounding.label
-                        value = grounding.value
-                        additionalProperties = grounding.additionalProperties.toMutableMap()
-                    }
-
-                    /**
-                     * Supported text with half-open UTF-8 byte spans into the complete property
-                     * string.
-                     */
-                    fun id(id: Id?) = id(JsonField.ofNullable(id))
-
-                    /** Alias for calling [Builder.id] with `id.orElse(null)`. */
-                    fun id(id: Optional<Id>) = id(id.getOrNull())
-
-                    /**
-                     * Sets [Builder.id] to an arbitrary JSON value.
-                     *
-                     * You should usually call [Builder.id] with a well-typed [Id] value instead.
-                     * This method is primarily for setting the field to an undocumented or not yet
-                     * supported value.
-                     */
-                    fun id(id: JsonField<Id>) = apply { this.id = id }
-
-                    /**
-                     * Supported text with half-open UTF-8 byte spans into the complete property
-                     * string.
-                     */
-                    fun label(label: Label?) = label(JsonField.ofNullable(label))
-
-                    /** Alias for calling [Builder.label] with `label.orElse(null)`. */
-                    fun label(label: Optional<Label>) = label(label.getOrNull())
-
-                    /**
-                     * Sets [Builder.label] to an arbitrary JSON value.
-                     *
-                     * You should usually call [Builder.label] with a well-typed [Label] value
-                     * instead. This method is primarily for setting the field to an undocumented or
-                     * not yet supported value.
-                     */
-                    fun label(label: JsonField<Label>) = apply { this.label = label }
-
-                    /**
-                     * Supported text with half-open UTF-8 byte spans into the complete property
-                     * string.
-                     */
-                    fun value(value: Value?) = value(JsonField.ofNullable(value))
-
-                    /** Alias for calling [Builder.value] with `value.orElse(null)`. */
-                    fun value(value: Optional<Value>) = value(value.getOrNull())
-
-                    /**
-                     * Sets [Builder.value] to an arbitrary JSON value.
-                     *
-                     * You should usually call [Builder.value] with a well-typed [Value] value
-                     * instead. This method is primarily for setting the field to an undocumented or
-                     * not yet supported value.
-                     */
-                    fun value(value: JsonField<Value>) = apply { this.value = value }
-
-                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
-                        this.additionalProperties.clear()
-                        putAllAdditionalProperties(additionalProperties)
-                    }
-
-                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                        additionalProperties.put(key, value)
-                    }
-
-                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
-                        apply {
-                            this.additionalProperties.putAll(additionalProperties)
-                        }
-
-                    fun removeAdditionalProperty(key: String) = apply {
-                        additionalProperties.remove(key)
-                    }
-
-                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                        keys.forEach(::removeAdditionalProperty)
-                    }
-
-                    /**
-                     * Returns an immutable instance of [Grounding].
-                     *
-                     * Further updates to this [Builder] will not mutate the returned instance.
-                     */
-                    fun build(): Grounding =
-                        Grounding(id, label, value, additionalProperties.toMutableMap())
-                }
-
-                private var validated: Boolean = false
-
-                /**
-                 * Validates that the types of all values in this object match their expected types
-                 * recursively.
-                 *
-                 * This method is _not_ forwards compatible with new types from the API for existing
-                 * fields.
-                 *
-                 * @throws LlamaCloudInvalidDataException if any value type in this object doesn't
-                 *   match its expected type.
-                 */
-                fun validate(): Grounding = apply {
-                    if (validated) {
-                        return@apply
-                    }
-
-                    id().ifPresent { it.validate() }
-                    label().ifPresent { it.validate() }
-                    value().ifPresent { it.validate() }
-                    validated = true
-                }
-
-                fun isValid(): Boolean =
-                    try {
-                        validate()
-                        true
-                    } catch (e: LlamaCloudInvalidDataException) {
-                        false
-                    }
-
-                /**
-                 * Returns a score indicating how many valid values are contained in this object
-                 * recursively.
-                 *
-                 * Used for best match union deserialization.
-                 */
-                @JvmSynthetic
-                internal fun validity(): Int =
-                    (id.asKnown().getOrNull()?.validity() ?: 0) +
-                        (label.asKnown().getOrNull()?.validity() ?: 0) +
-                        (value.asKnown().getOrNull()?.validity() ?: 0)
-
-                /**
-                 * Supported text with half-open UTF-8 byte spans into the complete property string.
-                 */
-                class Id
-                @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-                private constructor(
-                    private val lines: JsonField<List<Line>>,
-                    private val additionalProperties: MutableMap<String, JsonValue>,
-                ) {
-
-                    @JsonCreator
-                    private constructor(
-                        @JsonProperty("lines")
-                        @ExcludeMissing
-                        lines: JsonField<List<Line>> = JsonMissing.of()
-                    ) : this(lines, mutableMapOf())
-
-                    /**
-                     * Supported lines. Word requests include supported words; gaps are valid. Boxes
-                     * use final page coordinates and optional local rotation r.
-                     *
-                     * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected
-                     *   type or is unexpectedly missing or null (e.g. if the server responded with
-                     *   an unexpected value).
-                     */
-                    fun lines(): List<Line> = lines.getRequired("lines")
-
-                    /**
-                     * Returns the raw JSON value of [lines].
-                     *
-                     * Unlike [lines], this method doesn't throw if the JSON field has an unexpected
-                     * type.
-                     */
-                    @JsonProperty("lines")
-                    @ExcludeMissing
-                    fun _lines(): JsonField<List<Line>> = lines
-
-                    @JsonAnySetter
-                    private fun putAdditionalProperty(key: String, value: JsonValue) {
-                        additionalProperties.put(key, value)
-                    }
-
-                    @JsonAnyGetter
-                    @ExcludeMissing
-                    fun _additionalProperties(): Map<String, JsonValue> =
-                        Collections.unmodifiableMap(additionalProperties)
-
-                    fun toBuilder() = Builder().from(this)
-
-                    companion object {
-
-                        /**
-                         * Returns a mutable builder for constructing an instance of [Id].
-                         *
-                         * The following fields are required:
-                         * ```java
-                         * .lines()
-                         * ```
-                         */
-                        @JvmStatic fun builder() = Builder()
-                    }
-
-                    /** A builder for [Id]. */
-                    class Builder internal constructor() {
-
-                        private var lines: JsonField<MutableList<Line>>? = null
-                        private var additionalProperties: MutableMap<String, JsonValue> =
-                            mutableMapOf()
-
-                        @JvmSynthetic
-                        internal fun from(id: Id) = apply {
-                            lines = id.lines.map { it.toMutableList() }
-                            additionalProperties = id.additionalProperties.toMutableMap()
-                        }
-
-                        /**
-                         * Supported lines. Word requests include supported words; gaps are valid.
-                         * Boxes use final page coordinates and optional local rotation r.
-                         */
-                        fun lines(lines: List<Line>) = lines(JsonField.of(lines))
-
-                        /**
-                         * Sets [Builder.lines] to an arbitrary JSON value.
-                         *
-                         * You should usually call [Builder.lines] with a well-typed `List<Line>`
-                         * value instead. This method is primarily for setting the field to an
-                         * undocumented or not yet supported value.
-                         */
-                        fun lines(lines: JsonField<List<Line>>) = apply {
-                            this.lines = lines.map { it.toMutableList() }
-                        }
-
-                        /**
-                         * Adds a single [Line] to [lines].
-                         *
-                         * @throws IllegalStateException if the field was previously set to a
-                         *   non-list.
-                         */
-                        fun addLine(line: Line) = apply {
-                            lines =
-                                (lines ?: JsonField.of(mutableListOf())).also {
-                                    checkKnown("lines", it).add(line)
-                                }
-                        }
-
-                        fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
-                            apply {
-                                this.additionalProperties.clear()
-                                putAllAdditionalProperties(additionalProperties)
-                            }
-
-                        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                            additionalProperties.put(key, value)
-                        }
-
-                        fun putAllAdditionalProperties(
-                            additionalProperties: Map<String, JsonValue>
-                        ) = apply { this.additionalProperties.putAll(additionalProperties) }
-
-                        fun removeAdditionalProperty(key: String) = apply {
-                            additionalProperties.remove(key)
-                        }
-
-                        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                            keys.forEach(::removeAdditionalProperty)
-                        }
-
-                        /**
-                         * Returns an immutable instance of [Id].
-                         *
-                         * Further updates to this [Builder] will not mutate the returned instance.
-                         *
-                         * The following fields are required:
-                         * ```java
-                         * .lines()
-                         * ```
-                         *
-                         * @throws IllegalStateException if any required field is unset.
-                         */
-                        fun build(): Id =
-                            Id(
-                                checkRequired("lines", lines).map { it.toImmutable() },
-                                additionalProperties.toMutableMap(),
-                            )
-                    }
-
-                    private var validated: Boolean = false
-
-                    /**
-                     * Validates that the types of all values in this object match their expected
-                     * types recursively.
-                     *
-                     * This method is _not_ forwards compatible with new types from the API for
-                     * existing fields.
-                     *
-                     * @throws LlamaCloudInvalidDataException if any value type in this object
-                     *   doesn't match its expected type.
-                     */
-                    fun validate(): Id = apply {
-                        if (validated) {
-                            return@apply
-                        }
-
-                        lines().forEach { it.validate() }
-                        validated = true
-                    }
-
-                    fun isValid(): Boolean =
-                        try {
-                            validate()
-                            true
-                        } catch (e: LlamaCloudInvalidDataException) {
-                            false
-                        }
-
-                    /**
-                     * Returns a score indicating how many valid values are contained in this object
-                     * recursively.
-                     *
-                     * Used for best match union deserialization.
-                     */
-                    @JvmSynthetic
-                    internal fun validity(): Int =
-                        (lines.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
-
-                    /** One grounded line of text with an optional per-word breakdown. */
-                    class Line
-                    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-                    private constructor(
-                        private val bbox: JsonField<BBox>,
-                        private val span: JsonField<List<JsonValue>>,
-                        private val words: JsonField<List<Word>>,
-                        private val additionalProperties: MutableMap<String, JsonValue>,
-                    ) {
-
-                        @JsonCreator
-                        private constructor(
-                            @JsonProperty("bbox")
-                            @ExcludeMissing
-                            bbox: JsonField<BBox> = JsonMissing.of(),
-                            @JsonProperty("span")
-                            @ExcludeMissing
-                            span: JsonField<List<JsonValue>> = JsonMissing.of(),
-                            @JsonProperty("words")
-                            @ExcludeMissing
-                            words: JsonField<List<Word>> = JsonMissing.of(),
-                        ) : this(bbox, span, words, mutableMapOf())
-
-                        /**
-                         * Line bounding box
-                         *
-                         * @throws LlamaCloudInvalidDataException if the JSON field has an
-                         *   unexpected type or is unexpectedly missing or null (e.g. if the server
-                         *   responded with an unexpected value).
-                         */
-                        fun bbox(): BBox = bbox.getRequired("bbox")
-
-                        /**
-                         * `[start, end)` UTF-8 byte span in the complete source property string
-                         *
-                         * @throws LlamaCloudInvalidDataException if the JSON field has an
-                         *   unexpected type or is unexpectedly missing or null (e.g. if the server
-                         *   responded with an unexpected value).
-                         */
-                        fun span(): List<JsonValue> = span.getRequired("span")
-
-                        /**
-                         * Per-word grounding within the line, when available
-                         *
-                         * @throws LlamaCloudInvalidDataException if the JSON field has an
-                         *   unexpected type (e.g. if the server responded with an unexpected
-                         *   value).
-                         */
-                        fun words(): Optional<List<Word>> = words.getOptional("words")
-
-                        /**
-                         * Returns the raw JSON value of [bbox].
-                         *
-                         * Unlike [bbox], this method doesn't throw if the JSON field has an
-                         * unexpected type.
-                         */
-                        @JsonProperty("bbox") @ExcludeMissing fun _bbox(): JsonField<BBox> = bbox
-
-                        /**
-                         * Returns the raw JSON value of [span].
-                         *
-                         * Unlike [span], this method doesn't throw if the JSON field has an
-                         * unexpected type.
-                         */
-                        @JsonProperty("span")
-                        @ExcludeMissing
-                        fun _span(): JsonField<List<JsonValue>> = span
-
-                        /**
-                         * Returns the raw JSON value of [words].
-                         *
-                         * Unlike [words], this method doesn't throw if the JSON field has an
-                         * unexpected type.
-                         */
-                        @JsonProperty("words")
-                        @ExcludeMissing
-                        fun _words(): JsonField<List<Word>> = words
-
-                        @JsonAnySetter
-                        private fun putAdditionalProperty(key: String, value: JsonValue) {
-                            additionalProperties.put(key, value)
-                        }
-
-                        @JsonAnyGetter
-                        @ExcludeMissing
-                        fun _additionalProperties(): Map<String, JsonValue> =
-                            Collections.unmodifiableMap(additionalProperties)
-
-                        fun toBuilder() = Builder().from(this)
-
-                        companion object {
-
-                            /**
-                             * Returns a mutable builder for constructing an instance of [Line].
-                             *
-                             * The following fields are required:
-                             * ```java
-                             * .bbox()
-                             * .span()
-                             * ```
-                             */
-                            @JvmStatic fun builder() = Builder()
-                        }
-
-                        /** A builder for [Line]. */
-                        class Builder internal constructor() {
-
-                            private var bbox: JsonField<BBox>? = null
-                            private var span: JsonField<MutableList<JsonValue>>? = null
-                            private var words: JsonField<MutableList<Word>>? = null
-                            private var additionalProperties: MutableMap<String, JsonValue> =
-                                mutableMapOf()
-
-                            @JvmSynthetic
-                            internal fun from(line: Line) = apply {
-                                bbox = line.bbox
-                                span = line.span.map { it.toMutableList() }
-                                words = line.words.map { it.toMutableList() }
-                                additionalProperties = line.additionalProperties.toMutableMap()
-                            }
-
-                            /** Line bounding box */
-                            fun bbox(bbox: BBox) = bbox(JsonField.of(bbox))
-
-                            /**
-                             * Sets [Builder.bbox] to an arbitrary JSON value.
-                             *
-                             * You should usually call [Builder.bbox] with a well-typed [BBox] value
-                             * instead. This method is primarily for setting the field to an
-                             * undocumented or not yet supported value.
-                             */
-                            fun bbox(bbox: JsonField<BBox>) = apply { this.bbox = bbox }
-
-                            /**
-                             * `[start, end)` UTF-8 byte span in the complete source property string
-                             */
-                            fun span(span: List<JsonValue>) = span(JsonField.of(span))
-
-                            /**
-                             * Sets [Builder.span] to an arbitrary JSON value.
-                             *
-                             * You should usually call [Builder.span] with a well-typed
-                             * `List<JsonValue>` value instead. This method is primarily for setting
-                             * the field to an undocumented or not yet supported value.
-                             */
-                            fun span(span: JsonField<List<JsonValue>>) = apply {
-                                this.span = span.map { it.toMutableList() }
-                            }
-
-                            /**
-                             * Adds a single [JsonValue] to [Builder.span].
-                             *
-                             * @throws IllegalStateException if the field was previously set to a
-                             *   non-list.
-                             */
-                            fun addSpan(span: JsonValue) = apply {
-                                this.span =
-                                    (this.span ?: JsonField.of(mutableListOf())).also {
-                                        checkKnown("span", it).add(span)
-                                    }
-                            }
-
-                            /** Per-word grounding within the line, when available */
-                            fun words(words: List<Word>?) = words(JsonField.ofNullable(words))
-
-                            /** Alias for calling [Builder.words] with `words.orElse(null)`. */
-                            fun words(words: Optional<List<Word>>) = words(words.getOrNull())
-
-                            /**
-                             * Sets [Builder.words] to an arbitrary JSON value.
-                             *
-                             * You should usually call [Builder.words] with a well-typed
-                             * `List<Word>` value instead. This method is primarily for setting the
-                             * field to an undocumented or not yet supported value.
-                             */
-                            fun words(words: JsonField<List<Word>>) = apply {
-                                this.words = words.map { it.toMutableList() }
-                            }
-
-                            /**
-                             * Adds a single [Word] to [words].
-                             *
-                             * @throws IllegalStateException if the field was previously set to a
-                             *   non-list.
-                             */
-                            fun addWord(word: Word) = apply {
-                                words =
-                                    (words ?: JsonField.of(mutableListOf())).also {
-                                        checkKnown("words", it).add(word)
-                                    }
-                            }
-
-                            fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
-                                apply {
-                                    this.additionalProperties.clear()
-                                    putAllAdditionalProperties(additionalProperties)
-                                }
-
-                            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                                additionalProperties.put(key, value)
-                            }
-
-                            fun putAllAdditionalProperties(
-                                additionalProperties: Map<String, JsonValue>
-                            ) = apply { this.additionalProperties.putAll(additionalProperties) }
-
-                            fun removeAdditionalProperty(key: String) = apply {
-                                additionalProperties.remove(key)
-                            }
-
-                            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                                keys.forEach(::removeAdditionalProperty)
-                            }
-
-                            /**
-                             * Returns an immutable instance of [Line].
-                             *
-                             * Further updates to this [Builder] will not mutate the returned
-                             * instance.
-                             *
-                             * The following fields are required:
-                             * ```java
-                             * .bbox()
-                             * .span()
-                             * ```
-                             *
-                             * @throws IllegalStateException if any required field is unset.
-                             */
-                            fun build(): Line =
-                                Line(
-                                    checkRequired("bbox", bbox),
-                                    checkRequired("span", span).map { it.toImmutable() },
-                                    (words ?: JsonMissing.of()).map { it.toImmutable() },
-                                    additionalProperties.toMutableMap(),
-                                )
-                        }
-
-                        private var validated: Boolean = false
-
-                        /**
-                         * Validates that the types of all values in this object match their
-                         * expected types recursively.
-                         *
-                         * This method is _not_ forwards compatible with new types from the API for
-                         * existing fields.
-                         *
-                         * @throws LlamaCloudInvalidDataException if any value type in this object
-                         *   doesn't match its expected type.
-                         */
-                        fun validate(): Line = apply {
-                            if (validated) {
-                                return@apply
-                            }
-
-                            bbox().validate()
-                            span()
-                            words().ifPresent { it.forEach { it.validate() } }
-                            validated = true
-                        }
-
-                        fun isValid(): Boolean =
-                            try {
-                                validate()
-                                true
-                            } catch (e: LlamaCloudInvalidDataException) {
-                                false
-                            }
-
-                        /**
-                         * Returns a score indicating how many valid values are contained in this
-                         * object recursively.
-                         *
-                         * Used for best match union deserialization.
-                         */
-                        @JvmSynthetic
-                        internal fun validity(): Int =
-                            (bbox.asKnown().getOrNull()?.validity() ?: 0) +
-                                (span.asKnown().getOrNull()?.size ?: 0) +
-                                (words.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
-
-                        /**
-                         * One grounded word: a `[start, end)` span in the source text and its bbox.
-                         */
-                        class Word
-                        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-                        private constructor(
-                            private val bbox: JsonField<BBox>,
-                            private val span: JsonField<List<JsonValue>>,
-                            private val additionalProperties: MutableMap<String, JsonValue>,
-                        ) {
-
-                            @JsonCreator
-                            private constructor(
-                                @JsonProperty("bbox")
-                                @ExcludeMissing
-                                bbox: JsonField<BBox> = JsonMissing.of(),
-                                @JsonProperty("span")
-                                @ExcludeMissing
-                                span: JsonField<List<JsonValue>> = JsonMissing.of(),
-                            ) : this(bbox, span, mutableMapOf())
-
-                            /**
-                             * Word bounding box
-                             *
-                             * @throws LlamaCloudInvalidDataException if the JSON field has an
-                             *   unexpected type or is unexpectedly missing or null (e.g. if the
-                             *   server responded with an unexpected value).
-                             */
-                            fun bbox(): BBox = bbox.getRequired("bbox")
-
-                            /**
-                             * `[start, end)` UTF-8 byte span in the complete source property string
-                             *
-                             * @throws LlamaCloudInvalidDataException if the JSON field has an
-                             *   unexpected type or is unexpectedly missing or null (e.g. if the
-                             *   server responded with an unexpected value).
-                             */
-                            fun span(): List<JsonValue> = span.getRequired("span")
-
-                            /**
-                             * Returns the raw JSON value of [bbox].
-                             *
-                             * Unlike [bbox], this method doesn't throw if the JSON field has an
-                             * unexpected type.
-                             */
-                            @JsonProperty("bbox")
-                            @ExcludeMissing
-                            fun _bbox(): JsonField<BBox> = bbox
-
-                            /**
-                             * Returns the raw JSON value of [span].
-                             *
-                             * Unlike [span], this method doesn't throw if the JSON field has an
-                             * unexpected type.
-                             */
-                            @JsonProperty("span")
-                            @ExcludeMissing
-                            fun _span(): JsonField<List<JsonValue>> = span
-
-                            @JsonAnySetter
-                            private fun putAdditionalProperty(key: String, value: JsonValue) {
-                                additionalProperties.put(key, value)
-                            }
-
-                            @JsonAnyGetter
-                            @ExcludeMissing
-                            fun _additionalProperties(): Map<String, JsonValue> =
-                                Collections.unmodifiableMap(additionalProperties)
-
-                            fun toBuilder() = Builder().from(this)
-
-                            companion object {
-
-                                /**
-                                 * Returns a mutable builder for constructing an instance of [Word].
-                                 *
-                                 * The following fields are required:
-                                 * ```java
-                                 * .bbox()
-                                 * .span()
-                                 * ```
-                                 */
-                                @JvmStatic fun builder() = Builder()
-                            }
-
-                            /** A builder for [Word]. */
-                            class Builder internal constructor() {
-
-                                private var bbox: JsonField<BBox>? = null
-                                private var span: JsonField<MutableList<JsonValue>>? = null
-                                private var additionalProperties: MutableMap<String, JsonValue> =
-                                    mutableMapOf()
-
-                                @JvmSynthetic
-                                internal fun from(word: Word) = apply {
-                                    bbox = word.bbox
-                                    span = word.span.map { it.toMutableList() }
-                                    additionalProperties = word.additionalProperties.toMutableMap()
-                                }
-
-                                /** Word bounding box */
-                                fun bbox(bbox: BBox) = bbox(JsonField.of(bbox))
-
-                                /**
-                                 * Sets [Builder.bbox] to an arbitrary JSON value.
-                                 *
-                                 * You should usually call [Builder.bbox] with a well-typed [BBox]
-                                 * value instead. This method is primarily for setting the field to
-                                 * an undocumented or not yet supported value.
-                                 */
-                                fun bbox(bbox: JsonField<BBox>) = apply { this.bbox = bbox }
-
-                                /**
-                                 * `[start, end)` UTF-8 byte span in the complete source property
-                                 * string
-                                 */
-                                fun span(span: List<JsonValue>) = span(JsonField.of(span))
-
-                                /**
-                                 * Sets [Builder.span] to an arbitrary JSON value.
-                                 *
-                                 * You should usually call [Builder.span] with a well-typed
-                                 * `List<JsonValue>` value instead. This method is primarily for
-                                 * setting the field to an undocumented or not yet supported value.
-                                 */
-                                fun span(span: JsonField<List<JsonValue>>) = apply {
-                                    this.span = span.map { it.toMutableList() }
-                                }
-
-                                /**
-                                 * Adds a single [JsonValue] to [Builder.span].
-                                 *
-                                 * @throws IllegalStateException if the field was previously set to
-                                 *   a non-list.
-                                 */
-                                fun addSpan(span: JsonValue) = apply {
-                                    this.span =
-                                        (this.span ?: JsonField.of(mutableListOf())).also {
-                                            checkKnown("span", it).add(span)
-                                        }
-                                }
-
-                                fun additionalProperties(
-                                    additionalProperties: Map<String, JsonValue>
-                                ) = apply {
-                                    this.additionalProperties.clear()
-                                    putAllAdditionalProperties(additionalProperties)
-                                }
-
-                                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                                    additionalProperties.put(key, value)
-                                }
-
-                                fun putAllAdditionalProperties(
-                                    additionalProperties: Map<String, JsonValue>
-                                ) = apply { this.additionalProperties.putAll(additionalProperties) }
-
-                                fun removeAdditionalProperty(key: String) = apply {
-                                    additionalProperties.remove(key)
-                                }
-
-                                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                                    keys.forEach(::removeAdditionalProperty)
-                                }
-
-                                /**
-                                 * Returns an immutable instance of [Word].
-                                 *
-                                 * Further updates to this [Builder] will not mutate the returned
-                                 * instance.
-                                 *
-                                 * The following fields are required:
-                                 * ```java
-                                 * .bbox()
-                                 * .span()
-                                 * ```
-                                 *
-                                 * @throws IllegalStateException if any required field is unset.
-                                 */
-                                fun build(): Word =
-                                    Word(
-                                        checkRequired("bbox", bbox),
-                                        checkRequired("span", span).map { it.toImmutable() },
-                                        additionalProperties.toMutableMap(),
-                                    )
-                            }
-
-                            private var validated: Boolean = false
-
-                            /**
-                             * Validates that the types of all values in this object match their
-                             * expected types recursively.
-                             *
-                             * This method is _not_ forwards compatible with new types from the API
-                             * for existing fields.
-                             *
-                             * @throws LlamaCloudInvalidDataException if any value type in this
-                             *   object doesn't match its expected type.
-                             */
-                            fun validate(): Word = apply {
-                                if (validated) {
-                                    return@apply
-                                }
-
-                                bbox().validate()
-                                span()
-                                validated = true
-                            }
-
-                            fun isValid(): Boolean =
-                                try {
-                                    validate()
-                                    true
-                                } catch (e: LlamaCloudInvalidDataException) {
-                                    false
-                                }
-
-                            /**
-                             * Returns a score indicating how many valid values are contained in
-                             * this object recursively.
-                             *
-                             * Used for best match union deserialization.
-                             */
-                            @JvmSynthetic
-                            internal fun validity(): Int =
-                                (bbox.asKnown().getOrNull()?.validity() ?: 0) +
-                                    (span.asKnown().getOrNull()?.size ?: 0)
-
-                            override fun equals(other: Any?): Boolean {
-                                if (this === other) {
-                                    return true
-                                }
-
-                                return other is Word &&
-                                    bbox == other.bbox &&
-                                    span == other.span &&
-                                    additionalProperties == other.additionalProperties
-                            }
-
-                            private val hashCode: Int by lazy {
-                                Objects.hash(bbox, span, additionalProperties)
-                            }
-
-                            override fun hashCode(): Int = hashCode
-
-                            override fun toString() =
-                                "Word{bbox=$bbox, span=$span, additionalProperties=$additionalProperties}"
-                        }
-
-                        override fun equals(other: Any?): Boolean {
-                            if (this === other) {
-                                return true
-                            }
-
-                            return other is Line &&
-                                bbox == other.bbox &&
-                                span == other.span &&
-                                words == other.words &&
-                                additionalProperties == other.additionalProperties
-                        }
-
-                        private val hashCode: Int by lazy {
-                            Objects.hash(bbox, span, words, additionalProperties)
-                        }
-
-                        override fun hashCode(): Int = hashCode
-
-                        override fun toString() =
-                            "Line{bbox=$bbox, span=$span, words=$words, additionalProperties=$additionalProperties}"
-                    }
-
-                    override fun equals(other: Any?): Boolean {
-                        if (this === other) {
-                            return true
-                        }
-
-                        return other is Id &&
-                            lines == other.lines &&
-                            additionalProperties == other.additionalProperties
-                    }
-
-                    private val hashCode: Int by lazy { Objects.hash(lines, additionalProperties) }
-
-                    override fun hashCode(): Int = hashCode
-
-                    override fun toString() =
-                        "Id{lines=$lines, additionalProperties=$additionalProperties}"
-                }
-
-                /**
-                 * Supported text with half-open UTF-8 byte spans into the complete property string.
-                 */
-                class Label
-                @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-                private constructor(
-                    private val lines: JsonField<List<Line>>,
-                    private val additionalProperties: MutableMap<String, JsonValue>,
-                ) {
-
-                    @JsonCreator
-                    private constructor(
-                        @JsonProperty("lines")
-                        @ExcludeMissing
-                        lines: JsonField<List<Line>> = JsonMissing.of()
-                    ) : this(lines, mutableMapOf())
-
-                    /**
-                     * Supported lines. Word requests include supported words; gaps are valid. Boxes
-                     * use final page coordinates and optional local rotation r.
-                     *
-                     * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected
-                     *   type or is unexpectedly missing or null (e.g. if the server responded with
-                     *   an unexpected value).
-                     */
-                    fun lines(): List<Line> = lines.getRequired("lines")
-
-                    /**
-                     * Returns the raw JSON value of [lines].
-                     *
-                     * Unlike [lines], this method doesn't throw if the JSON field has an unexpected
-                     * type.
-                     */
-                    @JsonProperty("lines")
-                    @ExcludeMissing
-                    fun _lines(): JsonField<List<Line>> = lines
-
-                    @JsonAnySetter
-                    private fun putAdditionalProperty(key: String, value: JsonValue) {
-                        additionalProperties.put(key, value)
-                    }
-
-                    @JsonAnyGetter
-                    @ExcludeMissing
-                    fun _additionalProperties(): Map<String, JsonValue> =
-                        Collections.unmodifiableMap(additionalProperties)
-
-                    fun toBuilder() = Builder().from(this)
-
-                    companion object {
-
-                        /**
-                         * Returns a mutable builder for constructing an instance of [Label].
-                         *
-                         * The following fields are required:
-                         * ```java
-                         * .lines()
-                         * ```
-                         */
-                        @JvmStatic fun builder() = Builder()
-                    }
-
-                    /** A builder for [Label]. */
-                    class Builder internal constructor() {
-
-                        private var lines: JsonField<MutableList<Line>>? = null
-                        private var additionalProperties: MutableMap<String, JsonValue> =
-                            mutableMapOf()
-
-                        @JvmSynthetic
-                        internal fun from(label: Label) = apply {
-                            lines = label.lines.map { it.toMutableList() }
-                            additionalProperties = label.additionalProperties.toMutableMap()
-                        }
-
-                        /**
-                         * Supported lines. Word requests include supported words; gaps are valid.
-                         * Boxes use final page coordinates and optional local rotation r.
-                         */
-                        fun lines(lines: List<Line>) = lines(JsonField.of(lines))
-
-                        /**
-                         * Sets [Builder.lines] to an arbitrary JSON value.
-                         *
-                         * You should usually call [Builder.lines] with a well-typed `List<Line>`
-                         * value instead. This method is primarily for setting the field to an
-                         * undocumented or not yet supported value.
-                         */
-                        fun lines(lines: JsonField<List<Line>>) = apply {
-                            this.lines = lines.map { it.toMutableList() }
-                        }
-
-                        /**
-                         * Adds a single [Line] to [lines].
-                         *
-                         * @throws IllegalStateException if the field was previously set to a
-                         *   non-list.
-                         */
-                        fun addLine(line: Line) = apply {
-                            lines =
-                                (lines ?: JsonField.of(mutableListOf())).also {
-                                    checkKnown("lines", it).add(line)
-                                }
-                        }
-
-                        fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
-                            apply {
-                                this.additionalProperties.clear()
-                                putAllAdditionalProperties(additionalProperties)
-                            }
-
-                        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                            additionalProperties.put(key, value)
-                        }
-
-                        fun putAllAdditionalProperties(
-                            additionalProperties: Map<String, JsonValue>
-                        ) = apply { this.additionalProperties.putAll(additionalProperties) }
-
-                        fun removeAdditionalProperty(key: String) = apply {
-                            additionalProperties.remove(key)
-                        }
-
-                        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                            keys.forEach(::removeAdditionalProperty)
-                        }
-
-                        /**
-                         * Returns an immutable instance of [Label].
-                         *
-                         * Further updates to this [Builder] will not mutate the returned instance.
-                         *
-                         * The following fields are required:
-                         * ```java
-                         * .lines()
-                         * ```
-                         *
-                         * @throws IllegalStateException if any required field is unset.
-                         */
-                        fun build(): Label =
-                            Label(
-                                checkRequired("lines", lines).map { it.toImmutable() },
-                                additionalProperties.toMutableMap(),
-                            )
-                    }
-
-                    private var validated: Boolean = false
-
-                    /**
-                     * Validates that the types of all values in this object match their expected
-                     * types recursively.
-                     *
-                     * This method is _not_ forwards compatible with new types from the API for
-                     * existing fields.
-                     *
-                     * @throws LlamaCloudInvalidDataException if any value type in this object
-                     *   doesn't match its expected type.
-                     */
-                    fun validate(): Label = apply {
-                        if (validated) {
-                            return@apply
-                        }
-
-                        lines().forEach { it.validate() }
-                        validated = true
-                    }
-
-                    fun isValid(): Boolean =
-                        try {
-                            validate()
-                            true
-                        } catch (e: LlamaCloudInvalidDataException) {
-                            false
-                        }
-
-                    /**
-                     * Returns a score indicating how many valid values are contained in this object
-                     * recursively.
-                     *
-                     * Used for best match union deserialization.
-                     */
-                    @JvmSynthetic
-                    internal fun validity(): Int =
-                        (lines.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
-
-                    /** One grounded line of text with an optional per-word breakdown. */
-                    class Line
-                    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-                    private constructor(
-                        private val bbox: JsonField<BBox>,
-                        private val span: JsonField<List<JsonValue>>,
-                        private val words: JsonField<List<Word>>,
-                        private val additionalProperties: MutableMap<String, JsonValue>,
-                    ) {
-
-                        @JsonCreator
-                        private constructor(
-                            @JsonProperty("bbox")
-                            @ExcludeMissing
-                            bbox: JsonField<BBox> = JsonMissing.of(),
-                            @JsonProperty("span")
-                            @ExcludeMissing
-                            span: JsonField<List<JsonValue>> = JsonMissing.of(),
-                            @JsonProperty("words")
-                            @ExcludeMissing
-                            words: JsonField<List<Word>> = JsonMissing.of(),
-                        ) : this(bbox, span, words, mutableMapOf())
-
-                        /**
-                         * Line bounding box
-                         *
-                         * @throws LlamaCloudInvalidDataException if the JSON field has an
-                         *   unexpected type or is unexpectedly missing or null (e.g. if the server
-                         *   responded with an unexpected value).
-                         */
-                        fun bbox(): BBox = bbox.getRequired("bbox")
-
-                        /**
-                         * `[start, end)` UTF-8 byte span in the complete source property string
-                         *
-                         * @throws LlamaCloudInvalidDataException if the JSON field has an
-                         *   unexpected type or is unexpectedly missing or null (e.g. if the server
-                         *   responded with an unexpected value).
-                         */
-                        fun span(): List<JsonValue> = span.getRequired("span")
-
-                        /**
-                         * Per-word grounding within the line, when available
-                         *
-                         * @throws LlamaCloudInvalidDataException if the JSON field has an
-                         *   unexpected type (e.g. if the server responded with an unexpected
-                         *   value).
-                         */
-                        fun words(): Optional<List<Word>> = words.getOptional("words")
-
-                        /**
-                         * Returns the raw JSON value of [bbox].
-                         *
-                         * Unlike [bbox], this method doesn't throw if the JSON field has an
-                         * unexpected type.
-                         */
-                        @JsonProperty("bbox") @ExcludeMissing fun _bbox(): JsonField<BBox> = bbox
-
-                        /**
-                         * Returns the raw JSON value of [span].
-                         *
-                         * Unlike [span], this method doesn't throw if the JSON field has an
-                         * unexpected type.
-                         */
-                        @JsonProperty("span")
-                        @ExcludeMissing
-                        fun _span(): JsonField<List<JsonValue>> = span
-
-                        /**
-                         * Returns the raw JSON value of [words].
-                         *
-                         * Unlike [words], this method doesn't throw if the JSON field has an
-                         * unexpected type.
-                         */
-                        @JsonProperty("words")
-                        @ExcludeMissing
-                        fun _words(): JsonField<List<Word>> = words
-
-                        @JsonAnySetter
-                        private fun putAdditionalProperty(key: String, value: JsonValue) {
-                            additionalProperties.put(key, value)
-                        }
-
-                        @JsonAnyGetter
-                        @ExcludeMissing
-                        fun _additionalProperties(): Map<String, JsonValue> =
-                            Collections.unmodifiableMap(additionalProperties)
-
-                        fun toBuilder() = Builder().from(this)
-
-                        companion object {
-
-                            /**
-                             * Returns a mutable builder for constructing an instance of [Line].
-                             *
-                             * The following fields are required:
-                             * ```java
-                             * .bbox()
-                             * .span()
-                             * ```
-                             */
-                            @JvmStatic fun builder() = Builder()
-                        }
-
-                        /** A builder for [Line]. */
-                        class Builder internal constructor() {
-
-                            private var bbox: JsonField<BBox>? = null
-                            private var span: JsonField<MutableList<JsonValue>>? = null
-                            private var words: JsonField<MutableList<Word>>? = null
-                            private var additionalProperties: MutableMap<String, JsonValue> =
-                                mutableMapOf()
-
-                            @JvmSynthetic
-                            internal fun from(line: Line) = apply {
-                                bbox = line.bbox
-                                span = line.span.map { it.toMutableList() }
-                                words = line.words.map { it.toMutableList() }
-                                additionalProperties = line.additionalProperties.toMutableMap()
-                            }
-
-                            /** Line bounding box */
-                            fun bbox(bbox: BBox) = bbox(JsonField.of(bbox))
-
-                            /**
-                             * Sets [Builder.bbox] to an arbitrary JSON value.
-                             *
-                             * You should usually call [Builder.bbox] with a well-typed [BBox] value
-                             * instead. This method is primarily for setting the field to an
-                             * undocumented or not yet supported value.
-                             */
-                            fun bbox(bbox: JsonField<BBox>) = apply { this.bbox = bbox }
-
-                            /**
-                             * `[start, end)` UTF-8 byte span in the complete source property string
-                             */
-                            fun span(span: List<JsonValue>) = span(JsonField.of(span))
-
-                            /**
-                             * Sets [Builder.span] to an arbitrary JSON value.
-                             *
-                             * You should usually call [Builder.span] with a well-typed
-                             * `List<JsonValue>` value instead. This method is primarily for setting
-                             * the field to an undocumented or not yet supported value.
-                             */
-                            fun span(span: JsonField<List<JsonValue>>) = apply {
-                                this.span = span.map { it.toMutableList() }
-                            }
-
-                            /**
-                             * Adds a single [JsonValue] to [Builder.span].
-                             *
-                             * @throws IllegalStateException if the field was previously set to a
-                             *   non-list.
-                             */
-                            fun addSpan(span: JsonValue) = apply {
-                                this.span =
-                                    (this.span ?: JsonField.of(mutableListOf())).also {
-                                        checkKnown("span", it).add(span)
-                                    }
-                            }
-
-                            /** Per-word grounding within the line, when available */
-                            fun words(words: List<Word>?) = words(JsonField.ofNullable(words))
-
-                            /** Alias for calling [Builder.words] with `words.orElse(null)`. */
-                            fun words(words: Optional<List<Word>>) = words(words.getOrNull())
-
-                            /**
-                             * Sets [Builder.words] to an arbitrary JSON value.
-                             *
-                             * You should usually call [Builder.words] with a well-typed
-                             * `List<Word>` value instead. This method is primarily for setting the
-                             * field to an undocumented or not yet supported value.
-                             */
-                            fun words(words: JsonField<List<Word>>) = apply {
-                                this.words = words.map { it.toMutableList() }
-                            }
-
-                            /**
-                             * Adds a single [Word] to [words].
-                             *
-                             * @throws IllegalStateException if the field was previously set to a
-                             *   non-list.
-                             */
-                            fun addWord(word: Word) = apply {
-                                words =
-                                    (words ?: JsonField.of(mutableListOf())).also {
-                                        checkKnown("words", it).add(word)
-                                    }
-                            }
-
-                            fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
-                                apply {
-                                    this.additionalProperties.clear()
-                                    putAllAdditionalProperties(additionalProperties)
-                                }
-
-                            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                                additionalProperties.put(key, value)
-                            }
-
-                            fun putAllAdditionalProperties(
-                                additionalProperties: Map<String, JsonValue>
-                            ) = apply { this.additionalProperties.putAll(additionalProperties) }
-
-                            fun removeAdditionalProperty(key: String) = apply {
-                                additionalProperties.remove(key)
-                            }
-
-                            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                                keys.forEach(::removeAdditionalProperty)
-                            }
-
-                            /**
-                             * Returns an immutable instance of [Line].
-                             *
-                             * Further updates to this [Builder] will not mutate the returned
-                             * instance.
-                             *
-                             * The following fields are required:
-                             * ```java
-                             * .bbox()
-                             * .span()
-                             * ```
-                             *
-                             * @throws IllegalStateException if any required field is unset.
-                             */
-                            fun build(): Line =
-                                Line(
-                                    checkRequired("bbox", bbox),
-                                    checkRequired("span", span).map { it.toImmutable() },
-                                    (words ?: JsonMissing.of()).map { it.toImmutable() },
-                                    additionalProperties.toMutableMap(),
-                                )
-                        }
-
-                        private var validated: Boolean = false
-
-                        /**
-                         * Validates that the types of all values in this object match their
-                         * expected types recursively.
-                         *
-                         * This method is _not_ forwards compatible with new types from the API for
-                         * existing fields.
-                         *
-                         * @throws LlamaCloudInvalidDataException if any value type in this object
-                         *   doesn't match its expected type.
-                         */
-                        fun validate(): Line = apply {
-                            if (validated) {
-                                return@apply
-                            }
-
-                            bbox().validate()
-                            span()
-                            words().ifPresent { it.forEach { it.validate() } }
-                            validated = true
-                        }
-
-                        fun isValid(): Boolean =
-                            try {
-                                validate()
-                                true
-                            } catch (e: LlamaCloudInvalidDataException) {
-                                false
-                            }
-
-                        /**
-                         * Returns a score indicating how many valid values are contained in this
-                         * object recursively.
-                         *
-                         * Used for best match union deserialization.
-                         */
-                        @JvmSynthetic
-                        internal fun validity(): Int =
-                            (bbox.asKnown().getOrNull()?.validity() ?: 0) +
-                                (span.asKnown().getOrNull()?.size ?: 0) +
-                                (words.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
-
-                        /**
-                         * One grounded word: a `[start, end)` span in the source text and its bbox.
-                         */
-                        class Word
-                        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-                        private constructor(
-                            private val bbox: JsonField<BBox>,
-                            private val span: JsonField<List<JsonValue>>,
-                            private val additionalProperties: MutableMap<String, JsonValue>,
-                        ) {
-
-                            @JsonCreator
-                            private constructor(
-                                @JsonProperty("bbox")
-                                @ExcludeMissing
-                                bbox: JsonField<BBox> = JsonMissing.of(),
-                                @JsonProperty("span")
-                                @ExcludeMissing
-                                span: JsonField<List<JsonValue>> = JsonMissing.of(),
-                            ) : this(bbox, span, mutableMapOf())
-
-                            /**
-                             * Word bounding box
-                             *
-                             * @throws LlamaCloudInvalidDataException if the JSON field has an
-                             *   unexpected type or is unexpectedly missing or null (e.g. if the
-                             *   server responded with an unexpected value).
-                             */
-                            fun bbox(): BBox = bbox.getRequired("bbox")
-
-                            /**
-                             * `[start, end)` UTF-8 byte span in the complete source property string
-                             *
-                             * @throws LlamaCloudInvalidDataException if the JSON field has an
-                             *   unexpected type or is unexpectedly missing or null (e.g. if the
-                             *   server responded with an unexpected value).
-                             */
-                            fun span(): List<JsonValue> = span.getRequired("span")
-
-                            /**
-                             * Returns the raw JSON value of [bbox].
-                             *
-                             * Unlike [bbox], this method doesn't throw if the JSON field has an
-                             * unexpected type.
-                             */
-                            @JsonProperty("bbox")
-                            @ExcludeMissing
-                            fun _bbox(): JsonField<BBox> = bbox
-
-                            /**
-                             * Returns the raw JSON value of [span].
-                             *
-                             * Unlike [span], this method doesn't throw if the JSON field has an
-                             * unexpected type.
-                             */
-                            @JsonProperty("span")
-                            @ExcludeMissing
-                            fun _span(): JsonField<List<JsonValue>> = span
-
-                            @JsonAnySetter
-                            private fun putAdditionalProperty(key: String, value: JsonValue) {
-                                additionalProperties.put(key, value)
-                            }
-
-                            @JsonAnyGetter
-                            @ExcludeMissing
-                            fun _additionalProperties(): Map<String, JsonValue> =
-                                Collections.unmodifiableMap(additionalProperties)
-
-                            fun toBuilder() = Builder().from(this)
-
-                            companion object {
-
-                                /**
-                                 * Returns a mutable builder for constructing an instance of [Word].
-                                 *
-                                 * The following fields are required:
-                                 * ```java
-                                 * .bbox()
-                                 * .span()
-                                 * ```
-                                 */
-                                @JvmStatic fun builder() = Builder()
-                            }
-
-                            /** A builder for [Word]. */
-                            class Builder internal constructor() {
-
-                                private var bbox: JsonField<BBox>? = null
-                                private var span: JsonField<MutableList<JsonValue>>? = null
-                                private var additionalProperties: MutableMap<String, JsonValue> =
-                                    mutableMapOf()
-
-                                @JvmSynthetic
-                                internal fun from(word: Word) = apply {
-                                    bbox = word.bbox
-                                    span = word.span.map { it.toMutableList() }
-                                    additionalProperties = word.additionalProperties.toMutableMap()
-                                }
-
-                                /** Word bounding box */
-                                fun bbox(bbox: BBox) = bbox(JsonField.of(bbox))
-
-                                /**
-                                 * Sets [Builder.bbox] to an arbitrary JSON value.
-                                 *
-                                 * You should usually call [Builder.bbox] with a well-typed [BBox]
-                                 * value instead. This method is primarily for setting the field to
-                                 * an undocumented or not yet supported value.
-                                 */
-                                fun bbox(bbox: JsonField<BBox>) = apply { this.bbox = bbox }
-
-                                /**
-                                 * `[start, end)` UTF-8 byte span in the complete source property
-                                 * string
-                                 */
-                                fun span(span: List<JsonValue>) = span(JsonField.of(span))
-
-                                /**
-                                 * Sets [Builder.span] to an arbitrary JSON value.
-                                 *
-                                 * You should usually call [Builder.span] with a well-typed
-                                 * `List<JsonValue>` value instead. This method is primarily for
-                                 * setting the field to an undocumented or not yet supported value.
-                                 */
-                                fun span(span: JsonField<List<JsonValue>>) = apply {
-                                    this.span = span.map { it.toMutableList() }
-                                }
-
-                                /**
-                                 * Adds a single [JsonValue] to [Builder.span].
-                                 *
-                                 * @throws IllegalStateException if the field was previously set to
-                                 *   a non-list.
-                                 */
-                                fun addSpan(span: JsonValue) = apply {
-                                    this.span =
-                                        (this.span ?: JsonField.of(mutableListOf())).also {
-                                            checkKnown("span", it).add(span)
-                                        }
-                                }
-
-                                fun additionalProperties(
-                                    additionalProperties: Map<String, JsonValue>
-                                ) = apply {
-                                    this.additionalProperties.clear()
-                                    putAllAdditionalProperties(additionalProperties)
-                                }
-
-                                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                                    additionalProperties.put(key, value)
-                                }
-
-                                fun putAllAdditionalProperties(
-                                    additionalProperties: Map<String, JsonValue>
-                                ) = apply { this.additionalProperties.putAll(additionalProperties) }
-
-                                fun removeAdditionalProperty(key: String) = apply {
-                                    additionalProperties.remove(key)
-                                }
-
-                                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                                    keys.forEach(::removeAdditionalProperty)
-                                }
-
-                                /**
-                                 * Returns an immutable instance of [Word].
-                                 *
-                                 * Further updates to this [Builder] will not mutate the returned
-                                 * instance.
-                                 *
-                                 * The following fields are required:
-                                 * ```java
-                                 * .bbox()
-                                 * .span()
-                                 * ```
-                                 *
-                                 * @throws IllegalStateException if any required field is unset.
-                                 */
-                                fun build(): Word =
-                                    Word(
-                                        checkRequired("bbox", bbox),
-                                        checkRequired("span", span).map { it.toImmutable() },
-                                        additionalProperties.toMutableMap(),
-                                    )
-                            }
-
-                            private var validated: Boolean = false
-
-                            /**
-                             * Validates that the types of all values in this object match their
-                             * expected types recursively.
-                             *
-                             * This method is _not_ forwards compatible with new types from the API
-                             * for existing fields.
-                             *
-                             * @throws LlamaCloudInvalidDataException if any value type in this
-                             *   object doesn't match its expected type.
-                             */
-                            fun validate(): Word = apply {
-                                if (validated) {
-                                    return@apply
-                                }
-
-                                bbox().validate()
-                                span()
-                                validated = true
-                            }
-
-                            fun isValid(): Boolean =
-                                try {
-                                    validate()
-                                    true
-                                } catch (e: LlamaCloudInvalidDataException) {
-                                    false
-                                }
-
-                            /**
-                             * Returns a score indicating how many valid values are contained in
-                             * this object recursively.
-                             *
-                             * Used for best match union deserialization.
-                             */
-                            @JvmSynthetic
-                            internal fun validity(): Int =
-                                (bbox.asKnown().getOrNull()?.validity() ?: 0) +
-                                    (span.asKnown().getOrNull()?.size ?: 0)
-
-                            override fun equals(other: Any?): Boolean {
-                                if (this === other) {
-                                    return true
-                                }
-
-                                return other is Word &&
-                                    bbox == other.bbox &&
-                                    span == other.span &&
-                                    additionalProperties == other.additionalProperties
-                            }
-
-                            private val hashCode: Int by lazy {
-                                Objects.hash(bbox, span, additionalProperties)
-                            }
-
-                            override fun hashCode(): Int = hashCode
-
-                            override fun toString() =
-                                "Word{bbox=$bbox, span=$span, additionalProperties=$additionalProperties}"
-                        }
-
-                        override fun equals(other: Any?): Boolean {
-                            if (this === other) {
-                                return true
-                            }
-
-                            return other is Line &&
-                                bbox == other.bbox &&
-                                span == other.span &&
-                                words == other.words &&
-                                additionalProperties == other.additionalProperties
-                        }
-
-                        private val hashCode: Int by lazy {
-                            Objects.hash(bbox, span, words, additionalProperties)
-                        }
-
-                        override fun hashCode(): Int = hashCode
-
-                        override fun toString() =
-                            "Line{bbox=$bbox, span=$span, words=$words, additionalProperties=$additionalProperties}"
-                    }
-
-                    override fun equals(other: Any?): Boolean {
-                        if (this === other) {
-                            return true
-                        }
-
-                        return other is Label &&
-                            lines == other.lines &&
-                            additionalProperties == other.additionalProperties
-                    }
-
-                    private val hashCode: Int by lazy { Objects.hash(lines, additionalProperties) }
-
-                    override fun hashCode(): Int = hashCode
-
-                    override fun toString() =
-                        "Label{lines=$lines, additionalProperties=$additionalProperties}"
-                }
-
-                /**
-                 * Supported text with half-open UTF-8 byte spans into the complete property string.
-                 */
-                class Value
-                @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-                private constructor(
-                    private val lines: JsonField<List<Line>>,
-                    private val additionalProperties: MutableMap<String, JsonValue>,
-                ) {
-
-                    @JsonCreator
-                    private constructor(
-                        @JsonProperty("lines")
-                        @ExcludeMissing
-                        lines: JsonField<List<Line>> = JsonMissing.of()
-                    ) : this(lines, mutableMapOf())
-
-                    /**
-                     * Supported lines. Word requests include supported words; gaps are valid. Boxes
-                     * use final page coordinates and optional local rotation r.
-                     *
-                     * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected
-                     *   type or is unexpectedly missing or null (e.g. if the server responded with
-                     *   an unexpected value).
-                     */
-                    fun lines(): List<Line> = lines.getRequired("lines")
-
-                    /**
-                     * Returns the raw JSON value of [lines].
-                     *
-                     * Unlike [lines], this method doesn't throw if the JSON field has an unexpected
-                     * type.
-                     */
-                    @JsonProperty("lines")
-                    @ExcludeMissing
-                    fun _lines(): JsonField<List<Line>> = lines
-
-                    @JsonAnySetter
-                    private fun putAdditionalProperty(key: String, value: JsonValue) {
-                        additionalProperties.put(key, value)
-                    }
-
-                    @JsonAnyGetter
-                    @ExcludeMissing
-                    fun _additionalProperties(): Map<String, JsonValue> =
-                        Collections.unmodifiableMap(additionalProperties)
-
-                    fun toBuilder() = Builder().from(this)
-
-                    companion object {
-
-                        /**
-                         * Returns a mutable builder for constructing an instance of [Value].
-                         *
-                         * The following fields are required:
-                         * ```java
-                         * .lines()
-                         * ```
-                         */
-                        @JvmStatic fun builder() = Builder()
-                    }
-
-                    /** A builder for [Value]. */
-                    class Builder internal constructor() {
-
-                        private var lines: JsonField<MutableList<Line>>? = null
-                        private var additionalProperties: MutableMap<String, JsonValue> =
-                            mutableMapOf()
-
-                        @JvmSynthetic
-                        internal fun from(value: Value) = apply {
-                            lines = value.lines.map { it.toMutableList() }
-                            additionalProperties = value.additionalProperties.toMutableMap()
-                        }
-
-                        /**
-                         * Supported lines. Word requests include supported words; gaps are valid.
-                         * Boxes use final page coordinates and optional local rotation r.
-                         */
-                        fun lines(lines: List<Line>) = lines(JsonField.of(lines))
-
-                        /**
-                         * Sets [Builder.lines] to an arbitrary JSON value.
-                         *
-                         * You should usually call [Builder.lines] with a well-typed `List<Line>`
-                         * value instead. This method is primarily for setting the field to an
-                         * undocumented or not yet supported value.
-                         */
-                        fun lines(lines: JsonField<List<Line>>) = apply {
-                            this.lines = lines.map { it.toMutableList() }
-                        }
-
-                        /**
-                         * Adds a single [Line] to [lines].
-                         *
-                         * @throws IllegalStateException if the field was previously set to a
-                         *   non-list.
-                         */
-                        fun addLine(line: Line) = apply {
-                            lines =
-                                (lines ?: JsonField.of(mutableListOf())).also {
-                                    checkKnown("lines", it).add(line)
-                                }
-                        }
-
-                        fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
-                            apply {
-                                this.additionalProperties.clear()
-                                putAllAdditionalProperties(additionalProperties)
-                            }
-
-                        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                            additionalProperties.put(key, value)
-                        }
-
-                        fun putAllAdditionalProperties(
-                            additionalProperties: Map<String, JsonValue>
-                        ) = apply { this.additionalProperties.putAll(additionalProperties) }
-
-                        fun removeAdditionalProperty(key: String) = apply {
-                            additionalProperties.remove(key)
-                        }
-
-                        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                            keys.forEach(::removeAdditionalProperty)
-                        }
-
-                        /**
-                         * Returns an immutable instance of [Value].
-                         *
-                         * Further updates to this [Builder] will not mutate the returned instance.
-                         *
-                         * The following fields are required:
-                         * ```java
-                         * .lines()
-                         * ```
-                         *
-                         * @throws IllegalStateException if any required field is unset.
-                         */
-                        fun build(): Value =
-                            Value(
-                                checkRequired("lines", lines).map { it.toImmutable() },
-                                additionalProperties.toMutableMap(),
-                            )
-                    }
-
-                    private var validated: Boolean = false
-
-                    /**
-                     * Validates that the types of all values in this object match their expected
-                     * types recursively.
-                     *
-                     * This method is _not_ forwards compatible with new types from the API for
-                     * existing fields.
-                     *
-                     * @throws LlamaCloudInvalidDataException if any value type in this object
-                     *   doesn't match its expected type.
-                     */
-                    fun validate(): Value = apply {
-                        if (validated) {
-                            return@apply
-                        }
-
-                        lines().forEach { it.validate() }
-                        validated = true
-                    }
-
-                    fun isValid(): Boolean =
-                        try {
-                            validate()
-                            true
-                        } catch (e: LlamaCloudInvalidDataException) {
-                            false
-                        }
-
-                    /**
-                     * Returns a score indicating how many valid values are contained in this object
-                     * recursively.
-                     *
-                     * Used for best match union deserialization.
-                     */
-                    @JvmSynthetic
-                    internal fun validity(): Int =
-                        (lines.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
-
-                    /** One grounded line of text with an optional per-word breakdown. */
-                    class Line
-                    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-                    private constructor(
-                        private val bbox: JsonField<BBox>,
-                        private val span: JsonField<List<JsonValue>>,
-                        private val words: JsonField<List<Word>>,
-                        private val additionalProperties: MutableMap<String, JsonValue>,
-                    ) {
-
-                        @JsonCreator
-                        private constructor(
-                            @JsonProperty("bbox")
-                            @ExcludeMissing
-                            bbox: JsonField<BBox> = JsonMissing.of(),
-                            @JsonProperty("span")
-                            @ExcludeMissing
-                            span: JsonField<List<JsonValue>> = JsonMissing.of(),
-                            @JsonProperty("words")
-                            @ExcludeMissing
-                            words: JsonField<List<Word>> = JsonMissing.of(),
-                        ) : this(bbox, span, words, mutableMapOf())
-
-                        /**
-                         * Line bounding box
-                         *
-                         * @throws LlamaCloudInvalidDataException if the JSON field has an
-                         *   unexpected type or is unexpectedly missing or null (e.g. if the server
-                         *   responded with an unexpected value).
-                         */
-                        fun bbox(): BBox = bbox.getRequired("bbox")
-
-                        /**
-                         * `[start, end)` UTF-8 byte span in the complete source property string
-                         *
-                         * @throws LlamaCloudInvalidDataException if the JSON field has an
-                         *   unexpected type or is unexpectedly missing or null (e.g. if the server
-                         *   responded with an unexpected value).
-                         */
-                        fun span(): List<JsonValue> = span.getRequired("span")
-
-                        /**
-                         * Per-word grounding within the line, when available
-                         *
-                         * @throws LlamaCloudInvalidDataException if the JSON field has an
-                         *   unexpected type (e.g. if the server responded with an unexpected
-                         *   value).
-                         */
-                        fun words(): Optional<List<Word>> = words.getOptional("words")
-
-                        /**
-                         * Returns the raw JSON value of [bbox].
-                         *
-                         * Unlike [bbox], this method doesn't throw if the JSON field has an
-                         * unexpected type.
-                         */
-                        @JsonProperty("bbox") @ExcludeMissing fun _bbox(): JsonField<BBox> = bbox
-
-                        /**
-                         * Returns the raw JSON value of [span].
-                         *
-                         * Unlike [span], this method doesn't throw if the JSON field has an
-                         * unexpected type.
-                         */
-                        @JsonProperty("span")
-                        @ExcludeMissing
-                        fun _span(): JsonField<List<JsonValue>> = span
-
-                        /**
-                         * Returns the raw JSON value of [words].
-                         *
-                         * Unlike [words], this method doesn't throw if the JSON field has an
-                         * unexpected type.
-                         */
-                        @JsonProperty("words")
-                        @ExcludeMissing
-                        fun _words(): JsonField<List<Word>> = words
-
-                        @JsonAnySetter
-                        private fun putAdditionalProperty(key: String, value: JsonValue) {
-                            additionalProperties.put(key, value)
-                        }
-
-                        @JsonAnyGetter
-                        @ExcludeMissing
-                        fun _additionalProperties(): Map<String, JsonValue> =
-                            Collections.unmodifiableMap(additionalProperties)
-
-                        fun toBuilder() = Builder().from(this)
-
-                        companion object {
-
-                            /**
-                             * Returns a mutable builder for constructing an instance of [Line].
-                             *
-                             * The following fields are required:
-                             * ```java
-                             * .bbox()
-                             * .span()
-                             * ```
-                             */
-                            @JvmStatic fun builder() = Builder()
-                        }
-
-                        /** A builder for [Line]. */
-                        class Builder internal constructor() {
-
-                            private var bbox: JsonField<BBox>? = null
-                            private var span: JsonField<MutableList<JsonValue>>? = null
-                            private var words: JsonField<MutableList<Word>>? = null
-                            private var additionalProperties: MutableMap<String, JsonValue> =
-                                mutableMapOf()
-
-                            @JvmSynthetic
-                            internal fun from(line: Line) = apply {
-                                bbox = line.bbox
-                                span = line.span.map { it.toMutableList() }
-                                words = line.words.map { it.toMutableList() }
-                                additionalProperties = line.additionalProperties.toMutableMap()
-                            }
-
-                            /** Line bounding box */
-                            fun bbox(bbox: BBox) = bbox(JsonField.of(bbox))
-
-                            /**
-                             * Sets [Builder.bbox] to an arbitrary JSON value.
-                             *
-                             * You should usually call [Builder.bbox] with a well-typed [BBox] value
-                             * instead. This method is primarily for setting the field to an
-                             * undocumented or not yet supported value.
-                             */
-                            fun bbox(bbox: JsonField<BBox>) = apply { this.bbox = bbox }
-
-                            /**
-                             * `[start, end)` UTF-8 byte span in the complete source property string
-                             */
-                            fun span(span: List<JsonValue>) = span(JsonField.of(span))
-
-                            /**
-                             * Sets [Builder.span] to an arbitrary JSON value.
-                             *
-                             * You should usually call [Builder.span] with a well-typed
-                             * `List<JsonValue>` value instead. This method is primarily for setting
-                             * the field to an undocumented or not yet supported value.
-                             */
-                            fun span(span: JsonField<List<JsonValue>>) = apply {
-                                this.span = span.map { it.toMutableList() }
-                            }
-
-                            /**
-                             * Adds a single [JsonValue] to [Builder.span].
-                             *
-                             * @throws IllegalStateException if the field was previously set to a
-                             *   non-list.
-                             */
-                            fun addSpan(span: JsonValue) = apply {
-                                this.span =
-                                    (this.span ?: JsonField.of(mutableListOf())).also {
-                                        checkKnown("span", it).add(span)
-                                    }
-                            }
-
-                            /** Per-word grounding within the line, when available */
-                            fun words(words: List<Word>?) = words(JsonField.ofNullable(words))
-
-                            /** Alias for calling [Builder.words] with `words.orElse(null)`. */
-                            fun words(words: Optional<List<Word>>) = words(words.getOrNull())
-
-                            /**
-                             * Sets [Builder.words] to an arbitrary JSON value.
-                             *
-                             * You should usually call [Builder.words] with a well-typed
-                             * `List<Word>` value instead. This method is primarily for setting the
-                             * field to an undocumented or not yet supported value.
-                             */
-                            fun words(words: JsonField<List<Word>>) = apply {
-                                this.words = words.map { it.toMutableList() }
-                            }
-
-                            /**
-                             * Adds a single [Word] to [words].
-                             *
-                             * @throws IllegalStateException if the field was previously set to a
-                             *   non-list.
-                             */
-                            fun addWord(word: Word) = apply {
-                                words =
-                                    (words ?: JsonField.of(mutableListOf())).also {
-                                        checkKnown("words", it).add(word)
-                                    }
-                            }
-
-                            fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
-                                apply {
-                                    this.additionalProperties.clear()
-                                    putAllAdditionalProperties(additionalProperties)
-                                }
-
-                            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                                additionalProperties.put(key, value)
-                            }
-
-                            fun putAllAdditionalProperties(
-                                additionalProperties: Map<String, JsonValue>
-                            ) = apply { this.additionalProperties.putAll(additionalProperties) }
-
-                            fun removeAdditionalProperty(key: String) = apply {
-                                additionalProperties.remove(key)
-                            }
-
-                            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                                keys.forEach(::removeAdditionalProperty)
-                            }
-
-                            /**
-                             * Returns an immutable instance of [Line].
-                             *
-                             * Further updates to this [Builder] will not mutate the returned
-                             * instance.
-                             *
-                             * The following fields are required:
-                             * ```java
-                             * .bbox()
-                             * .span()
-                             * ```
-                             *
-                             * @throws IllegalStateException if any required field is unset.
-                             */
-                            fun build(): Line =
-                                Line(
-                                    checkRequired("bbox", bbox),
-                                    checkRequired("span", span).map { it.toImmutable() },
-                                    (words ?: JsonMissing.of()).map { it.toImmutable() },
-                                    additionalProperties.toMutableMap(),
-                                )
-                        }
-
-                        private var validated: Boolean = false
-
-                        /**
-                         * Validates that the types of all values in this object match their
-                         * expected types recursively.
-                         *
-                         * This method is _not_ forwards compatible with new types from the API for
-                         * existing fields.
-                         *
-                         * @throws LlamaCloudInvalidDataException if any value type in this object
-                         *   doesn't match its expected type.
-                         */
-                        fun validate(): Line = apply {
-                            if (validated) {
-                                return@apply
-                            }
-
-                            bbox().validate()
-                            span()
-                            words().ifPresent { it.forEach { it.validate() } }
-                            validated = true
-                        }
-
-                        fun isValid(): Boolean =
-                            try {
-                                validate()
-                                true
-                            } catch (e: LlamaCloudInvalidDataException) {
-                                false
-                            }
-
-                        /**
-                         * Returns a score indicating how many valid values are contained in this
-                         * object recursively.
-                         *
-                         * Used for best match union deserialization.
-                         */
-                        @JvmSynthetic
-                        internal fun validity(): Int =
-                            (bbox.asKnown().getOrNull()?.validity() ?: 0) +
-                                (span.asKnown().getOrNull()?.size ?: 0) +
-                                (words.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
-
-                        /**
-                         * One grounded word: a `[start, end)` span in the source text and its bbox.
-                         */
-                        class Word
-                        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-                        private constructor(
-                            private val bbox: JsonField<BBox>,
-                            private val span: JsonField<List<JsonValue>>,
-                            private val additionalProperties: MutableMap<String, JsonValue>,
-                        ) {
-
-                            @JsonCreator
-                            private constructor(
-                                @JsonProperty("bbox")
-                                @ExcludeMissing
-                                bbox: JsonField<BBox> = JsonMissing.of(),
-                                @JsonProperty("span")
-                                @ExcludeMissing
-                                span: JsonField<List<JsonValue>> = JsonMissing.of(),
-                            ) : this(bbox, span, mutableMapOf())
-
-                            /**
-                             * Word bounding box
-                             *
-                             * @throws LlamaCloudInvalidDataException if the JSON field has an
-                             *   unexpected type or is unexpectedly missing or null (e.g. if the
-                             *   server responded with an unexpected value).
-                             */
-                            fun bbox(): BBox = bbox.getRequired("bbox")
-
-                            /**
-                             * `[start, end)` UTF-8 byte span in the complete source property string
-                             *
-                             * @throws LlamaCloudInvalidDataException if the JSON field has an
-                             *   unexpected type or is unexpectedly missing or null (e.g. if the
-                             *   server responded with an unexpected value).
-                             */
-                            fun span(): List<JsonValue> = span.getRequired("span")
-
-                            /**
-                             * Returns the raw JSON value of [bbox].
-                             *
-                             * Unlike [bbox], this method doesn't throw if the JSON field has an
-                             * unexpected type.
-                             */
-                            @JsonProperty("bbox")
-                            @ExcludeMissing
-                            fun _bbox(): JsonField<BBox> = bbox
-
-                            /**
-                             * Returns the raw JSON value of [span].
-                             *
-                             * Unlike [span], this method doesn't throw if the JSON field has an
-                             * unexpected type.
-                             */
-                            @JsonProperty("span")
-                            @ExcludeMissing
-                            fun _span(): JsonField<List<JsonValue>> = span
-
-                            @JsonAnySetter
-                            private fun putAdditionalProperty(key: String, value: JsonValue) {
-                                additionalProperties.put(key, value)
-                            }
-
-                            @JsonAnyGetter
-                            @ExcludeMissing
-                            fun _additionalProperties(): Map<String, JsonValue> =
-                                Collections.unmodifiableMap(additionalProperties)
-
-                            fun toBuilder() = Builder().from(this)
-
-                            companion object {
-
-                                /**
-                                 * Returns a mutable builder for constructing an instance of [Word].
-                                 *
-                                 * The following fields are required:
-                                 * ```java
-                                 * .bbox()
-                                 * .span()
-                                 * ```
-                                 */
-                                @JvmStatic fun builder() = Builder()
-                            }
-
-                            /** A builder for [Word]. */
-                            class Builder internal constructor() {
-
-                                private var bbox: JsonField<BBox>? = null
-                                private var span: JsonField<MutableList<JsonValue>>? = null
-                                private var additionalProperties: MutableMap<String, JsonValue> =
-                                    mutableMapOf()
-
-                                @JvmSynthetic
-                                internal fun from(word: Word) = apply {
-                                    bbox = word.bbox
-                                    span = word.span.map { it.toMutableList() }
-                                    additionalProperties = word.additionalProperties.toMutableMap()
-                                }
-
-                                /** Word bounding box */
-                                fun bbox(bbox: BBox) = bbox(JsonField.of(bbox))
-
-                                /**
-                                 * Sets [Builder.bbox] to an arbitrary JSON value.
-                                 *
-                                 * You should usually call [Builder.bbox] with a well-typed [BBox]
-                                 * value instead. This method is primarily for setting the field to
-                                 * an undocumented or not yet supported value.
-                                 */
-                                fun bbox(bbox: JsonField<BBox>) = apply { this.bbox = bbox }
-
-                                /**
-                                 * `[start, end)` UTF-8 byte span in the complete source property
-                                 * string
-                                 */
-                                fun span(span: List<JsonValue>) = span(JsonField.of(span))
-
-                                /**
-                                 * Sets [Builder.span] to an arbitrary JSON value.
-                                 *
-                                 * You should usually call [Builder.span] with a well-typed
-                                 * `List<JsonValue>` value instead. This method is primarily for
-                                 * setting the field to an undocumented or not yet supported value.
-                                 */
-                                fun span(span: JsonField<List<JsonValue>>) = apply {
-                                    this.span = span.map { it.toMutableList() }
-                                }
-
-                                /**
-                                 * Adds a single [JsonValue] to [Builder.span].
-                                 *
-                                 * @throws IllegalStateException if the field was previously set to
-                                 *   a non-list.
-                                 */
-                                fun addSpan(span: JsonValue) = apply {
-                                    this.span =
-                                        (this.span ?: JsonField.of(mutableListOf())).also {
-                                            checkKnown("span", it).add(span)
-                                        }
-                                }
-
-                                fun additionalProperties(
-                                    additionalProperties: Map<String, JsonValue>
-                                ) = apply {
-                                    this.additionalProperties.clear()
-                                    putAllAdditionalProperties(additionalProperties)
-                                }
-
-                                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                                    additionalProperties.put(key, value)
-                                }
-
-                                fun putAllAdditionalProperties(
-                                    additionalProperties: Map<String, JsonValue>
-                                ) = apply { this.additionalProperties.putAll(additionalProperties) }
-
-                                fun removeAdditionalProperty(key: String) = apply {
-                                    additionalProperties.remove(key)
-                                }
-
-                                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                                    keys.forEach(::removeAdditionalProperty)
-                                }
-
-                                /**
-                                 * Returns an immutable instance of [Word].
-                                 *
-                                 * Further updates to this [Builder] will not mutate the returned
-                                 * instance.
-                                 *
-                                 * The following fields are required:
-                                 * ```java
-                                 * .bbox()
-                                 * .span()
-                                 * ```
-                                 *
-                                 * @throws IllegalStateException if any required field is unset.
-                                 */
-                                fun build(): Word =
-                                    Word(
-                                        checkRequired("bbox", bbox),
-                                        checkRequired("span", span).map { it.toImmutable() },
-                                        additionalProperties.toMutableMap(),
-                                    )
-                            }
-
-                            private var validated: Boolean = false
-
-                            /**
-                             * Validates that the types of all values in this object match their
-                             * expected types recursively.
-                             *
-                             * This method is _not_ forwards compatible with new types from the API
-                             * for existing fields.
-                             *
-                             * @throws LlamaCloudInvalidDataException if any value type in this
-                             *   object doesn't match its expected type.
-                             */
-                            fun validate(): Word = apply {
-                                if (validated) {
-                                    return@apply
-                                }
-
-                                bbox().validate()
-                                span()
-                                validated = true
-                            }
-
-                            fun isValid(): Boolean =
-                                try {
-                                    validate()
-                                    true
-                                } catch (e: LlamaCloudInvalidDataException) {
-                                    false
-                                }
-
-                            /**
-                             * Returns a score indicating how many valid values are contained in
-                             * this object recursively.
-                             *
-                             * Used for best match union deserialization.
-                             */
-                            @JvmSynthetic
-                            internal fun validity(): Int =
-                                (bbox.asKnown().getOrNull()?.validity() ?: 0) +
-                                    (span.asKnown().getOrNull()?.size ?: 0)
-
-                            override fun equals(other: Any?): Boolean {
-                                if (this === other) {
-                                    return true
-                                }
-
-                                return other is Word &&
-                                    bbox == other.bbox &&
-                                    span == other.span &&
-                                    additionalProperties == other.additionalProperties
-                            }
-
-                            private val hashCode: Int by lazy {
-                                Objects.hash(bbox, span, additionalProperties)
-                            }
-
-                            override fun hashCode(): Int = hashCode
-
-                            override fun toString() =
-                                "Word{bbox=$bbox, span=$span, additionalProperties=$additionalProperties}"
-                        }
-
-                        override fun equals(other: Any?): Boolean {
-                            if (this === other) {
-                                return true
-                            }
-
-                            return other is Line &&
-                                bbox == other.bbox &&
-                                span == other.span &&
-                                words == other.words &&
-                                additionalProperties == other.additionalProperties
-                        }
-
-                        private val hashCode: Int by lazy {
-                            Objects.hash(bbox, span, words, additionalProperties)
-                        }
-
-                        override fun hashCode(): Int = hashCode
-
-                        override fun toString() =
-                            "Line{bbox=$bbox, span=$span, words=$words, additionalProperties=$additionalProperties}"
-                    }
-
-                    override fun equals(other: Any?): Boolean {
-                        if (this === other) {
-                            return true
-                        }
-
-                        return other is Value &&
-                            lines == other.lines &&
-                            additionalProperties == other.additionalProperties
-                    }
-
-                    private val hashCode: Int by lazy { Objects.hash(lines, additionalProperties) }
-
-                    override fun hashCode(): Int = hashCode
-
-                    override fun toString() =
-                        "Value{lines=$lines, additionalProperties=$additionalProperties}"
-                }
-
-                override fun equals(other: Any?): Boolean {
-                    if (this === other) {
-                        return true
-                    }
-
-                    return other is Grounding &&
-                        id == other.id &&
-                        label == other.label &&
-                        value == other.value &&
-                        additionalProperties == other.additionalProperties
-                }
-
-                private val hashCode: Int by lazy {
-                    Objects.hash(id, label, value, additionalProperties)
-                }
-
-                override fun hashCode(): Int = hashCode
-
-                override fun toString() =
-                    "Grounding{id=$id, label=$label, value=$value, additionalProperties=$additionalProperties}"
-            }
-
-            /** Form text node */
-            class Type @JsonCreator private constructor(private val value: JsonField<String>) :
-                Enum {
-
-                /**
-                 * Returns this class instance's raw value.
-                 *
-                 * This is usually only useful if this instance was deserialized from data that
-                 * doesn't match any known member, and you want to know that value. For example, if
-                 * the SDK is on an older version than the API, then the API may respond with new
-                 * members that the SDK is unaware of.
-                 */
-                @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
-
-                companion object {
-
-                    @JvmField val TEXT = of("text")
-
-                    @JvmStatic fun of(value: String) = Type(JsonField.of(value))
-                }
-
-                /** An enum containing [Type]'s known values. */
-                enum class Known {
-                    TEXT
-                }
-
-                /**
-                 * An enum containing [Type]'s known values, as well as an [_UNKNOWN] member.
-                 *
-                 * An instance of [Type] can contain an unknown value in a couple of cases:
-                 * - It was deserialized from data that doesn't match any known member. For example,
-                 *   if the SDK is on an older version than the API, then the API may respond with
-                 *   new members that the SDK is unaware of.
-                 * - It was constructed with an arbitrary value using the [of] method.
-                 */
-                enum class Value {
-                    TEXT,
-                    /**
-                     * An enum member indicating that [Type] was instantiated with an unknown value.
-                     */
-                    _UNKNOWN,
-                }
-
-                /**
-                 * Returns an enum member corresponding to this class instance's value, or
-                 * [Value._UNKNOWN] if the class was instantiated with an unknown value.
-                 *
-                 * Use the [known] method instead if you're certain the value is always known or if
-                 * you want to throw for the unknown case.
-                 */
-                fun value(): Value =
-                    when (this) {
-                        TEXT -> Value.TEXT
-                        else -> Value._UNKNOWN
-                    }
-
-                /**
-                 * Returns an enum member corresponding to this class instance's value.
-                 *
-                 * Use the [value] method instead if you're uncertain the value is always known and
-                 * don't want to throw for the unknown case.
-                 *
-                 * @throws LlamaCloudInvalidDataException if this class instance's value is a not a
-                 *   known member.
-                 */
-                fun known(): Known =
-                    when (this) {
-                        TEXT -> Known.TEXT
-                        else -> throw LlamaCloudInvalidDataException("Unknown Type: $value")
-                    }
-
-                /**
-                 * Returns this class instance's primitive wire representation.
-                 *
-                 * This differs from the [toString] method because that method is primarily for
-                 * debugging and generally doesn't throw.
-                 *
-                 * @throws LlamaCloudInvalidDataException if this class instance's value does not
-                 *   have the expected primitive type.
-                 */
-                fun asString(): String =
-                    _value().asString().orElseThrow {
-                        LlamaCloudInvalidDataException("Value is not a String")
-                    }
-
-                private var validated: Boolean = false
-
-                /**
-                 * Validates that the types of all values in this object match their expected types
-                 * recursively.
-                 *
-                 * This method is _not_ forwards compatible with new types from the API for existing
-                 * fields.
-                 *
-                 * @throws LlamaCloudInvalidDataException if any value type in this object doesn't
-                 *   match its expected type.
-                 */
-                fun validate(): Type = apply {
-                    if (validated) {
-                        return@apply
-                    }
-
-                    known()
-                    validated = true
-                }
-
-                fun isValid(): Boolean =
-                    try {
-                        validate()
-                        true
-                    } catch (e: LlamaCloudInvalidDataException) {
-                        false
-                    }
-
-                /**
-                 * Returns a score indicating how many valid values are contained in this object
-                 * recursively.
-                 *
-                 * Used for best match union deserialization.
-                 */
-                @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
-
-                override fun equals(other: Any?): Boolean {
-                    if (this === other) {
-                        return true
-                    }
-
-                    return other is Type && value == other.value
-                }
-
-                override fun hashCode() = value.hashCode()
-
-                override fun toString() = value.toString()
-            }
-
-            override fun equals(other: Any?): Boolean {
-                if (this === other) {
-                    return true
-                }
-
-                return other is Text &&
-                    value == other.value &&
-                    bbox == other.bbox &&
-                    grounding == other.grounding &&
-                    type == other.type &&
-                    additionalProperties == other.additionalProperties
-            }
-
-            private val hashCode: Int by lazy {
-                Objects.hash(value, bbox, grounding, type, additionalProperties)
-            }
-
-            override fun hashCode(): Int = hashCode
-
-            override fun toString() =
-                "Text{value=$value, bbox=$bbox, grounding=$grounding, type=$type, additionalProperties=$additionalProperties}"
-        }
     }
 
     override fun equals(other: Any?): Boolean {
diff --git a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/FormText.kt b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/FormText.kt
new file mode 100644
index 0000000..5fef287
--- /dev/null
+++ b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/FormText.kt
@@ -0,0 +1,2855 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package ai.llamaindex.llamacloud.models.parsing
+
+import ai.llamaindex.llamacloud.core.Enum
+import ai.llamaindex.llamacloud.core.ExcludeMissing
+import ai.llamaindex.llamacloud.core.JsonField
+import ai.llamaindex.llamacloud.core.JsonMissing
+import ai.llamaindex.llamacloud.core.JsonValue
+import ai.llamaindex.llamacloud.core.checkKnown
+import ai.llamaindex.llamacloud.core.checkRequired
+import ai.llamaindex.llamacloud.core.toImmutable
+import ai.llamaindex.llamacloud.errors.LlamaCloudInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * Printed text that is not part of a field, section heading or table: a title, an instruction, a
+ * note. With it the form JSON holds every printed word of its region.
+ */
+class FormText
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val value: JsonField<String>,
+    private val bbox: JsonField<List<BBox>>,
+    private val grounding: JsonField<Grounding>,
+    private val type: JsonField<Type>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("value") @ExcludeMissing value: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("bbox") @ExcludeMissing bbox: JsonField<List<BBox>> = JsonMissing.of(),
+        @JsonProperty("grounding")
+        @ExcludeMissing
+        grounding: JsonField<Grounding> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonField<Type> = JsonMissing.of(),
+    ) : this(value, bbox, grounding, type, mutableMapOf())
+
+    /**
+     * The printed text, verbatim
+     *
+     * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun value(): String = value.getRequired("value")
+
+    /**
+     * Bounding boxes of the text on the page, if attributed.
+     *
+     * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun bbox(): Optional<List<BBox>> = bbox.getOptional("bbox")
+
+    /**
+     * Optional grounding for a field's printed text; boolean states have no text spans.
+     *
+     * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun grounding(): Optional<Grounding> = grounding.getOptional("grounding")
+
+    /**
+     * Form text node
+     *
+     * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun type(): Optional<Type> = type.getOptional("type")
+
+    /**
+     * Returns the raw JSON value of [value].
+     *
+     * Unlike [value], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("value") @ExcludeMissing fun _value(): JsonField<String> = value
+
+    /**
+     * Returns the raw JSON value of [bbox].
+     *
+     * Unlike [bbox], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("bbox") @ExcludeMissing fun _bbox(): JsonField<List<BBox>> = bbox
+
+    /**
+     * Returns the raw JSON value of [grounding].
+     *
+     * Unlike [grounding], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("grounding") @ExcludeMissing fun _grounding(): JsonField<Grounding> = grounding
+
+    /**
+     * Returns the raw JSON value of [type].
+     *
+     * Unlike [type], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonField<Type> = type
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [FormText].
+         *
+         * The following fields are required:
+         * ```java
+         * .value()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [FormText]. */
+    class Builder internal constructor() {
+
+        private var value: JsonField<String>? = null
+        private var bbox: JsonField<MutableList<BBox>>? = null
+        private var grounding: JsonField<Grounding> = JsonMissing.of()
+        private var type: JsonField<Type> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(formText: FormText) = apply {
+            value = formText.value
+            bbox = formText.bbox.map { it.toMutableList() }
+            grounding = formText.grounding
+            type = formText.type
+            additionalProperties = formText.additionalProperties.toMutableMap()
+        }
+
+        /** The printed text, verbatim */
+        fun value(value: String) = value(JsonField.of(value))
+
+        /**
+         * Sets [Builder.value] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.value] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun value(value: JsonField<String>) = apply { this.value = value }
+
+        /** Bounding boxes of the text on the page, if attributed. */
+        fun bbox(bbox: List<BBox>?) = bbox(JsonField.ofNullable(bbox))
+
+        /** Alias for calling [Builder.bbox] with `bbox.orElse(null)`. */
+        fun bbox(bbox: Optional<List<BBox>>) = bbox(bbox.getOrNull())
+
+        /**
+         * Sets [Builder.bbox] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.bbox] with a well-typed `List<BBox>` value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun bbox(bbox: JsonField<List<BBox>>) = apply {
+            this.bbox = bbox.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [BBox] to [Builder.bbox].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addBbox(bbox: BBox) = apply {
+            this.bbox =
+                (this.bbox ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("bbox", it).add(bbox)
+                }
+        }
+
+        /** Optional grounding for a field's printed text; boolean states have no text spans. */
+        fun grounding(grounding: Grounding?) = grounding(JsonField.ofNullable(grounding))
+
+        /** Alias for calling [Builder.grounding] with `grounding.orElse(null)`. */
+        fun grounding(grounding: Optional<Grounding>) = grounding(grounding.getOrNull())
+
+        /**
+         * Sets [Builder.grounding] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.grounding] with a well-typed [Grounding] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun grounding(grounding: JsonField<Grounding>) = apply { this.grounding = grounding }
+
+        /** Form text node */
+        fun type(type: Type) = type(JsonField.of(type))
+
+        /**
+         * Sets [Builder.type] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.type] with a well-typed [Type] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun type(type: JsonField<Type>) = apply { this.type = type }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [FormText].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .value()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): FormText =
+            FormText(
+                checkRequired("value", value),
+                (bbox ?: JsonMissing.of()).map { it.toImmutable() },
+                grounding,
+                type,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws LlamaCloudInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): FormText = apply {
+        if (validated) {
+            return@apply
+        }
+
+        value()
+        bbox().ifPresent { it.forEach { it.validate() } }
+        grounding().ifPresent { it.validate() }
+        type().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: LlamaCloudInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (value.asKnown().isPresent) 1 else 0) +
+            (bbox.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            (grounding.asKnown().getOrNull()?.validity() ?: 0) +
+            (type.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** Optional grounding for a field's printed text; boolean states have no text spans. */
+    class Grounding
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<Id>,
+        private val label: JsonField<Label>,
+        private val value: JsonField<Value>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<Id> = JsonMissing.of(),
+            @JsonProperty("label") @ExcludeMissing label: JsonField<Label> = JsonMissing.of(),
+            @JsonProperty("value") @ExcludeMissing value: JsonField<Value> = JsonMissing.of(),
+        ) : this(id, label, value, mutableMapOf())
+
+        /**
+         * Supported text with half-open UTF-8 byte spans into the complete property string.
+         *
+         * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g. if
+         *   the server responded with an unexpected value).
+         */
+        fun id(): Optional<Id> = id.getOptional("id")
+
+        /**
+         * Supported text with half-open UTF-8 byte spans into the complete property string.
+         *
+         * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g. if
+         *   the server responded with an unexpected value).
+         */
+        fun label(): Optional<Label> = label.getOptional("label")
+
+        /**
+         * Supported text with half-open UTF-8 byte spans into the complete property string.
+         *
+         * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g. if
+         *   the server responded with an unexpected value).
+         */
+        fun value(): Optional<Value> = value.getOptional("value")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<Id> = id
+
+        /**
+         * Returns the raw JSON value of [label].
+         *
+         * Unlike [label], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("label") @ExcludeMissing fun _label(): JsonField<Label> = label
+
+        /**
+         * Returns the raw JSON value of [value].
+         *
+         * Unlike [value], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("value") @ExcludeMissing fun _value(): JsonField<Value> = value
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Grounding]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Grounding]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<Id> = JsonMissing.of()
+            private var label: JsonField<Label> = JsonMissing.of()
+            private var value: JsonField<Value> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(grounding: Grounding) = apply {
+                id = grounding.id
+                label = grounding.label
+                value = grounding.value
+                additionalProperties = grounding.additionalProperties.toMutableMap()
+            }
+
+            /** Supported text with half-open UTF-8 byte spans into the complete property string. */
+            fun id(id: Id?) = id(JsonField.ofNullable(id))
+
+            /** Alias for calling [Builder.id] with `id.orElse(null)`. */
+            fun id(id: Optional<Id>) = id(id.getOrNull())
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [Id] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<Id>) = apply { this.id = id }
+
+            /** Supported text with half-open UTF-8 byte spans into the complete property string. */
+            fun label(label: Label?) = label(JsonField.ofNullable(label))
+
+            /** Alias for calling [Builder.label] with `label.orElse(null)`. */
+            fun label(label: Optional<Label>) = label(label.getOrNull())
+
+            /**
+             * Sets [Builder.label] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.label] with a well-typed [Label] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun label(label: JsonField<Label>) = apply { this.label = label }
+
+            /** Supported text with half-open UTF-8 byte spans into the complete property string. */
+            fun value(value: Value?) = value(JsonField.ofNullable(value))
+
+            /** Alias for calling [Builder.value] with `value.orElse(null)`. */
+            fun value(value: Optional<Value>) = value(value.getOrNull())
+
+            /**
+             * Sets [Builder.value] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.value] with a well-typed [Value] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun value(value: JsonField<Value>) = apply { this.value = value }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Grounding].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Grounding =
+                Grounding(id, label, value, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws LlamaCloudInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Grounding = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id().ifPresent { it.validate() }
+            label().ifPresent { it.validate() }
+            value().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: LlamaCloudInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (id.asKnown().getOrNull()?.validity() ?: 0) +
+                (label.asKnown().getOrNull()?.validity() ?: 0) +
+                (value.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** Supported text with half-open UTF-8 byte spans into the complete property string. */
+        class Id
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val lines: JsonField<List<Line>>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("lines")
+                @ExcludeMissing
+                lines: JsonField<List<Line>> = JsonMissing.of()
+            ) : this(lines, mutableMapOf())
+
+            /**
+             * Supported lines. Word requests include supported words; gaps are valid. Boxes use
+             * final page coordinates and optional local rotation r.
+             *
+             * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun lines(): List<Line> = lines.getRequired("lines")
+
+            /**
+             * Returns the raw JSON value of [lines].
+             *
+             * Unlike [lines], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("lines") @ExcludeMissing fun _lines(): JsonField<List<Line>> = lines
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Id].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .lines()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Id]. */
+            class Builder internal constructor() {
+
+                private var lines: JsonField<MutableList<Line>>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(id: Id) = apply {
+                    lines = id.lines.map { it.toMutableList() }
+                    additionalProperties = id.additionalProperties.toMutableMap()
+                }
+
+                /**
+                 * Supported lines. Word requests include supported words; gaps are valid. Boxes use
+                 * final page coordinates and optional local rotation r.
+                 */
+                fun lines(lines: List<Line>) = lines(JsonField.of(lines))
+
+                /**
+                 * Sets [Builder.lines] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.lines] with a well-typed `List<Line>` value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun lines(lines: JsonField<List<Line>>) = apply {
+                    this.lines = lines.map { it.toMutableList() }
+                }
+
+                /**
+                 * Adds a single [Line] to [lines].
+                 *
+                 * @throws IllegalStateException if the field was previously set to a non-list.
+                 */
+                fun addLine(line: Line) = apply {
+                    lines =
+                        (lines ?: JsonField.of(mutableListOf())).also {
+                            checkKnown("lines", it).add(line)
+                        }
+                }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Id].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .lines()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Id =
+                    Id(
+                        checkRequired("lines", lines).map { it.toImmutable() },
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws LlamaCloudInvalidDataException if any value type in this object doesn't match
+             *   its expected type.
+             */
+            fun validate(): Id = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                lines().forEach { it.validate() }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: LlamaCloudInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (lines.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
+
+            /** One grounded line of text with an optional per-word breakdown. */
+            class Line
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val bbox: JsonField<BBox>,
+                private val span: JsonField<List<JsonValue>>,
+                private val words: JsonField<List<Word>>,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("bbox") @ExcludeMissing bbox: JsonField<BBox> = JsonMissing.of(),
+                    @JsonProperty("span")
+                    @ExcludeMissing
+                    span: JsonField<List<JsonValue>> = JsonMissing.of(),
+                    @JsonProperty("words")
+                    @ExcludeMissing
+                    words: JsonField<List<Word>> = JsonMissing.of(),
+                ) : this(bbox, span, words, mutableMapOf())
+
+                /**
+                 * Line bounding box
+                 *
+                 * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type
+                 *   or is unexpectedly missing or null (e.g. if the server responded with an
+                 *   unexpected value).
+                 */
+                fun bbox(): BBox = bbox.getRequired("bbox")
+
+                /**
+                 * `[start, end)` UTF-8 byte span in the complete source property string
+                 *
+                 * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type
+                 *   or is unexpectedly missing or null (e.g. if the server responded with an
+                 *   unexpected value).
+                 */
+                fun span(): List<JsonValue> = span.getRequired("span")
+
+                /**
+                 * Per-word grounding within the line, when available
+                 *
+                 * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type
+                 *   (e.g. if the server responded with an unexpected value).
+                 */
+                fun words(): Optional<List<Word>> = words.getOptional("words")
+
+                /**
+                 * Returns the raw JSON value of [bbox].
+                 *
+                 * Unlike [bbox], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("bbox") @ExcludeMissing fun _bbox(): JsonField<BBox> = bbox
+
+                /**
+                 * Returns the raw JSON value of [span].
+                 *
+                 * Unlike [span], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("span") @ExcludeMissing fun _span(): JsonField<List<JsonValue>> = span
+
+                /**
+                 * Returns the raw JSON value of [words].
+                 *
+                 * Unlike [words], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("words") @ExcludeMissing fun _words(): JsonField<List<Word>> = words
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [Line].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .bbox()
+                     * .span()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [Line]. */
+                class Builder internal constructor() {
+
+                    private var bbox: JsonField<BBox>? = null
+                    private var span: JsonField<MutableList<JsonValue>>? = null
+                    private var words: JsonField<MutableList<Word>>? = null
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(line: Line) = apply {
+                        bbox = line.bbox
+                        span = line.span.map { it.toMutableList() }
+                        words = line.words.map { it.toMutableList() }
+                        additionalProperties = line.additionalProperties.toMutableMap()
+                    }
+
+                    /** Line bounding box */
+                    fun bbox(bbox: BBox) = bbox(JsonField.of(bbox))
+
+                    /**
+                     * Sets [Builder.bbox] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.bbox] with a well-typed [BBox] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun bbox(bbox: JsonField<BBox>) = apply { this.bbox = bbox }
+
+                    /** `[start, end)` UTF-8 byte span in the complete source property string */
+                    fun span(span: List<JsonValue>) = span(JsonField.of(span))
+
+                    /**
+                     * Sets [Builder.span] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.span] with a well-typed `List<JsonValue>`
+                     * value instead. This method is primarily for setting the field to an
+                     * undocumented or not yet supported value.
+                     */
+                    fun span(span: JsonField<List<JsonValue>>) = apply {
+                        this.span = span.map { it.toMutableList() }
+                    }
+
+                    /**
+                     * Adds a single [JsonValue] to [Builder.span].
+                     *
+                     * @throws IllegalStateException if the field was previously set to a non-list.
+                     */
+                    fun addSpan(span: JsonValue) = apply {
+                        this.span =
+                            (this.span ?: JsonField.of(mutableListOf())).also {
+                                checkKnown("span", it).add(span)
+                            }
+                    }
+
+                    /** Per-word grounding within the line, when available */
+                    fun words(words: List<Word>?) = words(JsonField.ofNullable(words))
+
+                    /** Alias for calling [Builder.words] with `words.orElse(null)`. */
+                    fun words(words: Optional<List<Word>>) = words(words.getOrNull())
+
+                    /**
+                     * Sets [Builder.words] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.words] with a well-typed `List<Word>` value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun words(words: JsonField<List<Word>>) = apply {
+                        this.words = words.map { it.toMutableList() }
+                    }
+
+                    /**
+                     * Adds a single [Word] to [words].
+                     *
+                     * @throws IllegalStateException if the field was previously set to a non-list.
+                     */
+                    fun addWord(word: Word) = apply {
+                        words =
+                            (words ?: JsonField.of(mutableListOf())).also {
+                                checkKnown("words", it).add(word)
+                            }
+                    }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [Line].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .bbox()
+                     * .span()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): Line =
+                        Line(
+                            checkRequired("bbox", bbox),
+                            checkRequired("span", span).map { it.toImmutable() },
+                            (words ?: JsonMissing.of()).map { it.toImmutable() },
+                            additionalProperties.toMutableMap(),
+                        )
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws LlamaCloudInvalidDataException if any value type in this object doesn't
+                 *   match its expected type.
+                 */
+                fun validate(): Line = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    bbox().validate()
+                    span()
+                    words().ifPresent { it.forEach { it.validate() } }
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: LlamaCloudInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (bbox.asKnown().getOrNull()?.validity() ?: 0) +
+                        (span.asKnown().getOrNull()?.size ?: 0) +
+                        (words.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
+
+                /** One grounded word: a `[start, end)` span in the source text and its bbox. */
+                class Word
+                @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+                private constructor(
+                    private val bbox: JsonField<BBox>,
+                    private val span: JsonField<List<JsonValue>>,
+                    private val additionalProperties: MutableMap<String, JsonValue>,
+                ) {
+
+                    @JsonCreator
+                    private constructor(
+                        @JsonProperty("bbox")
+                        @ExcludeMissing
+                        bbox: JsonField<BBox> = JsonMissing.of(),
+                        @JsonProperty("span")
+                        @ExcludeMissing
+                        span: JsonField<List<JsonValue>> = JsonMissing.of(),
+                    ) : this(bbox, span, mutableMapOf())
+
+                    /**
+                     * Word bounding box
+                     *
+                     * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected
+                     *   type or is unexpectedly missing or null (e.g. if the server responded with
+                     *   an unexpected value).
+                     */
+                    fun bbox(): BBox = bbox.getRequired("bbox")
+
+                    /**
+                     * `[start, end)` UTF-8 byte span in the complete source property string
+                     *
+                     * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected
+                     *   type or is unexpectedly missing or null (e.g. if the server responded with
+                     *   an unexpected value).
+                     */
+                    fun span(): List<JsonValue> = span.getRequired("span")
+
+                    /**
+                     * Returns the raw JSON value of [bbox].
+                     *
+                     * Unlike [bbox], this method doesn't throw if the JSON field has an unexpected
+                     * type.
+                     */
+                    @JsonProperty("bbox") @ExcludeMissing fun _bbox(): JsonField<BBox> = bbox
+
+                    /**
+                     * Returns the raw JSON value of [span].
+                     *
+                     * Unlike [span], this method doesn't throw if the JSON field has an unexpected
+                     * type.
+                     */
+                    @JsonProperty("span")
+                    @ExcludeMissing
+                    fun _span(): JsonField<List<JsonValue>> = span
+
+                    @JsonAnySetter
+                    private fun putAdditionalProperty(key: String, value: JsonValue) {
+                        additionalProperties.put(key, value)
+                    }
+
+                    @JsonAnyGetter
+                    @ExcludeMissing
+                    fun _additionalProperties(): Map<String, JsonValue> =
+                        Collections.unmodifiableMap(additionalProperties)
+
+                    fun toBuilder() = Builder().from(this)
+
+                    companion object {
+
+                        /**
+                         * Returns a mutable builder for constructing an instance of [Word].
+                         *
+                         * The following fields are required:
+                         * ```java
+                         * .bbox()
+                         * .span()
+                         * ```
+                         */
+                        @JvmStatic fun builder() = Builder()
+                    }
+
+                    /** A builder for [Word]. */
+                    class Builder internal constructor() {
+
+                        private var bbox: JsonField<BBox>? = null
+                        private var span: JsonField<MutableList<JsonValue>>? = null
+                        private var additionalProperties: MutableMap<String, JsonValue> =
+                            mutableMapOf()
+
+                        @JvmSynthetic
+                        internal fun from(word: Word) = apply {
+                            bbox = word.bbox
+                            span = word.span.map { it.toMutableList() }
+                            additionalProperties = word.additionalProperties.toMutableMap()
+                        }
+
+                        /** Word bounding box */
+                        fun bbox(bbox: BBox) = bbox(JsonField.of(bbox))
+
+                        /**
+                         * Sets [Builder.bbox] to an arbitrary JSON value.
+                         *
+                         * You should usually call [Builder.bbox] with a well-typed [BBox] value
+                         * instead. This method is primarily for setting the field to an
+                         * undocumented or not yet supported value.
+                         */
+                        fun bbox(bbox: JsonField<BBox>) = apply { this.bbox = bbox }
+
+                        /** `[start, end)` UTF-8 byte span in the complete source property string */
+                        fun span(span: List<JsonValue>) = span(JsonField.of(span))
+
+                        /**
+                         * Sets [Builder.span] to an arbitrary JSON value.
+                         *
+                         * You should usually call [Builder.span] with a well-typed
+                         * `List<JsonValue>` value instead. This method is primarily for setting the
+                         * field to an undocumented or not yet supported value.
+                         */
+                        fun span(span: JsonField<List<JsonValue>>) = apply {
+                            this.span = span.map { it.toMutableList() }
+                        }
+
+                        /**
+                         * Adds a single [JsonValue] to [Builder.span].
+                         *
+                         * @throws IllegalStateException if the field was previously set to a
+                         *   non-list.
+                         */
+                        fun addSpan(span: JsonValue) = apply {
+                            this.span =
+                                (this.span ?: JsonField.of(mutableListOf())).also {
+                                    checkKnown("span", it).add(span)
+                                }
+                        }
+
+                        fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
+                            apply {
+                                this.additionalProperties.clear()
+                                putAllAdditionalProperties(additionalProperties)
+                            }
+
+                        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                            additionalProperties.put(key, value)
+                        }
+
+                        fun putAllAdditionalProperties(
+                            additionalProperties: Map<String, JsonValue>
+                        ) = apply { this.additionalProperties.putAll(additionalProperties) }
+
+                        fun removeAdditionalProperty(key: String) = apply {
+                            additionalProperties.remove(key)
+                        }
+
+                        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                            keys.forEach(::removeAdditionalProperty)
+                        }
+
+                        /**
+                         * Returns an immutable instance of [Word].
+                         *
+                         * Further updates to this [Builder] will not mutate the returned instance.
+                         *
+                         * The following fields are required:
+                         * ```java
+                         * .bbox()
+                         * .span()
+                         * ```
+                         *
+                         * @throws IllegalStateException if any required field is unset.
+                         */
+                        fun build(): Word =
+                            Word(
+                                checkRequired("bbox", bbox),
+                                checkRequired("span", span).map { it.toImmutable() },
+                                additionalProperties.toMutableMap(),
+                            )
+                    }
+
+                    private var validated: Boolean = false
+
+                    /**
+                     * Validates that the types of all values in this object match their expected
+                     * types recursively.
+                     *
+                     * This method is _not_ forwards compatible with new types from the API for
+                     * existing fields.
+                     *
+                     * @throws LlamaCloudInvalidDataException if any value type in this object
+                     *   doesn't match its expected type.
+                     */
+                    fun validate(): Word = apply {
+                        if (validated) {
+                            return@apply
+                        }
+
+                        bbox().validate()
+                        span()
+                        validated = true
+                    }
+
+                    fun isValid(): Boolean =
+                        try {
+                            validate()
+                            true
+                        } catch (e: LlamaCloudInvalidDataException) {
+                            false
+                        }
+
+                    /**
+                     * Returns a score indicating how many valid values are contained in this object
+                     * recursively.
+                     *
+                     * Used for best match union deserialization.
+                     */
+                    @JvmSynthetic
+                    internal fun validity(): Int =
+                        (bbox.asKnown().getOrNull()?.validity() ?: 0) +
+                            (span.asKnown().getOrNull()?.size ?: 0)
+
+                    override fun equals(other: Any?): Boolean {
+                        if (this === other) {
+                            return true
+                        }
+
+                        return other is Word &&
+                            bbox == other.bbox &&
+                            span == other.span &&
+                            additionalProperties == other.additionalProperties
+                    }
+
+                    private val hashCode: Int by lazy {
+                        Objects.hash(bbox, span, additionalProperties)
+                    }
+
+                    override fun hashCode(): Int = hashCode
+
+                    override fun toString() =
+                        "Word{bbox=$bbox, span=$span, additionalProperties=$additionalProperties}"
+                }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Line &&
+                        bbox == other.bbox &&
+                        span == other.span &&
+                        words == other.words &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy {
+                    Objects.hash(bbox, span, words, additionalProperties)
+                }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "Line{bbox=$bbox, span=$span, words=$words, additionalProperties=$additionalProperties}"
+            }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Id &&
+                    lines == other.lines &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(lines, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() = "Id{lines=$lines, additionalProperties=$additionalProperties}"
+        }
+
+        /** Supported text with half-open UTF-8 byte spans into the complete property string. */
+        class Label
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val lines: JsonField<List<Line>>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("lines")
+                @ExcludeMissing
+                lines: JsonField<List<Line>> = JsonMissing.of()
+            ) : this(lines, mutableMapOf())
+
+            /**
+             * Supported lines. Word requests include supported words; gaps are valid. Boxes use
+             * final page coordinates and optional local rotation r.
+             *
+             * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun lines(): List<Line> = lines.getRequired("lines")
+
+            /**
+             * Returns the raw JSON value of [lines].
+             *
+             * Unlike [lines], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("lines") @ExcludeMissing fun _lines(): JsonField<List<Line>> = lines
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Label].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .lines()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Label]. */
+            class Builder internal constructor() {
+
+                private var lines: JsonField<MutableList<Line>>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(label: Label) = apply {
+                    lines = label.lines.map { it.toMutableList() }
+                    additionalProperties = label.additionalProperties.toMutableMap()
+                }
+
+                /**
+                 * Supported lines. Word requests include supported words; gaps are valid. Boxes use
+                 * final page coordinates and optional local rotation r.
+                 */
+                fun lines(lines: List<Line>) = lines(JsonField.of(lines))
+
+                /**
+                 * Sets [Builder.lines] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.lines] with a well-typed `List<Line>` value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun lines(lines: JsonField<List<Line>>) = apply {
+                    this.lines = lines.map { it.toMutableList() }
+                }
+
+                /**
+                 * Adds a single [Line] to [lines].
+                 *
+                 * @throws IllegalStateException if the field was previously set to a non-list.
+                 */
+                fun addLine(line: Line) = apply {
+                    lines =
+                        (lines ?: JsonField.of(mutableListOf())).also {
+                            checkKnown("lines", it).add(line)
+                        }
+                }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Label].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .lines()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Label =
+                    Label(
+                        checkRequired("lines", lines).map { it.toImmutable() },
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws LlamaCloudInvalidDataException if any value type in this object doesn't match
+             *   its expected type.
+             */
+            fun validate(): Label = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                lines().forEach { it.validate() }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: LlamaCloudInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (lines.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
+
+            /** One grounded line of text with an optional per-word breakdown. */
+            class Line
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val bbox: JsonField<BBox>,
+                private val span: JsonField<List<JsonValue>>,
+                private val words: JsonField<List<Word>>,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("bbox") @ExcludeMissing bbox: JsonField<BBox> = JsonMissing.of(),
+                    @JsonProperty("span")
+                    @ExcludeMissing
+                    span: JsonField<List<JsonValue>> = JsonMissing.of(),
+                    @JsonProperty("words")
+                    @ExcludeMissing
+                    words: JsonField<List<Word>> = JsonMissing.of(),
+                ) : this(bbox, span, words, mutableMapOf())
+
+                /**
+                 * Line bounding box
+                 *
+                 * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type
+                 *   or is unexpectedly missing or null (e.g. if the server responded with an
+                 *   unexpected value).
+                 */
+                fun bbox(): BBox = bbox.getRequired("bbox")
+
+                /**
+                 * `[start, end)` UTF-8 byte span in the complete source property string
+                 *
+                 * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type
+                 *   or is unexpectedly missing or null (e.g. if the server responded with an
+                 *   unexpected value).
+                 */
+                fun span(): List<JsonValue> = span.getRequired("span")
+
+                /**
+                 * Per-word grounding within the line, when available
+                 *
+                 * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type
+                 *   (e.g. if the server responded with an unexpected value).
+                 */
+                fun words(): Optional<List<Word>> = words.getOptional("words")
+
+                /**
+                 * Returns the raw JSON value of [bbox].
+                 *
+                 * Unlike [bbox], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("bbox") @ExcludeMissing fun _bbox(): JsonField<BBox> = bbox
+
+                /**
+                 * Returns the raw JSON value of [span].
+                 *
+                 * Unlike [span], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("span") @ExcludeMissing fun _span(): JsonField<List<JsonValue>> = span
+
+                /**
+                 * Returns the raw JSON value of [words].
+                 *
+                 * Unlike [words], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("words") @ExcludeMissing fun _words(): JsonField<List<Word>> = words
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [Line].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .bbox()
+                     * .span()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [Line]. */
+                class Builder internal constructor() {
+
+                    private var bbox: JsonField<BBox>? = null
+                    private var span: JsonField<MutableList<JsonValue>>? = null
+                    private var words: JsonField<MutableList<Word>>? = null
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(line: Line) = apply {
+                        bbox = line.bbox
+                        span = line.span.map { it.toMutableList() }
+                        words = line.words.map { it.toMutableList() }
+                        additionalProperties = line.additionalProperties.toMutableMap()
+                    }
+
+                    /** Line bounding box */
+                    fun bbox(bbox: BBox) = bbox(JsonField.of(bbox))
+
+                    /**
+                     * Sets [Builder.bbox] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.bbox] with a well-typed [BBox] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun bbox(bbox: JsonField<BBox>) = apply { this.bbox = bbox }
+
+                    /** `[start, end)` UTF-8 byte span in the complete source property string */
+                    fun span(span: List<JsonValue>) = span(JsonField.of(span))
+
+                    /**
+                     * Sets [Builder.span] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.span] with a well-typed `List<JsonValue>`
+                     * value instead. This method is primarily for setting the field to an
+                     * undocumented or not yet supported value.
+                     */
+                    fun span(span: JsonField<List<JsonValue>>) = apply {
+                        this.span = span.map { it.toMutableList() }
+                    }
+
+                    /**
+                     * Adds a single [JsonValue] to [Builder.span].
+                     *
+                     * @throws IllegalStateException if the field was previously set to a non-list.
+                     */
+                    fun addSpan(span: JsonValue) = apply {
+                        this.span =
+                            (this.span ?: JsonField.of(mutableListOf())).also {
+                                checkKnown("span", it).add(span)
+                            }
+                    }
+
+                    /** Per-word grounding within the line, when available */
+                    fun words(words: List<Word>?) = words(JsonField.ofNullable(words))
+
+                    /** Alias for calling [Builder.words] with `words.orElse(null)`. */
+                    fun words(words: Optional<List<Word>>) = words(words.getOrNull())
+
+                    /**
+                     * Sets [Builder.words] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.words] with a well-typed `List<Word>` value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun words(words: JsonField<List<Word>>) = apply {
+                        this.words = words.map { it.toMutableList() }
+                    }
+
+                    /**
+                     * Adds a single [Word] to [words].
+                     *
+                     * @throws IllegalStateException if the field was previously set to a non-list.
+                     */
+                    fun addWord(word: Word) = apply {
+                        words =
+                            (words ?: JsonField.of(mutableListOf())).also {
+                                checkKnown("words", it).add(word)
+                            }
+                    }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [Line].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .bbox()
+                     * .span()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): Line =
+                        Line(
+                            checkRequired("bbox", bbox),
+                            checkRequired("span", span).map { it.toImmutable() },
+                            (words ?: JsonMissing.of()).map { it.toImmutable() },
+                            additionalProperties.toMutableMap(),
+                        )
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws LlamaCloudInvalidDataException if any value type in this object doesn't
+                 *   match its expected type.
+                 */
+                fun validate(): Line = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    bbox().validate()
+                    span()
+                    words().ifPresent { it.forEach { it.validate() } }
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: LlamaCloudInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (bbox.asKnown().getOrNull()?.validity() ?: 0) +
+                        (span.asKnown().getOrNull()?.size ?: 0) +
+                        (words.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
+
+                /** One grounded word: a `[start, end)` span in the source text and its bbox. */
+                class Word
+                @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+                private constructor(
+                    private val bbox: JsonField<BBox>,
+                    private val span: JsonField<List<JsonValue>>,
+                    private val additionalProperties: MutableMap<String, JsonValue>,
+                ) {
+
+                    @JsonCreator
+                    private constructor(
+                        @JsonProperty("bbox")
+                        @ExcludeMissing
+                        bbox: JsonField<BBox> = JsonMissing.of(),
+                        @JsonProperty("span")
+                        @ExcludeMissing
+                        span: JsonField<List<JsonValue>> = JsonMissing.of(),
+                    ) : this(bbox, span, mutableMapOf())
+
+                    /**
+                     * Word bounding box
+                     *
+                     * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected
+                     *   type or is unexpectedly missing or null (e.g. if the server responded with
+                     *   an unexpected value).
+                     */
+                    fun bbox(): BBox = bbox.getRequired("bbox")
+
+                    /**
+                     * `[start, end)` UTF-8 byte span in the complete source property string
+                     *
+                     * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected
+                     *   type or is unexpectedly missing or null (e.g. if the server responded with
+                     *   an unexpected value).
+                     */
+                    fun span(): List<JsonValue> = span.getRequired("span")
+
+                    /**
+                     * Returns the raw JSON value of [bbox].
+                     *
+                     * Unlike [bbox], this method doesn't throw if the JSON field has an unexpected
+                     * type.
+                     */
+                    @JsonProperty("bbox") @ExcludeMissing fun _bbox(): JsonField<BBox> = bbox
+
+                    /**
+                     * Returns the raw JSON value of [span].
+                     *
+                     * Unlike [span], this method doesn't throw if the JSON field has an unexpected
+                     * type.
+                     */
+                    @JsonProperty("span")
+                    @ExcludeMissing
+                    fun _span(): JsonField<List<JsonValue>> = span
+
+                    @JsonAnySetter
+                    private fun putAdditionalProperty(key: String, value: JsonValue) {
+                        additionalProperties.put(key, value)
+                    }
+
+                    @JsonAnyGetter
+                    @ExcludeMissing
+                    fun _additionalProperties(): Map<String, JsonValue> =
+                        Collections.unmodifiableMap(additionalProperties)
+
+                    fun toBuilder() = Builder().from(this)
+
+                    companion object {
+
+                        /**
+                         * Returns a mutable builder for constructing an instance of [Word].
+                         *
+                         * The following fields are required:
+                         * ```java
+                         * .bbox()
+                         * .span()
+                         * ```
+                         */
+                        @JvmStatic fun builder() = Builder()
+                    }
+
+                    /** A builder for [Word]. */
+                    class Builder internal constructor() {
+
+                        private var bbox: JsonField<BBox>? = null
+                        private var span: JsonField<MutableList<JsonValue>>? = null
+                        private var additionalProperties: MutableMap<String, JsonValue> =
+                            mutableMapOf()
+
+                        @JvmSynthetic
+                        internal fun from(word: Word) = apply {
+                            bbox = word.bbox
+                            span = word.span.map { it.toMutableList() }
+                            additionalProperties = word.additionalProperties.toMutableMap()
+                        }
+
+                        /** Word bounding box */
+                        fun bbox(bbox: BBox) = bbox(JsonField.of(bbox))
+
+                        /**
+                         * Sets [Builder.bbox] to an arbitrary JSON value.
+                         *
+                         * You should usually call [Builder.bbox] with a well-typed [BBox] value
+                         * instead. This method is primarily for setting the field to an
+                         * undocumented or not yet supported value.
+                         */
+                        fun bbox(bbox: JsonField<BBox>) = apply { this.bbox = bbox }
+
+                        /** `[start, end)` UTF-8 byte span in the complete source property string */
+                        fun span(span: List<JsonValue>) = span(JsonField.of(span))
+
+                        /**
+                         * Sets [Builder.span] to an arbitrary JSON value.
+                         *
+                         * You should usually call [Builder.span] with a well-typed
+                         * `List<JsonValue>` value instead. This method is primarily for setting the
+                         * field to an undocumented or not yet supported value.
+                         */
+                        fun span(span: JsonField<List<JsonValue>>) = apply {
+                            this.span = span.map { it.toMutableList() }
+                        }
+
+                        /**
+                         * Adds a single [JsonValue] to [Builder.span].
+                         *
+                         * @throws IllegalStateException if the field was previously set to a
+                         *   non-list.
+                         */
+                        fun addSpan(span: JsonValue) = apply {
+                            this.span =
+                                (this.span ?: JsonField.of(mutableListOf())).also {
+                                    checkKnown("span", it).add(span)
+                                }
+                        }
+
+                        fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
+                            apply {
+                                this.additionalProperties.clear()
+                                putAllAdditionalProperties(additionalProperties)
+                            }
+
+                        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                            additionalProperties.put(key, value)
+                        }
+
+                        fun putAllAdditionalProperties(
+                            additionalProperties: Map<String, JsonValue>
+                        ) = apply { this.additionalProperties.putAll(additionalProperties) }
+
+                        fun removeAdditionalProperty(key: String) = apply {
+                            additionalProperties.remove(key)
+                        }
+
+                        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                            keys.forEach(::removeAdditionalProperty)
+                        }
+
+                        /**
+                         * Returns an immutable instance of [Word].
+                         *
+                         * Further updates to this [Builder] will not mutate the returned instance.
+                         *
+                         * The following fields are required:
+                         * ```java
+                         * .bbox()
+                         * .span()
+                         * ```
+                         *
+                         * @throws IllegalStateException if any required field is unset.
+                         */
+                        fun build(): Word =
+                            Word(
+                                checkRequired("bbox", bbox),
+                                checkRequired("span", span).map { it.toImmutable() },
+                                additionalProperties.toMutableMap(),
+                            )
+                    }
+
+                    private var validated: Boolean = false
+
+                    /**
+                     * Validates that the types of all values in this object match their expected
+                     * types recursively.
+                     *
+                     * This method is _not_ forwards compatible with new types from the API for
+                     * existing fields.
+                     *
+                     * @throws LlamaCloudInvalidDataException if any value type in this object
+                     *   doesn't match its expected type.
+                     */
+                    fun validate(): Word = apply {
+                        if (validated) {
+                            return@apply
+                        }
+
+                        bbox().validate()
+                        span()
+                        validated = true
+                    }
+
+                    fun isValid(): Boolean =
+                        try {
+                            validate()
+                            true
+                        } catch (e: LlamaCloudInvalidDataException) {
+                            false
+                        }
+
+                    /**
+                     * Returns a score indicating how many valid values are contained in this object
+                     * recursively.
+                     *
+                     * Used for best match union deserialization.
+                     */
+                    @JvmSynthetic
+                    internal fun validity(): Int =
+                        (bbox.asKnown().getOrNull()?.validity() ?: 0) +
+                            (span.asKnown().getOrNull()?.size ?: 0)
+
+                    override fun equals(other: Any?): Boolean {
+                        if (this === other) {
+                            return true
+                        }
+
+                        return other is Word &&
+                            bbox == other.bbox &&
+                            span == other.span &&
+                            additionalProperties == other.additionalProperties
+                    }
+
+                    private val hashCode: Int by lazy {
+                        Objects.hash(bbox, span, additionalProperties)
+                    }
+
+                    override fun hashCode(): Int = hashCode
+
+                    override fun toString() =
+                        "Word{bbox=$bbox, span=$span, additionalProperties=$additionalProperties}"
+                }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Line &&
+                        bbox == other.bbox &&
+                        span == other.span &&
+                        words == other.words &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy {
+                    Objects.hash(bbox, span, words, additionalProperties)
+                }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "Line{bbox=$bbox, span=$span, words=$words, additionalProperties=$additionalProperties}"
+            }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Label &&
+                    lines == other.lines &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(lines, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Label{lines=$lines, additionalProperties=$additionalProperties}"
+        }
+
+        /** Supported text with half-open UTF-8 byte spans into the complete property string. */
+        class Value
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val lines: JsonField<List<Line>>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("lines")
+                @ExcludeMissing
+                lines: JsonField<List<Line>> = JsonMissing.of()
+            ) : this(lines, mutableMapOf())
+
+            /**
+             * Supported lines. Word requests include supported words; gaps are valid. Boxes use
+             * final page coordinates and optional local rotation r.
+             *
+             * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun lines(): List<Line> = lines.getRequired("lines")
+
+            /**
+             * Returns the raw JSON value of [lines].
+             *
+             * Unlike [lines], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("lines") @ExcludeMissing fun _lines(): JsonField<List<Line>> = lines
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Value].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .lines()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Value]. */
+            class Builder internal constructor() {
+
+                private var lines: JsonField<MutableList<Line>>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(value: Value) = apply {
+                    lines = value.lines.map { it.toMutableList() }
+                    additionalProperties = value.additionalProperties.toMutableMap()
+                }
+
+                /**
+                 * Supported lines. Word requests include supported words; gaps are valid. Boxes use
+                 * final page coordinates and optional local rotation r.
+                 */
+                fun lines(lines: List<Line>) = lines(JsonField.of(lines))
+
+                /**
+                 * Sets [Builder.lines] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.lines] with a well-typed `List<Line>` value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun lines(lines: JsonField<List<Line>>) = apply {
+                    this.lines = lines.map { it.toMutableList() }
+                }
+
+                /**
+                 * Adds a single [Line] to [lines].
+                 *
+                 * @throws IllegalStateException if the field was previously set to a non-list.
+                 */
+                fun addLine(line: Line) = apply {
+                    lines =
+                        (lines ?: JsonField.of(mutableListOf())).also {
+                            checkKnown("lines", it).add(line)
+                        }
+                }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Value].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .lines()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Value =
+                    Value(
+                        checkRequired("lines", lines).map { it.toImmutable() },
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws LlamaCloudInvalidDataException if any value type in this object doesn't match
+             *   its expected type.
+             */
+            fun validate(): Value = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                lines().forEach { it.validate() }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: LlamaCloudInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (lines.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
+
+            /** One grounded line of text with an optional per-word breakdown. */
+            class Line
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val bbox: JsonField<BBox>,
+                private val span: JsonField<List<JsonValue>>,
+                private val words: JsonField<List<Word>>,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("bbox") @ExcludeMissing bbox: JsonField<BBox> = JsonMissing.of(),
+                    @JsonProperty("span")
+                    @ExcludeMissing
+                    span: JsonField<List<JsonValue>> = JsonMissing.of(),
+                    @JsonProperty("words")
+                    @ExcludeMissing
+                    words: JsonField<List<Word>> = JsonMissing.of(),
+                ) : this(bbox, span, words, mutableMapOf())
+
+                /**
+                 * Line bounding box
+                 *
+                 * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type
+                 *   or is unexpectedly missing or null (e.g. if the server responded with an
+                 *   unexpected value).
+                 */
+                fun bbox(): BBox = bbox.getRequired("bbox")
+
+                /**
+                 * `[start, end)` UTF-8 byte span in the complete source property string
+                 *
+                 * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type
+                 *   or is unexpectedly missing or null (e.g. if the server responded with an
+                 *   unexpected value).
+                 */
+                fun span(): List<JsonValue> = span.getRequired("span")
+
+                /**
+                 * Per-word grounding within the line, when available
+                 *
+                 * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type
+                 *   (e.g. if the server responded with an unexpected value).
+                 */
+                fun words(): Optional<List<Word>> = words.getOptional("words")
+
+                /**
+                 * Returns the raw JSON value of [bbox].
+                 *
+                 * Unlike [bbox], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("bbox") @ExcludeMissing fun _bbox(): JsonField<BBox> = bbox
+
+                /**
+                 * Returns the raw JSON value of [span].
+                 *
+                 * Unlike [span], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("span") @ExcludeMissing fun _span(): JsonField<List<JsonValue>> = span
+
+                /**
+                 * Returns the raw JSON value of [words].
+                 *
+                 * Unlike [words], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("words") @ExcludeMissing fun _words(): JsonField<List<Word>> = words
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [Line].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .bbox()
+                     * .span()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [Line]. */
+                class Builder internal constructor() {
+
+                    private var bbox: JsonField<BBox>? = null
+                    private var span: JsonField<MutableList<JsonValue>>? = null
+                    private var words: JsonField<MutableList<Word>>? = null
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(line: Line) = apply {
+                        bbox = line.bbox
+                        span = line.span.map { it.toMutableList() }
+                        words = line.words.map { it.toMutableList() }
+                        additionalProperties = line.additionalProperties.toMutableMap()
+                    }
+
+                    /** Line bounding box */
+                    fun bbox(bbox: BBox) = bbox(JsonField.of(bbox))
+
+                    /**
+                     * Sets [Builder.bbox] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.bbox] with a well-typed [BBox] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun bbox(bbox: JsonField<BBox>) = apply { this.bbox = bbox }
+
+                    /** `[start, end)` UTF-8 byte span in the complete source property string */
+                    fun span(span: List<JsonValue>) = span(JsonField.of(span))
+
+                    /**
+                     * Sets [Builder.span] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.span] with a well-typed `List<JsonValue>`
+                     * value instead. This method is primarily for setting the field to an
+                     * undocumented or not yet supported value.
+                     */
+                    fun span(span: JsonField<List<JsonValue>>) = apply {
+                        this.span = span.map { it.toMutableList() }
+                    }
+
+                    /**
+                     * Adds a single [JsonValue] to [Builder.span].
+                     *
+                     * @throws IllegalStateException if the field was previously set to a non-list.
+                     */
+                    fun addSpan(span: JsonValue) = apply {
+                        this.span =
+                            (this.span ?: JsonField.of(mutableListOf())).also {
+                                checkKnown("span", it).add(span)
+                            }
+                    }
+
+                    /** Per-word grounding within the line, when available */
+                    fun words(words: List<Word>?) = words(JsonField.ofNullable(words))
+
+                    /** Alias for calling [Builder.words] with `words.orElse(null)`. */
+                    fun words(words: Optional<List<Word>>) = words(words.getOrNull())
+
+                    /**
+                     * Sets [Builder.words] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.words] with a well-typed `List<Word>` value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun words(words: JsonField<List<Word>>) = apply {
+                        this.words = words.map { it.toMutableList() }
+                    }
+
+                    /**
+                     * Adds a single [Word] to [words].
+                     *
+                     * @throws IllegalStateException if the field was previously set to a non-list.
+                     */
+                    fun addWord(word: Word) = apply {
+                        words =
+                            (words ?: JsonField.of(mutableListOf())).also {
+                                checkKnown("words", it).add(word)
+                            }
+                    }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [Line].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .bbox()
+                     * .span()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): Line =
+                        Line(
+                            checkRequired("bbox", bbox),
+                            checkRequired("span", span).map { it.toImmutable() },
+                            (words ?: JsonMissing.of()).map { it.toImmutable() },
+                            additionalProperties.toMutableMap(),
+                        )
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws LlamaCloudInvalidDataException if any value type in this object doesn't
+                 *   match its expected type.
+                 */
+                fun validate(): Line = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    bbox().validate()
+                    span()
+                    words().ifPresent { it.forEach { it.validate() } }
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: LlamaCloudInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (bbox.asKnown().getOrNull()?.validity() ?: 0) +
+                        (span.asKnown().getOrNull()?.size ?: 0) +
+                        (words.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
+
+                /** One grounded word: a `[start, end)` span in the source text and its bbox. */
+                class Word
+                @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+                private constructor(
+                    private val bbox: JsonField<BBox>,
+                    private val span: JsonField<List<JsonValue>>,
+                    private val additionalProperties: MutableMap<String, JsonValue>,
+                ) {
+
+                    @JsonCreator
+                    private constructor(
+                        @JsonProperty("bbox")
+                        @ExcludeMissing
+                        bbox: JsonField<BBox> = JsonMissing.of(),
+                        @JsonProperty("span")
+                        @ExcludeMissing
+                        span: JsonField<List<JsonValue>> = JsonMissing.of(),
+                    ) : this(bbox, span, mutableMapOf())
+
+                    /**
+                     * Word bounding box
+                     *
+                     * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected
+                     *   type or is unexpectedly missing or null (e.g. if the server responded with
+                     *   an unexpected value).
+                     */
+                    fun bbox(): BBox = bbox.getRequired("bbox")
+
+                    /**
+                     * `[start, end)` UTF-8 byte span in the complete source property string
+                     *
+                     * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected
+                     *   type or is unexpectedly missing or null (e.g. if the server responded with
+                     *   an unexpected value).
+                     */
+                    fun span(): List<JsonValue> = span.getRequired("span")
+
+                    /**
+                     * Returns the raw JSON value of [bbox].
+                     *
+                     * Unlike [bbox], this method doesn't throw if the JSON field has an unexpected
+                     * type.
+                     */
+                    @JsonProperty("bbox") @ExcludeMissing fun _bbox(): JsonField<BBox> = bbox
+
+                    /**
+                     * Returns the raw JSON value of [span].
+                     *
+                     * Unlike [span], this method doesn't throw if the JSON field has an unexpected
+                     * type.
+                     */
+                    @JsonProperty("span")
+                    @ExcludeMissing
+                    fun _span(): JsonField<List<JsonValue>> = span
+
+                    @JsonAnySetter
+                    private fun putAdditionalProperty(key: String, value: JsonValue) {
+                        additionalProperties.put(key, value)
+                    }
+
+                    @JsonAnyGetter
+                    @ExcludeMissing
+                    fun _additionalProperties(): Map<String, JsonValue> =
+                        Collections.unmodifiableMap(additionalProperties)
+
+                    fun toBuilder() = Builder().from(this)
+
+                    companion object {
+
+                        /**
+                         * Returns a mutable builder for constructing an instance of [Word].
+                         *
+                         * The following fields are required:
+                         * ```java
+                         * .bbox()
+                         * .span()
+                         * ```
+                         */
+                        @JvmStatic fun builder() = Builder()
+                    }
+
+                    /** A builder for [Word]. */
+                    class Builder internal constructor() {
+
+                        private var bbox: JsonField<BBox>? = null
+                        private var span: JsonField<MutableList<JsonValue>>? = null
+                        private var additionalProperties: MutableMap<String, JsonValue> =
+                            mutableMapOf()
+
+                        @JvmSynthetic
+                        internal fun from(word: Word) = apply {
+                            bbox = word.bbox
+                            span = word.span.map { it.toMutableList() }
+                            additionalProperties = word.additionalProperties.toMutableMap()
+                        }
+
+                        /** Word bounding box */
+                        fun bbox(bbox: BBox) = bbox(JsonField.of(bbox))
+
+                        /**
+                         * Sets [Builder.bbox] to an arbitrary JSON value.
+                         *
+                         * You should usually call [Builder.bbox] with a well-typed [BBox] value
+                         * instead. This method is primarily for setting the field to an
+                         * undocumented or not yet supported value.
+                         */
+                        fun bbox(bbox: JsonField<BBox>) = apply { this.bbox = bbox }
+
+                        /** `[start, end)` UTF-8 byte span in the complete source property string */
+                        fun span(span: List<JsonValue>) = span(JsonField.of(span))
+
+                        /**
+                         * Sets [Builder.span] to an arbitrary JSON value.
+                         *
+                         * You should usually call [Builder.span] with a well-typed
+                         * `List<JsonValue>` value instead. This method is primarily for setting the
+                         * field to an undocumented or not yet supported value.
+                         */
+                        fun span(span: JsonField<List<JsonValue>>) = apply {
+                            this.span = span.map { it.toMutableList() }
+                        }
+
+                        /**
+                         * Adds a single [JsonValue] to [Builder.span].
+                         *
+                         * @throws IllegalStateException if the field was previously set to a
+                         *   non-list.
+                         */
+                        fun addSpan(span: JsonValue) = apply {
+                            this.span =
+                                (this.span ?: JsonField.of(mutableListOf())).also {
+                                    checkKnown("span", it).add(span)
+                                }
+                        }
+
+                        fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
+                            apply {
+                                this.additionalProperties.clear()
+                                putAllAdditionalProperties(additionalProperties)
+                            }
+
+                        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                            additionalProperties.put(key, value)
+                        }
+
+                        fun putAllAdditionalProperties(
+                            additionalProperties: Map<String, JsonValue>
+                        ) = apply { this.additionalProperties.putAll(additionalProperties) }
+
+                        fun removeAdditionalProperty(key: String) = apply {
+                            additionalProperties.remove(key)
+                        }
+
+                        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                            keys.forEach(::removeAdditionalProperty)
+                        }
+
+                        /**
+                         * Returns an immutable instance of [Word].
+                         *
+                         * Further updates to this [Builder] will not mutate the returned instance.
+                         *
+                         * The following fields are required:
+                         * ```java
+                         * .bbox()
+                         * .span()
+                         * ```
+                         *
+                         * @throws IllegalStateException if any required field is unset.
+                         */
+                        fun build(): Word =
+                            Word(
+                                checkRequired("bbox", bbox),
+                                checkRequired("span", span).map { it.toImmutable() },
+                                additionalProperties.toMutableMap(),
+                            )
+                    }
+
+                    private var validated: Boolean = false
+
+                    /**
+                     * Validates that the types of all values in this object match their expected
+                     * types recursively.
+                     *
+                     * This method is _not_ forwards compatible with new types from the API for
+                     * existing fields.
+                     *
+                     * @throws LlamaCloudInvalidDataException if any value type in this object
+                     *   doesn't match its expected type.
+                     */
+                    fun validate(): Word = apply {
+                        if (validated) {
+                            return@apply
+                        }
+
+                        bbox().validate()
+                        span()
+                        validated = true
+                    }
+
+                    fun isValid(): Boolean =
+                        try {
+                            validate()
+                            true
+                        } catch (e: LlamaCloudInvalidDataException) {
+                            false
+                        }
+
+                    /**
+                     * Returns a score indicating how many valid values are contained in this object
+                     * recursively.
+                     *
+                     * Used for best match union deserialization.
+                     */
+                    @JvmSynthetic
+                    internal fun validity(): Int =
+                        (bbox.asKnown().getOrNull()?.validity() ?: 0) +
+                            (span.asKnown().getOrNull()?.size ?: 0)
+
+                    override fun equals(other: Any?): Boolean {
+                        if (this === other) {
+                            return true
+                        }
+
+                        return other is Word &&
+                            bbox == other.bbox &&
+                            span == other.span &&
+                            additionalProperties == other.additionalProperties
+                    }
+
+                    private val hashCode: Int by lazy {
+                        Objects.hash(bbox, span, additionalProperties)
+                    }
+
+                    override fun hashCode(): Int = hashCode
+
+                    override fun toString() =
+                        "Word{bbox=$bbox, span=$span, additionalProperties=$additionalProperties}"
+                }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Line &&
+                        bbox == other.bbox &&
+                        span == other.span &&
+                        words == other.words &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy {
+                    Objects.hash(bbox, span, words, additionalProperties)
+                }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "Line{bbox=$bbox, span=$span, words=$words, additionalProperties=$additionalProperties}"
+            }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Value &&
+                    lines == other.lines &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(lines, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Value{lines=$lines, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Grounding &&
+                id == other.id &&
+                label == other.label &&
+                value == other.value &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(id, label, value, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Grounding{id=$id, label=$label, value=$value, additionalProperties=$additionalProperties}"
+    }
+
+    /** Form text node */
+    class Type @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val TEXT = of("text")
+
+            @JvmStatic fun of(value: String) = Type(JsonField.of(value))
+        }
+
+        /** An enum containing [Type]'s known values. */
+        enum class Known {
+            TEXT
+        }
+
+        /**
+         * An enum containing [Type]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Type] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            TEXT,
+            /** An enum member indicating that [Type] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                TEXT -> Value.TEXT
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws LlamaCloudInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                TEXT -> Known.TEXT
+                else -> throw LlamaCloudInvalidDataException("Unknown Type: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws LlamaCloudInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow {
+                LlamaCloudInvalidDataException("Value is not a String")
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws LlamaCloudInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Type = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: LlamaCloudInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Type && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is FormText &&
+            value == other.value &&
+            bbox == other.bbox &&
+            grounding == other.grounding &&
+            type == other.type &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(value, bbox, grounding, type, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "FormText{value=$value, bbox=$bbox, grounding=$grounding, type=$type, additionalProperties=$additionalProperties}"
+}
diff --git a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/parsing/FormTextTest.kt b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/parsing/FormTextTest.kt
new file mode 100644
index 0000000..fb9a724
--- /dev/null
+++ b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/parsing/FormTextTest.kt
@@ -0,0 +1,474 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package ai.llamaindex.llamacloud.models.parsing
+
+import ai.llamaindex.llamacloud.core.JsonValue
+import ai.llamaindex.llamacloud.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class FormTextTest {
+
+    @Test
+    fun create() {
+        val formText =
+            FormText.builder()
+                .value("value")
+                .addBbox(
+                    BBox.builder()
+                        .h(0.0)
+                        .w(0.0)
+                        .x(0.0)
+                        .y(0.0)
+                        .confidence(0.0)
+                        .endIndex(0L)
+                        .label("label")
+                        .r(0.0)
+                        .startIndex(0L)
+                        .build()
+                )
+                .grounding(
+                    FormText.Grounding.builder()
+                        .id(
+                            FormText.Grounding.Id.builder()
+                                .addLine(
+                                    FormText.Grounding.Id.Line.builder()
+                                        .bbox(
+                                            BBox.builder()
+                                                .h(0.0)
+                                                .w(0.0)
+                                                .x(0.0)
+                                                .y(0.0)
+                                                .confidence(0.0)
+                                                .endIndex(0L)
+                                                .label("label")
+                                                .r(0.0)
+                                                .startIndex(0L)
+                                                .build()
+                                        )
+                                        .addSpan(JsonValue.from(mapOf<String, Any>()))
+                                        .addSpan(JsonValue.from(mapOf<String, Any>()))
+                                        .addWord(
+                                            FormText.Grounding.Id.Line.Word.builder()
+                                                .bbox(
+                                                    BBox.builder()
+                                                        .h(0.0)
+                                                        .w(0.0)
+                                                        .x(0.0)
+                                                        .y(0.0)
+                                                        .confidence(0.0)
+                                                        .endIndex(0L)
+                                                        .label("label")
+                                                        .r(0.0)
+                                                        .startIndex(0L)
+                                                        .build()
+                                                )
+                                                .addSpan(JsonValue.from(mapOf<String, Any>()))
+                                                .addSpan(JsonValue.from(mapOf<String, Any>()))
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .label(
+                            FormText.Grounding.Label.builder()
+                                .addLine(
+                                    FormText.Grounding.Label.Line.builder()
+                                        .bbox(
+                                            BBox.builder()
+                                                .h(0.0)
+                                                .w(0.0)
+                                                .x(0.0)
+                                                .y(0.0)
+                                                .confidence(0.0)
+                                                .endIndex(0L)
+                                                .label("label")
+                                                .r(0.0)
+                                                .startIndex(0L)
+                                                .build()
+                                        )
+                                        .addSpan(JsonValue.from(mapOf<String, Any>()))
+                                        .addSpan(JsonValue.from(mapOf<String, Any>()))
+                                        .addWord(
+                                            FormText.Grounding.Label.Line.Word.builder()
+                                                .bbox(
+                                                    BBox.builder()
+                                                        .h(0.0)
+                                                        .w(0.0)
+                                                        .x(0.0)
+                                                        .y(0.0)
+                                                        .confidence(0.0)
+                                                        .endIndex(0L)
+                                                        .label("label")
+                                                        .r(0.0)
+                                                        .startIndex(0L)
+                                                        .build()
+                                                )
+                                                .addSpan(JsonValue.from(mapOf<String, Any>()))
+                                                .addSpan(JsonValue.from(mapOf<String, Any>()))
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .value(
+                            FormText.Grounding.Value.builder()
+                                .addLine(
+                                    FormText.Grounding.Value.Line.builder()
+                                        .bbox(
+                                            BBox.builder()
+                                                .h(0.0)
+                                                .w(0.0)
+                                                .x(0.0)
+                                                .y(0.0)
+                                                .confidence(0.0)
+                                                .endIndex(0L)
+                                                .label("label")
+                                                .r(0.0)
+                                                .startIndex(0L)
+                                                .build()
+                                        )
+                                        .addSpan(JsonValue.from(mapOf<String, Any>()))
+                                        .addSpan(JsonValue.from(mapOf<String, Any>()))
+                                        .addWord(
+                                            FormText.Grounding.Value.Line.Word.builder()
+                                                .bbox(
+                                                    BBox.builder()
+                                                        .h(0.0)
+                                                        .w(0.0)
+                                                        .x(0.0)
+                                                        .y(0.0)
+                                                        .confidence(0.0)
+                                                        .endIndex(0L)
+                                                        .label("label")
+                                                        .r(0.0)
+                                                        .startIndex(0L)
+                                                        .build()
+                                                )
+                                                .addSpan(JsonValue.from(mapOf<String, Any>()))
+                                                .addSpan(JsonValue.from(mapOf<String, Any>()))
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .build()
+                )
+                .type(FormText.Type.TEXT)
+                .build()
+
+        assertThat(formText.value()).isEqualTo("value")
+        assertThat(formText.bbox().getOrNull())
+            .containsExactly(
+                BBox.builder()
+                    .h(0.0)
+                    .w(0.0)
+                    .x(0.0)
+                    .y(0.0)
+                    .confidence(0.0)
+                    .endIndex(0L)
+                    .label("label")
+                    .r(0.0)
+                    .startIndex(0L)
+                    .build()
+            )
+        assertThat(formText.grounding())
+            .contains(
+                FormText.Grounding.builder()
+                    .id(
+                        FormText.Grounding.Id.builder()
+                            .addLine(
+                                FormText.Grounding.Id.Line.builder()
+                                    .bbox(
+                                        BBox.builder()
+                                            .h(0.0)
+                                            .w(0.0)
+                                            .x(0.0)
+                                            .y(0.0)
+                                            .confidence(0.0)
+                                            .endIndex(0L)
+                                            .label("label")
+                                            .r(0.0)
+                                            .startIndex(0L)
+                                            .build()
+                                    )
+                                    .addSpan(JsonValue.from(mapOf<String, Any>()))
+                                    .addSpan(JsonValue.from(mapOf<String, Any>()))
+                                    .addWord(
+                                        FormText.Grounding.Id.Line.Word.builder()
+                                            .bbox(
+                                                BBox.builder()
+                                                    .h(0.0)
+                                                    .w(0.0)
+                                                    .x(0.0)
+                                                    .y(0.0)
+                                                    .confidence(0.0)
+                                                    .endIndex(0L)
+                                                    .label("label")
+                                                    .r(0.0)
+                                                    .startIndex(0L)
+                                                    .build()
+                                            )
+                                            .addSpan(JsonValue.from(mapOf<String, Any>()))
+                                            .addSpan(JsonValue.from(mapOf<String, Any>()))
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .label(
+                        FormText.Grounding.Label.builder()
+                            .addLine(
+                                FormText.Grounding.Label.Line.builder()
+                                    .bbox(
+                                        BBox.builder()
+                                            .h(0.0)
+                                            .w(0.0)
+                                            .x(0.0)
+                                            .y(0.0)
+                                            .confidence(0.0)
+                                            .endIndex(0L)
+                                            .label("label")
+                                            .r(0.0)
+                                            .startIndex(0L)
+                                            .build()
+                                    )
+                                    .addSpan(JsonValue.from(mapOf<String, Any>()))
+                                    .addSpan(JsonValue.from(mapOf<String, Any>()))
+                                    .addWord(
+                                        FormText.Grounding.Label.Line.Word.builder()
+                                            .bbox(
+                                                BBox.builder()
+                                                    .h(0.0)
+                                                    .w(0.0)
+                                                    .x(0.0)
+                                                    .y(0.0)
+                                                    .confidence(0.0)
+                                                    .endIndex(0L)
+                                                    .label("label")
+                                                    .r(0.0)
+                                                    .startIndex(0L)
+                                                    .build()
+                                            )
+                                            .addSpan(JsonValue.from(mapOf<String, Any>()))
+                                            .addSpan(JsonValue.from(mapOf<String, Any>()))
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .value(
+                        FormText.Grounding.Value.builder()
+                            .addLine(
+                                FormText.Grounding.Value.Line.builder()
+                                    .bbox(
+                                        BBox.builder()
+                                            .h(0.0)
+                                            .w(0.0)
+                                            .x(0.0)
+                                            .y(0.0)
+                                            .confidence(0.0)
+                                            .endIndex(0L)
+                                            .label("label")
+                                            .r(0.0)
+                                            .startIndex(0L)
+                                            .build()
+                                    )
+                                    .addSpan(JsonValue.from(mapOf<String, Any>()))
+                                    .addSpan(JsonValue.from(mapOf<String, Any>()))
+                                    .addWord(
+                                        FormText.Grounding.Value.Line.Word.builder()
+                                            .bbox(
+                                                BBox.builder()
+                                                    .h(0.0)
+                                                    .w(0.0)
+                                                    .x(0.0)
+                                                    .y(0.0)
+                                                    .confidence(0.0)
+                                                    .endIndex(0L)
+                                                    .label("label")
+                                                    .r(0.0)
+                                                    .startIndex(0L)
+                                                    .build()
+                                            )
+                                            .addSpan(JsonValue.from(mapOf<String, Any>()))
+                                            .addSpan(JsonValue.from(mapOf<String, Any>()))
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .build()
+            )
+        assertThat(formText.type()).contains(FormText.Type.TEXT)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val formText =
+            FormText.builder()
+                .value("value")
+                .addBbox(
+                    BBox.builder()
+                        .h(0.0)
+                        .w(0.0)
+                        .x(0.0)
+                        .y(0.0)
+                        .confidence(0.0)
+                        .endIndex(0L)
+                        .label("label")
+                        .r(0.0)
+                        .startIndex(0L)
+                        .build()
+                )
+                .grounding(
+                    FormText.Grounding.builder()
+                        .id(
+                            FormText.Grounding.Id.builder()
+                                .addLine(
+                                    FormText.Grounding.Id.Line.builder()
+                                        .bbox(
+                                            BBox.builder()
+                                                .h(0.0)
+                                                .w(0.0)
+                                                .x(0.0)
+                                                .y(0.0)
+                                                .confidence(0.0)
+                                                .endIndex(0L)
+                                                .label("label")
+                                                .r(0.0)
+                                                .startIndex(0L)
+                                                .build()
+                                        )
+                                        .addSpan(JsonValue.from(mapOf<String, Any>()))
+                                        .addSpan(JsonValue.from(mapOf<String, Any>()))
+                                        .addWord(
+                                            FormText.Grounding.Id.Line.Word.builder()
+                                                .bbox(
+                                                    BBox.builder()
+                                                        .h(0.0)
+                                                        .w(0.0)
+                                                        .x(0.0)
+                                                        .y(0.0)
+                                                        .confidence(0.0)
+                                                        .endIndex(0L)
+                                                        .label("label")
+                                                        .r(0.0)
+                                                        .startIndex(0L)
+                                                        .build()
+                                                )
+                                                .addSpan(JsonValue.from(mapOf<String, Any>()))
+                                                .addSpan(JsonValue.from(mapOf<String, Any>()))
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .label(
+                            FormText.Grounding.Label.builder()
+                                .addLine(
+                                    FormText.Grounding.Label.Line.builder()
+                                        .bbox(
+                                            BBox.builder()
+                                                .h(0.0)
+                                                .w(0.0)
+                                                .x(0.0)
+                                                .y(0.0)
+                                                .confidence(0.0)
+                                                .endIndex(0L)
+                                                .label("label")
+                                                .r(0.0)
+                                                .startIndex(0L)
+                                                .build()
+                                        )
+                                        .addSpan(JsonValue.from(mapOf<String, Any>()))
+                                        .addSpan(JsonValue.from(mapOf<String, Any>()))
+                                        .addWord(
+                                            FormText.Grounding.Label.Line.Word.builder()
+                                                .bbox(
+                                                    BBox.builder()
+                                                        .h(0.0)
+                                                        .w(0.0)
+                                                        .x(0.0)
+                                                        .y(0.0)
+                                                        .confidence(0.0)
+                                                        .endIndex(0L)
+                                                        .label("label")
+                                                        .r(0.0)
+                                                        .startIndex(0L)
+                                                        .build()
+                                                )
+                                                .addSpan(JsonValue.from(mapOf<String, Any>()))
+                                                .addSpan(JsonValue.from(mapOf<String, Any>()))
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .value(
+                            FormText.Grounding.Value.builder()
+                                .addLine(
+                                    FormText.Grounding.Value.Line.builder()
+                                        .bbox(
+                                            BBox.builder()
+                                                .h(0.0)
+                                                .w(0.0)
+                                                .x(0.0)
+                                                .y(0.0)
+                                                .confidence(0.0)
+                                                .endIndex(0L)
+                                                .label("label")
+                                                .r(0.0)
+                                                .startIndex(0L)
+                                                .build()
+                                        )
+                                        .addSpan(JsonValue.from(mapOf<String, Any>()))
+                                        .addSpan(JsonValue.from(mapOf<String, Any>()))
+                                        .addWord(
+                                            FormText.Grounding.Value.Line.Word.builder()
+                                                .bbox(
+                                                    BBox.builder()
+                                                        .h(0.0)
+                                                        .w(0.0)
+                                                        .x(0.0)
+                                                        .y(0.0)
+                                                        .confidence(0.0)
+                                                        .endIndex(0L)
+                                                        .label("label")
+                                                        .r(0.0)
+                                                        .startIndex(0L)
+                                                        .build()
+                                                )
+                                                .addSpan(JsonValue.from(mapOf<String, Any>()))
+                                                .addSpan(JsonValue.from(mapOf<String, Any>()))
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .build()
+                )
+                .type(FormText.Type.TEXT)
+                .build()
+
+        val roundtrippedFormText =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(formText),
+                jacksonTypeRef<FormText>(),
+            )
+
+        assertThat(roundtrippedFormText).isEqualTo(formText)
+    }
+}

From 01805c52f7b5ddf09095d93e1e3813acc66998c9 Mon Sep 17 00:00:00 2001
From: stlc-bot <stlc-bot@users.noreply.github.com>
Date: Sat, 10 Oct 2026 12:54:27 +0000
Subject: [PATCH 02/11] chore(stlc): seal custom-code tracking files

Stainless-Generated-From: 0023f9c2f6af8d0e1d8b946ba3a6049f63bb7983
---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 947c8c4..f5d5985 100644
--- a/README.md
+++ b/README.md
@@ -3,7 +3,7 @@
 <!-- x-release-please-start-version -->
 
 [![Maven Central](https://img.shields.io/maven-central/v/ai.llamaindex.llamacloud/llama-cloud)](https://central.sonatype.com/artifact/ai.llamaindex.llamacloud/llama-cloud/1.9.0)
-[![javadoc](https://javadoc.io/badge2/ai.llamaindex.llamacloud/llama-cloud/1.9.0/javadoc.svg)](https://javadoc.io/doc/ai.llamaindex.llamacloud/llama-cloud/1.8.0)
+[![javadoc](https://javadoc.io/badge2/ai.llamaindex.llamacloud/llama-cloud/1.9.0/javadoc.svg)](https://javadoc.io/doc/ai.llamaindex.llamacloud/llama-cloud/1.9.0)
 
 <!-- x-release-please-end -->
 

From ecde3df752a9bb68005bc3e7b0c3b8709ac81d78 Mon Sep 17 00:00:00 2001
From: stlc-bot <stlc-bot@users.noreply.github.com>
Date: Mon, 12 Oct 2026 17:40:41 +0000
Subject: [PATCH 03/11] PROD-10337: Rename Verify evidence data to
 metadata_tool (#29235)

Stainless-Generated-From: f4cd5938bb1f5ef4bd840822eec1b2abea066a03
---
 .../alpha/verify/VerifyGetDetailsResponse.kt  | 106 ++++++++++--------
 .../verify/VerifyGetDetailsResponseTest.kt    |  18 +--
 2 files changed, 70 insertions(+), 54 deletions(-)

diff --git a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/alpha/verify/VerifyGetDetailsResponse.kt b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/alpha/verify/VerifyGetDetailsResponse.kt
index 49e242a..16394be 100644
--- a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/alpha/verify/VerifyGetDetailsResponse.kt
+++ b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/alpha/verify/VerifyGetDetailsResponse.kt
@@ -699,8 +699,8 @@ private constructor(
         private val family: JsonField<String>,
         private val score: JsonField<Double>,
         private val tool: JsonField<String>,
-        private val data: JsonField<Data>,
         private val hard: JsonField<Boolean>,
+        private val metadataTool: JsonField<MetadataTool>,
         private val additionalProperties: MutableMap<String, JsonValue>,
     ) {
 
@@ -711,9 +711,11 @@ private constructor(
             @JsonProperty("family") @ExcludeMissing family: JsonField<String> = JsonMissing.of(),
             @JsonProperty("score") @ExcludeMissing score: JsonField<Double> = JsonMissing.of(),
             @JsonProperty("tool") @ExcludeMissing tool: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("data") @ExcludeMissing data: JsonField<Data> = JsonMissing.of(),
             @JsonProperty("hard") @ExcludeMissing hard: JsonField<Boolean> = JsonMissing.of(),
-        ) : this(code, detail, family, score, tool, data, hard, mutableMapOf())
+            @JsonProperty("metadata_tool")
+            @ExcludeMissing
+            metadataTool: JsonField<MetadataTool> = JsonMissing.of(),
+        ) : this(code, detail, family, score, tool, hard, metadataTool, mutableMapOf())
 
         /**
          * Machine-readable evidence code
@@ -756,20 +758,20 @@ private constructor(
         fun tool(): String = tool.getRequired("tool")
 
         /**
-         * Tool-specific structured payload
+         * Whether this is hard (conclusive) evidence
          *
          * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g. if
          *   the server responded with an unexpected value).
          */
-        fun data(): Optional<Data> = data.getOptional("data")
+        fun hard(): Optional<Boolean> = hard.getOptional("hard")
 
         /**
-         * Whether this is hard (conclusive) evidence
+         * Raw values from the tool behind this finding; the shape varies by tool
          *
          * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g. if
          *   the server responded with an unexpected value).
          */
-        fun hard(): Optional<Boolean> = hard.getOptional("hard")
+        fun metadataTool(): Optional<MetadataTool> = metadataTool.getOptional("metadata_tool")
 
         /**
          * Returns the raw JSON value of [code].
@@ -807,18 +809,21 @@ private constructor(
         @JsonProperty("tool") @ExcludeMissing fun _tool(): JsonField<String> = tool
 
         /**
-         * Returns the raw JSON value of [data].
+         * Returns the raw JSON value of [hard].
          *
-         * Unlike [data], this method doesn't throw if the JSON field has an unexpected type.
+         * Unlike [hard], this method doesn't throw if the JSON field has an unexpected type.
          */
-        @JsonProperty("data") @ExcludeMissing fun _data(): JsonField<Data> = data
+        @JsonProperty("hard") @ExcludeMissing fun _hard(): JsonField<Boolean> = hard
 
         /**
-         * Returns the raw JSON value of [hard].
+         * Returns the raw JSON value of [metadataTool].
          *
-         * Unlike [hard], this method doesn't throw if the JSON field has an unexpected type.
+         * Unlike [metadataTool], this method doesn't throw if the JSON field has an unexpected
+         * type.
          */
-        @JsonProperty("hard") @ExcludeMissing fun _hard(): JsonField<Boolean> = hard
+        @JsonProperty("metadata_tool")
+        @ExcludeMissing
+        fun _metadataTool(): JsonField<MetadataTool> = metadataTool
 
         @JsonAnySetter
         private fun putAdditionalProperty(key: String, value: JsonValue) {
@@ -857,8 +862,8 @@ private constructor(
             private var family: JsonField<String>? = null
             private var score: JsonField<Double>? = null
             private var tool: JsonField<String>? = null
-            private var data: JsonField<Data> = JsonMissing.of()
             private var hard: JsonField<Boolean> = JsonMissing.of()
+            private var metadataTool: JsonField<MetadataTool> = JsonMissing.of()
             private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
             @JvmSynthetic
@@ -868,8 +873,8 @@ private constructor(
                 family = evidence.family
                 score = evidence.score
                 tool = evidence.tool
-                data = evidence.data
                 hard = evidence.hard
+                metadataTool = evidence.metadataTool
                 additionalProperties = evidence.additionalProperties.toMutableMap()
             }
 
@@ -933,18 +938,6 @@ private constructor(
              */
             fun tool(tool: JsonField<String>) = apply { this.tool = tool }
 
-            /** Tool-specific structured payload */
-            fun data(data: Data) = data(JsonField.of(data))
-
-            /**
-             * Sets [Builder.data] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.data] with a well-typed [Data] value instead. This
-             * method is primarily for setting the field to an undocumented or not yet supported
-             * value.
-             */
-            fun data(data: JsonField<Data>) = apply { this.data = data }
-
             /** Whether this is hard (conclusive) evidence */
             fun hard(hard: Boolean) = hard(JsonField.of(hard))
 
@@ -957,6 +950,20 @@ private constructor(
              */
             fun hard(hard: JsonField<Boolean>) = apply { this.hard = hard }
 
+            /** Raw values from the tool behind this finding; the shape varies by tool */
+            fun metadataTool(metadataTool: MetadataTool) = metadataTool(JsonField.of(metadataTool))
+
+            /**
+             * Sets [Builder.metadataTool] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.metadataTool] with a well-typed [MetadataTool] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun metadataTool(metadataTool: JsonField<MetadataTool>) = apply {
+                this.metadataTool = metadataTool
+            }
+
             fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
                 this.additionalProperties.clear()
                 putAllAdditionalProperties(additionalProperties)
@@ -999,8 +1006,8 @@ private constructor(
                     checkRequired("family", family),
                     checkRequired("score", score),
                     checkRequired("tool", tool),
-                    data,
                     hard,
+                    metadataTool,
                     additionalProperties.toMutableMap(),
                 )
         }
@@ -1026,8 +1033,8 @@ private constructor(
             family()
             score()
             tool()
-            data().ifPresent { it.validate() }
             hard()
+            metadataTool().ifPresent { it.validate() }
             validated = true
         }
 
@@ -1052,11 +1059,11 @@ private constructor(
                 (if (family.asKnown().isPresent) 1 else 0) +
                 (if (score.asKnown().isPresent) 1 else 0) +
                 (if (tool.asKnown().isPresent) 1 else 0) +
-                (data.asKnown().getOrNull()?.validity() ?: 0) +
-                (if (hard.asKnown().isPresent) 1 else 0)
+                (if (hard.asKnown().isPresent) 1 else 0) +
+                (metadataTool.asKnown().getOrNull()?.validity() ?: 0)
 
-        /** Tool-specific structured payload */
-        class Data
+        /** Raw values from the tool behind this finding; the shape varies by tool */
+        class MetadataTool
         @JsonCreator
         private constructor(
             @com.fasterxml.jackson.annotation.JsonValue
@@ -1071,18 +1078,18 @@ private constructor(
 
             companion object {
 
-                /** Returns a mutable builder for constructing an instance of [Data]. */
+                /** Returns a mutable builder for constructing an instance of [MetadataTool]. */
                 @JvmStatic fun builder() = Builder()
             }
 
-            /** A builder for [Data]. */
+            /** A builder for [MetadataTool]. */
             class Builder internal constructor() {
 
                 private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
                 @JvmSynthetic
-                internal fun from(data: Data) = apply {
-                    additionalProperties = data.additionalProperties.toMutableMap()
+                internal fun from(metadataTool: MetadataTool) = apply {
+                    additionalProperties = metadataTool.additionalProperties.toMutableMap()
                 }
 
                 fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
@@ -1108,11 +1115,11 @@ private constructor(
                 }
 
                 /**
-                 * Returns an immutable instance of [Data].
+                 * Returns an immutable instance of [MetadataTool].
                  *
                  * Further updates to this [Builder] will not mutate the returned instance.
                  */
-                fun build(): Data = Data(additionalProperties.toImmutable())
+                fun build(): MetadataTool = MetadataTool(additionalProperties.toImmutable())
             }
 
             private var validated: Boolean = false
@@ -1127,7 +1134,7 @@ private constructor(
              * @throws LlamaCloudInvalidDataException if any value type in this object doesn't match
              *   its expected type.
              */
-            fun validate(): Data = apply {
+            fun validate(): MetadataTool = apply {
                 if (validated) {
                     return@apply
                 }
@@ -1158,14 +1165,14 @@ private constructor(
                     return true
                 }
 
-                return other is Data && additionalProperties == other.additionalProperties
+                return other is MetadataTool && additionalProperties == other.additionalProperties
             }
 
             private val hashCode: Int by lazy { Objects.hash(additionalProperties) }
 
             override fun hashCode(): Int = hashCode
 
-            override fun toString() = "Data{additionalProperties=$additionalProperties}"
+            override fun toString() = "MetadataTool{additionalProperties=$additionalProperties}"
         }
 
         override fun equals(other: Any?): Boolean {
@@ -1179,19 +1186,28 @@ private constructor(
                 family == other.family &&
                 score == other.score &&
                 tool == other.tool &&
-                data == other.data &&
                 hard == other.hard &&
+                metadataTool == other.metadataTool &&
                 additionalProperties == other.additionalProperties
         }
 
         private val hashCode: Int by lazy {
-            Objects.hash(code, detail, family, score, tool, data, hard, additionalProperties)
+            Objects.hash(
+                code,
+                detail,
+                family,
+                score,
+                tool,
+                hard,
+                metadataTool,
+                additionalProperties,
+            )
         }
 
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "Evidence{code=$code, detail=$detail, family=$family, score=$score, tool=$tool, data=$data, hard=$hard, additionalProperties=$additionalProperties}"
+            "Evidence{code=$code, detail=$detail, family=$family, score=$score, tool=$tool, hard=$hard, metadataTool=$metadataTool, additionalProperties=$additionalProperties}"
     }
 
     /** A per-page forensic heatmap overlay, as a presigned image URL. */
diff --git a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/alpha/verify/VerifyGetDetailsResponseTest.kt b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/alpha/verify/VerifyGetDetailsResponseTest.kt
index 32ff3ea..e46f2cd 100644
--- a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/alpha/verify/VerifyGetDetailsResponseTest.kt
+++ b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/alpha/verify/VerifyGetDetailsResponseTest.kt
@@ -30,12 +30,12 @@ internal class VerifyGetDetailsResponseTest {
                         .family("family")
                         .score(0.0)
                         .tool("tool")
-                        .data(
-                            VerifyGetDetailsResponse.Evidence.Data.builder()
+                        .hard(true)
+                        .metadataTool(
+                            VerifyGetDetailsResponse.Evidence.MetadataTool.builder()
                                 .putAdditionalProperty("foo", JsonValue.from("bar"))
                                 .build()
                         )
-                        .hard(true)
                         .build()
                 )
                 .addHeatmap(
@@ -90,12 +90,12 @@ internal class VerifyGetDetailsResponseTest {
                     .family("family")
                     .score(0.0)
                     .tool("tool")
-                    .data(
-                        VerifyGetDetailsResponse.Evidence.Data.builder()
+                    .hard(true)
+                    .metadataTool(
+                        VerifyGetDetailsResponse.Evidence.MetadataTool.builder()
                             .putAdditionalProperty("foo", JsonValue.from("bar"))
                             .build()
                     )
-                    .hard(true)
                     .build()
             )
         assertThat(verifyGetDetailsResponse.heatmaps().getOrNull())
@@ -157,12 +157,12 @@ internal class VerifyGetDetailsResponseTest {
                         .family("family")
                         .score(0.0)
                         .tool("tool")
-                        .data(
-                            VerifyGetDetailsResponse.Evidence.Data.builder()
+                        .hard(true)
+                        .metadataTool(
+                            VerifyGetDetailsResponse.Evidence.MetadataTool.builder()
                                 .putAdditionalProperty("foo", JsonValue.from("bar"))
                                 .build()
                         )
-                        .hard(true)
                         .build()
                 )
                 .addHeatmap(

From 51952343e5a6e7ab646348f5c13e8fa3d5f7b7e9 Mon Sep 17 00:00:00 2001
From: stlc-bot <stlc-bot@users.noreply.github.com>
Date: Mon, 12 Oct 2026 21:32:07 +0000
Subject: [PATCH 04/11] PROD-10374: Drop unpublished forms node types and
 withhold new ones from older SDKs (#29239)

Stainless-Generated-From: a85a8bc0901b5825610dc7827bce7cb3cbbab4ce
---
 .../ai/llamaindex/llamacloud/models/parsing/Form.kt       | 4 ++--
 .../llamacloud/models/parsing/ParsingGetResponse.kt       | 8 +++++---
 2 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/Form.kt b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/Form.kt
index 28f9d8c..a34443d 100644
--- a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/Form.kt
+++ b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/Form.kt
@@ -45,7 +45,7 @@ private constructor(
     ) : this(json, list, mutableMapOf())
 
     /**
-     * Structured representation: an ordered tree of sections, fields, and tables
+     * Structured representation: an ordered tree of sections, fields, tables, and text
      *
      * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type or is
      *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
@@ -114,7 +114,7 @@ private constructor(
             additionalProperties = form.additionalProperties.toMutableMap()
         }
 
-        /** Structured representation: an ordered tree of sections, fields, and tables */
+        /** Structured representation: an ordered tree of sections, fields, tables, and text */
         fun json(json: List<Json>) = json(JsonField.of(json))
 
         /**
diff --git a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/ParsingGetResponse.kt b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/ParsingGetResponse.kt
index ae502ab..631e8db 100644
--- a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/ParsingGetResponse.kt
+++ b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/ParsingGetResponse.kt
@@ -104,7 +104,7 @@ private constructor(
     fun job(): Job = job.getRequired("job")
 
     /**
-     * Per-page form analysis results (one entry per page).
+     * Beta: per-page form analysis results; node types the calling SDK predates are left out.
      *
      * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
@@ -357,7 +357,9 @@ private constructor(
          */
         fun job(job: JsonField<Job>) = apply { this.job = job }
 
-        /** Per-page form analysis results (one entry per page). */
+        /**
+         * Beta: per-page form analysis results; node types the calling SDK predates are left out.
+         */
         fun forms(forms: Forms?) = forms(JsonField.ofNullable(forms))
 
         /** Alias for calling [Builder.forms] with `forms.orElse(null)`. */
@@ -1653,7 +1655,7 @@ private constructor(
             "Job{id=$id, projectId=$projectId, status=$status, createdAt=$createdAt, errorMessage=$errorMessage, name=$name, tier=$tier, updatedAt=$updatedAt, usage=$usage, userMetadata=$userMetadata, additionalProperties=$additionalProperties}"
     }
 
-    /** Per-page form analysis results (one entry per page). */
+    /** Beta: per-page form analysis results; node types the calling SDK predates are left out. */
     class Forms
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
     private constructor(

From b656c6d29ff620877af36b0e561a0f2e8a740467 Mon Sep 17 00:00:00 2001
From: stlc-bot <stlc-bot@users.noreply.github.com>
Date: Mon, 12 Oct 2026 22:24:12 +0000
Subject: [PATCH 05/11] PROD-10337: Rename Verify evidence metadata_tool to
 metadata (#29477)

Stainless-Generated-From: dbb4d345fde776402cb4fa13784e42ccd7ce90fe
---
 .../alpha/verify/VerifyGetDetailsResponse.kt  | 74 ++++++++-----------
 .../verify/VerifyGetDetailsResponseTest.kt    | 12 +--
 2 files changed, 36 insertions(+), 50 deletions(-)

diff --git a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/alpha/verify/VerifyGetDetailsResponse.kt b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/alpha/verify/VerifyGetDetailsResponse.kt
index 16394be..45b4820 100644
--- a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/alpha/verify/VerifyGetDetailsResponse.kt
+++ b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/alpha/verify/VerifyGetDetailsResponse.kt
@@ -700,7 +700,7 @@ private constructor(
         private val score: JsonField<Double>,
         private val tool: JsonField<String>,
         private val hard: JsonField<Boolean>,
-        private val metadataTool: JsonField<MetadataTool>,
+        private val metadata: JsonField<Metadata>,
         private val additionalProperties: MutableMap<String, JsonValue>,
     ) {
 
@@ -712,10 +712,10 @@ private constructor(
             @JsonProperty("score") @ExcludeMissing score: JsonField<Double> = JsonMissing.of(),
             @JsonProperty("tool") @ExcludeMissing tool: JsonField<String> = JsonMissing.of(),
             @JsonProperty("hard") @ExcludeMissing hard: JsonField<Boolean> = JsonMissing.of(),
-            @JsonProperty("metadata_tool")
+            @JsonProperty("metadata")
             @ExcludeMissing
-            metadataTool: JsonField<MetadataTool> = JsonMissing.of(),
-        ) : this(code, detail, family, score, tool, hard, metadataTool, mutableMapOf())
+            metadata: JsonField<Metadata> = JsonMissing.of(),
+        ) : this(code, detail, family, score, tool, hard, metadata, mutableMapOf())
 
         /**
          * Machine-readable evidence code
@@ -771,7 +771,7 @@ private constructor(
          * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g. if
          *   the server responded with an unexpected value).
          */
-        fun metadataTool(): Optional<MetadataTool> = metadataTool.getOptional("metadata_tool")
+        fun metadata(): Optional<Metadata> = metadata.getOptional("metadata")
 
         /**
          * Returns the raw JSON value of [code].
@@ -816,14 +816,11 @@ private constructor(
         @JsonProperty("hard") @ExcludeMissing fun _hard(): JsonField<Boolean> = hard
 
         /**
-         * Returns the raw JSON value of [metadataTool].
+         * Returns the raw JSON value of [metadata].
          *
-         * Unlike [metadataTool], this method doesn't throw if the JSON field has an unexpected
-         * type.
+         * Unlike [metadata], this method doesn't throw if the JSON field has an unexpected type.
          */
-        @JsonProperty("metadata_tool")
-        @ExcludeMissing
-        fun _metadataTool(): JsonField<MetadataTool> = metadataTool
+        @JsonProperty("metadata") @ExcludeMissing fun _metadata(): JsonField<Metadata> = metadata
 
         @JsonAnySetter
         private fun putAdditionalProperty(key: String, value: JsonValue) {
@@ -863,7 +860,7 @@ private constructor(
             private var score: JsonField<Double>? = null
             private var tool: JsonField<String>? = null
             private var hard: JsonField<Boolean> = JsonMissing.of()
-            private var metadataTool: JsonField<MetadataTool> = JsonMissing.of()
+            private var metadata: JsonField<Metadata> = JsonMissing.of()
             private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
             @JvmSynthetic
@@ -874,7 +871,7 @@ private constructor(
                 score = evidence.score
                 tool = evidence.tool
                 hard = evidence.hard
-                metadataTool = evidence.metadataTool
+                metadata = evidence.metadata
                 additionalProperties = evidence.additionalProperties.toMutableMap()
             }
 
@@ -951,18 +948,16 @@ private constructor(
             fun hard(hard: JsonField<Boolean>) = apply { this.hard = hard }
 
             /** Raw values from the tool behind this finding; the shape varies by tool */
-            fun metadataTool(metadataTool: MetadataTool) = metadataTool(JsonField.of(metadataTool))
+            fun metadata(metadata: Metadata) = metadata(JsonField.of(metadata))
 
             /**
-             * Sets [Builder.metadataTool] to an arbitrary JSON value.
+             * Sets [Builder.metadata] to an arbitrary JSON value.
              *
-             * You should usually call [Builder.metadataTool] with a well-typed [MetadataTool] value
+             * You should usually call [Builder.metadata] with a well-typed [Metadata] value
              * instead. This method is primarily for setting the field to an undocumented or not yet
              * supported value.
              */
-            fun metadataTool(metadataTool: JsonField<MetadataTool>) = apply {
-                this.metadataTool = metadataTool
-            }
+            fun metadata(metadata: JsonField<Metadata>) = apply { this.metadata = metadata }
 
             fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
                 this.additionalProperties.clear()
@@ -1007,7 +1002,7 @@ private constructor(
                     checkRequired("score", score),
                     checkRequired("tool", tool),
                     hard,
-                    metadataTool,
+                    metadata,
                     additionalProperties.toMutableMap(),
                 )
         }
@@ -1034,7 +1029,7 @@ private constructor(
             score()
             tool()
             hard()
-            metadataTool().ifPresent { it.validate() }
+            metadata().ifPresent { it.validate() }
             validated = true
         }
 
@@ -1060,10 +1055,10 @@ private constructor(
                 (if (score.asKnown().isPresent) 1 else 0) +
                 (if (tool.asKnown().isPresent) 1 else 0) +
                 (if (hard.asKnown().isPresent) 1 else 0) +
-                (metadataTool.asKnown().getOrNull()?.validity() ?: 0)
+                (metadata.asKnown().getOrNull()?.validity() ?: 0)
 
         /** Raw values from the tool behind this finding; the shape varies by tool */
-        class MetadataTool
+        class Metadata
         @JsonCreator
         private constructor(
             @com.fasterxml.jackson.annotation.JsonValue
@@ -1078,18 +1073,18 @@ private constructor(
 
             companion object {
 
-                /** Returns a mutable builder for constructing an instance of [MetadataTool]. */
+                /** Returns a mutable builder for constructing an instance of [Metadata]. */
                 @JvmStatic fun builder() = Builder()
             }
 
-            /** A builder for [MetadataTool]. */
+            /** A builder for [Metadata]. */
             class Builder internal constructor() {
 
                 private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
                 @JvmSynthetic
-                internal fun from(metadataTool: MetadataTool) = apply {
-                    additionalProperties = metadataTool.additionalProperties.toMutableMap()
+                internal fun from(metadata: Metadata) = apply {
+                    additionalProperties = metadata.additionalProperties.toMutableMap()
                 }
 
                 fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
@@ -1115,11 +1110,11 @@ private constructor(
                 }
 
                 /**
-                 * Returns an immutable instance of [MetadataTool].
+                 * Returns an immutable instance of [Metadata].
                  *
                  * Further updates to this [Builder] will not mutate the returned instance.
                  */
-                fun build(): MetadataTool = MetadataTool(additionalProperties.toImmutable())
+                fun build(): Metadata = Metadata(additionalProperties.toImmutable())
             }
 
             private var validated: Boolean = false
@@ -1134,7 +1129,7 @@ private constructor(
              * @throws LlamaCloudInvalidDataException if any value type in this object doesn't match
              *   its expected type.
              */
-            fun validate(): MetadataTool = apply {
+            fun validate(): Metadata = apply {
                 if (validated) {
                     return@apply
                 }
@@ -1165,14 +1160,14 @@ private constructor(
                     return true
                 }
 
-                return other is MetadataTool && additionalProperties == other.additionalProperties
+                return other is Metadata && additionalProperties == other.additionalProperties
             }
 
             private val hashCode: Int by lazy { Objects.hash(additionalProperties) }
 
             override fun hashCode(): Int = hashCode
 
-            override fun toString() = "MetadataTool{additionalProperties=$additionalProperties}"
+            override fun toString() = "Metadata{additionalProperties=$additionalProperties}"
         }
 
         override fun equals(other: Any?): Boolean {
@@ -1187,27 +1182,18 @@ private constructor(
                 score == other.score &&
                 tool == other.tool &&
                 hard == other.hard &&
-                metadataTool == other.metadataTool &&
+                metadata == other.metadata &&
                 additionalProperties == other.additionalProperties
         }
 
         private val hashCode: Int by lazy {
-            Objects.hash(
-                code,
-                detail,
-                family,
-                score,
-                tool,
-                hard,
-                metadataTool,
-                additionalProperties,
-            )
+            Objects.hash(code, detail, family, score, tool, hard, metadata, additionalProperties)
         }
 
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "Evidence{code=$code, detail=$detail, family=$family, score=$score, tool=$tool, hard=$hard, metadataTool=$metadataTool, additionalProperties=$additionalProperties}"
+            "Evidence{code=$code, detail=$detail, family=$family, score=$score, tool=$tool, hard=$hard, metadata=$metadata, additionalProperties=$additionalProperties}"
     }
 
     /** A per-page forensic heatmap overlay, as a presigned image URL. */
diff --git a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/alpha/verify/VerifyGetDetailsResponseTest.kt b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/alpha/verify/VerifyGetDetailsResponseTest.kt
index e46f2cd..a04c641 100644
--- a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/alpha/verify/VerifyGetDetailsResponseTest.kt
+++ b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/alpha/verify/VerifyGetDetailsResponseTest.kt
@@ -31,8 +31,8 @@ internal class VerifyGetDetailsResponseTest {
                         .score(0.0)
                         .tool("tool")
                         .hard(true)
-                        .metadataTool(
-                            VerifyGetDetailsResponse.Evidence.MetadataTool.builder()
+                        .metadata(
+                            VerifyGetDetailsResponse.Evidence.Metadata.builder()
                                 .putAdditionalProperty("foo", JsonValue.from("bar"))
                                 .build()
                         )
@@ -91,8 +91,8 @@ internal class VerifyGetDetailsResponseTest {
                     .score(0.0)
                     .tool("tool")
                     .hard(true)
-                    .metadataTool(
-                        VerifyGetDetailsResponse.Evidence.MetadataTool.builder()
+                    .metadata(
+                        VerifyGetDetailsResponse.Evidence.Metadata.builder()
                             .putAdditionalProperty("foo", JsonValue.from("bar"))
                             .build()
                     )
@@ -158,8 +158,8 @@ internal class VerifyGetDetailsResponseTest {
                         .score(0.0)
                         .tool("tool")
                         .hard(true)
-                        .metadataTool(
-                            VerifyGetDetailsResponse.Evidence.MetadataTool.builder()
+                        .metadata(
+                            VerifyGetDetailsResponse.Evidence.Metadata.builder()
                                 .putAdditionalProperty("foo", JsonValue.from("bar"))
                                 .build()
                         )

From 031311b933c26b733dadc0181a485d16aea9fe5b Mon Sep 17 00:00:00 2001
From: stlc-bot <stlc-bot@users.noreply.github.com>
Date: Tue, 13 Oct 2026 12:51:32 +0000
Subject: [PATCH 06/11] feat(classify): add expand=usage to GET
 /api/v2/classify/{job_id} (#29577)

Stainless-Generated-From: ffff914554a3765c0f1d991d67749f8d0fe2ffc6
---
 .../models/classify/ClassifyCancelResponse.kt | 277 +++++++++++++++++-
 .../models/classify/ClassifyCreateResponse.kt | 277 +++++++++++++++++-
 .../models/classify/ClassifyGetParams.kt      |  39 ++-
 .../models/classify/ClassifyGetResponse.kt    | 277 +++++++++++++++++-
 .../models/classify/ClassifyListResponse.kt   | 277 +++++++++++++++++-
 .../services/async/ClassifyServiceAsync.kt    |   3 +-
 .../services/blocking/ClassifyService.kt      |   3 +-
 .../classify/ClassifyCancelResponseTest.kt    |  10 +
 .../classify/ClassifyCreateResponseTest.kt    |  10 +
 .../models/classify/ClassifyGetParamsTest.kt  |   3 +
 .../classify/ClassifyGetResponseTest.kt       |   4 +
 .../classify/ClassifyListPageResponseTest.kt  |  15 +
 .../classify/ClassifyListResponseTest.kt      |   4 +
 .../async/ClassifyServiceAsyncTest.kt         |   1 +
 .../services/blocking/ClassifyServiceTest.kt  |   1 +
 15 files changed, 1188 insertions(+), 13 deletions(-)

diff --git a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyCancelResponse.kt b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyCancelResponse.kt
index 7815a78..402a0df 100644
--- a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyCancelResponse.kt
+++ b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyCancelResponse.kt
@@ -37,6 +37,7 @@ private constructor(
     private val result: JsonField<ClassifyResult>,
     private val transactionId: JsonField<String>,
     private val updatedAt: JsonField<OffsetDateTime>,
+    private val usage: JsonField<Usage>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
 
@@ -74,6 +75,7 @@ private constructor(
         @JsonProperty("updated_at")
         @ExcludeMissing
         updatedAt: JsonField<OffsetDateTime> = JsonMissing.of(),
+        @JsonProperty("usage") @ExcludeMissing usage: JsonField<Usage> = JsonMissing.of(),
     ) : this(
         id,
         configuration,
@@ -89,6 +91,7 @@ private constructor(
         result,
         transactionId,
         updatedAt,
+        usage,
         mutableMapOf(),
     )
 
@@ -205,6 +208,18 @@ private constructor(
      */
     fun updatedAt(): Optional<OffsetDateTime> = updatedAt.getOptional("updated_at")
 
+    /**
+     * Usage recorded against a classify job.
+     *
+     * Classify bills through the parse job it runs on a file input, so that parse job's credits are
+     * the whole total. A job run on a parse job you created bills nothing of its own:
+     * ``parse_credits`` is null and ``credits`` is 0.
+     *
+     * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun usage(): Optional<Usage> = usage.getOptional("usage")
+
     /**
      * Returns the raw JSON value of [id].
      *
@@ -318,6 +333,13 @@ private constructor(
     @ExcludeMissing
     fun _updatedAt(): JsonField<OffsetDateTime> = updatedAt
 
+    /**
+     * Returns the raw JSON value of [usage].
+     *
+     * Unlike [usage], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("usage") @ExcludeMissing fun _usage(): JsonField<Usage> = usage
+
     @JsonAnySetter
     private fun putAdditionalProperty(key: String, value: JsonValue) {
         additionalProperties.put(key, value)
@@ -366,6 +388,7 @@ private constructor(
         private var result: JsonField<ClassifyResult> = JsonMissing.of()
         private var transactionId: JsonField<String> = JsonMissing.of()
         private var updatedAt: JsonField<OffsetDateTime> = JsonMissing.of()
+        private var usage: JsonField<Usage> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
         @JvmSynthetic
@@ -384,6 +407,7 @@ private constructor(
             result = classifyCancelResponse.result
             transactionId = classifyCancelResponse.transactionId
             updatedAt = classifyCancelResponse.updatedAt
+            usage = classifyCancelResponse.usage
             additionalProperties = classifyCancelResponse.additionalProperties.toMutableMap()
         }
 
@@ -589,6 +613,26 @@ private constructor(
          */
         fun updatedAt(updatedAt: JsonField<OffsetDateTime>) = apply { this.updatedAt = updatedAt }
 
+        /**
+         * Usage recorded against a classify job.
+         *
+         * Classify bills through the parse job it runs on a file input, so that parse job's credits
+         * are the whole total. A job run on a parse job you created bills nothing of its own:
+         * ``parse_credits`` is null and ``credits`` is 0.
+         */
+        fun usage(usage: Usage?) = usage(JsonField.ofNullable(usage))
+
+        /** Alias for calling [Builder.usage] with `usage.orElse(null)`. */
+        fun usage(usage: Optional<Usage>) = usage(usage.getOrNull())
+
+        /**
+         * Sets [Builder.usage] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.usage] with a well-typed [Usage] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun usage(usage: JsonField<Usage>) = apply { this.usage = usage }
+
         fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
             this.additionalProperties.clear()
             putAllAdditionalProperties(additionalProperties)
@@ -642,6 +686,7 @@ private constructor(
                 result,
                 transactionId,
                 updatedAt,
+                usage,
                 additionalProperties.toMutableMap(),
             )
     }
@@ -675,6 +720,7 @@ private constructor(
         result().ifPresent { it.validate() }
         transactionId()
         updatedAt()
+        usage().ifPresent { it.validate() }
         validated = true
     }
 
@@ -706,7 +752,8 @@ private constructor(
             (if (parseJobId.asKnown().isPresent) 1 else 0) +
             (result.asKnown().getOrNull()?.validity() ?: 0) +
             (if (transactionId.asKnown().isPresent) 1 else 0) +
-            (if (updatedAt.asKnown().isPresent) 1 else 0)
+            (if (updatedAt.asKnown().isPresent) 1 else 0) +
+            (usage.asKnown().getOrNull()?.validity() ?: 0)
 
     /** Whether the input was a file or parse job (FILE or PARSE_JOB) */
     class DocumentInputType @JsonCreator private constructor(private val value: JsonField<String>) :
@@ -1010,6 +1057,230 @@ private constructor(
         override fun toString() = value.toString()
     }
 
+    /**
+     * Usage recorded against a classify job.
+     *
+     * Classify bills through the parse job it runs on a file input, so that parse job's credits are
+     * the whole total. A job run on a parse job you created bills nothing of its own:
+     * ``parse_credits`` is null and ``credits`` is 0.
+     */
+    class Usage
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val credits: JsonField<Double>,
+        private val parseCredits: JsonField<Double>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("credits") @ExcludeMissing credits: JsonField<Double> = JsonMissing.of(),
+            @JsonProperty("parse_credits")
+            @ExcludeMissing
+            parseCredits: JsonField<Double> = JsonMissing.of(),
+        ) : this(credits, parseCredits, mutableMapOf())
+
+        /**
+         * Total credits billed against this job. Null until billing has recorded it.
+         *
+         * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g. if
+         *   the server responded with an unexpected value).
+         */
+        fun credits(): Optional<Double> = credits.getOptional("credits")
+
+        /**
+         * Credits billed against the parse job Classify ran on the input file
+         *
+         * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g. if
+         *   the server responded with an unexpected value).
+         */
+        fun parseCredits(): Optional<Double> = parseCredits.getOptional("parse_credits")
+
+        /**
+         * Returns the raw JSON value of [credits].
+         *
+         * Unlike [credits], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("credits") @ExcludeMissing fun _credits(): JsonField<Double> = credits
+
+        /**
+         * Returns the raw JSON value of [parseCredits].
+         *
+         * Unlike [parseCredits], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("parse_credits")
+        @ExcludeMissing
+        fun _parseCredits(): JsonField<Double> = parseCredits
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Usage]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Usage]. */
+        class Builder internal constructor() {
+
+            private var credits: JsonField<Double> = JsonMissing.of()
+            private var parseCredits: JsonField<Double> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(usage: Usage) = apply {
+                credits = usage.credits
+                parseCredits = usage.parseCredits
+                additionalProperties = usage.additionalProperties.toMutableMap()
+            }
+
+            /** Total credits billed against this job. Null until billing has recorded it. */
+            fun credits(credits: Double?) = credits(JsonField.ofNullable(credits))
+
+            /**
+             * Alias for [Builder.credits].
+             *
+             * This unboxed primitive overload exists for backwards compatibility.
+             */
+            fun credits(credits: Double) = credits(credits as Double?)
+
+            /** Alias for calling [Builder.credits] with `credits.orElse(null)`. */
+            fun credits(credits: Optional<Double>) = credits(credits.getOrNull())
+
+            /**
+             * Sets [Builder.credits] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.credits] with a well-typed [Double] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun credits(credits: JsonField<Double>) = apply { this.credits = credits }
+
+            /** Credits billed against the parse job Classify ran on the input file */
+            fun parseCredits(parseCredits: Double?) =
+                parseCredits(JsonField.ofNullable(parseCredits))
+
+            /**
+             * Alias for [Builder.parseCredits].
+             *
+             * This unboxed primitive overload exists for backwards compatibility.
+             */
+            fun parseCredits(parseCredits: Double) = parseCredits(parseCredits as Double?)
+
+            /** Alias for calling [Builder.parseCredits] with `parseCredits.orElse(null)`. */
+            fun parseCredits(parseCredits: Optional<Double>) =
+                parseCredits(parseCredits.getOrNull())
+
+            /**
+             * Sets [Builder.parseCredits] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.parseCredits] with a well-typed [Double] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun parseCredits(parseCredits: JsonField<Double>) = apply {
+                this.parseCredits = parseCredits
+            }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Usage].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Usage = Usage(credits, parseCredits, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws LlamaCloudInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Usage = apply {
+            if (validated) {
+                return@apply
+            }
+
+            credits()
+            parseCredits()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: LlamaCloudInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (credits.asKnown().isPresent) 1 else 0) +
+                (if (parseCredits.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Usage &&
+                credits == other.credits &&
+                parseCredits == other.parseCredits &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(credits, parseCredits, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Usage{credits=$credits, parseCredits=$parseCredits, additionalProperties=$additionalProperties}"
+    }
+
     override fun equals(other: Any?): Boolean {
         if (this === other) {
             return true
@@ -1030,6 +1301,7 @@ private constructor(
             result == other.result &&
             transactionId == other.transactionId &&
             updatedAt == other.updatedAt &&
+            usage == other.usage &&
             additionalProperties == other.additionalProperties
     }
 
@@ -1049,6 +1321,7 @@ private constructor(
             result,
             transactionId,
             updatedAt,
+            usage,
             additionalProperties,
         )
     }
@@ -1056,5 +1329,5 @@ private constructor(
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "ClassifyCancelResponse{id=$id, configuration=$configuration, documentInputType=$documentInputType, fileInput=$fileInput, projectId=$projectId, status=$status, userId=$userId, configurationId=$configurationId, createdAt=$createdAt, errorMessage=$errorMessage, parseJobId=$parseJobId, result=$result, transactionId=$transactionId, updatedAt=$updatedAt, additionalProperties=$additionalProperties}"
+        "ClassifyCancelResponse{id=$id, configuration=$configuration, documentInputType=$documentInputType, fileInput=$fileInput, projectId=$projectId, status=$status, userId=$userId, configurationId=$configurationId, createdAt=$createdAt, errorMessage=$errorMessage, parseJobId=$parseJobId, result=$result, transactionId=$transactionId, updatedAt=$updatedAt, usage=$usage, additionalProperties=$additionalProperties}"
 }
diff --git a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyCreateResponse.kt b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyCreateResponse.kt
index 571e45d..2abe7da 100644
--- a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyCreateResponse.kt
+++ b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyCreateResponse.kt
@@ -37,6 +37,7 @@ private constructor(
     private val result: JsonField<ClassifyResult>,
     private val transactionId: JsonField<String>,
     private val updatedAt: JsonField<OffsetDateTime>,
+    private val usage: JsonField<Usage>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
 
@@ -74,6 +75,7 @@ private constructor(
         @JsonProperty("updated_at")
         @ExcludeMissing
         updatedAt: JsonField<OffsetDateTime> = JsonMissing.of(),
+        @JsonProperty("usage") @ExcludeMissing usage: JsonField<Usage> = JsonMissing.of(),
     ) : this(
         id,
         configuration,
@@ -89,6 +91,7 @@ private constructor(
         result,
         transactionId,
         updatedAt,
+        usage,
         mutableMapOf(),
     )
 
@@ -205,6 +208,18 @@ private constructor(
      */
     fun updatedAt(): Optional<OffsetDateTime> = updatedAt.getOptional("updated_at")
 
+    /**
+     * Usage recorded against a classify job.
+     *
+     * Classify bills through the parse job it runs on a file input, so that parse job's credits are
+     * the whole total. A job run on a parse job you created bills nothing of its own:
+     * ``parse_credits`` is null and ``credits`` is 0.
+     *
+     * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun usage(): Optional<Usage> = usage.getOptional("usage")
+
     /**
      * Returns the raw JSON value of [id].
      *
@@ -318,6 +333,13 @@ private constructor(
     @ExcludeMissing
     fun _updatedAt(): JsonField<OffsetDateTime> = updatedAt
 
+    /**
+     * Returns the raw JSON value of [usage].
+     *
+     * Unlike [usage], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("usage") @ExcludeMissing fun _usage(): JsonField<Usage> = usage
+
     @JsonAnySetter
     private fun putAdditionalProperty(key: String, value: JsonValue) {
         additionalProperties.put(key, value)
@@ -366,6 +388,7 @@ private constructor(
         private var result: JsonField<ClassifyResult> = JsonMissing.of()
         private var transactionId: JsonField<String> = JsonMissing.of()
         private var updatedAt: JsonField<OffsetDateTime> = JsonMissing.of()
+        private var usage: JsonField<Usage> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
         @JvmSynthetic
@@ -384,6 +407,7 @@ private constructor(
             result = classifyCreateResponse.result
             transactionId = classifyCreateResponse.transactionId
             updatedAt = classifyCreateResponse.updatedAt
+            usage = classifyCreateResponse.usage
             additionalProperties = classifyCreateResponse.additionalProperties.toMutableMap()
         }
 
@@ -589,6 +613,26 @@ private constructor(
          */
         fun updatedAt(updatedAt: JsonField<OffsetDateTime>) = apply { this.updatedAt = updatedAt }
 
+        /**
+         * Usage recorded against a classify job.
+         *
+         * Classify bills through the parse job it runs on a file input, so that parse job's credits
+         * are the whole total. A job run on a parse job you created bills nothing of its own:
+         * ``parse_credits`` is null and ``credits`` is 0.
+         */
+        fun usage(usage: Usage?) = usage(JsonField.ofNullable(usage))
+
+        /** Alias for calling [Builder.usage] with `usage.orElse(null)`. */
+        fun usage(usage: Optional<Usage>) = usage(usage.getOrNull())
+
+        /**
+         * Sets [Builder.usage] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.usage] with a well-typed [Usage] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun usage(usage: JsonField<Usage>) = apply { this.usage = usage }
+
         fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
             this.additionalProperties.clear()
             putAllAdditionalProperties(additionalProperties)
@@ -642,6 +686,7 @@ private constructor(
                 result,
                 transactionId,
                 updatedAt,
+                usage,
                 additionalProperties.toMutableMap(),
             )
     }
@@ -675,6 +720,7 @@ private constructor(
         result().ifPresent { it.validate() }
         transactionId()
         updatedAt()
+        usage().ifPresent { it.validate() }
         validated = true
     }
 
@@ -706,7 +752,8 @@ private constructor(
             (if (parseJobId.asKnown().isPresent) 1 else 0) +
             (result.asKnown().getOrNull()?.validity() ?: 0) +
             (if (transactionId.asKnown().isPresent) 1 else 0) +
-            (if (updatedAt.asKnown().isPresent) 1 else 0)
+            (if (updatedAt.asKnown().isPresent) 1 else 0) +
+            (usage.asKnown().getOrNull()?.validity() ?: 0)
 
     /** Whether the input was a file or parse job (FILE or PARSE_JOB) */
     class DocumentInputType @JsonCreator private constructor(private val value: JsonField<String>) :
@@ -1010,6 +1057,230 @@ private constructor(
         override fun toString() = value.toString()
     }
 
+    /**
+     * Usage recorded against a classify job.
+     *
+     * Classify bills through the parse job it runs on a file input, so that parse job's credits are
+     * the whole total. A job run on a parse job you created bills nothing of its own:
+     * ``parse_credits`` is null and ``credits`` is 0.
+     */
+    class Usage
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val credits: JsonField<Double>,
+        private val parseCredits: JsonField<Double>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("credits") @ExcludeMissing credits: JsonField<Double> = JsonMissing.of(),
+            @JsonProperty("parse_credits")
+            @ExcludeMissing
+            parseCredits: JsonField<Double> = JsonMissing.of(),
+        ) : this(credits, parseCredits, mutableMapOf())
+
+        /**
+         * Total credits billed against this job. Null until billing has recorded it.
+         *
+         * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g. if
+         *   the server responded with an unexpected value).
+         */
+        fun credits(): Optional<Double> = credits.getOptional("credits")
+
+        /**
+         * Credits billed against the parse job Classify ran on the input file
+         *
+         * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g. if
+         *   the server responded with an unexpected value).
+         */
+        fun parseCredits(): Optional<Double> = parseCredits.getOptional("parse_credits")
+
+        /**
+         * Returns the raw JSON value of [credits].
+         *
+         * Unlike [credits], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("credits") @ExcludeMissing fun _credits(): JsonField<Double> = credits
+
+        /**
+         * Returns the raw JSON value of [parseCredits].
+         *
+         * Unlike [parseCredits], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("parse_credits")
+        @ExcludeMissing
+        fun _parseCredits(): JsonField<Double> = parseCredits
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Usage]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Usage]. */
+        class Builder internal constructor() {
+
+            private var credits: JsonField<Double> = JsonMissing.of()
+            private var parseCredits: JsonField<Double> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(usage: Usage) = apply {
+                credits = usage.credits
+                parseCredits = usage.parseCredits
+                additionalProperties = usage.additionalProperties.toMutableMap()
+            }
+
+            /** Total credits billed against this job. Null until billing has recorded it. */
+            fun credits(credits: Double?) = credits(JsonField.ofNullable(credits))
+
+            /**
+             * Alias for [Builder.credits].
+             *
+             * This unboxed primitive overload exists for backwards compatibility.
+             */
+            fun credits(credits: Double) = credits(credits as Double?)
+
+            /** Alias for calling [Builder.credits] with `credits.orElse(null)`. */
+            fun credits(credits: Optional<Double>) = credits(credits.getOrNull())
+
+            /**
+             * Sets [Builder.credits] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.credits] with a well-typed [Double] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun credits(credits: JsonField<Double>) = apply { this.credits = credits }
+
+            /** Credits billed against the parse job Classify ran on the input file */
+            fun parseCredits(parseCredits: Double?) =
+                parseCredits(JsonField.ofNullable(parseCredits))
+
+            /**
+             * Alias for [Builder.parseCredits].
+             *
+             * This unboxed primitive overload exists for backwards compatibility.
+             */
+            fun parseCredits(parseCredits: Double) = parseCredits(parseCredits as Double?)
+
+            /** Alias for calling [Builder.parseCredits] with `parseCredits.orElse(null)`. */
+            fun parseCredits(parseCredits: Optional<Double>) =
+                parseCredits(parseCredits.getOrNull())
+
+            /**
+             * Sets [Builder.parseCredits] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.parseCredits] with a well-typed [Double] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun parseCredits(parseCredits: JsonField<Double>) = apply {
+                this.parseCredits = parseCredits
+            }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Usage].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Usage = Usage(credits, parseCredits, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws LlamaCloudInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Usage = apply {
+            if (validated) {
+                return@apply
+            }
+
+            credits()
+            parseCredits()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: LlamaCloudInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (credits.asKnown().isPresent) 1 else 0) +
+                (if (parseCredits.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Usage &&
+                credits == other.credits &&
+                parseCredits == other.parseCredits &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(credits, parseCredits, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Usage{credits=$credits, parseCredits=$parseCredits, additionalProperties=$additionalProperties}"
+    }
+
     override fun equals(other: Any?): Boolean {
         if (this === other) {
             return true
@@ -1030,6 +1301,7 @@ private constructor(
             result == other.result &&
             transactionId == other.transactionId &&
             updatedAt == other.updatedAt &&
+            usage == other.usage &&
             additionalProperties == other.additionalProperties
     }
 
@@ -1049,6 +1321,7 @@ private constructor(
             result,
             transactionId,
             updatedAt,
+            usage,
             additionalProperties,
         )
     }
@@ -1056,5 +1329,5 @@ private constructor(
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "ClassifyCreateResponse{id=$id, configuration=$configuration, documentInputType=$documentInputType, fileInput=$fileInput, projectId=$projectId, status=$status, userId=$userId, configurationId=$configurationId, createdAt=$createdAt, errorMessage=$errorMessage, parseJobId=$parseJobId, result=$result, transactionId=$transactionId, updatedAt=$updatedAt, additionalProperties=$additionalProperties}"
+        "ClassifyCreateResponse{id=$id, configuration=$configuration, documentInputType=$documentInputType, fileInput=$fileInput, projectId=$projectId, status=$status, userId=$userId, configurationId=$configurationId, createdAt=$createdAt, errorMessage=$errorMessage, parseJobId=$parseJobId, result=$result, transactionId=$transactionId, updatedAt=$updatedAt, usage=$usage, additionalProperties=$additionalProperties}"
 }
diff --git a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyGetParams.kt b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyGetParams.kt
index fb2778e..cbfb7d4 100644
--- a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyGetParams.kt
+++ b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyGetParams.kt
@@ -5,6 +5,7 @@ package ai.llamaindex.llamacloud.models.classify
 import ai.llamaindex.llamacloud.core.Params
 import ai.llamaindex.llamacloud.core.http.Headers
 import ai.llamaindex.llamacloud.core.http.QueryParams
+import ai.llamaindex.llamacloud.core.toImmutable
 import java.util.Objects
 import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
@@ -13,11 +14,13 @@ import kotlin.jvm.optionals.getOrNull
  * Get a classify job by ID.
  *
  * Returns the job status, configuration, and classify result when complete. The result includes the
- * matched document type, confidence score, and reasoning.
+ * matched document type, confidence score, and reasoning. Use `expand=usage` for credits billed
+ * against the job.
  */
 class ClassifyGetParams
 private constructor(
     private val jobId: String?,
+    private val expand: List<String>?,
     private val organizationId: String?,
     private val projectId: String?,
     private val additionalHeaders: Headers,
@@ -26,6 +29,9 @@ private constructor(
 
     fun jobId(): Optional<String> = Optional.ofNullable(jobId)
 
+    /** Additional fields to include: usage */
+    fun expand(): Optional<List<String>> = Optional.ofNullable(expand)
+
     fun organizationId(): Optional<String> = Optional.ofNullable(organizationId)
 
     fun projectId(): Optional<String> = Optional.ofNullable(projectId)
@@ -50,6 +56,7 @@ private constructor(
     class Builder internal constructor() {
 
         private var jobId: String? = null
+        private var expand: MutableList<String>? = null
         private var organizationId: String? = null
         private var projectId: String? = null
         private var additionalHeaders: Headers.Builder = Headers.builder()
@@ -58,6 +65,7 @@ private constructor(
         @JvmSynthetic
         internal fun from(classifyGetParams: ClassifyGetParams) = apply {
             jobId = classifyGetParams.jobId
+            expand = classifyGetParams.expand?.toMutableList()
             organizationId = classifyGetParams.organizationId
             projectId = classifyGetParams.projectId
             additionalHeaders = classifyGetParams.additionalHeaders.toBuilder()
@@ -69,6 +77,21 @@ private constructor(
         /** Alias for calling [Builder.jobId] with `jobId.orElse(null)`. */
         fun jobId(jobId: Optional<String>) = jobId(jobId.getOrNull())
 
+        /** Additional fields to include: usage */
+        fun expand(expand: List<String>?) = apply { this.expand = expand?.toMutableList() }
+
+        /** Alias for calling [Builder.expand] with `expand.orElse(null)`. */
+        fun expand(expand: Optional<List<String>>) = expand(expand.getOrNull())
+
+        /**
+         * Adds a single [String] to [Builder.expand].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addExpand(expand: String) = apply {
+            this.expand = (this.expand ?: mutableListOf()).apply { add(expand) }
+        }
+
         fun organizationId(organizationId: String?) = apply { this.organizationId = organizationId }
 
         /** Alias for calling [Builder.organizationId] with `organizationId.orElse(null)`. */
@@ -186,6 +209,7 @@ private constructor(
         fun build(): ClassifyGetParams =
             ClassifyGetParams(
                 jobId,
+                expand?.toImmutable(),
                 organizationId,
                 projectId,
                 additionalHeaders.build(),
@@ -204,6 +228,7 @@ private constructor(
     override fun _queryParams(): QueryParams =
         QueryParams.builder()
             .apply {
+                expand?.forEach { put("expand", it) }
                 organizationId?.let { put("organization_id", it) }
                 projectId?.let { put("project_id", it) }
                 putAll(additionalQueryParams)
@@ -217,6 +242,7 @@ private constructor(
 
         return other is ClassifyGetParams &&
             jobId == other.jobId &&
+            expand == other.expand &&
             organizationId == other.organizationId &&
             projectId == other.projectId &&
             additionalHeaders == other.additionalHeaders &&
@@ -224,8 +250,15 @@ private constructor(
     }
 
     override fun hashCode(): Int =
-        Objects.hash(jobId, organizationId, projectId, additionalHeaders, additionalQueryParams)
+        Objects.hash(
+            jobId,
+            expand,
+            organizationId,
+            projectId,
+            additionalHeaders,
+            additionalQueryParams,
+        )
 
     override fun toString() =
-        "ClassifyGetParams{jobId=$jobId, organizationId=$organizationId, projectId=$projectId, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+        "ClassifyGetParams{jobId=$jobId, expand=$expand, organizationId=$organizationId, projectId=$projectId, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
 }
diff --git a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyGetResponse.kt b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyGetResponse.kt
index 7d3486f..7dbd24b 100644
--- a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyGetResponse.kt
+++ b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyGetResponse.kt
@@ -37,6 +37,7 @@ private constructor(
     private val result: JsonField<ClassifyResult>,
     private val transactionId: JsonField<String>,
     private val updatedAt: JsonField<OffsetDateTime>,
+    private val usage: JsonField<Usage>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
 
@@ -74,6 +75,7 @@ private constructor(
         @JsonProperty("updated_at")
         @ExcludeMissing
         updatedAt: JsonField<OffsetDateTime> = JsonMissing.of(),
+        @JsonProperty("usage") @ExcludeMissing usage: JsonField<Usage> = JsonMissing.of(),
     ) : this(
         id,
         configuration,
@@ -89,6 +91,7 @@ private constructor(
         result,
         transactionId,
         updatedAt,
+        usage,
         mutableMapOf(),
     )
 
@@ -205,6 +208,18 @@ private constructor(
      */
     fun updatedAt(): Optional<OffsetDateTime> = updatedAt.getOptional("updated_at")
 
+    /**
+     * Usage recorded against a classify job.
+     *
+     * Classify bills through the parse job it runs on a file input, so that parse job's credits are
+     * the whole total. A job run on a parse job you created bills nothing of its own:
+     * ``parse_credits`` is null and ``credits`` is 0.
+     *
+     * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun usage(): Optional<Usage> = usage.getOptional("usage")
+
     /**
      * Returns the raw JSON value of [id].
      *
@@ -318,6 +333,13 @@ private constructor(
     @ExcludeMissing
     fun _updatedAt(): JsonField<OffsetDateTime> = updatedAt
 
+    /**
+     * Returns the raw JSON value of [usage].
+     *
+     * Unlike [usage], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("usage") @ExcludeMissing fun _usage(): JsonField<Usage> = usage
+
     @JsonAnySetter
     private fun putAdditionalProperty(key: String, value: JsonValue) {
         additionalProperties.put(key, value)
@@ -366,6 +388,7 @@ private constructor(
         private var result: JsonField<ClassifyResult> = JsonMissing.of()
         private var transactionId: JsonField<String> = JsonMissing.of()
         private var updatedAt: JsonField<OffsetDateTime> = JsonMissing.of()
+        private var usage: JsonField<Usage> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
         @JvmSynthetic
@@ -384,6 +407,7 @@ private constructor(
             result = classifyGetResponse.result
             transactionId = classifyGetResponse.transactionId
             updatedAt = classifyGetResponse.updatedAt
+            usage = classifyGetResponse.usage
             additionalProperties = classifyGetResponse.additionalProperties.toMutableMap()
         }
 
@@ -589,6 +613,26 @@ private constructor(
          */
         fun updatedAt(updatedAt: JsonField<OffsetDateTime>) = apply { this.updatedAt = updatedAt }
 
+        /**
+         * Usage recorded against a classify job.
+         *
+         * Classify bills through the parse job it runs on a file input, so that parse job's credits
+         * are the whole total. A job run on a parse job you created bills nothing of its own:
+         * ``parse_credits`` is null and ``credits`` is 0.
+         */
+        fun usage(usage: Usage?) = usage(JsonField.ofNullable(usage))
+
+        /** Alias for calling [Builder.usage] with `usage.orElse(null)`. */
+        fun usage(usage: Optional<Usage>) = usage(usage.getOrNull())
+
+        /**
+         * Sets [Builder.usage] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.usage] with a well-typed [Usage] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun usage(usage: JsonField<Usage>) = apply { this.usage = usage }
+
         fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
             this.additionalProperties.clear()
             putAllAdditionalProperties(additionalProperties)
@@ -642,6 +686,7 @@ private constructor(
                 result,
                 transactionId,
                 updatedAt,
+                usage,
                 additionalProperties.toMutableMap(),
             )
     }
@@ -675,6 +720,7 @@ private constructor(
         result().ifPresent { it.validate() }
         transactionId()
         updatedAt()
+        usage().ifPresent { it.validate() }
         validated = true
     }
 
@@ -706,7 +752,8 @@ private constructor(
             (if (parseJobId.asKnown().isPresent) 1 else 0) +
             (result.asKnown().getOrNull()?.validity() ?: 0) +
             (if (transactionId.asKnown().isPresent) 1 else 0) +
-            (if (updatedAt.asKnown().isPresent) 1 else 0)
+            (if (updatedAt.asKnown().isPresent) 1 else 0) +
+            (usage.asKnown().getOrNull()?.validity() ?: 0)
 
     /** Whether the input was a file or parse job (FILE or PARSE_JOB) */
     class DocumentInputType @JsonCreator private constructor(private val value: JsonField<String>) :
@@ -1010,6 +1057,230 @@ private constructor(
         override fun toString() = value.toString()
     }
 
+    /**
+     * Usage recorded against a classify job.
+     *
+     * Classify bills through the parse job it runs on a file input, so that parse job's credits are
+     * the whole total. A job run on a parse job you created bills nothing of its own:
+     * ``parse_credits`` is null and ``credits`` is 0.
+     */
+    class Usage
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val credits: JsonField<Double>,
+        private val parseCredits: JsonField<Double>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("credits") @ExcludeMissing credits: JsonField<Double> = JsonMissing.of(),
+            @JsonProperty("parse_credits")
+            @ExcludeMissing
+            parseCredits: JsonField<Double> = JsonMissing.of(),
+        ) : this(credits, parseCredits, mutableMapOf())
+
+        /**
+         * Total credits billed against this job. Null until billing has recorded it.
+         *
+         * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g. if
+         *   the server responded with an unexpected value).
+         */
+        fun credits(): Optional<Double> = credits.getOptional("credits")
+
+        /**
+         * Credits billed against the parse job Classify ran on the input file
+         *
+         * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g. if
+         *   the server responded with an unexpected value).
+         */
+        fun parseCredits(): Optional<Double> = parseCredits.getOptional("parse_credits")
+
+        /**
+         * Returns the raw JSON value of [credits].
+         *
+         * Unlike [credits], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("credits") @ExcludeMissing fun _credits(): JsonField<Double> = credits
+
+        /**
+         * Returns the raw JSON value of [parseCredits].
+         *
+         * Unlike [parseCredits], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("parse_credits")
+        @ExcludeMissing
+        fun _parseCredits(): JsonField<Double> = parseCredits
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Usage]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Usage]. */
+        class Builder internal constructor() {
+
+            private var credits: JsonField<Double> = JsonMissing.of()
+            private var parseCredits: JsonField<Double> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(usage: Usage) = apply {
+                credits = usage.credits
+                parseCredits = usage.parseCredits
+                additionalProperties = usage.additionalProperties.toMutableMap()
+            }
+
+            /** Total credits billed against this job. Null until billing has recorded it. */
+            fun credits(credits: Double?) = credits(JsonField.ofNullable(credits))
+
+            /**
+             * Alias for [Builder.credits].
+             *
+             * This unboxed primitive overload exists for backwards compatibility.
+             */
+            fun credits(credits: Double) = credits(credits as Double?)
+
+            /** Alias for calling [Builder.credits] with `credits.orElse(null)`. */
+            fun credits(credits: Optional<Double>) = credits(credits.getOrNull())
+
+            /**
+             * Sets [Builder.credits] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.credits] with a well-typed [Double] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun credits(credits: JsonField<Double>) = apply { this.credits = credits }
+
+            /** Credits billed against the parse job Classify ran on the input file */
+            fun parseCredits(parseCredits: Double?) =
+                parseCredits(JsonField.ofNullable(parseCredits))
+
+            /**
+             * Alias for [Builder.parseCredits].
+             *
+             * This unboxed primitive overload exists for backwards compatibility.
+             */
+            fun parseCredits(parseCredits: Double) = parseCredits(parseCredits as Double?)
+
+            /** Alias for calling [Builder.parseCredits] with `parseCredits.orElse(null)`. */
+            fun parseCredits(parseCredits: Optional<Double>) =
+                parseCredits(parseCredits.getOrNull())
+
+            /**
+             * Sets [Builder.parseCredits] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.parseCredits] with a well-typed [Double] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun parseCredits(parseCredits: JsonField<Double>) = apply {
+                this.parseCredits = parseCredits
+            }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Usage].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Usage = Usage(credits, parseCredits, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws LlamaCloudInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Usage = apply {
+            if (validated) {
+                return@apply
+            }
+
+            credits()
+            parseCredits()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: LlamaCloudInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (credits.asKnown().isPresent) 1 else 0) +
+                (if (parseCredits.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Usage &&
+                credits == other.credits &&
+                parseCredits == other.parseCredits &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(credits, parseCredits, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Usage{credits=$credits, parseCredits=$parseCredits, additionalProperties=$additionalProperties}"
+    }
+
     override fun equals(other: Any?): Boolean {
         if (this === other) {
             return true
@@ -1030,6 +1301,7 @@ private constructor(
             result == other.result &&
             transactionId == other.transactionId &&
             updatedAt == other.updatedAt &&
+            usage == other.usage &&
             additionalProperties == other.additionalProperties
     }
 
@@ -1049,6 +1321,7 @@ private constructor(
             result,
             transactionId,
             updatedAt,
+            usage,
             additionalProperties,
         )
     }
@@ -1056,5 +1329,5 @@ private constructor(
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "ClassifyGetResponse{id=$id, configuration=$configuration, documentInputType=$documentInputType, fileInput=$fileInput, projectId=$projectId, status=$status, userId=$userId, configurationId=$configurationId, createdAt=$createdAt, errorMessage=$errorMessage, parseJobId=$parseJobId, result=$result, transactionId=$transactionId, updatedAt=$updatedAt, additionalProperties=$additionalProperties}"
+        "ClassifyGetResponse{id=$id, configuration=$configuration, documentInputType=$documentInputType, fileInput=$fileInput, projectId=$projectId, status=$status, userId=$userId, configurationId=$configurationId, createdAt=$createdAt, errorMessage=$errorMessage, parseJobId=$parseJobId, result=$result, transactionId=$transactionId, updatedAt=$updatedAt, usage=$usage, additionalProperties=$additionalProperties}"
 }
diff --git a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyListResponse.kt b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyListResponse.kt
index 4b4ffc8..49d1279 100644
--- a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyListResponse.kt
+++ b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyListResponse.kt
@@ -37,6 +37,7 @@ private constructor(
     private val result: JsonField<ClassifyResult>,
     private val transactionId: JsonField<String>,
     private val updatedAt: JsonField<OffsetDateTime>,
+    private val usage: JsonField<Usage>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
 
@@ -74,6 +75,7 @@ private constructor(
         @JsonProperty("updated_at")
         @ExcludeMissing
         updatedAt: JsonField<OffsetDateTime> = JsonMissing.of(),
+        @JsonProperty("usage") @ExcludeMissing usage: JsonField<Usage> = JsonMissing.of(),
     ) : this(
         id,
         configuration,
@@ -89,6 +91,7 @@ private constructor(
         result,
         transactionId,
         updatedAt,
+        usage,
         mutableMapOf(),
     )
 
@@ -205,6 +208,18 @@ private constructor(
      */
     fun updatedAt(): Optional<OffsetDateTime> = updatedAt.getOptional("updated_at")
 
+    /**
+     * Usage recorded against a classify job.
+     *
+     * Classify bills through the parse job it runs on a file input, so that parse job's credits are
+     * the whole total. A job run on a parse job you created bills nothing of its own:
+     * ``parse_credits`` is null and ``credits`` is 0.
+     *
+     * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun usage(): Optional<Usage> = usage.getOptional("usage")
+
     /**
      * Returns the raw JSON value of [id].
      *
@@ -318,6 +333,13 @@ private constructor(
     @ExcludeMissing
     fun _updatedAt(): JsonField<OffsetDateTime> = updatedAt
 
+    /**
+     * Returns the raw JSON value of [usage].
+     *
+     * Unlike [usage], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("usage") @ExcludeMissing fun _usage(): JsonField<Usage> = usage
+
     @JsonAnySetter
     private fun putAdditionalProperty(key: String, value: JsonValue) {
         additionalProperties.put(key, value)
@@ -366,6 +388,7 @@ private constructor(
         private var result: JsonField<ClassifyResult> = JsonMissing.of()
         private var transactionId: JsonField<String> = JsonMissing.of()
         private var updatedAt: JsonField<OffsetDateTime> = JsonMissing.of()
+        private var usage: JsonField<Usage> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
         @JvmSynthetic
@@ -384,6 +407,7 @@ private constructor(
             result = classifyListResponse.result
             transactionId = classifyListResponse.transactionId
             updatedAt = classifyListResponse.updatedAt
+            usage = classifyListResponse.usage
             additionalProperties = classifyListResponse.additionalProperties.toMutableMap()
         }
 
@@ -589,6 +613,26 @@ private constructor(
          */
         fun updatedAt(updatedAt: JsonField<OffsetDateTime>) = apply { this.updatedAt = updatedAt }
 
+        /**
+         * Usage recorded against a classify job.
+         *
+         * Classify bills through the parse job it runs on a file input, so that parse job's credits
+         * are the whole total. A job run on a parse job you created bills nothing of its own:
+         * ``parse_credits`` is null and ``credits`` is 0.
+         */
+        fun usage(usage: Usage?) = usage(JsonField.ofNullable(usage))
+
+        /** Alias for calling [Builder.usage] with `usage.orElse(null)`. */
+        fun usage(usage: Optional<Usage>) = usage(usage.getOrNull())
+
+        /**
+         * Sets [Builder.usage] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.usage] with a well-typed [Usage] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun usage(usage: JsonField<Usage>) = apply { this.usage = usage }
+
         fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
             this.additionalProperties.clear()
             putAllAdditionalProperties(additionalProperties)
@@ -642,6 +686,7 @@ private constructor(
                 result,
                 transactionId,
                 updatedAt,
+                usage,
                 additionalProperties.toMutableMap(),
             )
     }
@@ -675,6 +720,7 @@ private constructor(
         result().ifPresent { it.validate() }
         transactionId()
         updatedAt()
+        usage().ifPresent { it.validate() }
         validated = true
     }
 
@@ -706,7 +752,8 @@ private constructor(
             (if (parseJobId.asKnown().isPresent) 1 else 0) +
             (result.asKnown().getOrNull()?.validity() ?: 0) +
             (if (transactionId.asKnown().isPresent) 1 else 0) +
-            (if (updatedAt.asKnown().isPresent) 1 else 0)
+            (if (updatedAt.asKnown().isPresent) 1 else 0) +
+            (usage.asKnown().getOrNull()?.validity() ?: 0)
 
     /** Whether the input was a file or parse job (FILE or PARSE_JOB) */
     class DocumentInputType @JsonCreator private constructor(private val value: JsonField<String>) :
@@ -1010,6 +1057,230 @@ private constructor(
         override fun toString() = value.toString()
     }
 
+    /**
+     * Usage recorded against a classify job.
+     *
+     * Classify bills through the parse job it runs on a file input, so that parse job's credits are
+     * the whole total. A job run on a parse job you created bills nothing of its own:
+     * ``parse_credits`` is null and ``credits`` is 0.
+     */
+    class Usage
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val credits: JsonField<Double>,
+        private val parseCredits: JsonField<Double>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("credits") @ExcludeMissing credits: JsonField<Double> = JsonMissing.of(),
+            @JsonProperty("parse_credits")
+            @ExcludeMissing
+            parseCredits: JsonField<Double> = JsonMissing.of(),
+        ) : this(credits, parseCredits, mutableMapOf())
+
+        /**
+         * Total credits billed against this job. Null until billing has recorded it.
+         *
+         * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g. if
+         *   the server responded with an unexpected value).
+         */
+        fun credits(): Optional<Double> = credits.getOptional("credits")
+
+        /**
+         * Credits billed against the parse job Classify ran on the input file
+         *
+         * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g. if
+         *   the server responded with an unexpected value).
+         */
+        fun parseCredits(): Optional<Double> = parseCredits.getOptional("parse_credits")
+
+        /**
+         * Returns the raw JSON value of [credits].
+         *
+         * Unlike [credits], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("credits") @ExcludeMissing fun _credits(): JsonField<Double> = credits
+
+        /**
+         * Returns the raw JSON value of [parseCredits].
+         *
+         * Unlike [parseCredits], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("parse_credits")
+        @ExcludeMissing
+        fun _parseCredits(): JsonField<Double> = parseCredits
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Usage]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Usage]. */
+        class Builder internal constructor() {
+
+            private var credits: JsonField<Double> = JsonMissing.of()
+            private var parseCredits: JsonField<Double> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(usage: Usage) = apply {
+                credits = usage.credits
+                parseCredits = usage.parseCredits
+                additionalProperties = usage.additionalProperties.toMutableMap()
+            }
+
+            /** Total credits billed against this job. Null until billing has recorded it. */
+            fun credits(credits: Double?) = credits(JsonField.ofNullable(credits))
+
+            /**
+             * Alias for [Builder.credits].
+             *
+             * This unboxed primitive overload exists for backwards compatibility.
+             */
+            fun credits(credits: Double) = credits(credits as Double?)
+
+            /** Alias for calling [Builder.credits] with `credits.orElse(null)`. */
+            fun credits(credits: Optional<Double>) = credits(credits.getOrNull())
+
+            /**
+             * Sets [Builder.credits] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.credits] with a well-typed [Double] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun credits(credits: JsonField<Double>) = apply { this.credits = credits }
+
+            /** Credits billed against the parse job Classify ran on the input file */
+            fun parseCredits(parseCredits: Double?) =
+                parseCredits(JsonField.ofNullable(parseCredits))
+
+            /**
+             * Alias for [Builder.parseCredits].
+             *
+             * This unboxed primitive overload exists for backwards compatibility.
+             */
+            fun parseCredits(parseCredits: Double) = parseCredits(parseCredits as Double?)
+
+            /** Alias for calling [Builder.parseCredits] with `parseCredits.orElse(null)`. */
+            fun parseCredits(parseCredits: Optional<Double>) =
+                parseCredits(parseCredits.getOrNull())
+
+            /**
+             * Sets [Builder.parseCredits] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.parseCredits] with a well-typed [Double] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun parseCredits(parseCredits: JsonField<Double>) = apply {
+                this.parseCredits = parseCredits
+            }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Usage].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Usage = Usage(credits, parseCredits, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws LlamaCloudInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Usage = apply {
+            if (validated) {
+                return@apply
+            }
+
+            credits()
+            parseCredits()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: LlamaCloudInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (credits.asKnown().isPresent) 1 else 0) +
+                (if (parseCredits.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Usage &&
+                credits == other.credits &&
+                parseCredits == other.parseCredits &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(credits, parseCredits, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Usage{credits=$credits, parseCredits=$parseCredits, additionalProperties=$additionalProperties}"
+    }
+
     override fun equals(other: Any?): Boolean {
         if (this === other) {
             return true
@@ -1030,6 +1301,7 @@ private constructor(
             result == other.result &&
             transactionId == other.transactionId &&
             updatedAt == other.updatedAt &&
+            usage == other.usage &&
             additionalProperties == other.additionalProperties
     }
 
@@ -1049,6 +1321,7 @@ private constructor(
             result,
             transactionId,
             updatedAt,
+            usage,
             additionalProperties,
         )
     }
@@ -1056,5 +1329,5 @@ private constructor(
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "ClassifyListResponse{id=$id, configuration=$configuration, documentInputType=$documentInputType, fileInput=$fileInput, projectId=$projectId, status=$status, userId=$userId, configurationId=$configurationId, createdAt=$createdAt, errorMessage=$errorMessage, parseJobId=$parseJobId, result=$result, transactionId=$transactionId, updatedAt=$updatedAt, additionalProperties=$additionalProperties}"
+        "ClassifyListResponse{id=$id, configuration=$configuration, documentInputType=$documentInputType, fileInput=$fileInput, projectId=$projectId, status=$status, userId=$userId, configurationId=$configurationId, createdAt=$createdAt, errorMessage=$errorMessage, parseJobId=$parseJobId, result=$result, transactionId=$transactionId, updatedAt=$updatedAt, usage=$usage, additionalProperties=$additionalProperties}"
 }
diff --git a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/services/async/ClassifyServiceAsync.kt b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/services/async/ClassifyServiceAsync.kt
index dddf064..fc34d45 100644
--- a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/services/async/ClassifyServiceAsync.kt
+++ b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/services/async/ClassifyServiceAsync.kt
@@ -179,7 +179,8 @@ interface ClassifyServiceAsync {
      * Get a classify job by ID.
      *
      * Returns the job status, configuration, and classify result when complete. The result includes
-     * the matched document type, confidence score, and reasoning.
+     * the matched document type, confidence score, and reasoning. Use `expand=usage` for credits
+     * billed against the job.
      */
     fun get(jobId: String): CompletableFuture<ClassifyGetResponse> =
         get(jobId, ClassifyGetParams.none())
diff --git a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/services/blocking/ClassifyService.kt b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/services/blocking/ClassifyService.kt
index d0c32f8..8a9ef33 100644
--- a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/services/blocking/ClassifyService.kt
+++ b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/services/blocking/ClassifyService.kt
@@ -166,7 +166,8 @@ interface ClassifyService {
      * Get a classify job by ID.
      *
      * Returns the job status, configuration, and classify result when complete. The result includes
-     * the matched document type, confidence score, and reasoning.
+     * the matched document type, confidence score, and reasoning. Use `expand=usage` for credits
+     * billed against the job.
      */
     fun get(jobId: String): ClassifyGetResponse = get(jobId, ClassifyGetParams.none())
 
diff --git a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyCancelResponseTest.kt b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyCancelResponseTest.kt
index 6fee807..8d57540 100644
--- a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyCancelResponseTest.kt
+++ b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyCancelResponseTest.kt
@@ -53,6 +53,9 @@ internal class ClassifyCancelResponseTest {
                 )
                 .transactionId("transaction_id")
                 .updatedAt(OffsetDateTime.parse("2019-12-27T18:11:19.117Z"))
+                .usage(
+                    ClassifyCancelResponse.Usage.builder().credits(30.0).parseCredits(3.0).build()
+                )
                 .build()
 
         assertThat(classifyCancelResponse.id()).isEqualTo("id")
@@ -94,6 +97,10 @@ internal class ClassifyCancelResponseTest {
         assertThat(classifyCancelResponse.transactionId()).contains("transaction_id")
         assertThat(classifyCancelResponse.updatedAt())
             .contains(OffsetDateTime.parse("2019-12-27T18:11:19.117Z"))
+        assertThat(classifyCancelResponse.usage())
+            .contains(
+                ClassifyCancelResponse.Usage.builder().credits(30.0).parseCredits(3.0).build()
+            )
     }
 
     @Test
@@ -140,6 +147,9 @@ internal class ClassifyCancelResponseTest {
                 )
                 .transactionId("transaction_id")
                 .updatedAt(OffsetDateTime.parse("2019-12-27T18:11:19.117Z"))
+                .usage(
+                    ClassifyCancelResponse.Usage.builder().credits(30.0).parseCredits(3.0).build()
+                )
                 .build()
 
         val roundtrippedClassifyCancelResponse =
diff --git a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyCreateResponseTest.kt b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyCreateResponseTest.kt
index bdf31c8..c9ff460 100644
--- a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyCreateResponseTest.kt
+++ b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyCreateResponseTest.kt
@@ -53,6 +53,9 @@ internal class ClassifyCreateResponseTest {
                 )
                 .transactionId("transaction_id")
                 .updatedAt(OffsetDateTime.parse("2019-12-27T18:11:19.117Z"))
+                .usage(
+                    ClassifyCreateResponse.Usage.builder().credits(30.0).parseCredits(3.0).build()
+                )
                 .build()
 
         assertThat(classifyCreateResponse.id()).isEqualTo("id")
@@ -94,6 +97,10 @@ internal class ClassifyCreateResponseTest {
         assertThat(classifyCreateResponse.transactionId()).contains("transaction_id")
         assertThat(classifyCreateResponse.updatedAt())
             .contains(OffsetDateTime.parse("2019-12-27T18:11:19.117Z"))
+        assertThat(classifyCreateResponse.usage())
+            .contains(
+                ClassifyCreateResponse.Usage.builder().credits(30.0).parseCredits(3.0).build()
+            )
     }
 
     @Test
@@ -140,6 +147,9 @@ internal class ClassifyCreateResponseTest {
                 )
                 .transactionId("transaction_id")
                 .updatedAt(OffsetDateTime.parse("2019-12-27T18:11:19.117Z"))
+                .usage(
+                    ClassifyCreateResponse.Usage.builder().credits(30.0).parseCredits(3.0).build()
+                )
                 .build()
 
         val roundtrippedClassifyCreateResponse =
diff --git a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyGetParamsTest.kt b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyGetParamsTest.kt
index 52aa850..ff6914f 100644
--- a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyGetParamsTest.kt
+++ b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyGetParamsTest.kt
@@ -12,6 +12,7 @@ internal class ClassifyGetParamsTest {
     fun create() {
         ClassifyGetParams.builder()
             .jobId("job_id")
+            .addExpand("string")
             .organizationId("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
             .projectId("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
             .build()
@@ -31,6 +32,7 @@ internal class ClassifyGetParamsTest {
         val params =
             ClassifyGetParams.builder()
                 .jobId("job_id")
+                .addExpand("string")
                 .organizationId("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
                 .projectId("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
                 .build()
@@ -40,6 +42,7 @@ internal class ClassifyGetParamsTest {
         assertThat(queryParams)
             .isEqualTo(
                 QueryParams.builder()
+                    .put("expand", "string")
                     .put("organization_id", "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
                     .put("project_id", "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
                     .build()
diff --git a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyGetResponseTest.kt b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyGetResponseTest.kt
index 37a1d4a..d372a6f 100644
--- a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyGetResponseTest.kt
+++ b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyGetResponseTest.kt
@@ -53,6 +53,7 @@ internal class ClassifyGetResponseTest {
                 )
                 .transactionId("transaction_id")
                 .updatedAt(OffsetDateTime.parse("2019-12-27T18:11:19.117Z"))
+                .usage(ClassifyGetResponse.Usage.builder().credits(30.0).parseCredits(3.0).build())
                 .build()
 
         assertThat(classifyGetResponse.id()).isEqualTo("id")
@@ -93,6 +94,8 @@ internal class ClassifyGetResponseTest {
         assertThat(classifyGetResponse.transactionId()).contains("transaction_id")
         assertThat(classifyGetResponse.updatedAt())
             .contains(OffsetDateTime.parse("2019-12-27T18:11:19.117Z"))
+        assertThat(classifyGetResponse.usage())
+            .contains(ClassifyGetResponse.Usage.builder().credits(30.0).parseCredits(3.0).build())
     }
 
     @Test
@@ -139,6 +142,7 @@ internal class ClassifyGetResponseTest {
                 )
                 .transactionId("transaction_id")
                 .updatedAt(OffsetDateTime.parse("2019-12-27T18:11:19.117Z"))
+                .usage(ClassifyGetResponse.Usage.builder().credits(30.0).parseCredits(3.0).build())
                 .build()
 
         val roundtrippedClassifyGetResponse =
diff --git a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyListPageResponseTest.kt b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyListPageResponseTest.kt
index 357581f..2537c6d 100644
--- a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyListPageResponseTest.kt
+++ b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyListPageResponseTest.kt
@@ -55,6 +55,12 @@ internal class ClassifyListPageResponseTest {
                         )
                         .transactionId("transaction_id")
                         .updatedAt(OffsetDateTime.parse("2019-12-27T18:11:19.117Z"))
+                        .usage(
+                            ClassifyListResponse.Usage.builder()
+                                .credits(30.0)
+                                .parseCredits(3.0)
+                                .build()
+                        )
                         .build()
                 )
                 .nextPageToken("next_page_token")
@@ -103,6 +109,9 @@ internal class ClassifyListPageResponseTest {
                     )
                     .transactionId("transaction_id")
                     .updatedAt(OffsetDateTime.parse("2019-12-27T18:11:19.117Z"))
+                    .usage(
+                        ClassifyListResponse.Usage.builder().credits(30.0).parseCredits(3.0).build()
+                    )
                     .build()
             )
         assertThat(classifyListPageResponse.nextPageToken()).contains("next_page_token")
@@ -155,6 +164,12 @@ internal class ClassifyListPageResponseTest {
                         )
                         .transactionId("transaction_id")
                         .updatedAt(OffsetDateTime.parse("2019-12-27T18:11:19.117Z"))
+                        .usage(
+                            ClassifyListResponse.Usage.builder()
+                                .credits(30.0)
+                                .parseCredits(3.0)
+                                .build()
+                        )
                         .build()
                 )
                 .nextPageToken("next_page_token")
diff --git a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyListResponseTest.kt b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyListResponseTest.kt
index 4cb540d..1790c3a 100644
--- a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyListResponseTest.kt
+++ b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/classify/ClassifyListResponseTest.kt
@@ -53,6 +53,7 @@ internal class ClassifyListResponseTest {
                 )
                 .transactionId("transaction_id")
                 .updatedAt(OffsetDateTime.parse("2019-12-27T18:11:19.117Z"))
+                .usage(ClassifyListResponse.Usage.builder().credits(30.0).parseCredits(3.0).build())
                 .build()
 
         assertThat(classifyListResponse.id()).isEqualTo("id")
@@ -93,6 +94,8 @@ internal class ClassifyListResponseTest {
         assertThat(classifyListResponse.transactionId()).contains("transaction_id")
         assertThat(classifyListResponse.updatedAt())
             .contains(OffsetDateTime.parse("2019-12-27T18:11:19.117Z"))
+        assertThat(classifyListResponse.usage())
+            .contains(ClassifyListResponse.Usage.builder().credits(30.0).parseCredits(3.0).build())
     }
 
     @Test
@@ -139,6 +142,7 @@ internal class ClassifyListResponseTest {
                 )
                 .transactionId("transaction_id")
                 .updatedAt(OffsetDateTime.parse("2019-12-27T18:11:19.117Z"))
+                .usage(ClassifyListResponse.Usage.builder().credits(30.0).parseCredits(3.0).build())
                 .build()
 
         val roundtrippedClassifyListResponse =
diff --git a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/services/async/ClassifyServiceAsyncTest.kt b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/services/async/ClassifyServiceAsyncTest.kt
index dcb4306..f9a7d7d 100644
--- a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/services/async/ClassifyServiceAsyncTest.kt
+++ b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/services/async/ClassifyServiceAsyncTest.kt
@@ -148,6 +148,7 @@ internal class ClassifyServiceAsyncTest {
             classifyServiceAsync.get(
                 ClassifyGetParams.builder()
                     .jobId("job_id")
+                    .addExpand("string")
                     .organizationId("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
                     .projectId("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
                     .build()
diff --git a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/services/blocking/ClassifyServiceTest.kt b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/services/blocking/ClassifyServiceTest.kt
index 4895966..f7843eb 100644
--- a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/services/blocking/ClassifyServiceTest.kt
+++ b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/services/blocking/ClassifyServiceTest.kt
@@ -144,6 +144,7 @@ internal class ClassifyServiceTest {
             classifyService.get(
                 ClassifyGetParams.builder()
                     .jobId("job_id")
+                    .addExpand("string")
                     .organizationId("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
                     .projectId("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
                     .build()

From ed5a1d8b1ecc995c1d1ea7140d15861aa4b5f017 Mon Sep 17 00:00:00 2001
From: stlc-bot <stlc-bot@users.noreply.github.com>
Date: Tue, 13 Oct 2026 18:00:48 +0000
Subject: [PATCH 07/11] Add advanced_citations option to Extract (#29219)

Stainless-Generated-From: ade8db06c0edcc6016be543b1cfd422808bb474e
---
 .../configurations/ExtractV2Parameters.kt     | 51 ++++++++++++++++++-
 .../models/extract/ExtractConfiguration.kt    | 51 ++++++++++++++++++-
 .../configurations/ExtractV2ParametersTest.kt |  3 ++
 .../extract/ExtractConfigurationTest.kt       |  3 ++
 .../models/extract/ExtractCreateParamsTest.kt |  4 ++
 .../models/extract/ExtractV2JobCreateTest.kt  |  3 ++
 .../extract/ExtractV2JobQueryResponseTest.kt  |  3 ++
 .../models/extract/ExtractV2JobTest.kt        |  3 ++
 .../services/async/ExtractServiceAsyncTest.kt |  1 +
 .../services/blocking/ExtractServiceTest.kt   |  1 +
 10 files changed, 121 insertions(+), 2 deletions(-)

diff --git a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/configurations/ExtractV2Parameters.kt b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/configurations/ExtractV2Parameters.kt
index 3af6d57..2fcdb01 100644
--- a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/configurations/ExtractV2Parameters.kt
+++ b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/configurations/ExtractV2Parameters.kt
@@ -26,6 +26,7 @@ class ExtractV2Parameters
 private constructor(
     private val dataSchema: JsonField<DataSchema>,
     private val productType: JsonValue,
+    private val advancedCitations: JsonField<Boolean>,
     private val citeSources: JsonField<Boolean>,
     private val confidenceScores: JsonField<Boolean>,
     private val disableCache: JsonField<Boolean>,
@@ -48,6 +49,9 @@ private constructor(
         @ExcludeMissing
         dataSchema: JsonField<DataSchema> = JsonMissing.of(),
         @JsonProperty("product_type") @ExcludeMissing productType: JsonValue = JsonMissing.of(),
+        @JsonProperty("advanced_citations")
+        @ExcludeMissing
+        advancedCitations: JsonField<Boolean> = JsonMissing.of(),
         @JsonProperty("cite_sources")
         @ExcludeMissing
         citeSources: JsonField<Boolean> = JsonMissing.of(),
@@ -84,6 +88,7 @@ private constructor(
     ) : this(
         dataSchema,
         productType,
+        advancedCitations,
         citeSources,
         confidenceScores,
         disableCache,
@@ -122,6 +127,15 @@ private constructor(
      */
     @JsonProperty("product_type") @ExcludeMissing fun _productType(): JsonValue = productType
 
+    /**
+     * More precise citation bounding boxes. Set to false for faster extraction with less precise
+     * boxes.
+     *
+     * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun advancedCitations(): Optional<Boolean> = advancedCitations.getOptional("advanced_citations")
+
     /**
      * Include citations in results. Returned under `extract_metadata` (auto-included when set).
      * Text-level on `turbo` (no bounding boxes).
@@ -253,6 +267,16 @@ private constructor(
     @ExcludeMissing
     fun _dataSchema(): JsonField<DataSchema> = dataSchema
 
+    /**
+     * Returns the raw JSON value of [advancedCitations].
+     *
+     * Unlike [advancedCitations], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("advanced_citations")
+    @ExcludeMissing
+    fun _advancedCitations(): JsonField<Boolean> = advancedCitations
+
     /**
      * Returns the raw JSON value of [citeSources].
      *
@@ -394,6 +418,7 @@ private constructor(
 
         private var dataSchema: JsonField<DataSchema>? = null
         private var productType: JsonValue = JsonValue.from("extract_v2")
+        private var advancedCitations: JsonField<Boolean> = JsonMissing.of()
         private var citeSources: JsonField<Boolean> = JsonMissing.of()
         private var confidenceScores: JsonField<Boolean> = JsonMissing.of()
         private var disableCache: JsonField<Boolean> = JsonMissing.of()
@@ -413,6 +438,7 @@ private constructor(
         internal fun from(extractV2Parameters: ExtractV2Parameters) = apply {
             dataSchema = extractV2Parameters.dataSchema
             productType = extractV2Parameters.productType
+            advancedCitations = extractV2Parameters.advancedCitations
             citeSources = extractV2Parameters.citeSources
             confidenceScores = extractV2Parameters.confidenceScores
             disableCache = extractV2Parameters.disableCache
@@ -458,6 +484,24 @@ private constructor(
          */
         fun productType(productType: JsonValue) = apply { this.productType = productType }
 
+        /**
+         * More precise citation bounding boxes. Set to false for faster extraction with less
+         * precise boxes.
+         */
+        fun advancedCitations(advancedCitations: Boolean) =
+            advancedCitations(JsonField.of(advancedCitations))
+
+        /**
+         * Sets [Builder.advancedCitations] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.advancedCitations] with a well-typed [Boolean] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun advancedCitations(advancedCitations: JsonField<Boolean>) = apply {
+            this.advancedCitations = advancedCitations
+        }
+
         /**
          * Include citations in results. Returned under `extract_metadata` (auto-included when set).
          * Text-level on `turbo` (no bounding boxes).
@@ -741,6 +785,7 @@ private constructor(
             ExtractV2Parameters(
                 checkRequired("dataSchema", dataSchema),
                 productType,
+                advancedCitations,
                 citeSources,
                 confidenceScores,
                 disableCache,
@@ -779,6 +824,7 @@ private constructor(
                 throw LlamaCloudInvalidDataException("'productType' is invalid, received $it")
             }
         }
+        advancedCitations()
         citeSources()
         confidenceScores()
         disableCache()
@@ -812,6 +858,7 @@ private constructor(
     internal fun validity(): Int =
         (dataSchema.asKnown().getOrNull()?.validity() ?: 0) +
             productType.let { if (it == JsonValue.from("extract_v2")) 1 else 0 } +
+            (if (advancedCitations.asKnown().isPresent) 1 else 0) +
             (if (citeSources.asKnown().isPresent) 1 else 0) +
             (if (confidenceScores.asKnown().isPresent) 1 else 0) +
             (if (disableCache.asKnown().isPresent) 1 else 0) +
@@ -1404,6 +1451,7 @@ private constructor(
         return other is ExtractV2Parameters &&
             dataSchema == other.dataSchema &&
             productType == other.productType &&
+            advancedCitations == other.advancedCitations &&
             citeSources == other.citeSources &&
             confidenceScores == other.confidenceScores &&
             disableCache == other.disableCache &&
@@ -1424,6 +1472,7 @@ private constructor(
         Objects.hash(
             dataSchema,
             productType,
+            advancedCitations,
             citeSources,
             confidenceScores,
             disableCache,
@@ -1444,5 +1493,5 @@ private constructor(
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "ExtractV2Parameters{dataSchema=$dataSchema, productType=$productType, citeSources=$citeSources, confidenceScores=$confidenceScores, disableCache=$disableCache, extractionTarget=$extractionTarget, maxPages=$maxPages, parseConfigId=$parseConfigId, parseTier=$parseTier, sheetNames=$sheetNames, spreadsheetMode=$spreadsheetMode, systemPrompt=$systemPrompt, targetPages=$targetPages, tier=$tier, version=$version, additionalProperties=$additionalProperties}"
+        "ExtractV2Parameters{dataSchema=$dataSchema, productType=$productType, advancedCitations=$advancedCitations, citeSources=$citeSources, confidenceScores=$confidenceScores, disableCache=$disableCache, extractionTarget=$extractionTarget, maxPages=$maxPages, parseConfigId=$parseConfigId, parseTier=$parseTier, sheetNames=$sheetNames, spreadsheetMode=$spreadsheetMode, systemPrompt=$systemPrompt, targetPages=$targetPages, tier=$tier, version=$version, additionalProperties=$additionalProperties}"
 }
diff --git a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/extract/ExtractConfiguration.kt b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/extract/ExtractConfiguration.kt
index 241749e..2ad6723 100644
--- a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/extract/ExtractConfiguration.kt
+++ b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/extract/ExtractConfiguration.kt
@@ -25,6 +25,7 @@ class ExtractConfiguration
 @JsonCreator(mode = JsonCreator.Mode.DISABLED)
 private constructor(
     private val dataSchema: JsonField<DataSchema>,
+    private val advancedCitations: JsonField<Boolean>,
     private val citeSources: JsonField<Boolean>,
     private val confidenceScores: JsonField<Boolean>,
     private val disableCache: JsonField<Boolean>,
@@ -46,6 +47,9 @@ private constructor(
         @JsonProperty("data_schema")
         @ExcludeMissing
         dataSchema: JsonField<DataSchema> = JsonMissing.of(),
+        @JsonProperty("advanced_citations")
+        @ExcludeMissing
+        advancedCitations: JsonField<Boolean> = JsonMissing.of(),
         @JsonProperty("cite_sources")
         @ExcludeMissing
         citeSources: JsonField<Boolean> = JsonMissing.of(),
@@ -81,6 +85,7 @@ private constructor(
         @JsonProperty("version") @ExcludeMissing version: JsonField<String> = JsonMissing.of(),
     ) : this(
         dataSchema,
+        advancedCitations,
         citeSources,
         confidenceScores,
         disableCache,
@@ -106,6 +111,15 @@ private constructor(
      */
     fun dataSchema(): DataSchema = dataSchema.getRequired("data_schema")
 
+    /**
+     * More precise citation bounding boxes. Set to false for faster extraction with less precise
+     * boxes.
+     *
+     * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun advancedCitations(): Optional<Boolean> = advancedCitations.getOptional("advanced_citations")
+
     /**
      * Include citations in results. Returned under `extract_metadata` (auto-included when set).
      * Text-level on `turbo` (no bounding boxes).
@@ -237,6 +251,16 @@ private constructor(
     @ExcludeMissing
     fun _dataSchema(): JsonField<DataSchema> = dataSchema
 
+    /**
+     * Returns the raw JSON value of [advancedCitations].
+     *
+     * Unlike [advancedCitations], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("advanced_citations")
+    @ExcludeMissing
+    fun _advancedCitations(): JsonField<Boolean> = advancedCitations
+
     /**
      * Returns the raw JSON value of [citeSources].
      *
@@ -377,6 +401,7 @@ private constructor(
     class Builder internal constructor() {
 
         private var dataSchema: JsonField<DataSchema>? = null
+        private var advancedCitations: JsonField<Boolean> = JsonMissing.of()
         private var citeSources: JsonField<Boolean> = JsonMissing.of()
         private var confidenceScores: JsonField<Boolean> = JsonMissing.of()
         private var disableCache: JsonField<Boolean> = JsonMissing.of()
@@ -395,6 +420,7 @@ private constructor(
         @JvmSynthetic
         internal fun from(extractConfiguration: ExtractConfiguration) = apply {
             dataSchema = extractConfiguration.dataSchema
+            advancedCitations = extractConfiguration.advancedCitations
             citeSources = extractConfiguration.citeSources
             confidenceScores = extractConfiguration.confidenceScores
             disableCache = extractConfiguration.disableCache
@@ -426,6 +452,24 @@ private constructor(
          */
         fun dataSchema(dataSchema: JsonField<DataSchema>) = apply { this.dataSchema = dataSchema }
 
+        /**
+         * More precise citation bounding boxes. Set to false for faster extraction with less
+         * precise boxes.
+         */
+        fun advancedCitations(advancedCitations: Boolean) =
+            advancedCitations(JsonField.of(advancedCitations))
+
+        /**
+         * Sets [Builder.advancedCitations] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.advancedCitations] with a well-typed [Boolean] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun advancedCitations(advancedCitations: JsonField<Boolean>) = apply {
+            this.advancedCitations = advancedCitations
+        }
+
         /**
          * Include citations in results. Returned under `extract_metadata` (auto-included when set).
          * Text-level on `turbo` (no bounding boxes).
@@ -708,6 +752,7 @@ private constructor(
         fun build(): ExtractConfiguration =
             ExtractConfiguration(
                 checkRequired("dataSchema", dataSchema),
+                advancedCitations,
                 citeSources,
                 confidenceScores,
                 disableCache,
@@ -741,6 +786,7 @@ private constructor(
         }
 
         dataSchema().validate()
+        advancedCitations()
         citeSources()
         confidenceScores()
         disableCache()
@@ -773,6 +819,7 @@ private constructor(
     @JvmSynthetic
     internal fun validity(): Int =
         (dataSchema.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (advancedCitations.asKnown().isPresent) 1 else 0) +
             (if (citeSources.asKnown().isPresent) 1 else 0) +
             (if (confidenceScores.asKnown().isPresent) 1 else 0) +
             (if (disableCache.asKnown().isPresent) 1 else 0) +
@@ -1364,6 +1411,7 @@ private constructor(
 
         return other is ExtractConfiguration &&
             dataSchema == other.dataSchema &&
+            advancedCitations == other.advancedCitations &&
             citeSources == other.citeSources &&
             confidenceScores == other.confidenceScores &&
             disableCache == other.disableCache &&
@@ -1383,6 +1431,7 @@ private constructor(
     private val hashCode: Int by lazy {
         Objects.hash(
             dataSchema,
+            advancedCitations,
             citeSources,
             confidenceScores,
             disableCache,
@@ -1403,5 +1452,5 @@ private constructor(
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "ExtractConfiguration{dataSchema=$dataSchema, citeSources=$citeSources, confidenceScores=$confidenceScores, disableCache=$disableCache, extractionTarget=$extractionTarget, maxPages=$maxPages, parseConfigId=$parseConfigId, parseTier=$parseTier, sheetNames=$sheetNames, spreadsheetMode=$spreadsheetMode, systemPrompt=$systemPrompt, targetPages=$targetPages, tier=$tier, version=$version, additionalProperties=$additionalProperties}"
+        "ExtractConfiguration{dataSchema=$dataSchema, advancedCitations=$advancedCitations, citeSources=$citeSources, confidenceScores=$confidenceScores, disableCache=$disableCache, extractionTarget=$extractionTarget, maxPages=$maxPages, parseConfigId=$parseConfigId, parseTier=$parseTier, sheetNames=$sheetNames, spreadsheetMode=$spreadsheetMode, systemPrompt=$systemPrompt, targetPages=$targetPages, tier=$tier, version=$version, additionalProperties=$additionalProperties}"
 }
diff --git a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/configurations/ExtractV2ParametersTest.kt b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/configurations/ExtractV2ParametersTest.kt
index e6f5ef6..9d96aa7 100644
--- a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/configurations/ExtractV2ParametersTest.kt
+++ b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/configurations/ExtractV2ParametersTest.kt
@@ -20,6 +20,7 @@ internal class ExtractV2ParametersTest {
                         .putAdditionalProperty("foo", JsonValue.from(mapOf("foo" to "bar")))
                         .build()
                 )
+                .advancedCitations(false)
                 .citeSources(true)
                 .confidenceScores(true)
                 .disableCache(true)
@@ -44,6 +45,7 @@ internal class ExtractV2ParametersTest {
                     .putAdditionalProperty("foo", JsonValue.from(mapOf("foo" to "bar")))
                     .build()
             )
+        assertThat(extractV2Parameters.advancedCitations()).contains(false)
         assertThat(extractV2Parameters.citeSources()).contains(true)
         assertThat(extractV2Parameters.confidenceScores()).contains(true)
         assertThat(extractV2Parameters.disableCache()).contains(true)
@@ -75,6 +77,7 @@ internal class ExtractV2ParametersTest {
                         .putAdditionalProperty("foo", JsonValue.from(mapOf("foo" to "bar")))
                         .build()
                 )
+                .advancedCitations(false)
                 .citeSources(true)
                 .confidenceScores(true)
                 .disableCache(true)
diff --git a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/extract/ExtractConfigurationTest.kt b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/extract/ExtractConfigurationTest.kt
index 3143c21..d3867b7 100644
--- a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/extract/ExtractConfigurationTest.kt
+++ b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/extract/ExtractConfigurationTest.kt
@@ -20,6 +20,7 @@ internal class ExtractConfigurationTest {
                         .putAdditionalProperty("foo", JsonValue.from(mapOf("foo" to "bar")))
                         .build()
                 )
+                .advancedCitations(false)
                 .citeSources(true)
                 .confidenceScores(true)
                 .disableCache(true)
@@ -44,6 +45,7 @@ internal class ExtractConfigurationTest {
                     .putAdditionalProperty("foo", JsonValue.from(mapOf("foo" to "bar")))
                     .build()
             )
+        assertThat(extractConfiguration.advancedCitations()).contains(false)
         assertThat(extractConfiguration.citeSources()).contains(true)
         assertThat(extractConfiguration.confidenceScores()).contains(true)
         assertThat(extractConfiguration.disableCache()).contains(true)
@@ -75,6 +77,7 @@ internal class ExtractConfigurationTest {
                         .putAdditionalProperty("foo", JsonValue.from(mapOf("foo" to "bar")))
                         .build()
                 )
+                .advancedCitations(false)
                 .citeSources(true)
                 .confidenceScores(true)
                 .disableCache(true)
diff --git a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/extract/ExtractCreateParamsTest.kt b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/extract/ExtractCreateParamsTest.kt
index be5d11e..e5f096b 100644
--- a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/extract/ExtractCreateParamsTest.kt
+++ b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/extract/ExtractCreateParamsTest.kt
@@ -34,6 +34,7 @@ internal class ExtractCreateParamsTest {
                                     .putAdditionalProperty("type", JsonValue.from("object"))
                                     .build()
                             )
+                            .advancedCitations(false)
                             .citeSources(true)
                             .confidenceScores(true)
                             .disableCache(true)
@@ -110,6 +111,7 @@ internal class ExtractCreateParamsTest {
                                         .putAdditionalProperty("type", JsonValue.from("object"))
                                         .build()
                                 )
+                                .advancedCitations(false)
                                 .citeSources(true)
                                 .confidenceScores(true)
                                 .disableCache(true)
@@ -213,6 +215,7 @@ internal class ExtractCreateParamsTest {
                                         .putAdditionalProperty("type", JsonValue.from("object"))
                                         .build()
                                 )
+                                .advancedCitations(false)
                                 .citeSources(true)
                                 .confidenceScores(true)
                                 .disableCache(true)
@@ -283,6 +286,7 @@ internal class ExtractCreateParamsTest {
                                     .putAdditionalProperty("type", JsonValue.from("object"))
                                     .build()
                             )
+                            .advancedCitations(false)
                             .citeSources(true)
                             .confidenceScores(true)
                             .disableCache(true)
diff --git a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/extract/ExtractV2JobCreateTest.kt b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/extract/ExtractV2JobCreateTest.kt
index 2f4f02e..1b257ec 100644
--- a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/extract/ExtractV2JobCreateTest.kt
+++ b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/extract/ExtractV2JobCreateTest.kt
@@ -33,6 +33,7 @@ internal class ExtractV2JobCreateTest {
                                 .putAdditionalProperty("type", JsonValue.from("object"))
                                 .build()
                         )
+                        .advancedCitations(false)
                         .citeSources(true)
                         .confidenceScores(true)
                         .disableCache(true)
@@ -97,6 +98,7 @@ internal class ExtractV2JobCreateTest {
                             .putAdditionalProperty("type", JsonValue.from("object"))
                             .build()
                     )
+                    .advancedCitations(false)
                     .citeSources(true)
                     .confidenceScores(true)
                     .disableCache(true)
@@ -163,6 +165,7 @@ internal class ExtractV2JobCreateTest {
                                 .putAdditionalProperty("type", JsonValue.from("object"))
                                 .build()
                         )
+                        .advancedCitations(false)
                         .citeSources(true)
                         .confidenceScores(true)
                         .disableCache(true)
diff --git a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/extract/ExtractV2JobQueryResponseTest.kt b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/extract/ExtractV2JobQueryResponseTest.kt
index ca9610a..1e03064 100644
--- a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/extract/ExtractV2JobQueryResponseTest.kt
+++ b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/extract/ExtractV2JobQueryResponseTest.kt
@@ -33,6 +33,7 @@ internal class ExtractV2JobQueryResponseTest {
                                         )
                                         .build()
                                 )
+                                .advancedCitations(false)
                                 .citeSources(true)
                                 .confidenceScores(true)
                                 .disableCache(true)
@@ -183,6 +184,7 @@ internal class ExtractV2JobQueryResponseTest {
                                     )
                                     .build()
                             )
+                            .advancedCitations(false)
                             .citeSources(true)
                             .confidenceScores(true)
                             .disableCache(true)
@@ -337,6 +339,7 @@ internal class ExtractV2JobQueryResponseTest {
                                         )
                                         .build()
                                 )
+                                .advancedCitations(false)
                                 .citeSources(true)
                                 .confidenceScores(true)
                                 .disableCache(true)
diff --git a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/extract/ExtractV2JobTest.kt b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/extract/ExtractV2JobTest.kt
index 5f8d134..e501527 100644
--- a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/extract/ExtractV2JobTest.kt
+++ b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/extract/ExtractV2JobTest.kt
@@ -28,6 +28,7 @@ internal class ExtractV2JobTest {
                                 .putAdditionalProperty("foo", JsonValue.from(mapOf("foo" to "bar")))
                                 .build()
                         )
+                        .advancedCitations(false)
                         .citeSources(true)
                         .confidenceScores(true)
                         .disableCache(true)
@@ -168,6 +169,7 @@ internal class ExtractV2JobTest {
                             .putAdditionalProperty("foo", JsonValue.from(mapOf("foo" to "bar")))
                             .build()
                     )
+                    .advancedCitations(false)
                     .citeSources(true)
                     .confidenceScores(true)
                     .disableCache(true)
@@ -314,6 +316,7 @@ internal class ExtractV2JobTest {
                                 .putAdditionalProperty("foo", JsonValue.from(mapOf("foo" to "bar")))
                                 .build()
                         )
+                        .advancedCitations(false)
                         .citeSources(true)
                         .confidenceScores(true)
                         .disableCache(true)
diff --git a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/services/async/ExtractServiceAsyncTest.kt b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/services/async/ExtractServiceAsyncTest.kt
index e3c4ba6..6edd622 100644
--- a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/services/async/ExtractServiceAsyncTest.kt
+++ b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/services/async/ExtractServiceAsyncTest.kt
@@ -54,6 +54,7 @@ internal class ExtractServiceAsyncTest {
                                             .putAdditionalProperty("type", JsonValue.from("object"))
                                             .build()
                                     )
+                                    .advancedCitations(false)
                                     .citeSources(true)
                                     .confidenceScores(true)
                                     .disableCache(true)
diff --git a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/services/blocking/ExtractServiceTest.kt b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/services/blocking/ExtractServiceTest.kt
index 9f4f247..549efec 100644
--- a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/services/blocking/ExtractServiceTest.kt
+++ b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/services/blocking/ExtractServiceTest.kt
@@ -54,6 +54,7 @@ internal class ExtractServiceTest {
                                             .putAdditionalProperty("type", JsonValue.from("object"))
                                             .build()
                                     )
+                                    .advancedCitations(false)
                                     .citeSources(true)
                                     .confidenceScores(true)
                                     .disableCache(true)

From fe060d2d78a5c18cd68eaf7f0c1b1b934f32785b Mon Sep 17 00:00:00 2001
From: stlc-bot <stlc-bot@users.noreply.github.com>
Date: Tue, 13 Oct 2026 20:53:48 +0000
Subject: [PATCH 08/11] PROD-10337: Unpublish the deprecated file_id from
 Verify requests (#29634)

Stainless-Generated-From: 7dd3ce1c31d78f683e51b3804c9c9f06792a23a0
---
 .../models/alpha/verify/VerifyCreateParams.kt | 247 +++++++-----------
 .../async/alpha/VerifyServiceAsync.kt         |  32 +--
 .../services/blocking/alpha/VerifyService.kt  |  29 +-
 .../alpha/verify/VerifyCreateParamsTest.kt    |  24 +-
 .../async/alpha/VerifyServiceAsyncTest.kt     |   3 +-
 .../blocking/alpha/VerifyServiceTest.kt       |   3 +-
 6 files changed, 125 insertions(+), 213 deletions(-)

diff --git a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/alpha/verify/VerifyCreateParams.kt b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/alpha/verify/VerifyCreateParams.kt
index 36f3f95..380a0c8 100644
--- a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/alpha/verify/VerifyCreateParams.kt
+++ b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/alpha/verify/VerifyCreateParams.kt
@@ -9,6 +9,7 @@ import ai.llamaindex.llamacloud.core.JsonMissing
 import ai.llamaindex.llamacloud.core.JsonValue
 import ai.llamaindex.llamacloud.core.Params
 import ai.llamaindex.llamacloud.core.checkKnown
+import ai.llamaindex.llamacloud.core.checkRequired
 import ai.llamaindex.llamacloud.core.http.Headers
 import ai.llamaindex.llamacloud.core.http.QueryParams
 import ai.llamaindex.llamacloud.core.toImmutable
@@ -46,28 +47,20 @@ private constructor(
     fun projectId(): Optional<String> = Optional.ofNullable(projectId)
 
     /**
-     * Configuration for a Verify job.
-     *
-     * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g. if the
-     *   server responded with an unexpected value).
-     */
-    fun configuration(): Optional<Configuration> = body.configuration()
-
-    /**
-     * Deprecated: use file_input instead
+     * File ID of the document to analyze
      *
-     * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g. if the
-     *   server responded with an unexpected value).
+     * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
      */
-    @Deprecated("deprecated") fun fileId(): Optional<String> = body.fileId()
+    fun fileInput(): String = body.fileInput()
 
     /**
-     * File ID of the document to analyze
+     * Configuration for a Verify job.
      *
      * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
      */
-    fun fileInput(): Optional<String> = body.fileInput()
+    fun configuration(): Optional<Configuration> = body.configuration()
 
     /**
      * Idempotency key scoped to the project. Reusing a key returns the original job; the new
@@ -95,25 +88,18 @@ private constructor(
     fun webhookConfigurations(): Optional<List<WebhookConfiguration>> = body.webhookConfigurations()
 
     /**
-     * Returns the raw JSON value of [configuration].
-     *
-     * Unlike [configuration], this method doesn't throw if the JSON field has an unexpected type.
-     */
-    fun _configuration(): JsonField<Configuration> = body._configuration()
-
-    /**
-     * Returns the raw JSON value of [fileId].
+     * Returns the raw JSON value of [fileInput].
      *
-     * Unlike [fileId], this method doesn't throw if the JSON field has an unexpected type.
+     * Unlike [fileInput], this method doesn't throw if the JSON field has an unexpected type.
      */
-    @Deprecated("deprecated") fun _fileId(): JsonField<String> = body._fileId()
+    fun _fileInput(): JsonField<String> = body._fileInput()
 
     /**
-     * Returns the raw JSON value of [fileInput].
+     * Returns the raw JSON value of [configuration].
      *
-     * Unlike [fileInput], this method doesn't throw if the JSON field has an unexpected type.
+     * Unlike [configuration], this method doesn't throw if the JSON field has an unexpected type.
      */
-    fun _fileInput(): JsonField<String> = body._fileInput()
+    fun _configuration(): JsonField<Configuration> = body._configuration()
 
     /**
      * Returns the raw JSON value of [transactionId].
@@ -151,9 +137,14 @@ private constructor(
 
     companion object {
 
-        @JvmStatic fun none(): VerifyCreateParams = builder().build()
-
-        /** Returns a mutable builder for constructing an instance of [VerifyCreateParams]. */
+        /**
+         * Returns a mutable builder for constructing an instance of [VerifyCreateParams].
+         *
+         * The following fields are required:
+         * ```java
+         * .fileInput()
+         * ```
+         */
         @JvmStatic fun builder() = Builder()
     }
 
@@ -191,15 +182,27 @@ private constructor(
          *
          * This is generally only useful if you are already constructing the body separately.
          * Otherwise, it's more convenient to use the top-level setters instead:
-         * - [configuration]
-         * - [fileId]
          * - [fileInput]
+         * - [configuration]
          * - [transactionId]
          * - [webhookConfigurationIds]
+         * - [webhookConfigurations]
          * - etc.
          */
         fun body(body: Body) = apply { this.body = body.toBuilder() }
 
+        /** File ID of the document to analyze */
+        fun fileInput(fileInput: String) = apply { body.fileInput(fileInput) }
+
+        /**
+         * Sets [Builder.fileInput] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.fileInput] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun fileInput(fileInput: JsonField<String>) = apply { body.fileInput(fileInput) }
+
         /** Configuration for a Verify job. */
         fun configuration(configuration: Configuration?) = apply {
             body.configuration(configuration)
@@ -220,36 +223,6 @@ private constructor(
             body.configuration(configuration)
         }
 
-        /** Deprecated: use file_input instead */
-        @Deprecated("deprecated") fun fileId(fileId: String?) = apply { body.fileId(fileId) }
-
-        /** Alias for calling [Builder.fileId] with `fileId.orElse(null)`. */
-        @Deprecated("deprecated") fun fileId(fileId: Optional<String>) = fileId(fileId.getOrNull())
-
-        /**
-         * Sets [Builder.fileId] to an arbitrary JSON value.
-         *
-         * You should usually call [Builder.fileId] with a well-typed [String] value instead. This
-         * method is primarily for setting the field to an undocumented or not yet supported value.
-         */
-        @Deprecated("deprecated")
-        fun fileId(fileId: JsonField<String>) = apply { body.fileId(fileId) }
-
-        /** File ID of the document to analyze */
-        fun fileInput(fileInput: String?) = apply { body.fileInput(fileInput) }
-
-        /** Alias for calling [Builder.fileInput] with `fileInput.orElse(null)`. */
-        fun fileInput(fileInput: Optional<String>) = fileInput(fileInput.getOrNull())
-
-        /**
-         * Sets [Builder.fileInput] to an arbitrary JSON value.
-         *
-         * You should usually call [Builder.fileInput] with a well-typed [String] value instead.
-         * This method is primarily for setting the field to an undocumented or not yet supported
-         * value.
-         */
-        fun fileInput(fileInput: JsonField<String>) = apply { body.fileInput(fileInput) }
-
         /**
          * Idempotency key scoped to the project. Reusing a key returns the original job; the new
          * request body is ignored.
@@ -457,6 +430,13 @@ private constructor(
          * Returns an immutable instance of [VerifyCreateParams].
          *
          * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .fileInput()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
          */
         fun build(): VerifyCreateParams =
             VerifyCreateParams(
@@ -485,9 +465,8 @@ private constructor(
     class Body
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
     private constructor(
-        private val configuration: JsonField<Configuration>,
-        private val fileId: JsonField<String>,
         private val fileInput: JsonField<String>,
+        private val configuration: JsonField<Configuration>,
         private val transactionId: JsonField<String>,
         private val webhookConfigurationIds: JsonField<List<String>>,
         private val webhookConfigurations: JsonField<List<WebhookConfiguration>>,
@@ -496,13 +475,12 @@ private constructor(
 
         @JsonCreator
         private constructor(
-            @JsonProperty("configuration")
-            @ExcludeMissing
-            configuration: JsonField<Configuration> = JsonMissing.of(),
-            @JsonProperty("file_id") @ExcludeMissing fileId: JsonField<String> = JsonMissing.of(),
             @JsonProperty("file_input")
             @ExcludeMissing
             fileInput: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("configuration")
+            @ExcludeMissing
+            configuration: JsonField<Configuration> = JsonMissing.of(),
             @JsonProperty("transaction_id")
             @ExcludeMissing
             transactionId: JsonField<String> = JsonMissing.of(),
@@ -513,9 +491,8 @@ private constructor(
             @ExcludeMissing
             webhookConfigurations: JsonField<List<WebhookConfiguration>> = JsonMissing.of(),
         ) : this(
-            configuration,
-            fileId,
             fileInput,
+            configuration,
             transactionId,
             webhookConfigurationIds,
             webhookConfigurations,
@@ -523,28 +500,20 @@ private constructor(
         )
 
         /**
-         * Configuration for a Verify job.
-         *
-         * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g. if
-         *   the server responded with an unexpected value).
-         */
-        fun configuration(): Optional<Configuration> = configuration.getOptional("configuration")
-
-        /**
-         * Deprecated: use file_input instead
+         * File ID of the document to analyze
          *
-         * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g. if
-         *   the server responded with an unexpected value).
+         * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
          */
-        @Deprecated("deprecated") fun fileId(): Optional<String> = fileId.getOptional("file_id")
+        fun fileInput(): String = fileInput.getRequired("file_input")
 
         /**
-         * File ID of the document to analyze
+         * Configuration for a Verify job.
          *
          * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g. if
          *   the server responded with an unexpected value).
          */
-        fun fileInput(): Optional<String> = fileInput.getOptional("file_input")
+        fun configuration(): Optional<Configuration> = configuration.getOptional("configuration")
 
         /**
          * Idempotency key scoped to the project. Reusing a key returns the original job; the new
@@ -573,6 +542,13 @@ private constructor(
         fun webhookConfigurations(): Optional<List<WebhookConfiguration>> =
             webhookConfigurations.getOptional("webhook_configurations")
 
+        /**
+         * Returns the raw JSON value of [fileInput].
+         *
+         * Unlike [fileInput], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("file_input") @ExcludeMissing fun _fileInput(): JsonField<String> = fileInput
+
         /**
          * Returns the raw JSON value of [configuration].
          *
@@ -583,23 +559,6 @@ private constructor(
         @ExcludeMissing
         fun _configuration(): JsonField<Configuration> = configuration
 
-        /**
-         * Returns the raw JSON value of [fileId].
-         *
-         * Unlike [fileId], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @Deprecated("deprecated")
-        @JsonProperty("file_id")
-        @ExcludeMissing
-        fun _fileId(): JsonField<String> = fileId
-
-        /**
-         * Returns the raw JSON value of [fileInput].
-         *
-         * Unlike [fileInput], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @JsonProperty("file_input") @ExcludeMissing fun _fileInput(): JsonField<String> = fileInput
-
         /**
          * Returns the raw JSON value of [transactionId].
          *
@@ -644,16 +603,22 @@ private constructor(
 
         companion object {
 
-            /** Returns a mutable builder for constructing an instance of [Body]. */
+            /**
+             * Returns a mutable builder for constructing an instance of [Body].
+             *
+             * The following fields are required:
+             * ```java
+             * .fileInput()
+             * ```
+             */
             @JvmStatic fun builder() = Builder()
         }
 
         /** A builder for [Body]. */
         class Builder internal constructor() {
 
+            private var fileInput: JsonField<String>? = null
             private var configuration: JsonField<Configuration> = JsonMissing.of()
-            private var fileId: JsonField<String> = JsonMissing.of()
-            private var fileInput: JsonField<String> = JsonMissing.of()
             private var transactionId: JsonField<String> = JsonMissing.of()
             private var webhookConfigurationIds: JsonField<MutableList<String>>? = null
             private var webhookConfigurations: JsonField<MutableList<WebhookConfiguration>>? = null
@@ -661,15 +626,26 @@ private constructor(
 
             @JvmSynthetic
             internal fun from(body: Body) = apply {
-                configuration = body.configuration
-                fileId = body.fileId
                 fileInput = body.fileInput
+                configuration = body.configuration
                 transactionId = body.transactionId
                 webhookConfigurationIds = body.webhookConfigurationIds.map { it.toMutableList() }
                 webhookConfigurations = body.webhookConfigurations.map { it.toMutableList() }
                 additionalProperties = body.additionalProperties.toMutableMap()
             }
 
+            /** File ID of the document to analyze */
+            fun fileInput(fileInput: String) = fileInput(JsonField.of(fileInput))
+
+            /**
+             * Sets [Builder.fileInput] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.fileInput] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun fileInput(fileInput: JsonField<String>) = apply { this.fileInput = fileInput }
+
             /** Configuration for a Verify job. */
             fun configuration(configuration: Configuration?) =
                 configuration(JsonField.ofNullable(configuration))
@@ -689,39 +665,6 @@ private constructor(
                 this.configuration = configuration
             }
 
-            /** Deprecated: use file_input instead */
-            @Deprecated("deprecated")
-            fun fileId(fileId: String?) = fileId(JsonField.ofNullable(fileId))
-
-            /** Alias for calling [Builder.fileId] with `fileId.orElse(null)`. */
-            @Deprecated("deprecated")
-            fun fileId(fileId: Optional<String>) = fileId(fileId.getOrNull())
-
-            /**
-             * Sets [Builder.fileId] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.fileId] with a well-typed [String] value instead.
-             * This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            @Deprecated("deprecated")
-            fun fileId(fileId: JsonField<String>) = apply { this.fileId = fileId }
-
-            /** File ID of the document to analyze */
-            fun fileInput(fileInput: String?) = fileInput(JsonField.ofNullable(fileInput))
-
-            /** Alias for calling [Builder.fileInput] with `fileInput.orElse(null)`. */
-            fun fileInput(fileInput: Optional<String>) = fileInput(fileInput.getOrNull())
-
-            /**
-             * Sets [Builder.fileInput] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.fileInput] with a well-typed [String] value instead.
-             * This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            fun fileInput(fileInput: JsonField<String>) = apply { this.fileInput = fileInput }
-
             /**
              * Idempotency key scoped to the project. Reusing a key returns the original job; the
              * new request body is ignored.
@@ -837,12 +780,18 @@ private constructor(
              * Returns an immutable instance of [Body].
              *
              * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .fileInput()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
              */
             fun build(): Body =
                 Body(
+                    checkRequired("fileInput", fileInput),
                     configuration,
-                    fileId,
-                    fileInput,
                     transactionId,
                     (webhookConfigurationIds ?: JsonMissing.of()).map { it.toImmutable() },
                     (webhookConfigurations ?: JsonMissing.of()).map { it.toImmutable() },
@@ -866,9 +815,8 @@ private constructor(
                 return@apply
             }
 
-            configuration().ifPresent { it.validate() }
-            fileId()
             fileInput()
+            configuration().ifPresent { it.validate() }
             transactionId()
             webhookConfigurationIds()
             webhookConfigurations().ifPresent { it.forEach { it.validate() } }
@@ -891,9 +839,8 @@ private constructor(
          */
         @JvmSynthetic
         internal fun validity(): Int =
-            (configuration.asKnown().getOrNull()?.validity() ?: 0) +
-                (if (fileId.asKnown().isPresent) 1 else 0) +
-                (if (fileInput.asKnown().isPresent) 1 else 0) +
+            (if (fileInput.asKnown().isPresent) 1 else 0) +
+                (configuration.asKnown().getOrNull()?.validity() ?: 0) +
                 (if (transactionId.asKnown().isPresent) 1 else 0) +
                 (webhookConfigurationIds.asKnown().getOrNull()?.size ?: 0) +
                 (webhookConfigurations.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
@@ -904,9 +851,8 @@ private constructor(
             }
 
             return other is Body &&
-                configuration == other.configuration &&
-                fileId == other.fileId &&
                 fileInput == other.fileInput &&
+                configuration == other.configuration &&
                 transactionId == other.transactionId &&
                 webhookConfigurationIds == other.webhookConfigurationIds &&
                 webhookConfigurations == other.webhookConfigurations &&
@@ -915,9 +861,8 @@ private constructor(
 
         private val hashCode: Int by lazy {
             Objects.hash(
-                configuration,
-                fileId,
                 fileInput,
+                configuration,
                 transactionId,
                 webhookConfigurationIds,
                 webhookConfigurations,
@@ -928,7 +873,7 @@ private constructor(
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "Body{configuration=$configuration, fileId=$fileId, fileInput=$fileInput, transactionId=$transactionId, webhookConfigurationIds=$webhookConfigurationIds, webhookConfigurations=$webhookConfigurations, additionalProperties=$additionalProperties}"
+            "Body{fileInput=$fileInput, configuration=$configuration, transactionId=$transactionId, webhookConfigurationIds=$webhookConfigurationIds, webhookConfigurations=$webhookConfigurations, additionalProperties=$additionalProperties}"
     }
 
     /** Configuration for a Verify job. */
diff --git a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/services/async/alpha/VerifyServiceAsync.kt b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/services/async/alpha/VerifyServiceAsync.kt
index da87a03..1d09722 100644
--- a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/services/async/alpha/VerifyServiceAsync.kt
+++ b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/services/async/alpha/VerifyServiceAsync.kt
@@ -42,23 +42,15 @@ interface VerifyServiceAsync {
      * The job runs asynchronously. Poll `GET /verify/{job_id}` with `expand=result` to check status
      * and retrieve results.
      */
-    fun create(): CompletableFuture<VerifyCreateResponse> = create(VerifyCreateParams.none())
+    fun create(params: VerifyCreateParams): CompletableFuture<VerifyCreateResponse> =
+        create(params, RequestOptions.none())
 
     /** @see create */
     fun create(
-        params: VerifyCreateParams = VerifyCreateParams.none(),
+        params: VerifyCreateParams,
         requestOptions: RequestOptions = RequestOptions.none(),
     ): CompletableFuture<VerifyCreateResponse>
 
-    /** @see create */
-    fun create(
-        params: VerifyCreateParams = VerifyCreateParams.none()
-    ): CompletableFuture<VerifyCreateResponse> = create(params, RequestOptions.none())
-
-    /** @see create */
-    fun create(requestOptions: RequestOptions): CompletableFuture<VerifyCreateResponse> =
-        create(VerifyCreateParams.none(), requestOptions)
-
     /**
      * List Verify jobs with optional filtering and pagination.
      *
@@ -221,26 +213,16 @@ interface VerifyServiceAsync {
          * Returns a raw HTTP response for `post /api/alpha/verify`, but is otherwise the same as
          * [VerifyServiceAsync.create].
          */
-        fun create(): CompletableFuture<HttpResponseFor<VerifyCreateResponse>> =
-            create(VerifyCreateParams.none())
-
-        /** @see create */
-        fun create(
-            params: VerifyCreateParams = VerifyCreateParams.none(),
-            requestOptions: RequestOptions = RequestOptions.none(),
-        ): CompletableFuture<HttpResponseFor<VerifyCreateResponse>>
-
-        /** @see create */
         fun create(
-            params: VerifyCreateParams = VerifyCreateParams.none()
+            params: VerifyCreateParams
         ): CompletableFuture<HttpResponseFor<VerifyCreateResponse>> =
             create(params, RequestOptions.none())
 
         /** @see create */
         fun create(
-            requestOptions: RequestOptions
-        ): CompletableFuture<HttpResponseFor<VerifyCreateResponse>> =
-            create(VerifyCreateParams.none(), requestOptions)
+            params: VerifyCreateParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<VerifyCreateResponse>>
 
         /**
          * Returns a raw HTTP response for `get /api/alpha/verify`, but is otherwise the same as
diff --git a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/services/blocking/alpha/VerifyService.kt b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/services/blocking/alpha/VerifyService.kt
index 31e06d3..be01768 100644
--- a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/services/blocking/alpha/VerifyService.kt
+++ b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/services/blocking/alpha/VerifyService.kt
@@ -42,22 +42,15 @@ interface VerifyService {
      * The job runs asynchronously. Poll `GET /verify/{job_id}` with `expand=result` to check status
      * and retrieve results.
      */
-    fun create(): VerifyCreateResponse = create(VerifyCreateParams.none())
+    fun create(params: VerifyCreateParams): VerifyCreateResponse =
+        create(params, RequestOptions.none())
 
     /** @see create */
     fun create(
-        params: VerifyCreateParams = VerifyCreateParams.none(),
+        params: VerifyCreateParams,
         requestOptions: RequestOptions = RequestOptions.none(),
     ): VerifyCreateResponse
 
-    /** @see create */
-    fun create(params: VerifyCreateParams = VerifyCreateParams.none()): VerifyCreateResponse =
-        create(params, RequestOptions.none())
-
-    /** @see create */
-    fun create(requestOptions: RequestOptions): VerifyCreateResponse =
-        create(VerifyCreateParams.none(), requestOptions)
-
     /**
      * List Verify jobs with optional filtering and pagination.
      *
@@ -202,26 +195,16 @@ interface VerifyService {
          * [VerifyService.create].
          */
         @MustBeClosed
-        fun create(): HttpResponseFor<VerifyCreateResponse> = create(VerifyCreateParams.none())
+        fun create(params: VerifyCreateParams): HttpResponseFor<VerifyCreateResponse> =
+            create(params, RequestOptions.none())
 
         /** @see create */
         @MustBeClosed
         fun create(
-            params: VerifyCreateParams = VerifyCreateParams.none(),
+            params: VerifyCreateParams,
             requestOptions: RequestOptions = RequestOptions.none(),
         ): HttpResponseFor<VerifyCreateResponse>
 
-        /** @see create */
-        @MustBeClosed
-        fun create(
-            params: VerifyCreateParams = VerifyCreateParams.none()
-        ): HttpResponseFor<VerifyCreateResponse> = create(params, RequestOptions.none())
-
-        /** @see create */
-        @MustBeClosed
-        fun create(requestOptions: RequestOptions): HttpResponseFor<VerifyCreateResponse> =
-            create(VerifyCreateParams.none(), requestOptions)
-
         /**
          * Returns a raw HTTP response for `get /api/alpha/verify`, but is otherwise the same as
          * [VerifyService.list].
diff --git a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/alpha/verify/VerifyCreateParamsTest.kt b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/alpha/verify/VerifyCreateParamsTest.kt
index 367a449..00030db 100644
--- a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/alpha/verify/VerifyCreateParamsTest.kt
+++ b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/alpha/verify/VerifyCreateParamsTest.kt
@@ -15,14 +15,13 @@ internal class VerifyCreateParamsTest {
         VerifyCreateParams.builder()
             .organizationId("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
             .projectId("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
+            .fileInput("dfl-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee")
             .configuration(
                 VerifyCreateParams.Configuration.builder()
                     .targetPages("1,3,5-7")
                     .tier(VerifyCreateParams.Configuration.Tier.AGENTIC)
                     .build()
             )
-            .fileId("dfl-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee")
-            .fileInput("dfl-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee")
             .transactionId("tx-unique-idempotency-key")
             .addWebhookConfigurationId("whc-...")
             .addWebhookConfigurationId("whc-...")
@@ -53,14 +52,13 @@ internal class VerifyCreateParamsTest {
             VerifyCreateParams.builder()
                 .organizationId("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
                 .projectId("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
+                .fileInput("dfl-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee")
                 .configuration(
                     VerifyCreateParams.Configuration.builder()
                         .targetPages("1,3,5-7")
                         .tier(VerifyCreateParams.Configuration.Tier.AGENTIC)
                         .build()
                 )
-                .fileId("dfl-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee")
-                .fileInput("dfl-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee")
                 .transactionId("tx-unique-idempotency-key")
                 .addWebhookConfigurationId("whc-...")
                 .addWebhookConfigurationId("whc-...")
@@ -100,7 +98,10 @@ internal class VerifyCreateParamsTest {
 
     @Test
     fun queryParamsWithoutOptionalFields() {
-        val params = VerifyCreateParams.builder().build()
+        val params =
+            VerifyCreateParams.builder()
+                .fileInput("dfl-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee")
+                .build()
 
         val queryParams = params._queryParams()
 
@@ -113,14 +114,13 @@ internal class VerifyCreateParamsTest {
             VerifyCreateParams.builder()
                 .organizationId("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
                 .projectId("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
+                .fileInput("dfl-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee")
                 .configuration(
                     VerifyCreateParams.Configuration.builder()
                         .targetPages("1,3,5-7")
                         .tier(VerifyCreateParams.Configuration.Tier.AGENTIC)
                         .build()
                 )
-                .fileId("dfl-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee")
-                .fileInput("dfl-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee")
                 .transactionId("tx-unique-idempotency-key")
                 .addWebhookConfigurationId("whc-...")
                 .addWebhookConfigurationId("whc-...")
@@ -149,6 +149,7 @@ internal class VerifyCreateParamsTest {
 
         val body = params._body()
 
+        assertThat(body.fileInput()).isEqualTo("dfl-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee")
         assertThat(body.configuration())
             .contains(
                 VerifyCreateParams.Configuration.builder()
@@ -156,8 +157,6 @@ internal class VerifyCreateParamsTest {
                     .tier(VerifyCreateParams.Configuration.Tier.AGENTIC)
                     .build()
             )
-        assertThat(body.fileId()).contains("dfl-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee")
-        assertThat(body.fileInput()).contains("dfl-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee")
         assertThat(body.transactionId()).contains("tx-unique-idempotency-key")
         assertThat(body.webhookConfigurationIds().getOrNull()).containsExactly("whc-...", "whc-...")
         assertThat(body.webhookConfigurations().getOrNull())
@@ -183,8 +182,13 @@ internal class VerifyCreateParamsTest {
 
     @Test
     fun bodyWithoutOptionalFields() {
-        val params = VerifyCreateParams.builder().build()
+        val params =
+            VerifyCreateParams.builder()
+                .fileInput("dfl-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee")
+                .build()
 
         val body = params._body()
+
+        assertThat(body.fileInput()).isEqualTo("dfl-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee")
     }
 }
diff --git a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/services/async/alpha/VerifyServiceAsyncTest.kt b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/services/async/alpha/VerifyServiceAsyncTest.kt
index aa4cdf9..b6be727 100644
--- a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/services/async/alpha/VerifyServiceAsyncTest.kt
+++ b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/services/async/alpha/VerifyServiceAsyncTest.kt
@@ -24,14 +24,13 @@ internal class VerifyServiceAsyncTest {
                 VerifyCreateParams.builder()
                     .organizationId("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
                     .projectId("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
+                    .fileInput("dfl-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee")
                     .configuration(
                         VerifyCreateParams.Configuration.builder()
                             .targetPages("1,3,5-7")
                             .tier(VerifyCreateParams.Configuration.Tier.AGENTIC)
                             .build()
                     )
-                    .fileId("dfl-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee")
-                    .fileInput("dfl-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee")
                     .transactionId("tx-unique-idempotency-key")
                     .addWebhookConfigurationId("whc-...")
                     .addWebhookConfigurationId("whc-...")
diff --git a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/services/blocking/alpha/VerifyServiceTest.kt b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/services/blocking/alpha/VerifyServiceTest.kt
index ead954c..5fcb47b 100644
--- a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/services/blocking/alpha/VerifyServiceTest.kt
+++ b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/services/blocking/alpha/VerifyServiceTest.kt
@@ -24,14 +24,13 @@ internal class VerifyServiceTest {
                 VerifyCreateParams.builder()
                     .organizationId("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
                     .projectId("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
+                    .fileInput("dfl-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee")
                     .configuration(
                         VerifyCreateParams.Configuration.builder()
                             .targetPages("1,3,5-7")
                             .tier(VerifyCreateParams.Configuration.Tier.AGENTIC)
                             .build()
                     )
-                    .fileId("dfl-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee")
-                    .fileInput("dfl-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee")
                     .transactionId("tx-unique-idempotency-key")
                     .addWebhookConfigurationId("whc-...")
                     .addWebhookConfigurationId("whc-...")

From e71421a3e146595fa30435939b5b63980bba3fcf Mon Sep 17 00:00:00 2001
From: stlc-bot <stlc-bot@users.noreply.github.com>
Date: Thu, 15 Oct 2026 17:10:55 +0000
Subject: [PATCH 09/11] fix(split): refuse to delete a non-terminal job
 (#29785)

Stainless-Generated-From: 33b8b19989ef0dba19fb979fab486acbbc4aabc6
---
 .../llamaindex/llamacloud/models/split/SplitDeleteParams.kt  | 5 ++++-
 .../llamacloud/services/async/SplitServiceAsync.kt           | 5 ++++-
 .../llamaindex/llamacloud/services/blocking/SplitService.kt  | 5 ++++-
 3 files changed, 12 insertions(+), 3 deletions(-)

diff --git a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/split/SplitDeleteParams.kt b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/split/SplitDeleteParams.kt
index fee2306..4216dfe 100644
--- a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/split/SplitDeleteParams.kt
+++ b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/split/SplitDeleteParams.kt
@@ -11,7 +11,10 @@ import java.util.Objects
 import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
-/** Delete a split job and its results. */
+/**
+ * Delete a split job and its results. A job that is not in a terminal state is refused with 409;
+ * cancel it first.
+ */
 class SplitDeleteParams
 private constructor(
     private val splitJobId: String?,
diff --git a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/services/async/SplitServiceAsync.kt b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/services/async/SplitServiceAsync.kt
index f90da1a..81f4956 100644
--- a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/services/async/SplitServiceAsync.kt
+++ b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/services/async/SplitServiceAsync.kt
@@ -84,7 +84,10 @@ interface SplitServiceAsync {
     fun list(requestOptions: RequestOptions): CompletableFuture<SplitListPageAsync> =
         list(SplitListParams.none(), requestOptions)
 
-    /** Delete a split job and its results. */
+    /**
+     * Delete a split job and its results. A job that is not in a terminal state is refused with
+     * 409; cancel it first.
+     */
     fun delete(splitJobId: String): CompletableFuture<SplitDeleteResponse> =
         delete(splitJobId, SplitDeleteParams.none())
 
diff --git a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/services/blocking/SplitService.kt b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/services/blocking/SplitService.kt
index 5e7b123..a88bd9e 100644
--- a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/services/blocking/SplitService.kt
+++ b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/services/blocking/SplitService.kt
@@ -83,7 +83,10 @@ interface SplitService {
     fun list(requestOptions: RequestOptions): SplitListPage =
         list(SplitListParams.none(), requestOptions)
 
-    /** Delete a split job and its results. */
+    /**
+     * Delete a split job and its results. A job that is not in a terminal state is refused with
+     * 409; cancel it first.
+     */
     fun delete(splitJobId: String): SplitDeleteResponse =
         delete(splitJobId, SplitDeleteParams.none())
 

From de8ae51b91342bacbf52e2113431ed8f0f43c1b4 Mon Sep 17 00:00:00 2001
From: stlc-bot <stlc-bot@users.noreply.github.com>
Date: Fri, 16 Oct 2026 04:21:43 +0000
Subject: [PATCH 10/11] Fix EU Parse model availability and watermark tagging
 (#30058)

Stainless-Generated-From: 5441930b0a18bf0bb306db44ccc7c962029965d2
---
 .../configurations/ParseV2Parameters.kt       | 32 ++++++++---------
 .../models/parsing/ParsingCreateParams.kt     | 36 +++++++++----------
 .../parsing/ParsingListVersionsResponse.kt    |  6 ++++
 .../ParsingListVersionsResponseTest.kt        |  6 ++--
 4 files changed, 43 insertions(+), 37 deletions(-)

diff --git a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/configurations/ParseV2Parameters.kt b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/configurations/ParseV2Parameters.kt
index 1937eb5..85eb61d 100644
--- a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/configurations/ParseV2Parameters.kt
+++ b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/configurations/ParseV2Parameters.kt
@@ -143,7 +143,7 @@ private constructor(
      * Current `latest` by tier:
      * - `fast`: `2026-06-15`
      * - `cost_effective`: `2026-09-28`
-     * - `agentic`: `2026-09-29`
+     * - `agentic`: `2026-10-15`
      * - `agentic_plus`: `2026-09-28`
      *
      * Full list: `GET /api/v2/parse/versions`.
@@ -481,7 +481,7 @@ private constructor(
          * Current `latest` by tier:
          * - `fast`: `2026-06-15`
          * - `cost_effective`: `2026-09-28`
-         * - `agentic`: `2026-09-29`
+         * - `agentic`: `2026-10-15`
          * - `agentic_plus`: `2026-09-28`
          *
          * Full list: `GET /api/v2/parse/versions`.
@@ -1012,7 +1012,7 @@ private constructor(
      * Current `latest` by tier:
      * - `fast`: `2026-06-15`
      * - `cost_effective`: `2026-09-28`
-     * - `agentic`: `2026-09-29`
+     * - `agentic`: `2026-10-15`
      * - `agentic_plus`: `2026-09-28`
      *
      * Full list: `GET /api/v2/parse/versions`.
@@ -1033,7 +1033,7 @@ private constructor(
 
             @JvmField val LATEST = of("latest")
 
-            @JvmField val _2026_09_29 = of("2026-09-29")
+            @JvmField val _2026_10_15 = of("2026-10-15")
 
             @JvmField val _2026_09_28 = of("2026-09-28")
 
@@ -1045,7 +1045,7 @@ private constructor(
         /** An enum containing [Version]'s known values. */
         enum class Known {
             LATEST,
-            _2026_09_29,
+            _2026_10_15,
             _2026_09_28,
             _2026_06_15,
         }
@@ -1061,7 +1061,7 @@ private constructor(
          */
         enum class Value {
             LATEST,
-            _2026_09_29,
+            _2026_10_15,
             _2026_09_28,
             _2026_06_15,
             /** An enum member indicating that [Version] was instantiated with an unknown value. */
@@ -1078,7 +1078,7 @@ private constructor(
         fun value(): Value =
             when (this) {
                 LATEST -> Value.LATEST
-                _2026_09_29 -> Value._2026_09_29
+                _2026_10_15 -> Value._2026_10_15
                 _2026_09_28 -> Value._2026_09_28
                 _2026_06_15 -> Value._2026_06_15
                 else -> Value._UNKNOWN
@@ -1096,7 +1096,7 @@ private constructor(
         fun known(): Known =
             when (this) {
                 LATEST -> Known.LATEST
-                _2026_09_29 -> Known._2026_09_29
+                _2026_10_15 -> Known._2026_10_15
                 _2026_09_28 -> Known._2026_09_28
                 _2026_06_15 -> Known._2026_06_15
                 else -> throw LlamaCloudInvalidDataException("Unknown Version: $value")
@@ -10041,7 +10041,7 @@ private constructor(
                  * Current `latest` by tier:
                  * - `fast`: `2026-06-15`
                  * - `cost_effective`: `2026-09-28`
-                 * - `agentic`: `2026-09-29`
+                 * - `agentic`: `2026-10-15`
                  * - `agentic_plus`: `2026-09-28`
                  *
                  * Full list: `GET /api/v2/parse/versions`.
@@ -10545,7 +10545,7 @@ private constructor(
                      * Current `latest` by tier:
                      * - `fast`: `2026-06-15`
                      * - `cost_effective`: `2026-09-28`
-                     * - `agentic`: `2026-09-29`
+                     * - `agentic`: `2026-10-15`
                      * - `agentic_plus`: `2026-09-28`
                      *
                      * Full list: `GET /api/v2/parse/versions`.
@@ -12159,7 +12159,7 @@ private constructor(
                  * Current `latest` by tier:
                  * - `fast`: `2026-06-15`
                  * - `cost_effective`: `2026-09-28`
-                 * - `agentic`: `2026-09-29`
+                 * - `agentic`: `2026-10-15`
                  * - `agentic_plus`: `2026-09-28`
                  *
                  * Full list: `GET /api/v2/parse/versions`.
@@ -12183,7 +12183,7 @@ private constructor(
 
                         @JvmField val LATEST = of("latest")
 
-                        @JvmField val _2026_09_29 = of("2026-09-29")
+                        @JvmField val _2026_10_15 = of("2026-10-15")
 
                         @JvmField val _2026_09_28 = of("2026-09-28")
 
@@ -12195,7 +12195,7 @@ private constructor(
                     /** An enum containing [Version]'s known values. */
                     enum class Known {
                         LATEST,
-                        _2026_09_29,
+                        _2026_10_15,
                         _2026_09_28,
                         _2026_06_15,
                     }
@@ -12211,7 +12211,7 @@ private constructor(
                      */
                     enum class Value {
                         LATEST,
-                        _2026_09_29,
+                        _2026_10_15,
                         _2026_09_28,
                         _2026_06_15,
                         /**
@@ -12231,7 +12231,7 @@ private constructor(
                     fun value(): Value =
                         when (this) {
                             LATEST -> Value.LATEST
-                            _2026_09_29 -> Value._2026_09_29
+                            _2026_10_15 -> Value._2026_10_15
                             _2026_09_28 -> Value._2026_09_28
                             _2026_06_15 -> Value._2026_06_15
                             else -> Value._UNKNOWN
@@ -12249,7 +12249,7 @@ private constructor(
                     fun known(): Known =
                         when (this) {
                             LATEST -> Known.LATEST
-                            _2026_09_29 -> Known._2026_09_29
+                            _2026_10_15 -> Known._2026_10_15
                             _2026_09_28 -> Known._2026_09_28
                             _2026_06_15 -> Known._2026_06_15
                             else -> throw LlamaCloudInvalidDataException("Unknown Version: $value")
diff --git a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/ParsingCreateParams.kt b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/ParsingCreateParams.kt
index 3ec8a19..ae7e835 100644
--- a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/ParsingCreateParams.kt
+++ b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/ParsingCreateParams.kt
@@ -77,7 +77,7 @@ private constructor(
      * Current `latest` by tier:
      * - `fast`: `2026-06-15`
      * - `cost_effective`: `2026-09-28`
-     * - `agentic`: `2026-09-29`
+     * - `agentic`: `2026-10-15`
      * - `agentic_plus`: `2026-09-28`
      *
      * Full list: `GET /api/v2/parse/versions`.
@@ -465,7 +465,7 @@ private constructor(
          * Current `latest` by tier:
          * - `fast`: `2026-06-15`
          * - `cost_effective`: `2026-09-28`
-         * - `agentic`: `2026-09-29`
+         * - `agentic`: `2026-10-15`
          * - `agentic_plus`: `2026-09-28`
          *
          * Full list: `GET /api/v2/parse/versions`.
@@ -1082,7 +1082,7 @@ private constructor(
          * Current `latest` by tier:
          * - `fast`: `2026-06-15`
          * - `cost_effective`: `2026-09-28`
-         * - `agentic`: `2026-09-29`
+         * - `agentic`: `2026-10-15`
          * - `agentic_plus`: `2026-09-28`
          *
          * Full list: `GET /api/v2/parse/versions`.
@@ -1516,7 +1516,7 @@ private constructor(
              * Current `latest` by tier:
              * - `fast`: `2026-06-15`
              * - `cost_effective`: `2026-09-28`
-             * - `agentic`: `2026-09-29`
+             * - `agentic`: `2026-10-15`
              * - `agentic_plus`: `2026-09-28`
              *
              * Full list: `GET /api/v2/parse/versions`.
@@ -2217,7 +2217,7 @@ private constructor(
      * Current `latest` by tier:
      * - `fast`: `2026-06-15`
      * - `cost_effective`: `2026-09-28`
-     * - `agentic`: `2026-09-29`
+     * - `agentic`: `2026-10-15`
      * - `agentic_plus`: `2026-09-28`
      *
      * Full list: `GET /api/v2/parse/versions`.
@@ -2238,7 +2238,7 @@ private constructor(
 
             @JvmField val LATEST = of("latest")
 
-            @JvmField val _2026_09_29 = of("2026-09-29")
+            @JvmField val _2026_10_15 = of("2026-10-15")
 
             @JvmField val _2026_09_28 = of("2026-09-28")
 
@@ -2250,7 +2250,7 @@ private constructor(
         /** An enum containing [Version]'s known values. */
         enum class Known {
             LATEST,
-            _2026_09_29,
+            _2026_10_15,
             _2026_09_28,
             _2026_06_15,
         }
@@ -2266,7 +2266,7 @@ private constructor(
          */
         enum class Value {
             LATEST,
-            _2026_09_29,
+            _2026_10_15,
             _2026_09_28,
             _2026_06_15,
             /** An enum member indicating that [Version] was instantiated with an unknown value. */
@@ -2283,7 +2283,7 @@ private constructor(
         fun value(): Value =
             when (this) {
                 LATEST -> Value.LATEST
-                _2026_09_29 -> Value._2026_09_29
+                _2026_10_15 -> Value._2026_10_15
                 _2026_09_28 -> Value._2026_09_28
                 _2026_06_15 -> Value._2026_06_15
                 else -> Value._UNKNOWN
@@ -2301,7 +2301,7 @@ private constructor(
         fun known(): Known =
             when (this) {
                 LATEST -> Known.LATEST
-                _2026_09_29 -> Known._2026_09_29
+                _2026_10_15 -> Known._2026_10_15
                 _2026_09_28 -> Known._2026_09_28
                 _2026_06_15 -> Known._2026_06_15
                 else -> throw LlamaCloudInvalidDataException("Unknown Version: $value")
@@ -11246,7 +11246,7 @@ private constructor(
                  * Current `latest` by tier:
                  * - `fast`: `2026-06-15`
                  * - `cost_effective`: `2026-09-28`
-                 * - `agentic`: `2026-09-29`
+                 * - `agentic`: `2026-10-15`
                  * - `agentic_plus`: `2026-09-28`
                  *
                  * Full list: `GET /api/v2/parse/versions`.
@@ -11750,7 +11750,7 @@ private constructor(
                      * Current `latest` by tier:
                      * - `fast`: `2026-06-15`
                      * - `cost_effective`: `2026-09-28`
-                     * - `agentic`: `2026-09-29`
+                     * - `agentic`: `2026-10-15`
                      * - `agentic_plus`: `2026-09-28`
                      *
                      * Full list: `GET /api/v2/parse/versions`.
@@ -13364,7 +13364,7 @@ private constructor(
                  * Current `latest` by tier:
                  * - `fast`: `2026-06-15`
                  * - `cost_effective`: `2026-09-28`
-                 * - `agentic`: `2026-09-29`
+                 * - `agentic`: `2026-10-15`
                  * - `agentic_plus`: `2026-09-28`
                  *
                  * Full list: `GET /api/v2/parse/versions`.
@@ -13388,7 +13388,7 @@ private constructor(
 
                         @JvmField val LATEST = of("latest")
 
-                        @JvmField val _2026_09_29 = of("2026-09-29")
+                        @JvmField val _2026_10_15 = of("2026-10-15")
 
                         @JvmField val _2026_09_28 = of("2026-09-28")
 
@@ -13400,7 +13400,7 @@ private constructor(
                     /** An enum containing [Version]'s known values. */
                     enum class Known {
                         LATEST,
-                        _2026_09_29,
+                        _2026_10_15,
                         _2026_09_28,
                         _2026_06_15,
                     }
@@ -13416,7 +13416,7 @@ private constructor(
                      */
                     enum class Value {
                         LATEST,
-                        _2026_09_29,
+                        _2026_10_15,
                         _2026_09_28,
                         _2026_06_15,
                         /**
@@ -13436,7 +13436,7 @@ private constructor(
                     fun value(): Value =
                         when (this) {
                             LATEST -> Value.LATEST
-                            _2026_09_29 -> Value._2026_09_29
+                            _2026_10_15 -> Value._2026_10_15
                             _2026_09_28 -> Value._2026_09_28
                             _2026_06_15 -> Value._2026_06_15
                             else -> Value._UNKNOWN
@@ -13454,7 +13454,7 @@ private constructor(
                     fun known(): Known =
                         when (this) {
                             LATEST -> Known.LATEST
-                            _2026_09_29 -> Known._2026_09_29
+                            _2026_10_15 -> Known._2026_10_15
                             _2026_09_28 -> Known._2026_09_28
                             _2026_06_15 -> Known._2026_06_15
                             else -> throw LlamaCloudInvalidDataException("Unknown Version: $value")
diff --git a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/ParsingListVersionsResponse.kt b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/ParsingListVersionsResponse.kt
index b1e601d..e0724de 100644
--- a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/ParsingListVersionsResponse.kt
+++ b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/ParsingListVersionsResponse.kt
@@ -393,6 +393,8 @@ private constructor(
 
         companion object {
 
+            @JvmField val _2026_10_15 = of("2026-10-15")
+
             @JvmField val _2026_09_29 = of("2026-09-29")
 
             @JvmField val _2026_09_28 = of("2026-09-28")
@@ -496,6 +498,7 @@ private constructor(
 
         /** An enum containing [Agentic]'s known values. */
         enum class Known {
+            _2026_10_15,
             _2026_09_29,
             _2026_09_28,
             _2026_09_24,
@@ -557,6 +560,7 @@ private constructor(
          * - It was constructed with an arbitrary value using the [of] method.
          */
         enum class Value {
+            _2026_10_15,
             _2026_09_29,
             _2026_09_28,
             _2026_09_24,
@@ -619,6 +623,7 @@ private constructor(
          */
         fun value(): Value =
             when (this) {
+                _2026_10_15 -> Value._2026_10_15
                 _2026_09_29 -> Value._2026_09_29
                 _2026_09_28 -> Value._2026_09_28
                 _2026_09_24 -> Value._2026_09_24
@@ -682,6 +687,7 @@ private constructor(
          */
         fun known(): Known =
             when (this) {
+                _2026_10_15 -> Known._2026_10_15
                 _2026_09_29 -> Known._2026_09_29
                 _2026_09_28 -> Known._2026_09_28
                 _2026_09_24 -> Known._2026_09_24
diff --git a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/parsing/ParsingListVersionsResponseTest.kt b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/parsing/ParsingListVersionsResponseTest.kt
index 86fcbbf..b782a22 100644
--- a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/parsing/ParsingListVersionsResponseTest.kt
+++ b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/parsing/ParsingListVersionsResponseTest.kt
@@ -13,7 +13,7 @@ internal class ParsingListVersionsResponseTest {
     fun create() {
         val parsingListVersionsResponse =
             ParsingListVersionsResponse.builder()
-                .addAgentic(ParsingListVersionsResponse.Agentic._2026_09_29)
+                .addAgentic(ParsingListVersionsResponse.Agentic._2026_10_15)
                 .addAgenticPlus(ParsingListVersionsResponse.AgenticPlus._2026_09_28)
                 .addCostEffective(ParsingListVersionsResponse.CostEffective._2026_09_28)
                 .addFast(ParsingListVersionsResponse.Fast._2026_06_15)
@@ -28,7 +28,7 @@ internal class ParsingListVersionsResponseTest {
                 .build()
 
         assertThat(parsingListVersionsResponse.agentic())
-            .containsExactly(ParsingListVersionsResponse.Agentic._2026_09_29)
+            .containsExactly(ParsingListVersionsResponse.Agentic._2026_10_15)
         assertThat(parsingListVersionsResponse.agenticPlus())
             .containsExactly(ParsingListVersionsResponse.AgenticPlus._2026_09_28)
         assertThat(parsingListVersionsResponse.costEffective())
@@ -51,7 +51,7 @@ internal class ParsingListVersionsResponseTest {
         val jsonMapper = jsonMapper()
         val parsingListVersionsResponse =
             ParsingListVersionsResponse.builder()
-                .addAgentic(ParsingListVersionsResponse.Agentic._2026_09_29)
+                .addAgentic(ParsingListVersionsResponse.Agentic._2026_10_15)
                 .addAgenticPlus(ParsingListVersionsResponse.AgenticPlus._2026_09_28)
                 .addCostEffective(ParsingListVersionsResponse.CostEffective._2026_09_28)
                 .addFast(ParsingListVersionsResponse.Fast._2026_06_15)

From 972d540aaca9f36afc8476eb367320a0555a528a Mon Sep 17 00:00:00 2001
From: stlc-bot <stlc-bot@users.noreply.github.com>
Date: Fri, 16 Oct 2026 18:53:26 +0000
Subject: [PATCH 11/11] fix(parse): apply watermark and wrapped-word rules to
 Lite fallbacks (#30128)

Stainless-Generated-From: 3dfd6d7727199127579b7c8d14901999ec970b9b
---
 .../configurations/ParseV2Parameters.kt       | 32 ++++++++---------
 .../models/parsing/ParsingCreateParams.kt     | 36 +++++++++----------
 .../parsing/ParsingListVersionsResponse.kt    |  6 ++++
 .../ParsingListVersionsResponseTest.kt        |  6 ++--
 4 files changed, 43 insertions(+), 37 deletions(-)

diff --git a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/configurations/ParseV2Parameters.kt b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/configurations/ParseV2Parameters.kt
index 85eb61d..4e59717 100644
--- a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/configurations/ParseV2Parameters.kt
+++ b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/configurations/ParseV2Parameters.kt
@@ -143,7 +143,7 @@ private constructor(
      * Current `latest` by tier:
      * - `fast`: `2026-06-15`
      * - `cost_effective`: `2026-09-28`
-     * - `agentic`: `2026-10-15`
+     * - `agentic`: `2026-10-16`
      * - `agentic_plus`: `2026-09-28`
      *
      * Full list: `GET /api/v2/parse/versions`.
@@ -481,7 +481,7 @@ private constructor(
          * Current `latest` by tier:
          * - `fast`: `2026-06-15`
          * - `cost_effective`: `2026-09-28`
-         * - `agentic`: `2026-10-15`
+         * - `agentic`: `2026-10-16`
          * - `agentic_plus`: `2026-09-28`
          *
          * Full list: `GET /api/v2/parse/versions`.
@@ -1012,7 +1012,7 @@ private constructor(
      * Current `latest` by tier:
      * - `fast`: `2026-06-15`
      * - `cost_effective`: `2026-09-28`
-     * - `agentic`: `2026-10-15`
+     * - `agentic`: `2026-10-16`
      * - `agentic_plus`: `2026-09-28`
      *
      * Full list: `GET /api/v2/parse/versions`.
@@ -1033,7 +1033,7 @@ private constructor(
 
             @JvmField val LATEST = of("latest")
 
-            @JvmField val _2026_10_15 = of("2026-10-15")
+            @JvmField val _2026_10_16 = of("2026-10-16")
 
             @JvmField val _2026_09_28 = of("2026-09-28")
 
@@ -1045,7 +1045,7 @@ private constructor(
         /** An enum containing [Version]'s known values. */
         enum class Known {
             LATEST,
-            _2026_10_15,
+            _2026_10_16,
             _2026_09_28,
             _2026_06_15,
         }
@@ -1061,7 +1061,7 @@ private constructor(
          */
         enum class Value {
             LATEST,
-            _2026_10_15,
+            _2026_10_16,
             _2026_09_28,
             _2026_06_15,
             /** An enum member indicating that [Version] was instantiated with an unknown value. */
@@ -1078,7 +1078,7 @@ private constructor(
         fun value(): Value =
             when (this) {
                 LATEST -> Value.LATEST
-                _2026_10_15 -> Value._2026_10_15
+                _2026_10_16 -> Value._2026_10_16
                 _2026_09_28 -> Value._2026_09_28
                 _2026_06_15 -> Value._2026_06_15
                 else -> Value._UNKNOWN
@@ -1096,7 +1096,7 @@ private constructor(
         fun known(): Known =
             when (this) {
                 LATEST -> Known.LATEST
-                _2026_10_15 -> Known._2026_10_15
+                _2026_10_16 -> Known._2026_10_16
                 _2026_09_28 -> Known._2026_09_28
                 _2026_06_15 -> Known._2026_06_15
                 else -> throw LlamaCloudInvalidDataException("Unknown Version: $value")
@@ -10041,7 +10041,7 @@ private constructor(
                  * Current `latest` by tier:
                  * - `fast`: `2026-06-15`
                  * - `cost_effective`: `2026-09-28`
-                 * - `agentic`: `2026-10-15`
+                 * - `agentic`: `2026-10-16`
                  * - `agentic_plus`: `2026-09-28`
                  *
                  * Full list: `GET /api/v2/parse/versions`.
@@ -10545,7 +10545,7 @@ private constructor(
                      * Current `latest` by tier:
                      * - `fast`: `2026-06-15`
                      * - `cost_effective`: `2026-09-28`
-                     * - `agentic`: `2026-10-15`
+                     * - `agentic`: `2026-10-16`
                      * - `agentic_plus`: `2026-09-28`
                      *
                      * Full list: `GET /api/v2/parse/versions`.
@@ -12159,7 +12159,7 @@ private constructor(
                  * Current `latest` by tier:
                  * - `fast`: `2026-06-15`
                  * - `cost_effective`: `2026-09-28`
-                 * - `agentic`: `2026-10-15`
+                 * - `agentic`: `2026-10-16`
                  * - `agentic_plus`: `2026-09-28`
                  *
                  * Full list: `GET /api/v2/parse/versions`.
@@ -12183,7 +12183,7 @@ private constructor(
 
                         @JvmField val LATEST = of("latest")
 
-                        @JvmField val _2026_10_15 = of("2026-10-15")
+                        @JvmField val _2026_10_16 = of("2026-10-16")
 
                         @JvmField val _2026_09_28 = of("2026-09-28")
 
@@ -12195,7 +12195,7 @@ private constructor(
                     /** An enum containing [Version]'s known values. */
                     enum class Known {
                         LATEST,
-                        _2026_10_15,
+                        _2026_10_16,
                         _2026_09_28,
                         _2026_06_15,
                     }
@@ -12211,7 +12211,7 @@ private constructor(
                      */
                     enum class Value {
                         LATEST,
-                        _2026_10_15,
+                        _2026_10_16,
                         _2026_09_28,
                         _2026_06_15,
                         /**
@@ -12231,7 +12231,7 @@ private constructor(
                     fun value(): Value =
                         when (this) {
                             LATEST -> Value.LATEST
-                            _2026_10_15 -> Value._2026_10_15
+                            _2026_10_16 -> Value._2026_10_16
                             _2026_09_28 -> Value._2026_09_28
                             _2026_06_15 -> Value._2026_06_15
                             else -> Value._UNKNOWN
@@ -12249,7 +12249,7 @@ private constructor(
                     fun known(): Known =
                         when (this) {
                             LATEST -> Known.LATEST
-                            _2026_10_15 -> Known._2026_10_15
+                            _2026_10_16 -> Known._2026_10_16
                             _2026_09_28 -> Known._2026_09_28
                             _2026_06_15 -> Known._2026_06_15
                             else -> throw LlamaCloudInvalidDataException("Unknown Version: $value")
diff --git a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/ParsingCreateParams.kt b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/ParsingCreateParams.kt
index ae7e835..4687055 100644
--- a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/ParsingCreateParams.kt
+++ b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/ParsingCreateParams.kt
@@ -77,7 +77,7 @@ private constructor(
      * Current `latest` by tier:
      * - `fast`: `2026-06-15`
      * - `cost_effective`: `2026-09-28`
-     * - `agentic`: `2026-10-15`
+     * - `agentic`: `2026-10-16`
      * - `agentic_plus`: `2026-09-28`
      *
      * Full list: `GET /api/v2/parse/versions`.
@@ -465,7 +465,7 @@ private constructor(
          * Current `latest` by tier:
          * - `fast`: `2026-06-15`
          * - `cost_effective`: `2026-09-28`
-         * - `agentic`: `2026-10-15`
+         * - `agentic`: `2026-10-16`
          * - `agentic_plus`: `2026-09-28`
          *
          * Full list: `GET /api/v2/parse/versions`.
@@ -1082,7 +1082,7 @@ private constructor(
          * Current `latest` by tier:
          * - `fast`: `2026-06-15`
          * - `cost_effective`: `2026-09-28`
-         * - `agentic`: `2026-10-15`
+         * - `agentic`: `2026-10-16`
          * - `agentic_plus`: `2026-09-28`
          *
          * Full list: `GET /api/v2/parse/versions`.
@@ -1516,7 +1516,7 @@ private constructor(
              * Current `latest` by tier:
              * - `fast`: `2026-06-15`
              * - `cost_effective`: `2026-09-28`
-             * - `agentic`: `2026-10-15`
+             * - `agentic`: `2026-10-16`
              * - `agentic_plus`: `2026-09-28`
              *
              * Full list: `GET /api/v2/parse/versions`.
@@ -2217,7 +2217,7 @@ private constructor(
      * Current `latest` by tier:
      * - `fast`: `2026-06-15`
      * - `cost_effective`: `2026-09-28`
-     * - `agentic`: `2026-10-15`
+     * - `agentic`: `2026-10-16`
      * - `agentic_plus`: `2026-09-28`
      *
      * Full list: `GET /api/v2/parse/versions`.
@@ -2238,7 +2238,7 @@ private constructor(
 
             @JvmField val LATEST = of("latest")
 
-            @JvmField val _2026_10_15 = of("2026-10-15")
+            @JvmField val _2026_10_16 = of("2026-10-16")
 
             @JvmField val _2026_09_28 = of("2026-09-28")
 
@@ -2250,7 +2250,7 @@ private constructor(
         /** An enum containing [Version]'s known values. */
         enum class Known {
             LATEST,
-            _2026_10_15,
+            _2026_10_16,
             _2026_09_28,
             _2026_06_15,
         }
@@ -2266,7 +2266,7 @@ private constructor(
          */
         enum class Value {
             LATEST,
-            _2026_10_15,
+            _2026_10_16,
             _2026_09_28,
             _2026_06_15,
             /** An enum member indicating that [Version] was instantiated with an unknown value. */
@@ -2283,7 +2283,7 @@ private constructor(
         fun value(): Value =
             when (this) {
                 LATEST -> Value.LATEST
-                _2026_10_15 -> Value._2026_10_15
+                _2026_10_16 -> Value._2026_10_16
                 _2026_09_28 -> Value._2026_09_28
                 _2026_06_15 -> Value._2026_06_15
                 else -> Value._UNKNOWN
@@ -2301,7 +2301,7 @@ private constructor(
         fun known(): Known =
             when (this) {
                 LATEST -> Known.LATEST
-                _2026_10_15 -> Known._2026_10_15
+                _2026_10_16 -> Known._2026_10_16
                 _2026_09_28 -> Known._2026_09_28
                 _2026_06_15 -> Known._2026_06_15
                 else -> throw LlamaCloudInvalidDataException("Unknown Version: $value")
@@ -11246,7 +11246,7 @@ private constructor(
                  * Current `latest` by tier:
                  * - `fast`: `2026-06-15`
                  * - `cost_effective`: `2026-09-28`
-                 * - `agentic`: `2026-10-15`
+                 * - `agentic`: `2026-10-16`
                  * - `agentic_plus`: `2026-09-28`
                  *
                  * Full list: `GET /api/v2/parse/versions`.
@@ -11750,7 +11750,7 @@ private constructor(
                      * Current `latest` by tier:
                      * - `fast`: `2026-06-15`
                      * - `cost_effective`: `2026-09-28`
-                     * - `agentic`: `2026-10-15`
+                     * - `agentic`: `2026-10-16`
                      * - `agentic_plus`: `2026-09-28`
                      *
                      * Full list: `GET /api/v2/parse/versions`.
@@ -13364,7 +13364,7 @@ private constructor(
                  * Current `latest` by tier:
                  * - `fast`: `2026-06-15`
                  * - `cost_effective`: `2026-09-28`
-                 * - `agentic`: `2026-10-15`
+                 * - `agentic`: `2026-10-16`
                  * - `agentic_plus`: `2026-09-28`
                  *
                  * Full list: `GET /api/v2/parse/versions`.
@@ -13388,7 +13388,7 @@ private constructor(
 
                         @JvmField val LATEST = of("latest")
 
-                        @JvmField val _2026_10_15 = of("2026-10-15")
+                        @JvmField val _2026_10_16 = of("2026-10-16")
 
                         @JvmField val _2026_09_28 = of("2026-09-28")
 
@@ -13400,7 +13400,7 @@ private constructor(
                     /** An enum containing [Version]'s known values. */
                     enum class Known {
                         LATEST,
-                        _2026_10_15,
+                        _2026_10_16,
                         _2026_09_28,
                         _2026_06_15,
                     }
@@ -13416,7 +13416,7 @@ private constructor(
                      */
                     enum class Value {
                         LATEST,
-                        _2026_10_15,
+                        _2026_10_16,
                         _2026_09_28,
                         _2026_06_15,
                         /**
@@ -13436,7 +13436,7 @@ private constructor(
                     fun value(): Value =
                         when (this) {
                             LATEST -> Value.LATEST
-                            _2026_10_15 -> Value._2026_10_15
+                            _2026_10_16 -> Value._2026_10_16
                             _2026_09_28 -> Value._2026_09_28
                             _2026_06_15 -> Value._2026_06_15
                             else -> Value._UNKNOWN
@@ -13454,7 +13454,7 @@ private constructor(
                     fun known(): Known =
                         when (this) {
                             LATEST -> Known.LATEST
-                            _2026_10_15 -> Known._2026_10_15
+                            _2026_10_16 -> Known._2026_10_16
                             _2026_09_28 -> Known._2026_09_28
                             _2026_06_15 -> Known._2026_06_15
                             else -> throw LlamaCloudInvalidDataException("Unknown Version: $value")
diff --git a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/ParsingListVersionsResponse.kt b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/ParsingListVersionsResponse.kt
index e0724de..08199c2 100644
--- a/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/ParsingListVersionsResponse.kt
+++ b/llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/ParsingListVersionsResponse.kt
@@ -393,6 +393,8 @@ private constructor(
 
         companion object {
 
+            @JvmField val _2026_10_16 = of("2026-10-16")
+
             @JvmField val _2026_10_15 = of("2026-10-15")
 
             @JvmField val _2026_09_29 = of("2026-09-29")
@@ -498,6 +500,7 @@ private constructor(
 
         /** An enum containing [Agentic]'s known values. */
         enum class Known {
+            _2026_10_16,
             _2026_10_15,
             _2026_09_29,
             _2026_09_28,
@@ -560,6 +563,7 @@ private constructor(
          * - It was constructed with an arbitrary value using the [of] method.
          */
         enum class Value {
+            _2026_10_16,
             _2026_10_15,
             _2026_09_29,
             _2026_09_28,
@@ -623,6 +627,7 @@ private constructor(
          */
         fun value(): Value =
             when (this) {
+                _2026_10_16 -> Value._2026_10_16
                 _2026_10_15 -> Value._2026_10_15
                 _2026_09_29 -> Value._2026_09_29
                 _2026_09_28 -> Value._2026_09_28
@@ -687,6 +692,7 @@ private constructor(
          */
         fun known(): Known =
             when (this) {
+                _2026_10_16 -> Known._2026_10_16
                 _2026_10_15 -> Known._2026_10_15
                 _2026_09_29 -> Known._2026_09_29
                 _2026_09_28 -> Known._2026_09_28
diff --git a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/parsing/ParsingListVersionsResponseTest.kt b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/parsing/ParsingListVersionsResponseTest.kt
index b782a22..77dd009 100644
--- a/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/parsing/ParsingListVersionsResponseTest.kt
+++ b/llama-cloud-core/src/test/kotlin/ai/llamaindex/llamacloud/models/parsing/ParsingListVersionsResponseTest.kt
@@ -13,7 +13,7 @@ internal class ParsingListVersionsResponseTest {
     fun create() {
         val parsingListVersionsResponse =
             ParsingListVersionsResponse.builder()
-                .addAgentic(ParsingListVersionsResponse.Agentic._2026_10_15)
+                .addAgentic(ParsingListVersionsResponse.Agentic._2026_10_16)
                 .addAgenticPlus(ParsingListVersionsResponse.AgenticPlus._2026_09_28)
                 .addCostEffective(ParsingListVersionsResponse.CostEffective._2026_09_28)
                 .addFast(ParsingListVersionsResponse.Fast._2026_06_15)
@@ -28,7 +28,7 @@ internal class ParsingListVersionsResponseTest {
                 .build()
 
         assertThat(parsingListVersionsResponse.agentic())
-            .containsExactly(ParsingListVersionsResponse.Agentic._2026_10_15)
+            .containsExactly(ParsingListVersionsResponse.Agentic._2026_10_16)
         assertThat(parsingListVersionsResponse.agenticPlus())
             .containsExactly(ParsingListVersionsResponse.AgenticPlus._2026_09_28)
         assertThat(parsingListVersionsResponse.costEffective())
@@ -51,7 +51,7 @@ internal class ParsingListVersionsResponseTest {
         val jsonMapper = jsonMapper()
         val parsingListVersionsResponse =
             ParsingListVersionsResponse.builder()
-                .addAgentic(ParsingListVersionsResponse.Agentic._2026_10_15)
+                .addAgentic(ParsingListVersionsResponse.Agentic._2026_10_16)
                 .addAgenticPlus(ParsingListVersionsResponse.AgenticPlus._2026_09_28)
                 .addCostEffective(ParsingListVersionsResponse.CostEffective._2026_09_28)
                 .addFast(ParsingListVersionsResponse.Fast._2026_06_15)