chunkr-ai 0.1.0a2__py3-none-any.whl → 0.1.0a4__py3-none-any.whl

chunkr_ai/types/file_list_params.py

@@ -0,0 +1,28 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Union
+from datetime import datetime
+from typing_extensions import Literal, Annotated, TypedDict
+
+from .._utils import PropertyInfo
+
+__all__ = ["FileListParams"]
+
+
+class FileListParams(TypedDict, total=False):
+    cursor: Annotated[Union[str, datetime], PropertyInfo(format="iso8601")]
+    """Cursor for pagination (created_at)"""
+
+    end: Annotated[Union[str, datetime], PropertyInfo(format="iso8601")]
+    """End date"""
+
+    limit: int
+    """Number of files per page"""
+
+    sort: Literal["asc", "desc"]
+    """Sort order: 'asc' for ascending, 'desc' for descending (default)"""
+
+    start: Annotated[Union[str, datetime], PropertyInfo(format="iso8601")]
+    """Start date"""

chunkr_ai/types/file_url.py

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from .._models import BaseModel
+
+__all__ = ["FileURL"]
+
+
+class FileURL(BaseModel):
+    url: str
+    """The presigned URL or base64 data (if base64_urls=true)"""
+
+    expires_in: Optional[int] = None
+    """Expiry in seconds (omitted when base64)"""

chunkr_ai/types/file_url_params.py

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+
+__all__ = ["FileURLParams"]
+
+
+class FileURLParams(TypedDict, total=False):
+    base64_urls: bool
+    """If true, returns base64 data instead of a presigned URL"""
+
+    expires_in: int
+    """Expiry in seconds for the presigned URL (default 3600)"""

chunkr_ai/types/files_list_response.py

@@ -0,0 +1,20 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from datetime import datetime
+
+from .file import File
+from .._models import BaseModel
+
+__all__ = ["FilesListResponse"]
+
+
+class FilesListResponse(BaseModel):
+    files: List[File]
+    """List of files"""
+
+    has_more: bool
+    """Whether there are more files to fetch"""
+
+    next_cursor: Optional[datetime] = None
+    """Cursor for pagination (timestamp) e.g. 2025-01-01T00:00:00Z"""

chunkr_ai/types/{task/task.py → task.py}

@@ -6,7 +6,7 @@ from typing_extensions import Literal, TypeAlias
 
 from pydantic import Field as FieldInfo
 
