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

llama_cloud/types/shared/cloud_jira_data_source.py

@@ -0,0 +1,30 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from ..._models import BaseModel
+
+__all__ = ["CloudJiraDataSource"]
+
+
+class CloudJiraDataSource(BaseModel):
+    """Cloud Jira Data Source integrating JiraReader."""
+
+    authentication_mechanism: str
+    """Type of Authentication for connecting to Jira APIs."""
+
+    query: str
+    """JQL (Jira Query Language) query to search."""
+
+    class_name: Optional[str] = None
+
+    cloud_id: Optional[str] = None
+    """The cloud ID, used in case of OAuth2."""
+
+    email: Optional[str] = None
+    """The email address to use for authentication."""
+
+    server_url: Optional[str] = None
+    """The server url for Jira Cloud."""
+
+    supports_access_control: Optional[bool] = None

llama_cloud/types/shared/cloud_jira_data_source_v2.py

@@ -0,0 +1,49 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+
+__all__ = ["CloudJiraDataSourceV2"]
+
+
+class CloudJiraDataSourceV2(BaseModel):
+    """Cloud Jira Data Source integrating JiraReaderV2."""
+
+    authentication_mechanism: str
+    """Type of Authentication for connecting to Jira APIs."""
+
+    query: str
+    """JQL (Jira Query Language) query to search."""
+
+    server_url: str
+    """The server url for Jira Cloud."""
+
+    api_version: Optional[Literal["2", "3"]] = None
+    """Jira REST API version to use (2 or 3).
+
+    3 supports Atlassian Document Format (ADF).
+    """
+
+    class_name: Optional[str] = None
+
+    cloud_id: Optional[str] = None
+    """The cloud ID, used in case of OAuth2."""
+
+    email: Optional[str] = None
+    """The email address to use for authentication."""
+
+    expand: Optional[str] = None
+    """Fields to expand in the response."""
+
+    fields: Optional[List[str]] = None
+    """List of fields to retrieve from Jira. If None, retrieves all fields."""
+
+    get_permissions: Optional[bool] = None
+    """Whether to fetch project role permissions and issue-level security"""
+
+    requests_per_minute: Optional[int] = None
+    """Rate limit for Jira API requests per minute."""
+
+    supports_access_control: Optional[bool] = None

llama_cloud/types/shared/cloud_milvus_vector_store.py

@@ -0,0 +1,21 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from ..._models import BaseModel
+
+__all__ = ["CloudMilvusVectorStore"]
+
+
+class CloudMilvusVectorStore(BaseModel):
+    """Cloud Milvus Vector Store."""
+
+    uri: str
+
+    class_name: Optional[str] = None
+
+    collection_name: Optional[str] = None
+
+    embedding_dimension: Optional[int] = None
+
+    supports_nested_metadata_filters: Optional[bool] = None

llama_cloud/types/shared/cloud_mongodb_atlas_vector_search.py

@@ -0,0 +1,36 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from ..._models import BaseModel
+
+__all__ = ["CloudMongoDBAtlasVectorSearch"]
+
+
+class CloudMongoDBAtlasVectorSearch(BaseModel):
+    """Cloud MongoDB Atlas Vector Store.
+
+    This class is used to store the configuration for a MongoDB Atlas vector store,
+    so that it can be created and used in LlamaCloud.
+
+    Args:
+        mongodb_uri (str): URI for connecting to MongoDB Atlas
+        db_name (str): name of the MongoDB database
+        collection_name (str): name of the MongoDB collection
+        vector_index_name (str): name of the MongoDB Atlas vector index
+        fulltext_index_name (str): name of the MongoDB Atlas full-text index
+    """
+
+    collection_name: str
+
+    db_name: str
+
+    class_name: Optional[str] = None
+
+    embedding_dimension: Optional[int] = None
+
+    fulltext_index_name: Optional[str] = None
+
+    supports_nested_metadata_filters: Optional[bool] = None
+
+    vector_index_name: Optional[str] = None

