From ef3ee26031fcfb8eb30f13d3afc9981d181d406b Mon Sep 17 00:00:00 2001
From: moe-berri <moe@berri.ai>
Date: Thu, 3 Sep 2026 17:11:44 -0700
Subject: [PATCH] chore: document fusion fault boundaries

---
 litellm/fusion_router.py                           | 6 +++---
 litellm/proxy/spend_tracking/budget_reservation.py | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/litellm/fusion_router.py b/litellm/fusion_router.py
index a2cb359e28f..8082dd31cae 100644
--- a/litellm/fusion_router.py
+++ b/litellm/fusion_router.py
@@ -903,7 +903,7 @@ class FusionRouter:
                 )
                 if isinstance(result, BaseModel):
                     result = result.model_dump()  # rebind-ok: orchestration branch state
-            except Exception as exc:
+            except Exception as exc:  # noqa: BLE001  # provider search failures become advisory tool results
                 result = {  # mutable-ok: local provider payload
                     "status": "error",
                     "error": type(exc).__name__,
@@ -1071,7 +1071,7 @@ class FusionRouter:
                 ),
                 timeout=self.config.panel_timeout_seconds,
             )
-        except Exception as exc:
+        except Exception as exc:  # noqa: BLE001  # one provider failure must not cancel the parallel panel
             return FusionPanelFailure(model=model, error_type=type(exc).__name__, failure_reason=_failure_reason(exc))
         if not isinstance(response, ModelResponse) or (content := _response_text(response)) is None:
             return FusionPanelFailure(
@@ -1116,7 +1116,7 @@ class FusionRouter:
                 ),
                 timeout=self.config.panel_timeout_seconds,
             )
-        except Exception:
+        except Exception:  # noqa: BLE001  # analysis is optional when its provider call fails
             return None
         return _parse_analysis(_response_text(response)) if isinstance(response, ModelResponse) else None
 
diff --git a/litellm/proxy/spend_tracking/budget_reservation.py b/litellm/proxy/spend_tracking/budget_reservation.py
index bb8b923ffcf..1d78de6b873 100644
--- a/litellm/proxy/spend_tracking/budget_reservation.py
+++ b/litellm/proxy/spend_tracking/budget_reservation.py
@@ -1200,7 +1200,7 @@ def _estimate_fusion_search_cost(
                 optional_params=optional_params,
             )
             estimates.append(maximum_searches * (input_cost + output_cost))
-    except Exception:
+    except Exception:  # noqa: BLE001  # unknown search pricing makes the reservation estimate unavailable
         verbose_proxy_logger.debug(
             "Unable to load Fusion search cost info for budget reservation",
             exc_info=True,