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

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

@@ -1,13 +1,13 @@
 Metadata-Version: 2.3
 Name: griptape-nodes
-Version: 0.68.1
+Version: 0.70.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.70.0}/pyproject.toml

@@ -1,16 +1,16 @@
 [project]
 name = "griptape-nodes"
-version = "0.68.1"
+version = "0.70.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.70.0}/src/griptape_nodes/api_client/client.py

@@ -168,7 +168,11 @@ class Client:
             logger.debug("WebSocket client connected")
         except TimeoutError as e:
             logger.error("Failed to connect WebSocket client: timeout")
-            msg = "Connection timeout"
+            msg = (
+                "Connection timeout - failed to connect to Nodes API. "
+                "This usually indicates an invalid or missing GT_CLOUD_API_KEY. "
+                "Please verify your API key is correct."
+            )
             raise ConnectionError(msg) from e
 
     async def _disconnect(self) -> None:

{griptape_nodes-0.68.1 → griptape_nodes-0.70.0}/src/griptape_nodes/app/app.py

@@ -3,11 +3,14 @@ from __future__ import annotations
 import asyncio
 import json
 import logging
+import sys
 import threading
 from dataclasses import dataclass
 
+from rich.align import Align
 from rich.console import Console
 from rich.logging import RichHandler
+from rich.panel import Panel
 
 from griptape_nodes.api_client import Client
 from griptape_nodes.retained_mode.events import app_events, execution_events
