From a814b201783cd7b73fdc20b6f6dcb813df573580 Mon Sep 17 00:00:00 2001
From: pander <>
Date: Thu, 23 Apr 2026 09:18:47 +0800
Subject: [PATCH] fix(agent): classify 'overloaded' messages as server
 overload, not rate_limit

Closes #14038
---
 agent/error_classifier.py | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/agent/error_classifier.py b/agent/error_classifier.py
index 04875b6a5..a4c1b0e1b 100644
--- a/agent/error_classifier.py
+++ b/agent/error_classifier.py
@@ -773,6 +773,14 @@ def _classify_by_message(
             should_fallback=True,
         )
 
+    # Overloaded / server-busy patterns — must come BEFORE rate_limit check
+    # so that "overloaded" messages don't incorrectly trigger credential rotation.
+    if any(p in error_msg for p in ("overloaded", "temporarily overloaded", "service is temporarily overloaded")):
+        return result_fn(
+            FailoverReason.overloaded,
+            retryable=True,
+        )
+
     # Billing patterns
     if any(p in error_msg for p in _BILLING_PATTERNS):
         return result_fn(