-from ..._models import BaseModel
+from .._models import BaseModel
 
 __all__ = [
     "Task",
@@ -494,7 +494,10 @@ class ConfigurationSegmentProcessing(BaseModel):
       - `Auto`: Process content automatically
       - `LLM`: Use large language models for processing
       - `Ignore`: Exclude segments from final output
-    - `description` enables LLM-generated descriptions for segments
+    - `description` enables LLM-generated descriptions for segments. **Note:** This
+      uses chunkr's own VLM models and is not configurable via LLM processing
+      configuration.
+    - `extended_context` uses the full page image as context for LLM generation.
 
     **Deprecated fields (for backwards compatibility):**
 
@@ -516,7 +519,10 @@ class ConfigurationSegmentProcessing(BaseModel):
       - `Auto`: Process content automatically
       - `LLM`: Use large language models for processing
       - `Ignore`: Exclude segments from final output
-    - `description` enables LLM-generated descriptions for segments
+    - `description` enables LLM-generated descriptions for segments. **Note:** This
+      uses chunkr's own VLM models and is not configurable via LLM processing
+      configuration.
+    - `extended_context` uses the full page image as context for LLM generation.
 
     **Deprecated fields (for backwards compatibility):**
 
@@ -538,7 +544,10 @@ class ConfigurationSegmentProcessing(BaseModel):
       - `Auto`: Process content automatically
       - `LLM`: Use large language models for processing
       - `Ignore`: Exclude segments from final output
-    - `description` enables LLM-generated descriptions for segments
+    - `description` enables LLM-generated descriptions for segments. **Note:** This
+      uses chunkr's own VLM models and is not configurable via LLM processing
+      configuration.
+    - `extended_context` uses the full page image as context for LLM generation.
 
     **Deprecated fields (for backwards compatibility):**
 
@@ -560,7 +569,10 @@ class ConfigurationSegmentProcessing(BaseModel):
       - `Auto`: Process content automatically
       - `LLM`: Use large language models for processing
       - `Ignore`: Exclude segments from final output
-    - `description` enables LLM-generated descriptions for segments
+    - `description` enables LLM-generated descriptions for segments. **Note:** This
+      uses chunkr's own VLM models and is not configurable via LLM processing
+      configuration.
+    - `extended_context` uses the full page image as context for LLM generation.
 
     **Deprecated fields (for backwards compatibility):**
 
@@ -582,7 +594,10 @@ class ConfigurationSegmentProcessing(BaseModel):
       - `Auto`: Process content automatically
       - `LLM`: Use large language models for processing
       - `Ignore`: Exclude segments from final output
-    - `description` enables LLM-generated descriptions for segments
+    - `description` enables LLM-generated descriptions for segments. **Note:** This
+      uses chunkr's own VLM models and is not configurable via LLM processing
+      configuration.
+    - `extended_context` uses the full page image as context for LLM generation.
 
     **Deprecated fields (for backwards compatibility):**
 
@@ -604,7 +619,10 @@ class ConfigurationSegmentProcessing(BaseModel):
       - `Auto`: Process content automatically
       - `LLM`: Use large language models for processing
       - `Ignore`: Exclude segments from final output
-    - `description` enables LLM-generated descriptions for segments
+    - `description` enables LLM-generated descriptions for segments. **Note:** This
+      uses chunkr's own VLM models and is not configurable via LLM processing
+      configuration.
+    - `extended_context` uses the full page image as context for LLM generation.
 
     **Deprecated fields (for backwards compatibility):**
 
@@ -626,7 +644,10 @@ class ConfigurationSegmentProcessing(BaseModel):
       - `Auto`: Process content automatically
       - `LLM`: Use large language models for processing
       - `Ignore`: Exclude segments from final output
-    - `description` enables LLM-generated descriptions for segments
+    - `description` enables LLM-generated descriptions for segments. **Note:** This
+      uses chunkr's own VLM models and is not configurable via LLM processing
+      configuration.
+    - `extended_context` uses the full page image as context for LLM generation.
 
     **Deprecated fields (for backwards compatibility):**
 
@@ -648,7 +669,10 @@ class ConfigurationSegmentProcessing(BaseModel):
       - `Auto`: Process content automatically
       - `LLM`: Use large language models for processing
       - `Ignore`: Exclude segments from final output
-    - `description` enables LLM-generated descriptions for segments
+    - `description` enables LLM-generated descriptions for segments. **Note:** This
+      uses chunkr's own VLM models and is not configurable via LLM processing
+      configuration.
+    - `extended_context` uses the full page image as context for LLM generation.
 
     **Deprecated fields (for backwards compatibility):**
 
@@ -672,7 +696,10 @@ class ConfigurationSegmentProcessing(BaseModel):
       - `Auto`: Process content automatically
       - `LLM`: Use large language models for processing
       - `Ignore`: Exclude segments from final output
-    - `description` enables LLM-generated descriptions for segments
+    - `description` enables LLM-generated descriptions for segments. **Note:** This
+      uses chunkr's own VLM models and is not configurable via LLM processing
+      configuration.
+    - `extended_context` uses the full page image as context for LLM generation.
 
     **Deprecated fields (for backwards compatibility):**
 
@@ -694,7 +721,10 @@ class ConfigurationSegmentProcessing(BaseModel):
       - `Auto`: Process content automatically
       - `LLM`: Use large language models for processing
       - `Ignore`: Exclude segments from final output
-    - `description` enables LLM-generated descriptions for segments
+    - `description` enables LLM-generated descriptions for segments. **Note:** This
+      uses chunkr's own VLM models and is not configurable via LLM processing
+      configuration.
+    - `extended_context` uses the full page image as context for LLM generation.
 
     **Deprecated fields (for backwards compatibility):**
 
@@ -716,7 +746,10 @@ class ConfigurationSegmentProcessing(BaseModel):
       - `Auto`: Process content automatically
       - `LLM`: Use large language models for processing
       - `Ignore`: Exclude segments from final output
-    - `description` enables LLM-generated descriptions for segments
+    - `description` enables LLM-generated descriptions for segments. **Note:** This
+      uses chunkr's own VLM models and is not configurable via LLM processing
+      configuration.
+    - `extended_context` uses the full page image as context for LLM generation.
 
     **Deprecated fields (for backwards compatibility):**
 
@@ -738,7 +771,10 @@ class ConfigurationSegmentProcessing(BaseModel):
       - `Auto`: Process content automatically
       - `LLM`: Use large language models for processing
       - `Ignore`: Exclude segments from final output
-    - `description` enables LLM-generated descriptions for segments
+    - `description` enables LLM-generated descriptions for segments. **Note:** This
+      uses chunkr's own VLM models and is not configurable via LLM processing
+      configuration.
+    - `extended_context` uses the full page image as context for LLM generation.
 
     **Deprecated fields (for backwards compatibility):**
 
@@ -796,18 +832,14 @@ class Configuration(BaseModel):
     content is produced (rule-based vs. LLM). • The output format (`Html` or
     `Markdown`).
 
-    Optional flags such as image **cropping**, **extended context**, and **LLM
-    descriptions** further refine behaviour.
-
-    ---
+    Optional flags such as image **cropping**, **extended context**, and
+    **descriptions** further refine behaviour.
 
     **Default strategy per segment** • `Title`, `SectionHeader`, `Text`, `ListItem`,
-    `Caption`, `Footnote` → **Auto** (Markdown) • `Table` → **LLM** (HTML,
-    description on) • `Picture` → **LLM** (Markdown, description off, cropping
-    _All_) • `Formula`, `Page` → **LLM** (Markdown) • `PageHeader`, `PageFooter` →
-    **Ignore** (removed from output)
-
-    ---
+    `Caption`, `Footnote` → **Auto** (Markdown, description off) • `Table` → **LLM**
+    (HTML, description on) • `Picture` → **LLM** (Markdown, description off,
+    cropping _All_) • `Formula`, `Page` → **LLM** (Markdown, description off) •
+    `PageHeader`, `PageFooter` → **Ignore** (removed from output)
 
     **Strategy reference** • **Auto** – rule-based content generation. • **LLM** –
     generate content with an LLM. • **Ignore** – exclude the segment entirely.

chunkr_ai/types/{task → tasks}/__init__.py

@@ -2,6 +2,5 @@
 
 from __future__ import annotations
 
-from .task import Task as Task
 from .parse_create_params import ParseCreateParams as ParseCreateParams
 from .parse_update_params import ParseUpdateParams as ParseUpdateParams

chunkr_ai/types/{task → tasks}/parse_create_params.py

@@ -34,7 +34,13 @@ __all__ = [
 
 class ParseCreateParams(TypedDict, total=False):
     file: Required[str]
-    """The file to be uploaded. Can be a URL or a base64 encoded file."""
+    """The file to be uploaded. Supported inputs:
+
+    - `ch://files/{file_id}`: References a previously uploaded file you own
+      (authorization enforced)
+    - `http(s)://...`: Remote URL to fetch
+    - `data:*;base64,...` or raw base64 string
+    """
 
     chunk_processing: Optional[ChunkProcessing]
     """Controls the setting for the chunking and post-processing of each chunk."""
@@ -82,18 +88,14 @@ class ParseCreateParams(TypedDict, total=False):
     content is produced (rule-based vs. LLM). • The output format (`Html` or
     `Markdown`).
 
-    Optional flags such as image **cropping**, **extended context**, and **LLM
-    descriptions** further refine behaviour.
-
-    ---
+    Optional flags such as image **cropping**, **extended context**, and
+    **descriptions** further refine behaviour.
 
     **Default strategy per segment** • `Title`, `SectionHeader`, `Text`, `ListItem`,
-    `Caption`, `Footnote` → **Auto** (Markdown) • `Table` → **LLM** (HTML,
-    description on) • `Picture` → **LLM** (Markdown, description off, cropping
-    _All_) • `Formula`, `Page` → **LLM** (Markdown) • `PageHeader`, `PageFooter` →
-    **Ignore** (removed from output)
-
-    ---
+    `Caption`, `Footnote` → **Auto** (Markdown, description off) • `Table` → **LLM**
+    (HTML, description on) • `Picture` → **LLM** (Markdown, description off,
+    cropping _All_) • `Formula`, `Page` → **LLM** (Markdown, description off) •
+    `PageHeader`, `PageFooter` → **Ignore** (removed from output)
 
     **Strategy reference** • **Auto** – rule-based content generation. • **LLM** –
     generate content with an LLM. • **Ignore** – exclude the segment entirely.
@@ -553,7 +555,10 @@ class SegmentProcessing(TypedDict, total=False):
       - `Auto`: Process content automatically
       - `LLM`: Use large language models for processing
       - `Ignore`: Exclude segments from final output
-    - `description` enables LLM-generated descriptions for segments
+    - `description` enables LLM-generated descriptions for segments. **Note:** This
+      uses chunkr's own VLM models and is not configurable via LLM processing
+      configuration.
+    - `extended_context` uses the full page image as context for LLM generation.
 
     **Deprecated fields (for backwards compatibility):**
 
@@ -575,7 +580,10 @@ class SegmentProcessing(TypedDict, total=False):
       - `Auto`: Process content automatically
       - `LLM`: Use large language models for processing
       - `Ignore`: Exclude segments from final output
-    - `description` enables LLM-generated descriptions for segments
+    - `description` enables LLM-generated descriptions for segments. **Note:** This
+      uses chunkr's own VLM models and is not configurable via LLM processing
+      configuration.
+    - `extended_context` uses the full page image as context for LLM generation.
 
     **Deprecated fields (for backwards compatibility):**
 
@@ -597,7 +605,10 @@ class SegmentProcessing(TypedDict, total=False):
       - `Auto`: Process content automatically
       - `LLM`: Use large language models for processing
       - `Ignore`: Exclude segments from final output
-    - `description` enables LLM-generated descriptions for segments
+    - `description` enables LLM-generated descriptions for segments. **Note:** This
+      uses chunkr's own VLM models and is not configurable via LLM processing
+      configuration.
+    - `extended_context` uses the full page image as context for LLM generation.
 
     **Deprecated fields (for backwards compatibility):**
 
@@ -619,7 +630,10 @@ class SegmentProcessing(TypedDict, total=False):
       - `Auto`: Process content automatically
       - `LLM`: Use large language models for processing
       - `Ignore`: Exclude segments from final output
-    - `description` enables LLM-generated descriptions for segments
+    - `description` enables LLM-generated descriptions for segments. **Note:** This
+      uses chunkr's own VLM models and is not configurable via LLM processing
+      configuration.
+    - `extended_context` uses the full page image as context for LLM generation.
 
     **Deprecated fields (for backwards compatibility):**
 
@@ -641,7 +655,10 @@ class SegmentProcessing(TypedDict, total=False):
       - `Auto`: Process content automatically
       - `LLM`: Use large language models for processing
       - `Ignore`: Exclude segments from final output
-    - `description` enables LLM-generated descriptions for segments
+    - `description` enables LLM-generated descriptions for segments. **Note:** This
+      uses chunkr's own VLM models and is not configurable via LLM processing
+      configuration.
+    - `extended_context` uses the full page image as context for LLM generation.
 
     **Deprecated fields (for backwards compatibility):**
 
@@ -663,7 +680,10 @@ class SegmentProcessing(TypedDict, total=False):
       - `Auto`: Process content automatically
       - `LLM`: Use large language models for processing
       - `Ignore`: Exclude segments from final output
-    - `description` enables LLM-generated descriptions for segments
+    - `description` enables LLM-generated descriptions for segments. **Note:** This
+      uses chunkr's own VLM models and is not configurable via LLM processing
+      configuration.
+    - `extended_context` uses the full page image as context for LLM generation.
 
     **Deprecated fields (for backwards compatibility):**
 
@@ -685,7 +705,10 @@ class SegmentProcessing(TypedDict, total=False):
       - `Auto`: Process content automatically
       - `LLM`: Use large language models for processing
       - `Ignore`: Exclude segments from final output
-    - `description` enables LLM-generated descriptions for segments
+    - `description` enables LLM-generated descriptions for segments. **Note:** This
+      uses chunkr's own VLM models and is not configurable via LLM processing
+      configuration.
+    - `extended_context` uses the full page image as context for LLM generation.
 
     **Deprecated fields (for backwards compatibility):**
 
@@ -707,7 +730,10 @@ class SegmentProcessing(TypedDict, total=False):
       - `Auto`: Process content automatically
       - `LLM`: Use large language models for processing
       - `Ignore`: Exclude segments from final output
-    - `description` enables LLM-generated descriptions for segments
+    - `description` enables LLM-generated descriptions for segments. **Note:** This
+      uses chunkr's own VLM models and is not configurable via LLM processing
+      configuration.
+    - `extended_context` uses the full page image as context for LLM generation.
 
     **Deprecated fields (for backwards compatibility):**
 
@@ -729,7 +755,10 @@ class SegmentProcessing(TypedDict, total=False):
       - `Auto`: Process content automatically
       - `LLM`: Use large language models for processing
       - `Ignore`: Exclude segments from final output
-    - `description` enables LLM-generated descriptions for segments
+    - `description` enables LLM-generated descriptions for segments. **Note:** This
+      uses chunkr's own VLM models and is not configurable via LLM processing
+      configuration.
+    - `extended_context` uses the full page image as context for LLM generation.
 
     **Deprecated fields (for backwards compatibility):**
 
@@ -751,7 +780,10 @@ class SegmentProcessing(TypedDict, total=False):
       - `Auto`: Process content automatically
       - `LLM`: Use large language models for processing
       - `Ignore`: Exclude segments from final output
-    - `description` enables LLM-generated descriptions for segments
+    - `description` enables LLM-generated descriptions for segments. **Note:** This
+      uses chunkr's own VLM models and is not configurable via LLM processing
+      configuration.
+    - `extended_context` uses the full page image as context for LLM generation.
 
     **Deprecated fields (for backwards compatibility):**
 
@@ -773,7 +805,10 @@ class SegmentProcessing(TypedDict, total=False):
       - `Auto`: Process content automatically
       - `LLM`: Use large language models for processing
       - `Ignore`: Exclude segments from final output
-    - `description` enables LLM-generated descriptions for segments
+    - `description` enables LLM-generated descriptions for segments. **Note:** This
+      uses chunkr's own VLM models and is not configurable via LLM processing
+      configuration.
+    - `extended_context` uses the full page image as context for LLM generation.
 
     **Deprecated fields (for backwards compatibility):**
 
@@ -795,7 +830,10 @@ class SegmentProcessing(TypedDict, total=False):
       - `Auto`: Process content automatically
       - `LLM`: Use large language models for processing
       - `Ignore`: Exclude segments from final output
-    - `description` enables LLM-generated descriptions for segments
+    - `description` enables LLM-generated descriptions for segments. **Note:** This
+      uses chunkr's own VLM models and is not configurable via LLM processing
+      configuration.
+    - `extended_context` uses the full page image as context for LLM generation.
 
     **Deprecated fields (for backwards compatibility):**
 

chunkr_ai/types/{task → tasks}/parse_update_params.py

@@ -82,18 +82,14 @@ class ParseUpdateParams(TypedDict, total=False):
     content is produced (rule-based vs. LLM). • The output format (`Html` or
     `Markdown`).
 
-    Optional flags such as image **cropping**, **extended context**, and **LLM
-    descriptions** further refine behaviour.
-
-    ---
+    Optional flags such as image **cropping**, **extended context**, and
+    **descriptions** further refine behaviour.
 
     **Default strategy per segment** • `Title`, `SectionHeader`, `Text`, `ListItem`,
-    `Caption`, `Footnote` → **Auto** (Markdown) • `Table` → **LLM** (HTML,
-    description on) • `Picture` → **LLM** (Markdown, description off, cropping
-    _All_) • `Formula`, `Page` → **LLM** (Markdown) • `PageHeader`, `PageFooter` →
-    **Ignore** (removed from output)
-
-    ---
+    `Caption`, `Footnote` → **Auto** (Markdown, description off) • `Table` → **LLM**
+    (HTML, description on) • `Picture` → **LLM** (Markdown, description off,
+    cropping _All_) • `Formula`, `Page` → **LLM** (Markdown, description off) •
+    `PageHeader`, `PageFooter` → **Ignore** (removed from output)
 
     **Strategy reference** • **Auto** – rule-based content generation. • **LLM** –
     generate content with an LLM. • **Ignore** – exclude the segment entirely.
@@ -553,7 +549,10 @@ class SegmentProcessing(TypedDict, total=False):
       - `Auto`: Process content automatically
       - `LLM`: Use large language models for processing
       - `Ignore`: Exclude segments from final output
-    - `description` enables LLM-generated descriptions for segments
+    - `description` enables LLM-generated descriptions for segments. **Note:** This
+      uses chunkr's own VLM models and is not configurable via LLM processing
+      configuration.
+    - `extended_context` uses the full page image as context for LLM generation.
 
     **Deprecated fields (for backwards compatibility):**
 
@@ -575,7 +574,10 @@ class SegmentProcessing(TypedDict, total=False):
       - `Auto`: Process content automatically
       - `LLM`: Use large language models for processing
       - `Ignore`: Exclude segments from final output
-    - `description` enables LLM-generated descriptions for segments
+    - `description` enables LLM-generated descriptions for segments. **Note:** This
+      uses chunkr's own VLM models and is not configurable via LLM processing
+      configuration.
+    - `extended_context` uses the full page image as context for LLM generation.
 
     **Deprecated fields (for backwards compatibility):**
 
@@ -597,7 +599,10 @@ class SegmentProcessing(TypedDict, total=False):
       - `Auto`: Process content automatically
       - `LLM`: Use large language models for processing
       - `Ignore`: Exclude segments from final output
-    - `description` enables LLM-generated descriptions for segments
+    - `description` enables LLM-generated descriptions for segments. **Note:** This
+      uses chunkr's own VLM models and is not configurable via LLM processing
+      configuration.
+    - `extended_context` uses the full page image as context for LLM generation.
 
     **Deprecated fields (for backwards compatibility):**
 
@@ -619,7 +624,10 @@ class SegmentProcessing(TypedDict, total=False):
       - `Auto`: Process content automatically
       - `LLM`: Use large language models for processing
       - `Ignore`: Exclude segments from final output
-    - `description` enables LLM-generated descriptions for segments
+    - `description` enables LLM-generated descriptions for segments. **Note:** This
+      uses chunkr's own VLM models and is not configurable via LLM processing
+      configuration.
+    - `extended_context` uses the full page image as context for LLM generation.
 
     **Deprecated fields (for backwards compatibility):**
 
@@ -641,7 +649,10 @@ class SegmentProcessing(TypedDict, total=False):
       - `Auto`: Process content automatically
       - `LLM`: Use large language models for processing
       - `Ignore`: Exclude segments from final output
-    - `description` enables LLM-generated descriptions for segments
+    - `description` enables LLM-generated descriptions for segments. **Note:** This
+      uses chunkr's own VLM models and is not configurable via LLM processing
+      configuration.
+    - `extended_context` uses the full page image as context for LLM generation.
 
     **Deprecated fields (for backwards compatibility):**
 
@@ -663,7 +674,10 @@ class SegmentProcessing(TypedDict, total=False):
       - `Auto`: Process content automatically
       - `LLM`: Use large language models for processing
       - `Ignore`: Exclude segments from final output
-    - `description` enables LLM-generated descriptions for segments
+    - `description` enables LLM-generated descriptions for segments. **Note:** This
+      uses chunkr's own VLM models and is not configurable via LLM processing
+      configuration.
+    - `extended_context` uses the full page image as context for LLM generation.
 
     **Deprecated fields (for backwards compatibility):**
 
@@ -685,7 +699,10 @@ class SegmentProcessing(TypedDict, total=False):
       - `Auto`: Process content automatically
       - `LLM`: Use large language models for processing
       - `Ignore`: Exclude segments from final output
-    - `description` enables LLM-generated descriptions for segments
+    - `description` enables LLM-generated descriptions for segments. **Note:** This
+      uses chunkr's own VLM models and is not configurable via LLM processing
+      configuration.
+    - `extended_context` uses the full page image as context for LLM generation.
 
     **Deprecated fields (for backwards compatibility):**
 
@@ -707,7 +724,10 @@ class SegmentProcessing(TypedDict, total=False):
       - `Auto`: Process content automatically
       - `LLM`: Use large language models for processing
       - `Ignore`: Exclude segments from final output
-    - `description` enables LLM-generated descriptions for segments
+    - `description` enables LLM-generated descriptions for segments. **Note:** This
+      uses chunkr's own VLM models and is not configurable via LLM processing
+      configuration.
+    - `extended_context` uses the full page image as context for LLM generation.
 
     **Deprecated fields (for backwards compatibility):**
 
@@ -729,7 +749,10 @@ class SegmentProcessing(TypedDict, total=False):
       - `Auto`: Process content automatically
       - `LLM`: Use large language models for processing
       - `Ignore`: Exclude segments from final output
-    - `description` enables LLM-generated descriptions for segments
+    - `description` enables LLM-generated descriptions for segments. **Note:** This
+      uses chunkr's own VLM models and is not configurable via LLM processing
+      configuration.
+    - `extended_context` uses the full page image as context for LLM generation.
 
     **Deprecated fields (for backwards compatibility):**
 
@@ -751,7 +774,10 @@ class SegmentProcessing(TypedDict, total=False):
       - `Auto`: Process content automatically
       - `LLM`: Use large language models for processing
       - `Ignore`: Exclude segments from final output
-    - `description` enables LLM-generated descriptions for segments
+    - `description` enables LLM-generated descriptions for segments. **Note:** This
+      uses chunkr's own VLM models and is not configurable via LLM processing
+      configuration.
+    - `extended_context` uses the full page image as context for LLM generation.
 
     **Deprecated fields (for backwards compatibility):**
 
@@ -773,7 +799,10 @@ class SegmentProcessing(TypedDict, total=False):
       - `Auto`: Process content automatically
       - `LLM`: Use large language models for processing
       - `Ignore`: Exclude segments from final output
-    - `description` enables LLM-generated descriptions for segments
+    - `description` enables LLM-generated descriptions for segments. **Note:** This
+      uses chunkr's own VLM models and is not configurable via LLM processing
+      configuration.
+    - `extended_context` uses the full page image as context for LLM generation.
 
     **Deprecated fields (for backwards compatibility):**
 
@@ -795,7 +824,10 @@ class SegmentProcessing(TypedDict, total=False):
       - `Auto`: Process content automatically
       - `LLM`: Use large language models for processing
       - `Ignore`: Exclude segments from final output
-    - `description` enables LLM-generated descriptions for segments
+    - `description` enables LLM-generated descriptions for segments. **Note:** This
+      uses chunkr's own VLM models and is not configurable via LLM processing
+      configuration.
+    - `extended_context` uses the full page image as context for LLM generation.
 
     **Deprecated fields (for backwards compatibility):**