novacode-cli 1.2.0__py3-none-any.whl

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 (691) hide show
  1. novacode_cli/__init__.py +29 -0
  2. novacode_cli/__main__.py +6 -0
  3. novacode_cli/_lazy_heavy.py +99 -0
  4. novacode_cli/_version.py +3 -0
  5. novacode_cli/agent_stream.py +178 -0
  6. novacode_cli/agents/agent_file.py +250 -0
  7. novacode_cli/agents/agent_mailbox.py +120 -0
  8. novacode_cli/agents/approval_decisions.py +146 -0
  9. novacode_cli/agents/arg_repair.py +196 -0
  10. novacode_cli/agents/async_agents/__init__.py +6 -0
  11. novacode_cli/agents/async_agents/_config.py +213 -0
  12. novacode_cli/agents/async_agents/_mcp_tools.py +192 -0
  13. novacode_cli/agents/async_agents/_specialist.py +84 -0
  14. novacode_cli/agents/async_agents/_test_commands.py +89 -0
  15. novacode_cli/agents/async_agents/_tools.py +432 -0
  16. novacode_cli/agents/async_agents/general_purpose.py +42 -0
  17. novacode_cli/agents/async_agents/langgraph.json +9 -0
  18. novacode_cli/agents/async_agents/research.py +22 -0
  19. novacode_cli/agents/async_context.py +303 -0
  20. novacode_cli/agents/async_on_demand.py +52 -0
  21. novacode_cli/agents/async_task_errors.py +75 -0
  22. novacode_cli/agents/async_workspace.py +27 -0
  23. novacode_cli/agents/attribution.py +165 -0
  24. novacode_cli/agents/browser_mode.py +119 -0
  25. novacode_cli/agents/btw_agent.py +71 -0
  26. novacode_cli/agents/caveman.py +352 -0
  27. novacode_cli/agents/caveman_support.py +370 -0
  28. novacode_cli/agents/code_mode.py +774 -0
  29. novacode_cli/agents/code_runtime.py +160 -0
  30. novacode_cli/agents/context_compaction.py +1339 -0
  31. novacode_cli/agents/core_agent.py +2710 -0
  32. novacode_cli/agents/default_subagents/__init__.py +24 -0
  33. novacode_cli/agents/default_subagents/async_subagents.py +296 -0
  34. novacode_cli/agents/default_subagents/builtin/browser-automation-agent.md +110 -0
  35. novacode_cli/agents/default_subagents/builtin/bug-fix-agent.md +22 -0
  36. novacode_cli/agents/default_subagents/builtin/bug-investigation-agent.md +42 -0
  37. novacode_cli/agents/default_subagents/builtin/code-explorer.md +37 -0
  38. novacode_cli/agents/default_subagents/builtin/code-review-agent.md +33 -0
  39. novacode_cli/agents/default_subagents/builtin/dependency-audit-agent.md +34 -0
  40. novacode_cli/agents/default_subagents/builtin/documentation-update-agent.md +46 -0
  41. novacode_cli/agents/default_subagents/builtin/performance-audit-agent.md +41 -0
  42. novacode_cli/agents/default_subagents/builtin/plan-scout-agent.md +64 -0
  43. novacode_cli/agents/default_subagents/builtin/refactoring-agent.md +35 -0
  44. novacode_cli/agents/default_subagents/builtin/refactoring-specialist-agent.md +175 -0
  45. novacode_cli/agents/default_subagents/builtin/security-audit-agent.md +96 -0
  46. novacode_cli/agents/default_subagents/builtin/test-generation-agent.md +33 -0
  47. novacode_cli/agents/default_subagents/builtin/test-runner-agent.md +55 -0
  48. novacode_cli/agents/default_subagents/prompt.py +88 -0
  49. novacode_cli/agents/default_subagents/subagents.py +138 -0
  50. novacode_cli/agents/dream_agent.py +93 -0
  51. novacode_cli/agents/edit_diagnostics.py +362 -0
  52. novacode_cli/agents/edit_fallback.py +62 -0
  53. novacode_cli/agents/handoff.py +166 -0
  54. novacode_cli/agents/invocation.py +152 -0
  55. novacode_cli/agents/model_budget.py +42 -0
  56. novacode_cli/agents/model_retry.py +113 -0
  57. novacode_cli/agents/model_router.py +420 -0
  58. novacode_cli/agents/openai_decisions.py +186 -0
  59. novacode_cli/agents/plan_agent/__init__.py +12 -0
  60. novacode_cli/agents/plan_agent/plan_agent.py +357 -0
  61. novacode_cli/agents/plan_agent/plan_mode_middleware.py +64 -0
  62. novacode_cli/agents/plan_execution.py +237 -0
  63. novacode_cli/agents/ponytail.py +66 -0
  64. novacode_cli/agents/prime.py +274 -0
  65. novacode_cli/agents/provider_caching.py +99 -0
  66. novacode_cli/agents/server_launcher.py +904 -0
  67. novacode_cli/agents/strict_tools.py +384 -0
  68. novacode_cli/agents/task_discipline.py +294 -0
  69. novacode_cli/agents/tool_call_repair.py +290 -0
  70. novacode_cli/agents/tool_offload.py +291 -0
  71. novacode_cli/agents/tool_search.py +806 -0
  72. novacode_cli/agents/tool_search_variants.py +106 -0
  73. novacode_cli/agents/tool_verdicts.py +1194 -0
  74. novacode_cli/agents/user_async_agents.py +312 -0
  75. novacode_cli/artifacts/__init__.py +10 -0
  76. novacode_cli/artifacts/registry.py +278 -0
  77. novacode_cli/artifacts/server.py +426 -0
  78. novacode_cli/assets/Nova.png +0 -0
  79. novacode_cli/assets/nova-avatar.png +0 -0
  80. novacode_cli/audio/__init__.py +301 -0
  81. novacode_cli/audio/capture.py +137 -0
  82. novacode_cli/audio/downloads.py +273 -0
  83. novacode_cli/audio/pipeline.py +391 -0
  84. novacode_cli/audio/playback.py +87 -0
  85. novacode_cli/audio/providers.py +208 -0
  86. novacode_cli/audio/speakable.py +78 -0
  87. novacode_cli/audio/stt.py +132 -0
  88. novacode_cli/audio/stt_deepgram.py +69 -0
  89. novacode_cli/audio/stt_elevenlabs.py +89 -0
  90. novacode_cli/audio/stt_parakeet.py +94 -0
  91. novacode_cli/audio/stt_whistle.py +61 -0
  92. novacode_cli/audio/summarize.py +92 -0
  93. novacode_cli/audio/tts.py +85 -0
  94. novacode_cli/audio/tts_kokoro.py +73 -0
  95. novacode_cli/audio/tts_orpheus.py +180 -0
  96. novacode_cli/audio/tts_pocket.py +131 -0
  97. novacode_cli/audio/tts_sano.py +69 -0
  98. novacode_cli/audio/vad.py +145 -0
  99. novacode_cli/backends/__init__.py +17 -0
  100. novacode_cli/backends/filesystem.py +894 -0
  101. novacode_cli/backends/native_search.py +92 -0
  102. novacode_cli/bootstrap/__init__.py +9 -0
  103. novacode_cli/bootstrap/env_snapshot.py +240 -0
  104. novacode_cli/bootstrap/steering.py +464 -0
  105. novacode_cli/bootstrap/vision_router.py +604 -0
  106. novacode_cli/brand.py +362 -0
  107. novacode_cli/cli_args.py +718 -0
  108. novacode_cli/commands/__init__.py +237 -0
  109. novacode_cli/commands/agents_commands.py +231 -0
  110. novacode_cli/commands/auth_handler.py +40 -0
  111. novacode_cli/commands/browser_use_handler.py +75 -0
  112. novacode_cli/commands/cache_handler.py +32 -0
  113. novacode_cli/commands/chat_handler.py +1357 -0
  114. novacode_cli/commands/ci_fix.py +171 -0
  115. novacode_cli/commands/claude_plan.py +331 -0
  116. novacode_cli/commands/codex_plan.py +195 -0
  117. novacode_cli/commands/commands.py +1113 -0
  118. novacode_cli/commands/create_handler.py +124 -0
  119. novacode_cli/commands/create_server.py +1887 -0
  120. novacode_cli/commands/cron_handler.py +119 -0
  121. novacode_cli/commands/dream_handler.py +203 -0
  122. novacode_cli/commands/effort_handler.py +65 -0
  123. novacode_cli/commands/evolution_handler.py +214 -0
  124. novacode_cli/commands/file_commands.py +381 -0
  125. novacode_cli/commands/handoff_handler.py +68 -0
  126. novacode_cli/commands/hooks_handler.py +269 -0
  127. novacode_cli/commands/init_handler.py +146 -0
  128. novacode_cli/commands/learning_handler.py +160 -0
  129. novacode_cli/commands/lite_mode_handler.py +76 -0
  130. novacode_cli/commands/log_commands.py +363 -0
  131. novacode_cli/commands/mcp_handler.py +29 -0
  132. novacode_cli/commands/model_handler.py +29 -0
  133. novacode_cli/commands/notifications_handler.py +158 -0
  134. novacode_cli/commands/onboard_handler.py +121 -0
  135. novacode_cli/commands/plan_handler.py +440 -0
  136. novacode_cli/commands/planner_usage.py +250 -0
  137. novacode_cli/commands/plugin_install_handler.py +38 -0
  138. novacode_cli/commands/plugins_handler.py +35 -0
  139. novacode_cli/commands/prime_handler.py +455 -0
  140. novacode_cli/commands/prompt_handler.py +149 -0
  141. novacode_cli/commands/provider_usage.py +160 -0
  142. novacode_cli/commands/ralph_events.py +106 -0
  143. novacode_cli/commands/ralph_handler.py +1293 -0
  144. novacode_cli/commands/refine_handler.py +213 -0
  145. novacode_cli/commands/research_handler.py +202 -0
  146. novacode_cli/commands/rootapp_remote.py +83 -0
  147. novacode_cli/commands/router_handler.py +36 -0
  148. novacode_cli/commands/server_commands.py +249 -0
  149. novacode_cli/commands/session_commands.py +203 -0
  150. novacode_cli/commands/share_handler.py +450 -0
  151. novacode_cli/commands/side_commands.py +366 -0
  152. novacode_cli/commands/skill_invoke.py +420 -0
  153. novacode_cli/commands/skills_commands.py +48 -0
  154. novacode_cli/commands/trace_handler.py +322 -0
  155. novacode_cli/commands/trello_handler.py +226 -0
  156. novacode_cli/commands/trello_remote.py +177 -0
  157. novacode_cli/commands/trello_server.py +1214 -0
  158. novacode_cli/commands/vision_handler.py +127 -0
  159. novacode_cli/commands/voice_handler.py +447 -0
  160. novacode_cli/commands/webhook_handler.py +134 -0
  161. novacode_cli/commands/wiki_commands.py +227 -0
  162. novacode_cli/compaction.py +753 -0
  163. novacode_cli/computation_cache.py +159 -0
  164. novacode_cli/computer/__init__.py +1 -0
  165. novacode_cli/computer/persistent.py +234 -0
  166. novacode_cli/computer/preview.py +253 -0
  167. novacode_cli/computer/runtime.py +474 -0
  168. novacode_cli/computer/windows_console.py +152 -0
  169. novacode_cli/computer/windows_qemu.py +211 -0
  170. novacode_cli/config/browser_mode.py +159 -0
  171. novacode_cli/config/catalog_models.py +95 -0
  172. novacode_cli/config/config.py +1388 -0
  173. novacode_cli/config/credentials.py +540 -0
  174. novacode_cli/config/google_oauth_auth.py +281 -0
  175. novacode_cli/config/model_capabilities.py +343 -0
  176. novacode_cli/config/model_catalog.py +275 -0
  177. novacode_cli/config/model_create.py +1325 -0
  178. novacode_cli/config/model_manager.py +695 -0
  179. novacode_cli/config/nova_config.py +1283 -0
  180. novacode_cli/config/openai_chatgpt_auth.py +384 -0
  181. novacode_cli/config/opencode_gateway.py +25 -0
  182. novacode_cli/config/plan_mode.py +188 -0
  183. novacode_cli/config/provider_auth.py +438 -0
  184. novacode_cli/config/provider_catalog.json +5127 -0
  185. novacode_cli/config/provider_registry.py +38 -0
  186. novacode_cli/config/provider_transports.py +258 -0
  187. novacode_cli/config/role_models.py +175 -0
  188. novacode_cli/context/__init__.py +50 -0
  189. novacode_cli/context/_analysis.py +799 -0
  190. novacode_cli/context/_budget.py +116 -0
  191. novacode_cli/context/_conversation.py +73 -0
  192. novacode_cli/context/_dynamic.py +264 -0
  193. novacode_cli/context/_model_config.py +380 -0
  194. novacode_cli/context/_models_dev.py +99 -0
  195. novacode_cli/context/archives.py +248 -0
  196. novacode_cli/context/estimates.py +65 -0
  197. novacode_cli/context/history.py +17 -0
  198. novacode_cli/context/knowledge_cache.py +292 -0
  199. novacode_cli/context/manager.py +101 -0
  200. novacode_cli/context/observations.py +65 -0
  201. novacode_cli/context/pressure.py +168 -0
  202. novacode_cli/context/provider_accounting.py +109 -0
  203. novacode_cli/context/snapshot.py +493 -0
  204. novacode_cli/context/strategies.py +279 -0
  205. novacode_cli/context/task_progress.py +122 -0
  206. novacode_cli/core/__init__.py +0 -0
  207. novacode_cli/core/agent_loop.py +1821 -0
  208. novacode_cli/core/autonomous_loop.py +277 -0
  209. novacode_cli/core/code_approvals.py +57 -0
  210. novacode_cli/core/input_preparation.py +276 -0
  211. novacode_cli/core/reasoning.py +67 -0
  212. novacode_cli/core/streaming.py +326 -0
  213. novacode_cli/core/subagent_tasks.py +696 -0
  214. novacode_cli/core/subagent_tracking.py +235 -0
  215. novacode_cli/core/tool_results.py +116 -0
  216. novacode_cli/core/verification_loop.py +272 -0
  217. novacode_cli/council.py +595 -0
  218. novacode_cli/council_consensus.py +115 -0
  219. novacode_cli/council_decision.py +157 -0
  220. novacode_cli/council_planner.py +1421 -0
  221. novacode_cli/council_settings.py +208 -0
  222. novacode_cli/council_web_settings.py +41 -0
  223. novacode_cli/council_workspace.py +56 -0
  224. novacode_cli/cowork/__init__.py +10 -0
  225. novacode_cli/cowork/broker_middleware.py +162 -0
  226. novacode_cli/cowork/launcher.py +102 -0
  227. novacode_cli/cowork/policy.py +284 -0
  228. novacode_cli/cowork/ui.py +826 -0
  229. novacode_cli/daemons/__init__.py +1 -0
  230. novacode_cli/daemons/registry.py +342 -0
  231. novacode_cli/desktop_notifications.py +302 -0
  232. novacode_cli/doctor.py +251 -0
  233. novacode_cli/embeddings.py +109 -0
  234. novacode_cli/entrypoint.py +56 -0
  235. novacode_cli/errors/__init__.py +19 -0
  236. novacode_cli/errors/handlers.py +648 -0
  237. novacode_cli/errors/provider_errors.py +249 -0
  238. novacode_cli/errors/taxonomy.py +80 -0
  239. novacode_cli/events.py +179 -0
  240. novacode_cli/file_ops.py +714 -0
  241. novacode_cli/git_safety.py +281 -0
  242. novacode_cli/handoff.py +383 -0
  243. novacode_cli/headless/__init__.py +18 -0
  244. novacode_cli/headless/input.py +58 -0
  245. novacode_cli/headless/output.py +224 -0
  246. novacode_cli/headless/pipe.py +532 -0
  247. novacode_cli/headless/runner.py +461 -0
  248. novacode_cli/hermes/__init__.py +39 -0
  249. novacode_cli/hermes/activation.py +297 -0
  250. novacode_cli/hermes/config.py +129 -0
  251. novacode_cli/hermes/curator.py +199 -0
  252. novacode_cli/hermes/evolution.py +374 -0
  253. novacode_cli/hermes/ledger.py +364 -0
  254. novacode_cli/hermes/memory_tiers.py +969 -0
  255. novacode_cli/hermes/middleware.py +678 -0
  256. novacode_cli/hermes/overview.py +174 -0
  257. novacode_cli/hermes/prompt_evolution.py +503 -0
  258. novacode_cli/hermes/refine_loop.py +643 -0
  259. novacode_cli/hermes/refinement_log.py +190 -0
  260. novacode_cli/hermes/review.py +674 -0
  261. novacode_cli/hermes/skill_debate.py +135 -0
  262. novacode_cli/hermes/skill_discovery.py +450 -0
  263. novacode_cli/hermes/skill_manager.py +335 -0
  264. novacode_cli/hermes/skill_proposals.py +43 -0
  265. novacode_cli/hermes/test_gaming.py +119 -0
  266. novacode_cli/hermes/tracker.py +435 -0
  267. novacode_cli/hermes/tuner.py +206 -0
  268. novacode_cli/hermes/verification_memory.py +134 -0
  269. novacode_cli/hermes/verifier.py +277 -0
  270. novacode_cli/hitl/__init__.py +22 -0
  271. novacode_cli/hitl/interrupts.py +493 -0
  272. novacode_cli/hooks.py +359 -0
  273. novacode_cli/image_utils.py +517 -0
  274. novacode_cli/init/__init__.py +7 -0
  275. novacode_cli/init/events.py +43 -0
  276. novacode_cli/input_utils.py +526 -0
  277. novacode_cli/install_commands.py +87 -0
  278. novacode_cli/integrations/__init__.py +82 -0
  279. novacode_cli/integrations/daytona.py +122 -0
  280. novacode_cli/integrations/docker.py +309 -0
  281. novacode_cli/integrations/host_path.py +111 -0
  282. novacode_cli/integrations/langsmith.py +151 -0
  283. novacode_cli/integrations/modal.py +134 -0
  284. novacode_cli/integrations/runloop.py +130 -0
  285. novacode_cli/integrations/sandbox_factory.py +1388 -0
  286. novacode_cli/integrations/sandbox_registry.py +312 -0
  287. novacode_cli/integrations/workdir_backend.py +589 -0
  288. novacode_cli/main.py +2078 -0
  289. novacode_cli/mcp/__init__.py +73 -0
  290. novacode_cli/mcp/auth.py +189 -0
  291. novacode_cli/mcp/client.py +571 -0
  292. novacode_cli/mcp/code_mode.py +5 -0
  293. novacode_cli/mcp/code_runtime.py +5 -0
  294. novacode_cli/mcp/commands.py +902 -0
  295. novacode_cli/mcp/config.py +406 -0
  296. novacode_cli/mcp/generic.py +128 -0
  297. novacode_cli/mcp/middleware.py +993 -0
  298. novacode_cli/mcp/presets.py +367 -0
  299. novacode_cli/memory/__init__.py +1 -0
  300. novacode_cli/memory/agent_memory.py +1312 -0
  301. novacode_cli/memory/builtin_lessons.py +60 -0
  302. novacode_cli/memory/dream_gates.py +192 -0
  303. novacode_cli/memory/limits.py +59 -0
  304. novacode_cli/memory/parsed_cache.py +106 -0
  305. novacode_cli/memory/recall_stats.py +97 -0
  306. novacode_cli/memory/semantic.py +116 -0
  307. novacode_cli/memory/store.py +335 -0
  308. novacode_cli/memory/wiki.py +274 -0
  309. novacode_cli/migrate.py +185 -0
  310. novacode_cli/onboarding.py +649 -0
  311. novacode_cli/onboarding_check.py +119 -0
  312. novacode_cli/path_approval.py +297 -0
  313. novacode_cli/plan_archive.py +148 -0
  314. novacode_cli/plugins/__init__.py +121 -0
  315. novacode_cli/plugins/claude_plugins.py +538 -0
  316. novacode_cli/plugins/cli.py +168 -0
  317. novacode_cli/plugins/components.py +413 -0
  318. novacode_cli/plugins/hooks.py +356 -0
  319. novacode_cli/plugins/loader.py +317 -0
  320. novacode_cli/plugins/marketplaces.py +199 -0
  321. novacode_cli/plugins/storage.py +70 -0
  322. novacode_cli/prime.py +759 -0
  323. novacode_cli/prime_factory/__init__.py +15 -0
  324. novacode_cli/prime_factory/container.py +198 -0
  325. novacode_cli/prime_factory/controller.py +565 -0
  326. novacode_cli/prime_factory/knowledge.py +261 -0
  327. novacode_cli/prime_factory/publication.py +218 -0
  328. novacode_cli/prime_factory/recovery.py +50 -0
  329. novacode_cli/prime_factory/research.py +370 -0
  330. novacode_cli/prime_factory/runner.py +608 -0
  331. novacode_cli/prime_factory/runtime.py +261 -0
  332. novacode_cli/prime_factory/state.py +201 -0
  333. novacode_cli/prime_factory/store.py +128 -0
  334. novacode_cli/prime_factory/worker.py +129 -0
  335. novacode_cli/prime_factory/workflow.py +899 -0
  336. novacode_cli/prime_factory/workspace.py +317 -0
  337. novacode_cli/prime_memory.py +290 -0
  338. novacode_cli/process_manager.py +585 -0
  339. novacode_cli/project_onboard.py +537 -0
  340. novacode_cli/prompts/System_Prompt_Nova.jinja +23 -0
  341. novacode_cli/prompts/__init__.py +168 -0
  342. novacode_cli/prompts/agent_definitions.jinja +11 -0
  343. novacode_cli/prompts/agent_generation.jinja +125 -0
  344. novacode_cli/prompts/async_agents/general_purpose.jinja +22 -0
  345. novacode_cli/prompts/claude_plan_mode.jinja +12 -0
  346. novacode_cli/prompts/coding_workflow.jinja +18 -0
  347. novacode_cli/prompts/computer_use.jinja +17 -0
  348. novacode_cli/prompts/core_agent_system.jinja +81 -0
  349. novacode_cli/prompts/delegation.jinja +15 -0
  350. novacode_cli/prompts/desktop_power.jinja +4 -0
  351. novacode_cli/prompts/file_paths.jinja +15 -0
  352. novacode_cli/prompts/file_tracker.jinja +23 -0
  353. novacode_cli/prompts/init_agents_md.jinja +56 -0
  354. novacode_cli/prompts/init_exploration.jinja +174 -0
  355. novacode_cli/prompts/init_semantic_orchestrate.jinja +37 -0
  356. novacode_cli/prompts/instruction_scope.jinja +5 -0
  357. novacode_cli/prompts/learnings_extraction.jinja +45 -0
  358. novacode_cli/prompts/longterm_memory.jinja +54 -0
  359. novacode_cli/prompts/mcp.jinja +84 -0
  360. novacode_cli/prompts/memory_consolidation.jinja +40 -0
  361. novacode_cli/prompts/nova_evolution.jinja +73 -0
  362. novacode_cli/prompts/nova_review.jinja +158 -0
  363. novacode_cli/prompts/nova_skill_debate.jinja +36 -0
  364. novacode_cli/prompts/nova_standing_instructions.jinja +26 -0
  365. novacode_cli/prompts/nova_verify.jinja +100 -0
  366. novacode_cli/prompts/onboard_dashboard.jinja +378 -0
  367. novacode_cli/prompts/plan_agent.jinja +87 -0
  368. novacode_cli/prompts/plan_scouts.jinja +5 -0
  369. novacode_cli/prompts/plan_storage.jinja +8 -0
  370. novacode_cli/prompts/planning.jinja +82 -0
  371. novacode_cli/prompts/ponytail/LICENSE +21 -0
  372. novacode_cli/prompts/ponytail/UPSTREAM.json +15 -0
  373. novacode_cli/prompts/ponytail/hooks/ponytail-config.js +175 -0
  374. novacode_cli/prompts/ponytail/hooks/ponytail-instructions.js +98 -0
  375. novacode_cli/prompts/ponytail/skills/ponytail/SKILL.md +52 -0
  376. novacode_cli/prompts/ponytail/skills/ponytail-audit/SKILL.md +103 -0
  377. novacode_cli/prompts/ponytail/skills/ponytail-debt/SKILL.md +44 -0
  378. novacode_cli/prompts/ponytail/skills/ponytail-gain/SKILL.md +52 -0
  379. novacode_cli/prompts/ponytail/skills/ponytail-help/SKILL.md +76 -0
  380. novacode_cli/prompts/ponytail/skills/ponytail-review/SKILL.md +101 -0
  381. novacode_cli/prompts/prompt_evolution.jinja +27 -0
  382. novacode_cli/prompts/ralph_iteration.jinja +75 -0
  383. novacode_cli/prompts/refine_gate.jinja +31 -0
  384. novacode_cli/prompts/refine_plan.jinja +64 -0
  385. novacode_cli/prompts/refine_review.jinja +34 -0
  386. novacode_cli/prompts/research_delivery.jinja +9 -0
  387. novacode_cli/prompts/research_swarm.jinja +130 -0
  388. novacode_cli/prompts/response_style.jinja +5 -0
  389. novacode_cli/prompts/session_summarization.jinja +86 -0
  390. novacode_cli/prompts/skill_creation.jinja +85 -0
  391. novacode_cli/prompts/subagents/fact_checker.jinja +48 -0
  392. novacode_cli/prompts/subagents/financial_analyst.jinja +50 -0
  393. novacode_cli/prompts/subagents/literature_reviewer.jinja +52 -0
  394. novacode_cli/prompts/subagents/market_analyst.jinja +48 -0
  395. novacode_cli/prompts/subagents/research_synthesizer.jinja +57 -0
  396. novacode_cli/prompts/subagents/technical_researcher.jinja +56 -0
  397. novacode_cli/prompts/subagents/web_researcher.jinja +46 -0
  398. novacode_cli/prompts/summarization.jinja +107 -0
  399. novacode_cli/prompts/summarization_answers.jinja +23 -0
  400. novacode_cli/prompts/summarization_questions.jinja +32 -0
  401. novacode_cli/prompts/vision_caption.jinja +21 -0
  402. novacode_cli/prompts/voice_summary.jinja +65 -0
  403. novacode_cli/prompts/wiki_file.jinja +57 -0
  404. novacode_cli/prompts/wiki_ingest.jinja +87 -0
  405. novacode_cli/recovery.py +383 -0
  406. novacode_cli/remote/__init__.py +45 -0
  407. novacode_cli/remote/approvals.py +282 -0
  408. novacode_cli/remote/async_task_clients.py +97 -0
  409. novacode_cli/remote/async_task_watcher.py +240 -0
  410. novacode_cli/remote/bridge.py +905 -0
  411. novacode_cli/remote/command_menu.py +26 -0
  412. novacode_cli/remote/command_ui.py +243 -0
  413. novacode_cli/remote/config.py +199 -0
  414. novacode_cli/remote/discord_bridge.py +530 -0
  415. novacode_cli/remote/discord_format.py +31 -0
  416. novacode_cli/remote/discord_threads.py +225 -0
  417. novacode_cli/remote/images.py +97 -0
  418. novacode_cli/remote/processor.py +601 -0
  419. novacode_cli/remote/rootapp_bot/bot.cjs +16 -0
  420. novacode_cli/remote/rootapp_bot/package-lock.json +2683 -0
  421. novacode_cli/remote/rootapp_bot/package.json +18 -0
  422. novacode_cli/remote/rootapp_bot/transport.cjs +80 -0
  423. novacode_cli/remote/rootapp_bridge.py +370 -0
  424. novacode_cli/remote/rootapp_setup.py +89 -0
  425. novacode_cli/remote/routing.py +103 -0
  426. novacode_cli/remote/scheduler.py +302 -0
  427. novacode_cli/remote/session.py +164 -0
  428. novacode_cli/remote/status.py +411 -0
  429. novacode_cli/remote/streaming.py +188 -0
  430. novacode_cli/remote/telegram_bridge.py +1118 -0
  431. novacode_cli/remote/telegram_format.py +215 -0
  432. novacode_cli/remote/telegram_hub.py +256 -0
  433. novacode_cli/remote/voice_notes.py +120 -0
  434. novacode_cli/remote/webhook_adapters.py +167 -0
  435. novacode_cli/remote/webhook_server.py +154 -0
  436. novacode_cli/rewind.py +150 -0
  437. novacode_cli/rooms/__init__.py +1 -0
  438. novacode_cli/rooms/bridge.py +86 -0
  439. novacode_cli/rooms/cli.py +231 -0
  440. novacode_cli/rooms/nova.py +227 -0
  441. novacode_cli/rooms/runtime.py +299 -0
  442. novacode_cli/rooms/store.py +538 -0
  443. novacode_cli/rooms/workspace.py +94 -0
  444. novacode_cli/security/__init__.py +29 -0
  445. novacode_cli/security/approval_context.py +45 -0
  446. novacode_cli/security/delegated_approval.py +68 -0
  447. novacode_cli/security/local_http.py +85 -0
  448. novacode_cli/security/middleware.py +87 -0
  449. novacode_cli/security/paths.py +35 -0
  450. novacode_cli/security/policy.py +535 -0
  451. novacode_cli/security/policy_writer.py +90 -0
  452. novacode_cli/security/prompt_injection.py +203 -0
  453. novacode_cli/security/remember.py +81 -0
  454. novacode_cli/security/rule_synthesis.py +116 -0
  455. novacode_cli/security/secret_files.py +61 -0
  456. novacode_cli/security/session_allow.py +114 -0
  457. novacode_cli/security/unicode_security.py +516 -0
  458. novacode_cli/security/validator.py +173 -0
  459. novacode_cli/server/__init__.py +9 -0
  460. novacode_cli/server/app.py +632 -0
  461. novacode_cli/server/event_adapter.py +189 -0
  462. novacode_cli/server/session_manager.py +90 -0
  463. novacode_cli/server_main.py +64 -0
  464. novacode_cli/server_runner/dev_server.py +530 -0
  465. novacode_cli/server_runner/test_runner.py +470 -0
  466. novacode_cli/session/__init__.py +1 -0
  467. novacode_cli/session/adapters/__init__.py +240 -0
  468. novacode_cli/session/adapters/claude_code.py +102 -0
  469. novacode_cli/session/adapters/codex.py +77 -0
  470. novacode_cli/session/adapters/harness_native.py +75 -0
  471. novacode_cli/session/checkpoint_coordinator.py +448 -0
  472. novacode_cli/session/context_restore.py +25 -0
  473. novacode_cli/session/history_export.py +228 -0
  474. novacode_cli/session/history_tree.py +174 -0
  475. novacode_cli/session/imported_context.py +267 -0
  476. novacode_cli/session/runtime_identity.py +32 -0
  477. novacode_cli/session/session_persistence.py +1168 -0
  478. novacode_cli/session/session_prompt_builder.py +279 -0
  479. novacode_cli/session/session_restore.py +351 -0
  480. novacode_cli/session/session_summarization.py +20 -0
  481. novacode_cli/session/transcript_journal.py +153 -0
  482. novacode_cli/sessions/__init__.py +11 -0
  483. novacode_cli/sessions/gateway.py +84 -0
  484. novacode_cli/sessions/launch.py +51 -0
  485. novacode_cli/sessions/lease.py +213 -0
  486. novacode_cli/sessions/messaging.py +255 -0
  487. novacode_cli/sessions/protocol.py +216 -0
  488. novacode_cli/sessions/resume.py +31 -0
  489. novacode_cli/sessions/supervisor.py +498 -0
  490. novacode_cli/sessions/tasks.py +73 -0
  491. novacode_cli/sessions/tui_messaging.py +413 -0
  492. novacode_cli/sessions/worker.py +652 -0
  493. novacode_cli/sessions/worktree.py +262 -0
  494. novacode_cli/shell/__init__.py +27 -0
  495. novacode_cli/shell/jobs.py +475 -0
  496. novacode_cli/shell/middleware.py +1568 -0
  497. novacode_cli/shell/os_sandbox.py +205 -0
  498. novacode_cli/shell/output.py +181 -0
  499. novacode_cli/shell/patterns.py +275 -0
  500. novacode_cli/shell/processes.py +87 -0
  501. novacode_cli/shell/utils.py +236 -0
  502. novacode_cli/skills/__init__.py +26 -0
  503. novacode_cli/skills/builtin/handoff/SKILL.md +15 -0
  504. novacode_cli/skills/curation_middleware.py +69 -0
  505. novacode_cli/skills/executable.py +161 -0
  506. novacode_cli/skills/libraries.py +102 -0
  507. novacode_cli/skills/load.py +248 -0
  508. novacode_cli/skills/prune.py +215 -0
  509. novacode_cli/skills/refreshing_middleware.py +896 -0
  510. novacode_cli/skills/retrieval.py +248 -0
  511. novacode_cli/skills/runtime.py +118 -0
  512. novacode_cli/skills/schema.py +254 -0
  513. novacode_cli/skills/skill_creation.py +1549 -0
  514. novacode_cli/skills/skill_lock.py +75 -0
  515. novacode_cli/skills/skill_system_prompt.py +16 -0
  516. novacode_cli/skills/skills_prefs.py +126 -0
  517. novacode_cli/skills/tool_resolver.py +31 -0
  518. novacode_cli/skills/upstream.py +50 -0
  519. novacode_cli/skills/versioning.py +291 -0
  520. novacode_cli/states/Session.py +847 -0
  521. novacode_cli/states/__init__.py +31 -0
  522. novacode_cli/states/slices/__init__.py +17 -0
  523. novacode_cli/states/slices/agent_runtime.py +249 -0
  524. novacode_cli/states/slices/background_tasks.py +21 -0
  525. novacode_cli/states/slices/notifications.py +74 -0
  526. novacode_cli/states/slices/remote_bridge.py +56 -0
  527. novacode_cli/states/slices/ui_settings.py +49 -0
  528. novacode_cli/states/slices/wiki.py +25 -0
  529. novacode_cli/teammates/__init__.py +1 -0
  530. novacode_cli/teammates/controller.py +557 -0
  531. novacode_cli/teammates/graph.py +104 -0
  532. novacode_cli/teammates/registry.py +175 -0
  533. novacode_cli/teammates/service.py +254 -0
  534. novacode_cli/teammates/worker.py +19 -0
  535. novacode_cli/teams/__init__.py +1 -0
  536. novacode_cli/teams/adapters/__init__.py +1 -0
  537. novacode_cli/teams/adapters/container.py +316 -0
  538. novacode_cli/teams/adapters/inprocess.py +206 -0
  539. novacode_cli/teams/adapters/process.py +364 -0
  540. novacode_cli/teams/bootstrap.py +246 -0
  541. novacode_cli/teams/container_git.py +67 -0
  542. novacode_cli/teams/context.py +34 -0
  543. novacode_cli/teams/coordinator.py +815 -0
  544. novacode_cli/teams/gateway.py +200 -0
  545. novacode_cli/teams/host.py +64 -0
  546. novacode_cli/teams/legacy.py +52 -0
  547. novacode_cli/teams/middleware.py +176 -0
  548. novacode_cli/teams/models.py +104 -0
  549. novacode_cli/teams/output.py +47 -0
  550. novacode_cli/teams/protocol.py +50 -0
  551. novacode_cli/teams/recovery.py +80 -0
  552. novacode_cli/teams/scheduler.py +44 -0
  553. novacode_cli/teams/store.py +631 -0
  554. novacode_cli/teams/worker.py +251 -0
  555. novacode_cli/teams/workspace.py +100 -0
  556. novacode_cli/token_utils.py +256 -0
  557. novacode_cli/tools/__init__.py +104 -0
  558. novacode_cli/tools/_shared.py +97 -0
  559. novacode_cli/tools/_types.py +24 -0
  560. novacode_cli/tools/artifact_tools.py +137 -0
  561. novacode_cli/tools/code_search_tools.py +330 -0
  562. novacode_cli/tools/computer_tools.py +77 -0
  563. novacode_cli/tools/cron_tools.py +65 -0
  564. novacode_cli/tools/daemon_tool.py +290 -0
  565. novacode_cli/tools/desktop_tools.py +161 -0
  566. novacode_cli/tools/fetch_tools.py +530 -0
  567. novacode_cli/tools/http_tools.py +279 -0
  568. novacode_cli/tools/inspection_tools.py +107 -0
  569. novacode_cli/tools/job_tools.py +143 -0
  570. novacode_cli/tools/knowledge_tools.py +427 -0
  571. novacode_cli/tools/memory_tools.py +461 -0
  572. novacode_cli/tools/memory_wiki_tools.py +40 -0
  573. novacode_cli/tools/notebook_tools.py +238 -0
  574. novacode_cli/tools/oracle_tool.py +83 -0
  575. novacode_cli/tools/plan_archive_tools.py +80 -0
  576. novacode_cli/tools/plan_mode_tools.py +315 -0
  577. novacode_cli/tools/python_kernel_loop.py +165 -0
  578. novacode_cli/tools/python_kernel_tool.py +222 -0
  579. novacode_cli/tools/reflection_tools.py +34 -0
  580. novacode_cli/tools/scraper_tools.py +377 -0
  581. novacode_cli/tools/skill_tools.py +275 -0
  582. novacode_cli/tools/speak_tool.py +51 -0
  583. novacode_cli/tools/store_memory_tools.py +227 -0
  584. novacode_cli/tools/ui_tools.py +62 -0
  585. novacode_cli/tools/waiter_tools.py +408 -0
  586. novacode_cli/tools/web_tools.py +349 -0
  587. novacode_cli/tools/wiki_tools.py +152 -0
  588. novacode_cli/tools/worktree_tools.py +219 -0
  589. novacode_cli/tracking/__init__.py +10 -0
  590. novacode_cli/tracking/file_tracker.py +826 -0
  591. novacode_cli/tracking/local_metrics.py +170 -0
  592. novacode_cli/tracking/loop_guard.py +507 -0
  593. novacode_cli/tracking/request_metrics.py +60 -0
  594. novacode_cli/tracking/tracing.py +692 -0
  595. novacode_cli/tracking/usage_tree.py +677 -0
  596. novacode_cli/tracking/workspace_anchoring.py +231 -0
  597. novacode_cli/tui/__init__.py +11 -0
  598. novacode_cli/tui/animation_rate.py +9 -0
  599. novacode_cli/tui/animations.py +332 -0
  600. novacode_cli/tui/app.py +19315 -0
  601. novacode_cli/tui/auth_display.py +87 -0
  602. novacode_cli/tui/auth_screens.py +826 -0
  603. novacode_cli/tui/avatar.py +294 -0
  604. novacode_cli/tui/avatar_frames.py +21 -0
  605. novacode_cli/tui/background_tasks.py +35 -0
  606. novacode_cli/tui/browser_settings_screen.py +70 -0
  607. novacode_cli/tui/caveman_screen.py +185 -0
  608. novacode_cli/tui/council_settings_screen.py +182 -0
  609. novacode_cli/tui/council_view.py +535 -0
  610. novacode_cli/tui/decision_settings.py +268 -0
  611. novacode_cli/tui/diff_preview.py +199 -0
  612. novacode_cli/tui/gc_tuning.py +63 -0
  613. novacode_cli/tui/handoff_screen.py +206 -0
  614. novacode_cli/tui/harness.py +244 -0
  615. novacode_cli/tui/history_tree_screen.py +179 -0
  616. novacode_cli/tui/home.py +328 -0
  617. novacode_cli/tui/home_scene.py +94 -0
  618. novacode_cli/tui/icons.py +81 -0
  619. novacode_cli/tui/interface_styles.tcss +327 -0
  620. novacode_cli/tui/matrix3.py +108 -0
  621. novacode_cli/tui/mcp_tools_screen.py +131 -0
  622. novacode_cli/tui/motion.py +178 -0
  623. novacode_cli/tui/output_body.py +136 -0
  624. novacode_cli/tui/output_buffer.py +59 -0
  625. novacode_cli/tui/palette.py +334 -0
  626. novacode_cli/tui/pickers.py +237 -0
  627. novacode_cli/tui/prime_panel.py +506 -0
  628. novacode_cli/tui/provider_signin.py +213 -0
  629. novacode_cli/tui/pty_shell.py +159 -0
  630. novacode_cli/tui/reference_screens.py +444 -0
  631. novacode_cli/tui/resume_picker.py +346 -0
  632. novacode_cli/tui/rooms.py +597 -0
  633. novacode_cli/tui/screens.py +7088 -0
  634. novacode_cli/tui/session_import.py +333 -0
  635. novacode_cli/tui/session_pane.py +242 -0
  636. novacode_cli/tui/session_tab.py +42 -0
  637. novacode_cli/tui/session_transcript.py +118 -0
  638. novacode_cli/tui/shell_output.py +7 -0
  639. novacode_cli/tui/stall_watch.py +174 -0
  640. novacode_cli/tui/statusline.py +40 -0
  641. novacode_cli/tui/statusline_screen.py +91 -0
  642. novacode_cli/tui/teammate_updates.py +162 -0
  643. novacode_cli/tui/teammates.py +548 -0
  644. novacode_cli/tui/terminal.py +289 -0
  645. novacode_cli/tui/terminal_view.py +235 -0
  646. novacode_cli/tui/themes.py +118 -0
  647. novacode_cli/tui/update_notice.py +84 -0
  648. novacode_cli/tui/voice_downloads.py +113 -0
  649. novacode_cli/tui/widgets.py +2038 -0
  650. novacode_cli/tui/windows_input.py +38 -0
  651. novacode_cli/tui/workspace_approval.py +165 -0
  652. novacode_cli/ui/council_web.py +113 -0
  653. novacode_cli/ui/council_workspace.py +72 -0
  654. novacode_cli/ui/cowork_web.py +41 -0
  655. novacode_cli/ui/diff_highlight.py +160 -0
  656. novacode_cli/ui/execution.py +1396 -0
  657. novacode_cli/ui/exit_summary.py +65 -0
  658. novacode_cli/ui/hitl_approval.py +196 -0
  659. novacode_cli/ui/input_preparation.py +2 -0
  660. novacode_cli/ui/interrupt_handlers.py +215 -0
  661. novacode_cli/ui/question_prompt.py +151 -0
  662. novacode_cli/ui/status_phrases.py +157 -0
  663. novacode_cli/ui/stream_preview.py +66 -0
  664. novacode_cli/ui/streaming.py +2 -0
  665. novacode_cli/ui/subagent_tracking.py +2 -0
  666. novacode_cli/ui/ui_elements.py +1585 -0
  667. novacode_cli/ui/web_workspace.py +244 -0
  668. novacode_cli/ui_events.py +299 -0
  669. novacode_cli/update_ui.py +243 -0
  670. novacode_cli/updates.py +489 -0
  671. novacode_cli/utils/backend_patches.py +399 -0
  672. novacode_cli/utils/backend_paths.py +467 -0
  673. novacode_cli/utils/lazy_providers.py +51 -0
  674. novacode_cli/utils/model_info.py +223 -0
  675. novacode_cli/utils/pdf_extraction.py +183 -0
  676. novacode_cli/utils/startup.py +29 -0
  677. novacode_cli/utils/tasks.py +42 -0
  678. novacode_cli/utils/windows.py +9 -0
  679. novacode_cli/vixie/hook_adapter.py +127 -0
  680. novacode_cli/vixie/server.py +375 -0
  681. novacode_cli/wiki/__init__.py +15 -0
  682. novacode_cli/wiki/ask.py +56 -0
  683. novacode_cli/wiki/file.py +71 -0
  684. novacode_cli/wiki/ingest.py +184 -0
  685. novacode_cli/wiki/manager.py +261 -0
  686. novacode_cli-1.2.0.dist-info/METADATA +271 -0
  687. novacode_cli-1.2.0.dist-info/RECORD +691 -0
  688. novacode_cli-1.2.0.dist-info/WHEEL +5 -0
  689. novacode_cli-1.2.0.dist-info/entry_points.txt +2 -0
  690. novacode_cli-1.2.0.dist-info/licenses/LICENSE +21 -0
  691. novacode_cli-1.2.0.dist-info/top_level.txt +1 -0
