retab 0.0.42__py3-none-any.whl → 0.0.43__py3-none-any.whl

retab/resources/processors/automations/mailboxes.py

@@ -3,7 +3,7 @@ from pathlib import Path
 from typing import Any, List, Literal, Optional
 
 from pydantic import EmailStr, HttpUrl
-from pydantic_core import PydanticUndefined
+from ....types.standards import FieldUnset
 
 from ...._resource import AsyncAPIResource, SyncAPIResource
 from ....utils.mime import prepare_mime_document
@@ -21,25 +21,32 @@ class MailBoxesMixin:
         name: str,
         processor_id: str,
         webhook_url: str,
-        authorized_domains: list[str] = PydanticUndefined,  # type: ignore[assignment]
-        authorized_emails: list[EmailStr] = PydanticUndefined,  # type: ignore[assignment]
-        webhook_headers: dict[str, str] = PydanticUndefined,  # type: ignore[assignment]
-        default_language: str = PydanticUndefined,  # type: ignore[assignment]
-        need_validation: bool = PydanticUndefined,  # type: ignore[assignment]
+        authorized_domains: list[str] = FieldUnset,
+        authorized_emails: list[EmailStr] = FieldUnset,
+        webhook_headers: dict[str, str] = FieldUnset,
+        default_language: str = FieldUnset,
+        need_validation: bool = FieldUnset,
     ) -> PreparedRequest:
         """Create a new email automation configuration."""
