.NET: [BREAKING] Rename AgentThread to AgentSession by westey-m · Pull Request #3430 · microsoft/agent-framework

westey (westey-m) · 2026-01-26T09:04:31Z

Motivation and Context

#775

Description

Renaming AgentThread to AgentSession to better describe what it represents.

Contribution Checklist

The code builds clean without any errors or warnings
The PR follows the Contribution Guidelines
All unit tests pass, and I have added new tests where possible
Is this a breaking change? If yes, add "[BREAKING]" prefix to the title of the PR.

Copilot

Pull request overview

Renames the core conversation state abstraction in the .NET SDK from AgentThread to AgentSession across product code, tests, and samples to better reflect that it can hold broader conversational state (not just chat history).

Changes:

Renamed public APIs and implementations from AgentThread/*Thread* to AgentSession/*Session* across the SDK surface.
Updated hosting/session persistence abstractions (AgentSessionStore, in-memory/no-op stores) and related integration points (A2A, Azure Functions, Durable Task).
Updated unit/integration tests and samples/docs to use the new session terminology.

Reviewed changes

Copilot reviewed 221 out of 221 changed files in this pull request and generated 9 comments.

Show a summary per file

File	Description
dotnet/src/Microsoft.Agents.AI/OpenTelemetryAgent.cs	Rename run pipeline parameters from thread to session.
dotnet/src/Microsoft.Agents.AI/Memory/ChatHistoryMemoryProviderScope.cs	Renames scope field from `ThreadId` to `SessionId`.
dotnet/src/Microsoft.Agents.AI/LoggingAgent.cs	Updates agent run signatures to `AgentSession`; remarks updated (needs wording fix).
dotnet/src/Microsoft.Agents.AI/FunctionInvocationDelegatingAgent.cs	Forwards session through delegating agent.
dotnet/src/Microsoft.Agents.AI/AgentJsonUtilities.cs	Updates JSON-serializable state types to session equivalents.
dotnet/src/Microsoft.Agents.AI/AgentExtensions.cs	Renames optional function invocation context from thread to session.
dotnet/src/Microsoft.Agents.AI.Workflows/WorkflowsJsonUtilities.cs	Updates workflow agent state serialization to session type.
dotnet/src/Microsoft.Agents.AI.Workflows/Specialized/AIAgentHostExecutor.cs	Stores/restores agent session in workflow checkpointing instead of thread.
dotnet/src/Microsoft.Agents.AI.Purview/ScopedContentProcessor.cs	Renames `threadId` parameter to `sessionId` for Purview correlation.
dotnet/src/Microsoft.Agents.AI.Purview/PurviewWrapper.cs	Renames thread ID extraction and flow to session; still uses ConversationId mapping.
dotnet/src/Microsoft.Agents.AI.Purview/PurviewAgent.cs	Updates agent wrapper APIs to session.
dotnet/src/Microsoft.Agents.AI.Purview/IScopedContentProcessor.cs	Renames interface contract to session terminology.
dotnet/src/Microsoft.Agents.AI.Mem0/Mem0ProviderScope.cs	Updates docs to session wording (property naming needs alignment).
dotnet/src/Microsoft.Agents.AI.Hosting/NoopAgentThreadStore.cs	Removes thread store in favor of session store.
dotnet/src/Microsoft.Agents.AI.Hosting/NoopAgentSessionStore.cs	Adds no-op session store implementation.
dotnet/src/Microsoft.Agents.AI.Hosting/Local/InMemoryAgentSessionStore.cs	Replaces in-memory thread store with in-memory session store.
dotnet/src/Microsoft.Agents.AI.Hosting/HostedAgentBuilderExtensions.cs	Renames builder APIs to `WithInMemorySessionStore` / `WithSessionStore`.
dotnet/src/Microsoft.Agents.AI.Hosting/AgentSessionStore.cs	Renames abstract store contract from thread to session.
dotnet/src/Microsoft.Agents.AI.Hosting.AzureFunctions/README.md	Updates Azure Functions docs to use session terminology.
dotnet/src/Microsoft.Agents.AI.Hosting.A2A/AIAgentExtensions.cs	Renames A2A host integration from thread store to session store.
dotnet/src/Microsoft.Agents.AI.Hosting.A2A.AspNetCore/EndpointRouteBuilderExtensions.cs	Updates DI/service lookup to `AgentSessionStore`.
dotnet/src/Microsoft.Agents.AI.DurableTask/EntityAgentWrapper.cs	Updates wrapper signatures to accept session.
dotnet/src/Microsoft.Agents.AI.DurableTask/DurableAgentSession.cs	Renames durable thread object to durable session object.
dotnet/src/Microsoft.Agents.AI.DurableTask/DurableAgentJsonUtilities.cs	Updates JSON context to serialize `DurableAgentSession`.
dotnet/src/Microsoft.Agents.AI.DurableTask/DurableAgentContext.cs	Renames `CurrentThread` to `CurrentSession`.
dotnet/src/Microsoft.Agents.AI.DurableTask/DurableAIAgentProxy.cs	Updates proxy APIs and validation to durable sessions.
dotnet/src/Microsoft.Agents.AI.DurableTask/AgentEntity.cs	Creates a new session for streaming agent execution.
dotnet/src/Microsoft.Agents.AI.CopilotStudio/CopilotStudioAgentThread.cs	Removes Copilot Studio thread type.
dotnet/src/Microsoft.Agents.AI.CopilotStudio/CopilotStudioAgentSession.cs	Adds Copilot Studio session type.
dotnet/src/Microsoft.Agents.AI.Abstractions/DelegatingAIAgent.cs	Updates delegating base agent APIs to session.
dotnet/src/Microsoft.Agents.AI.Abstractions/ChatHistoryProvider.cs	Updates docs to associate provider with a session.
dotnet/src/Microsoft.Agents.AI.Abstractions/AgentRunOptions.cs	Updates XML docs to reference session-based Run APIs.
dotnet/src/Microsoft.Agents.AI.Abstractions/AgentResponseUpdate.cs	Updates XML docs to reference session-based streaming APIs.
dotnet/src/Microsoft.Agents.AI.Abstractions/AgentResponse.cs	Updates XML docs to reference session-based non-streaming APIs.
dotnet/src/Microsoft.Agents.AI.Abstractions/AgentAbstractionsJsonUtilities.cs	Updates JSON context types to session-based states.
dotnet/src/Microsoft.Agents.AI.AGUI/AGUIChatClient.cs	Updates comments to session terminology (execution-thread wording needs care in some places).
dotnet/src/Microsoft.Agents.AI.A2A/A2AJsonUtilities.cs	Updates JSON context to session-based state type.
dotnet/src/Microsoft.Agents.AI.A2A/A2AAgentSession.cs	Renames A2A thread object to session object and updates serialization.
dotnet/tests/OpenAIResponse.IntegrationTests/OpenAIResponseFixture.cs	Updates fixture APIs to accept `AgentSession`.
dotnet/tests/OpenAIChatCompletion.IntegrationTests/OpenAIChatCompletionFixture.cs	Updates fixture APIs to accept `AgentSession`.
dotnet/tests/OpenAIAssistant.IntegrationTests/OpenAIAssistantFixture.cs	Updates fixture APIs to accept `AgentSession`.
dotnet/tests/Microsoft.Agents.AI.Workflows.UnitTests/WorkflowHostSmokeTests.cs	Updates workflow agent tests to use `InMemoryAgentSession`.
dotnet/tests/Microsoft.Agents.AI.Workflows.UnitTests/SpecializedExecutorSmokeTests.cs	Updates smoke tests and test types to session variants.
dotnet/tests/Microsoft.Agents.AI.Workflows.UnitTests/SampleSmokeTest.cs	Updates sample smoke test state variable from thread to session.
dotnet/tests/Microsoft.Agents.AI.Workflows.UnitTests/Sample/13_Subworkflow_Checkpointing.cs	Updates sample workflow entrypoint to accept/return session.
dotnet/tests/Microsoft.Agents.AI.Workflows.UnitTests/Sample/12_HandOff_HostAsAgent.cs	Updates sample to use session.
dotnet/tests/Microsoft.Agents.AI.Workflows.UnitTests/Sample/11_Concurrent_HostAsAgent.cs	Updates sample to use session.
dotnet/tests/Microsoft.Agents.AI.Workflows.UnitTests/Sample/10_Sequential_HostAsAgent.cs	Updates sample to use session.
dotnet/tests/Microsoft.Agents.AI.Workflows.UnitTests/Sample/07_GroupChat_Workflow_HostAsAgent.cs	Updates sample to use session.
dotnet/tests/Microsoft.Agents.AI.Workflows.UnitTests/Sample/06_GroupChat_Workflow.cs	Updates sample agent to implement session APIs.
dotnet/tests/Microsoft.Agents.AI.Workflows.UnitTests/RepresentationTests.cs	Updates test agent API surface to session.
dotnet/tests/Microsoft.Agents.AI.Workflows.UnitTests/InProcessExecutionTests.cs	Updates test agent + internal session class naming/docs.
dotnet/tests/Microsoft.Agents.AI.Workflows.UnitTests/AgentWorkflowBuilderTests.cs	Updates builder tests and test agents to session APIs.
dotnet/tests/Microsoft.Agents.AI.UnitTests/TestAIAgent.cs	Updates test helper delegates to session-based signatures.
dotnet/tests/Microsoft.Agents.AI.UnitTests/OpenTelemetryAgentTests.cs	Updates tests to use session-based callbacks.
dotnet/tests/Microsoft.Agents.AI.UnitTests/LoggingAgentTests.cs	Updates tests to use session-based callbacks.
dotnet/tests/Microsoft.Agents.AI.UnitTests/FunctionInvocationDelegatingAgentTests.cs	Updates middleware callback signature to session.
dotnet/tests/Microsoft.Agents.AI.UnitTests/ChatClient/ChatClientAgent_DeserializeSessionTests.cs	Renames and updates deserialize tests to session type.
dotnet/tests/Microsoft.Agents.AI.UnitTests/AgentExtensionsTests.cs	Updates agent extension tests to session type.
dotnet/tests/Microsoft.Agents.AI.UnitTests/AIAgentBuilderTests.cs	Updates generic middleware signature from thread to session.
dotnet/tests/Microsoft.Agents.AI.Hosting.AzureFunctions.UnitTests/TestAgent.cs	Updates test agent and dummy session type.
dotnet/tests/Microsoft.Agents.AI.Hosting.AzureFunctions.IntegrationTests/SamplesValidation.cs	Updates validation to reference session terminology.
dotnet/tests/Microsoft.Agents.AI.Hosting.A2A.UnitTests/AIAgentExtensionsTests.cs	Updates A2A extension tests to session-based APIs.
dotnet/tests/Microsoft.Agents.AI.DurableTask.UnitTests/DurableAgentThreadTests.cs	Removes durable thread serialization tests.
dotnet/tests/Microsoft.Agents.AI.DurableTask.UnitTests/DurableAgentSessionTests.cs	Adds durable session serialization tests.
dotnet/tests/Microsoft.Agents.AI.DurableTask.IntegrationTests/TimeToLiveTests.cs	Updates TTL tests to use session.
dotnet/tests/Microsoft.Agents.AI.DurableTask.IntegrationTests/ExternalClientTests.cs	Updates external client tests to use session.
dotnet/tests/Microsoft.Agents.AI.DurableTask.IntegrationTests/AgentEntityTests.cs	Updates entity tests to use session.
dotnet/tests/Microsoft.Agents.AI.Declarative.UnitTests/AggregatorPromptAgentFactoryTests.cs	Updates test agent to session APIs.
dotnet/tests/Microsoft.Agents.AI.AzureAI.UnitTests/AzureAIProjectChatClientTests.cs	Updates tests to use session and `ChatClientAgentSession`.
dotnet/tests/Microsoft.Agents.AI.Abstractions.UnitTests/TestJsonSerializerContext.cs	Updates JSON context types to session state types.
dotnet/tests/Microsoft.Agents.AI.Abstractions.UnitTests/ServiceIdAgentThreadTests.cs	Removes thread-based ServiceId agent tests.
dotnet/tests/Microsoft.Agents.AI.A2A.UnitTests/A2AAgentThreadTests.cs	Removes A2A thread tests.
dotnet/tests/Microsoft.Agents.AI.A2A.UnitTests/A2AAgentSessionTests.cs	Adds A2A session tests.
dotnet/tests/CopilotStudio.IntegrationTests/CopilotStudioRunTests.cs	Updates skipped conformance test name to session.
dotnet/tests/CopilotStudio.IntegrationTests/CopilotStudioRunStreamingTests.cs	Updates skipped conformance test name to session.
dotnet/tests/CopilotStudio.IntegrationTests/CopilotStudioFixture.cs	Updates fixture API to session.
dotnet/tests/AzureAIAgentsPersistent.IntegrationTests/AzureAIAgentsPersistentFixture.cs	Updates fixture APIs to session.
dotnet/tests/AzureAI.IntegrationTests/AIProjectClientFixture.cs	Updates fixture APIs to session.
dotnet/tests/AnthropicChatCompletion.IntegrationTests/AnthropicChatCompletionRunTests.cs	Updates conformance override name to session.
dotnet/tests/AnthropicChatCompletion.IntegrationTests/AnthropicChatCompletionRunStreamingTests.cs	Updates conformance override name to session.
dotnet/tests/AnthropicChatCompletion.IntegrationTests/AnthropicChatCompletionFixture.cs	Updates fixture APIs to session.
dotnet/tests/AgentConformance.IntegrationTests/Support/SessionCleanup.cs	Renames cleanup helper to delete sessions.
dotnet/tests/AgentConformance.IntegrationTests/IAgentFixture.cs	Updates fixture contract to session APIs.
dotnet/tests/AgentConformance.IntegrationTests/ChatClientAgentRunTests.cs	Updates conformance tests to create/use sessions.
dotnet/tests/AgentConformance.IntegrationTests/ChatClientAgentRunStreamingTests.cs	Updates conformance tests to create/use sessions.
dotnet/samples/M365Agent/Agents/WeatherForecastAgent.cs	Updates sample agent override signatures to session.
dotnet/samples/M365Agent/AFAgentApplication.cs	Updates Bot Framework sample state handling to session serialization.
dotnet/samples/GettingStarted/Workflows/Observability/WorkflowAsAnAgent/Program.cs	Updates sample to create/use sessions.
dotnet/samples/GettingStarted/Workflows/Declarative/HostedWorkflow/Program.cs	Updates sample to create/use sessions.
dotnet/samples/GettingStarted/Workflows/Agents/WorkflowAsAnAgent/Program.cs	Updates sample to create/use sessions.
dotnet/samples/GettingStarted/Workflows/Agents/CustomAgentExecutors/Program.cs	Updates sample executor state from thread to session.
dotnet/samples/GettingStarted/ModelContextProtocol/ResponseAgent_Hosted_MCP/Program.cs	Updates sample to create/use sessions.
dotnet/samples/GettingStarted/ModelContextProtocol/FoundryAgent_Hosted_MCP/Program.cs	Updates sample to create/use sessions.
dotnet/samples/GettingStarted/FoundryAgents/FoundryAgents_Step15_ComputerUse/Program.cs	Updates sample to create/use sessions and resume with session.
dotnet/samples/GettingStarted/FoundryAgents/FoundryAgents_Step13_Plugins/Program.cs	Updates sample to create/use sessions.
dotnet/samples/GettingStarted/FoundryAgents/FoundryAgents_Step12_Middleware/Program.cs	Updates sample middleware signatures and session usage.
dotnet/samples/GettingStarted/FoundryAgents/FoundryAgents_Step11_AsFunctionTool/Program.cs	Updates sample to create/use sessions.
dotnet/samples/GettingStarted/FoundryAgents/FoundryAgents_Step10_UsingImages/Program.cs	Updates sample to create/use sessions.
dotnet/samples/GettingStarted/FoundryAgents/FoundryAgents_Step08_DependencyInjection/Program.cs	Updates sample service state from thread to session.
dotnet/samples/GettingStarted/FoundryAgents/FoundryAgents_Step07_Observability/Program.cs	Updates sample to create/use sessions (streaming + non-streaming).
dotnet/samples/GettingStarted/FoundryAgents/FoundryAgents_Step06_PersistedConversations/Program.cs	Updates sample persistence to serialize/deserialize sessions.
dotnet/samples/GettingStarted/FoundryAgents/FoundryAgents_Step04_UsingFunctionToolsWithApprovals/Program.cs	Updates sample to create/use sessions and continue with session.
dotnet/samples/GettingStarted/FoundryAgents/FoundryAgents_Step03_UsingFunctionTools/Program.cs	Updates sample to create/use sessions (streaming + non-streaming).
dotnet/samples/GettingStarted/FoundryAgents/FoundryAgents_Step02_MultiturnConversation/README.md	Updates docs to use `GetNewSessionAsync`.
dotnet/samples/GettingStarted/FoundryAgents/FoundryAgents_Step02_MultiturnConversation/Program.cs	Updates sample to create/use sessions with Foundry conversations.
dotnet/samples/GettingStarted/Agents/Agent_Step20_AdditionalAIContext/Program.cs	Updates sample to create/use sessions and persist state.
dotnet/samples/GettingStarted/Agents/Agent_Step18_DeepResearch/Program.cs	Updates sample to create/use session for streaming.
dotnet/samples/GettingStarted/Agents/Agent_Step17_BackgroundResponses/Program.cs	Updates sample to use session for continuation/resumption.
dotnet/samples/GettingStarted/Agents/Agent_Step16_ChatReduction/Program.cs	Updates sample to use session (chat history access via services).
dotnet/samples/GettingStarted/Agents/Agent_Step13_BackgroundResponsesWithToolsAndPersistence/Program.cs	Updates sample persistence helpers to use session.
dotnet/samples/GettingStarted/Agents/Agent_Step11_UsingImages/Program.cs	Updates sample to create/use session for streaming.
dotnet/samples/GettingStarted/Agents/Agent_Step09_DependencyInjection/Program.cs	Updates sample service state from thread to session.
dotnet/samples/GettingStarted/Agents/Agent_Step06_PersistedConversations/Program.cs	Updates sample persistence to serialize/deserialize sessions.
dotnet/samples/GettingStarted/Agents/Agent_Step04_UsingFunctionToolsWithApprovals/Program.cs	Updates sample to create/use session and continue with session.
dotnet/samples/GettingStarted/Agents/Agent_Step02_MultiturnConversation/Program.cs	Updates sample to create/use session for multi-turn context.
dotnet/samples/GettingStarted/AgentWithRAG/AgentWithRAG_Step04_FoundryServiceRAG/Program.cs	Updates sample to create/use sessions.
dotnet/samples/GettingStarted/AgentWithRAG/AgentWithRAG_Step03_CustomRAGDataSource/Program.cs	Updates sample to create/use sessions.
dotnet/samples/GettingStarted/AgentWithRAG/AgentWithRAG_Step02_CustomVectorStoreRAG/Program.cs	Updates sample to create/use sessions.
dotnet/samples/GettingStarted/AgentWithRAG/AgentWithRAG_Step01_BasicTextRAG/TextSearchStore/TextSearchStore.cs	Updates comments (needs thread-vs-session wording correction for locking).
dotnet/samples/GettingStarted/AgentWithRAG/AgentWithRAG_Step01_BasicTextRAG/Program.cs	Updates sample to create/use sessions.
dotnet/samples/GettingStarted/AgentWithOpenAI/README.md	Updates docs to refer to AgentSession.
dotnet/samples/GettingStarted/AgentWithOpenAI/Agent_OpenAI_Step05_Conversation/README.md	Updates docs and code snippets to AgentSession.
dotnet/samples/GettingStarted/AgentWithOpenAI/Agent_OpenAI_Step05_Conversation/Program.cs	Updates sample to create/use session for multi-turn conversation.
dotnet/samples/GettingStarted/AgentWithOpenAI/Agent_OpenAI_Step04_CreateFromOpenAIResponseClient/OpenAIResponseClientAgent.cs	Updates sample wrapper methods to accept session.
dotnet/samples/GettingStarted/AgentWithOpenAI/Agent_OpenAI_Step03_CreateFromChatClient/OpenAIChatClientAgent.cs	Updates sample wrapper methods to accept session.
dotnet/samples/GettingStarted/AgentWithMemory/AgentWithMemory_Step02_MemoryUsingMem0/Program.cs	Updates sample to use session terminology and serialize/deserialize session.
dotnet/samples/GettingStarted/AgentWithMemory/AgentWithMemory_Step01_ChatHistoryMemory/Program.cs	Updates sample to use sessions (contains a new-guid bug + typo).
dotnet/samples/GettingStarted/AgentWithAnthropic/Agent_Anthropic_Step03_UsingFunctionTools/Program.cs	Updates sample to create/use sessions.
dotnet/samples/GettingStarted/AgentProviders/Agent_With_OpenAIAssistants/Program.cs	Updates sample to create/use session.
dotnet/samples/GettingStarted/AgentProviders/Agent_With_AzureAIProject/Program.cs	Updates sample to create/use session.
dotnet/samples/GettingStarted/AgentProviders/Agent_With_AzureAIAgentsPersistent/Program.cs	Updates sample to create/use session.
dotnet/samples/GettingStarted/AgentOpenTelemetry/Program.cs	Updates sample to create/use session for streaming.
dotnet/samples/GettingStarted/AGUI/Step05_StateManagement/Server/SharedStateAgent.cs	Updates wrapper to flow session.
dotnet/samples/GettingStarted/AGUI/Step05_StateManagement/Client/StatefulAgent.cs	Updates wrapper to flow session.
dotnet/samples/GettingStarted/AGUI/Step05_StateManagement/Client/Program.cs	Updates sample to create/use session and print run session id.
dotnet/samples/GettingStarted/AGUI/Step04_HumanInLoop/Server/ServerFunctionApprovalServerAgent.cs	Updates wrapper to flow session.
dotnet/samples/GettingStarted/AGUI/Step04_HumanInLoop/Client/ServerFunctionApprovalClientAgent.cs	Updates wrapper to flow session.
dotnet/samples/GettingStarted/AGUI/Step04_HumanInLoop/Client/Program.cs	Updates client sample to track session rather than thread.
dotnet/samples/GettingStarted/AGUI/Step03_FrontendTools/Client/Program.cs	Updates sample to create/use session and print run session id.
dotnet/samples/GettingStarted/AGUI/Step02_BackendTools/Client/Program.cs	Updates sample to create/use session and print run session id.
dotnet/samples/GettingStarted/AGUI/Step01_GettingStarted/Client/Program.cs	Updates sample to create/use session and print run session id.
dotnet/samples/GettingStarted/A2A/A2AAgent_PollingForTaskCompletion/Program.cs	Updates sample to create/use session for continuation polling.
dotnet/samples/DurableAgents/ConsoleApps/07_ReliableStreaming/RedisStreamResponseHandler.cs	Updates durable sample to use `CurrentSession`.
dotnet/samples/DurableAgents/ConsoleApps/07_ReliableStreaming/Program.cs	Updates durable sample to create/use session.
dotnet/samples/DurableAgents/ConsoleApps/06_LongRunningTools/Program.cs	Updates durable sample orchestration to use sessions.
dotnet/samples/DurableAgents/ConsoleApps/05_AgentOrchestration_HITL/Program.cs	Updates durable sample orchestration to use sessions.
dotnet/samples/DurableAgents/ConsoleApps/04_AgentOrchestration_Conditionals/Program.cs	Updates durable sample orchestration to use sessions.
dotnet/samples/DurableAgents/ConsoleApps/02_AgentOrchestration_Chaining/README.md	Updates docs to AgentSession.
dotnet/samples/DurableAgents/ConsoleApps/02_AgentOrchestration_Chaining/Program.cs	Updates orchestration sample to use sessions.
dotnet/samples/DurableAgents/ConsoleApps/01_SingleAgent/Program.cs	Updates single-agent durable sample to use sessions.
dotnet/samples/AzureFunctions/08_ReliableStreaming/RedisStreamResponseHandler.cs	Updates Azure Functions sample to use `CurrentSession`.
dotnet/samples/AzureFunctions/08_ReliableStreaming/FunctionTriggers.cs	Updates sample trigger to create/use session.
dotnet/samples/AzureFunctions/06_LongRunningTools/Tools.cs	Updates comment to session terminology.
dotnet/samples/AzureFunctions/06_LongRunningTools/FunctionTriggers.cs	Updates orchestration sample to use sessions.
dotnet/samples/AzureFunctions/05_AgentOrchestration_HITL/FunctionTriggers.cs	Updates orchestration sample to use sessions.
dotnet/samples/AzureFunctions/04_AgentOrchestration_Conditionals/FunctionTriggers.cs	Updates orchestration sample to use sessions.
dotnet/samples/AzureFunctions/02_AgentOrchestration_Chaining/README.md	Updates docs to AgentSession.
dotnet/samples/AzureFunctions/02_AgentOrchestration_Chaining/Program.cs	Updates sample comments to session terminology.
dotnet/samples/AzureFunctions/02_AgentOrchestration_Chaining/FunctionTriggers.cs	Updates orchestration sample to use sessions.
dotnet/samples/AgentWebChat/AgentWebChat.Web/OpenAIResponsesAgentClient.cs	Renames threadId parameter to sessionId and maps to ConversationId.
dotnet/samples/AgentWebChat/AgentWebChat.Web/OpenAIChatCompletionsAgentClient.cs	Renames threadId parameter to sessionId.
dotnet/samples/AgentWebChat/AgentWebChat.Web/IAgentClient.cs	Renames threadId parameter to sessionId; adds AgentClientSession wrapper (naming needs alignment).
dotnet/samples/AgentWebChat/AgentWebChat.Web/A2AAgentClient.cs	Renames threadId parameter to sessionId, still maps to A2A context id.
dotnet/samples/AgentWebChat/AgentWebChat.AgentHost/Program.cs	Updates host builder to use in-memory session store.
dotnet/samples/AGUIClientServer/AGUIDojoServer/SharedState/SharedStateAgent.cs	Updates wrapper to flow session through.
dotnet/samples/AGUIClientServer/AGUIDojoServer/PredictiveStateUpdates/PredictiveStateUpdatesAgent.cs	Updates wrapper to flow session through.
dotnet/samples/AGUIClientServer/AGUIDojoServer/AgenticUI/AgenticUIAgent.cs	Updates wrapper to flow session through.
dotnet/samples/AGUIClientServer/AGUIClient/Program.cs	Updates sample to create/use session and print run session id.
dotnet/samples/A2AClientServer/A2AClient/Program.cs	Updates sample to create/use session.

Comments suppressed due to low confidence (2)

dotnet/src/Microsoft.Agents.AI.DurableTask/DurableAgentSession.cs:40

serializedSession parameter documentation says "serialized thread data". Please update to "serialized session data" to match the rename and avoid confusion.
dotnet/src/Microsoft.Agents.AI.DurableTask/DurableAgentSession.cs:11
The class summary still says "An agent thread implementation" even though the type is now DurableAgentSession. Update the summary to say "session" for correctness and discoverability.

westey (westey-m)

Replied to review comments

The Microsoft Agent Framework renamed AgentThread to AgentSession (microsoft/agent-framework#3430). The durable extension's core types were already migrated, but its HTTP and MCP wire contracts, a few Python public symbols, and the docs still used "thread". Incoming requests continue to accept the deprecated thread_id / threadId names, so existing callers keep working. Responses and the MCP tool schema now expose session_id / x-ms-session-id / sessionId only. --------- Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

westey (westey-m) added 3 commits January 23, 2026 22:42

Rename AgentThread to AgentSession
f32ae99

Add more renames
c9d41f4

Update readme files
544c65c

Mark Wallace (markwallace-microsoft) added documentation Usage: [Issues, PRs], Target: documentation in the code base and learn docs .NET Usage: [Issues, PRs], Target: .Net workflows Usage: [Issues, PRs], Target: Workflows labels Jan 26, 2026

github-actionsBot changed the title ~~[BREAKING] Rename AgentThread to AgentSession~~.NET: [BREAKING] Rename AgentThread to AgentSessionJan 26, 2026

westey (westey-m) added 3 commits January 26, 2026 09:54

Revert nullable variable change and further fixes.
74cf1b5

Revert change in header name
b8f81a1

Fix some comments and tests
c830822

westey (westey-m) marked this pull request as ready for review January 26, 2026 10:47

CopilotAI review requested due to automatic review settings January 26, 2026 10:47

Copilotstarted reviewing on behalf of westey (westey-m)January 26, 2026 10:48 View session

Update changelog.
abab268

CopilotAI reviewed Jan 26, 2026
View reviewed changes

Merge branch 'main' into agentsession-rename
d76dc78

westey (westey-m)temporarily deployed to integration January 26, 2026 11:06 — with GitHub Actions Inactive

westey (westey-m)had a problem deploying to integration January 26, 2026 11:06 — with GitHub Actions Error

Address PR feedback.
85ac32f

westey (westey-m) commented Jan 26, 2026
View reviewed changes

westey (westey-m)temporarily deployed to integration January 26, 2026 11:17 — with GitHub Actions Inactive

SergeyMenshykh approved these changes Jan 26, 2026
View reviewed changes

Fixing code review comments.
debbb66

westey (westey-m)temporarily deployed to integration January 26, 2026 12:32 — with GitHub Actions Inactive

Merge branch 'main' into agentsession-rename
0fedf65

westey (westey-m)had a problem deploying to integration January 26, 2026 14:07 — with GitHub Actions Failure

Jacob Alber (lokitoth) approved these changes Jan 26, 2026
View reviewed changes

This was referenced Apr 6, 2026
chore: Bump Microsoft.Agents.AI and Microsoft.Extensions.AI sterob-2/orchestrator#89
Closed
chore: Bump Microsoft.Agents.AI and 4 others sterob-2/orchestrator#90
Open
chore: Bump Microsoft.Agents.AI and 2 others sterob-2/orchestrator#91
Open

This was referenced May 2, 2026
Bump the nuget-all group with 7 updates microsoft/Agents#546
Closed
Bump the dotnet-tooling group with 6 updates incursa/workbench#607
Closed
Bump the nuget-all group with 8 updates microsoft/Agents#562
Merged

This was referenced May 18, 2026
deps: Bump AgentFrameworkToolkit.Tools.ModelContextProtocol and 2 others Esquetta/Kam#20
Closed
deps: Bump Microsoft.Agents.AI from 1.0.0-preview.260108.1 to 1.6.1 Esquetta/Kam#22
Closed

dependabotBot mentioned this pull request Jun 10, 2026
Bump JsonSchema.Net and 5 others incursa/workbench#610
Closed

dependabotBot mentioned this pull request Jun 24, 2026
Bump the dotnet-tooling group with 7 updates incursa/workbench#612
Closed

dependabotBot mentioned this pull request Jul 15, 2026
Bump DotNet.ReproducibleBuilds.Isolated and 6 others incursa/workbench#613
Open

This was referenced Jul 24, 2026
Use "session" instead of "thread" terminology microsoft/agent-framework-durable-extension#46
Closed
Use "session" instead of "thread" terminology microsoft/agent-framework-durable-extension#47
Merged

Uh oh!

Conversation

westey (westey-m) commented Jan 26, 2026

Motivation and Context

Description

Contribution Checklist

Uh oh!

CopilotAI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

westey (westey-m) left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants