griptape-nodes 0.64.11__py3-none-any.whl → 0.65.0__py3-none-any.whl

griptape_nodes/retained_mode/managers/secrets_manager.py

@@ -23,6 +23,7 @@ from griptape_nodes.retained_mode.events.secrets_events import (
 )
 from griptape_nodes.retained_mode.managers.config_manager import ConfigManager
 from griptape_nodes.retained_mode.managers.event_manager import EventManager
+from griptape_nodes.retained_mode.managers.settings import SECRETS_TO_REGISTER_KEY
 
 logger = logging.getLogger("griptape_nodes")
 
@@ -60,9 +61,7 @@ class SecretsManager:
         """
         secret_names = set()
 
-        secrets_to_register = self.config_manager.get_config_value(
-            "app_events.on_app_initialization_complete.secrets_to_register", default=[]
-        )
+        secrets_to_register = self.config_manager.get_config_value(SECRETS_TO_REGISTER_KEY, default=[])
 
         secret_names.update(secrets_to_register)
 

griptape_nodes/retained_mode/managers/settings.py

@@ -6,6 +6,14 @@ from typing import Any, Literal
 from pydantic import BaseModel, ConfigDict, field_validator
 from pydantic import Field as PydanticField
 
+LIBRARIES_TO_REGISTER_KEY = "app_events.on_app_initialization_complete.libraries_to_register"
+LIBRARIES_TO_DOWNLOAD_KEY = "app_events.on_app_initialization_complete.libraries_to_download"
+WORKFLOWS_TO_REGISTER_KEY = "app_events.on_app_initialization_complete.workflows_to_register"
+SECRETS_TO_REGISTER_KEY = "app_events.on_app_initialization_complete.secrets_to_register"
+MODELS_TO_DOWNLOAD_KEY = "app_events.on_app_initialization_complete.models_to_download"
+PROJECTS_TO_REGISTER_KEY = "app_events.on_app_initialization_complete.projects_to_register"
+EVENTS_TO_ECHO_KEY = "app_events.events_to_echo_as_retained_mode"
+
 
 class Category(BaseModel):
     """A category with name and optional description."""
@@ -95,7 +103,14 @@ class MCPServerConfig(BaseModel):
 
 
 class AppInitializationComplete(BaseModel):
-    libraries_to_register: list[str] = Field(default_factory=list)
+    libraries_to_download: list[str] = Field(
+        default_factory=list,
+        description="Git URLs of libraries to automatically download when the engine starts. Downloaded into libraries_directory. Supports full URLs or GitHub shorthand (e.g., 'user/repo'). Optionally specify a branch, tag, or commit with @ref syntax (e.g., 'user/repo@stable' or 'https://github.com/user/repo@v1.0.0'). If no ref is specified, uses the repository's default branch.",
+    )
+    libraries_to_register: list[str] = Field(
+        default_factory=list,
+        description="Libraries to automatically load when the engine starts. Can contain paths to individual griptape_nodes_library.json files or directory paths (scanned recursively for library JSON files).",
+    )
     workflows_to_register: list[str] = Field(default_factory=list)
     secrets_to_register: list[str] = Field(
         default_factory=lambda: ["HF_TOKEN", "GT_CLOUD_API_KEY"],
@@ -155,6 +170,11 @@ class Settings(BaseModel):
         default="sandbox_library",
         description="Path to the sandbox library directory (useful while developing nodes). If presented as just a directory (e.g., 'sandbox_library') it will be interpreted as being relative to the workspace directory.",
     )
+    libraries_directory: str = Field(
+        category=FILE_SYSTEM,
+        default="libraries",
+        description="Path to directory for downloaded libraries. All griptape_nodes_library.json files found recursively will be auto-discovered on startup. Relative paths are interpreted relative to the workspace directory.",
+    )
     app_events: AppEvents = Field(
         category=APPLICATION_EVENTS,
         default_factory=AppEvents,

griptape_nodes/retained_mode/managers/sync_manager.py

@@ -25,6 +25,7 @@ from griptape_nodes.retained_mode.events.workflow_events import (
     RegisterWorkflowsFromConfigResultSuccess,
 )
 from griptape_nodes.retained_mode.griptape_nodes import GriptapeNodes
+from griptape_nodes.retained_mode.managers.settings import WORKFLOWS_TO_REGISTER_KEY
 
 if TYPE_CHECKING:
     from griptape_nodes.retained_mode.events.base_events import ResultPayload
@@ -490,9 +491,7 @@ class SyncManager:
         if synced_workflows:
             logger.info("Registering %d synced workflows from configuration", len(synced_workflows))
             try:
-                register_request = RegisterWorkflowsFromConfigRequest(
-                    config_section="app_events.on_app_initialization_complete.workflows_to_register"
-                )
+                register_request = RegisterWorkflowsFromConfigRequest(config_section=WORKFLOWS_TO_REGISTER_KEY)
                 register_result = GriptapeNodes.handle_request(register_request)
 
                 if isinstance(register_result, RegisterWorkflowsFromConfigResultSuccess):