vellum-ai 0.14.63__py3-none-any.whl → 1.11.2__py3-none-any.whl

vellum/workflows/tests/test_sandbox.py

@@ -1,10 +1,14 @@
 import pytest
+from datetime import datetime
+from unittest.mock import MagicMock
 from typing import List
 
 from vellum.workflows.inputs.base import BaseInputs
+from vellum.workflows.inputs.dataset_row import DatasetRow
 from vellum.workflows.nodes.bases.base import BaseNode
 from vellum.workflows.sandbox import WorkflowSandboxRunner
 from vellum.workflows.state.base import BaseState
+from vellum.workflows.triggers import ScheduleTrigger
 from vellum.workflows.workflows.base import BaseWorkflow
 
 
@@ -60,3 +64,136 @@ def test_sandbox_runner__happy_path(mock_logger, run_kwargs, expected_last_log):
         "----------------------------------",
         expected_last_log,
     ]
+
+
+def test_sandbox_runner_with_dict_inputs(mock_logger):
+    """
+    Test that WorkflowSandboxRunner can run with dict inputs in DatasetRow.
+    """
+
+    # GIVEN we capture the logs to stdout
+    logs = []
+    mock_logger.return_value.info.side_effect = lambda msg: logs.append(msg)
+
+    class Inputs(BaseInputs):
+        message: str
+
+    class StartNode(BaseNode):
+        class Outputs(BaseNode.Outputs):
+            result = Inputs.message
+
+    class Workflow(BaseWorkflow[Inputs, BaseState]):
+        graph = StartNode
+
+        class Outputs(BaseWorkflow.Outputs):
+            final_output = StartNode.Outputs.result
+
+    dataset = [
+        DatasetRow(label="test_row", inputs={"message": "Hello from dict"}),
+    ]
+
+    # WHEN we run the sandbox with the DatasetRow containing dict inputs
+    runner = WorkflowSandboxRunner(workflow=Workflow(), dataset=dataset)
+    runner.run()
+
+    assert logs == [
+        "Just started Node: StartNode",
+        "Just finished Node: StartNode",
+        "Workflow fulfilled!",
+        "----------------------------------",
+        "final_output: Hello from dict",
+    ]
+
+
+def test_sandbox_runner_with_workflow_trigger(mock_logger):
+    """
+    Test that WorkflowSandboxRunner can run with DatasetRow containing workflow_trigger.
+    """
+
+    # GIVEN we capture the logs to stdout
+    logs = []
+    mock_logger.return_value.info.side_effect = lambda msg: logs.append(msg)
+
+    class MySchedule(ScheduleTrigger):
+        class Config(ScheduleTrigger.Config):
+            cron = "* * * * *"
+            timezone = "UTC"
+
+    class StartNode(BaseNode):
+        class Outputs(BaseNode.Outputs):
+            result = MySchedule.current_run_at
+
+    class Workflow(BaseWorkflow):
+        graph = MySchedule >> StartNode
+
+        class Outputs(BaseWorkflow.Outputs):
+            final_output = StartNode.Outputs.result
+
+    # AND a dataset with workflow_trigger
+    dataset = [
+        DatasetRow(
+            label="test_row",
+            inputs={"current_run_at": datetime.min, "next_run_at": datetime.now()},
+            workflow_trigger=MySchedule,
+        ),
+    ]
+
+    # WHEN we run the sandbox with the DatasetRow containing workflow_trigger
+    runner = WorkflowSandboxRunner(workflow=Workflow(), dataset=dataset)
+    runner.run()
+
+    # THEN the workflow should run successfully
+    assert logs == [
+        "Just started Node: StartNode",
+        "Just finished Node: StartNode",
+        "Workflow fulfilled!",
+        "----------------------------------",
+        "final_output: 0001-01-01 00:00:00",
+    ]
+
+    # AND the dataset row should still have the trigger class
+    assert dataset[0].workflow_trigger == MySchedule
+
+
+def test_sandbox_runner_with_node_output_mocks(mock_logger, mocker):
+    """
+    Tests that WorkflowSandboxRunner passes node_output_mocks from DatasetRow to workflow.stream().
+    """
+
+    class Inputs(BaseInputs):
+        message: str
+
+    class TestNode(BaseNode):
+        class Outputs(BaseNode.Outputs):
+            result: str
+
+    class Workflow(BaseWorkflow[Inputs, BaseState]):
+        graph = TestNode
+
+        class Outputs(BaseWorkflow.Outputs):
+            final_output = TestNode.Outputs.result
+
+    mock_outputs = TestNode.Outputs(result="mocked_result")
+
+    # AND a dataset with node_output_mocks
+    dataset = [
+        DatasetRow(
+            label="test_with_mocks",
+            inputs={"message": "test"},
+            node_output_mocks=[mock_outputs],
+        ),
+    ]
+
+    workflow_instance = Workflow()
+    original_stream = workflow_instance.stream
+    stream_mock = MagicMock(return_value=original_stream(inputs=Inputs(message="test")))
+    mocker.patch.object(workflow_instance, "stream", stream_mock)
+
+    # WHEN we run the sandbox with the DatasetRow containing node_output_mocks
+    runner = WorkflowSandboxRunner(workflow=workflow_instance, dataset=dataset)
+    runner.run()
+
+    stream_mock.assert_called_once()
+    call_kwargs = stream_mock.call_args.kwargs
+    assert "node_output_mocks" in call_kwargs
+    assert call_kwargs["node_output_mocks"] == [mock_outputs]

