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,349 @@
|
|
|
1
|
+
"""Web search tools.
|
|
2
|
+
|
|
3
|
+
This module provides tools for searching the web using various search engines.
|
|
4
|
+
"""
|
|
5
|
+
|
|
6
|
+
from __future__ import annotations
|
|
7
|
+
|
|
8
|
+
from typing import Any, Literal
|
|
9
|
+
|
|
10
|
+
from langchain.tools import tool
|
|
11
|
+
|
|
12
|
+
from novacode_cli.config.config import settings
|
|
13
|
+
|
|
14
|
+
# Initialize Tavily client if API key is available
|
|
15
|
+
try:
|
|
16
|
+
from tavily import TavilyClient
|
|
17
|
+
|
|
18
|
+
tavily_client = TavilyClient(api_key=settings.tavily_api_key) if settings.has_tavily else None
|
|
19
|
+
except ImportError:
|
|
20
|
+
tavily_client = None
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
@tool
|
|
24
|
+
def web_search(
|
|
25
|
+
query: str,
|
|
26
|
+
max_results: int = 5,
|
|
27
|
+
topic: Literal["general", "news", "finance"] = "general",
|
|
28
|
+
include_raw_content: bool = False,
|
|
29
|
+
) -> dict[str, Any]:
|
|
30
|
+
"""Search the web using Tavily for current information and documentation.
|
|
31
|
+
|
|
32
|
+
This tool searches the web and returns relevant results. After receiving results,
|
|
33
|
+
you MUST synthesize the information into a natural, helpful response for the user.
|
|
34
|
+
|
|
35
|
+
Args:
|
|
36
|
+
query: The search query (be specific and detailed)
|
|
37
|
+
max_results: Number of results to return (default: 5)
|
|
38
|
+
topic: Search topic type - "general" for most queries, "news" for current events
|
|
39
|
+
include_raw_content: Include full page content (warning: uses more tokens)
|
|
40
|
+
|
|
41
|
+
Returns:
|
|
42
|
+
Dictionary containing:
|
|
43
|
+
- results: List of search results, each with:
|
|
44
|
+
- title: Page title
|
|
45
|
+
- url: Page URL
|
|
46
|
+
- content: Relevant excerpt from the page
|
|
47
|
+
- score: Relevance score (0-1)
|
|
48
|
+
- query: The original search query
|
|
49
|
+
|
|
50
|
+
IMPORTANT: After using this tool:
|
|
51
|
+
1. Read through the 'content' field of each result
|
|
52
|
+
2. Extract relevant information that answers the user's question
|
|
53
|
+
3. Synthesize this into a clear, natural language response
|
|
54
|
+
4. Cite sources by mentioning the page titles or URLs
|
|
55
|
+
5. NEVER show the raw JSON to the user - always provide a formatted response
|
|
56
|
+
"""
|
|
57
|
+
if tavily_client is None:
|
|
58
|
+
return {
|
|
59
|
+
"error": (
|
|
60
|
+
"Tavily API key not configured. Please set TAVILY_API_KEY environment variable."
|
|
61
|
+
),
|
|
62
|
+
"query": query,
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
try:
|
|
66
|
+
return tavily_client.search(
|
|
67
|
+
query,
|
|
68
|
+
max_results=max_results,
|
|
69
|
+
include_raw_content=include_raw_content,
|
|
70
|
+
topic=topic,
|
|
71
|
+
)
|
|
72
|
+
except Exception as e: # noqa: BLE001
|
|
73
|
+
return {"error": f"Web search error: {e!s}", "query": query}
|
|
74
|
+
|
|
75
|
+
|
|
76
|
+
@tool
|
|
77
|
+
def duckduckgo_search(
|
|
78
|
+
query: str,
|
|
79
|
+
max_results: int = 5,
|
|
80
|
+
region: str = "wt-wt",
|
|
81
|
+
safesearch: Literal["on", "moderate", "off"] = "moderate",
|
|
82
|
+
time_range: Literal["d", "w", "m", "y", ""] = "",
|
|
83
|
+
) -> dict[str, Any]:
|
|
84
|
+
"""Search the web using DuckDuckGo (no API key required).
|
|
85
|
+
|
|
86
|
+
A free alternative to Tavily for web search. Returns relevant search results
|
|
87
|
+
that you should synthesize into a natural response for the user.
|
|
88
|
+
|
|
89
|
+
Args:
|
|
90
|
+
query: The search query (be specific and detailed)
|
|
91
|
+
max_results: Number of results to return (default: 5, max: 20)
|
|
92
|
+
region: Region for search results (default: "wt-wt" for worldwide)
|
|
93
|
+
Examples: "us-en", "uk-en", "de-de", "fr-fr", "jp-jp"
|
|
94
|
+
safesearch: Safe search level - "on", "moderate", or "off"
|
|
95
|
+
time_range: Time filter - "d" (day), "w" (week), "m" (month), "y" (year), "" (any)
|
|
96
|
+
|
|
97
|
+
Returns:
|
|
98
|
+
Dictionary containing:
|
|
99
|
+
- success: Whether search succeeded
|
|
100
|
+
- results: List of search results, each with:
|
|
101
|
+
- title: Page title
|
|
102
|
+
- url: Page URL
|
|
103
|
+
- body: Relevant excerpt/snippet from the page
|
|
104
|
+
- query: The original search query
|
|
105
|
+
- total_results: Number of results returned
|
|
106
|
+
|
|
107
|
+
IMPORTANT: After using this tool:
|
|
108
|
+
1. Read through the 'body' field of each result
|
|
109
|
+
2. Extract relevant information that answers the user's question
|
|
110
|
+
3. Synthesize this into a clear, natural language response
|
|
111
|
+
4. Cite sources by mentioning the page titles or URLs
|
|
112
|
+
5. NEVER show the raw JSON to the user - always provide a formatted response
|
|
113
|
+
|
|
114
|
+
Example:
|
|
115
|
+
duckduckgo_search("Python asyncio tutorial")
|
|
116
|
+
duckduckgo_search("latest news AI", time_range="w")
|
|
117
|
+
"""
|
|
118
|
+
try:
|
|
119
|
+
from ddgs import DDGS
|
|
120
|
+
except ImportError:
|
|
121
|
+
try:
|
|
122
|
+
from duckduckgo_search import DDGS # Fallback to old package name
|
|
123
|
+
except ImportError:
|
|
124
|
+
return {
|
|
125
|
+
"success": False,
|
|
126
|
+
"error": "ddgs not installed. Install with: uv add ddgs",
|
|
127
|
+
"query": query,
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
# Limit max_results to reasonable bounds
|
|
131
|
+
max_results = min(max(1, max_results), 20)
|
|
132
|
+
|
|
133
|
+
try:
|
|
134
|
+
with DDGS() as ddgs:
|
|
135
|
+
results = list(
|
|
136
|
+
ddgs.text(
|
|
137
|
+
query,
|
|
138
|
+
region=region,
|
|
139
|
+
safesearch=safesearch,
|
|
140
|
+
timelimit=time_range if time_range else None,
|
|
141
|
+
max_results=max_results,
|
|
142
|
+
)
|
|
143
|
+
)
|
|
144
|
+
|
|
145
|
+
# Format results to match expected structure
|
|
146
|
+
formatted_results = [
|
|
147
|
+
{
|
|
148
|
+
"title": r.get("title", ""),
|
|
149
|
+
"url": r.get("href", r.get("link", "")),
|
|
150
|
+
"body": r.get("body", r.get("snippet", "")),
|
|
151
|
+
}
|
|
152
|
+
for r in results
|
|
153
|
+
]
|
|
154
|
+
|
|
155
|
+
return {
|
|
156
|
+
"success": True,
|
|
157
|
+
"results": formatted_results,
|
|
158
|
+
"query": query,
|
|
159
|
+
"total_results": len(formatted_results),
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
except Exception as e: # noqa: BLE001
|
|
163
|
+
return {
|
|
164
|
+
"success": False,
|
|
165
|
+
"error": f"DuckDuckGo search error: {e!s}",
|
|
166
|
+
"query": query,
|
|
167
|
+
}
|
|
168
|
+
|
|
169
|
+
|
|
170
|
+
# Documentation site mappings for docs_search
|
|
171
|
+
_DOCS_SITES: dict[str, list[str]] = {
|
|
172
|
+
# Python ecosystem
|
|
173
|
+
"python": ["docs.python.org", "docs.python-guide.org"],
|
|
174
|
+
"django": ["docs.djangoproject.com"],
|
|
175
|
+
"flask": ["flask.palletsprojects.com"],
|
|
176
|
+
"fastapi": ["fastapi.tiangolo.com"],
|
|
177
|
+
"numpy": ["numpy.org/doc"],
|
|
178
|
+
"pandas": ["pandas.pydata.org/docs"],
|
|
179
|
+
"pytorch": ["pytorch.org/docs"],
|
|
180
|
+
"tensorflow": ["tensorflow.org/api_docs"],
|
|
181
|
+
"requests": ["requests.readthedocs.io"],
|
|
182
|
+
"sqlalchemy": ["docs.sqlalchemy.org"],
|
|
183
|
+
"pydantic": ["docs.pydantic.dev"],
|
|
184
|
+
# JavaScript/TypeScript ecosystem
|
|
185
|
+
"javascript": ["developer.mozilla.org/en-US/docs/Web/JavaScript"],
|
|
186
|
+
"typescript": ["typescriptlang.org/docs"],
|
|
187
|
+
"nodejs": ["nodejs.org/docs", "nodejs.org/api"],
|
|
188
|
+
"node": ["nodejs.org/docs", "nodejs.org/api"],
|
|
189
|
+
"react": ["react.dev", "reactjs.org/docs"],
|
|
190
|
+
"vue": ["vuejs.org/guide", "vuejs.org/api"],
|
|
191
|
+
"angular": ["angular.io/docs"],
|
|
192
|
+
"nextjs": ["nextjs.org/docs"],
|
|
193
|
+
"express": ["expressjs.com"],
|
|
194
|
+
"deno": ["deno.land/manual", "docs.deno.com"],
|
|
195
|
+
# Web/CSS
|
|
196
|
+
"css": ["developer.mozilla.org/en-US/docs/Web/CSS"],
|
|
197
|
+
"html": ["developer.mozilla.org/en-US/docs/Web/HTML"],
|
|
198
|
+
"mdn": ["developer.mozilla.org"],
|
|
199
|
+
"web": ["developer.mozilla.org/en-US/docs/Web"],
|
|
200
|
+
# Other languages
|
|
201
|
+
"rust": ["doc.rust-lang.org", "docs.rs"],
|
|
202
|
+
"go": ["go.dev/doc", "pkg.go.dev"],
|
|
203
|
+
"golang": ["go.dev/doc", "pkg.go.dev"],
|
|
204
|
+
"java": ["docs.oracle.com/en/java"],
|
|
205
|
+
"kotlin": ["kotlinlang.org/docs"],
|
|
206
|
+
"swift": ["developer.apple.com/documentation/swift"],
|
|
207
|
+
"ruby": ["ruby-doc.org", "docs.ruby-lang.org"],
|
|
208
|
+
"php": ["php.net/docs.php", "php.net/manual"],
|
|
209
|
+
"csharp": ["docs.microsoft.com/en-us/dotnet/csharp"],
|
|
210
|
+
"dotnet": ["docs.microsoft.com/en-us/dotnet"],
|
|
211
|
+
# Databases
|
|
212
|
+
"postgresql": ["postgresql.org/docs"],
|
|
213
|
+
"postgres": ["postgresql.org/docs"],
|
|
214
|
+
"mysql": ["dev.mysql.com/doc"],
|
|
215
|
+
"mongodb": ["docs.mongodb.com"],
|
|
216
|
+
"redis": ["redis.io/docs"],
|
|
217
|
+
"sqlite": ["sqlite.org/docs.html"],
|
|
218
|
+
# DevOps/Cloud
|
|
219
|
+
"docker": ["docs.docker.com"],
|
|
220
|
+
"kubernetes": ["kubernetes.io/docs"],
|
|
221
|
+
"k8s": ["kubernetes.io/docs"],
|
|
222
|
+
"aws": ["docs.aws.amazon.com"],
|
|
223
|
+
"azure": ["docs.microsoft.com/en-us/azure"],
|
|
224
|
+
"gcp": ["cloud.google.com/docs"],
|
|
225
|
+
# Tools
|
|
226
|
+
"git": ["git-scm.com/doc"],
|
|
227
|
+
"github": ["docs.github.com"],
|
|
228
|
+
"vscode": ["code.visualstudio.com/docs"],
|
|
229
|
+
"linux": ["man7.org/linux/man-pages", "linux.die.net/man"],
|
|
230
|
+
# AI/ML
|
|
231
|
+
"langchain": ["python.langchain.com/docs", "js.langchain.com/docs"],
|
|
232
|
+
"openai": ["platform.openai.com/docs"],
|
|
233
|
+
"anthropic": ["docs.anthropic.com"],
|
|
234
|
+
"huggingface": ["huggingface.co/docs"],
|
|
235
|
+
}
|
|
236
|
+
|
|
237
|
+
# General documentation aggregators (used when no specific topic)
|
|
238
|
+
_GENERAL_DOCS_SITES = [
|
|
239
|
+
"devdocs.io",
|
|
240
|
+
"developer.mozilla.org",
|
|
241
|
+
"docs.python.org",
|
|
242
|
+
"nodejs.org/docs",
|
|
243
|
+
"readthedocs.io",
|
|
244
|
+
]
|
|
245
|
+
|
|
246
|
+
|
|
247
|
+
@tool
|
|
248
|
+
def docs_search(
|
|
249
|
+
query: str,
|
|
250
|
+
topic: str = "",
|
|
251
|
+
max_results: int = 5,
|
|
252
|
+
) -> dict[str, Any]:
|
|
253
|
+
"""Search official documentation sites only.
|
|
254
|
+
|
|
255
|
+
A focused search tool that queries only official documentation and reference
|
|
256
|
+
sites, filtering out blog posts, tutorials, and Stack Overflow answers.
|
|
257
|
+
Ideal for finding authoritative API references and official guides.
|
|
258
|
+
|
|
259
|
+
Args:
|
|
260
|
+
query: The search query (e.g., "asyncio gather", "useState hook")
|
|
261
|
+
topic: Optional topic/language to focus search (e.g., "python", "react", "rust")
|
|
262
|
+
If not specified, searches general documentation sites.
|
|
263
|
+
Available topics: python, javascript, typescript, react, vue, nodejs,
|
|
264
|
+
rust, go, java, docker, kubernetes, aws, postgresql, and many more.
|
|
265
|
+
max_results: Number of results to return (default: 5, max: 10)
|
|
266
|
+
|
|
267
|
+
Returns:
|
|
268
|
+
Dictionary containing:
|
|
269
|
+
- success: Whether search succeeded
|
|
270
|
+
- results: List of documentation results with title, url, body
|
|
271
|
+
- query: The search query used (including site restrictions)
|
|
272
|
+
- topic: The topic searched (if specified)
|
|
273
|
+
- sites_searched: List of documentation sites that were searched
|
|
274
|
+
|
|
275
|
+
Example:
|
|
276
|
+
docs_search("async await", topic="python")
|
|
277
|
+
docs_search("useEffect cleanup", topic="react")
|
|
278
|
+
docs_search("SELECT JOIN", topic="postgresql")
|
|
279
|
+
docs_search("container networking", topic="docker")
|
|
280
|
+
"""
|
|
281
|
+
try:
|
|
282
|
+
from ddgs import DDGS
|
|
283
|
+
except ImportError:
|
|
284
|
+
try:
|
|
285
|
+
from duckduckgo_search import DDGS
|
|
286
|
+
except ImportError:
|
|
287
|
+
return {
|
|
288
|
+
"success": False,
|
|
289
|
+
"error": "ddgs not installed. Install with: uv add ddgs",
|
|
290
|
+
"query": query,
|
|
291
|
+
}
|
|
292
|
+
|
|
293
|
+
max_results = min(max(1, max_results), 10)
|
|
294
|
+
|
|
295
|
+
# Determine which sites to search
|
|
296
|
+
topic_lower = topic.lower().strip() if topic else ""
|
|
297
|
+
if topic_lower and topic_lower in _DOCS_SITES:
|
|
298
|
+
sites = _DOCS_SITES[topic_lower]
|
|
299
|
+
elif topic_lower:
|
|
300
|
+
# Try partial match
|
|
301
|
+
for key, value in _DOCS_SITES.items():
|
|
302
|
+
if topic_lower in key or key in topic_lower:
|
|
303
|
+
sites = value
|
|
304
|
+
topic_lower = key
|
|
305
|
+
break
|
|
306
|
+
else:
|
|
307
|
+
# Unknown topic - search general docs with topic as keyword
|
|
308
|
+
sites = _GENERAL_DOCS_SITES
|
|
309
|
+
query = f"{topic} {query}"
|
|
310
|
+
else:
|
|
311
|
+
sites = _GENERAL_DOCS_SITES
|
|
312
|
+
|
|
313
|
+
# Build site-restricted query
|
|
314
|
+
site_query = " OR ".join(f"site:{site}" for site in sites)
|
|
315
|
+
full_query = f"{query} ({site_query})"
|
|
316
|
+
|
|
317
|
+
try:
|
|
318
|
+
with DDGS() as ddgs:
|
|
319
|
+
results = list(
|
|
320
|
+
ddgs.text(
|
|
321
|
+
full_query,
|
|
322
|
+
max_results=max_results,
|
|
323
|
+
)
|
|
324
|
+
)
|
|
325
|
+
|
|
326
|
+
formatted_results = [
|
|
327
|
+
{
|
|
328
|
+
"title": r.get("title", ""),
|
|
329
|
+
"url": r.get("href", r.get("link", "")),
|
|
330
|
+
"body": r.get("body", r.get("snippet", "")),
|
|
331
|
+
}
|
|
332
|
+
for r in results
|
|
333
|
+
]
|
|
334
|
+
|
|
335
|
+
return {
|
|
336
|
+
"success": True,
|
|
337
|
+
"results": formatted_results,
|
|
338
|
+
"query": query,
|
|
339
|
+
"topic": topic_lower if topic_lower else "general",
|
|
340
|
+
"sites_searched": sites,
|
|
341
|
+
"total_results": len(formatted_results),
|
|
342
|
+
}
|
|
343
|
+
|
|
344
|
+
except Exception as e: # noqa: BLE001
|
|
345
|
+
return {
|
|
346
|
+
"success": False,
|
|
347
|
+
"error": f"Documentation search error: {e!s}",
|
|
348
|
+
"query": query,
|
|
349
|
+
}
|
|
@@ -0,0 +1,152 @@
|
|
|
1
|
+
"""Agent-accessible wiki tools for autonomous wiki operations.
|
|
2
|
+
|
|
3
|
+
These tools let the agent consult and update the wiki during coding
|
|
4
|
+
sessions — searching, reading, writing pages, and updating the index
|
|
5
|
+
without requiring slash commands.
|
|
6
|
+
"""
|
|
7
|
+
|
|
8
|
+
from __future__ import annotations
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
from langchain.tools import tool
|
|
12
|
+
|
|
13
|
+
from novacode_cli.wiki.manager import WikiManager
|
|
14
|
+
|
|
15
|
+
|
|
16
|
+
@tool
|
|
17
|
+
def wiki_search(query: str) -> str:
|
|
18
|
+
"""Search the project wiki for pages matching a query.
|
|
19
|
+
|
|
20
|
+
Returns a list of (topic, path, summary) tuples ranked by relevance.
|
|
21
|
+
|
|
22
|
+
Args:
|
|
23
|
+
query: Search keywords or phrase (e.g. "MCP protocol comparison")
|
|
24
|
+
|
|
25
|
+
Returns:
|
|
26
|
+
Formatted search results or "(no matches)".
|
|
27
|
+
"""
|
|
28
|
+
try:
|
|
29
|
+
mgr = WikiManager()
|
|
30
|
+
results = mgr.search(query)
|
|
31
|
+
if not results:
|
|
32
|
+
return "(no wiki matches found)"
|
|
33
|
+
|
|
34
|
+
lines = ["### Wiki Search Results\n"]
|
|
35
|
+
for topic, path, summary in results:
|
|
36
|
+
lines.append(f"- **[{topic}]({path})**")
|
|
37
|
+
if summary:
|
|
38
|
+
lines.append(f" — {summary}")
|
|
39
|
+
lines.append("")
|
|
40
|
+
return "".join(lines)
|
|
41
|
+
except RuntimeError:
|
|
42
|
+
return "(wiki is not available — not in a git project)"
|
|
43
|
+
except Exception as ex: # noqa: BLE001
|
|
44
|
+
return f"(wiki search failed: {ex})"
|
|
45
|
+
|
|
46
|
+
|
|
47
|
+
@tool
|
|
48
|
+
def wiki_read(path: str) -> str:
|
|
49
|
+
"""Read a wiki page by path.
|
|
50
|
+
|
|
51
|
+
The path is relative to the wiki directory, e.g.
|
|
52
|
+
``technologies/LangGraph.md`` or ``comparisons/CrewAI-vs-LangGraph.md``.
|
|
53
|
+
|
|
54
|
+
Args:
|
|
55
|
+
path: Wiki page path like ``technologies/LangGraph.md``.
|
|
56
|
+
|
|
57
|
+
Returns:
|
|
58
|
+
The page content, or an error message.
|
|
59
|
+
"""
|
|
60
|
+
try:
|
|
61
|
+
mgr = WikiManager()
|
|
62
|
+
p = path.replace("\\", "/").strip().lstrip("/")
|
|
63
|
+
if p.startswith(".nova/wiki/"):
|
|
64
|
+
p = p[len(".nova/wiki/"):]
|
|
65
|
+
elif p.startswith("wiki/"):
|
|
66
|
+
p = p[len("wiki/"):]
|
|
67
|
+
content = mgr.read_page(p)
|
|
68
|
+
if content is None:
|
|
69
|
+
return f"(wiki page not found: {path})"
|
|
70
|
+
return content
|
|
71
|
+
except RuntimeError:
|
|
72
|
+
return "(wiki is not available — not in a git project)"
|
|
73
|
+
except Exception as ex: # noqa: BLE001
|
|
74
|
+
return f"(wiki read failed: {ex})"
|
|
75
|
+
|
|
76
|
+
|
|
77
|
+
@tool
|
|
78
|
+
def wiki_write(path: str, content: str) -> str:
|
|
79
|
+
"""Write or overwrite a wiki page.
|
|
80
|
+
|
|
81
|
+
The path should include the topic directory and filename,
|
|
82
|
+
e.g. ``technologies/LangGraph.md`` or ``patterns/MultiAgentPatterns.md``.
|
|
83
|
+
|
|
84
|
+
Valid topic directories: technologies/, frameworks/, patterns/,
|
|
85
|
+
projects/, comparisons/.
|
|
86
|
+
|
|
87
|
+
After writing, you should also call ``wiki_update_index`` to keep the
|
|
88
|
+
index in sync.
|
|
89
|
+
|
|
90
|
+
Args:
|
|
91
|
+
path: Page path like ``technologies/LangGraph.md``.
|
|
92
|
+
content: Markdown content for the page.
|
|
93
|
+
|
|
94
|
+
Returns:
|
|
95
|
+
Confirmation message.
|
|
96
|
+
"""
|
|
97
|
+
try:
|
|
98
|
+
mgr = WikiManager()
|
|
99
|
+
mgr.ensure_structure()
|
|
100
|
+
|
|
101
|
+
p = path.replace("\\", "/").strip().lstrip("/")
|
|
102
|
+
if p.startswith(".nova/wiki/"):
|
|
103
|
+
p = p[len(".nova/wiki/"):]
|
|
104
|
+
elif p.startswith("wiki/"):
|
|
105
|
+
p = p[len("wiki/"):]
|
|
106
|
+
|
|
107
|
+
# Split path into topic & title
|
|
108
|
+
parts = p.split("/")
|
|
109
|
+
if len(parts) < 2:
|
|
110
|
+
return (
|
|
111
|
+
f"(invalid path '{path}' — use topic/filename.md, "
|
|
112
|
+
"e.g. technologies/LangGraph.md)"
|
|
113
|
+
)
|
|
114
|
+
topic = parts[0]
|
|
115
|
+
title = "/".join(parts[1:])
|
|
116
|
+
|
|
117
|
+
mgr.write_page(topic, title, content)
|
|
118
|
+
return f"✓ Wrote wiki page: {topic}/{title}"
|
|
119
|
+
except RuntimeError:
|
|
120
|
+
return "(wiki is not available — not in a git project)"
|
|
121
|
+
except Exception as ex: # noqa: BLE001
|
|
122
|
+
return f"(wiki write failed: {ex})"
|
|
123
|
+
|
|
124
|
+
|
|
125
|
+
@tool
|
|
126
|
+
def wiki_update_index(topic: str, path: str, summary: str = "") -> str:
|
|
127
|
+
"""Add or update an entry in the wiki index.
|
|
128
|
+
|
|
129
|
+
Use this after creating or updating a wiki page so it appears in
|
|
130
|
+
search results.
|
|
131
|
+
|
|
132
|
+
Args:
|
|
133
|
+
topic: Display name for the entry (e.g. "LangGraph").
|
|
134
|
+
path: Relative path to the page (e.g. "technologies/LangGraph.md").
|
|
135
|
+
summary: Optional one-line description.
|
|
136
|
+
|
|
137
|
+
Returns:
|
|
138
|
+
Confirmation message.
|
|
139
|
+
"""
|
|
140
|
+
try:
|
|
141
|
+
mgr = WikiManager()
|
|
142
|
+
p = path.replace("\\", "/").strip().lstrip("/")
|
|
143
|
+
if p.startswith(".nova/wiki/"):
|
|
144
|
+
p = p[len(".nova/wiki/"):]
|
|
145
|
+
elif p.startswith("wiki/"):
|
|
146
|
+
p = p[len("wiki/"):]
|
|
147
|
+
mgr.update_index(topic, p, summary)
|
|
148
|
+
return f"✓ Index updated: {topic} → {p}"
|
|
149
|
+
except RuntimeError:
|
|
150
|
+
return "(wiki is not available — not in a git project)"
|
|
151
|
+
except Exception as ex: # noqa: BLE001
|
|
152
|
+
return f"(wiki index update failed: {ex})"
|