feat: add provider analytics summary

backend/app/api/stories.py

@@ -19,6 +19,7 @@ from app.schemas.story_schemas import (
     GenerateRequest,
     GenerationJobDetailResponse,
     GenerationJobSummaryResponse,
+    GenerationProviderAnalyticsResponse,
     GenerationProviderStatsResponse,
     GenerationRequest,
     GenerationResponse,
@@ -34,6 +35,7 @@ from app.services import story_service
 from app.services.generation_jobs import (
     get_generation_job_detail,
     get_story_provider_stats,
+    get_user_provider_analytics,
     list_story_generation_jobs,
 )
 from app.services.memory_service import build_enhanced_memory_context
@@ -83,6 +85,18 @@ async def get_generation_job(
     return await get_generation_job_detail(db, job_id=job_id, user_id=user.id)
 
 
+@router.get(
+    "/generations/provider-analytics",
+    response_model=GenerationProviderAnalyticsResponse,
+)
+async def get_generation_provider_analytics(
+    user: User = Depends(require_user),
+    db: AsyncSession = Depends(get_db),
+):
+    """Get provider call stats aggregated across the user's generation history."""
+    return await get_user_provider_analytics(db, user_id=user.id)
+
+
 @router.get(
     "/generations/{story_id}/jobs",
     response_model=list[GenerationJobSummaryResponse],

backend/app/schemas/story_schemas.py

@@ -222,6 +222,19 @@ class GenerationProviderStatsResponse(BaseModel):
     by_provider: list[GenerationProviderStatResponse] = Field(default_factory=list)
 
 
+class GenerationProviderAnalyticsResponse(BaseModel):
+    """Provider call stats aggregated across one user's generation history."""
+
+    total_calls: int
+    successful_calls: int
+    failed_calls: int
+    avg_latency_ms: float | None = None
+    estimated_cost_usd: float = 0.0
+    job_count: int
+    story_count: int
+    by_provider: list[GenerationProviderStatResponse] = Field(default_factory=list)
+
+
 class AchievementItem(BaseModel):
     """Achievement item returned for a story."""
 

backend/app/services/generation_jobs.py

@@ -5,7 +5,7 @@ from __future__ import annotations
 from typing import Any
 
 from fastapi import HTTPException
-from sqlalchemy import desc, select
+from sqlalchemy import desc, distinct, func, select
 from sqlalchemy.ext.asyncio import AsyncSession
 
 from app.db.models import GenerationJob, GenerationJobEvent, Story
@@ -272,28 +272,8 @@ def _as_float(value: Any) -> float | None:
     return None
 
 
-async def get_story_provider_stats(
-    db: AsyncSession,
-    *,
-    story_id: int,
-    user_id: str,
-) -> dict[str, Any]:
-    """Aggregate provider call telemetry from all user-owned jobs for one story."""
-
-    events = (
-        await db.execute(
-            select(GenerationJobEvent)
-            .join(GenerationJob, GenerationJobEvent.job_id == GenerationJob.id)
-            .where(
-                GenerationJob.story_id == story_id,
-                GenerationJob.user_id == user_id,
-                GenerationJobEvent.event_type.in_(
-                    ["provider_call_succeeded", "provider_call_failed"]
-                ),
-            )
-            .order_by(GenerationJobEvent.id)
-        )
-    ).scalars().all()
+def _aggregate_provider_events(events: list[GenerationJobEvent]) -> dict[str, Any]:
+    """Aggregate provider telemetry from provider call events."""
 
     by_key: dict[tuple[str, str], dict[str, Any]] = {}
     total_latency = 0.0
@@ -363,7 +343,6 @@ async def get_story_provider_stats(
     )
 
     return {
-        "story_id": story_id,
         "total_calls": successful_calls + failed_calls,
         "successful_calls": successful_calls,
         "failed_calls": failed_calls,
@@ -371,3 +350,66 @@ async def get_story_provider_stats(
         "estimated_cost_usd": round(total_cost, 6),
         "by_provider": by_provider,
     }
+
+
+async def get_story_provider_stats(
+    db: AsyncSession,
+    *,
+    story_id: int,
+    user_id: str,
+) -> dict[str, Any]:
+    """Aggregate provider call telemetry from all user-owned jobs for one story."""
+
+    events = (
+        await db.execute(
+            select(GenerationJobEvent)
+            .join(GenerationJob, GenerationJobEvent.job_id == GenerationJob.id)
+            .where(
+                GenerationJob.story_id == story_id,
+                GenerationJob.user_id == user_id,
+                GenerationJobEvent.event_type.in_(
+                    ["provider_call_succeeded", "provider_call_failed"]
+                ),
+            )
+            .order_by(GenerationJobEvent.id)
+        )
+    ).scalars().all()
+
+    return {"story_id": story_id, **_aggregate_provider_events(events)}
+
+
+async def get_user_provider_analytics(
+    db: AsyncSession,
+    *,
+    user_id: str,
+) -> dict[str, Any]:
+    """Aggregate provider telemetry across all stories owned by one user."""
+
+    events = (
+        await db.execute(
+            select(GenerationJobEvent)
+            .join(GenerationJob, GenerationJobEvent.job_id == GenerationJob.id)
+            .where(
+                GenerationJob.user_id == user_id,
+                GenerationJobEvent.event_type.in_(
+                    ["provider_call_succeeded", "provider_call_failed"]
+                ),
+            )
+            .order_by(GenerationJobEvent.id)
+        )
+    ).scalars().all()
+
+    job_count, story_count = (
+        await db.execute(
+            select(
+                func.count(GenerationJob.id),
+                func.count(distinct(GenerationJob.story_id)),
+            ).where(GenerationJob.user_id == user_id)
+        )
+    ).one()
+
+    return {
+        **_aggregate_provider_events(events),
+        "job_count": job_count,
+        "story_count": story_count,
+    }