Port 15 placeholder samples to Microsoft.Agents.AI 1.3 / ModelContextProtocol 1.2

Replaces every placeholder Program.cs with a working implementation against
the stable 1.x API surface. The .book.txt files (preserving the original
0.3-preview snippets that print in the manuscript) remain alongside for
traceability.

Key API shifts applied across the ports:
- ChatClientAgentOptions.{Instructions,Tools} now live under .ChatOptions
  (or pass instructions/tools to the string-arg ChatClientAgent ctor).
- AgentThread -> AgentSession; AgentRunResponse -> AgentResponse;
  GetNewThread() -> CreateSessionAsync(); session serialization is
  agent.SerializeSessionAsync / DeserializeSessionAsync.
- WorkflowBuilder takes the start executor in its ctor; Executor.From/FromAsync
  became FunctionExecutor<TIn,TOut>; SetOutputExecutor -> WithOutputFrom; the
  workflow runs via InProcessExecution.RunAsync(workflow, input).
- AsBuilder().Use(...) middleware delegate now receives the inner AIAgent
  directly (no next-delegate); call innerAgent.RunAsync(...).
- ModelContextProtocol.{Client,Server} packages were merged into
  ModelContextProtocol / .Core / .AspNetCore. McpClientTool extends AIFunction
  so .AsAIFunction() is gone; rename via .WithName(...).
- Server bootstrap uses .WithHttpTransport() (streamable HTTP only); SSE was
  retired. Client side uses HttpClientTransport in place of
  StreamableHttpClientTransport / SseClientTransport.
- A2A server hosting requires an IAgentHandler, registered via
  services.AddA2AAgent<THandler>(card) and exposed via app.MapA2A("/path")
  from A2A.AspNetCore. The 0.3-preview's app.MapA2A(agent, "/path") shorthand
  no longer exists.
- McpClient.OnToolsListChanged(...) replaced by RegisterNotificationHandler
  (NotificationMethods.ToolListChangedNotification, ...) which returns an
  IAsyncDisposable.

A2A.AspNetCore 1.0.0-preview2 added to Directory.Packages.props (preview-only,
referenced via VersionOverride from samples/ch04-agent-framework/04.7-a2a-server).
README.md "API-update-pending samples" section replaced with the 1.x API
delta cheatsheet.

All 37 sample projects build clean.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

Author: NinjaRocks

Directory.Packages.props

@@ -27,6 +27,7 @@
     <!-- Preview-only members of the family. -->
     <PackageVersion Include="Microsoft.Agents.AI.A2A" Version="1.3.0-preview.260423.1" />
     <PackageVersion Include="Microsoft.Agents.AI.Hosting" Version="1.3.0-preview.260423.1" />
+    <PackageVersion Include="A2A.AspNetCore" Version="1.0.0-preview2" />
   </ItemGroup>
 
   <ItemGroup Label="Model Context Protocol (1.x)">

README.md

@@ -97,35 +97,19 @@ These samples need **only** Ollama (no API keys, no cloud calls):
 
 The rest assume an OpenAI / Anthropic / Azure OpenAI key.
 
