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,102 @@
1
+ """Explicit, role-specific skill libraries shared by foreground and background agents."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import re
6
+ from pathlib import PurePosixPath
7
+
8
+ # Agents shipped as files (default_subagents/builtin/) name theirs in `skill_names:`.
9
+ SPECIALIST_LIBRARIES: dict[str, tuple[str, ...]] = {
10
+ "research-agent": ("web-research", "deep-research"),
11
+ "web-researcher": ("web-research", "deep-research"),
12
+ "fact-checker": ("fact-checking", "web-research"),
13
+ "research-synthesizer": ("research-synthesis", "web-research"),
14
+ "literature-reviewer": ("literature-review", "academic-research"),
15
+ "market-analyst": ("market-research",),
16
+ "financial-analyst": ("financial-analysis",),
17
+ "technical-researcher": ("web-research", "technical-research"),
18
+ }
19
+
20
+
21
+ def library_names(name: str, definition: dict | None = None) -> tuple[str, ...] | None:
22
+ """None means full library; [] means no skills; unknown specialists opt in explicitly."""
23
+ definition = definition or {}
24
+ if "skill_names" in definition:
25
+ chosen = definition["skill_names"]
26
+ if chosen == "*":
27
+ return None
28
+ if not isinstance(chosen, list) or any(
29
+ not isinstance(value, str)
30
+ or len(value) > 64
31
+ or not re.fullmatch(r"[a-z0-9]+(?:-[a-z0-9]+)*", value)
32
+ for value in chosen
33
+ ):
34
+ message = "skill_names must be a list of kebab-case skill names, or '*'"
35
+ raise ValueError(message)
36
+ return tuple(dict.fromkeys(chosen))
37
+ if name in {"general-purpose", "general-purpose-async"}:
38
+ return None
39
+ return SPECIALIST_LIBRARIES.get(name, ())
40
+
41
+
42
+ class LibraryDiscoveryBackend:
43
+ """Filter directory discovery before parsing files, without changing file permissions."""
44
+
45
+ def __init__(self, backend: object, names: tuple[str, ...]) -> None:
46
+ self.backend = backend
47
+ self.names = frozenset(names)
48
+
49
+ def ls(self, path: str):
50
+ from deepagents.backends.protocol import LsResult
51
+
52
+ result = self.backend.ls(path)
53
+ entries = result.entries if isinstance(result, LsResult) else result
54
+ selected = [
55
+ item
56
+ for item in entries or []
57
+ if PurePosixPath(item["path"].replace("\\", "/")).name in self.names
58
+ ]
59
+ return (
60
+ LsResult(entries=selected, error=result.error)
61
+ if isinstance(result, LsResult)
62
+ else selected
63
+ )
64
+
65
+ def __getattr__(self, name: str):
66
+ return getattr(self.backend, name)
67
+
68
+
69
+ def background_library(name: str, definition: dict | None = None):
70
+ """Build fresh discovery and activation middleware for one background graph."""
71
+ from deepagents.backends import CompositeBackend
72
+
73
+ from novacode_cli.agents.async_workspace import workspace_root
74
+ from novacode_cli.backends import OptimizedFilesystemBackend
75
+ from novacode_cli.config.config import Settings, settings
76
+ from novacode_cli.plugins.claude_plugins import plugin_skill_dirs
77
+ from novacode_cli.skills.refreshing_middleware import SubagentSkillsMiddleware
78
+
79
+ root = workspace_root()
80
+ directories = [
81
+ settings.get_global_skills_dir(),
82
+ Settings.get_shared_skills_dir(),
83
+ Settings.get_global_claude_skills_dir(),
84
+ *(directory for _, directory in plugin_skill_dirs()),
85
+ *(root / marker / "skills" for marker in (".agents", ".claude", ".nova")),
86
+ ]
87
+ directories = list(dict.fromkeys(directory for directory in directories if directory.is_dir()))
88
+ routes = {
89
+ f"/agent-skills-{index}/": OptimizedFilesystemBackend(root_dir=directory, virtual_mode=True)
90
+ for index, directory in enumerate(directories)
91
+ }
92
+ # The graph's file/shell backend remains its workspace backend. Only the
93
+ # skill helpers use these extra mounts; they check the selected library.
94
+ backend = CompositeBackend(
95
+ default=OptimizedFilesystemBackend(root_dir=root, virtual_mode=True), routes=routes
96
+ )
97
+ return SubagentSkillsMiddleware(
98
+ backend=backend,
99
+ sources=list(routes),
100
+ watch_dirs=directories,
101
+ library_names=library_names(name, definition),
102
+ )
@@ -0,0 +1,248 @@
1
+ """Skill loader for parsing and loading agent skills from SKILL.md files.
2
+
3
+ This module implements Anthropic's agent skills pattern with YAML frontmatter parsing.
4
+ Each skill is a directory containing a SKILL.md file with:
5
+ - YAML frontmatter (name, description required)
6
+ - Markdown instructions for the agent
7
+ - Optional supporting files (scripts, configs, etc.)
8
+
9
+ Example SKILL.md structure:
10
+ ```markdown
11
+ ---
12
+ name: web-research
13
+ description: Structured approach to conducting thorough web research
14
+ ---
15
+
16
+ # Web Research Skill
17
+
18
+ ## When to Use
19
+ - User asks you to research a topic
20
+ ...
21
+ ```
22
+ """
23
+
24
+ from __future__ import annotations
25
+
26
+ from typing import TYPE_CHECKING
27
+
28
+ # Lazy deepagents imports: `list_skills` pulls in deepagents + the filesystem
29
+ # backend (~4s). We defer them to first call so importing this module (and the
30
+ # modules that import it, e.g. skills.skill_creation) doesn't pay that cost at
31
+ # CLI startup. `SkillMetadata` stays importable via a lazy proxy below.
32
+ if TYPE_CHECKING:
33
+ from deepagents.middleware.skills import SkillMetadata
34
+
35
+ if TYPE_CHECKING:
36
+ from pathlib import Path
37
+
38
+ # Maximum size for SKILL.md files (10MB)
39
+ MAX_SKILL_FILE_SIZE = 10 * 1024 * 1024
40
+
41
+
42
+ class _LazySkillMetadata:
43
+ """Lazy proxy so ``from novacode_cli.skills.load import SkillMetadata`` works
44
+ without importing deepagents at module load. Resolves on first attribute
45
+ access (used only as a type in annotations and dict values)."""
46
+
47
+ def __getattr__(self, name: str):
48
+ from deepagents.middleware.skills import SkillMetadata
49
+
50
+ return getattr(SkillMetadata, name)
51
+
52
+
53
+ SkillMetadata = _LazySkillMetadata() # type: ignore[assignment]
54
+
55
+ # Re-export for CLI commands
56
+ __all__ = ["SkillMetadata", "find_skill_dir", "list_skills"]
57
+
58
+
59
+ def find_skill_dir(name: str) -> tuple[Path, str] | None:
60
+ """Locate an installed skill's directory by name.
61
+
62
+ Searches installed sources with the same last-source-wins precedence as
63
+ :func:`list_skills` (user → shared → Claude → plugins → project) and returns
64
+ ``(skill_dir, source)`` where ``source`` is ``"user"`` / ``"project"`` /
65
+ ``"claude"`` / ``"plugin"``, or ``None`` when no such skill exists.
66
+
67
+ Unlike :func:`list_skills` this reads only the filesystem — no deepagents
68
+ import — so callers that just need a path (prune, delete, edit) stay cheap.
69
+ The returned path is the *directory*; the skill file is ``dir / "SKILL.md"``.
70
+ """
71
+ import re
72
+
73
+ from novacode_cli.config.config import Settings
74
+
75
+ if not re.fullmatch(r"[a-z0-9]+(?:-[a-z0-9]+)*", name) or len(name) > 64:
76
+ return None
77
+ settings = Settings.from_environment()
78
+ from novacode_cli.plugins.claude_plugins import plugin_skill_dirs
79
+
80
+ sources = [
81
+ (settings.get_global_skills_dir(), "user"),
82
+ (Settings.get_shared_skills_dir(), "user"),
83
+ (Settings.get_global_claude_skills_dir(), "claude"),
84
+ *((path, "plugin") for _, path in plugin_skill_dirs()),
85
+ *((path, "project") for path in settings.get_project_skills_dirs()),
86
+ ]
87
+ # Later sources win, consistently with discovery and the agent backend.
88
+ for directory, source in reversed(sources):
89
+ candidate = directory / name
90
+ if (candidate / "SKILL.md").is_file():
91
+ return candidate, source
92
+
93
+ return None
94
+
95
+
96
+ def _dir_signature(directory: Path) -> frozenset | None:
97
+ """Validate current content, including edits with restored timestamps."""
98
+ import os
99
+ from pathlib import Path
100
+
101
+ from novacode_cli.computation_cache import digest
102
+
103
+ sig = []
104
+ try:
105
+ with os.scandir(directory) as entries:
106
+ for entry in entries:
107
+ path = Path(entry.path) / "SKILL.md"
108
+ try:
109
+ sig.append((entry.name, digest(path.read_bytes())))
110
+ except FileNotFoundError:
111
+ continue
112
+ except OSError:
113
+ return None
114
+ except OSError:
115
+ return None
116
+ return frozenset(sig)
117
+
118
+
119
+ def _list_dir(directory: Path) -> list:
120
+ """Reuse validated directory listings in memory, with defensive copies."""
121
+ from time import perf_counter_ns
122
+ from typing import cast
123
+
124
+ from deepagents.middleware.skills import _list_skills as list_skills_from_backend
125
+
126
+ from novacode_cli.backends import OptimizedFilesystemBackend as FilesystemBackend
127
+ from novacode_cli.computation_cache import digest, get, put, record_timing
128
+
129
+ started = perf_counter_ns()
130
+ signature = _dir_signature(directory)
131
+ record_timing("skill_definitions", "validation", perf_counter_ns() - started)
132
+ key = digest(repr(("skill-listing-v1", str(directory.resolve()), sorted(signature or ()))))
133
+ cached = get("skill_definitions", key) if signature is not None else None
134
+ if cached is not None and signature == _dir_signature(directory):
135
+ return cast("list", cached)
136
+ backend = FilesystemBackend(root_dir=str(directory), virtual_mode=True)
137
+ started = perf_counter_ns()
138
+ skills = list_skills_from_backend(backend=backend, source_path=".")
139
+ record_timing("skill_definitions", "computation", perf_counter_ns() - started)
140
+ # If files changed during the parse, do not associate it with the old key.
141
+ if signature is not None and signature == _dir_signature(directory):
142
+ put("skill_definitions", key, skills)
143
+ return skills
144
+
145
+
146
+ def list_skills(
147
+ *,
148
+ user_skills_dir: Path | None = None,
149
+ project_skills_dir: Path | None = None,
150
+ claude_skills_dir: Path | None = None,
151
+ plugin_skills_dirs: list[Path] | None = None,
152
+ shared_skills_dir: Path | None = None,
153
+ project_skills_dirs: list[Path] | None = None,
154
+ ) -> list[SkillMetadata]:
155
+ """List skills from user, project, and/or global Claude directories.
156
+
157
+ This is a CLI-specific wrapper around the prebuilt middleware's skill loading
158
+ functionality. It uses FilesystemBackend to load skills from local directories.
159
+
160
+ Sources are loaded in this order (later overrides earlier):
161
+ 1. User skills (~/.nova/skills/) — foundation
162
+ 2. Shared global skills (~/.agents/skills/)
163
+ 3. Global Claude skills (~/.claude/skills/) — shared Claude Code skills
164
+ 4. Project skills (.agents/skills/, .nova/skills/, .claude/skills/) — highest priority
165
+
166
+ When multiple sources have skills with the same name, the later source's
167
+ skill takes precedence. Each skill includes a 'source' field indicating
168
+ its origin ('user', 'claude', or 'project').
169
+
170
+ Args:
171
+ user_skills_dir: Path to the user-level skills directory.
172
+ project_skills_dir: Path to the project-level skills directory.
173
+ claude_skills_dir: Path to the global Claude Code skills directory
174
+ (~/.claude/skills/).
175
+ shared_skills_dir: Global canonical directory used by the Skills CLI.
176
+ project_skills_dirs: Project directories in increasing precedence order.
177
+ plugin_skills_dirs: Skill directories supplied by installed plugins.
178
+
179
+ Returns:
180
+ Merged list of skill metadata from all sources, with later sources
181
+ taking precedence over earlier ones when names conflict. Each skill
182
+ includes a 'source' field indicating its origin.
183
+ """
184
+ # Lazy deepagents imports (see module docstring): only needed when actually
185
+ # listing skills, not at import time.
186
+
187
+ all_skills: dict[str, SkillMetadata] = {}
188
+
189
+ # Load user skills first (foundation)
190
+ if user_skills_dir and user_skills_dir.exists():
191
+ user_skills = _list_dir(user_skills_dir)
192
+ for skill in user_skills:
193
+ skill["source"] = "user" # type: ignore[typeddict-unknown-key]
194
+ skill["path"] = str(user_skills_dir / str(skill["path"]).lstrip("/\\"))
195
+ all_skills[skill["name"]] = skill
196
+
197
+ # Shared skills keep absolute paths so invocation also finds supporting files.
198
+ if shared_skills_dir and shared_skills_dir.is_dir():
199
+ for skill in _list_dir(shared_skills_dir):
200
+ skill["source"] = "user"
201
+ virtual_path = str(skill.get("path", "")).lstrip("/\\")
202
+ skill["path"] = str(shared_skills_dir / virtual_path)
203
+ all_skills[skill["name"]] = skill
204
+
205
+ # Load global Claude Code skills second (override/supplement user skills)
206
+ if claude_skills_dir and claude_skills_dir.exists():
207
+ claude_skills = _list_dir(claude_skills_dir)
208
+ for skill in claude_skills:
209
+ skill["source"] = "claude" # type: ignore[typeddict-unknown-key]
210
+ skill["path"] = str(claude_skills_dir / str(skill["path"]).lstrip("/\\"))
211
+ all_skills[skill["name"]] = skill
212
+
213
+ # Load installed-plugin skills (~/.nova/plugins/<name>/skills). Set an explicit
214
+ # on-disk ``path`` so the invoker's path-first read/dir resolution works without
215
+ # threading plugin dirs through every helper.
216
+ from novacode_cli.plugins.claude_plugins import plugin_skill_sources, qualify_skills
217
+
218
+ plugin_sources = {str(s["directory"]): s for s in plugin_skill_sources()}
219
+ for plugin_dir in plugin_skills_dirs or []:
220
+ if not (plugin_dir and plugin_dir.exists()):
221
+ continue
222
+ listed = _list_dir(plugin_dir)
223
+ if str(plugin_dir) in plugin_sources:
224
+ listed = qualify_skills(listed, plugin_sources[str(plugin_dir)])
225
+ for skill in listed:
226
+ skill["source"] = "plugin" # type: ignore[typeddict-unknown-key]
227
+ # The backend's ``path`` is virtual (rooted at plugin_dir, e.g.
228
+ # "/foo/SKILL.md") and uses the real directory name — which can differ
229
+ # from the frontmatter name. Map it to an absolute on-disk path so the
230
+ # invoker's path-first resolution works.
231
+ vpath = str(skill.get("path", "") or "").lstrip("/\\")
232
+ skill["path"] = str(plugin_dir / vpath) if vpath else str(plugin_dir / skill["name"]) # type: ignore[typeddict-unknown-key]
233
+ all_skills[skill["name"]] = skill
234
+
235
+ # Project sources override global sources. Include legacy callers' single root.
236
+ directories = list(project_skills_dirs or [])
237
+ if project_skills_dir and project_skills_dir not in directories:
238
+ directories.append(project_skills_dir)
239
+ for directory in directories:
240
+ if not directory.is_dir():
241
+ continue
242
+ for skill in _list_dir(directory):
243
+ skill["source"] = "project"
244
+ virtual_path = str(skill.get("path", "")).lstrip("/\\")
245
+ skill["path"] = str(directory / virtual_path)
246
+ all_skills[skill["name"]] = skill
247
+
248
+ return list(all_skills.values())
@@ -0,0 +1,215 @@
1
+ """Prune skills — the shared core behind ``/skills prune`` and the TUI.
2
+
3
+ Both the REPL (``commands/skills_commands.py``) and the TUI
4
+ (``tui/screens.py`` ``SkillsScreen``) call into this module so their behaviour
5
+ cannot drift: locating prunable skills, archiving a selection, and listing or
6
+ restoring what was archived.
7
+
8
+ Deletion is **always** a soft delete — it delegates to
9
+ :func:`novacode_cli.skills.versioning.archive_skill`, which moves the skill
10
+ directory to ``<skills_root>/../skills-archive/``. Nothing here ever calls
11
+ ``shutil.rmtree``, so every prune is recoverable via :func:`restore`.
12
+
13
+ Deliberately UI-free (no ``console``, no Textual): it returns data and the two
14
+ surfaces render it.
15
+
16
+ Note on usage counts: invocation counts live in the Hermes ``skill_usage``
17
+ store, which is only written when the learning loop is enabled (OFF by
18
+ default). They are therefore reported as *optional enrichment* — never as the
19
+ basis for selecting what to prune, which would flag every skill on a default
20
+ install.
21
+ """
22
+
23
+ from __future__ import annotations
24
+
25
+ import logging
26
+ import re
27
+ from typing import TYPE_CHECKING
28
+
29
+ from novacode_cli.skills import versioning
30
+
31
+ if TYPE_CHECKING:
32
+ from pathlib import Path
33
+
34
+ logger = logging.getLogger("nova.skills.prune")
35
+
36
+ #: Sources whose skills may be archived. ``claude`` is a bundled/read-only
37
+ #: source; plugin skills are managed by their plugin and never pruned here.
38
+ PRUNABLE_SOURCES = frozenset({"user", "project"})
39
+
40
+ _DESCRIPTION_RE = re.compile(r"^description:\s*(.+)$", re.MULTILINE)
41
+
42
+
43
+ def _read_description(skill_md: Path) -> str:
44
+ """Frontmatter ``description`` from a SKILL.md (best-effort, "" on failure)."""
45
+ try:
46
+ text = skill_md.read_text(encoding="utf-8")
47
+ except OSError:
48
+ return ""
49
+ match = _DESCRIPTION_RE.search(text)
50
+ return match.group(1).strip().strip("\"'") if match else ""
51
+
52
+
53
+ def archive_root_for(skills_dir: Path) -> Path:
54
+ """The archive directory that :func:`versioning.archive_skill` uses."""
55
+ return skills_dir.parent / "skills-archive"
56
+
57
+
58
+ def _skill_dirs() -> list[tuple[Path, str]]:
59
+ """Every directory that can hold a skill, as ``(dir, source)``.
60
+
61
+ Order matches :func:`find_skill_dir` precedence (user → project → claude).
62
+ Scanning these directly keeps this module free of the deepagents import that
63
+ ``list_skills`` pulls in, so the TUI opens without a multi-second stall.
64
+ """
65
+ from novacode_cli.config.config import Settings
66
+
67
+ settings = Settings.from_environment()
68
+ dirs: list[tuple[Path, str]] = [(settings.get_global_skills_dir(), "user")]
69
+ dirs.extend((project_dir, "project") for project_dir in settings.get_project_skills_dirs())
70
+ dirs.append((Settings.get_global_claude_skills_dir(), "claude"))
71
+ return dirs
72
+
73
+
74
+ def candidates(usage: dict[str, dict] | None = None) -> list[dict]:
75
+ """Every installed skill, marked with whether it may be pruned.
76
+
77
+ ``usage`` optionally maps skill name → ``{"invocations": int}`` (from the
78
+ Hermes store); when omitted, counts are reported as 0. Missing usage is
79
+ normal — the learning loop is opt-in — so callers must not read absence as
80
+ "unused".
81
+
82
+ Returns dicts with ``name``, ``source``, ``path``, ``description``,
83
+ ``invocations`` and ``prunable`` (False for bundled/plugin sources).
84
+ """
85
+ usage = usage or {}
86
+ out: list[dict] = []
87
+ seen: set[str] = set()
88
+
89
+ for directory, source in _skill_dirs():
90
+ if not directory.exists():
91
+ continue
92
+ try:
93
+ children = sorted(directory.iterdir())
94
+ except OSError:
95
+ continue
96
+ for child in children:
97
+ # Dot-dirs hold version history, not skills.
98
+ if not child.is_dir() or child.name.startswith("."):
99
+ continue
100
+ skill_md = child / "SKILL.md"
101
+ if not skill_md.is_file() or child.name in seen:
102
+ continue
103
+ seen.add(child.name)
104
+ out.append(
105
+ {
106
+ "name": child.name,
107
+ "source": source,
108
+ "path": child,
109
+ "description": _read_description(skill_md),
110
+ "invocations": int(usage.get(child.name, {}).get("invocations", 0)),
111
+ "prunable": source in PRUNABLE_SOURCES,
112
+ }
113
+ )
114
+
115
+ out.sort(key=lambda item: (item["source"], item["name"]))
116
+ return out
117
+
118
+
119
+ def _forget_prefs(name: str) -> None:
120
+ """Drop ``name`` from the disabled set, so no stale entry outlives it."""
121
+ from novacode_cli.skills import skills_prefs
122
+
123
+ for scope in ("global", "project"):
124
+ path = skills_prefs.scope_path(scope)
125
+ if path is None or not path.exists():
126
+ continue
127
+ disabled = skills_prefs.load_disabled(path)
128
+ if name in disabled:
129
+ disabled.discard(name)
130
+ skills_prefs.save_disabled(path, disabled)
131
+
132
+
133
+ def archive_one(name: str) -> tuple[bool, str]:
134
+ """Archive a single skill. Returns ``(ok, message)``.
135
+
136
+ Mirrors the agent's ``skill_manage delete``: refuse bundled skills, move the
137
+ directory to the archive, then drop its ``skill_lock`` entry and any stale
138
+ curation preference.
139
+ """
140
+ from novacode_cli.skills.load import find_skill_dir
141
+
142
+ resolved = find_skill_dir(name)
143
+ if resolved is None:
144
+ return False, f"no skill named '{name}' found"
145
+ skill_dir, source = resolved
146
+ if source not in PRUNABLE_SOURCES:
147
+ return False, f"'{name}' is a bundled {source} skill and cannot be removed"
148
+
149
+ dest = versioning.archive_skill(skill_dir)
150
+ if dest is None:
151
+ return False, f"could not archive '{name}'"
152
+
153
+ # Best-effort cleanup — a failure here must not report the archive as failed.
154
+ try:
155
+ from novacode_cli.skills.skill_lock import SkillLock
156
+
157
+ SkillLock.for_skills_dir(skill_dir.parent).remove(name)
158
+ except Exception: # noqa: BLE001
159
+ logger.debug("Could not drop lock entry for %s", name, exc_info=True)
160
+ try:
161
+ _forget_prefs(name)
162
+ except Exception: # noqa: BLE001
163
+ logger.debug("Could not clean prefs for %s", name, exc_info=True)
164
+
165
+ return True, f"archived '{name}' (recoverable)"
166
+
167
+
168
+ def archive_many(names: list[str]) -> list[tuple[str, bool, str]]:
169
+ """Archive each name in turn. Returns ``[(name, ok, message), ...]``.
170
+
171
+ Never raises for a single failure: the caller reports per-skill outcomes so
172
+ a partial prune is visible rather than silently swallowed.
173
+ """
174
+ return [(name, *archive_one(name)) for name in names]
175
+
176
+
177
+ def list_archived_skills() -> list[dict]:
178
+ """Archived skills from both the global and project archives (newest first).
179
+
180
+ Each entry gains a ``root`` key naming the archive it came from, which
181
+ :func:`restore_skill` needs in order to put it back in the right place.
182
+ """
183
+ from novacode_cli.config.config import Settings
184
+
185
+ settings = Settings.from_environment()
186
+ roots: list[Path] = [archive_root_for(settings.get_global_skills_dir())]
187
+ project_dir = settings.get_project_skills_dir()
188
+ if project_dir is not None:
189
+ roots.append(archive_root_for(project_dir))
190
+
191
+ out: list[dict] = []
192
+ for root in roots:
193
+ out.extend({**entry, "root": root} for entry in versioning.list_archived(root))
194
+ out.sort(key=lambda item: item["archived_at"], reverse=True)
195
+ return out
196
+
197
+
198
+ def restore_skill(archive_dir: Path) -> tuple[bool, str]:
199
+ """Restore an archived skill to where it came from.
200
+
201
+ Delegates to :func:`versioning.restore_archived`, which refuses to clobber
202
+ an existing skill of the same name.
203
+ """
204
+ return versioning.restore_archived(archive_dir)
205
+
206
+
207
+ __all__ = [
208
+ "PRUNABLE_SOURCES",
209
+ "archive_many",
210
+ "archive_one",
211
+ "archive_root_for",
212
+ "candidates",
213
+ "list_archived_skills",
214
+ "restore_skill",
215
+ ]