llama-cloud 0.1.41__py3-none-any.whl → 1.0.0b4__py3-none-any.whl

llama_cloud/types/extraction/job_list_params.py

@@ -0,0 +1,11 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, TypedDict
+
+__all__ = ["JobListParams"]
+
+
+class JobListParams(TypedDict, total=False):
+    extraction_agent_id: Required[str]

llama_cloud/types/extraction/job_list_response.py

@@ -0,0 +1,10 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List
+from typing_extensions import TypeAlias
+
+from .extract_job import ExtractJob
+
+__all__ = ["JobListResponse"]
+
+JobListResponse: TypeAlias = List[ExtractJob]

llama_cloud/types/extraction/run_delete_params.py

@@ -0,0 +1,14 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+from typing_extensions import TypedDict
+
+__all__ = ["RunDeleteParams"]
+
+
+class RunDeleteParams(TypedDict, total=False):
+    organization_id: Optional[str]
+
+    project_id: Optional[str]

llama_cloud/types/extraction/run_get_by_job_params.py

@@ -0,0 +1,14 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+from typing_extensions import TypedDict
+
+__all__ = ["RunGetByJobParams"]
+
+
+class RunGetByJobParams(TypedDict, total=False):
+    organization_id: Optional[str]
+
+    project_id: Optional[str]

llama_cloud/types/extraction/run_get_params.py

@@ -0,0 +1,14 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+from typing_extensions import TypedDict
+
+__all__ = ["RunGetParams"]
+
+
+class RunGetParams(TypedDict, total=False):
+    organization_id: Optional[str]
+
+    project_id: Optional[str]

llama_cloud/types/extraction/run_list_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 Required, TypedDict
+
+__all__ = ["RunListParams"]
+
+
+class RunListParams(TypedDict, total=False):
+    extraction_agent_id: Required[str]
+
+    limit: int
+
+    skip: int

llama_cloud/types/extraction/webhook_configuration.py

@@ -0,0 +1,43 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Dict, List, Optional
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+
+__all__ = ["WebhookConfiguration"]
+
+
+class WebhookConfiguration(BaseModel):
+    """Allows the user to configure webhook options for notifications and callbacks."""
+
+    webhook_events: Optional[
+        List[
+            Literal[
+                "extract.pending",
+                "extract.success",
+                "extract.error",
+                "extract.partial_success",
+                "extract.cancelled",
+                "parse.pending",
+                "parse.success",
+                "parse.error",
+                "parse.partial_success",
+                "parse.cancelled",
+                "unmapped_event",
+            ]
+        ]
+    ] = None
+    """List of event names to subscribe to"""
+
+    webhook_headers: Optional[Dict[str, str]] = None
+    """Custom HTTP headers to include with webhook requests."""
+
+    webhook_output_format: Optional[str] = None
+    """The output format to use for the webhook.
+
+    Defaults to string if none supplied. Currently supported values: string, json
+    """
+
+    webhook_url: Optional[str] = None
+    """The URL to send webhook notifications to."""

llama_cloud/types/extraction/webhook_configuration_param.py

@@ -0,0 +1,43 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Dict, List, Optional
+from typing_extensions import Literal, TypedDict
+
+__all__ = ["WebhookConfigurationParam"]
+
+
+class WebhookConfigurationParam(TypedDict, total=False):
+    """Allows the user to configure webhook options for notifications and callbacks."""
+
+    webhook_events: Optional[
+        List[
+            Literal[
+                "extract.pending",
+                "extract.success",
+                "extract.error",
+                "extract.partial_success",
+                "extract.cancelled",
+                "parse.pending",
+                "parse.success",
+                "parse.error",
+                "parse.partial_success",
+                "parse.cancelled",
+                "unmapped_event",
+            ]
+        ]
+    ]
+    """List of event names to subscribe to"""
+
+    webhook_headers: Optional[Dict[str, str]]
+    """Custom HTTP headers to include with webhook requests."""
+
+    webhook_output_format: Optional[str]
+    """The output format to use for the webhook.
+
+    Defaults to string if none supplied. Currently supported values: string, json
+    """
+
+    webhook_url: Optional[str]
+    """The URL to send webhook notifications to."""