vellum/workflows/tests/triggers/test_integration_trigger.py

@@ -0,0 +1,156 @@
+"""Tests for IntegrationTrigger."""
+
+import pytest
+
+from vellum.workflows.constants import VellumIntegrationProviderType
+from vellum.workflows.references.trigger import TriggerAttributeReference
+from vellum.workflows.triggers.integration import IntegrationTrigger
+
+
+def test_requires_config():
+    """Trigger classes must declare Config with required fields."""
+
+    # This should fail - no Config class
+    with pytest.raises(TypeError, match="Config"):
+
+        class BadTrigger1(IntegrationTrigger):
+            message: str
+            # Missing Config!
+
+    # This should fail - incomplete Config
+    with pytest.raises(TypeError, match="provider"):
+
+        class BadTrigger2(IntegrationTrigger):
+            message: str
+
+            class Config(IntegrationTrigger.Config):
+                integration_name = "SLACK"
+                slug = "slack_new_message"
+                # Missing provider!
+
+    # This should work
+    class GoodTrigger(IntegrationTrigger):
+        message: str
+        user: str
+
+        class Config(IntegrationTrigger.Config):
+            provider = VellumIntegrationProviderType.COMPOSIO
+            integration_name = "SLACK"
+            slug = "slack_new_message"
+
+    assert hasattr(GoodTrigger, "Config")
+
+
+def test_top_level_annotations_create_references():
+    """Top-level type annotations (webhook event attributes) automatically create TriggerAttributeReference."""
+
+    class SlackTrigger(IntegrationTrigger):
+        message: str
+        user: str
+        timestamp: float
+
+        class Config(IntegrationTrigger.Config):
+            provider = VellumIntegrationProviderType.COMPOSIO
+            integration_name = "SLACK"
+            slug = "slack_new_message"
+
+    # Should auto-create references from annotations
+    assert isinstance(SlackTrigger.message, TriggerAttributeReference)
+    assert isinstance(SlackTrigger.user, TriggerAttributeReference)
+    assert isinstance(SlackTrigger.timestamp, TriggerAttributeReference)
+    assert SlackTrigger.message.types == (str,)
+    assert SlackTrigger.timestamp.types == (float,)
+
+    # Undeclared attributes should raise AttributeError
+    with pytest.raises(AttributeError):
+        _ = SlackTrigger.undefined_attribute
+
+
+def test_attribute_ids_include_class_name():
+    """Attribute IDs should include class name (like nodes)."""
+
+    class Trigger1(IntegrationTrigger):
+        message: str
+
+        class Config(IntegrationTrigger.Config):
+            provider = VellumIntegrationProviderType.COMPOSIO
+            integration_name = "SLACK"
+            slug = "slack_new_message"
+
+    class Trigger2(IntegrationTrigger):
+        message: str
+
+        class Config(IntegrationTrigger.Config):
+            provider = VellumIntegrationProviderType.COMPOSIO
+            integration_name = "SLACK"
+            slug = "slack_new_message"
+
+    # Different class names = different IDs (like nodes)
+    # Type ignore: mypy sees message as str, but it's actually TriggerAttributeReference at class level
+    assert Trigger1.message.id != Trigger2.message.id  # type: ignore[attr-defined]
+
+
+def test_populates_dynamic_attributes():
+    """Trigger dynamically populates attributes from event_data keys."""
+
+    class GithubPushTrigger(IntegrationTrigger):
+        repository: str
+        branch: str
+        commits: list
+
+        class Config(IntegrationTrigger.Config):
+            provider = VellumIntegrationProviderType.COMPOSIO
+            integration_name = "GITHUB"
+            slug = "github_push_event"
+
+    event_data = {
+        "repository": "vellum-ai/workflows",
+        "branch": "main",
+        "commits": ["abc123", "def456"],
+    }
+
+    trigger = GithubPushTrigger(**event_data)
+
+    assert trigger.repository == "vellum-ai/workflows"
+    assert trigger.branch == "main"
+    assert trigger.commits == ["abc123", "def456"]
+
+
+def test_to_trigger_attribute_values():
+    """to_trigger_attribute_values returns correct attribute mappings."""
+
+    class SlackTrigger(IntegrationTrigger):
+        message: str
+        channel: str
+
+        class Config(IntegrationTrigger.Config):
+            provider = VellumIntegrationProviderType.COMPOSIO
+            integration_name = "SLACK"
+            slug = "slack_new_message"
+
+    event_data = {"message": "Hello", "channel": "C123"}
+    trigger = SlackTrigger(**event_data)
+
+    attr_values = trigger.to_trigger_attribute_values()
+
+    assert len(attr_values) == 2
+    for key in attr_values.keys():
+        assert isinstance(key, TriggerAttributeReference)
+    assert set(attr_values.values()) == {"Hello", "C123"}
+
+
+def test_empty_event_data():
+    """Trigger handles empty event data gracefully."""
+
+    class SlackTrigger(IntegrationTrigger):
+        message: str
+
+        class Config(IntegrationTrigger.Config):
+            provider = VellumIntegrationProviderType.COMPOSIO
+            integration_name = "SLACK"
+            slug = "slack_new_message"
+
+    trigger = SlackTrigger()
+
+    attr_values = trigger.to_trigger_attribute_values()
+    assert attr_values == {}