llama_cloud/types/shared/cloud_notion_page_data_source.py

@@ -0,0 +1,19 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from ..._models import BaseModel
+
+__all__ = ["CloudNotionPageDataSource"]
+
+
+class CloudNotionPageDataSource(BaseModel):
+    class_name: Optional[str] = None
+
+    database_ids: Optional[str] = None
+    """The Notion Database Id to read content from."""
+
+    page_ids: Optional[str] = None
+    """The Page ID's of the Notion to read from."""
+
+    supports_access_control: Optional[bool] = None

llama_cloud/types/shared/cloud_one_drive_data_source.py

@@ -0,0 +1,32 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+
+__all__ = ["CloudOneDriveDataSource"]
+
+
+class CloudOneDriveDataSource(BaseModel):
+    client_id: str
+    """The client ID to use for authentication."""
+
+    tenant_id: str
+    """The tenant ID to use for authentication."""
+
+    user_principal_name: str
+    """The user principal name to use for authentication."""
+
+    class_name: Optional[str] = None
+
+    folder_id: Optional[str] = None
+    """The ID of the OneDrive folder to read from."""
+
+    folder_path: Optional[str] = None
+    """The path of the OneDrive folder to read from."""
+
+    required_exts: Optional[List[str]] = None
+    """The list of required file extensions."""
+
+    supports_access_control: Optional[Literal[True]] = None

llama_cloud/types/shared/cloud_pinecone_vector_store.py

@@ -0,0 +1,32 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Dict, Optional
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+
+__all__ = ["CloudPineconeVectorStore"]
+
+
+class CloudPineconeVectorStore(BaseModel):
+    """Cloud Pinecone Vector Store.
+
+    This class is used to store the configuration for a Pinecone vector store, so that it can be
+    created and used in LlamaCloud.
+
+    Args:
+        api_key (str): API key for authenticating with Pinecone
+        index_name (str): name of the Pinecone index
+        namespace (optional[str]): namespace to use in the Pinecone index
+        insert_kwargs (optional[dict]): additional kwargs to pass during insertion
+    """
+
+    index_name: str
+
+    class_name: Optional[str] = None
+
+    insert_kwargs: Optional[Dict[str, object]] = None
+
+    namespace: Optional[str] = None
+
+    supports_nested_metadata_filters: Optional[Literal[True]] = None

llama_cloud/types/shared/cloud_postgres_vector_store.py

@@ -0,0 +1,35 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from ..._models import BaseModel
+from .pg_vector_hnsw_settings import PgVectorHnswSettings
+
+__all__ = ["CloudPostgresVectorStore"]
+
+
+class CloudPostgresVectorStore(BaseModel):
+    database: str
+
+    embed_dim: int
+
+    host: str
+
+    port: int
+
+    schema_name: str
+
+    table_name: str
+
+    user: str
+
+    class_name: Optional[str] = None
+
+    hnsw_settings: Optional[PgVectorHnswSettings] = None
+    """HNSW settings for PGVector."""
+
+    hybrid_search: Optional[bool] = None
+
+    perform_setup: Optional[bool] = None
+
+    supports_nested_metadata_filters: Optional[bool] = None

llama_cloud/types/shared/cloud_qdrant_vector_store.py

@@ -0,0 +1,35 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Dict, Optional
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+
+__all__ = ["CloudQdrantVectorStore"]
+
+
+class CloudQdrantVectorStore(BaseModel):
+    """Cloud Qdrant Vector Store.
+
+    This class is used to store the configuration for a Qdrant vector store, so that it can be
+    created and used in LlamaCloud.
+
+    Args:
+        collection_name (str): name of the Qdrant collection
+        url (str): url of the Qdrant instance
+        api_key (str): API key for authenticating with Qdrant
+        max_retries (int): maximum number of retries in case of a failure. Defaults to 3
+        client_kwargs (dict): additional kwargs to pass to the Qdrant client
+    """
+
+    collection_name: str
+
+    url: str
+
+    class_name: Optional[str] = None
+
+    client_kwargs: Optional[Dict[str, object]] = None
+
+    max_retries: Optional[int] = None
+
+    supports_nested_metadata_filters: Optional[Literal[True]] = None

