neoagent 2.3.1-beta.0 → 2.3.1-beta.100

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 (406) hide show
  1. package/.env.example +63 -5
  2. package/README.md +16 -5
  3. package/com.neoagent.plist +1 -1
  4. package/docs/automation.md +82 -41
  5. package/docs/capabilities.md +85 -89
  6. package/docs/configuration.md +89 -87
  7. package/docs/getting-started.md +46 -27
  8. package/docs/hardware.md +1 -1
  9. package/docs/index.md +24 -30
  10. package/docs/integrations.md +46 -60
  11. package/docs/migration.md +41 -146
  12. package/docs/operations.md +23 -20
  13. package/docs/skills.md +20 -20
  14. package/docs/why-neoagent.md +15 -13
  15. package/extensions/chrome-browser/background.mjs +10 -2
  16. package/flutter_app/.metadata +42 -0
  17. package/flutter_app/DESIGN_SYSTEM.md +166 -0
  18. package/flutter_app/README.md +21 -0
  19. package/flutter_app/analysis_options.yaml +32 -0
  20. package/flutter_app/android/app/build.gradle.kts +111 -0
  21. package/flutter_app/android/app/src/debug/AndroidManifest.xml +7 -0
  22. package/flutter_app/android/app/src/main/AndroidManifest.xml +185 -0
  23. package/flutter_app/android/app/src/main/kotlin/com/neoagent/flutter_app/MainActivity.kt +888 -0
  24. package/flutter_app/android/app/src/main/kotlin/com/neoagent/flutter_app/auto/NeoAgentCarAppService.kt +114 -0
  25. package/flutter_app/android/app/src/main/kotlin/com/neoagent/flutter_app/health/HealthConnectGateway.kt +280 -0
  26. package/flutter_app/android/app/src/main/kotlin/com/neoagent/flutter_app/health/HealthSyncNotifications.kt +113 -0
  27. package/flutter_app/android/app/src/main/kotlin/com/neoagent/flutter_app/health/HealthSyncPayload.kt +57 -0
  28. package/flutter_app/android/app/src/main/kotlin/com/neoagent/flutter_app/health/HealthSyncScheduler.kt +78 -0
  29. package/flutter_app/android/app/src/main/kotlin/com/neoagent/flutter_app/health/HealthSyncWorker.kt +253 -0
  30. package/flutter_app/android/app/src/main/kotlin/com/neoagent/flutter_app/health/PermissionsRationaleActivity.kt +46 -0
  31. package/flutter_app/android/app/src/main/kotlin/com/neoagent/flutter_app/recording/RecordingBootReceiver.kt +21 -0
  32. package/flutter_app/android/app/src/main/kotlin/com/neoagent/flutter_app/recording/RecordingForegroundService.kt +586 -0
  33. package/flutter_app/android/app/src/main/kotlin/com/neoagent/flutter_app/recording/RecordingStateStore.kt +78 -0
  34. package/flutter_app/android/app/src/main/kotlin/com/neoagent/flutter_app/recording/RecordingUploadClient.kt +104 -0
  35. package/flutter_app/android/app/src/main/kotlin/com/neoagent/flutter_app/telecom/NeoAgentConnection.kt +118 -0
  36. package/flutter_app/android/app/src/main/kotlin/com/neoagent/flutter_app/telecom/NeoAgentConnectionService.kt +86 -0
  37. package/flutter_app/android/app/src/main/kotlin/com/neoagent/flutter_app/widgets/AiHomeWidgetProvider.kt +457 -0
  38. package/flutter_app/android/app/src/main/kotlin/com/neoagent/flutter_app/widgets/AiWidgetStore.kt +194 -0
  39. package/flutter_app/android/app/src/main/kotlin/com/neoagent/flutter_app/widgets/VoiceLaunchWidgetProvider.kt +67 -0
  40. package/flutter_app/android/app/src/main/kotlin/com/neoagent/flutter_app/widgets/WidgetConfigActivity.kt +228 -0
  41. package/flutter_app/android/app/src/main/kotlin/com/neoagent/flutter_app/widgets/WidgetSyncScheduler.kt +72 -0
  42. package/flutter_app/android/app/src/main/kotlin/com/neoagent/flutter_app/widgets/WidgetSyncWorker.kt +186 -0
  43. package/flutter_app/android/app/src/main/kotlin/com/neoagent/flutter_app/widgets/WidgetTaskRunWorker.kt +210 -0
  44. package/flutter_app/android/app/src/main/res/drawable/launch_background.xml +12 -0
  45. package/flutter_app/android/app/src/main/res/drawable/neoagent_ai_widget_bg.xml +11 -0
  46. package/flutter_app/android/app/src/main/res/drawable/neoagent_ai_widget_task_bg.xml +8 -0
  47. package/flutter_app/android/app/src/main/res/drawable-v21/launch_background.xml +12 -0
  48. package/flutter_app/android/app/src/main/res/layout/neoagent_ai_widget.xml +138 -0
  49. package/flutter_app/android/app/src/main/res/layout/neoagent_ai_widget_task_row.xml +52 -0
  50. package/flutter_app/android/app/src/main/res/layout/neoagent_voice_widget.xml +49 -0
  51. package/flutter_app/android/app/src/main/res/mipmap-hdpi/ic_launcher.png +0 -0
  52. package/flutter_app/android/app/src/main/res/mipmap-mdpi/ic_launcher.png +0 -0
  53. package/flutter_app/android/app/src/main/res/mipmap-xhdpi/ic_launcher.png +0 -0
  54. package/flutter_app/android/app/src/main/res/mipmap-xxhdpi/ic_launcher.png +0 -0
  55. package/flutter_app/android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png +0 -0
  56. package/flutter_app/android/app/src/main/res/values/arrays.xml +8 -0
  57. package/flutter_app/android/app/src/main/res/values/strings.xml +12 -0
  58. package/flutter_app/android/app/src/main/res/values/styles.xml +18 -0
  59. package/flutter_app/android/app/src/main/res/values-night/styles.xml +18 -0
  60. package/flutter_app/android/app/src/main/res/xml/automotive_app_desc.xml +4 -0
  61. package/flutter_app/android/app/src/main/res/xml/file_paths.xml +6 -0
  62. package/flutter_app/android/app/src/main/res/xml/neoagent_ai_widget_info.xml +12 -0
  63. package/flutter_app/android/app/src/main/res/xml/neoagent_voice_widget_info.xml +12 -0
  64. package/flutter_app/android/app/src/profile/AndroidManifest.xml +7 -0
  65. package/flutter_app/android/build.gradle.kts +24 -0
  66. package/flutter_app/android/ci-release.keystore +0 -0
  67. package/flutter_app/android/gradle/wrapper/gradle-wrapper.properties +5 -0
  68. package/flutter_app/android/gradle.properties +3 -0
  69. package/flutter_app/android/key.properties +4 -0
  70. package/flutter_app/android/settings.gradle.kts +26 -0
  71. package/flutter_app/assets/branding/app_icon_1024.png +0 -0
  72. package/flutter_app/assets/branding/app_icon_128.png +0 -0
  73. package/flutter_app/assets/branding/app_icon_192.png +0 -0
  74. package/flutter_app/assets/branding/app_icon_256.png +0 -0
  75. package/flutter_app/assets/branding/app_icon_32.png +0 -0
  76. package/flutter_app/assets/branding/app_icon_512.png +0 -0
  77. package/flutter_app/assets/branding/app_icon_64.png +0 -0
  78. package/flutter_app/assets/branding/onboarding_intro.mp4 +0 -0
  79. package/flutter_app/assets/branding/tray_icon_template.png +0 -0
  80. package/flutter_app/lib/features/location/location_service.dart +117 -0
  81. package/flutter_app/lib/features/notifications/notification_interceptor.dart +73 -0
  82. package/flutter_app/lib/features/onboarding/onboarding_chrome.dart +571 -0
  83. package/flutter_app/lib/features/onboarding/onboarding_messaging_step.dart +275 -0
  84. package/flutter_app/lib/features/onboarding/onboarding_model_step.dart +366 -0
  85. package/flutter_app/lib/features/onboarding/onboarding_shell.dart +57 -0
  86. package/flutter_app/lib/features/onboarding/onboarding_video_step.dart +218 -0
  87. package/flutter_app/lib/features/onboarding/onboarding_welcome_step.dart +46 -0
  88. package/flutter_app/lib/main.dart +107 -0
  89. package/flutter_app/lib/main_account_settings.dart +1340 -0
  90. package/flutter_app/lib/main_admin.dart +900 -0
  91. package/flutter_app/lib/main_app_shell.dart +2162 -0
  92. package/flutter_app/lib/main_chat.dart +3902 -0
  93. package/flutter_app/lib/main_controller.dart +7229 -0
  94. package/flutter_app/lib/main_devices.dart +1738 -0
  95. package/flutter_app/lib/main_integrations.dart +917 -0
  96. package/flutter_app/lib/main_launcher.dart +959 -0
  97. package/flutter_app/lib/main_launcher_entry.dart +5 -0
  98. package/flutter_app/lib/main_models.dart +3807 -0
  99. package/flutter_app/lib/main_navigation.dart +206 -0
  100. package/flutter_app/lib/main_operations.dart +5249 -0
  101. package/flutter_app/lib/main_recordings.dart +920 -0
  102. package/flutter_app/lib/main_runtime.dart +869 -0
  103. package/flutter_app/lib/main_settings.dart +2288 -0
  104. package/flutter_app/lib/main_shared.dart +3393 -0
  105. package/flutter_app/lib/main_spacing.dart +33 -0
  106. package/flutter_app/lib/main_theme.dart +276 -0
  107. package/flutter_app/lib/main_unified.dart +388 -0
  108. package/flutter_app/lib/main_voice_assistant.dart +957 -0
  109. package/flutter_app/lib/src/analytics_service.dart +294 -0
  110. package/flutter_app/lib/src/android_apk_drop_zone.dart +32 -0
  111. package/flutter_app/lib/src/android_apk_drop_zone_stub.dart +16 -0
  112. package/flutter_app/lib/src/android_apk_drop_zone_web.dart +348 -0
  113. package/flutter_app/lib/src/android_app_installer.dart +22 -0
  114. package/flutter_app/lib/src/android_app_installer_io.dart +122 -0
  115. package/flutter_app/lib/src/android_app_installer_stub.dart +21 -0
  116. package/flutter_app/lib/src/android_auto_bridge.dart +59 -0
  117. package/flutter_app/lib/src/android_launcher_bridge.dart +239 -0
  118. package/flutter_app/lib/src/app_launch_bridge.dart +58 -0
  119. package/flutter_app/lib/src/app_release_updater.dart +511 -0
  120. package/flutter_app/lib/src/backend_client.dart +1870 -0
  121. package/flutter_app/lib/src/desktop_companion.dart +2 -0
  122. package/flutter_app/lib/src/desktop_companion_actions.dart +586 -0
  123. package/flutter_app/lib/src/desktop_companion_io.dart +538 -0
  124. package/flutter_app/lib/src/desktop_companion_stub.dart +59 -0
  125. package/flutter_app/lib/src/desktop_native_bridge.dart +91 -0
  126. package/flutter_app/lib/src/desktop_screen_capture.dart +21 -0
  127. package/flutter_app/lib/src/desktop_screen_capture_io.dart +142 -0
  128. package/flutter_app/lib/src/desktop_screen_capture_stub.dart +12 -0
  129. package/flutter_app/lib/src/diagnostics_logger.dart +119 -0
  130. package/flutter_app/lib/src/health_bridge.dart +136 -0
  131. package/flutter_app/lib/src/live_voice_capture.dart +85 -0
  132. package/flutter_app/lib/src/messaging_access_summary.dart +46 -0
  133. package/flutter_app/lib/src/network/app_http_client.dart +53 -0
  134. package/flutter_app/lib/src/network/app_http_client_factory.dart +6 -0
  135. package/flutter_app/lib/src/network/app_http_client_io.dart +138 -0
  136. package/flutter_app/lib/src/network/app_http_client_stub.dart +3 -0
  137. package/flutter_app/lib/src/network/app_http_client_web.dart +94 -0
  138. package/flutter_app/lib/src/oauth_launcher.dart +33 -0
  139. package/flutter_app/lib/src/oauth_launcher_io.dart +95 -0
  140. package/flutter_app/lib/src/oauth_launcher_stub.dart +33 -0
  141. package/flutter_app/lib/src/oauth_launcher_web.dart +107 -0
  142. package/flutter_app/lib/src/recording_bridge.dart +232 -0
  143. package/flutter_app/lib/src/recording_bridge_io.dart +1019 -0
  144. package/flutter_app/lib/src/recording_bridge_stub.dart +120 -0
  145. package/flutter_app/lib/src/recording_bridge_web.dart +689 -0
  146. package/flutter_app/lib/src/recording_payloads.dart +86 -0
  147. package/flutter_app/lib/src/theme/palette.dart +81 -0
  148. package/flutter_app/lib/src/web_app_update_monitor.dart +17 -0
  149. package/flutter_app/lib/src/web_app_update_monitor_stub.dart +24 -0
  150. package/flutter_app/lib/src/web_app_update_monitor_web.dart +123 -0
  151. package/flutter_app/lib/src/widget_bridge.dart +49 -0
  152. package/flutter_app/linux/CMakeLists.txt +128 -0
  153. package/flutter_app/linux/flutter/CMakeLists.txt +88 -0
  154. package/flutter_app/linux/flutter/generated_plugin_registrant.cc +47 -0
  155. package/flutter_app/linux/flutter/generated_plugin_registrant.h +15 -0
  156. package/flutter_app/linux/flutter/generated_plugins.cmake +32 -0
  157. package/flutter_app/linux/runner/CMakeLists.txt +26 -0
  158. package/flutter_app/linux/runner/main.cc +6 -0
  159. package/flutter_app/linux/runner/my_application.cc +144 -0
  160. package/flutter_app/linux/runner/my_application.h +18 -0
  161. package/flutter_app/linux/runner/resources/app_icon.png +0 -0
  162. package/flutter_app/macos/Flutter/Flutter-Debug.xcconfig +2 -0
  163. package/flutter_app/macos/Flutter/Flutter-Release.xcconfig +2 -0
  164. package/flutter_app/macos/Flutter/GeneratedPluginRegistrant.swift +48 -0
  165. package/flutter_app/macos/Podfile +42 -0
  166. package/flutter_app/macos/Podfile.lock +87 -0
  167. package/flutter_app/macos/Runner/AppDelegate.swift +576 -0
  168. package/flutter_app/macos/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json +68 -0
  169. package/flutter_app/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_1024.png +0 -0
  170. package/flutter_app/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_128.png +0 -0
  171. package/flutter_app/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_16.png +0 -0
  172. package/flutter_app/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_256.png +0 -0
  173. package/flutter_app/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_32.png +0 -0
  174. package/flutter_app/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_512.png +0 -0
  175. package/flutter_app/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_64.png +0 -0
  176. package/flutter_app/macos/Runner/Base.lproj/MainMenu.xib +342 -0
  177. package/flutter_app/macos/Runner/Configs/AppInfo.xcconfig +14 -0
  178. package/flutter_app/macos/Runner/Configs/Debug.xcconfig +2 -0
  179. package/flutter_app/macos/Runner/Configs/Release.xcconfig +2 -0
  180. package/flutter_app/macos/Runner/Configs/Warnings.xcconfig +13 -0
  181. package/flutter_app/macos/Runner/DebugProfile.entitlements +16 -0
  182. package/flutter_app/macos/Runner/Info.plist +36 -0
  183. package/flutter_app/macos/Runner/MainFlutterWindow.swift +19 -0
  184. package/flutter_app/macos/Runner/Release.entitlements +12 -0
  185. package/flutter_app/macos/Runner.xcodeproj/project.pbxproj +801 -0
  186. package/flutter_app/macos/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist +8 -0
  187. package/flutter_app/macos/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme +99 -0
  188. package/flutter_app/macos/Runner.xcworkspace/contents.xcworkspacedata +10 -0
  189. package/flutter_app/macos/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist +8 -0
  190. package/flutter_app/macos/RunnerTests/RunnerTests.swift +12 -0
  191. package/flutter_app/patch_strings.py +12 -0
  192. package/flutter_app/pubspec.lock +1256 -0
  193. package/flutter_app/pubspec.yaml +59 -0
  194. package/flutter_app/third_party/desktop_audio_capture/LICENSE +21 -0
  195. package/flutter_app/third_party/desktop_audio_capture/README.md +262 -0
  196. package/flutter_app/third_party/desktop_audio_capture/lib/audio_capture.dart +65 -0
  197. package/flutter_app/third_party/desktop_audio_capture/lib/config/mic_audio_config.dart +153 -0
  198. package/flutter_app/third_party/desktop_audio_capture/lib/config/system_adudio_config.dart +110 -0
  199. package/flutter_app/third_party/desktop_audio_capture/lib/mic/mic_audio_capture.dart +461 -0
  200. package/flutter_app/third_party/desktop_audio_capture/lib/model/audio_status.dart +91 -0
  201. package/flutter_app/third_party/desktop_audio_capture/lib/model/decibel_data.dart +106 -0
  202. package/flutter_app/third_party/desktop_audio_capture/lib/model/input_device_type.dart +219 -0
  203. package/flutter_app/third_party/desktop_audio_capture/lib/system/system_audio_capture.dart +336 -0
  204. package/flutter_app/third_party/desktop_audio_capture/linux/CMakeLists.txt +101 -0
  205. package/flutter_app/third_party/desktop_audio_capture/linux/audio_capture_plugin.cc +692 -0
  206. package/flutter_app/third_party/desktop_audio_capture/linux/include/audio_capture/audio_capture_plugin.h +35 -0
  207. package/flutter_app/third_party/desktop_audio_capture/linux/include/audio_capture/mic_capture_plugin.h +36 -0
  208. package/flutter_app/third_party/desktop_audio_capture/linux/include/desktop_audio_capture/audio_capture_plugin.h +32 -0
  209. package/flutter_app/third_party/desktop_audio_capture/linux/include/desktop_audio_capture/mic_capture_plugin.h +32 -0
  210. package/flutter_app/third_party/desktop_audio_capture/linux/mic_capture_plugin.cc +878 -0
  211. package/flutter_app/third_party/desktop_audio_capture/macos/Classes/AudioCapturePlugin.swift +27 -0
  212. package/flutter_app/third_party/desktop_audio_capture/macos/Classes/MicCapturePlugin.swift +1172 -0
  213. package/flutter_app/third_party/desktop_audio_capture/macos/Classes/SystemCapturePlugin.swift +655 -0
  214. package/flutter_app/third_party/desktop_audio_capture/macos/Resources/PrivacyInfo.xcprivacy +12 -0
  215. package/flutter_app/third_party/desktop_audio_capture/macos/desktop_audio_capture.podspec +30 -0
  216. package/flutter_app/third_party/desktop_audio_capture/pubspec.yaml +87 -0
  217. package/flutter_app/third_party/desktop_audio_capture/windows/CMakeLists.txt +105 -0
  218. package/flutter_app/third_party/desktop_audio_capture/windows/audio_capture_plugin.cpp +80 -0
  219. package/flutter_app/third_party/desktop_audio_capture/windows/audio_capture_plugin.h +31 -0
  220. package/flutter_app/third_party/desktop_audio_capture/windows/audio_capture_plugin_c_api.cpp +12 -0
  221. package/flutter_app/third_party/desktop_audio_capture/windows/include/audio_capture/audio_capture_plugin_c_api.h +23 -0
  222. package/flutter_app/third_party/desktop_audio_capture/windows/include/desktop_audio_capture/audio_capture_plugin.h +25 -0
  223. package/flutter_app/third_party/desktop_audio_capture/windows/mic_capture_plugin.cpp +1117 -0
  224. package/flutter_app/third_party/desktop_audio_capture/windows/mic_capture_plugin.h +115 -0
  225. package/flutter_app/third_party/desktop_audio_capture/windows/system_audio_capture_plugin.cpp +777 -0
  226. package/flutter_app/third_party/desktop_audio_capture/windows/system_audio_capture_plugin.h +87 -0
  227. package/flutter_app/third_party/flutter_secure_storage_linux/linux/CMakeLists.txt +30 -0
  228. package/flutter_app/third_party/flutter_secure_storage_linux/linux/flutter_secure_storage_linux_plugin.cc +215 -0
  229. package/flutter_app/third_party/flutter_secure_storage_linux/linux/include/flutter_secure_storage_linux/flutter_secure_storage_linux_plugin.h +27 -0
  230. package/flutter_app/third_party/flutter_secure_storage_linux/pubspec.yaml +20 -0
  231. package/flutter_app/tool/generate_desktop_branding.py +219 -0
  232. package/flutter_app/web/favicon.png +0 -0
  233. package/flutter_app/web/favicon.svg +12 -0
  234. package/flutter_app/web/icons/Icon-192.png +0 -0
  235. package/flutter_app/web/icons/Icon-512.png +0 -0
  236. package/flutter_app/web/icons/Icon-maskable-192.png +0 -0
  237. package/flutter_app/web/icons/Icon-maskable-512.png +0 -0
  238. package/flutter_app/web/index.html +39 -0
  239. package/flutter_app/web/manifest.json +35 -0
  240. package/flutter_app/windows/CMakeLists.txt +108 -0
  241. package/flutter_app/windows/flutter/CMakeLists.txt +109 -0
  242. package/flutter_app/windows/flutter/generated_plugin_registrant.cc +50 -0
  243. package/flutter_app/windows/flutter/generated_plugin_registrant.h +15 -0
  244. package/flutter_app/windows/flutter/generated_plugins.cmake +36 -0
  245. package/flutter_app/windows/runner/CMakeLists.txt +41 -0
  246. package/flutter_app/windows/runner/Runner.rc +121 -0
  247. package/flutter_app/windows/runner/flutter_window.cpp +533 -0
  248. package/flutter_app/windows/runner/flutter_window.h +37 -0
  249. package/flutter_app/windows/runner/main.cpp +53 -0
  250. package/flutter_app/windows/runner/resource.h +16 -0
  251. package/flutter_app/windows/runner/resources/app_icon.ico +0 -0
  252. package/flutter_app/windows/runner/runner.exe.manifest +14 -0
  253. package/flutter_app/windows/runner/utils.cpp +65 -0
  254. package/flutter_app/windows/runner/utils.h +19 -0
  255. package/flutter_app/windows/runner/win32_window.cpp +299 -0
  256. package/flutter_app/windows/runner/win32_window.h +102 -0
  257. package/lib/install_helpers.js +31 -0
  258. package/lib/manager.js +465 -43
  259. package/package.json +11 -3
  260. package/runtime/paths.js +137 -0
  261. package/server/config/analytics.js +30 -0
  262. package/server/db/database.js +363 -21
  263. package/server/guest-agent.android.package.json +13 -0
  264. package/server/guest-agent.browser.package.json +14 -0
  265. package/server/guest_agent.js +98 -52
  266. package/server/http/middleware.js +55 -2
  267. package/server/http/routes.js +6 -1
  268. package/server/http/static.js +41 -1
  269. package/server/index.js +16 -16
  270. package/server/public/.last_build_id +1 -1
  271. package/server/public/assets/AssetManifest.bin +1 -1
  272. package/server/public/assets/AssetManifest.bin.json +1 -1
  273. package/server/public/assets/AssetManifest.json +1 -1
  274. package/server/public/assets/NOTICES +679 -129
  275. package/server/public/assets/assets/branding/onboarding_intro.mp4 +0 -0
  276. package/server/public/assets/fonts/MaterialIcons-Regular.otf +0 -0
  277. package/server/public/assets/packages/mixpanel_flutter/assets/mixpanel.js +3 -0
  278. package/server/public/canvaskit/wimp.wasm +0 -0
  279. package/server/public/flutter_bootstrap.js +2 -2
  280. package/server/public/main.dart.js +95866 -87333
  281. package/server/routes/account.js +26 -1
  282. package/server/routes/agents.js +6 -2
  283. package/server/routes/android.js +22 -6
  284. package/server/routes/auth.js +25 -5
  285. package/server/routes/browser.js +47 -13
  286. package/server/routes/integrations.js +119 -9
  287. package/server/routes/memory.js +179 -8
  288. package/server/routes/runtime.js +14 -0
  289. package/server/routes/screenHistory.js +46 -0
  290. package/server/routes/settings.js +102 -24
  291. package/server/routes/skills.js +12 -0
  292. package/server/routes/social_video.js +66 -0
  293. package/server/routes/tasks.js +22 -2
  294. package/server/routes/triggers.js +90 -0
  295. package/server/routes/wearable.js +67 -0
  296. package/server/routes/widgets.js +4 -4
  297. package/server/services/ai/capabilityHealth.js +23 -51
  298. package/server/services/ai/compaction.js +1 -1
  299. package/server/services/ai/deliverables/artifact_helpers.js +190 -0
  300. package/server/services/ai/deliverables/contracts.js +113 -0
  301. package/server/services/ai/deliverables/index.js +20 -0
  302. package/server/services/ai/deliverables/selector.js +94 -0
  303. package/server/services/ai/deliverables/validator.js +63 -0
  304. package/server/services/ai/deliverables/workflows.js +207 -0
  305. package/server/services/ai/engine.js +372 -27
  306. package/server/services/ai/hooks.js +127 -0
  307. package/server/services/ai/integrated_tools/index.js +98 -0
  308. package/server/services/ai/integrated_tools/remotion.js +373 -0
  309. package/server/services/ai/integrated_tools/shared.js +204 -0
  310. package/server/services/ai/integrated_tools/slidev.js +207 -0
  311. package/server/services/ai/loopPolicy.js +146 -0
  312. package/server/services/ai/models.js +36 -0
  313. package/server/services/ai/providers/githubCopilot.js +97 -0
  314. package/server/services/ai/providers/openai.js +2 -1
  315. package/server/services/ai/providers/openaiCodex.js +384 -0
  316. package/server/services/ai/recordingInsights.js +11 -13
  317. package/server/services/ai/runEvents.js +100 -0
  318. package/server/services/ai/settings.js +20 -0
  319. package/server/services/ai/systemPrompt.js +16 -2
  320. package/server/services/ai/taskAnalysis.js +2 -0
  321. package/server/services/ai/toolResult.js +20 -0
  322. package/server/services/ai/toolRunner.js +46 -6
  323. package/server/services/ai/toolSelector.js +54 -1
  324. package/server/services/ai/tools.js +360 -127
  325. package/server/services/android/android_bootstrap_worker.js +63 -0
  326. package/server/services/android/controller.js +442 -1760
  327. package/server/services/bootstrap_helpers.js +0 -34
  328. package/server/services/browser/controller.js +326 -52
  329. package/server/services/cli/executor.js +40 -1
  330. package/server/services/desktop/screenRecorder.js +182 -0
  331. package/server/services/integrations/env.js +10 -0
  332. package/server/services/integrations/figma/provider.js +1 -0
  333. package/server/services/integrations/github/common.js +106 -0
  334. package/server/services/integrations/github/provider.js +499 -0
  335. package/server/services/integrations/github/repos.js +1124 -0
  336. package/server/services/integrations/google/provider.js +1 -0
  337. package/server/services/integrations/manager.js +88 -12
  338. package/server/services/integrations/microsoft/provider.js +1 -0
  339. package/server/services/integrations/oauth_provider.js +25 -8
  340. package/server/services/integrations/provider_config_store.js +85 -0
  341. package/server/services/integrations/registry.js +8 -2
  342. package/server/services/integrations/spotify/provider.js +488 -0
  343. package/server/services/integrations/trello/provider.js +842 -0
  344. package/server/services/integrations/weather/provider.js +559 -0
  345. package/server/services/integrations/whatsapp/provider.js +6 -2
  346. package/server/services/manager.js +109 -154
  347. package/server/services/mcp/client.js +120 -23
  348. package/server/services/memory/llm_transfer.js +218 -0
  349. package/server/services/memory/manager.js +299 -35
  350. package/server/services/messaging/access_policy.js +10 -0
  351. package/server/services/messaging/automation.js +1 -1
  352. package/server/services/messaging/manager.js +93 -8
  353. package/server/services/messaging/meshtastic.js +277 -0
  354. package/server/services/messaging/meshtastic_env.js +40 -0
  355. package/server/services/messaging/meshtastic_protocol.js +530 -0
  356. package/server/services/messaging/meshtastic_tcp_transport.js +25 -0
  357. package/server/services/runtime/backends/local-vm.js +221 -158
  358. package/server/services/runtime/docker-vm-manager.js +392 -0
  359. package/server/services/runtime/guest_bootstrap.js +654 -0
  360. package/server/services/runtime/manager.js +85 -29
  361. package/server/services/runtime/settings.js +22 -31
  362. package/server/services/runtime/validation.js +16 -31
  363. package/server/services/skills/base_catalog.js +33 -0
  364. package/server/services/social_video/adapters/base.js +26 -0
  365. package/server/services/social_video/adapters/index.js +27 -0
  366. package/server/services/social_video/adapters/instagram.js +17 -0
  367. package/server/services/social_video/adapters/tiktok.js +17 -0
  368. package/server/services/social_video/adapters/x.js +17 -0
  369. package/server/services/social_video/adapters/youtube.js +17 -0
  370. package/server/services/social_video/captions.js +187 -0
  371. package/server/services/social_video/frame.js +42 -0
  372. package/server/services/social_video/index.js +7 -0
  373. package/server/services/social_video/metadata.js +63 -0
  374. package/server/services/social_video/result.js +63 -0
  375. package/server/services/social_video/service.js +720 -0
  376. package/server/services/social_video/url.js +83 -0
  377. package/server/services/tasks/adapters/index.js +2 -0
  378. package/server/services/tasks/adapters/manual.js +12 -0
  379. package/server/services/tasks/adapters/schedule.js +33 -5
  380. package/server/services/tasks/adapters/weather_event.js +84 -0
  381. package/server/services/tasks/integration_runtime.js +86 -1
  382. package/server/services/tasks/runtime.js +3 -3
  383. package/server/services/tasks/task_repository.js +3 -6
  384. package/server/services/voice/agentBridge.js +20 -4
  385. package/server/services/voice/message.js +3 -0
  386. package/server/services/voice/openaiClient.js +4 -1
  387. package/server/services/voice/openaiSpeech.js +6 -1
  388. package/server/services/voice/providers.js +144 -15
  389. package/server/services/voice/runtime.js +8 -8
  390. package/server/services/voice/runtimeManager.js +292 -20
  391. package/server/services/voice/turnRunner.js +29 -9
  392. package/server/services/wearable/firmware_manifest.js +353 -0
  393. package/server/services/wearable/gateway.js +350 -0
  394. package/server/services/wearable/protocol.js +45 -0
  395. package/server/services/wearable/service.js +240 -0
  396. package/server/services/websocket.js +3 -1
  397. package/server/services/widgets/focus_widget.js +137 -0
  398. package/server/services/widgets/service.js +182 -6
  399. package/server/services/workspace/manager.js +301 -0
  400. package/server/utils/deployment.js +16 -9
  401. package/server/utils/local_secrets.js +56 -0
  402. package/server/utils/logger.js +37 -9
  403. package/server/services/integrations/home_assistant/provider.js +0 -350
  404. package/server/services/messaging/access_policy.test.js +0 -228
  405. package/server/services/runtime/backends/host.js +0 -37
  406. package/server/services/runtime/qemu.js +0 -391
@@ -1,228 +0,0 @@
1
- const test = require('node:test');
2
- const assert = require('node:assert/strict');
3
-
4
- const {
5
- createDefaultAccessPolicy,
6
- migrateLegacyWhitelist,
7
- normalizeAccessPolicy,
8
- parseStoredAccessPolicy,
9
- evaluateAccessPolicy,
10
- } = require('./access_policy');
11
- const { BasePlatform } = require('./base');
12
-
13
- test('discord defaults require allowlists and shared mentions', () => {
14
- const policy = createDefaultAccessPolicy('discord');
15
- assert.equal(policy.directPolicy, 'allowlist');
16
- assert.equal(policy.sharedPolicy, 'allowlist');
17
- assert.equal(policy.requireMentionInShared, true);
18
- });
19
-
20
- test('discord legacy whitelist migrates into canonical buckets', () => {
21
- const policy = migrateLegacyWhitelist('discord', [
22
- 'user:123',
23
- 'guild:456',
24
- 'channel:789',
25
- 'role:999',
26
- ]);
27
-
28
- assert.deepEqual(
29
- policy.directRules.map((rule) => `${rule.scope}:${rule.value}`),
30
- ['user:123'],
31
- );
32
- assert.deepEqual(
33
- policy.sharedSpaceRules.map((rule) => `${rule.scope}:${rule.value}`),
34
- ['server:456', 'channel:789'],
35
- );
36
- assert.deepEqual(
37
- policy.sharedActorRules.map((rule) => `${rule.scope}:${rule.value}`),
38
- ['user:123', 'role:999'],
39
- );
40
- });
41
-
42
- test('telegram legacy raw ids split users and groups', () => {
43
- const policy = migrateLegacyWhitelist('telegram', ['123', '-100555']);
44
- assert.deepEqual(
45
- policy.directRules.map((rule) => `${rule.scope}:${rule.value}`),
46
- ['user:123'],
47
- );
48
- assert.deepEqual(
49
- policy.sharedSpaceRules.map((rule) => `${rule.scope}:${rule.value}`),
50
- ['group:-100555'],
51
- );
52
- assert.deepEqual(
53
- policy.sharedActorRules.map((rule) => `${rule.scope}:${rule.value}`),
54
- ['user:123'],
55
- );
56
- });
57
-
58
- test('telnyx legacy numbers become direct phone rules', () => {
59
- const policy = migrateLegacyWhitelist('telnyx', ['+1 (555) 1200']);
60
- assert.equal(policy.sharedPolicy, 'disabled');
61
- assert.deepEqual(policy.directRules, [
62
- { scope: 'phone_number', value: '+15551200' },
63
- ]);
64
- });
65
-
66
- test('shared access requires both space allowlist and mention when configured', () => {
67
- const policy = normalizeAccessPolicy('discord', {
68
- sharedPolicy: 'allowlist',
69
- requireMentionInShared: true,
70
- sharedSpaceRules: [{ scope: 'server', value: 'guild-1' }],
71
- sharedActorRules: [{ scope: 'role', value: 'role-1' }],
72
- });
73
-
74
- const deniedByMention = evaluateAccessPolicy(policy, {
75
- senderId: 'user-1',
76
- chatId: 'chan-1',
77
- isDirect: false,
78
- isShared: true,
79
- groupId: 'chan-1',
80
- channelId: 'chan-1',
81
- serverId: 'guild-1',
82
- roleIds: ['role-1'],
83
- wasMentioned: false,
84
- }, 'discord');
85
- assert.equal(deniedByMention.allowed, false);
86
- assert.equal(deniedByMention.reason, 'mention_required');
87
-
88
- const allowed = evaluateAccessPolicy(policy, {
89
- senderId: 'user-1',
90
- chatId: 'chan-1',
91
- isDirect: false,
92
- isShared: true,
93
- groupId: 'chan-1',
94
- channelId: 'chan-1',
95
- serverId: 'guild-1',
96
- roleIds: ['role-1'],
97
- wasMentioned: true,
98
- }, 'discord');
99
- assert.equal(allowed.allowed, true);
100
- });
101
-
102
- test('direct allowlist requires a matching direct rule', () => {
103
- const policy = normalizeAccessPolicy('telegram', {
104
- directPolicy: 'allowlist',
105
- directRules: [{ scope: 'user', value: '42' }],
106
- });
107
-
108
- assert.equal(
109
- evaluateAccessPolicy(policy, {
110
- senderId: '42',
111
- chatId: 'dm_42',
112
- isDirect: true,
113
- isShared: false,
114
- wasMentioned: false,
115
- }, 'telegram').allowed,
116
- true,
117
- );
118
-
119
- assert.equal(
120
- evaluateAccessPolicy(policy, {
121
- senderId: '99',
122
- chatId: 'dm_99',
123
- isDirect: true,
124
- isShared: false,
125
- wasMentioned: false,
126
- }, 'telegram').allowed,
127
- false,
128
- );
129
- });
130
-
131
- test('shared actor role rules gate allowed spaces', () => {
132
- const policy = normalizeAccessPolicy('discord', {
133
- sharedPolicy: 'open',
134
- requireMentionInShared: false,
135
- sharedActorRules: [{ scope: 'role', value: 'ops' }],
136
- });
137
-
138
- assert.equal(
139
- evaluateAccessPolicy(policy, {
140
- senderId: 'user-1',
141
- chatId: 'chan',
142
- isDirect: false,
143
- isShared: true,
144
- channelId: 'chan',
145
- serverId: 'guild',
146
- roleIds: ['ops'],
147
- wasMentioned: true,
148
- }, 'discord').allowed,
149
- true,
150
- );
151
-
152
- const denied = evaluateAccessPolicy(policy, {
153
- senderId: 'user-2',
154
- chatId: 'chan',
155
- isDirect: false,
156
- isShared: true,
157
- channelId: 'chan',
158
- serverId: 'guild',
159
- roleIds: ['guest'],
160
- wasMentioned: true,
161
- }, 'discord');
162
- assert.equal(denied.allowed, false);
163
- assert.equal(denied.reason, 'shared_actor_not_allowed');
164
- });
165
-
166
- test('parseStoredAccessPolicy prefers canonical JSON and falls back to legacy JSON', () => {
167
- const canonical = parseStoredAccessPolicy(
168
- 'discord',
169
- JSON.stringify({
170
- directPolicy: 'open',
171
- sharedPolicy: 'disabled',
172
- requireMentionInShared: false,
173
- }),
174
- JSON.stringify(['user:123']),
175
- );
176
- assert.equal(canonical.directPolicy, 'open');
177
- assert.equal(canonical.sharedPolicy, 'disabled');
178
-
179
- const legacy = parseStoredAccessPolicy(
180
- 'discord',
181
- null,
182
- JSON.stringify(['user:123']),
183
- );
184
- assert.deepEqual(
185
- legacy.directRules.map((rule) => `${rule.scope}:${rule.value}`),
186
- ['user:123'],
187
- );
188
- });
189
-
190
- test('live platforms can hot-update policy without reconnecting', () => {
191
- class FakePlatform extends BasePlatform {
192
- constructor() {
193
- super('discord', {});
194
- }
195
- }
196
-
197
- const platform = new FakePlatform();
198
- platform.setAccessPolicy({
199
- directPolicy: 'disabled',
200
- sharedPolicy: 'disabled',
201
- });
202
- assert.equal(
203
- platform.evaluateAccess({
204
- senderId: 'user-1',
205
- chatId: 'dm_user-1',
206
- isDirect: true,
207
- isShared: false,
208
- wasMentioned: false,
209
- }).allowed,
210
- false,
211
- );
212
-
213
- platform.setAccessPolicy({
214
- directPolicy: 'allowlist',
215
- directRules: [{ scope: 'user', value: 'user-1' }],
216
- sharedPolicy: 'disabled',
217
- });
218
- assert.equal(
219
- platform.evaluateAccess({
220
- senderId: 'user-1',
221
- chatId: 'dm_user-1',
222
- isDirect: true,
223
- isShared: false,
224
- wasMentioned: false,
225
- }).allowed,
226
- true,
227
- );
228
- });
@@ -1,37 +0,0 @@
1
- class HostExecutionBackend {
2
- constructor(options = {}) {
3
- this.cliExecutor = options.cliExecutor || null;
4
- this.getBrowserProvider = options.getBrowserProvider;
5
- this.getAndroidProvider = options.getAndroidProvider;
6
- }
7
-
8
- async executeCommand(_userId, command, options = {}) {
9
- if (!this.cliExecutor) {
10
- throw new Error('Host CLI executor is not available.');
11
- }
12
- if (options.pty) {
13
- return this.cliExecutor.executeInteractive(command, options.inputs || [], options);
14
- }
15
- return this.cliExecutor.execute(command, options);
16
- }
17
-
18
- async getBrowserProviderForUser(userId) {
19
- if (typeof this.getBrowserProvider !== 'function') {
20
- throw new Error('Missing getBrowserProvider in Host execution backend.');
21
- }
22
- return this.getBrowserProvider(userId);
23
- }
24
-
25
- async getAndroidProviderForUser(userId) {
26
- if (typeof this.getAndroidProvider !== 'function') {
27
- throw new Error('Missing getAndroidProvider in Host execution backend.');
28
- }
29
- return this.getAndroidProvider(userId);
30
- }
31
-
32
- async shutdown() {}
33
- }
34
-
35
- module.exports = {
36
- HostExecutionBackend,
37
- };
@@ -1,391 +0,0 @@
1
- const fs = require('fs');
2
- const http = require('http');
3
- const https = require('https');
4
- const net = require('net');
5
- const path = require('path');
6
- const { StringDecoder } = require('string_decoder');
7
- const { spawn, spawnSync } = require('child_process');
8
- const { DATA_DIR } = require('../../../runtime/paths');
9
-
10
- const VM_ROOT = path.join(DATA_DIR, 'runtime-vms');
11
- const BASE_IMAGE_CACHE_ROOT = path.join(VM_ROOT, 'base-images');
12
- fs.mkdirSync(VM_ROOT, { recursive: true });
13
- fs.mkdirSync(BASE_IMAGE_CACHE_ROOT, { recursive: true });
14
-
15
- const DEFAULT_UBUNTU_BASE_IMAGE_URLS = Object.freeze({
16
- x64: 'https://cloud-images.ubuntu.com/releases/24.04/release/ubuntu-24.04-server-cloudimg-amd64.img',
17
- arm64: 'https://cloud-images.ubuntu.com/releases/24.04/release/ubuntu-24.04-server-cloudimg-arm64.img',
18
- });
19
-
20
- function guestArchForHost(hostArch = process.arch) {
21
- return hostArch === 'arm64' ? 'arm64' : 'x64';
22
- }
23
-
24
- function resolveQemuBinary({ arch = guestArchForHost(), platform = process.platform } = {}) {
25
- if (platform === 'win32') {
26
- return arch === 'arm64' ? 'qemu-system-aarch64.exe' : 'qemu-system-x86_64.exe';
27
- }
28
- return arch === 'arm64' ? 'qemu-system-aarch64' : 'qemu-system-x86_64';
29
- }
30
-
31
- function defaultBaseImageUrlForArch(arch = guestArchForHost()) {
32
- return DEFAULT_UBUNTU_BASE_IMAGE_URLS[arch] || DEFAULT_UBUNTU_BASE_IMAGE_URLS.x64;
33
- }
34
-
35
- function isHttpUrl(value) {
36
- const candidate = String(value || '').trim();
37
- return /^https?:\/\//i.test(candidate);
38
- }
39
-
40
- function downloadFile(sourceUrl, destinationPath, redirectCount = 0) {
41
- return new Promise((resolve, reject) => {
42
- if (redirectCount > 5) {
43
- reject(new Error('Too many redirects while downloading VM base image.'));
44
- return;
45
- }
46
-
47
- const client = String(sourceUrl).startsWith('https:') ? https : http;
48
- let settled = false;
49
- let output = null;
50
- const tempPath = `${destinationPath}.download`;
51
-
52
- const cleanup = (error) => {
53
- if (settled) {
54
- return;
55
- }
56
- settled = true;
57
- try { output?.destroy(); } catch {}
58
- try { fs.rmSync(tempPath, { force: true }); } catch {}
59
- reject(error);
60
- };
61
-
62
- const request = client.get(sourceUrl, (response) => {
63
- if (response.statusCode && response.statusCode >= 300 && response.statusCode < 400 && response.headers.location) {
64
- response.resume();
65
- const nextUrl = new URL(response.headers.location, sourceUrl).toString();
66
- if (!settled) {
67
- settled = true;
68
- resolve(downloadFile(nextUrl, destinationPath, redirectCount + 1));
69
- }
70
- return;
71
- }
72
-
73
- if (response.statusCode !== 200) {
74
- response.resume();
75
- cleanup(new Error(`Failed to download VM base image: HTTP ${response.statusCode}`));
76
- return;
77
- }
78
-
79
- fs.mkdirSync(path.dirname(destinationPath), { recursive: true });
80
- output = fs.createWriteStream(tempPath);
81
-
82
- response.pipe(output);
83
- output.on('finish', () => {
84
- output.close(() => {
85
- if (settled) {
86
- return;
87
- }
88
- settled = true;
89
- try {
90
- fs.renameSync(tempPath, destinationPath);
91
- resolve(destinationPath);
92
- } catch (error) {
93
- try { fs.rmSync(tempPath, { force: true }); } catch {}
94
- reject(error);
95
- }
96
- });
97
- });
98
- output.on('error', (error) => {
99
- cleanup(error);
100
- });
101
- response.on('error', (error) => {
102
- cleanup(error);
103
- });
104
- });
105
-
106
- request.setTimeout(30000, () => {
107
- request.destroy(new Error('Timed out while downloading VM base image.'));
108
- });
109
- request.on('timeout', () => {
110
- cleanup(new Error('Timed out while downloading VM base image.'));
111
- });
112
- request.on('abort', () => {
113
- cleanup(new Error('VM base image download was aborted.'));
114
- });
115
- request.on('error', (error) => {
116
- cleanup(error);
117
- });
118
- });
119
- }
120
-
121
- function resolveAcceleration({ platform = process.platform } = {}) {
122
- if (platform === 'linux') return 'kvm';
123
- if (platform === 'darwin') return 'hvf';
124
- if (platform === 'win32') return 'whpx';
125
- return 'tcg';
126
- }
127
-
128
- function buildQemuArgs({
129
- imagePath,
130
- sshPort,
131
- agentPort = 8421,
132
- memoryMb = 4096,
133
- cpus = 2,
134
- arch = guestArchForHost(),
135
- platform = process.platform,
136
- }) {
137
- const accel = resolveAcceleration({ platform });
138
- const args = ['-display', 'none', '-m', String(memoryMb), '-smp', String(cpus)];
139
-
140
- if (arch === 'arm64') {
141
- args.push('-machine', `virt,accel=${accel}`);
142
- if (platform !== 'win32') {
143
- args.push('-cpu', 'host');
144
- }
145
- } else {
146
- args.push('-machine', `q35,accel=${accel}`);
147
- if (platform !== 'win32') {
148
- args.push('-cpu', 'host');
149
- }
150
- }
151
-
152
- args.push(
153
- '-drive', `if=virtio,file=${imagePath},format=qcow2`,
154
- '-netdev', `user,id=net0,hostfwd=tcp:127.0.0.1:${sshPort}-:22,hostfwd=tcp:127.0.0.1:${agentPort}-:8421`,
155
- '-device', 'virtio-net-pci,netdev=net0',
156
- );
157
-
158
- return args;
159
- }
160
-
161
- function commandExists(command) {
162
- const probe = spawnSync(process.platform === 'win32' ? 'where' : 'bash', process.platform === 'win32' ? [command] : ['-lc', `command -v "${command}"`], {
163
- stdio: 'ignore',
164
- });
165
- return probe.status === 0;
166
- }
167
-
168
- function allocatePort() {
169
- return new Promise((resolve, reject) => {
170
- const server = net.createServer();
171
- server.unref();
172
- server.on('error', reject);
173
- server.listen(0, '127.0.0.1', () => {
174
- const address = server.address();
175
- const port = typeof address === 'object' && address ? address.port : null;
176
- server.close((err) => {
177
- if (err) return reject(err);
178
- resolve(port);
179
- });
180
- });
181
- });
182
- }
183
-
184
- function ensureUserVmDisk(userRoot, baseImagePath) {
185
- fs.mkdirSync(userRoot, { recursive: true });
186
- const diskPath = path.join(userRoot, 'disk.qcow2');
187
- if (fs.existsSync(diskPath)) {
188
- return diskPath;
189
- }
190
- if (!fs.existsSync(baseImagePath)) {
191
- throw new Error(`VM base image not found: ${baseImagePath}`);
192
- }
193
-
194
- const qemuImg = process.platform === 'win32' ? 'qemu-img.exe' : 'qemu-img';
195
- if (!commandExists(qemuImg)) {
196
- throw new Error('qemu-img is required to create per-user VM overlays.');
197
- }
198
-
199
- const result = spawnSync(
200
- qemuImg,
201
- ['create', '-f', 'qcow2', '-F', 'qcow2', '-b', baseImagePath, diskPath],
202
- {
203
- stdio: 'pipe',
204
- encoding: 'utf8',
205
- },
206
- );
207
- if (result.status === 0 && fs.existsSync(diskPath)) {
208
- return diskPath;
209
- }
210
-
211
- throw new Error(
212
- `Failed to create VM overlay with qemu-img: ${(result.stderr || result.stdout || 'unknown error').trim()}`,
213
- );
214
- }
215
-
216
- class QemuVmManager {
217
- constructor(options = {}) {
218
- this.rootDir = path.resolve(options.rootDir || VM_ROOT);
219
- this.baseImagePath = options.baseImagePath || process.env.NEOAGENT_VM_BASE_IMAGE || '';
220
- this.baseImageUrl = options.baseImageUrl || process.env.NEOAGENT_VM_BASE_IMAGE_URL || defaultBaseImageUrlForArch(options.guestArch || guestArchForHost());
221
- this.memoryMb = Number(options.memoryMb || process.env.NEOAGENT_VM_MEMORY_MB || 4096);
222
- this.cpus = Number(options.cpus || process.env.NEOAGENT_VM_CPUS || 2);
223
- this.guestArch = options.guestArch || guestArchForHost();
224
- this.instances = new Map();
225
- this.baseImagePromise = null;
226
- fs.mkdirSync(this.rootDir, { recursive: true });
227
- }
228
-
229
- getBaseImageCachePath() {
230
- if (!isHttpUrl(this.baseImageUrl)) {
231
- return null;
232
- }
233
- const parsed = new URL(this.baseImageUrl);
234
- const filename = path.basename(parsed.pathname || '') || `${this.guestArch}-base.img`;
235
- return path.join(BASE_IMAGE_CACHE_ROOT, filename);
236
- }
237
-
238
- resolveBaseImagePath() {
239
- const explicitPath = String(this.baseImagePath || '').trim();
240
- if (explicitPath) {
241
- return explicitPath;
242
- }
243
- return this.getBaseImageCachePath();
244
- }
245
-
246
- async ensureBaseImageAvailable() {
247
- const explicitPath = String(this.baseImagePath || '').trim();
248
- if (explicitPath) {
249
- if (!fs.existsSync(explicitPath)) {
250
- throw new Error(`VM base image not found: ${explicitPath}`);
251
- }
252
- return explicitPath;
253
- }
254
-
255
- if (!isHttpUrl(this.baseImageUrl)) {
256
- throw new Error('VM base image is not configured. Set NEOAGENT_VM_BASE_IMAGE or NEOAGENT_VM_BASE_IMAGE_URL.');
257
- }
258
-
259
- const cachePath = this.getBaseImageCachePath();
260
- if (cachePath && fs.existsSync(cachePath)) {
261
- return cachePath;
262
- }
263
-
264
- if (!this.baseImagePromise) {
265
- this.baseImagePromise = downloadFile(this.baseImageUrl, cachePath)
266
- .finally(() => {
267
- this.baseImagePromise = null;
268
- });
269
- }
270
-
271
- return this.baseImagePromise;
272
- }
273
-
274
- isConfigured() {
275
- return this.getReadiness().ready;
276
- }
277
-
278
- getReadiness() {
279
- const qemuBinary = resolveQemuBinary({ arch: this.guestArch });
280
- const qemuImgBinary = process.platform === 'win32' ? 'qemu-img.exe' : 'qemu-img';
281
- const resolvedBaseImagePath = this.resolveBaseImagePath();
282
- const baseImageExists = Boolean(resolvedBaseImagePath && fs.existsSync(resolvedBaseImagePath));
283
- const downloadConfigured = !this.baseImagePath && isHttpUrl(this.baseImageUrl);
284
- const qemuAvailable = commandExists(qemuBinary);
285
- const qemuImgAvailable = commandExists(qemuImgBinary);
286
- return {
287
- ready: qemuAvailable && qemuImgAvailable && (baseImageExists || downloadConfigured),
288
- baseImagePath: resolvedBaseImagePath || null,
289
- baseImageExists,
290
- baseImageUrl: this.baseImageUrl || null,
291
- downloadConfigured,
292
- qemuBinary,
293
- qemuAvailable,
294
- qemuImgBinary,
295
- qemuImgAvailable,
296
- acceleration: resolveAcceleration(),
297
- guestArch: this.guestArch,
298
- platform: process.platform,
299
- };
300
- }
301
-
302
- async ensureVm(userId) {
303
- const key = String(userId || '').trim();
304
- if (!key) {
305
- throw new Error('VM runtime requires a user ID.');
306
- }
307
- const existing = this.instances.get(key);
308
- if (existing?.process && !existing.process.killed) {
309
- return existing;
310
- }
311
- const readiness = this.getReadiness();
312
- if (!readiness.ready) {
313
- throw new Error('VM runtime is not configured on this host. Set NEOAGENT_VM_BASE_IMAGE or NEOAGENT_VM_BASE_IMAGE_URL.');
314
- }
315
-
316
- const userRoot = path.join(this.rootDir, key);
317
- const baseImagePath = await this.ensureBaseImageAvailable();
318
- const diskPath = ensureUserVmDisk(userRoot, baseImagePath);
319
- const agentPort = await allocatePort();
320
- const sshPort = await allocatePort();
321
- const qemuBinary = resolveQemuBinary({ arch: this.guestArch });
322
- const args = buildQemuArgs({
323
- imagePath: diskPath,
324
- sshPort,
325
- agentPort,
326
- memoryMb: this.memoryMb,
327
- cpus: this.cpus,
328
- arch: this.guestArch,
329
- });
330
-
331
- const child = spawn(qemuBinary, args, {
332
- cwd: userRoot,
333
- detached: process.platform !== 'win32',
334
- stdio: ['ignore', 'ignore', 'pipe'],
335
- });
336
-
337
- let lastError = '';
338
- const stderrDecoder = new StringDecoder('utf8');
339
- child.stderr.on('data', (chunk) => {
340
- lastError = [...`${lastError}${stderrDecoder.write(chunk)}`].slice(-4000).join('');
341
- });
342
- child.stderr.on('close', () => {
343
- const remainder = stderrDecoder.end();
344
- if (remainder) {
345
- lastError = [...`${lastError}${remainder}`].slice(-4000).join('');
346
- }
347
- });
348
- child.on('exit', () => {
349
- this.instances.delete(key);
350
- });
351
-
352
- const session = {
353
- userId: key,
354
- process: child,
355
- qemuBinary,
356
- qemuArgs: args,
357
- userRoot,
358
- diskPath,
359
- agentPort,
360
- sshPort,
361
- baseUrl: `http://127.0.0.1:${agentPort}`,
362
- getLastError: () => lastError.trim(),
363
- };
364
- this.instances.set(key, session);
365
- return session;
366
- }
367
-
368
- async shutdown() {
369
- for (const session of this.instances.values()) {
370
- try {
371
- session.process.kill('SIGTERM');
372
- } catch {}
373
- }
374
- this.instances.clear();
375
- }
376
- }
377
-
378
- module.exports = {
379
- BASE_IMAGE_CACHE_ROOT,
380
- DEFAULT_UBUNTU_BASE_IMAGE_URLS,
381
- QemuVmManager,
382
- VM_ROOT,
383
- allocatePort,
384
- buildQemuArgs,
385
- defaultBaseImageUrlForArch,
386
- downloadFile,
387
- guestArchForHost,
388
- isHttpUrl,
389
- resolveAcceleration,
390
- resolveQemuBinary,
391
- };