-## API-update-pending samples
-
-Microsoft's `Microsoft.Agents.AI` and `ModelContextProtocol` packages went stable (1.x) with substantial API changes from the 0.3.x previews used while the manuscript was being written. To keep the build green, the following samples currently ship a one-line placeholder `Program.cs` and the original code is preserved alongside as `Program.cs.book.txt` (and any other `*.cs.book.txt` files in the same folder).
-
-These need a manuscript-aligned API rewrite (target: `Microsoft.Agents.AI` 1.3 + `ModelContextProtocol` 1.2):
-
-- `samples/ch04-agent-framework/04.2.1-hello-agent/`
-- `samples/ch04-agent-framework/04.2.4-anthropic-agents/`
-- `samples/ch04-agent-framework/04.3-persistent-session/`
-- `samples/ch04-agent-framework/04.4-tools-and-approval/`
-- `samples/ch04-agent-framework/04.5-agent-middleware/`
-- `samples/ch04-agent-framework/04.6.3-text-processing-walkthrough/`
-- `samples/ch04-agent-framework/04.6.7-content-workflow/`
-- `samples/ch04-agent-framework/04.7-a2a-server/`
-- `samples/ch04-agent-framework/04.8-agent-with-mcp/`
-- `samples/ch05-mcp/05.3.1-stdio-transport/`
-- `samples/ch05-mcp/05.3.2-sse-transport/`
-- `samples/ch05-mcp/05.3.3-streamable-http/`
-- `samples/ch05-mcp/05.4-mcp-client/`
-- `samples/ch05-mcp/05.6.3-mcp-agent-factory/`
-- `samples/ch05-mcp/cached-mcp-tool-provider/`
-
-Notable shape changes to plan around when updating:
-
-- `ChatClientAgentOptions` no longer has `Instructions` / `Tools` -- both move under `ChatOptions` / `ChatHistoryProvider`.
-- `AgentThread` -> `AgentSession`; `AgentRunResponse` -> `AgentResponse`; `AIAgent.GetNewThread()` is gone.
-- `WorkflowBuilder` requires a starting executor in its constructor; `Executor.From` / `Executor.FromAsync` were renamed.
-- `ModelContextProtocol.Client` and `ModelContextProtocol.Server` are no longer separate packages -- everything is in `ModelContextProtocol` / `ModelContextProtocol.Core`.
-- `WithHttpServerTransport(...)` / `HttpTransportType` were replaced by `WithHttpTransport(...)` (streamable HTTP only).
+## 1.x API surface (Agent Framework 1.3 / MCP 1.2)
+
+All samples target `Microsoft.Agents.AI` 1.3 and `ModelContextProtocol` 1.2. The manuscript was originally drafted against the 0.3.x previews, so the printed code occasionally differs from what's in this repo. The original 0.3-preview snippets are preserved alongside the live code as `*.cs.book.txt` for traceability. The shape changes that recur most often:
+
+- `ChatClientAgentOptions` no longer carries `Instructions` / `Tools` -- they move to `ChatClientAgentOptions.ChatOptions` (`Instructions`, `Tools`) or to the string-arg `ChatClientAgent` constructor.
+- `AgentThread` -> `AgentSession`; `AgentRunResponse` -> `AgentResponse`; `AIAgent.GetNewThread()` -> `AIAgent.CreateSessionAsync(...)`. Session serialization is `agent.SerializeSessionAsync(session)` / `agent.DeserializeSessionAsync(jsonElement)`.
+- `WorkflowBuilder()` parameterless ctor is gone -- the start executor is passed to the constructor (`new WorkflowBuilder(start)`). `Executor.From` / `FromAsync` lambdas became `new FunctionExecutor<TIn, TOut>(id, handler)`. `SetOutputExecutor` -> `WithOutputFrom(...)`. `workflow.RunAsync(...)` was replaced by `InProcessExecution.RunAsync(workflow, input)`.
+- The `AsBuilder().Use(...)` middleware delegate now receives `(messages, session, options, innerAgent, ct)` -- you call `innerAgent.RunAsync(...)` instead of a `next` delegate.
+- `ModelContextProtocol.Client` / `ModelContextProtocol.Server` are no longer separate packages -- everything is in `ModelContextProtocol` / `ModelContextProtocol.Core` / `ModelContextProtocol.AspNetCore`. `McpClientTool` now extends `AIFunction` directly (no `.AsAIFunction()` needed); rename via `tool.WithName(...)`.
+- Server bootstrap is `.AddMcpServer().WithHttpTransport().WithToolsFromAssembly()` then `app.MapMcp(...)`. `WithHttpServerTransport(...)` and `HttpTransportType.Sse` have been retired -- streamable HTTP is the only HTTP transport.
+- Client transports: `StreamableHttpClientTransport` -> `HttpClientTransport` (with `HttpClientTransportOptions`). `SseClientTransport` is gone.
+- A2A server hosting requires implementing `A2A.IAgentHandler`, registering it via `services.AddA2AAgent<THandler>(agentCard)`, then `app.MapA2A("/path")` from `A2A.AspNetCore`. The 0.3-preview's one-liner `app.MapA2A(agent, "/path")` no longer exists.
+- `McpClient.OnToolsListChanged(...)` was replaced by `client.RegisterNotificationHandler(NotificationMethods.ToolListChangedNotification, handler)`, which returns an `IAsyncDisposable`.
 
 ## Versioning and tags
 

