android-midscene-automation 0.2.4 → 1.1.1

package/CHANGELOG.md

@@ -1,4 +1,14 @@
 # 更新记录
+## v1.1.1
+更新README.md
+
+## v1.1.0
+- [Artemis]修复自定义模型返回 `<think>` 思考标签导致 Hopper 等节点 JSON 解析失败的问题：非 Google 模型的 Pydantic 结构化输出接入统一清理、提取和校验流程，显式提供 JSON Schema，格式错误时限次要求模型纠正。
+- [Artemis]修复 Flash 步骤摘要和历史压缩仍直接创建 Gemini 客户端的问题：非 Google 模型统一使用配置中的 summarizer 节点及其备用模型；模型初始化错误不再静默切换到 Gemini。
+- [Artemis]修复 Artemis 使用 MiniMax、GLM 等非 Google 默认模型时，辅助检查节点仍强制调用 Gemini 并因缺少密钥导致任务启动失败的问题；支持这些节点继承默认模型或使用显式配置。
+- [Artemis]集成 Google Artemis。
+- [Midscene]Midscene 集成已停止日常维护，现有功能仍保留。
+
 ## v0.2.4
 - Midscene Android、Android Playground、Core、Playground、Shared 和 Web 模块统一升级至 1.14.0。
 - 修复 Midscene 测试脚本生成过程中切换“AI 生成 / 自定义步骤编排”会清空生成状态和结果的问题；生成任务继续在后台执行，模式切换后保留已生成步骤与代码。

package/README.md

@@ -1,37 +1,21 @@
 # Android Midscene Automation
 
-一个面向 Android App 的自动化测试工具，同时支持 Midscene AI 测试和 Appium 组件树录制回放。
+一个面向 Android App 的自动化测试工具，集成 Appium 组件树录制回放、Artemis 自然语言任务执行和 Midscene AI 测试。
 
 ## 界面预览
 
-![](./screen/c1.jpg)
+![](./screen/1.jpg)
+![](./screen/2.jpg)
+![](./screen/3.jpg)
 
-### Midscene
-
-![](./screen/m1.jpg)
-
-![](./screen/m2.jpg)
-
-![](./screen/m3.jpg)
-
-### Appium
-
-![](./screen/a1.jpg)
-
-![](./screen/a2.jpg)
-
-![](./screen/a3.jpg)
-
-![](./screen/a4.jpg)
-
-![](./screen/a5.jpg)
 
 ## 支持的测试方式
 
 | 测试方式 | 页面入口 | 工作方式 | 模型要求 | 适用场景 |
 | --- | --- | --- | --- | --- |
-| Midscene | `Midscene > 测试脚本生成 / 自动化测试` | 使用自然语言生成和执行测试脚本，通过多模态模型理解设备画面 | **必须配置模型** | 页面元素难以稳定定位、希望使用自然语言快速编写测试 |
 | Appium | `Appium` | 读取 Android 组件树，按 selector、组件 ID 和流程图录制、回放 | **不需要配置任何模型** | 需要稳定、可重复、无模型消耗的传统自动化测试 |
+| Artemis | `Artemis` | 使用自然语言描述目标，AI 自主规划并操作设备，记录步骤、结果和任务笔记 | **必须配置模型**，独立配置 | 探索性测试、多步骤业务任务、画面检查与数据收集 |
+| Midscene | `Midscene > 测试脚本生成 / 自动化测试` | 使用自然语言生成和执行测试脚本，通过多模态模型理解设备画面 | **必须配置模型** | 页面元素难以稳定定位、希望使用自然语言快速编写测试 |
 
 使用 Midscene 前，请先进入“参数配置”完成 `Midscene 模型` 配置；需要 AI 生成脚本时，还要配置 `脚本优化模型`。模型配置不可用时，Midscene 脚本无法正常生成或执行。
 
@@ -39,10 +23,11 @@ Appium 方案完全不依赖大模型，不需要填写 Base URL、API Key、Mod
 
 ## 环境要求
 
-- Node.js 18+
-- npm
-- Android SDK / ADB，移动端自动化测试需要
-- Appium 3.x 和 UiAutomator2 Driver，仅 Appium 录制回放方式需要
+- Node.js：运行主项目需要符合 Vite 7 的要求（20.19+ 或 22.12+）；同时使用 Artemis 前端时按其 Angular 依赖要求准备 Node.js，当前集成使用 22.22.3+（22 LTS）。
+- npm。
+- Android SDK / ADB，移动端自动化测试需要。
+- Appium 3.x 和 UiAutomator2 Driver，仅 Appium 录制回放方式需要。
+- uv 和 Python 3.12+，仅 Artemis 需要。
 
 安装 Appium 相关依赖：
 
