android-midscene-automation 0.2.4 → 1.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (525) hide show
  1. package/CHANGELOG.md +10 -0
  2. package/README.md +159 -29
  3. package/artemis-main/.dockerignore +15 -0
  4. package/artemis-main/.env.example +34 -0
  5. package/artemis-main/CONTRIBUTING.md +35 -0
  6. package/artemis-main/Dockerfile +68 -0
  7. package/artemis-main/LICENSE +202 -0
  8. package/artemis-main/Makefile +115 -0
  9. package/artemis-main/README.md +322 -0
  10. package/artemis-main/README_CN.md +320 -0
  11. package/artemis-main/apps/__init__.py +15 -0
  12. package/artemis-main/apps/admin_console/__init__.py +19 -0
  13. package/artemis-main/apps/admin_console/core/__init__.py +13 -0
  14. package/artemis-main/apps/admin_console/core/config.py +43 -0
  15. package/artemis-main/apps/admin_console/core/security.py +178 -0
  16. package/artemis-main/apps/admin_console/core/state.py +243 -0
  17. package/artemis-main/apps/admin_console/database/__init__.py +13 -0
  18. package/artemis-main/apps/admin_console/database/connection.py +60 -0
  19. package/artemis-main/apps/admin_console/database/repositories/__init__.py +13 -0
  20. package/artemis-main/apps/admin_console/database/repositories/session_repository.py +564 -0
  21. package/artemis-main/apps/admin_console/database/repositories/step_repository.py +512 -0
  22. package/artemis-main/apps/admin_console/database/repositories/trace_repository.py +133 -0
  23. package/artemis-main/apps/admin_console/index.html +3787 -0
  24. package/artemis-main/apps/admin_console/replay_manager.py +2585 -0
  25. package/artemis-main/apps/admin_console/routers/__init__.py +13 -0
  26. package/artemis-main/apps/admin_console/routers/media.py +198 -0
  27. package/artemis-main/apps/admin_console/routers/replay.py +91 -0
  28. package/artemis-main/apps/admin_console/routers/sessions.py +239 -0
  29. package/artemis-main/apps/admin_console/routers/steps.py +109 -0
  30. package/artemis-main/apps/admin_console/routers/stream.py +56 -0
  31. package/artemis-main/apps/admin_console/routers/system.py +761 -0
  32. package/artemis-main/apps/admin_console/routers/tasks.py +517 -0
  33. package/artemis-main/apps/admin_console/schemas/__init__.py +13 -0
  34. package/artemis-main/apps/admin_console/schemas/task_schema.py +47 -0
  35. package/artemis-main/apps/admin_console/server.py +508 -0
  36. package/artemis-main/apps/admin_console/services/__init__.py +13 -0
  37. package/artemis-main/apps/admin_console/services/device_stream_service.py +137 -0
  38. package/artemis-main/apps/admin_console/services/ipc_service.py +262 -0
  39. package/artemis-main/apps/admin_console/services/media_service.py +623 -0
  40. package/artemis-main/apps/admin_console/services/model_service.py +148 -0
  41. package/artemis-main/apps/admin_console/services/task_preset_catalog.py +514 -0
  42. package/artemis-main/apps/admin_console/services/task_queue_service.py +1719 -0
  43. package/artemis-main/apps/admin_console/services/worker_process_io.py +144 -0
  44. package/artemis-main/apps/showcase_ui/README.md +31 -0
  45. package/artemis-main/apps/showcase_ui/angular.json +132 -0
  46. package/artemis-main/apps/showcase_ui/package-lock.json +9472 -0
  47. package/artemis-main/apps/showcase_ui/package.json +39 -0
  48. package/artemis-main/apps/showcase_ui/proxy.conf.json +23 -0
  49. package/artemis-main/apps/showcase_ui/public/favicon.ico +0 -0
  50. package/artemis-main/apps/showcase_ui/public/logo.png +0 -0
  51. package/artemis-main/apps/showcase_ui/public/logo.svg +56 -0
  52. package/artemis-main/apps/showcase_ui/src/app/app.component.html +24 -0
  53. package/artemis-main/apps/showcase_ui/src/app/app.component.scss +49 -0
  54. package/artemis-main/apps/showcase_ui/src/app/app.component.spec.ts +42 -0
  55. package/artemis-main/apps/showcase_ui/src/app/app.component.ts +32 -0
  56. package/artemis-main/apps/showcase_ui/src/app/app.config.ts +29 -0
  57. package/artemis-main/apps/showcase_ui/src/app/app.routes.ts +27 -0
  58. package/artemis-main/apps/showcase_ui/src/app/components/agent-stream/agent-stream-startup.spec.ts +108 -0
  59. package/artemis-main/apps/showcase_ui/src/app/components/agent-stream/agent-stream.component.html +1436 -0
  60. package/artemis-main/apps/showcase_ui/src/app/components/agent-stream/agent-stream.component.scss +3973 -0
  61. package/artemis-main/apps/showcase_ui/src/app/components/agent-stream/agent-stream.component.ts +2235 -0
  62. package/artemis-main/apps/showcase_ui/src/app/components/chat-interface/chat-interface.component.html +380 -0
  63. package/artemis-main/apps/showcase_ui/src/app/components/chat-interface/chat-interface.component.scss +1171 -0
  64. package/artemis-main/apps/showcase_ui/src/app/components/chat-interface/chat-interface.component.ts +270 -0
  65. package/artemis-main/apps/showcase_ui/src/app/components/floating-video-player/floating-video-player.component.html +433 -0
  66. package/artemis-main/apps/showcase_ui/src/app/components/floating-video-player/floating-video-player.component.scss +987 -0
  67. package/artemis-main/apps/showcase_ui/src/app/components/floating-video-player/floating-video-player.component.ts +632 -0
  68. package/artemis-main/apps/showcase_ui/src/app/components/legacy-agent-stream/legacy-agent-stream.component.html +130 -0
  69. package/artemis-main/apps/showcase_ui/src/app/components/legacy-agent-stream/legacy-agent-stream.component.scss +406 -0
  70. package/artemis-main/apps/showcase_ui/src/app/components/legacy-agent-stream/legacy-agent-stream.component.ts +74 -0
  71. package/artemis-main/apps/showcase_ui/src/app/components/nav-switcher/nav-switcher.component.scss +115 -0
  72. package/artemis-main/apps/showcase_ui/src/app/components/nav-switcher/nav-switcher.component.ts +52 -0
  73. package/artemis-main/apps/showcase_ui/src/app/core/data/smart-tasks.data.ts +334 -0
  74. package/artemis-main/apps/showcase_ui/src/app/core/i18n/language.service.spec.ts +55 -0
  75. package/artemis-main/apps/showcase_ui/src/app/core/i18n/language.service.ts +61 -0
  76. package/artemis-main/apps/showcase_ui/src/app/core/i18n/translate.pipe.ts +11 -0
  77. package/artemis-main/apps/showcase_ui/src/app/core/i18n/zh-cn.ts +651 -0
  78. package/artemis-main/apps/showcase_ui/src/app/core/models/markdown.model.ts +43 -0
  79. package/artemis-main/apps/showcase_ui/src/app/core/models/pro-tuning.model.spec.ts +47 -0
  80. package/artemis-main/apps/showcase_ui/src/app/core/models/pro-tuning.model.ts +165 -0
  81. package/artemis-main/apps/showcase_ui/src/app/core/models/session.model.ts +85 -0
  82. package/artemis-main/apps/showcase_ui/src/app/core/models/stream.model.ts +246 -0
  83. package/artemis-main/apps/showcase_ui/src/app/core/models/system.model.ts +118 -0
  84. package/artemis-main/apps/showcase_ui/src/app/core/services/task-recommendation.service.ts +111 -0
  85. package/artemis-main/apps/showcase_ui/src/app/pages/home/home.component.html +2130 -0
  86. package/artemis-main/apps/showcase_ui/src/app/pages/home/home.component.scss +5204 -0
  87. package/artemis-main/apps/showcase_ui/src/app/pages/home/home.component.ts +1189 -0
  88. package/artemis-main/apps/showcase_ui/src/app/pages/legacy-workspace/legacy-workspace.component.html +39 -0
  89. package/artemis-main/apps/showcase_ui/src/app/pages/legacy-workspace/legacy-workspace.component.scss +151 -0
  90. package/artemis-main/apps/showcase_ui/src/app/pages/legacy-workspace/legacy-workspace.component.ts +58 -0
  91. package/artemis-main/apps/showcase_ui/src/app/pages/workspace/workspace.component.html +201 -0
  92. package/artemis-main/apps/showcase_ui/src/app/pages/workspace/workspace.component.scss +886 -0
  93. package/artemis-main/apps/showcase_ui/src/app/pages/workspace/workspace.component.ts +324 -0
  94. package/artemis-main/apps/showcase_ui/src/app/services/agent.service.spec.ts +418 -0
  95. package/artemis-main/apps/showcase_ui/src/app/services/agent.service.ts +2012 -0
  96. package/artemis-main/apps/showcase_ui/src/app/services/system.service.spec.ts +173 -0
  97. package/artemis-main/apps/showcase_ui/src/app/services/system.service.ts +620 -0
  98. package/artemis-main/apps/showcase_ui/src/app/utils/action-formatter.util.spec.ts +513 -0
  99. package/artemis-main/apps/showcase_ui/src/app/utils/action-formatter.util.ts +1015 -0
  100. package/artemis-main/apps/showcase_ui/src/app/utils/image-overlay.util.spec.ts +85 -0
  101. package/artemis-main/apps/showcase_ui/src/app/utils/image-overlay.util.ts +662 -0
  102. package/artemis-main/apps/showcase_ui/src/app/utils/markdown-parser.util.spec.ts +70 -0
  103. package/artemis-main/apps/showcase_ui/src/app/utils/markdown-parser.util.ts +383 -0
  104. package/artemis-main/apps/showcase_ui/src/app/utils/recording-timeline.util.spec.ts +107 -0
  105. package/artemis-main/apps/showcase_ui/src/app/utils/recording-timeline.util.ts +123 -0
  106. package/artemis-main/apps/showcase_ui/src/app/utils/run-info.util.spec.ts +92 -0
  107. package/artemis-main/apps/showcase_ui/src/app/utils/run-info.util.ts +116 -0
  108. package/artemis-main/apps/showcase_ui/src/app/utils/stream-aggregator.util.spec.ts +640 -0
  109. package/artemis-main/apps/showcase_ui/src/app/utils/stream-aggregator.util.ts +1021 -0
  110. package/artemis-main/apps/showcase_ui/src/app/utils/tool-formatter.util.spec.ts +375 -0
  111. package/artemis-main/apps/showcase_ui/src/app/utils/tool-formatter.util.ts +1419 -0
  112. package/artemis-main/apps/showcase_ui/src/index.html +37 -0
  113. package/artemis-main/apps/showcase_ui/src/main.ts +22 -0
  114. package/artemis-main/apps/showcase_ui/src/styles.scss +60 -0
  115. package/artemis-main/apps/showcase_ui/tsconfig.app.json +23 -0
  116. package/artemis-main/apps/showcase_ui/tsconfig.json +27 -0
  117. package/artemis-main/apps/showcase_ui/tsconfig.spec.json +23 -0
  118. package/artemis-main/artemis/__init__.py +44 -0
  119. package/artemis-main/artemis/__main__.py +18 -0
  120. package/artemis-main/artemis/_legacy_imports.py +94 -0
  121. package/artemis-main/artemis/_version.py +30 -0
  122. package/artemis-main/artemis/agents/__init__.py +17 -0
  123. package/artemis-main/artemis/agents/checker/checker.json +9 -0
  124. package/artemis-main/artemis/agents/checker/checker.py +859 -0
  125. package/artemis-main/artemis/agents/diagnoser/diagnoser.json +23 -0
  126. package/artemis-main/artemis/agents/diagnoser/diagnoser.py +608 -0
  127. package/artemis-main/artemis/agents/explorer/constants.py +52 -0
  128. package/artemis-main/artemis/agents/explorer/explorer.json +57 -0
  129. package/artemis-main/artemis/agents/explorer/explorer.py +473 -0
  130. package/artemis-main/artemis/agents/explorer/geometry.py +73 -0
  131. package/artemis-main/artemis/agents/explorer/native_runner.py +878 -0
  132. package/artemis-main/artemis/agents/explorer/perception_tools.py +632 -0
  133. package/artemis-main/artemis/agents/explorer/run_setup.py +403 -0
  134. package/artemis-main/artemis/agents/explorer/screen_index.py +266 -0
  135. package/artemis-main/artemis/agents/explorer/tiers.py +110 -0
  136. package/artemis-main/artemis/agents/explorer/tool_declarations.py +394 -0
  137. package/artemis-main/artemis/agents/explorer/universal_runner.py +317 -0
  138. package/artemis-main/artemis/agents/flash/context_compressor.py +452 -0
  139. package/artemis-main/artemis/agents/flash/flash_runner.md +51 -0
  140. package/artemis-main/artemis/agents/flash/flash_summarizer.md +53 -0
  141. package/artemis-main/artemis/agents/flash/flash_summarizer_single.md +54 -0
  142. package/artemis-main/artemis/agents/flash/runner.py +1167 -0
  143. package/artemis-main/artemis/agents/flash/summarizer.py +511 -0
  144. package/artemis-main/artemis/agents/history_analyzer/history_analyzer.md +8 -0
  145. package/artemis-main/artemis/agents/history_analyzer/history_analyzer.py +182 -0
  146. package/artemis-main/artemis/agents/image_processor/image_processor.md +74 -0
  147. package/artemis-main/artemis/agents/image_processor/image_processor.py +322 -0
  148. package/artemis-main/artemis/agents/log_analyzer/log_analyzer.md +15 -0
  149. package/artemis-main/artemis/agents/log_analyzer/log_analyzer.py +403 -0
  150. package/artemis-main/artemis/agents/log_analyzer/log_reader_sub_agent.md +8 -0
  151. package/artemis-main/artemis/agents/log_analyzer/output_analyzer.md +11 -0
  152. package/artemis-main/artemis/agents/log_analyzer/output_analyzer.py +163 -0
  153. package/artemis-main/artemis/agents/object_detector/object_detector.json +9 -0
  154. package/artemis-main/artemis/agents/object_detector/object_detector.py +211 -0
  155. package/artemis-main/artemis/agents/operator/operator.json +3 -0
  156. package/artemis-main/artemis/agents/operator/operator.py +1394 -0
  157. package/artemis-main/artemis/agents/operator/prompts.py +1064 -0
  158. package/artemis-main/artemis/agents/outputter/outputter.md +36 -0
  159. package/artemis-main/artemis/agents/outputter/outputter.py +552 -0
  160. package/artemis-main/artemis/agents/planner/planner.json +32 -0
  161. package/artemis-main/artemis/agents/planner/planner.py +436 -0
  162. package/artemis-main/artemis/agents/prompt_assembly.py +79 -0
  163. package/artemis-main/artemis/agents/summarizer/summarizer.py +190 -0
  164. package/artemis-main/artemis/agents/validator/action_execution.py +98 -0
  165. package/artemis-main/artemis/agents/validator/categories.py +33 -0
  166. package/artemis-main/artemis/agents/validator/execution_loop.py +488 -0
  167. package/artemis-main/artemis/agents/validator/incidents.py +120 -0
  168. package/artemis-main/artemis/agents/validator/pixel_safety_net.md +15 -0
  169. package/artemis-main/artemis/agents/validator/precondition_pixel.py +320 -0
  170. package/artemis-main/artemis/agents/validator/precondition_xml.py +672 -0
  171. package/artemis-main/artemis/agents/validator/tool_declarations.py +332 -0
  172. package/artemis-main/artemis/agents/validator/validator.py +188 -0
  173. package/artemis-main/artemis/agents/video_analyzer/__init__.py +15 -0
  174. package/artemis-main/artemis/agents/video_analyzer/audio_native.py +543 -0
  175. package/artemis-main/artemis/agents/video_analyzer/blackboard.py +821 -0
  176. package/artemis-main/artemis/agents/video_analyzer/chunk_agentic.py +455 -0
  177. package/artemis-main/artemis/agents/video_analyzer/chunk_conversation.py +491 -0
  178. package/artemis-main/artemis/agents/video_analyzer/chunk_native.py +437 -0
  179. package/artemis-main/artemis/agents/video_analyzer/conflict_resolution.py +137 -0
  180. package/artemis-main/artemis/agents/video_analyzer/gemini_files.py +162 -0
  181. package/artemis-main/artemis/agents/video_analyzer/native_coordinator.py +541 -0
  182. package/artemis-main/artemis/agents/video_analyzer/reliability.py +128 -0
  183. package/artemis-main/artemis/agents/video_analyzer/universal_engine.py +487 -0
  184. package/artemis-main/artemis/agents/video_analyzer/universal_tools.py +323 -0
  185. package/artemis-main/artemis/agents/video_analyzer/video_analyzer.md +51 -0
  186. package/artemis-main/artemis/agents/video_analyzer/video_analyzer.py +875 -0
  187. package/artemis-main/artemis/agents/video_analyzer/video_sub_agent.md +15 -0
  188. package/artemis-main/artemis/agents/video_analyzer/video_sub_agent_audio.md +12 -0
  189. package/artemis-main/artemis/clients/accessibility_client.py +438 -0
  190. package/artemis-main/artemis/clients/screen_client_factory.py +403 -0
  191. package/artemis-main/artemis/config/__init__.py +309 -0
  192. package/artemis-main/artemis/config/agent.py +1098 -0
  193. package/artemis-main/artemis/config/constants.py +151 -0
  194. package/artemis-main/artemis/config/core/__init__.py +24 -0
  195. package/artemis-main/artemis/config/core/engine.py +118 -0
  196. package/artemis-main/artemis/config/core/interpolator.py +78 -0
  197. package/artemis-main/artemis/config/llm.py +267 -0
  198. package/artemis-main/artemis/config/paths.py +244 -0
  199. package/artemis-main/artemis/config/runtime.py +197 -0
  200. package/artemis-main/artemis/config/settings.py +315 -0
  201. package/artemis-main/artemis/constants.py +47 -0
  202. package/artemis-main/artemis/context.py +289 -0
  203. package/artemis-main/artemis/controllers/__init__.py +41 -0
  204. package/artemis-main/artemis/controllers/controller_factory.py +41 -0
  205. package/artemis-main/artemis/controllers/device_controller.py +29 -0
  206. package/artemis-main/artemis/controllers/types.py +37 -0
  207. package/artemis-main/artemis/controllers/unified_controller.py +649 -0
  208. package/artemis-main/artemis/core/__init__.py +21 -0
  209. package/artemis-main/artemis/core/diagnostics/__init__.py +90 -0
  210. package/artemis-main/artemis/core/diagnostics/adb_keys.py +270 -0
  211. package/artemis-main/artemis/core/diagnostics/adb_server_connection.py +330 -0
  212. package/artemis-main/artemis/core/diagnostics/device_smoke.py +364 -0
  213. package/artemis-main/artemis/core/diagnostics/emulator_manager.py +501 -0
  214. package/artemis-main/artemis/core/diagnostics/engine.py +438 -0
  215. package/artemis-main/artemis/core/diagnostics/hierarchy_parity.py +216 -0
  216. package/artemis-main/artemis/core/diagnostics/probes/adb_probe.py +887 -0
  217. package/artemis-main/artemis/core/diagnostics/probes/base.py +45 -0
  218. package/artemis-main/artemis/core/diagnostics/probes/credentials_probe.py +296 -0
  219. package/artemis-main/artemis/core/diagnostics/probes/host_probe.py +427 -0
  220. package/artemis-main/artemis/core/diagnostics/probes/runtime_probe.py +169 -0
  221. package/artemis-main/artemis/core/diagnostics/probes/toolchain_probe.py +139 -0
  222. package/artemis-main/artemis/core/diagnostics/readiness.py +83 -0
  223. package/artemis-main/artemis/core/diagnostics/schema.py +118 -0
  224. package/artemis-main/artemis/core/tool_declaration.py +43 -0
  225. package/artemis-main/artemis/core/tool_failure.py +56 -0
  226. package/artemis-main/artemis/data_engine/context_vars.py +24 -0
  227. package/artemis-main/artemis/data_engine/engine.py +1615 -0
  228. package/artemis-main/artemis/data_engine/history_reader.py +142 -0
  229. package/artemis-main/artemis/data_engine/models.py +131 -0
  230. package/artemis-main/artemis/data_engine/storage.py +1245 -0
  231. package/artemis-main/artemis/data_engine/trace.py +727 -0
  232. package/artemis-main/artemis/drivers/__init__.py +48 -0
  233. package/artemis-main/artemis/drivers/android/adb_driver.py +507 -0
  234. package/artemis-main/artemis/drivers/android/hierarchy.py +64 -0
  235. package/artemis-main/artemis/drivers/android/input_ime.py +120 -0
  236. package/artemis-main/artemis/drivers/android/recorder.py +57 -0
  237. package/artemis-main/artemis/drivers/base.py +290 -0
  238. package/artemis-main/artemis/drivers/cloud/cloud_driver.py +117 -0
  239. package/artemis-main/artemis/drivers/factory.py +80 -0
  240. package/artemis-main/artemis/drivers/mock/mock_driver.py +198 -0
  241. package/artemis-main/artemis/drivers/types.py +67 -0
  242. package/artemis-main/artemis/graph/checkpoints.py +1243 -0
  243. package/artemis-main/artemis/graph/graph.py +1055 -0
  244. package/artemis-main/artemis/graph/perception.py +234 -0
  245. package/artemis-main/artemis/graph/state.py +151 -0
  246. package/artemis-main/artemis/graph/visibility.py +238 -0
  247. package/artemis-main/artemis/interfaces/cli/__init__.py +19 -0
  248. package/artemis-main/artemis/interfaces/cli/commands/__init__.py +15 -0
  249. package/artemis-main/artemis/interfaces/cli/commands/batch.py +278 -0
  250. package/artemis-main/artemis/interfaces/cli/commands/doctor.py +468 -0
  251. package/artemis-main/artemis/interfaces/cli/commands/helper.py +226 -0
  252. package/artemis-main/artemis/interfaces/cli/commands/init.py +193 -0
  253. package/artemis-main/artemis/interfaces/cli/commands/mcp.py +862 -0
  254. package/artemis-main/artemis/interfaces/cli/commands/run.py +463 -0
  255. package/artemis-main/artemis/interfaces/cli/commands/server.py +151 -0
  256. package/artemis-main/artemis/interfaces/cli/commands/server_lifecycle.py +328 -0
  257. package/artemis-main/artemis/interfaces/cli/commands/trace.py +111 -0
  258. package/artemis-main/artemis/interfaces/cli/commands/ui.py +404 -0
  259. package/artemis-main/artemis/interfaces/cli/main.py +109 -0
  260. package/artemis-main/artemis/interfaces/sdk/__init__.py +31 -0
  261. package/artemis-main/artemis/interfaces/sdk/client.py +19 -0
  262. package/artemis-main/artemis/interfaces/sdk/task.py +72 -0
  263. package/artemis-main/artemis/llm/__init__.py +25 -0
  264. package/artemis-main/artemis/llm/fake_model.py +179 -0
  265. package/artemis-main/artemis/llm/google/__init__.py +57 -0
  266. package/artemis-main/artemis/llm/google/provider.py +185 -0
  267. package/artemis-main/artemis/llm/google/usage.py +148 -0
  268. package/artemis-main/artemis/llm/parser.py +32 -0
  269. package/artemis-main/artemis/llm/reliability.py +267 -0
  270. package/artemis-main/artemis/llm/router.py +389 -0
  271. package/artemis-main/artemis/llm/schemas.py +36 -0
  272. package/artemis-main/artemis/llm/structured.py +196 -0
  273. package/artemis-main/artemis/main.py +58 -0
  274. package/artemis-main/artemis/mcp/__init__.py +20 -0
  275. package/artemis-main/artemis/mcp/action_executor.py +760 -0
  276. package/artemis-main/artemis/mcp/action_manifest.py +320 -0
  277. package/artemis-main/artemis/mcp/action_names.py +172 -0
  278. package/artemis-main/artemis/mcp/action_server.py +202 -0
  279. package/artemis-main/artemis/mcp/action_session.py +245 -0
  280. package/artemis-main/artemis/mcp/action_specs.py +868 -0
  281. package/artemis-main/artemis/mcp/action_types.py +86 -0
  282. package/artemis-main/artemis/mcp/actuators/__init__.py +21 -0
  283. package/artemis-main/artemis/mcp/actuators/adb.py +414 -0
  284. package/artemis-main/artemis/mcp/actuators/base.py +113 -0
  285. package/artemis-main/artemis/mcp/actuators/mock.py +70 -0
  286. package/artemis-main/artemis/mcp/adb_server.py +490 -0
  287. package/artemis-main/artemis/mcp/observation.py +133 -0
  288. package/artemis-main/artemis/mcp/xml_search_server.py +297 -0
  289. package/artemis-main/artemis/memory/__init__.py +90 -0
  290. package/artemis-main/artemis/memory/chunking.py +1843 -0
  291. package/artemis-main/artemis/memory/context_policy.py +226 -0
  292. package/artemis-main/artemis/memory/step_capsule.md +73 -0
  293. package/artemis-main/artemis/memory/step_memory.py +281 -0
  294. package/artemis-main/artemis/memory/transcript.py +798 -0
  295. package/artemis-main/artemis/platform/__init__.py +61 -0
  296. package/artemis-main/artemis/platform/base.py +104 -0
  297. package/artemis-main/artemis/platform/darwin.py +184 -0
  298. package/artemis-main/artemis/platform/linux.py +207 -0
  299. package/artemis-main/artemis/platform/windows.py +193 -0
  300. package/artemis-main/artemis/resources/__init__.py +46 -0
  301. package/artemis-main/artemis/runtime/__init__.py +108 -0
  302. package/artemis-main/artemis/runtime/adb_endpoint.py +173 -0
  303. package/artemis-main/artemis/runtime/awake_lease.py +283 -0
  304. package/artemis-main/artemis/runtime/awake_service.py +343 -0
  305. package/artemis-main/artemis/runtime/cancel_requests.py +254 -0
  306. package/artemis-main/artemis/runtime/daemon_client.py +422 -0
  307. package/artemis-main/artemis/runtime/device_lock.py +1013 -0
  308. package/artemis-main/artemis/runtime/device_pool.py +478 -0
  309. package/artemis-main/artemis/runtime/helper_manager.py +1030 -0
  310. package/artemis-main/artemis/runtime/process_probe.py +98 -0
  311. package/artemis-main/artemis/runtime/server_lifecycle.py +435 -0
  312. package/artemis-main/artemis/runtime/supervisor.py +121 -0
  313. package/artemis-main/artemis/runtime/trace_store.py +375 -0
  314. package/artemis-main/artemis/sdk/__init__.py +26 -0
  315. package/artemis-main/artemis/sdk/agent.py +485 -0
  316. package/artemis-main/artemis/sdk/builders/__init__.py +29 -0
  317. package/artemis-main/artemis/sdk/builders/agent_config_builder.py +474 -0
  318. package/artemis-main/artemis/sdk/constants.py +15 -0
  319. package/artemis-main/artemis/sdk/run_outcome.py +58 -0
  320. package/artemis-main/artemis/sdk/types/__init__.py +61 -0
  321. package/artemis-main/artemis/sdk/types/agent.py +89 -0
  322. package/artemis-main/artemis/sdk/utils.py +28 -0
  323. package/artemis-main/artemis/services/llm.py +1040 -0
  324. package/artemis-main/artemis/services/token_meter.py +267 -0
  325. package/artemis-main/artemis/telemetry/__init__.py +35 -0
  326. package/artemis-main/artemis/telemetry/models.py +64 -0
  327. package/artemis-main/artemis/telemetry/replay.py +34 -0
  328. package/artemis-main/artemis/telemetry/storage/json_storage.py +47 -0
  329. package/artemis-main/artemis/telemetry/tracer.py +85 -0
  330. package/artemis-main/artemis/toolchain/__init__.py +52 -0
  331. package/artemis-main/artemis/toolchain/descriptors.py +92 -0
  332. package/artemis-main/artemis/toolchain/resolver.py +185 -0
  333. package/artemis-main/artemis/tools/base.py +232 -0
  334. package/artemis-main/artemis/tools/command_tool.py +1240 -0
  335. package/artemis-main/artemis/tools/committee_prompts.json +5 -0
  336. package/artemis-main/artemis/tools/committee_tool.py +422 -0
  337. package/artemis-main/artemis/tools/diagnoser_submit_answer_tool.py +87 -0
  338. package/artemis-main/artemis/tools/diagnostic_tool.py +120 -0
  339. package/artemis-main/artemis/tools/explorer_tool.py +581 -0
  340. package/artemis-main/artemis/tools/history/__init__.py +398 -0
  341. package/artemis-main/artemis/tools/history/replay.py +120 -0
  342. package/artemis-main/artemis/tools/history/screenshot.py +139 -0
  343. package/artemis-main/artemis/tools/history/search.py +563 -0
  344. package/artemis-main/artemis/tools/image_processor_tool.py +124 -0
  345. package/artemis-main/artemis/tools/index.py +47 -0
  346. package/artemis-main/artemis/tools/log_tool.py +108 -0
  347. package/artemis-main/artemis/tools/mobile/launch_app.py +132 -0
  348. package/artemis-main/artemis/tools/mobile/log_utils.py +138 -0
  349. package/artemis-main/artemis/tools/mobile/ocr.py +202 -0
  350. package/artemis-main/artemis/tools/mobile/read_hierarchy.py +108 -0
  351. package/artemis-main/artemis/tools/mobile/read_logs.py +116 -0
  352. package/artemis-main/artemis/tools/mobile/search_logs.py +260 -0
  353. package/artemis-main/artemis/tools/object_detection_tool.py +244 -0
  354. package/artemis-main/artemis/tools/scratchpad.py +819 -0
  355. package/artemis-main/artemis/tools/system/adb_shell.py +31 -0
  356. package/artemis-main/artemis/tools/tool_wrapper.py +270 -0
  357. package/artemis-main/artemis/tools/video_tool.py +261 -0
  358. package/artemis-main/artemis/tools/wait_tool.py +97 -0
  359. package/artemis-main/artemis/utils/app_launch_utils.py +207 -0
  360. package/artemis-main/artemis/utils/coordinates.py +606 -0
  361. package/artemis-main/artemis/utils/credentials_validator.py +201 -0
  362. package/artemis-main/artemis/utils/cv_canvas.py +189 -0
  363. package/artemis-main/artemis/utils/cython_compat.py +45 -0
  364. package/artemis-main/artemis/utils/element_hit_test.py +80 -0
  365. package/artemis-main/artemis/utils/image_diff.py +335 -0
  366. package/artemis-main/artemis/utils/image_hash.py +80 -0
  367. package/artemis-main/artemis/utils/notes.py +470 -0
  368. package/artemis-main/artemis/utils/ocr_api.py +105 -0
  369. package/artemis-main/artemis/utils/ocr_xml_fusion.py +318 -0
  370. package/artemis-main/artemis/utils/plan_grammar.py +513 -0
  371. package/artemis-main/artemis/utils/python_executor.py +213 -0
  372. package/artemis-main/artemis/utils/startup_progress.py +60 -0
  373. package/artemis-main/artemis/utils/task_tree.py +1174 -0
  374. package/artemis-main/artemis/utils/text.py +37 -0
  375. package/artemis-main/artemis/utils/ui_filter.py +651 -0
  376. package/artemis-main/artemis/utils/video.py +685 -0
  377. package/artemis-main/artemis/utils/visualization.py +802 -0
  378. package/artemis-main/config/artemis.example.jsonc +12 -0
  379. package/artemis-main/mcp_server/README.md +111 -0
  380. package/artemis-main/mcp_server/__init__.py +21 -0
  381. package/artemis-main/mcp_server/__main__.py +20 -0
  382. package/artemis-main/mcp_server/background/__init__.py +15 -0
  383. package/artemis-main/mcp_server/background/task_runner.py +453 -0
  384. package/artemis-main/mcp_server/base.py +49 -0
  385. package/artemis-main/mcp_server/notifiers/__init__.py +74 -0
  386. package/artemis-main/mcp_server/notifiers/agentapi.py +289 -0
  387. package/artemis-main/mcp_server/notifiers/base.py +45 -0
  388. package/artemis-main/mcp_server/notifiers/composite.py +87 -0
  389. package/artemis-main/mcp_server/notifiers/desktop.py +108 -0
  390. package/artemis-main/mcp_server/notifiers/file.py +69 -0
  391. package/artemis-main/mcp_server/notifiers/script.py +90 -0
  392. package/artemis-main/mcp_server/notifiers/webhook.py +87 -0
  393. package/artemis-main/mcp_server/rules.md +68 -0
  394. package/artemis-main/mcp_server/server.py +106 -0
  395. package/artemis-main/mcp_server/tools/__init__.py +29 -0
  396. package/artemis-main/mcp_server/tools/device_state.py +107 -0
  397. package/artemis-main/mcp_server/tools/diagnose.py +1249 -0
  398. package/artemis-main/mcp_server/tools/inspect_trace.py +394 -0
  399. package/artemis-main/mcp_server/tools/task_manager.py +627 -0
  400. package/artemis-main/mcp_server/tools/task_runner.py +548 -0
  401. package/artemis-main/mcp_server/utils/__init__.py +15 -0
  402. package/artemis-main/mcp_server/utils/device_utils.py +180 -0
  403. package/artemis-main/mcp_server/utils/env_utils.py +65 -0
  404. package/artemis-main/packages/artemis-accessibility-helper/ArtemisAccessibilityHelper.apk +0 -0
  405. package/artemis-main/packages/artemis-accessibility-helper/app/build.gradle.kts +35 -0
  406. package/artemis-main/packages/artemis-accessibility-helper/app/src/main/AndroidManifest.xml +49 -0
  407. package/artemis-main/packages/artemis-accessibility-helper/app/src/main/java/com/artemis/helper/A11yNode.java +274 -0
  408. package/artemis-main/packages/artemis-accessibility-helper/app/src/main/java/com/artemis/helper/ArtemisAccessibilityService.java +227 -0
  409. package/artemis-main/packages/artemis-accessibility-helper/app/src/main/java/com/artemis/helper/CommandServer.java +463 -0
  410. package/artemis-main/packages/artemis-accessibility-helper/app/src/main/java/com/artemis/helper/DisplayUtils.java +111 -0
  411. package/artemis-main/packages/artemis-accessibility-helper/app/src/main/java/com/artemis/helper/GestureController.java +232 -0
  412. package/artemis-main/packages/artemis-accessibility-helper/app/src/main/java/com/artemis/helper/HierarchyDumper.java +832 -0
  413. package/artemis-main/packages/artemis-accessibility-helper/app/src/main/java/com/artemis/helper/TokenReceiver.java +36 -0
  414. package/artemis-main/packages/artemis-accessibility-helper/app/src/main/java/com/artemis/helper/TokenStore.java +38 -0
  415. package/artemis-main/packages/artemis-accessibility-helper/app/src/main/java/com/artemis/helper/XmlUtils.java +102 -0
  416. package/artemis-main/packages/artemis-accessibility-helper/app/src/main/res/values/strings.xml +4 -0
  417. package/artemis-main/packages/artemis-accessibility-helper/app/src/main/res/xml/accessibility_service_config.xml +10 -0
  418. package/artemis-main/packages/artemis-accessibility-helper/build.gradle.kts +3 -0
  419. package/artemis-main/packages/artemis-accessibility-helper/build_apk.sh +215 -0
  420. package/artemis-main/packages/artemis-accessibility-helper/debug.keystore +0 -0
  421. package/artemis-main/packages/artemis-accessibility-helper/gradle.properties +2 -0
  422. package/artemis-main/packages/artemis-accessibility-helper/helper_manifest.json +7 -0
  423. package/artemis-main/packages/artemis-accessibility-helper/settings.gradle.kts +17 -0
  424. package/artemis-main/packages/artemis-client/DESIGN.md +89 -0
  425. package/artemis-main/packages/artemis-client/README.md +112 -0
  426. package/artemis-main/packages/artemis-client/examples/basic.py +30 -0
  427. package/artemis-main/packages/artemis-client/pyproject.toml +36 -0
  428. package/artemis-main/packages/artemis-client/src/artemis_client/__init__.py +45 -0
  429. package/artemis-main/packages/artemis-client/src/artemis_client/client.py +401 -0
  430. package/artemis-main/packages/artemis-client/src/artemis_client/errors.py +66 -0
  431. package/artemis-main/packages/artemis-client/src/artemis_client/models.py +212 -0
  432. package/artemis-main/packages/artemis-client/src/artemis_client/py.typed +1 -0
  433. package/artemis-main/packages/artemis-client/src/artemis_client/transport.py +134 -0
  434. package/artemis-main/packages/artemis-client/tests/test_client.py +289 -0
  435. package/artemis-main/packages/artemis-client/tests/test_transport.py +85 -0
  436. package/artemis-main/pyproject.toml +259 -0
  437. package/artemis-main/pyright-core.json +17 -0
  438. package/artemis-main/scripts/check_dependency_sources.py +68 -0
  439. package/artemis-main/scripts/install_deps.ps1 +520 -0
  440. package/artemis-main/scripts/install_deps.sh +533 -0
  441. package/artemis-main/scripts/quality_ratchet.py +97 -0
  442. package/artemis-main/scripts/real_device_video_acceptance.py +483 -0
  443. package/artemis-main/scripts/run_edge_case_part.py +327 -0
  444. package/artemis-main/scripts/run_ui.py +242 -0
  445. package/artemis-main/scripts/start.ps1 +500 -0
  446. package/artemis-main/scripts/test_all_edge_cases.py +269 -0
  447. package/artemis-main/scripts/verify_concurrency_and_devices.py +385 -0
  448. package/artemis-main/setup.py +164 -0
  449. package/artemis-main/start.bat +35 -0
  450. package/artemis-main/start.sh +423 -0
  451. package/artemis-main/third_party/mobile_use/LICENSE +190 -0
  452. package/artemis-main/third_party/mobile_use/METADATA +27 -0
  453. package/artemis-main/third_party/mobile_use/NOTICE +12 -0
  454. package/artemis-main/third_party/mobile_use/__init__.py +19 -0
  455. package/artemis-main/third_party/mobile_use/agents/__init__.py +13 -0
  456. package/artemis-main/third_party/mobile_use/agents/hopper/__init__.py +13 -0
  457. package/artemis-main/third_party/mobile_use/agents/hopper/hopper.md +22 -0
  458. package/artemis-main/third_party/mobile_use/agents/hopper/hopper.py +80 -0
  459. package/artemis-main/third_party/mobile_use/clients/__init__.py +13 -0
  460. package/artemis-main/third_party/mobile_use/clients/ui_automator_client.py +482 -0
  461. package/artemis-main/third_party/mobile_use/config/__init__.py +13 -0
  462. package/artemis-main/third_party/mobile_use/config/llm.py +183 -0
  463. package/artemis-main/third_party/mobile_use/config/output.py +184 -0
  464. package/artemis-main/third_party/mobile_use/context.py +119 -0
  465. package/artemis-main/third_party/mobile_use/controllers/__init__.py +13 -0
  466. package/artemis-main/third_party/mobile_use/controllers/platform_specific_commands_controller.py +151 -0
  467. package/artemis-main/third_party/mobile_use/controllers/types.py +92 -0
  468. package/artemis-main/third_party/mobile_use/controllers/unified_controller.py +183 -0
  469. package/artemis-main/third_party/mobile_use/graph.py +54 -0
  470. package/artemis-main/third_party/mobile_use/llm_service.py +193 -0
  471. package/artemis-main/third_party/mobile_use/main.py +130 -0
  472. package/artemis-main/third_party/mobile_use/sdk/__init__.py +13 -0
  473. package/artemis-main/third_party/mobile_use/sdk/agent.py +1060 -0
  474. package/artemis-main/third_party/mobile_use/sdk/builders/__init__.py +13 -0
  475. package/artemis-main/third_party/mobile_use/sdk/builders/agent_config_builder.py +225 -0
  476. package/artemis-main/third_party/mobile_use/sdk/builders/index.py +33 -0
  477. package/artemis-main/third_party/mobile_use/sdk/builders/task_request_builder.py +243 -0
  478. package/artemis-main/third_party/mobile_use/sdk/types/__init__.py +13 -0
  479. package/artemis-main/third_party/mobile_use/sdk/types/agent.py +98 -0
  480. package/artemis-main/third_party/mobile_use/sdk/types/exceptions.py +109 -0
  481. package/artemis-main/third_party/mobile_use/sdk/types/task.py +234 -0
  482. package/artemis-main/third_party/mobile_use/testing.py +59 -0
  483. package/artemis-main/third_party/mobile_use/tools/__init__.py +13 -0
  484. package/artemis-main/third_party/mobile_use/tools/index.py +44 -0
  485. package/artemis-main/third_party/mobile_use/tools/mobile/__init__.py +13 -0
  486. package/artemis-main/third_party/mobile_use/tools/mobile/launch_app.py +89 -0
  487. package/artemis-main/third_party/mobile_use/tools/tool_wrapper.py +52 -0
  488. package/artemis-main/third_party/mobile_use/utils/__init__.py +13 -0
  489. package/artemis-main/third_party/mobile_use/utils/app_launch_utils.py +217 -0
  490. package/artemis-main/third_party/mobile_use/utils/cli_helpers.py +60 -0
  491. package/artemis-main/third_party/mobile_use/utils/decorators.py +158 -0
  492. package/artemis-main/third_party/mobile_use/utils/file.py +31 -0
  493. package/artemis-main/third_party/mobile_use/utils/logger.py +216 -0
  494. package/artemis-main/third_party/mobile_use/utils/media.py +213 -0
  495. package/artemis-main/third_party/mobile_use/utils/shell_utils.py +39 -0
  496. package/artemis-main/third_party/mobile_use/utils/video.py +398 -0
  497. package/artemis-main/uv.lock +4908 -0
  498. package/bin/android-midscene-automation.js +1 -5
  499. package/bin/artemis-config.mjs +15 -0
  500. package/bin/artemis-embedded.py +56 -0
  501. package/bin/start-artemis.mjs +30 -0
  502. package/bin/start-dev.mjs +112 -0
  503. package/bin/test_artemis_embedded.py +44 -0
  504. package/package.json +4 -2
  505. package/server/artemis.ts +34 -0
  506. package/server/http-api.ts +12 -0
  507. package/src/App.vue +10 -5
  508. package/src/api.ts +5 -0
  509. package/src/appium-recorder/AppiumPage.vue +1 -1
  510. package/src/appium-recorder/components/ComponentInspector.vue +1 -1
  511. package/src/appium-recorder/components/FlowNodeSearch.vue +3 -3
  512. package/src/appium-recorder/components/ImageCheckDialog.vue +3 -3
  513. package/src/appium-recorder/components/RecorderWorkspace.vue +4 -4
  514. package/src/appium-recorder/flow-appearance.ts +4 -4
  515. package/src/components/AppSidebar.vue +8 -7
  516. package/src/components/MidsceneMaintenanceNotice.vue +17 -0
  517. package/src/components/analytics/AnalysisCharts.vue +4 -4
  518. package/src/components/analytics/ReportAnalysis.vue +1 -1
  519. package/src/components/generator/TestCaseFileUpload.vue +1 -1
  520. package/src/components/help/HelpCenter.vue +56 -37
  521. package/src/pages/AiGeneratorPage.vue +1 -1
  522. package/src/pages/ArtemisPage.vue +72 -0
  523. package/src/pages/ConfigPage.vue +18 -19
  524. package/src/style.css +340 -121
  525. package/src/types.ts +1 -1
@@ -0,0 +1,632 @@
1
+ import { TranslatePipe } from '../../core/i18n/translate.pipe';
2
+ /**
3
+ * Copyright 2026 Google LLC
4
+ *
5
+ * Licensed under the Apache License, Version 2.0 (the "License");
6
+ * you may not use this file except in compliance with the License.
7
+ * You may obtain a copy of the License at
8
+ *
9
+ * http://www.apache.org/licenses/LICENSE-2.0
10
+ *
11
+ * Unless required by applicable law or agreed to in writing, software
12
+ * distributed under the License is distributed on an "AS IS" BASIS,
13
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ * See the License for the specific language governing permissions and
15
+ * limitations under the License.
16
+ */
17
+
18
+ import {
19
+ Component,
20
+ ChangeDetectionStrategy,
21
+ NgZone,
22
+ inject,
23
+ signal,
24
+ computed,
25
+ ElementRef,
26
+ ViewChild,
27
+ HostListener,
28
+ effect,
29
+ OnDestroy
30
+ } from '@angular/core';
31
+
32
+ import { FormsModule } from '@angular/forms';
33
+ import { AgentService } from '../../services/agent.service';
34
+ import { StepReplayFrame } from '../../core/models/stream.model';
35
+ import { drawActionCoordinatesOnOverlay } from '../../utils/image-overlay.util';
36
+ import { getActionIcon } from '../../utils/action-formatter.util';
37
+ import { locateTimelineTime, sessionTimeToTimelineTime } from '../../utils/recording-timeline.util';
38
+
39
+ @Component({
40
+ selector: 'app-floating-video-player',
41
+ standalone: true,
42
+ imports: [TranslatePipe, FormsModule],
43
+ templateUrl: './floating-video-player.component.html',
44
+ styleUrl: './floating-video-player.component.scss',
45
+ changeDetection: ChangeDetectionStrategy.OnPush
46
+ })
47
+ export class FloatingVideoPlayerComponent implements OnDestroy {
48
+ public agentService = inject(AgentService);
49
+ private zone = inject(NgZone);
50
+
51
+ @ViewChild('videoRef') videoRef?: ElementRef<HTMLVideoElement>;
52
+ @ViewChild('stepImgRef') stepImgRef?: ElementRef<HTMLImageElement>;
53
+ @ViewChild('stepOverlayRef') stepOverlayRef?: ElementRef<HTMLElement>;
54
+
55
+ // Playback state signals
56
+ public isPlaying = signal<boolean>(false);
57
+ public playbackRate = signal<number>(1.0);
58
+ public isLooping = signal<boolean>(false);
59
+ public currentTime = signal<number>(0);
60
+ public duration = signal<number>(0);
61
+ public isMuted = signal<boolean>(false);
62
+ public isTheaterMode = signal<boolean>(false);
63
+ public videoLoadError = signal<boolean>(false);
64
+ public liveStreamUrl = signal<string>('/api/stream/device-live');
65
+ public liveStreamError = signal<boolean>(false);
66
+ public activeSegmentIndex = signal<number>(0);
67
+ public currentVideoUrl = computed(() => {
68
+ const segments = this.agentService.activeVideoSegments();
69
+ return segments[this.activeSegmentIndex()]?.url || this.agentService.activeVideoUrl();
70
+ });
71
+ private pendingLocalTime: number | null = null;
72
+ private pendingAutoplay = false;
73
+ private pendingAbsoluteSeek: number | null = null;
74
+
75
+ // Step Replay state signals
76
+ public activeStepIndex = signal<number>(0);
77
+ public isStepPlaying = signal<boolean>(false);
78
+ public viewMode = signal<'pre' | 'post'>('pre'); // 'pre' = action preview with coords, 'post' = action result
79
+ public isCardHovered = signal<boolean>(false);
80
+ public isCardPinned = signal<boolean>(false);
81
+ public isCardVisible = computed(() => this.isCardHovered() || this.isCardPinned());
82
+ public isStepImageLoading = signal<boolean>(false);
83
+ public stepImageError = signal<boolean>(false);
84
+ private stepTimer: any = null;
85
+
86
+ public stepFrames = computed(() => this.agentService.currentSessionStepFrames());
87
+ public totalStepFrames = computed(() => this.stepFrames().length);
88
+ public currentStepFrame = computed<StepReplayFrame | null>(() => {
89
+ const frames = this.stepFrames();
90
+ const idx = this.activeStepIndex();
91
+ return frames[idx] || null;
92
+ });
93
+ public currentStepImageUrl = computed<string>(() => {
94
+ const frame = this.currentStepFrame();
95
+ if (!frame) return '';
96
+ if (this.viewMode() === 'post' && frame.postImageUrl) {
97
+ return frame.postImageUrl;
98
+ }
99
+ return frame.preImageUrl || frame.imageUrl || '';
100
+ });
101
+ public stepProgressPercent = computed(() => {
102
+ const total = this.totalStepFrames();
103
+ if (total <= 1) return 0;
104
+ return (this.activeStepIndex() / (total - 1)) * 100;
105
+ });
106
+
107
+ // Available speed options
108
+ public speedOptions = [0.5, 1.0, 1.5, 2.0, 4.0];
109
+
110
+ // Dragging and window positioning state
111
+ public posX = signal<number>(
112
+ typeof window !== 'undefined' ? Math.max(20, window.innerWidth - 420) : 100
113
+ );
114
+ public posY = signal<number>(
115
+ typeof window !== 'undefined' ? Math.max(60, window.innerHeight - 700) : 100
116
+ );
117
+
118
+ private isDragging = false;
119
+ private dragStartX = 0;
120
+ private dragStartY = 0;
121
+ private initialPosX = 0;
122
+ private initialPosY = 0;
123
+
124
+ constructor() {
125
+ // Reset video load error whenever active video URL changes
126
+ effect(
127
+ () => {
128
+ const url = this.agentService.activeVideoUrl();
129
+ const segments = this.agentService.activeVideoSegments();
130
+ this.videoLoadError.set(false);
131
+ this.activeSegmentIndex.set(0);
132
+ this.currentTime.set(0);
133
+ this.duration.set(segments.reduce((sum, segment) => sum + segment.duration, 0));
134
+ this.isPlaying.set(false);
135
+ },
136
+ { allowSignalWrites: true }
137
+ );
138
+
139
+ // Reset step playback state only when session actually changes
140
+ let lastTrackedSessionId: string | null = null;
141
+ effect(
142
+ () => {
143
+ const curSessionId = this.agentService.currentSessionId();
144
+ const total = this.totalStepFrames();
145
+ if (curSessionId !== lastTrackedSessionId) {
146
+ lastTrackedSessionId = curSessionId;
147
+ this.activeStepIndex.set(0);
148
+ this.viewMode.set('pre');
149
+ this.pauseStepPlay();
150
+ } else if (total > 0 && this.activeStepIndex() >= total) {
151
+ this.activeStepIndex.set(total - 1);
152
+ }
153
+ },
154
+ { allowSignalWrites: true }
155
+ );
156
+
157
+ // Track step screenshot URL changes and reset loading/error state
158
+ effect(() => {
159
+ const url = this.currentStepImageUrl();
160
+ if (url) {
161
+ this.isStepImageLoading.set(true);
162
+ this.stepImageError.set(false);
163
+ } else {
164
+ this.isStepImageLoading.set(false);
165
+ }
166
+ }, { allowSignalWrites: true });
167
+
168
+ // Re-draw overlay whenever activeStepIndex or viewMode changes
169
+ effect(() => {
170
+ this.activeStepIndex();
171
+ this.viewMode();
172
+ setTimeout(() => this.drawStepOverlay(), 40);
173
+ });
174
+
175
+ effect(() => {
176
+ const request = this.agentService.videoSeekRequest();
177
+ if (!request) return;
178
+ this.pendingAbsoluteSeek = request.seconds;
179
+ if (this.agentService.recordingPlaybackStatus() !== 'ready') return;
180
+ const video = this.videoRef?.nativeElement;
181
+ if (video && video.readyState >= 1) {
182
+ const target = this.pendingAbsoluteSeek;
183
+ this.pendingAbsoluteSeek = null;
184
+ this.seekToSessionTime(target, true);
185
+ }
186
+ });
187
+
188
+ effect(() => {
189
+ const request = this.agentService.stepSeekRequest();
190
+ if (!request) return;
191
+ this.seekStepFrame(request.index);
192
+ });
193
+ }
194
+
195
+ public onLiveStreamError(): void {
196
+ this.liveStreamError.set(true);
197
+ }
198
+
199
+ public retryLiveStream(): void {
200
+ this.liveStreamError.set(false);
201
+ this.liveStreamUrl.set(`/api/stream/device-live?t=${Date.now()}`);
202
+ }
203
+
204
+ /**
205
+ * Format seconds into mm:ss format
206
+ */
207
+ public formatTime(seconds: number): string {
208
+ if (isNaN(seconds) || seconds < 0) return '00:00';
209
+ const mins = Math.floor(seconds / 60);
210
+ const secs = Math.floor(seconds % 60);
211
+ const mStr = mins < 10 ? '0' + mins : String(mins);
212
+ const sStr = secs < 10 ? '0' + secs : String(secs);
213
+ return `${mStr}:${sStr}`;
214
+ }
215
+
216
+ /**
217
+ * Progress percentage for timeline scrubber (0 - 100)
218
+ */
219
+ public progressPercent = computed(() => {
220
+ const dur = this.duration();
221
+ if (dur <= 0) return 0;
222
+ return Math.min(100, Math.max(0, (this.currentTime() / dur) * 100));
223
+ });
224
+
225
+ /**
226
+ * Start dragging the window from header. The move/up listeners are attached
227
+ * only for the duration of the drag and live outside the Angular zone, so
228
+ * ordinary mouse movement over the page never touches change detection.
229
+ */
230
+ public startDrag(event: MouseEvent): void {
231
+ if (this.isTheaterMode()) return;
232
+ this.isDragging = true;
233
+ this.dragStartX = event.clientX;
234
+ this.dragStartY = event.clientY;
235
+ this.initialPosX = this.posX();
236
+ this.initialPosY = this.posY();
237
+ event.preventDefault();
238
+
239
+ this.zone.runOutsideAngular(() => {
240
+ document.addEventListener('mousemove', this.onDrag);
241
+ document.addEventListener('mouseup', this.stopDrag);
242
+ });
243
+ }
244
+
245
+ private onDrag = (event: MouseEvent): void => {
246
+ if (!this.isDragging) return;
247
+ const deltaX = event.clientX - this.dragStartX;
248
+ const deltaY = event.clientY - this.dragStartY;
249
+
250
+ const minX = 10;
251
+ const minY = 10;
252
+ const maxX = Math.max(10, window.innerWidth - 240);
253
+ const maxY = Math.max(10, window.innerHeight - 80);
254
+
255
+ const targetX = Math.max(minX, Math.min(maxX, this.initialPosX + deltaX));
256
+ const targetY = Math.max(minY, Math.min(maxY, this.initialPosY + deltaY));
257
+
258
+ this.posX.set(targetX);
259
+ this.posY.set(targetY);
260
+ };
261
+
262
+ private stopDrag = (): void => {
263
+ this.isDragging = false;
264
+ document.removeEventListener('mousemove', this.onDrag);
265
+ document.removeEventListener('mouseup', this.stopDrag);
266
+ };
267
+
268
+ @HostListener('window:resize')
269
+ public onResize(): void {
270
+ // Keep window within viewport bounds if window resized
271
+ const maxX = Math.max(10, window.innerWidth - 240);
272
+ const maxY = Math.max(10, window.innerHeight - 80);
273
+ if (this.posX() > maxX) this.posX.set(maxX);
274
+ if (this.posY() > maxY) this.posY.set(maxY);
275
+ }
276
+
277
+ @HostListener('window:keydown', ['$event'])
278
+ public onKeyDown(event: KeyboardEvent): void {
279
+ if (!this.agentService.isVideoWindowOpen()) return;
280
+
281
+ if (event.key === 'Escape') {
282
+ if (this.isTheaterMode()) {
283
+ this.isTheaterMode.set(false);
284
+ } else {
285
+ this.agentService.closeVideoPlayer();
286
+ }
287
+ }
288
+ }
289
+
290
+ /**
291
+ * Video element event handlers
292
+ */
293
+ public onLoadedMetadata(): void {
294
+ const v = this.videoRef?.nativeElement;
295
+ if (v) {
296
+ const segments = this.agentService.activeVideoSegments();
297
+ if (!segments.length) {
298
+ this.duration.set(v.duration || 0);
299
+ }
300
+ this.videoLoadError.set(false);
301
+ v.playbackRate = this.playbackRate();
302
+ v.loop = this.isLooping() && !segments.length;
303
+ v.muted = this.isMuted();
304
+ if (this.pendingAbsoluteSeek !== null) {
305
+ const target = this.pendingAbsoluteSeek;
306
+ this.pendingAbsoluteSeek = null;
307
+ this.seekToSessionTime(target, true);
308
+ // A seek into another finalized segment changes the video source. Let
309
+ // that segment's metadata event apply pendingLocalTime.
310
+ if (this.pendingLocalTime !== null) return;
311
+ }
312
+ if (this.pendingLocalTime !== null) {
313
+ v.currentTime = Math.max(0, Math.min(v.duration || this.pendingLocalTime, this.pendingLocalTime));
314
+ this.pendingLocalTime = null;
315
+ }
316
+ if (this.pendingAutoplay) {
317
+ this.pendingAutoplay = false;
318
+ v.play().catch(() => {});
319
+ }
320
+ if (this.agentService.consumeVideoAutoplay()) {
321
+ this.isMuted.set(true);
322
+ v.muted = true;
323
+ v.play().catch(() => {
324
+ this.isPlaying.set(false);
325
+ });
326
+ }
327
+ }
328
+ }
329
+
330
+ public onTimeUpdate(): void {
331
+ const v = this.videoRef?.nativeElement;
332
+ if (v) {
333
+ const segments = this.agentService.activeVideoSegments();
334
+ const segment = segments[this.activeSegmentIndex()];
335
+ this.currentTime.set((segment?.start || 0) + v.currentTime);
336
+ if (!segments.length && v.duration && v.duration !== this.duration()) {
337
+ this.duration.set(v.duration);
338
+ }
339
+ }
340
+ }
341
+
342
+ public onPlay(): void {
343
+ this.isPlaying.set(true);
344
+ }
345
+
346
+ public onPause(): void {
347
+ this.isPlaying.set(false);
348
+ }
349
+
350
+ public onEnded(): void {
351
+ const segments = this.agentService.activeVideoSegments();
352
+ if (segments.length && this.activeSegmentIndex() < segments.length - 1) {
353
+ this.pendingLocalTime = 0;
354
+ this.pendingAutoplay = true;
355
+ this.activeSegmentIndex.update(index => index + 1);
356
+ return;
357
+ }
358
+ if (segments.length && this.isLooping()) {
359
+ this.seek(0, true);
360
+ return;
361
+ }
362
+ this.isPlaying.set(false);
363
+ }
364
+
365
+ public onError(): void {
366
+ this.videoLoadError.set(true);
367
+ this.isPlaying.set(false);
368
+ }
369
+
370
+ /**
371
+ * Playback actions
372
+ */
373
+ public togglePlay(): void {
374
+ const v = this.videoRef?.nativeElement;
375
+ if (!v) return;
376
+ if (v.paused) {
377
+ v.play().catch(() => {});
378
+ } else {
379
+ v.pause();
380
+ }
381
+ }
382
+
383
+ public restart(): void {
384
+ this.seek(0, true);
385
+ }
386
+
387
+ /**
388
+ * Seek to a session-relative time (seconds since the task session started,
389
+ * the axis step timestamps and analyzer ranges use). Manifest v2 segments
390
+ * carry real session offsets, so the time lands in the right segment even
391
+ * across scrcpy restart gaps; legacy playlists fall back to the timeline axis.
392
+ */
393
+ public seekToSessionTime(sessionSeconds: number, autoplay = false): void {
394
+ const segments = this.agentService.activeVideoSegments();
395
+ this.seek(sessionTimeToTimelineTime(segments, sessionSeconds), autoplay);
396
+ }
397
+
398
+ /** Seek on the back-to-back playlist axis used by the scrubber. */
399
+ public seek(seconds: number, autoplay = false): void {
400
+ const v = this.videoRef?.nativeElement;
401
+ if (!v) return;
402
+ const target = Math.max(0, Math.min(this.duration(), seconds));
403
+ const segments = this.agentService.activeVideoSegments();
404
+ const location = locateTimelineTime(segments, target);
405
+ if (!location) {
406
+ v.currentTime = target;
407
+ if (autoplay) v.play().catch(() => {});
408
+ return;
409
+ }
410
+ const { index, localTime } = location;
411
+ if (index === this.activeSegmentIndex()) {
412
+ v.currentTime = localTime;
413
+ if (autoplay) v.play().catch(() => {});
414
+ } else {
415
+ this.pendingLocalTime = localTime;
416
+ this.pendingAutoplay = autoplay || !v.paused;
417
+ this.activeSegmentIndex.set(index);
418
+ }
419
+ this.currentTime.set(target);
420
+ }
421
+
422
+ public onScrub(event: Event): void {
423
+ const input = event.target as HTMLInputElement;
424
+ const targetTime = parseFloat(input.value);
425
+ this.seek(targetTime);
426
+ }
427
+
428
+ public setSpeed(rate: number): void {
429
+ this.playbackRate.set(rate);
430
+ const v = this.videoRef?.nativeElement;
431
+ if (v) {
432
+ v.playbackRate = rate;
433
+ }
434
+ if (this.isStepPlaying()) {
435
+ this.scheduleNextStepFrame();
436
+ }
437
+ }
438
+
439
+ public toggleLoop(): void {
440
+ const next = !this.isLooping();
441
+ this.isLooping.set(next);
442
+ const v = this.videoRef?.nativeElement;
443
+ if (v) {
444
+ v.loop = next && !this.agentService.activeVideoSegments().length;
445
+ }
446
+ }
447
+
448
+ public toggleMute(): void {
449
+ const next = !this.isMuted();
450
+ this.isMuted.set(next);
451
+ const v = this.videoRef?.nativeElement;
452
+ if (v) {
453
+ v.muted = next;
454
+ }
455
+ }
456
+
457
+ public toggleTheater(): void {
458
+ this.isTheaterMode.set(!this.isTheaterMode());
459
+ }
460
+
461
+ public toggleMinimize(): void {
462
+ this.agentService.isVideoMinimized.set(!this.agentService.isVideoMinimized());
463
+ }
464
+
465
+ public openInNewTab(): void {
466
+ const url = this.agentService.activeVideoUrl();
467
+ if (url) {
468
+ window.open(url, '_blank');
469
+ }
470
+ }
471
+
472
+ /**
473
+ * Step Replay Controls
474
+ */
475
+ public toggleStepPlay(): void {
476
+ if (this.isStepPlaying()) {
477
+ this.pauseStepPlay();
478
+ } else {
479
+ this.startStepPlay();
480
+ }
481
+ }
482
+
483
+ public startStepPlay(): void {
484
+ if (this.totalStepFrames() <= 0) return;
485
+ if (this.activeStepIndex() >= this.totalStepFrames() - 1) {
486
+ this.activeStepIndex.set(0);
487
+ }
488
+ this.isStepPlaying.set(true);
489
+ this.scheduleNextStepFrame();
490
+ }
491
+
492
+ public pauseStepPlay(): void {
493
+ this.isStepPlaying.set(false);
494
+ if (this.stepTimer) {
495
+ clearTimeout(this.stepTimer);
496
+ this.stepTimer = null;
497
+ }
498
+ }
499
+
500
+ private scheduleNextStepFrame(): void {
501
+ if (this.stepTimer) clearTimeout(this.stepTimer);
502
+ const delay = Math.max(300, 1500 / this.playbackRate());
503
+ this.stepTimer = setTimeout(() => {
504
+ if (!this.isStepPlaying()) return;
505
+ if (this.activeStepIndex() < this.totalStepFrames() - 1) {
506
+ this.activeStepIndex.update((i) => i + 1);
507
+ this.scheduleNextStepFrame();
508
+ } else {
509
+ if (this.isLooping()) {
510
+ this.activeStepIndex.set(0);
511
+ this.scheduleNextStepFrame();
512
+ } else {
513
+ this.pauseStepPlay();
514
+ }
515
+ }
516
+ }, delay);
517
+ }
518
+
519
+ public prevStepFrame(): void {
520
+ this.pauseStepPlay();
521
+ this.viewMode.set('pre');
522
+ this.activeStepIndex.update((i) => Math.max(0, i - 1));
523
+ }
524
+
525
+ public nextStepFrame(): void {
526
+ this.pauseStepPlay();
527
+ this.viewMode.set('pre');
528
+ this.activeStepIndex.update((i) => Math.min(this.totalStepFrames() - 1, i + 1));
529
+ }
530
+
531
+ public seekStepFrame(index: number): void {
532
+ this.viewMode.set('pre');
533
+ this.activeStepIndex.set(Math.max(0, Math.min(this.totalStepFrames() - 1, index)));
534
+ }
535
+
536
+ public onStepScrub(event: Event): void {
537
+ const input = event.target as HTMLInputElement;
538
+ this.seekStepFrame(parseInt(input.value, 10));
539
+ }
540
+
541
+ public restartStep(): void {
542
+ this.seekStepFrame(0);
543
+ this.startStepPlay();
544
+ }
545
+
546
+ public setStepViewMode(mode: 'pre' | 'post', event?: Event): void {
547
+ if (event) event.stopPropagation();
548
+ this.viewMode.set(mode);
549
+ setTimeout(() => this.drawStepOverlay(), 40);
550
+ }
551
+
552
+ public toggleStepViewMode(event?: Event): void {
553
+ if (event) event.stopPropagation();
554
+ this.setStepViewMode(this.viewMode() === 'pre' ? 'post' : 'pre');
555
+ }
556
+
557
+ public onViewportMouseEnter(): void {
558
+ this.isCardHovered.set(true);
559
+ }
560
+
561
+ public onViewportMouseLeave(): void {
562
+ this.isCardHovered.set(false);
563
+ }
564
+
565
+ public toggleCardPin(event?: Event): void {
566
+ if (event) event.stopPropagation();
567
+ this.isCardPinned.update((v) => !v);
568
+ }
569
+
570
+ public cycleSpeed(): void {
571
+ const current = this.playbackRate();
572
+ const idx = this.speedOptions.indexOf(current);
573
+ const nextIdx = (idx + 1) % this.speedOptions.length;
574
+ this.setSpeed(this.speedOptions[nextIdx]);
575
+ }
576
+
577
+ public onStepImageLoad(): void {
578
+ this.isStepImageLoading.set(false);
579
+ this.stepImageError.set(false);
580
+ this.drawStepOverlay();
581
+ }
582
+
583
+ public onStepImageError(): void {
584
+ this.isStepImageLoading.set(false);
585
+ this.stepImageError.set(true);
586
+ }
587
+
588
+ public drawStepOverlay(): void {
589
+ const img = this.stepImgRef?.nativeElement;
590
+ const overlay = this.stepOverlayRef?.nativeElement;
591
+ if (!img || !overlay) return;
592
+ overlay.innerHTML = '';
593
+
594
+ // Only draw coordinate overlays when viewing the pre-action screenshot
595
+ if (this.viewMode() === 'post') {
596
+ return;
597
+ }
598
+
599
+ const frame = this.currentStepFrame();
600
+ if (!frame || !frame.action) return;
601
+
602
+ try {
603
+ drawActionCoordinatesOnOverlay(img, overlay, frame.action);
604
+ } catch (err) {
605
+ console.warn('Failed to draw step coordinates overlay:', err);
606
+ }
607
+ }
608
+
609
+ public getStepActionIcon(action: any): string {
610
+ return getActionIcon(action);
611
+ }
612
+
613
+ public openImageInNewTab(): void {
614
+ const url = this.currentStepImageUrl() || this.currentStepFrame()?.imageUrl;
615
+ if (url) {
616
+ window.open(url, '_blank');
617
+ }
618
+ }
619
+
620
+ public trackStepFrame(index: number, frame: StepReplayFrame): string {
621
+ return frame.stepId || String(index);
622
+ }
623
+
624
+ public ngOnDestroy(): void {
625
+ if (this.stepTimer) {
626
+ clearTimeout(this.stepTimer);
627
+ this.stepTimer = null;
628
+ }
629
+ document.removeEventListener('mousemove', this.onDrag);
630
+ document.removeEventListener('mouseup', this.stopDrag);
631
+ }
632
+ }