sync: 188 file da Baida98/AI@143f6f8b (2026-08-26 07:02 UTC) [deploy-all]

api/providers.py

@@ -213,6 +213,42 @@ async def health_manager_status(role: AuthRole = Depends(require_role(AuthRole.M
     from .health_manager import health_manager
     return await health_manager.get_status()
 
+def build_server_provider_readiness_payload(
+    cached_payload: dict | None,
+    configured_count: int,
+) -> dict:
+    """Crea una risposta pubblica minima per il gate UI senza effettuare probe.
+
+    Se la cache della health ha provider positivi, usa quel dato recente. Altrimenti
+    espone solo l’esistenza di provider configurati nel runtime: nessuna chiave,
+    quota, modello, errore upstream o identificativo profilo lascia il server.
+    """
+    providers = cached_payload.get("providers", []) if isinstance(cached_payload, dict) else []
+    healthy_count = sum(
+        1 for provider in providers
+        if isinstance(provider, dict) and provider.get("ok") is True
+    )
+    if healthy_count > 0:
+        return {"configured": True, "available": healthy_count, "source": "cache"}
+    return {
+        "configured": configured_count > 0,
+        "available": max(configured_count, 0),
+        "source": "configured",
+    }
+
+
+@router.get('/api/ai/readiness')
+async def ai_provider_readiness(role: AuthRole = Depends(require_role(AuthRole.MACHINE))):
+    """Readiness economica per il gate pubblico, senza chiamare provider esterni."""
+    configured_count = 0
+    try:
+        from models.ai_client import AIClient
+        configured_count = len(AIClient().providers)
+    except Exception as exc:
+        _logger.warning("[providers] readiness configuration unavailable: %s", type(exc).__name__)
+    return build_server_provider_readiness_payload(_ai_health_cache.get("data"), configured_count)
+
+
 @router.get('/api/ai/health')
 async def ai_provider_health(role: AuthRole = Depends(require_role(AuthRole.MACHINE))):  # GAP-1-fix
     """Testa tutti i provider AI in parallelo — risultati cachati 60s."""

tests/test_provider_heartbeat_state.py

@@ -24,6 +24,24 @@ class ProviderHeartbeatStateTests(unittest.IsolatedAsyncioTestCase):
             state._heartbeat_state.clear()
             state._heartbeat_state.update(original)
 
+    def test_readiness_prefers_positive_cached_health_without_exposing_provider_details(self):
+        payload = providers.build_server_provider_readiness_payload(
+            {"providers": [{"ok": True, "name": "hidden", "profile": "secret-profile"}, {"ok": False}]},
+            configured_count=0,
+        )
+
+        self.assertEqual(payload, {"configured": True, "available": 1, "source": "cache"})
+        self.assertNotIn("name", payload)
+        self.assertNotIn("profile", payload)
+
+    def test_readiness_uses_configuration_when_health_cache_is_empty(self):
+        payload = providers.build_server_provider_readiness_payload(None, configured_count=3)
+        self.assertEqual(payload, {"configured": True, "available": 3, "source": "configured"})
+
+    def test_readiness_reports_unconfigured_without_triggering_a_probe(self):
+        payload = providers.build_server_provider_readiness_payload({"providers": [{"ok": False}]}, configured_count=0)
+        self.assertEqual(payload, {"configured": False, "available": 0, "source": "configured"})
+
     async def test_start_heartbeat_creates_a_single_background_task(self):
         original_task = providers._heartbeat_task
         providers._heartbeat_task = None