vellum-ai 0.14.22__py3-none-any.whl → 0.14.24__py3-none-any.whl

vellum/__init__.py

@@ -13,6 +13,8 @@ from .types import (
     AddOpenaiApiKeyEnum,
     ApiNodeResult,
     ApiNodeResultData,
+    ApiRequestParentContext,
+    ApiVersionEnum,
     ArrayChatMessageContent,
     ArrayChatMessageContentItem,
     ArrayChatMessageContentItemRequest,
@@ -25,6 +27,7 @@ from .types import (
     AudioPromptBlock,
     AudioVellumValue,
     AudioVellumValueRequest,
+    BaseOutput,
     BasicVectorizerIntfloatMultilingualE5Large,
     BasicVectorizerIntfloatMultilingualE5LargeRequest,
     BasicVectorizerSentenceTransformersMultiQaMpnetBaseCosV1,
@@ -57,6 +60,7 @@ from .types import (
     CodeExecutorInput,
     CodeExecutorResponse,
     CodeExecutorSecretInput,
+    CodeResourceDefinition,
     CompilePromptDeploymentExpandMetaRequest,
     CompilePromptMeta,
     ComponentsSchemasPdfSearchResultMetaSource,
@@ -114,6 +118,7 @@ from .types import (
     ExecutionSearchResultsVellumValue,
     ExecutionStringVellumValue,
     ExecutionVellumValue,
+    ExternalInputDescriptor,
     ExternalTestCaseExecution,
     ExternalTestCaseExecutionRequest,
     FinishReasonEnum,
@@ -176,6 +181,7 @@ from .types import (
     InitiatedWorkflowNodeResultEvent,
     InstructorVectorizerConfig,
     InstructorVectorizerConfigRequest,
+    InvokedPort,
     IterationStateEnum,
     JinjaPromptBlock,
     JsonInput,
@@ -199,6 +205,7 @@ from .types import (
     MetricNodeResult,
     MlModelRead,
     MlModelUsage,
+    MlModelUsageWrapper,
     NamedScenarioInputChatHistoryVariableValueRequest,
     NamedScenarioInputJsonVariableValueRequest,
     NamedScenarioInputRequest,
@@ -222,6 +229,21 @@ from .types import (
     NamedTestCaseVariableValue,
     NamedTestCaseVariableValueRequest,
     NewMemberJoinBehaviorEnum,
+    NodeEventDisplayContext,
+    NodeExecutionFulfilledBody,
+    NodeExecutionFulfilledEvent,
+    NodeExecutionInitiatedBody,
+    NodeExecutionInitiatedEvent,
+    NodeExecutionPausedBody,
+    NodeExecutionPausedEvent,
+    NodeExecutionRejectedBody,
+    NodeExecutionRejectedEvent,
+    NodeExecutionResumedBody,
+    NodeExecutionResumedEvent,
+    NodeExecutionSpan,
+    NodeExecutionSpanAttributes,
+    NodeExecutionStreamingBody,
+    NodeExecutionStreamingEvent,
     NodeInputCompiledArrayValue,
     NodeInputCompiledChatHistoryValue,
     NodeInputCompiledErrorValue,
@@ -241,6 +263,7 @@ from .types import (
     NodeOutputCompiledSearchResultsValue,
     NodeOutputCompiledStringValue,
     NodeOutputCompiledValue,
+    NodeParentContext,
     NormalizedLogProbs,
     NormalizedTokenLogProbs,
     NumberInput,
@@ -266,6 +289,7 @@ from .types import (
     PaginatedTestSuiteTestCaseList,
     PaginatedWorkflowReleaseTagReadList,
     PaginatedWorkflowSandboxExampleList,
+    ParentContext,
     PdfSearchResultMetaSource,
     PdfSearchResultMetaSourceRequest,
     PlainTextPromptBlock,
@@ -275,6 +299,7 @@ from .types import (
     PromptBlockState,
     PromptDeploymentExpandMetaRequest,
     PromptDeploymentInputRequest,
+    PromptDeploymentParentContext,
     PromptExecutionMeta,
     PromptNodeExecutionMeta,
     PromptNodeResult,
@@ -332,6 +357,9 @@ from .types import (
     SlimDocument,
     SlimDocumentDocumentToDocumentIndex,
     SlimWorkflowDeployment,
+    SlimWorkflowExecutionRead,
+    SpanLink,
+    SpanLinkTypeEnum,
     StreamingAdHocExecutePromptEvent,
     StreamingExecutePromptEvent,
     StreamingPromptExecutionMeta,
@@ -445,6 +473,7 @@ from .types import (
     VariablePromptBlock,
     VellumAudio,
     VellumAudioRequest,
+    VellumCodeResourceDefinition,
     VellumDocument,
     VellumDocumentRequest,
     VellumError,
@@ -452,7 +481,11 @@ from .types import (
     VellumErrorRequest,
     VellumImage,
     VellumImageRequest,
+    VellumNodeExecutionEvent,
+    VellumSdkError,
+    VellumSdkErrorCodeEnum,
     VellumSecret,
+    VellumSpan,
     VellumValue,
     VellumValueLogicalConditionGroupRequest,
     VellumValueLogicalConditionRequest,
@@ -461,17 +494,43 @@ from .types import (
     VellumVariable,
     VellumVariableExtensions,
     VellumVariableType,
+    VellumWorkflowExecutionEvent,
+    WorkflowDeploymentEventExecutionsResponse,
     WorkflowDeploymentHistoryItem,
+    WorkflowDeploymentParentContext,
     WorkflowDeploymentRead,
+    WorkflowError,
+    WorkflowEventDisplayContext,
     WorkflowEventError,
+    WorkflowEventExecutionRead,
+    WorkflowExecutionActual,
     WorkflowExecutionActualChatHistoryRequest,
     WorkflowExecutionActualJsonRequest,
     WorkflowExecutionActualStringRequest,
     WorkflowExecutionEventErrorCode,
     WorkflowExecutionEventType,
+    WorkflowExecutionFulfilledBody,
+    WorkflowExecutionFulfilledEvent,
+    WorkflowExecutionInitiatedBody,
+    WorkflowExecutionInitiatedEvent,
     WorkflowExecutionNodeResultEvent,
+    WorkflowExecutionPausedBody,
+    WorkflowExecutionPausedEvent,
+    WorkflowExecutionRejectedBody,
+    WorkflowExecutionRejectedEvent,
+    WorkflowExecutionResumedBody,
+    WorkflowExecutionResumedEvent,
+    WorkflowExecutionSnapshottedBody,
+    WorkflowExecutionSnapshottedEvent,
+    WorkflowExecutionSpan,
+    WorkflowExecutionSpanAttributes,
+    WorkflowExecutionStreamingBody,
+    WorkflowExecutionStreamingEvent,
+    WorkflowExecutionUsageCalculationFulfilledBody,
+    WorkflowExecutionViewOnlineEvalMetricResult,
     WorkflowExecutionWorkflowResultEvent,
     WorkflowExpandMetaRequest,
+    WorkflowInitializationError,
     WorkflowNodeResultData,
     WorkflowNodeResultEvent,
     WorkflowNodeResultEventState,
@@ -485,6 +544,7 @@ from .types import (
     WorkflowOutputNumber,
     WorkflowOutputSearchResults,
     WorkflowOutputString,
+    WorkflowParentContext,
     WorkflowPushDeploymentConfigRequest,
     WorkflowPushExecConfig,
     WorkflowPushResponse,
@@ -506,6 +566,7 @@ from .types import (
     WorkflowResultEventOutputDataSearchResults,
     WorkflowResultEventOutputDataString,
     WorkflowSandboxExample,
+    WorkflowSandboxParentContext,
     WorkflowStreamEvent,
     WorkspaceRead,
     WorkspaceSecretRead,
@@ -552,6 +613,8 @@ __all__ = [
     "AddOpenaiApiKeyEnum",
     "ApiNodeResult",
     "ApiNodeResultData",
+    "ApiRequestParentContext",
+    "ApiVersionEnum",
     "ArrayChatMessageContent",
     "ArrayChatMessageContentItem",
     "ArrayChatMessageContentItemRequest",
@@ -566,6 +629,7 @@ __all__ = [
     "AudioVellumValue",
     "AudioVellumValueRequest",
     "BadRequestError",
+    "BaseOutput",
     "BasicVectorizerIntfloatMultilingualE5Large",
     "BasicVectorizerIntfloatMultilingualE5LargeRequest",
     "BasicVectorizerSentenceTransformersMultiQaMpnetBaseCosV1",
@@ -598,6 +662,7 @@ __all__ = [
     "CodeExecutorInput",
     "CodeExecutorResponse",
     "CodeExecutorSecretInput",
+    "CodeResourceDefinition",
     "CompilePromptDeploymentExpandMetaRequest",
     "CompilePromptMeta",
     "ComponentsSchemasPdfSearchResultMetaSource",
@@ -657,6 +722,7 @@ __all__ = [
     "ExecutionSearchResultsVellumValue",
     "ExecutionStringVellumValue",
     "ExecutionVellumValue",
+    "ExternalInputDescriptor",
     "ExternalTestCaseExecution",
     "ExternalTestCaseExecutionRequest",
     "FinishReasonEnum",
@@ -722,6 +788,7 @@ __all__ = [
     "InstructorVectorizerConfig",
     "InstructorVectorizerConfigRequest",
     "InternalServerError",
+    "InvokedPort",
     "IterationStateEnum",
     "JinjaPromptBlock",
     "JsonInput",
@@ -748,6 +815,7 @@ __all__ = [
     "MetricNodeResult",
     "MlModelRead",
     "MlModelUsage",
+    "MlModelUsageWrapper",
     "NamedScenarioInputChatHistoryVariableValueRequest",
     "NamedScenarioInputJsonVariableValueRequest",
     "NamedScenarioInputRequest",
@@ -771,6 +839,21 @@ __all__ = [
     "NamedTestCaseVariableValue",
     "NamedTestCaseVariableValueRequest",
     "NewMemberJoinBehaviorEnum",
+    "NodeEventDisplayContext",
+    "NodeExecutionFulfilledBody",
+    "NodeExecutionFulfilledEvent",
+    "NodeExecutionInitiatedBody",
+    "NodeExecutionInitiatedEvent",
+    "NodeExecutionPausedBody",
+    "NodeExecutionPausedEvent",
+    "NodeExecutionRejectedBody",
+    "NodeExecutionRejectedEvent",
+    "NodeExecutionResumedBody",
+    "NodeExecutionResumedEvent",
+    "NodeExecutionSpan",
+    "NodeExecutionSpanAttributes",
+    "NodeExecutionStreamingBody",
+    "NodeExecutionStreamingEvent",
     "NodeInputCompiledArrayValue",
     "NodeInputCompiledChatHistoryValue",
     "NodeInputCompiledErrorValue",
@@ -790,6 +873,7 @@ __all__ = [
     "NodeOutputCompiledSearchResultsValue",
     "NodeOutputCompiledStringValue",
     "NodeOutputCompiledValue",
+    "NodeParentContext",
     "NormalizedLogProbs",
     "NormalizedTokenLogProbs",
     "NotFoundError",
@@ -816,6 +900,7 @@ __all__ = [
     "PaginatedTestSuiteTestCaseList",
     "PaginatedWorkflowReleaseTagReadList",
     "PaginatedWorkflowSandboxExampleList",
+    "ParentContext",
     "PdfSearchResultMetaSource",
     "PdfSearchResultMetaSourceRequest",
     "PlainTextPromptBlock",
@@ -825,6 +910,7 @@ __all__ = [
     "PromptBlockState",
     "PromptDeploymentExpandMetaRequest",
     "PromptDeploymentInputRequest",
+    "PromptDeploymentParentContext",
     "PromptExecutionMeta",
     "PromptNodeExecutionMeta",
     "PromptNodeResult",
@@ -882,6 +968,9 @@ __all__ = [
     "SlimDocument",
     "SlimDocumentDocumentToDocumentIndex",
     "SlimWorkflowDeployment",
+    "SlimWorkflowExecutionRead",
+    "SpanLink",
+    "SpanLinkTypeEnum",
     "StreamingAdHocExecutePromptEvent",
     "StreamingExecutePromptEvent",
     "StreamingPromptExecutionMeta",
@@ -996,6 +1085,7 @@ __all__ = [
     "Vellum",
     "VellumAudio",
     "VellumAudioRequest",
+    "VellumCodeResourceDefinition",
     "VellumDocument",
     "VellumDocumentRequest",
     "VellumEnvironment",
@@ -1004,7 +1094,11 @@ __all__ = [
     "VellumErrorRequest",
     "VellumImage",
     "VellumImageRequest",
+    "VellumNodeExecutionEvent",
+    "VellumSdkError",
+    "VellumSdkErrorCodeEnum",
     "VellumSecret",
+    "VellumSpan",
     "VellumValue",
     "VellumValueLogicalConditionGroupRequest",
     "VellumValueLogicalConditionRequest",
@@ -1013,18 +1107,44 @@ __all__ = [
     "VellumVariable",
     "VellumVariableExtensions",
     "VellumVariableType",
+    "VellumWorkflowExecutionEvent",
+    "WorkflowDeploymentEventExecutionsResponse",
     "WorkflowDeploymentHistoryItem",
+    "WorkflowDeploymentParentContext",
     "WorkflowDeploymentRead",
     "WorkflowDeploymentsListRequestStatus",
+    "WorkflowError",
+    "WorkflowEventDisplayContext",
     "WorkflowEventError",
+    "WorkflowEventExecutionRead",
+    "WorkflowExecutionActual",
     "WorkflowExecutionActualChatHistoryRequest",
     "WorkflowExecutionActualJsonRequest",
     "WorkflowExecutionActualStringRequest",
     "WorkflowExecutionEventErrorCode",
     "WorkflowExecutionEventType",
+    "WorkflowExecutionFulfilledBody",
+    "WorkflowExecutionFulfilledEvent",
+    "WorkflowExecutionInitiatedBody",
+    "WorkflowExecutionInitiatedEvent",
     "WorkflowExecutionNodeResultEvent",
+    "WorkflowExecutionPausedBody",
+    "WorkflowExecutionPausedEvent",
+    "WorkflowExecutionRejectedBody",
+    "WorkflowExecutionRejectedEvent",
+    "WorkflowExecutionResumedBody",
+    "WorkflowExecutionResumedEvent",
+    "WorkflowExecutionSnapshottedBody",
+    "WorkflowExecutionSnapshottedEvent",
+    "WorkflowExecutionSpan",
+    "WorkflowExecutionSpanAttributes",
+    "WorkflowExecutionStreamingBody",
+    "WorkflowExecutionStreamingEvent",
+    "WorkflowExecutionUsageCalculationFulfilledBody",
+    "WorkflowExecutionViewOnlineEvalMetricResult",
     "WorkflowExecutionWorkflowResultEvent",
     "WorkflowExpandMetaRequest",
+    "WorkflowInitializationError",
     "WorkflowNodeResultData",
     "WorkflowNodeResultEvent",
     "WorkflowNodeResultEventState",
@@ -1038,6 +1158,7 @@ __all__ = [
     "WorkflowOutputNumber",
     "WorkflowOutputSearchResults",
     "WorkflowOutputString",
+    "WorkflowParentContext",
     "WorkflowPushDeploymentConfigRequest",
     "WorkflowPushExecConfig",
     "WorkflowPushResponse",
@@ -1059,6 +1180,7 @@ __all__ = [
     "WorkflowResultEventOutputDataSearchResults",
     "WorkflowResultEventOutputDataString",
     "WorkflowSandboxExample",
+    "WorkflowSandboxParentContext",
     "WorkflowStreamEvent",
     "WorkflowsPullRequestFormat",
     "WorkspaceRead",

vellum/client/core/client_wrapper.py

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

vellum/client/resources/workflow_deployments/client.py

@@ -10,6 +10,8 @@ from json.decoder import JSONDecodeError
 from ...core.api_error import ApiError
 from ...types.workflow_deployment_read import WorkflowDeploymentRead
 from ...core.jsonable_encoder import jsonable_encoder
+from ...types.workflow_deployment_event_executions_response import WorkflowDeploymentEventExecutionsResponse
+from ...types.workflow_event_execution_read import WorkflowEventExecutionRead
 from ...types.workflow_deployment_history_item import WorkflowDeploymentHistoryItem
 from .types.list_workflow_release_tags_request_source import ListWorkflowReleaseTagsRequestSource
 from ...types.paginated_workflow_release_tag_read_list import PaginatedWorkflowReleaseTagReadList
@@ -141,6 +143,122 @@ class WorkflowDeploymentsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
+    def list_workflow_deployment_event_executions(
+        self,
+        id: str,
+        *,
+        filters: typing.Optional[str] = None,
+        limit: typing.Optional[int] = None,
+        offset: typing.Optional[int] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> WorkflowDeploymentEventExecutionsResponse:
+        """
+        Parameters
+        ----------
+        id : str
+
+        filters : typing.Optional[str]
+
+        limit : typing.Optional[int]
+            Number of executions to return per page.
+
+        offset : typing.Optional[int]
+            The initial index from which to return the executions.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        WorkflowDeploymentEventExecutionsResponse
+
+
+        Examples
+        --------
+        from vellum import Vellum
+
+        client = Vellum(
+            api_key="YOUR_API_KEY",
+        )
+        client.workflow_deployments.list_workflow_deployment_event_executions(
+            id="id",
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v1/workflow-deployments/{jsonable_encoder(id)}/execution-events",
+            base_url=self._client_wrapper.get_environment().default,
+            method="GET",
+            params={
+                "filters": filters,
+                "limit": limit,
+                "offset": offset,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    WorkflowDeploymentEventExecutionsResponse,
+                    parse_obj_as(
+                        type_=WorkflowDeploymentEventExecutionsResponse,  # 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 workflow_deployment_event_execution(
+        self, execution_id: str, id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> WorkflowEventExecutionRead:
+        """
+        Parameters
+        ----------
+        execution_id : str
+
+        id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        WorkflowEventExecutionRead
+
+
+        Examples
+        --------
+        from vellum import Vellum
+
+        client = Vellum(
+            api_key="YOUR_API_KEY",
+        )
+        client.workflow_deployments.workflow_deployment_event_execution(
+            execution_id="execution_id",
+            id="id",
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v1/workflow-deployments/{jsonable_encoder(id)}/execution-events/{jsonable_encoder(execution_id)}",
+            base_url=self._client_wrapper.get_environment().default,
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    WorkflowEventExecutionRead,
+                    parse_obj_as(
+                        type_=WorkflowEventExecutionRead,  # 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 workflow_deployment_history_item_retrieve(
         self, history_id_or_release_tag: str, id: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> WorkflowDeploymentHistoryItem:
@@ -529,6 +647,138 @@ class AsyncWorkflowDeploymentsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
+    async def list_workflow_deployment_event_executions(
+        self,
+        id: str,
+        *,
+        filters: typing.Optional[str] = None,
+        limit: typing.Optional[int] = None,
+        offset: typing.Optional[int] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> WorkflowDeploymentEventExecutionsResponse:
+        """
+        Parameters
+        ----------
+        id : str
+
+        filters : typing.Optional[str]
+
+        limit : typing.Optional[int]
+            Number of executions to return per page.
+
+        offset : typing.Optional[int]
+            The initial index from which to return the executions.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        WorkflowDeploymentEventExecutionsResponse
+
+
+        Examples
+        --------
+        import asyncio
+
+        from vellum import AsyncVellum
+
+        client = AsyncVellum(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.workflow_deployments.list_workflow_deployment_event_executions(
+                id="id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v1/workflow-deployments/{jsonable_encoder(id)}/execution-events",
+            base_url=self._client_wrapper.get_environment().default,
+            method="GET",
+            params={
+                "filters": filters,
+                "limit": limit,
+                "offset": offset,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    WorkflowDeploymentEventExecutionsResponse,
+                    parse_obj_as(
+                        type_=WorkflowDeploymentEventExecutionsResponse,  # 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 workflow_deployment_event_execution(
+        self, execution_id: str, id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> WorkflowEventExecutionRead:
+        """
+        Parameters
+        ----------
+        execution_id : str
+
+        id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        WorkflowEventExecutionRead
+
+
+        Examples
+        --------
+        import asyncio
+
+        from vellum import AsyncVellum
+
+        client = AsyncVellum(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.workflow_deployments.workflow_deployment_event_execution(
+                execution_id="execution_id",
+                id="id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v1/workflow-deployments/{jsonable_encoder(id)}/execution-events/{jsonable_encoder(execution_id)}",
+            base_url=self._client_wrapper.get_environment().default,
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    WorkflowEventExecutionRead,
+                    parse_obj_as(
+                        type_=WorkflowEventExecutionRead,  # 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 workflow_deployment_history_item_retrieve(
         self, history_id_or_release_tag: str, id: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> WorkflowDeploymentHistoryItem: