griptape-nodes 0.40.0__py3-none-any.whl → 0.42.0__py3-none-any.whl

griptape_nodes/retained_mode/retained_mode.py

@@ -32,8 +32,10 @@ from griptape_nodes.retained_mode.events.execution_events import (
 from griptape_nodes.retained_mode.events.flow_events import (
     CreateFlowRequest,
     DeleteFlowRequest,
+    GetFlowMetadataRequest,
     ListFlowsInFlowRequest,
     ListNodesInFlowRequest,
+    SetFlowMetadataRequest,
 )
 from griptape_nodes.retained_mode.events.library_events import (
     GetNodeMetadataFromLibraryRequest,
@@ -1247,6 +1249,48 @@ class RetainedMode:
         request = GetFlowStateRequest(flow_name=flow_name)
         return GriptapeNodes().handle_request(request)
 
+    @classmethod
+    def get_metadata_for_flow(cls, flow_name: str) -> ResultPayload:
+        """Retrieves metadata associated with a flow.
+
+        Flow metadata can include UI position, display name, tags, and other custom properties.
+
+        Args:
+            flow_name (str): Name of the flow to get metadata for.
+
+        Returns:
+            ResultPayload: Contains the flow's metadata.
+
+        Example:
+            # Get flow metadata
+            result = cmd.get_metadata_for_flow("my_flow")
+        """
+        request = GetFlowMetadataRequest(flow_name=flow_name)
+        result = GriptapeNodes().handle_request(request)
+        return result
+
+    @classmethod
+    def set_metadata_for_flow(cls, flow_name: str, metadata: dict[Any, Any]) -> ResultPayload:
+        """Sets metadata for a flow.
+
+        Args:
+            flow_name (str): Name of the flow to set metadata for.
+            metadata (dict): Dictionary containing the metadata to set.
+
+        Returns:
+            ResultPayload: Contains the result of the metadata update operation.
+
+        Example:
+            # Set flow position
+            metadata = {
+                "position": {"x": 100, "y": 200}
+            }
+            result = cmd.set_metadata_for_flow("my_flow", metadata)
+        """
+        request = SetFlowMetadataRequest(flow_name=flow_name, metadata=metadata)
+        result = GriptapeNodes().handle_request(request)
+        return result
+
     # ARBITRARY PYTHON EXECUTION
     @classmethod
     def run_arbitrary_python(cls, python_str: str) -> ResultPayload:

griptape_nodes/retained_mode/utils/engine_identity.py

@@ -1,6 +1,7 @@
-"""Manages engine identity for a single engine per machine.
+"""Manages engine identity for multiple engines per machine.
 
 Handles engine ID, name storage, and generation for unique engine identification.
+Supports multiple engines with selection via GTN_ENGINE_ID environment variable.
 """
 
 import json
@@ -15,9 +16,9 @@ from .name_generator import generate_engine_name
 
 
 class EngineIdentity:
-    """Manages engine identity for a single engine per machine."""
+    """Manages engine identity for multiple engines per machine."""
 
-    _ENGINE_DATA_FILE = "engine.json"
+    _ENGINE_DATA_FILE = "engines.json"
 
     @classmethod
     def _get_engine_data_dir(cls) -> Path:
@@ -30,11 +31,11 @@ class EngineIdentity:
         return cls._get_engine_data_dir() / cls._ENGINE_DATA_FILE
 
     @classmethod
-    def _load_engine_data(cls) -> dict:
-        """Load engine data from storage.
+    def _load_engines_data(cls) -> dict:
+        """Load engines data from storage.
 
         Returns:
-            dict: Engine data including id, name, timestamps
+            dict: Engines data structure with engines array and default_engine_id
         """
         engine_data_file = cls._get_engine_data_file()
 
@@ -42,48 +43,124 @@ class EngineIdentity:
             try:
                 with engine_data_file.open("r") as f:
                     data = json.load(f)
-                    if isinstance(data, dict):
+                    if isinstance(data, dict) and "engines" in data:
                         return data
             except (json.JSONDecodeError, OSError):
-                # If file is corrupted, return empty dict
                 pass
 
-        return {}
+        return {"engines": [], "default_engine_id": None}
 
     @classmethod
-    def _save_engine_data(cls, engine_data: dict) -> None:
-        """Save engine data to storage.
+    def _save_engines_data(cls, engines_data: dict) -> None:
+        """Save engines data to storage.
 
         Args:
-            engine_data: Engine data to save
+            engines_data: Engines data structure to save
         """
         engine_data_dir = cls._get_engine_data_dir()
         engine_data_dir.mkdir(parents=True, exist_ok=True)
 
         engine_data_file = cls._get_engine_data_file()
         with engine_data_file.open("w") as f:
-            json.dump(engine_data, f, indent=2)
+            json.dump(engines_data, f, indent=2)
+
+    @classmethod
+    def _get_selected_engine_id(cls) -> str | None:
+        """Get the selected engine ID from environment variable or default.
+
+        Returns:
+            str | None: The selected engine ID or None if not specified
+        """
+        return os.getenv("GTN_ENGINE_ID")
+
+    @classmethod
+    def _find_engine_by_id(cls, engines_data: dict, engine_id: str) -> dict | None:
+        """Find an engine by ID in the engines data.
+
+        Args:
+            engines_data: The engines data structure
+            engine_id: The engine ID to find
+
+        Returns:
+            dict | None: The engine data if found, None otherwise
+        """
+        for engine in engines_data.get("engines", []):
+            if engine.get("id") == engine_id:
+                return engine
+        return None
 
     @classmethod
     def get_engine_data(cls) -> dict:
-        """Get the engine data, creating default if it doesn't exist.
+        """Get the current engine data, creating default if it doesn't exist.
 
         Returns:
-            dict: The engine data
+            dict: The current engine data
         """
-        engine_data = cls._load_engine_data()
+        engines_data = cls._load_engines_data()
+
+        # Determine which engine to use
+        selected_engine_id = cls._get_selected_engine_id()
 
-        if not engine_data or "id" not in engine_data:
-            # Create default engine data
+        if selected_engine_id:
+            # Use specified engine ID
+            engine_data = cls._find_engine_by_id(engines_data, selected_engine_id)
+            if engine_data:
+                return engine_data
+            # If specified engine not found, create it
+            engine_data = {
+                "id": selected_engine_id,
+                "name": generate_engine_name(),
+                "created_at": datetime.now(tz=UTC).isoformat(),
+            }
+        else:
+            # Use default engine (first one) or create new one
+            if engines_data.get("engines"):
+                default_id = engines_data.get("default_engine_id")
+                if default_id:
+                    engine_data = cls._find_engine_by_id(engines_data, default_id)
+                    if engine_data:
+                        return engine_data
+                # Fall back to first engine
+                return engines_data["engines"][0]
+
+            # Create new engine
             engine_data = {
-                "id": os.getenv("GTN_ENGINE_ID") or str(uuid.uuid4()),
+                "id": str(uuid.uuid4()),
                 "name": generate_engine_name(),
                 "created_at": datetime.now(tz=UTC).isoformat(),
             }
-            cls._save_engine_data(engine_data)
 
+        # Add or update engine in the data structure
+        cls._add_or_update_engine(engine_data)
         return engine_data
 
+    @classmethod
+    def _add_or_update_engine(cls, engine_data: dict) -> None:
+        """Add or update an engine in the engines data structure.
+
+        Args:
+            engine_data: The engine data to add or update
+        """
+        engines_data = cls._load_engines_data()
+
+        # Find existing engine
+        engine_id = engine_data["id"]
+        existing_engine = cls._find_engine_by_id(engines_data, engine_id)
+
+        if existing_engine:
+            # Update existing engine
+            existing_engine.update(engine_data)
+            existing_engine["updated_at"] = datetime.now(tz=UTC).isoformat()
+        else:
+            # Add new engine
+            engines_data.setdefault("engines", []).append(engine_data)
+
+            # Set as default if it's the first engine
+            if not engines_data.get("default_engine_id") and len(engines_data["engines"]) == 1:
+                engines_data["default_engine_id"] = engine_id
+
+        cls._save_engines_data(engines_data)
+
     @classmethod
     def get_engine_id(cls) -> str:
         """Get the engine ID.
@@ -106,20 +183,57 @@ class EngineIdentity:
 
     @classmethod
     def set_engine_name(cls, engine_name: str) -> None:
-        """Set and persist the engine name.
+        """Set and persist the current engine name.
 
         Args:
             engine_name: The new engine name to set
         """
-        engine_data = cls._load_engine_data()
-
-        # Ensure we have basic engine data
-        if not engine_data or "id" not in engine_data:
-            engine_data = cls.get_engine_data()
+        # Get current engine data
+        engine_data = cls.get_engine_data()
 
+        # Update the name
         engine_data["name"] = engine_name
         engine_data["updated_at"] = datetime.now(tz=UTC).isoformat()
-        cls._save_engine_data(engine_data)
+
+        # Save updated engine data
+        cls._add_or_update_engine(engine_data)
+
+    @classmethod
+    def get_all_engines(cls) -> list[dict]:
+        """Get all registered engines.
+
+        Returns:
+            list[dict]: List of all engine data
+        """
+        engines_data = cls._load_engines_data()
+        return engines_data.get("engines", [])
+
+    @classmethod
+    def get_default_engine_id(cls) -> str | None:
+        """Get the default engine ID.
+
+        Returns:
+            str | None: The default engine ID or None if not set
+        """
+        engines_data = cls._load_engines_data()
+        return engines_data.get("default_engine_id")
+
+    @classmethod
+    def set_default_engine_id(cls, engine_id: str) -> None:
+        """Set the default engine ID.
+
+        Args:
+            engine_id: The engine ID to set as default
+        """
+        engines_data = cls._load_engines_data()
+
+        # Verify the engine exists
+        if cls._find_engine_by_id(engines_data, engine_id):
+            engines_data["default_engine_id"] = engine_id
+            cls._save_engines_data(engines_data)
+        else:
+            msg = f"Engine with ID {engine_id} not found"
+            raise ValueError(msg)
 
     @classmethod
     def get_engine_data_file_path(cls) -> Path:

{griptape_nodes-0.40.0.dist-info → griptape_nodes-0.42.0.dist-info}/METADATA

@@ -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.dist-info → griptape_nodes-0.42.0.dist-info}/RECORD

@@ -1,10 +1,10 @@
 griptape_nodes/__init__.py,sha256=49jcr4gyvTjpdZDKCek0UqtAMeMdJr-OL_Hx7Ira8CE,37026
 griptape_nodes/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 griptape_nodes/app/.python-version,sha256=e1X45ntWI8S-8_ppEojalDfXnTq6FW3kjUgdsyrH0W0,5
-griptape_nodes/app/__init__.py,sha256=x6FNnJwW9e1cUmsq64UhXWXnHOP-ivv2KT3kST1EmPM,435
-griptape_nodes/app/app.py,sha256=VmGUedjaLcFNu46nvXh2OJqlmLkcU7aYZJh72zW7em8,18876
-griptape_nodes/app/app_sessions.py,sha256=yu9v853CchkcudevPYV_Gqi6P1FBTj-GgszUNc6ZMOA,17701
-griptape_nodes/app/watch.py,sha256=Jh7sQoptOuVzEobyhHG5EThxOcb8wfkW0JOmYE-WDpE,1848
+griptape_nodes/app/__init__.py,sha256=2wdMRsCWieR9md72tBX2UqJowD-WBLLN3VWPzpTIJqw,229
+griptape_nodes/app/app.py,sha256=5RG03clRZWwZeFpeKc3hwxO8TTCbBHblWvZZnG9LPU4,18942
+griptape_nodes/app/app_sessions.py,sha256=sgVIOEmxcQt0oErvfMciOaVWStPh-qNtPZXtXpw1Q-o,21852
+griptape_nodes/app/watch.py,sha256=SkK9ajCEGswjXpujyIlW90YDgTpNDFyDM_jjAhS0t0Y,1988
 griptape_nodes/bootstrap/__init__.py,sha256=ENv3SIzQ9TtlRrg1y4e4CnoBpJaFpFSkNpTFBV8X5Ls,25
 griptape_nodes/bootstrap/bootstrap_script.py,sha256=QLLu3wu1VGmoUU8SKGeyLGDOijKBLGAJYv1RlI9sub0,1312
 griptape_nodes/bootstrap/post_build_install_script.sh,sha256=t2ItVve_2Vk7jMFsfAfVHCAc5sFSDSQkmjglr1USZ7s,48
@@ -23,68 +23,69 @@ griptape_nodes/drivers/__init__.py,sha256=tHmiFQn6uJyFVhC2PrqHgRUH3d3yDsqMQpWqRa
 griptape_nodes/drivers/storage/__init__.py,sha256=_7p8vJt3YnnF6sD3Uxxw38c-gazuMIHSS-m3G6sa2Qk,208
 griptape_nodes/drivers/storage/base_storage_driver.py,sha256=di1tqC-o8tEeZ8h_asUxb5KgixwJbTlQLe_lUtqcunQ,1050
 griptape_nodes/drivers/storage/griptape_cloud_storage_driver.py,sha256=zYQHzHxlE3TcOitytk9WpD3YTKTRyfrzW-H_vXpgTLQ,6083
-griptape_nodes/drivers/storage/local_storage_driver.py,sha256=PnKgnjkhmnzI5SOI3VKXTkwbb5G1lLs25pLTr022W_c,2196
+griptape_nodes/drivers/storage/local_storage_driver.py,sha256=fXtT6NEPeTZgS-mNsy66zd9Cdw17WddjAp4aQdR_oug,2257
 griptape_nodes/drivers/storage/storage_backend.py,sha256=3QBIwrgPc1krBIiPYLoK2swhIPDiKJnnucOEdyx7y3c,184
 griptape_nodes/exe_types/__init__.py,sha256=wGGwKGX9-TSarUFbXpDvdU_J7eXIbWTBl_NCLOZa-G8,32
 griptape_nodes/exe_types/connections.py,sha256=_-VNzf6Kay62QzJlSX-LlHTUhz-CKF-UDsbZLJ0l6Wk,12435
 griptape_nodes/exe_types/core_types.py,sha256=gkWSehpB28kFwgKl8KNrW4MaxB2rcEEPTuOThCOg6ms,58259
-griptape_nodes/exe_types/flow.py,sha256=FAjs6vWEWbuoU5OvUGjs8BY_kEB7IWKvlJ-X5HXkoZ4,21095
+griptape_nodes/exe_types/flow.py,sha256=pCeTrx8yrUgLw1U9yQxC7arzJjyP2vag-pG0QTKut-M,5716
 griptape_nodes/exe_types/node_types.py,sha256=MwrZCFPsKU3VV1GoG6jeuGyyLjkCQ_7EZHfiuKcm0hU,45514
 griptape_nodes/exe_types/type_validator.py,sha256=RTz1vX09jzQpHhozITMJ0siOZUXvsERDhrApjdaM1WM,1120
 griptape_nodes/machines/__init__.py,sha256=v0jkwr-CFOLmfEYUQvX8BKQLOdvhSsA6toXkdHcPGUE,30
-griptape_nodes/machines/control_flow.py,sha256=LegXG4If6M5N6ZNlrQywLGQe-sjg_VKDeKPu5gmqbxU,8421
+griptape_nodes/machines/control_flow.py,sha256=qOyf00hEas310kToQBKGOXrhmwcY5agWu8ct4i-0nnA,8643
 griptape_nodes/machines/fsm.py,sha256=JwNz32UmcajoADDMm_fL5MqDRNjr6t8CIUzck-7TFhE,1784
-griptape_nodes/machines/node_resolution.py,sha256=Ou29TWTDWr0m54oYYszBIcVILauK7hET4tTWGDJojM4,19929
+griptape_nodes/machines/node_resolution.py,sha256=HfmREZKhJLCo2vR_6LsOpff5KTiRQ71O5iNrUY31eT4,20049
 griptape_nodes/node_library/__init__.py,sha256=U3FcSdmq6UW7qt6E3Up3NWKvUEn5_5lqL-u5qbzfxMQ,28
 griptape_nodes/node_library/advanced_node_library.py,sha256=B1ZaxuFIzQ6tx_3MLIxlsHuahthEC1Hw_t6K_ByIdzs,2104
 griptape_nodes/node_library/library_registry.py,sha256=fE1NF-9SeRPK_pWPQgfeDBsMzvxiAlShPBvi71DCG9Q,12099
-griptape_nodes/node_library/workflow_registry.py,sha256=WF4jsXOa8AvWykkLPgnwYo-n2PYT5c3fJgjxYCaHOps,4257
+griptape_nodes/node_library/workflow_registry.py,sha256=EMqQgx7DaR3mEgBWQEgMHhgxYalaotda8Uo9wD8d9i4,4247
 griptape_nodes/retained_mode/__init__.py,sha256=X12DKL6KhLsiRTPIlrPj2h76_sJ0q0eH4r0kMQkodm0,29
-griptape_nodes/retained_mode/griptape_nodes.py,sha256=F4EdAFSBm3tZsiKl9k2d5HB0hiv06A1EZit55bmqJWU,37167
-griptape_nodes/retained_mode/retained_mode.py,sha256=HUKoiTtDYm61a1wipeLKk_1oRfkMeIjiWrzGQ6x61d0,54779
+griptape_nodes/retained_mode/griptape_nodes.py,sha256=dOI8A_Dd2O9ndDUOXoHhhe9xjckbUDct9qsLURNMmQk,24040
+griptape_nodes/retained_mode/retained_mode.py,sha256=2cjSD1F_ABpuL8km_nGpAn2h5TijeV77qr1ePH_BWZg,56272
 griptape_nodes/retained_mode/events/__init__.py,sha256=7B1C-c0jVvnShtHJ2lfX6BZPE0U1DgQwg1e4DorhKG0,22
-griptape_nodes/retained_mode/events/agent_events.py,sha256=Ftwv_6jobQZ3ZEOAIFwTCdbYke0vN0fN0ZTRWqppM3M,2235
-griptape_nodes/retained_mode/events/app_events.py,sha256=bke-50TIKkOPA-BXxP_BGqJBzbqAgKUlYFi-Zc6hMv8,3921
-griptape_nodes/retained_mode/events/arbitrary_python_events.py,sha256=9IJKVyzo9jqef2Dt3thoqnq4FWKTX5yG5SnOvXHvLns,797
-griptape_nodes/retained_mode/events/base_events.py,sha256=XtLnEvXK46Uph5oT3Y8KJN8KGFOrN0ntNE--ixf9Krs,20661
-griptape_nodes/retained_mode/events/config_events.py,sha256=cgx5Qe0wSHxpehHj7CDb4bF6UfUERD5oAMA0Eb3BSgk,2454
-griptape_nodes/retained_mode/events/connection_events.py,sha256=XbuzSchjNmM8SMD-QrnhEQxwyt5pQPmB6j46GGjFNRI,2261
-griptape_nodes/retained_mode/events/context_events.py,sha256=je81-kK-ORLUunvAM8r-2xtN4fIHlt0d2qoUZ3a-u0M,1042
-griptape_nodes/retained_mode/events/execution_events.py,sha256=ZYj87Us-iMaornesQRHbAeABftqNPfCdRevg1860ixM,5701
-griptape_nodes/retained_mode/events/flow_events.py,sha256=1BtdgefElLDRlVjELm1Dlcmn770z7Y0zA0Ml9hWcUN8,7967
+griptape_nodes/retained_mode/events/agent_events.py,sha256=xyCtR-Hf1vv6Ft-z0At0ytIMYBRckYympxdByVZXrCE,4880
+griptape_nodes/retained_mode/events/app_events.py,sha256=aKrXFOgNZZmQ_6fgdCIjzW5l5LUfNFlFhtS492hnqQM,8477
+griptape_nodes/retained_mode/events/arbitrary_python_events.py,sha256=uhep1c1xjUc-YQO5nIStAE48PS6rFZLTDQIr_Qb3we8,1460
+griptape_nodes/retained_mode/events/base_events.py,sha256=pSiePAzG7ddzHCtmX4C-56vByEUA4GgIDqkIa4yllFo,19756
+griptape_nodes/retained_mode/events/config_events.py,sha256=9WhFx6mD7QF_h1ldFAPRE_iLtrQBAFEvA6_MzhGOomk,6129
+griptape_nodes/retained_mode/events/connection_events.py,sha256=QjHAp0SeCbRSG-dF_nU_CPaOcSKItq2DWJ_FHWgF1b4,4744
+griptape_nodes/retained_mode/events/context_events.py,sha256=-FIwjI0hJodDhfM4BF-3GTRycu80v1TlSSOX34oA9nA,2122
+griptape_nodes/retained_mode/events/execution_events.py,sha256=z1RakAGJQrNUmU6SU6evXSldPdlSlw0gBm7_S15JaEo,9946
+griptape_nodes/retained_mode/events/flow_events.py,sha256=BKEftgN6pIMCFpLF9yIwkcloIWVY6FSIwUX5a4fc5KU,14019
 griptape_nodes/retained_mode/events/generate_request_payload_schemas.py,sha256=PQ0QRZAUBljSIGjB8QhYUeRmSrfmLsJ6XVcygJKi13I,1102
-griptape_nodes/retained_mode/events/library_events.py,sha256=hvLFc21wme55TfEUCPVTEI7-CkSotGmESDQGcuhs8es,10061
-griptape_nodes/retained_mode/events/logger_events.py,sha256=e5Xu9cVk4_V24dI-leqWbzWSf_c2wRHJpsEfJT9_p8M,325
-griptape_nodes/retained_mode/events/node_events.py,sha256=-rpsN0889umeQA8BRkV6cqhiyooK9j0Pz2dDlYFx9_A,14962
-griptape_nodes/retained_mode/events/object_events.py,sha256=ZNuRFw2zhrfAIWKwu_aumn-1-kedvvEoVUq82P6RyAs,1283
-griptape_nodes/retained_mode/events/os_events.py,sha256=QWhTJs9SzGGIuvFB2-3w8Bfhk5KcCZOuFfn1eeJvWdk,659
-griptape_nodes/retained_mode/events/parameter_events.py,sha256=2Ex4_9-GE-dzasP1DHutslzLMuF-tu4egHLHSsTEdp4,9495
+griptape_nodes/retained_mode/events/library_events.py,sha256=xE-yOAmjIWcyNhR_3qNK9ucnbW-f_hyFoXPGgXnmlQQ,17628
+griptape_nodes/retained_mode/events/logger_events.py,sha256=jYlxzPomgCsJuPtJ0znWBhD8QJfC8qC4xfChDiuVuyg,705
+griptape_nodes/retained_mode/events/node_events.py,sha256=V9Kf0G2l2UQxu3kpnlWupC7vMYShkGpYrLe62v4e9AU,24526
+griptape_nodes/retained_mode/events/object_events.py,sha256=cJaqEU73Lzf1RRxJrFqEpl8eTr-gDhKpXKywJ-vVCJQ,2631
+griptape_nodes/retained_mode/events/os_events.py,sha256=GrEfWKEM8s9t950KeAQKX9amAQI_fXst9vc9V66vBPA,1243
+griptape_nodes/retained_mode/events/parameter_events.py,sha256=n5PCL_T5zxktX3hSyqpDseztJrT6_RjS9lu6AmNBDq0,18411
 griptape_nodes/retained_mode/events/payload_registry.py,sha256=q-wxUqp63vhNj-Pl1JGJHnBkhUefcCArPoMN3KBREEI,1691
-griptape_nodes/retained_mode/events/secrets_events.py,sha256=gK6RkIHEIyQJRtYI-REf3FmSXCRw5VrP5YJH8D8rmWY,1788
-griptape_nodes/retained_mode/events/static_file_events.py,sha256=ZKsLQUHL5tFVETd4it6pwdiLhbMjsGkRJQrUxmFGaDQ,2091
-griptape_nodes/retained_mode/events/validation_events.py,sha256=a3DwE1xmrmAZ9Y2HCAMHecyRl1Q5Ozy0cEOKgzeAQNE,1434
-griptape_nodes/retained_mode/events/workflow_events.py,sha256=GKn_tbC2VDqgwqrObCSwbMiFS23gc0iSGQxqFgTiDw0,4139
+griptape_nodes/retained_mode/events/secrets_events.py,sha256=UniLR-fH7OO-caSGCPDCZYf8Z0drBKqoRcjvNY7Y3Hs,4021
+griptape_nodes/retained_mode/events/static_file_events.py,sha256=c8kKkrxAPZxrE9fsldpWtweK1C4T-1-dHWw_76SRehM,3764
+griptape_nodes/retained_mode/events/validation_events.py,sha256=H2yWoHp2t7QwGV_fDQXRy7JojYnK4k6SOAlEvRYST_Q,3062
+griptape_nodes/retained_mode/events/workflow_events.py,sha256=6V8zsWnf8MbBZ2Oi36zaM_a7dZO5oOlq_iIxPL-g8Jk,11138
 griptape_nodes/retained_mode/managers/__init__.py,sha256=OTXysKusqYCQeAYwnVj4PbE3MxvAUTq9xOZT6vUE3JA,24
-griptape_nodes/retained_mode/managers/agent_manager.py,sha256=5jlFl_wPa9NiUTgnIJhT3ZZVXEGE4MsR0pn-IhADkS4,10235
+griptape_nodes/retained_mode/managers/agent_manager.py,sha256=lSOyY2j2DE8qJh3OYCdqWnLKlXzywr5ItzzU7dfKwRM,10238
 griptape_nodes/retained_mode/managers/arbitrary_code_exec_manager.py,sha256=QnqI2_IkDpc9SHzbb-jwsyYkm91W0V9kLlxARUbbVUI,1777
 griptape_nodes/retained_mode/managers/config_manager.py,sha256=0fs-xd6vpetBGYrsm6sqPBhWb0qChMdtUcxco92qTqQ,25344
 griptape_nodes/retained_mode/managers/context_manager.py,sha256=DiGNh09TZ7rsLEcXqqB9Yrh2ietBy59LPF7GM0OBQS8,22930
-griptape_nodes/retained_mode/managers/event_manager.py,sha256=5Y8oKasS2bISu5qdDhX9YRy2LD7lyIsfd2FxpXOnZ6c,6726
-griptape_nodes/retained_mode/managers/flow_manager.py,sha256=WvFVcSSyEfUJvvcdMKLrrmMrbsVA2FFMxZiD5uxqUS0,71597
-griptape_nodes/retained_mode/managers/library_manager.py,sha256=JQDPImFBXqQ-zFH-DpBurr_0nnO4oLR6-rHSTBVsLOA,87745
-griptape_nodes/retained_mode/managers/node_manager.py,sha256=4vUMhjuIZnd2s1isBhDnwLNdgfwkC50sRo9ERiXTWjU,127179
-griptape_nodes/retained_mode/managers/object_manager.py,sha256=mgNK8o-iYFzNl2IBzUKIqECiiqk5dI3cNNqirLam7vc,11828
+griptape_nodes/retained_mode/managers/engine_identity_manager.py,sha256=GBBz7HJBJVNyXLGRdAvqDgihMRB_YjWqdEwLMCnadUg,4409
+griptape_nodes/retained_mode/managers/event_manager.py,sha256=rGoeGO0ATZd9w8Gm1RDHoODDYyJ-XqxiGJidYijH_QY,7201
+griptape_nodes/retained_mode/managers/flow_manager.py,sha256=JDLedAGIfP_RZ5Qlj7C-0mYXlHvw8N4_Nt9I0bCetx0,106297
+griptape_nodes/retained_mode/managers/library_manager.py,sha256=WnNqabpTvANic7ww0E_78zj8zsBMJxcW3eXMJ4Ma730,93627
+griptape_nodes/retained_mode/managers/node_manager.py,sha256=ygWeAHQeZcP_PCrDgA5tK4yeUrnAtoXb_l2MHLSaXH0,127460
+griptape_nodes/retained_mode/managers/object_manager.py,sha256=HAMyW2OnrbdYmOzRSqmvbpyKg6eO3wUEk6-2CP9EQcw,12243
 griptape_nodes/retained_mode/managers/operation_manager.py,sha256=6nHx1fADdj7nyt5dIrNNuSkR362XgR1AMVESI1UCF6o,19746
-griptape_nodes/retained_mode/managers/os_manager.py,sha256=jeWvm0X_ma40ZBJFqgU_RgNR2nSfDxCxGUEQxZyujmQ,5104
-griptape_nodes/retained_mode/managers/secrets_manager.py,sha256=oRdTN__mgM5tQTxVKZ8e0R8BcKfL6_zMA-AKuFV9QE8,6038
-griptape_nodes/retained_mode/managers/settings.py,sha256=nzEziQ1_Ba_PtQYtOgF_Uq7w0eF6eZ93Sqbl36mqlhk,4094
+griptape_nodes/retained_mode/managers/os_manager.py,sha256=-Uz74v5Ysw8JSqxGooG30bUP2kO4e-LNxpa8SqxUXdg,7463
+griptape_nodes/retained_mode/managers/secrets_manager.py,sha256=uGlj5MAL5kfShwE0yRn5ywuIcNGUP9qOq9SLt3vkTjI,6219
+griptape_nodes/retained_mode/managers/session_manager.py,sha256=fLjtBvgGY3daq1vbpJPXq069n35Z-Zr5dF3B0XyD2JY,11817
+griptape_nodes/retained_mode/managers/settings.py,sha256=oS-TDmz8IWIBK-OsjIbThNfinAOzaoJbDUSGlTOT_nw,4439
 griptape_nodes/retained_mode/managers/static_files_manager.py,sha256=RbQHGeJgRa7tCGJwif0hGVMbEVkHgaUt4FB44McRxWA,7129
 griptape_nodes/retained_mode/managers/version_compatibility_manager.py,sha256=1lwwuof4C6Ho1xh59Re_ajmvcc2lUyxpO1-RkHfKBYc,4385
-griptape_nodes/retained_mode/managers/workflow_manager.py,sha256=qvjRvvNFTrqQmiC6B4ifudzSbepua4serKi8W1In4G8,128750
+griptape_nodes/retained_mode/managers/workflow_manager.py,sha256=jj7cM1s1E7PkY1uER2P3WozS1ZuIZDZFfPXRO_dT9Hk,131627
 griptape_nodes/retained_mode/utils/__init__.py,sha256=W5dvv8YwvVVq_8eVTgMd3Z_VB_Dtq1sIIVq8745QH_I,52
-griptape_nodes/retained_mode/utils/engine_identity.py,sha256=T28qJtpaS2JUmMxU7NRNws_zQxm5CIIgdujfAmodIMU,3817
+griptape_nodes/retained_mode/utils/engine_identity.py,sha256=PZmdlYM69-B-6Z1F4iJfZyVm2twJY5cSGoiUJCMj0xU,7846
 griptape_nodes/retained_mode/utils/name_generator.py,sha256=IZLahtfP3XC79XApLdGoZ0IKKUkgiITpd16RK7NbyEs,2524
-griptape_nodes/retained_mode/utils/session_persistence.py,sha256=zhCeE7_5zHXBtNoVjEjwWSdLQbFQn_mI3Ybq5TkWjPA,3339
 griptape_nodes/traits/__init__.py,sha256=bTLXTiZTJz2z15RRLoPI4nvLnNW9FiLcKL_2pT4E10g,32
 griptape_nodes/traits/add_param_button.py,sha256=Xtc39SfvYY6JDjhxu2wmdeaHW2X4LkpNAQufSTCP3hY,655
 griptape_nodes/traits/button.py,sha256=rpQQ77ASKH3YJabc5WWw9DpEHQiMg1jx0i0sdkwH-SA,611
@@ -105,8 +106,8 @@ griptape_nodes/version_compatibility/__init__.py,sha256=JMz1sB7Zsj6pS1S5sdsPR0kn
 griptape_nodes/version_compatibility/versions/__init__.py,sha256=PWSxM28LPUdBdRPA98j4RUWvuZ4NqfX1day2VU6SqPw,74
 griptape_nodes/version_compatibility/versions/v0_39_0/__init__.py,sha256=21iKlFpsmBW4WsAexSD0WMAJnsYmMq2sIbDeYC831fc,62
 griptape_nodes/version_compatibility/versions/v0_39_0/modified_parameters_set_removal.py,sha256=KJeyhyn_iUaDx32FRi1-__yxw6rp9tG4eTBCimpurBM,5306
-griptape_nodes-0.40.0.dist-info/METADATA,sha256=khIpbSQkHxssHJ4PMubVl1E6PIybiJIXe_GcTFUdHlo,4102
-griptape_nodes-0.40.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-griptape_nodes-0.40.0.dist-info/entry_points.txt,sha256=Q8V3Ydy7PNfJgTjNEVkPui25AwZ4HJ3kZCU3oh4mq-c,81
-griptape_nodes-0.40.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-griptape_nodes-0.40.0.dist-info/RECORD,,
+griptape_nodes-0.42.0.dist-info/METADATA,sha256=ApwIVvUYJC8oYo43PxlzKXcY8CKdQxVQoAJjNob8wP8,4110
+griptape_nodes-0.42.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+griptape_nodes-0.42.0.dist-info/entry_points.txt,sha256=Q8V3Ydy7PNfJgTjNEVkPui25AwZ4HJ3kZCU3oh4mq-c,81
+griptape_nodes-0.42.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+griptape_nodes-0.42.0.dist-info/RECORD,,

griptape_nodes/retained_mode/utils/session_persistence.py

@@ -1,105 +0,0 @@
-"""Manages session persistence using XDG state directory.
-
-Handles storing and retrieving active session information across engine restarts.
-"""
-
-import json
-from datetime import UTC, datetime
-from pathlib import Path
-
-from xdg_base_dirs import xdg_state_home
-
-
-class SessionPersistence:
-    """Manages session persistence for active session tracking."""
-
-    _SESSION_STATE_FILE = "session.json"
-
-    @classmethod
-    def _get_session_state_dir(cls) -> Path:
-        """Get the XDG state directory for session persistence."""
-        return xdg_state_home() / "griptape_nodes"
-
-    @classmethod
-    def _get_session_state_file(cls) -> Path:
-        """Get the path to the session state storage file."""
-        return cls._get_session_state_dir() / cls._SESSION_STATE_FILE
-
-    @classmethod
-    def _load_session_data(cls) -> dict:
-        """Load session data from storage.
-
-        Returns:
-            dict: Session data including id, timestamps
-        """
-        session_state_file = cls._get_session_state_file()
-
-        if session_state_file.exists():
-            try:
-                with session_state_file.open("r") as f:
-                    data = json.load(f)
-                    if isinstance(data, dict):
-                        return data
-            except (json.JSONDecodeError, OSError):
-                # If file is corrupted, return empty dict
-                pass
-
-        return {}
-
-    @classmethod
-    def _save_session_data(cls, session_data: dict) -> None:
-        """Save session data to storage.
-
-        Args:
-            session_data: Session data to save
-        """
-        session_state_dir = cls._get_session_state_dir()
-        session_state_dir.mkdir(parents=True, exist_ok=True)
-
-        session_state_file = cls._get_session_state_file()
-        with session_state_file.open("w") as f:
-            json.dump(session_data, f, indent=2)
-
-    @classmethod
-    def persist_session(cls, session_id: str) -> None:
-        """Persist the active session ID to storage.
-
-        Args:
-            session_id: The session ID to persist
-        """
-        session_data = {
-            "session_id": session_id,
-            "started_at": datetime.now(tz=UTC).isoformat(),
-            "last_updated": datetime.now(tz=UTC).isoformat(),
-        }
-        cls._save_session_data(session_data)
-
-    @classmethod
-    def get_persisted_session_id(cls) -> str | None:
-        """Get the persisted session ID if it exists.
-
-        Returns:
-            str | None: The persisted session ID or None if no session is persisted
-        """
-        session_data = cls._load_session_data()
-        return session_data.get("session_id")
-
-    @classmethod
-    def clear_persisted_session(cls) -> None:
-        """Clear the persisted session data."""
-        session_state_file = cls._get_session_state_file()
-        if session_state_file.exists():
-            try:
-                session_state_file.unlink()
-            except OSError:
-                # If we can't delete the file, just clear its contents
-                cls._save_session_data({})
-
-    @classmethod
-    def has_persisted_session(cls) -> bool:
-        """Check if there is a persisted session.
-
-        Returns:
-            bool: True if there is a persisted session, False otherwise
-        """
-        return cls.get_persisted_session_id() is not None