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,273 @@
1
+ """Model download events shared by voice providers and the TUI."""
2
+ # ruff: noqa: ANN401 -- Hugging Face/tqdm forward heterogeneous public arguments.
3
+
4
+ from __future__ import annotations
5
+
6
+ import asyncio
7
+ import inspect
8
+ import io
9
+ import logging
10
+ import os
11
+ import tempfile
12
+ import threading
13
+ import time
14
+ import urllib.request
15
+ from collections.abc import Callable
16
+ from contextlib import asynccontextmanager, contextmanager
17
+ from contextvars import ContextVar
18
+ from dataclasses import dataclass, field, replace
19
+ from functools import wraps
20
+ from itertools import count
21
+ from pathlib import Path
22
+ from typing import TYPE_CHECKING, Any
23
+ from uuid import uuid4
24
+
25
+ if TYPE_CHECKING:
26
+ from collections.abc import AsyncIterator, Iterator
27
+
28
+ logger = logging.getLogger("nova.audio.downloads")
29
+ _OPERATIONS = count()
30
+ _PROGRESS_INTERVAL_S = 0.15
31
+
32
+
33
+ @dataclass(frozen=True)
34
+ class ModelDownload:
35
+ """One operation's current model preparation or file-transfer state."""
36
+
37
+ operation_id: str
38
+ kind: str
39
+ provider: str
40
+ state: str
41
+ filename: str = ""
42
+ completed: int = 0
43
+ total: int | None = None
44
+ error: str = ""
45
+ sequence: int = field(default_factory=lambda: next(_OPERATIONS))
46
+
47
+
48
+ DownloadCallback = Callable[[ModelDownload], None]
49
+ _CALLBACK: ContextVar[DownloadCallback | None] = ContextVar("voice_download_callback", default=None)
50
+ _CURRENT: ContextVar[_Reporter | None] = ContextVar("voice_model_download", default=None)
51
+ _HOOK_LOCK = threading.Lock()
52
+
53
+
54
+ class _Reporter:
55
+ def __init__(self, kind: str, provider: str, callback: DownloadCallback) -> None:
56
+ self.event = ModelDownload(uuid4().hex, kind, provider, "loading")
57
+ self.callback = callback
58
+ self.lock = threading.RLock()
59
+ self.closed = False
60
+ self.visible = False
61
+ self.last_update = 0.0
62
+
63
+ def emit(
64
+ self,
65
+ state: str,
66
+ *,
67
+ filename: str = "",
68
+ completed: int = 0,
69
+ total: int | None = None,
70
+ error: str = "",
71
+ force: bool = False,
72
+ ) -> None:
73
+ with self.lock:
74
+ if self.closed:
75
+ return
76
+ now = time.monotonic()
77
+ if (
78
+ state == "downloading"
79
+ and not force
80
+ and self.event.state == state
81
+ and filename == self.event.filename
82
+ and completed != total
83
+ and now - self.last_update < _PROGRESS_INTERVAL_S
84
+ ):
85
+ return
86
+ self.event = replace(
87
+ self.event,
88
+ state=state,
89
+ filename=filename,
90
+ completed=max(0, completed),
91
+ total=total,
92
+ error=error,
93
+ )
94
+ self.visible = True
95
+ self.last_update = now
96
+ try:
97
+ self.callback(self.event)
98
+ except Exception: # noqa: BLE001 -- a closed UI must not break a model download.
99
+ logger.debug("Voice progress callback failed", exc_info=True)
100
+
101
+ def finish(self, state: str, error: str = "") -> None:
102
+ with self.lock:
103
+ if self.visible:
104
+ self.emit(
105
+ state,
106
+ filename=self.event.filename,
107
+ completed=self.event.completed,
108
+ total=self.event.total,
109
+ error=error,
110
+ )
111
+ self.closed = True
112
+
113
+ def progress_class(self) -> type[Any]:
114
+ from tqdm.auto import tqdm
115
+
116
+ reporter = self
117
+
118
+ class QuietStream(io.StringIO):
119
+ def write(self, text: str) -> int:
120
+ return len(text)
121
+
122
+ # tqdm.auto is dynamically selected and has no bundled typing.
123
+ class ModelTqdm(tqdm): # type: ignore[misc]
124
+ def __init__(self, *args: Any, **kwargs: Any) -> None:
125
+ kwargs.update(file=QuietStream(), disable=False, leave=False)
126
+ super().__init__(*args, **kwargs)
127
+ self._report()
128
+
129
+ def _report(self, *, force: bool = False) -> None:
130
+ if getattr(self, "unit", None) != "B":
131
+ return
132
+ total = getattr(self, "total", None)
133
+ completed = int(getattr(self, "n", 0))
134
+ if completed or total:
135
+ reporter.emit(
136
+ "downloading",
137
+ filename=str(getattr(self, "desc", "model")),
138
+ completed=completed,
139
+ total=int(total) if total else None,
140
+ force=force,
141
+ )
142
+
143
+ def update(self, n: float = 1) -> bool | None:
144
+ result = super().update(n)
145
+ self._report()
146
+ return result
147
+
148
+ def refresh(self, *args: Any, **kwargs: Any) -> bool | None:
149
+ result = super().refresh(*args, **kwargs)
150
+ self._report()
151
+ return result
152
+
153
+ def close(self) -> None:
154
+ self._report(force=True)
155
+ super().close()
156
+
157
+ return ModelTqdm
158
+
159
+
160
+ def _wrap_hub_download(original: Callable[..., Any]) -> Callable[..., Any]:
161
+ @wraps(original)
162
+ def download(*args: Any, **kwargs: Any) -> Any:
163
+ reporter = _CURRENT.get()
164
+ if reporter is not None:
165
+ kwargs["tqdm_class"] = reporter.progress_class()
166
+ return original(*args, **kwargs)
167
+
168
+ download._nova_voice_progress = True # type: ignore[attr-defined]
169
+ return download
170
+
171
+
172
+ def _install_hub_progress() -> None:
173
+ """Adapt public HF progress hooks; calls outside a voice scope are unchanged."""
174
+ try:
175
+ import huggingface_hub
176
+ except ImportError:
177
+ return
178
+ with _HOOK_LOCK:
179
+ for name in ("hf_hub_download", "snapshot_download"):
180
+ original = getattr(huggingface_hub, name, None)
181
+ if original is None or getattr(original, "_nova_voice_progress", False):
182
+ continue
183
+ parameters = inspect.signature(original).parameters
184
+ if "tqdm_class" not in parameters and not any(
185
+ p.kind == inspect.Parameter.VAR_KEYWORD for p in parameters.values()
186
+ ):
187
+ continue # Older HF versions can still show indeterminate preparation.
188
+ setattr(huggingface_hub, name, _wrap_hub_download(original))
189
+
190
+
191
+ @contextmanager
192
+ def download_progress(callback: DownloadCallback) -> Iterator[None]:
193
+ """Bind progress for pipelines created inside a captured TUI command."""
194
+ token = _CALLBACK.set(callback)
195
+ try:
196
+ yield
197
+ finally:
198
+ _CALLBACK.reset(token)
199
+
200
+
201
+ def report_model_loading() -> None:
202
+ """Leave byte progress behind while native initialization is still running."""
203
+ reporter = _CURRENT.get()
204
+ if reporter is not None and reporter.visible:
205
+ reporter.emit("loading")
206
+
207
+
208
+ @asynccontextmanager
209
+ async def watch_downloads(
210
+ kind: str, provider: str, backend: Any, callback: DownloadCallback | None
211
+ ) -> AsyncIterator[None]:
212
+ """Report one load; copied thread contexts retain a request-local reporter."""
213
+ callback = callback or _CALLBACK.get()
214
+ if callback is None:
215
+ yield
216
+ return
217
+ await asyncio.to_thread(_install_hub_progress)
218
+ reporter = _Reporter(kind, provider, callback)
219
+ token = _CURRENT.set(reporter)
220
+ try:
221
+ try:
222
+ pending = await asyncio.to_thread(
223
+ lambda: getattr(
224
+ backend, "needs_download", getattr(backend, "_model", object()) is None
225
+ )
226
+ )
227
+ except Exception: # noqa: BLE001 -- cache detection is only a progress hint.
228
+ pending = False
229
+ if pending:
230
+ reporter.emit("loading")
231
+ yield
232
+ except asyncio.CancelledError:
233
+ reporter.finish("cancelled")
234
+ raise
235
+ except Exception as exc:
236
+ reporter.finish("error", str(exc))
237
+ raise
238
+ else:
239
+ reporter.finish("ready")
240
+ finally:
241
+ reporter.closed = True
242
+ _CURRENT.reset(token)
243
+
244
+
245
+ def download_file(url: str, dest: Path) -> None:
246
+ """Stream an owned voice asset with byte progress and atomic replacement."""
247
+ dest.parent.mkdir(parents=True, exist_ok=True)
248
+ fd, temporary = tempfile.mkstemp(dir=dest.parent, suffix=".tmp")
249
+ reporter = _CURRENT.get()
250
+ completed = 0
251
+ try:
252
+ with os.fdopen(fd, "wb") as output, urllib.request.urlopen(url, timeout=30) as response: # noqa: S310 -- callers supply fixed model hosts.
253
+ length = response.headers.get("Content-Length")
254
+ total = int(length) if length and length.isdigit() and int(length) > 0 else None
255
+ if reporter:
256
+ reporter.emit("downloading", filename=dest.name, total=total)
257
+ while chunk := response.read(64 * 1024):
258
+ output.write(chunk)
259
+ completed += len(chunk)
260
+ if reporter:
261
+ reporter.emit(
262
+ "downloading", filename=dest.name, completed=completed, total=total
263
+ )
264
+ if total is not None and completed != total:
265
+ msg = f"Incomplete download for {dest.name}: {completed} of {total} bytes"
266
+ raise OSError(msg)
267
+ if reporter:
268
+ reporter.emit(
269
+ "downloading", filename=dest.name, completed=completed, total=total, force=True
270
+ )
271
+ Path(temporary).replace(dest)
272
+ finally:
273
+ Path(temporary).unlink(missing_ok=True)
@@ -0,0 +1,391 @@
1
+ """VoicePipeline — orchestrates capture → VAD → STT, and TTS playback.
2
+
3
+ UI-agnostic: the TUI constructs one of these and drives it via callbacks, so the
4
+ audio logic stays testable and reusable. All heavy work runs off the event loop
5
+ (``asyncio.to_thread``). The ``tts_active`` flag lets the always-listening loop
6
+ **pause while Nova is speaking**, so it never transcribes its own output.
7
+ """
8
+
9
+ from __future__ import annotations
10
+
11
+ import asyncio
12
+ import logging
13
+ import threading
14
+ from typing import TYPE_CHECKING, Any
15
+
16
+ from novacode_cli.audio.downloads import watch_downloads
17
+
18
+ if TYPE_CHECKING:
19
+ from collections.abc import Awaitable, Callable
20
+
21
+ from novacode_cli.audio.downloads import DownloadCallback
22
+ from novacode_cli.audio.providers import VoiceSTT, VoiceTTS
23
+
24
+ logger = logging.getLogger("nova.audio.pipeline")
25
+
26
+ _TTS_POLL_S = 0.1
27
+
28
+ _ACTIVE_PIPELINE: VoicePipeline | None = None
29
+
30
+
31
+ def get_active_pipeline() -> VoicePipeline | None:
32
+ """Return the currently active VoicePipeline instance."""
33
+ return _ACTIVE_PIPELINE
34
+
35
+
36
+ def _stored_or_config_key(cfg: dict[str, Any], env_var: str) -> str:
37
+ """Resolve a cloud voice provider's key, preferring the credential store.
38
+
39
+ The config field is checked first only because it is the older location and
40
+ may still hold a key on a machine where the startup migration has not run;
41
+ `credential_value` then covers the keychain (which is where `/auth` and
42
+ `/voice settings --key` now write) and the environment.
43
+
44
+ A key that no longer resolves returns ``""`` so the backend still reports its
45
+ own "no API key" error rather than the pipeline guessing.
46
+
47
+ Args:
48
+ cfg: The provider's config block.
49
+ env_var: Credential env var backing this provider.
50
+
51
+ Returns:
52
+ The API key, or an empty string when none is configured.
53
+ """
54
+ from novacode_cli.config.credentials import credential_value
55
+
56
+ return cfg.get("api_key") or cfg.get("key") or credential_value(env_var)
57
+
58
+
59
+ def build_stt(provider: str, provider_configs: dict[str, Any] | None = None) -> VoiceSTT:
60
+ """Create an STT backend by provider name.
61
+
62
+ Module-level rather than a :class:`VoicePipeline` method because callers
63
+ that only transcribe — a remote voice note, say — must not construct a
64
+ pipeline: doing so installs itself as the process-wide ``_ACTIVE_PIPELINE``
65
+ and would hijack the live voice session.
66
+ """
67
+ cfg = (provider_configs or {}).get(provider, {})
68
+ if provider == "whistle":
69
+ try:
70
+ import needle # noqa: F401 -- verify optional package before activating provider.
71
+ except ImportError as exc:
72
+ from novacode_cli.audio import whistle_install_hint
73
+
74
+ raise ImportError(whistle_install_hint()) from exc
75
+
76
+ from novacode_cli.audio.stt_whistle import WhistleTranscriber
77
+
78
+ return WhistleTranscriber(
79
+ model=cfg.get("model", "whistle"),
80
+ language=cfg.get("language", "en"),
81
+ )
82
+ if provider == "faster-whisper":
83
+ from novacode_cli.audio.stt import Transcriber
84
+
85
+ return Transcriber(
86
+ model_size=cfg.get("model", "distil-large-v3"),
87
+ device=cfg.get("device", "auto"),
88
+ language=cfg.get("language", "en"),
89
+ )
90
+ if provider == "deepgram":
91
+ from novacode_cli.audio.stt_deepgram import DeepgramTranscriber
92
+
93
+ return DeepgramTranscriber(
94
+ api_key=_stored_or_config_key(cfg, "DEEPGRAM_API_KEY"),
95
+ model=cfg.get("model", "nova-2"),
96
+ )
97
+ if provider == "parakeet":
98
+ try:
99
+ import sherpa_onnx # noqa: F401
100
+ except ImportError as e:
101
+ from novacode_cli.audio import parakeet_install_hint
102
+
103
+ raise ImportError(parakeet_install_hint()) from e
104
+
105
+ from novacode_cli.audio.stt_parakeet import ParakeetTranscriber
106
+
107
+ return ParakeetTranscriber(
108
+ num_threads=cfg.get("threads", 2),
109
+ )
110
+ msg = f"Unknown STT provider: {provider!r}"
111
+ raise ValueError(msg)
112
+
113
+
114
+ def stt_from_voice_config(cfg: dict[str, Any]) -> VoiceSTT:
115
+ """Build the STT backend described by a saved ``/voice`` config block.
116
+
117
+ Applies the same legacy-key merge :class:`VoicePipeline` does, so a voice
118
+ note is transcribed by whatever provider and model the user selected rather
119
+ than by a second, silently different default.
120
+ """
121
+ provider_configs = {k: dict(v) for k, v in (cfg.get("providers") or {}).items()}
122
+ whisper = provider_configs.setdefault("faster-whisper", {})
123
+ whisper.setdefault("model", cfg.get("stt_model", "base"))
124
+ whisper.setdefault("device", cfg.get("stt_device", "auto"))
125
+ return build_stt(cfg.get("stt_provider", "faster-whisper"), provider_configs)
126
+
127
+
128
+ class VoicePipeline:
129
+ """High-level voice I/O: one-shot capture, continuous listen, and speak."""
130
+
131
+ def __init__(
132
+ self,
133
+ *,
134
+ stt_provider: str = "faster-whisper",
135
+ tts_provider: str = "piper",
136
+ provider_configs: dict[str, Any] | None = None,
137
+ # Legacy flat params (kept for backward compat, merged into provider_configs).
138
+ stt_model: str = "base",
139
+ stt_device: str = "auto",
140
+ tts_voice: str = "en_US-lessac-medium",
141
+ on_download_progress: DownloadCallback | None = None,
142
+ ) -> None:
143
+ """Record component config; nothing is loaded until first use."""
144
+ global _ACTIVE_PIPELINE
145
+ _ACTIVE_PIPELINE = self
146
+ self._stt_provider = stt_provider
147
+ self._tts_provider = tts_provider
148
+ self.on_download_progress = on_download_progress
149
+ _pc = dict(provider_configs or {})
150
+ _pc.setdefault("faster-whisper", {})
151
+ _pc["faster-whisper"].setdefault("model", stt_model)
152
+ _pc["faster-whisper"].setdefault("device", stt_device)
153
+ _pc.setdefault("piper", {})
154
+ _pc["piper"].setdefault("voice", tts_voice)
155
+ self._provider_configs = _pc
156
+ self._capture: Any = None
157
+ self._vad: Any = None
158
+ self._stt: Any = None
159
+ self._tts: Any = None
160
+ self._tts_active = False
161
+ # Explicit speak tools may enter from a worker's event loop.
162
+ self._speech_lock = threading.Lock()
163
+
164
+ @property
165
+ def tts_active(self) -> bool:
166
+ """Whether TTS is currently playing (listen loop pauses while True)."""
167
+ return self._tts_active
168
+
169
+ def _ensure_components(self) -> None:
170
+ self._ensure_input_components()
171
+ self._ensure_tts()
172
+
173
+ def _ensure_input_components(self) -> None:
174
+ """Build microphone components only when capturing or preloading input."""
175
+ from novacode_cli.audio.capture import AudioCapture
176
+ from novacode_cli.audio.vad import SileroVad
177
+
178
+ if self._capture is None:
179
+ self._capture = AudioCapture()
180
+ if self._vad is None:
181
+ self._vad = SileroVad()
182
+ if self._stt is None:
183
+ self._stt = self._build_stt()
184
+
185
+ def _ensure_tts(self) -> None:
186
+ """Build the speech provider without allocating the input stack."""
187
+ if self._tts is None:
188
+ self._tts = self._build_tts()
189
+
190
+ def _build_stt(self) -> VoiceSTT:
191
+ """Create the STT provider selected by ``stt_provider``."""
192
+ return build_stt(self._stt_provider, self._provider_configs)
193
+
194
+ def _build_tts(self) -> VoiceTTS: # noqa: PLR0911 -- explicit lazy provider branches.
195
+ """Create the TTS provider selected by ``tts_provider``."""
196
+ provider = self._tts_provider
197
+ cfg = self._provider_configs.get(provider, {})
198
+ if provider == "kokoro":
199
+ from novacode_cli.audio.tts_kokoro import KokoroSpeaker
200
+
201
+ return KokoroSpeaker(voice=cfg.get("voice", "af_heart"))
202
+ if provider == "sano":
203
+ from novacode_cli.audio.tts_sano import SanoSpeaker
204
+
205
+ return SanoSpeaker(voice=cfg.get("voice", "amy-1p1m"))
206
+ if provider == "piper":
207
+ from novacode_cli.audio.tts import Speaker
208
+
209
+ return Speaker(voice=cfg.get("voice", "en_US-lessac-medium"))
210
+ if provider == "elevenlabs":
211
+ from novacode_cli.audio.stt_elevenlabs import ElevenLabsSpeaker
212
+
213
+ return ElevenLabsSpeaker(
214
+ api_key=_stored_or_config_key(cfg, "ELEVENLABS_API_KEY"),
215
+ voice_id=cfg.get("voice_id", "21m00Tcm4TlvDq8ikWAM"),
216
+ )
217
+ if provider == "orpheus":
218
+ from novacode_cli.audio.tts_orpheus import OrpheusSpeaker
219
+
220
+ return OrpheusSpeaker(
221
+ voice=cfg.get("voice", "tara"),
222
+ lang=cfg.get("lang", "en"),
223
+ )
224
+ if provider == "pocket":
225
+ try:
226
+ import pocket_tts # noqa: F401
227
+ except ImportError as e:
228
+ from novacode_cli.audio import pocket_install_hint
229
+
230
+ raise ImportError(pocket_install_hint()) from e
231
+
232
+ from novacode_cli.audio.tts_pocket import PocketSpeaker
233
+
234
+ return PocketSpeaker(
235
+ voice=cfg.get("voice", "alba"),
236
+ )
237
+ if provider == "none":
238
+ from novacode_cli.audio.providers import _NullTTS
239
+
240
+ return _NullTTS()
241
+ msg = f"Unknown TTS provider: {provider!r}"
242
+ raise ValueError(msg)
243
+
244
+ async def warmup(self, *, input_audio: bool = True) -> bool:
245
+ """Pre-load VAD + STT + TTS models off the loop so first use isn't laggy.
246
+
247
+ Only the local providers have models to pre-load (cloud providers have
248
+ nothing to warm up). Best-effort: any load error is logged and ignored —
249
+ the model simply loads on first real use instead. Return False if any
250
+ component failed, so callers do not announce readiness incorrectly.
251
+ """
252
+ if input_audio:
253
+ self._ensure_components()
254
+ else:
255
+ self._ensure_tts()
256
+ # Cloud providers expose no eager loader.
257
+ _stt_load = getattr(self._stt, "_ensure_model", None)
258
+ _tts_load = getattr(self._tts, "_ensure_voice", None)
259
+ tasks: list[tuple[str, Any]] = []
260
+ if input_audio:
261
+ tasks.append(("VAD", self._vad.ensure_model_async))
262
+ if input_audio and _stt_load is not None:
263
+ tasks.append(("STT", _stt_load))
264
+ if _tts_load is not None:
265
+ tasks.append(("TTS", _tts_load))
266
+ ready = True
267
+ for label, loader in tasks:
268
+ try:
269
+ if label == "VAD":
270
+ await loader()
271
+ continue
272
+ backend = self._stt if label == "STT" else self._tts
273
+ provider = self._stt_provider if label == "STT" else self._tts_provider
274
+ async with watch_downloads(label, provider, backend, self.on_download_progress):
275
+ await asyncio.to_thread(loader)
276
+ except Exception:
277
+ ready = False
278
+ logger.exception("Voice warmup failed for %s; will load on first use", label)
279
+ return ready
280
+
281
+ async def capture_utterance(
282
+ self, *, should_stop: Callable[[], bool] | None = None
283
+ ) -> str | None:
284
+ """Push-to-talk: record one utterance, return its transcript (or ``None``)."""
285
+ self._ensure_input_components()
286
+ self._capture.start()
287
+ self._capture.drain()
288
+ try:
289
+ pcm = await self._vad.collect_utterance_async(
290
+ self._capture.read, should_stop=should_stop
291
+ )
292
+ finally:
293
+ self._capture.stop() # PTT releases the mic between utterances
294
+ if pcm is None or len(pcm) == 0:
295
+ return None
296
+ async with watch_downloads("STT", self._stt_provider, self._stt, self.on_download_progress):
297
+ return (await self._stt.transcribe(pcm)) or None
298
+
299
+ async def speak(self, text: str) -> None:
300
+ """Speak ``text`` aloud, flagging ``tts_active`` for the duration."""
301
+ if not text.strip():
302
+ return
303
+ # asyncio locks/events bind to one loop; explicit speech can use another.
304
+ while not self._speech_lock.acquire(blocking=False): # noqa: ASYNC110
305
+ await asyncio.sleep(_TTS_POLL_S)
306
+ try:
307
+ self._ensure_tts()
308
+ self._tts_active = True
309
+ try:
310
+ async with watch_downloads(
311
+ "TTS", self._tts_provider, self._tts, self.on_download_progress
312
+ ):
313
+ await self._tts.speak(text)
314
+ finally:
315
+ self._tts_active = False
316
+ finally:
317
+ self._speech_lock.release()
318
+
319
+ async def listen_loop(
320
+ self,
321
+ on_transcript: Callable[[str], Awaitable[None] | None],
322
+ *,
323
+ should_stop: Callable[[], bool] | None = None,
324
+ ) -> None:
325
+ """Always-listening: capture utterances continuously, emit each transcript.
326
+
327
+ Pauses capture while ``tts_active`` so Nova never hears itself.
328
+ """
329
+ self._ensure_input_components()
330
+ self._capture.start()
331
+ try:
332
+ while True:
333
+ if should_stop is not None and should_stop():
334
+ return
335
+ if self._tts_active:
336
+ self._capture.drain()
337
+ await asyncio.sleep(_TTS_POLL_S)
338
+ continue
339
+
340
+ pcm = await self._vad.collect_utterance_async(
341
+ self._capture.read,
342
+ should_stop=lambda: self._tts_active or bool(should_stop and should_stop()),
343
+ )
344
+ # Discard anything captured if TTS started or we were cancelled.
345
+ if pcm is None or len(pcm) == 0 or self._tts_active:
346
+ continue
347
+ async with watch_downloads(
348
+ "STT", self._stt_provider, self._stt, self.on_download_progress
349
+ ):
350
+ text = await self._stt.transcribe(pcm)
351
+ if self._tts_active or (should_stop is not None and should_stop()):
352
+ continue
353
+ if not text:
354
+ continue
355
+ result = on_transcript(text)
356
+ if asyncio.iscoroutine(result):
357
+ await result
358
+ finally:
359
+ self._capture.stop()
360
+
361
+ def stop(self) -> None:
362
+ """Release the microphone."""
363
+ if self._capture is not None:
364
+ self._capture.stop()
365
+
366
+ @property
367
+ def tts_needs_download(self) -> bool:
368
+ """Whether the TTS provider needs to download files before speaking."""
369
+ self._ensure_tts()
370
+ return getattr(self._tts, "needs_download", False)
371
+
372
+ @property
373
+ def stt_needs_download(self) -> bool:
374
+ """Whether the STT provider needs to download its model before use."""
375
+ if self._stt is None:
376
+ self._stt = self._build_stt()
377
+ return getattr(self._stt, "needs_download", False)
378
+
379
+ def downloads_pending(self) -> list[str]:
380
+ """Return labels (``["STT", "TTS"]``) for models still needing download.
381
+
382
+ Cheap: only stats the filesystem / HF cache via each provider's
383
+ ``needs_download`` — no model is loaded. Empty when everything is cached.
384
+ """
385
+ self._ensure_components()
386
+ pending: list[str] = []
387
+ if getattr(self._stt, "needs_download", False):
388
+ pending.append("STT")
389
+ if getattr(self._tts, "needs_download", False):
390
+ pending.append("TTS")
391
+ return pending