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

llama_cloud/types/composite_retrieval_result.py

@@ -1,42 +1,57 @@
-# 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, Optional
 
-from ..core.datetime_utils import serialize_datetime
-from .composite_retrieved_text_node_with_score import CompositeRetrievedTextNodeWithScore
+from .._models import BaseModel
 from .page_figure_node_with_score import PageFigureNodeWithScore
 from .page_screenshot_node_with_score import PageScreenshotNodeWithScore
 
-try:
-    import pydantic
-    if pydantic.__version__.startswith("1."):
-        raise ImportError
-    import pydantic.v1 as pydantic  # type: ignore
-except ImportError:
-    import pydantic  # type: ignore
-
-
-class CompositeRetrievalResult(pydantic.BaseModel):
-    nodes: typing.Optional[typing.List[CompositeRetrievedTextNodeWithScore]] = pydantic.Field(
-        description="The retrieved nodes from the composite retrieval."
-    )
-    image_nodes: typing.Optional[typing.List[PageScreenshotNodeWithScore]] = pydantic.Field(
-        description="The image nodes retrieved by the pipeline for the given query. Deprecated - will soon be replaced with 'page_screenshot_nodes'."
-    )
-    page_figure_nodes: typing.Optional[typing.List[PageFigureNodeWithScore]] = pydantic.Field(
-        description="The page figure nodes retrieved by the pipeline for the given query."
-    )
-
-    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}
+__all__ = ["CompositeRetrievalResult", "Node", "NodeNode"]
+
+
+class NodeNode(BaseModel):
+    id: str
+    """The ID of the retrieved node."""
+
+    end_char_idx: Optional[int] = None
+    """The end character index of the retrieved node in the document"""
+
+    pipeline_id: str
+    """The ID of the pipeline this node was retrieved from."""
+
+    retriever_id: str
+    """The ID of the retriever this node was retrieved from."""
+
+    retriever_pipeline_name: str
+    """The name of the retrieval pipeline this node was retrieved from."""
+
+    start_char_idx: Optional[int] = None
+    """The start character index of the retrieved node in the document"""
+
+    text: str
+    """The text of the retrieved node."""
+
+    metadata: Optional[Dict[str, object]] = None
+    """Metadata associated with the retrieved node."""
+
+
+class Node(BaseModel):
+    node: NodeNode
+
+    class_name: Optional[str] = None
+
+    score: Optional[float] = None
+
+
+class CompositeRetrievalResult(BaseModel):
+    image_nodes: Optional[List[PageScreenshotNodeWithScore]] = None
+    """The image nodes retrieved by the pipeline for the given query.
+
+    Deprecated - will soon be replaced with 'page_screenshot_nodes'.
+    """
+
+    nodes: Optional[List[Node]] = None
+    """The retrieved nodes from the composite retrieval."""
+
+    page_figure_nodes: Optional[List[PageFigureNodeWithScore]] = None
+    """The page figure nodes retrieved by the pipeline for the given query."""

llama_cloud/types/data_sink.py

@@ -1,43 +1,50 @@
-# This file was auto-generated by Fern from our API Definition.
-
-import datetime as dt
-import typing
-
-from ..core.datetime_utils import serialize_datetime
-from .configurable_data_sink_names import ConfigurableDataSinkNames
-from .data_sink_component import DataSinkComponent
-
-try:
-    import pydantic
-    if pydantic.__version__.startswith("1."):
-        raise ImportError
-    import pydantic.v1 as pydantic  # type: ignore
-except ImportError:
-    import pydantic  # type: ignore
-
-
-class DataSink(pydantic.BaseModel):
-    """
-    Schema for a data sink.
-    """
-
-    id: str = pydantic.Field(description="Unique identifier")
-    created_at: typing.Optional[dt.datetime]
-    updated_at: typing.Optional[dt.datetime]
-    name: str = pydantic.Field(description="The name of the data sink.")
-    sink_type: ConfigurableDataSinkNames
-    component: DataSinkComponent = pydantic.Field(description="Component that implements the data sink")
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Dict, Union, Optional
+from datetime import datetime
+from typing_extensions import Literal, TypeAlias
+
+from .._models import BaseModel
+from .shared.cloud_milvus_vector_store import CloudMilvusVectorStore
+from .shared.cloud_qdrant_vector_store import CloudQdrantVectorStore
+from .shared.cloud_astra_db_vector_store import CloudAstraDBVectorStore
+from .shared.cloud_pinecone_vector_store import CloudPineconeVectorStore
+from .shared.cloud_postgres_vector_store import CloudPostgresVectorStore
+from .shared.cloud_mongodb_atlas_vector_search import CloudMongoDBAtlasVectorSearch
+from .shared.cloud_azure_ai_search_vector_store import CloudAzureAISearchVectorStore
+
+__all__ = ["DataSink", "Component"]
+
+Component: TypeAlias = Union[
+    Dict[str, object],
+    CloudPineconeVectorStore,
+    CloudPostgresVectorStore,
+    CloudQdrantVectorStore,
+    CloudAzureAISearchVectorStore,
+    CloudMongoDBAtlasVectorSearch,
+    CloudMilvusVectorStore,
+    CloudAstraDBVectorStore,
+]
+
+
+class DataSink(BaseModel):
+    """Schema for a data sink."""
+
+    id: str
+    """Unique identifier"""
+
+    component: Component
+    """Component that implements the data sink"""
+
+    name: str
+    """The name of the data sink."""
+
     project_id: 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)