@@ -0,0 +1,159 @@
1
+ """Bounded, process-local reuse of deterministic JSON values.
2
+
3
+ Only serialized bytes are retained; callers always receive defensive copies.
4
+ No tools, permissions, model objects, or provider responses belong here.
5
+ """
6
+
7
+ from __future__ import annotations
8
+
9
+ import atexit
10
+ import hashlib
11
+ import json
12
+ import os
13
+ import sys
14
+ from collections import OrderedDict
15
+ from contextlib import suppress
16
+ from threading import RLock
17
+ from typing import cast
18
+
19
+ ENTRY_LIMIT = 256
20
+ CACHE_BYTES = 8 * 1024 * 1024
21
+ PROCESS_BYTES = 32 * 1024 * 1024
22
+ _LOCK = RLock()
23
+ _ENTRIES: OrderedDict[tuple[str, str], bytes] = OrderedDict()
24
+ _NAMESPACES: dict[str, OrderedDict[str, None]] = {}
25
+ _BYTES: dict[str, int] = {}
26
+ _RETAINED_BYTES = 0
27
+ _STATS: dict[str, dict[str, int]] = {}
28
+
29
+
30
+ def digest(content: str | bytes) -> str:
31
+ """Hash content without retaining it as a cache key."""
32
+ return hashlib.sha256(
33
+ content.encode("utf-8") if isinstance(content, str) else content
34
+ ).hexdigest()
35
+
36
+
37
+ def _event(namespace: str, outcome: str) -> None:
38
+ stats = _STATS.setdefault(namespace, {})
39
+ stats[outcome] = stats.get(outcome, 0) + 1
40
+ if os.environ.get("NOVA_LOCAL_METRICS") == "1":
41
+ with suppress(OSError, ValueError):
42
+ sys.stderr.write(
43
+ json.dumps(
44
+ {
45
+ "nova_cache_metrics": {
46
+ "cache": namespace,
47
+ "outcome": outcome,
48
+ "entries": len(_ENTRIES),
49
+ "retained_bytes": _RETAINED_BYTES,
50
+ "validation_ns": stats.get("validation_ns", 0),
51
+ "computation_ns": stats.get("computation_ns", 0),
52
+ }
53
+ }
54
+ )
55
+ + "\n"
56
+ )
57
+
58
+
59
+ def record_timing(namespace: str, phase: str, elapsed_ns: int) -> None:
60
+ """Accumulate numeric validation/computation time without retaining inputs."""
61
+ with _LOCK:
62
+ stats = _STATS.setdefault(namespace, {})
63
+ stats[phase + "_ns"] = stats.get(phase + "_ns", 0) + elapsed_ns
64
+
65
+
66
+ def get(namespace: str, key: str) -> object | None:
67
+ """Read a defensive copy, or miss when explicitly disabled."""
68
+ with _LOCK:
69
+ if os.environ.get("NOVA_DISABLE_COMPUTATION_CACHE") == "1":
70
+ return None
71
+ payload = _ENTRIES.get((namespace, key))
72
+ _event(namespace, "miss" if payload is None else "hit")
73
+ if payload is None:
74
+ return None
75
+ _ENTRIES.move_to_end((namespace, key))
76
+ _NAMESPACES[namespace].move_to_end(key)
77
+ # Immutable bytes remain valid across eviction; decoding a defensive copy
78
+ # must not hold the shared lock while other sessions access their caches.
79
+ return cast("object", json.loads(payload))
80
+
81
+
82
+ def _remove(namespace: str, key: str) -> None:
83
+ """Update both LRU orders and byte accounting while the caller holds the lock."""
84
+ global _RETAINED_BYTES # noqa: PLW0603
85
+ payload = _ENTRIES.pop((namespace, key))
86
+ _RETAINED_BYTES -= len(payload)
87
+ _BYTES[namespace] -= len(payload)
88
+ del _NAMESPACES[namespace][key]
89
+ if not _NAMESPACES[namespace]:
90
+ del _NAMESPACES[namespace]
91
+ del _BYTES[namespace]
92
+
93
+
94
+ def put(namespace: str, key: str, value: object) -> None:
95
+ """Retain JSON data within both namespace and shared process budgets."""
96
+ global _RETAINED_BYTES # noqa: PLW0603
97
+ if os.environ.get("NOVA_DISABLE_COMPUTATION_CACHE") == "1":
98
+ return
99
+ try:
100
+ payload = json.dumps(value, ensure_ascii=False, allow_nan=False).encode("utf-8")
101
+ # JSON must preserve the value exactly (e.g. reject tuples/non-string keys).
102
+ if json.loads(payload) != value:
103
+ return
104
+ except (TypeError, ValueError):
105
+ return
106
+ if len(payload) > CACHE_BYTES:
107
+ return
108
+ with _LOCK:
109
+ if (namespace, key) in _ENTRIES:
110
+ _remove(namespace, key)
111
+ _ENTRIES[namespace, key] = payload
112
+ _NAMESPACES.setdefault(namespace, OrderedDict())[key] = None
113
+ _BYTES[namespace] = _BYTES.get(namespace, 0) + len(payload)
114
+ _RETAINED_BYTES += len(payload)
115
+ while namespace in _NAMESPACES and (
116
+ len(_NAMESPACES[namespace]) > ENTRY_LIMIT or _BYTES[namespace] > CACHE_BYTES
117
+ ):
118
+ _remove(namespace, next(iter(_NAMESPACES[namespace])))
119
+ _event(namespace, "eviction")
120
+ while _RETAINED_BYTES > PROCESS_BYTES:
121
+ victim_namespace, victim_key = next(iter(_ENTRIES))
122
+ _remove(victim_namespace, victim_key)
123
+ _event(victim_namespace, "eviction")
124
+
125
+
126
+ def clear(namespace: str | None = None) -> None:
127
+ """Explicit configuration/workspace invalidation and process teardown."""
128
+ with _LOCK:
129
+ keys = (
130
+ list(_ENTRIES)
131
+ if namespace is None
132
+ else [(namespace, key) for key in _NAMESPACES.get(namespace, {})]
133
+ )
134
+ for owner, key in keys:
135
+ _remove(owner, key)
136
+ if namespace is None:
137
+ _STATS.clear()
138
+ else:
139
+ _STATS.pop(namespace, None)
140
+
141
+
142
+ def snapshot() -> dict[str, object]:
143
+ """Content-free counters and actual retained serialized payload size."""
144
+ with _LOCK:
145
+ return {
146
+ "entries": len(_ENTRIES),
147
+ "retained_bytes": _RETAINED_BYTES,
148
+ "caches": {
149
+ name: {
150
+ **_STATS.get(name, {}),
151
+ "entries": len(_NAMESPACES.get(name, {})),
152
+ "retained_bytes": _BYTES.get(name, 0),
153
+ }
154
+ for name in dict.fromkeys([*_STATS, *_NAMESPACES])
155
+ },
156
+ }
157
+
158
+
159
+ atexit.register(clear)
@@ -0,0 +1 @@
1
+ """Opt-in local Linux computers owned by Nova sessions."""
@@ -0,0 +1,234 @@
1
+ """Retained, explicitly owned local computers for background teammates."""
2
+ # ruff: noqa: ANN401, EM101, TRY003
3
+
4
+ from __future__ import annotations
5
+
6
+ import asyncio
7
+ import importlib
8
+ import json
9
+ import re
10
+ from typing import TYPE_CHECKING, Any
11
+
12
+ from novacode_cli.computer.runtime import Computer, ComputerError, _prepare_qemu_path
13
+ from novacode_cli.security.secret_files import write_secret_json
14
+
15
+ if TYPE_CHECKING:
16
+ from pathlib import Path
17
+
18
+
19
+ class PersistentComputer(Computer):
20
+ """Keep a teammate's guest across controller lifetimes."""
21
+
22
+ def __init__(self, manifest: Path, owner: str) -> None:
23
+ """Bind an owner-checked manifest before any VM operation."""
24
+ super().__init__()
25
+ self.manifest, self.owner = manifest, owner
26
+ self._manual = False
27
+ self._deleting = False
28
+ if manifest.exists():
29
+ record = json.loads(manifest.read_text(encoding="utf-8"))
30
+ if record.get("owner") != owner:
31
+ raise ComputerError("Computer manifest belongs to another owner")
32
+ if not re.fullmatch(r"nova-[0-9a-f]{16}", str(record.get("name", ""))):
33
+ raise ComputerError("Invalid retained computer identity")
34
+ self._name = record["name"]
35
+ self._deleting = record.get("deleting") is True
36
+
37
+ async def _create_guest(self, options: Any) -> Any:
38
+ options.keep_on_failure = True
39
+ self.manifest.parent.mkdir(parents=True, exist_ok=True)
40
+ write_secret_json(self.manifest, {"owner": self.owner, "name": self._name})
41
+ return await super()._create_guest(options)
42
+
43
+ async def _cleanup_guest(self) -> None:
44
+ """Startup failures must retain an existing computer and its recovery identity."""
45
+
46
+ def _verify_owned(self, guest: Any) -> None:
47
+ self._verify_info(guest.info())
48
+
49
+ def _verify_info(self, info: Any) -> None:
50
+ if (info.name, info.location, info.kind, info.runtime) != (
51
+ self._name,
52
+ "local",
53
+ "vm",
54
+ "qemu",
55
+ ):
56
+ raise ComputerError("Retained computer identity does not match its owner")
57
+
58
+ async def _connect_owned(self) -> Any:
59
+ _prepare_qemu_path()
60
+ self._sdk = importlib.import_module("cua")
61
+ self._client = self._sdk.embedded()
62
+ info = await self._client.sandboxes().get("local:" + self._name)
63
+ self._verify_info(info)
64
+ # Cua 0.9.0 connect refuses Paused/Stopped sandboxes. Its supported
65
+ # power API resumes/boots by ref before a fresh handle can attach.
66
+ if getattr(info.status, "name", "") in {"SUSPENDED", "STOPPED"}:
67
+ await self._client.spaces().start("local:" + self._name)
68
+ guest = await self._client.sandboxes().connect("local:" + self._name)
69
+ self._verify_owned(guest)
70
+ return guest
71
+
72
+ async def _start(self) -> dict:
73
+ if self._deleting:
74
+ raise ComputerError("Computer deletion is incomplete; retry Delete")
75
+ if self._phase == "ready":
76
+ return self._status()
77
+ if self._starting is not None:
78
+ raise ComputerError("Computer is already starting")
79
+ if self._name is None:
80
+ return await super()._start()
81
+ self._phase = "starting"
82
+ self._starting = asyncio.current_task()
83
+ try:
84
+ from novacode_cli.computer.windows_console import background_guest
85
+
86
+ async with background_guest(self._name):
87
+ self._guest = guest = await self._connect_owned()
88
+ await guest.resume()
89
+ self._desktop = await guest.spacesd(30_000)
90
+ self._paused = False
91
+ self._manual = False
92
+ self._observation = None
93
+ await self._capture(observe=False)
94
+ self._phase, self._stage, self._error = "ready", "Retained desktop ready", ""
95
+ return self._status()
96
+ except BaseException as exc:
97
+ self._phase, self._error = "error", str(exc)
98
+ self._desktop = None
99
+ raise
100
+ finally:
101
+ self._starting = None
102
+
103
+ async def _stop(self) -> dict:
104
+ self._paused = True
105
+ self._observation = None
106
+ if self._starting is not None:
107
+ # Do not race create/suspend or delete a half-created persistent guest.
108
+ raise ComputerError("Computer is still starting; wait before stopping")
109
+ async with self._input_lock:
110
+ if self._name and self._guest is None:
111
+ self._sdk = importlib.import_module("cua")
112
+ self._client = self._sdk.embedded()
113
+ info = await self._client.sandboxes().get("local:" + self._name)
114
+ self._verify_info(info)
115
+ if getattr(info.status, "name", "") not in {"SUSPENDED", "STOPPED"}:
116
+ await self._client.spaces().stop("local:" + self._name)
117
+ if self._guest is not None and self._phase != "suspended":
118
+ try:
119
+ await self._guest.suspend()
120
+ except BaseException as exc:
121
+ self._phase, self._error = "error", str(exc)
122
+ raise
123
+ self._manual = False
124
+ self._desktop = None
125
+ self._phase = "suspended" if self._name else "stopped"
126
+ self._stage = "Computer retained; resume to continue"
127
+ return self._status()
128
+
129
+ def _status(self) -> dict:
130
+ return {
131
+ **super()._status(),
132
+ "persistent": True,
133
+ "manual_control": self._manual,
134
+ "manual": self._manual,
135
+ }
136
+
137
+ @property
138
+ def manual(self) -> bool:
139
+ """Whether the owner holds input independently of task state."""
140
+ return self._manual
141
+
142
+ async def _delete_owned(self) -> dict:
143
+ if self._starting is not None:
144
+ raise ComputerError("Computer is still starting")
145
+ async with self._input_lock:
146
+ self._paused = True
147
+ if self._name:
148
+ self._sdk = importlib.import_module("cua")
149
+ self._client = self._sdk.embedded()
150
+ try:
151
+ if self._guest is None:
152
+ info = await self._client.sandboxes().get("local:" + self._name)
153
+ self._verify_info(info)
154
+ else:
155
+ self._verify_owned(self._guest)
156
+ write_secret_json(
157
+ self.manifest,
158
+ {
159
+ "owner": self.owner,
160
+ "name": self._name,
161
+ "deleting": True,
162
+ },
163
+ )
164
+ self._deleting = True
165
+ if self._guest is None:
166
+ await self._client.sandboxes().delete("local:" + self._name)
167
+ else:
168
+ await self._guest.delete()
169
+ except self._sdk.CuaError.NotFound:
170
+ if not self._deleting:
171
+ raise
172
+ self._guest = None
173
+ self._name = None
174
+ self.manifest.unlink(missing_ok=True)
175
+ self._desktop = self._observation = None
176
+ self._manual = False
177
+ self._frame = b""
178
+ self._phase, self._stage = "stopped", "Computer deleted"
179
+ return self._status()
180
+
181
+ async def _dispatch(self, operation: str, arguments: dict) -> Any:
182
+ operation = {
183
+ "takeover": "take_control",
184
+ "return_control": "release_control",
185
+ "manual_action": "owner_action",
186
+ }.get(operation, operation)
187
+ if operation == "resume" and self._manual:
188
+ raise ComputerError("Return Control explicitly before resuming agent input")
189
+ if operation == "approval_frame":
190
+ async with self._input_lock:
191
+ shot = self._observation
192
+ if shot is None or shot.screenshot_id != arguments.get("screenshot_id"):
193
+ raise ComputerError("Take a fresh screenshot before proposing input")
194
+ return bytes(shot.image)
195
+ if operation == "delete":
196
+ return await self._delete_owned()
197
+ if operation == "take_control":
198
+ self._paused = True
199
+ async with self._input_lock:
200
+ self._manual = True
201
+ self._observation = None
202
+ return self._status()
203
+ if operation == "release_control":
204
+ async with self._input_lock:
205
+ self._manual = False
206
+ self._paused = False
207
+ self._observation = None
208
+ return self._status()
209
+ if operation == "owner_action":
210
+ async with self._input_lock:
211
+ if not self._manual or self._desktop is None:
212
+ raise ComputerError("Take manual control before sending input")
213
+ from novacode_cli.tools.computer_tools import ComputerActionInput
214
+
215
+ await self._capture(observe=True)
216
+ width = arguments.pop("frame_width", None)
217
+ height = arguments.pop("frame_height", None)
218
+ if width is not None and (width, height) != (
219
+ self._observation.width,
220
+ self._observation.height,
221
+ ):
222
+ raise ComputerError("Display dimensions changed; wait for a fresh preview")
223
+ validated = ComputerActionInput.model_validate(
224
+ {**arguments, "screenshot_id": self._observation.screenshot_id}
225
+ )
226
+ self._paused = False
227
+ try:
228
+ await self._act(**validated.model_dump())
229
+ await self._capture(observe=False)
230
+ finally:
231
+ self._paused = True
232
+ self._observation = None
233
+ return self._status()
234
+ return await super()._dispatch(operation, arguments)
@@ -0,0 +1,253 @@
1
+ """A private, demand-driven desktop preview on loopback."""
2
+ # ruff: noqa: E501
3
+ # Standalone HTML/JS lives inline, matching Nova's other loopback viewers.
4
+
5
+ from __future__ import annotations
6
+
7
+ import json
8
+ import secrets
9
+ import threading
10
+ from http.server import ThreadingHTTPServer
11
+ from typing import TYPE_CHECKING
12
+ from urllib.parse import urlencode
13
+
14
+ from novacode_cli.security.local_http import LocalRequestHandler, secure_html
15
+
16
+ MAX_MANUAL_INPUT_BYTES = 64_000
17
+
18
+ if TYPE_CHECKING:
19
+ from novacode_cli.computer.runtime import Computer
20
+
21
+ HTML = """<!doctype html><html lang="en"><head><meta charset="utf-8">
22
+ <meta name="viewport" content="width=device-width,initial-scale=1">
23
+ <title>Nova · Computer</title><style>
24
+ :root{color-scheme:dark;--bg:#111923;--surface:#182331;--canvas:#090e15;--line:#2d3d50;--text:#edf3fa;--muted:#9eafc0;--accent:#91b8ff;--warning:#f1cf90;--danger:#efabac;
25
+ font:14px/1.6 'Segoe UI Variable','Segoe UI',sans-serif;background:var(--bg);color:var(--text)}
26
+ *{box-sizing:border-box}[hidden]{display:none!important}body{margin:0}::selection{background:var(--accent);color:var(--canvas)}
27
+ header{max-width:1600px;margin:auto;padding:28px 32px 24px;display:flex;align-items:center;justify-content:space-between;gap:24px;flex-wrap:wrap}
28
+ .identity{display:flex;align-items:center;gap:18px}.brand{font-weight:650;color:var(--accent);border-right:1px solid var(--line);padding-right:18px;font-size:17px}
29
+ h1{font:600 24px/1.25 'Segoe UI Variable Display','Segoe UI',sans-serif;letter-spacing:-.025em;margin:0 0 4px}
30
+ h2{font-size:15px;line-height:1.4;font-weight:600;margin:0 0 12px}p{margin:0 0 16px}small,.hint{color:var(--muted)}
31
+ nav{display:flex;gap:8px;flex-wrap:wrap}button,input{font:inherit;border-radius:7px;min-height:40px}
32
+ button{cursor:pointer;padding:8px 14px;border:1px solid var(--line);background:var(--surface);color:var(--text);font-weight:600;transition:background .15s,border-color .15s}
33
+ button:hover:not(:disabled){border-color:var(--accent);background:#223449}button:focus-visible,input:focus-visible,summary:focus-visible{outline:2px solid var(--accent);outline-offset:3px}
34
+ button:disabled{color:#708296;cursor:default}#stop{color:var(--danger)}#takeover{background:var(--accent);color:var(--canvas);border-color:var(--accent)}
35
+ body[data-retained="true"] #stop{color:var(--text)}
36
+ main{max-width:1600px;padding:0 32px 24px;margin:auto}.workspace{display:grid;grid-template-columns:minmax(0,1fr) 288px;gap:24px;align-items:start}
37
+ .viewer{min-width:0;border:1px solid var(--line);border-radius:12px;overflow:hidden;background:var(--canvas)}
38
+ .viewer-bar{display:flex;align-items:center;justify-content:space-between;gap:12px;padding:12px 16px;background:var(--surface);border-bottom:1px solid var(--line)}
39
+ .viewer-label{color:var(--muted);font-size:12px}.status{display:flex;align-items:center;gap:8px}
40
+ #state{font:12px/1.5 'Cascadia Code',Consolas,monospace;text-transform:capitalize;color:var(--accent)}
41
+ .status:before{content:'';width:6px;height:6px;border-radius:50%;background:var(--accent)}
42
+ #notice{padding:10px 16px;color:var(--muted);border-top:1px solid var(--line);font-size:12px;overflow-wrap:anywhere;min-height:40px}
43
+ .desktop{min-height:400px;display:grid;place-items:center;overflow:hidden;padding:8px}
44
+ #screen{display:block;max-width:100%;width:auto;height:auto;max-height:calc(100dvh - 230px);object-fit:contain}
45
+ #empty{max-width:38ch;padding:64px 24px;text-align:center;color:var(--muted)}
46
+ body[data-control="manual"] .viewer{border-color:var(--accent)}body[data-control="manual"] #screen{cursor:crosshair}
47
+ aside{padding:6px 0}.rail-section{padding:0 0 24px;margin-bottom:24px;border-bottom:1px solid var(--line)}
48
+ .rail-section:last-child{border-bottom:0;margin-bottom:0}.control-heading{display:flex;align-items:baseline;justify-content:space-between;gap:8px}
49
+ #control-owner{color:var(--accent);font-size:12px}#takeover,#return_control{width:100%;margin-bottom:20px}
50
+ #takeover-controls label{display:block;font-weight:600;margin:18px 0 6px}.input-row{display:flex;gap:8px;align-items:start}
51
+ input{color:var(--text);background:var(--canvas);border:1px solid var(--line);padding:8px 10px;width:100%;min-width:0}
52
+ input:disabled{color:#708296}input::placeholder{color:var(--muted)}.input-row button{flex:none}.field-hint{font-size:12px;color:var(--muted);margin:6px 0 0}
53
+ .specs{display:grid;grid-template-columns:1fr 1fr;gap:10px;font-size:12px;color:var(--muted)}.specs strong{display:block;color:var(--text);font-weight:500;font-size:14px}
54
+ #approval-indicator{color:var(--muted);font-size:13px}#approval-indicator.waiting{color:var(--warning)}
55
+ #approval-observation{margin-top:16px;border:1px solid var(--line);border-radius:10px;overflow:hidden}
56
+ summary{padding:14px 16px;cursor:pointer;color:var(--warning);font-weight:600}#approval-observation p{padding:0 16px;color:var(--muted);font-size:13px}
57
+ #approval-screen{display:block;max-width:100%;height:auto;margin:auto}footer{color:var(--muted);font-size:12px;padding-top:18px;max-width:100ch}
58
+ code{font-family:'Cascadia Code',Consolas,monospace;color:var(--text)}
59
+ @media(max-width:900px){.workspace{grid-template-columns:minmax(0,1fr)}aside{display:grid;grid-template-columns:1fr 1fr;gap:24px}.desktop{min-height:280px}#screen{max-height:65dvh}}
60
+ @media(max-width:600px){header{padding:20px 16px;gap:16px}.identity{gap:12px}.brand{padding-right:12px}h1{font-size:22px}main{padding:0 16px 20px}nav{width:100%}nav button{flex:1;min-height:44px}aside{display:block}.desktop{min-height:230px}.input-row input,.input-row button{min-height:44px}.viewer-label{display:none}}
61
+ @media(prefers-reduced-motion:reduce){button{transition:none}}
62
+ /* A desktop console: the guest is the focal surface, controls stay quiet. */
63
+ :root{--bg:#101720;--surface:#1b2633;--canvas:#080d13;--line:#344252;--text:#eef3f8;--muted:#a7b7c8;--accent:#a9c8fb}
64
+ header{padding:22px 32px;max-width:1800px}.brand{font-size:20px;letter-spacing:-.05em}
65
+ h1{font-size:21px}header small{font-size:12px}nav button{background:transparent;min-height:36px;font-size:12px}
66
+ main{max-width:1800px}.workspace{grid-template-columns:minmax(0,1fr) 276px;gap:28px}
67
+ .viewer{border-radius:10px;box-shadow:0 16px 48px #0003}.viewer-bar{padding:10px 16px;background:#1b2633}
68
+ .viewer-tools{display:flex;align-items:center;gap:16px}.viewer-tools button{min-height:28px;padding:2px 9px;font-size:12px;background:transparent}
69
+ .desktop{height:calc(100dvh - 220px);min-height:360px;padding:18px;background:#080d13}
70
+ #screen{max-height:100%;max-width:100%;box-shadow:0 0 0 1px #ffffff14}
71
+ .viewer:fullscreen{display:flex;flex-direction:column;border:0;border-radius:0;background:var(--canvas)}
72
+ .viewer:fullscreen .desktop{height:auto;min-height:0;flex:1}.viewer:fullscreen #screen{max-height:calc(100dvh - 110px)}
73
+ #empty{max-width:42ch}#empty:before{content:'▣';display:block;font-size:36px;line-height:1;margin-bottom:20px;color:var(--accent)}
74
+ #notice{background:#141e29;min-height:38px}.rail-section{padding-bottom:22px;margin-bottom:22px}
75
+ .control-heading{margin-bottom:8px}.control-heading h2{margin:0}#control-owner{font:11px 'Cascadia Code',Consolas,monospace}
76
+ aside p.hint{font-size:13px}#takeover,#return_control{margin:2px 0 8px;min-height:44px}
77
+ #return_control{border-color:var(--accent);color:var(--accent)}
78
+ .specs{gap:16px 12px}.specs strong{font-family:'Cascadia Code',Consolas,monospace;font-size:12px;margin-top:3px}
79
+ #approval-observation{border-left:3px solid var(--warning);border-radius:6px;background:#1b2633}
80
+ body[data-connected="false"] .status:before{background:var(--warning)}
81
+ body[data-connected="false"] #state{color:var(--warning)}
82
+ footer{font-size:11px;padding-top:16px}
83
+ @media(min-width:1600px){.desktop{height:calc(100dvh - 230px)}}
84
+ @media(max-width:900px){.workspace{grid-template-columns:minmax(0,1fr)}.desktop{height:60dvh;min-height:280px}aside{padding-top:4px}}
85
+ @media(max-width:600px){header{padding:18px 16px}main{padding:0 16px 20px}.desktop{height:48dvh;min-height:220px;padding:8px}.viewer-tools{gap:8px}nav button{min-height:44px}.viewer-bar{padding:10px 12px}}
86
+ </style></head><body><header><div class="identity"><span class="brand">Nova</span><div>
87
+ <h1>Computer</h1><small>Your private Linux workspace.</small></div></div>
88
+ <nav aria-label="Computer controls"><button id="pause">Pause input</button>
89
+ <button id="resume">Resume input</button><button id="stop">Stop VM</button></nav></header>
90
+ <main><div class="workspace"><div class="display-column"><section class="viewer" aria-label="Live computer preview">
91
+ <div class="viewer-bar"><div class="status" role="status" aria-live="polite"><span id="state">Connecting</span></div><div class="viewer-tools"><span class="viewer-label">Live desktop</span><button id="fullscreen" aria-label="Enter fullscreen preview">Expand</button></div></div>
92
+ <div class="desktop"><img id="screen" alt="Live view of Nova's Linux virtual machine" hidden>
93
+ <div id="empty">Connecting to your computer…</div></div><div id="notice" role="status"></div></section>
94
+ <details id="approval-observation" hidden><summary>Observation awaiting approval</summary>
95
+ <p>This is the exact frame attached to the proposed input. Review it before approving in Nova.</p>
96
+ <img id="approval-screen" alt="Exact desktop observation attached to the pending input proposal"></details></div>
97
+ <aside aria-label="Computer controls and details"><section id="takeover-controls" class="rail-section" hidden aria-label="Manual computer input">
98
+ <div class="control-heading"><h2>Desktop control</h2><span id="control-owner" role="status"></span></div>
99
+ <p class="hint">Take control to use the mouse and keyboard. Your teammate waits until you return control.</p>
100
+ <button id="takeover">Take Control</button><button id="return_control" hidden>Return Control</button>
101
+ <label for="manual-text">Private text</label><div class="input-row">
102
+ <input id="manual-text" type="password" autocomplete="off" placeholder="Text to type in the guest">
103
+ <button id="send-text">Type</button></div><p class="field-hint">Sent to the guest, kept out of input logs.</p>
104
+ <label for="manual-key">Keyboard shortcut</label><div class="input-row">
105
+ <input id="manual-key" autocomplete="off" placeholder="e.g. ctrl,l"><button id="send-key">Send</button></div>
106
+ <p class="field-hint">Separate key names with commas.</p>
107
+ <p class="hint" style="margin-top:20px">Click or scroll on the desktop while you hold control. Return Control, then Resume in Nova. Closing this page leaves the teammate paused.</p></section>
108
+ <section class="rail-section"><h2>Workspace</h2><div class="specs"><div>System<strong>Linux</strong></div><div>Memory<strong>4 GiB</strong></div><div>Processor<strong>2 CPUs</strong></div><div>Runtime<strong>Local QEMU</strong></div></div></section>
109
+ <section id="approval-section" class="rail-section" hidden><h2>Input approval</h2><p id="approval-indicator">No input waiting for review.</p><p class="hint">Review and approve proposed actions in Nova's Teammates panel.</p></section></aside></div>
110
+ <footer>Preview refreshes once per second while this tab is visible. Pause blocks the next agent input;
111
+ an action already sent may finish. Stop deletes this temporary VM and its files.
112
+ Start another computer from Nova with <code>/computer start</code>.</footer></main>
113
+ <script>
114
+ const $=id=>document.getElementById(id);let picture=null,approvalPicture=null,busy=false,retained=false,manual=false;
115
+ async function request(path,options={}){const r=await fetch(path,options);
116
+ if(!r.ok){const error=await r.json();throw new Error(error.error||'Computer unavailable')}return r}
117
+ function render(s){document.body.dataset.connected='true';retained=!!s.persistent;manual=!!s.manual;document.body.dataset.control=manual?'manual':'agent';document.body.dataset.retained=String(retained);
118
+ $('state').textContent=s.phase+(s.phase==='ready'?(manual?' · you have control':s.paused?' · input paused':''):'');
119
+ $('takeover-controls').hidden=!retained;$('resume').hidden=retained;$('stop').textContent=retained?'Suspend':'Stop VM';
120
+ $('approval-section').hidden=!retained;
121
+ $('approval-indicator').textContent=s.pending_approval?'An input needs your review. Open the saved observation.':(s.auto_approve?'Auto approve desktop input is on.':'Desktop input requires approval.');
122
+ $('approval-indicator').classList.toggle('waiting',!!s.pending_approval);
123
+ if(!s.pending_approval){$('approval-observation').hidden=true;$('approval-observation').open=false;}
124
+ if(retained){$('control-owner').textContent=manual?'You hold control':'Teammate';
125
+ $('takeover').hidden=manual;$('return_control').hidden=!manual;
126
+ $('takeover').disabled=busy||s.manual;$('return_control').disabled=busy||!s.manual;
127
+ for(const id of ['manual-text','manual-key','send-text','send-key'])$(id).disabled=busy||!s.manual||s.phase!=='ready';
128
+ document.querySelector('footer').textContent='Suspend preserves your files. '+(s.auto_approve?'Future desktop input is automatically approved within the assigned task.':'Desktop input requires approval in Nova.');}
129
+ $('notice').textContent=s.error||s.stage+(s.phase==='starting'?' · '+s.elapsed_seconds+'s elapsed':'');
130
+ $('pause').disabled=busy||s.phase!=='ready'||s.paused;
131
+ $('resume').disabled=busy||s.phase!=='ready'||!s.paused;
132
+ $('stop').disabled=busy||s.phase==='stopped'||s.phase==='stopping';
133
+ if(s.phase!=='ready'){$('screen').hidden=true;$('empty').hidden=false;
134
+ $('empty').textContent=s.phase==='starting'?'Preparing your Linux workspace. The first start may take a few minutes.':s.phase==='suspended'?'Your workspace is suspended. Take Control or resume a task in Nova to wake it.':s.phase==='stopped'?'Your computer is offline. Start it from Nova with /computer start.':'Computer '+s.phase}}
135
+ async function tick(){try{if(!document.hidden){const s=await(await request('/status')).json();render(s);
136
+ if(s.pending_approval){const blob=await(await request('/approval_frame')).blob();const next=URL.createObjectURL(blob);
137
+ $('approval-screen').src=next;$('approval-observation').hidden=false;if(approvalPicture)URL.revokeObjectURL(approvalPicture);approvalPicture=next}
138
+ else{$('approval-observation').hidden=true}
139
+ if(s.phase==='ready'){const blob=await(await request('/frame')).blob();const next=URL.createObjectURL(blob);
140
+ $('screen').src=next;$('screen').hidden=false;$('empty').hidden=true;if(picture)URL.revokeObjectURL(picture);picture=next}
141
+ }}catch(e){manual=false;document.body.dataset.connected='false';document.body.dataset.control='agent';$('state').textContent='Preview disconnected';$('notice').textContent=e.message+' · Reconnecting automatically…';
142
+ for(const id of ['pause','resume','stop','takeover','return_control','manual-text','manual-key','send-text','send-key'])$(id).disabled=true;}
143
+ finally{setTimeout(tick,1000)}}
144
+ for(const action of ['pause','resume','stop','takeover','return_control'])$(action).onclick=async()=>{
145
+ if(busy)return;
146
+ if(action==='stop'&&!retained&&!confirm('Stop and delete this temporary computer and its files?'))return;
147
+ busy=true;for(const id of ['pause','resume','stop','takeover','return_control'])$(id).disabled=true;
148
+ try{const s=await(await request('/'+action,{method:'POST',headers:{'X-Nova-Request':'1'}})).json();
149
+ busy=false;render(s)}catch(e){busy=false;$('notice').textContent=e.message}};
150
+ async function input(args){if(!manual||busy)return;busy=true;
151
+ try{render(await(await request('/manual_action',{method:'POST',headers:{'X-Nova-Request':'1','Content-Type':'application/json'},body:JSON.stringify(args)})).json())}
152
+ catch(e){$('notice').textContent=e.message}finally{busy=false}}
153
+ $('screen').onclick=e=>{if(!manual)return;const r=$('screen').getBoundingClientRect();
154
+ input({action:'click',frame_width:$('screen').naturalWidth,frame_height:$('screen').naturalHeight,x:Math.min($('screen').naturalWidth-1,Math.floor((e.clientX-r.left)*$('screen').naturalWidth/r.width)),
155
+ y:Math.min($('screen').naturalHeight-1,Math.floor((e.clientY-r.top)*$('screen').naturalHeight/r.height))})};
156
+ $('screen').addEventListener('wheel',e=>{if(!manual)return;e.preventDefault();input({action:'scroll',dy:Math.sign(e.deltaY)*3})},{passive:false});
157
+ $('send-text').onclick=()=>{const text=$('manual-text').value;$('manual-text').value='';if(text)input({action:'type',text})};
158
+ $('send-key').onclick=()=>{const keys=$('manual-key').value.split(',').map(k=>k.trim()).filter(Boolean);$('manual-key').value='';if(keys.length)input({action:'key',keys})};
159
+ $('fullscreen').hidden=!document.fullscreenEnabled;
160
+ $('fullscreen').onclick=async()=>{try{if(document.fullscreenElement)await document.exitFullscreen();else await document.querySelector('.viewer').requestFullscreen()}catch(e){$('notice').textContent='Fullscreen unavailable. Use the fullscreen command in your browser.'}};
161
+ document.addEventListener('fullscreenchange',()=>{const expanded=!!document.fullscreenElement;$('fullscreen').textContent=expanded?'Exit fullscreen':'Expand';$('fullscreen').setAttribute('aria-label',expanded?'Exit fullscreen preview':'Enter fullscreen preview')});
162
+ for(const [field,button] of [['manual-text','send-text'],['manual-key','send-key']])$(field).addEventListener('keydown',e=>{if(e.key==='Enter'){e.preventDefault();$(button).click()}});
163
+ tick();
164
+ </script></body></html>"""
165
+
166
+
167
+ class ComputerPreview:
168
+ """One authenticated viewer for one session; never exposed through artifacts."""
169
+
170
+ def __init__(self, computer: Computer) -> None:
171
+ """Bind an authenticated listener directly to an available loopback port."""
172
+ owner = computer
173
+
174
+ class Handler(LocalRequestHandler):
175
+ def log_message(self, *_args: object) -> None:
176
+ # Browser authorization tokens must not enter access logs.
177
+ pass
178
+
179
+ def respond(self, status: int, body: bytes, content_type: str) -> None:
180
+ self.send_response(status)
181
+ self.send_header("Content-Type", content_type)
182
+ self.send_header("Content-Length", str(len(body)))
183
+ self.send_header("Cache-Control", "no-store")
184
+ self.send_header("Referrer-Policy", "no-referrer")
185
+ self.send_header("X-Content-Type-Options", "nosniff")
186
+ self.send_header(
187
+ "Content-Security-Policy",
188
+ (
189
+ "default-src 'none'; script-src 'unsafe-inline'; style-src 'unsafe-inline'; "
190
+ "img-src blob:; connect-src 'self'; frame-ancestors 'none'; base-uri 'none'"
191
+ ),
192
+ )
193
+ self.end_headers()
194
+ self.wfile.write(body)
195
+
196
+ def do_GET(self) -> None: # noqa: N802 - BaseHTTPRequestHandler API.
197
+ if self.path == "/":
198
+ self.respond(200, secure_html(HTML).encode(), "text/html; charset=utf-8")
199
+ elif self.path in {"/status", "/frame", "/approval_frame"}:
200
+ self.operate(self.path[1:])
201
+ else:
202
+ self.send_error(404)
203
+
204
+ def do_POST(self) -> None: # noqa: N802 - BaseHTTPRequestHandler API.
205
+ if self.path in {"/pause", "/resume", "/stop", "/takeover", "/return_control"}:
206
+ self.operate(self.path[1:])
207
+ elif self.path == "/manual_action":
208
+ try:
209
+ length = int(self.headers.get("Content-Length", "0"))
210
+ if not 0 < length <= MAX_MANUAL_INPUT_BYTES:
211
+ message = "Invalid input size"
212
+ raise ValueError(message) # noqa: TRY301
213
+ arguments = json.loads(self.rfile.read(length))
214
+ if not isinstance(arguments, dict):
215
+ message = "Expected input object"
216
+ raise TypeError(message) # noqa: TRY301
217
+ self.operate("manual_action", arguments)
218
+ except (ValueError, TypeError, OSError):
219
+ self.respond(400, b'{"error":"Invalid manual input"}', "application/json")
220
+ else:
221
+ self.send_error(404)
222
+
223
+ def operate(self, operation: str, arguments: dict | None = None) -> None:
224
+ try:
225
+ result = owner.call_sync(operation, **(arguments or {}))
226
+ if operation in {"frame", "approval_frame"}:
227
+ self.respond(200, result, "image/png")
228
+ else:
229
+ self.respond(200, json.dumps(result).encode(), "application/json")
230
+ except Exception as exc: # noqa: BLE001 - Return a usable viewer error.
231
+ message = (
232
+ "Manual input failed; inspect desktop"
233
+ if operation == "manual_action"
234
+ else str(exc)
235
+ )
236
+ self.respond(409, json.dumps({"error": message}).encode(), "application/json")
237
+
238
+ self._server = ThreadingHTTPServer(("127.0.0.1", 0), Handler)
239
+ self._server.daemon_threads = True
240
+ token = secrets.token_urlsafe(32)
241
+ self._server.auth_token = token # type: ignore[attr-defined] # LocalRequestHandler contract.
242
+ query = urlencode({"token": token})
243
+ self.url = f"http://127.0.0.1:{self._server.server_port}/?{query}"
244
+ self._thread = threading.Thread(
245
+ target=self._server.serve_forever, daemon=True, name="nova-computer-preview"
246
+ )
247
+ self._thread.start()
248
+
249
+ def close(self) -> None:
250
+ """Release the viewer's listener."""
251
+ self._server.shutdown()
252
+ self._server.server_close()
253
+ self._thread.join(timeout=2)