griptape-nodes 0.40.0__tar.gz → 0.42.0__tar.gz

{griptape_nodes-0.40.0 → griptape_nodes-0.42.0}/CLAUDE.md

@@ -183,3 +183,20 @@ Do what has been asked; nothing more, nothing less.
 NEVER create files unless they're absolutely necessary for achieving your goal.
 ALWAYS prefer editing an existing file to creating a new one.
 NEVER proactively create documentation files (\*.md) or README files. Only create documentation files if explicitly requested by the User.
+
+# Code Style Preferences
+
+**Avoid tuples for return values** - Tuples should be a last resort. When unavoidable, use NamedTuples for clarity. Prefer separate variables, class instances, or other data structures.
+
+**Simple, readable logic flow** - Prefer simple, easy-to-follow logic over complex nested expressions:
+
+- Use explicit if/else statements instead of ternary operators or nested conditionals
+- Put failure cases at the top so the success path flows naturally to the bottom
+- Avoid complex nested expressions - break them into clear, separate statements
+- Example: Instead of `value = func() if condition else None`, use:
+    ```python
+    if condition:
+        value = func()
+    else:
+        value = None
+    ```

{griptape_nodes-0.40.0 → griptape_nodes-0.42.0}/Makefile

@@ -35,6 +35,8 @@ version/publish: ## Create and push git tags.
 	@git tag stable -f
 	@git push -f --tags
 	# Push to a release branch (e.g. release/v0.34).
+	# Create branch if it doesn't exist locally, otherwise checkout existing branch
+	@git checkout -b release/v$$(make version/get | awk -F. '{print $$1 "." $$2}') || git checkout release/v$$(make version/get | awk -F. '{print $$1 "." $$2}')
 	@git push -u origin release/v$$(make version/get | awk -F. '{print $$1 "." $$2}')
 	
 .PHONY: run

{griptape_nodes-0.40.0 → griptape_nodes-0.42.0}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: griptape-nodes
-Version: 0.40.0
+Version: 0.42.0
 Summary: Add your description here
 License-File: LICENSE
-Requires-Python: ~=3.12
+Requires-Python: <3.13,>=3.12.0
 Requires-Dist: fastapi>=0.115.12
 Requires-Dist: griptape[drivers-prompt-amazon-bedrock,drivers-prompt-anthropic,drivers-prompt-cohere,drivers-prompt-ollama,drivers-web-scraper-trafilatura,drivers-web-search-duckduckgo,drivers-web-search-exa,loaders-image]>=1.7.1
 Requires-Dist: httpx<1.0.0,>=0.28.0

{griptape_nodes-0.40.0 → griptape_nodes-0.42.0}/install.ps1

@@ -11,7 +11,17 @@ Function ColorWrite {
 }
 # -----------------------------------
 