llama_cloud/types/extraction_run_params.py

@@ -0,0 +1,45 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Dict, Union, Iterable, Optional
+from typing_extensions import Required, TypedDict
+
+from .extraction.extract_config_param import ExtractConfigParam
+from .extraction.webhook_configuration_param import WebhookConfigurationParam
+
+__all__ = ["ExtractionRunParams", "File"]
+
+
+class ExtractionRunParams(TypedDict, total=False):
+    config: Required[ExtractConfigParam]
+    """The configuration parameters for the extraction"""
+
+    data_schema: Required[Union[Dict[str, Union[Dict[str, object], Iterable[object], str, float, bool, None]], str]]
+    """The schema of the data to extract"""
+
+    organization_id: Optional[str]
+
+    project_id: Optional[str]
+
+    file: Optional[File]
+    """Schema for file data with base64 content and MIME type."""
+
+    file_id: Optional[str]
+    """The ID of the file to extract from"""
+
+    text: Optional[str]
+    """The text content to extract from"""
+
+    webhook_configurations: Optional[Iterable[WebhookConfigurationParam]]
+    """The outbound webhook configurations"""
+
+
+class File(TypedDict, total=False):
+    """Schema for file data with base64 content and MIME type."""
+
+    data: Required[str]
+    """The file content as base64-encoded string"""
+
+    mime_type: Required[str]
+    """The MIME type of the file (e.g., 'application/pdf', 'text/plain')"""

llama_cloud/types/fail_page_mode.py

@@ -1,29 +1,7 @@
-# This file was auto-generated by Fern from our API Definition.
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import enum
-import typing
+from typing_extensions import Literal, TypeAlias
 
-T_Result = typing.TypeVar("T_Result")
+__all__ = ["FailPageMode"]
 
-
-class FailPageMode(str, enum.Enum):
-    """
-    Enum for representing the different available page error handling modes
-    """
-
-    RAW_TEXT = "raw_text"
-    BLANK_PAGE = "blank_page"
-    ERROR_MESSAGE = "error_message"
-
-    def visit(
-        self,
-        raw_text: typing.Callable[[], T_Result],
-        blank_page: typing.Callable[[], T_Result],
-        error_message: typing.Callable[[], T_Result],
-    ) -> T_Result:
-        if self is FailPageMode.RAW_TEXT:
-            return raw_text()
-        if self is FailPageMode.BLANK_PAGE:
-            return blank_page()
-        if self is FailPageMode.ERROR_MESSAGE:
-            return error_message()
+FailPageMode: TypeAlias = Literal["raw_text", "blank_page", "error_message"]

llama_cloud/types/file.py

@@ -1,48 +1,56 @@
-# This file was auto-generated by Fern from our API Definition.
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import datetime as dt
-import typing
+from typing import Dict, List, Union, Optional
+from datetime import datetime
 
-from ..core.datetime_utils import serialize_datetime
-from .file_permission_info_value import FilePermissionInfoValue
-from .file_resource_info_value import FileResourceInfoValue
+from .._models import BaseModel
 
-try:
-    import pydantic
-    if pydantic.__version__.startswith("1."):
-        raise ImportError
-    import pydantic.v1 as pydantic  # type: ignore
-except ImportError:
-    import pydantic  # type: ignore
+__all__ = ["File"]
 
 
-class File(pydantic.BaseModel):
+class File(BaseModel):
+    """Schema for a file."""
+
+    id: str
+    """Unique identifier"""
+
+    name: str
+
+    project_id: str
+    """The ID of the project that the file belongs to"""
+
+    created_at: Optional[datetime] = None
+    """Creation datetime"""
+
+    data_source_id: Optional[str] = None
+    """The ID of the data source that the file belongs to"""
+
+    expires_at: Optional[datetime] = None
+    """The expiration date for the file. Files past this date can be deleted."""
+
+    external_file_id: Optional[str] = None
+    """The ID of the file in the external system"""
+
+    file_size: Optional[int] = None
+    """Size of the file in bytes"""
+
+    file_type: Optional[str] = None
+    """File type (e.g. pdf, docx, etc.)"""
+
+    last_modified_at: Optional[datetime] = None
+    """The last modified time of the file"""
+
+    permission_info: Optional[Dict[str, Union[Dict[str, object], List[object], str, float, bool, None]]] = None
+    """Permission information for the file"""
+
+    purpose: Optional[str] = None
     """
-    Schema for a file.
+    The intended purpose of the file (e.g., 'user_data', 'parse', 'extract',
+    'split', 'classify')
     """
 
