diff --git a/packages/ai/CHANGELOG.md b/packages/ai/CHANGELOG.md
index 65a39da63..254d173cc 100644
--- a/packages/ai/CHANGELOG.md
+++ b/packages/ai/CHANGELOG.md
@@ -2,15 +2,16 @@
 
 ## [Unreleased]
 
+### Fixed
+
+- Fixed completed model streams retaining their provider concurrency permit until after completion became observable, without replacing provider results when lease cleanup fails ([#8284](https://github.com/can1357/oh-my-pi/pull/8284) by [@ethancawse](https://github.com/ethancawse)).
+
 ## [17.2.15] - 2026-08-12
 
 ### Fixed
 
 - Fixed an issue where AWS_BEDROCK_SKIP_AUTH failed to expose Amazon Bedrock models when AWS credential files were unavailable.
 - Fixed an issue where forceReasoningOff was ignored by Anthropic and Google transports, which allowed native thinking alongside a caller-supplied external scratchpad.
-### Fixed
-
-- Fixed completed model streams retaining their provider concurrency permit until after completion became observable, without replacing provider results when lease cleanup fails ([#8284](https://github.com/can1357/oh-my-pi/pull/8284) by [@ethancawse](https://github.com/ethancawse)).
 
 ## [17.2.14] - 2026-08-11
 
diff --git a/packages/ai/src/stream.ts b/packages/ai/src/stream.ts
index 992e9ff51..0cb66b096 100644
--- a/packages/ai/src/stream.ts
+++ b/packages/ai/src/stream.ts
@@ -658,7 +658,9 @@ function withProviderInFlightLimit<TOptions extends Pick<StreamOptions, "signal"
 			try {
 				await releaseOnce();
 			} catch (releaseError) {
-				// The lease has stopped heartbeating and stale cleanup will reap it.
+				// The lease has stopped heartbeating and stale cleanup will reap it
+				// within PROVIDER_INFLIGHT_LEASE_STALE_MS. Until then, its slot may
+				// remain unavailable and waiters rely on the fallback poll.
 				// Never replace a completed response or the provider's original error
 				// with a coordination-directory cleanup failure.
 				logger.warn("Provider in-flight permit release failed", {