Files
agent-framework/dotnet/tests/Microsoft.Agents.Workflows.UnitTests/ReflectionSmokeTest.cs
T
Jacob Alber 32711cfa95 .Net: WIP: feat: Define Workflow and Executor APIs (#261)
* feat: Define Workflow and Executor APIs

* feat: Define IExecutionContext and Events

* feat: Simple Workflow Demos

* refactor: Move Workflows classes to separate assembly

* feat: Move FanOut/In to LowLevel API with new semantics

* feat: Implement Local Execution

* refactor: Assembly name .Workflow => .Workflows

* feat: Enable Default Message Handling

* also lifts Bind in MessageHandlerInfo to better be able to direclty invoke handlers (for AOT, later)

* feat: Implement StreamingHandle APIs

This allows the user to respond to WorkflowEvents with external messages, enabling HIL.

* feat: Add checks for duplicate edges and chain cycles

* feat: Add built-in WorkflowEvents

* refactor: Pull classes into own files

* refactor: Simplify Disposal pattern in Executor

* refactor: Break EdgeRunner file into per-type files

* refactor: Use Throw.IfNull()

* refactor: Remove AddLoop()

Per https://github.com/microsoft/agent-framework/pull/272#discussion_r2241739079 we decided this was not very useful.

* refactor: Normalize use of ValueTask

* fix: Build Break from removing .AddLoop

* refactor: Explicit routing and RouteBuilder

Split out reflection from MessageRouter implemention into build phase, enabling AOT compilation to drive RouteBuilding without reflection.

* test: Add Reflection/Invocation tests

* fix: Terminate on Completion event

* refactor: Update public API surface

* feat: Add support for external requests

* feat: Support hosting AIAgent instances in Workflows

* fix: Fix routing to go through Executor.ExecuteAsync

* test: Update samples for "must SendMessage" semantics

* Add invoking samples to unit tests to avoid future breaks

* fix: ExternalRequest should block Workflow completion

* feat: Normalize API surface against Python

* Also adds xmldoc to all public APIs

* refactor: Normalize UnitTest and Sample namespaces

* fix: Formatting

* refactor: Normalize project/folder names

* feat: Remove DynamicCodeExecution from ValueTaskTypeErasure

* fix: Fix ILTrim warnings

* docs: Add missing docs and fix typos

* feat: Hosted Agents should report Run events

* fix: Fix type propagation for ILTrim changes

* refactor: Simplify DynamicallyAccessedMembers annotations

* sample: Use static-Type construction of InputPort

* feat: Support non-Streaming Run Mode

* test: Add test for non-streaming execution

* refactor: Remove unused types

* refactor: Simplify Event and EdgeData type hierarchies

* feat: Add Switch (=Conditional Edge Group) control flow

* feat: Make .NET AutoSend the MessageHandler result

* feat: Implement State APIs

* refactor: Simplify public namespaces and code organization

* refactor: Reconcile .NET and Python names

---------

Co-authored-by: Chris <66376200+crickman@users.noreply.github.com>
2025-08-13 22:34:39 +00:00

132 lines
3.7 KiB
C#

// Copyright (c) Microsoft. All rights reserved.
using System;
using System.Threading.Tasks;
using Microsoft.Agents.Workflows.Execution;
using Microsoft.Agents.Workflows.Reflection;
using Moq;
namespace Microsoft.Agents.Workflows.UnitTests;
public class BaseTestExecutor<TActual> : ReflectingExecutor<TActual> where TActual : ReflectingExecutor<TActual>
{
protected void OnInvokedHandler()
{
this.InvokedHandler = true;
}
public bool InvokedHandler
{
get;
private set;
} = false;
}
public class DefaultHandler : BaseTestExecutor<DefaultHandler>, IMessageHandler<object>
{
public ValueTask HandleAsync(object message, IWorkflowContext context)
{
this.OnInvokedHandler();
return this.Handler(message, context);
}
public Func<object, IWorkflowContext, ValueTask> Handler
{
get;
set;
} = (message, context) => default;
}
public class TypedHandler<TInput> : BaseTestExecutor<TypedHandler<TInput>>, IMessageHandler<TInput>
{
public ValueTask HandleAsync(TInput message, IWorkflowContext context)
{
this.OnInvokedHandler();
return this.Handler(message, context);
}
public Func<TInput, IWorkflowContext, ValueTask> Handler
{
get;
set;
} = (message, context) => default;
}
public class TypedHandlerWithOutput<TInput, TResult> : BaseTestExecutor<TypedHandlerWithOutput<TInput, TResult>>, IMessageHandler<TInput, TResult>
{
public ValueTask<TResult> HandleAsync(TInput message, IWorkflowContext context)
{
this.OnInvokedHandler();
return this.Handler(message, context);
}
public Func<TInput, IWorkflowContext, ValueTask<TResult>> Handler
{
get;
set;
} = (message, context) => default;
}
public class RoutingReflectionTests
{
private async ValueTask<CallResult?> RunTestReflectAndRouteMessageAsync<TInput, TE>(BaseTestExecutor<TE> executor, TInput? input = default) where TInput : new() where TE : ReflectingExecutor<TE>
{
MessageRouter router = executor.Router;
Assert.NotNull(router);
input ??= new();
Assert.True(router.CanHandle(input.GetType()));
Assert.True(router.CanHandle(input));
CallResult? result = await router.RouteMessageAsync(input, Mock.Of<IWorkflowContext>());
Assert.True(executor.InvokedHandler);
return result;
}
[Fact]
public async Task Test_ReflectAndExecute_DefaultHandlerAsync()
{
DefaultHandler executor = new();
CallResult? result = await this.RunTestReflectAndRouteMessageAsync<object, DefaultHandler>(executor);
Assert.NotNull(result);
Assert.True(result.IsSuccess);
Assert.True(result.IsVoid);
}
[Fact]
public async Task Test_ReflectAndExecute_HandlerReturnsVoidAsync()
{
TypedHandler<int> executor = new();
CallResult? result = await this.RunTestReflectAndRouteMessageAsync<object, TypedHandler<int>>(executor, 3);
Assert.NotNull(result);
Assert.True(result.IsSuccess);
Assert.True(result.IsVoid);
}
[Fact]
public async Task Test_ReflectAndExecute_HandlerReturnsValueAsync()
{
TypedHandlerWithOutput<int, string> executor = new()
{
Handler = (message, context) =>
{
return new ValueTask<string>($"{message}");
}
};
const string Expected = "3";
CallResult? result = await this.RunTestReflectAndRouteMessageAsync<object, TypedHandlerWithOutput<int, string>>(executor, int.Parse(Expected));
Assert.NotNull(result);
Assert.True(result.IsSuccess);
Assert.False(result.IsVoid);
Assert.Equal(Expected, result.Result);
}
}