Python: Added AgentRunResponse and AgentRunResponseUpdate types (#157)

* Removed instructions property from Agent

* Added AgentRunResponse and AgentRunResponseUpdate types

* Added unit tests for agent response types

* Small fix

* Addressed PR feedback

* Small improvement

* Small fix

python/packages/main/agent_framework/_agents.py

@@ -5,7 +5,7 @@ from collections.abc import AsyncIterable, Sequence
 from typing import Any, Protocol, runtime_checkable
 
 from ._pydantic import AFBaseModel
-from ._types import ChatMessage, ChatResponse, ChatResponseUpdate
+from ._types import AgentRunResponse, AgentRunResponseUpdate, ChatMessage
 
 # region AgentThread
 
@@ -82,26 +82,21 @@ class Agent(Protocol):
         """Returns the description of the agent."""
         ...
 
-    @property
-    def instructions(self) -> str | None:
-        """Returns the instructions for the agent."""
-        ...
-
     async def run(
         self,
         messages: str | ChatMessage | list[ChatMessage] | None = None,
         *,
         thread: AgentThread | None = None,
         **kwargs: Any,
-    ) -> ChatResponse:
+    ) -> AgentRunResponse:
         """Get a response from the agent.
 
         This method returns the final result of the agent's execution
-        as a single ChatResponse object. The caller is blocked until
+        as a single AgentRunResponse object. The caller is blocked until
         the final result is available.
 
         Note: For streaming responses, use the run_stream method, which returns
-        intermediate steps and the final result as a stream of ChatResponseUpdate
+        intermediate steps and the final result as a stream of AgentRunResponseUpdate
         objects. Streaming only the final result is not feasible because the timing of
         the final result's availability is unknown, and blocking the caller until then
         is undesirable in streaming scenarios.
@@ -122,16 +117,13 @@ class Agent(Protocol):
         *,
         thread: AgentThread | None = None,
         **kwargs: Any,
-    ) -> AsyncIterable[ChatResponseUpdate]:
+    ) -> AsyncIterable[AgentRunResponseUpdate]:
         """Run the agent as a stream.
 
         This method will return the intermediate steps and final results of the
-        agent's execution as a stream of ChatResponseUpdate objects to the caller.
+        agent's execution as a stream of AgentRunResponseUpdate objects to the caller.
 
-        To get the intermediate steps of the agent's execution as fully formed messages,
-        use the on_intermediate_message callback.
-
-        Note: A ChatResponseUpdate object contains a chunk of a message.
+        Note: An AgentRunResponseUpdate object contains a chunk of a message.
 
         Args:
             messages: The message(s) to send to the agent.