fix(cli): add local_development.redis_enabled manifest opt-out (MAY-1086)

agentex agents run unconditionally sets REDIS_URL=redis://localhost:6379 in
the agent process env. Combined with the module-level RedisStreamRepository
instantiated by `from agentex.lib import adk`, this causes silent request
hangs for agents that don't use adk.messages/adk.streaming when no local
Redis is reachable (e.g. Temporal-direct async agents in restricted dev
pods). The lazy redis.asyncio client only fails on first publish, so there
is no startup error to point at the misconfiguration.

Add an explicit `local_development.redis_enabled: bool = true` flag.
Default true preserves existing behavior; users with no local Redis can
set false to skip the REDIS_URL default. acp_type is not a reliable
discriminator here — the codebase has acp_type=async tutorials that
legitimately call adk.messages.create.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

Author: IdkwhatImD0ing

src/agentex/lib/cli/handlers/run_handlers.py

@@ -365,13 +365,19 @@ def create_agent_environment(manifest: AgentManifest) -> dict[str, str]:
     env_vars = {
         "ENVIRONMENT": "development",
         "TEMPORAL_ADDRESS": "localhost:7233",
-        "REDIS_URL": "redis://localhost:6379",
         "AGENT_NAME": manifest.agent.name,
         "ACP_TYPE": manifest.agent.acp_type,
         "ACP_URL": f"http://{manifest.local_development.agent.host_address}",  # type: ignore[union-attr]
         "ACP_PORT": str(manifest.local_development.agent.port),  # type: ignore[union-attr]
     }
 
+    # Gate the default REDIS_URL on an explicit manifest flag. Agents that don't use
+    # adk.messages/adk.streaming can set local_development.redis_enabled: false to avoid
+    # the localhost:6379 default, which otherwise causes silent request hangs when no
+    # local Redis is reachable (MAY-1086).
+    if manifest.local_development is None or manifest.local_development.redis_enabled:
+        env_vars["REDIS_URL"] = "redis://localhost:6379"
+
     if manifest.agent.agent_input_type:
         env_vars["AGENT_INPUT_TYPE"] = manifest.agent.agent_input_type
 

src/agentex/lib/sdk/config/local_development_config.py

@@ -56,3 +56,12 @@ class LocalDevelopmentConfig(BaseModel):
     paths: LocalPathsConfig | None = Field(
         default=None, description="File paths for local development"
     )
+    redis_enabled: bool = Field(
+        default=True,
+        description=(
+            "Whether the local CLI should set REDIS_URL=redis://localhost:6379 for the "
+            "agent process. Set to false for agents that don't use adk.messages/adk.streaming "
+            "when no local Redis is available, to avoid silent request hangs from the lazy "
+            "Redis client."
+        ),
+    )