+    sink_type: Literal["PINECONE", "POSTGRES", "QDRANT", "AZUREAI_SEARCH", "MONGODB_ATLAS", "MILVUS", "ASTRA_DB"]
 
-    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)
+    created_at: Optional[datetime] = None
+    """Creation datetime"""
 
-    class Config:
-        frozen = True
-        smart_union = True
-        json_encoders = {dt.datetime: serialize_datetime}
+    updated_at: Optional[datetime] = None
+    """Update datetime"""

llama_cloud/types/data_sink_create_param.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 Dict, Union
+from typing_extensions import Literal, Required, TypeAlias, TypedDict
+
+from .shared_params.cloud_milvus_vector_store import CloudMilvusVectorStore
+from .shared_params.cloud_qdrant_vector_store import CloudQdrantVectorStore
+from .shared_params.cloud_astra_db_vector_store import CloudAstraDBVectorStore
+from .shared_params.cloud_pinecone_vector_store import CloudPineconeVectorStore
+from .shared_params.cloud_postgres_vector_store import CloudPostgresVectorStore
+from .shared_params.cloud_mongodb_atlas_vector_search import CloudMongoDBAtlasVectorSearch
+from .shared_params.cloud_azure_ai_search_vector_store import CloudAzureAISearchVectorStore
+
+__all__ = ["DataSinkCreateParam", "Component"]
+
+Component: TypeAlias = Union[
+    Dict[str, object],
+    CloudPineconeVectorStore,
+    CloudPostgresVectorStore,
+    CloudQdrantVectorStore,
+    CloudAzureAISearchVectorStore,
+    CloudMongoDBAtlasVectorSearch,
+    CloudMilvusVectorStore,
+    CloudAstraDBVectorStore,
+]
+
+
+class DataSinkCreateParam(TypedDict, total=False):
+    """Schema for creating a data sink."""
+
+    component: Required[Component]
+    """Component that implements the data sink"""
+
+    name: Required[str]
+    """The name of the data sink."""
+
+    sink_type: Required[
+        Literal["PINECONE", "POSTGRES", "QDRANT", "AZUREAI_SEARCH", "MONGODB_ATLAS", "MILVUS", "ASTRA_DB"]
+    ]

llama_cloud/types/data_sink_create_params.py

@@ -0,0 +1,44 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Dict, Union, Optional
+from typing_extensions import Literal, Required, TypeAlias, TypedDict
+
+from .shared_params.cloud_milvus_vector_store import CloudMilvusVectorStore
+from .shared_params.cloud_qdrant_vector_store import CloudQdrantVectorStore
+from .shared_params.cloud_astra_db_vector_store import CloudAstraDBVectorStore
+from .shared_params.cloud_pinecone_vector_store import CloudPineconeVectorStore
+from .shared_params.cloud_postgres_vector_store import CloudPostgresVectorStore
+from .shared_params.cloud_mongodb_atlas_vector_search import CloudMongoDBAtlasVectorSearch
+from .shared_params.cloud_azure_ai_search_vector_store import CloudAzureAISearchVectorStore
+
+__all__ = ["DataSinkCreateParams", "Component"]
+
+
+class DataSinkCreateParams(TypedDict, total=False):
+    component: Required[Component]
+    """Component that implements the data sink"""
+
+    name: Required[str]
+    """The name of the data sink."""
+
+    sink_type: Required[
+        Literal["PINECONE", "POSTGRES", "QDRANT", "AZUREAI_SEARCH", "MONGODB_ATLAS", "MILVUS", "ASTRA_DB"]
+    ]
+
+    organization_id: Optional[str]
+
+    project_id: Optional[str]
+
+
+Component: TypeAlias = Union[
+    Dict[str, object],
+    CloudPineconeVectorStore,
+    CloudPostgresVectorStore,
+    CloudQdrantVectorStore,
+    CloudAzureAISearchVectorStore,
+    CloudMongoDBAtlasVectorSearch,
+    CloudMilvusVectorStore,
+    CloudAstraDBVectorStore,
+]

