feat: introduce MCP server, cross-platform runtime, and Showcase UI reorganization

- Showcase UI Reorganization:
  * Move web UI dashboard from root directory into apps/showcase_ui/ for cleaner project structure
  * Add 'artemis ui' CLI command (artemis/interfaces/cli/commands/ui.py) and launcher scripts for the interactive showcase console
- Standalone MCP Server & Notifiers (mcp_server/):
  * Implement dedicated MCP server package with mobile automation tools (device_state, inspect_trace, task_manager, task_runner)
  * Add multi-channel notifiers (AgentAPI, Desktop notifications, Webhooks, File output, and Composite routing)
  * Introduce background task runner and trace store for autonomous mobile execution monitoring
- Cross-Platform Runtime & Toolchain Support:
  * Add artemis/platform/ with OS-specific implementations for Linux, macOS (Darwin), and Windows
  * Add artemis/runtime/supervisor.py for resilient process and agent runtime supervision
  * Add artemis/toolchain/ with dependency resolution and SDK descriptors
  * Add cross-platform launcher scripts (start.sh, start.bat) and installer scripts (scripts/install_deps.*)
- Core Enhancements & Diagnostics:
  * Enhance coordinate normalization, OCR API fallback, and perception pipeline
  * Add credential validation (credentials_validator.py) and system diagnostics
  * Update bilingual documentation (README.md, README_CN.md) and architecture diagrams
- Test Suite Expansion:
  * Add integration tests for cloud gateway, remote ADB, and Artemis login
  * Add unit tests covering core diagnostics, platform detection, toolchain, credentials validator, optional OCR, and MCP tools

apps/admin_console/database/connection.py

@@ -15,7 +15,6 @@
 from contextlib import contextmanager
 from pathlib import Path
 import sqlite3
-from fastapi import HTTPException
 
 try:
     from admin_console.core.config import DB_PATH
@@ -23,13 +22,29 @@ except ImportError:
     from apps.admin_console.core.config import DB_PATH
 
 
+_initialized_dbs = set()
+
+
 def get_db(db_path: Path | None = None) -> sqlite3.Connection:
     """Returns a SQLite connection with timeout and Row row_factory."""
     path = db_path or DB_PATH
-    if not path.exists():
-        raise HTTPException(status_code=500, detail=f"Database not found at {path}")
+    path_key = str(path)
+    if path_key not in _initialized_dbs:
+        path.parent.mkdir(parents=True, exist_ok=True)
+        try:
+            from artemis.data_engine.storage import StorageManager
+
+            StorageManager(db_path=path, base_trace_dir=path.parent)
+            _initialized_dbs.add(path_key)
+        except Exception:
+            pass
     conn = sqlite3.connect(path, timeout=10.0)
     conn.row_factory = sqlite3.Row
+    try:
+        conn.execute("PRAGMA journal_mode=WAL")
+        conn.execute("PRAGMA busy_timeout=10000")
+    except Exception:
+        pass
     return conn
 
 

apps/admin_console/database/repositories/__init__.py

@@ -10,4 +10,4 @@
 # 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.
+# limitations under the License.

apps/admin_console/database/repositories/session_repository.py

@@ -33,13 +33,6 @@ class SessionRepository:
             cursor.execute("SELECT * FROM sessions ORDER BY start_time DESC")
             return [dict(r) for r in cursor.fetchall()]
 
-    def get_session_by_id(self, session_id: str) -> dict[str, Any] | None:
-        with db_session(self.db_path) as conn:
-            cursor = conn.cursor()
-            cursor.execute("SELECT * FROM sessions WHERE session_id = ?", (str(session_id),))
-            row = cursor.fetchone()
-            return dict(row) if row else None
-
     def get_video_recordings_map(self) -> dict[str, str]:
         with db_session(self.db_path) as conn:
             cursor = conn.cursor()

apps/admin_console/database/repositories/step_repository.py

@@ -13,6 +13,7 @@
 # limitations under the License.
 
 import json
+import re
 from typing import Any
 
 try:
@@ -183,9 +184,27 @@ class StepRepository:
             )
 
         args = payload_obj.get("args", payload_obj)
-        if isinstance(args, dict):
-            return {"args": self._clean_value(args)}
-        return {"args": self._clean_value(args)}
+        cleaned_args = (
+            self._clean_value(args) if isinstance(args, dict) else self._clean_value(args)
+        )
+        result_payload: dict[str, Any] = {"args": cleaned_args}
+
+        # Extract structured action execution results
+        res = payload_obj.get("result")
+        if isinstance(res, dict):
+            if res.get("post_image_name"):
+                result_payload["post_image_name"] = res["post_image_name"]
+            if res.get("pre_image_name"):
+                result_payload["pre_image_name"] = res["pre_image_name"]
+            if res.get("outcome"):
+                result_payload["outcome"] = res["outcome"]
+        elif res:
+            res_str = str(res)
+            match = re.search(r"([a-f0-9]{64})", res_str)
+            if match:
+                result_payload["post_image_name"] = match.group(1)
+
+        return result_payload
 
     def get_session_steps(self, session_id: str, client: str | None = None) -> list[dict[str, Any]]:
         with db_session(self.db_path) as conn:
@@ -221,7 +240,7 @@ class StepRepository:
                 if pre_img and step_dict.get("post_image_name") == pre_img:
                     step_dict["post_image_name"] = None
 
-                # Fetch generic tool traces for this step
+                # Fetch action and generic tool traces for this step
                 step_id = step_dict.get("step_id")
                 if step_id:
                     cursor.execute(
@@ -229,7 +248,7 @@ class StepRepository:
                         " t1.type, t1.name, t1.timestamp, t1.duration, t1.status,"
                         " t1.payload, t2.name as agent_name FROM traces t1 LEFT"
                         " JOIN traces t2 ON t1.parent_trace_id = t2.trace_id WHERE"
-                        " t1.step_id = ? AND (t1.type = 'tool' OR (t1.type ="
+                        " t1.step_id = ? AND (t1.type = 'tool' OR t1.type = 'action' OR (t1.type ="
                         " 'llm_call' AND t1.status = 'failed')) ORDER BY"
                         " t1.timestamp ASC",
                         (step_id,),