Overhaul orchestration library with new approach (#199)

Author: stephentoub

dotnet/samples/GettingStarted/Orchestration/ConcurrentOrchestration_Intro.cs

@@ -43,10 +43,9 @@ public async Task RunOrchestrationAsync(bool streamedResponse)
         // Run the orchestration
         string input = "What is temperature?";
         Console.WriteLine($"\n# INPUT: {input}\n");
-        OrchestrationResult<string[]> result = await orchestration.InvokeAsync(input);
+        AgentRunResponse result = await orchestration.RunAsync(input);
 
-        string[] output = await result;
-        Console.WriteLine($"\n# RESULT:\n{string.Join("\n\n", output.Select(text => $"{text}"))}");
+        Console.WriteLine($"\n# RESULT:\n{string.Join("\n\n", result.Messages.Select(r => $"{r.Text}"))}");
 
         this.DisplayHistory(monitor.History);
     }

dotnet/samples/GettingStarted/Orchestration/ConcurrentOrchestration_With_StructuredOutput.cs

@@ -32,21 +32,14 @@ public async Task RunOrchestrationAsync()
                 description: "An expert in entity recognition");
 
         // Define the orchestration with transform
-        StructuredOutputTransform<Analysis> outputTransform = new(this.CreateChatClient());
-        ConcurrentOrchestration<string, Analysis> orchestration =
-            new(agent1, agent2, agent3)
-            {
-                LoggerFactory = this.LoggerFactory,
-                ResultTransform = outputTransform.TransformAsync,
-            };
+        ConcurrentOrchestration orchestration = new(agent1, agent2, agent3) { LoggerFactory = this.LoggerFactory };
 
         // Run the orchestration
         const string resourceId = "Hamlet_full_play_summary.txt";
         string input = Resources.Read(resourceId);
         Console.WriteLine($"\n# INPUT: @{resourceId}\n");
-        OrchestrationResult<Analysis> result = await orchestration.InvokeAsync(input);
 
-        Analysis output = await result;
+        var output = await orchestration.RunAsync<Analysis>(this.CreateChatClient(), input);
         Console.WriteLine($"\n# RESULT:\n{JsonSerializer.Serialize(output, s_options)}");
     }
 

dotnet/samples/GettingStarted/Orchestration/GroupChatOrchestration_Intro.cs

@@ -68,8 +68,8 @@ Consider suggestions when refining an idea.
 
         string input = "Create a slogon for a new eletric SUV that is affordable and fun to drive.";
         Console.WriteLine($"\n# INPUT: {input}\n");
-        OrchestrationResult<string> result = await orchestration.InvokeAsync(input);
-        Console.WriteLine($"\n# RESULT: {await result}");
+        AgentRunResponse result = await orchestration.RunAsync(input);
+        Console.WriteLine($"\n# RESULT: {result}");
 
         this.DisplayHistory(monitor.History);
     }

dotnet/samples/GettingStarted/Orchestration/GroupChatOrchestration_With_AIManager.cs

@@ -132,8 +132,8 @@ You are in a debate. Feel free to challenge the other participants with respect.
 
         // Run the orchestration
         Console.WriteLine($"\n# INPUT: {topic}\n");
-        OrchestrationResult<string> result = await orchestration.InvokeAsync(topic);
-        Console.WriteLine($"\n# RESULT: {await result}");
+        AgentRunResponse result = await orchestration.RunAsync(topic);
+        Console.WriteLine($"\n# RESULT: {result}");
 
         this.DisplayHistory(monitor.History);
     }

dotnet/samples/GettingStarted/Orchestration/GroupChatOrchestration_With_HumanInTheLoop.cs

@@ -69,8 +69,8 @@ Consider suggestions when refining an idea.
         // Run the orchestration
         string input = "Create a slogon for a new eletric SUV that is affordable and fun to drive.";
         Console.WriteLine($"\n# INPUT: {input}\n");
