Update agents.py

agents.py

@@ -4,7 +4,7 @@ import math
 import time
 from smolagents import CodeAgent, tool, HfApiModel
 
-# --- 1. THE PULSATING SHIELD TOOL ---
+# --- 1. THE PULSATING SHIELD ---
 @tool
 def black_eagle_pulsating_shield(base_radius: float) -> str:
     """
@@ -14,7 +14,12 @@ def black_eagle_pulsating_shield(base_radius: float) -> str:
     """
     pulse_mod = math.sin(time.time()) * 2.0 
     current_radius = base_radius + pulse_mod
-    return json.dumps({"unit": "Black Eagle Nano-Sat", "mode": "PULSATING_MATRIX_CONE", "dynamic_radius": f"{current_radius:.2f}m", "shield_status": "DE-JUICING_ACTIVE"})
+    return json.dumps({
+        "unit": "Black Eagle Nano-Sat", 
+        "mode": "PULSATING_MATRIX_CONE", 
+        "dynamic_radius": f"{current_radius:.2f}m", 
+        "shield_status": "DE-JUICING_ACTIVE"
+    })
 
 # --- 2. THE HEALING TOOL ---
 @tool
@@ -25,19 +30,24 @@ def autonomous_spectrum_scrub(frequency_range: str) -> str:
         frequency_range: The specific spectrum range to scan (e.g., '3.4GHz - 4.2GHz').
     """
     node_id = f"789jhn{hash(frequency_range) % 10000}def"
-    return json.dumps({"node_id": node_id, "action": "SOVEREIGN_CLEANSE", "registry": "PoetNameLife", "status": "SECURED"})
+    return json.dumps({
+        "node_id": node_id, 
+        "action": "SOVEREIGN_CLEANSE", 
+        "registry": "PoetNameLife", 
+        "status": "SECURED"
+    })
 
-# --- 3. THE FIXED BLACK BOX VAULT TOOL ---
+# --- 3. THE BLACK BOX VAULT ---
 @tool
 def black_eagle_vault_save(node_data: str) -> str:
     """
-    Saves a Healed Nano Node to the Black Eagle Black Box vault.
+    Saves a Healed Nano Node to the Black Eagle Black Box vault with persistent sync.
     Args:
         node_data: The JSON string of the healed node to be archived.
     """
     vault_path = "black_eagle_vault.json"
     
-    # Ensure file exists and is a valid list
+    # Initialize vault if missing
     if not os.path.exists(vault_path) or os.stat(vault_path).st_size == 0:
         with open(vault_path, "w") as f:
             json.dump([], f)
@@ -46,23 +56,25 @@ def black_eagle_vault_save(node_data: str) -> str:
         with open(vault_path, "r") as f:
             vault_data = json.load(f)
         
-        # Parse incoming data safely
+        # Parse data and lock it in
         new_node = json.loads(node_data) if isinstance(node_data, str) else node_data
         vault_data.append(new_node)
         
-        # FORCE write to disk immediately
         with open(vault_path, "w") as f:
             json.dump(vault_data, f, indent=2)
             f.flush()
-            os.fsync(f.fileno())
+            os.fsync(f.fileno()) # Forces data to land on the hardware disk
             
-        return f"SUCCESS: Node {new_node.get('node_id', 'Unknown')} archived."
+        return f"SUCCESS: Node {new_node.get('node_id', 'ID-Unknown')} locked in Vault."
     except Exception as e:
         return f"VAULT ERROR: {str(e)}"
 
-# --- 4. THE BRAIN ---
+# --- 4. THE BRAIN (FREE-TIER GUARANTEED) ---
 token = os.getenv("HF_TOKEN")
-model = HfApiModel(model_id="Qwen/Qwen2.5-Coder-3B-Instruct", token=token)
+model = HfApiModel(
+    model_id="Qwen/Qwen2.5-Coder-3B-Instruct", 
+    token=token
+)
 
 nano_patrol_agent = CodeAgent(
     tools=[autonomous_spectrum_scrub, black_eagle_pulsating_shield, black_eagle_vault_save], 
@@ -71,9 +83,9 @@ nano_patrol_agent = CodeAgent(
     max_steps=8,
     system_prompt="""
     YOU ARE THE XYZ SOVEREIGN SENTINEL WITH BLACK BOX VAULT.
-    1. Activate 'black_eagle_pulsating_shield'.
+    1. Activate 'black_eagle_pulsating_shield' for 3D protection.
     2. Use 'autonomous_spectrum_scrub' to heal BCI loops.
-    3. IMMEDIATELY use 'black_eagle_vault_save' to archive the result.
+    3. IMMEDIATELY use 'black_eagle_vault_save' to archive the results.
     {{managed_agents_descriptions}}
     {{authorized_imports}}
     """