19 Commits

• .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: [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] Change SerializeSession to be Async (#3879)

  * Change SerializeSession to be Async
  
  * Update Changelog

  westey · 2026-02-12 11:56:42 +00:00
  6a88c7b1a1
• .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
• .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: [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: [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: [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: 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] 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
• refactor: [BREAKING] Remove generic Workflow<T> (#1551)

  Remove input type checking in favour of explicit `.DescribeProtocolAsync()` flow. Also removes `.AsAgentAsync()` as the validation happens at workflow run time. This makes it easier to use Workflows with DI without resorting to async-over-sync.

  Jacob Alber · 2025-10-21 00:13:41 +00:00
  0ef4e739d5
• .NET: Add support for Subworkflows and many threading fixes (#1066)

  * feat: Add support for Workflow-as-Executor
  
  * Fixes routing of 'object' compile-typed variables to properly take in type information
  * Fixes a concurrency issue in StepTracer
  
  * fix: Make Subworkflow ExternalRequests work properly
  
  * fix: Threading and Concurrency fixes; prep for OffThread Mode
  
  * refactor: Remove dead code around OffStreamRunEventStream
  
  Currently not used, and will be replaced with a rewrite when brought back, so having it in the change is not valuable.
  
  * ci: Work around issues with dotnet-format not properly analyzing the source
  
  * fix: Fix the logic of AsyncCoordinator and AsyncBarrier
  
  * Prevent individual wait cancellations from canceling the entire barrier
  * Propagate information about whether the wait was completed or cancelled, and whether any waiters were present when released
  
  * fix: Remove superfluous acces to .Keys in InProcStepTracer
  
  * refactor: Clean up AsyncCoordinator's use of AsyncBarrier

  Jacob Alber · 2025-10-03 17:26:30 +00:00
  32e7ff00b5
• .NET: Clean up some CancellationToken usage (#996)

  * Clean up some CancellationToken usage
  
  * Unused usings

  Stephen Toub · 2025-09-30 13:44:53 +00:00
  4fd61924fc
• .NET: Clean up stale mentions of M.E.AI.Agents (#997)

  * Clean up stale mentions of M.E.AI.Agents
  
  * Unused usings

  Stephen Toub · 2025-09-30 08:36:06 +00:00
  77e5f527c4
• .NET: Rename workflows projects (#975)

  * Renaming Microsoft.Agent.Workflows to Microsoft.Agents.AI.Workflows
  
  * Removing local settings.
  
  * Removing remining old files from merge.

  Ben Thomas · 2025-09-29 18:30:45 +00:00
  647db9635a