Refactor: implemented Repository Factory and Async Mutator Engine. Decoupled storage logic and enforced Dependency Injection across CLI and Web API. Updated documentation.

decnet/web/router/stream/api_stream_events.py

@@ -6,6 +6,7 @@ from typing import AsyncGenerator, Optional
 from fastapi import APIRouter, Depends, Query, Request
 from fastapi.responses import StreamingResponse
 
+from decnet.env import DECNET_DEVELOPER
 from decnet.web.dependencies import get_stream_user, repo
 
 log = logging.getLogger(__name__)
@@ -14,20 +15,30 @@ router = APIRouter()
 
 
 @router.get("/stream", tags=["Observability"],
-    responses={401: {"description": "Not authenticated"}, 422: {"description": "Validation error"}},)
+    responses={
+        200: {
+            "content": {"text/event-stream": {}},
+            "description": "Real-time Server-Sent Events (SSE) stream"
+        },
+        401: {"description": "Could not validate credentials"},
+        422: {"description": "Validation error"}
+    },
+)
 async def stream_events(
-    request: Request, 
-    last_event_id: int = Query(0, alias="lastEventId"), 
+    request: Request,
+    last_event_id: int = Query(0, alias="lastEventId"),
     search: Optional[str] = None,
     start_time: Optional[str] = None,
     end_time: Optional[str] = None,
+    max_output: Optional[int] = Query(None, alias="maxOutput"),
     current_user: str = Depends(get_stream_user)
 ) -> StreamingResponse:
-    
+
     async def event_generator() -> AsyncGenerator[str, None]:
         last_id = last_event_id
         stats_interval_sec = 10
         loops_since_stats = 0
+        emitted_chunks = 0
         try:
             if last_id == 0:
                 last_id = await repo.get_max_log_id()
@@ -42,6 +53,12 @@ async def stream_events(
             yield f"event: message\ndata: {json.dumps({'type': 'histogram', 'data': histogram})}\n\n"
 
             while True:
+                if DECNET_DEVELOPER and max_output is not None:
+                    emitted_chunks += 1
+                    if emitted_chunks > max_output:
+                        log.debug("Developer mode: max_output reached (%d), closing stream", max_output)
+                        break
+
                 if await request.is_disconnected():
                     break
 
@@ -65,6 +82,7 @@ async def stream_events(
                     loops_since_stats = 0
 
                 loops_since_stats += 1
+
                 await asyncio.sleep(1)
         except asyncio.CancelledError:
             pass