vellum-ai 0.9.16__py3-none-any.whl → 0.9.16rc4__py3-none-any.whl

vellum/client/types/vellum_error_request.py

@@ -0,0 +1,21 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+from .vellum_error_code_enum import VellumErrorCodeEnum
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import typing
+import pydantic
+
+
+class VellumErrorRequest(UniversalBaseModel):
+    message: str
+    code: VellumErrorCodeEnum
+
+    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/client/types/vellum_image.py

@@ -0,0 +1,20 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import typing
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class VellumImage(UniversalBaseModel):
+    src: str
+    metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = 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/client/types/vellum_image_request.py

@@ -0,0 +1,20 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import typing
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class VellumImageRequest(UniversalBaseModel):
+    src: str
+    metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = 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/client/types/vellum_value.py

@@ -0,0 +1,29 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from __future__ import annotations
+import typing
+from .string_vellum_value import StringVellumValue
+from .number_vellum_value import NumberVellumValue
+from .json_vellum_value import JsonVellumValue
+from .image_vellum_value import ImageVellumValue
+from .audio_vellum_value import AudioVellumValue
+from .function_call_vellum_value import FunctionCallVellumValue
+from .error_vellum_value import ErrorVellumValue
+from .chat_history_vellum_value import ChatHistoryVellumValue
+from .search_results_vellum_value import SearchResultsVellumValue
+import typing
+
+if typing.TYPE_CHECKING:
+    from .array_vellum_value import ArrayVellumValue
+VellumValue = typing.Union[
+    StringVellumValue,
+    NumberVellumValue,
+    JsonVellumValue,
+    ImageVellumValue,
+    AudioVellumValue,
+    FunctionCallVellumValue,
+    ErrorVellumValue,
+    "ArrayVellumValue",
+    ChatHistoryVellumValue,
+    SearchResultsVellumValue,
+]

vellum/client/types/vellum_value_logical_condition_group_request.py

@@ -0,0 +1,38 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from __future__ import annotations
+from ..core.pydantic_utilities import UniversalBaseModel
+from .array_vellum_value_request import ArrayVellumValueRequest
+import typing
+from .condition_combinator import ConditionCombinator
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+from ..core.pydantic_utilities import update_forward_refs
+
+
+class VellumValueLogicalConditionGroupRequest(UniversalBaseModel):
+    """
+    A higher-order condition that combines one or more basic conditions or other higher-order conditions.
+    """
+
+    type: typing.Literal["LOGICAL_CONDITION_GROUP"] = "LOGICAL_CONDITION_GROUP"
+    conditions: typing.List["VellumValueLogicalExpressionRequest"]
+    combinator: ConditionCombinator
+    negated: 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
+
+
+from .vellum_value_logical_expression_request import VellumValueLogicalExpressionRequest  # noqa: E402
+
+update_forward_refs(
+    ArrayVellumValueRequest, VellumValueLogicalConditionGroupRequest=VellumValueLogicalConditionGroupRequest
+)
+update_forward_refs(VellumValueLogicalConditionGroupRequest)

vellum/client/types/vellum_value_logical_condition_request.py

@@ -0,0 +1,34 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from __future__ import annotations
+from ..core.pydantic_utilities import UniversalBaseModel
+from .array_vellum_value_request import ArrayVellumValueRequest
+import typing
+from .vellum_value_request import VellumValueRequest
+from .logical_operator import LogicalOperator
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+from ..core.pydantic_utilities import update_forward_refs
+
+
+class VellumValueLogicalConditionRequest(UniversalBaseModel):
+    """
+    A basic condition comparing two Vellum values.
+    """
+
+    type: typing.Literal["LOGICAL_CONDITION"] = "LOGICAL_CONDITION"
+    lhs_variable: VellumValueRequest
+    operator: LogicalOperator
+    rhs_variable: VellumValueRequest
+
+    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
+
+
+update_forward_refs(ArrayVellumValueRequest, VellumValueLogicalConditionRequest=VellumValueLogicalConditionRequest)

vellum/client/types/vellum_value_logical_expression_request.py