-    id: str = pydantic.Field(description="Unique identifier")
-    created_at: typing.Optional[dt.datetime]
-    updated_at: typing.Optional[dt.datetime]
-    name: str
-    external_file_id: typing.Optional[str]
-    file_size: typing.Optional[int]
-    file_type: typing.Optional[str]
-    project_id: str = pydantic.Field(description="The ID of the project that the file belongs to")
-    last_modified_at: typing.Optional[dt.datetime]
-    resource_info: typing.Optional[typing.Dict[str, typing.Optional[FileResourceInfoValue]]]
-    permission_info: typing.Optional[typing.Dict[str, typing.Optional[FilePermissionInfoValue]]]
-    data_source_id: typing.Optional[str]
-
-    def json(self, **kwargs: typing.Any) -> str:
-        kwargs_with_defaults: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}
-        return super().json(**kwargs_with_defaults)
-
-    def dict(self, **kwargs: typing.Any) -> typing.Dict[str, typing.Any]:
-        kwargs_with_defaults: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}
-        return super().dict(**kwargs_with_defaults)
-
-    class Config:
-        frozen = True
-        smart_union = True
-        json_encoders = {dt.datetime: serialize_datetime}
+    resource_info: Optional[Dict[str, Union[Dict[str, object], List[object], str, float, bool, None]]] = None
+    """Resource information for the file"""
+
+    updated_at: Optional[datetime] = None
+    """Update datetime"""

llama_cloud/types/file_create_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 Optional
+from typing_extensions import Required, TypedDict
+
+from .._types import FileTypes
+
+__all__ = ["FileCreateParams"]
+
+
+class FileCreateParams(TypedDict, total=False):
+    file: Required[FileTypes]
+    """The file to upload"""
+
+    purpose: Required[str]
+    """The intended purpose of the file.
+
+    Valid values: 'user_data', 'parse', 'extract', 'split', 'classify', 'sheet'
+    """
+
+    organization_id: Optional[str]
+
+    project_id: Optional[str]
+
+    external_file_id: Optional[str]
+    """The ID of the file in the external system"""

llama_cloud/types/file_create_response.py

@@ -0,0 +1,38 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from datetime import datetime
+
+from .._models import BaseModel
+
+__all__ = ["FileCreateResponse"]
+
+
+class FileCreateResponse(BaseModel):
+    """Schema for a file in the v2 API."""
+
+    id: str
+    """Unique identifier"""
+
+    name: str
+
+    project_id: str
+    """The ID of the project that the file belongs to"""
+
+    expires_at: Optional[datetime] = None
+    """The expiration date for the file. Files past this date can be deleted."""
+
+    external_file_id: Optional[str] = None
+    """The ID of the file in the external system"""
+
+    file_type: Optional[str] = None
+    """File type (e.g. pdf, docx, etc.)"""
+
+    last_modified_at: Optional[datetime] = None
+    """The last modified time of the file"""
+
+    purpose: Optional[str] = None
+    """
+    The intended purpose of the file (e.g., 'user_data', 'parse', 'extract',
+    'split', 'classify', 'sheet')
+    """

llama_cloud/types/file_delete_params.py

@@ -0,0 +1,14 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+from typing_extensions import TypedDict
+
+__all__ = ["FileDeleteParams"]
+
+
+class FileDeleteParams(TypedDict, total=False):
+    organization_id: Optional[str]
+
+    project_id: Optional[str]