llama_cloud/types/shared/cloud_s3_data_source.py

@@ -0,0 +1,28 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from ..._models import BaseModel
+
+__all__ = ["CloudS3DataSource"]
+
+
+class CloudS3DataSource(BaseModel):
+    bucket: str
+    """The name of the S3 bucket to read from."""
+
+    aws_access_id: Optional[str] = None
+    """The AWS access ID to use for authentication."""
+
+    class_name: Optional[str] = None
+
+    prefix: Optional[str] = None
+    """The prefix of the S3 objects to read from."""
+
+    regex_pattern: Optional[str] = None
+    """The regex pattern to filter S3 objects. Must be a valid regex pattern."""
+
+    s3_endpoint_url: Optional[str] = None
+    """The S3 endpoint URL to use for authentication."""
+
+    supports_access_control: Optional[bool] = None

llama_cloud/types/shared/cloud_sharepoint_data_source.py

@@ -0,0 +1,55 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+
+__all__ = ["CloudSharepointDataSource"]
+
+
+class CloudSharepointDataSource(BaseModel):
+    client_id: str
+    """The client ID to use for authentication."""
+
+    tenant_id: str
+    """The tenant ID to use for authentication."""
+
+    class_name: Optional[str] = None
+
+    drive_name: Optional[str] = None
+    """The name of the Sharepoint drive to read from."""
+
+    exclude_path_patterns: Optional[List[str]] = None
+    """List of regex patterns for file paths to exclude.
+
+    Files whose paths (including filename) match any pattern will be excluded.
+    Example: ['/temp/', '/backup/', '\\..git/', '\\..tmp$', '^~']
+    """
+
+    folder_id: Optional[str] = None
+    """The ID of the Sharepoint folder to read from."""
+
+    folder_path: Optional[str] = None
+    """The path of the Sharepoint folder to read from."""
+
+    get_permissions: Optional[bool] = None
+    """Whether to get permissions for the sharepoint site."""
+
+    include_path_patterns: Optional[List[str]] = None
+    """List of regex patterns for file paths to include.
+
+    Full paths (including filename) must match at least one pattern to be included.
+    Example: ['/reports/', '/docs/.*\\..pdf$', '^Report.*\\..pdf$']
+    """
+
+    required_exts: Optional[List[str]] = None
+    """The list of required file extensions."""
+
+    site_id: Optional[str] = None
+    """The ID of the SharePoint site to download from."""
+
+    site_name: Optional[str] = None
+    """The name of the SharePoint site to download from."""
+
+    supports_access_control: Optional[Literal[True]] = None

llama_cloud/types/shared/cloud_slack_data_source.py

@@ -0,0 +1,31 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from ..._models import BaseModel
+
+__all__ = ["CloudSlackDataSource"]
+
+
+class CloudSlackDataSource(BaseModel):
+    channel_ids: Optional[str] = None
+    """Slack Channel."""
+
+    channel_patterns: Optional[str] = None
+    """Slack Channel name pattern."""
+
+    class_name: Optional[str] = None
+
+    earliest_date: Optional[str] = None
+    """Earliest date."""
+
+    earliest_date_timestamp: Optional[float] = None
+    """Earliest date timestamp."""
+
+    latest_date: Optional[str] = None
+    """Latest date."""
+
+    latest_date_timestamp: Optional[float] = None
+    """Latest date timestamp."""
+
+    supports_access_control: Optional[bool] = None

llama_cloud/types/shared/failure_handling_config.py

