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.
109 lines
4.0 KiB
Python
109 lines
4.0 KiB
Python
# 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 json
|
|
import traceback
|
|
from fastapi import APIRouter, HTTPException
|
|
from fastapi.responses import PlainTextResponse
|
|
|
|
try:
|
|
from admin_console.core.config import TEST_OUTPUTS_DIR
|
|
from admin_console.database.repositories.step_repository import step_repo
|
|
from admin_console.database.repositories.trace_repository import trace_repo
|
|
from admin_console.services.media_service import media_service
|
|
except ImportError:
|
|
from apps.admin_console.core.config import TEST_OUTPUTS_DIR
|
|
from apps.admin_console.database.repositories.step_repository import step_repo
|
|
from apps.admin_console.database.repositories.trace_repository import trace_repo
|
|
from apps.admin_console.services.media_service import media_service
|
|
|
|
|
|
router = APIRouter(tags=["steps"])
|
|
|
|
|
|
@router.get("/api/sessions/{session_id}/steps")
|
|
async def get_session_steps(session_id: str, client: str | None = None):
|
|
try:
|
|
return step_repo.get_session_steps(session_id, client=client)
|
|
except Exception as e:
|
|
raise HTTPException(status_code=500, detail=str(e))
|
|
|
|
|
|
@router.get("/api/steps/{step_id}/traces")
|
|
async def get_step_traces_endpoint(step_id: str):
|
|
try:
|
|
session_id = step_repo.get_step_session_id(step_id)
|
|
if not session_id:
|
|
raise HTTPException(status_code=404, detail="Step not found")
|
|
return trace_repo.get_step_traces_tree(session_id, step_id)
|
|
except HTTPException as e:
|
|
raise e
|
|
except Exception as e:
|
|
raise HTTPException(status_code=500, detail=str(e))
|
|
|
|
|
|
def _resolve_trace_db_path(session_id: str | None, step_number: int | None):
|
|
if session_id and step_number is not None:
|
|
sandbox_db_path = (
|
|
TEST_OUTPUTS_DIR
|
|
/ f"{session_id}_step_{step_number:02d}"
|
|
/ "temp_traces"
|
|
/ "data_engine.db"
|
|
)
|
|
if sandbox_db_path.exists():
|
|
return sandbox_db_path
|
|
return None
|
|
|
|
|
|
@router.get("/api/traces/{trace_id}")
|
|
async def get_trace(trace_id: str, session_id: str = None, step_number: int = None):
|
|
try:
|
|
db_path = _resolve_trace_db_path(session_id, step_number)
|
|
trace_dict = trace_repo.get_trace_by_id(trace_id, db_path=db_path)
|
|
if not trace_dict:
|
|
raise HTTPException(status_code=404, detail="Trace not found")
|
|
|
|
if trace_dict.get("payload"):
|
|
try:
|
|
payload_obj = json.loads(trace_dict["payload"])
|
|
trace_dict["payload"] = media_service.unwrap_payload(payload_obj)
|
|
except Exception:
|
|
pass
|
|
|
|
return trace_dict
|
|
except HTTPException as e:
|
|
raise e
|
|
except Exception as e:
|
|
traceback.print_exc()
|
|
raise HTTPException(status_code=500, detail=str(e))
|
|
|
|
|
|
@router.get("/api/traces/{trace_id}/download")
|
|
async def download_trace(trace_id: str, session_id: str = None, step_number: int = None):
|
|
try:
|
|
db_path = _resolve_trace_db_path(session_id, step_number)
|
|
trace_dict = trace_repo.get_trace_by_id(trace_id, db_path=db_path)
|
|
if not trace_dict or not trace_dict.get("payload"):
|
|
raise HTTPException(status_code=404, detail="Payload not found")
|
|
|
|
return PlainTextResponse(
|
|
trace_dict["payload"],
|
|
headers={"Content-Disposition": f'attachment; filename="trace_{trace_id}.json"'},
|
|
)
|
|
except HTTPException as e:
|
|
raise e
|
|
except Exception as e:
|
|
traceback.print_exc()
|
|
raise HTTPException(status_code=500, detail=str(e))
|