vellum/workflows/triggers/__init__.py

@@ -0,0 +1,6 @@
+from vellum.workflows.triggers.base import BaseTrigger
+from vellum.workflows.triggers.integration import IntegrationTrigger
+from vellum.workflows.triggers.manual import ManualTrigger
+from vellum.workflows.triggers.schedule import ScheduleTrigger
+
+__all__ = ["BaseTrigger", "IntegrationTrigger", "ManualTrigger", "ScheduleTrigger"]

vellum/workflows/triggers/base.py

@@ -0,0 +1,391 @@
+from abc import ABC, ABCMeta
+from functools import lru_cache
+import inspect
+import json
+import os
+from uuid import UUID
+from typing import TYPE_CHECKING, Any, ClassVar, Dict, Iterator, Optional, Tuple, Type, cast, get_origin
+
+from vellum.workflows.references.trigger import TriggerAttributeReference
+from vellum.workflows.types.utils import get_class_attr_names, infer_types
+from vellum.workflows.utils.files import virtual_open
+from vellum.workflows.utils.uuids import uuid4_from_hash
+from vellum_ee.workflows.display.editor import NodeDisplayComment
+
+if TYPE_CHECKING:
+    from vellum.workflows.graph.graph import Graph, GraphTarget
+    from vellum.workflows.state.base import BaseState
+
+
+def _is_annotated(cls: Type, name: str) -> bool:
+    annotations = getattr(cls, "__annotations__", {})
+    annotation = annotations.get(name)
+    if annotation is not None:
+        if get_origin(annotation) is ClassVar:
+            return False
+        return True
+
+    for base in cls.__bases__:
+        if _is_annotated(base, name):
+            return True
+
+    return False
+
+
+def _convert_to_relative_module_path(absolute_module_path: str, workflow_root: str) -> str:
+    """
+    Convert an absolute module path to a relative path from the workflow root.
+
+    Args:
+        absolute_module_path: The full module path (e.g., "workflow_id.triggers.scheduled")
+        workflow_root: The workflow root module (e.g., "workflow_id")
+
+    Returns:
+        Relative module path with leading dot (e.g., ".triggers.scheduled")
+    """
+    if not absolute_module_path.startswith(workflow_root):
+        return ""
+
+    remaining_path = absolute_module_path[len(workflow_root) :]
+    if remaining_path.startswith("."):
+        return remaining_path
+    else:
+        return "." + remaining_path
+
+
+def _get_trigger_id_from_metadata(trigger_class: Type["BaseTrigger"]) -> Optional[UUID]:
+    """
+    Get the trigger ID from metadata.json for a given trigger class.
+
+    Args:
+        trigger_class: The trigger class to look up
+
+    Returns:
+        The UUID from metadata.json, or None if not found
+    """
+    workflow_root = _find_workflow_root_with_metadata(trigger_class.__module__)
+    if not workflow_root:
+        return None
+
+    trigger_path_to_id_mapping = _get_trigger_path_to_id_mapping(trigger_class.__module__)
+    if not trigger_path_to_id_mapping:
+        return None
+
+    # Convert module path to relative path and append class name
+    # e.g., "root_module.triggers.scheduled" + "ScheduleTrigger" -> ".triggers.scheduled.ScheduleTrigger"
+    relative_module_path = _convert_to_relative_module_path(trigger_class.__module__, workflow_root)
+    if not relative_module_path:
+        return None
+
+    # Append class name to get full trigger path
+    relative_trigger_path = f"{relative_module_path}.{trigger_class.__qualname__}"
+    return trigger_path_to_id_mapping.get(relative_trigger_path)
+
+
+def _find_workflow_root_with_metadata(trigger_module: str) -> Optional[str]:
+    """
+    Find the workflow root module by searching for metadata.json up the module hierarchy.
+
+    Args:
+        trigger_module: The trigger's module path (e.g., "workflows.my_workflow.triggers.my_trigger")
+
+    Returns:
+        The workflow root module path if found, None otherwise
+    """
+    module_parts = trigger_module.split(".")
+
+    # Try searching up the module hierarchy for metadata.json
+    for i in range(len(module_parts), 0, -1):
+        potential_root = ".".join(module_parts[:i])
+        module_dir = potential_root.replace(".", os.path.sep)
+        metadata_path = os.path.join(module_dir, "metadata.json")
+
+        # Try to open the file using virtual_open to support both regular and virtual filesystems
+        # virtual_open checks BaseWorkflowFinder instances before falling back to regular open()
+        try:
+            file_handle = virtual_open(metadata_path)
+            if file_handle is not None:
+                file_handle.close()
+                return potential_root
+        except (FileNotFoundError, OSError):
+            pass
+
+    return None
+
+
+@lru_cache(maxsize=128)
+def _get_trigger_path_to_id_mapping(module_path: str) -> Dict[str, UUID]:
+    """
+    Read trigger path to ID mapping from metadata.json for a given module.
+
+    This function is cached to avoid repeated file reads. It searches up the module
+    hierarchy for metadata.json and extracts the trigger_path_to_id_mapping.
+
+    Args:
+        module_path: The module path to search from (e.g., "workflows.my_workflow.triggers.my_trigger")
+
+    Returns:
+        Dictionary mapping trigger module paths to their UUIDs
+    """
+    try:
+        # Find the workflow root that contains metadata.json
+        workflow_root = _find_workflow_root_with_metadata(module_path)
+        if not workflow_root:
+            return {}
+
+        # Convert module path to file path
+        module_dir = workflow_root.replace(".", os.path.sep)
+        metadata_path = os.path.join(module_dir, "metadata.json")
+
+        # Use virtual_open to support both regular and virtual environments
+        with virtual_open(metadata_path) as f:
+            metadata_json = json.load(f)
+            trigger_mapping = metadata_json.get("trigger_path_to_id_mapping", {})
+
+            # Convert string IDs to UUIDs
+            return {path: UUID(id_str) for path, id_str in trigger_mapping.items()}
+
+    except (FileNotFoundError, json.JSONDecodeError, ValueError, KeyError):
+        # If there's any error reading or parsing the file, return empty dict
+        return {}
+
+
+class BaseTriggerMeta(ABCMeta):
+    def __new__(mcs, name: str, bases: Tuple[Type, ...], dct: Dict[str, Any]) -> Any:
+        if "Display" not in dct:
+            for base in reversed(bases):
+                if hasattr(base, "Display"):
+                    dct["Display"] = type(
+                        f"{name}.Display",
+                        (base.Display,),
+                        {"__module__": dct["__module__"]},
+                    )
+                    break
+
+        cls = super().__new__(mcs, name, bases, dct)
+        trigger_class = cast(Type["BaseTrigger"], cls)
+
+        # Set default ID based on module and class name
+        trigger_class.__id__ = uuid4_from_hash(f"{trigger_class.__module__}.{trigger_class.__qualname__}")
+
+        # Try to override with ID from metadata.json if available
+        metadata_id = _get_trigger_id_from_metadata(trigger_class)
+        if metadata_id:
+            trigger_class.__id__ = metadata_id
+
+        return trigger_class
+
+    """
+    Metaclass for BaseTrigger that enables class-level >> operator.
+
+    This allows triggers to be used at the class level, similar to nodes:
+        ManualTrigger >> MyNode  # Class-level, no instantiation
+    """
+
+    def __getattribute__(cls, name: str) -> Any:
+        trigger_cls = cast(Type["BaseTrigger"], cls)
+        if name.startswith("_"):
+            return super().__getattribute__(name)
+
+        try:
+            attribute = super().__getattribute__(name)
+        except AttributeError as exc:
+            if _is_annotated(cls, name):
+                attribute = None
+            else:
+                raise exc
+
+        if inspect.isroutine(attribute) or isinstance(attribute, (property, classmethod, staticmethod)):
+            return attribute
+
+        if isinstance(attribute, TriggerAttributeReference):
+            return attribute
+
+        if name in cls.__dict__:
+            return attribute
+
+        if not _is_annotated(cls, name):
+            return attribute
+
+        types = infer_types(cls, name)
+        reference = TriggerAttributeReference(name=name, types=types, instance=attribute, trigger_class=trigger_cls)
+        return reference
+
+    def __iter__(cls) -> Iterator[TriggerAttributeReference]:
+        seen: Dict[str, TriggerAttributeReference] = {}
+
+        for attr_name in get_class_attr_names(cls):
+            if attr_name in seen:
+                yield seen[attr_name]
+                continue
+
+            # Skip ClassVar annotations - they're not trigger attributes
+            if not _is_annotated(cls, attr_name):
+                continue
+
+            attr_value = getattr(cls, attr_name)
+            if isinstance(attr_value, TriggerAttributeReference):
+                seen[attr_name] = attr_value
+                yield attr_value
+
+    def __rshift__(cls, other: "GraphTarget") -> "Graph":  # type: ignore[misc]
+        """
+        Enable Trigger class >> Node syntax (class-level only).
+
+        Args:
+            other: The target to connect to - can be a Node, Graph, or set of Nodes
+
+        Returns:
+            Graph: A graph object with trigger edges
+
+        Examples:
+            ManualTrigger >> MyNode
+            ManualTrigger >> {NodeA, NodeB}
+            ManualTrigger >> (NodeA >> NodeB)
+        """
+        from vellum.workflows.edges.trigger_edge import TriggerEdge
+        from vellum.workflows.graph.graph import Graph
+        from vellum.workflows.nodes.bases.base import BaseNode as BaseNodeClass
+
+        # Cast cls to the proper type for TriggerEdge
+        trigger_cls = cast(Type["BaseTrigger"], cls)
+
+        if isinstance(other, set):
+            # Trigger >> {NodeA, NodeB}
+            trigger_edges = []
+            graph_items = []
+            for item in other:
+                if isinstance(item, type) and issubclass(item, BaseNodeClass):
+                    trigger_edges.append(TriggerEdge(trigger_cls, item))
+                elif isinstance(item, Graph):
+                    # Trigger >> {Graph1, Graph2}
+                    graph_items.append(item)
+                    for entrypoint in item.entrypoints:
+                        trigger_edges.append(TriggerEdge(trigger_cls, entrypoint))
+                else:
+                    raise TypeError(
+                        f"Cannot connect trigger to {type(item).__name__}. " f"Expected BaseNode or Graph in set."
+                    )
+
+            result_graph = Graph.from_trigger_edges(trigger_edges)
+
+            for graph_item in graph_items:
+                result_graph._extend_edges(graph_item.edges)
+                result_graph._terminals.update(graph_item._terminals)
+                for existing_trigger_edge in graph_item._trigger_edges:
+                    if existing_trigger_edge not in result_graph._trigger_edges:
+                        result_graph._trigger_edges.append(existing_trigger_edge)
+
+            return result_graph
+
+        elif isinstance(other, Graph):
+            # Trigger >> Graph
+            edges = [TriggerEdge(trigger_cls, entrypoint) for entrypoint in other.entrypoints]
+            result_graph = Graph.from_trigger_edges(edges)
+            # Also include the edges from the original graph
+            result_graph._extend_edges(other.edges)
+            result_graph._terminals = other._terminals
+            return result_graph
+
+        elif isinstance(other, type) and issubclass(other, BaseNodeClass):
+            # Trigger >> Node
+            edge = TriggerEdge(trigger_cls, other)
+            return Graph.from_trigger_edge(edge)
+
+        else:
+            raise TypeError(
+                f"Cannot connect trigger to {type(other).__name__}. " f"Expected BaseNode, Graph, or set of BaseNodes."
+            )
+
+    def __rrshift__(cls, other: Any) -> "Graph":
+        """
+        Prevent Node >> Trigger class syntax.
+
+        Raises:
+            TypeError: Always, as this operation is not allowed
+        """
+        raise TypeError(
+            f"Cannot create edge targeting trigger {cls.__name__}. "
+            f"Triggers must be at the start of a graph path, not as targets. "
+            f"Did you mean: {cls.__name__} >> {other.__name__ if hasattr(other, '__name__') else other}?"
+        )
+
+
+class BaseTrigger(ABC, metaclass=BaseTriggerMeta):
+    """
+    Base class for workflow triggers - first-class graph elements.
+
+    Triggers define how and when a workflow execution is initiated. They are integrated
+    into the workflow graph using the >> operator and can connect to nodes at the class level.
+
+    Examples:
+        # Class-level usage (consistent with nodes)
+        ManualTrigger >> MyNode
+        ManualTrigger >> {NodeA, NodeB}
+        ManualTrigger >> (NodeA >> NodeB)
+
+    Subclass Hierarchy:
+        - ManualTrigger: Explicit workflow invocation (default)
+        - IntegrationTrigger: External service triggers (base for Slack, GitHub, etc.)
+        - ScheduledTrigger: Time-based triggers with cron/interval schedules
+
+    Important:
+        Triggers can only appear at the start of graph paths. Attempting to create
+        edges targeting triggers (Node >> Trigger) will raise a TypeError.
+
+    Note:
+        Like nodes, triggers work at the class level only. Do not instantiate triggers.
+    """
+
+    __id__: UUID
+
+    class Display:
+        """Optional display metadata for visual representation."""
+
+        label: str = "Trigger"
+        x: float = 0.0
+        y: float = 0.0
+        z_index: int = 0
+        icon: Optional[str] = None
+        color: Optional[str] = None
+        comment: Optional[NodeDisplayComment] = None
+
+    def __init__(self, **kwargs: Any):
+        """
+        Initialize trigger with event data.
+
+        Args:
+            **kwargs: Arbitrary keyword arguments passed during trigger instantiation.
+                     Subclasses may use these to populate trigger attributes.
+        """
+        self._event_data = kwargs
+
+        for key, value in kwargs.items():
+            setattr(self, key, value)
+
+    @classmethod
+    def attribute_references(cls) -> Dict[str, "TriggerAttributeReference[Any]"]:
+        """Return class-level trigger attribute descriptors keyed by attribute name."""
+
+        return {reference.name: reference for reference in cls}
+
+    def to_trigger_attribute_values(self) -> Dict["TriggerAttributeReference[Any]", Any]:
+        """Materialize attribute descriptor/value pairs for this trigger instance."""
+
+        attribute_values: Dict["TriggerAttributeReference[Any]", Any] = {}
+        for reference in type(self):
+            if hasattr(self, reference.name):
+                attribute_values[reference] = getattr(self, reference.name)
+            elif type(None) in reference.types:
+                attribute_values[reference] = None
+            else:
+                raise AttributeError(
+                    f"{type(self).__name__} did not populate required trigger attribute '{reference.name}'"
+                )
+
+        return attribute_values
+
+    def bind_to_state(self, state: "BaseState") -> None:
+        """Persist this trigger's attribute values onto the provided state."""
+
+        state.meta.trigger_attributes.update(self.to_trigger_attribute_values())