vellum-ai 1.2.2__tar.gz → 1.2.3__tar.gz

{vellum_ai-1.2.2 → vellum_ai-1.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: vellum-ai
-Version: 1.2.2
+Version: 1.2.3
 Summary: 
 License: MIT
 Requires-Python: >=3.9,<4.0

{vellum_ai-1.2.2 → vellum_ai-1.2.3}/ee/vellum_ee/workflows/display/nodes/vellum/error_node.py

@@ -2,7 +2,7 @@ from uuid import UUID
 from typing import Any, ClassVar, Generic, Optional, TypeVar
 
 from vellum.workflows.nodes import ErrorNode
-from vellum.workflows.types.core import JsonArray, JsonObject
+from vellum.workflows.types.core import JsonObject
 from vellum_ee.workflows.display.nodes.base_node_display import BaseNodeDisplay
 from vellum_ee.workflows.display.nodes.utils import raise_if_descriptor
 from vellum_ee.workflows.display.nodes.vellum.utils import create_node_input
@@ -20,10 +20,6 @@ class BaseErrorNodeDisplay(BaseNodeDisplay[_ErrorNodeType], Generic[_ErrorNodeTy
 
     __serializable_inputs__ = {ErrorNode.error}
 
-    def serialize_ports(self, display_context: "WorkflowDisplayContext") -> JsonArray:
-        """Error nodes have no ports."""
-        return []
-
     def serialize(self, display_context: WorkflowDisplayContext, **_kwargs) -> JsonObject:
         node_id = self.node_id
         error_source_input_id = self.node_input_ids_by_name.get(

{vellum_ai-1.2.2 → vellum_ai-1.2.3}/ee/vellum_ee/workflows/display/nodes/vellum/final_output_node.py

@@ -2,7 +2,7 @@ from uuid import UUID
 from typing import ClassVar, Generic, Optional, TypeVar
 
 from vellum.workflows.nodes.displayable.final_output_node import FinalOutputNode
-from vellum.workflows.types.core import JsonArray, JsonObject
+from vellum.workflows.types.core import JsonObject
 from vellum.workflows.utils.uuids import uuid4_from_hash
 from vellum_ee.workflows.display.nodes.base_node_display import BaseNodeDisplay
 from vellum_ee.workflows.display.nodes.utils import to_kebab_case
@@ -19,10 +19,6 @@ NODE_INPUT_KEY = "node_input"
 class BaseFinalOutputNodeDisplay(BaseNodeDisplay[_FinalOutputNodeType], Generic[_FinalOutputNodeType]):
     output_name: ClassVar[Optional[str]] = None
 
-    def serialize_ports(self, display_context: "WorkflowDisplayContext") -> JsonArray:
-        """Final output nodes have no ports."""
-        return []
-
     def serialize(self, display_context: WorkflowDisplayContext, **_kwargs) -> JsonObject:
         node = self._node
         node_id = self.node_id

vellum_ai-1.2.3/ee/vellum_ee/workflows/display/utils/events.py

@@ -0,0 +1,24 @@
+from vellum.workflows.events.workflow import WorkflowExecutionInitiatedEvent
+from vellum_ee.workflows.display.utils.registry import (
+    get_parent_display_context_from_event,
+    register_workflow_display_class,
+    register_workflow_display_context,
+)
+from vellum_ee.workflows.display.workflows.get_vellum_workflow_display_class import get_workflow_display
+
+
+def event_enricher(event: WorkflowExecutionInitiatedEvent) -> WorkflowExecutionInitiatedEvent:
+    workflow_definition = event.body.workflow_definition
+    workflow_display = get_workflow_display(
+        workflow_class=workflow_definition,
+        parent_display_context=get_parent_display_context_from_event(event),
+        dry_run=True,
+    )
+    register_workflow_display_context(event.span_id, workflow_display.display_context)
+
+    if event.body.workflow_definition.is_dynamic:
+        register_workflow_display_class(workflow_definition, workflow_display.__class__)
+        workflow_version_exec_config = workflow_display.serialize()
+        setattr(event.body, "workflow_version_exec_config", workflow_version_exec_config)
+
+    return event

vellum_ai-1.2.3/ee/vellum_ee/workflows/display/utils/tests/test_events.py

@@ -0,0 +1,69 @@
+import pytest
+from uuid import uuid4
+from typing import Optional
+
+from vellum.workflows.events.workflow import WorkflowExecutionInitiatedBody, WorkflowExecutionInitiatedEvent
+from vellum.workflows.inputs.base import BaseInputs
+from vellum.workflows.workflows.base import BaseWorkflow
+from vellum_ee.workflows.display.utils.events import event_enricher
+
+
+@pytest.mark.parametrize(
+    "is_dynamic,expected_config",
+    [
+        (False, None),
+        (
+            True,
+            {
+                "workflow_raw_data": {
+                    "nodes": [
+                        {
+                            "id": "86607b18-7872-49f3-a592-fda1428f70aa",
+                            "type": "ENTRYPOINT",
+                            "inputs": [],
+                            "data": {
+                                "label": "Entrypoint Node",
+                                "source_handle_id": "d1fe8f4c-53d7-43a0-b210-73ebdc60bf57",
+                            },
+                            "display_data": {"position": {"x": 0.0, "y": -50.0}},
+                            "base": None,
+                            "definition": None,
+                        }
+                    ],
+                    "edges": [],
+                    "display_data": {"viewport": {"x": 0.0, "y": 0.0, "zoom": 1.0}},
+                    "definition": {
+                        "name": "TestWorkflow",
+                        "module": ["vellum_ee", "workflows", "display", "utils", "tests", "test_events"],
+                    },
+                    "output_values": [],
+                },
+                "input_variables": [],
+                "state_variables": [],
+                "output_variables": [],
+            },
+        ),
+    ],
+)
+def test_event_enricher_static_workflow(is_dynamic: bool, expected_config: Optional[dict]):
+    """Test event_enricher with a static workflow (is_dynamic=False)."""
+    # GIVEN a workflow class with the specified is_dynamic value
+    _is_dynamic = is_dynamic
+
+    class TestWorkflow(BaseWorkflow):
+        is_dynamic = _is_dynamic
+
+    event: WorkflowExecutionInitiatedEvent = WorkflowExecutionInitiatedEvent(
+        trace_id=uuid4(),
+        span_id=uuid4(),
+        body=WorkflowExecutionInitiatedBody(
+            workflow_definition=TestWorkflow,
+            inputs=BaseInputs(),
+        ),
+    )
+
+    # WHEN the event_enricher is called with mocked dependencies
+    event_enricher(event)
+
+    # AND workflow_version_exec_config is set to the expected config
+    assert event.body.workflow_version_exec_config == expected_config

{vellum_ai-1.2.2 → vellum_ai-1.2.3}/ee/vellum_ee/workflows/tests/test_server.py

@@ -8,6 +8,7 @@ from vellum.client.types.number_vellum_value import NumberVellumValue
 from vellum.workflows import BaseWorkflow
 from vellum.workflows.nodes import BaseNode
 from vellum.workflows.state.context import WorkflowContext
+from vellum.workflows.utils.uuids import generate_workflow_deployment_prefix
 from vellum_ee.workflows.display.workflows.base_workflow_display import BaseWorkflowDisplay
 from vellum_ee.workflows.server.virtual_file_loader import VirtualFileFinder
 
@@ -566,3 +567,97 @@ class Workflow(BaseWorkflow[Inputs, BaseState]):
 
     # THEN the serialization should complete successfully
     assert result is not None
+
+
+def test_resolve_workflow_deployment__returns_workflow_with_generated_files():
+    """
+    Test that resolve_workflow_deployment returns a workflow with artifacts
+    in generated_files using the correct prefix format.
+    """
+    # GIVEN a deployment name and release tag
+    deployment_name = "test_deployment"
+    release_tag = "LATEST"
+
+    expected_prefix = generate_workflow_deployment_prefix(deployment_name, release_tag)
+
+    # Create a simple test node for the resolved workflow
+    test_node_code = """
+from vellum.workflows.nodes.bases.base import BaseNode
+from vellum.workflows.outputs import BaseOutputs
+
+class TestNode(BaseNode):
+    template = "Hello"
+
+    class Outputs(BaseOutputs):
+        result: str
+
+    def run(self):
+        return self.Outputs(result="Hello, {template}")
+"""
+
+    mock_workflow_code = """
+from vellum.workflows import BaseWorkflow
+from .nodes.test_node import TestNode
+
+class ResolvedWorkflow(BaseWorkflow):
+    graph = TestNode
+"""
+
+    # Create parent workflow files that reference the subworkflow deployment
+    parent_workflow_code = """
+from vellum.workflows import BaseWorkflow
+from .nodes.subworkflow_deployment_node import TestSubworkflowDeploymentNode
+
+class ParentWorkflow(BaseWorkflow):
+    graph = TestSubworkflowDeploymentNode
+"""
+
+    parent_node_code = """
+from vellum.workflows.nodes import SubworkflowDeploymentNode
+from vellum.workflows.outputs import BaseOutputs
+
+class TestSubworkflowDeploymentNode(SubworkflowDeploymentNode):
+    deployment = "test_deployment"
+
+    class Outputs(BaseOutputs):
+        result: str
+
+    subworkflow_inputs = {"message": "test"}
+"""
+
+    files = {
+        "__init__.py": "",
+        "workflow.py": parent_workflow_code,
+        "nodes/__init__.py": """
+from .subworkflow_deployment_node import TestSubworkflowDeploymentNode
+
+__all__ = ["TestSubworkflowDeploymentNode"]
+""",
+        "nodes/subworkflow_deployment_node.py": parent_node_code,
+        f"{expected_prefix}/__init__.py": "",
+        f"{expected_prefix}/workflow.py": mock_workflow_code,
+        f"{expected_prefix}/nodes/__init__.py": """
+from .test_node import TestNode
+
+__all__ = ["TestNode"]
+""",
+        f"{expected_prefix}/nodes/test_node.py": test_node_code,
+    }
+
+    namespace = str(uuid4())
+
+    # AND the virtual file loader is registered
+    finder = VirtualFileFinder(files, namespace)
+    sys.meta_path.append(finder)
+
+    # WHEN we execute the root workflow
+    Workflow = BaseWorkflow.load_from_module(namespace)
+    workflow = Workflow(context=WorkflowContext(generated_files=files, namespace=namespace))
+
+    # THEN the workflow should be successfully initialized
+    assert workflow
+
+    event = workflow.run()
+
+    # AND the method should return a workflow (not None) - this will pass once implemented
+    assert event.name == "workflow.execution.fulfilled"

{vellum_ai-1.2.2 → vellum_ai-1.2.3}/pyproject.toml

@@ -3,7 +3,7 @@ name = "vellum-ai"
 
 [tool.poetry]
 name = "vellum-ai"
-version = "1.2.2"
+version = "1.2.3"
 description = ""
 readme = "README.md"
 authors = []

{vellum_ai-1.2.2 → vellum_ai-1.2.3}/src/vellum/__init__.py

@@ -26,6 +26,7 @@ from .client.types import (
     ArrayVellumValueRequest,
     AudioChatMessageContent,
     AudioChatMessageContentRequest,
+    AudioInputRequest,
     AudioPromptBlock,
     AudioVellumValue,
     AudioVellumValueRequest,
@@ -76,6 +77,10 @@ from .client.types import (
     ContainerImageContainerImageTag,
     ContainerImageRead,
     CreateTestSuiteTestCaseRequest,
+    DelimiterChunkerConfig,
+    DelimiterChunkerConfigRequest,
+    DelimiterChunking,
+    DelimiterChunkingRequest,
     DeploymentHistoryItem,
     DeploymentProviderPayloadResponse,
     DeploymentProviderPayloadResponsePayload,
@@ -91,6 +96,7 @@ from .client.types import (
     DocumentIndexIndexingConfig,
     DocumentIndexIndexingConfigRequest,
     DocumentIndexRead,
+    DocumentInputRequest,
     DocumentProcessingState,
     DocumentPromptBlock,
     DocumentRead,
@@ -118,15 +124,19 @@ from .client.types import (
     ExecuteWorkflowResponse,
     ExecuteWorkflowWorkflowResultEvent,
     ExecutionArrayVellumValue,
+    ExecutionAudioVellumValue,
     ExecutionChatHistoryVellumValue,
+    ExecutionDocumentVellumValue,
     ExecutionErrorVellumValue,
     ExecutionFunctionCallVellumValue,
+    ExecutionImageVellumValue,
     ExecutionJsonVellumValue,
     ExecutionNumberVellumValue,
     ExecutionSearchResultsVellumValue,
     ExecutionStringVellumValue,
     ExecutionThinkingVellumValue,
     ExecutionVellumValue,
+    ExecutionVideoVellumValue,
     ExternalInputDescriptor,
     ExternalParentContext,
     ExternalTestCaseExecution,
@@ -185,6 +195,7 @@ from .client.types import (
     HkunlpInstructorXlVectorizerRequest,
     ImageChatMessageContent,
     ImageChatMessageContentRequest,
+    ImageInputRequest,
     ImagePromptBlock,
     ImageVellumValue,
     ImageVellumValueRequest,
@@ -260,14 +271,18 @@ from .client.types import (
     NodeExecutionStreamingBody,
     NodeExecutionStreamingEvent,
     NodeInputCompiledArrayValue,
+    NodeInputCompiledAudioValue,
     NodeInputCompiledChatHistoryValue,
+    NodeInputCompiledDocumentValue,
     NodeInputCompiledErrorValue,
     NodeInputCompiledFunctionCallValue,
+    NodeInputCompiledImageValue,
     NodeInputCompiledJsonValue,
     NodeInputCompiledNumberValue,
     NodeInputCompiledSearchResultsValue,
     NodeInputCompiledSecretValue,
     NodeInputCompiledStringValue,
+    NodeInputCompiledVideoValue,
     NodeInputVariableCompiledValue,
     NodeOutputCompiledArrayValue,
     NodeOutputCompiledChatHistoryValue,
@@ -327,10 +342,14 @@ from .client.types import (
     PromptOutput,
     PromptParameters,
     PromptPushResponse,
+    PromptRequestAudioInput,
     PromptRequestChatHistoryInput,
+    PromptRequestDocumentInput,
+    PromptRequestImageInput,
     PromptRequestInput,
     PromptRequestJsonInput,
     PromptRequestStringInput,
+    PromptRequestVideoInput,
     PromptSettings,
     PromptVersionBuildConfigSandbox,
     RawPromptExecutionOverridesRequest,
@@ -534,6 +553,7 @@ from .client.types import (
     VellumWorkflowExecutionEvent,
     VideoChatMessageContent,
     VideoChatMessageContentRequest,
+    VideoInputRequest,
     VideoPromptBlock,
     VideoVellumValue,
     VideoVellumValueRequest,
@@ -683,6 +703,7 @@ __all__ = [
     "AsyncVellum",
     "AudioChatMessageContent",
     "AudioChatMessageContentRequest",
+    "AudioInputRequest",
     "AudioPromptBlock",
     "AudioVellumValue",
     "AudioVellumValueRequest",
@@ -734,6 +755,10 @@ __all__ = [
     "ContainerImageContainerImageTag",
     "ContainerImageRead",
     "CreateTestSuiteTestCaseRequest",
+    "DelimiterChunkerConfig",
+    "DelimiterChunkerConfigRequest",
+    "DelimiterChunking",
+    "DelimiterChunkingRequest",
     "DeploymentHistoryItem",
     "DeploymentProviderPayloadResponse",
     "DeploymentProviderPayloadResponsePayload",
@@ -751,6 +776,7 @@ __all__ = [
     "DocumentIndexIndexingConfigRequest",
     "DocumentIndexRead",
     "DocumentIndexesListRequestStatus",
+    "DocumentInputRequest",
     "DocumentProcessingState",
     "DocumentPromptBlock",
     "DocumentRead",
@@ -778,15 +804,19 @@ __all__ = [
     "ExecuteWorkflowResponse",
     "ExecuteWorkflowWorkflowResultEvent",
     "ExecutionArrayVellumValue",
+    "ExecutionAudioVellumValue",
     "ExecutionChatHistoryVellumValue",
+    "ExecutionDocumentVellumValue",
     "ExecutionErrorVellumValue",
     "ExecutionFunctionCallVellumValue",
+    "ExecutionImageVellumValue",
     "ExecutionJsonVellumValue",
     "ExecutionNumberVellumValue",
     "ExecutionSearchResultsVellumValue",
     "ExecutionStringVellumValue",
     "ExecutionThinkingVellumValue",
     "ExecutionVellumValue",
+    "ExecutionVideoVellumValue",
     "ExternalInputDescriptor",
     "ExternalParentContext",
     "ExternalTestCaseExecution",
@@ -847,6 +877,7 @@ __all__ = [
     "HkunlpInstructorXlVectorizerRequest",
     "ImageChatMessageContent",
     "ImageChatMessageContentRequest",
+    "ImageInputRequest",
     "ImagePromptBlock",
     "ImageVellumValue",
     "ImageVellumValueRequest",
@@ -926,14 +957,18 @@ __all__ = [
     "NodeExecutionStreamingBody",
     "NodeExecutionStreamingEvent",
     "NodeInputCompiledArrayValue",
+    "NodeInputCompiledAudioValue",
     "NodeInputCompiledChatHistoryValue",
+    "NodeInputCompiledDocumentValue",
     "NodeInputCompiledErrorValue",
     "NodeInputCompiledFunctionCallValue",
+    "NodeInputCompiledImageValue",
     "NodeInputCompiledJsonValue",
     "NodeInputCompiledNumberValue",
     "NodeInputCompiledSearchResultsValue",
     "NodeInputCompiledSecretValue",
     "NodeInputCompiledStringValue",
+    "NodeInputCompiledVideoValue",
     "NodeInputVariableCompiledValue",
     "NodeOutputCompiledArrayValue",
     "NodeOutputCompiledChatHistoryValue",
@@ -994,10 +1029,14 @@ __all__ = [
     "PromptOutput",
     "PromptParameters",
     "PromptPushResponse",
+    "PromptRequestAudioInput",
     "PromptRequestChatHistoryInput",
+    "PromptRequestDocumentInput",
+    "PromptRequestImageInput",
     "PromptRequestInput",
     "PromptRequestJsonInput",
     "PromptRequestStringInput",
+    "PromptRequestVideoInput",
     "PromptSettings",
     "PromptVersionBuildConfigSandbox",
     "RawPromptExecutionOverridesRequest",
@@ -1205,6 +1244,7 @@ __all__ = [
     "VellumWorkflowExecutionEvent",
     "VideoChatMessageContent",
     "VideoChatMessageContentRequest",
+    "VideoInputRequest",
     "VideoPromptBlock",
     "VideoVellumValue",
     "VideoVellumValueRequest",

{vellum_ai-1.2.2 → vellum_ai-1.2.3}/src/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.2.2",
+            "User-Agent": "vellum-ai/1.2.3",
             "X-Fern-Language": "Python",
             "X-Fern-SDK-Name": "vellum-ai",
-            "X-Fern-SDK-Version": "1.2.2",
+            "X-Fern-SDK-Version": "1.2.3",
             **(self.get_custom_headers() or {}),
         }
         if self._api_version is not None:

{vellum_ai-1.2.2 → vellum_ai-1.2.3}/src/vellum/client/core/pydantic_utilities.py

@@ -6,6 +6,7 @@ from collections import defaultdict
 from typing import Any, Callable, ClassVar, Dict, List, Mapping, Optional, Set, Tuple, Type, TypeVar, Union, cast
 
 import pydantic
+from pydantic import SerializationInfo
 import logging
 
 logger = logging.getLogger(__name__)
@@ -70,8 +71,8 @@ class UniversalBaseModel(pydantic.BaseModel):
         )
 
         @pydantic.model_serializer(mode="plain", when_used="json")  # type: ignore[attr-defined]
-        def serialize_model(self) -> Any:  # type: ignore[name-defined]
-            serialized = self.model_dump()
+        def serialize_model(self, info: SerializationInfo) -> Any:  # type: ignore[name-defined]
+            serialized = self.model_dump(context=info.context)
             data = {k: serialize_datetime(v) if isinstance(v, dt.datetime) else v for k, v in serialized.items()}
             return data
 

{vellum_ai-1.2.2 → vellum_ai-1.2.3}/src/vellum/client/reference.md

@@ -6172,6 +6172,22 @@ client.workflow_executions.retrieve_workflow_execution_detail(
 <dl>
 <dd>
 
+**prev_span_id:** `typing.Optional[str]` — Optional keyset cursor span_id to continue from (exclusive)
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**span_limit:** `typing.Optional[int]` — Maximum number of spans to return (for lazy loading)
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
 **request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.
     
 </dd>

{vellum_ai-1.2.2 → vellum_ai-1.2.3}/src/vellum/client/resources/workflow_executions/client.py

@@ -28,13 +28,24 @@ class WorkflowExecutionsClient:
         return self._raw_client
 
     def retrieve_workflow_execution_detail(
-        self, execution_id: str, *, request_options: typing.Optional[RequestOptions] = None
+        self,
+        execution_id: str,
+        *,
+        prev_span_id: typing.Optional[str] = None,
+        span_limit: typing.Optional[int] = None,
+        request_options: typing.Optional[RequestOptions] = None,
     ) -> WorkflowExecutionDetail:
         """
         Parameters
         ----------
         execution_id : str
 
+        prev_span_id : typing.Optional[str]
+            Optional keyset cursor span_id to continue from (exclusive)
+
+        span_limit : typing.Optional[int]
+            Maximum number of spans to return (for lazy loading)
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -55,7 +66,9 @@ class WorkflowExecutionsClient:
             execution_id="execution_id",
         )
         """
-        _response = self._raw_client.retrieve_workflow_execution_detail(execution_id, request_options=request_options)
+        _response = self._raw_client.retrieve_workflow_execution_detail(
+            execution_id, prev_span_id=prev_span_id, span_limit=span_limit, request_options=request_options
+        )
         return _response.data
 
 
@@ -75,13 +88,24 @@ class AsyncWorkflowExecutionsClient:
         return self._raw_client
 
     async def retrieve_workflow_execution_detail(
-        self, execution_id: str, *, request_options: typing.Optional[RequestOptions] = None
+        self,
+        execution_id: str,
+        *,
+        prev_span_id: typing.Optional[str] = None,
+        span_limit: typing.Optional[int] = None,
+        request_options: typing.Optional[RequestOptions] = None,
     ) -> WorkflowExecutionDetail:
         """
         Parameters
         ----------
         execution_id : str
 
+        prev_span_id : typing.Optional[str]
+            Optional keyset cursor span_id to continue from (exclusive)
+
+        span_limit : typing.Optional[int]
+            Maximum number of spans to return (for lazy loading)
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -111,6 +135,6 @@ class AsyncWorkflowExecutionsClient:
         asyncio.run(main())
         """
         _response = await self._raw_client.retrieve_workflow_execution_detail(
-            execution_id, request_options=request_options
+            execution_id, prev_span_id=prev_span_id, span_limit=span_limit, request_options=request_options
         )
         return _response.data

{vellum_ai-1.2.2 → vellum_ai-1.2.3}/src/vellum/client/resources/workflow_executions/raw_client.py

@@ -17,13 +17,24 @@ class RawWorkflowExecutionsClient:
         self._client_wrapper = client_wrapper
 
     def retrieve_workflow_execution_detail(
-        self, execution_id: str, *, request_options: typing.Optional[RequestOptions] = None
+        self,
+        execution_id: str,
+        *,
+        prev_span_id: typing.Optional[str] = None,
+        span_limit: typing.Optional[int] = None,
+        request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[WorkflowExecutionDetail]:
         """
         Parameters
         ----------
         execution_id : str
 
+        prev_span_id : typing.Optional[str]
+            Optional keyset cursor span_id to continue from (exclusive)
+
+        span_limit : typing.Optional[int]
+            Maximum number of spans to return (for lazy loading)
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -36,6 +47,10 @@ class RawWorkflowExecutionsClient:
             f"v1/workflow-executions/{jsonable_encoder(execution_id)}/detail",
             base_url=self._client_wrapper.get_environment().default,
             method="GET",
+            params={
+                "prev_span_id": prev_span_id,
+                "span_limit": span_limit,
+            },
             request_options=request_options,
         )
         try:
@@ -59,13 +74,24 @@ class AsyncRawWorkflowExecutionsClient:
         self._client_wrapper = client_wrapper
 
     async def retrieve_workflow_execution_detail(
-        self, execution_id: str, *, request_options: typing.Optional[RequestOptions] = None
+        self,
+        execution_id: str,
+        *,
+        prev_span_id: typing.Optional[str] = None,
+        span_limit: typing.Optional[int] = None,
+        request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[WorkflowExecutionDetail]:
         """
         Parameters
         ----------
         execution_id : str
 
+        prev_span_id : typing.Optional[str]
+            Optional keyset cursor span_id to continue from (exclusive)
+
+        span_limit : typing.Optional[int]
+            Maximum number of spans to return (for lazy loading)
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -78,6 +104,10 @@ class AsyncRawWorkflowExecutionsClient:
             f"v1/workflow-executions/{jsonable_encoder(execution_id)}/detail",
             base_url=self._client_wrapper.get_environment().default,
             method="GET",
+            params={
+                "prev_span_id": prev_span_id,
+                "span_limit": span_limit,
+            },
             request_options=request_options,
         )
         try: