Document expected chat response write suppression

Copilot · BenjaminMichaelis · web-flow · commit ae6bf1037e81 · 2026-05-13T09:51:37.000Z
Agent-Logs-Url: https://github.com/IntelliTect/EssentialCSharp.Web/sessions/ca7b0afb-1731-4a50-ac2e-b4d7152c972a Co-authored-by: BenjaminMichaelis <22186029+BenjaminMichaelis@users.noreply.github.com>
diff --git a/EssentialCSharp.Web/Controllers/ChatController.cs b/EssentialCSharp.Web/Controllers/ChatController.cs
@@ -153,12 +153,15 @@ public async Task StreamMessage([FromBody] ChatMessageRequest request, Cancellat
                 }
                 catch (OperationCanceledException) when (cancellationToken.IsCancellationRequested || HttpContext.RequestAborted.IsCancellationRequested)
                 {
+                    // Best-effort write during an aborted request — no response body can be delivered.
                 }
                 catch (IOException) when (HttpContext.RequestAborted.IsCancellationRequested)
                 {
+                    // Expected client disconnect while attempting a best-effort error response write.
                 }
                 catch (ObjectDisposedException) when (HttpContext.RequestAborted.IsCancellationRequested)
                 {
+                    // Response stream can already be disposed after an abrupt client disconnect.
                 }
             }
             else
@@ -192,12 +195,15 @@ public async Task StreamMessage([FromBody] ChatMessageRequest request, Cancellat
             }
             catch (OperationCanceledException) when (cancellationToken.IsCancellationRequested || HttpContext.RequestAborted.IsCancellationRequested)
             {
+                // Best-effort write during an aborted request — no response body can be delivered.
             }
             catch (IOException) when (HttpContext.RequestAborted.IsCancellationRequested)
             {
+                // Expected client disconnect while attempting a best-effort error response write.
             }
             catch (ObjectDisposedException) when (HttpContext.RequestAborted.IsCancellationRequested)
             {
+                // Response stream can already be disposed after an abrupt client disconnect.
             }
         }
         catch (Exception ex)

Original file line number	Diff line number	Diff line change
`@@ -153,12 +153,15 @@ public async Task StreamMessage([FromBody] ChatMessageRequest request, Cancellat`
`153`	`153`	`}`
`154`	`154`	`catch (OperationCanceledException) when (cancellationToken.IsCancellationRequested \|\| HttpContext.RequestAborted.IsCancellationRequested)`
`155`	`155`	`{`
	`156`	`+ // Best-effort write during an aborted request — no response body can be delivered.`
`156`	`157`	`}`
`157`	`158`	`catch (IOException) when (HttpContext.RequestAborted.IsCancellationRequested)`
`158`	`159`	`{`
	`160`	`+ // Expected client disconnect while attempting a best-effort error response write.`
`159`	`161`	`}`
`160`	`162`	`catch (ObjectDisposedException) when (HttpContext.RequestAborted.IsCancellationRequested)`
`161`	`163`	`{`
	`164`	`+ // Response stream can already be disposed after an abrupt client disconnect.`
`162`	`165`	`}`
`163`	`166`	`}`
`164`	`167`	`else`
`@@ -192,12 +195,15 @@ public async Task StreamMessage([FromBody] ChatMessageRequest request, Cancellat`
`192`	`195`	`}`
`193`	`196`	`catch (OperationCanceledException) when (cancellationToken.IsCancellationRequested \|\| HttpContext.RequestAborted.IsCancellationRequested)`
`194`	`197`	`{`
	`198`	`+ // Best-effort write during an aborted request — no response body can be delivered.`
`195`	`199`	`}`
`196`	`200`	`catch (IOException) when (HttpContext.RequestAborted.IsCancellationRequested)`
`197`	`201`	`{`
	`202`	`+ // Expected client disconnect while attempting a best-effort error response write.`
`198`	`203`	`}`
`199`	`204`	`catch (ObjectDisposedException) when (HttpContext.RequestAborted.IsCancellationRequested)`
`200`	`205`	`{`
	`206`	`+ // Response stream can already be disposed after an abrupt client disconnect.`
`201`	`207`	`}`
`202`	`208`	`}`
`203`	`209`	`catch (Exception ex)`