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.
- novacode_cli/__init__.py +29 -0
- novacode_cli/__main__.py +6 -0
- novacode_cli/_lazy_heavy.py +99 -0
- novacode_cli/_version.py +3 -0
- novacode_cli/agent_stream.py +178 -0
- novacode_cli/agents/agent_file.py +250 -0
- novacode_cli/agents/agent_mailbox.py +120 -0
- novacode_cli/agents/approval_decisions.py +146 -0
- novacode_cli/agents/arg_repair.py +196 -0
- novacode_cli/agents/async_agents/__init__.py +6 -0
- novacode_cli/agents/async_agents/_config.py +213 -0
- novacode_cli/agents/async_agents/_mcp_tools.py +192 -0
- novacode_cli/agents/async_agents/_specialist.py +84 -0
- novacode_cli/agents/async_agents/_test_commands.py +89 -0
- novacode_cli/agents/async_agents/_tools.py +432 -0
- novacode_cli/agents/async_agents/general_purpose.py +42 -0
- novacode_cli/agents/async_agents/langgraph.json +9 -0
- novacode_cli/agents/async_agents/research.py +22 -0
- novacode_cli/agents/async_context.py +303 -0
- novacode_cli/agents/async_on_demand.py +52 -0
- novacode_cli/agents/async_task_errors.py +75 -0
- novacode_cli/agents/async_workspace.py +27 -0
- novacode_cli/agents/attribution.py +165 -0
- novacode_cli/agents/browser_mode.py +119 -0
- novacode_cli/agents/btw_agent.py +71 -0
- novacode_cli/agents/caveman.py +352 -0
- novacode_cli/agents/caveman_support.py +370 -0
- novacode_cli/agents/code_mode.py +774 -0
- novacode_cli/agents/code_runtime.py +160 -0
- novacode_cli/agents/context_compaction.py +1339 -0
- novacode_cli/agents/core_agent.py +2710 -0
- novacode_cli/agents/default_subagents/__init__.py +24 -0
- novacode_cli/agents/default_subagents/async_subagents.py +296 -0
- novacode_cli/agents/default_subagents/builtin/browser-automation-agent.md +110 -0
- novacode_cli/agents/default_subagents/builtin/bug-fix-agent.md +22 -0
- novacode_cli/agents/default_subagents/builtin/bug-investigation-agent.md +42 -0
- novacode_cli/agents/default_subagents/builtin/code-explorer.md +37 -0
- novacode_cli/agents/default_subagents/builtin/code-review-agent.md +33 -0
- novacode_cli/agents/default_subagents/builtin/dependency-audit-agent.md +34 -0
- novacode_cli/agents/default_subagents/builtin/documentation-update-agent.md +46 -0
- novacode_cli/agents/default_subagents/builtin/performance-audit-agent.md +41 -0
- novacode_cli/agents/default_subagents/builtin/plan-scout-agent.md +64 -0
- novacode_cli/agents/default_subagents/builtin/refactoring-agent.md +35 -0
- novacode_cli/agents/default_subagents/builtin/refactoring-specialist-agent.md +175 -0
- novacode_cli/agents/default_subagents/builtin/security-audit-agent.md +96 -0
- novacode_cli/agents/default_subagents/builtin/test-generation-agent.md +33 -0
- novacode_cli/agents/default_subagents/builtin/test-runner-agent.md +55 -0
- novacode_cli/agents/default_subagents/prompt.py +88 -0
- novacode_cli/agents/default_subagents/subagents.py +138 -0
- novacode_cli/agents/dream_agent.py +93 -0
- novacode_cli/agents/edit_diagnostics.py +362 -0
- novacode_cli/agents/edit_fallback.py +62 -0
- novacode_cli/agents/handoff.py +166 -0
- novacode_cli/agents/invocation.py +152 -0
- novacode_cli/agents/model_budget.py +42 -0
- novacode_cli/agents/model_retry.py +113 -0
- novacode_cli/agents/model_router.py +420 -0
- novacode_cli/agents/openai_decisions.py +186 -0
- novacode_cli/agents/plan_agent/__init__.py +12 -0
- novacode_cli/agents/plan_agent/plan_agent.py +357 -0
- novacode_cli/agents/plan_agent/plan_mode_middleware.py +64 -0
- novacode_cli/agents/plan_execution.py +237 -0
- novacode_cli/agents/ponytail.py +66 -0
- novacode_cli/agents/prime.py +274 -0
- novacode_cli/agents/provider_caching.py +99 -0
- novacode_cli/agents/server_launcher.py +904 -0
- novacode_cli/agents/strict_tools.py +384 -0
- novacode_cli/agents/task_discipline.py +294 -0
- novacode_cli/agents/tool_call_repair.py +290 -0
- novacode_cli/agents/tool_offload.py +291 -0
- novacode_cli/agents/tool_search.py +806 -0
- novacode_cli/agents/tool_search_variants.py +106 -0
- novacode_cli/agents/tool_verdicts.py +1194 -0
- novacode_cli/agents/user_async_agents.py +312 -0
- novacode_cli/artifacts/__init__.py +10 -0
- novacode_cli/artifacts/registry.py +278 -0
- novacode_cli/artifacts/server.py +426 -0
- novacode_cli/assets/Nova.png +0 -0
- novacode_cli/assets/nova-avatar.png +0 -0
- novacode_cli/audio/__init__.py +301 -0
- novacode_cli/audio/capture.py +137 -0
- novacode_cli/audio/downloads.py +273 -0
- novacode_cli/audio/pipeline.py +391 -0
- novacode_cli/audio/playback.py +87 -0
- novacode_cli/audio/providers.py +208 -0
- novacode_cli/audio/speakable.py +78 -0
- novacode_cli/audio/stt.py +132 -0
- novacode_cli/audio/stt_deepgram.py +69 -0
- novacode_cli/audio/stt_elevenlabs.py +89 -0
- novacode_cli/audio/stt_parakeet.py +94 -0
- novacode_cli/audio/stt_whistle.py +61 -0
- novacode_cli/audio/summarize.py +92 -0
- novacode_cli/audio/tts.py +85 -0
- novacode_cli/audio/tts_kokoro.py +73 -0
- novacode_cli/audio/tts_orpheus.py +180 -0
- novacode_cli/audio/tts_pocket.py +131 -0
- novacode_cli/audio/tts_sano.py +69 -0
- novacode_cli/audio/vad.py +145 -0
- novacode_cli/backends/__init__.py +17 -0
- novacode_cli/backends/filesystem.py +894 -0
- novacode_cli/backends/native_search.py +92 -0
- novacode_cli/bootstrap/__init__.py +9 -0
- novacode_cli/bootstrap/env_snapshot.py +240 -0
- novacode_cli/bootstrap/steering.py +464 -0
- novacode_cli/bootstrap/vision_router.py +604 -0
- novacode_cli/brand.py +362 -0
- novacode_cli/cli_args.py +718 -0
- novacode_cli/commands/__init__.py +237 -0
- novacode_cli/commands/agents_commands.py +231 -0
- novacode_cli/commands/auth_handler.py +40 -0
- novacode_cli/commands/browser_use_handler.py +75 -0
- novacode_cli/commands/cache_handler.py +32 -0
- novacode_cli/commands/chat_handler.py +1357 -0
- novacode_cli/commands/ci_fix.py +171 -0
- novacode_cli/commands/claude_plan.py +331 -0
- novacode_cli/commands/codex_plan.py +195 -0
- novacode_cli/commands/commands.py +1113 -0
- novacode_cli/commands/create_handler.py +124 -0
- novacode_cli/commands/create_server.py +1887 -0
- novacode_cli/commands/cron_handler.py +119 -0
- novacode_cli/commands/dream_handler.py +203 -0
- novacode_cli/commands/effort_handler.py +65 -0
- novacode_cli/commands/evolution_handler.py +214 -0
- novacode_cli/commands/file_commands.py +381 -0
- novacode_cli/commands/handoff_handler.py +68 -0
- novacode_cli/commands/hooks_handler.py +269 -0
- novacode_cli/commands/init_handler.py +146 -0
- novacode_cli/commands/learning_handler.py +160 -0
- novacode_cli/commands/lite_mode_handler.py +76 -0
- novacode_cli/commands/log_commands.py +363 -0
- novacode_cli/commands/mcp_handler.py +29 -0
- novacode_cli/commands/model_handler.py +29 -0
- novacode_cli/commands/notifications_handler.py +158 -0
- novacode_cli/commands/onboard_handler.py +121 -0
- novacode_cli/commands/plan_handler.py +440 -0
- novacode_cli/commands/planner_usage.py +250 -0
- novacode_cli/commands/plugin_install_handler.py +38 -0
- novacode_cli/commands/plugins_handler.py +35 -0
- novacode_cli/commands/prime_handler.py +455 -0
- novacode_cli/commands/prompt_handler.py +149 -0
- novacode_cli/commands/provider_usage.py +160 -0
- novacode_cli/commands/ralph_events.py +106 -0
- novacode_cli/commands/ralph_handler.py +1293 -0
- novacode_cli/commands/refine_handler.py +213 -0
- novacode_cli/commands/research_handler.py +202 -0
- novacode_cli/commands/rootapp_remote.py +83 -0
- novacode_cli/commands/router_handler.py +36 -0
- novacode_cli/commands/server_commands.py +249 -0
- novacode_cli/commands/session_commands.py +203 -0
- novacode_cli/commands/share_handler.py +450 -0
- novacode_cli/commands/side_commands.py +366 -0
- novacode_cli/commands/skill_invoke.py +420 -0
- novacode_cli/commands/skills_commands.py +48 -0
- novacode_cli/commands/trace_handler.py +322 -0
- novacode_cli/commands/trello_handler.py +226 -0
- novacode_cli/commands/trello_remote.py +177 -0
- novacode_cli/commands/trello_server.py +1214 -0
- novacode_cli/commands/vision_handler.py +127 -0
- novacode_cli/commands/voice_handler.py +447 -0
- novacode_cli/commands/webhook_handler.py +134 -0
- novacode_cli/commands/wiki_commands.py +227 -0
- novacode_cli/compaction.py +753 -0
- novacode_cli/computation_cache.py +159 -0
- novacode_cli/computer/__init__.py +1 -0
- novacode_cli/computer/persistent.py +234 -0
- novacode_cli/computer/preview.py +253 -0
- novacode_cli/computer/runtime.py +474 -0
- novacode_cli/computer/windows_console.py +152 -0
- novacode_cli/computer/windows_qemu.py +211 -0
- novacode_cli/config/browser_mode.py +159 -0
- novacode_cli/config/catalog_models.py +95 -0
- novacode_cli/config/config.py +1388 -0
- novacode_cli/config/credentials.py +540 -0
- novacode_cli/config/google_oauth_auth.py +281 -0
- novacode_cli/config/model_capabilities.py +343 -0
- novacode_cli/config/model_catalog.py +275 -0
- novacode_cli/config/model_create.py +1325 -0
- novacode_cli/config/model_manager.py +695 -0
- novacode_cli/config/nova_config.py +1283 -0
- novacode_cli/config/openai_chatgpt_auth.py +384 -0
- novacode_cli/config/opencode_gateway.py +25 -0
- novacode_cli/config/plan_mode.py +188 -0
- novacode_cli/config/provider_auth.py +438 -0
- novacode_cli/config/provider_catalog.json +5127 -0
- novacode_cli/config/provider_registry.py +38 -0
- novacode_cli/config/provider_transports.py +258 -0
- novacode_cli/config/role_models.py +175 -0
- novacode_cli/context/__init__.py +50 -0
- novacode_cli/context/_analysis.py +799 -0
- novacode_cli/context/_budget.py +116 -0
- novacode_cli/context/_conversation.py +73 -0
- novacode_cli/context/_dynamic.py +264 -0
- novacode_cli/context/_model_config.py +380 -0
- novacode_cli/context/_models_dev.py +99 -0
- novacode_cli/context/archives.py +248 -0
- novacode_cli/context/estimates.py +65 -0
- novacode_cli/context/history.py +17 -0
- novacode_cli/context/knowledge_cache.py +292 -0
- novacode_cli/context/manager.py +101 -0
- novacode_cli/context/observations.py +65 -0
- novacode_cli/context/pressure.py +168 -0
- novacode_cli/context/provider_accounting.py +109 -0
- novacode_cli/context/snapshot.py +493 -0
- novacode_cli/context/strategies.py +279 -0
- novacode_cli/context/task_progress.py +122 -0
- novacode_cli/core/__init__.py +0 -0
- novacode_cli/core/agent_loop.py +1821 -0
- novacode_cli/core/autonomous_loop.py +277 -0
- novacode_cli/core/code_approvals.py +57 -0
- novacode_cli/core/input_preparation.py +276 -0
- novacode_cli/core/reasoning.py +67 -0
- novacode_cli/core/streaming.py +326 -0
- novacode_cli/core/subagent_tasks.py +696 -0
- novacode_cli/core/subagent_tracking.py +235 -0
- novacode_cli/core/tool_results.py +116 -0
- novacode_cli/core/verification_loop.py +272 -0
- novacode_cli/council.py +595 -0
- novacode_cli/council_consensus.py +115 -0
- novacode_cli/council_decision.py +157 -0
- novacode_cli/council_planner.py +1421 -0
- novacode_cli/council_settings.py +208 -0
- novacode_cli/council_web_settings.py +41 -0
- novacode_cli/council_workspace.py +56 -0
- novacode_cli/cowork/__init__.py +10 -0
- novacode_cli/cowork/broker_middleware.py +162 -0
- novacode_cli/cowork/launcher.py +102 -0
- novacode_cli/cowork/policy.py +284 -0
- novacode_cli/cowork/ui.py +826 -0
- novacode_cli/daemons/__init__.py +1 -0
- novacode_cli/daemons/registry.py +342 -0
- novacode_cli/desktop_notifications.py +302 -0
- novacode_cli/doctor.py +251 -0
- novacode_cli/embeddings.py +109 -0
- novacode_cli/entrypoint.py +56 -0
- novacode_cli/errors/__init__.py +19 -0
- novacode_cli/errors/handlers.py +648 -0
- novacode_cli/errors/provider_errors.py +249 -0
- novacode_cli/errors/taxonomy.py +80 -0
- novacode_cli/events.py +179 -0
- novacode_cli/file_ops.py +714 -0
- novacode_cli/git_safety.py +281 -0
- novacode_cli/handoff.py +383 -0
- novacode_cli/headless/__init__.py +18 -0
- novacode_cli/headless/input.py +58 -0
- novacode_cli/headless/output.py +224 -0
- novacode_cli/headless/pipe.py +532 -0
- novacode_cli/headless/runner.py +461 -0
- novacode_cli/hermes/__init__.py +39 -0
- novacode_cli/hermes/activation.py +297 -0
- novacode_cli/hermes/config.py +129 -0
- novacode_cli/hermes/curator.py +199 -0
- novacode_cli/hermes/evolution.py +374 -0
- novacode_cli/hermes/ledger.py +364 -0
- novacode_cli/hermes/memory_tiers.py +969 -0
- novacode_cli/hermes/middleware.py +678 -0
- novacode_cli/hermes/overview.py +174 -0
- novacode_cli/hermes/prompt_evolution.py +503 -0
- novacode_cli/hermes/refine_loop.py +643 -0
- novacode_cli/hermes/refinement_log.py +190 -0
- novacode_cli/hermes/review.py +674 -0
- novacode_cli/hermes/skill_debate.py +135 -0
- novacode_cli/hermes/skill_discovery.py +450 -0
- novacode_cli/hermes/skill_manager.py +335 -0
- novacode_cli/hermes/skill_proposals.py +43 -0
- novacode_cli/hermes/test_gaming.py +119 -0
- novacode_cli/hermes/tracker.py +435 -0
- novacode_cli/hermes/tuner.py +206 -0
- novacode_cli/hermes/verification_memory.py +134 -0
- novacode_cli/hermes/verifier.py +277 -0
- novacode_cli/hitl/__init__.py +22 -0
- novacode_cli/hitl/interrupts.py +493 -0
- novacode_cli/hooks.py +359 -0
- novacode_cli/image_utils.py +517 -0
- novacode_cli/init/__init__.py +7 -0
- novacode_cli/init/events.py +43 -0
- novacode_cli/input_utils.py +526 -0
- novacode_cli/install_commands.py +87 -0
- novacode_cli/integrations/__init__.py +82 -0
- novacode_cli/integrations/daytona.py +122 -0
- novacode_cli/integrations/docker.py +309 -0
- novacode_cli/integrations/host_path.py +111 -0
- novacode_cli/integrations/langsmith.py +151 -0
- novacode_cli/integrations/modal.py +134 -0
- novacode_cli/integrations/runloop.py +130 -0
- novacode_cli/integrations/sandbox_factory.py +1388 -0
- novacode_cli/integrations/sandbox_registry.py +312 -0
- novacode_cli/integrations/workdir_backend.py +589 -0
- novacode_cli/main.py +2078 -0
- novacode_cli/mcp/__init__.py +73 -0
- novacode_cli/mcp/auth.py +189 -0
- novacode_cli/mcp/client.py +571 -0
- novacode_cli/mcp/code_mode.py +5 -0
- novacode_cli/mcp/code_runtime.py +5 -0
- novacode_cli/mcp/commands.py +902 -0
- novacode_cli/mcp/config.py +406 -0
- novacode_cli/mcp/generic.py +128 -0
- novacode_cli/mcp/middleware.py +993 -0
- novacode_cli/mcp/presets.py +367 -0
- novacode_cli/memory/__init__.py +1 -0
- novacode_cli/memory/agent_memory.py +1312 -0
- novacode_cli/memory/builtin_lessons.py +60 -0
- novacode_cli/memory/dream_gates.py +192 -0
- novacode_cli/memory/limits.py +59 -0
- novacode_cli/memory/parsed_cache.py +106 -0
- novacode_cli/memory/recall_stats.py +97 -0
- novacode_cli/memory/semantic.py +116 -0
- novacode_cli/memory/store.py +335 -0
- novacode_cli/memory/wiki.py +274 -0
- novacode_cli/migrate.py +185 -0
- novacode_cli/onboarding.py +649 -0
- novacode_cli/onboarding_check.py +119 -0
- novacode_cli/path_approval.py +297 -0
- novacode_cli/plan_archive.py +148 -0
- novacode_cli/plugins/__init__.py +121 -0
- novacode_cli/plugins/claude_plugins.py +538 -0
- novacode_cli/plugins/cli.py +168 -0
- novacode_cli/plugins/components.py +413 -0
- novacode_cli/plugins/hooks.py +356 -0
- novacode_cli/plugins/loader.py +317 -0
- novacode_cli/plugins/marketplaces.py +199 -0
- novacode_cli/plugins/storage.py +70 -0
- novacode_cli/prime.py +759 -0
- novacode_cli/prime_factory/__init__.py +15 -0
- novacode_cli/prime_factory/container.py +198 -0
- novacode_cli/prime_factory/controller.py +565 -0
- novacode_cli/prime_factory/knowledge.py +261 -0
- novacode_cli/prime_factory/publication.py +218 -0
- novacode_cli/prime_factory/recovery.py +50 -0
- novacode_cli/prime_factory/research.py +370 -0
- novacode_cli/prime_factory/runner.py +608 -0
- novacode_cli/prime_factory/runtime.py +261 -0
- novacode_cli/prime_factory/state.py +201 -0
- novacode_cli/prime_factory/store.py +128 -0
- novacode_cli/prime_factory/worker.py +129 -0
- novacode_cli/prime_factory/workflow.py +899 -0
- novacode_cli/prime_factory/workspace.py +317 -0
- novacode_cli/prime_memory.py +290 -0
- novacode_cli/process_manager.py +585 -0
- novacode_cli/project_onboard.py +537 -0
- novacode_cli/prompts/System_Prompt_Nova.jinja +23 -0
- novacode_cli/prompts/__init__.py +168 -0
- novacode_cli/prompts/agent_definitions.jinja +11 -0
- novacode_cli/prompts/agent_generation.jinja +125 -0
- novacode_cli/prompts/async_agents/general_purpose.jinja +22 -0
- novacode_cli/prompts/claude_plan_mode.jinja +12 -0
- novacode_cli/prompts/coding_workflow.jinja +18 -0
- novacode_cli/prompts/computer_use.jinja +17 -0
- novacode_cli/prompts/core_agent_system.jinja +81 -0
- novacode_cli/prompts/delegation.jinja +15 -0
- novacode_cli/prompts/desktop_power.jinja +4 -0
- novacode_cli/prompts/file_paths.jinja +15 -0
- novacode_cli/prompts/file_tracker.jinja +23 -0
- novacode_cli/prompts/init_agents_md.jinja +56 -0
- novacode_cli/prompts/init_exploration.jinja +174 -0
- novacode_cli/prompts/init_semantic_orchestrate.jinja +37 -0
- novacode_cli/prompts/instruction_scope.jinja +5 -0
- novacode_cli/prompts/learnings_extraction.jinja +45 -0
- novacode_cli/prompts/longterm_memory.jinja +54 -0
- novacode_cli/prompts/mcp.jinja +84 -0
- novacode_cli/prompts/memory_consolidation.jinja +40 -0
- novacode_cli/prompts/nova_evolution.jinja +73 -0
- novacode_cli/prompts/nova_review.jinja +158 -0
- novacode_cli/prompts/nova_skill_debate.jinja +36 -0
- novacode_cli/prompts/nova_standing_instructions.jinja +26 -0
- novacode_cli/prompts/nova_verify.jinja +100 -0
- novacode_cli/prompts/onboard_dashboard.jinja +378 -0
- novacode_cli/prompts/plan_agent.jinja +87 -0
- novacode_cli/prompts/plan_scouts.jinja +5 -0
- novacode_cli/prompts/plan_storage.jinja +8 -0
- novacode_cli/prompts/planning.jinja +82 -0
- novacode_cli/prompts/ponytail/LICENSE +21 -0
- novacode_cli/prompts/ponytail/UPSTREAM.json +15 -0
- novacode_cli/prompts/ponytail/hooks/ponytail-config.js +175 -0
- novacode_cli/prompts/ponytail/hooks/ponytail-instructions.js +98 -0
- novacode_cli/prompts/ponytail/skills/ponytail/SKILL.md +52 -0
- novacode_cli/prompts/ponytail/skills/ponytail-audit/SKILL.md +103 -0
- novacode_cli/prompts/ponytail/skills/ponytail-debt/SKILL.md +44 -0
- novacode_cli/prompts/ponytail/skills/ponytail-gain/SKILL.md +52 -0
- novacode_cli/prompts/ponytail/skills/ponytail-help/SKILL.md +76 -0
- novacode_cli/prompts/ponytail/skills/ponytail-review/SKILL.md +101 -0
- novacode_cli/prompts/prompt_evolution.jinja +27 -0
- novacode_cli/prompts/ralph_iteration.jinja +75 -0
- novacode_cli/prompts/refine_gate.jinja +31 -0
- novacode_cli/prompts/refine_plan.jinja +64 -0
- novacode_cli/prompts/refine_review.jinja +34 -0
- novacode_cli/prompts/research_delivery.jinja +9 -0
- novacode_cli/prompts/research_swarm.jinja +130 -0
- novacode_cli/prompts/response_style.jinja +5 -0
- novacode_cli/prompts/session_summarization.jinja +86 -0
- novacode_cli/prompts/skill_creation.jinja +85 -0
- novacode_cli/prompts/subagents/fact_checker.jinja +48 -0
- novacode_cli/prompts/subagents/financial_analyst.jinja +50 -0
- novacode_cli/prompts/subagents/literature_reviewer.jinja +52 -0
- novacode_cli/prompts/subagents/market_analyst.jinja +48 -0
- novacode_cli/prompts/subagents/research_synthesizer.jinja +57 -0
- novacode_cli/prompts/subagents/technical_researcher.jinja +56 -0
- novacode_cli/prompts/subagents/web_researcher.jinja +46 -0
- novacode_cli/prompts/summarization.jinja +107 -0
- novacode_cli/prompts/summarization_answers.jinja +23 -0
- novacode_cli/prompts/summarization_questions.jinja +32 -0
- novacode_cli/prompts/vision_caption.jinja +21 -0
- novacode_cli/prompts/voice_summary.jinja +65 -0
- novacode_cli/prompts/wiki_file.jinja +57 -0
- novacode_cli/prompts/wiki_ingest.jinja +87 -0
- novacode_cli/recovery.py +383 -0
- novacode_cli/remote/__init__.py +45 -0
- novacode_cli/remote/approvals.py +282 -0
- novacode_cli/remote/async_task_clients.py +97 -0
- novacode_cli/remote/async_task_watcher.py +240 -0
- novacode_cli/remote/bridge.py +905 -0
- novacode_cli/remote/command_menu.py +26 -0
- novacode_cli/remote/command_ui.py +243 -0
- novacode_cli/remote/config.py +199 -0
- novacode_cli/remote/discord_bridge.py +530 -0
- novacode_cli/remote/discord_format.py +31 -0
- novacode_cli/remote/discord_threads.py +225 -0
- novacode_cli/remote/images.py +97 -0
- novacode_cli/remote/processor.py +601 -0
- novacode_cli/remote/rootapp_bot/bot.cjs +16 -0
- novacode_cli/remote/rootapp_bot/package-lock.json +2683 -0
- novacode_cli/remote/rootapp_bot/package.json +18 -0
- novacode_cli/remote/rootapp_bot/transport.cjs +80 -0
- novacode_cli/remote/rootapp_bridge.py +370 -0
- novacode_cli/remote/rootapp_setup.py +89 -0
- novacode_cli/remote/routing.py +103 -0
- novacode_cli/remote/scheduler.py +302 -0
- novacode_cli/remote/session.py +164 -0
- novacode_cli/remote/status.py +411 -0
- novacode_cli/remote/streaming.py +188 -0
- novacode_cli/remote/telegram_bridge.py +1118 -0
- novacode_cli/remote/telegram_format.py +215 -0
- novacode_cli/remote/telegram_hub.py +256 -0
- novacode_cli/remote/voice_notes.py +120 -0
- novacode_cli/remote/webhook_adapters.py +167 -0
- novacode_cli/remote/webhook_server.py +154 -0
- novacode_cli/rewind.py +150 -0
- novacode_cli/rooms/__init__.py +1 -0
- novacode_cli/rooms/bridge.py +86 -0
- novacode_cli/rooms/cli.py +231 -0
- novacode_cli/rooms/nova.py +227 -0
- novacode_cli/rooms/runtime.py +299 -0
- novacode_cli/rooms/store.py +538 -0
- novacode_cli/rooms/workspace.py +94 -0
- novacode_cli/security/__init__.py +29 -0
- novacode_cli/security/approval_context.py +45 -0
- novacode_cli/security/delegated_approval.py +68 -0
- novacode_cli/security/local_http.py +85 -0
- novacode_cli/security/middleware.py +87 -0
- novacode_cli/security/paths.py +35 -0
- novacode_cli/security/policy.py +535 -0
- novacode_cli/security/policy_writer.py +90 -0
- novacode_cli/security/prompt_injection.py +203 -0
- novacode_cli/security/remember.py +81 -0
- novacode_cli/security/rule_synthesis.py +116 -0
- novacode_cli/security/secret_files.py +61 -0
- novacode_cli/security/session_allow.py +114 -0
- novacode_cli/security/unicode_security.py +516 -0
- novacode_cli/security/validator.py +173 -0
- novacode_cli/server/__init__.py +9 -0
- novacode_cli/server/app.py +632 -0
- novacode_cli/server/event_adapter.py +189 -0
- novacode_cli/server/session_manager.py +90 -0
- novacode_cli/server_main.py +64 -0
- novacode_cli/server_runner/dev_server.py +530 -0
- novacode_cli/server_runner/test_runner.py +470 -0
- novacode_cli/session/__init__.py +1 -0
- novacode_cli/session/adapters/__init__.py +240 -0
- novacode_cli/session/adapters/claude_code.py +102 -0
- novacode_cli/session/adapters/codex.py +77 -0
- novacode_cli/session/adapters/harness_native.py +75 -0
- novacode_cli/session/checkpoint_coordinator.py +448 -0
- novacode_cli/session/context_restore.py +25 -0
- novacode_cli/session/history_export.py +228 -0
- novacode_cli/session/history_tree.py +174 -0
- novacode_cli/session/imported_context.py +267 -0
- novacode_cli/session/runtime_identity.py +32 -0
- novacode_cli/session/session_persistence.py +1168 -0
- novacode_cli/session/session_prompt_builder.py +279 -0
- novacode_cli/session/session_restore.py +351 -0
- novacode_cli/session/session_summarization.py +20 -0
- novacode_cli/session/transcript_journal.py +153 -0
- novacode_cli/sessions/__init__.py +11 -0
- novacode_cli/sessions/gateway.py +84 -0
- novacode_cli/sessions/launch.py +51 -0
- novacode_cli/sessions/lease.py +213 -0
- novacode_cli/sessions/messaging.py +255 -0
- novacode_cli/sessions/protocol.py +216 -0
- novacode_cli/sessions/resume.py +31 -0
- novacode_cli/sessions/supervisor.py +498 -0
- novacode_cli/sessions/tasks.py +73 -0
- novacode_cli/sessions/tui_messaging.py +413 -0
- novacode_cli/sessions/worker.py +652 -0
- novacode_cli/sessions/worktree.py +262 -0
- novacode_cli/shell/__init__.py +27 -0
- novacode_cli/shell/jobs.py +475 -0
- novacode_cli/shell/middleware.py +1568 -0
- novacode_cli/shell/os_sandbox.py +205 -0
- novacode_cli/shell/output.py +181 -0
- novacode_cli/shell/patterns.py +275 -0
- novacode_cli/shell/processes.py +87 -0
- novacode_cli/shell/utils.py +236 -0
- novacode_cli/skills/__init__.py +26 -0
- novacode_cli/skills/builtin/handoff/SKILL.md +15 -0
- novacode_cli/skills/curation_middleware.py +69 -0
- novacode_cli/skills/executable.py +161 -0
- novacode_cli/skills/libraries.py +102 -0
- novacode_cli/skills/load.py +248 -0
- novacode_cli/skills/prune.py +215 -0
- novacode_cli/skills/refreshing_middleware.py +896 -0
- novacode_cli/skills/retrieval.py +248 -0
- novacode_cli/skills/runtime.py +118 -0
- novacode_cli/skills/schema.py +254 -0
- novacode_cli/skills/skill_creation.py +1549 -0
- novacode_cli/skills/skill_lock.py +75 -0
- novacode_cli/skills/skill_system_prompt.py +16 -0
- novacode_cli/skills/skills_prefs.py +126 -0
- novacode_cli/skills/tool_resolver.py +31 -0
- novacode_cli/skills/upstream.py +50 -0
- novacode_cli/skills/versioning.py +291 -0
- novacode_cli/states/Session.py +847 -0
- novacode_cli/states/__init__.py +31 -0
- novacode_cli/states/slices/__init__.py +17 -0
- novacode_cli/states/slices/agent_runtime.py +249 -0
- novacode_cli/states/slices/background_tasks.py +21 -0
- novacode_cli/states/slices/notifications.py +74 -0
- novacode_cli/states/slices/remote_bridge.py +56 -0
- novacode_cli/states/slices/ui_settings.py +49 -0
- novacode_cli/states/slices/wiki.py +25 -0
- novacode_cli/teammates/__init__.py +1 -0
- novacode_cli/teammates/controller.py +557 -0
- novacode_cli/teammates/graph.py +104 -0
- novacode_cli/teammates/registry.py +175 -0
- novacode_cli/teammates/service.py +254 -0
- novacode_cli/teammates/worker.py +19 -0
- novacode_cli/teams/__init__.py +1 -0
- novacode_cli/teams/adapters/__init__.py +1 -0
- novacode_cli/teams/adapters/container.py +316 -0
- novacode_cli/teams/adapters/inprocess.py +206 -0
- novacode_cli/teams/adapters/process.py +364 -0
- novacode_cli/teams/bootstrap.py +246 -0
- novacode_cli/teams/container_git.py +67 -0
- novacode_cli/teams/context.py +34 -0
- novacode_cli/teams/coordinator.py +815 -0
- novacode_cli/teams/gateway.py +200 -0
- novacode_cli/teams/host.py +64 -0
- novacode_cli/teams/legacy.py +52 -0
- novacode_cli/teams/middleware.py +176 -0
- novacode_cli/teams/models.py +104 -0
- novacode_cli/teams/output.py +47 -0
- novacode_cli/teams/protocol.py +50 -0
- novacode_cli/teams/recovery.py +80 -0
- novacode_cli/teams/scheduler.py +44 -0
- novacode_cli/teams/store.py +631 -0
- novacode_cli/teams/worker.py +251 -0
- novacode_cli/teams/workspace.py +100 -0
- novacode_cli/token_utils.py +256 -0
- novacode_cli/tools/__init__.py +104 -0
- novacode_cli/tools/_shared.py +97 -0
- novacode_cli/tools/_types.py +24 -0
- novacode_cli/tools/artifact_tools.py +137 -0
- novacode_cli/tools/code_search_tools.py +330 -0
- novacode_cli/tools/computer_tools.py +77 -0
- novacode_cli/tools/cron_tools.py +65 -0
- novacode_cli/tools/daemon_tool.py +290 -0
- novacode_cli/tools/desktop_tools.py +161 -0
- novacode_cli/tools/fetch_tools.py +530 -0
- novacode_cli/tools/http_tools.py +279 -0
- novacode_cli/tools/inspection_tools.py +107 -0
- novacode_cli/tools/job_tools.py +143 -0
- novacode_cli/tools/knowledge_tools.py +427 -0
- novacode_cli/tools/memory_tools.py +461 -0
- novacode_cli/tools/memory_wiki_tools.py +40 -0
- novacode_cli/tools/notebook_tools.py +238 -0
- novacode_cli/tools/oracle_tool.py +83 -0
- novacode_cli/tools/plan_archive_tools.py +80 -0
- novacode_cli/tools/plan_mode_tools.py +315 -0
- novacode_cli/tools/python_kernel_loop.py +165 -0
- novacode_cli/tools/python_kernel_tool.py +222 -0
- novacode_cli/tools/reflection_tools.py +34 -0
- novacode_cli/tools/scraper_tools.py +377 -0
- novacode_cli/tools/skill_tools.py +275 -0
- novacode_cli/tools/speak_tool.py +51 -0
- novacode_cli/tools/store_memory_tools.py +227 -0
- novacode_cli/tools/ui_tools.py +62 -0
- novacode_cli/tools/waiter_tools.py +408 -0
- novacode_cli/tools/web_tools.py +349 -0
- novacode_cli/tools/wiki_tools.py +152 -0
- novacode_cli/tools/worktree_tools.py +219 -0
- novacode_cli/tracking/__init__.py +10 -0
- novacode_cli/tracking/file_tracker.py +826 -0
- novacode_cli/tracking/local_metrics.py +170 -0
- novacode_cli/tracking/loop_guard.py +507 -0
- novacode_cli/tracking/request_metrics.py +60 -0
- novacode_cli/tracking/tracing.py +692 -0
- novacode_cli/tracking/usage_tree.py +677 -0
- novacode_cli/tracking/workspace_anchoring.py +231 -0
- novacode_cli/tui/__init__.py +11 -0
- novacode_cli/tui/animation_rate.py +9 -0
- novacode_cli/tui/animations.py +332 -0
- novacode_cli/tui/app.py +19315 -0
- novacode_cli/tui/auth_display.py +87 -0
- novacode_cli/tui/auth_screens.py +826 -0
- novacode_cli/tui/avatar.py +294 -0
- novacode_cli/tui/avatar_frames.py +21 -0
- novacode_cli/tui/background_tasks.py +35 -0
- novacode_cli/tui/browser_settings_screen.py +70 -0
- novacode_cli/tui/caveman_screen.py +185 -0
- novacode_cli/tui/council_settings_screen.py +182 -0
- novacode_cli/tui/council_view.py +535 -0
- novacode_cli/tui/decision_settings.py +268 -0
- novacode_cli/tui/diff_preview.py +199 -0
- novacode_cli/tui/gc_tuning.py +63 -0
- novacode_cli/tui/handoff_screen.py +206 -0
- novacode_cli/tui/harness.py +244 -0
- novacode_cli/tui/history_tree_screen.py +179 -0
- novacode_cli/tui/home.py +328 -0
- novacode_cli/tui/home_scene.py +94 -0
- novacode_cli/tui/icons.py +81 -0
- novacode_cli/tui/interface_styles.tcss +327 -0
- novacode_cli/tui/matrix3.py +108 -0
- novacode_cli/tui/mcp_tools_screen.py +131 -0
- novacode_cli/tui/motion.py +178 -0
- novacode_cli/tui/output_body.py +136 -0
- novacode_cli/tui/output_buffer.py +59 -0
- novacode_cli/tui/palette.py +334 -0
- novacode_cli/tui/pickers.py +237 -0
- novacode_cli/tui/prime_panel.py +506 -0
- novacode_cli/tui/provider_signin.py +213 -0
- novacode_cli/tui/pty_shell.py +159 -0
- novacode_cli/tui/reference_screens.py +444 -0
- novacode_cli/tui/resume_picker.py +346 -0
- novacode_cli/tui/rooms.py +597 -0
- novacode_cli/tui/screens.py +7088 -0
- novacode_cli/tui/session_import.py +333 -0
- novacode_cli/tui/session_pane.py +242 -0
- novacode_cli/tui/session_tab.py +42 -0
- novacode_cli/tui/session_transcript.py +118 -0
- novacode_cli/tui/shell_output.py +7 -0
- novacode_cli/tui/stall_watch.py +174 -0
- novacode_cli/tui/statusline.py +40 -0
- novacode_cli/tui/statusline_screen.py +91 -0
- novacode_cli/tui/teammate_updates.py +162 -0
- novacode_cli/tui/teammates.py +548 -0
- novacode_cli/tui/terminal.py +289 -0
- novacode_cli/tui/terminal_view.py +235 -0
- novacode_cli/tui/themes.py +118 -0
- novacode_cli/tui/update_notice.py +84 -0
- novacode_cli/tui/voice_downloads.py +113 -0
- novacode_cli/tui/widgets.py +2038 -0
- novacode_cli/tui/windows_input.py +38 -0
- novacode_cli/tui/workspace_approval.py +165 -0
- novacode_cli/ui/council_web.py +113 -0
- novacode_cli/ui/council_workspace.py +72 -0
- novacode_cli/ui/cowork_web.py +41 -0
- novacode_cli/ui/diff_highlight.py +160 -0
- novacode_cli/ui/execution.py +1396 -0
- novacode_cli/ui/exit_summary.py +65 -0
- novacode_cli/ui/hitl_approval.py +196 -0
- novacode_cli/ui/input_preparation.py +2 -0
- novacode_cli/ui/interrupt_handlers.py +215 -0
- novacode_cli/ui/question_prompt.py +151 -0
- novacode_cli/ui/status_phrases.py +157 -0
- novacode_cli/ui/stream_preview.py +66 -0
- novacode_cli/ui/streaming.py +2 -0
- novacode_cli/ui/subagent_tracking.py +2 -0
- novacode_cli/ui/ui_elements.py +1585 -0
- novacode_cli/ui/web_workspace.py +244 -0
- novacode_cli/ui_events.py +299 -0
- novacode_cli/update_ui.py +243 -0
- novacode_cli/updates.py +489 -0
- novacode_cli/utils/backend_patches.py +399 -0
- novacode_cli/utils/backend_paths.py +467 -0
- novacode_cli/utils/lazy_providers.py +51 -0
- novacode_cli/utils/model_info.py +223 -0
- novacode_cli/utils/pdf_extraction.py +183 -0
- novacode_cli/utils/startup.py +29 -0
- novacode_cli/utils/tasks.py +42 -0
- novacode_cli/utils/windows.py +9 -0
- novacode_cli/vixie/hook_adapter.py +127 -0
- novacode_cli/vixie/server.py +375 -0
- novacode_cli/wiki/__init__.py +15 -0
- novacode_cli/wiki/ask.py +56 -0
- novacode_cli/wiki/file.py +71 -0
- novacode_cli/wiki/ingest.py +184 -0
- novacode_cli/wiki/manager.py +261 -0
- novacode_cli-1.2.0.dist-info/METADATA +271 -0
- novacode_cli-1.2.0.dist-info/RECORD +691 -0
- novacode_cli-1.2.0.dist-info/WHEEL +5 -0
- novacode_cli-1.2.0.dist-info/entry_points.txt +2 -0
- novacode_cli-1.2.0.dist-info/licenses/LICENSE +21 -0
- 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
|
+
]
|