-ColorWrite "`nInstalling uv...`n" 'Cyan'
+# Check if uv is already installed
+$existingUv = Get-Command uv -ErrorAction SilentlyContinue
+if ($existingUv) {
+    ColorWrite "uv is already installed. Using existing installation..." 'Cyan'
+    $uvInstallPath = $existingUv.Source
+} else {
+    ColorWrite "Installing uv..." 'Cyan'
+    $env:UV_UNMANAGED_INSTALL = Join-Path $env:USERPROFILE '.local\share\griptape_nodes\bin'
+    $uvInstallPath = Join-Path $env:USERPROFILE '.local\share\griptape_nodes\bin\uv.exe'
+}
+
 try {
     powershell -ExecutionPolicy Bypass -c "irm https://astral.sh/uv/install.ps1 | iex" > $null
 } catch {
@@ -21,11 +31,15 @@ try {
 ColorWrite "uv installed successfully." 'Green'
 
 ColorWrite "`nInstalling Griptape Nodes Engine...`n" 'Cyan'
-$localBin = Join-Path $env:USERPROFILE '.local\bin'
-$uvPath = Join-Path $localBin 'uv.exe'
+
+# Verify uv installation
+if (-not (Test-Path $uvInstallPath)) {
+    ColorWrite "Error: uv installation failed at expected path: $uvInstallPath" 'Red'
+    exit 1
+}
 
 # Install griptape-nodes
-& $uvPath tool install --force --python python3.12 griptape-nodes > $null
+& $uvInstallPath tool install --force --python python3.12 griptape-nodes > $null
 
 if (-not (Get-Command griptape-nodes -ErrorAction SilentlyContinue)) {
     ColorWrite "**************************************" 'Green'

{griptape_nodes-0.40.0 → griptape_nodes-0.42.0}/install.sh

@@ -14,24 +14,30 @@ fi
 cecho() { printf "%b%s%b\n" "$1" "$2" "$RESET"; } # colour echo
 # -----------------------------------
 
-echo ""
-cecho "$CYAN$BOLD" "Installing uv..."
-echo ""
-curl -LsSf https://astral.sh/uv/install.sh | sh >/dev/null
+# Check if uv is already installed
+if command -v uv >/dev/null 2>&1; then
+  cecho "$CYAN" "uv is already installed. Using existing installation..."
+  UV_PATH=$(command -v uv)
+else
+  cecho "$CYAN" "Installing uv..."
+  export UV_UNMANAGED_INSTALL="$HOME/.local/share/griptape_nodes/bin"
+  curl -LsSf https://astral.sh/uv/install.sh | sh >/dev/null
+  UV_PATH="$HOME/.local/share/griptape_nodes/bin/uv"
+fi
+
 cecho "$GREEN$BOLD" "uv installed successfully!"
 
-# Verify uv is on the user's PATH
-if ! command -v uv >/dev/null 2>&1; then
-  cecho "$RED" "Error: Griptape Nodes dependency 'uv' was installed but requires the terminal instance to be restarted to be run."
-  cecho "$RED" "Please close this terminal instance, open a new terminal instance, and then run the install command you performed earlier."
+# Verify uv installation
+if [ ! -f "$UV_PATH" ]; then
+  cecho "$RED" "Error: uv installation failed at expected path: $UV_PATH"
   exit 1
 fi
 
 echo ""
 cecho "$CYAN$BOLD" "Installing Griptape Nodes Engine..."
 echo ""
-~/.local/bin/uv tool update-shell
-~/.local/bin/uv tool install --force --python python3.12 griptape-nodes >/dev/null
+"$UV_PATH" tool update-shell
+"$UV_PATH" tool install --force --python python3.12 griptape-nodes >/dev/null
 
 cecho "$GREEN$BOLD" "**************************************"
 cecho "$GREEN$BOLD" "*      Installation complete!        *"

{griptape_nodes-0.40.0 → griptape_nodes-0.42.0}/libraries/griptape_nodes_advanced_media_library/diffusers_nodes_library/pipelines/amused/amused_pipeline_parameters.py

@@ -13,6 +13,7 @@ from diffusers_nodes_library.common.parameters.huggingface_repo_parameter import
 from diffusers_nodes_library.common.parameters.seed_parameter import SeedParameter  # type: ignore[reportMissingImports]
 from griptape_nodes.exe_types.core_types import Parameter, ParameterMode
 from griptape_nodes.exe_types.node_types import BaseNode
+from griptape_nodes.retained_mode.griptape_nodes import GriptapeNodes
 
 logger = logging.getLogger("diffusers_nodes_library")
 
@@ -32,6 +33,14 @@ class AmusedPipelineParameters:
         )
         self._seed_parameter = SeedParameter(node)
 
+    def _get_temp_directory_path(self) -> str:
+        """Get the configured temp directory path for this library."""
+        # Get configured temp folder name, default to "intermediates"
+        temp_folder_name = GriptapeNodes.ConfigManager().get_config_value("advanced_media_library.temp_folder_name")
+        if temp_folder_name is None:
+            temp_folder_name = "intermediates"
+        return temp_folder_name
+
     # ------------------------------------------------------------------
     # Parameter registration helpers
     # ------------------------------------------------------------------
@@ -175,7 +184,10 @@ class AmusedPipelineParameters:
         width = self.get_width()
         height = self.get_height()
         preview_placeholder_image = PIL.Image.new("RGB", (width, height), color="black")
-        self._node.publish_update_to_parameter("output_image", pil_to_image_artifact(preview_placeholder_image))
+        self._node.publish_update_to_parameter(
+            "output_image",
+            pil_to_image_artifact(preview_placeholder_image, directory_path=self._get_temp_directory_path()),
+        )
 
     def latents_to_image_pil(self, pipe: diffusers.AmusedPipeline, latents: torch.Tensor) -> Image:
         """Convert latents to PIL image using the pipeline's VQ-VAE decoder."""
@@ -208,7 +220,9 @@ class AmusedPipelineParameters:
     def publish_output_image_preview_latents(self, pipe: diffusers.AmusedPipeline, latents: torch.Tensor) -> None:
         """Publish preview image from latents during inference."""
         preview_image_pil = self.latents_to_image_pil(pipe, latents)
-        preview_image_artifact = pil_to_image_artifact(preview_image_pil)
+        preview_image_artifact = pil_to_image_artifact(
+            preview_image_pil, directory_path=self._get_temp_directory_path()
+        )
         self._node.publish_update_to_parameter("output_image", preview_image_artifact)
 
     def publish_output_image(self, output_image_pil: Image) -> None:

{griptape_nodes-0.40.0 → griptape_nodes-0.42.0}/libraries/griptape_nodes_advanced_media_library/diffusers_nodes_library/pipelines/flux/flux_fill_pipeline_parameters.py

@@ -15,6 +15,7 @@ from diffusers_nodes_library.common.parameters.huggingface_repo_parameter import
 from diffusers_nodes_library.common.parameters.seed_parameter import SeedParameter
 from griptape_nodes.exe_types.core_types import Parameter, ParameterMode
 from griptape_nodes.exe_types.node_types import BaseNode
+from griptape_nodes.retained_mode.griptape_nodes import GriptapeNodes
 
 logger = logging.getLogger("diffusers_nodes_library")
 
@@ -31,6 +32,14 @@ class FluxFillPipelineParameters:
         self._seed_parameter = SeedParameter(node)
         self._input_image_size = (None, None)
 
+    def _get_temp_directory_path(self) -> str:
+        """Get the configured temp directory path for this library."""
+        # Get configured temp folder name, default to "intermediates"
+        temp_folder_name = GriptapeNodes.ConfigManager().get_config_value("advanced_media_library.temp_folder_name")
+        if temp_folder_name is None:
+            temp_folder_name = "intermediates"
+        return temp_folder_name
+
     def add_input_parameters(self) -> None:
         self._huggingface_repo_parameter.add_input_parameters()
         self._node.add_parameter(
@@ -190,7 +199,10 @@ class FluxFillPipelineParameters:
         # Immediately set a preview placeholder image to make it react quickly and adjust
         # the size of the image preview on the node.
         preview_placeholder_image = PIL.Image.new("RGB", (width, height), color="black")
-        self._node.publish_update_to_parameter("output_image", pil_to_image_artifact(preview_placeholder_image))
+        self._node.publish_update_to_parameter(
+            "output_image",
+            pil_to_image_artifact(preview_placeholder_image, directory_path=self._get_temp_directory_path()),
+        )
 
     def latents_to_image_pil(
         self, pipe: diffusers.FluxPipeline | diffusers.FluxControlNetPipeline, latents: Any
@@ -207,7 +219,9 @@ class FluxFillPipelineParameters:
         self, pipe: diffusers.FluxPipeline | diffusers.FluxControlNetPipeline, latents: Any
     ) -> None:
         preview_image_pil = self.latents_to_image_pil(pipe, latents)
-        preview_image_artifact = pil_to_image_artifact(preview_image_pil)
+        preview_image_artifact = pil_to_image_artifact(
+            preview_image_pil, directory_path=self._get_temp_directory_path()
+        )
         self._node.publish_update_to_parameter("output_image", preview_image_artifact)
 
     def publish_output_image(self, output_image_pil: Image) -> None:

{griptape_nodes-0.40.0 → griptape_nodes-0.42.0}/libraries/griptape_nodes_advanced_media_library/diffusers_nodes_library/pipelines/flux/flux_kontext_pipeline_parameters.py

@@ -15,6 +15,7 @@ from diffusers_nodes_library.common.parameters.huggingface_repo_parameter import
 from diffusers_nodes_library.common.parameters.seed_parameter import SeedParameter
 from griptape_nodes.exe_types.core_types import Parameter, ParameterMode
 from griptape_nodes.exe_types.node_types import BaseNode
+from griptape_nodes.retained_mode.griptape_nodes import GriptapeNodes
 from griptape_nodes.traits.options import Options
 
 logger = logging.getLogger("diffusers_nodes_library")
@@ -31,6 +32,14 @@ class FluxKontextPipelineParameters:
         )
         self._seed_parameter = SeedParameter(node)
 
+    def _get_temp_directory_path(self) -> str:
+        """Get the configured temp directory path for this library."""
+        # Get configured temp folder name, default to "intermediates"
+        temp_folder_name = GriptapeNodes.ConfigManager().get_config_value("advanced_media_library.temp_folder_name")
+        if temp_folder_name is None:
+            temp_folder_name = "intermediates"
+        return temp_folder_name
+
     def add_input_parameters(self) -> None:
         self._huggingface_repo_parameter.add_input_parameters()
         self._node.add_parameter(
@@ -282,7 +291,10 @@ class FluxKontextPipelineParameters:
     def publish_output_image_preview_placeholder(self) -> None:
         width, height = self.get_effective_size()
         preview_placeholder_image = PIL.Image.new("RGB", (width, height), color="black")
-        self._node.publish_update_to_parameter("output_image", pil_to_image_artifact(preview_placeholder_image))
+        self._node.publish_update_to_parameter(
+            "output_image",
+            pil_to_image_artifact(preview_placeholder_image, directory_path=self._get_temp_directory_path()),
+        )
 
     def latents_to_image_pil(self, pipe: diffusers.FluxKontextPipeline, latents: Any) -> Image:
         width, height = self.get_effective_size()
@@ -294,7 +306,9 @@ class FluxKontextPipelineParameters:
 
     def publish_output_image_preview_latents(self, pipe: diffusers.FluxKontextPipeline, latents: Any) -> None:
         preview_image_pil = self.latents_to_image_pil(pipe, latents)
-        preview_image_artifact = pil_to_image_artifact(preview_image_pil)
+        preview_image_artifact = pil_to_image_artifact(
+            preview_image_pil, directory_path=self._get_temp_directory_path()
+        )
         self._node.publish_update_to_parameter("output_image", preview_image_artifact)
 
     def publish_output_image(self, output_image_pil: Image) -> None:

{griptape_nodes-0.40.0 → griptape_nodes-0.42.0}/libraries/griptape_nodes_advanced_media_library/diffusers_nodes_library/pipelines/flux/flux_pipeline_parameters.py

@@ -10,6 +10,7 @@ from diffusers_nodes_library.common.parameters.huggingface_repo_parameter import
 from diffusers_nodes_library.common.parameters.seed_parameter import SeedParameter
 from griptape_nodes.exe_types.core_types import Parameter, ParameterMode
 from griptape_nodes.exe_types.node_types import BaseNode
+from griptape_nodes.retained_mode.griptape_nodes import GriptapeNodes
 
 logger = logging.getLogger("diffusers_nodes_library")
 
@@ -26,6 +27,14 @@ class FluxPipelineParameters:
         )
         self._seed_parameter = SeedParameter(node)
 
+    def _get_temp_directory_path(self) -> str:
+        """Get the configured temp directory path for this library."""
+        # Get configured temp folder name, default to "intermediates"
+        temp_folder_name = GriptapeNodes.ConfigManager().get_config_value("advanced_media_library.temp_folder_name")
+        if temp_folder_name is None:
+            temp_folder_name = "intermediates"
+        return temp_folder_name
+
     def add_input_parameters(self) -> None:
         self._huggingface_repo_parameter.add_input_parameters()
         self._node.add_parameter(
@@ -159,7 +168,10 @@ class FluxPipelineParameters:
         # Immediately set a preview placeholder image to make it react quickly and adjust
         # the size of the image preview on the node.
         preview_placeholder_image = PIL.Image.new("RGB", (width, height), color="black")
-        self._node.publish_update_to_parameter("output_image", pil_to_image_artifact(preview_placeholder_image))
+        self._node.publish_update_to_parameter(
+            "output_image",
+            pil_to_image_artifact(preview_placeholder_image, directory_path=self._get_temp_directory_path()),
+        )
 
     def get_prompt(self) -> str:
         return self._node.get_parameter_value("prompt")
@@ -218,7 +230,9 @@ class FluxPipelineParameters:
         self, pipe: diffusers.FluxPipeline | diffusers.FluxControlNetPipeline, latents: Any
     ) -> None:
         preview_image_pil = self.latents_to_image_pil(pipe, latents)
-        preview_image_artifact = pil_to_image_artifact(preview_image_pil)
+        preview_image_artifact = pil_to_image_artifact(
+            preview_image_pil, directory_path=self._get_temp_directory_path()
+        )
         self._node.publish_update_to_parameter("output_image", preview_image_artifact)
 
     def publish_output_image(self, output_image_pil: Image) -> None:

{griptape_nodes-0.40.0 → griptape_nodes-0.42.0}/libraries/griptape_nodes_advanced_media_library/diffusers_nodes_library/pipelines/flux/tiling_flux_img_2_img_pipeline.py

@@ -29,6 +29,7 @@ from diffusers_nodes_library.pipelines.flux.flux_pipeline_parameters import (
 )
 from griptape_nodes.exe_types.core_types import Parameter
 from griptape_nodes.exe_types.node_types import AsyncResult, ControlNode
+from griptape_nodes.retained_mode.griptape_nodes import GriptapeNodes
 from griptape_nodes.traits.options import Options
 
 logger = logging.getLogger("diffusers_nodes_library")
@@ -107,9 +108,23 @@ class TilingFluxImg2ImgPipeline(ControlNode):
         self.flux_params.add_output_parameters()
         self.log_params.add_output_parameters()
 
+    def _get_temp_directory_path(self) -> str:
+        """Get the configured temp directory path for this library."""
+        # Get configured temp folder name, default to "intermediates"
+        temp_folder_name = GriptapeNodes.ConfigManager().get_config_value("advanced_media_library.temp_folder_name")
+        if temp_folder_name is None:
+            temp_folder_name = "intermediates"
+        return temp_folder_name
+
     def after_value_set(self, parameter: Parameter, value: Any) -> None:
         self.flux_params.after_value_set(parameter, value)
 
+    def validate_before_node_run(self) -> list[Exception] | None:
+        input_image = self.get_parameter_value("input_image")
+        if input_image is None:
+            return [ValueError("input_image is required")]
+        return []
+
     def preprocess(self) -> None:
         self.flux_params.preprocess()
 
@@ -133,7 +148,10 @@ class TilingFluxImg2ImgPipeline(ControlNode):
         # Immediately set a preview placeholder image to make it react quickly and adjust
         # the size of the image preview on the node.
         preview_placeholder_image = PIL.Image.new("RGB", input_image_pil.size, color="black")
-        self.publish_update_to_parameter("output_image", pil_to_image_artifact(preview_placeholder_image))
+        self.publish_update_to_parameter(
+            "output_image",
+            pil_to_image_artifact(preview_placeholder_image, directory_path=self._get_temp_directory_path()),
+        )
 
         # Adjust tile size so that it is not much bigger than the input image.
         largest_reasonable_tile_width = next_multiple_ge(input_image_pil.width, 16)
@@ -194,7 +212,10 @@ class TilingFluxImg2ImgPipeline(ControlNode):
                     # HERE -> need to update the tile by calling something in the tile processor.
                     preview_image_with_partial_tile = get_preview_image_with_partial_tile(intermediate_pil_image)
                     self.publish_update_to_parameter(
-                        "output_image", pil_to_image_artifact(preview_image_with_partial_tile)
+                        "output_image",
+                        pil_to_image_artifact(
+                            preview_image_with_partial_tile, directory_path=self._get_temp_directory_path()
+                        ),
                     )
                     self.append_value_to_parameter(
                         "logs", f"Finished inference step {i + 1} of {num_inference_steps}.\n"
@@ -231,7 +252,10 @@ class TilingFluxImg2ImgPipeline(ControlNode):
 
         def callback_on_tile_end(i: int, preview_image_pil: Image) -> None:
             if i < num_tiles:
-                self.publish_update_to_parameter("output_image", pil_to_image_artifact(preview_image_pil))
+                self.publish_update_to_parameter(
+                    "output_image",
+                    pil_to_image_artifact(preview_image_pil, directory_path=self._get_temp_directory_path()),
+                )
                 self.log_params.append_to_logs(f"Finished tile {i} of {num_tiles}.\n")
                 self.log_params.append_to_logs(f"Starting tile {i + 1} of {num_tiles}...\n")
 

{griptape_nodes-0.40.0 → griptape_nodes-0.42.0}/libraries/griptape_nodes_advanced_media_library/diffusers_nodes_library/pipelines/stable_diffusion/stable_diffusion_pipeline_parameters.py

@@ -10,6 +10,7 @@ from diffusers_nodes_library.common.parameters.huggingface_repo_parameter import
 from diffusers_nodes_library.common.parameters.seed_parameter import SeedParameter
 from griptape_nodes.exe_types.core_types import Parameter, ParameterMode
 from griptape_nodes.exe_types.node_types import BaseNode
+from griptape_nodes.retained_mode.griptape_nodes import GriptapeNodes
 
 logger = logging.getLogger("diffusers_nodes_library")
 
@@ -30,6 +31,14 @@ class StableDiffusionPipelineParameters:
         )
         self._seed_parameter = SeedParameter(node)
 
+    def _get_temp_directory_path(self) -> str:
+        """Get the configured temp directory path for this library."""
+        # Get configured temp folder name, default to "intermediates"
+        temp_folder_name = GriptapeNodes.ConfigManager().get_config_value("advanced_media_library.temp_folder_name")
+        if temp_folder_name is None:
+            temp_folder_name = "intermediates"
+        return temp_folder_name
+
     def add_input_parameters(self) -> None:
         self._huggingface_repo_parameter.add_input_parameters()
         self._node.add_parameter(
@@ -115,7 +124,10 @@ class StableDiffusionPipelineParameters:
         width = int(self._node.parameter_values["width"])
         height = int(self._node.parameter_values["height"])
         preview_placeholder_image = PIL.Image.new("RGB", (width, height), color="black")
-        self._node.publish_update_to_parameter("output_image", pil_to_image_artifact(preview_placeholder_image))
+        self._node.publish_update_to_parameter(
+            "output_image",
+            pil_to_image_artifact(preview_placeholder_image, directory_path=self._get_temp_directory_path()),
+        )
 
     def get_prompt(self) -> str:
         return self._node.get_parameter_value("prompt")
@@ -159,7 +171,9 @@ class StableDiffusionPipelineParameters:
 
     def publish_output_image_preview_latents(self, pipe: diffusers.StableDiffusionPipeline, latents: Any) -> None:
         preview_image_pil = self.latents_to_image_pil(pipe, latents)
-        preview_image_artifact = pil_to_image_artifact(preview_image_pil)
+        preview_image_artifact = pil_to_image_artifact(
+            preview_image_pil, directory_path=self._get_temp_directory_path()
+        )
         self._node.publish_update_to_parameter("output_image", preview_image_artifact)
 
     def publish_output_image(self, output_image_pil: Image) -> None:

{griptape_nodes-0.40.0 → griptape_nodes-0.42.0}/libraries/griptape_nodes_advanced_media_library/diffusers_nodes_library/pipelines/stable_diffusion_ae/stable_diffusion_ae_pipeline_parameters.py

@@ -11,6 +11,7 @@ from diffusers_nodes_library.common.parameters.huggingface_repo_parameter import
 from diffusers_nodes_library.common.parameters.seed_parameter import SeedParameter
 from griptape_nodes.exe_types.core_types import Parameter, ParameterMode
 from griptape_nodes.exe_types.node_types import BaseNode
+from griptape_nodes.retained_mode.griptape_nodes import GriptapeNodes
 
 logger = logging.getLogger("diffusers_nodes_library")
 
@@ -31,6 +32,14 @@ class StableDiffusionAttendAndExcitePipelineParameters:
         )
         self._seed_parameter = SeedParameter(node)
 
+    def _get_temp_directory_path(self) -> str:
+        """Get the configured temp directory path for this library."""
+        # Get configured temp folder name, default to "intermediates"
+        temp_folder_name = GriptapeNodes.ConfigManager().get_config_value("advanced_media_library.temp_folder_name")
+        if temp_folder_name is None:
+            temp_folder_name = "intermediates"
+        return temp_folder_name
+
     def add_input_parameters(self) -> None:
         self._huggingface_repo_parameter.add_input_parameters()
         self._node.add_parameter(
@@ -211,7 +220,7 @@ class StableDiffusionAttendAndExcitePipelineParameters:
 
     def publish_output_image_preview_placeholder(self) -> None:
         placeholder_image = PIL.Image.new("RGB", (self.get_width(), self.get_height()), "black")
-        placeholder_artifact = pil_to_image_artifact(placeholder_image)
+        placeholder_artifact = pil_to_image_artifact(placeholder_image, directory_path=self._get_temp_directory_path())
         self._node.set_parameter_value("output_image", placeholder_artifact)
 
     def latents_to_image_pil(self, pipe: diffusers.StableDiffusionAttendAndExcitePipeline, latents: Any) -> Image:
@@ -225,7 +234,9 @@ class StableDiffusionAttendAndExcitePipelineParameters:
     ) -> None:
         try:
             preview_image_pil = self.latents_to_image_pil(pipe, latents)
-            preview_image_artifact = pil_to_image_artifact(preview_image_pil)
+            preview_image_artifact = pil_to_image_artifact(
+                preview_image_pil, directory_path=self._get_temp_directory_path()
+            )
             self._node.publish_update_to_parameter("output_image", preview_image_artifact)
         except Exception as e:
             logger.warning("Failed to publish preview from latents: %s", e)

{griptape_nodes-0.40.0 → griptape_nodes-0.42.0}/libraries/griptape_nodes_advanced_media_library/griptape_nodes_library.json

@@ -1,11 +1,20 @@
 {
   "name": "Griptape Nodes Advanced Media Library",
   "library_schema_version": "0.1.0",
+  "settings": [
+    {
+      "description": "Configuration settings for the Advanced Media Library temporary file storage",
+      "category": "advanced_media_library",
+      "contents": {
+        "temp_folder_name": "intermediates"
+      }
+    }
+  ],
   "metadata": {
     "author": "Griptape, Inc.",
     "description": "Advanced media generation and manipulation nodes for Griptape Nodes.",
-    "library_version": "0.39.0",
-    "engine_version": "0.39.0",
+    "library_version": "0.41.0",
+    "engine_version": "0.41.0",
     "tags": [
       "Griptape",
       "AI"
@@ -113,7 +122,7 @@
       }
     },
     {
-      "class_name": "DinoSam2VideoDetector", 
+      "class_name": "DinoSam2VideoDetector",
       "file_path": "dino_sam2_library/dino_sam_2_video_detector.py",
       "metadata": {
         "category": "video/segmentation",
@@ -253,7 +262,7 @@
       "metadata": {
         "category": "image/upscale",
         "description": "Generate Image Variation with Flux via 🤗 Diffusers using a tiling strategy that allows efficient processing of hi-res images. Without the tiling the quadratic cost of transformer models will consume your GPU and time.",
-        "display_name": "Flux Post-Upscale"
+        "display_name": "Flux Post Upscale"
       }
     },
     {
@@ -491,4 +500,4 @@
       }
     }
   ]
-}
+}

{griptape_nodes-0.40.0 → griptape_nodes-0.42.0}/libraries/griptape_nodes_advanced_media_library/pillow_nodes_library/utils.py

@@ -12,14 +12,22 @@ def image_artifact_to_pil(image_artifact: ImageArtifact) -> Image:
     return PIL.Image.open(io.BytesIO(image_artifact.value))
 
 
-def pil_to_image_artifact(pil_image: Image) -> ImageUrlArtifact:
+def pil_to_image_artifact(pil_image: Image, directory_path: str = "") -> ImageUrlArtifact:
     """Converts Pillow Image to Griptape ImageArtifact."""
     from griptape_nodes.retained_mode.griptape_nodes import GriptapeNodes
 
     image_io = io.BytesIO()
     pil_image.save(image_io, "PNG")
     image_bytes = image_io.getvalue()
-    url = GriptapeNodes.StaticFilesManager().save_static_file(image_bytes, f"{uuid.uuid4()}.png")
+
+    if directory_path:
+        # Use the provided directory path
+        filename = f"{directory_path}/{uuid.uuid4()}.png"
+    else:
+        # No directory prefix - direct storage
+        filename = f"{uuid.uuid4()}.png"
+
+    url = GriptapeNodes.StaticFilesManager().save_static_file(image_bytes, filename)
     return ImageUrlArtifact(url)
 
 

