Update .NET Copilot SDK recipes for explicit permission (fix for SDK v0.1.28) (#1033)

* Update .NET Copilot SDK recipes for explicit permission handling (fix breaking change in SDK v0.1.28)

* Update .NET Copilot SDK recipes for explicit permission handling

cookbook/copilot-sdk/dotnet/accessibility-report.md

@@ -64,6 +64,7 @@ await using var session = await client.CreateSessionAsync(new SessionConfig
 {
     Model = "claude-opus-4.6",
     Streaming = true,
+    OnPermissionRequest = PermissionHandler.ApproveAll,
     McpServers = new Dictionary<string, object>()
     {
         ["playwright"] =
@@ -207,6 +208,7 @@ if (generateTests == "y" || generateTests == "yes")
 The recipe configures a local MCP server that runs alongside the session:
 
 ```csharp
+OnPermissionRequest = PermissionHandler.ApproveAll,
 McpServers = new Dictionary<string, object>()
 {
     ["playwright"] = new McpLocalServerConfig

cookbook/copilot-sdk/dotnet/error-handling.md

@@ -24,7 +24,8 @@ try
     await client.StartAsync();
     var session = await client.CreateSessionAsync(new SessionConfig
     {
-        Model = "gpt-5"
+        Model = "gpt-5",
+        OnPermissionRequest = PermissionHandler.ApproveAll
     });
 
     var done = new TaskCompletionSource<string>();
@@ -76,7 +77,11 @@ catch (Exception ex)
 ## Timeout handling
 
 ```csharp
-var session = await client.CreateSessionAsync(new SessionConfig { Model = "gpt-5" });
+var session = await client.CreateSessionAsync(new SessionConfig
+{
+    Model = "gpt-5",
+    OnPermissionRequest = PermissionHandler.ApproveAll
+});
 
 try
 {
@@ -106,7 +111,11 @@ catch (OperationCanceledException)
 ## Aborting a request
 
 ```csharp
-var session = await client.CreateSessionAsync(new SessionConfig { Model = "gpt-5" });
+var session = await client.CreateSessionAsync(new SessionConfig
+{
+    Model = "gpt-5",
+    OnPermissionRequest = PermissionHandler.ApproveAll
+});
 
 // Start a request
 await session.SendAsync(new MessageOptions { Prompt = "Write a very long story..." });
@@ -141,7 +150,11 @@ Console.CancelKeyPress += async (sender, e) =>
 await using var client = new CopilotClient();
 await client.StartAsync();
 
-var session = await client.CreateSessionAsync(new SessionConfig { Model = "gpt-5" });
+var session = await client.CreateSessionAsync(new SessionConfig
+{
+    Model = "gpt-5",
+    OnPermissionRequest = PermissionHandler.ApproveAll
+});
 
 // ... do work ...
 
@@ -150,6 +163,8 @@ var session = await client.CreateSessionAsync(new SessionConfig { Model = "gpt-5
 
 ## Best practices
 
+Starting with Copilot SDK v0.1.28, permission handling is opt-in. If a session may need tool, file, or system access, set `OnPermissionRequest` explicitly when creating it.
+
 1. **Always clean up**: Use try-finally or `await using` to ensure `StopAsync()` is called
 2. **Handle connection errors**: The CLI might not be installed or running
 3. **Set appropriate timeouts**: Use `CancellationToken` for long-running requests

cookbook/copilot-sdk/dotnet/managing-local-files.md

@@ -6,6 +6,7 @@ Use Copilot to intelligently organize files in a folder based on their metadata.
 >
 > ```bash
 > dotnet run recipe/managing-local-files.cs
+> dotnet run recipe/managing-local-files.cs -- /path/to/folder
 > ```
 
 ## Example scenario
@@ -24,7 +25,8 @@ await client.StartAsync();
 // Define tools for file operations
 var session = await client.CreateSessionAsync(new SessionConfig
 {
-    Model = "gpt-5"
+    Model = "gpt-5",
+    OnPermissionRequest = PermissionHandler.ApproveAll
 });
 
 // Wait for completion
@@ -49,8 +51,8 @@ session.On(evt =>
     }
 });
 
-// Ask Copilot to organize files
+// Use an explicit folder or default to the current directory
-var targetFolder = @"C:\Users\Me\Downloads";
+var targetFolder = args.FirstOrDefault() ?? Environment.CurrentDirectory;
 
 await session.SendAsync(new MessageOptions
 {

cookbook/copilot-sdk/dotnet/multiple-sessions.md

@@ -21,9 +21,21 @@ await using var client = new CopilotClient();
 await client.StartAsync();
 
 // Create multiple independent sessions
-var session1 = await client.CreateSessionAsync(new SessionConfig { Model = "gpt-5" });
+var session1 = await client.CreateSessionAsync(new SessionConfig
-var session2 = await client.CreateSessionAsync(new SessionConfig { Model = "gpt-5" });
+{
-var session3 = await client.CreateSessionAsync(new SessionConfig { Model = "claude-sonnet-4.5" });
+    Model = "gpt-5",
+    OnPermissionRequest = PermissionHandler.ApproveAll
+});
+var session2 = await client.CreateSessionAsync(new SessionConfig
+{
+    Model = "gpt-5",
+    OnPermissionRequest = PermissionHandler.ApproveAll
+});
+var session3 = await client.CreateSessionAsync(new SessionConfig
+{
+    Model = "claude-sonnet-4.5",
+    OnPermissionRequest = PermissionHandler.ApproveAll
+});
 
 // Each session maintains its own conversation history
 await session1.SendAsync(new MessageOptions { Prompt = "You are helping with a Python project" });
@@ -49,7 +61,8 @@ Use custom IDs for easier tracking:
 var session = await client.CreateSessionAsync(new SessionConfig
 {
     SessionId = "user-123-chat",
-    Model = "gpt-5"
+    Model = "gpt-5",
+    OnPermissionRequest = PermissionHandler.ApproveAll
 });
 
 Console.WriteLine(session.SessionId); // "user-123-chat"

cookbook/copilot-sdk/dotnet/persisting-sessions.md

@@ -25,7 +25,8 @@ await client.StartAsync();
 var session = await client.CreateSessionAsync(new SessionConfig
 {
     SessionId = "user-123-conversation",
-    Model = "gpt-5"
+    Model = "gpt-5",
+    OnPermissionRequest = PermissionHandler.ApproveAll
 });
 
 await session.SendAsync(new MessageOptions { Prompt = "Let's discuss TypeScript generics" });

cookbook/copilot-sdk/dotnet/pr-visualization.md

@@ -165,6 +165,7 @@ await client.StartAsync();
 var session = await client.CreateSessionAsync(new SessionConfig
 {
     Model = "gpt-5",
+    OnPermissionRequest = PermissionHandler.ApproveAll,
     SystemMessage = new SystemMessageConfig
     {
         Content = $"""

cookbook/copilot-sdk/dotnet/ralph-loop.md

@@ -58,7 +58,11 @@ try
 
         // Fresh session each iteration — context isolation is the point
         var session = await client.CreateSessionAsync(
-            new SessionConfig { Model = "gpt-5.1-codex-mini" });
+            new SessionConfig
+            {
+                Model = "gpt-5.1-codex-mini",
+                OnPermissionRequest = PermissionHandler.ApproveAll
+            });
         try
         {
             var done = new TaskCompletionSource<string>();
@@ -125,8 +129,7 @@ try
                 // Pin the agent to the project directory
                 WorkingDirectory = Environment.CurrentDirectory,
                 // Auto-approve tool calls for unattended operation
-                OnPermissionRequest = (_, _) => Task.FromResult(
+                OnPermissionRequest = PermissionHandler.ApproveAll,
-                    new PermissionRequestResult { Kind = "approved" }),
             });
         try
         {

cookbook/copilot-sdk/dotnet/recipe/accessibility-report.cs

@@ -32,6 +32,7 @@ await using var session = await client.CreateSessionAsync(new SessionConfig
 {
   Model = "claude-opus-4.6",
   Streaming = true,
+  OnPermissionRequest = PermissionHandler.ApproveAll,
   McpServers = new Dictionary<string, object>()
   {
     ["playwright"] =

cookbook/copilot-sdk/dotnet/recipe/error-handling.cs

@@ -10,7 +10,8 @@ try
     await client.StartAsync();
     var session = await client.CreateSessionAsync(new SessionConfig
     {
-        Model = "gpt-5"
+        Model = "gpt-5",
+        OnPermissionRequest = PermissionHandler.ApproveAll
     });
 
     var done = new TaskCompletionSource<string>();

cookbook/copilot-sdk/dotnet/recipe/managing-local-files.cs

@@ -10,7 +10,8 @@ await client.StartAsync();
 // Define tools for file operations
 var session = await client.CreateSessionAsync(new SessionConfig
 {
-    Model = "gpt-5"
+    Model = "gpt-5",
+    OnPermissionRequest = PermissionHandler.ApproveAll
 });
 
 // Wait for completion
@@ -36,8 +37,7 @@ session.On(evt =>
 });
 
 // Ask Copilot to organize files
-// Change this to your target folder
+var targetFolder = args.FirstOrDefault() ?? Environment.CurrentDirectory;
-var targetFolder = @"C:\Users\Me\Downloads";
 
 await session.SendAsync(new MessageOptions
 {

cookbook/copilot-sdk/dotnet/recipe/multiple-sessions.cs

@@ -7,9 +7,21 @@ await using var client = new CopilotClient();
 await client.StartAsync();
 
 // Create multiple independent sessions
-var session1 = await client.CreateSessionAsync(new SessionConfig { Model = "gpt-5" });
+var session1 = await client.CreateSessionAsync(new SessionConfig
-var session2 = await client.CreateSessionAsync(new SessionConfig { Model = "gpt-5" });
+{
-var session3 = await client.CreateSessionAsync(new SessionConfig { Model = "claude-sonnet-4.5" });
+    Model = "gpt-5",
+    OnPermissionRequest = PermissionHandler.ApproveAll
+});
+var session2 = await client.CreateSessionAsync(new SessionConfig
+{
+    Model = "gpt-5",
+    OnPermissionRequest = PermissionHandler.ApproveAll
+});
+var session3 = await client.CreateSessionAsync(new SessionConfig
+{
+    Model = "claude-sonnet-4.5",
+    OnPermissionRequest = PermissionHandler.ApproveAll
+});
 
 Console.WriteLine("Created 3 independent sessions");
 

cookbook/copilot-sdk/dotnet/recipe/persisting-sessions.cs

@@ -10,7 +10,8 @@ await client.StartAsync();
 var session = await client.CreateSessionAsync(new SessionConfig
 {
     SessionId = "user-123-conversation",
-    Model = "gpt-5"
+    Model = "gpt-5",
+    OnPermissionRequest = PermissionHandler.ApproveAll
 });
 
 await session.SendAsync(new MessageOptions { Prompt = "Let's discuss TypeScript generics" });

cookbook/copilot-sdk/dotnet/recipe/pr-visualization.cs

@@ -132,6 +132,7 @@ await client.StartAsync();
 var session = await client.CreateSessionAsync(new SessionConfig
 {
     Model = "gpt-5",
+    OnPermissionRequest = PermissionHandler.ApproveAll,
     SystemMessage = new SystemMessageConfig
     {
         Content = $"""

cookbook/copilot-sdk/dotnet/recipe/ralph-loop.cs

@@ -48,8 +48,7 @@ try
                 // Pin the agent to the project directory
                 WorkingDirectory = Environment.CurrentDirectory,
                 // Auto-approve tool calls for unattended operation
-                OnPermissionRequest = (_, _) => Task.FromResult(
+                OnPermissionRequest = PermissionHandler.ApproveAll,
-                    new PermissionRequestResult { Kind = "approved" }),
             });
 
         try