samples/ch04-agent-framework/04.2.1-hello-agent/Program.cs

@@ -1,4 +1,30 @@
-// API-update-pending: this sample is being updated for the Microsoft.Agents.AI 1.x
-// and ModelContextProtocol 1.x API surface. See README.md and the Program.cs.book.txt
-// (and any other *.cs.book.txt) files for the original code as written for the manuscript.
-Console.WriteLine("Sample placeholder. See README.md and Program.cs.book.txt for the original implementation.");
+using Microsoft.Agents.AI;
+using Microsoft.Extensions.AI;
+using OllamaSharp;
+
+IChatClient chat = new OllamaApiClient(
+    new Uri(Environment.GetEnvironmentVariable("OLLAMA_ENDPOINT") ?? "http://localhost:11434"),
+    Environment.GetEnvironmentVariable("OLLAMA_MODEL") ?? "phi4-mini");
+
+ChatClientAgent agent = new(
+    chat,
+    instructions: """
+        You are Curio, a curious assistant that asks one short clarifying question
+        before answering. Keep replies under three sentences.
+        """,
+    name: "Curio");
+
+AgentSession session = await agent.CreateSessionAsync();
+
+string[] turns =
+[
+    "I'd like to plan a weekend hike.",
+    "Two people, intermediate fitness, prefer woodland trails.",
+];
+
+foreach (var turn in turns)
+{
+    Console.WriteLine($"\n[User] {turn}");
+    AgentResponse response = await agent.RunAsync(turn, session);
+    Console.WriteLine($"[{agent.Name}] {response}");
+}

samples/ch04-agent-framework/04.2.4-anthropic-agents/Program.cs

@@ -1,4 +1,35 @@
-// API-update-pending: this sample is being updated for the Microsoft.Agents.AI 1.x
-// and ModelContextProtocol 1.x API surface. See README.md and the Program.cs.book.txt
-// (and any other *.cs.book.txt) files for the original code as written for the manuscript.
-Console.WriteLine("Sample placeholder. See README.md and Program.cs.book.txt for the original implementation.");
+using Anthropic.SDK;
+using Microsoft.Agents.AI;
+using Microsoft.Extensions.AI;
+
+var apiKey = Environment.GetEnvironmentVariable("ANTHROPIC_API_KEY")
+    ?? throw new InvalidOperationException("Set ANTHROPIC_API_KEY.");
+
+var modelId = Environment.GetEnvironmentVariable("ANTHROPIC_MODEL") ?? "claude-haiku-4-5-20251001";
+
+IChatClient chat = new AnthropicClient(apiKey).Messages;
+
+ChatClientAgent agent = new(chat, new ChatClientAgentOptions
+{
+    Name = "Claude",
+    ChatOptions = new ChatOptions
+    {
+        ModelId = modelId,
+        Instructions = "You are a thoughtful tutor. Explain things clearly with one concrete example.",
+    },
+});
+
+AgentSession session = await agent.CreateSessionAsync();
+
+string[] turns =
+[
+    "Explain how garbage collection generations work in .NET.",
+    "When does an object actually move from gen 0 to gen 1?",
+];
+
+foreach (var turn in turns)
+{
+    Console.WriteLine($"\n[User] {turn}");
+    AgentResponse response = await agent.RunAsync(turn, session);
+    Console.WriteLine($"[{agent.Name}] {response}");
+}

samples/ch04-agent-framework/04.3-persistent-session/Program.cs

