Weilin Liu
c1803fcb86
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.
π± Artemis Applications Ecosystem (apps/)
This directory houses the two primary applications and user interfaces of the Artemis ecosystem.
π Subsystems Overview
apps/
βββ π οΈ admin_console/ # [Interface 1] Full-fidelity Trace Inspector & Task Control Console (FastAPI + Web)
βββ β¨ showcase_ui/ # [Interface 2] Aesthetic User Presentation & Interaction Workspace (Angular 19)
π Detailed Comparison of the Two UIs
| Dimension | π οΈ Admin & Trace Console (admin_console) |
β¨ Showcase & Workspace UI (showcase_ui) |
|---|---|---|
| Primary Audience | Developers, Test Engineers, System Admins | End Users, Customers, Product Demo Audiences |
| UI Paradigm | High-density, full-fidelity tree logs, step-by-step inspector | Dynamic Aurora Glow, Glassmorphism, dual-pane stream |
| Core Capabilities | β’ Full hierarchical Call Tree & LLM thinking inspection β’ Pre/post action screenshots & visual overlay verification β’ Video playback & step replay engine ( /api/replay)β’ Queue tasks & live state toggle |
β’ Real-time Agent thought & action progress streaming β’ Interactive natural language chat sidebar β’ Aesthetic visual representation of mobile autonomy |
| Tech Stack | Python (FastAPI) + Vanilla Responsive Web | TypeScript, Angular 19, SCSS |
| Start Command | uv run uvicorn apps.admin_console.server:app --port 8000 --reload |
cd apps/showcase_ui && npm start (Port 4200) |