@@ -113,6 +116,35 @@ logging.basicConfig(
 console = Console()
 
 
+def _ensure_api_key() -> str:
+    """Verify that GT_CLOUD_API_KEY is set, exit with clear error message if not.
+
+    Returns:
+        The API key value
+
+    Raises:
+        SystemExit: If API key is missing or empty
+    """
+    secrets_manager = griptape_nodes.SecretsManager()
+    api_key = secrets_manager.get_secret("GT_CLOUD_API_KEY", should_error_on_not_found=False)
+
+    if not api_key:
+        message = Panel(
+            Align.center(
+                "[bold red]Nodes API key is not set, please run [code]gtn init[/code] with a valid key:[/bold red]\n"
+                "[code]gtn init --api-key <your key>[/code]\n\n"
+                "[bold red]You can generate a new key from [/bold red][bold blue][link=https://nodes.griptape.ai]https://nodes.griptape.ai[/link][/bold blue]",
+            ),
+            title="[red]X[/red] Missing Nodes API Key",
+            border_style="red",
+            padding=(1, 4),
+        )
+        console.print(message)
+        sys.exit(1)
+
+    return api_key
+
+
 def start_app() -> None:
     """Legacy sync entry point - runs async app."""
     try:
@@ -125,6 +157,9 @@ def start_app() -> None:
 
 async def astart_app() -> None:
     """New async app entry point."""
+    # Verify API key is set before starting
+    _ensure_api_key()
+
     # Initialize event queue in main thread
     griptape_nodes.EventManager().initialize_queue()
 
@@ -154,6 +189,22 @@ def _start_websocket_connection() -> None:
 
         # Run the async WebSocket tasks
         loop.run_until_complete(_run_websocket_tasks())
+    except ConnectionError:
+        # Connection failed - likely due to invalid/missing API key
+        message = Panel(
+            Align.center(
+                "[bold red]Failed to connect to Nodes API.[/bold red]\n\n"
+                "This usually indicates an invalid or missing [code]GT_CLOUD_API_KEY[/code].\n\n"
+                "[bold red]Please verify your API key:[/bold red]\n"
+                "[code]gtn init --api-key <your key>[/code]\n\n"
+                "[bold red]You can generate a new key from [/bold red][bold blue][link=https://nodes.griptape.ai]https://nodes.griptape.ai[/link][/bold blue]",
+            ),
+            title="[red]X[/red] Connection Failed",
+            border_style="red",
+            padding=(1, 4),
+        )
+        console.print(message)
+        sys.exit(1)
     except Exception as e:
         logger.error("WebSocket thread error: %s", e)
         raise

{griptape_nodes-0.68.1 → griptape_nodes-0.70.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.70.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.70.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,16 @@ 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 only on actual failure (not placeholder/initialization messages)
+        # While string matching is not the best practice, it's currently the only way to check for placeholder messages.
+        # TODO: use a better approach to check for placeholder messages. https://github.com/griptape-ai/griptape-nodes/issues/3686
+        is_placeholder = result_details in (
+            "<Results will appear when the node executes>",
+            "Beginning execution...",
+            "",
+        )
+        show_warning = not was_successful and not is_placeholder
+        self._update_status_group_display_label(show_warning=show_warning)
 
     def clear_execution_status(self, initial_message: str | None = None) -> None:
         """Clear execution status and reset parameters.
@@ -102,6 +123,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.70.0}/src/griptape_nodes/exe_types/param_components/log_parameter.py

@@ -20,7 +20,7 @@ class LogParameter:
                 output_type="str",
                 allowed_modes={ParameterMode.OUTPUT},
                 tooltip="logs",
-                ui_options={"multiline": True},
+                ui_options={"multiline": True, "placeholder_text": ""},
             )
         )
 
@@ -68,6 +68,10 @@ class StdoutCapture:
     def flush(self) -> None:
         self._original_stdout.flush()
 
+    def isatty(self) -> bool:
+        # Return False to prevent libraries from outputting ANSI color codes
+        return False
+
     def __enter__(self) -> "StdoutCapture":
         sys.stdout = self
         return self

{griptape_nodes-0.68.1 → griptape_nodes-0.70.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.70.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:
@@ -533,6 +564,7 @@ class SerializeNodeToCommandsRequest(RequestPayload):
     serialized_parameter_value_tracker: SerializedParameterValueTracker = field(
         default_factory=SerializedParameterValueTracker
     )
+    use_pickling: bool = False
 
 
 @dataclass
@@ -617,7 +649,8 @@ class SerializeSelectedNodesToCommandsResultSuccess(WorkflowNotAlteredMixin, Res
 
     # They will be passed with node_name, timestamp
     # Could be a flow command if it's all nodes in a flow.
-    serialized_selected_node_commands: SerializedSelectedNodesCommands
+    serialized_selected_node_commands: str
+    pickled_values: dict[str, str]
 
 
 @dataclass
@@ -643,6 +676,8 @@ class DeserializeSelectedNodesFromCommandsRequest(WorkflowNotAlteredMixin, Reque
     Results: DeserializeSelectedNodesFromCommandsResultSuccess (with node names) | DeserializeSelectedNodesFromCommandsResultFailure (deserialization error)
     """
 
+    deserialize_commands: str
+    pickled_values: dict[str, str]
     positions: list[NewPosition] | None = None
 
 

{griptape_nodes-0.68.1 → griptape_nodes-0.70.0}/src/griptape_nodes/retained_mode/managers/context_manager.py

@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 import logging
-from typing import TYPE_CHECKING, Any
+from typing import TYPE_CHECKING
 
 from griptape_nodes.exe_types.flow import ControlFlow
 from griptape_nodes.retained_mode.events.context_events import (
@@ -18,8 +18,6 @@ if TYPE_CHECKING:
     from griptape_nodes.exe_types.core_types import BaseNodeElement
     from griptape_nodes.exe_types.node_types import BaseNode
     from griptape_nodes.retained_mode.events.base_events import ResultPayload
-    from griptape_nodes.retained_mode.events.flow_events import SerializedFlowCommands
-    from griptape_nodes.retained_mode.events.node_events import SerializedSelectedNodesCommands
     from griptape_nodes.retained_mode.managers.event_manager import EventManager
 
 logger = logging.getLogger("griptape_nodes")
@@ -34,7 +32,6 @@ class ContextManager:
     """
 
     _workflow_stack: list[ContextManager.WorkflowContextState]
-    _clipboard: ClipBoard
 
     class WorkflowContextError(Exception):
         """Base exception for workflow context errors."""
@@ -242,32 +239,9 @@ class ContextManager:
         ) -> None:
             self._manager.pop_element()
 
-    class ClipBoard:
-        """Keeps Commands for Copying or Pasting."""
-
-        # Contains flow, node, parameter, connections
-        flow_commands: SerializedFlowCommands | None
-        # Contains node and Parameter and relevant connections
-        node_commands: SerializedSelectedNodesCommands | None
-        parameter_uuid_to_values: dict[str, Any] | None
-
-        def __init__(self) -> None:
-            self.flow_commands = None
-            self.node_commands = None
-            self.parameter_uuid_to_values = None
-
-        def clear(self) -> None:
-            del self.flow_commands
-            self.flow_commands = None
-            del self.node_commands
-            self.node_commands = None
-            if self.parameter_uuid_to_values is not None:
-                self.parameter_uuid_to_values.clear()
-
     def __init__(self, event_manager: EventManager) -> None:
         """Initialize the context manager with empty workflow and flow stacks."""
         self._workflow_stack = []
-        self._clipboard = self.ClipBoard()
         event_manager.assign_manager_to_request_type(
             request_type=SetWorkflowContextRequest, callback=self.on_set_workflow_context_request
         )

{griptape_nodes-0.68.1 → griptape_nodes-0.70.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