A programming framework for agentic AI
impl state management (#28)
Jack Gerrits7568a7a447fb
diff --git a/src/agnext/application_components/_single_threaded_agent_runtime.py b/src/agnext/application_components/_single_threaded_agent_runtime.pyindex 6651509a8..35d67446c 100644--- a/src/agnext/application_components/_single_threaded_agent_runtime.py+++ b/src/agnext/application_components/_single_threaded_agent_runtime.py@@ -1,7 +1,7 @@import asynciofrom asyncio import Futurefrom dataclasses import dataclass-from typing import Any, Awaitable, Dict, List, Set+from typing import Any, Awaitable, Dict, List, Mapping, Setfrom ..core import Agent, AgentRuntime, CancellationTokenfrom ..core.exceptions import MessageDroppedException@@ -108,6 +108,16 @@ class SingleThreadedAgentRuntime(AgentRuntime):future.set_result(None)return future+ def save_state(self) -> Mapping[str, Any]:+ state: Dict[str, Dict[str, Any]] = {}+ for agent in self._agents:+ state[agent.name] = dict(agent.save_state())+ return state++ def load_state(self, state: Mapping[str, Any]) -> None:+ for agent in self._agents:+ agent.load_state(state[agent.name])+async def _process_send(self, message_envelope: SendMessageEnvelope) -> None:recipient = message_envelope.recipientassert recipient in self._agentsdiff --git a/src/agnext/core/_agent.py b/src/agnext/core/_agent.pyindex d50a1c06f..f3f130e54 100644--- a/src/agnext/core/_agent.py+++ b/src/agnext/core/_agent.py@@ -1,4 +1,4 @@-from typing import Any, Protocol, Sequence, runtime_checkable+from typing import Any, Mapping, Protocol, Sequence, runtime_checkablefrom agnext.core._cancellation_token import CancellationToken@@ -33,3 +33,7 @@ class Agent(Protocol):If there was a cancellation, this function should raise a `CancelledError`."""...++ def save_state(self) -> Mapping[str, Any]: ...++ def load_state(self, state: Mapping[str, Any]) -> None: ...diff --git a/src/agnext/core/_agent_runtime.py b/src/agnext/core/_agent_runtime.pyindex ca39479c2..7d134fdde 100644--- a/src/agnext/core/_agent_runtime.py+++ b/src/agnext/core/_agent_runtime.py@@ -1,5 +1,5 @@from asyncio import Future-from typing import Any, Protocol+from typing import Any, Mapping, Protocolfrom agnext.core._agent import Agentfrom agnext.core._cancellation_token import CancellationToken@@ -37,3 +37,7 @@ class AgentRuntime(Protocol):sender: Agent | None = None,cancellation_token: CancellationToken | None = None,) -> Future[None]: ...++ def save_state(self) -> Mapping[str, Any]: ...++ def load_state(self, state: Mapping[str, Any]) -> None: ...diff --git a/src/agnext/core/_base_agent.py b/src/agnext/core/_base_agent.pyindex d0d4f2c88..f570f2b3a 100644--- a/src/agnext/core/_base_agent.py+++ b/src/agnext/core/_base_agent.py@@ -1,6 +1,7 @@+import warningsfrom abc import ABC, abstractmethodfrom asyncio import Future-from typing import Any, Sequence, TypeVar+from typing import Any, Mapping, Sequence, TypeVarfrom agnext.core._agent_runtime import AgentRuntimefrom agnext.core._cancellation_token import CancellationToken@@ -62,3 +63,11 @@ class BaseAgent(ABC, Agent):cancellation_token = CancellationToken()future = self._router.publish_message(message, sender=self, cancellation_token=cancellation_token)return future++ def save_state(self) -> Mapping[str, Any]:+ warnings.warn("save_state not implemented", stacklevel=2)+ return {}++ def load_state(self, state: Mapping[str, Any]) -> None:+ warnings.warn("load_state not implemented", stacklevel=2)+ passdiff --git a/tests/test_state.py b/tests/test_state.pynew file mode 100644index 000000000..0c8fb8e14--- /dev/null+++ b/tests/test_state.py@@ -0,0 +1,62 @@+from typing import Any, Mapping, Sequence+import pytest++from agnext.application_components import SingleThreadedAgentRuntime+from agnext.core import AgentRuntime+from agnext.core import BaseAgent+from agnext.core import CancellationToken++class StatefulAgent(BaseAgent):+ def __init__(self, name: str, runtime: AgentRuntime) -> None:+ super().__init__(name, runtime)+ self.state = 0++ @property+ def subscriptions(self) -> Sequence[type]:+ return []++ async def on_message(self, message: Any, cancellation_token: CancellationToken) -> Any:+ raise NotImplementedError++ def save_state(self) -> Mapping[str, Any]:+ return {"state": self.state}++ def load_state(self, state: Mapping[str, Any]) -> None:+ self.state = state["state"]+++async def test_agent_can_save_state() -> None:+ runtime = SingleThreadedAgentRuntime()++ agent1 = StatefulAgent("name1", runtime)+ assert agent1.state == 0+ agent1.state = 1+ assert agent1.state == 1++ agent1_state = agent1.save_state()++ agent1.state = 2+ assert agent1.state == 2++ agent1.load_state(agent1_state)+ assert agent1.state == 1++async def test_runtime_can_save_state() -> None:+ runtime = SingleThreadedAgentRuntime()++ agent1 = StatefulAgent("name1", runtime)+ assert agent1.state == 0+ agent1.state = 1+ assert agent1.state == 1++ runtime_state = runtime.save_state()++ runtime2 = SingleThreadedAgentRuntime()+ agent2 = StatefulAgent("name1", runtime2)+ runtime2.load_state(runtime_state)+ assert agent2.state == 1+++