feat(console): add Artemis Admin & Trace Console backend and management plane

Introduces the comprehensive developer/administrator control plane and trace
inspection console backend for the ARTEMIS mobile automation platform.

Key Features & Backend Architecture:
- Core Server & Modular Routing:
  * FastAPI modular architecture with dedicated routers for sessions, steps, tasks, media, stream, and replay.
  * Multi-layer repository pattern with SQLite persistence for sessions, traces, and step data.
- Task Control & Queue Management:
  * FIFO asynchronous task queue service with support for single/batch goal execution and profile selection (Flash / Pro).
  * Session lifecycle controls (run, pause, resume, stop, clear queue).
  * Startup orphan cleanup and automatic older replay archiving.
- Live Telemetry & IPC Communication:
  * High-performance IPC server for streaming real-time execution logs, agent thoughts, and tool invocations.
  * Server-Sent Events (SSE) /api/stream/{session_id} endpoint for live UI updates.
- Real-Time Device Streaming:
  * Live ADB screen capture and MJPEG frame generator (/api/stream/device-live).
  * Device connectivity and state inspection endpoint (/api/stream/device-state).
- Trace Inspection & Step Replay Engine:
  * Hierarchical call tree inspection, pre/post step screenshots, and action overlay metadata.
  * Isolated single-step replay manager (/api/replay) for interactive debugging and validation.

apps/admin_console/routers/replay.py

@@ -0,0 +1,91 @@
+# Copyright 2026 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import traceback
+from fastapi import APIRouter, HTTPException
+
+try:
+    from admin_console.core.config import WORKSPACE_ROOT
+    from admin_console.schemas.task_schema import ReplayRequest
+    from admin_console.replay_manager import ReplayManager
+except ImportError:
+    from apps.admin_console.core.config import WORKSPACE_ROOT
+    from apps.admin_console.schemas.task_schema import ReplayRequest
+    from apps.admin_console.replay_manager import ReplayManager
+
+replay_manager = ReplayManager(WORKSPACE_ROOT)
+
+
+router = APIRouter(tags=["replay"])
+
+
+@router.get("/api/devices")
+async def list_devices():
+    """Dynamically queries the ADB server for connected Android devices."""
+    return replay_manager.list_devices()
+
+
+@router.get("/api/replay/tools")
+async def get_replay_tools():
+    """Returns the list of registered tools available for replay."""
+    return replay_manager.get_replay_tools()
+
+
+@router.get("/api/replay/config")
+async def get_replay_config(tool_name: str = "ask_explorer"):
+    """Returns the parameter list and types of the selected tool logic."""
+    try:
+        return replay_manager.get_replay_config(tool_name)
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.get("/api/sessions/{session_id}/replay_steps")
+async def get_replay_steps(session_id: str):
+    """Loads and formats metadata for all chunked steps in the session."""
+    try:
+        return replay_manager.get_replay_steps(session_id)
+    except FileNotFoundError as e:
+        raise HTTPException(status_code=404, detail=str(e))
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.post("/api/sessions/{session_id}/steps/{step_number}/replay")
+async def trigger_step_replay_endpoint(session_id: str, step_number: int, req: ReplayRequest):
+    """Triggers sandbox execution of step replay and returns the resulting traces trees."""
+    try:
+        return await replay_manager.run_step_replay(
+            session_id=session_id,
+            step_number=step_number,
+            device_id=req.device_id,
+            user_submits=req.user_submits,
+            tool_name=req.tool_name,
+            replay_id=req.replay_id,
+        )
+    except Exception as e:
+        traceback.print_exc()
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.get("/api/sessions/{session_id}/steps/{step_number}/replay_traces")
+async def get_step_replay_traces_endpoint(
+    session_id: str, step_number: int, tool_name: str = "ask_explorer"
+):
+    """Retrieves previously generated step replay traces if they exist."""
+    try:
+        return replay_manager.get_step_replay_traces(session_id, step_number, tool_name)
+    except Exception as e:
+        traceback.print_exc()
+        raise HTTPException(status_code=500, detail=str(e))