@@ -0,0 +1,16 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from ..._models import BaseModel
+
+__all__ = ["FailureHandlingConfig"]
+
+
+class FailureHandlingConfig(BaseModel):
+    """
+    Configuration for handling different types of failures during data source processing.
+    """
+
+    skip_list_failures: Optional[bool] = None
+    """Whether to skip failed batches/lists and continue processing"""

llama_cloud/types/shared/pg_vector_hnsw_settings.py

@@ -0,0 +1,27 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+
+__all__ = ["PgVectorHnswSettings"]
+
+
+class PgVectorHnswSettings(BaseModel):
+    """HNSW settings for PGVector."""
+
+    distance_method: Optional[Literal["l2", "ip", "cosine", "l1", "hamming", "jaccard"]] = None
+    """The distance method to use."""
+
+    ef_construction: Optional[int] = None
+    """The number of edges to use during the construction phase."""
+
+    ef_search: Optional[int] = None
+    """The number of edges to use during the search phase."""
+
+    m: Optional[int] = None
+    """The number of bi-directional links created for each new element."""
+
+    vector_type: Optional[Literal["vector", "half_vec", "bit", "sparse_vec"]] = None
+    """The type of vector to use."""

llama_cloud/types/shared_params/__init__.py

@@ -0,0 +1,21 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from .cloud_s3_data_source import CloudS3DataSource as CloudS3DataSource
+from .cloud_box_data_source import CloudBoxDataSource as CloudBoxDataSource
+from .cloud_jira_data_source import CloudJiraDataSource as CloudJiraDataSource
+from .cloud_slack_data_source import CloudSlackDataSource as CloudSlackDataSource
+from .failure_handling_config import FailureHandlingConfig as FailureHandlingConfig
+from .pg_vector_hnsw_settings import PgVectorHnswSettings as PgVectorHnswSettings
+from .cloud_jira_data_source_v2 import CloudJiraDataSourceV2 as CloudJiraDataSourceV2
+from .cloud_milvus_vector_store import CloudMilvusVectorStore as CloudMilvusVectorStore
+from .cloud_qdrant_vector_store import CloudQdrantVectorStore as CloudQdrantVectorStore
+from .cloud_astra_db_vector_store import CloudAstraDBVectorStore as CloudAstraDBVectorStore
+from .cloud_one_drive_data_source import CloudOneDriveDataSource as CloudOneDriveDataSource
+from .cloud_pinecone_vector_store import CloudPineconeVectorStore as CloudPineconeVectorStore
+from .cloud_postgres_vector_store import CloudPostgresVectorStore as CloudPostgresVectorStore
+from .cloud_confluence_data_source import CloudConfluenceDataSource as CloudConfluenceDataSource
+from .cloud_sharepoint_data_source import CloudSharepointDataSource as CloudSharepointDataSource
+from .cloud_notion_page_data_source import CloudNotionPageDataSource as CloudNotionPageDataSource
+from .cloud_az_storage_blob_data_source import CloudAzStorageBlobDataSource as CloudAzStorageBlobDataSource
+from .cloud_mongodb_atlas_vector_search import CloudMongoDBAtlasVectorSearch as CloudMongoDBAtlasVectorSearch
+from .cloud_azure_ai_search_vector_store import CloudAzureAISearchVectorStore as CloudAzureAISearchVectorStore

llama_cloud/types/shared_params/cloud_astra_db_vector_store.py