{griptape_nodes-0.40.0 → griptape_nodes-0.42.0}/libraries/griptape_nodes_library/griptape_nodes_library/execution/for_each_start.py

@@ -79,7 +79,9 @@ class ForEachStartNode(StartLoopNode):
                 self._items = []
         # Get the current item and pass it along.
         # I need to unresolve all future nodes (all of them in the for each loop).
-        self._flow.connections.unresolve_future_nodes(self)
+        from griptape_nodes.retained_mode.griptape_nodes import GriptapeNodes
+
+        GriptapeNodes.FlowManager().get_connections().unresolve_future_nodes(self)
         current_item_value = self._items[self.current_index]
         self.parameter_output_values["current_item"] = current_item_value
         self.set_parameter_value("index", self.current_index)

{griptape_nodes-0.40.0 → griptape_nodes-0.42.0}/libraries/griptape_nodes_library/griptape_nodes_library/execution/for_loop_start.py

@@ -80,7 +80,9 @@ class ForLoopStartNode(ForEachStartNode):
             self.current_index = 0  # Start at 0 for proper end node synchronization
 
         # Unresolve all future nodes at the start of processing
-        self._flow.connections.unresolve_future_nodes(self)
+        from griptape_nodes.retained_mode.griptape_nodes import GriptapeNodes
+
+        GriptapeNodes.FlowManager().get_connections().unresolve_future_nodes(self)
 
         # Get the current value and pass it along
         step = self.get_parameter_value("step")

