griptape-nodes 0.68.1__tar.gz → 0.69.0__tar.gz

{griptape_nodes-0.68.1 → griptape_nodes-0.69.0}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.3
 Name: griptape-nodes
-Version: 0.68.1
+Version: 0.69.0
 Summary: Add your description here
-Requires-Dist: griptape>=1.8.12
+Requires-Dist: griptape>=1.9.0
 Requires-Dist: pydantic>=2.10.6
 Requires-Dist: python-dotenv>=1.0.1
 Requires-Dist: xdg-base-dirs>=6.0.2
 Requires-Dist: httpx>=0.28.0,<1.0.0
-Requires-Dist: websockets>=15.0.1,<16.0.0
+Requires-Dist: websockets>=15.0.1,<17.0.0
 Requires-Dist: tomlkit>=0.13.2
 Requires-Dist: uv>=0.6.16
 Requires-Dist: fastapi>=0.115.12

{griptape_nodes-0.68.1 → griptape_nodes-0.69.0}/pyproject.toml

@@ -1,16 +1,16 @@
 [project]
 name = "griptape-nodes"
-version = "0.68.1"
+version = "0.69.0"
 description = "Add your description here"
 readme = "README.md"
 requires-python = ">=3.12.0, <3.13"
 dependencies = [
-  "griptape>=1.8.12",
+  "griptape>=1.9.0",
   "pydantic>=2.10.6",
   "python-dotenv>=1.0.1",
   "xdg-base-dirs>=6.0.2",
   "httpx>=0.28.0,<1.0.0",
-  "websockets>=15.0.1,<16.0.0",
+  "websockets>=15.0.1,<17.0.0",
   "tomlkit>=0.13.2",
   # TODO: https://github.com/griptape-ai/griptape-nodes/issues/833
   "uv>=0.6.16",

{griptape_nodes-0.68.1 → griptape_nodes-0.69.0}/src/griptape_nodes/exe_types/node_groups/base_node_group.py

@@ -65,8 +65,7 @@ class BaseNodeGroup(BaseNode):
         Args:
             nodes: A list of nodes to add to this group
         """
-        for node in nodes:
-            self.nodes[node.name] = node
+        self._add_nodes_to_group_dict(nodes)
 
         node_names_in_group = set(self.nodes.keys())
         self.metadata["node_names_in_group"] = list(node_names_in_group)
@@ -93,3 +92,24 @@ class BaseNodeGroup(BaseNode):
             if node.name not in self.nodes:
                 msg = f"Node {node.name} is not in node group {self.name}"
                 raise ValueError(msg)
+
+    def handle_child_node_rename(self, old_name: str, new_name: str) -> None:
+        """Update group membership when a child node is renamed.
+
+        Args:
+            old_name: The old name of the child node
+            new_name: The new name of the child node
+        """
+        if old_name not in self.nodes:
+            return
+
+        # Update the nodes dictionary
+        node = self.nodes.pop(old_name)
+        self.nodes[new_name] = node
+
+        # Update the metadata
+        node_names_in_group = self.metadata.get("node_names_in_group", [])
+        if old_name in node_names_in_group:
+            node_names_in_group.remove(old_name)
+            node_names_in_group.append(new_name)
+            self.metadata["node_names_in_group"] = node_names_in_group

{griptape_nodes-0.68.1 → griptape_nodes-0.69.0}/src/griptape_nodes/exe_types/node_types.py

@@ -1623,7 +1623,7 @@ class EndNode(BaseNode):
             self,
             was_successful_modes={ParameterMode.PROPERTY},
             result_details_modes={ParameterMode.INPUT},
-            parameter_group_initially_collapsed=False,
+            parameter_group_initially_collapsed=True,
             result_details_placeholder="Details about the completion or failure will be shown here.",
         )
 

{griptape_nodes-0.68.1 → griptape_nodes-0.69.0}/src/griptape_nodes/exe_types/param_components/execution_status_component.py

@@ -83,6 +83,17 @@ class ExecutionStatusComponent:
         """
         return self._status_group
 
+    def _update_status_group_display_label(self, *, show_warning: bool) -> None:
+        """Update the Status ParameterGroup display label with optional warning emoji."""
+        if show_warning:
+            self._status_group.update_ui_options_key("display_name", "⚠️ Status")
+            return
+
+        # Remove display_name to use default "Status" from name
+        ui_options = self._status_group.ui_options.copy()
+        ui_options.pop("display_name", None)
+        self._status_group.ui_options = ui_options
+
     def set_execution_result(self, *, was_successful: bool, result_details: str) -> None:
         """Set the execution result values.
 
@@ -92,6 +103,8 @@ class ExecutionStatusComponent:
         """
         self._update_parameter_value(self._was_successful, was_successful)
         self._update_parameter_value(self._result_details, result_details)
+        # Update display label: show warning emoji on failure
+        self._update_status_group_display_label(show_warning=not was_successful)
 
     def clear_execution_status(self, initial_message: str | None = None) -> None:
         """Clear execution status and reset parameters.
@@ -102,6 +115,8 @@ class ExecutionStatusComponent:
         if initial_message is None:
             initial_message = ""
         self.set_execution_result(was_successful=False, result_details=initial_message)
+        # Reset to "Status" during execution (not a failure yet)
+        self._update_status_group_display_label(show_warning=False)
 
     def append_to_result_details(self, additional_text: str, separator: str = "\n") -> None:
         """Append text to the existing result_details.

{griptape_nodes-0.68.1 → griptape_nodes-0.69.0}/src/griptape_nodes/exe_types/param_components/seed_parameter.py

@@ -3,6 +3,8 @@ from typing import Any
 
 from griptape_nodes.exe_types.core_types import Parameter, ParameterMode
 from griptape_nodes.exe_types.node_types import BaseNode
+from griptape_nodes.exe_types.param_types.parameter_bool import ParameterBool
+from griptape_nodes.exe_types.param_types.parameter_int import ParameterInt
 
 
 class SeedParameter:
@@ -10,24 +12,20 @@ class SeedParameter:
         self._node = node
         self._max_seed = max_seed
 
-    def add_input_parameters(self) -> None:
-        self._node.add_parameter(
-            Parameter(
-                name="randomize_seed",
-                type="bool",
-                output_type="bool",
-                tooltip="randomize the seed on each run",
-                default_value=False,
-            )
+    def add_input_parameters(self, *, inside_param_group: bool = False) -> None:
+        randomize_seed_parameter = ParameterBool(
+            name="randomize_seed",
+            tooltip="randomize the seed on each run",
+            default_value=False,
         )
-        self._node.add_parameter(
-            Parameter(
-                name="seed",
-                type="int",
-                tooltip="seed",
-                default_value=42,
-            )
+        seed_parameter = ParameterInt(
+            name="seed",
+            tooltip="the seed to use for the generation",
+            default_value=42,
         )
+        if not inside_param_group:
+            self._node.add_parameter(randomize_seed_parameter)
+            self._node.add_parameter(seed_parameter)
 
     def remove_input_parameters(self) -> None:
         self._node.remove_parameter_element_by_name("randomize_seed")

{griptape_nodes-0.68.1 → griptape_nodes-0.69.0}/src/griptape_nodes/retained_mode/events/node_events.py

@@ -390,8 +390,6 @@ class GetAllNodeInfoResultFailure(WorkflowNotAlteredMixin, ResultPayloadFailure)
 class SetLockNodeStateRequest(WorkflowNotAlteredMixin, RequestPayload):
     """Lock a node.
 
-    Use when: Implementing locking functionality, preventing changes to nodes.
-
     Args:
         node_name: Name of the node to lock
         lock: Whether to lock or unlock the node. If true, the node will be locked, otherwise it will be unlocked.
@@ -418,6 +416,39 @@ class SetLockNodeStateResultFailure(WorkflowNotAlteredMixin, ResultPayloadFailur
     """Node failed to lock."""
 
 
+@dataclass
+@PayloadRegistry.register
+class BatchSetNodeLockStateRequest(WorkflowNotAlteredMixin, RequestPayload):
+    """Set lock state for multiple nodes in a single request.
+
+    Use when: Locking or unlocking multiple nodes at once, consistent with BatchSetNodeMetadataRequest.
+
+    Args:
+        node_names: Names of nodes to lock/unlock.
+        lock: Whether to lock (True) or unlock (False) the nodes.
+
+    Results: BatchSetNodeLockStateResultSuccess | BatchSetNodeLockStateResultFailure
+    """
+
+    node_names: list[str]
+    lock: bool
+
+
+@dataclass
+@PayloadRegistry.register
+class BatchSetNodeLockStateResultSuccess(WorkflowNotAlteredMixin, ResultPayloadSuccess):
+    """Batch node lock state update completed successfully."""
+
+    updated_nodes: list[str]
+    failed_nodes: dict[str, str] = field(default_factory=dict)
+
+
+@dataclass
+@PayloadRegistry.register
+class BatchSetNodeLockStateResultFailure(ResultPayloadFailure):
+    """Batch node lock state update failed. Common causes: all nodes not found."""
+
+
 # A Node's state can be serialized to a sequence of commands that the engine runs.
 @dataclass
 class SerializedNodeCommands:

{griptape_nodes-0.68.1 → griptape_nodes-0.69.0}/src/griptape_nodes/retained_mode/managers/flow_manager.py

@@ -17,7 +17,7 @@ from griptape_nodes.exe_types.core_types import (
     ParameterTypeBuiltin,
 )
 from griptape_nodes.exe_types.flow import ControlFlow
-from griptape_nodes.exe_types.node_groups import SubflowNodeGroup
+from griptape_nodes.exe_types.node_groups import BaseNodeGroup, SubflowNodeGroup
 from griptape_nodes.exe_types.node_types import (
     BaseNode,
     ErrorProxyNode,
@@ -1530,9 +1530,9 @@ class FlowManager:
             if node_name is not None:
                 node_name_to_uuid[node_name] = serialize_result.serialized_node_commands.node_uuid
 
-            # SubflowNodeGroups must be serialized LAST because they reference child node names via node_names_to_add
+            # BaseNodeGroups must be serialized LAST because they reference child node names via node_names_to_add
             # If we deserialize a NodeGroup before its children, the child nodes won't exist yet
-            if isinstance(node, SubflowNodeGroup):
+            if isinstance(node, BaseNodeGroup):
                 serialized_node_group_commands.append(serialize_result.serialized_node_commands)
             else:
                 serialized_node_commands.append(serialize_result.serialized_node_commands)
@@ -1543,7 +1543,7 @@ class FlowManager:
                     serialize_result.set_parameter_value_commands
                 )
 
-        # Update SubflowNodeGroup commands to use UUIDs instead of names in node_names_to_add
+        # Update BaseNodeGroup commands to use UUIDs instead of names in node_names_to_add
         # This allows workflow generation to directly look up variable names from UUIDs
 
         for node_group_command in serialized_node_group_commands:
@@ -3224,9 +3224,9 @@ class FlowManager:
                     # Store the serialized node's UUID for correlation to connections and setting parameter values later.
                     node_name_to_uuid[node_name] = serialized_node.node_uuid
 
-                    # SubflowNodeGroups must be serialized LAST because CreateNodeGroupRequest references child node names
+                    # BaseNodeGroups must be serialized LAST because CreateNodeGroupRequest references child node names
                     # If we deserialize a NodeGroup before its children, the child nodes won't exist yet
-                    if isinstance(node, SubflowNodeGroup):
+                    if isinstance(node, BaseNodeGroup):
                         serialized_node_group_commands.append(serialized_node)
                     else:
                         serialized_node_commands.append(serialized_node)
@@ -3299,7 +3299,7 @@ class FlowManager:
         # This ensures child nodes exist before their parent NodeGroups are created during deserialization
         serialized_node_commands.extend(serialized_node_group_commands)
 
-        # Update SubflowNodeGroup commands to use UUIDs instead of names in node_names_to_add
+        # Update BaseNodeGroup commands to use UUIDs instead of names in node_names_to_add
         # This allows workflow generation to directly look up variable names from UUIDs
         # Build a complete node name to UUID map including nodes from all subflows
         complete_node_name_to_uuid = dict(node_name_to_uuid)  # Start with current flow's nodes

{griptape_nodes-0.68.1 → griptape_nodes-0.69.0}/src/griptape_nodes/retained_mode/managers/node_manager.py

@@ -70,6 +70,9 @@ from griptape_nodes.retained_mode.events.node_events import (
     AddNodesToNodeGroupRequest,
     AddNodesToNodeGroupResultFailure,
     AddNodesToNodeGroupResultSuccess,
+    BatchSetNodeLockStateRequest,
+    BatchSetNodeLockStateResultFailure,
+    BatchSetNodeLockStateResultSuccess,
     BatchSetNodeMetadataRequest,
     BatchSetNodeMetadataResultFailure,
     BatchSetNodeMetadataResultSuccess,
@@ -292,6 +295,9 @@ class NodeManager:
             CanResetNodeToDefaultsRequest, self.on_can_reset_node_to_defaults_request
         )
         event_manager.assign_manager_to_request_type(ResetNodeToDefaultsRequest, self.on_reset_node_to_defaults_request)
+        event_manager.assign_manager_to_request_type(
+            BatchSetNodeLockStateRequest, self.on_batch_set_lock_node_state_request
+        )
 
     def handle_node_rename(self, old_name: str, new_name: str) -> None:
         # Get the node itself
@@ -317,6 +323,12 @@ class NodeManager:
                     connection.source_node.name = new_name
             temp = connections.outgoing_index.pop(old_name)
             connections.outgoing_index[new_name] = temp
+
+        # Update parent group membership if node belongs to a group
+        parent_group = node.parent_group
+        if parent_group is not None and isinstance(parent_group, BaseNodeGroup):
+            parent_group.handle_child_node_rename(old_name, new_name)
+
         # update the node in the flow!
         flow.remove_node(old_name)
         node.name = new_name
@@ -2631,9 +2643,8 @@ class NodeManager:
                 library_version = library_metadata_result.metadata.library_version
                 library_details = LibraryNameAndVersion(library_name=library_used, library_version=library_version)
 
-            # Handle SubflowNodeGroup specially - serialize like normal nodes but preserve node group behavior
-            if isinstance(node, SubflowNodeGroup):
-                # For non-SubflowNodeGroup, library_details should always be set
+            # Handle BaseNodeGroup specially - serialize like normal nodes but preserve node group behavior
+            if isinstance(node, BaseNodeGroup):
                 if library_details is None:
                     details = f"Attempted to serialize Node '{node_name}' to commands. Library details missing."
                     return SerializeNodeToCommandsResultFailure(result_details=details)
@@ -2651,7 +2662,6 @@ class NodeManager:
                     metadata=metadata_copy,
                 )
             else:
-                # For non-SubflowNodeGroup, library_details should always be set
                 if library_details is None:
                     details = f"Attempted to serialize Node '{node_name}' to commands. Library details missing."
                     return SerializeNodeToCommandsResultFailure(result_details=details)
@@ -3588,6 +3598,30 @@ class NodeManager:
             result_details=f"Successfully set lock state to {node.lock} for node '{node_name}'.",
         )
 
+    def on_batch_set_lock_node_state_request(self, request: BatchSetNodeLockStateRequest) -> ResultPayload:
+        updated: list[str] = []
+        failed: dict[str, str] = {}
+        for name in request.node_names:
+            try:
+                node = self.get_node_by_name(name)
+            except ValueError as err:
+                failed[name] = f"Node not found. Error: {err}"
+                continue
+            node.lock = request.lock
+            updated.append(name)
+
+        if not updated:
+            details = f"Failed to update any nodes. Failed: {failed}"
+            return BatchSetNodeLockStateResultFailure(result_details=details)
+        details = f"Successfully set lock state to {request.lock} for nodes: {', '.join(updated)}." + (
+            f" Failed: {failed}" if failed else ""
+        )
+        return BatchSetNodeLockStateResultSuccess(
+            updated_nodes=updated,
+            failed_nodes=failed,
+            result_details=details,
+        )
+
     def on_send_node_message_request(self, request: SendNodeMessageRequest) -> ResultPayload:
         """Handle a SendNodeMessageRequest by calling the node's message callback.
 

{griptape_nodes-0.68.1 → griptape_nodes-0.69.0}/src/griptape_nodes/retained_mode/retained_mode.py

@@ -44,6 +44,9 @@ from griptape_nodes.retained_mode.events.library_events import (
     ListRegisteredLibrariesRequest,
 )
 from griptape_nodes.retained_mode.events.node_events import (
+    BatchSetNodeLockStateRequest,
+    BatchSetNodeLockStateResultFailure,
+    BatchSetNodeLockStateResultSuccess,
     CreateNodeRequest,
     CreateNodeResultFailure,
     DeleteNodeRequest,
@@ -388,6 +391,20 @@ class RetainedMode:
         result = GriptapeNodes().handle_request(request)
         return result
 
+    @classmethod
+    def batch_set_lock_node_state(
+        cls, *, node_names: list[str], lock: bool = True
+    ) -> BatchSetNodeLockStateResultSuccess | BatchSetNodeLockStateResultFailure:
+        """Sets the lock state of multiple nodes.
+
+        Args:
+            node_names (list[str]): Names of nodes to lock/unlock.
+            lock (bool): Whether to lock (True) or unlock (False) the nodes.
+        """
+        request = BatchSetNodeLockStateRequest(node_names=node_names, lock=lock)
+        result = GriptapeNodes().handle_request(request)
+        return result
+
     @classmethod
     def get_connections_for_node(cls, node_name: str) -> ResultPayload:
         """Gets all connections associated with a node.