A programming framework for agentic AI
Port changes from agexplore (#47)
Jack Gerrits19570fdd98fb
diff --git a/src/agnext/application/_single_threaded_agent_runtime.py b/src/agnext/application/_single_threaded_agent_runtime.pyindex bbd654331..4f4260905 100644--- a/src/agnext/application/_single_threaded_agent_runtime.py+++ b/src/agnext/application/_single_threaded_agent_runtime.py@@ -1,5 +1,7 @@import asyncio+import loggingfrom asyncio import Future+from collections.abc import Sequencefrom dataclasses import dataclassfrom typing import Any, Awaitable, Dict, List, Mapping, Set@@ -7,6 +9,8 @@ from ..core import Agent, AgentRuntime, CancellationTokenfrom ..core.exceptions import MessageDroppedExceptionfrom ..core.intervention import DropMessage, InterventionHandler+logger = logging.getLogger("agnext")+@dataclass(kw_only=True)class PublishMessageEnvelope:@@ -58,6 +62,14 @@ class SingleThreadedAgentRuntime(AgentRuntime):self._per_type_subscribers[message_type].append(agent)self._agents.add(agent)+ @property+ def agents(self) -> Sequence[Agent]:+ return list(self._agents)++ @property+ def unprocessed_messages(self) -> Sequence[PublishMessageEnvelope | SendMessageEnvelope | ResponseMessageEnvelope]:+ return self._message_queue+# Returns the response of the messagedef send_message(self,@@ -123,6 +135,10 @@ class SingleThreadedAgentRuntime(AgentRuntime):assert recipient in self._agentstry:+ sender_name = message_envelope.sender.name if message_envelope.sender is not None else "Unknown"+ logger.info(+ f"Calling message handler for {recipient.name} with message type {type(message_envelope.message).__name__} from {sender_name}"+ )response = await recipient.on_message(message_envelope.message,cancellation_token=message_envelope.cancellation_token,@@ -145,6 +161,11 @@ class SingleThreadedAgentRuntime(AgentRuntime):for agent in self._per_type_subscribers.get(type(message_envelope.message), []): # type: ignoreif message_envelope.sender is not None and agent.name == message_envelope.sender.name:continue++ logger.info(+ f"Calling message handler for {agent.name} with message type {type(message_envelope.message).__name__} published by {message_envelope.sender.name if message_envelope.sender is not None else 'Unknown'}"+ )+future = agent.on_message(message_envelope.message,cancellation_token=message_envelope.cancellation_token,@@ -154,12 +175,16 @@ class SingleThreadedAgentRuntime(AgentRuntime):try:_all_responses = await asyncio.gather(*responses)except BaseException:- # TODO log error+ logger.error("Error processing publish message", exc_info=True)return# TODO if responses are given for a publishasync def _process_response(self, message_envelope: ResponseMessageEnvelope) -> None:+ recipient_name = message_envelope.recipient.name if message_envelope.recipient is not None else "Unknown"+ logger.info(+ f"Resolving response for recipient {recipient_name} from {message_envelope.sender.name} with message type {type(message_envelope.message).__name__}"+ )message_envelope.future.set_result(message_envelope.message)async def process_next(self) -> None:diff --git a/src/agnext/chat/patterns/orchestrator_chat.py b/src/agnext/chat/patterns/orchestrator_chat.pyindex 4a3903e82..802c62d63 100644--- a/src/agnext/chat/patterns/orchestrator_chat.py+++ b/src/agnext/chat/patterns/orchestrator_chat.py@@ -30,6 +30,10 @@ class OrchestratorChat(BaseChatAgent, TypeRoutedAgent):self._max_stalled_turns_before_retry = max_stalled_turns_before_retryself._max_retry_attempts_before_educated_guess = max_retry_attempts+ @property+ def children(self) -> Sequence[str]:+ return [agent.name for agent in self._specialists] + [self._orchestrator.name] + [self._planner.name]+@message_handler(TextMessage)async def on_text_message(self,diff --git a/src/agnext/core/__init__.py b/src/agnext/core/__init__.pyindex 0a843c2c9..138c7bf73 100644--- a/src/agnext/core/__init__.py+++ b/src/agnext/core/__init__.py@@ -3,8 +3,9 @@ The :mod:`agnext.core` module provides the foundational generic interfaces upon"""from ._agent import Agent+from ._agent_props import AgentChildrenfrom ._agent_runtime import AgentRuntimefrom ._base_agent import BaseAgentfrom ._cancellation_token import CancellationToken-__all__ = ["Agent", "AgentRuntime", "BaseAgent", "CancellationToken"]+__all__ = ["Agent", "AgentRuntime", "BaseAgent", "CancellationToken", "AgentChildren"]diff --git a/src/agnext/core/_agent_props.py b/src/agnext/core/_agent_props.pynew file mode 100644index 000000000..8e9ddbe4e--- /dev/null+++ b/src/agnext/core/_agent_props.py@@ -0,0 +1,9 @@+from typing import Protocol, Sequence, runtime_checkable+++@runtime_checkable+class AgentChildren(Protocol):+ @property+ def children(self) -> Sequence[str]:+ """Names of the children of the agent."""+ ...diff --git a/src/agnext/core/intervention.py b/src/agnext/core/intervention.pyindex e80edc86f..62606d63f 100644--- a/src/agnext/core/intervention.py+++ b/src/agnext/core/intervention.py@@ -1,4 +1,4 @@-from typing import Any, Awaitable, Callable, Protocol, Sequence, final+from typing import Any, Awaitable, Callable, Protocol, finalfrom agnext.core import Agent@@ -21,9 +21,6 @@ class InterventionHandler(Protocol):async def on_send(self, message: Any, *, sender: Agent | None, recipient: Agent) -> Any | type[DropMessage]: ...async def on_publish(self, message: Any, *, sender: Agent | None) -> Any | type[DropMessage]: ...async def on_response(self, message: Any, *, sender: Agent, recipient: Agent | None) -> Any | type[DropMessage]: ...- async def on_publish_response(- self, message: Sequence[Any], *, recipient: Agent | None- ) -> Sequence[Any] | type[DropMessage]: ...class DefaultInterventionHandler(InterventionHandler):@@ -35,8 +32,3 @@ class DefaultInterventionHandler(InterventionHandler):async def on_response(self, message: Any, *, sender: Agent, recipient: Agent | None) -> Any | type[DropMessage]:return message-- async def on_publish_response(- self, message: Sequence[Any], *, recipient: Agent | None- ) -> Sequence[Any] | type[DropMessage]:- return message