AIAgentStateManager

Manages the state of an AI agent by providing thread-safe access and mechanisms to update the internal state using a locking mechanism.

This class ensures consistency across state modifications by using a mutual exclusion lock, allowing only one coroutine to access or modify the state at a time.

Note: on every withStateLock invocation, a fresh AIAgentState snapshot is created that carries over the current iteration counter, and the previous snapshot is closed. Consumers must therefore not retain references to the AIAgentState instance received inside the lock across calls.