-        OrchestrationResult<string> result = await orchestration.InvokeAsync(input);
-        Console.WriteLine($"\n# RESULT: {await result}");
+        AgentRunResponse result = await orchestration.RunAsync(input);
+        Console.WriteLine($"\n# RESULT: {result}");
 
         this.DisplayHistory(monitor.History);
     }

dotnet/samples/GettingStarted/Orchestration/HandoffOrchestration_Intro.cs

@@ -80,9 +80,9 @@ public async Task RunOrchestrationAsync(bool streamedResponse)
 
         // Run the orchestration
         Console.WriteLine($"\n# INPUT:\n{task}\n");
-        OrchestrationResult<string> result = await orchestration.InvokeAsync(task);
+        AgentRunResponse result = await orchestration.RunAsync(task);
 
-        Console.WriteLine($"\n# RESULT: {await result}");
+        Console.WriteLine($"\n# RESULT: {result}");
 
         this.DisplayHistory(monitor.History);
     }

dotnet/samples/GettingStarted/Orchestration/HandoffOrchestration_With_StructuredInput.cs

@@ -1,5 +1,6 @@
 // Copyright (c) Microsoft. All rights reserved.
 
+using System.Text.Json;
 using System.Text.Json.Serialization;
 using Microsoft.Agents.Orchestration;
 using Microsoft.Extensions.AI;
@@ -44,7 +45,7 @@ public async Task RunOrchestrationAsync()
         OrchestrationMonitor monitor = new();
 
         // Define the orchestration
-        HandoffOrchestration<GithubIssue, string> orchestration =
+        HandoffOrchestration orchestration =
             new(OrchestrationHandoffs
                     .StartWith(triageAgent)
                     .Add(triageAgent, dotnetAgent, pythonAgent))
@@ -80,8 +81,8 @@ Normal DBContext logging shows only normal context queries. Queries run by Vecto
 
         // Run the orchestration
         Console.WriteLine($"\n# INPUT:\n{input.Id}: {input.Title}\n");
-        OrchestrationResult<string> result = await orchestration.InvokeAsync(input);
-        Console.WriteLine($"\n# RESULT: {await result}");
+        AgentRunResponse result = await orchestration.RunAsync(JsonSerializer.Serialize(input));
+        Console.WriteLine($"\n# RESULT: {result}");
         Console.WriteLine($"\n# LABELS: {string.Join(",", githubPlugin.Labels["12345"])}\n");
     }
 

dotnet/samples/GettingStarted/Orchestration/SequentialOrchestration_Intro.cs

@@ -65,8 +65,8 @@ give format and make it polished. Output the final improved copy as a single tex
         // Run the orchestration
         string input = "An eco-friendly stainless steel water bottle that keeps drinks cold for 24 hours";
         Console.WriteLine($"\n# INPUT: {input}\n");
-        OrchestrationResult<string> result = await orchestration.InvokeAsync(input);
-        Console.WriteLine($"\n# RESULT: {await result}");
+        AgentRunResponse result = await orchestration.RunAsync(input);
+        Console.WriteLine($"\n# RESULT: {result}");
 
         this.DisplayHistory(monitor.History);
     }

dotnet/samples/GettingStarted/Orchestration/SequentialOrchestration_With_Cancellation.cs

@@ -1,6 +1,7 @@
 // Copyright (c) Microsoft. All rights reserved.
 
 using Microsoft.Agents.Orchestration;
+using Microsoft.Extensions.AI;
 using Microsoft.Extensions.AI.Agents;
 
 namespace Orchestration;
@@ -28,7 +29,7 @@ public async Task RunOrchestrationAsync()
         string input = "42";
         Console.WriteLine($"\n# INPUT: {input}\n");
 
-        OrchestrationResult<string> result = await orchestration.InvokeAsync(input);
+        OrchestratingAgentResponse result = await orchestration.RunAsync([new ChatMessage(ChatRole.User, input)]);
 
         result.Cancel();
         await Task.Delay(TimeSpan.FromSeconds(3));