diff --git a/litellm/managed_agents/__init__.py b/litellm/managed_agents/__init__.py
index 1d4534d67f7..6ffc76de5e6 100644
--- a/litellm/managed_agents/__init__.py
+++ b/litellm/managed_agents/__init__.py
@@ -1,4 +1,7 @@
-"""v2 managed agents — sandbox-agnostic agent runs.
+"""v2 managed agents — sandbox-agnostic agent runs (SDK-level).
 
-Public surface is in litellm/managed_agents/router.py.
+Pydantic types, sandbox adapters, DB helpers, and other framework-agnostic
+building blocks live here. The FastAPI endpoint handlers live under
+``litellm/proxy/managed_agents_endpoints/`` (per the proxy-only fastapi
+import rule).
 """