griptape-nodes 0.58.0__tar.gz → 0.59.0__tar.gz

{griptape_nodes-0.58.0 → griptape_nodes-0.59.0}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.3
 Name: griptape-nodes
-Version: 0.58.0
+Version: 0.59.0
 Summary: Add your description here
-Requires-Dist: griptape>=1.8.5
+Requires-Dist: griptape>=1.8.8
 Requires-Dist: pydantic>=2.10.6
 Requires-Dist: python-dotenv>=1.0.1
 Requires-Dist: xdg-base-dirs>=6.0.2
@@ -23,6 +23,7 @@ Requires-Dist: typer>=0.15.0
 Requires-Dist: huggingface-hub[xf-xet]>=0.28.0
 Requires-Dist: rich>=14.1.0
 Requires-Dist: semver>=3.0.4
+Requires-Dist: aiofiles>=25.1.0
 Requires-Dist: austin-dist>=3.7.0 ; extra == 'profiling'
 Requires-Python: >=3.12.0, <3.13
 Provides-Extra: profiling

{griptape_nodes-0.58.0 → griptape_nodes-0.59.0}/pyproject.toml

@@ -1,11 +1,11 @@
 [project]
 name = "griptape-nodes"
-version = "0.58.0"
+version = "0.59.0"
 description = "Add your description here"
 readme = "README.md"
 requires-python = ">=3.12.0, <3.13"
 dependencies = [
-  "griptape>=1.8.5",
+  "griptape>=1.8.8",
   "pydantic>=2.10.6",
   "python-dotenv>=1.0.1",
   "xdg-base-dirs>=6.0.2",
@@ -24,9 +24,10 @@ dependencies = [
   "pillow>=11.3.0",
   "watchfiles>=1.1.0",
   "typer>=0.15.0",
-  "huggingface-hub[xf_xet]>=0.28.0",
+  "huggingface-hub[xf-xet]>=0.28.0",
   "rich>=14.1.0",
   "semver>=3.0.4",
+  "aiofiles>=25.1.0",
 ]
 
 [project.optional-dependencies]
@@ -34,6 +35,7 @@ profiling = ["austin-dist>=3.7.0"]
 
 [dependency-groups]
 dev = [
+  "griptape-cloud-client",
   "mdformat>=0.7.22",
   "mdformat-gfm>=0.4.1",
   "mdformat-frontmatter>=2.0.8",
@@ -47,6 +49,7 @@ docs = [
   "mkdocs-material>=9.6.9",
   "mkdocs>=1.5.2",
   "mkdocstrings[python]>=0.29.1",
+  "mkdocs-mermaid2-plugin>=1.2.2",
 ]
 test = [
   "pytest>=8.3.5",
@@ -65,11 +68,13 @@ gtn = "griptape_nodes:main"
 requires = ["uv_build"]
 build-backend = "uv_build"
 
+[tool.uv.sources]
+griptape-cloud-client = { git = "https://github.com/griptape-ai/griptape-cloud-python-client", rev = "main" }
+
 [tool.ruff]
 line-length = 120
+extend-exclude = ["libraries/**/templates/*.py"]
 
-[tool.ruff.format]
-exclude = [".venv"]
 
 [tool.ruff.lint]
 select = ["ALL"]
@@ -101,10 +106,11 @@ ignore = [
 "nodes.griptape_nodes_library".msg = "Import from griptape_nodes_library instead of nodes.griptape_nodes_library"
 "libraries.griptape_nodes_library".msg = "Import from griptape_nodes_library instead of libraries.griptape_nodes_library"
 "libraries.griptape_nodes_advanced_media_library".msg = "Import from griptape_nodes_advanced_media_library instead of libraries.griptape_nodes_advanced_media_library"
+"libraries.griptape_cloud".msg = "Import from griptape_cloud instead of libraries.griptape_cloud"
 
 [tool.ruff.lint.per-file-ignores]
 "tests/*" = ["S101", "D104"]
-"nodes/tests/*" = ["S101", "D104"]
+"libraries/**/tests/*" = ["S101", "D104"]
 
 [tool.ruff.lint.flake8-annotations]
 mypy-init-return = true
@@ -125,7 +131,7 @@ venvPath = "."
 venv = ".venv"
 include = ["."]
 exclude = [
-  "libraries/griptape_nodes_library/workflows/templates/**/*",
+  "libraries/**/templates/*",
   ".venv",
   "GriptapeNodes",
   "**/node_modules",

{griptape_nodes-0.58.0 → griptape_nodes-0.59.0}/src/griptape_nodes/bootstrap/utils/python_subprocess_executor.py

@@ -52,8 +52,8 @@ class PythonSubprocessExecutor:
 
             stdout_bytes, stderr_bytes = await self._process.communicate()
             returncode = self._process.returncode
-            stdout = stdout_bytes.decode() if stdout_bytes else ""
-            stderr = stderr_bytes.decode() if stderr_bytes else ""
+            stdout = stdout_bytes.decode(errors="replace") if stdout_bytes else ""
+            stderr = stderr_bytes.decode(errors="replace") if stderr_bytes else ""
 
             # Log all output regardless of return code
             if stdout:

{griptape_nodes-0.58.0 → griptape_nodes-0.59.0}/src/griptape_nodes/bootstrap/workflow_executors/local_session_workflow_executor.py

@@ -109,7 +109,6 @@ class LocalSessionWorkflowExecutor(LocalWorkflowExecutor):
 
     async def arun(
         self,
-        workflow_name: str,
         flow_input: Any,
         storage_backend: StorageBackend | None = None,
         **kwargs: Any,
@@ -120,7 +119,6 @@ class LocalSessionWorkflowExecutor(LocalWorkflowExecutor):
         loading the user-defined workflow, and running the specified workflow.
 
         Parameters:
-            workflow_name: The name of the workflow to execute.
             flow_input: Input data for the flow, typically a dictionary.
             storage_backend: The storage backend to use for the workflow execution.
 
@@ -129,7 +127,6 @@ class LocalSessionWorkflowExecutor(LocalWorkflowExecutor):
         """
         try:
             await self._arun(
-                workflow_name=workflow_name,
                 flow_input=flow_input,
                 storage_backend=storage_backend,
                 **kwargs,
@@ -151,14 +148,12 @@ class LocalSessionWorkflowExecutor(LocalWorkflowExecutor):
 
     async def _arun(  # noqa: C901, PLR0915
         self,
-        workflow_name: str,
         flow_input: Any,
         storage_backend: StorageBackend | None = None,
         **kwargs: Any,
     ) -> None:
         """Internal async run method with detailed event handling and websocket integration."""
         flow_name = await self.aprepare_workflow_for_run(
-            workflow_name=workflow_name,
             flow_input=flow_input,
             storage_backend=storage_backend,
             **kwargs,

{griptape_nodes-0.58.0 → griptape_nodes-0.59.0}/src/griptape_nodes/bootstrap/workflow_executors/local_workflow_executor.py

@@ -52,6 +52,15 @@ class LocalWorkflowExecutor(WorkflowExecutor):
         # TODO: Broadcast shutdown https://github.com/griptape-ai/griptape-nodes/issues/2149
         return
 
+    def _get_workflow_name(self) -> str:
+        try:
+            context_manager = GriptapeNodes.ContextManager()
+            return context_manager.get_current_workflow_name()
+        except Exception as e:
+            msg = f"Failed to get current workflow from context manager: {e}"
+            logger.exception(msg)
+            raise LocalExecutorError(msg) from e
+
     def _load_flow_for_workflow(self) -> str:
         try:
             context_manager = GriptapeNodes.ContextManager()
@@ -153,7 +162,6 @@ class LocalWorkflowExecutor(WorkflowExecutor):
 
     async def aprepare_workflow_for_run(
         self,
-        workflow_name: str,
         flow_input: Any,
         storage_backend: StorageBackend | None = None,
         **kwargs: Any,
@@ -164,7 +172,6 @@ class LocalWorkflowExecutor(WorkflowExecutor):
         initializing event listeners, registering libraries, loading the user-defined
         workflow, and preparing the specified workflow for execution.
         Parameters:
-            workflow_name: The name of the workflow to prepare.
             flow_input: Input data for the flow, typically a dictionary.
             storage_backend: The storage backend to use for the workflow execution.
 
@@ -175,7 +182,6 @@ class LocalWorkflowExecutor(WorkflowExecutor):
             msg = "The storage_backend parameter is deprecated. Pass `storage_backend` to the constructor instead."
             raise ValueError(msg)
 
-        logger.info("Executing workflow: %s", workflow_name)
         GriptapeNodes.EventManager().initialize_queue()
 
         # Load workflow from file if workflow_path is provided
@@ -192,7 +198,6 @@ class LocalWorkflowExecutor(WorkflowExecutor):
 
     async def arun(
         self,
-        workflow_name: str,
         flow_input: Any,
         storage_backend: StorageBackend | None = None,
         **kwargs: Any,
@@ -211,7 +216,6 @@ class LocalWorkflowExecutor(WorkflowExecutor):
             None
         """
         flow_name = await self.aprepare_workflow_for_run(
-            workflow_name=workflow_name,
             flow_input=flow_input,
             storage_backend=storage_backend,
             **kwargs,

{griptape_nodes-0.58.0 → griptape_nodes-0.59.0}/src/griptape_nodes/bootstrap/workflow_executors/subprocess_workflow_executor.py

@@ -76,7 +76,6 @@ class SubprocessWorkflowExecutor(LocalSessionWorkflowExecutor, PythonSubprocessE
 
     async def arun(
         self,
-        workflow_name: str,  # noqa: ARG002
         flow_input: Any,
         storage_backend: StorageBackend = StorageBackend.LOCAL,
         *,

{griptape_nodes-0.58.0 → griptape_nodes-0.59.0}/src/griptape_nodes/bootstrap/workflow_executors/workflow_executor.py

@@ -28,17 +28,15 @@ class WorkflowExecutor:
 
     def run(
         self,
-        workflow_name: str,
         flow_input: Any,
         storage_backend: StorageBackend = StorageBackend.LOCAL,
         **kwargs: Any,
     ) -> None:
-        return asyncio.run(self.arun(workflow_name, flow_input, storage_backend, **kwargs))
+        return asyncio.run(self.arun(flow_input, storage_backend, **kwargs))
 
     @abstractmethod
     async def arun(
         self,
-        workflow_name: str,
         flow_input: Any,
         storage_backend: StorageBackend = StorageBackend.LOCAL,
         **kwargs: Any,

{griptape_nodes-0.58.0 → griptape_nodes-0.59.0}/src/griptape_nodes/bootstrap/workflow_publishers/local_workflow_publisher.py

@@ -27,7 +27,7 @@ class LocalWorkflowPublisher(LocalWorkflowExecutor):
         **kwargs: Any,
     ) -> None:
         # Load the workflow into memory
-        await self.aprepare_workflow_for_run(workflow_name=workflow_name, flow_input={}, workflow_path=workflow_path)
+        await self.aprepare_workflow_for_run(flow_input={}, workflow_path=workflow_path)
         pickle_control_flow_result = kwargs.get("pickle_control_flow_result", False)
         publish_workflow_request = PublishWorkflowRequest(
             workflow_name=workflow_name,

{griptape_nodes-0.58.0 → griptape_nodes-0.59.0}/src/griptape_nodes/cli/commands/init.py

@@ -47,6 +47,13 @@ def init_command(  # noqa: PLR0913
             help="Install the Griptape Nodes Advanced Image Library.",
         ),
     ] = None,
+    register_griptape_cloud_library: Annotated[
+        bool | None,
+        typer.Option(
+            "--register-griptape-cloud-library/--no-register-griptape-cloud-library",
+            help="Install the Griptape Cloud Library.",
+        ),
+    ] = None,
     libraries_sync: Annotated[
         bool | None,
         typer.Option("--libraries-sync/--no-libraries-sync", help="Sync the Griptape Nodes libraries."),
@@ -83,6 +90,7 @@ def init_command(  # noqa: PLR0913
             api_key=api_key,
             storage_backend=storage_backend,
             register_advanced_library=register_advanced_library,
+            register_griptape_cloud_library=register_griptape_cloud_library,
             config_values=config_values,
             secret_values=secret_values,
             libraries_sync=libraries_sync,
@@ -134,7 +142,7 @@ def _run_init_configuration(config: InitConfig) -> None:
     _handle_storage_backend_config(config)
     _handle_bucket_config(config)
     _handle_hf_token_config(config)
-    _handle_advanced_library_config(config)
+    _handle_additional_library_config(config)
     _handle_arbitrary_configs(config)
 
 
@@ -218,17 +226,24 @@ def _handle_hf_token_config(config: InitConfig) -> str | None:
     return hf_token
 
 
-def _handle_advanced_library_config(config: InitConfig) -> bool | None:
-    """Handle advanced library configuration step."""
+def _handle_additional_library_config(config: InitConfig) -> bool | None:
+    """Handle additional library configuration step."""
     register_advanced_library = config.register_advanced_library
+    register_griptape_cloud_library = config.register_griptape_cloud_library
 
     if config.interactive:
         register_advanced_library = _prompt_for_advanced_media_library(
             default_prompt_for_advanced_media_library=register_advanced_library
         )
+        register_griptape_cloud_library = _prompt_for_griptape_cloud_library(
+            default_prompt_for_griptape_cloud_library=register_griptape_cloud_library
+        )
 
-    if register_advanced_library is not None:
-        libraries_to_register = _build_libraries_list(register_advanced_library=register_advanced_library)
+    if register_advanced_library is not None or register_griptape_cloud_library is not None:
+        libraries_to_register = _build_libraries_list(
+            register_advanced_library=register_advanced_library,
+            register_griptape_cloud_library=register_griptape_cloud_library,
+        )
         config_manager.set_config_value(
             "app_events.on_app_initialization_complete.libraries_to_register", libraries_to_register
         )
@@ -470,8 +485,25 @@ def _prompt_for_advanced_media_library(*, default_prompt_for_advanced_media_libr
     return Confirm.ask("Register Advanced Media Library?", default=default_prompt_for_advanced_media_library)
 
 
-def _build_libraries_list(*, register_advanced_library: bool) -> list[str]:
-    """Builds the list of libraries to register based on the advanced library setting."""
+def _prompt_for_griptape_cloud_library(*, default_prompt_for_griptape_cloud_library: bool | None = None) -> bool:
+    """Prompts the user whether to register the Griptape Cloud Library."""
+    if default_prompt_for_griptape_cloud_library is None:
+        default_prompt_for_griptape_cloud_library = False
+    explainer = """[bold cyan]Griptape Cloud Library[/bold cyan]
+    Would you like to install the Griptape Nodes Griptape Cloud Library?
+    This node library makes Griptape Cloud APIs and functionality available within Griptape Nodes.
+    For example, nodes are available for invoking Structures, Assistants, or even publishing a Workflow to Griptape Cloud.
+    The Griptape Nodes Griptape Cloud Library can be added later by following instructions here: [bold blue][link=https://docs.griptapenodes.com]https://docs.griptapenodes.com[/link][/bold blue].
+    """
+    console.print(Panel(explainer, expand=False))
+
+    return Confirm.ask("Register Griptape Cloud Library?", default=default_prompt_for_griptape_cloud_library)
+
+
+def _build_libraries_list(
+    *, register_advanced_library: bool | None = False, register_griptape_cloud_library: bool | None = False
+) -> list[str]:
+    """Builds the list of libraries to register based on library settings."""
     # TODO: https://github.com/griptape-ai/griptape-nodes/issues/929
     libraries_key = "app_events.on_app_initialization_complete.libraries_to_register"
     library_base_dir = Path(ENV_LIBRARIES_BASE_DIR)
@@ -509,6 +541,20 @@ def _build_libraries_list(*, register_advanced_library: bool) -> list[str]:
         for lib in libraries_to_remove:
             new_libraries.remove(lib)
 
+    griptape_cloud_library = str(library_base_dir / "griptape_cloud/griptape_nodes_library.json")
+    griptape_cloud_identifier = _get_library_identifier(griptape_cloud_library)
+    if register_griptape_cloud_library:
+        # If the griptape cloud library is not registered, add it
+        if griptape_cloud_identifier not in current_identifiers:
+            new_libraries.append(griptape_cloud_library)
+    else:
+        # If the griptape cloud library is registered, remove it
+        libraries_to_remove = [
+            lib for lib in new_libraries if _get_library_identifier(lib) == griptape_cloud_identifier
+        ]
+        for lib in libraries_to_remove:
+            new_libraries.remove(lib)
+
     return new_libraries
 
 

{griptape_nodes-0.58.0 → griptape_nodes-0.59.0}/src/griptape_nodes/cli/shared.py

@@ -18,6 +18,7 @@ class InitConfig:
     api_key: str | None = None
     storage_backend: str | None = None
     register_advanced_library: bool | None = None
+    register_griptape_cloud_library: bool | None = None
     config_values: dict[str, Any] | None = None
     secret_values: dict[str, str] | None = None
     libraries_sync: bool | None = None