@@ -1,4 +1,47 @@
-// API-update-pending: this sample is being updated for the Microsoft.Agents.AI 1.x
-// and ModelContextProtocol 1.x API surface. See README.md and the Program.cs.book.txt
-// (and any other *.cs.book.txt) files for the original code as written for the manuscript.
-Console.WriteLine("Sample placeholder. See README.md and Program.cs.book.txt for the original implementation.");
+using System.Text.Json;
+using Microsoft.Agents.AI;
+using Microsoft.Extensions.AI;
+using OllamaSharp;
+
+const string SessionStateFile = "session.json";
+
+IChatClient chat = new OllamaApiClient(
+    new Uri("http://localhost:11434"),
+    Environment.GetEnvironmentVariable("OLLAMA_MODEL") ?? "phi4-mini");
+
+ChatClientAgent agent = new(
+    chat,
+    instructions: "You are a personal notebook assistant. Remember anything the user tells you.",
+    name: "Note");
+
+AgentSession session = await LoadSessionAsync(agent) ?? await agent.CreateSessionAsync();
+
+Console.WriteLine($"Session file: {Path.GetFullPath(SessionStateFile)}");
+Console.WriteLine("Type messages (blank to save and exit). Re-run to resume.");
+
+while (true)
+{
+    Console.Write("\n> ");
+    var input = Console.ReadLine();
+    if (string.IsNullOrWhiteSpace(input)) break;
+
+    AgentResponse response = await agent.RunAsync(input, session);
+    Console.WriteLine($"[{agent.Name}] {response}");
+}
+
+await SaveSessionAsync(agent, session);
+Console.WriteLine($"Saved {SessionStateFile}.");
+
+static async Task<AgentSession?> LoadSessionAsync(AIAgent agent)
+{
+    if (!File.Exists(SessionStateFile)) return null;
+    using var stream = File.OpenRead(SessionStateFile);
+    var element = await JsonSerializer.DeserializeAsync<JsonElement>(stream);
+    return await agent.DeserializeSessionAsync(element);
+}
+
+static async Task SaveSessionAsync(AIAgent agent, AgentSession session)
+{
+    JsonElement element = await agent.SerializeSessionAsync(session);
+    await File.WriteAllTextAsync(SessionStateFile, element.GetRawText());
+}

samples/ch04-agent-framework/04.4-tools-and-approval/Program.cs

@@ -1,4 +1,47 @@
-// API-update-pending: this sample is being updated for the Microsoft.Agents.AI 1.x
-// and ModelContextProtocol 1.x API surface. See README.md and the Program.cs.book.txt
-// (and any other *.cs.book.txt) files for the original code as written for the manuscript.
-Console.WriteLine("Sample placeholder. See README.md and Program.cs.book.txt for the original implementation.");
+using System.ComponentModel;
+using Microsoft.Agents.AI;
+using Microsoft.Extensions.AI;
+using OpenAI;
+
+var apiKey = Environment.GetEnvironmentVariable("OPENAI_API_KEY")
+    ?? throw new InvalidOperationException("Set OPENAI_API_KEY (function calling needs a tool-capable provider).");
+
+IChatClient chat = new OpenAIClient(apiKey).GetChatClient("gpt-4o-mini").AsIChatClient();
+
+var tools = new List<AITool>
+{
+    AIFunctionFactory.Create(GetCustomer),
+    AIFunctionFactory.Create(DeleteCustomerProtected),
+};
+
+ChatClientAgent agent = new(chat, new ChatClientAgentOptions
+{
+    Name = "AdminBot",
+    ChatOptions = new ChatOptions
+    {
+        Instructions = "You manage customers. Use the tools provided.",
+        Tools = tools,
+    },
+});
+
+AgentSession session = await agent.CreateSessionAsync();
+AgentResponse response = await agent.RunAsync("Look up customer 42, then delete them.", session);
+
+Console.WriteLine($"\n[{agent.Name}] {response}");
+
+
+[Description("Look up a customer by ID. Safe -- read only.")]
+static string GetCustomer([Description("Customer ID")] int id)
+    => $"Customer {id}: Anna Lee, premium tier, joined 2024-02-09.";
+
+[Description("Delete a customer permanently. PROTECTED -- requires explicit human approval before execution.")]
+[RequiresApproval]
+static string DeleteCustomerProtected([Description("Customer ID")] int id)
+    => $"Customer {id} permanently deleted.";
+
+
+// Marker attribute. A real production app would have a function-invocation
+// middleware that checks for this and emits FunctionApprovalRequest events
+// before invoking the underlying delegate.
+[AttributeUsage(AttributeTargets.Method)]
+internal sealed class RequiresApprovalAttribute : Attribute { }

