feat(service): Add S3Coordinates.max_num_elements (#3565)

Add S3Coordinates.max_num_elements

Signed-off-by: Christoph Auer <cau@zurich.ibm.com>

Author: cau-git

docling/datamodel/service/sources.py

@@ -94,3 +94,14 @@ class S3Coordinates(BaseModel):
             ),
         ),
     ] = ""
+
+    max_num_elements: Annotated[
+        int | None,
+        Field(
+            description=(
+                "Maximum number of S3 objects to iterate for this source. "
+                "Optional, defaults to no limit."
+            ),
+            ge=1,
+        ),
+    ] = None