@@ -0,0 +1,42 @@
+# 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 Literal, Required, TypedDict
+
+__all__ = ["CloudAstraDBVectorStore"]
+
+
+class CloudAstraDBVectorStore(TypedDict, total=False):
+    """Cloud AstraDB Vector Store.
+
+    This class is used to store the configuration for an AstraDB vector store, so that it can be
+    created and used in LlamaCloud.
+
+    Args:
+        token (str): The Astra DB Application Token to use.
+        api_endpoint (str): The Astra DB JSON API endpoint for your database.
+        collection_name (str): Collection name to use. If not existing, it will be created.
+        embedding_dimension (int): Length of the embedding vectors in use.
+        keyspace (optional[str]): The keyspace to use. If not provided, 'default_keyspace'
+    """
+
+    token: Required[str]
+    """The Astra DB Application Token to use"""
+
+    api_endpoint: Required[str]
+    """The Astra DB JSON API endpoint for your database"""
+
+    collection_name: Required[str]
+    """Collection name to use. If not existing, it will be created"""
+
+    embedding_dimension: Required[int]
+    """Length of the embedding vectors in use"""
+
+    class_name: str
+
+    keyspace: Optional[str]
+    """The keyspace to use. If not provided, 'default_keyspace'"""
+
+    supports_nested_metadata_filters: Literal[True]

llama_cloud/types/shared_params/cloud_az_storage_blob_data_source.py

@@ -0,0 +1,41 @@
+# 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
+
+__all__ = ["CloudAzStorageBlobDataSource"]
+
+
+class CloudAzStorageBlobDataSource(TypedDict, total=False):
+    account_url: Required[str]
+    """The Azure Storage Blob account URL to use for authentication."""
+
+    container_name: Required[str]
+    """The name of the Azure Storage Blob container to read from."""
+
+    account_key: Optional[str]
+    """The Azure Storage Blob account key to use for authentication."""
+
+    account_name: Optional[str]
+    """The Azure Storage Blob account name to use for authentication."""
+
+    blob: Optional[str]
+    """The blob name to read from."""
+
+    class_name: str
+
+    client_id: Optional[str]
+    """The Azure AD client ID to use for authentication."""
+
+    client_secret: Optional[str]
+    """The Azure AD client secret to use for authentication."""
+
+    prefix: Optional[str]
+    """The prefix of the Azure Storage Blob objects to read from."""
+
+    supports_access_control: bool
+
+    tenant_id: Optional[str]
+    """The Azure AD tenant ID to use for authentication."""

llama_cloud/types/shared_params/cloud_azure_ai_search_vector_store.py

@@ -0,0 +1,34 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Dict, Optional
+from typing_extensions import Literal, Required, TypedDict
+
+__all__ = ["CloudAzureAISearchVectorStore"]
+
+
+class CloudAzureAISearchVectorStore(TypedDict, total=False):
+    """Cloud Azure AI Search Vector Store."""
+
+    search_service_api_key: Required[str]
+
+    search_service_endpoint: Required[str]
+
+    class_name: str
+
+    client_id: Optional[str]
+
+    client_secret: Optional[str]
+
+    embedding_dimension: Optional[int]
+
+    filterable_metadata_field_keys: Optional[Dict[str, object]]
+
+    index_name: Optional[str]
+
+    search_service_api_version: Optional[str]
+
+    supports_nested_metadata_filters: Literal[True]
+
+    tenant_id: Optional[str]

llama_cloud/types/shared_params/cloud_box_data_source.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 Literal, Required, TypedDict
+
+__all__ = ["CloudBoxDataSource"]
+
+
+class CloudBoxDataSource(TypedDict, total=False):
+    authentication_mechanism: Required[Literal["developer_token", "ccg"]]
+    """The type of authentication to use (Developer Token or CCG)"""
+
+    class_name: str
+
+    client_id: Optional[str]
+    """
+    Box API key used for identifying the application the user is authenticating with
+    """
+
+    client_secret: Optional[str]
+    """Box API secret used for making auth requests."""
+
+    developer_token: Optional[str]
+    """
+    Developer token for authentication if authentication_mechanism is
+    'developer_token'.
+    """
+
+    enterprise_id: Optional[str]
+    """Box Enterprise ID, if provided authenticates as service."""
+
+    folder_id: Optional[str]
+    """The ID of the Box folder to read from."""
+
+    supports_access_control: bool
+
+    user_id: Optional[str]
+    """Box User ID, if provided authenticates as user."""