llama_cloud/types/data_sink_list_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__ = ["DataSinkListParams"]
+
+
+class DataSinkListParams(TypedDict, total=False):
+    organization_id: Optional[str]
+
+    project_id: Optional[str]

llama_cloud/types/data_sink_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 .data_sink import DataSink
+
+__all__ = ["DataSinkListResponse"]
+
+DataSinkListResponse: TypeAlias = List[DataSink]

llama_cloud/types/data_sink_update_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 Dict, Union, Optional
+from typing_extensions import Literal, Required, TypeAlias, TypedDict
+
+from .shared_params.cloud_milvus_vector_store import CloudMilvusVectorStore
+from .shared_params.cloud_qdrant_vector_store import CloudQdrantVectorStore
+from .shared_params.cloud_astra_db_vector_store import CloudAstraDBVectorStore
+from .shared_params.cloud_pinecone_vector_store import CloudPineconeVectorStore
+from .shared_params.cloud_postgres_vector_store import CloudPostgresVectorStore
+from .shared_params.cloud_mongodb_atlas_vector_search import CloudMongoDBAtlasVectorSearch
+from .shared_params.cloud_azure_ai_search_vector_store import CloudAzureAISearchVectorStore
+
+__all__ = ["DataSinkUpdateParams", "Component"]
+
+
+class DataSinkUpdateParams(TypedDict, total=False):
+    sink_type: Required[
+        Literal["PINECONE", "POSTGRES", "QDRANT", "AZUREAI_SEARCH", "MONGODB_ATLAS", "MILVUS", "ASTRA_DB"]
+    ]
+
+    component: Optional[Component]
+    """Component that implements the data sink"""
+
+    name: Optional[str]
+    """The name of the data sink."""
+
+
+Component: TypeAlias = Union[
+    Dict[str, object],
+    CloudPineconeVectorStore,
+    CloudPostgresVectorStore,
+    CloudQdrantVectorStore,
+    CloudAzureAISearchVectorStore,
+    CloudMongoDBAtlasVectorSearch,
+    CloudMilvusVectorStore,
+    CloudAstraDBVectorStore,
+]

llama_cloud/types/data_source.py

@@ -1,47 +1,75 @@
-# 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 typing_extensions import Literal, TypeAlias
 
-from ..core.datetime_utils import serialize_datetime
-from .configurable_data_source_names import ConfigurableDataSourceNames
-from .data_source_component import DataSourceComponent
-from .data_source_custom_metadata_value import DataSourceCustomMetadataValue
+from .._models import BaseModel
+from .shared.cloud_s3_data_source import CloudS3DataSource
+from .shared.cloud_box_data_source import CloudBoxDataSource
+from .shared.cloud_jira_data_source import CloudJiraDataSource
+from .shared.cloud_slack_data_source import CloudSlackDataSource
+from .shared.cloud_jira_data_source_v2 import CloudJiraDataSourceV2
+from .shared.cloud_one_drive_data_source import CloudOneDriveDataSource
 from .data_source_reader_version_metadata import DataSourceReaderVersionMetadata
