69 Commits

• .NET: CI Build time end to end improvement (#4208)

  * .NET: Upgrade to XUnit 3 and Microsoft Testing Platform (#4176)
  
  * Fix copilot studio integration tests failure (#4209)
  
  * Fix anthropic integration tests and skip reason (#4211)
  
  * Remove accidental add of code coverage for integration tests (#4219)
  
  * Add solution filtered parallel test run (#4226)
  
  * Fix build paths (#4228)
  
  * Fix coverage settings path and trait filter (#4229)
  
  * Add project name filter to solution (#4231)
  
  * Increase Integration Test Parallelism (#4241)
  
  * Increase integration tests threads to 4x (#4242)
  
  * Separate build and test into parallel jobs (#4243)
  
  * Filter src by framework for tests build (#4244)
  
  * Separate build and test into parallel jobs
  
  * Filter source projects by framework for tests build
  
  * Pre-build samples via tests to avoid timeouts (#4245)
  
  * Separate build from run for console sample validation (#4251)
  
  * Address PR comments (#4255)
  
  * Merge and move scripts (#4308)
  
  * .NET: Add Microsoft Fabric sample #3674 (#4230)
  
  Co-authored-by: Chris <66376200+crickman@users.noreply.github.com>
  
  * Python: Phase 2: Embedding clients for Ollama, Bedrock, and Azure AI Inference (#4207)
  
  * Phase 2: Embedding clients for Ollama, Bedrock, and Azure AI Inference
  
  Add embedding client implementations to existing provider packages:
  
  - OllamaEmbeddingClient: Text embeddings via Ollama's embed API
  - BedrockEmbeddingClient: Text embeddings via Amazon Titan on Bedrock
  - AzureAIInferenceEmbeddingClient: Text and image embeddings via Azure AI
    Inference, supporting Content | str input with separate model IDs for
    text (AZURE_AI_INFERENCE_EMBEDDING_MODEL_ID) and image
    (AZURE_AI_INFERENCE_IMAGE_EMBEDDING_MODEL_ID) endpoints
  
  Additional changes:
  - Rename EmbeddingCoT -> EmbeddingT, EmbeddingOptionsCoT -> EmbeddingOptionsT
  - Add otel_provider_name passthrough to all embedding clients
  - Register integration pytest marker in all packages
  - Add lazy-loading namespace exports for Ollama and Bedrock embeddings
  - Add image embedding sample using Cohere-embed-v3-english
  - Add azure-ai-inference dependency to azure-ai package
  
  Part of #1188
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix mypy duplicate name and ruff lint issues
  
  - Rename second 'vector' variable to 'img_vector' in image embedding loop
  - Combine nested with statements in tests
  - Remove unused result assignments in tests
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * updates from feedback
  
  * Fix CI failures in embedding usage handling
  
  - Fix Azure AI embedding mypy issues by normalizing vectors to list[float],
    safely accumulating optional usage token fields, and filtering None entries
    before constructing GeneratedEmbeddings
  - Avoid Bandit false positive by initializing usage details as an empty dict
  - Update OpenAI embedding tests to assert canonical usage keys
    (input_token_count/total_token_count)
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * [Purview] Mark responses as responses and fix epoch bug for python long overflow (#4225)
  
  * .NET: Support InvokeMcpTool for declarative workflows (#4204)
  
  * Initial implementation of InvokeMcpTool in declarative workflow
  
  * Cleaned up sample implementation
  
  * Updated sample comments.
  
  * Added missing executor routing attribute
  
  * Fix PR comments.
  
  * Updated based on PR comments.
  
  * Updated based on PR comments.
  
  * Removed unnecessary using statement.
  
  * Update Python package versions to rc2 (#4258)
  
  - Bump core and azure-ai to 1.0.0rc2
  - Bump preview packages to 1.0.0b260225
  - Update dependencies to >=1.0.0rc2
  - Add CHANGELOG entries for changes since rc1
  - Update uv.lock
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * .NET: Fixing issue where OpenTelemetry span is never exported in .NET in-process workflow execution (#4196)
  
  * 1. Add reproduction test for issue #4155: workflow.run Activity never stopped in streaming OffThread path
  
  The WorkflowRunActivity_IsStopped_Streaming_OffThread test demonstrates that
  the workflow.run OpenTelemetry Activity created in StreamingRunEventStream.RunLoopAsync
  is started but never stopped when using the OffThread/Default streaming execution.
  The background run loop keeps running after event consumption completes, so the
  using Activity? declaration never disposes until explicit StopAsync() is called.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  2. Fix workflow.run Activity never stopped in streaming OffThread execution (#4155)
  
  The workflow.run OpenTelemetry Activity in StreamingRunEventStream.RunLoopAsync
  was scoped to the method lifetime via 'using'. Since the run loop only exits on
  cancellation, the Activity was never stopped/exported until explicit disposal.
  
  Fix: Remove 'using' and explicitly dispose the Activity when the workflow reaches
  Idle status (all supersteps complete). A safety-net disposal in the finally block
  handles cancellation and error paths.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Add root-level workflow.session activity spanning run loop lifetime\n\nImplements two-level telemetry hierarchy per PR feedback from lokitoth:\n- workflow.session: spans the entire run loop / stream lifetime\n- workflow_invoke: per input-to-halt cycle, nested within the session\n\nThis ensures the session activity stays open across multiple turns,\nwhile individual run activities are created and disposed per cycle.\n\nAlso fixes linkedSource CancellationTokenSource disposal leak in\nStreamingRunEventStream (added using declaration)."
  
  * Address Copilot review: fix Activity/CTS disposal, rename activity, add error tag\n\n1. LockstepRunEventStream: Remove 'using' from Activity in async iterator\n   and manually dispose in finally block (fixes #4155 pattern). Also dispose\n   linkedSource CTS in finally to prevent leak.\n2. Tags.cs: Add ErrorMessage (\"error.message\") tag for runtime errors,\n   distinct from BuildErrorMessage (\"build.error.message\").\n3. ActivityNames: Rename WorkflowRun from \"workflow_invoke\" to \"workflow.run\"\n   for cross-language consistency.\n4. WorkflowTelemetryContext: Fix XML doc to say \"outer/parent span\" instead\n   of \"root-level span\".\n5. ObservabilityTests: Assert WorkflowSession absence when DisableWorkflowRun\n   is true.\n6. WorkflowRunActivityStopTests: Fix streaming test race by disposing\n   StreamingRun before asserting activities are stopped.\n7. StreamingRunEventStream/LockstepRunEventStream: Use Tags.ErrorMessage\n   instead of Tags.BuildErrorMessage for runtime error events."
  
  * Review fixes: revert workflow_invoke rename, use 'using' for linkedSource, move SessionStarted earlier\n\n- Revert ActivityNames.WorkflowRun back to \"workflow_invoke\" (OTEL semantic convention contract)\n- Use 'using' declaration for linkedSource CTS in LockstepRunEventStream (no timing sensitivity)\n- Move SessionStarted event before WaitForInputAsync in StreamingRunEventStream to match Lockstep behavior"
  
  * Improve naming and comments in WorkflowRunActivityStopTests"
  
  * Prevent session Activity.Current leak in lockstep mode, add nesting test
  
  Save and restore Activity.Current in LockstepRunEventStream.Start() so the
  session activity doesn't leak into caller code via AsyncLocal. Re-establish
  Activity.Current = sessionActivity before creating the run activity in
  TakeEventStreamAsync to preserve parent-child nesting.
  
  Add test verifying app activities after RunAsync are not parented under the
  session, and that the workflow_invoke activity nests under the session."
  
  * Fix stale XML doc: WorkflowRun -> WorkflowInvoke in ObservabilityTests
  
  ---------
  
  Co-authored-by: alliscode <bentho@microsoft.com>
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Python / .NET Samples - Restructure and Improve Samples (Feature Branc… (#4092)
  
  * Python: .NET Samples - Restructure and Improve Samples (Feature Branch) (#4091)
  
  * Moved by agent (#4094)
  
  * Fix readme links
  
  * .NET Samples - Create `04-hosting` learning path step (#4098)
  
  * Agent move
  
  * Agent reorderd
  
  * Remove A2A section from README 
  
  Removed A2A section from the Getting Started README.
  
  * Agent fixed links
  
  * Fix broken sample links in durable-agents README (#4101)
  
  * Initial plan
  
  * Fix broken internal links in documentation
  
  Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>
  
  * Revert template link changes; keep only durable-agents README fix
  
  Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
  Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>
  
  * .NET Samples - Create `03-workflows` learning path step (#4102)
  
  * Fix solution project path
  
  * Python: Fix broken markdown links to repo resources (outside /docs) (#4105)
  
  * Initial plan
  
  * Fix broken markdown links to repo resources
  
  Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>
  
  * Update README to rename .NET Workflows Samples section
  
  ---------
  
  Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
  Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>
  
  * .NET Samples - Create `02-agents` learning path step (#4107)
  
  * .NET: Fix broken relative link in GroupChatToolApproval README (#4108)
  
  * Initial plan
  
  * Fix broken link in GroupChatToolApproval README
  
  Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
  Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>
  
  * Update labeler configuration for workflow samples
  
  * .NET - Reorder Agents samples to start from Step01 instead of Step04 (#4110)
  
  * Fix solution
  
  * Resolve new sample paths
  
  * Move new AgentSkills and AgentWithMemory_Step04 samples
  
  * Fix link
  
  * Fix readme path
  
  * fix: update stale dotnet/samples/Durable path reference in AGENTS.md
  
  Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>
  
  * Moved new sample
  
  * Update solution
  
  * Resolve merge (new sample)
  
  * Sync to new sample - FoundryAgents_Step21_BingCustomSearch
  
  * Updated README
  
  * .NET Samples - Configuration Naming Update (#4149)
  
  * .NET: Restore AzureFunctions index parity with ConsoleApps under DurableAgents samples (#4221)
  
  * Clean-up `05_host_your_agent`
  
  * Config setting consistency
  
  * Refine samples
  
  * AGENTS.md
  
  * Move new samples
  
  * Re-order samples
  
  * Move new project and fixup solution
  
  * Fixup model config
  
  * Fix up new UT project
  
  ---------
  
  Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>
  
  * Python: Fix Bedrock embedding test stub missing meta attribute (#4287)
  
  * Fix Bedrock embedding test stub missing meta attribute
  
  * Increase test coverage so gate passes
  
  * Python: (ag-ui): fix approval payloads being re-processed on subsequent conversation turns (#4232)
  
  * Fix ag-ui tool call issue
  
  * Safe json fix
  
  * Python: Update workflow orchestration samples to use AzureOpenAIResponsesClient (#4285)
  
  * Update workflow orchestration samples to use AzureOpenAIResponsesClient
  
  * Fix broken link
  
  * Move scripts to scripts folder
  
  ---------
  
  Co-authored-by: Roger Barreto <19890735+rogerbarreto@users.noreply.github.com>
  Co-authored-by: Chris <66376200+crickman@users.noreply.github.com>
  Co-authored-by: Eduard van Valkenburg <eavanvalkenburg@users.noreply.github.com>
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  Co-authored-by: Rishabh Chawla <rishabhchawla1995@gmail.com>
  Co-authored-by: Peter Ibekwe <109177538+peibekwe@users.noreply.github.com>
  Co-authored-by: Dmytro Struk <13853051+dmytrostruk@users.noreply.github.com>
  Co-authored-by: Ben Thomas <ben.thomas@microsoft.com>
  Co-authored-by: alliscode <bentho@microsoft.com>
  Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>
  Co-authored-by: Evan Mattson <35585003+moonbox3@users.noreply.github.com>
  
  * Fix encoding (#4309)
  
  * Disable Parallelization for WorkflowRunActivityStopTests (#4313)
  
  * Revert parallel disable (#4324)
  
  * .NET: Disable flakey Workflow Observability tests (#4416)
  
  * Disable flakey OffThread test
  
  * Disable additional OffThread test
  
  * Disable a further test
  
  * Disable all observability tests
  
  ---------
  
  Co-authored-by: Roger Barreto <19890735+rogerbarreto@users.noreply.github.com>
  Co-authored-by: Chris <66376200+crickman@users.noreply.github.com>
  Co-authored-by: Eduard van Valkenburg <eavanvalkenburg@users.noreply.github.com>
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  Co-authored-by: Rishabh Chawla <rishabhchawla1995@gmail.com>
  Co-authored-by: Peter Ibekwe <109177538+peibekwe@users.noreply.github.com>
  Co-authored-by: Dmytro Struk <13853051+dmytrostruk@users.noreply.github.com>
  Co-authored-by: Ben Thomas <ben.thomas@microsoft.com>
  Co-authored-by: alliscode <bentho@microsoft.com>
  Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>
  Co-authored-by: Evan Mattson <35585003+moonbox3@users.noreply.github.com>

  westey · 2026-03-05 14:14:33 +00:00
  3fb90a501a
• .NET: Add foundry extension samples for python and dotnet (#4359)

  * Add foundry extension samples for python and dotnet
  
  * Align foundry extension samples with existing hosted agent patterns
  
  - Fix Python multiagent indentation bug (from_agent_framework ran in both modes)
  - Remove hardcoded personal endpoint from appsettings.Development.json
  - Rename .NET folders/projects to PascalCase (FoundryMultiAgent, FoundrySingleAgent)
  - Upgrade .NET multiagent from net9.0 to net10.0
  - Add ManagePackageVersionsCentrally=false and analyzer blocks to .csproj files
  - Replace wildcard package versions with fixed versions
  - Use alpine Docker images and standard build pattern
  - Align agent.yaml structure (template nesting, displayName, resources, authors)
  - Convert .NET multiagent from namespace/class to top-level statements
  - Add run-requests.http for multiagent sample
  - Fix Python requirements.txt (remove dev deps, add agent-framework)
  - Add proper copyright headers
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Align foundry samples: fix builds, upgrade AgentServer to beta.8
  
  - Fix TargetFrameworks (plural) to override inherited net472 from Directory.Build.props
  - Upgrade Azure.AI.AgentServer.AgentFramework to 1.0.0-beta.8 (latest)
  - Bump OpenTelemetry packages to 1.12.0 (required by beta.8)
  - Fix Roslynator/format errors (imports ordering, BOM, sealed record, target-typed new)
  - Verified with docker dotnet format (matching CI pipeline)
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Refactor hosted samples to use AIProjectClient.CreateAIAgentAsync
  
  Replace PersistentAgentsClient and manual AzureOpenAIClient setup with
  AIProjectClient.CreateAIAgentAsync() from Microsoft.Agents.AI.AzureAI.
  
  - FoundryMultiAgent: Remove Azure.AI.Agents.Persistent, use CreateAIAgentAsync
    for Writer and Reviewer agents with cleanup in finally block
  - FoundrySingleAgent: Remove manual GetConnection/AzureOpenAIClient chain,
    use CreateAIAgentAsync with hotel search tool
  - Update csproj: add Microsoft.Agents.AI.AzureAI, remove unused packages
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Update READMEs to reflect AIProjectClient.CreateAIAgentAsync usage
  
  - Reference Microsoft.Agents.AI.AzureAI and Microsoft.Agents.AI.Workflows packages
  - Add Azure AI Developer role requirement for agents/write data action
  - Replace PersistentAgentsClient references
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Add HostedAgents READMEs and Foundry samples to solution
  
  - Create dotnet/samples/05-end-to-end/HostedAgents/README.md with sample index
  - Create python/samples/05-end-to-end/hosted_agents/README.md with sample index
  - Add FoundryMultiAgent and FoundrySingleAgent to agent-framework-dotnet.slnx
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix Python linting: reorder imports before load_dotenv, remove trailing whitespace
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Update uv.lock to match latest package versions
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix trailing whitespace in foundry_single_agent agent.yaml
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Exclude dotnet.microsoft.com from link checker
  
  This domain intermittently times out in CI, causing flaky markdown
  link check failures unrelated to PR changes.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Align env vars to AZURE_AI_PROJECT_ENDPOINT and default model to gpt-4o-mini
  
  Addresses PR review feedback:
  - Rename PROJECT_ENDPOINT to AZURE_AI_PROJECT_ENDPOINT across all
    Foundry samples (dotnet + python) to match existing samples
  - Change default model from gpt-4.1-mini to gpt-4o-mini consistently
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Skip flaky test CreatesWorkflowEndToEndActivities_WithCorrectName_DefaultAsync
  
  Tracked in #4398
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Remove Python foundry samples from PR scope
  
  Python hosted agent samples need further alignment with the azure-ai
  package conventions. Removing from this PR to ship .NET samples first.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Narrow linkspector exclusion to dotnet.microsoft.com/download only
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: Leo Yao <leoyao@Leos-MacBook-Pro.local>
  Co-authored-by: Roger Barreto <19890735+rogerbarreto@users.noreply.github.com>
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Leo Yao · 2026-03-05 11:43:24 +00:00
  56bba795cb
• .NET: Skip flacky UT + (Attempt) Merge Gatekeeper fix (#4456)

  * Skip flacky UT
  
  * Ignore org-level GitHub App checks in merge-gatekeeper
  
  Add Cleanup artifacts, Agent, Prepare, and Upload results to the
  ignored list. These are check runs created by an org-level GitHub App
  (MSDO), not by any workflow in this repo, and their transient failures
  should not block merges.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Roger Barreto · 2026-03-04 14:39:54 +00:00
  e8a7ffbc14
• .NET: Update Azure.AI.Projects 2.0.0-beta.1 (#4270)

  * Update Microsoft.Agents.AI.AzureAI for Azure.AI.Projects SDK 2.0.0
  
  - Bump Azure.AI.Projects to 2.0.0-alpha.20260213.1
  - Bump Azure.AI.Projects.OpenAI to 2.0.0-alpha.20260213.1
  - Bump System.ClientModel to 1.9.0 (transitive dependency)
  - Switch both GetAgent and CreateAgentVersion to protocol methods
    with MEAI user-agent policy injection via RequestOptions
  - Migrate 29 CREATE-path tests from FakeAgentClient to HttpHandlerAssert
    pattern for real HTTP pipeline testing
  - Fix StructuredOutputDefinition constructor (BinaryData -> IDictionary)
  - Fix responses endpoint path (openai/responses -> /responses)
  - Add local-packages NuGet source for pre-release nupkgs
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Update Azure.AI.Projects to 2.0.0-beta.1 from NuGet.org
  
  - Update Azure.AI.Projects and Azure.AI.Projects.OpenAI to 2.0.0-beta.1
  - Remove local-packages NuGet source (packages now on nuget.org)
  - Fix MemorySearchTool -> MemorySearchPreviewTool rename
  - Fix RedTeams.CreateAsync ambiguous call
  - Fix CreateAgentVersion/Async signature change (BinaryData -> string)
  - Suppress AAIP001 experimental warning for WorkflowAgentDefinition
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Move s_modelWriterOptionsWire field before methods that use it
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix flaky test: prevent spurious workflow_invoke Activity on timeout wake-up
  
  The StreamingRunEventStream run loop uses a 1-second timeout on
  WaitForInputAsync. When the timeout fires before the consumer calls
  StopAsync, the loop would create a spurious workflow_invoke Activity
  even though no actual input was provided. This caused the
  WorkflowRunActivity_IsStopped_Streaming_OffThread_MultiTurnAsync test
  to intermittently fail (expecting 2 activities but finding 3).
  
  Fix: guard the loop body with a HasUnprocessedMessages check. On
  timeout wake-ups with no work, the loop waits again without creating
  an activity or changing the run status.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix epoch race condition causing unit tests to hang on net10.0 and net472
  
  The HasUnprocessedMessages guard (previous commit) correctly prevents
  spurious workflow_invoke Activity creation on timeout wake-ups, but
  exposed a latent race in the epoch-based signal filtering.
  
  The race: when the run loop processes messages quickly and calls
  Interlocked.Increment(ref _completionEpoch) before the consumer calls
  TakeEventStreamAsync, the consumer reads the already-incremented epoch
  and sets myEpoch = epoch + 1. This causes the consumer to skip the
  valid InternalHaltSignal (its epoch < myEpoch) and block forever
  waiting for a signal that will never arrive (since the guard prevents
  spurious signal generation).
  
  Fix: read _completionEpoch without +1. The +1 was originally needed to
  filter stale signals from timeout-driven spurious loop iterations, but
  those no longer exist thanks to the HasUnprocessedMessages guard.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Revert "Fix epoch race condition causing unit tests to hang on net10.0 and net472"
  
  This reverts commit 6ce7f01be8.
  
  * Revert "Fix flaky test: prevent spurious workflow_invoke Activity on timeout wake-up"
  
  This reverts commit 98963e17f2.
  
  * Skip hanging multi-turn declarative integration tests
  
  The ValidateMultiTurnAsync tests (ConfirmInput.yaml, RequestExternalInput.yaml)
  hang indefinitely in CI, blocking the merge queue. The hang is SDK-independent
  (reproduces with both Azure.AI.Projects 1.2.0-beta.5 and 2.0.0-beta.1) and
  is a pre-existing issue in the declarative workflow multi-turn test logic.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Remove unused using directive in IntegrationTest.cs
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Restore Azure.AI.Projects 2.0.0-beta.1 version bump
  
  The merge from main accidentally reverted the package versions back to
  1.2.0-beta.5. This is the primary change of this PR.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Address merge conflict
  
  * Skip flaky WorkflowRunActivity_IsStopped_Streaming_OffThread_MultiTurnAsync test
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Skip CheckSystem test cases temporarily
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Roger Barreto · 2026-03-04 11:36:39 +00:00
  e7961571a8
• .NET: Skip OffThread observability test (#4399)

  * Skip flaky OffThread observability test
  
  Temporarily skip CreatesWorkflowEndToEndActivities_WithCorrectName_OffThreadAsync
  due to intermittent failures. Tracked in #4398.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Update dotnet/tests/Microsoft.Agents.AI.Workflows.UnitTests/ObservabilityTests.cs
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

  Roger Barreto · 2026-03-02 19:30:32 +00:00
  3b4eed270f
• Add Name and Description support for GroupChat workflow builder (#4334)
  Peter Ibekwe · 2026-03-02 19:29:32 +00:00
  d932947ba5
• .NET: Fixing issue with invalid node Ids when visualizing dotnet workflows. (#4269)

  * Fix Mermaid rendering errors in WorkflowVisualizer.ToMermaidString
  
  Fix two bugs in the Mermaid diagram output:
  
  1. Use safe node aliases (node_0, node_1, ...) instead of raw executor IDs
     as Mermaid node identifiers. Raw IDs containing spaces, dots, or
     non-ASCII characters (e.g. Japanese) caused Mermaid parse errors.
  
  2. Fix conditional edge arrow syntax from '.--> ' (invalid) to '.-> '
     (valid Mermaid dotted arrow syntax).
  
  Fixes #1406
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Use recognizable sanitized IDs for Mermaid node identifiers\n\nReplace generic node_0/node_1 aliases with IDs derived from the original\nexecutor names. ASCII letters, digits, and underscores are preserved;\nother characters become underscores (collapsed, trimmed). Leading digits\nget an n_ prefix. Collisions are resolved with a numeric suffix.\n\nThis keeps node IDs readable in the Mermaid source while the display\nlabels continue to show the full original names."
  
  * Remove issue number references from test names and comments"
  
  * Address PR review feedback from Copilot\n\n- Add Throw.IfNull(id) guard to SanitizeMermaidNodeId\n- Add safety limit (10,000) to collision resolution loop\n- Restore missing edge assertions (middle1/middle2 --> end)\n- Fix comment to show actual sanitized ID (n_1_User_input)\n- Use stricter regex in Unicode test (must start with letter/underscore)"
  
  * Address second round of PR review feedback\n\n- Escape node display labels via EscapeMermaidLabel to handle quotes,\n  brackets, and newlines in executor IDs\n- Fix XML doc on SanitizeMermaidNodeId to accurately describe that\n  existing consecutive underscores in input are preserved\n- Restore specific edge assertion (mid --> end) in conditional edge test\n- Restore fan-in routing assertions (s1/s2 through intermediate node,\n  no direct edges to t) in fan-in test"
  
  ---------
  
  Co-authored-by: alliscode <bentho@microsoft.com>
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Ben Thomas · 2026-03-02 16:26:14 +00:00
  db48f8ce09
• .NET: Fixing issue where OpenTelemetry span is never exported in .NET in-process workflow execution (#4196)

  * 1. Add reproduction test for issue #4155: workflow.run Activity never stopped in streaming OffThread path
  
  The WorkflowRunActivity_IsStopped_Streaming_OffThread test demonstrates that
  the workflow.run OpenTelemetry Activity created in StreamingRunEventStream.RunLoopAsync
  is started but never stopped when using the OffThread/Default streaming execution.
  The background run loop keeps running after event consumption completes, so the
  using Activity? declaration never disposes until explicit StopAsync() is called.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  2. Fix workflow.run Activity never stopped in streaming OffThread execution (#4155)
  
  The workflow.run OpenTelemetry Activity in StreamingRunEventStream.RunLoopAsync
  was scoped to the method lifetime via 'using'. Since the run loop only exits on
  cancellation, the Activity was never stopped/exported until explicit disposal.
  
  Fix: Remove 'using' and explicitly dispose the Activity when the workflow reaches
  Idle status (all supersteps complete). A safety-net disposal in the finally block
  handles cancellation and error paths.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Add root-level workflow.session activity spanning run loop lifetime\n\nImplements two-level telemetry hierarchy per PR feedback from lokitoth:\n- workflow.session: spans the entire run loop / stream lifetime\n- workflow_invoke: per input-to-halt cycle, nested within the session\n\nThis ensures the session activity stays open across multiple turns,\nwhile individual run activities are created and disposed per cycle.\n\nAlso fixes linkedSource CancellationTokenSource disposal leak in\nStreamingRunEventStream (added using declaration)."
  
  * Address Copilot review: fix Activity/CTS disposal, rename activity, add error tag\n\n1. LockstepRunEventStream: Remove 'using' from Activity in async iterator\n   and manually dispose in finally block (fixes #4155 pattern). Also dispose\n   linkedSource CTS in finally to prevent leak.\n2. Tags.cs: Add ErrorMessage (\"error.message\") tag for runtime errors,\n   distinct from BuildErrorMessage (\"build.error.message\").\n3. ActivityNames: Rename WorkflowRun from \"workflow_invoke\" to \"workflow.run\"\n   for cross-language consistency.\n4. WorkflowTelemetryContext: Fix XML doc to say \"outer/parent span\" instead\n   of \"root-level span\".\n5. ObservabilityTests: Assert WorkflowSession absence when DisableWorkflowRun\n   is true.\n6. WorkflowRunActivityStopTests: Fix streaming test race by disposing\n   StreamingRun before asserting activities are stopped.\n7. StreamingRunEventStream/LockstepRunEventStream: Use Tags.ErrorMessage\n   instead of Tags.BuildErrorMessage for runtime error events."
  
  * Review fixes: revert workflow_invoke rename, use 'using' for linkedSource, move SessionStarted earlier\n\n- Revert ActivityNames.WorkflowRun back to \"workflow_invoke\" (OTEL semantic convention contract)\n- Use 'using' declaration for linkedSource CTS in LockstepRunEventStream (no timing sensitivity)\n- Move SessionStarted event before WaitForInputAsync in StreamingRunEventStream to match Lockstep behavior"
  
  * Improve naming and comments in WorkflowRunActivityStopTests"
  
  * Prevent session Activity.Current leak in lockstep mode, add nesting test
  
  Save and restore Activity.Current in LockstepRunEventStream.Start() so the
  session activity doesn't leak into caller code via AsyncLocal. Re-establish
  Activity.Current = sessionActivity before creating the run activity in
  TakeEventStreamAsync to preserve parent-child nesting.
  
  Add test verifying app activities after RunAsync are not parented under the
  session, and that the workflow_invoke activity nests under the session."
  
  * Fix stale XML doc: WorkflowRun -> WorkflowInvoke in ObservabilityTests
  
  ---------
  
  Co-authored-by: alliscode <bentho@microsoft.com>
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Ben Thomas · 2026-02-25 19:42:45 +00:00
  425f27f989
• .NET: [BREAKING] Workflows API Review Naming Changes (Part 1?) (#4090)

  * refactor: Normalize Run/RunStreaming with AIAgent
  
  * refactor: Clarify Session vs. Run -level concepts
  
  * Rename RunId to SessionId to better match Run/Session terminology in AIAgent
  * [BREAKING]: Will break existing checkpointed sessions in CosmosDb due to field rename
  
  * refactor: Rename and simplify interface around getting typed data out of ExternalRequest/Response
  
  * Also adds hints around using value types in PortableValue
  
  * refactor: Rename AddFanInEdge to AddFanInBarrierEdge
  
  This will prevent a breaking change later when we introduce a programmable FanIn edge, analogous to the FanOut edge's EdgeSelector.
  
  The goal, in the long run is to support a number of different FanIn scenarios, with naive FanIn (no barrier) by default, similar to FanOut.
  
  * refactor: AsAgent(this Workflow, ...) => AsAIAgent(...)
  
  * misc - part1: SwitchBuilder internal
  
  ---------
  
  Co-authored-by: Dmytro Struk <13853051+dmytrostruk@users.noreply.github.com>

  Jacob Alber · 2026-02-20 02:05:18 +00:00
  0086d38f58
• .NET: Remove FunctionCalls and Tool Messages from Handoff passed messages (#3811)

  * Fix handoff orchestration not passing user message to handoff target agent (#3161)
  
  Filter out internal handoff function call and tool result messages before
  passing conversation history to the target agent's LLM. These messages
  confused the model into ignoring the original user question.
  
  * Add handoff tool call filtering behavior and enhance workflow builder
  
  - Introduced HandoffToolCallFilteringBehavior enum to specify filtering behavior for tool call contents in handoff workflows.
  - Updated HandoffsWorkflowBuilder to support customizable handoff instructions and tool call filtering behavior.
  - Enhanced HandoffAgentExecutor to utilize new filtering options for improved message handling during agent handoffs.
  
  * Enhance handoff message filtering logic and add unit tests for filtering behaviors
  
  * Refactor HandoffMessagesFilter to remove unused handoff function names and enhance filtering logic for non-handoff function calls
  
  * Refactor HandoffMessagesFilter to streamline FilterCandidateState initialization and improve clarity
  
  * Refactor HandoffMessagesFilter to improve filtering logic and add integration tests for handoff workflows
  
  * fix: HandoffAgentExecutor tests

  Jacob Alber · 2026-02-19 19:55:12 +00:00
  2cb4137501
• [BREAKING] .NET: Decouple Checkpointing from Run/StreamAsync APIs (#4037)

  * [BREAKING] refactor: Decouple Checkpointing and Execution APIs
  
  With this change, Checkpointing becomes an property of an IWorkflowExecutionEnvironment. This lets environments that are tightly-coupled to their CheckpointManager avoid needing to present APIs that would not work (e.g. taking in an InMemory CheckpointManager for Durable Tasks, for example)
  
  * refactor: Normalize IsCheckpointingEnabled naming

  Jacob Alber · 2026-02-19 16:41:35 +00:00
  c73bd87503
• Fix CheckpointInfo.Parent always null in InProcessRunner (#3796) (#3812)

  Track the last CheckpointInfo in InProcessRunner so that newly created
  checkpoints reference their parent. When resuming from a checkpoint,
  the resumed-from checkpoint becomes the parent of the next checkpoint.
  
  Adds tests verifying:
  - First checkpoint has null parent
  - Subsequent checkpoints chain parents correctly
  - Checkpoint after resume references the resumed-from checkpoint

  Jacob Alber · 2026-02-19 14:34:58 +00:00
  3507b2c532
• .NET: [BREAKING] Implement Polymorphic Routing (#3792)

  * feat: Implement Polymorphic Routing
  
  * feat: Add support for Send/Yield annotations with basic Executor
  
  * Adds annotations to Declarative workflow executors
  
  * fix: Address PR Comments
  
  * Implicit filter in collection loops
  * Remove debug / usused / superfluous code
  * Fix ProtocolBuilder implicit output registrations
  * Fix logic error in ExecuteRouteGeneratorTests.ClassWithManualConfigureProtocol_DoesNotGenerate
  
  * fix: Solidify type checks and send/yield type registrations
  
  * fix: Suppress generation of TurnTokens out of AggregateTurnMessagesExecutor
  
  * Fixes an issue where ConcurrentEndExecutor is not expecting TurnTokens.
  
  * fix: Add ProtocolBuilder support for chained-delegation
  
  * Updates Declarative pacakge to rely on chained-delegation Send/Yield registration
  * Renames DeclarativeActionExectuor's new ExecuteAsync to ExecuteActionAsync to avoid colliding with Executor.ExecutoeAsync
  
  * fix: Address PR Comments
  
  * Fixes type mapping in FanInEdgeRunner
  * Fixes and expalins send/yield type registration in FunctionExecutor
  
  * fixup: build-break
  
  * fix: Add missing SendsMesage declaration to InvokeAzureAgentExecutor

  Jacob Alber · 2026-02-19 14:09:03 +00:00
  6a3d22598f
• .NET: BREAKING: Unify AgentResponse[Update] events as WorkflowOutputEvents (#3441)

  * Rename WorkflowOutputEvent.SourceId to ExecutorId for Python consistency
  
  - Rename SourceId property to ExecutorId in WorkflowOutputEvent
  - Add [Obsolete] SourceId property for backward compatibility
  - Update all test usages to use ExecutorId
  
  Resolves part of #2938
  
  * Unify AgentResponse events with WorkflowOutputEvent (#2938)
  
  - Change AgentResponseEvent and AgentResponseUpdateEvent to inherit from
    WorkflowOutputEvent instead of ExecutorEvent
  - Update AIAgentHostExecutor and HandoffAgentExecutor to use YieldOutputAsync()
    instead of AddEventAsync() for agent outputs
  - Add special-casing in InProcessRunnerContext.YieldOutputAsync() to create
    specific event types for AgentResponse and AgentResponseUpdate, bypassing
    OutputFilter for backwards compatibility
  - Update TestRunContext and TestWorkflowContext with same special-casing
  - Add regression tests in AgentEventsTests
  
  * refactor: Seal AgentResponse events

  Jacob Alber · 2026-02-18 18:55:26 +00:00
  6a39d5a652
• .NET: Improve session cast error message quality and consistency (#3973)

  * Improve session cast error messge consistency
  
  * Update changelog

  westey · 2026-02-17 15:51:30 +00:00
  08275f657b
• .NET: [BREAKING] Add session StateBag for state storage and support multiple providers on the Agent (#3806)

  * .NET: [BREAKING] Add session statebag to use for state storage instead of inside providers (#3737)
  
  * Add a StateBag to AgentSession and pass Agent and AgentSession to AIContextProvider and ChatHistoryProviders
  
  * Convert all AIContextProviders to use the statebag
  
  * Update InMemoryChatHistoryProvider to use StateBag
  
  * Update Comsos and Workflow ChatHistoryProviders
  
  * Update 3rd party chat history storage sample.
  
  * Remove serialize method from providers
  
  * Replacing provider factories with properties
  
  * Remove Providers from Session and flatten state bag serialization
  
  * Update samples to use getservice on agent
  
  * Updated additional session types to serialize statebag
  
  * Fix regression
  
  * Address PR comments
  
  * Address PR comments.
  
  * Fix formatting
  
  * Fix unit tests
  
  * Remove InMemoryAgentSession since it is not required anymore.
  
  * Address PR comments
  
  * Convert sessions for A2AAgent, ChatClientAgent, CopilotStudioAgent and GithubCopilotAgent to use regular json serialization.
  
  * Fix durable agent session jso usgae
  
  * Add jso to InMemory and Workflow ChatHistoryProviders
  
  * Update InMemoryChatHistoryProvider to use an options class for it's many optional settings.
  
  * Apply suggestions from code review
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Address PR feedback
  
  * Fix verification bug.
  
  * Improve state bag thread safety
  
  * Address PR comments and fix unit tests
  
  * Address PR comments
  
  * Fix unit test
  
  ---------
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Add a public StateKey property to providers (#3810)
  
  * .NET: [BREAKING] Update providers in such a way that they can participate in a pipeline (#3846)
  
  * Make providers pipeline capable
  
  * Fix unit tests
  
  * Move source stamping to providers from base class
  
  * Also update samples.
  
  * Address PR comments
  
  * Rename AsAgentRequestMessageSourcedMessage to WithAgentRequestMessageSource
  
  * .NET: [BREAKING] Add consistent message filtering to all providers. (#3851)
  
  * Add consistent message filtering to all providers.
  
  * Remove old chat history filtering classes
  
  * Fix merge issues
  
  * Fix unit test
  
  * Enforce non-nullable property
  
  * Fix merging bug and make troubleshooting source info easier by adding tostring implementation
  
  * .NET: [BREAKING] Add support for multiple AIContextProviders on a ChatClientAgent (#3863)
  
  * Add support for multiple AIContextProviders on a ChatClientAgent
  
  * Address PR comments and fix tests
  
  * Address PR comments.
  
  * .NET: [BREAKING]Delay AIContext Materialization until the end of the pipeline is reached. (#3883)
  
  * Delay AIContext Materialization until the end of the pipeline is reached.
  
  * Address PR comments.
  
  * Address PR comments
  
  * Modify InvokedContext to be immutable (#3888)
  
  * .NET: Address Feedback on StateBag feature branch PR (#3910)
  
  * Address Feedback on statebag feature branch PR
  
  * Update dotnet/src/Microsoft.Agents.AI.DurableTask/CHANGELOG.md
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Address PR comments
  
  ---------
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

  westey · 2026-02-13 14:08:07 +00:00
  3168eb4870
• .NET: [BREAKING] Change SerializeSession to be Async (#3879)

  * Change SerializeSession to be Async
  
  * Update Changelog

  westey · 2026-02-12 11:56:42 +00:00
  6a88c7b1a1
• .NET: Fix: Checkpoint Deserialization breaks when JSON metadata properties are out of order (#3442)

  * Fix checkpoint JSON deserialization with out-of-order metadata properties (#2962)
  
  * Simplify: propagate AllowOutOfOrderMetadataProperties from incoming JsonSerializerOptions

  Jacob Alber · 2026-02-10 15:50:57 +00:00
  e489ac0fa3
• .NET: Workflow telemetry opt in (#3467)

  * feat(workflows): Make telemetry opt-in via WithOpenTelemetry()
  
  - Add WorkflowTelemetryOptions class with EnableSensitiveData property
  - Add WorkflowTelemetryContext to manage ActivitySource lifecycle
  - Add WithOpenTelemetry() extension method on WorkflowBuilder
  - Update all workflow components to use telemetry context:
    - WorkflowBuilder, Workflow, Executor
    - InProcessRunnerContext, InProcessRunner
    - LockstepRunEventStream, StreamingRunEventStream
    - All edge runners (Direct, FanIn, FanOut, Response)
  - Telemetry is now disabled by default
  - Users must call WithOpenTelemetry() to enable spans/activities
  
  BREAKING CHANGE: Workflow telemetry is now opt-in. Users who relied on
  automatic telemetry must add .WithOpenTelemetry() to their workflow builder.
  
  * refactor: Pass telemetry context as parameter instead of via interface
  
  - Remove IWorkflowContextWithTelemetry interface
  - Add internal ExecuteAsync overload that accepts WorkflowTelemetryContext
  - Public ExecuteAsync delegates with WorkflowTelemetryContext.Disabled
  - InProcessRunner passes TelemetryContext when calling ExecuteAsync
  - BoundContext now implements IWorkflowContext (not the removed interface)
  
  * Add optional ActivitySource parameter to WithOpenTelemetry
  
  Allow users to provide their own ActivitySource when enabling telemetry,
  giving them better control over the ActivitySource lifecycle. When not
  provided, the framework creates one internally (existing behavior).
  
  Changes:
  - Add optional activitySource parameter to WithOpenTelemetry() extension
  - Update WorkflowTelemetryContext to accept external ActivitySource
  - Add unit test for user-provided ActivitySource scenario
  
  * Add component-level telemetry control with disable flags
  
  Allow users to selectively disable specific activity types via
  WorkflowTelemetryOptions. All activities are enabled by default.
  
  New disable flags:
  - DisableWorkflowBuild: Disables workflow.build activities
  - DisableWorkflowRun: Disables workflow_invoke activities
  - DisableExecutorProcess: Disables executor.process activities
  - DisableEdgeGroupProcess: Disables edge_group.process activities
  - DisableMessageSend: Disables message.send activities
  
  Added helper methods to WorkflowTelemetryContext for each activity type
  and updated all activity creation sites to use them.
  
  * Implement EnableSensitiveData to log executor input/output
  
  When EnableSensitiveData is true in WorkflowTelemetryOptions, executor
  input and output are logged as JSON-serialized attributes in the
  executor.process activity.
  
  New activity tags:
  - executor.input: JSON serialized input message
  - executor.output: JSON serialized output result (non-void only)
  
  Added suppression attributes for AOT/trimming warnings since this is
  an opt-in feature for debugging/diagnostics.
  
  * Refactor activity start methods to centralize tagging logic
  
  Move tagging logic into WorkflowTelemetryContext methods:
  - StartExecutorProcessActivity now accepts executorId, executorType,
    messageType, and message; sets all tags including executor.input
    when EnableSensitiveData is true
  - Added SetExecutorOutput method to set executor.output after execution
  - StartMessageSendActivity now accepts sourceId, targetId, and message;
    sets all tags including message.content when EnableSensitiveData is true
  
  Simplified Executor.cs and InProcessRunnerContext.cs by removing
  inline tagging code. Added message.content tag constant.
  
  * Revert Python changes
  
  * Update samples and code cleanup
  
  * Fix file formatting
  
  * Add comment
  
  * Add telemetry configuration to declarative workflow
  
  * Remove delays in tests
  
  * Address comments

  Tao Chen · 2026-02-09 23:10:50 +00:00
  e3b4b6662b
• .NET: Introduce Core implementation methods for session methods on AIAgent (#3699)

  * Introduce Core implementation methods for session methods on AIAgent
  
  * Update changelog

  westey · 2026-02-06 13:25:20 +00:00
  ac17adb595
• [BREAKING] Obsoleting ReflectingExecutor in favor of source gen (#3380)

  * Initial working version with tests.
  
  * Updates to validate class data once instead of for each handler method. Also updated Diagnostics Ids to format of MAFGENWF{NUM}
  
  * Formatting and trying to fix generation project pack.
  
  * Another atempt at getting the genrators project to build.
  
  * More attempts to fix generator build and pack.
  
  * Fixing file encodings.
  
  * Initail round of cleanup.
  
  * Trying to fix packing.
  
  * Still trying to fix pipeline pack.
  
  * Remove obsolescence markers, sample updates, and docs from generator branch.
  
  This commit separates the generator core functionality from the
  deprecation of ReflectingExecutor. The removed changes will be
  re-added in a dependent branch (wf-obsolete-reflector).
  
  🤖 Generated with [Claude Code](https://claude.com/claude-code)
  
  Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
  
  * Mark ReflectingExecutor and IMessageHandler as obsolete.
  
  This commit deprecates the reflection-based handler discovery approach
  in favor of the new [MessageHandler] attribute with source generation.
  
  Changes:
  - Add [Obsolete] to ReflectingExecutor<T>, IMessageHandler<T>, IMessageHandler<T,R>
  - Add #pragma to suppress warnings in internal reflection code
  - Update Concurrent sample to use new [MessageHandler] pattern
  - Add Directory.Build.props for samples to include generator
  - Add documentation files explaining the migration
  
  🤖 Generated with [Claude Code](https://claude.com/claude-code)
  
  Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
  
  * Obsoleteing Reflector-based workflow code generation in favor of Source Generators and updating some samples to use new pattern.
  
  This commit deprecates the reflection-based handler discovery approach
  in favor of the new [MessageHandler] attribute with source generation.
  
  Changes:
  - Add [Obsolete] to ReflectingExecutor<T>, IMessageHandler<T>, IMessageHandler<T,R>
  - Add #pragma to suppress warnings in internal reflection code
  - Update Concurrent sample to use new [MessageHandler] pattern
  - Add Directory.Build.props for samples to include generator
  - Add documentation files explaining the migration
  
  🤖 Generated with [Claude Code](https://claude.com/claude-code)
  
  Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
  
  * Cleaning up temporary design and progress files.
  
  ---------
  
  Co-authored-by: alliscode <bentho@microsoft.com>
  Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
  Co-authored-by: Chris <66376200+crickman@users.noreply.github.com>

  Ben Thomas · 2026-02-04 20:07:43 +00:00
  907654a489
• .NET: [BREAKING] Rename session state json param (#3681)

  * Rename session state json param to ensure consistency
  
  * Fix merge failures and PR comments.

  westey · 2026-02-04 18:54:10 +00:00
  a2d1e69652
• .NET: [BREAKING] Move AgentSession.Serialize to AIAgent (#3650)

  * Move AgentSession.Serialize to AIAgent
  
  * Address PR comments.
  
  * Improve code and fix unit test
  
  * Update test agents to return a default json element instead of throwing where the the result of the serialization is never used.
  
  * Update further tests to actually serialize the session

  westey · 2026-02-04 15:52:15 +00:00
  6255abd687
• .NET: [BREAKING] Rename GetNewSession to CreateSession (#3501)

  * Rename GetNewSession to CreateSession
  
  * Address copilot feedback
  
  * Suppress warning
  
  * Suppress warning
  
  * Fix further warnings.

  westey · 2026-02-03 11:33:50 +00:00
  6fdf6111e6
• .NET: Add tests for subworkflow shared state behavior (#3444)

  Adds tests documenting current shared state behavior in subworkflows:
  
  - State works correctly within a subworkflow
  
  - State is isolated across parent/subworkflow boundaries
  
  Related to #2419

  Jacob Alber · 2026-01-27 21:45:27 +00:00
  4245561013
• fix: FileSystemJsonCheckpointStore does not flush to disk on Checkpoint creation (#3439)
  Jacob Alber · 2026-01-27 19:53:40 +00:00
  5ef12a2341
• .NET: [BREAKING] Rename AgentThread to AgentSession (#3430)

  * Rename AgentThread to AgentSession
  
  * Add more renames
  
  * Update readme files
  
  * Revert nullable variable change and further fixes.
  
  * Revert change in header name
  
  * Fix some comments and tests
  
  * Update changelog.
  
  * Address PR feedback.
  
  * Fixing code review comments.
  
  * Fix new errors after merging latest code.

  westey · 2026-01-26 16:30:25 +00:00
  a3a9147e61
• .NET: [BREAKING] feat: Improve Agent hosting inside Workflows (#3142)

  * refactor: Rename AggregateTurnMessagesExecutor
  
  * feat: Rework Agent Hosting for Configurability and HIL support
  
  * Adds support for selecting whether updates and/or full responses are
    emitted to events
  * Adds support for HIL/FunctionCalls (including interception)
  * Implements internal support for ExternalRequests from any executor
    (not just RequestPort)
  
  * test: Add tests for new AIAgentHostExecutor functionality
  
  * feat: Unify non-Handoff Agent Hosting
  
  * doc: More explicit documentation for `overwrite` in RouteBuilder

  Jacob Alber · 2026-01-23 19:45:29 +00:00
  6e8c7c42c8
• .NET: Rename ChatMessageStore to ChatHistoryProvider (#3375)

  * Rename ChatMessageStore to ChatHistoryProvider
  
  * Fix merge issue
  
  * Fixed PR comments
  
  * Fix tests after property rename
  
  * Add unit tests and fix merge issues
  
  * Fix encoding

  westey · 2026-01-23 15:49:01 +00:00
  21e00c054b
• fix: Subworkflows do not work well with HostAsAgent (#3240)

  Subworkflows run into issues with Checkpointing and the Chat Protocol:
  
  * The concurrency rework made subtle changes in behaviour that introduced a hang when using subworkflows with ChatProtocol and streaming execution.
  * The ResetAsync() implementation in WorkflowHostExecutor was improperly resetting the joinContext - this was happening on restore checkpoint _after_ the join context was attached when
  * Subworkflows cannot be used as the start node when hosted AsAgent due to inability to treat Catch-All as a Chat Protocol
  * Subworkflow ownership issue when used in non-concurrent mode after finishing a run
  
  Also fixes:
  * When ChatMessages are output by executors that are not agents, there is no corresponding AgentResponseUpdate/AgentResponse event
  
  Breaking Changes
  * [BREAKING CHANGE] It is possible to provide the wrong RunId when resuming from CheckpointInfo (even though the data already exists on CheckpointInfo)

  Jacob Alber · 2026-01-22 16:01:47 +00:00
  4940d0ef36
• .NET: [Breaking] Rename AgentRunResponseEvent and AgentRunUpdateEvent classes (#3214)

  * rename AgentRunResponseEvent and AgentRunUpdateEvent classes
  
  * rollback unnecessary changes

  SergeyMenshykh · 2026-01-14 17:44:35 +00:00
  f56808b279
• .NET: [Breaking] RenameAgentRunResponse and AgentRunResponseUpdate classes (#3197)

  * rename AgentRunResponse and AgentRunResponseUpdate classes - part1
  
  * rename varialbles, parameters, methods and tests
  
  * rollback unnecessary changes

  SergeyMenshykh · 2026-01-14 10:27:41 +00:00
  c70e594e6c
• .NET: [BREAKING] Change GetNewThread and DeserializeThread to async (#3152)

  * Change GetNewThread and DeserializeThread plus ChatMessageStore and AIContextProvider Factories to async
  
  * Merge fixes

  westey · 2026-01-12 11:25:51 +00:00
  bb6ecd9c71
• .NET: fix: Expose WorkflowErrorEvent as ErrorContent (#2762)

  * fix: Expose WorkflowErrorEvent as ErrorContent
  
  When hosted using .AsAgent(), Workflows were not exposing inner errors coming as Exceptions (through the WorkflowErrorEvent)
  
  The fix is to convert their message to an ErrorContent on the way out, rather than rely on the default "empty update" to collect the raw event.
  
  * feat: Add a way to show/suppress exception information

  Jacob Alber · 2026-01-08 17:34:05 +00:00
  99fac4ca56
• .NET: [Breaking] Introduce RunCoreAsync/RunCoreStreamingAsync delegation pattern in AIAgent (#2749)

  * Initial plan
  
  * Refactor AIAgent: Make RunAsync and RunStreamingAsync non-abstract, add RunCoreAsync and RunCoreStreamingAsync
  
  Co-authored-by: SergeyMenshykh <68852919+SergeyMenshykh@users.noreply.github.com>
  
  * Fix infinite recursion in test implementations
  
  Co-authored-by: SergeyMenshykh <68852919+SergeyMenshykh@users.noreply.github.com>
  
  * Make RunAsync and RunStreamingAsync non-virtual as requested
  
  Co-authored-by: SergeyMenshykh <68852919+SergeyMenshykh@users.noreply.github.com>
  
  * Fix DelegatingAIAgent subclasses to use RunCoreAsync/RunCoreStreamingAsync
  
  Co-authored-by: SergeyMenshykh <68852919+SergeyMenshykh@users.noreply.github.com>
  
  * Fix XML documentation references in AnonymousDelegatingAIAgent
  
  Co-authored-by: SergeyMenshykh <68852919+SergeyMenshykh@users.noreply.github.com>
  
  * Restore <see cref> tags with proper qualified signatures in AnonymousDelegatingAIAgent
  
  Co-authored-by: SergeyMenshykh <68852919+SergeyMenshykh@users.noreply.github.com>
  
  * Rollback unnecessary XML documentation changes in AnonymousDelegatingAIAgent
  
  Co-authored-by: SergeyMenshykh <68852919+SergeyMenshykh@users.noreply.github.com>
  
  * Remove pragma and update crefs to RunCoreAsync/RunCoreStreamingAsync
  
  Co-authored-by: SergeyMenshykh <68852919+SergeyMenshykh@users.noreply.github.com>
  
  * Fix EntityAgentWrapper to call base.RunCoreAsync/RunCoreStreamingAsync
  
  Co-authored-by: SergeyMenshykh <68852919+SergeyMenshykh@users.noreply.github.com>
  
  * fix compilation issues
  
  * fix compilatio issue
  
  * fix tests
  
  * fix unit tests
  
  * fix unit test
  
  ---------
  
  Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
  Co-authored-by: SergeyMenshykh <68852919+SergeyMenshykh@users.noreply.github.com>
  Co-authored-by: SergeyMenshykh <sergemenshikh@gmail.com>
  Co-authored-by: Chris <66376200+crickman@users.noreply.github.com>

  Copilot · 2025-12-30 12:24:09 +00:00
  8b4f7d5e29
• .NET: [Breaking] Delete display name property (#2758)

  * delete the AIAgent.DisplayName property
  
  * use agent name as a first value for activity display name
  
  * Update dotnet/src/Microsoft.Agents.AI.Workflows/Specialized/HandoffAgentExecutor.cs
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

  SergeyMenshykh · 2025-12-18 09:22:45 +00:00
  a71f768331
• .NET: adds support for labels in edges, fixes rendering of labels in dot a… (#1507)

  * adds support for labels in edges,  fixes rendering of labels in dot and mermaid, adds rendering of labels in edges
  
  * Update dotnet/src/Microsoft.Agents.AI.Workflows/Visualization/WorkflowVisualizer.cs
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * escaping edge labels, adding tests for labels containing strange characters that would break the diagram and enabling the previous signature so the API has backwards compatibility.
  
  * Unify label in EdgeData
  
  * Edge API adjustments, removed useless "sanitizer"
  
  * fixed test
  
  ---------
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  Co-authored-by: Jacob Alber <jaalber@microsoft.com>
  Co-authored-by: Chris <66376200+crickman@users.noreply.github.com>

  Jose Luis Latorre Millas · 2025-12-12 00:31:45 +00:00
  eb1117fff4
• .NET: [BREAKING] Prevent nulls in AIAgent property (#2719)

  * prevent nulls in AIAgent property
  
  * address feedback

  SergeyMenshykh · 2025-12-11 09:50:25 +00:00
  989b6ebe71
• Update analyzers for .NET 10 SDK (#2611)
  Stephen Toub · 2025-12-10 10:34:56 +00:00
  b01fd23cd2
• .NET: Change type of props representing continuation token (#2430)

  * change type of props representing continuation token
  
  * use explict cast instead of the as operator

  SergeyMenshykh · 2025-11-25 09:59:43 +00:00
  a89c15d6e6
• .NET: Upgrade to .NET 10 (#2128)

  * Upgrade to .NET 10
  
  - Require .NET 10 SDK
  - Include net10.0 assets in all assemblies
  - Move net9.0-only targets to net10.0
  - Update LangVersion to latest
  - Remove complicated distinctions between debug target TFMs and release target TFMs
  - Remove unnecessary package dependencies when built into netcoreapp
  - Clean up some ifdefs
  - Clean up some analyzer warnings
  
  * Fix CI

  Stephen Toub · 2025-11-22 04:14:15 +00:00
  dc2b109b50
• .NET: Add Microsoft.Agents.AI.AzureAI (Azure.AI.Project 1.2) Support (#1662)

  * WIP
  
  * Fixed build errors (#1638)
  
  Comment and nullable type alignment
  
  * .NET: Azure.AI.Agents Package Split + Initial Extensions (#1657)
  
  * Move packages
  
  * Update nuget.config
  
  * Address Xmldoc
  
  * Remove format from branches checks
  
  * Address Xmldocs
  
  * Add more details to the implementation
  
  * Moving Agent logic to ChatClient
  
  * Adding Name and Id overrides to AzureAIAgent
  
  * Updating extensions
  
  * Add GetAiAgent extensions
  
  * Adding support for version as name can conflict 409 using the Agents API with same name
  
  * Addressing more updates to the extensions
  
  * More improvements
  
  * Remove debugging code from sample
  
  * Address copilot feedback
  
  * Apply suggestions from co-pilot code review
  
  * Update Directory.Packages.props
  
  Fix package version rollback:
  
  Azure.AI.Agents.Persistent (beta-6 => beta-7)
  
  * .NET: Add comprehensive unit tests for Microsoft.Agents.AI.AzureAIAgents extension methods (#1786)
  
  * Initial plan
  
  * Add comprehensive unit test project for Microsoft.Agents.AI.AzureAIAgents
  
  Co-authored-by: rogerbarreto <19890735+rogerbarreto@users.noreply.github.com>
  
  * Add README documenting test project and package dependency requirements
  
  Co-authored-by: rogerbarreto <19890735+rogerbarreto@users.noreply.github.com>
  
  * Fix documentation URL to use learn.microsoft.com
  
  Co-authored-by: rogerbarreto <19890735+rogerbarreto@users.noreply.github.com>
  
  * Bump back AAAP 1.2.0-beta.7
  
  * Address AI generated UT's
  
  * Remove UT Readme
  
  * Apply suggestions from code review
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
  Co-authored-by: rogerbarreto <19890735+rogerbarreto@users.noreply.github.com>
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * .NET: Change model to be required just for prompt agent definition specific extensions (#1812)
  
  * Remove unneeded model from extensions
  
  * Add noop justification
  
  * Update Package Nameing: V1 -> AzureAI.Persistent / V2 -> AzureAI (#1829)
  
  * .NET: Update Extensions for Strict Agent Definitions + Improvements (#1892)
  
  * Update Package Nameing: V1 -> AzureAI.Persistent / V2 -> AzureAI
  
  * Update agents and extensions to comply with strict agent definitions
  
  * More static updates
  
  * Address UT, and ResponseTool support
  
  * Improving reusability extensions
  
  * Addressing ResponseTools Unit Tests and extension setup
  
  * Adapted workaround on breaking AAA with OpenAI 2.6.0
  
  * Small updates
  
  * Remove strictness when retrieving agents, improved XmlDocs
  
  * Improve sample comments
  
  * Update dotnet/tests/Microsoft.Agents.AI.AzureAI.UnitTests/AgentsClientExtensionsTests.cs
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Apply suggestion from @Copilot
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Apply suggestion from @Copilot
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Address PR comments
  
  * Address UT failing
  
  * Address Copilot feedback
  
  * Address Copilot feedback
  
  * Address comment typo
  
  * Address PR feedback
  
  * Address typo
  
  * Add missing Extensions with ChatClientAgentOptions
  
  * Address comments
  
  ---------
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Version update (#1901)
  
  * Updated package version (#1906)
  
  * .NET: Allow Declarative AIAgents Extensions (#1931)
  
  * Improve reusability of extension code and additional option to losen the strictiness of in-proc tools
  
  * Add missing UT scenarios
  
  * Add missing UT test scenarios
  
  * Normalize changes
  
  * Updated (#1948)
  
  * .NET: AgentDefinition extensions method simplification (#1967)
  
  * Update extensions methods that accepts AgentDefinition type to not be restrictive
  
  * Update Unit Tests
  
  * Revert yarn/package-lock
  
  * Revert yarn/package-lock
  
  * Address copilot feedback
  
  * Fix bad merge
  
  * .NET Workflows - WIP Declarative action update (#1761)
  
  * WIP
  
  * Fixed build errors (#1638)
  
  Comment and nullable type alignment
  
  * Sync to SDK update
  
  * Checkpoint
  
  * Checkpoint: Tests passing
  
  * Checkpoint: EndWorkflow
  
  * Add trace
  
  * .NET: Azure.AI.Agents Package Split + Initial Extensions (#1657)
  
  * Move packages
  
  * Update nuget.config
  
  * Address Xmldoc
  
  * Remove format from branches checks
  
  * Address Xmldocs
  
  * Add more details to the implementation
  
  * Moving Agent logic to ChatClient
  
  * Adding Name and Id overrides to AzureAIAgent
  
  * Updating extensions
  
  * Add GetAiAgent extensions
  
  * Adding support for version as name can conflict 409 using the Agents API with same name
  
  * Addressing more updates to the extensions
  
  * More improvements
  
  * Remove debugging code from sample
  
  * Address copilot feedback
  
  * Apply suggestions from co-pilot code review
  
  * Checkpoint
  
  * Update Directory.Packages.props
  
  Fix package version rollback:
  
  Azure.AI.Agents.Persistent (beta-6 => beta-7)
  
  * Add project reference
  
  * .NET: Add comprehensive unit tests for Microsoft.Agents.AI.AzureAIAgents extension methods (#1786)
  
  * Initial plan
  
  * Add comprehensive unit test project for Microsoft.Agents.AI.AzureAIAgents
  
  Co-authored-by: rogerbarreto <19890735+rogerbarreto@users.noreply.github.com>
  
  * Add README documenting test project and package dependency requirements
  
  Co-authored-by: rogerbarreto <19890735+rogerbarreto@users.noreply.github.com>
  
  * Fix documentation URL to use learn.microsoft.com
  
  Co-authored-by: rogerbarreto <19890735+rogerbarreto@users.noreply.github.com>
  
  * Bump back AAAP 1.2.0-beta.7
  
  * Address AI generated UT's
  
  * Remove UT Readme
  
  * Apply suggestions from code review
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
  Co-authored-by: rogerbarreto <19890735+rogerbarreto@users.noreply.github.com>
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * .NET: Change model to be required just for prompt agent definition specific extensions (#1812)
  
  * Remove unneeded model from extensions
  
  * Add noop justification
  
  * Update Package Nameing: V1 -> AzureAI.Persistent / V2 -> AzureAI (#1829)
  
  * Checkpoint for merge
  
  * No build errors
  
  * .NET: Update Extensions for Strict Agent Definitions + Improvements (#1892)
  
  * Update Package Nameing: V1 -> AzureAI.Persistent / V2 -> AzureAI
  
  * Update agents and extensions to comply with strict agent definitions
  
  * More static updates
  
  * Address UT, and ResponseTool support
  
  * Improving reusability extensions
  
  * Addressing ResponseTools Unit Tests and extension setup
  
  * Adapted workaround on breaking AAA with OpenAI 2.6.0
  
  * Small updates
  
  * Remove strictness when retrieving agents, improved XmlDocs
  
  * Improve sample comments
  
  * Update dotnet/tests/Microsoft.Agents.AI.AzureAI.UnitTests/AgentsClientExtensionsTests.cs
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Apply suggestion from @Copilot
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Apply suggestion from @Copilot
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Address PR comments
  
  * Address UT failing
  
  * Address Copilot feedback
  
  * Address Copilot feedback
  
  * Address comment typo
  
  * Address PR feedback
  
  * Address typo
  
  * Add missing Extensions with ChatClientAgentOptions
  
  * Address comments
  
  ---------
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Updated package version (#1897)
  
  * Version update (#1901)
  
  * Checkpoint
  
  * Updated package version (#1906)
  
  * Checkpoint
  
  * Checkpoint
  
  * Checkpoint
  
  * Align with azure ai agent
  
  * Update dotnet/samples/GettingStarted/Workflows/Declarative/StudentTeacher/Program.cs
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Update dotnet/samples/GettingStarted/Workflows/Declarative/MCPToolApproval/Program.cs
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Update dotnet/samples/GettingStarted/Workflows/Declarative/DeepResearch/Program.cs
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Refactored external input
  
  * Update dotnet/samples/GettingStarted/Workflows/Declarative/MCPToolApproval/Program.cs
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Agent tools patch
  
  * Demos validated
  
  * Checkpoint
  
  * Hygiene
  
  * Checkpoint - Samples
  
  * Update dotnet/samples/GettingStarted/Workflows/Declarative/StudentTeacher/Program.cs
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Update dotnet/samples/GettingStarted/Workflows/Declarative/StudentTeacher/Program.cs
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Checkpoint
  
  * Checkpoint - Deep Research
  
  * Update baseline
  
  * Update
  
  * Typo
  
  * Checkpoint
  
  * Typos
  
  * Sample cleanup
  
  * Update dotnet/src/Microsoft.Agents.AI.Workflows.Declarative/AzureAgentProvider.cs
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Update dotnet/src/Microsoft.Agents.AI.AzureAI/AgentsClientExtensions.cs
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Update dotnet/samples/GettingStarted/Workflows/Declarative/FunctionTools/Program.cs
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Update dotnet/samples/GettingStarted/Workflows/Declarative/StudentTeacher/Program.cs
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Update dotnet/samples/GettingStarted/Workflows/Declarative/ToolApproval/Program.cs
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Update dotnet/samples/GettingStarted/Workflows/Declarative/DeepResearch/Program.cs
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Typo
  
  * Typo
  
  * Fix input loop
  
  * Sample - Function Calling / External Input
  
  * Typo
  
  * Finessed
  
  * Checkpoint
  
  * Fix feed
  
  * Checkpoint - so close
  
  * Ding dong!
  
  * "there" ***
  
  * Fixup comments
  
  * Fix sample
  
  * Code analysis
  
  * Header
  
  * Typo (variableName)
  
  * Remove dead code
  
  * Skip test (agent api ratchet)
  
  * Comment
  
  * Update dotnet/samples/GettingStarted/Workflows/Declarative/StudentTeacher/Program.cs
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Typo
  
  ---------
  
  Co-authored-by: Roger Barreto <19890735+rogerbarreto@users.noreply.github.com>
  Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  Co-authored-by: Dmytro Struk <13853051+dmytrostruk@users.noreply.github.com>
  
  * .NET: Latest updates Pre/Post V2 Bugbash Findings (#2040)
  
  * Improve V2 logic before/after bugbash prep
  
  * Apply suggestions from code review
  
  Co-authored-by: Stephen Toub <stoub@microsoft.com>
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: Stephen Toub <stoub@microsoft.com>
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * .NET: Update Foundry Agents to latest 2.0.0 alpha.20251107.3 (#2050)
  
  * Update extensions for new CreateVersionOptions structure
  
  * Update unit tests
  
  * Addresss capitalized
  
  * Update AgentsClientExtensionsTests.cs
  
  Fix invalid cast format failure
  
  * .NET: Feature foundry agent + user agent (#2058)
  
  * Update unit tests
  
  * Add user-agent protocol calls
  
  * Update unit tests
  
  * Update unit tests with http handler confirmation
  
  * UT fix
  
  * Fix xmldoc
  
  * Apply suggestions from code review
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Address copilot feedback
  
  ---------
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * .NET: Update Extensions to be less restrictive for GetAIAgents (#2091)
  
  * Update behavior / restrictiveness when retrieving agents
  
  * Apply suggestions from code review
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Apply suggestions from code review
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Address format
  
  * Address copilot feedback
  
  ---------
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  Co-authored-by: Chris <66376200+crickman@users.noreply.github.com>
  
  * .NET Workflows - Support "structured inputs" feature for declarative workflows (#2053)
  
  * Bump version for release
  
  * .NET Workflows - Separate Foundry/AzureAI Provider into its own package (#2078)
  
  * Remove unused using directive in AzureAgentProvider
  
  Removed unused using directive for Extensions.
  
  * .NET: Updates to Foundry Agents Package (#2125)
  
  * Remove the conversation creation always
  
  * Update unit tests + address IL + refactor
  
  * Apply suggestions from code review
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Internalize unused methods
  
  ---------
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Fix declarative workflows integration testcase
  
  * .NET: Feature foundry agent/agent reference extension (Python Parity with Name + Version option) (#2147)
  
  * Add agent reference extensions
  
  * Add UT covering AgentReference and ModelId
  
  * .NET: Add GettingStarted Samples for Agents V2. (#2159)
  
  * Add gettingstarted samples for Foundry Agents
  
  * Address structured outputs
  
  * Net 10 -> Net 9 Temporary
  
  * Net 10 -> Net 9 Temporary
  
  * Apply suggestions from code review
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Address missing docs + old
  
  * Drop var for samples
  
  * Apply suggestions from code review
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Apply suggestions from code review
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Address copilot feedback
  
  ---------
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * .NET: Foundry Agents V2 - Add CodeInterpreter Sample (#2180)
  
  * Adding Code Interpreter sample and AgentName naming validation
  
  * Add agent name check UT
  
  * Improve sample code
  
  * Apply suggestion
  
  * Apply suggestion
  
  * Fixed (#2190)
  
  * .NET Workflows - Add "CustomerSupport" sample (#2102)
  
  * .NET Workflows - Add sample for hosted declarative workflow (#2199)
  
  * fwiw
  
  * Less blank lines
  
  * Fixed (#2204)
  
  * Update version (#2206)
  
  * .NET: Feature foundry agent/update breaking v2.0 to v1.2 (#2212)
  
  * Migration WIP Checkpoint 1
  
  * Build + UT + Workflow passing
  
  * Address latest commits after break
  
  * Revert rename in unrelated files
  
  * Address PR comments
  
  * Class renames
  
  * Allow dotnet-format workflow on feature branches
  
  Revert unintentional edit
  
  * .NET: Add Conformance Integration Tests for AzureAI Package (#2237)
  
  * Conformance tests added and passing
  
  * Correct namespace
  
  * Update Azure.AI.Project to latest public nuget version
  
  * .NET: Added Computer use tool sample (#2235)
  
  * Initial computer use sample implementation.
  
  * Added background thread to allow polling for long running requests.
  
  * Removed unrequired try-catch block and added missing thread for agent call.
  
  * Removed irrelevant chatOptions and updated code based on feedback.
  
  * Updated image assets and fixed response issue.
  
  * Updated based on PR comments.
  
  * Update to Azure.AI.Project
  
  ---------
  
  Co-authored-by: Roger Barreto <19890735+rogerbarreto@users.noreply.github.com>
  
  * Package descriptions
  
  ---------
  
  Co-authored-by: Chris <66376200+crickman@users.noreply.github.com>
  Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  Co-authored-by: Dmytro Struk <13853051+dmytrostruk@users.noreply.github.com>
  Co-authored-by: Chris Rickman <crickman@microsoft.com>
  Co-authored-by: Stephen Toub <stoub@microsoft.com>
  Co-authored-by: Mark Wallace <127216156+markwallace-microsoft@users.noreply.github.com>
  Co-authored-by: Peter Ibekwe <109177538+peibekwe@users.noreply.github.com>

  Roger Barreto · 2025-11-15 10:43:02 +00:00
  e706f07868
• .NET: AgentHostExecutor should use agent DisplayName as Executor ID (#1840)

  * AgentHostExecutor should use agent DisplayName as Executor ID
  
  * Address comments
  
  * Remove unintended changes
  
  * Remove unintended changes
  
  * Fix tests and address comments

  Tao Chen · 2025-11-05 22:16:53 +00:00
  3f835c8118
• .NET: [BREAKING] .NET: Add Workflow on-Build() Orphan Validation (#1943)

  * fix: Workflow Validation
  
  * adds orphan validation to workflow builder
  * adds tests for workflow validation
  * expands on the underlying reasoning why type validation is not supported
  
  * fixup: CodeGen template

  Jacob Alber · 2025-11-05 22:12:27 +00:00
  0bf6d437d8
• .NET: [BREAKING] refactor: Normalize WorkflowBuilder APIs (#1935)

  * [BREAKING] refactor: Normalize WorkflowBuilder APIs
  
  * "partitioner" => "assigner"
  * normalize ordering so sources always to the left of targets for edges
  * normalize parameter ordering so sources and targets are always first arguments
  * remove `params` (users should use collection expressions instead)
  
  * refactor: Align name with Python

  Jacob Alber · 2025-11-05 19:50:01 +00:00
  94a5ba3448
• .NET: Improve fidelity of OpenAI Responses server and add Conversations (#1907)

  * Improve fidelity of OpenAI Responses server and add Conversations
  
  * Merge
  
  * nit
  
  * Undo prior change
  
  * Undo prior change
  
  * Review feedback
  
  * Review feedback
  
  * Fix test
  
  * Use simpler JsonDocument approach for polymorphic deserialization
  
  * More review feedback
  
  * dotnet format

  Reuben Bond · 2025-11-05 18:46:19 +00:00
  33f84f9ed2
• .NET: Make sure Workflow activities are as expected (#1903)

  * Make sure Workflow activities are as expected
  
  * misc
  
  * Copliot comments
  
  * Fix unit tests
  
  * Improve test stability
  
  * Fix unit tests
  
  * Fix formatting

  Tao Chen · 2025-11-05 00:37:31 +00:00
  552f7c781d
• .NET: [BREAKING] Unify ExecutorIsh and ExecutorRegistration, unify/simplify APIs (#1637)

  * refactor: Unify ExecutorIsh and ExecutorRegistration => ExecutorBinding
  
  * Switch to more modern Record type-tree for Sum Types
  * Unify APIs for getting ExecutorBinding
  * Fix an issue where workflows consisting entirely of cross-run shareable executors which are not instance-resettable do not properly clear state when running non-concurrently.
  
  * feat: Simplify function-to-executor pattern
  
  * refactor: Normalize API naming

  Jacob Alber · 2025-11-03 18:20:35 +00:00
  b25b0af49b
• fix: .NET: Concurrency Support for Orchestrations (#1689)

  Concurrent run support was recently added to workflows, but Orchestrations did not fully update to support it. A few executors were missing Cross-Run Shareable annotations, and the ConcurrentEnd executor needed to be factory-instantiated.
  
  This also ports the fix for #1613 from #1637, to avoid waiting on that PR.

  Jacob Alber · 2025-10-24 23:18:51 +00:00
  899d8ff775
• fix: InMemoryCheckpointManager is not JSON serializable (#1639)

  Checkpointing is used by the WorkflowHostAgent to be able to support resume from a provided thread. When a CheckpointManager is not specified, we use the InMemoryCheckpointManager and serialize its state into the thread's Serialize()ed JsonElement.
  
  At some point InMemoryCheckpointManager became not serializable, breaking this behaviour. This change restores serializability, and adds a test.

  Jacob Alber · 2025-10-23 19:32:52 +00:00
  b2246efa69