Merge pull request #1013 from yasinBursali/fix/dream-agent-key-lifecycle

fix(dream-agent-key): complete DREAM_AGENT_KEY lifecycle on macOS + docs

Author: Lightheartdevs

dream-server/.env.example

@@ -148,6 +148,9 @@ WEBUI_PORT=3000            # Open WebUI (external → internal 8080)
 # Dashboard API key (generate: openssl rand -hex 32)
 # DASHBOARD_API_KEY=
 
+# Dream host agent key (generate: openssl rand -hex 32) — auto-generated by installer; rotating breaks host-agent authentication
+# DREAM_AGENT_KEY=
+
 # Qdrant API key (generate: openssl rand -hex 32)
 # QDRANT_API_KEY=
 

dream-server/installers/macos/lib/env-generator.sh

@@ -116,6 +116,11 @@ generate_dream_env() {
         fi
         upsert_env_value "$env_path" "LLAMA_CPU_LIMIT" "$detected_cpu_limit"
         upsert_env_value "$env_path" "LLAMA_CPU_RESERVATION" "$detected_cpu_reservation"
+
+        # Upsert DREAM_AGENT_KEY when missing (pre-PR-#979 upgrade path)
+        if [[ -z "$(read_env_value "$env_path" "DREAM_AGENT_KEY")" ]]; then
+            upsert_env_value "$env_path" "DREAM_AGENT_KEY" "$(new_secure_hex 32)"
+        fi
         return 0
     fi