+from .shared.cloud_confluence_data_source import CloudConfluenceDataSource
+from .shared.cloud_sharepoint_data_source import CloudSharepointDataSource
+from .shared.cloud_notion_page_data_source import CloudNotionPageDataSource
+from .shared.cloud_az_storage_blob_data_source import CloudAzStorageBlobDataSource
+
+__all__ = ["DataSource", "Component"]
+
+Component: TypeAlias = Union[
+    Dict[str, object],
+    CloudS3DataSource,
+    CloudAzStorageBlobDataSource,
+    CloudOneDriveDataSource,
+    CloudSharepointDataSource,
+    CloudSlackDataSource,
+    CloudNotionPageDataSource,
+    CloudConfluenceDataSource,
+    CloudJiraDataSource,
+    CloudJiraDataSourceV2,
+    CloudBoxDataSource,
+]
+
+
+class DataSource(BaseModel):
+    """Schema for a data source."""
+
+    id: str
+    """Unique identifier"""
+
+    component: Component
+    """Component that implements the data source"""
+
+    name: str
+    """The name of the data source."""
 
-try:
-    import pydantic
-    if pydantic.__version__.startswith("1."):
-        raise ImportError
-    import pydantic.v1 as pydantic  # type: ignore
-except ImportError:
-    import pydantic  # type: ignore
-
-
-class DataSource(pydantic.BaseModel):
-    """
-    Schema for a data source.
-    """
-
-    id: str = pydantic.Field(description="Unique identifier")
-    created_at: typing.Optional[dt.datetime]
-    updated_at: typing.Optional[dt.datetime]
-    name: str = pydantic.Field(description="The name of the data source.")
-    source_type: ConfigurableDataSourceNames
-    custom_metadata: typing.Optional[typing.Dict[str, typing.Optional[DataSourceCustomMetadataValue]]]
-    component: DataSourceComponent = pydantic.Field(description="Component that implements the data source")
-    version_metadata: typing.Optional[DataSourceReaderVersionMetadata]
     project_id: 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)
+    source_type: Literal[
+        "S3",
+        "AZURE_STORAGE_BLOB",
+        "GOOGLE_DRIVE",
+        "MICROSOFT_ONEDRIVE",
+        "MICROSOFT_SHAREPOINT",
+        "SLACK",
+        "NOTION_PAGE",
+        "CONFLUENCE",
+        "JIRA",
+        "JIRA_V2",
+        "BOX",
+    ]
+
+    created_at: Optional[datetime] = None
+    """Creation datetime"""
+
+    custom_metadata: Optional[Dict[str, Union[Dict[str, object], List[object], str, float, bool, None]]] = None
+    """Custom metadata that will be present on all data loaded from the data source"""
 
-    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)
+    updated_at: Optional[datetime] = None
+    """Update datetime"""
 
-    class Config:
-        frozen = True
-        smart_union = True
-        json_encoders = {dt.datetime: serialize_datetime}
+    version_metadata: Optional[DataSourceReaderVersionMetadata] = None
+    """Version metadata for the data source"""

llama_cloud/types/data_source_create_params.py

@@ -0,0 +1,65 @@
+# 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 Literal, Required, TypeAlias, TypedDict
+
+from .shared_params.cloud_s3_data_source import CloudS3DataSource
+from .shared_params.cloud_box_data_source import CloudBoxDataSource
+from .shared_params.cloud_jira_data_source import CloudJiraDataSource
+from .shared_params.cloud_slack_data_source import CloudSlackDataSource
+from .shared_params.cloud_jira_data_source_v2 import CloudJiraDataSourceV2
+from .shared_params.cloud_one_drive_data_source import CloudOneDriveDataSource
+from .shared_params.cloud_confluence_data_source import CloudConfluenceDataSource
+from .shared_params.cloud_sharepoint_data_source import CloudSharepointDataSource
+from .shared_params.cloud_notion_page_data_source import CloudNotionPageDataSource
+from .shared_params.cloud_az_storage_blob_data_source import CloudAzStorageBlobDataSource
+
+__all__ = ["DataSourceCreateParams", "Component"]
+
+
+class DataSourceCreateParams(TypedDict, total=False):
+    component: Required[Component]
+    """Component that implements the data source"""
+
+    name: Required[str]
+    """The name of the data source."""
+
+    source_type: Required[
+        Literal[
+            "S3",
+            "AZURE_STORAGE_BLOB",
+            "GOOGLE_DRIVE",
+            "MICROSOFT_ONEDRIVE",
+            "MICROSOFT_SHAREPOINT",
+            "SLACK",
+            "NOTION_PAGE",
+            "CONFLUENCE",
+            "JIRA",
+            "JIRA_V2",
+            "BOX",
+        ]
+    ]
+
+    organization_id: Optional[str]
+
+    project_id: Optional[str]
+
+    custom_metadata: Optional[Dict[str, Union[Dict[str, object], Iterable[object], str, float, bool, None]]]
+    """Custom metadata that will be present on all data loaded from the data source"""
+
+
+Component: TypeAlias = Union[
+    Dict[str, object],
+    CloudS3DataSource,
+    CloudAzStorageBlobDataSource,
+    CloudOneDriveDataSource,
+    CloudSharepointDataSource,
+    CloudSlackDataSource,
+    CloudNotionPageDataSource,
+    CloudConfluenceDataSource,
+    CloudJiraDataSource,
+    CloudJiraDataSourceV2,
+    CloudBoxDataSource,
+]

