Extend session visibility in admin dashboard with configurable retention

- Add retention_seconds param to SessionTracker (default 30min)
- Sessions now stay visible 30min after last request instead of 2min
- Add SESSION_RETENTION_MINUTES env var for configuration
- Show Active/Idle status in admin UI (<5min vs >5min idle)

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

api/admin.py

@@ -66,6 +66,10 @@ def _get_admin_data() -> dict[str, Any]:
                 "last_activity_seconds": last_activity_seconds,
                 "last_activity_display": _format_time(last_activity_seconds),
                 "requests_per_minute": int(req_per_min),
+                "status": "Active" if last_activity_seconds < 300 else "Idle",
+                "status_class": "status-active"
+                if last_activity_seconds < 300
+                else "status-idle",
             }
         )
 

api/services.py

@@ -11,7 +11,7 @@ from fastapi import HTTPException, Request
 from fastapi.responses import StreamingResponse
 from loguru import logger
 
-from config.settings import Settings
+from config.settings import Settings, get_settings
 from core.anthropic import get_token_count, get_user_facing_error_message
 from core.anthropic.sse import ANTHROPIC_SSE_RESPONSE_HEADERS, format_sse_event
 from core.session_tracker import SessionTracker
@@ -132,7 +132,10 @@ class ClaudeProxyService:
         self._provider_getter = provider_getter
         self._model_router = model_router or ModelRouter(settings)
         self._token_counter = token_counter
-        self._session_tracker = SessionTracker.get_instance()
+        settings_local = get_settings()
+        self._session_tracker = SessionTracker.get_instance(
+            retention_seconds=settings_local.session_retention_minutes * 60
+        )
 
     def create_message(self, request: Request, request_data: MessagesRequest) -> object:
         """Create a message response or streaming response with optional failover."""

config/settings.py

@@ -142,6 +142,9 @@ class Settings(BaseSettings):
     )
     # ==================== Zen/OpenCode Config ====================
     zen_api_key: str = Field(default="", validation_alias="ZEN_API_KEY")
+    session_retention_minutes: int = Field(
+        default=30, validation_alias="SESSION_RETENTION_MINUTES"
+    )
     zen_base_url: str = Field(
         default="https://opencode.ai/zen", validation_alias="ZEN_BASE_URL"
     )

core/session_tracker.py

@@ -6,7 +6,7 @@ import asyncio
 import time
 from collections import defaultdict
 from dataclasses import dataclass
-from typing import ClassVar
+from typing import ClassVar, cast
 
 from loguru import logger
 
@@ -56,6 +56,7 @@ class SessionTracker:
         max_sessions: int = 50,
         window_seconds: float = 60.0,
         per_session_rate_limit: int = 30,
+        retention_seconds: float | None = None,
     ):
         if hasattr(self, "_initialized"):
             return
@@ -68,14 +69,18 @@ class SessionTracker:
         self._max_sessions = max_sessions
         self._window_seconds = window_seconds
         self._per_session_rate_limit = per_session_rate_limit
+        self._retention_seconds = (
+            retention_seconds if retention_seconds is not None else window_seconds * 2
+        )
         self._lock = asyncio.Lock()
         self._initialized = True
 
         logger.info(
-            "SessionTracker initialized (max_sessions={}, window={}s, per_session_limit={}/min)",
+            "SessionTracker initialized (max_sessions={}, window={}s, per_session_limit={}/min, retention={}s)",
             max_sessions,
             window_seconds,
             per_session_rate_limit,
+            self._retention_seconds,
         )
 
     @classmethod
@@ -93,7 +98,7 @@ class SessionTracker:
     def _cleanup_old_sessions(self) -> None:
         """Remove sessions with no recent activity (must be called with lock held)."""
         now = time.monotonic()
-        cutoff = now - (self._window_seconds * 2)
+        cutoff = now - self._retention_seconds
         to_remove = [
             sid
             for sid, state in self._sessions.items()
@@ -129,7 +134,7 @@ class SessionTracker:
 
     async def track_request(self, session_id: str, provider_id: str) -> None:
         """Record a request for a session to a provider (async-safe)."""
-        self._track_request_sync(session_id, provider_id)
+        self.track_request_sync(session_id, provider_id)
 
     def track_request_sync(self, session_id: str, provider_id: str) -> None:
         """Record a request for a session to a provider (sync version for hot path)."""
@@ -151,7 +156,7 @@ class SessionTracker:
     async def track_request_async(self, session_id: str, provider_id: str) -> None:
         """Async version with lock for when called from async contexts that need guarantees."""
         async with self._lock:
-            self._track_request_sync(session_id, provider_id)
+            self.track_request_sync(session_id, provider_id)
 
     async def release_request(self, session_id: str, provider_id: str) -> None:
         """Release a request slot when streaming completes."""
@@ -214,7 +219,7 @@ class SessionTracker:
     def get_all_session_loads(self) -> dict[str, SessionLoad]:
         """Get load information for all active sessions."""
         return {
-            sid: self.get_session_load(sid)
+            sid: cast(SessionLoad, self.get_session_load(sid))
             for sid in self._sessions
             if self.get_session_load(sid) is not None
         }

templates/admin.html

@@ -93,6 +93,12 @@
         .status-limited {
             color: #f85149;
         }
+        .status-active {
+            color: #3fb950;
+        }
+        .status-idle {
+            color: #8b949e;
+        }
         .empty {
             color: #8b949e;
             font-style: italic;
@@ -140,6 +146,7 @@
                         <th>Providers</th>
                         <th>Last Active</th>
                         <th>Req/Min</th>
+                        <th>Status</th>
                     </tr>
                 </thead>
                 <tbody>
@@ -154,6 +161,7 @@
                         </td>
                         <td>{{ session.last_activity_display }}</td>
                         <td class="number">{{ session.requests_per_minute }}</td>
+                        <td class="{{ session.status_class }}">{{ session.status }}</td>
                     </tr>
                     {% endfor %}
                 </tbody>