griptape-nodes 0.60.4__py3-none-any.whl → 0.62.0__py3-none-any.whl

griptape_nodes/node_library/workflow_registry.py

@@ -45,7 +45,7 @@ class WorkflowShape(BaseModel):
 
 
 class WorkflowMetadata(BaseModel):
-    LATEST_SCHEMA_VERSION: ClassVar[str] = "0.10.0"
+    LATEST_SCHEMA_VERSION: ClassVar[str] = "0.12.0"
 
     name: str
     schema_version: str

griptape_nodes/retained_mode/events/execution_events.py

@@ -95,6 +95,47 @@ class StartFlowResultFailure(ResultPayloadFailure):
     validation_exceptions: list[Exception]
 
 
+@dataclass
+@PayloadRegistry.register
+class StartFlowFromNodeRequest(RequestPayload):
+    """Start executing a flow from a specific node.
+
+    Use when: Resuming execution from a particular node, debugging specific parts of a flow,
+    re-running portions of a workflow, implementing custom execution control.
+
+    Args:
+        flow_name: Name of the flow to start (deprecated)
+        node_name: Name of the node to start execution from
+        debug_mode: Whether to run in debug mode (default: False)
+        pickle_control_flow_result: If this is true, the final ControlFLowResolvedEvent will be pickled to be picked up from inside a subprocess
+
+    Results: StartFlowFromNodeResultSuccess | StartFlowFromNodeResultFailure (with validation exceptions)
+    """
+
+    flow_name: str | None = None
+    node_name: str | None = None
+    debug_mode: bool = False
+    pickle_control_flow_result: bool = False
+
+
+@dataclass
+@PayloadRegistry.register
+class StartFlowFromNodeResultSuccess(WorkflowAlteredMixin, ResultPayloadSuccess):
+    """Flow started from node successfully. Execution is now running from the specified node."""
+
+
+@dataclass
+@PayloadRegistry.register
+class StartFlowFromNodeResultFailure(ResultPayloadFailure):
+    """Flow start from node failed. Contains validation errors that prevented execution.
+
+    Args:
+        validation_exceptions: List of validation errors that occurred
+    """
+
+    validation_exceptions: list[Exception]
+
+
 @dataclass
 @PayloadRegistry.register
 class CancelFlowRequest(RequestPayload):

griptape_nodes/retained_mode/events/node_events.py

@@ -10,7 +10,11 @@ from griptape_nodes.exe_types.node_types import NodeResolutionState
 if TYPE_CHECKING:
     from griptape_nodes.exe_types.core_types import NodeMessagePayload
     from griptape_nodes.exe_types.node_types import NodeDependencies