llama_cloud/types/data_source_list_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__ = ["DataSourceListParams"]
+
+
+class DataSourceListParams(TypedDict, total=False):
+    organization_id: Optional[str]
+
+    project_id: Optional[str]

llama_cloud/types/data_source_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 .data_source import DataSource
+
+__all__ = ["DataSourceListResponse"]
+
+DataSourceListResponse: TypeAlias = List[DataSource]

llama_cloud/types/data_source_reader_version_metadata.py

@@ -1,32 +1,13 @@
-# 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 Optional
+from typing_extensions import Literal
 
-from ..core.datetime_utils import serialize_datetime
-from .data_source_reader_version_metadata_reader_version import DataSourceReaderVersionMetadataReaderVersion
+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__ = ["DataSourceReaderVersionMetadata"]
 
 
-class DataSourceReaderVersionMetadata(pydantic.BaseModel):
-    reader_version: typing.Optional[DataSourceReaderVersionMetadataReaderVersion]
-
-    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}
+class DataSourceReaderVersionMetadata(BaseModel):
+    reader_version: Optional[Literal["1.0", "2.0", "2.1"]] = None
+    """The version of the reader to use for this data source."""

llama_cloud/types/data_source_update_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 Dict, Union, Iterable, Optional
+from typing_extensions import Literal, Required, TypeAlias, TypedDict
+
+from .shared_params.cloud_s3_data_source import CloudS3DataSource
+from .shared_params.cloud_box_data_source import CloudBoxDataSource
+from .shared_params.cloud_jira_data_source import CloudJiraDataSource
+from .shared_params.cloud_slack_data_source import CloudSlackDataSource
+from .shared_params.cloud_jira_data_source_v2 import CloudJiraDataSourceV2
+from .shared_params.cloud_one_drive_data_source import CloudOneDriveDataSource
+from .shared_params.cloud_confluence_data_source import CloudConfluenceDataSource
+from .shared_params.cloud_sharepoint_data_source import CloudSharepointDataSource
+from .shared_params.cloud_notion_page_data_source import CloudNotionPageDataSource
+from .shared_params.cloud_az_storage_blob_data_source import CloudAzStorageBlobDataSource
+
+__all__ = ["DataSourceUpdateParams", "Component"]
+
+
+class DataSourceUpdateParams(TypedDict, total=False):
+    source_type: Required[
+        Literal[
+            "S3",
+            "AZURE_STORAGE_BLOB",
+            "GOOGLE_DRIVE",
+            "MICROSOFT_ONEDRIVE",
+            "MICROSOFT_SHAREPOINT",
+            "SLACK",
+            "NOTION_PAGE",
+            "CONFLUENCE",
+            "JIRA",
+            "JIRA_V2",
+            "BOX",
+        ]
+    ]
+
+    component: Optional[Component]
+    """Component that implements the data source"""
+
+    custom_metadata: Optional[Dict[str, Union[Dict[str, object], Iterable[object], str, float, bool, None]]]
+    """Custom metadata that will be present on all data loaded from the data source"""
+
+    name: Optional[str]
+    """The name of the data source."""
+
+
+Component: TypeAlias = Union[
+    Dict[str, object],
+    CloudS3DataSource,
+    CloudAzStorageBlobDataSource,
+    CloudOneDriveDataSource,
+    CloudSharepointDataSource,
+    CloudSlackDataSource,
+    CloudNotionPageDataSource,
+    CloudConfluenceDataSource,
+    CloudJiraDataSource,
+    CloudJiraDataSourceV2,
+    CloudBoxDataSource,
+]