feat(parse): apply watermark_handling to text output; add watermark e2e test (#27932)

Stainless-Generated-From: 158630752b68f21d64bdc66dae9bbc82c025ab8c

Author: stlc-bot

llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/configurations/ParseV2Parameters.kt

@@ -3205,10 +3205,12 @@ private constructor(
 
         /**
          * What to do with watermark text stamped across the page (e.g., 'CONFIDENTIAL', 'DRAFT'):
-         * 'move_to_end' (default) keeps it as the last block of the page's markdown and text
-         * output, 'move_to_start' as the first block, and 'remove' drops it. In every mode the
-         * detected text is reported in the page's `watermark` metadata. Requires version 2026-09-28
-         * or later on the cost_effective, agentic, and agentic_plus tiers; ignored otherwise
+         * 'move_to_end' (default) keeps it as the last block of the page's markdown,
+         * 'move_to_start' as the first block, and 'remove' drops it. The text output follows the
+         * same choice where the watermark is a line of its own in the PDF text layer. In every mode
+         * the detected text is reported in the page's `watermark` metadata. Requires version
+         * 2026-09-28 or later on the cost_effective, agentic, and agentic_plus tiers; ignored
+         * otherwise
          *
          * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g. if
          *   the server responded with an unexpected value).
@@ -3565,9 +3567,10 @@ private constructor(
 
             /**
              * What to do with watermark text stamped across the page (e.g., 'CONFIDENTIAL',
-             * 'DRAFT'): 'move_to_end' (default) keeps it as the last block of the page's markdown
-             * and text output, 'move_to_start' as the first block, and 'remove' drops it. In every
-             * mode the detected text is reported in the page's `watermark` metadata. Requires
+             * 'DRAFT'): 'move_to_end' (default) keeps it as the last block of the page's markdown,
+             * 'move_to_start' as the first block, and 'remove' drops it. The text output follows
+             * the same choice where the watermark is a line of its own in the PDF text layer. In
+             * every mode the detected text is reported in the page's `watermark` metadata. Requires
              * version 2026-09-28 or later on the cost_effective, agentic, and agentic_plus tiers;
              * ignored otherwise
              */
@@ -5354,10 +5357,12 @@ private constructor(
 
         /**
          * What to do with watermark text stamped across the page (e.g., 'CONFIDENTIAL', 'DRAFT'):
-         * 'move_to_end' (default) keeps it as the last block of the page's markdown and text
-         * output, 'move_to_start' as the first block, and 'remove' drops it. In every mode the
-         * detected text is reported in the page's `watermark` metadata. Requires version 2026-09-28
-         * or later on the cost_effective, agentic, and agentic_plus tiers; ignored otherwise
+         * 'move_to_end' (default) keeps it as the last block of the page's markdown,
+         * 'move_to_start' as the first block, and 'remove' drops it. The text output follows the
+         * same choice where the watermark is a line of its own in the PDF text layer. In every mode
+         * the detected text is reported in the page's `watermark` metadata. Requires version
+         * 2026-09-28 or later on the cost_effective, agentic, and agentic_plus tiers; ignored
+         * otherwise
          */
         class WatermarkHandling
         @JsonCreator

llama-cloud-core/src/main/kotlin/ai/llamaindex/llamacloud/models/parsing/ParsingCreateParams.kt

@@ -4410,10 +4410,12 @@ private constructor(
 
         /**
          * What to do with watermark text stamped across the page (e.g., 'CONFIDENTIAL', 'DRAFT'):
-         * 'move_to_end' (default) keeps it as the last block of the page's markdown and text
-         * output, 'move_to_start' as the first block, and 'remove' drops it. In every mode the
-         * detected text is reported in the page's `watermark` metadata. Requires version 2026-09-28
-         * or later on the cost_effective, agentic, and agentic_plus tiers; ignored otherwise
+         * 'move_to_end' (default) keeps it as the last block of the page's markdown,
+         * 'move_to_start' as the first block, and 'remove' drops it. The text output follows the
+         * same choice where the watermark is a line of its own in the PDF text layer. In every mode
+         * the detected text is reported in the page's `watermark` metadata. Requires version
+         * 2026-09-28 or later on the cost_effective, agentic, and agentic_plus tiers; ignored
+         * otherwise
          *
          * @throws LlamaCloudInvalidDataException if the JSON field has an unexpected type (e.g. if
          *   the server responded with an unexpected value).
@@ -4770,9 +4772,10 @@ private constructor(
 
             /**
              * What to do with watermark text stamped across the page (e.g., 'CONFIDENTIAL',
-             * 'DRAFT'): 'move_to_end' (default) keeps it as the last block of the page's markdown
-             * and text output, 'move_to_start' as the first block, and 'remove' drops it. In every
-             * mode the detected text is reported in the page's `watermark` metadata. Requires
+             * 'DRAFT'): 'move_to_end' (default) keeps it as the last block of the page's markdown,
+             * 'move_to_start' as the first block, and 'remove' drops it. The text output follows
+             * the same choice where the watermark is a line of its own in the PDF text layer. In
+             * every mode the detected text is reported in the page's `watermark` metadata. Requires
              * version 2026-09-28 or later on the cost_effective, agentic, and agentic_plus tiers;
              * ignored otherwise
              */
@@ -6559,10 +6562,12 @@ private constructor(
 
         /**
          * What to do with watermark text stamped across the page (e.g., 'CONFIDENTIAL', 'DRAFT'):
-         * 'move_to_end' (default) keeps it as the last block of the page's markdown and text
-         * output, 'move_to_start' as the first block, and 'remove' drops it. In every mode the
-         * detected text is reported in the page's `watermark` metadata. Requires version 2026-09-28
-         * or later on the cost_effective, agentic, and agentic_plus tiers; ignored otherwise
+         * 'move_to_end' (default) keeps it as the last block of the page's markdown,
+         * 'move_to_start' as the first block, and 'remove' drops it. The text output follows the
+         * same choice where the watermark is a line of its own in the PDF text layer. In every mode
+         * the detected text is reported in the page's `watermark` metadata. Requires version
+         * 2026-09-28 or later on the cost_effective, agentic, and agentic_plus tiers; ignored
+         * otherwise
          */
         class WatermarkHandling
         @JsonCreator