llama_cloud/types/file_get_params.py

@@ -0,0 +1,16 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+from typing_extensions import TypedDict
+
+__all__ = ["FileGetParams"]
+
+
+class FileGetParams(TypedDict, total=False):
+    expires_at_seconds: Optional[int]
+
+    organization_id: Optional[str]
+
+    project_id: Optional[str]

llama_cloud/types/file_list_params.py

@@ -0,0 +1,40 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+from typing_extensions import TypedDict
+
+from .._types import SequenceNotStr
+
+__all__ = ["FileListParams"]
+
+
+class FileListParams(TypedDict, total=False):
+    external_file_id: Optional[str]
+    """Filter by external file ID."""
+
+    file_ids: Optional[SequenceNotStr[str]]
+    """Filter by specific file IDs."""
+
+    file_name: Optional[str]
+    """Filter by file name (exact match)."""
+
+    order_by: Optional[str]
+    """A comma-separated list of fields to order by, sorted in ascending order.
+
+    Use 'field_name desc' to specify descending order.
+    """
+
+    organization_id: Optional[str]
+
+    page_size: Optional[int]
+    """The maximum number of items to return. Defaults to 50, maximum is 1000."""
+
+    page_token: Optional[str]
+    """A page token received from a previous list call.
+
+    Provide this to retrieve the subsequent page.
+    """
+
+    project_id: Optional[str]

llama_cloud/types/file_list_response.py

@@ -0,0 +1,38 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from datetime import datetime
+
+from .._models import BaseModel
+
+__all__ = ["FileListResponse"]
+
+
+class FileListResponse(BaseModel):
+    """Schema for a file in the v2 API."""
+
+    id: str
+    """Unique identifier"""
+
+    name: str
+
+    project_id: str
+    """The ID of the project that the file belongs to"""
+
+    expires_at: Optional[datetime] = None
+    """The expiration date for the file. Files past this date can be deleted."""
+
+    external_file_id: Optional[str] = None
+    """The ID of the file in the external system"""
+
+    file_type: Optional[str] = None
+    """File type (e.g. pdf, docx, etc.)"""
+
+    last_modified_at: Optional[datetime] = None
+    """The last modified time of the file"""
+
+    purpose: Optional[str] = None
+    """
+    The intended purpose of the file (e.g., 'user_data', 'parse', 'extract',
+    'split', 'classify', 'sheet')
+    """

llama_cloud/types/file_query_params.py

@@ -0,0 +1,61 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+from typing_extensions import TypedDict
+
+from .._types import SequenceNotStr
+
+__all__ = ["FileQueryParams", "Filter"]
+
+
+class FileQueryParams(TypedDict, total=False):
+    organization_id: Optional[str]
+
+    project_id: Optional[str]
+
+    filter: Optional[Filter]
+    """Filter parameters for file queries."""
+
+    order_by: Optional[str]
+    """A comma-separated list of fields to order by, sorted in ascending order.
+
+    Use 'field_name desc' to specify descending order.
+    """
+
+    page_size: Optional[int]
+    """The maximum number of items to return.
+
+    The service may return fewer than this value. If unspecified, a default page
+    size will be used. The maximum value is typically 1000; values above this will
+    be coerced to the maximum.
+    """
+
+    page_token: Optional[str]
+    """A page token, received from a previous list call.
+
+    Provide this to retrieve the subsequent page.
+    """
+
+
+class Filter(TypedDict, total=False):
+    """Filter parameters for file queries."""
+
+    data_source_id: Optional[str]
+    """Filter by data source ID"""
+
+    external_file_id: Optional[str]
+    """Filter by external file ID"""
+
+    file_ids: Optional[SequenceNotStr[str]]
+    """Filter by specific file IDs"""
+
+    file_name: Optional[str]
+    """Filter by file name"""
+
+    only_manually_uploaded: Optional[bool]
+    """Filter only manually uploaded files (data_source_id is null)"""
+
+    project_id: Optional[str]
+    """Filter by project ID"""