@@ -51,7 +36,141 @@ npm install -g appium@3.5.0
 appium driver install uiautomator2
 ```
 
-使用 Appium 方式前需要运行 `appium` 启动服务；只使用 Midscene 时不需要安装或启动 Appium。
+使用 Appium 方式前需要运行 `appium` 启动服务；只使用 Artemis 或 Midscene 时不需要安装或启动 Appium。
+
+## Artemis 使用说明
+
+### 启动与控制台集成
+
+菜单中的 **Artemis** 在主内容区嵌入独立的 Artemis 控制台，支持切换菜单后保留页面状态。首次连接和“重新连接”都会检查服务；未启动或未允许嵌入时显示操作提示。
+
+1. Artemis 源码独立放在项目根目录的 `artemis-main/`，或通过 `ARTEMIS_PROJECT_DIR` 指定源码绝对路径。`artemis-main/` 源码随主项目的 Git / npm 包分发。本地 `config/artemis.jsonc`、`.env`、依赖环境和运行数据不提交、不打包；首次启动会从公开的 `config/artemis.example.jsonc` 生成本地配置，已有配置不会被覆盖。
+2. 安装 `uv`，准备 Python 3.12+、Node.js 22.22.3+（22 LTS）、ADB 和设备；Artemis 前端首次启动时会自动安装依赖并构建。
+3. 在项目根目录运行 `npm run dev`，或使用 `npx android-midscene-automation`，会同时启动主项目与 Artemis；首次会同步 Python 依赖并按需构建 Artemis 前端。启动完成后点击 **Artemis**。API Key、模型和设备在 Artemis 自身的配置中设置，不会自动复用 Midscene 的模型配置。
+
+检测到 Artemis 已运行时会复用该服务；按 Ctrl+C 会停止本次启动的服务，不会停止之前已运行的 Artemis。缺少源码或 Artemis 启动失败时会输出提示，主项目仍可使用。仍可通过 `npm run artemis` 单独启动 Artemis。主项目端口被占用时会明确报错，可通过 `npm run dev -- --port 5174` 指定其他端口，并自动为新启动的 Artemis 配置对应的嵌入来源。
+
+在 Artemis 的“系统设置 → 自定义配置”中点击“编辑 JSONC”，可直接修改并保存当前使用的 `artemis.jsonc`；支持注释和原有排版，保存前校验 JSONC、模型与智能体配置。文件已被其他操作修改时会阻止覆盖，保存失败时保留草稿。“取消编辑”放弃本次修改并重新加载文件。模型配置用于新任务，运行中的任务保持当前设置；API Key 和接口地址仍在 Artemis 的 `.env` 中配置。
+
+修改配置文件或 `.env` 后，点击自定义配置中的“刷新配置”，会重新校验 JSONC 并加载模型密钥和 Base URL，更新“已配置 / 未设置”状态，无需重启服务。刷新只检查本地配置，不调用模型 API 验证密钥；正在编辑草稿时按钮禁用，校验失败时保留当前已加载设置。
+
+专用启动入口仅绑定 `127.0.0.1:8000`，通过 CSP 允许 `localhost` / `127.0.0.1` 的 `5173`、`4173` 端口嵌入，并保留 Artemis 原有的 Host / Origin 校验。原来的 `artemis ui` 默认禁止 iframe；若已启动，需要先停止原服务再执行 `npm run artemis`。终端按 Ctrl+C 停止服务。
+
+可选环境变量：
+
+| 变量 | 用途 |
+| --- | --- |
+| `ARTEMIS_PROJECT_DIR` | Artemis 源码目录，传给 `npm run dev` 或 `npm run artemis` |
+| `ARTEMIS_PORT` | Artemis 服务端口，默认 `8000` |
+| `ARTEMIS_EMBED_ORIGINS` | 允许嵌入的完整来源地址，逗号分隔；主项目使用其他端口时需设置，不接受通配符 |
+| `ARTEMIS_URL` | 主项目后端连接的 Artemis 地址，默认 `http://127.0.0.1:8000`，传给 `npm run dev` 或 `npm run preview` |
+| `ARTEMIS_AUTO_START` | 设置为 `0` 时，`npm run dev` 仅启动主项目；默认自动启动 Artemis |
+
+当前集成面向本机使用。Artemis 与 Midscene/Appium 的任务队列、设备锁和结果各自独立，请不要同时控制同一台设备。
+
+### 首次配置与执行
+
+1. 连接并解锁 Android 设备，开启 USB 调试，在终端运行 `adb devices -l`，确认设备状态为 `device`，并在手机上允许调试授权。
+2. 首次启动后，按下方说明配置 `artemis-main/.env` 和 `artemis-main/config/artemis.jsonc`，然后在“系统设置 → 自定义配置”点击“刷新配置”。
+3. 点击主项目菜单中的 **Artemis**，在 Artemis 控制台的设备选择入口选择实际连接的设备，再选择 **Flash** 或 **Pro** 执行模式。模式名称与模型名称不同，例如 Pro 模式也可以使用自定义的 MiniMax 模型。
+4. 输入自然语言任务并提交。任务应明确目标 App、操作范围和可观察的完成条件，例如：
+
+   > 打开 Android 设置，查看设备型号和 Android 版本，返回查到的信息后结束任务。
+
+5. 在执行视图查看步骤、模型调用、错误与结果；需要中止时使用停止按钮。选择历史任务可以查看对应记录。右上角中英文切换按钮用于切换控制台界面语言，任务描述可以使用中文。
+
+### 配置自定义模型
+
+Artemis 不读取主项目“参数配置”中的 Midscene 模型。其模型名称、节点和备用模型写在 JSONC 中，API Key 与接口地址写在 `.env` 中：
+
+| 你获得的参数 | Artemis 配置位置 | 示例字段 |
+| --- | --- | --- |
+| API Key | `artemis-main/.env` | `OPENAI_API_KEY` |
+| Base URL | `artemis-main/.env` | `OPENAI_BASE_URL` |
+| Model Name | `artemis-main/config/artemis.jsonc` | `default.model` 与 `default.fallback.model` |
+| 接口类型 | `artemis-main/config/artemis.jsonc` | OpenAI 兼容接口使用 `provider: "openai"` |
+
+首次准备 `.env` 时，从项目根目录执行以下命令；如果文件已存在，直接编辑已有文件：
+
+```sh
+cp -n artemis-main/.env.example artemis-main/.env
+```
+
+编辑 `.env`，使用模型服务商给出的 OpenAI 兼容接口地址和密钥。地址通常包含 `/v1`，应填写接口基地址，不要填写完整的 `/chat/completions` 请求路径：
+
+```dotenv
+OPENAI_API_KEY=your-api-key
+OPENAI_BASE_URL=https://your-provider.example/v1
+```
+
+通过“编辑 JSONC”修改本地配置，例如：
+
+```jsonc
+{
+  "default": {
+    "provider": "openai",
+    "model": "your-model-name",
+    "fallback": {
+      "provider": "openai",
+      "model": "your-fallback-model-name"
+    }
+  },
+  "nodes": {}
+}
+```
+
+将占位名称替换为服务商提供的实际模型名称。没有其他备用模型时，`fallback` 可以使用同一模型，但不会提供跨模型容错。`nodes` 用于覆盖指定节点的模型；没有覆盖的节点继承 `default`。切换提供方时也要检查原有节点及其 `fallback`，避免仍引用其他提供方的模型。
+
+GLM、DeepSeek、MiniMax 等提供 OpenAI 兼容接口的服务可按此结构配置，但用于屏幕理解的模型还需要支持图片输入与所需的工具调用；接口兼容不代表每个模型型号都能完成设备任务。配置 Gemini 时使用 `provider: "google"`，并在 `.env` 中填写 `GOOGLE_API_KEY` 或 `GEMINI_API_KEY`。
+
+保存 JSONC 后点击“刷新配置”检查本地设置。出现“已配置”表示字段已读取，不代表 API Key、模型权限或多模态能力已通过在线验证。修改 Python 源码后需重启 Artemis；“刷新配置”不会重新加载源码。
+
+### Flash 与 Pro 模式
+
+| 模式 | 执行方式 | 适用任务 | 笔记与计划 |
+| --- | --- | --- | --- |
+| Flash | 根据当前画面直接决策、操作，流程较简洁 | 打开页面、短流程操作、简单查询 | 当前未提供笔记读写工具，页签可能为空 |
+| Pro | 先规划，再执行与校验，任务结束前进行最终检查 | 多步骤任务、需要过程证据或整理结果的测试 | 可生成计划和任务笔记 |
+
+Pro 任务完成设备操作后，仍可能继续回看截图、检查结果、等待步骤摘要和生成录像。计划全部勾选不代表服务已完成收尾，以最终任务状态为准。
+
+### 笔记与计划
+
+“笔记与计划”用于查看当前或历史任务中 AI 保存的记录，页面目前不提供直接编辑操作：
+
+- `task_plan.md`：任务步骤和执行进度，显示待执行、执行中及完成状态。
+- 其他笔记：保存采集数据、观察结果或任务总结；有多个文件时点击名称切换查看。
+
+在 Pro 模式的任务描述中明确要求记录，例如：
+
+> 打开设置，查看设备型号和 Android 版本。执行前制定任务计划，将查到的信息保存到 device_info 笔记中，完成后更新计划并返回结果。
+
+笔记按任务保存，用于同一任务内的持续记忆，不会自动成为所有后续任务共享的知识库。
+
+### 执行记录与本地配置
+
+默认执行数据保存在 `artemis-main/traces/`，临时数据保存在 `artemis-main/scratch/`；自定义 `TRACES_PATH` 或运行参数时，以实际配置的输出位置为准。
+
+| 路径 | 内容 | Git / npm 分发 |
+| --- | --- | --- |
+| `artemis-main/config/artemis.example.jsonc` | 不含密钥的公开默认配置 | 随源码分发 |
+| `artemis-main/config/artemis.jsonc` | 本机实际使用的模型与智能体配置 | 已忽略，不提交、不打包 |
+| `artemis-main/.env` | 本机模型密钥、Base URL 等设置 | 已忽略，不提交、不打包 |
+| `artemis-main/traces/` | 执行数据库、步骤截图、录像、回放数据、任务笔记和计划 | 已忽略，不提交、不打包 |
+| `artemis-main/scratch/` | 执行过程临时文件 | 已忽略，不提交、不打包 |
+
+执行记录写入本地不会自动执行 Git 提交或推送，正常 `git add .` 不会包含上述已忽略的文件。这里说明的是 Git/npm 分发范围；执行 AI 任务时，模型调用仍会向所配置的服务商发送任务所需的文本和图片。
+
+### Artemis 常见问题
+
+- **控制台无法连接**：检查启动终端的日志，确认 `uv`、Python、Node.js 和前端构建依赖可用，再运行 `npm run artemis`。若使用其他端口，检查 `ARTEMIS_URL`、`ARTEMIS_PORT` 和嵌入来源是否一致。
+- **模型仍显示“未设置”**：确认修改的是当前 `ARTEMIS_PROJECT_DIR` 下的 `.env` 与 `config/artemis.jsonc`，再点击“刷新配置”；主项目的 Midscene 配置不会同步到 Artemis。
+- **没有实际设备**：运行 `adb devices -l`，检查 USB 调试授权、设备连接，以及 Artemis 的 `ADB_HOST`、`ADB_PORT`。任务使用 Artemis 中选择的设备。
+- **视频工具链提示缺少 scrcpy / ffmpeg**：在“系统设置”的视频工具链检查中查看缺失项目，安装后确认启动 Artemis 的终端能找到工具；终端 PATH 改变后重新启动服务。
+- **任务看起来没有结束**：查看最近步骤和日志，区分正在操作、等待模型、错误暂停与 Pro 最终检查。记录任务 ID 可用于定位日志；需要结束当前任务时使用停止按钮。
+- **自定义模型输出解析失败**：本项目已为非 Google 模型的 Pydantic 结构化输出接入思考标签清理、JSON 提取和校验，格式错误时要求模型纠正一次；持续错误仍会报告失败。纯文本步骤摘要也会清理思考内容，避免将其计入摘要长度。
+
+上述模型适配修复属于本项目集成源码的修改，并不代表 Artemis 上游已包含相同修复。
 
 ## 启动
 