@@ -0,0 +1,12 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from __future__ import annotations
+import typing
+from .vellum_value_logical_condition_request import VellumValueLogicalConditionRequest
+import typing
+
+if typing.TYPE_CHECKING:
+    from .vellum_value_logical_condition_group_request import VellumValueLogicalConditionGroupRequest
+VellumValueLogicalExpressionRequest = typing.Union[
+    VellumValueLogicalConditionRequest, "VellumValueLogicalConditionGroupRequest"
+]

vellum/client/types/vellum_value_request.py

@@ -0,0 +1,29 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from __future__ import annotations
+import typing
+from .string_vellum_value_request import StringVellumValueRequest
+from .number_vellum_value_request import NumberVellumValueRequest
+from .json_vellum_value_request import JsonVellumValueRequest
+from .image_vellum_value_request import ImageVellumValueRequest
+from .audio_vellum_value_request import AudioVellumValueRequest
+from .function_call_vellum_value_request import FunctionCallVellumValueRequest
+from .error_vellum_value_request import ErrorVellumValueRequest
+from .chat_history_vellum_value_request import ChatHistoryVellumValueRequest
+from .search_results_vellum_value_request import SearchResultsVellumValueRequest
+import typing
+
+if typing.TYPE_CHECKING:
+    from .array_vellum_value_request import ArrayVellumValueRequest
+VellumValueRequest = typing.Union[
+    StringVellumValueRequest,
+    NumberVellumValueRequest,
+    JsonVellumValueRequest,
+    ImageVellumValueRequest,
+    AudioVellumValueRequest,
+    FunctionCallVellumValueRequest,
+    ErrorVellumValueRequest,
+    "ArrayVellumValueRequest",
+    ChatHistoryVellumValueRequest,
+    SearchResultsVellumValueRequest,
+]

vellum/client/types/vellum_variable.py

@@ -0,0 +1,33 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from __future__ import annotations
+from ..core.pydantic_utilities import UniversalBaseModel
+from .array_vellum_value import ArrayVellumValue
+from .vellum_variable_type import VellumVariableType
+import typing
+from .vellum_value import VellumValue
+from .vellum_variable_extensions import VellumVariableExtensions
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+from ..core.pydantic_utilities import update_forward_refs
+
+
+class VellumVariable(UniversalBaseModel):
+    id: str
+    key: str
+    type: VellumVariableType
+    required: typing.Optional[bool] = None
+    default: typing.Optional[VellumValue] = None
+    extensions: typing.Optional[VellumVariableExtensions] = 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
+
+
+update_forward_refs(ArrayVellumValue, VellumVariable=VellumVariable)

vellum/client/types/vellum_variable_extensions.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 ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class VellumVariableExtensions(UniversalBaseModel):
+    """
+    A set of fields with additional properties for use in Vellum Variables.
+    """
+
+    color: typing.Optional[str] = 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/client/types/vellum_variable_type.py

@@ -0,0 +1,20 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+VellumVariableType = typing.Union[
+    typing.Literal[
+        "STRING",
+        "NUMBER",
+        "JSON",
+        "CHAT_HISTORY",
+        "SEARCH_RESULTS",
+        "ERROR",
+        "ARRAY",
+        "FUNCTION_CALL",
+        "IMAGE",
+        "AUDIO",
+        "NULL",
+    ],
+    typing.Any,
+]

vellum/client/types/workflow_deployment_read.py

