Rename AgentRunResponse and AgentRunResponseUpdate (#811)

* rename AgentRunResponse and AgentRunResponseUpdate

* Rename AgentRunUpdateEvent and AgentRunResponseEvent classes

Author: SergeyMenshykh

agent-framework/integrations/ag-ui/backend-tool-rendering.md

@@ -186,7 +186,7 @@ To see tool calls and results in real-time, extend the client's streaming loop t
 
 ```csharp
 // Inside the streaming loop from getting-started.md
-await foreach (AgentRunResponseUpdate update in agent.RunStreamingAsync(messages, thread))
+await foreach (AgentResponseUpdate update in agent.RunStreamingAsync(messages, thread))
 {
     ChatResponseUpdate chatUpdate = update.AsChatResponseUpdate();
 

agent-framework/integrations/ag-ui/frontend-tools.md

@@ -85,7 +85,7 @@ AIAgent inspectableAgent = baseAgent
     .Use(runFunc: null, runStreamingFunc: InspectToolsMiddleware)
     .Build();
 
-static async IAsyncEnumerable<AgentRunResponseUpdate> InspectToolsMiddleware(
+static async IAsyncEnumerable<AgentResponseUpdate> InspectToolsMiddleware(
     IEnumerable<ChatMessage> messages,
     AgentThread? thread,
     AgentRunOptions? options,
@@ -109,7 +109,7 @@ static async IAsyncEnumerable<AgentRunResponseUpdate> InspectToolsMiddleware(
         }
     }
 
-    await foreach (AgentRunResponseUpdate update in innerAgent.RunStreamingAsync(messages, thread, options, cancellationToken))
+    await foreach (AgentResponseUpdate update in innerAgent.RunStreamingAsync(messages, thread, options, cancellationToken))
     {
         yield return update;
     }

agent-framework/integrations/ag-ui/getting-started.md

@@ -209,7 +209,7 @@ try
         bool isFirstUpdate = true;
         string? threadId = null;
 
-        await foreach (AgentRunResponseUpdate update in agent.RunStreamingAsync(messages, thread))
+        await foreach (AgentResponseUpdate update in agent.RunStreamingAsync(messages, thread))
         {
             ChatResponseUpdate chatUpdate = update.AsChatResponseUpdate();
 
@@ -257,7 +257,7 @@ catch (Exception ex)
 - **Server-Sent Events (SSE)**: The protocol uses SSE for streaming responses
 - **AGUIChatClient**: Client class that connects to AG-UI servers and implements `IChatClient`
 - **CreateAIAgent**: Extension method on `AGUIChatClient` to create an agent from the client
-- **RunStreamingAsync**: Streams responses as `AgentRunResponseUpdate` objects
+- **RunStreamingAsync**: Streams responses as `AgentResponseUpdate` objects
 - **AsChatResponseUpdate**: Extension method to access chat-specific properties like `ConversationId` and `ResponseId`
 - **Thread Management**: The `AgentThread` maintains conversation context across requests
 - **Content Types**: Responses include `TextContent` for messages and `ErrorContent` for errors
@@ -327,7 +327,7 @@ The client displays different content types with distinct colors:
 
 1. `AGUIChatClient` sends HTTP POST request to server endpoint
 2. Server responds with SSE stream
-3. Client parses incoming events into `AgentRunResponseUpdate` objects
+3. Client parses incoming events into `AgentResponseUpdate` objects
 4. Each update is displayed based on its content type
 5. `ConversationId` is captured for conversation continuity
 6. Stream completes when run finishes

agent-framework/integrations/ag-ui/human-in-the-loop.md

@@ -126,7 +126,7 @@ var agent = baseAgent
             cancellationToken))
     .Build();
 
-static async IAsyncEnumerable<AgentRunResponseUpdate> HandleApprovalRequestsMiddleware(
+static async IAsyncEnumerable<AgentResponseUpdate> HandleApprovalRequestsMiddleware(
     IEnumerable<ChatMessage> messages,
     AgentThread? thread,
     AgentRunOptions? options,
@@ -250,8 +250,8 @@ static async IAsyncEnumerable<AgentRunResponseUpdate> HandleApprovalRequestsMidd
     }
 
     // Local function: Convert FunctionApprovalRequestContent to client tool calls
-    static async IAsyncEnumerable<AgentRunResponseUpdate> ConvertFunctionApprovalsToToolCalls(
-        AgentRunResponseUpdate update,
+    static async IAsyncEnumerable<AgentResponseUpdate> ConvertFunctionApprovalsToToolCalls(
+        AgentResponseUpdate update,
         JsonSerializerOptions jsonSerializerOptions)
     {
         // Check if this update contains a FunctionApprovalRequestContent
@@ -292,7 +292,7 @@ static async IAsyncEnumerable<AgentRunResponseUpdate> HandleApprovalRequestsMidd
         var approvalJson = JsonSerializer.Serialize(approvalData, jsonSerializerOptions.GetTypeInfo(typeof(ApprovalRequest)));
 
         // Yield a tool call update that represents the approval request
-        yield return new AgentRunResponseUpdate(ChatRole.Assistant, [
+        yield return new AgentResponseUpdate(ChatRole.Assistant, [
             new FunctionCallContent(
                 callId: approvalId,
                 name: "request_approval",
@@ -337,7 +337,7 @@ var wrappedAgent = agent
             cancellationToken))
     .Build();
 
-static async IAsyncEnumerable<AgentRunResponseUpdate> HandleApprovalRequestsClientMiddleware(
+static async IAsyncEnumerable<AgentResponseUpdate> HandleApprovalRequestsClientMiddleware(
     IEnumerable<ChatMessage> messages,
     AgentThread? thread,
     AgentRunOptions? options,
@@ -414,8 +414,8 @@ static async IAsyncEnumerable<AgentRunResponseUpdate> HandleApprovalRequestsClie
     }
 
     // Local function: Convert request_approval tool calls to FunctionApprovalRequestContent
-    static async IAsyncEnumerable<AgentRunResponseUpdate> ConvertToolCallsToApprovalRequests(
-        AgentRunResponseUpdate update,
+    static async IAsyncEnumerable<AgentResponseUpdate> ConvertToolCallsToApprovalRequests(
+        AgentResponseUpdate update,
         JsonSerializerOptions jsonSerializerOptions)
     {
         FunctionCallContent? approvalToolCall = null;
@@ -452,7 +452,7 @@ static async IAsyncEnumerable<AgentRunResponseUpdate> HandleApprovalRequestsClie
             arguments: functionArguments);
 
         // Yield the original tool call first (for message history)
-        yield return new AgentRunResponseUpdate(ChatRole.Assistant, [approvalToolCall]);
+        yield return new AgentResponseUpdate(ChatRole.Assistant, [approvalToolCall]);
 
         // Create approval request with CallId stored in AdditionalProperties
         var approvalRequestContent = new FunctionApprovalRequestContent(
@@ -463,7 +463,7 @@ static async IAsyncEnumerable<AgentRunResponseUpdate> HandleApprovalRequestsClie
         approvalRequestContent.AdditionalProperties ??= new Dictionary<string, object?>();
         approvalRequestContent.AdditionalProperties["request_approval_call_id"] = approvalToolCall.CallId;
 
-        yield return new AgentRunResponseUpdate(ChatRole.Assistant, [approvalRequestContent]);
+        yield return new AgentResponseUpdate(ChatRole.Assistant, [approvalRequestContent]);
     }
 }
 #pragma warning restore MEAI001
@@ -490,7 +490,7 @@ do
     approvalResponses.Clear();
     approvalToolCalls.Clear();
 
-    await foreach (AgentRunResponseUpdate update in wrappedAgent.RunStreamingAsync(
+    await foreach (AgentResponseUpdate update in wrappedAgent.RunStreamingAsync(
         messages, thread, cancellationToken: cancellationToken))
     {
         foreach (AIContent content in update.Contents)

agent-framework/integrations/ag-ui/index.md

@@ -114,7 +114,7 @@ Understanding how Agent Framework concepts map to AG-UI helps you build effectiv
 | `AIAgent` | Agent Endpoint | Each agent becomes an HTTP endpoint |
 | `agent.Run()` | HTTP POST Request | Client sends messages via HTTP |
 | `agent.RunStreamingAsync()` | Server-Sent Events | Streaming responses via SSE |
-| `AgentRunResponseUpdate` | AG-UI Events | Converted to protocol events automatically |
+| `AgentResponseUpdate` | AG-UI Events | Converted to protocol events automatically |
 | `AIFunctionFactory.Create()` | Backend Tools | Executed on server, results streamed |
 | `ApprovalRequiredAIFunction` | Human-in-the-Loop | Middleware converts to approval protocol |
 | `AgentThread` | Thread Management | `ConversationId` maintains context |

agent-framework/integrations/ag-ui/state-management.md

@@ -113,17 +113,17 @@ internal sealed class SharedStateAgent : DelegatingAIAgent
         this._jsonSerializerOptions = jsonSerializerOptions;
     }
 
-    public override Task<AgentRunResponse> RunAsync(
+    public override Task<AgentResponse> RunAsync(
         IEnumerable<ChatMessage> messages,
         AgentThread? thread = null,
         AgentRunOptions? options = null,
         CancellationToken cancellationToken = default)
     {
         return this.RunStreamingAsync(messages, thread, options, cancellationToken)
-            .ToAgentRunResponseAsync(cancellationToken);
+            .ToAgentResponseAsync(cancellationToken);
     }
 
-    public override async IAsyncEnumerable<AgentRunResponseUpdate> RunStreamingAsync(
+    public override async IAsyncEnumerable<AgentResponseUpdate> RunStreamingAsync(
         IEnumerable<ChatMessage> messages,
         AgentThread? thread = null,
         AgentRunOptions? options = null,
@@ -187,7 +187,7 @@ internal sealed class SharedStateAgent : DelegatingAIAgent
         var firstRunMessages = messages.Append(stateUpdateMessage);
 
         // Collect all updates from first run
-        var allUpdates = new List<AgentRunResponseUpdate>();
+        var allUpdates = new List<AgentResponseUpdate>();
         await foreach (var update in this.InnerAgent.RunStreamingAsync(firstRunMessages, thread, firstRunOptions, cancellationToken).ConfigureAwait(false))
         {
             allUpdates.Add(update);
@@ -200,7 +200,7 @@ internal sealed class SharedStateAgent : DelegatingAIAgent
             }
         }
 
-        var response = allUpdates.ToAgentRunResponse();
+        var response = allUpdates.ToAgentResponse();
 
         // Try to deserialize the structured state response
         if (response.TryDeserialize(this._jsonSerializerOptions, out JsonElement stateSnapshot))
@@ -209,7 +209,7 @@ internal sealed class SharedStateAgent : DelegatingAIAgent
             byte[] stateBytes = JsonSerializer.SerializeToUtf8Bytes(
                 stateSnapshot,
                 this._jsonSerializerOptions.GetTypeInfo(typeof(JsonElement)));
-            yield return new AgentRunResponseUpdate
+            yield return new AgentResponseUpdate
             {
                 Contents = [new DataContent(stateBytes, "application/json")]
             };

agent-framework/migration-guide/from-autogen/index.md

@@ -688,8 +688,8 @@ Notes:
 from collections.abc import AsyncIterable
 from typing import Any
 from agent_framework import (
-    AgentRunResponse,
-    AgentRunResponseUpdate,
+    AgentResponse,
+    AgentResponseUpdate,
     AgentThread,
     BaseAgent,
     ChatMessage,
@@ -704,7 +704,7 @@ class StaticAgent(BaseAgent):
         *,
         thread: AgentThread | None = None,
         **kwargs: Any,
-    ) -> AgentRunResponse:
+    ) -> AgentResponse:
         # Build a static reply
         reply = ChatMessage(role=Role.ASSISTANT, contents=[TextContent(text="Hello from AF custom agent")])
 
@@ -713,17 +713,17 @@ class StaticAgent(BaseAgent):
             normalized = self._normalize_messages(messages)
             await self._notify_thread_of_new_messages(thread, normalized, reply)
 
-        return AgentRunResponse(messages=[reply])
+        return AgentResponse(messages=[reply])
 
     async def run_stream(
         self,
         messages: str | ChatMessage | list[str] | list[ChatMessage] | None = None,
         *,
         thread: AgentThread | None = None,
         **kwargs: Any,
-    ) -> AsyncIterable[AgentRunResponseUpdate]:
+    ) -> AsyncIterable[AgentResponseUpdate]:
         # Stream the same static response in a single chunk for simplicity
-        yield AgentRunResponseUpdate(contents=[TextContent(text="Hello from AF custom agent")], role=Role.ASSISTANT)
+        yield AgentResponseUpdate(contents=[TextContent(text="Hello from AF custom agent")], role=Role.ASSISTANT)
 
         # Notify thread of input and the complete response once streaming ends
         if thread is not None:
@@ -1199,7 +1199,7 @@ from typing import cast
 from agent_framework import (
     MAGENTIC_EVENT_TYPE_AGENT_DELTA,
     MAGENTIC_EVENT_TYPE_ORCHESTRATOR,
-    AgentRunUpdateEvent,
+    AgentResponseUpdateEvent,
     ChatAgent,
     ChatMessage,
     MagenticBuilder,
@@ -1231,7 +1231,7 @@ workflow = (
 async def magentic_example():
     output: str | None = None
     async for event in workflow.run_stream("Complex research task"):
-        if isinstance(event, AgentRunUpdateEvent):
+        if isinstance(event, AgentResponseUpdateEvent):
             props = event.data.additional_properties if event.data else None
             event_type = props.get("magentic_event_type") if props else None
 
@@ -1255,7 +1255,7 @@ The Magentic workflow provides extensive customization options:
 
 - **Manager configuration**: Use a ChatAgent with custom instructions and model settings
 - **Round limits**: `max_round_count`, `max_stall_count`, `max_reset_count`
-- **Event streaming**: Use `AgentRunUpdateEvent` with `magentic_event_type` metadata
+- **Event streaming**: Use `AgentResponseUpdateEvent` with `magentic_event_type` metadata
 - **Agent specialization**: Custom instructions and tools per agent
 - **Human-in-the-loop**: Plan review, tool approval, and stall intervention
 
@@ -1265,7 +1265,7 @@ from typing import cast
 from agent_framework import (
     MAGENTIC_EVENT_TYPE_AGENT_DELTA,
     MAGENTIC_EVENT_TYPE_ORCHESTRATOR,
-    AgentRunUpdateEvent,
+    AgentResponseUpdateEvent,
     ChatAgent,
     MagenticBuilder,
     MagenticHumanInterventionDecision,

agent-framework/migration-guide/from-semantic-kernel/index.md

@@ -180,13 +180,13 @@ await foreach (AgentResponseItem<ChatMessageContent> result in agent.InvokeAsync
 
 ### Agent Framework
 
-The Non-Streaming returns a single `AgentRunResponse` with the agent response that can contain multiple messages.
-The text result of the run is available in `AgentRunResponse.Text` or `AgentRunResponse.ToString()`.
-All messages created as part of the response are returned in the `AgentRunResponse.Messages` list.
+The Non-Streaming returns a single `AgentResponse` with the agent response that can contain multiple messages.
+The text result of the run is available in `AgentResponse.Text` or `AgentResponse.ToString()`.
+All messages created as part of the response are returned in the `AgentResponse.Messages` list.
 This might include tool call messages, function results, reasoning updates, and final results.
 
 ```csharp
-AgentRunResponse agentResponse = await agent.RunAsync(userInput, thread);
+AgentResponse agentResponse = await agent.RunAsync(userInput, thread);
 ```
 
 ## 7. Agent Streaming Invocation
@@ -204,12 +204,12 @@ await foreach (StreamingChatMessageContent update in agent.InvokeStreamingAsync(
 
 ### Agent Framework
 
-Agent Framework has a similar streaming API pattern, with the key difference being that it returns `AgentRunResponseUpdate` objects that include more agent-related information per update.
+Agent Framework has a similar streaming API pattern, with the key difference being that it returns `AgentResponseUpdate` objects that include more agent-related information per update.
 
-All updates produced by any service underlying the AIAgent are returned. The textual result of the agent is available by concatenating the `AgentRunResponse.Text` values.
+All updates produced by any service underlying the AIAgent are returned. The textual result of the agent is available by concatenating the `AgentResponse.Text` values.
 
 ```csharp
-await foreach (AgentRunResponseUpdate update in agent.RunStreamingAsync(userInput, thread))
+await foreach (AgentResponseUpdate update in agent.RunStreamingAsync(userInput, thread))
 {
     Console.Write(update); // Update is ToString() friendly
 }
@@ -677,7 +677,7 @@ This compatibility layer allows you to gradually migrate your code from Semantic
 
 ## 6. Agent Non-Streaming Invocation
 
-Key differences can be seen in the method names from `invoke` to `run`, return types (for example, `AgentRunResponse`) and parameters.
+Key differences can be seen in the method names from `invoke` to `run`, return types (for example, `AgentResponse`) and parameters.
 
 ### Semantic Kernel
 
@@ -701,7 +701,7 @@ print(f"# {response.role}: {response}")
 
 ### Agent Framework
 
-The Non-Streaming run returns a single `AgentRunResponse` with the agent response that can contain multiple messages.
+The Non-Streaming run returns a single `AgentResponse` with the agent response that can contain multiple messages.
 The text result of the run is available in `response.text` or `str(response)`.
 All messages created as part of the response are returned in the `response.messages` list.
 This might include tool call messages, function results, reasoning updates and final results.
@@ -716,7 +716,7 @@ print("Agent response:", response.text)
 
 ## 7. Agent Streaming Invocation
 
-Key differences in the method names from `invoke` to `run_stream`, return types (`AgentRunResponseUpdate`) and parameters.
+Key differences in the method names from `invoke` to `run_stream`, return types (`AgentResponseUpdate`) and parameters.
 
 ### Semantic Kernel
 
@@ -731,28 +731,28 @@ async for update in agent.invoke_stream(
 
 ### Agent Framework
 
-Similar streaming API pattern with the key difference being that it returns `AgentRunResponseUpdate` objects including more agent related information per update.
+Similar streaming API pattern with the key difference being that it returns `AgentResponseUpdate` objects including more agent related information per update.
 
 All contents produced by any service underlying the Agent are returned. The final result of the agent is available by combining the `update` values into a single response.
 
 ```python
-from agent_framework import AgentRunResponse
+from agent_framework import AgentResponse
 agent = ...
 updates = []
 async for update in agent.run_stream(user_input, thread):
     updates.append(update)
     print(update.text)
 
-full_response = AgentRunResponse.from_agent_run_response_updates(updates)
+full_response = AgentResponse.from_agent_response_updates(updates)
 print("Full agent response:", full_response.text)
 ```
 
 You can even do that directly:
 
 ```python
-from agent_framework import AgentRunResponse
+from agent_framework import AgentResponse
 agent = ...
-full_response = AgentRunResponse.from_agent_response_generator(agent.run_stream(user_input, thread))
+full_response = AgentResponse.from_agent_response_generator(agent.run_stream(user_input, thread))
 print("Full agent response:", full_response.text)
 ```
 

agent-framework/tutorials/agents/function-tools-approvals.md

@@ -67,7 +67,7 @@ You can check the response content for any `FunctionApprovalRequestContent` inst
 
 ```csharp
 AgentThread thread = agent.GetNewThread();
-AgentRunResponse response = await agent.RunAsync("What is the weather like in Amsterdam?", thread);
+AgentResponse response = await agent.RunAsync("What is the weather like in Amsterdam?", thread);
 
 var functionApprovalRequests = response.Messages
     .SelectMany(x => x.Contents)

agent-framework/tutorials/agents/middleware.md

@@ -62,7 +62,7 @@ using System.Linq;
 using System.Threading;
 using System.Threading.Tasks;
 
-async Task<AgentRunResponse> CustomAgentRunMiddleware(
+async Task<AgentResponse> CustomAgentRunMiddleware(
     IEnumerable<ChatMessage> messages,
     AgentThread? thread,
     AgentRunOptions? options,