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,464 @@
|
|
|
1
|
+
"""Steering middleware for injecting persistent user guidance into every model call.
|
|
2
|
+
|
|
3
|
+
Steering lets the user add standing instructions that persist across turns,
|
|
4
|
+
unlike regular chat messages which are "one and done." Examples:
|
|
5
|
+
|
|
6
|
+
/steer focus on the database layer
|
|
7
|
+
/steer never modify test files without asking first
|
|
8
|
+
/steer prioritize backward compatibility
|
|
9
|
+
/steer use async patterns everywhere
|
|
10
|
+
|
|
11
|
+
These instructions are injected into every model call as a dedicated
|
|
12
|
+
section in the system prompt, ensuring the agent obeys them on every
|
|
13
|
+
turn — not just the one where they were typed.
|
|
14
|
+
|
|
15
|
+
The steering state is held in ``session_state.steering_instructions``,
|
|
16
|
+
a list of ``(label, instruction)`` tuples. The ``/steer`` slash command
|
|
17
|
+
is the primary interface for managing them.
|
|
18
|
+
|
|
19
|
+
Architecture
|
|
20
|
+
-----------
|
|
21
|
+
``SteeringMiddleware`` sits in the agent middleware stack alongside
|
|
22
|
+
``GraphContextMiddleware``, ``ShellMiddleware``, etc. It intercepts
|
|
23
|
+
every ``awrap_model_call`` and prepends the current steering instructions
|
|
24
|
+
to the system prompt, right after the base prompt but before any other
|
|
25
|
+
middleware injections.
|
|
26
|
+
|
|
27
|
+
The injection format is::
|
|
28
|
+
|
|
29
|
+
[Steering Instructions]
|
|
30
|
+
- focus on the database layer
|
|
31
|
+
- never modify test files without asking first
|
|
32
|
+
- prioritize backward compatibility
|
|
33
|
+
[/Steering Instructions]
|
|
34
|
+
|
|
35
|
+
This is deliberately verbose — the agent sees these on every call, so
|
|
36
|
+
they act as persistent guardrails rather than one-off suggestions.
|
|
37
|
+
"""
|
|
38
|
+
|
|
39
|
+
from __future__ import annotations
|
|
40
|
+
|
|
41
|
+
import itertools
|
|
42
|
+
import logging
|
|
43
|
+
from collections.abc import Awaitable, Callable
|
|
44
|
+
from typing import Any
|
|
45
|
+
|
|
46
|
+
from langchain.agents.middleware.types import (
|
|
47
|
+
AgentMiddleware,
|
|
48
|
+
AgentState,
|
|
49
|
+
ModelRequest,
|
|
50
|
+
ModelResponse,
|
|
51
|
+
hook_config,
|
|
52
|
+
)
|
|
53
|
+
from langchain_core.messages import AIMessage, HumanMessage, SystemMessage
|
|
54
|
+
|
|
55
|
+
logger = logging.getLogger(__name__)
|
|
56
|
+
|
|
57
|
+
# ── Context-window safety ──────────────────────────────────────────
|
|
58
|
+
# If the system prompt (after ALL middleware injections) exceeds this
|
|
59
|
+
# fraction of the model's context window, skip steering to avoid
|
|
60
|
+
# silently truncating the model's output. Hardcoded as a class-level
|
|
61
|
+
# constant so subclasses can override.
|
|
62
|
+
_INJECTION_CTX_MARGIN = 0.80 # 80% — generous margin for messages + output
|
|
63
|
+
_STEERING_SENTINEL = "[/User Steering]"
|
|
64
|
+
|
|
65
|
+
|
|
66
|
+
# ---------------------------------------------------------------------------
|
|
67
|
+
# Steering instruction storage
|
|
68
|
+
# ---------------------------------------------------------------------------
|
|
69
|
+
|
|
70
|
+
|
|
71
|
+
_uid_counter = itertools.count()
|
|
72
|
+
|
|
73
|
+
|
|
74
|
+
class SteeringInstruction:
|
|
75
|
+
"""A single steering instruction with a label for display.
|
|
76
|
+
|
|
77
|
+
Attributes:
|
|
78
|
+
label: Short human-readable label (e.g., "focus", "constraint", "style").
|
|
79
|
+
instruction: The full instruction text.
|
|
80
|
+
uid: Process-unique id, used to deliver each steer as a live message
|
|
81
|
+
exactly once (stable across GC, unlike ``id()``).
|
|
82
|
+
"""
|
|
83
|
+
|
|
84
|
+
__slots__ = ("label", "instruction", "uid", "consumed", "live")
|
|
85
|
+
|
|
86
|
+
def __init__(self, label: str, instruction: str, *, live: bool = False) -> None:
|
|
87
|
+
self.label = label
|
|
88
|
+
self.instruction = instruction
|
|
89
|
+
self.uid = next(_uid_counter)
|
|
90
|
+
self.consumed = False
|
|
91
|
+
#: A message typed while the agent worked (a queued message), not a
|
|
92
|
+
#: standing /steer rule: it joins the conversation at the next step.
|
|
93
|
+
self.live = live
|
|
94
|
+
|
|
95
|
+
def __repr__(self) -> str:
|
|
96
|
+
return f"SteeringInstruction({self.label!r}, {self.instruction!r})"
|
|
97
|
+
|
|
98
|
+
|
|
99
|
+
#: Marks a queued message in the conversation (``additional_kwargs``).
|
|
100
|
+
QUEUED_SOURCE = "queued_message"
|
|
101
|
+
|
|
102
|
+
|
|
103
|
+
def queued_message(text: str) -> HumanMessage:
|
|
104
|
+
"""A message typed while the agent worked, as it joins the conversation."""
|
|
105
|
+
return HumanMessage(
|
|
106
|
+
"[Sent by the user while you were working: incorporate it into the "
|
|
107
|
+
f"current task now]\n{text}",
|
|
108
|
+
additional_kwargs={"lc_source": QUEUED_SOURCE, "queued_text": text},
|
|
109
|
+
)
|
|
110
|
+
|
|
111
|
+
|
|
112
|
+
# ---------------------------------------------------------------------------
|
|
113
|
+
# Middleware
|
|
114
|
+
# ---------------------------------------------------------------------------
|
|
115
|
+
|
|
116
|
+
|
|
117
|
+
class SteeringMiddleware(AgentMiddleware):
|
|
118
|
+
"""Inject persistent steering instructions into every model call.
|
|
119
|
+
|
|
120
|
+
The middleware holds a reference to a shared list of
|
|
121
|
+
``SteeringInstruction`` objects. The same list is stored in
|
|
122
|
+
``session_state.steering_instructions``, so updates via the ``/steer``
|
|
123
|
+
command are immediately visible to the middleware — no state
|
|
124
|
+
synchronization needed.
|
|
125
|
+
|
|
126
|
+
When no steering instructions are active, this middleware is a no-op.
|
|
127
|
+
"""
|
|
128
|
+
|
|
129
|
+
state_schema = AgentState
|
|
130
|
+
|
|
131
|
+
def __init__(
|
|
132
|
+
self,
|
|
133
|
+
instructions: list[SteeringInstruction] | None = None,
|
|
134
|
+
enabled: bool = True,
|
|
135
|
+
) -> None:
|
|
136
|
+
"""Initialize the steering middleware.
|
|
137
|
+
|
|
138
|
+
Args:
|
|
139
|
+
instructions: Shared list of steering instructions. If None,
|
|
140
|
+
creates an empty list internally (not connected to session state).
|
|
141
|
+
enabled: If False, this middleware is a no-op.
|
|
142
|
+
"""
|
|
143
|
+
self._enabled = enabled
|
|
144
|
+
self._instructions: list[SteeringInstruction] = (
|
|
145
|
+
instructions if instructions is not None else []
|
|
146
|
+
)
|
|
147
|
+
# uids of instructions already surfaced as a live user message, so each
|
|
148
|
+
# new steer is delivered as an actionable message exactly once (then
|
|
149
|
+
# persists via the system prompt).
|
|
150
|
+
self._delivered: set[int] = set()
|
|
151
|
+
|
|
152
|
+
@staticmethod
|
|
153
|
+
def _estimate_tokens(text: str) -> int:
|
|
154
|
+
"""Rough token estimate for a text blob (~3 chars/token for code-heavy text)."""
|
|
155
|
+
return max(1, len(text) // 3)
|
|
156
|
+
|
|
157
|
+
def _lookup_context_window(self, request: ModelRequest) -> int | None:
|
|
158
|
+
"""Return the model's context-window size in tokens, or None if unknown."""
|
|
159
|
+
# 1) Check model.profile (seeded by _seed_summarization_profile in core_agent.py)
|
|
160
|
+
try:
|
|
161
|
+
profile = getattr(request.model, "profile", None) or {}
|
|
162
|
+
max_tokens = profile.get("max_input_tokens")
|
|
163
|
+
if max_tokens and int(max_tokens) > 0:
|
|
164
|
+
return int(max_tokens)
|
|
165
|
+
except Exception: # noqa: BLE001
|
|
166
|
+
pass
|
|
167
|
+
# 2) Fall back to ContextManager lookup
|
|
168
|
+
try:
|
|
169
|
+
model_name = (
|
|
170
|
+
getattr(request.model, "model_name", None)
|
|
171
|
+
or getattr(request.model, "model", None)
|
|
172
|
+
or ""
|
|
173
|
+
)
|
|
174
|
+
if model_name:
|
|
175
|
+
from novacode_cli.context.manager import ContextManager
|
|
176
|
+
|
|
177
|
+
cm = ContextManager(model_name)
|
|
178
|
+
return cm.window_size()
|
|
179
|
+
except Exception: # noqa: BLE001
|
|
180
|
+
pass
|
|
181
|
+
return None
|
|
182
|
+
|
|
183
|
+
@staticmethod
|
|
184
|
+
def _messages_chars(messages: Any) -> int:
|
|
185
|
+
"""Total character count of the conversation messages' content."""
|
|
186
|
+
total = 0
|
|
187
|
+
for m in messages or []:
|
|
188
|
+
content = getattr(m, "content", "")
|
|
189
|
+
if isinstance(content, str):
|
|
190
|
+
total += len(content)
|
|
191
|
+
elif isinstance(content, list):
|
|
192
|
+
for part in content:
|
|
193
|
+
if isinstance(part, str):
|
|
194
|
+
total += len(part)
|
|
195
|
+
elif isinstance(part, dict):
|
|
196
|
+
total += len(str(part.get("text", "")))
|
|
197
|
+
return total
|
|
198
|
+
|
|
199
|
+
def _prompt_within_margin(self, request: ModelRequest, added_chars: int) -> bool:
|
|
200
|
+
"""True if the *full* input (system + history + steering) fits the margin.
|
|
201
|
+
|
|
202
|
+
The real input the model receives is the system prompt **plus the whole
|
|
203
|
+
conversation**, so a steering block that fits the system prompt alone can
|
|
204
|
+
still push a long chat over the window — which truncates the model's
|
|
205
|
+
answer mid-sentence. We therefore count the messages too (the previous
|
|
206
|
+
check looked only at the system prompt). When the window is unknown
|
|
207
|
+
(no model profile / ContextManager entry) we assume yes rather than
|
|
208
|
+
silently dropping steering.
|
|
209
|
+
"""
|
|
210
|
+
window = self._lookup_context_window(request)
|
|
211
|
+
if window is None:
|
|
212
|
+
return True # can't measure → don't block
|
|
213
|
+
system_chars = len(request.system_prompt or "")
|
|
214
|
+
messages_chars = self._messages_chars(getattr(request, "messages", None))
|
|
215
|
+
total = max(1, (system_chars + messages_chars + max(0, added_chars)) // 3)
|
|
216
|
+
margin = int(window * _INJECTION_CTX_MARGIN)
|
|
217
|
+
if total >= margin:
|
|
218
|
+
logger.warning(
|
|
219
|
+
"Steering injection skipped: input ~%s tokens (system + history + "
|
|
220
|
+
"steering) exceeds %s%% of %s-token context window (%s tokens)",
|
|
221
|
+
total,
|
|
222
|
+
int(_INJECTION_CTX_MARGIN * 100),
|
|
223
|
+
window,
|
|
224
|
+
margin,
|
|
225
|
+
)
|
|
226
|
+
return False
|
|
227
|
+
return True
|
|
228
|
+
|
|
229
|
+
def _inject(self, request: ModelRequest) -> ModelRequest:
|
|
230
|
+
"""Inject steering instructions into this model call.
|
|
231
|
+
|
|
232
|
+
Two layers:
|
|
233
|
+
* a persistent block appended to the system prompt (standing guardrails
|
|
234
|
+
the agent must honor on every step), and
|
|
235
|
+
* for any *newly added* steer (e.g. typed while the agent was working),
|
|
236
|
+
a one-time HumanMessage so the agent actively reads and incorporates it
|
|
237
|
+
into the task in progress — a passive system-prompt line mid-tool-loop
|
|
238
|
+
is easy to overlook.
|
|
239
|
+
|
|
240
|
+
Guards:
|
|
241
|
+
* **Sentinel** — skips system-prompt injection when the block is already
|
|
242
|
+
present (accumulating copies on every model call bloats the prompt).
|
|
243
|
+
* **Context margin** — skips system-prompt injection when the prompt after
|
|
244
|
+
injection would exceed 80 % of the model's context window (overflow
|
|
245
|
+
silently truncates the model's output).
|
|
246
|
+
* The one-time nudge HumanMessage for *new* steers still fires in both
|
|
247
|
+
cases — even when the standing block is skipped, newly added instructions
|
|
248
|
+
reach the model via an actionable in-band message.
|
|
249
|
+
"""
|
|
250
|
+
if not self._enabled:
|
|
251
|
+
return request
|
|
252
|
+
|
|
253
|
+
# Queued messages are in the conversation already (before_model).
|
|
254
|
+
instructions = [si for si in self._instructions if not si.live]
|
|
255
|
+
if not instructions:
|
|
256
|
+
return request
|
|
257
|
+
|
|
258
|
+
# ── Build the steering block ──────────────────────────────────
|
|
259
|
+
lines = [
|
|
260
|
+
f"- [{si.label}] {si.instruction}" if si.label else f"- {si.instruction}"
|
|
261
|
+
for si in instructions
|
|
262
|
+
]
|
|
263
|
+
block = (
|
|
264
|
+
"[User Steering — standing instructions from the user that you MUST "
|
|
265
|
+
"follow on every step]\n" + "\n".join(lines) + "\n[/User Steering]"
|
|
266
|
+
)
|
|
267
|
+
|
|
268
|
+
overrides: dict[str, Any] = {}
|
|
269
|
+
|
|
270
|
+
# ── Guard 1: Sentinel — skip if already injected ──────────────
|
|
271
|
+
system_prompt = request.system_prompt
|
|
272
|
+
already_injected = system_prompt is not None and _STEERING_SENTINEL in system_prompt
|
|
273
|
+
|
|
274
|
+
if not already_injected and self._prompt_within_margin(request, len(block)):
|
|
275
|
+
new_prompt = (system_prompt + "\n\n" + block) if system_prompt else block
|
|
276
|
+
overrides["system_message"] = SystemMessage(new_prompt)
|
|
277
|
+
|
|
278
|
+
# ── Guard 2 (always): deliver newly-added steers as a live msg ─
|
|
279
|
+
new = [si for si in instructions if si.uid not in self._delivered]
|
|
280
|
+
if new:
|
|
281
|
+
for si in new:
|
|
282
|
+
self._delivered.add(si.uid)
|
|
283
|
+
si.consumed = True
|
|
284
|
+
nudge = "\n".join(f"- {si.instruction}" for si in new)
|
|
285
|
+
msg = HumanMessage(
|
|
286
|
+
"[The user added the following while you were working — "
|
|
287
|
+
"incorporate it into your current task now, in addition to what "
|
|
288
|
+
"you're already doing]\n" + nudge
|
|
289
|
+
)
|
|
290
|
+
overrides["messages"] = [*request.messages, msg]
|
|
291
|
+
|
|
292
|
+
if not overrides:
|
|
293
|
+
return request
|
|
294
|
+
return request.override(**overrides)
|
|
295
|
+
|
|
296
|
+
def before_model(self, state: Any, runtime: Any) -> dict[str, Any] | None: # noqa: ANN401
|
|
297
|
+
"""Record messages typed while the agent worked, at its next step.
|
|
298
|
+
|
|
299
|
+
A queued message becomes a user message in the conversation (as in
|
|
300
|
+
Claude Code), not just text in one request: later turns, compaction
|
|
301
|
+
summaries and /resume then all know the user said it.
|
|
302
|
+
"""
|
|
303
|
+
if not self._enabled:
|
|
304
|
+
return None
|
|
305
|
+
new = [si for si in self._instructions if si.live and si.uid not in self._delivered]
|
|
306
|
+
if not new:
|
|
307
|
+
return None
|
|
308
|
+
for si in new:
|
|
309
|
+
self._delivered.add(si.uid)
|
|
310
|
+
si.consumed = True
|
|
311
|
+
_announce_pickup(si.instruction)
|
|
312
|
+
return {"messages": [queued_message(si.instruction) for si in new]}
|
|
313
|
+
|
|
314
|
+
async def abefore_model(self, state: Any, runtime: Any) -> dict[str, Any] | None: # noqa: ANN401
|
|
315
|
+
return self.before_model(state, runtime)
|
|
316
|
+
|
|
317
|
+
@hook_config(can_jump_to=["model"])
|
|
318
|
+
def after_model(self, state: Any, runtime: Any) -> dict[str, Any] | None: # noqa: ANN401
|
|
319
|
+
"""Deliver late user input before a final answer ends the graph turn."""
|
|
320
|
+
messages = state.get("messages", [])
|
|
321
|
+
last = messages[-1] if messages else None
|
|
322
|
+
if not isinstance(last, AIMessage) or last.tool_calls:
|
|
323
|
+
# Tool results must pair with their calls before adding user input.
|
|
324
|
+
return None
|
|
325
|
+
update = self.before_model(state, runtime)
|
|
326
|
+
return {**update, "jump_to": "model"} if update else None
|
|
327
|
+
|
|
328
|
+
@hook_config(can_jump_to=["model"])
|
|
329
|
+
async def aafter_model(self, state: Any, runtime: Any) -> dict[str, Any] | None: # noqa: ANN401
|
|
330
|
+
"""Async version of the late-message continuation check."""
|
|
331
|
+
return self.after_model(state, runtime)
|
|
332
|
+
|
|
333
|
+
def wrap_model_call(
|
|
334
|
+
self,
|
|
335
|
+
request: ModelRequest,
|
|
336
|
+
handler: Callable[[ModelRequest], ModelResponse],
|
|
337
|
+
) -> ModelResponse:
|
|
338
|
+
"""Inject steering (sync)."""
|
|
339
|
+
return handler(self._inject(request))
|
|
340
|
+
|
|
341
|
+
async def awrap_model_call(
|
|
342
|
+
self,
|
|
343
|
+
request: ModelRequest,
|
|
344
|
+
handler: Callable[[ModelRequest], Awaitable[ModelResponse]],
|
|
345
|
+
) -> ModelResponse:
|
|
346
|
+
"""Inject steering (async)."""
|
|
347
|
+
return await handler(self._inject(request))
|
|
348
|
+
|
|
349
|
+
|
|
350
|
+
# ---------------------------------------------------------------------------
|
|
351
|
+
# Formatting helpers (used by /steer command)
|
|
352
|
+
# ---------------------------------------------------------------------------
|
|
353
|
+
|
|
354
|
+
|
|
355
|
+
def _announce_pickup(text: str) -> None:
|
|
356
|
+
"""Tell the UI a queued message reached the agent (best effort)."""
|
|
357
|
+
try:
|
|
358
|
+
from novacode_cli.events import nova_event_log
|
|
359
|
+
|
|
360
|
+
short = " ".join(text.split())
|
|
361
|
+
short = short if len(short) <= 80 else short[:79] + "…"
|
|
362
|
+
nova_event_log.append(("queued_pickup", "✓", "dim", f"Picked up: {short}"))
|
|
363
|
+
except Exception: # noqa: BLE001 - a notice is never worth a failed step
|
|
364
|
+
logger.debug("queued-message notice failed", exc_info=True)
|
|
365
|
+
|
|
366
|
+
|
|
367
|
+
def format_steering_status(instructions: list[SteeringInstruction]) -> str:
|
|
368
|
+
"""Format the current steering instructions as a Rich-displayable summary.
|
|
369
|
+
|
|
370
|
+
Args:
|
|
371
|
+
instructions: List of active steering instructions.
|
|
372
|
+
|
|
373
|
+
Returns:
|
|
374
|
+
Formatted string for console display. Empty string if none.
|
|
375
|
+
"""
|
|
376
|
+
if not instructions:
|
|
377
|
+
return "[dim]No steering instructions active.[/dim]"
|
|
378
|
+
|
|
379
|
+
lines = [f"[cyan]{len(instructions)} steering instruction(s) active:[/cyan]"]
|
|
380
|
+
for i, si in enumerate(instructions, 1):
|
|
381
|
+
if si.label:
|
|
382
|
+
lines.append(f" [dim]{i}.[/dim] [bold]{si.label}[/bold]: {si.instruction}")
|
|
383
|
+
else:
|
|
384
|
+
lines.append(f" [dim]{i}.[/dim] {si.instruction}")
|
|
385
|
+
|
|
386
|
+
return "\n".join(lines)
|
|
387
|
+
|
|
388
|
+
|
|
389
|
+
def classify_instruction(text: str) -> str:
|
|
390
|
+
"""Classify a steering instruction into a category label.
|
|
391
|
+
|
|
392
|
+
This is a simple heuristic that assigns a label based on keywords
|
|
393
|
+
in the instruction text. The label is used for display and
|
|
394
|
+
organization, not for any logic.
|
|
395
|
+
|
|
396
|
+
Args:
|
|
397
|
+
text: The raw instruction text.
|
|
398
|
+
|
|
399
|
+
Returns:
|
|
400
|
+
A short label string (e.g., "focus", "constraint", "style", "priority").
|
|
401
|
+
"""
|
|
402
|
+
text_lower = text.lower()
|
|
403
|
+
|
|
404
|
+
# Constraint signals
|
|
405
|
+
constraint_keywords = [
|
|
406
|
+
"never",
|
|
407
|
+
"don't",
|
|
408
|
+
"dont",
|
|
409
|
+
"do not",
|
|
410
|
+
"must not",
|
|
411
|
+
"cannot",
|
|
412
|
+
"avoid",
|
|
413
|
+
"refrain",
|
|
414
|
+
"forbidden",
|
|
415
|
+
"disallow",
|
|
416
|
+
"no ",
|
|
417
|
+
]
|
|
418
|
+
if any(kw in text_lower for kw in constraint_keywords):
|
|
419
|
+
return "constraint"
|
|
420
|
+
|
|
421
|
+
# Focus signals
|
|
422
|
+
focus_keywords = [
|
|
423
|
+
"focus on",
|
|
424
|
+
"concentrate on",
|
|
425
|
+
"prioritize",
|
|
426
|
+
"emphasize",
|
|
427
|
+
"pay attention to",
|
|
428
|
+
"concentrate",
|
|
429
|
+
"center on",
|
|
430
|
+
]
|
|
431
|
+
if any(kw in text_lower for kw in focus_keywords):
|
|
432
|
+
return "focus"
|
|
433
|
+
|
|
434
|
+
# Priority signals
|
|
435
|
+
priority_keywords = [
|
|
436
|
+
"always",
|
|
437
|
+
"make sure",
|
|
438
|
+
"ensure",
|
|
439
|
+
"guarantee",
|
|
440
|
+
"important",
|
|
441
|
+
"critical",
|
|
442
|
+
"essential",
|
|
443
|
+
"must",
|
|
444
|
+
]
|
|
445
|
+
if any(kw in text_lower for kw in priority_keywords):
|
|
446
|
+
return "priority"
|
|
447
|
+
|
|
448
|
+
# Style signals
|
|
449
|
+
style_keywords = [
|
|
450
|
+
"use async",
|
|
451
|
+
"use ",
|
|
452
|
+
"prefer ",
|
|
453
|
+
"style",
|
|
454
|
+
"format",
|
|
455
|
+
"pattern",
|
|
456
|
+
"verbose",
|
|
457
|
+
"concise",
|
|
458
|
+
"brief",
|
|
459
|
+
"detailed",
|
|
460
|
+
]
|
|
461
|
+
if any(kw in text_lower for kw in style_keywords):
|
|
462
|
+
return "style"
|
|
463
|
+
|
|
464
|
+
return "guide"
|