@@ -0,0 +1,77 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from __future__ import annotations
+from ..core.pydantic_utilities import UniversalBaseModel
+from .array_vellum_value import ArrayVellumValue
+import pydantic
+import typing
+from .entity_status import EntityStatus
+from .environment_enum import EnvironmentEnum
+import datetime as dt
+from .vellum_variable import VellumVariable
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+from ..core.pydantic_utilities import update_forward_refs
+
+
+class WorkflowDeploymentRead(UniversalBaseModel):
+    id: str
+    name: str = pydantic.Field()
+    """
+    A name that uniquely identifies this workflow deployment within its workspace
+    """
+
+    label: str = pydantic.Field()
+    """
+    A human-readable label for the workflow deployment
+    """
+
+    status: typing.Optional[EntityStatus] = pydantic.Field(default=None)
+    """
+    The current status of the workflow deployment
+    
+    - `ACTIVE` - Active
+    - `ARCHIVED` - Archived
+    """
+
+    environment: typing.Optional[EnvironmentEnum] = pydantic.Field(default=None)
+    """
+    The environment this workflow deployment is used in
+    
+    - `DEVELOPMENT` - Development
+    - `STAGING` - Staging
+    - `PRODUCTION` - Production
+    """
+
+    created: dt.datetime
+    last_deployed_on: dt.datetime
+    last_deployed_history_item_id: str = pydantic.Field()
+    """
+    The ID of the history item associated with this Workflow Deployment's LATEST Release Tag
+    """
+
+    input_variables: typing.List[VellumVariable] = pydantic.Field()
+    """
+    The input variables this Workflow Deployment expects to receive values for when it is executed.
+    """
+
+    output_variables: typing.List[VellumVariable] = pydantic.Field()
+    """
+    The output variables this Workflow Deployment produces values for when it's executed.
+    """
+
+    description: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    A human-readable description of the workflow deployment
+    """
+
+    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
+
+
+update_forward_refs(ArrayVellumValue, WorkflowDeploymentRead=WorkflowDeploymentRead)

vellum/client/types/workflow_event_error.py

@@ -0,0 +1,21 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+from .workflow_execution_event_error_code import WorkflowExecutionEventErrorCode
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import typing
+import pydantic
+
+
+class WorkflowEventError(UniversalBaseModel):
+    message: str
+    code: WorkflowExecutionEventErrorCode
+
+    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/client/types/workflow_execution_actual_chat_history_request.py

@@ -0,0 +1,49 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import typing
+import pydantic
+from .chat_message_request import ChatMessageRequest
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class WorkflowExecutionActualChatHistoryRequest(UniversalBaseModel):
+    output_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The Vellum-generated ID of a workflow output. Must provide either this or output_key. output_key is typically preferred.
+    """
+
+    output_key: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The user-defined name of a workflow output. Must provide either this or output_id. Should correspond to the `Name` specified in a Final Output Node. Generally preferred over output_id.
+    """
+
+    quality: typing.Optional[float] = pydantic.Field(default=None)
+    """
+    Optionally provide a decimal number between 0.0 and 1.0 (inclusive) representing the quality of the output. 0 is the worst, 1 is the best.
+    """
+
+    metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = pydantic.Field(default=None)
+    """
+    Optionally provide additional metadata about the feedback submission.
+    """
+
+    timestamp: typing.Optional[float] = pydantic.Field(default=None)
+    """
+    Optionally provide the timestamp representing when this feedback was collected. Used for reporting purposes.
+    """
+
+    output_type: typing.Literal["CHAT_HISTORY"] = "CHAT_HISTORY"
+    desired_output_value: typing.Optional[typing.List[ChatMessageRequest]] = pydantic.Field(default=None)
+    """
+    Optionally provide the value that the output ideally should have been.
+    """
+
+    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/client/types/workflow_execution_actual_json_request.py

@@ -0,0 +1,48 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import typing
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class WorkflowExecutionActualJsonRequest(UniversalBaseModel):
+    output_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The Vellum-generated ID of a workflow output. Must provide either this or output_key. output_key is typically preferred.
+    """
+
+    output_key: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The user-defined name of a workflow output. Must provide either this or output_id. Should correspond to the `Name` specified in a Final Output Node. Generally preferred over output_id.
+    """
+
+    quality: typing.Optional[float] = pydantic.Field(default=None)
+    """
+    Optionally provide a decimal number between 0.0 and 1.0 (inclusive) representing the quality of the output. 0 is the worst, 1 is the best.
+    """
+
+    metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = pydantic.Field(default=None)
+    """
+    Optionally provide additional metadata about the feedback submission.
+    """
+
+    timestamp: typing.Optional[float] = pydantic.Field(default=None)
+    """
+    Optionally provide the timestamp representing when this feedback was collected. Used for reporting purposes.
+    """
+
+    output_type: typing.Literal["JSON"] = "JSON"
+    desired_output_value: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = pydantic.Field(default=None)
+    """
+    Optionally provide the value that the output ideally should have been.
+    """
+
+    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/client/types/workflow_execution_actual_string_request.py

@@ -0,0 +1,48 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import typing
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class WorkflowExecutionActualStringRequest(UniversalBaseModel):
+    output_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The Vellum-generated ID of a workflow output. Must provide either this or output_key. output_key is typically preferred.
+    """
+
+    output_key: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The user-defined name of a workflow output. Must provide either this or output_id. Should correspond to the `Name` specified in a Final Output Node. Generally preferred over output_id.
+    """
+
+    quality: typing.Optional[float] = pydantic.Field(default=None)
+    """
+    Optionally provide a decimal number between 0.0 and 1.0 (inclusive) representing the quality of the output. 0 is the worst, 1 is the best.
+    """
+
+    metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = pydantic.Field(default=None)
+    """
+    Optionally provide additional metadata about the feedback submission.
+    """
+
+    timestamp: typing.Optional[float] = pydantic.Field(default=None)
+    """
+    Optionally provide the timestamp representing when this feedback was collected. Used for reporting purposes.
+    """
+
+    output_type: typing.Literal["STRING"] = "STRING"
+    desired_output_value: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Optionally provide the value that the output ideally should have been.
+    """
+
+    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/client/types/workflow_execution_event_error_code.py