@@ -75,6 +194,7 @@ npx android-midscene-automation --port 5174
 
 ## 功能文档
 
+- [Artemis 使用说明](#artemis-使用说明)
 - [Appium 录制器使用说明](#appium-录制器使用说明)
 - [流程节点操作说明](./流程节点操作说明.md)
 - [AI 识别操作说明](./AI识别操作说明.md)
@@ -112,11 +232,11 @@ npm run dev
 http://127.0.0.1:5173/
 ```
 
-`npm run dev` 会同时启动前端页面和本地后端 API。后端不是独立进程，而是在 `vite.config.ts` 中通过 `server/http-api.ts` 挂载到 Vite dev server 的 Connect middleware。
+`npm run dev` 会同时启动前端页面、本地后端 API 和独立的 Artemis 服务。主项目后端不是独立进程，而是在 `vite.config.ts` 中通过 `server/http-api.ts` 挂载到 Vite dev server 的 Connect middleware。
 
 ## 模型配置
 
-模型配置仅用于 Midscene 和 AI 脚本生成，Appium 录制与回放不读取模型配置。首次使用 Midscene 时进入页面的“参数配置”：
+本节的“参数配置”仅用于 Midscene 和 AI 脚本生成，Appium 录制与回放不读取这些模型配置。Artemis 使用自己的 JSONC 与 `.env`，详见 [Artemis 使用说明](#artemis-使用说明)。首次使用 Midscene 时进入页面的“参数配置”：
 
 - `运行配置`：可选指定 Android SDK 根目录和 Appium 回放报告目录；留空时使用系统 SDK 与默认 `output` 目录。
 - `Midscene模型`：执行测试脚本时使用，支持“自定义提供方”和“使用 Codex”。
@@ -1382,6 +1502,16 @@ Linux: ~/.local/share/android-midscene-automation
 
 # 项目更新记录
 
+## v1.1.1
+更新README.md
+
+## v1.1.0
+- [Artemis]修复自定义模型返回 `<think>` 思考标签导致 Hopper 等节点 JSON 解析失败的问题：非 Google 模型的 Pydantic 结构化输出接入统一清理、提取和校验流程，显式提供 JSON Schema，格式错误时限次要求模型纠正。
+- [Artemis]修复 Flash 步骤摘要和历史压缩仍直接创建 Gemini 客户端的问题：非 Google 模型统一使用配置中的 summarizer 节点及其备用模型；模型初始化错误不再静默切换到 Gemini。
+- [Artemis]修复 Artemis 使用 MiniMax、GLM 等非 Google 默认模型时，辅助检查节点仍强制调用 Gemini 并因缺少密钥导致任务启动失败的问题；支持这些节点继承默认模型或使用显式配置。
+- [Artemis]集成 Google Artemis。
+- [Midscene]Midscene 集成已停止日常维护，现有功能仍保留。
+
 ## v0.2.4
 - Midscene Android、Android Playground、Core、Playground、Shared 和 Web 模块统一升级至 1.14.0。
 - 修复 Midscene 测试脚本生成过程中切换“AI 生成 / 自定义步骤编排”会清空生成状态和结果的问题；生成任务继续在后台执行，模式切换后保留已生成步骤与代码。

package/artemis-main/.dockerignore

@@ -0,0 +1,15 @@
+.git
+.github
+.venv
+.pytest_cache
+.ruff_cache
+**/__pycache__
+**/*.pyc
+apps/showcase_ui/.angular
+apps/showcase_ui/dist
+apps/showcase_ui/node_modules
+build
+dist
+traces
+.env
+*.log

package/artemis-main/.env.example

@@ -0,0 +1,34 @@
+# ==============================================================================
+# Artemis Environment Configuration Template
+# ==============================================================================
+# Copy this file to .env and fill in your API credentials:
+# cp .env.example .env
+
+# LLM Providers (Configure at least one)
+GEMINI_API_KEY=
+GOOGLE_API_KEY=
+OPENAI_API_KEY=
+# OpenAI-compatible endpoint for GLM, DeepSeek, or other providers
+OPENAI_BASE_URL=
+ANTHROPIC_API_KEY=
+OPEN_ROUTER_API_KEY=
+XAI_API_KEY=
+
+# Google Cloud Vision OCR (Optional - for advanced OCR processing)
+OCR_API_KEY=
+
+# Android ADB Connectivity (Optional - defaults to 127.0.0.1:5037)
+ADB_HOST=127.0.0.1
+ADB_PORT=5037
+# ADB_DEVICE_SERIAL=
+# Keep the display awake, falling back to a wake lock or safe heartbeat when needed.
+# Set to false if Artemis is used with a personal device whose screen should time out.
+ARTEMIS_KEEP_DEVICE_AWAKE=true
+# UI hierarchy backend: auto (Accessibility Helper, UIAutomator2 fallback) | helper | uiautomator
+ARTEMIS_HIERARCHY_BACKEND=auto
+# Let tasks install / upgrade the Accessibility Helper APK on a device they hold.
+# Set to false on shared or personal phones: then only `artemis helper install` installs it.
+ARTEMIS_HELPER_AUTO_INSTALL=true
+
+# Artemis Execution Defaults (flash or pro)
+ARTEMIS_DEFAULT_PROFILE=flash

package/artemis-main/CONTRIBUTING.md

@@ -0,0 +1,35 @@
+# Contributing to ARTEMIS
+
+Thank you for your interest in contributing to **ARTEMIS**! We welcome and appreciate all forms of contributions—whether it's reporting bugs, proposing new features, improving documentation, or submitting code.
+
+---
+
+## 🤝 Ways to Contribute
+
+- **🐛 Report Bugs & Suggest Features**: If you find an issue or have an idea to improve ARTEMIS, please open an [Issue](https://github.com/google/artemis/issues).
+- **💡 Submit Pull Requests**:
+  1. Fork the repository and create your feature/fix branch (`git checkout -b feat/my-feature`).
+  2. Make your changes and verify with `make test`, `make lint`, and `make typecheck`.
+  3. Open a Pull Request with a brief summary of your work.
+- **💬 Community & Discussion**: Join our [Discord Community](https://discord.gg/wF2FN4WHGY) to chat with maintainers, ask questions, or share feedback.
+
+---
+
+Every contribution—big or small—helps make ARTEMIS better. Thank you for building with us!
+
+## Test layers
+
+`make test` is the required, deterministic suite. It does not need an Android
+device, model credentials, or the optional private cloud service. This is the
+same suite used by pull-request CI.
+
+- `make test-integration` runs cross-component tests that may need configured
+  model credentials.
+- `make test-device` runs Android and end-to-end tests and therefore requires
+  an attached, authorized device or emulator.
+- `make test-all` collects every test tree and is intended for a fully
+  provisioned maintainer environment.
+
+Tests that require external state must carry the appropriate `android`,
+`cloud`, `manual`, or `e2e` marker. They must remain safely collectable when
+that dependency is unavailable.

package/artemis-main/Dockerfile

@@ -0,0 +1,68 @@
+# 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.
+
+FROM node:22-bookworm-slim AS frontend-builder
+
+WORKDIR /build/apps/showcase_ui
+COPY apps/showcase_ui/package.json apps/showcase_ui/package-lock.json ./
+RUN npm ci
+COPY apps/showcase_ui/angular.json apps/showcase_ui/tsconfig*.json ./
+COPY apps/showcase_ui/public/ ./public/
+COPY apps/showcase_ui/src/ ./src/
+RUN npm run build
+
+
+FROM python:3.12-slim AS wheel-builder
+
+WORKDIR /build
+COPY artemis/ ./artemis/
+COPY apps/ ./apps/
+COPY mcp_server/ ./mcp_server/
+COPY third_party/ ./third_party/
+COPY packages/artemis-client/ ./packages/artemis-client/
+COPY config/ ./config/
+COPY pyproject.toml setup.py README.md LICENSE ./
+COPY --from=frontend-builder /build/apps/showcase_ui/dist/ ./apps/showcase_ui/dist/
+
+# Build wheels for the runtime image.
+RUN python -m pip wheel --no-cache-dir --no-deps --wheel-dir /wheels ./packages/artemis-client \
+    && python -m pip wheel --no-cache-dir --no-deps --wheel-dir /wheels .
+
+
+FROM python:3.12-slim
+
+WORKDIR /app
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    adb \
+    curl \
+    git \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY --from=wheel-builder /wheels/ /wheels/
+RUN pip install --no-cache-dir /wheels/artemis_client-*.whl \
+    && pip install --no-cache-dir /wheels/artemis-*.whl \
+    && rm -rf /wheels
+
+ENV PYTHONUNBUFFERED=1
+ENV ARTEMIS_APP_DIR=/app
+ENV PORT=8080
+
+EXPOSE 8080
+
+# The console has no user authentication: publish the port to loopback only,
+# e.g. `docker run -p 127.0.0.1:8080:8080 ...`, and reach it remotely through
+# a Tailscale/SSH tunnel. (0.0.0.0 here is container-internal and required
+# for the port mapping to work.)
+CMD ["uvicorn", "apps.admin_console.server:app", "--host", "0.0.0.0", "--port", "8080"]

package/artemis-main/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        https://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   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
+
+       https://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.