agent-framework

WIP: Proposal for StreamingRunWatcher API

Jacob Alber · 2025-11-06 15:01:16 -05:00

931204f6dd

Updated packages configuration (#1952 )

Dmytro Struk · 2025-11-06 01:04:48 +00:00

6fec8a61e3

.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: Add DevUI package for .NET (#1603 )

* Implement DevUI

* Review feedback

* Fix build

Reuben Bond · 2025-11-05 20:02:48 +00:00

8855bfb065

.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

[BREAKING] refactor: Fix unintuitive binding of StreamAsync (#1930 )

In #1551 we added a mechanism to open a Streaming workflow run without providing any input. This caused unintuitive behaviour when passing a string as input without providing a runId, resulting in the input being misinterpreted as the runId and the workflow not executing.

As well, the name caused confusion about why the Workflow was not running when using the input-less StreamAsync (since the Workflow cannot run without any messages to drive its execution).

Jacob Alber · 2025-11-05 17:26:46 +00:00

b8a55dccb4

.NET: AG-UI support for .NET (#1776 )

* Initial plan

* Infrastructure setup

* Plan for minimal client

* Plan update

* Basic agentic chat

* cleanup

* Cleanups

* More cleanups

* Cleanups

* More cleanups

* Test plan

* Sample

* Fix streaming and error handling

* Fix notifications

* Cleanups

* cleanup sample

* Additional tests

* Additional tests

* Run dotnet format

* Remove unnecessary files

* Mark packages as non packable

* Fix build

* Address feedback

* Fix build

* Fix remaining warnings

* Feedback

* Feedback and cleanup

* Cleanup

* Cleanups

* Cleanups

* Cleanups

* Retrieve existing messages from the store to send them along the way and update the sample client

* Run dotnet format

* Add ADR for AG-UI

* Switch to use the SG and use a convention for run ids

* Cleanup MapAGUI API

* Fix formatting

* Fix solution

* Fix solution

Javier Calvarro Nelson · 2025-11-05 15:51:37 +00:00

b03a4fb95e

Fix workflow lookup with AddAsAIAgent(name) when name differs from workflow name (#1925 )

Jeff Handley · 2025-11-05 15:31:36 +00:00

77d882e2b4

.NET: [Breaking Change] Moving MAAI.AzureAI V1 Package -> MAAI.AzureAI.Persistent (V1) (#1902 )

* Update AzureAI -> AzureAI.Persistent

* Fix sample reference

Roger Barreto · 2025-11-05 13:28:00 +00:00

6ca907f23f

.NET: [BREAKING] Simplify TextSearchProvider construction and improve Mem0Provider scoping. (#1905 )

* Simplify TextSearchProvider construction and improve Mem0Provider scoping

* Fixing indentation.

westey · 2025-11-05 13:00:18 +00:00

5e38c63455

.NET: Improve fidelity of OpenAI ChatCompletions Hosting (#1785 )

* rename, support json serialization

* wip

* non-streaming

* streaming?

* proper streaming types

* comments + fix audio parse

* copilot suggestions

* proper stopsequences type

* build options as i could

* annotations

* proper generation of Id for chatcompletions

* string length as in chatcompletions api ref

* image url

* support tools

* rework API

* introduce tests for chatcompletions

* function calling / serialization tests / fixes

* more tests and coverage

* fix format

* sort usings

* nit

* address PR comments

* nits

Korolev Dmitry · 2025-11-05 09:55:26 +00:00

bb8ef466de

.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

Python: .NET: Updated package version and small fix (#1911 )

* Removed public key

* Updated package version

* Updated Python package versions

Dmytro Struk · 2025-11-04 22:42:07 +00:00

9e1b3c9b85

.NET: Add additional error handling to existing providers. (#1837 )

* Add additional error handling to existing providers.

* Add additional information when logging mem0 messages.

* Fix formatting.

westey · 2025-11-04 17:09:45 +00:00

8b4aa1ebb5

.NET: Add rag samples with sample TextSearchStore (#1664 )

* Port store for adding text to a vector store to AF

* Fix typo.

* Change TextSearchStore to sample, and add sample to use it and do rag with a custom schema

* Add more tests and fix broken ones

* Fix merge issue

* Fix sample after merge.

* Convert TextSearchStore to use Dynamic mode to be AOT compatible.

* Add some more clarification on when to use assistant messages in rag searches.

westey · 2025-11-04 16:24:26 +00:00

ada5b83c80

.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

.NET: Peibekwe/workflows cancellation token fix (#1740 )

* Propagate cancellation token down the stack

* Added unit tests to cover workflow cancellation scenarios

* Updated tests based on feedback to simplify assert.

* Create custom AsyncEnumrable to gracefully handle cancellation for Channel reader. Tailor cancellation tests to declarative scenarios.

* Update comment and naming for readability.

* Fixing minor stylistic recommendation.

---------

Co-authored-by: Chris <66376200+crickman@users.noreply.github.com>

Peter Ibekwe · 2025-11-03 16:34:55 +00:00

c83011b30d

.NET: Change GetAIAgentAsync to be synchronous (#1846 )

* Change GetAIAgentAsync to be synchronous

* Update dotnet/tests/Microsoft.Agents.AI.A2A.UnitTests/Extensions/A2AAgentCardExtensionsTests.cs

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Stephen Toub · 2025-11-03 15:16:19 +00:00

e87eed573b

Don't stamp unknown author name on output messages. (#1830 )

westey · 2025-10-31 14:12:20 +00:00

2101d9d36d

.NET: [BREAKING] Fix issue where AIContextProvider messages were not added to MessageStores (#1788 )

* Fix issue where AIContextProvider messages were not added to MessageStores

* Fix typos

* Update XML docs to reduce ambiguity.

* Update AIContext XML docs

* Fix merge issue

westey · 2025-10-30 11:55:48 +00:00

fb7086b2e0

.NET: Add a Mem0 usage sample (#1779 )

* Add a Mem0 usage sample

* Change charset

* Add variable types

westey · 2025-10-30 09:31:29 +00:00

36532e929e

Shorten TextSearchSearchResult to TextSearchResult (#1780 )

westey · 2025-10-29 21:16:28 +00:00

f6eadd412e

.NET: Make ChatProtocolExecutor public (#1781 )

* Initial plan

* Make ChatProtocolExecutor and ChatProtocolExecutorOptions public with XML documentation

Co-authored-by: lokitoth <6936551+lokitoth@users.noreply.github.com>

* Address PR review feedback - remove remarks, fix parameter descriptions

Co-authored-by: lokitoth <6936551+lokitoth@users.noreply.github.com>

* ci: Empty Commit to kick over CI

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: lokitoth <6936551+lokitoth@users.noreply.github.com>
Co-authored-by: Jacob Alber <jaalber@microsoft.com>

Copilot · 2025-10-29 19:02:27 +00:00

a2ee840eef

Disable packing mem0 to avoid release for now (#1751 )

westey · 2025-10-28 16:41:57 +00:00

4d9980c5c3

.NET: Add Rag AIContext Provider (#1630 )

* Add Rag AIContext Provider

* Fix issues

* Improve options naming based on PR feedback.

* Move Rag Provider to Data namespace

* Add Raw Representation to RagSearchResult

* Renaming RagProvider to TextSearchProvider

westey · 2025-10-28 14:16:29 +00:00

a816408cd4

.NET Workflows - Expose SendMessage override to all platforms (#1741 )

* For real

* Fine-tune

* One more miss

Chris · 2025-10-28 12:29:01 +00:00

b70030daec

.NET: Porting Mem0Provider to Agent Framework (#1601 )

* Porting Mem0Provider to AF from SK

* Switch integration tests to manual

* Address issues

* Move Mem0Provider to separate project.

* Move integration tests to new project

* Address PR comments.

westey · 2025-10-28 12:28:37 +00:00

742203fb12

Fix gen_ai.operation.name to be invoke_agent (#1729 )

Stephen Toub · 2025-10-28 01:45:09 +00:00

8408209c70

.NET Workflows - Add support for tool approval (#1685 )

* Draft

* Nullable init

* Complete

* Consistency

* Test fix

* Typo

* Comment

* Updated

* Fix identifier

* Test fix

* Comment typo

* Better naming

* Comment

* Tweak comment

Chris · 2025-10-27 17:40:45 +00:00

92925a8bc7

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

.NET: API to manage AgentThreads in hosting scenarios (#1520 )

* skeleton

* wip

* rename + fix tests

* implement workflow tests

* fix comments

* Update dotnet/src/Microsoft.Agents.AI.Hosting/HostApplicationBuilderWorkflowExtensions.cs

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* fixes

* proto

* fix worfklow build logic

* build it / no reflection / no generics / extensions on aiagent

* rollback + new overload on workflow builder

* address PR comments

* fix build

* take from main

* correct based on latest API

* apply suggestion

* address PR comments x1

* address PR comments 2

* renames

* *With*

* refactor api a bit

* refactor + merge main + apply suggestions

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Korolev Dmitry · 2025-10-24 11:17:25 +00:00

73eb00b37b

feat: Add Cancellation API on StreamingRun (#1675 )

Jacob Alber · 2025-10-23 20:01:56 +00:00

3aa682082a

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

.NET: Refactor A2A and AIAgent hosting extensions (#1625 )

* a2a reformat

* and refactor extensions on serviceCollection

* units

* fix build

* add remark for agentcard overloads

Korolev Dmitry · 2025-10-23 17:43:48 +00:00

72c391bc08

allow a2a agent to accept non-user messages (#1661 )

SergeyMenshykh · 2025-10-23 14:37:14 +00:00

202bfdc376

Propagate cancellation token down the stack (#1641 )

Peter Ibekwe · 2025-10-23 01:44:44 +00:00

e9687d59b4

Fixes issue 1623 - .NET: [BUG] Fix Invalid Mermaid/DOT Identifiers in Fan-In Node Visualization (#1624 )

Jose Luis Latorre Millas · 2025-10-22 21:19:44 +00:00

0fc1b8837b

.NET: Improve fidelity of OpenAI Responses hosting (#1550 )

* Improve conformance of OpenAI Responses API serving

* Update dotnet/src/Microsoft.Agents.AI.Hosting.OpenAI/Responses/AgentRunResponseExtensions.cs

Co-authored-by: Stephen Toub <stoub@microsoft.com>

* Update dotnet/src/Microsoft.Agents.AI.Hosting.OpenAI/Responses/AgentRunResponseExtensions.cs

Co-authored-by: Stephen Toub <stoub@microsoft.com>

* Sort packages

* Relax adherence where acceptable

* nit

* PromptCacheKey is not obsolete

* format

---------

Co-authored-by: Stephen Toub <stoub@microsoft.com>

Reuben Bond · 2025-10-22 17:48:44 +00:00

103c7e7105

.NET: Add support for background responses (#1501 )

* add support for background responses

* Update dotnet/src/Microsoft.Agents.AI.Abstractions/AgentRunResponseUpdate.cs

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* fix broken link

* fix xml comments and background responses properties override funcitonity

* change ai model provider

* use Run{Streaming}Async overloads that don't require messages

* stop using m: prefix in cref attribute of <see/> element.

* reject input messages provided with continuation token + don't extract messages from message store and context provide if continuation token is provided

* use agent thread for background-responses sample

* require agent thread for background responses

* Update dotnet/src/Microsoft.Agents.AI/ChatClient/ChatClientAgent.cs

Co-authored-by: Roger Barreto <19890735+rogerbarreto@users.noreply.github.com>

* Update dotnet/src/Microsoft.Agents.AI/ChatClient/ChatClientAgent.cs

Co-authored-by: Roger Barreto <19890735+rogerbarreto@users.noreply.github.com>

* remove CA1200

* Update dotnet/src/Microsoft.Agents.AI.Abstractions/AgentRunOptions.cs

Co-authored-by: westey <164392973+westey-m@users.noreply.github.com>

* Update dotnet/src/Microsoft.Agents.AI.Abstractions/AgentRunResponse.cs

Co-authored-by: westey <164392973+westey-m@users.noreply.github.com>

* Update dotnet/src/Microsoft.Agents.AI.Abstractions/AgentRunResponse.cs

Co-authored-by: westey <164392973+westey-m@users.noreply.github.com>

* address pr review comments

* Update dotnet/samples/GettingStarted/Agents/Agent_Step17_BackgroundResponses/Program.cs

Co-authored-by: westey <164392973+westey-m@users.noreply.github.com>

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Roger Barreto <19890735+rogerbarreto@users.noreply.github.com>
Co-authored-by: westey <164392973+westey-m@users.noreply.github.com>

SergeyMenshykh · 2025-10-22 17:43:57 +00:00

1bf520a7c2

.NET: Use extension methods from A2A package for converting between MEAI & A2A model classes (#1600 )

* use extension methods from A2A package for converting between MEAI and A2A model classes.

* Update dotnet/tests/Microsoft.Agents.AI.A2A.UnitTests/A2AAgentTests.cs

Co-authored-by: Stephen Toub <stoub@microsoft.com>

* remove unused using

---------

Co-authored-by: Stephen Toub <stoub@microsoft.com>

SergeyMenshykh · 2025-10-21 17:59:27 +00:00

d7f422b92c

.NET: Fix handoff function naming (#1370 )

* Fix handoff function naming

We don't need the agent's name or a guid in the handoff name... we can just use simple numbering. There's a possibility that someone built an agent with a built-in function tool named "handoff_to_x"; if that turns out to be an issue, we could add back some longer bit of randomness.

* Update dotnet/src/Microsoft.Agents.AI.Workflows/Specialized/HandoffAgentExecutor.cs

---------

Co-authored-by: Chris <66376200+crickman@users.noreply.github.com>

Stephen Toub · 2025-10-21 15:23:53 +00:00

22d76e5780

.NET Workflows - Fix ability of ParseValue action to process list/table types. (#1577 )

* Initial plan

* Add test classes for extension methods

Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>

* Fix test issues and document bug in ExpandoObjectExtensions

Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>

* Address code review feedback - shorten Skip messages and add explanatory comments

Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>

* Replace Fields.ToDictionary with GetField calls and fix ExpandoObjectExtensions bug

Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>

* Update dotnet/tests/Microsoft.Agents.AI.Workflows.Declarative.UnitTests/Extensions/DataValueExtensionsTests.cs

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update dotnet/tests/Microsoft.Agents.AI.Workflows.Declarative.UnitTests/Extensions/DataValueExtensionsTests.cs

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Remove unused using statement from DialogBaseExtensionsTests

Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>

* Add proper WrapWithBot tests using AdaptiveDialog and OnActivity

Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>

* Cleanup

* Better

* Better

* One more test

* Checkpoint

* Checkpoint

* Finally

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Chris · 2025-10-21 02:45:07 +00:00

731e3a7633

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: AIAgentHostExecutor to use ToAgentRunResponse (#1439 )

* AIAgentHostExecutor to use ToAgentRunResponse

* Only run agent in stream mode when emit event is true

Tao Chen · 2025-10-20 17:50:12 +00:00

7c1e3db846

.NET: Add comprehensive test classes for extension methods in Microsoft.Agents.AI.Workflows.Declarative (#1555 )

* Initial plan

* Add test classes for extension methods

Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>

* Fix test issues and document bug in ExpandoObjectExtensions

Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>

* Address code review feedback - shorten Skip messages and add explanatory comments

Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>

* Replace Fields.ToDictionary with GetField calls and fix ExpandoObjectExtensions bug

Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>

* Update dotnet/tests/Microsoft.Agents.AI.Workflows.Declarative.UnitTests/Extensions/DataValueExtensionsTests.cs

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update dotnet/tests/Microsoft.Agents.AI.Workflows.Declarative.UnitTests/Extensions/DataValueExtensionsTests.cs

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Remove unused using statement from DialogBaseExtensionsTests

Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>

* Add proper WrapWithBot tests using AdaptiveDialog and OnActivity

Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>

* Cleanup

* Better

* Better

* One more test

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Chris Rickman <crickman@microsoft.com>

Copilot · 2025-10-20 15:21:46 +00:00

c72455508b

.NET README - Declarative Workflows (#1526 )

* Info

* Update dotnet/src/Microsoft.Agents.AI.Workflows.Declarative/README.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update dotnet/src/Microsoft.Agents.AI.Workflows.Declarative/README.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Link

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Chris · 2025-10-17 00:44:25 +00:00

2046f16cdb

.NET Workflows - Declarative updated for Question action (#1532 )

* Updated

* Namespace

Chris · 2025-10-17 00:44:19 +00:00

df776ae77b

.NET: Add support for getting and creating Assistant and Foundry agents with ChatClientAgentOptions (#1304 )

* Add support for getting and creating Assistant and Foundry agents with ChatClientAgentOptions

* Fix options cloning and agent creation

* Fix inconsistency

* Add support for mapping more tools and integration tests for ensuring CreateAIAgent works with those tools.

* Add support for additional openai tools with tests.

* Remove special casing for function tools, since it's either not supported yet, or requires a lot of code duplication.

* Removed unused using.

* Fix broken unit tests

* Change integration test to reduce flakiness.

westey · 2025-10-16 15:39:48 +00:00

54c3eb726a

264 Commits