vellum-ai 1.3.0__py3-none-any.whl → 1.3.2__py3-none-any.whl

vellum/__init__.py

@@ -78,6 +78,7 @@ from .client.types import (
     ContainerImageContainerImageTag,
     ContainerImageRead,
     CreateTestSuiteTestCaseRequest,
+    CreateWorkflowEventRequest,
     DelimiterChunkerConfig,
     DelimiterChunkerConfigRequest,
     DelimiterChunking,
@@ -88,6 +89,7 @@ from .client.types import (
     DeploymentRead,
     DeploymentReleaseTagDeploymentHistoryItem,
     DeploymentReleaseTagRead,
+    DeprecatedPromptRequestInput,
     DockerServiceToken,
     DocumentChatMessageContent,
     DocumentChatMessageContentRequest,
@@ -624,6 +626,7 @@ from .client.types import (
     WorkflowExecutionWorkflowResultEvent,
     WorkflowExpandMetaRequest,
     WorkflowInitializationError,
+    WorkflowInput,
     WorkflowNodeResultData,
     WorkflowNodeResultEvent,
     WorkflowNodeResultEventState,
@@ -784,6 +787,7 @@ __all__ = [
     "ContainerImageContainerImageTag",
     "ContainerImageRead",
     "CreateTestSuiteTestCaseRequest",
+    "CreateWorkflowEventRequest",
     "DelimiterChunkerConfig",
     "DelimiterChunkerConfigRequest",
     "DelimiterChunking",
@@ -795,6 +799,7 @@ __all__ = [
     "DeploymentReleaseTagDeploymentHistoryItem",
     "DeploymentReleaseTagRead",
     "DeploymentsListRequestStatus",
+    "DeprecatedPromptRequestInput",
     "DockerServiceToken",
     "DocumentChatMessageContent",
     "DocumentChatMessageContentRequest",
@@ -1344,6 +1349,7 @@ __all__ = [
     "WorkflowExecutionWorkflowResultEvent",
     "WorkflowExpandMetaRequest",
     "WorkflowInitializationError",
+    "WorkflowInput",
     "WorkflowNodeResultData",
     "WorkflowNodeResultEvent",
     "WorkflowNodeResultEventState",

vellum/client/README.md

@@ -103,7 +103,7 @@ The SDK supports streaming responses, as well, the response will be a generator
 from vellum import (
     JinjaPromptBlock,
     PromptParameters,
-    PromptRequestStringInput,
+    StringInput,
     Vellum,
     VellumVariable,
 )
@@ -115,12 +115,12 @@ client = Vellum(
 response = client.ad_hoc.adhoc_execute_prompt_stream(
     ml_model="x",
     input_values=[
-        PromptRequestStringInput(
-            key="x",
+        StringInput(
+            name="x",
             value="value",
         ),
-        PromptRequestStringInput(
-            key="x",
+        StringInput(
+            name="x",
             value="value",
         ),
     ],

vellum/client/__init__.py

@@ -479,6 +479,7 @@ class Vellum:
         release_tag: typing.Optional[str] = OMIT,
         external_id: typing.Optional[str] = OMIT,
         metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
+        previous_execution_id: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> ExecuteWorkflowResponse:
         """
@@ -507,6 +508,9 @@ class Vellum:
         metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
             Arbitrary JSON metadata associated with this request. Can be used to capture additional monitoring data such as user id, session id, etc. for future analysis.
 
+        previous_execution_id : typing.Optional[str]
+            The ID of a previous Workflow Execution to reference for initial State loading.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -544,6 +548,7 @@ class Vellum:
             release_tag=release_tag,
             external_id=external_id,
             metadata=metadata,
+            previous_execution_id=previous_execution_id,
             request_options=request_options,
         )
         return _response.data
@@ -559,6 +564,7 @@ class Vellum:
         external_id: typing.Optional[str] = OMIT,
         event_types: typing.Optional[typing.Sequence[WorkflowExecutionEventType]] = OMIT,
         metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
+        previous_execution_id: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.Iterator[WorkflowStreamEvent]:
         """
@@ -590,6 +596,9 @@ class Vellum:
         metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
             Arbitrary JSON metadata associated with this request. Can be used to capture additional monitoring data such as user id, session id, etc. for future analysis.
 
+        previous_execution_id : typing.Optional[str]
+            The ID of a previous Workflow Execution to reference for initial State loading.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -630,6 +639,7 @@ class Vellum:
             external_id=external_id,
             event_types=event_types,
             metadata=metadata,
+            previous_execution_id=previous_execution_id,
             request_options=request_options,
         ) as r:
             yield from r.data
@@ -1376,6 +1386,7 @@ class AsyncVellum:
         release_tag: typing.Optional[str] = OMIT,
         external_id: typing.Optional[str] = OMIT,
         metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
+        previous_execution_id: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> ExecuteWorkflowResponse:
         """
@@ -1404,6 +1415,9 @@ class AsyncVellum:
         metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
             Arbitrary JSON metadata associated with this request. Can be used to capture additional monitoring data such as user id, session id, etc. for future analysis.
 
+        previous_execution_id : typing.Optional[str]
+            The ID of a previous Workflow Execution to reference for initial State loading.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -1449,6 +1463,7 @@ class AsyncVellum:
             release_tag=release_tag,
             external_id=external_id,
             metadata=metadata,
+            previous_execution_id=previous_execution_id,
             request_options=request_options,
         )
         return _response.data
@@ -1464,6 +1479,7 @@ class AsyncVellum:
         external_id: typing.Optional[str] = OMIT,
         event_types: typing.Optional[typing.Sequence[WorkflowExecutionEventType]] = OMIT,
         metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
+        previous_execution_id: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.AsyncIterator[WorkflowStreamEvent]:
         """
@@ -1495,6 +1511,9 @@ class AsyncVellum:
         metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
             Arbitrary JSON metadata associated with this request. Can be used to capture additional monitoring data such as user id, session id, etc. for future analysis.
 
+        previous_execution_id : typing.Optional[str]
+            The ID of a previous Workflow Execution to reference for initial State loading.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -1543,6 +1562,7 @@ class AsyncVellum:
             external_id=external_id,
             event_types=event_types,
             metadata=metadata,
+            previous_execution_id=previous_execution_id,
             request_options=request_options,
         ) as r:
             async for _chunk in r.data:

vellum/client/core/client_wrapper.py

@@ -27,10 +27,10 @@ class BaseClientWrapper:
 
     def get_headers(self) -> typing.Dict[str, str]:
         headers: typing.Dict[str, str] = {
-            "User-Agent": "vellum-ai/1.3.0",
+            "User-Agent": "vellum-ai/1.3.2",
             "X-Fern-Language": "Python",
             "X-Fern-SDK-Name": "vellum-ai",
-            "X-Fern-SDK-Version": "1.3.0",
+            "X-Fern-SDK-Version": "1.3.2",
             **(self.get_custom_headers() or {}),
         }
         if self._api_version is not None:

vellum/client/raw_client.py

@@ -515,6 +515,7 @@ class RawVellum:
         release_tag: typing.Optional[str] = OMIT,
         external_id: typing.Optional[str] = OMIT,
         metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
+        previous_execution_id: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[ExecuteWorkflowResponse]:
         """
@@ -543,6 +544,9 @@ class RawVellum:
         metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
             Arbitrary JSON metadata associated with this request. Can be used to capture additional monitoring data such as user id, session id, etc. for future analysis.
 
+        previous_execution_id : typing.Optional[str]
+            The ID of a previous Workflow Execution to reference for initial State loading.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -567,6 +571,7 @@ class RawVellum:
                 "release_tag": release_tag,
                 "external_id": external_id,
                 "metadata": metadata,
+                "previous_execution_id": previous_execution_id,
             },
             headers={
                 "content-type": "application/json",
@@ -634,6 +639,7 @@ class RawVellum:
         external_id: typing.Optional[str] = OMIT,
         event_types: typing.Optional[typing.Sequence[WorkflowExecutionEventType]] = OMIT,
         metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
+        previous_execution_id: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.Iterator[HttpResponse[typing.Iterator[WorkflowStreamEvent]]]:
         """
@@ -665,6 +671,9 @@ class RawVellum:
         metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
             Arbitrary JSON metadata associated with this request. Can be used to capture additional monitoring data such as user id, session id, etc. for future analysis.
 
+        previous_execution_id : typing.Optional[str]
+            The ID of a previous Workflow Execution to reference for initial State loading.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -690,6 +699,7 @@ class RawVellum:
                 "external_id": external_id,
                 "event_types": event_types,
                 "metadata": metadata,
+                "previous_execution_id": previous_execution_id,
             },
             headers={
                 "content-type": "application/json",
@@ -1728,6 +1738,7 @@ class AsyncRawVellum:
         release_tag: typing.Optional[str] = OMIT,
         external_id: typing.Optional[str] = OMIT,
         metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
+        previous_execution_id: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[ExecuteWorkflowResponse]:
         """
@@ -1756,6 +1767,9 @@ class AsyncRawVellum:
         metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
             Arbitrary JSON metadata associated with this request. Can be used to capture additional monitoring data such as user id, session id, etc. for future analysis.
 
+        previous_execution_id : typing.Optional[str]
+            The ID of a previous Workflow Execution to reference for initial State loading.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -1780,6 +1794,7 @@ class AsyncRawVellum:
                 "release_tag": release_tag,
                 "external_id": external_id,
                 "metadata": metadata,
+                "previous_execution_id": previous_execution_id,
             },
             headers={
                 "content-type": "application/json",
@@ -1847,6 +1862,7 @@ class AsyncRawVellum:
         external_id: typing.Optional[str] = OMIT,
         event_types: typing.Optional[typing.Sequence[WorkflowExecutionEventType]] = OMIT,
         metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
+        previous_execution_id: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.AsyncIterator[AsyncHttpResponse[typing.AsyncIterator[WorkflowStreamEvent]]]:
         """
@@ -1878,6 +1894,9 @@ class AsyncRawVellum:
         metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
             Arbitrary JSON metadata associated with this request. Can be used to capture additional monitoring data such as user id, session id, etc. for future analysis.
 
+        previous_execution_id : typing.Optional[str]
+            The ID of a previous Workflow Execution to reference for initial State loading.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -1903,6 +1922,7 @@ class AsyncRawVellum:
                 "external_id": external_id,
                 "event_types": event_types,
                 "metadata": metadata,
+                "previous_execution_id": previous_execution_id,
             },
             headers={
                 "content-type": "application/json",

vellum/client/reference.md

@@ -605,6 +605,14 @@ client.execute_workflow(
 <dl>
 <dd>
 
+**previous_execution_id:** `typing.Optional[str]` — The ID of a previous Workflow Execution to reference for initial State loading.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
 **request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.
     
 </dd>
@@ -743,6 +751,14 @@ for chunk in response.data:
 <dl>
 <dd>
 
+**previous_execution_id:** `typing.Optional[str]` — The ID of a previous Workflow Execution to reference for initial State loading.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
 **request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.
     
 </dd>
@@ -1262,7 +1278,7 @@ client.submit_workflow_execution_actuals(
 <dl>
 <dd>
 
-Accept an event and publish it to ClickHouse for analytics processing.
+Accept an event or list of events and publish them to ClickHouse for analytics processing.
 </dd>
 </dl>
 </dd>
@@ -1291,22 +1307,40 @@ client = Vellum(
     api_key="YOUR_API_KEY",
 )
 client.events.create(
-    request=NodeExecutionInitiatedEvent(
-        body=NodeExecutionInitiatedBody(
-            node_definition=VellumCodeResourceDefinition(
-                name="name",
-                module=["module", "module"],
-                id="id",
+    request=[
+        NodeExecutionInitiatedEvent(
+            body=NodeExecutionInitiatedBody(
+                node_definition=VellumCodeResourceDefinition(
+                    name="name",
+                    module=["module", "module"],
+                    id="id",
+                ),
+                inputs={"inputs": {"key": "value"}},
             ),
-            inputs={"inputs": {"key": "value"}},
+            id="id",
+            timestamp=datetime.datetime.fromisoformat(
+                "2024-01-15 09:30:00+00:00",
+            ),
+            trace_id="trace_id",
+            span_id="span_id",
         ),
-        id="id",
-        timestamp=datetime.datetime.fromisoformat(
-            "2024-01-15 09:30:00+00:00",
+        NodeExecutionInitiatedEvent(
+            body=NodeExecutionInitiatedBody(
+                node_definition=VellumCodeResourceDefinition(
+                    name="name",
+                    module=["module", "module"],
+                    id="id",
+                ),
+                inputs={"inputs": {"key": "value"}},
+            ),
+            id="id",
+            timestamp=datetime.datetime.fromisoformat(
+                "2024-01-15 09:30:00+00:00",
+            ),
+            trace_id="trace_id",
+            span_id="span_id",
         ),
-        trace_id="trace_id",
-        span_id="span_id",
-    ),
+    ],
 )
 
 ```
@@ -1323,7 +1357,7 @@ client.events.create(
 <dl>
 <dd>
 
-**request:** `WorkflowEvent` 
+**request:** `CreateWorkflowEventRequest` 
     
 </dd>
 </dl>
@@ -1360,7 +1394,7 @@ client.events.create(
 from vellum import (
     JinjaPromptBlock,
     PromptParameters,
-    PromptRequestStringInput,
+    StringInput,
     Vellum,
     VellumVariable,
 )
@@ -1372,12 +1406,12 @@ client = Vellum(
 client.ad_hoc.adhoc_execute_prompt(
     ml_model="x",
     input_values=[
-        PromptRequestStringInput(
-            key="x",
+        StringInput(
+            name="x",
             value="value",
         ),
-        PromptRequestStringInput(
-            key="x",
+        StringInput(
+            name="x",
             value="value",
         ),
     ],
@@ -1426,7 +1460,7 @@ client.ad_hoc.adhoc_execute_prompt(
 <dl>
 <dd>
 
-**input_values:** `typing.Sequence[PromptRequestInput]` 
+**input_values:** `typing.Sequence[DeprecatedPromptRequestInput]` 
     
 </dd>
 </dl>
@@ -1510,7 +1544,7 @@ client.ad_hoc.adhoc_execute_prompt(
 from vellum import (
     JinjaPromptBlock,
     PromptParameters,
-    PromptRequestStringInput,
+    StringInput,
     Vellum,
     VellumVariable,
 )
@@ -1522,12 +1556,12 @@ client = Vellum(
 response = client.ad_hoc.adhoc_execute_prompt_stream(
     ml_model="x",
     input_values=[
-        PromptRequestStringInput(
-            key="x",
+        StringInput(
+            name="x",
             value="value",
         ),
-        PromptRequestStringInput(
-            key="x",
+        StringInput(
+            name="x",
             value="value",
         ),
     ],
@@ -1578,7 +1612,7 @@ for chunk in response.data:
 <dl>
 <dd>
 
-**input_values:** `typing.Sequence[PromptRequestInput]` 
+**input_values:** `typing.Sequence[DeprecatedPromptRequestInput]` 
     
 </dd>
 </dl>

vellum/client/resources/ad_hoc/client.py

@@ -6,10 +6,10 @@ from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
 from ...core.request_options import RequestOptions
 from ...types.ad_hoc_execute_prompt_event import AdHocExecutePromptEvent
 from ...types.ad_hoc_expand_meta import AdHocExpandMeta
+from ...types.deprecated_prompt_request_input import DeprecatedPromptRequestInput
 from ...types.function_definition import FunctionDefinition
 from ...types.prompt_block import PromptBlock
 from ...types.prompt_parameters import PromptParameters
-from ...types.prompt_request_input import PromptRequestInput
 from ...types.prompt_settings import PromptSettings
 from ...types.vellum_variable import VellumVariable
 from .raw_client import AsyncRawAdHocClient, RawAdHocClient
@@ -41,7 +41,7 @@ class AdHocClient:
         self,
         *,
         ml_model: str,
-        input_values: typing.Sequence[PromptRequestInput],
+        input_values: typing.Sequence[DeprecatedPromptRequestInput],
         input_variables: typing.Sequence[VellumVariable],
         parameters: PromptParameters,
         blocks: typing.Sequence[PromptBlock],
@@ -55,7 +55,7 @@ class AdHocClient:
         ----------
         ml_model : str
 
-        input_values : typing.Sequence[PromptRequestInput]
+        input_values : typing.Sequence[DeprecatedPromptRequestInput]
 
         input_variables : typing.Sequence[VellumVariable]
 
@@ -82,7 +82,7 @@ class AdHocClient:
         from vellum import (
             JinjaPromptBlock,
             PromptParameters,
-            PromptRequestStringInput,
+            StringInput,
             Vellum,
             VellumVariable,
         )
@@ -94,12 +94,12 @@ class AdHocClient:
         client.ad_hoc.adhoc_execute_prompt(
             ml_model="x",
             input_values=[
-                PromptRequestStringInput(
-                    key="x",
+                StringInput(
+                    name="x",
                     value="value",
                 ),
-                PromptRequestStringInput(
-                    key="x",
+                StringInput(
+                    name="x",
                     value="value",
                 ),
             ],
@@ -143,7 +143,7 @@ class AdHocClient:
         self,
         *,
         ml_model: str,
-        input_values: typing.Sequence[PromptRequestInput],
+        input_values: typing.Sequence[DeprecatedPromptRequestInput],
         input_variables: typing.Sequence[VellumVariable],
         parameters: PromptParameters,
         blocks: typing.Sequence[PromptBlock],
@@ -157,7 +157,7 @@ class AdHocClient:
         ----------
         ml_model : str
 
-        input_values : typing.Sequence[PromptRequestInput]
+        input_values : typing.Sequence[DeprecatedPromptRequestInput]
 
         input_variables : typing.Sequence[VellumVariable]
 
@@ -184,7 +184,7 @@ class AdHocClient:
         from vellum import (
             JinjaPromptBlock,
             PromptParameters,
-            PromptRequestStringInput,
+            StringInput,
             Vellum,
             VellumVariable,
         )
@@ -196,12 +196,12 @@ class AdHocClient:
         response = client.ad_hoc.adhoc_execute_prompt_stream(
             ml_model="x",
             input_values=[
-                PromptRequestStringInput(
-                    key="x",
+                StringInput(
+                    name="x",
                     value="value",
                 ),
-                PromptRequestStringInput(
-                    key="x",
+                StringInput(
+                    name="x",
                     value="value",
                 ),
             ],
@@ -263,7 +263,7 @@ class AsyncAdHocClient:
         self,
         *,
         ml_model: str,
-        input_values: typing.Sequence[PromptRequestInput],
+        input_values: typing.Sequence[DeprecatedPromptRequestInput],
         input_variables: typing.Sequence[VellumVariable],
         parameters: PromptParameters,
         blocks: typing.Sequence[PromptBlock],
@@ -277,7 +277,7 @@ class AsyncAdHocClient:
         ----------
         ml_model : str
 
-        input_values : typing.Sequence[PromptRequestInput]
+        input_values : typing.Sequence[DeprecatedPromptRequestInput]
 
         input_variables : typing.Sequence[VellumVariable]
 
@@ -307,7 +307,7 @@ class AsyncAdHocClient:
             AsyncVellum,
             JinjaPromptBlock,
             PromptParameters,
-            PromptRequestStringInput,
+            StringInput,
             VellumVariable,
         )
 
@@ -321,12 +321,12 @@ class AsyncAdHocClient:
             await client.ad_hoc.adhoc_execute_prompt(
                 ml_model="x",
                 input_values=[
-                    PromptRequestStringInput(
-                        key="x",
+                    StringInput(
+                        name="x",
                         value="value",
                     ),
-                    PromptRequestStringInput(
-                        key="x",
+                    StringInput(
+                        name="x",
                         value="value",
                     ),
                 ],
@@ -373,7 +373,7 @@ class AsyncAdHocClient:
         self,
         *,
         ml_model: str,
-        input_values: typing.Sequence[PromptRequestInput],
+        input_values: typing.Sequence[DeprecatedPromptRequestInput],
         input_variables: typing.Sequence[VellumVariable],
         parameters: PromptParameters,
         blocks: typing.Sequence[PromptBlock],
@@ -387,7 +387,7 @@ class AsyncAdHocClient:
         ----------
         ml_model : str
 
-        input_values : typing.Sequence[PromptRequestInput]
+        input_values : typing.Sequence[DeprecatedPromptRequestInput]
 
         input_variables : typing.Sequence[VellumVariable]
 
@@ -417,7 +417,7 @@ class AsyncAdHocClient:
             AsyncVellum,
             JinjaPromptBlock,
             PromptParameters,
-            PromptRequestStringInput,
+            StringInput,
             VellumVariable,
         )
 
@@ -431,12 +431,12 @@ class AsyncAdHocClient:
             response = await client.ad_hoc.adhoc_execute_prompt_stream(
                 ml_model="x",
                 input_values=[
-                    PromptRequestStringInput(
-                        key="x",
+                    StringInput(
+                        name="x",
                         value="value",
                     ),
-                    PromptRequestStringInput(
-                        key="x",
+                    StringInput(
+                        name="x",
                         value="value",
                     ),
                 ],