-        mailbox = Mailbox(
-            name=name,
-            processor_id=processor_id,
-            default_language=default_language,
-            webhook_url=webhook_url,
-            webhook_headers=webhook_headers,
-            need_validation=need_validation,
-            email=email,
-            authorized_domains=authorized_domains,
-            authorized_emails=authorized_emails,
-        )
-        return PreparedRequest(method="POST", url=self.mailboxes_base_url, data=mailbox.model_dump(mode="json"))
+        mailbox_dict: dict[str, Any] = {
+            'name': name,
+            'processor_id': processor_id,
+            'webhook_url': webhook_url,
+            'email': email,
+        }
+        if default_language is not FieldUnset:
+            mailbox_dict['default_language'] = default_language
+        if webhook_headers is not FieldUnset:
+            mailbox_dict['webhook_headers'] = webhook_headers
+        if need_validation is not FieldUnset:
+            mailbox_dict['need_validation'] = need_validation
+        if authorized_domains is not FieldUnset:
+            mailbox_dict['authorized_domains'] = authorized_domains
+        if authorized_emails is not FieldUnset:
+            mailbox_dict['authorized_emails'] = authorized_emails
+
+        mailbox = Mailbox(**mailbox_dict)
+        return PreparedRequest(method="POST", url=self.mailboxes_base_url, data=mailbox.model_dump(mode="json", exclude_unset=True))
 
     def prepare_list(
         self,
@@ -73,24 +80,32 @@ class MailBoxesMixin:
     def prepare_update(
         self,
         mailbox_id: str,
-        name: str = PydanticUndefined,  # type: ignore[assignment]
-        default_language: str = PydanticUndefined,  # type: ignore[assignment]
-        webhook_url: str = PydanticUndefined,  # type: ignore[assignment]
-        webhook_headers: dict[str, str] = PydanticUndefined,  # type: ignore[assignment]
-        need_validation: bool = PydanticUndefined,  # type: ignore[assignment]
-        authorized_domains: list[str] = PydanticUndefined,  # type: ignore[assignment]
-        authorized_emails: list[str] = PydanticUndefined,  # type: ignore[assignment]
+        name: str = FieldUnset,
+        default_language: str = FieldUnset,
+        webhook_url: str = FieldUnset,
+        webhook_headers: dict[str, str] = FieldUnset,
+        need_validation: bool = FieldUnset,
+        authorized_domains: list[str] = FieldUnset,
+        authorized_emails: list[str] = FieldUnset,
     ) -> PreparedRequest:
-        update_mailbox_request = UpdateMailboxRequest(
-            name=name,
-            default_language=default_language,
-            webhook_url=webhook_url,
-            webhook_headers=webhook_headers,
-            need_validation=need_validation,
-            authorized_domains=authorized_domains,
-            authorized_emails=authorized_emails,
-        )
-        return PreparedRequest(method="PUT", url=f"/v1/processors/automations/mailboxes/{mailbox_id}", data=update_mailbox_request.model_dump(mode="json"))
+        update_dict: dict[str, Any] = {}
+        if name is not FieldUnset:
+            update_dict['name'] = name
+        if default_language is not FieldUnset:
+            update_dict['default_language'] = default_language
+        if webhook_url is not FieldUnset:
+            update_dict['webhook_url'] = webhook_url
+        if webhook_headers is not FieldUnset:
+            update_dict['webhook_headers'] = webhook_headers
+        if need_validation is not FieldUnset:
+            update_dict['need_validation'] = need_validation
+        if authorized_domains is not FieldUnset:
+            update_dict['authorized_domains'] = authorized_domains
+        if authorized_emails is not FieldUnset:
+            update_dict['authorized_emails'] = authorized_emails
+
+        update_mailbox_request = UpdateMailboxRequest(**update_dict)
+        return PreparedRequest(method="PUT", url=f"/v1/processors/automations/mailboxes/{mailbox_id}", data=update_mailbox_request.model_dump(mode="json", exclude_unset=True))
 
     def prepare_delete(self, mailbox_id: str) -> PreparedRequest:
         return PreparedRequest(method="DELETE", url=f"/v1/processors/automations/mailboxes/{mailbox_id}", raise_for_status=True)
@@ -109,11 +124,11 @@ class Mailboxes(SyncAPIResource, MailBoxesMixin):
         name: str,
         webhook_url: str,
         processor_id: str,
-        authorized_domains: list[str] = PydanticUndefined,  # type: ignore[assignment]
-        authorized_emails: list[EmailStr] = PydanticUndefined,  # type: ignore[assignment]
-        webhook_headers: dict[str, str] = PydanticUndefined,  # type: ignore[assignment]
-        default_language: str = PydanticUndefined,  # type: ignore[assignment]
-        need_validation: bool = PydanticUndefined,  # type: ignore[assignment]
+        authorized_domains: list[str] = FieldUnset,
+        authorized_emails: list[EmailStr] = FieldUnset,
+        webhook_headers: dict[str, str] = FieldUnset,
+        default_language: str = FieldUnset,
+        need_validation: bool = FieldUnset,
     ) -> Mailbox:
         """Create a new email automation configuration.
 
@@ -202,13 +217,13 @@ class Mailboxes(SyncAPIResource, MailBoxesMixin):
     def update(
         self,
         mailbox_id: str,
-        name: str = PydanticUndefined,  # type: ignore[assignment]
-        default_language: str = PydanticUndefined,  # type: ignore[assignment]
-        webhook_url: str = PydanticUndefined,  # type: ignore[assignment]
-        webhook_headers: dict[str, str] = PydanticUndefined,  # type: ignore[assignment]
-        need_validation: bool = PydanticUndefined,  # type: ignore[assignment]
-        authorized_domains: List[str] = PydanticUndefined,  # type: ignore[assignment]
-        authorized_emails: List[str] = PydanticUndefined,  # type: ignore[assignment]
+        name: str = FieldUnset,
+        default_language: str = FieldUnset,
+        webhook_url: str = FieldUnset,
+        webhook_headers: dict[str, str] = FieldUnset,
+        need_validation: bool = FieldUnset,
+        authorized_domains: List[str] = FieldUnset,
+        authorized_emails: List[str] = FieldUnset,
     ) -> Mailbox:
         """Update an email automation configuration.
 
@@ -260,11 +275,11 @@ class AsyncMailboxes(AsyncAPIResource, MailBoxesMixin):
         name: str,
         webhook_url: str,
         processor_id: str,
-        authorized_domains: List[str] = PydanticUndefined,  # type: ignore[assignment]
-        authorized_emails: List[EmailStr] = PydanticUndefined,  # type: ignore[assignment]
-        webhook_headers: dict[str, str] = PydanticUndefined,  # type: ignore[assignment]
-        default_language: str = PydanticUndefined,  # type: ignore[assignment]
-        need_validation: bool = PydanticUndefined,  # type: ignore[assignment]
+        authorized_domains: List[str] = FieldUnset,
+        authorized_emails: List[EmailStr] = FieldUnset,
+        webhook_headers: dict[str, str] = FieldUnset,
+        default_language: str = FieldUnset,
+        need_validation: bool = FieldUnset,
     ) -> Mailbox:
         request = self.prepare_create(
             email=email,
@@ -315,13 +330,13 @@ class AsyncMailboxes(AsyncAPIResource, MailBoxesMixin):
     async def update(
         self,
         mailbox_id: str,
-        name: str = PydanticUndefined,  # type: ignore[assignment]
-        default_language: str = PydanticUndefined,  # type: ignore[assignment]
-        webhook_url: str = PydanticUndefined,  # type: ignore[assignment]
-        webhook_headers: dict[str, str] = PydanticUndefined,  # type: ignore[assignment]
-        need_validation: bool = PydanticUndefined,  # type: ignore[assignment]
-        authorized_domains: List[str] = PydanticUndefined,  # type: ignore[assignment]
-        authorized_emails: List[str] = PydanticUndefined,  # type: ignore[assignment]
+        name: str = FieldUnset,
+        default_language: str = FieldUnset,
+        webhook_url: str = FieldUnset,
+        webhook_headers: dict[str, str] = FieldUnset,
+        need_validation: bool = FieldUnset,
+        authorized_domains: List[str] = FieldUnset,
+        authorized_emails: List[str] = FieldUnset,
     ) -> Mailbox:
         request = self.prepare_update(
             mailbox_id=mailbox_id,

retab/resources/processors/automations/outlook.py

@@ -1,6 +1,6 @@
 from typing import Any, Literal, List
 
-from pydantic_core import PydanticUndefined
+from ....types.standards import FieldUnset
 
 from ...._resource import AsyncAPIResource, SyncAPIResource
 from ....types.automations.outlook import (
@@ -21,33 +21,44 @@ class OutlooksMixin:
         name: str,
         processor_id: str,
         webhook_url: str,
-        default_language: str = PydanticUndefined,  # type: ignore[assignment]
-        webhook_headers: dict[str, str] = PydanticUndefined,  # type: ignore[assignment]
-        need_validation: bool = PydanticUndefined,  # type: ignore[assignment]
-        authorized_domains: list[str] = PydanticUndefined,  # type: ignore[assignment]
-        authorized_emails: list[str] = PydanticUndefined,  # type: ignore[assignment]
-        layout_schema: dict[str, Any] = PydanticUndefined,  # type: ignore[assignment]
-        match_params: list[MatchParams] = PydanticUndefined,  # type: ignore[assignment]
-        fetch_params: list[FetchParams] = PydanticUndefined,  # type: ignore[assignment]
+        default_language: str = FieldUnset,
+        webhook_headers: dict[str, str] = FieldUnset,
+        need_validation: bool = FieldUnset,
+        authorized_domains: list[str] = FieldUnset,
+        authorized_emails: list[str] = FieldUnset,
+        layout_schema: dict[str, Any] = FieldUnset,
+        match_params: list[MatchParams] = FieldUnset,
+        fetch_params: list[FetchParams] = FieldUnset,
     ) -> PreparedRequest:
+        # Build outlook dictionary with only provided fields
+        outlook_dict: dict[str, Any] = {
+            'processor_id': processor_id,
+            'name': name,
+            'webhook_url': webhook_url,
+        }
+        if default_language is not FieldUnset:
+            outlook_dict['default_language'] = default_language
+        if webhook_headers is not FieldUnset:
+            outlook_dict['webhook_headers'] = webhook_headers
+        if need_validation is not FieldUnset:
+            outlook_dict['need_validation'] = need_validation
+        if authorized_domains is not FieldUnset:
+            outlook_dict['authorized_domains'] = authorized_domains
+        if authorized_emails is not FieldUnset:
+            outlook_dict['authorized_emails'] = authorized_emails
+        if layout_schema is not FieldUnset:
+            outlook_dict['layout_schema'] = layout_schema
+        if match_params is not FieldUnset:
+            outlook_dict['match_params'] = match_params
+        if fetch_params is not FieldUnset:
+            outlook_dict['fetch_params'] = fetch_params
+
         # Validate the data
-        outlook_data = Outlook(
-            processor_id=processor_id,
-            name=name,
-            default_language=default_language,
-            webhook_url=webhook_url,
-            webhook_headers=webhook_headers,
-            need_validation=need_validation,
-            authorized_domains=authorized_domains,
-            authorized_emails=authorized_emails,
-            layout_schema=layout_schema,
-            match_params=match_params,
-            fetch_params=fetch_params,
-        )
+        outlook_data = Outlook(**outlook_dict)
         return PreparedRequest(
             method="POST",
             url=self.outlooks_base_url,
-            data=outlook_data.model_dump(mode="json"),
+            data=outlook_data.model_dump(mode="json", exclude_unset=True),
         )
 
     def prepare_list(
@@ -80,34 +91,45 @@ class OutlooksMixin:
     def prepare_update(
         self,
         outlook_id: str,
-        name: str = PydanticUndefined,  # type: ignore[assignment]
-        default_language: str = PydanticUndefined,  # type: ignore[assignment]
-        webhook_url: str = PydanticUndefined,  # type: ignore[assignment]
-        webhook_headers: dict[str, str] = PydanticUndefined,  # type: ignore[assignment]
-        need_validation: bool = PydanticUndefined,  # type: ignore[assignment]
-        authorized_domains: list[str] = PydanticUndefined,  # type: ignore[assignment]
-        authorized_emails: list[str] = PydanticUndefined,  # type: ignore[assignment]
-        match_params: list[MatchParams] = PydanticUndefined,  # type: ignore[assignment]
-        fetch_params: list[FetchParams] = PydanticUndefined,  # type: ignore[assignment]
-        layout_schema: dict[str, Any] = PydanticUndefined,  # type: ignore[assignment]
+        name: str = FieldUnset,
+        default_language: str = FieldUnset,
+        webhook_url: str = FieldUnset,
+        webhook_headers: dict[str, str] = FieldUnset,
+        need_validation: bool = FieldUnset,
+        authorized_domains: list[str] = FieldUnset,
+        authorized_emails: list[str] = FieldUnset,
+        match_params: list[MatchParams] = FieldUnset,
+        fetch_params: list[FetchParams] = FieldUnset,
+        layout_schema: dict[str, Any] = FieldUnset,
     ) -> PreparedRequest:
-        update_outlook_request = UpdateOutlookRequest(
-            name=name,
-            default_language=default_language,
-            webhook_url=webhook_url,
-            webhook_headers=webhook_headers,
-            need_validation=need_validation,
-            authorized_domains=authorized_domains,
-            authorized_emails=authorized_emails,
-            layout_schema=layout_schema,
-            match_params=match_params,
-            fetch_params=fetch_params,
-        )
+        update_dict: dict[str, Any] = {}
+        if name is not FieldUnset:
+            update_dict['name'] = name
+        if default_language is not FieldUnset:
+            update_dict['default_language'] = default_language
+        if webhook_url is not FieldUnset:
+            update_dict['webhook_url'] = webhook_url
+        if webhook_headers is not FieldUnset:
+            update_dict['webhook_headers'] = webhook_headers
+        if need_validation is not FieldUnset:
+            update_dict['need_validation'] = need_validation
+        if authorized_domains is not FieldUnset:
+            update_dict['authorized_domains'] = authorized_domains
+        if authorized_emails is not FieldUnset:
+            update_dict['authorized_emails'] = authorized_emails
+        if layout_schema is not FieldUnset:
+            update_dict['layout_schema'] = layout_schema
+        if match_params is not FieldUnset:
+            update_dict['match_params'] = match_params
+        if fetch_params is not FieldUnset:
+            update_dict['fetch_params'] = fetch_params
+
+        update_outlook_request = UpdateOutlookRequest(**update_dict)
 
         return PreparedRequest(
             method="PUT",
             url=f"{self.outlooks_base_url}/{outlook_id}",
-            data=update_outlook_request.model_dump(mode="json"),
+            data=update_outlook_request.model_dump(mode="json", exclude_unset=True),
         )
 
     def prepare_delete(self, outlook_id: str) -> PreparedRequest:
@@ -125,14 +147,14 @@ class Outlooks(SyncAPIResource, OutlooksMixin):
         name: str,
         processor_id: str,
         webhook_url: str,
-        default_language: str = PydanticUndefined,  # type: ignore[assignment]
-        webhook_headers: dict[str, str] = PydanticUndefined,  # type: ignore[assignment]
-        need_validation: bool = PydanticUndefined,  # type: ignore[assignment]
-        authorized_domains: list[str] = PydanticUndefined,  # type: ignore[assignment]
-        authorized_emails: list[str] = PydanticUndefined,  # type: ignore[assignment]
-        layout_schema: dict[str, Any] = PydanticUndefined,  # type: ignore[assignment]
-        match_params: list[MatchParams] = PydanticUndefined,  # type: ignore[assignment]
-        fetch_params: list[FetchParams] = PydanticUndefined,  # type: ignore[assignment]
+        default_language: str = FieldUnset,
+        webhook_headers: dict[str, str] = FieldUnset,
+        need_validation: bool = FieldUnset,
+        authorized_domains: list[str] = FieldUnset,
+        authorized_emails: list[str] = FieldUnset,
+        layout_schema: dict[str, Any] = FieldUnset,
+        match_params: list[MatchParams] = FieldUnset,
+        fetch_params: list[FetchParams] = FieldUnset,
     ) -> Outlook:
         """Create a new outlook automation configuration.
 
@@ -211,16 +233,16 @@ class Outlooks(SyncAPIResource, OutlooksMixin):
     def update(
         self,
         outlook_id: str,
-        name: str = PydanticUndefined,  # type: ignore[assignment]
-        default_language: str = PydanticUndefined,  # type: ignore[assignment]
-        webhook_url: str = PydanticUndefined,  # type: ignore[assignment]
-        webhook_headers: dict[str, str] = PydanticUndefined,  # type: ignore[assignment]
-        need_validation: bool = PydanticUndefined,  # type: ignore[assignment]
-        authorized_domains: List[str] = PydanticUndefined,  # type: ignore[assignment]
-        authorized_emails: List[str] = PydanticUndefined,  # type: ignore[assignment]
-        layout_schema: dict[str, Any] = PydanticUndefined,  # type: ignore[assignment]
-        match_params: List[MatchParams] = PydanticUndefined,  # type: ignore[assignment]
-        fetch_params: List[FetchParams] = PydanticUndefined,  # type: ignore[assignment]
+        name: str = FieldUnset,
+        default_language: str = FieldUnset,
+        webhook_url: str = FieldUnset,
+        webhook_headers: dict[str, str] = FieldUnset,
+        need_validation: bool = FieldUnset,
+        authorized_domains: List[str] = FieldUnset,
+        authorized_emails: List[str] = FieldUnset,
+        layout_schema: dict[str, Any] = FieldUnset,
+        match_params: List[MatchParams] = FieldUnset,
+        fetch_params: List[FetchParams] = FieldUnset,
     ) -> Outlook:
         """Update an outlook automation configuration.
 
@@ -274,14 +296,14 @@ class AsyncOutlooks(AsyncAPIResource, OutlooksMixin):
         name: str,
         processor_id: str,
         webhook_url: str,
-        default_language: str = PydanticUndefined,  # type: ignore[assignment]
-        webhook_headers: dict[str, str] = PydanticUndefined,  # type: ignore[assignment]
-        need_validation: bool = PydanticUndefined,  # type: ignore[assignment]
-        authorized_domains: list[str] = PydanticUndefined,  # type: ignore[assignment]
-        authorized_emails: list[str] = PydanticUndefined,  # type: ignore[assignment]
-        layout_schema: dict[str, Any] = PydanticUndefined,  # type: ignore[assignment]
-        match_params: list[MatchParams] = PydanticUndefined,  # type: ignore[assignment]
-        fetch_params: list[FetchParams] = PydanticUndefined,  # type: ignore[assignment]
+        default_language: str = FieldUnset,
+        webhook_headers: dict[str, str] = FieldUnset,
+        need_validation: bool = FieldUnset,
+        authorized_domains: list[str] = FieldUnset,
+        authorized_emails: list[str] = FieldUnset,
+        layout_schema: dict[str, Any] = FieldUnset,
+        match_params: list[MatchParams] = FieldUnset,
+        fetch_params: list[FetchParams] = FieldUnset,
     ) -> Outlook:
         request = self.prepare_create(
             name=name,
@@ -322,16 +344,16 @@ class AsyncOutlooks(AsyncAPIResource, OutlooksMixin):
     async def update(
         self,
         outlook_id: str,
-        name: str = PydanticUndefined,  # type: ignore[assignment]
-        default_language: str = PydanticUndefined,  # type: ignore[assignment]
-        webhook_url: str = PydanticUndefined,  # type: ignore[assignment]
-        webhook_headers: dict[str, str] = PydanticUndefined,  # type: ignore[assignment]
-        need_validation: bool = PydanticUndefined,  # type: ignore[assignment]
-        authorized_domains: List[str] = PydanticUndefined,  # type: ignore[assignment]
-        authorized_emails: List[str] = PydanticUndefined,  # type: ignore[assignment]
-        layout_schema: dict[str, Any] = PydanticUndefined,  # type: ignore[assignment]
-        match_params: List[MatchParams] = PydanticUndefined,  # type: ignore[assignment]
-        fetch_params: List[FetchParams] = PydanticUndefined,  # type: ignore[assignment]
+        name: str = FieldUnset,
+        default_language: str = FieldUnset,
+        webhook_url: str = FieldUnset,
+        webhook_headers: dict[str, str] = FieldUnset,
+        need_validation: bool = FieldUnset,
+        authorized_domains: List[str] = FieldUnset,
+        authorized_emails: List[str] = FieldUnset,
+        layout_schema: dict[str, Any] = FieldUnset,
+        match_params: List[MatchParams] = FieldUnset,
+        fetch_params: List[FetchParams] = FieldUnset,
     ) -> Outlook:
         request = self.prepare_update(
             outlook_id=outlook_id,

retab/resources/processors/client.py

@@ -6,8 +6,6 @@ from typing import Any, List, Literal
 import PIL.Image
 from openai.types.chat.chat_completion_reasoning_effort import ChatCompletionReasoningEffort
 from pydantic import BaseModel, HttpUrl
-from pydantic_core import PydanticUndefined
-
 from ..._resource import AsyncAPIResource, SyncAPIResource
 from ...utils.ai_models import assert_valid_model_extraction
 from ...utils.json_schema import load_json_schema
@@ -17,7 +15,7 @@ from ...types.documents.extractions import RetabParsedChatCompletion
 from ...types.logs import ProcessorConfig, UpdateProcessorRequest
 from ...types.modalities import Modality
 from ...types.pagination import ListMetadata
-from ...types.standards import PreparedRequest
+from ...types.standards import PreparedRequest, FieldUnset
 from .automations.client import AsyncAutomations, Automations
 
 
@@ -35,30 +33,37 @@ class ProcessorsMixin:
         json_schema: dict[str, Any] | Path | str,
         modality: Modality = "native",
         model: str = "gpt-4o-mini",
-        temperature: float = PydanticUndefined,  # type: ignore[assignment]
-        reasoning_effort: ChatCompletionReasoningEffort = PydanticUndefined,  # type: ignore[assignment]
-        image_resolution_dpi: int = PydanticUndefined,  # type: ignore[assignment]
-        browser_canvas: BrowserCanvas = PydanticUndefined,  # type: ignore[assignment]
-        n_consensus: int = PydanticUndefined,  # type: ignore[assignment]
+        temperature: float = FieldUnset,
+        reasoning_effort: ChatCompletionReasoningEffort = FieldUnset,
+        image_resolution_dpi: int = FieldUnset,
+        browser_canvas: BrowserCanvas = FieldUnset,
+        n_consensus: int = FieldUnset,
     ) -> PreparedRequest:
         assert_valid_model_extraction(model)
 
         # Load the JSON schema from file path, string, or dict
         loaded_schema = load_json_schema(json_schema)
 
-        processor_config = ProcessorConfig(
-            name=name,
-            json_schema=loaded_schema,
-            modality=modality,
-            model=model,
-            temperature=temperature,
-            reasoning_effort=reasoning_effort,
-            image_resolution_dpi=image_resolution_dpi,
-            browser_canvas=browser_canvas,
-            n_consensus=n_consensus,
-        )
+        config_dict = {
+            'name': name,
+            'json_schema': loaded_schema,
+            'modality': modality,
+            'model': model,
+        }
+        if temperature is not FieldUnset:
+            config_dict['temperature'] = temperature
+        if reasoning_effort is not FieldUnset:
+            config_dict['reasoning_effort'] = reasoning_effort
+        if image_resolution_dpi is not FieldUnset:
+            config_dict['image_resolution_dpi'] = image_resolution_dpi
+        if browser_canvas is not FieldUnset:
+            config_dict['browser_canvas'] = browser_canvas
+        if n_consensus is not FieldUnset:
+            config_dict['n_consensus'] = n_consensus
+
+        processor_config = ProcessorConfig(**config_dict)
 
-        return PreparedRequest(method="POST", url="/v1/processors", data=processor_config.model_dump(mode="json"))
+        return PreparedRequest(method="POST", url="/v1/processors", data=processor_config.model_dump(mode="json", exclude_unset=True))
 
     def prepare_list(
         self,
@@ -215,11 +220,11 @@ class Processors(SyncAPIResource, ProcessorsMixin):
         json_schema: dict[str, Any] | Path | str,
         modality: Modality = "native",
         model: str = "gpt-4o-mini",
-        temperature: float = PydanticUndefined,  # type: ignore[assignment]
-        reasoning_effort: ChatCompletionReasoningEffort = PydanticUndefined,  # type: ignore[assignment]
-        image_resolution_dpi: int = PydanticUndefined,  # type: ignore[assignment]
-        browser_canvas: BrowserCanvas = PydanticUndefined,  # type: ignore[assignment]
-        n_consensus: int = PydanticUndefined,  # type: ignore[assignment]
+        temperature: float = FieldUnset,
+        reasoning_effort: ChatCompletionReasoningEffort = FieldUnset,
+        image_resolution_dpi: int = FieldUnset,
+        browser_canvas: BrowserCanvas = FieldUnset,
+        n_consensus: int = FieldUnset,
     ) -> ProcessorConfig:
         """Create a new processor configuration.
 
@@ -390,11 +395,11 @@ class AsyncProcessors(AsyncAPIResource, ProcessorsMixin):
         json_schema: dict[str, Any] | Path | str,
         modality: Modality = "native",
         model: str = "gpt-4o-mini",
-        temperature: float = PydanticUndefined,  # type: ignore[assignment]
-        reasoning_effort: ChatCompletionReasoningEffort = PydanticUndefined,  # type: ignore[assignment]
-        image_resolution_dpi: int = PydanticUndefined,  # type: ignore[assignment]
-        browser_canvas: BrowserCanvas = PydanticUndefined,  # type: ignore[assignment]
-        n_consensus: int = PydanticUndefined,  # type: ignore[assignment]
+        temperature: float = FieldUnset,
+        reasoning_effort: ChatCompletionReasoningEffort = FieldUnset,
+        image_resolution_dpi: int = FieldUnset,
+        browser_canvas: BrowserCanvas = FieldUnset,
+        n_consensus: int = FieldUnset,
     ) -> ProcessorConfig:
         request = self.prepare_create(
             name=name,

retab/resources/usage.py

@@ -84,6 +84,7 @@ class Usage(SyncAPIResource, UsageMixin):
     def monthly_credits_usage(self) -> MonthlyUsageResponse:
         """
         Get monthly credits usage information.
+        Credits are calculated dynamically based on MIME type and consumption.
 
         Returns:
             dict: Monthly usage data including credits consumed and limits
@@ -198,6 +199,7 @@ class AsyncUsage(AsyncAPIResource, UsageMixin):
     async def monthly_credits_usage(self) -> MonthlyUsageResponse:
         """
         Get monthly credits usage information.
+        Credits are calculated dynamically based on MIME type and consumption.
 
         Returns:
             dict: Monthly usage data including credits consumed and limits

retab/types/ai_models.py

@@ -79,7 +79,7 @@ class FinetunedModel(BaseModel):
 
 # Monthly Usage
 class MonthlyUsageResponseContent(BaseModel):
-    request_count: int
+    credits_count: float  # Changed to float to support decimal credits
 
 
 MonthlyUsageResponse = MonthlyUsageResponseContent