| """Process-wide shared state. | |
| This module holds the cached agent instances in a single, neutral location. | |
| Both the FastAPI auth app and the LangGraph graph import this module the same | |
| way (``utils.shared_state``), guaranteeing there is only ONE copy of the state | |
| in the running process. | |
| Do NOT store this state in ``web/login.py`` — the LangGraph server imports | |
| that file under multiple module names, which would create duplicate module | |
| objects each with their own independent state. | |
| """ | |
| from __future__ import annotations | |
| import asyncio | |
| from typing import Any | |
| # Cached agent instances keyed by agent name. All agents are shared singletons | |
| # built with the server-wide HF_TOKEN environment variable. | |
| agents: dict[str, Any] = {} | |
| # Guards concurrent first-time initialization of the same agent. | |
| locks: dict[str, asyncio.Lock] = {} | |