Files
agent-framework/dotnet/src/Microsoft.Agents.Workflows/ConfigurationExtensions.cs
T
Jacob Alber 0cae1e0adf .NET: Improve DevEx for simple Executors (#626)
* feat: Improve DevEx for simple Executors

* Add abstract types for executors that will only handle one type of message
* Add FunctionExecutor and configuration capability on delegates
* Add support for late-instantiated Executors

* refactor: Remove open-typed extension method

* refactor: Switch to TaskFactory pattern for async--from-sync

* docs: Update XML docs for publics and fix formatting

* refactor: Better naming for ExecutorIsh configuration methods

* docs: Fix typo in ExecutorIshConfigurationExtensions.ConfigureFactory
2025-09-08 19:11:53 +00:00

33 lines
2.2 KiB
C#

// Copyright (c) Microsoft. All rights reserved.
namespace Microsoft.Agents.Workflows;
/// <summary>
/// Extensions methods for creating Configured objects
/// </summary>
public static class ConfigurationExtensions
{
/// <summary>
/// Creates a new configuration that treats the subject as its base type, allowing configuration to be applied at
/// the parent type level.
/// </summary>
/// <typeparam name="TSubject">The type of the original subject being configured. Must inherit from or implement TParent.</typeparam>
/// <typeparam name="TParent">The base type or interface to which the configuration will be upcast.</typeparam>
/// <param name="configured">The existing configuration for the subject type to be upcast to its parent type. Cannot be null.</param>
/// <returns>A new <see cref="Configured{TParent}"/> instance that applies the original configuration logic to the parent type.</returns>
public static Configured<TParent> Super<TSubject, TParent>(this Configured<TSubject> configured) where TSubject : TParent
=> new(async config => await configured.FactoryAsync(config).ConfigureAwait(false), configured.Id, configured.Raw);
/// <summary>
/// Creates a new configuration that treats the subject as its base type, allowing configuration to be applied at
/// the parent type level.
/// </summary>
/// <typeparam name="TSubject">The type of the original subject being configured. Must inherit from or implement TParent.</typeparam>
/// <typeparam name="TParent">The base type or interface to which the configuration will be upcast.</typeparam>
/// <typeparam name="TSubjectOptions">The type of configuration options for the original subject being configured.</typeparam>
/// <param name="configured">The existing configuration for the subject type to be upcast to its parent type. Cannot be null.</param>
/// <returns>A new <see cref="Configured{TParent}"/> instance that applies the original configuration logic to the parent type.</returns>
public static Configured<TParent> Super<TSubject, TParent, TSubjectOptions>(this Configured<TSubject, TSubjectOptions> configured) where TSubject : TParent
=> configured.Memoize().Super<TSubject, TParent>();
}