-    from griptape_nodes.retained_mode.events.connection_events import ListConnectionsForNodeResultSuccess
+    from griptape_nodes.retained_mode.events.connection_events import (
+        IncomingConnection,
+        ListConnectionsForNodeResultSuccess,
+        OutgoingConnection,
+    )
     from griptape_nodes.retained_mode.events.parameter_events import (
         GetParameterDetailsResultSuccess,
         GetParameterValueResultSuccess,
@@ -819,3 +823,88 @@ class GetFlowForNodeResultFailure(WorkflowNotAlteredMixin, ResultPayloadFailure)
 
     Common causes: node not found, node not assigned to any flow.
     """
+
+
+@dataclass
+@PayloadRegistry.register
+class CanResetNodeToDefaultsRequest(RequestPayload):
+    """Check if a node can be reset to its default state.
+
+    Use when: Need to validate whether a node reset operation is allowed before attempting it,
+    implementing UI state (enabled/disabled reset button), or providing user feedback.
+    Checks for conditions that would prevent reset (locked state, missing metadata, etc.).
+
+    Args:
+        node_name: Name of the node to check (None for current context node)
+
+    Results: CanResetNodeToDefaultsResultSuccess (with can_reset flag and reason) | CanResetNodeToDefaultsResultFailure (validation failed)
+    """
+
+    node_name: str | None = None
+
+
+@dataclass
+@PayloadRegistry.register
+class CanResetNodeToDefaultsResultSuccess(WorkflowNotAlteredMixin, ResultPayloadSuccess):
+    """Node reset check completed successfully.
+
+    Args:
+        can_reset: True if the node can be reset to defaults, False otherwise
+        editor_tooltip_reason: Optional explanation if node cannot be reset (e.g., "Cannot reset locked node")
+    """
+
+    can_reset: bool
+    editor_tooltip_reason: str | None = None
+
+
+@dataclass
+@PayloadRegistry.register
+class CanResetNodeToDefaultsResultFailure(WorkflowNotAlteredMixin, ResultPayloadFailure):
+    """Node reset check failed.
+
+    Common causes: node not found, no current context, no library metadata.
+    """
+
+
+@dataclass
+@PayloadRegistry.register
+class ResetNodeToDefaultsRequest(RequestPayload):
+    """Reset a node to its default state while preserving connections where possible.
+
+    Use when: Need to reset a node's configuration back to defaults, clear customizations,
+    fix broken node state, or restore a node to its initial state. Creates a fresh instance
+    of the same node type and reconnects it to the workflow.
+
+    Args:
+        node_name: Name of the node to reset (None for current context node)
+
+    Results: ResetNodeToDefaultsResultSuccess (with reconnection status) | ResetNodeToDefaultsResultFailure (reset failed)
+    """
+
+    node_name: str | None = None
+
+
+@dataclass
+@PayloadRegistry.register
+class ResetNodeToDefaultsResultSuccess(WorkflowAlteredMixin, ResultPayloadSuccess):
+    """Node reset to defaults successfully.
+
+    Args:
+        node_name: Name of the reset node
+        failed_incoming_connections: List of incoming connections that failed to reconnect
+        failed_outgoing_connections: List of outgoing connections that failed to reconnect
+    """
+
+    node_name: str
+    failed_incoming_connections: list[IncomingConnection]
+    failed_outgoing_connections: list[OutgoingConnection]
+
+
+@dataclass
+@PayloadRegistry.register
+class ResetNodeToDefaultsResultFailure(ResultPayloadFailure):
+    """Node reset to defaults failed.
+
+    Common causes: node not found, no current context, failed to create new node,
+    failed to delete old node, failed to rename new node.
+    """

griptape_nodes/retained_mode/events/os_events.py

@@ -366,3 +366,111 @@ class WriteFileResultFailure(WorkflowNotAlteredMixin, ResultPayloadFailure):
     """
 
     failure_reason: FileIOFailureReason
+
+
+@dataclass
+@PayloadRegistry.register
+class CopyTreeRequest(RequestPayload):
+    """Copy an entire directory tree from source to destination.
+
+    Use when: Copying directories recursively, backing up directory structures,
+    duplicating folder hierarchies with all contents.
+
+    Args:
+        source_path: Path to the source directory to copy
+        destination_path: Path where the directory tree should be copied
+        symlinks: If True, copy symbolic links as links (default: False)
+        ignore_dangling_symlinks: If True, ignore dangling symlinks (default: False)
+        dirs_exist_ok: If True, allow destination to exist (default: False)
+        ignore_patterns: List of glob patterns to ignore (e.g., ["__pycache__", "*.pyc", ".git"])
+
+    Results: CopyTreeResultSuccess | CopyTreeResultFailure
+    """
+
+    source_path: str
+    destination_path: str
+    symlinks: bool = False
+    ignore_dangling_symlinks: bool = False
+    dirs_exist_ok: bool = False
+    ignore_patterns: list[str] | None = None
+
+
+@dataclass
+@PayloadRegistry.register
+class CopyTreeResultSuccess(WorkflowNotAlteredMixin, ResultPayloadSuccess):
+    """Directory tree copied successfully.
+
+    Attributes:
+        source_path: Source path that was copied
+        destination_path: Destination path where tree was copied
+        files_copied: Number of files copied
+        total_bytes_copied: Total bytes copied
+    """
+
+    source_path: str
+    destination_path: str
+    files_copied: int
+    total_bytes_copied: int
+
+
+@dataclass
+@PayloadRegistry.register
+class CopyTreeResultFailure(WorkflowNotAlteredMixin, ResultPayloadFailure):
+    """Directory tree copy failed.
+
+    Attributes:
+        failure_reason: Classification of why the copy failed
+        result_details: Human-readable error message (inherited from ResultPayloadFailure)
+    """
+
+    failure_reason: FileIOFailureReason
+
+
+@dataclass
+@PayloadRegistry.register
+class CopyFileRequest(RequestPayload):
+    """Copy a single file from source to destination.
+
+    Use when: Copying individual files, duplicating files,
+    backing up single files.
+
+    Args:
+        source_path: Path to the source file to copy
+        destination_path: Path where the file should be copied
+        overwrite: If True, overwrite destination if it exists (default: False)
+
+    Results: CopyFileResultSuccess | CopyFileResultFailure
+    """
+
+    source_path: str
+    destination_path: str
+    overwrite: bool = False
+
+
+@dataclass
+@PayloadRegistry.register
+class CopyFileResultSuccess(WorkflowNotAlteredMixin, ResultPayloadSuccess):
+    """File copied successfully.
+
+    Attributes:
+        source_path: Source path that was copied
+        destination_path: Destination path where file was copied
+        bytes_copied: Number of bytes copied
+    """
+
+    source_path: str
+    destination_path: str
+    bytes_copied: int
+
+
+@dataclass
+@PayloadRegistry.register
+class CopyFileResultFailure(WorkflowNotAlteredMixin, ResultPayloadFailure):
+    """File copy failed.
+
+    Attributes:
+        failure_reason: Classification of why the copy failed
+        result_details: Human-readable error message (inherited from ResultPayloadFailure)
+    """
+
+    failure_reason: FileIOFailureReason

griptape_nodes/retained_mode/events/parameter_events.py

@@ -161,7 +161,7 @@ class SetParameterValueRequest(RequestPayload):
     """
 
     parameter_name: str
-    value: Any
+    value: str | int | float | bool | dict | None
     # If node name is None, use the Current Context
     node_name: str | None = None
     data_type: str | None = None