griptape-nodes 0.52.1__py3-none-any.whl → 0.53.0__py3-none-any.whl

griptape_nodes/retained_mode/managers/object_manager.py

@@ -10,6 +10,7 @@ from griptape_nodes.exe_types.core_types import (
 from griptape_nodes.exe_types.flow import ControlFlow
 from griptape_nodes.exe_types.node_types import BaseNode
 from griptape_nodes.retained_mode.events.base_events import (
+    ResultDetails,
     ResultPayload,
 )
 from griptape_nodes.retained_mode.events.execution_events import (
@@ -50,7 +51,10 @@ class ObjectManager:
     def on_rename_object_request(self, request: RenameObjectRequest) -> ResultPayload:
         # Does the source object exist?
         if request.object_name == request.requested_name:
-            return RenameObjectResultSuccess(final_name=request.requested_name)
+            return RenameObjectResultSuccess(
+                final_name=request.requested_name,
+                result_details=f"Object '{request.requested_name}' already has the requested name",
+            )
         source_obj = self.attempt_get_object_by_name(request.object_name)
         if source_obj is None:
             details = f"Attempted to rename object '{request.object_name}', but no object of that name could be found."
@@ -97,8 +101,11 @@ class ObjectManager:
         if final_name != request.requested_name:
             details += " WARNING: Originally requested the name '{request.requested_name}', but that was taken."
             log_level = logging.WARNING
-        logger.log(level=log_level, msg=details)
-        return RenameObjectResultSuccess(final_name=final_name)
+        if log_level == logging.WARNING:
+            result_details = ResultDetails(message=details, level="WARNING")
+        else:
+            result_details = details
+        return RenameObjectResultSuccess(final_name=final_name, result_details=result_details)
 
     def on_clear_all_object_state_request(self, request: ClearAllObjectStateRequest) -> ResultPayload:  # noqa: C901
         if not request.i_know_what_im_doing:
@@ -148,8 +155,7 @@ class ObjectManager:
         GriptapeNodes.VariablesManager().on_clear_object_state()
 
         details = "Successfully cleared all object state (deleted everything)."
-        logger.debug(details)
-        return ClearAllObjectStateResultSuccess()
+        return ClearAllObjectStateResultSuccess(result_details=details)
 
     def get_filtered_subset[T](
         self,

griptape_nodes/retained_mode/managers/os_manager.py

@@ -11,7 +11,7 @@ from typing import Any
 from binaryornot.check import is_binary
 from rich.console import Console
 
-from griptape_nodes.retained_mode.events.base_events import ResultPayload
+from griptape_nodes.retained_mode.events.base_events import ResultDetails, ResultPayload
 from griptape_nodes.retained_mode.events.os_events import (
     CreateFileRequest,
     CreateFileResultFailure,
@@ -304,7 +304,7 @@ class OSManager:
                 logger.info(details)
                 return OpenAssociatedFileResultFailure(result_details=details)
 
-            return OpenAssociatedFileResultSuccess()
+            return OpenAssociatedFileResultSuccess(result_details="File opened successfully in associated application.")
         except subprocess.CalledProcessError as e:
             details = (
                 f"Process error when opening file: return code={e.returncode}, stdout={e.stdout}, stderr={e.stderr}"
@@ -399,11 +399,17 @@ class OSManager:
             if request.workspace_only:
                 # In workspace mode, return relative path if within workspace, absolute if outside
                 return ListDirectoryResultSuccess(
-                    entries=entries, current_path=str(relative_or_abs_path), is_workspace_path=is_workspace_path
+                    entries=entries,
+                    current_path=str(relative_or_abs_path),
+                    is_workspace_path=is_workspace_path,
+                    result_details="Directory listing retrieved successfully.",
                 )
             # In system-wide mode, always return the full absolute path
             return ListDirectoryResultSuccess(
-                entries=entries, current_path=str(directory), is_workspace_path=is_workspace_path
+                entries=entries,
+                current_path=str(directory),
+                is_workspace_path=is_workspace_path,
+                result_details="Directory listing retrieved successfully.",
             )
 
         except Exception as e:
@@ -430,6 +436,7 @@ class OSManager:
                 mime_type=mime_type,
                 encoding=encoding,
                 compression_encoding=compression_encoding,
+                result_details="File read successfully.",
             )
 
         except (ValueError, FileNotFoundError) as e:
@@ -759,8 +766,9 @@ class OSManager:
             # Check if it already exists - warn but treat as success
             if file_path.exists():
                 msg = f"Path already exists: {file_path}"
-                logger.warning(msg)
-                return CreateFileResultSuccess(created_path=str(file_path))
+                return CreateFileResultSuccess(
+                    created_path=str(file_path), result_details=ResultDetails(message=msg, level="WARNING")
+                )
 
             # Create parent directories if needed
             file_path.parent.mkdir(parents=True, exist_ok=True)
@@ -777,7 +785,10 @@ class OSManager:
                 file_path.touch()
                 logger.info("Created empty file: %s", file_path)
 
-            return CreateFileResultSuccess(created_path=str(file_path))
+            return CreateFileResultSuccess(
+                created_path=str(file_path),
+                result_details=f"{'Directory' if request.is_directory else 'File'} created successfully at {file_path}",
+            )
 
         except Exception as e:
             path_info = request.get_full_path() if hasattr(request, "get_full_path") else str(request.path)
@@ -820,9 +831,13 @@ class OSManager:
 
             # Perform the rename operation
             old_path.rename(new_path)
-            logger.info("Renamed: %s -> %s", old_path, new_path)
+            details = f"Renamed: {old_path} -> {new_path}"
 
-            return RenameFileResultSuccess(old_path=str(old_path), new_path=str(new_path))
+            return RenameFileResultSuccess(
+                old_path=str(old_path),
+                new_path=str(new_path),
+                result_details=ResultDetails(message=details, level="INFO"),
+            )
 
         except Exception as e:
             msg = f"Failed to rename {request.old_path} to {request.new_path}: {e}"

griptape_nodes/retained_mode/managers/secrets_manager.py

@@ -60,7 +60,9 @@ class SecretsManager:
             logger.error(details)
             return GetSecretValueResultFailure(result_details=details)
 
-        return GetSecretValueResultSuccess(value=secret_value)
+        return GetSecretValueResultSuccess(
+            value=secret_value, result_details=f"Successfully retrieved secret value for key: {secret_key}"
+        )
 
     def on_handle_set_secret_request(self, request: SetSecretValueRequest) -> ResultPayload:
         secret_name = SecretsManager._apply_secret_name_compliance(request.key)
@@ -77,12 +79,14 @@ class SecretsManager:
 
         self.set_secret(secret_name, secret_value)
 
-        return SetSecretValueResultSuccess()
+        return SetSecretValueResultSuccess(result_details=f"Successfully set secret value for key: {secret_name}")
 
     def on_handle_get_all_secret_values_request(self, request: GetAllSecretValuesRequest) -> ResultPayload:  # noqa: ARG002
         secret_values = dotenv_values(ENV_VAR_PATH)
 
-        return GetAllSecretValuesResultSuccess(values=secret_values)
+        return GetAllSecretValuesResultSuccess(
+            values=secret_values, result_details=f"Successfully retrieved {len(secret_values)} secret values"
+        )
 
     def on_handle_delete_secret_value_request(self, request: DeleteSecretValueRequest) -> ResultPayload:
         secret_name = SecretsManager._apply_secret_name_compliance(request.key)
@@ -101,7 +105,7 @@ class SecretsManager:
 
         logger.info("Secret '%s' deleted.", secret_name)
 
-        return DeleteSecretValueResultSuccess()
+        return DeleteSecretValueResultSuccess(result_details=f"Successfully deleted secret: {secret_name}")
 
     def get_secret(self, secret_name: str, *, should_error_on_not_found: bool = True) -> str | None:
         """Return the secret value with the following search precedence (highest to lowest priority).

griptape_nodes/retained_mode/managers/settings.py

@@ -1,7 +1,15 @@
+from enum import StrEnum
 from pathlib import Path
 from typing import Any, Literal
 
-from pydantic import BaseModel, ConfigDict, Field
+from pydantic import BaseModel, ConfigDict, Field, field_validator
+
+
+class WorkflowExecutionMode(StrEnum):
+    """Execution type for node processing."""
+
+    SEQUENTIAL = "sequential"
+    PARALLEL = "parallel"
 
 
 class AppInitializationComplete(BaseModel):
@@ -89,6 +97,29 @@ class Settings(BaseModel):
         }
     )
     log_level: str = Field(default="INFO")
+    workflow_execution_mode: WorkflowExecutionMode = Field(
+        default=WorkflowExecutionMode.SEQUENTIAL, description="Workflow execution mode for node processing"
+    )
+
+    @field_validator("workflow_execution_mode", mode="before")
+    @classmethod
+    def validate_workflow_execution_mode(cls, v: Any) -> WorkflowExecutionMode:
+        """Convert string values to WorkflowExecutionMode enum."""
+        if isinstance(v, str):
+            try:
+                return WorkflowExecutionMode(v.lower())
+            except ValueError:
+                # Return default if invalid string
+                return WorkflowExecutionMode.SEQUENTIAL
+        elif isinstance(v, WorkflowExecutionMode):
+            return v
+        else:
+            # Return default for any other type
+            return WorkflowExecutionMode.SEQUENTIAL
+
+    max_nodes_in_parallel: int | None = Field(
+        default=5, description="Maximum number of nodes executing at a time for parallel execution."
+    )
     storage_backend: Literal["local", "gtc"] = Field(default="local")
     minimum_disk_space_gb_libraries: float = Field(
         default=10.0,

griptape_nodes/retained_mode/managers/static_files_manager.py

@@ -103,7 +103,7 @@ class StaticFilesManager:
             logger.error(msg)
             return CreateStaticFileResultFailure(error=msg, result_details=msg)
 
-        return CreateStaticFileResultSuccess(url=url)
+        return CreateStaticFileResultSuccess(url=url, result_details=f"Successfully created static file: {url}")
 
     def on_handle_create_static_file_upload_url_request(
         self,
@@ -126,7 +126,10 @@ class StaticFilesManager:
             return CreateStaticFileUploadUrlResultFailure(error=msg, result_details=msg)
 
         return CreateStaticFileUploadUrlResultSuccess(
-            url=response["url"], headers=response["headers"], method=response["method"]
+            url=response["url"],
+            headers=response["headers"],
+            method=response["method"],
+            result_details="Successfully created static file upload URL",
         )
 
     def on_handle_create_static_file_download_url_request(
@@ -149,7 +152,9 @@ class StaticFilesManager:
             logger.error(msg)
             return CreateStaticFileDownloadUrlResultFailure(error=msg, result_details=msg)
 
-        return CreateStaticFileDownloadUrlResultSuccess(url=url)
+        return CreateStaticFileDownloadUrlResultSuccess(
+            url=url, result_details="Successfully created static file download URL"
+        )
 
     def save_static_file(self, data: bytes, file_name: str) -> str:
         """Saves a static file to the workspace directory.

griptape_nodes/retained_mode/managers/sync_manager.py

@@ -13,7 +13,7 @@ from watchfiles import Change, PythonFilter, watch
 
 from griptape_nodes.drivers.storage.griptape_cloud_storage_driver import GriptapeCloudStorageDriver
 from griptape_nodes.retained_mode.events.app_events import AppInitializationComplete
-from griptape_nodes.retained_mode.events.base_events import AppEvent
+from griptape_nodes.retained_mode.events.base_events import AppEvent, ResultDetails
 from griptape_nodes.retained_mode.events.sync_events import (
     StartSyncAllCloudWorkflowsRequest,
     StartSyncAllCloudWorkflowsResultFailure,
@@ -130,8 +130,11 @@ class SyncManager:
             workflow_files = [file for file in files if file.endswith(".py")]
 
             if not workflow_files:
-                logger.info("No workflow files found in cloud storage")
-                return StartSyncAllCloudWorkflowsResultSuccess(sync_directory=str(sync_dir), total_workflows=0)
+                return StartSyncAllCloudWorkflowsResultSuccess(
+                    sync_directory=str(sync_dir),
+                    total_workflows=0,
+                    result_details=ResultDetails(message="No workflow files found in cloud storage.", level="INFO"),
+                )
 
             # Start background sync with unique ID
             sync_task_id = str(uuid.uuid4())
@@ -149,9 +152,9 @@ class SyncManager:
             logger.error(details)
             return StartSyncAllCloudWorkflowsResultFailure(result_details=details)
         else:
-            logger.info("Started background sync for %d workflow files", len(workflow_files))
+            details = f"Started background sync for {len(workflow_files)} workflow files"
             return StartSyncAllCloudWorkflowsResultSuccess(
-                sync_directory=str(sync_dir), total_workflows=len(workflow_files)
+                sync_directory=str(sync_dir), total_workflows=len(workflow_files), result_details=details
             )
 
     def on_app_initialization_complete(self, _payload: AppInitializationComplete) -> None: