mirror of
https://github.com/microsoft/agent-framework.git
synced 2026-06-16 21:04:09 +08:00
Jacob Alber
5902bcb10a
* feat: Propagate CancellationToken to Executors * Also adds cancellation propagation to `Executor`-accessible APIs * Adds registrators for cancellable handlers to `RouteBuilder` * [BREAKING]: Adds `CancellationToken` to `IMessageHandler.HandleAsync` * test: Re-enable Concurrent Orchestration test * refactor: Delete unused IInputCoordinator * refactor: Remove superfluous argument qualifications
43 lines
1.9 KiB
C#
43 lines
1.9 KiB
C#
// Copyright (c) Microsoft. All rights reserved.
|
|
|
|
using System.Threading;
|
|
using System.Threading.Tasks;
|
|
|
|
namespace Microsoft.Agents.AI.Workflows.Reflection;
|
|
|
|
/// <summary>
|
|
/// A message handler interface for handling messages of type <typeparamref name="TMessage"/>.
|
|
/// </summary>
|
|
/// <typeparam name="TMessage"></typeparam>
|
|
public interface IMessageHandler<TMessage>
|
|
{
|
|
/// <summary>
|
|
/// Handles the incoming message asynchronously.
|
|
/// </summary>
|
|
/// <param name="message">The message to handle.</param>
|
|
/// <param name="context">The execution context.</param>
|
|
/// <param name="cancellationToken">The <see cref="CancellationToken"/> to monitor for cancellation requests.
|
|
/// The default is <see cref="CancellationToken.None"/>.</param>
|
|
/// <returns>A task that represents the asynchronous operation.</returns>
|
|
ValueTask HandleAsync(TMessage message, IWorkflowContext context, CancellationToken cancellationToken = default);
|
|
}
|
|
|
|
/// <summary>
|
|
/// A message handler interface for handling messages of type <typeparamref name="TMessage"/> and
|
|
/// returning a result.
|
|
/// </summary>
|
|
/// <typeparam name="TMessage">The type of message to handle.</typeparam>
|
|
/// <typeparam name="TResult">The type of result returned after handling the message.</typeparam>
|
|
public interface IMessageHandler<TMessage, TResult>
|
|
{
|
|
/// <summary>
|
|
/// Handles the incoming message asynchronously.
|
|
/// </summary>
|
|
/// <param name="message">The message to handle.</param>
|
|
/// <param name="context">The execution context.</param>
|
|
/// <param name="cancellationToken">The <see cref="CancellationToken"/> to monitor for cancellation requests.
|
|
/// The default is <see cref="CancellationToken.None"/>.</param>
|
|
/// <returns>A task that represents the asynchronous operation.</returns>
|
|
ValueTask<TResult> HandleAsync(TMessage message, IWorkflowContext context, CancellationToken cancellationToken = default);
|
|
}
|