@@ -0,0 +1,17 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+WorkflowExecutionEventErrorCode = typing.Union[
+    typing.Literal[
+        "WORKFLOW_INITIALIZATION",
+        "WORKFLOW_CANCELLED",
+        "NODE_EXECUTION_COUNT_LIMIT_REACHED",
+        "INTERNAL_SERVER_ERROR",
+        "NODE_EXECUTION",
+        "LLM_PROVIDER",
+        "INVALID_TEMPLATE",
+        "USER_DEFINED_ERROR",
+    ],
+    typing.Any,
+]

vellum/client/types/workflow_execution_event_type.py

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

vellum/client/types/workflow_execution_node_result_event.py

@@ -0,0 +1,34 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from __future__ import annotations
+from ..core.pydantic_utilities import UniversalBaseModel
+from .array_vellum_value import ArrayVellumValue
+import typing
+from .workflow_node_result_event import WorkflowNodeResultEvent
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+from ..core.pydantic_utilities import update_forward_refs
+
+
+class WorkflowExecutionNodeResultEvent(UniversalBaseModel):
+    """
+    A NODE-level event emitted from the workflow's execution.
+    """
+
+    execution_id: str
+    run_id: typing.Optional[str] = None
+    external_id: typing.Optional[str] = None
+    type: typing.Literal["NODE"] = "NODE"
+    data: WorkflowNodeResultEvent
+
+    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
+
+
+update_forward_refs(ArrayVellumValue, WorkflowExecutionNodeResultEvent=WorkflowExecutionNodeResultEvent)

vellum/client/types/workflow_execution_workflow_result_event.py

@@ -0,0 +1,36 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from __future__ import annotations
+from ..core.pydantic_utilities import UniversalBaseModel
+from .array_variable_value import ArrayVariableValue
+from .array_vellum_value import ArrayVellumValue
+import typing
+from .workflow_result_event import WorkflowResultEvent
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+from ..core.pydantic_utilities import update_forward_refs
+
+
+class WorkflowExecutionWorkflowResultEvent(UniversalBaseModel):
+    """
+    A WORKFLOW-level event emitted from the workflow's execution.
+    """
+
+    execution_id: str
+    run_id: typing.Optional[str] = None
+    external_id: typing.Optional[str] = None
+    type: typing.Literal["WORKFLOW"] = "WORKFLOW"
+    data: WorkflowResultEvent
+
+    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
+
+
+update_forward_refs(ArrayVariableValue, WorkflowExecutionWorkflowResultEvent=WorkflowExecutionWorkflowResultEvent)
+update_forward_refs(ArrayVellumValue, WorkflowExecutionWorkflowResultEvent=WorkflowExecutionWorkflowResultEvent)

vellum/client/types/workflow_expand_meta_request.py

@@ -0,0 +1,22 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import typing
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class WorkflowExpandMetaRequest(UniversalBaseModel):
+    usage: typing.Optional[bool] = pydantic.Field(default=None)
+    """
+    If enabled, the Prompt Node FULFILLED events will include model host usage tracking. This may increase latency for some model hosts.
+    """
+
+    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