{griptape_nodes-0.40.0 → griptape_nodes-0.42.0}/libraries/griptape_nodes_library/griptape_nodes_library/utils/error_utils.py

@@ -33,7 +33,10 @@ def try_throw_error(agent_output: BaseArtifact) -> None:
     """Throws an error if the agent output is an ErrorArtifact."""
     if isinstance(agent_output, ErrorArtifact):
         if isinstance(agent_output.exception, requests.HTTPError):
-            error_message = _parse_griptape_cloud_error_message(agent_output.exception.response.text)
+            if agent_output.exception.response.text:
+                error_message = _parse_griptape_cloud_error_message(agent_output.exception.response.text)
+            else:
+                error_message = str(agent_output.exception)
         else:
             error_message = str(agent_output.value)
         msg = f"Agent run failed because of an exception: {error_message}"

{griptape_nodes-0.40.0 → griptape_nodes-0.42.0}/libraries/griptape_nodes_library/griptape_nodes_library.json

@@ -4,8 +4,8 @@
   "metadata": {
     "author": "Griptape, Inc",
     "description": "Default nodes for Griptape Nodes",
-    "library_version": "0.39.0",
-    "engine_version": "0.39.0",
+    "library_version": "0.41.0",
+    "engine_version": "0.41.0",
     "tags": ["Griptape", "AI"]
   },
   "categories": [