samples/ch04-agent-framework/04.5-agent-middleware/Program.cs

@@ -1,4 +1,39 @@
-// API-update-pending: this sample is being updated for the Microsoft.Agents.AI 1.x
-// and ModelContextProtocol 1.x API surface. See README.md and the Program.cs.book.txt
-// (and any other *.cs.book.txt) files for the original code as written for the manuscript.
-Console.WriteLine("Sample placeholder. See README.md and Program.cs.book.txt for the original implementation.");
+using System.Diagnostics;
+using Microsoft.Agents.AI;
+using Microsoft.Extensions.AI;
+using OllamaSharp;
+
+IChatClient chat = new OllamaApiClient(
+    new Uri("http://localhost:11434"),
+    Environment.GetEnvironmentVariable("OLLAMA_MODEL") ?? "phi4-mini");
+
+ChatClientAgent inner = new(
+    chat,
+    instructions: "Reply with a single concise sentence.",
+    name: "Helper");
+
+AIAgent agent = inner
+    .AsBuilder()
+    .Use(LoggingRunMiddleware, runStreamingFunc: null)
+    .Build();
+
+AgentSession session = await inner.CreateSessionAsync();
+AgentResponse response = await agent.RunAsync("Give me a one-sentence travel tip for visiting Iceland in winter.", session);
+Console.WriteLine($"\n[{agent.Name}] {response}");
+
+
+static async Task<AgentResponse> LoggingRunMiddleware(
+    IEnumerable<ChatMessage> messages,
+    AgentSession? session,
+    AgentRunOptions? options,
+    AIAgent next,
+    CancellationToken ct)
+{
+    var sw = Stopwatch.StartNew();
+    var lastUserMessage = messages.LastOrDefault();
+    Console.WriteLine($"  [run] start: \"{lastUserMessage?.Text}\"");
+    AgentResponse response = await next.RunAsync(messages, session, options, ct);
+    sw.Stop();
+    Console.WriteLine($"  [run] done in {sw.ElapsedMilliseconds} ms: {response.Messages.Count} message(s)");
+    return response;
+}

samples/ch04-agent-framework/04.6.3-text-processing-walkthrough/Program.cs

@@ -1,4 +1,40 @@
-// API-update-pending: this sample is being updated for the Microsoft.Agents.AI 1.x
-// and ModelContextProtocol 1.x API surface. See README.md and the Program.cs.book.txt
-// (and any other *.cs.book.txt) files for the original code as written for the manuscript.
-Console.WriteLine("Sample placeholder. See README.md and Program.cs.book.txt for the original implementation.");
+using Microsoft.Agents.AI.Workflows;
+
+var upper = new FunctionExecutor<string, string>(
+    "uppercase",
+    (s, ctx, ct) => ValueTask.FromResult(s.ToUpperInvariant()));
+
+var reverse = new FunctionExecutor<string, string>(
+    "reverse",
+    (s, ctx, ct) => ValueTask.FromResult(new string(s.Reverse().ToArray())));
+
+Workflow workflow = new WorkflowBuilder(upper)
+    .AddEdge(upper, reverse)
+    .WithOutputFrom(reverse)
+    .Build();
+
+await using var run = await InProcessExecution.RunAsync(workflow, "Hello, agent!");
+foreach (var evt in run.NewEvents)
+{
+    if (evt is WorkflowOutputEvent output)
+    {
+        Console.WriteLine($"Result: {output.Data}");
+    }
+}
+
+Console.WriteLine();
+Console.WriteLine("Streaming events:");
+
+await using var stream = await InProcessExecution.RunStreamingAsync(workflow, "Streaming demo");
+await foreach (WorkflowEvent evt in stream.WatchStreamAsync())
+{
+    switch (evt)
+    {
+        case WorkflowOutputEvent output:
+            Console.WriteLine($"  output: {output.Data}");
+            break;
+        case ExecutorCompletedEvent completed:
+            Console.WriteLine($"  executor done: {completed.ExecutorId}");
+            break;
+    }
+}