vellum-ai 0.8.23__py3-none-any.whl → 0.8.25__py3-none-any.whl

vellum/__init__.py

@@ -99,6 +99,17 @@ from .types import (
     ExternalTestCaseExecution,
     ExternalTestCaseExecutionRequest,
     FinishReasonEnum,
+    FolderEntity,
+    FolderEntityDocumentIndex,
+    FolderEntityDocumentIndexData,
+    FolderEntityFolder,
+    FolderEntityFolderData,
+    FolderEntityPromptSandbox,
+    FolderEntityPromptSandboxData,
+    FolderEntityTestSuite,
+    FolderEntityTestSuiteData,
+    FolderEntityWorkflowSandbox,
+    FolderEntityWorkflowSandboxData,
     FulfilledAdHocExecutePromptEvent,
     FulfilledEnum,
     FulfilledExecutePromptEvent,
@@ -225,6 +236,7 @@ from .types import (
     OpenAiVectorizerTextEmbeddingAda002,
     OpenAiVectorizerTextEmbeddingAda002Request,
     PaginatedDocumentIndexReadList,
+    PaginatedFolderEntityList,
     PaginatedSlimDeploymentReadList,
     PaginatedSlimDocumentList,
     PaginatedSlimWorkflowDeploymentList,
@@ -457,6 +469,7 @@ from .errors import BadRequestError, ForbiddenError, InternalServerError, NotFou
 from .resources import (
     DeploymentsListRequestStatus,
     DocumentIndexesListRequestStatus,
+    FolderEntitiesListRequestEntityStatus,
     WorkflowDeploymentsListRequestStatus,
     ad_hoc,
     deployments,
@@ -577,6 +590,18 @@ __all__ = [
     "ExternalTestCaseExecution",
     "ExternalTestCaseExecutionRequest",
     "FinishReasonEnum",
+    "FolderEntitiesListRequestEntityStatus",
+    "FolderEntity",
+    "FolderEntityDocumentIndex",
+    "FolderEntityDocumentIndexData",
+    "FolderEntityFolder",
+    "FolderEntityFolderData",
+    "FolderEntityPromptSandbox",
+    "FolderEntityPromptSandboxData",
+    "FolderEntityTestSuite",
+    "FolderEntityTestSuiteData",
+    "FolderEntityWorkflowSandbox",
+    "FolderEntityWorkflowSandboxData",
     "ForbiddenError",
     "FulfilledAdHocExecutePromptEvent",
     "FulfilledEnum",
@@ -706,6 +731,7 @@ __all__ = [
     "OpenAiVectorizerTextEmbeddingAda002",
     "OpenAiVectorizerTextEmbeddingAda002Request",
     "PaginatedDocumentIndexReadList",
+    "PaginatedFolderEntityList",
     "PaginatedSlimDeploymentReadList",
     "PaginatedSlimDocumentList",
     "PaginatedSlimWorkflowDeploymentList",

vellum/core/client_wrapper.py

@@ -17,7 +17,7 @@ class BaseClientWrapper:
         headers: typing.Dict[str, str] = {
             "X-Fern-Language": "Python",
             "X-Fern-SDK-Name": "vellum-ai",
-            "X-Fern-SDK-Version": "0.8.23",
+            "X-Fern-SDK-Version": "0.8.25",
         }
         headers["X_API_KEY"] = self.api_key
         return headers

vellum/lib/test_suites/resources.py

@@ -4,9 +4,10 @@ import logging
 import time
 from functools import cached_property
 from typing import Callable, Generator, List, cast, Iterable
+from uuid import UUID
 
 from vellum import TestSuiteRunRead, TestSuiteRunMetricNumberOutput
-from vellum.client import Vellum
+from vellum.client import Vellum, OMIT
 from vellum.lib.test_suites.constants import (
     DEFAULT_MAX_POLLING_DURATION_MS,
     DEFAULT_POLLING_INTERVAL_MS,
@@ -14,6 +15,8 @@ from vellum.lib.test_suites.constants import (
 from vellum.lib.test_suites.exceptions import TestSuiteRunResultsException
 from vellum.lib.utils.env import get_api_key
 from vellum.lib.utils.paginator import PaginatedResults, get_all_results
+from vellum.lib.utils.typing import cast_not_optional
+from vellum.lib.utils.uuid import is_valid_uuid
 from vellum.types import (
     ExternalTestCaseExecutionRequest,
     NamedTestCaseVariableValueRequest,
@@ -198,7 +201,9 @@ class VellumTestSuiteRunResults:
         output_values = self.get_numeric_metric_output_values(
             metric_identifier=metric_identifier, output_identifier=output_identifier
         )
-        return sum(cast(Iterable[float], filter(lambda o: isinstance(o, float), output_values))) / len(output_values)
+        return sum(
+            cast(Iterable[float], filter(lambda o: isinstance(o, float), output_values))
+        ) / len(output_values)
 
     def get_min_metric_output(
         self, metric_identifier: str | None = None, output_identifier: str | None = None
@@ -207,7 +212,9 @@ class VellumTestSuiteRunResults:
         output_values = self.get_numeric_metric_output_values(
             metric_identifier=metric_identifier, output_identifier=output_identifier
         )
-        return min(cast(Iterable[float], filter(lambda o: isinstance(o, float), output_values)))
+        return min(
+            cast(Iterable[float], filter(lambda o: isinstance(o, float), output_values))
+        )
 
     def get_max_metric_output(
         self, metric_identifier: str | None = None, output_identifier: str | None = None
@@ -216,7 +223,9 @@ class VellumTestSuiteRunResults:
         output_values = self.get_numeric_metric_output_values(
             metric_identifier=metric_identifier, output_identifier=output_identifier
         )
-        return max(cast(Iterable[float], filter(lambda o: isinstance(o, float), output_values)))
+        return max(
+            cast(Iterable[float], filter(lambda o: isinstance(o, float), output_values))
+        )
 
     def wait_until_complete(self) -> None:
         """Wait until the Test Suite Run is no longer in a QUEUED or RUNNING state."""
@@ -282,16 +291,25 @@ class VellumTestSuiteRunResults:
 class VellumTestSuite:
     """A utility class that provides methods for running a Vellum Test Suite and interacting with its results."""
 
+    _test_suite_id: str | None
+    _test_suite_name: str | None
+
     def __init__(
         self,
-        test_suite_id: str,
+        test_suite_identifier: str | UUID,
         *,
         client: Vellum | None = None,
     ) -> None:
         self.client = client or Vellum(
             api_key=get_api_key(),
         )
-        self._test_suite_id = test_suite_id
+
+        if is_valid_uuid(test_suite_identifier):
+            self._test_suite_id = str(test_suite_identifier)
+            self._test_suite_name = None
+        else:
+            self._test_suite_id = None
+            self._test_suite_name = str(test_suite_identifier)
 
     def run_external(
         self,
@@ -305,7 +323,7 @@ class VellumTestSuite:
         Returns a wrapper that polls the generated Test Suite Run until it's done running and returns its results.
         """
         test_cases = self.client.test_suites.list_test_suite_test_cases(
-            id=self._test_suite_id
+            id=cast_not_optional(self._test_suite_id or self._test_suite_name)
         )
         executions: List[ExternalTestCaseExecutionRequest] = []
 
@@ -320,7 +338,8 @@ class VellumTestSuite:
             )
 
         test_suite_run = self.client.test_suite_runs.create(
-            test_suite_id=self._test_suite_id,
+            test_suite_id=self._test_suite_id or OMIT,
+            test_suite_name=self._test_suite_name or OMIT,
             exec_config=TestSuiteRunExternalExecConfigRequest(
                 type="EXTERNAL",
                 data=TestSuiteRunExternalExecConfigDataRequest(

vellum/lib/utils/typing.py

@@ -0,0 +1,10 @@
+from typing import TypeVar, Optional
+
+_T = TypeVar("_T")
+
+
+def cast_not_optional(optional: Optional[_T]) -> _T:
+    """Convert an optional to its value for type checking purposes. Raises an AssertionError if passed None."""
+    if optional is None:
+        raise AssertionError("Not optional check failed")
+    return optional

vellum/lib/utils/uuid.py

@@ -0,0 +1,10 @@
+from typing import Union
+import uuid
+
+
+def is_valid_uuid(val: Union[str, uuid.UUID, None]) -> bool:
+    try:
+        uuid.UUID(str(val))
+        return True
+    except (ValueError, TypeError):
+        return False

vellum/resources/__init__.py

@@ -15,11 +15,13 @@ from . import (
 )
 from .deployments import DeploymentsListRequestStatus
 from .document_indexes import DocumentIndexesListRequestStatus
+from .folder_entities import FolderEntitiesListRequestEntityStatus
 from .workflow_deployments import WorkflowDeploymentsListRequestStatus
 
 __all__ = [
     "DeploymentsListRequestStatus",
     "DocumentIndexesListRequestStatus",
+    "FolderEntitiesListRequestEntityStatus",
     "WorkflowDeploymentsListRequestStatus",
     "ad_hoc",
     "deployments",

vellum/resources/folder_entities/__init__.py

@@ -1,2 +1,5 @@
 # This file was auto-generated by Fern from our API Definition.
 
+from .types import FolderEntitiesListRequestEntityStatus
+
+__all__ = ["FolderEntitiesListRequestEntityStatus"]

vellum/resources/folder_entities/client.py

@@ -2,10 +2,13 @@
 
 import typing
 from ...core.client_wrapper import SyncClientWrapper
+from .types.folder_entities_list_request_entity_status import FolderEntitiesListRequestEntityStatus
 from ...core.request_options import RequestOptions
-from ...core.jsonable_encoder import jsonable_encoder
+from ...types.paginated_folder_entity_list import PaginatedFolderEntityList
+from ...core.pydantic_utilities import parse_obj_as
 from json.decoder import JSONDecodeError
 from ...core.api_error import ApiError
+from ...core.jsonable_encoder import jsonable_encoder
 from ...core.client_wrapper import AsyncClientWrapper
 
 # this is used as the default value for optional parameters
@@ -16,6 +19,93 @@ class FolderEntitiesClient:
     def __init__(self, *, client_wrapper: SyncClientWrapper):
         self._client_wrapper = client_wrapper
 
+    def list(
+        self,
+        *,
+        parent_folder_id: str,
+        entity_status: typing.Optional[FolderEntitiesListRequestEntityStatus] = None,
+        limit: typing.Optional[int] = None,
+        offset: typing.Optional[int] = None,
+        ordering: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> PaginatedFolderEntityList:
+        """
+        List all folder entities within a specified folder.
+
+        Parameters
+        ----------
+        parent_folder_id : str
+            Filter down to only those entities whose parent folder has the specified ID.
+
+            To filter by an entity's parent folder, provide the ID of the parent folder. To filter by the root directory, provide
+            a string representing the entity type of the root directory. Supported root directories include:
+
+            - PROMPT_SANDBOX
+            - WORKFLOW_SANDBOX
+            - DOCUMENT_INDEX
+            - TEST_SUITE
+
+        entity_status : typing.Optional[FolderEntitiesListRequestEntityStatus]
+            Filter down to only those objects whose entities have a status matching the status specified.
+
+            - `ACTIVE` - Active
+            - `ARCHIVED` - Archived
+
+        limit : typing.Optional[int]
+            Number of results to return per page.
+
+        offset : typing.Optional[int]
+            The initial index from which to return the results.
+
+        ordering : typing.Optional[str]
+            Which field to use when ordering the results.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        PaginatedFolderEntityList
+
+
+        Examples
+        --------
+        from vellum import Vellum
+
+        client = Vellum(
+            api_key="YOUR_API_KEY",
+        )
+        client.folder_entities.list(
+            parent_folder_id="parent_folder_id",
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "v1/folder-entities",
+            base_url=self._client_wrapper.get_environment().default,
+            method="GET",
+            params={
+                "entity_status": entity_status,
+                "limit": limit,
+                "offset": offset,
+                "ordering": ordering,
+                "parent_folder_id": parent_folder_id,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    PaginatedFolderEntityList,
+                    parse_obj_as(
+                        type_=PaginatedFolderEntityList,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
     def add_entity_to_folder(
         self, folder_id: str, *, entity_id: str, request_options: typing.Optional[RequestOptions] = None
     ) -> None:
@@ -27,7 +117,13 @@ class FolderEntitiesClient:
         Parameters
         ----------
         folder_id : str
-            The ID of the folder to which the entity should be added. This can be a UUID of a folder, or the name of a root directory (e.g. "PROMPT_SANDBOX").
+            The ID of the folder to which the entity should be added. This can be a UUID of a folder, or the name of a root
+            directory. Supported root directories include:
+
+            - PROMPT_SANDBOX
+            - WORKFLOW_SANDBOX
+            - DOCUMENT_INDEX
+            - TEST_SUITE
 
         entity_id : str
             The ID of the entity you would like to move.
@@ -74,6 +170,101 @@ class AsyncFolderEntitiesClient:
     def __init__(self, *, client_wrapper: AsyncClientWrapper):
         self._client_wrapper = client_wrapper
 
+    async def list(
+        self,
+        *,
+        parent_folder_id: str,
+        entity_status: typing.Optional[FolderEntitiesListRequestEntityStatus] = None,
+        limit: typing.Optional[int] = None,
+        offset: typing.Optional[int] = None,
+        ordering: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> PaginatedFolderEntityList:
+        """
+        List all folder entities within a specified folder.
+
+        Parameters
+        ----------
+        parent_folder_id : str
+            Filter down to only those entities whose parent folder has the specified ID.
+
+            To filter by an entity's parent folder, provide the ID of the parent folder. To filter by the root directory, provide
+            a string representing the entity type of the root directory. Supported root directories include:
+
+            - PROMPT_SANDBOX
+            - WORKFLOW_SANDBOX
+            - DOCUMENT_INDEX
+            - TEST_SUITE
+
+        entity_status : typing.Optional[FolderEntitiesListRequestEntityStatus]
+            Filter down to only those objects whose entities have a status matching the status specified.
+
+            - `ACTIVE` - Active
+            - `ARCHIVED` - Archived
+
+        limit : typing.Optional[int]
+            Number of results to return per page.
+
+        offset : typing.Optional[int]
+            The initial index from which to return the results.
+
+        ordering : typing.Optional[str]
+            Which field to use when ordering the results.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        PaginatedFolderEntityList
+
+
+        Examples
+        --------
+        import asyncio
+
+        from vellum import AsyncVellum
+
+        client = AsyncVellum(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.folder_entities.list(
+                parent_folder_id="parent_folder_id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "v1/folder-entities",
+            base_url=self._client_wrapper.get_environment().default,
+            method="GET",
+            params={
+                "entity_status": entity_status,
+                "limit": limit,
+                "offset": offset,
+                "ordering": ordering,
+                "parent_folder_id": parent_folder_id,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    PaginatedFolderEntityList,
+                    parse_obj_as(
+                        type_=PaginatedFolderEntityList,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
     async def add_entity_to_folder(
         self, folder_id: str, *, entity_id: str, request_options: typing.Optional[RequestOptions] = None
     ) -> None:
@@ -85,7 +276,13 @@ class AsyncFolderEntitiesClient:
         Parameters
         ----------
         folder_id : str
-            The ID of the folder to which the entity should be added. This can be a UUID of a folder, or the name of a root directory (e.g. "PROMPT_SANDBOX").
+            The ID of the folder to which the entity should be added. This can be a UUID of a folder, or the name of a root
+            directory. Supported root directories include:
+
+            - PROMPT_SANDBOX
+            - WORKFLOW_SANDBOX
+            - DOCUMENT_INDEX
+            - TEST_SUITE
 
         entity_id : str
             The ID of the entity you would like to move.

vellum/resources/folder_entities/types/__init__.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from .folder_entities_list_request_entity_status import FolderEntitiesListRequestEntityStatus
+
+__all__ = ["FolderEntitiesListRequestEntityStatus"]

vellum/resources/folder_entities/types/folder_entities_list_request_entity_status.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+FolderEntitiesListRequestEntityStatus = typing.Union[typing.Literal["ACTIVE", "ARCHIVED"], typing.Any]

vellum/types/__init__.py

@@ -106,6 +106,17 @@ from .execution_vellum_value import ExecutionVellumValue
 from .external_test_case_execution import ExternalTestCaseExecution
 from .external_test_case_execution_request import ExternalTestCaseExecutionRequest
 from .finish_reason_enum import FinishReasonEnum
+from .folder_entity import FolderEntity
+from .folder_entity_document_index import FolderEntityDocumentIndex
+from .folder_entity_document_index_data import FolderEntityDocumentIndexData
+from .folder_entity_folder import FolderEntityFolder
+from .folder_entity_folder_data import FolderEntityFolderData
+from .folder_entity_prompt_sandbox import FolderEntityPromptSandbox
+from .folder_entity_prompt_sandbox_data import FolderEntityPromptSandboxData
+from .folder_entity_test_suite import FolderEntityTestSuite
+from .folder_entity_test_suite_data import FolderEntityTestSuiteData
+from .folder_entity_workflow_sandbox import FolderEntityWorkflowSandbox
+from .folder_entity_workflow_sandbox_data import FolderEntityWorkflowSandboxData
 from .fulfilled_ad_hoc_execute_prompt_event import FulfilledAdHocExecutePromptEvent
 from .fulfilled_enum import FulfilledEnum
 from .fulfilled_execute_prompt_event import FulfilledExecutePromptEvent
@@ -236,6 +247,7 @@ from .open_ai_vectorizer_text_embedding_3_small_request import OpenAiVectorizerT
 from .open_ai_vectorizer_text_embedding_ada_002 import OpenAiVectorizerTextEmbeddingAda002
 from .open_ai_vectorizer_text_embedding_ada_002_request import OpenAiVectorizerTextEmbeddingAda002Request
 from .paginated_document_index_read_list import PaginatedDocumentIndexReadList
+from .paginated_folder_entity_list import PaginatedFolderEntityList
 from .paginated_slim_deployment_read_list import PaginatedSlimDeploymentReadList
 from .paginated_slim_document_list import PaginatedSlimDocumentList
 from .paginated_slim_workflow_deployment_list import PaginatedSlimWorkflowDeploymentList
@@ -567,6 +579,17 @@ __all__ = [
     "ExternalTestCaseExecution",
     "ExternalTestCaseExecutionRequest",
     "FinishReasonEnum",
+    "FolderEntity",
+    "FolderEntityDocumentIndex",
+    "FolderEntityDocumentIndexData",
+    "FolderEntityFolder",
+    "FolderEntityFolderData",
+    "FolderEntityPromptSandbox",
+    "FolderEntityPromptSandboxData",
+    "FolderEntityTestSuite",
+    "FolderEntityTestSuiteData",
+    "FolderEntityWorkflowSandbox",
+    "FolderEntityWorkflowSandboxData",
     "FulfilledAdHocExecutePromptEvent",
     "FulfilledEnum",
     "FulfilledExecutePromptEvent",
@@ -693,6 +716,7 @@ __all__ = [
     "OpenAiVectorizerTextEmbeddingAda002",
     "OpenAiVectorizerTextEmbeddingAda002Request",
     "PaginatedDocumentIndexReadList",
+    "PaginatedFolderEntityList",
     "PaginatedSlimDeploymentReadList",
     "PaginatedSlimDocumentList",
     "PaginatedSlimWorkflowDeploymentList",

vellum/types/folder_entity.py

@@ -0,0 +1,16 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+from .folder_entity_folder import FolderEntityFolder
+from .folder_entity_prompt_sandbox import FolderEntityPromptSandbox
+from .folder_entity_workflow_sandbox import FolderEntityWorkflowSandbox
+from .folder_entity_document_index import FolderEntityDocumentIndex
+from .folder_entity_test_suite import FolderEntityTestSuite
+
+FolderEntity = typing.Union[
+    FolderEntityFolder,
+    FolderEntityPromptSandbox,
+    FolderEntityWorkflowSandbox,
+    FolderEntityDocumentIndex,
+    FolderEntityTestSuite,
+]

vellum/types/folder_entity_document_index.py

@@ -0,0 +1,26 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import typing
+from .folder_entity_document_index_data import FolderEntityDocumentIndexData
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class FolderEntityDocumentIndex(UniversalBaseModel):
+    """
+    A slim representation of a Document Index, as it exists within a Folder.
+    """
+
+    id: str
+    type: typing.Literal["DOCUMENT_INDEX"] = "DOCUMENT_INDEX"
+    data: FolderEntityDocumentIndexData
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

vellum/types/folder_entity_document_index_data.py

@@ -0,0 +1,25 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import datetime as dt
+from .entity_status import EntityStatus
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import typing
+import pydantic
+
+
+class FolderEntityDocumentIndexData(UniversalBaseModel):
+    id: str
+    label: str
+    created: dt.datetime
+    modified: dt.datetime
+    status: EntityStatus
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

vellum/types/folder_entity_folder.py

@@ -0,0 +1,26 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import typing
+from .folder_entity_folder_data import FolderEntityFolderData
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class FolderEntityFolder(UniversalBaseModel):
+    """
+    A slim representation of a Folder, as it exists within another Folder.
+    """
+
+    id: str
+    type: typing.Literal["FOLDER"] = "FOLDER"
+    data: FolderEntityFolderData
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

vellum/types/folder_entity_folder_data.py

@@ -0,0 +1,24 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import datetime as dt
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import typing
+import pydantic
+
+
+class FolderEntityFolderData(UniversalBaseModel):
+    id: str
+    label: str
+    created: dt.datetime
+    modified: dt.datetime
+    has_contents: bool
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

vellum/types/folder_entity_prompt_sandbox.py

@@ -0,0 +1,26 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import typing
+from .folder_entity_prompt_sandbox_data import FolderEntityPromptSandboxData
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class FolderEntityPromptSandbox(UniversalBaseModel):
+    """
+    A slim representation of a Prompt Sandbox, as it exists within a Folder.
+    """
+
+    id: str
+    type: typing.Literal["PROMPT_SANDBOX"] = "PROMPT_SANDBOX"
+    data: FolderEntityPromptSandboxData
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

vellum/types/folder_entity_prompt_sandbox_data.py

@@ -0,0 +1,26 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import datetime as dt
+from .entity_status import EntityStatus
+import typing
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class FolderEntityPromptSandboxData(UniversalBaseModel):
+    id: str
+    label: str
+    created: dt.datetime
+    modified: dt.datetime
+    status: EntityStatus
+    last_deployed_on: typing.Optional[dt.datetime] = None
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

vellum/types/folder_entity_test_suite.py

@@ -0,0 +1,26 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import typing
+from .folder_entity_test_suite_data import FolderEntityTestSuiteData
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class FolderEntityTestSuite(UniversalBaseModel):
+    """
+    A slim representation of a Test Suite, as it exists within a Folder.
+    """
+
+    id: str
+    type: typing.Literal["TEST_SUITE"] = "TEST_SUITE"
+    data: FolderEntityTestSuiteData
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

vellum/types/folder_entity_test_suite_data.py

@@ -0,0 +1,25 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import datetime as dt
+from .entity_status import EntityStatus
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import typing
+import pydantic
+
+
+class FolderEntityTestSuiteData(UniversalBaseModel):
+    id: str
+    label: str
+    created: dt.datetime
+    modified: dt.datetime
+    status: EntityStatus
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

vellum/types/folder_entity_workflow_sandbox.py

@@ -0,0 +1,26 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import typing
+from .folder_entity_workflow_sandbox_data import FolderEntityWorkflowSandboxData
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class FolderEntityWorkflowSandbox(UniversalBaseModel):
+    """
+    A slim representation of a Workflow Sandbox, as it exists within a Folder.
+    """
+
+    id: str
+    type: typing.Literal["WORKFLOW_SANDBOX"] = "WORKFLOW_SANDBOX"
+    data: FolderEntityWorkflowSandboxData
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

vellum/types/folder_entity_workflow_sandbox_data.py

@@ -0,0 +1,26 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import datetime as dt
+from .entity_status import EntityStatus
+import typing
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class FolderEntityWorkflowSandboxData(UniversalBaseModel):
+    id: str
+    label: str
+    created: dt.datetime
+    modified: dt.datetime
+    status: EntityStatus
+    last_deployed_on: typing.Optional[dt.datetime] = None
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

vellum/types/paginated_folder_entity_list.py

@@ -0,0 +1,23 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import typing
+from .folder_entity import FolderEntity
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class PaginatedFolderEntityList(UniversalBaseModel):
+    count: typing.Optional[int] = None
+    next: typing.Optional[str] = None
+    previous: typing.Optional[str] = None
+    results: typing.Optional[typing.List[FolderEntity]] = None
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

{vellum_ai-0.8.23.dist-info → vellum_ai-0.8.25.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: vellum-ai
-Version: 0.8.23
+Version: 0.8.25
 Summary: 
 License: MIT
 Requires-Python: >=3.8,<4.0

{vellum_ai-0.8.23.dist-info → vellum_ai-0.8.25.dist-info}/RECORD

@@ -1,8 +1,8 @@
-vellum/__init__.py,sha256=XD7isCfj2AEsRXQ7I_R3dfvqSFpcz3vM_B_3EK_icfk,32600
+vellum/__init__.py,sha256=Xwhije2oWv8vv2_FipbeWUctQ9KqoAik8PONMipyxus,33434
 vellum/client.py,sha256=cMrzyQ7GUnByOLvgoe9lCf569uk5e17I4TIgA74awKg,114255
 vellum/core/__init__.py,sha256=SQ85PF84B9MuKnBwHNHWemSGuy-g_515gFYNFhvEE0I,1438
 vellum/core/api_error.py,sha256=RE8LELok2QCjABadECTvtDp7qejA1VmINCh6TbqPwSE,426
-vellum/core/client_wrapper.py,sha256=hKafZmB1w1XfuU7lZreKQfuedsRD-_CnQKgB-TC2MEY,1890
+vellum/core/client_wrapper.py,sha256=Kx9aa371E_mOTEMMnK0-ZBcwrYjDsnV-olT344DkZTk,1890
 vellum/core/datetime_utils.py,sha256=nBys2IsYrhPdszxGKCNRPSOCwa-5DWOHG95FB8G9PKo,1047
 vellum/core/file.py,sha256=X9IbmkZmB2bB_DpmZAO3crWdXagOakAyn6UCOCImCPg,2322
 vellum/core/http_client.py,sha256=R0pQpCppnEtxccGvXl4uJ76s7ro_65Fo_erlNNLp_AI,19228
@@ -22,13 +22,15 @@ vellum/lib/__init__.py,sha256=KTSY0V59WEOr5uNyAei1dDfaAatyXw_Aca5kNjo5mY0,79
 vellum/lib/test_suites/__init__.py,sha256=hNsLoHSykqXDJP-MwFvu2lExImxo9KEyEJjt_fdAzpE,77
 vellum/lib/test_suites/constants.py,sha256=Vteml4_csZsMgo_q3-71E3JRCAoN6308TXLu5nfLhmU,116
 vellum/lib/test_suites/exceptions.py,sha256=6Xacoyv43fJvVf6Dt6Io5a-f9vF12Tx51jzsQRNSqhY,56
-vellum/lib/test_suites/resources.py,sha256=86LEUe_JsPnjfEjJHcy1i3Hw2PduC6dHy8zJ8JzT1uw,12526
+vellum/lib/test_suites/resources.py,sha256=cn0FqsULHNo84cGhS1-7tvV7-bz77UgFd6Sfxl63Cdo,13137
 vellum/lib/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 vellum/lib/utils/env.py,sha256=ySl859lYBfls8hmlaU_RFdquHa_A_7SzaC6KEdFqh1Y,298
 vellum/lib/utils/exceptions.py,sha256=dXMAkzqbHV_AP5FjjbegPlfUE0zQDlpA3qOsoOJUxfg,49
 vellum/lib/utils/paginator.py,sha256=yDvgehocYBDclLt5SewZH4hCIyq0yLHdBzkyPCoYPjs,698
+vellum/lib/utils/typing.py,sha256=qngWnFwrWLUeu1nmixXGj173mwg7BXKTAyQkxK8AtfQ,327
+vellum/lib/utils/uuid.py,sha256=nedyhTNQDS2YvrU5gL3PtvG9cgGH87yKOcpGDJAe44E,214
 vellum/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-vellum/resources/__init__.py,sha256=rrkswsofiS3xbyO4ufcrbY2qrQ_tlQ-Kdby2UiWfGyw,856
+vellum/resources/__init__.py,sha256=202WddnB8daP4pLM4aQEkqvWaqRUBxEN2e5Ju__FyqM,968
 vellum/resources/ad_hoc/__init__.py,sha256=FTtvy8EDg9nNNg9WCatVgKTRYV8-_v1roeGPAKoa_pw,65
 vellum/resources/ad_hoc/client.py,sha256=TP5Mr94keCqcIi3_1zGEApyPJhvax7NHUb1396X4ypQ,16342
 vellum/resources/deployments/__init__.py,sha256=AE0TcFwLrLBljM0ZDX-pPw4Kqt-1f5JDpIok2HS80QI,157
@@ -41,8 +43,10 @@ vellum/resources/document_indexes/types/__init__.py,sha256=IoFqKHN_VBdEhC7VL8_6J
 vellum/resources/document_indexes/types/document_indexes_list_request_status.py,sha256=sfUEB0cvOSmlE2iITqnMVyHv05Zy2fWP4QjCIYqMg0M,178
 vellum/resources/documents/__init__.py,sha256=FTtvy8EDg9nNNg9WCatVgKTRYV8-_v1roeGPAKoa_pw,65
 vellum/resources/documents/client.py,sha256=TRptBN1FG4wyTYOq0TpmkXlQL63Owbvsa539E1VXs6s,27574
-vellum/resources/folder_entities/__init__.py,sha256=FTtvy8EDg9nNNg9WCatVgKTRYV8-_v1roeGPAKoa_pw,65
-vellum/resources/folder_entities/client.py,sha256=yxkHRAx8frCk-WvgcRD-WzMhA2kxvY_j42S436-j4EQ,4440
+vellum/resources/folder_entities/__init__.py,sha256=QOp7UMMB3a32GrfVaud35ECn4fqPBKXxCyClsDgd6GE,175
+vellum/resources/folder_entities/client.py,sha256=ep5dnfJmEuEyrOSUftEVwKaeXrg1DENEDjO4_nw9yq0,11114
+vellum/resources/folder_entities/types/__init__.py,sha256=cHabrupjC-HL3kj-UZ9WdVzqHoQHCu6QsLFB3wlOs7k,212
+vellum/resources/folder_entities/types/folder_entities_list_request_entity_status.py,sha256=nK9b9fRSeCfjn2V2Hifl1IbhFeVsNkoeXJ8rCAPADFg,183
 vellum/resources/metric_definitions/__init__.py,sha256=FTtvy8EDg9nNNg9WCatVgKTRYV8-_v1roeGPAKoa_pw,65
 vellum/resources/metric_definitions/client.py,sha256=Q0hrwTmjaUUVYPKM7wqRdWMzQwZszn5i_ons5mAsIXY,6009
 vellum/resources/sandboxes/__init__.py,sha256=FTtvy8EDg9nNNg9WCatVgKTRYV8-_v1roeGPAKoa_pw,65
@@ -68,7 +72,7 @@ vellum/terraform/ml_model/__init__.py,sha256=I8h1Ru-Rb-Hi_HusK6G7nJQZEKQGsAAHMmw
 vellum/terraform/provider/__init__.py,sha256=-06xKmAmknpohVzw5TD-t1bnUHta8OrQYqvMd04XM-U,12684
 vellum/terraform/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
 vellum/terraform/versions.json,sha256=45c7jjRD5i4w9DJQHs5ZqLLVXRnQwP9Rirq3mWY-xEo,56
-vellum/types/__init__.py,sha256=Kvyi2Q6clu5iFTXl8cMuYz5Za41tX3flFXfAZiaYz9M,49854
+vellum/types/__init__.py,sha256=0OFQSJe437PosE8l2TDQo1nrA1p5HQkx13Fq2wT1Rg4,51034
 vellum/types/ad_hoc_execute_prompt_event.py,sha256=bCjujA2XsOgyF3bRZbcEqV2rOIymRgsLoIRtZpB14xg,607
 vellum/types/ad_hoc_expand_meta_request.py,sha256=hS8PC3hC--OKvRKi2ZFj_RJPQ1bxo2GXno8qJq1kk28,1338
 vellum/types/ad_hoc_fulfilled_prompt_execution_meta.py,sha256=Bfvf1d_dkmshxRACVM5vcxbH_7AQY23RmrrnPc0ytYY,939
@@ -167,6 +171,17 @@ vellum/types/execution_vellum_value.py,sha256=PpbrbJdSioqaqT2gZ6mx2Ht0Oy8XGyxBDc
 vellum/types/external_test_case_execution.py,sha256=CzO7IM3uINXQfOHWjEVvRqwRcp5_JWWtyXVxMQGHl_c,1063
 vellum/types/external_test_case_execution_request.py,sha256=5nZWMZnDPqQSmmcnIM5Cz6VxA6YQrcfmdWw7d2Da3cY,1128
 vellum/types/finish_reason_enum.py,sha256=KoNjzvXMHDCT0AUhhwGoZ1_7bi4h3fZEFvvHyGyoTP8,169
+vellum/types/folder_entity.py,sha256=v8zNprIbxktOzmncbNXTOJlLTBV5bZqD1Z_AGGHG1_8,578
+vellum/types/folder_entity_document_index.py,sha256=-Tg2qnzGhp2FLnvGrgoVr0ZBEKFmm2TjgYvlII8tkog,839
+vellum/types/folder_entity_document_index_data.py,sha256=UceusLf7dLYDHq4ZlKdP5Wx_ytL5oadOPMtut9AKkrQ,723
+vellum/types/folder_entity_folder.py,sha256=1GWfyHdenyAI2GXiouIbnFhPK4ADqZGFh-6fpp_C6-U,792
+vellum/types/folder_entity_folder_data.py,sha256=JLYkhvRY63-ojNY84lfRTaUg25KjslSE-iNAC2NYCTI,674
+vellum/types/folder_entity_prompt_sandbox.py,sha256=7CGVcK5maoqO7CC7sFfi6F5X0QWdHVbEygqLyci_VDY,839
+vellum/types/folder_entity_prompt_sandbox_data.py,sha256=4u-t-p2-h7Z1SacNOQnEnY3tt-au5WB0hIDrB1HOeKk,781
+vellum/types/folder_entity_test_suite.py,sha256=M5sb7ntUX2VsCyD0AYnz7dalt7G1ejOYQZvsUU33q2w,811
+vellum/types/folder_entity_test_suite_data.py,sha256=RGITy3Pip6NeIb77YGavDWgRr8GLFDB9sXrTU_Dm2OI,719
+vellum/types/folder_entity_workflow_sandbox.py,sha256=gFmkwKZGh5O9-9y4w6VGK1IRsKLf7NZ4SCC-pgucm8M,853
+vellum/types/folder_entity_workflow_sandbox_data.py,sha256=MW0nLAvetgnsm6KWiGcYcKB9llR-UfosSNz0MtokN38,783
 vellum/types/fulfilled_ad_hoc_execute_prompt_event.py,sha256=19rFjVrzobaaAQhZlP_WGV9f_Rwrz4EPRXbT2aYkaJw,1016
 vellum/types/fulfilled_enum.py,sha256=MenrGneRMBvsq-n8tkMXAx0wppGWLJgkqdKnfklGP9U,124
 vellum/types/fulfilled_execute_prompt_event.py,sha256=E-iBwlMWvwQyRfzqPlgtX8KurE3IYsTRd5vWjXtbOmk,994
@@ -293,6 +308,7 @@ vellum/types/open_ai_vectorizer_text_embedding_3_small_request.py,sha256=-lwNeWj
 vellum/types/open_ai_vectorizer_text_embedding_ada_002.py,sha256=c4vNlR6lRvUjq-67M06sroDMNMG_qC4JUBqwmKEJQ2I,812
 vellum/types/open_ai_vectorizer_text_embedding_ada_002_request.py,sha256=FdpkkNBGgRwfqFjBwpfH4t2zKIM0pIYminX2iZQUzvY,841
 vellum/types/paginated_document_index_read_list.py,sha256=bO7pm3KCZi5LDO17YXgr_lUF9SRdAfMu6wOutX91ANw,797
+vellum/types/paginated_folder_entity_list.py,sha256=PElkrxMrnEjL9YGXde_r7RpNQUjzYfaLDlnwO8WFDSo,776
 vellum/types/paginated_slim_deployment_read_list.py,sha256=H8VKHr-aZP4ACwQJSs7KOrbqaj2nmMmyyvZHe7NRWRc,1048
 vellum/types/paginated_slim_document_list.py,sha256=8f7L0ZqD9hBU4XTGTdltl0ORuyy2gryPU5UxlmPabq4,776
 vellum/types/paginated_slim_workflow_deployment_list.py,sha256=b0SGPewaOK5VlvlxymI6BELdqC9W0m823IZK-SaOiIw,1072
@@ -521,7 +537,7 @@ vellum/types/workflow_result_event_output_data_search_results.py,sha256=U34IK7Zv
 vellum/types/workflow_result_event_output_data_string.py,sha256=tM3kgh6tEhD0dFEb_7UU0-UspeN4pUdINCcCrD64W74,1228
 vellum/types/workflow_stream_event.py,sha256=Wn3Yzuy9MqWAeo8tEaXDTKDEbJoA8DdYdMVq8EKuhu8,361
 vellum/version.py,sha256=jq-1PlAYxN9AXuaZqbYk9ak27SgE2lw9Ia5gx1b1gVI,76
-vellum_ai-0.8.23.dist-info/LICENSE,sha256=CcaljEIoOBaU-wItPH4PmM_mDCGpyuUY0Er1BGu5Ti8,1073
-vellum_ai-0.8.23.dist-info/METADATA,sha256=0-YqyyRiBiY5436OCa3ixRQvA0dakPjZcDpkHwOe4eE,4395
-vellum_ai-0.8.23.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
-vellum_ai-0.8.23.dist-info/RECORD,,
+vellum_ai-0.8.25.dist-info/LICENSE,sha256=CcaljEIoOBaU-wItPH4PmM_mDCGpyuUY0Er1BGu5Ti8,1073
+vellum_ai-0.8.25.dist-info/METADATA,sha256=ibKMuK7rTEPyv3aQB39XMW7f1iH3mG6iffIxE6bQ1NA,4395
+vellum_ai-0.8.25.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
+vellum_ai-0.8.25.dist-info/RECORD,,