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
2026-08-18 13:59:27 -07:00
1 parent 78e478f502
commit 9a5aaf99b7
@@ -0,0 +1,173 @@
+# 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.
+
+"""Linux Platform Implementation (XDG Base Directory Specification & POSIX Process Model)."""
+
+import os
+from pathlib import Path
+import shutil
+import signal
+import tempfile
+
+from artemis.platform.base import IPlatform, IPlatformPaths, IPlatformProcess, OSType
+
+
+class LinuxPlatformPaths(IPlatformPaths):
+    """Linux paths adhering to the XDG Base Directory specification with legacy fallbacks."""
+
+    def __init__(self):
+        self._home = Path.home()
+
+    @property
+    def config_dir(self) -> Path:
+        xdg_config = os.getenv("XDG_CONFIG_HOME")
+        if xdg_config:
+            p = Path(xdg_config) / "artemis"
+        else:
+            p = self._home / ".config" / "artemis"
+        p.mkdir(parents=True, exist_ok=True)
+        return p
+
+    @property
+    def data_dir(self) -> Path:
+        # Check custom app dir override first
+        env_dir = os.getenv("ARTEMIS_APP_DIR") or os.getenv("ANTIGRAVITY_APP_DIR")
+        if env_dir:
+            p = Path(env_dir)
+            p.mkdir(parents=True, exist_ok=True)
+            return p
+
+        xdg_data = os.getenv("XDG_DATA_HOME")
+        if xdg_data:
+            p = Path(xdg_data) / "artemis"
+            p.mkdir(parents=True, exist_ok=True)
+            return p
+
+        # Check legacy ~/.gemini/jetski or ~/.artemis directory if it exists
+        legacy_jetski = self._home / ".gemini" / "jetski"
+        if legacy_jetski.exists():
+            return legacy_jetski
+
+        legacy_artemis = self._home / ".artemis"
+        if legacy_artemis.exists():
+            return legacy_artemis
+
+        p = self._home / ".local" / "share" / "artemis"
+        p.mkdir(parents=True, exist_ok=True)
+        return p
+
+    @property
+    def cache_dir(self) -> Path:
+        xdg_cache = os.getenv("XDG_CACHE_HOME")
+        if xdg_cache:
+            p = Path(xdg_cache) / "artemis"
+        else:
+            p = self._home / ".cache" / "artemis"
+        p.mkdir(parents=True, exist_ok=True)
+        return p
+
+    @property
+    def logs_dir(self) -> Path:
+        p = self.data_dir / "logs"
+        p.mkdir(parents=True, exist_ok=True)
+        return p
+
+    def temp_dir(self, subfolder: str | None = None) -> Path:
+        base = Path(tempfile.gettempdir()) / "artemis"
+        target = base / subfolder if subfolder else base
+        target.mkdir(parents=True, exist_ok=True)
+        return target
+
+    def resolve_app_dir(self) -> Path:
+        return self.data_dir
+
+
+class LinuxPlatformProcess(IPlatformProcess):
+    """Linux process management using POSIX signals and process groups."""
+
+    @property
+    def path_separator(self) -> str:
+        return ":"
+
+    def terminate_process_tree(self, pid: int, timeout_seconds: float = 3.0) -> bool:
+        try:
+            import psutil
+
+            parent = psutil.Process(pid)
+            children = parent.children(recursive=True)
+            for child in children:
+                try:
+                    child.send_signal(signal.SIGTERM)
+                except (psutil.NoSuchProcess, psutil.AccessDenied):
+                    pass
+
+            parent.send_signal(signal.SIGTERM)
+            gone, alive = psutil.wait_procs(children + [parent], timeout=timeout_seconds)
+            for p in alive:
+                try:
+                    p.kill()
+                except (psutil.NoSuchProcess, psutil.AccessDenied):
+                    pass
+            return True
+        except Exception:
+            try:
+                os.kill(pid, signal.SIGKILL)
+                return True
+            except OSError:
+                return False
+
+    def setup_utf8_io(self) -> None:
+        pass
+
+
+class LinuxPlatform(IPlatform):
+    """Linux Platform Adapter."""
+
+    def __init__(self):
+        self._paths = LinuxPlatformPaths()
+        self._process = LinuxPlatformProcess()
+
+    @property
+    def os_type(self) -> OSType:
+        return OSType.LINUX
+
+    @property
+    def paths(self) -> IPlatformPaths:
+        return self._paths
+
+    @property
+    def process(self) -> IPlatformProcess:
+        return self._process
+
+    def get_package_manager_name(self) -> str | None:
+        for pm in ("apt-get", "dnf", "pacman", "zypper"):
+            if shutil.which(pm):
+                return pm
+        return None
+
+    def get_install_command(self, tool_name: str) -> str:
+        pm = self.get_package_manager_name()
+        pkg_map = {
+            "adb": {"apt-get": "adb", "dnf": "android-tools", "pacman": "android-tools"},
+            "ffmpeg": {"apt-get": "ffmpeg", "dnf": "ffmpeg", "pacman": "ffmpeg"},
+            "scrcpy": {"apt-get": "scrcpy", "dnf": "scrcpy", "pacman": "scrcpy"},
+        }
+        pkg = pkg_map.get(tool_name, {}).get(pm, tool_name)
+        if pm == "apt-get":
+            return f"sudo apt-get install -y {pkg}"
+        elif pm == "dnf":
+            return f"sudo dnf install -y {pkg}"
+        elif pm == "pacman":
+            return f"sudo pacman -S --noconfirm {pkg}"
+        return f"Install {tool_name} using your system package manager."