Agent asks a question

\n**A run waiting for an answer**: ```razor @implements IAsyncDisposable ``` ```csharp private readonly BitAiChatSession session = new(AiDemoAgentTransports.AsksForInput()); private readonly string[] suggestions = ["Migrate the database to the new schema"]; public ValueTask DisposeAsync() => session.DisposeAsync(); ``` `AiDemoAgentTransports.cs`: ```csharp // AiScriptedTransport and AiScript are the demo's helpers - see the Basic chat scenario. public static IBitAiTransport AsksForInput() => new AiScriptedTransport((request, token) => AiScript.Stream(token, async yielder => { // The first message asks, the answer to it continues the run, and whatever is said after that is talk. The run is // named after the message that started it, so the answer - the second user message - resumes that run and no other. var users = request.Messages.Where(m => m.Role.IsUser).ToArray(); var runId = $"run-migration-{users[0].MessageId}"; await yielder(new BitAiMessageStartedEvent()); if (users.Length > 2) { await foreach (var evt in AiScript.Write("That migration run is over - what it did is in its steps above.", 4, 12, token)) await yielder(evt); await yielder(new BitAiMessageCompletedEvent()); return; } if (users.Length == 1) { await yielder(new BitAiAgentRunStartedEvent(runId) { AgentName = "Migration agent", Goal = "Move the database to the new schema" }); await yielder(new BitAiAgentPlanEvent(runId, [ new BitAiAgentPlanStep("s1", "Inspect the current schema"), new BitAiAgentPlanStep("s2", "Choose a downtime window"), new BitAiAgentPlanStep("s3", "Run the migration"), ])); await yielder(new BitAiAgentStepStartedEvent(runId, "s1")); await yielder(new BitAiAgentStepCompletedEvent(runId, "s1") { Summary = "14 tables, 2 need rewriting" }); // Stop at step two, with a question and the answers it can take in one tap. await yielder(new BitAiAgentStepStartedEvent(runId, "s2")); await yielder(new BitAiAgentInputRequestedEvent(runId, "Two tables need a rewrite, which needs downtime. When should I take it?") { Suggestions = ["Tonight after 22:00", "Saturday morning", "Ask me again later"], }); await yielder(new BitAiMessageCompletedEvent(BitAiFinishReason.Stop)); return; } // The answer arrived as a user message. No window after all stops the run, which skips the steps it will not take. var window = users[1].GetText().Trim(); if (window == "Ask me again later") { await yielder(new BitAiAgentStepCompletedEvent(runId, "s2", BitAiAgentStepStatus.Skipped) { Summary = "Postponed" }); await yielder(new BitAiAgentRunCompletedEvent(runId, BitAiAgentRunStatus.Cancelled)); await foreach (var evt in AiScript.Write("Understood - I will leave the database as it is.", 4, 12, token)) await yielder(evt); await yielder(new BitAiMessageCompletedEvent()); return; } // Otherwise carry on from step two. await yielder(new BitAiAgentStepCompletedEvent(runId, "s2") { Summary = $"Window: {window}" }); await yielder(new BitAiAgentStepStartedEvent(runId, "s3")); await yielder(new BitAiAgentStepCompletedEvent(runId, "s3") { Summary = "14 tables migrated" }); await yielder(new BitAiAgentRunCompletedEvent(runId)); await foreach (var evt in AiScript.Write($"Booked for {window}. I will run the migration then and report back.", 4, 12, token)) await yielder(evt); await yielder(new BitAiMessageCompletedEvent()); })); ```

Blocked, not finished. The transport plans three steps, completes the first, starts the second, and sends BitAiAgentInputRequestedEvent(runId, prompt) with its Suggestions before ending the reply. The run moves to WaitingForInput and carries the question (PendingPrompt) and the one-tap answers (PendingSuggestions); the step it was on is Blocked until the answer comes, rather than drawn as running with a clock that keeps going.

Choosing an answer - or typing one into the run's own box - calls BitAiChatSession.RespondToAgentAsync(runId, answer), which resumes the run, appends the answer as a user message and starts the next turn. The transport finds the answer in the request and continues the same run from the step it stopped at, addressing it by the run id it used before. "Ask me again later" answers nothing: the agent skips the step and ends the run Cancelled instead of booking a window nobody chose.

This is the difference between an agent that asks and an agent that guesses. The state is explicit, so the UI can make waiting look deliberate rather than stuck.