PyPI - novacode-cli - Versions diffs - 1.2.0__py3-none-any.whl - Mend

novacode-cli 1.2.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (691) hide show

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

novacode_cli/commands/chat_handler.py ADDED Viewed

@@ -0,0 +1,1357 @@
+"""Handler for /chat command — launches a local **Council** web UI.
+The ``/chat`` web UI runs a *council of agents*: five personas debate a topic
+chatroom-style, then score each other; the highest-scoring answer is the
+verdict. The server runs in a background thread
+(``http.server.ThreadingHTTPServer``) and streams the council over **Server-Sent
+Events** to the browser, driving the same LangGraph session's configured model
+via ``asyncio.run_coroutine_threadsafe`` onto the CLI event loop.
+The council logic itself lives in :mod:`novacode_cli.council`.
+"""
+from __future__ import annotations
+import asyncio
+import json
+import logging
+import queue
+import secrets
+import socket
+import sys
+import threading
+import time
+import webbrowser
+from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
+from typing import Any
+from urllib.parse import parse_qs, urlparse
+from novacode_cli.config.config import COLORS, console
+from novacode_cli.ui.council_workspace import (WORKSPACE_CONTROLS_HTML, WORKSPACE_CONTROLS_SCRIPT, WORKSPACE_CONTROLS_STYLE, WORKSPACE_METRICS_HTML)
+from novacode_cli.ui.council_web import COUNCIL_STYLE, COUNCIL_SETTINGS_HTML, COUNCIL_SETTINGS_SCRIPT
+from novacode_cli.ui.web_workspace import WORKSPACE_CSS, WORKSPACE_SCRIPT
+logger = logging.getLogger(__name__)
+# Sentinel pushed onto the event queue when the council run finishes.
+_STREAM_END = object()
+_pending_answers: dict[str, queue.Queue] = {}
+_pending_lock = threading.Lock()
+_producers: set = set()
+_HEARTBEAT_SECONDS = 10
+_IDLE_TIMEOUT = 300
+# ---------------------------------------------------------------------------
+# Module-level state shared with the background HTTP server thread.
+# Set by set_agent_refs before the server thread starts.
+# ---------------------------------------------------------------------------
+_agent: Any = None
+_assistant_id: str | None = None
+_session_state: Any = None
+_main_loop: asyncio.AbstractEventLoop | None = None
+_server: ThreadingHTTPServer | None = None
+_server_thread: threading.Thread | None = None
+_server_port: int | None = None
+# Only one council can be in session at a time (a single shared model/loop).
+_run_lock = threading.Lock()
+_settings_lock = threading.Lock()
+# Prior council rounds (this server's lifetime), so follow-up topics can build on
+# the earlier discussion. Each round: {"topic", "transcript": [[name, text]...],
+# "winner"}. Guarded by _run_lock (only one run mutates it at a time). Reset via
+# GET /api/council/reset or when the server stops.
+_council_history: list[dict[str, Any]] = []
+# How many rounds to retain. The prompt only reads the last few
+# (council._MAX_HISTORY_ROUNDS); a small margin over that lets the UI show a
+# little more scrollback without the list growing without bound.
+_MAX_KEPT_ROUNDS = 12
+# The user's verdict on each round: the council recommends, the user settles.
+# Each entry is {"topic", "decision", "winner", "at"} where decision is one of
+# DECISION_KEYS. Bounded like _council_history — a long-lived server would
+# otherwise accumulate one record per round forever. Guarded by _run_lock.
+_council_decisions: list[dict[str, Any]] = []
+# The only decisions the server will record. Anything else is a client bug (or
+# something poking the endpoint), and is rejected rather than stored.
+DECISION_KEYS = ("approve", "revise", "reject")
+# Refuse absurd bodies outright: this is a localhost endpoint and a decision is
+# four short fields, so a large one is never legitimate.
+_MAX_DECISION_BODY = 8 * 1024
+# ---------------------------------------------------------------------------
+# Embedded HTML council page
+# ---------------------------------------------------------------------------
+def _make_chat_html() -> str:
+    """Render the council with an advisor sidebar and a dedicated chat area."""
+    return r"""<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width,initial-scale=1.0">
+<title>Nova — Council</title>
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/styles/atom-one-dark.min.css">
+<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/highlight.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>
+<style>
+  /* --- the bench — advisor seats with live state + vote tally --- */
+  #bench { display: none; flex-shrink: 0; gap: 8px; padding: 10px 14px;
+    border-bottom: 1px solid var(--border); background: var(--surface); overflow-x: auto; }
+  #bench.active { display: flex; }
+  #bench .seat { flex: 1 1 0; min-width: 92px; display: flex; flex-direction: column;
+    align-items: center; gap: 4px; padding: 8px 6px; border-radius: 4px;
+    border: 1px solid var(--border); border-left: 3px solid var(--seat, var(--border));
+    background: var(--panel); transition: border-color .3s, box-shadow .3s, opacity .3s, transform .2s;
+    opacity: .5; }
+  #bench .seat-av { position: relative; font-size: 20px; width: 36px; height: 36px;
+    border-radius: 50%; display: flex; align-items: center; justify-content: center;
+    border: 1px solid var(--seat, var(--border)); background: var(--bg); }
+  #bench .seat-badge { position: absolute; top: -6px; right: -8px; min-width: 17px; height: 17px;
+    padding: 0 4px; border-radius: 9px; font-size: 10px; font-weight: 700; line-height: 17px;
+    text-align: center; background: var(--panel); color: var(--muted); font-family: inherit;
+    opacity: 0; transform: scale(.6); transition: opacity .25s, transform .25s, background .25s, color .25s; }
+  #bench .seat-badge.has { opacity: 1; transform: scale(1); background: var(--warning); color: #1a1410; }
+  #bench .seat-name { font-size: 10.5px; font-weight: 600; color: var(--fg); text-align: center; }
+  #bench .seat-state { font-size: 9px; text-transform: uppercase; letter-spacing: .06em; color: var(--muted); }
+  #bench .seat[data-state="speaking"] { opacity: 1; border-color: var(--seat); box-shadow: 0 0 0 1px var(--seat); }
+  #bench .seat[data-state="speaking"] .seat-av { animation: pulse 1.3s ease-in-out infinite; }
+  #bench .seat[data-state="answered"] { opacity: 1; }
+  #bench .seat[data-state="answered"] .seat-state { color: var(--seat); }
+  #bench .seat[data-state="voting"] { opacity: 1; }
+  #bench .seat[data-state="voting"] .seat-state { color: var(--warning); }
+  #bench .seat[data-state="winner"] { opacity: 1; border-color: var(--warning);
+    box-shadow: 0 0 0 1px var(--warning), 0 0 22px rgba(224,175,104,.25); transform: translateY(-2px); }
+  #bench .seat[data-state="winner"] .seat-state { color: var(--warning); font-weight: 700; }
+  /* --- messages --- */
+  #messages { flex: 1; overflow-y: auto; padding: 20px 16px; display: flex;
+    flex-direction: column; gap: 12px; scroll-behavior: smooth; }
+  #messages::-webkit-scrollbar { width: 8px; }
+  #messages::-webkit-scrollbar-thumb { background: var(--border); border-radius: 4px; }
+  .topic-banner { align-self: center; max-width: 80%; text-align: center; color: var(--muted);
+    font-size: 13px; padding: 6px 18px; border-bottom: 1px solid var(--border); }
+  /* agent message — accent-bar card like the TUI transcript */
+  .agent { max-width: 84%; align-self: flex-start; background: var(--surface);
+    border-left: 3px solid var(--seat, var(--primary)); padding: 10px 14px;
+    animation: rise .3s ease both; }
+  .agent .who { display: flex; align-items: center; gap: 8px; margin-bottom: 6px;
+    font-weight: 700; font-size: 11px; color: var(--seat, var(--fg)); }
+  .agent .who .avatar { font-size: 14px; }
+  .agent .who-tag { margin-left: auto; font-size: 9px; font-weight: 500; text-transform: uppercase;
+    letter-spacing: .08em; color: var(--muted); border: 1px solid var(--border); padding: 1px 6px;
+    border-radius: 10px; white-space: nowrap; }
+  .agent .search-chip { font-size: 11px; color: var(--warning); margin-bottom: 6px; opacity: .9;
+    word-break: break-word; }
+  .agent .body { line-height: 1.6; font-size: 13px; color: var(--fg); }
+  .agent .body p { margin: 0 0 8px; }
+  .agent .body p:last-child { margin-bottom: 0; }
+  .agent .body pre { background: var(--bg) !important; border: 1px solid var(--border);
+    border-left: 3px solid var(--accent); border-radius: 3px; padding: 10px 12px; overflow-x: auto;
+    margin: 8px 0; font-size: 12px; }
+  .agent .body code { background: var(--boost); border: 1px solid var(--border); padding: 1px 5px;
+    border-radius: 3px; font-size: 12px; color: var(--secondary); }
+  .agent .body pre code { background: none !important; border: 0; padding: 0 !important; color: var(--fg); }
+  .agent.streaming .body::after { content: '▍'; color: var(--seat, var(--primary));
+    animation: blink 1s steps(1) infinite; margin-left: 1px; }
+  /* phase divider */
+  .phase { align-self: center; color: var(--accent); font-size: 10px; text-transform: uppercase;
+    letter-spacing: .2em; font-weight: 700; margin: 8px 0 2px; display: flex; align-items: center; gap: 12px; }
+  .phase::before, .phase::after { content: ''; height: 1px; width: 60px; background: var(--border); }
+  .phase-sub { text-transform: none; letter-spacing: 0; font-weight: 400; color: var(--muted);
+    font-size: 10px; margin-left: 10px; }
+  /* one-line democratic votes */
+  .vote-row { align-self: stretch; max-width: 84%; display: flex; flex-wrap: wrap;
+    align-items: baseline; gap: 8px; padding: 6px 12px; font-size: 12px;
+    border-left: 3px solid var(--seat, var(--primary)); background: var(--surface);
+    animation: rise .25s ease both; }
+  .vote-row .v-voter { font-weight: 700; color: var(--seat, var(--fg)); }
+  .vote-row .v-arrow { color: var(--muted); }
+  .vote-row .v-choice { font-weight: 700; }
+  .vote-row .v-choice.muted { color: var(--muted); font-weight: 400; font-style: italic; }
+  .vote-row .v-why { flex-basis: 100%; color: var(--muted); font-size: 11px; }
+  /* verdict */
+  .verdict { align-self: stretch; margin: 8px 0; background: var(--surface);
+    border: 1px solid var(--border); border-left: 4px solid var(--warning); border-radius: 4px;
+    padding: 16px 18px; animation: rise .4s ease both; }
+  .verdict h3 { font-size: 14px; color: var(--fg); margin-bottom: 10px; display: flex;
+    align-items: center; gap: 10px; font-weight: 800; }
+  .verdict h3 .w-name { color: var(--warning); }
+  .verdict-sub { color: var(--muted); font-size: 11px; margin: -4px 0 12px; letter-spacing: .03em; }
+  .leaderboard { display: flex; flex-direction: column; gap: 6px; margin-bottom: 12px; }
+  .lb-row { display: flex; align-items: center; gap: 10px; font-size: 12px; }
+  .lb-row .lb-name { width: 150px; color: var(--muted); flex-shrink: 0; overflow: hidden;
+    text-overflow: ellipsis; white-space: nowrap; }
+  .lb-row.win .lb-name { color: var(--fg); font-weight: 700; }
+  .lb-bar { flex: 1; height: 8px; background: var(--panel); border-radius: 4px; overflow: hidden; }
+  .lb-fill { height: 100%; background: var(--seat, var(--primary)); border-radius: 4px;
+    transition: width .6s ease; }
+  .lb-row .lb-pts { width: 60px; text-align: right; color: var(--warning); font-weight: 600;
+    font-variant-numeric: tabular-nums; }
+  .winner-label { margin-top: 4px; font-size: 9.5px; text-transform: uppercase; letter-spacing: .12em;
+    color: var(--muted); }
+  .verdict .winner-answer { border-top: 1px solid var(--border); padding-top: 10px; line-height: 1.6;
+    font-size: 13px; color: var(--fg); }
+  .verdict .winner-answer pre { background: var(--bg) !important; border: 1px solid var(--border);
+    border-left: 3px solid var(--accent); padding: 10px 12px; border-radius: 3px; overflow-x: auto; }
+  /* your approval — the council recommends, you decide */
+  .approval { margin-top: 14px; padding-top: 12px; border-top: 1px solid var(--border); }
+  .approval-lead { font-size: 10px; text-transform: uppercase; letter-spacing: .12em;
+    color: var(--muted); margin-bottom: 9px; }
+  .approval-row { display: flex; flex-wrap: wrap; gap: 8px; }
+  .approval-row button { font: inherit; font-size: 11px; padding: 5px 12px; cursor: pointer;
+    background: var(--panel); color: var(--fg); border: 1px solid var(--border);
+    border-radius: 3px; transition: border-color .15s, color .15s, background .15s; }
+  .approval-row button:hover { border-color: var(--primary); background: var(--boost); }
+  .approval-row button[data-decision="approve"] { border-color: var(--success); color: var(--success); }
+  .approval-row button[data-decision="approve"]:hover { background: rgba(115,218,202,.12); }
+  .approval-row button[data-decision="revise"] { border-color: var(--warning); color: var(--warning); }
+  .approval-row button[data-decision="revise"]:hover { background: rgba(224,175,104,.12); }
+  .approval-row button[data-decision="reject"] { border-color: var(--error); color: var(--error); }
+  .approval-row button[data-decision="reject"]:hover { background: rgba(247,118,142,.12); }
+  .approval-state { font-size: 11.5px; display: flex; align-items: center; gap: 8px; }
+  .approval-state[data-decision="approve"] { color: var(--success); }
+  .approval-state[data-decision="revise"] { color: var(--warning); }
+  .approval-state[data-decision="reject"] { color: var(--error); }
+  .approval-note { color: var(--muted); font-size: 10.5px; }
+  .error-msg { align-self: center; color: var(--error); font-size: 12px; padding: 8px 18px;
+    text-align: center; background: rgba(247,118,142,.08); border-radius: 4px;
+    border: 1px solid rgba(247,118,142,.25); }
+  /* welcome */
+  .welcome { text-align: center; margin: auto; padding: 40px 24px; max-width: 520px;
+    animation: rise .5s ease both; }
+  .welcome h2 { font-weight: 800; font-size: 22px; color: var(--fg); margin-bottom: 6px; }
+  .welcome .divider { width: 40px; height: 2px; background: var(--primary); margin: 14px auto; }
+  .welcome p { font-size: 12.5px; line-height: 1.7; color: var(--muted); margin-bottom: 8px; }
+  .welcome .seats { display: flex; flex-wrap: wrap; gap: 8px; justify-content: center; margin-top: 14px; }
+  .welcome .seat { font-size: 11px; padding: 3px 10px; border: 1px solid var(--border);
+    border-radius: 20px; color: var(--muted); }
+  /* --- composer (TUI prompt dock) --- */
+  #decision-options, #decision-criteria { width:100%; box-sizing:border-box; background:var(--panel); color:var(--fg); border:1px solid var(--border); border-radius:8px; padding:10px; margin:8px 0 16px; font:inherit; }
+  .clarification { padding:20px; border:1px solid var(--primary); border-radius:12px; margin:16px 0; }
+  .clarification button, .clarification input { margin:8px 8px 0 0; padding:10px; max-width:100%; }
+  #input-area { display: flex; align-items: stretch; border-top: 1px solid var(--border);
+    background: var(--panel); flex-shrink: 0; }
+  .mode-badge { display: flex; align-items: center; padding: 0 10px; font-size: 10px; font-weight: 700;
+    letter-spacing: .14em; text-transform: uppercase; color: #b4c6ef; background: #161f33;
+    border-right: 1px solid var(--primary); }
+  .prefix { display: flex; align-items: center; padding: 0 10px; color: var(--accent); font-weight: 800;
+    font-size: 16px; background: var(--panel); user-select: none; }
+  #input-area textarea { flex: 1; resize: none; min-height: 56px; max-height: 180px; background: var(--panel);
+    border: 0; color: var(--fg); font: inherit; font-size: 13px; padding: 16px 12px; outline: none;
+    transition: background .2s; }
+  #input-area textarea::placeholder { color: var(--muted); }
+  #input-area textarea:focus { background: var(--boost); }
+  #input-area textarea:disabled { opacity: .45; }
+  #input-area button { background: var(--primary); color: #0f0f16; border: 0; font: inherit; font-weight: 700;
+    font-size: 12px; padding: 0 18px; cursor: pointer; letter-spacing: .06em; transition: background .15s; }
+  #input-area button:hover:not(:disabled) { background: #8fb4ff; }
+  #input-area button:disabled { opacity: .4; cursor: not-allowed; }
+  /* --- status bar --- */
+  #status-bar { display: flex; align-items: center; gap: 16px; padding: 5px 14px;
+    background: var(--surface); border-top: 1px solid var(--border); font-size: 11px; color: var(--muted);
+    flex: 0 0 auto; animation: rise .4s ease both; animation-delay: .24s; }
+  #status-bar .dot.on { color: var(--success); }
+  #status-bar .dot.off { color: var(--muted); }
+  #status-bar .spacer { flex: 1; }
+  #status-bar .hint { color: var(--muted); }
+  /* The running phase message. Clamped so a long name ("The Skeptic is forming
+     an answer…") cannot push the clock off a narrow window. */
+  .status-msg { flex: 0 1 auto; min-width: 0; max-width: 46vw; overflow: hidden;
+    text-overflow: ellipsis; white-space: nowrap; color: var(--fg); opacity: .85; }
+  .status-msg:empty { display: none; }
+  /* --- motion --- */
+  @keyframes rise { from { opacity: 0; transform: translateY(6px); } to { opacity: 1; transform: none; } }
+  @keyframes fadein { from { opacity: 0; } to { opacity: 1; } }
+  @keyframes blink { 0%,49% { opacity: 1; } 50%,100% { opacity: 0; } }
+  @keyframes pulse { 0%,100% { opacity: .75; } 50% { opacity: 1; } }
+  @media (prefers-reduced-motion: reduce) { * { animation: none !important; transition: none !important; } }
+__WORKSPACE_STYLE__
+__COUNCIL_STYLE__
+__WORKSPACE_CONTROLS_STYLE__
+</style>
+</head>
+<body class="workspace-app council-app">
+<aside class="workspace-sidebar" id="workspace-sidebar" aria-label="Council sidebar">
+<div class="workspace-brand"><span class="brand-icon" aria-hidden="true">◆</span>
+  <span>Nova</span><span class="brand-product">Council</span>
+  <button class="sidebar-close" id="sidebar-close" aria-label="Close sidebar">×</button></div>
+<div class="sidebar-content">
+  <button id="new-thread" class="sidebar-primary" data-return-to-chat title="Clear the prior session and start fresh">＋ New discussion</button>
+  <h2 class="sidebar-label">Your advisors</h2>
+  <div id="bench" aria-label="Council advisors"></div>
+  <p class="sidebar-note advisor-placeholder">Your council assembles when you send a question. Follow each advisor's progress here.</p>
+  <h2 class="sidebar-label">Decision brief</h2>
+  <label for="decision-options">Options · one per line (2–8)</label>
+  <textarea id="decision-options" rows="4" placeholder="Build internally&#10;Buy a service&#10;Delay the decision"></textarea>
+  <label for="decision-criteria">Criteria and constraints</label>
+  <textarea id="decision-criteria" rows="3" placeholder="Budget, deadline, priorities, risk tolerance…"></textarea>
+  <p class="advisor-placeholder">Add options to enable advisor questions and option voting. Leave empty for an open discussion.</p>
+  <button id="stop-council" type="button">Stop discussion</button>
+  <h2 class="sidebar-label">How it works</h2>
+  <ol class="workflow"><li>Independent perspectives</li><li>Questions, trade-offs, and voting</li><li>Chairman synthesis</li><li>The final decision is yours</li></ol>
+</div>
+<div class="sidebar-footer"><span>Follow-ups stay in this discussion.</span>__WORKSPACE_METRICS_HTML__<span class="sid" id="sid"></span></div>
+</aside>
+<main class="workspace-chat" id="conversation">
+<header class="chat-topbar"><button class="mobile-menu" id="sidebar-toggle" aria-controls="workspace-sidebar"
+  aria-expanded="false" aria-label="Open sidebar">☰</button><div class="chat-heading"><h1>Council</h1>
+  <p>A few perspectives. A clearer decision.</p></div><button type="button" class="settings-open" data-council-settings>Council settings</button><span id="run-badge" class="run-badge">● convening</span></header>
+__WORKSPACE_CONTROLS_HTML__
+<div id="messages" role="tabpanel" aria-labelledby="view-synthesis" aria-live="polite" tabindex="0">
+  <div class="welcome"><div class="welcome-icon">MULTI-AGENT DELIBERATION</div>
+    <h2>One question. Independent perspectives.</h2>
+    <p>Broadcast your task to specialist advisors in parallel. Review their debate or follow the chairman’s consolidated answer. Choose a preset or use your saved council.</p>
+    <div class="prompt-options">
+      <button class="prompt-option" data-prompt="Help me compare two approaches to ">Compare approaches</button>
+      <button class="prompt-option" data-prompt="Review this decision and challenge my assumptions: ">Review a decision</button>
+      <button class="prompt-option" data-prompt="What trade-offs should I consider for ">Explore trade-offs</button>
+    </div>
+  </div>
+</div>
+<div id="input-area">
+  <span class="mode-badge">council</span>
+  <span class="prefix">&gt;</span>
+  <textarea id="input" rows="1" placeholder="Ask your council a question…" aria-label="Message the council"></textarea>
+  <button id="send-btn">Convene</button>
+</div>
+<div id="status-bar">
+  <span id="conn" class="dot off">○ ready</span>
+  <span id="status-msg" class="status-msg"></span>
+  <span id="stat-run" class="dot off">○ idle</span>
+  <span class="spacer"></span>
+  <span class="hint">⏎ send · ⇧⏎ newline</span>
+  <span id="clock"></span>
+</div>
+</main>
+<button class="workspace-backdrop" id="workspace-backdrop" tabindex="-1"
+  aria-label="Close sidebar"></button>
+<script>
+const $ = id => document.getElementById(id);
+const messages = $('messages');
+const input = $('input');
+const sendBtn = $('send-btn');
+const bench = $('bench');
+let es = null;
+const agentEls = {};    // id -> {wrap, body, buf}
+const benchSeats = {};  // id -> {seat, badge, votes}
+let agentMeta = {};     // id -> {name, avatar, color}
+// The running message lives in its OWN child span. Assigning
+// `statusBar.textContent` here instead would delete every child of the bar —
+// #conn, #stat-run, #clock and all — on the first status update. setRun() then
+// dereferenced the destroyed #stat-run and threw, and because convene() calls
+// setRun(true) *before* `new EventSource(...)`, every follow-up question died
+// before its stream was ever created: text consumed, composer left disabled,
+// nothing rendered. That was the "follow-up chat does nothing" wedge, and a
+// string-grep test for `endRun()` could never have caught it.
+function setStatus(m) { $('status-msg').textContent = m; }
+function setRun(on) {
+  $('run-badge').classList.toggle('show', on);
+  $('council-preset').disabled=on; $('clear-view').disabled=on;$('clear-view').hidden=on;$('workspace-stop').hidden=!on;
+  // Null-guarded: a status/render helper must never be able to wedge the
+  // composer. This bug shipped twice by throwing from exactly here.
+  const sr = $('stat-run');
+  if (!sr) return;
+  sr.textContent = on ? '● running' : '○ idle';
+  sr.className = 'dot ' + (on ? 'on' : 'off');
+}
+function atBottom() { return messages.scrollHeight - messages.scrollTop - messages.clientHeight < 100; }
+function scrollDown(force) { if (force || atBottom()) messages.scrollTop = messages.scrollHeight; }
+function dropWelcome() { const w = messages.querySelector('.welcome'); if (w) w.remove(); }
+function highlight(el) { el.querySelectorAll('pre code').forEach(b => hljs.highlightElement(b)); }
+function el(tag, cls) { const e = document.createElement(tag); if (cls) e.className = cls; return e; }
+function addError(text) {
+  dropWelcome();
+  const e = el('div', 'error-msg'); e.textContent = text;
+  messages.appendChild(e); scrollDown(true);
+}
+function addPhase(text, sub) {
+  const e = el('div', 'phase');
+  const t = el('span', 'phase-title'); t.textContent = text; e.appendChild(t);
+  if (sub) { const s = el('span', 'phase-sub'); s.textContent = sub; e.appendChild(s); }
+  messages.appendChild(e); scrollDown(true);
+}
+/* --- clock --- */
+(function(){
+  const c = document.getElementById('clock');
+  if (!c) return;
+  function tick(){ c.textContent = new Date().toLocaleTimeString([], {hour:'2-digit', minute:'2-digit'}); }
+  tick(); setInterval(tick, 10000);
+})();
+/* --- the bench: the row of advisor seats at the top of the chamber --- */
+function buildBench(agents) {
+  bench.innerHTML = '';
+  for (const k in benchSeats) delete benchSeats[k];
+  agents.forEach(a => {
+    agentMeta[a.id] = a;
+    const seat = el('div', 'seat'); seat.dataset.state = 'idle';
+    seat.style.setProperty('--seat', a.color || 'var(--primary)');
+    const av = el('div', 'seat-av'); av.textContent = a.avatar || '•';
+    const badge = el('div', 'seat-badge'); badge.textContent = '0'; badge.title = 'votes';
+    av.appendChild(badge);
+    const nm = el('div', 'seat-name'); nm.textContent = a.name || a.id;
+    const st = el('div', 'seat-state'); st.textContent = 'waiting';
+    seat.appendChild(av); seat.appendChild(nm); seat.appendChild(st);
+    if(a.id==='chairman'){seat.dataset.chairman='true';st.textContent='standby';}
+    if(a.model||a.role){const details=el('div','seat-details');const model=el('strong');model.textContent=a.model||'Session model (inherit)';const role=el('span');role.textContent=a.role||'';details.append(model,role);seat.appendChild(details);}
+    bench.appendChild(seat);
+    benchSeats[a.id] = { seat, badge, state: st, votes: 0 };
+  });
+  bench.classList.add('active');
+}
+function seatState(id, state, label) {
+  const s = benchSeats[id]; if (!s) return;
+  s.seat.dataset.state = state;
+  if (label) s.state.textContent = label;
+}
+function bumpSeatVote(id) {
+  const s = benchSeats[id]; if (!s) return;
+  s.votes += 1; s.badge.textContent = s.votes; s.badge.classList.add('has');
+}
+function startAgent(meta) {
+  dropWelcome();
+  const wrap = el('div', 'agent streaming');
+  wrap.style.setProperty('--seat', meta.color || 'var(--primary)');
+  const who = el('div', 'who');
+  const av = el('span', 'avatar'); av.textContent = meta.avatar || '•';
+  const nm = el('span'); nm.textContent = meta.name || meta.id;
+  const tag = el('span', 'who-tag'); tag.textContent = 'independent answer';
+  who.appendChild(av); who.appendChild(nm); who.appendChild(tag);
+  const body = el('div', 'body');
+  wrap.appendChild(who); wrap.appendChild(body);
+  messages.appendChild(wrap);
+  agentEls[meta.id] = { wrap, body, buf: '' };
+  seatState(meta.id, 'speaking', 'answering…');
+  scrollDown(true);
+}
+function deltaAgent(id, text) {
+  const a = agentEls[id]; if (!a) return;
+  a.buf += text;
+  a.body.innerHTML = marked.parse(a.buf);
+  highlight(a.body);
+  scrollDown();
+}
+function finishAgent(id, text) {
+  const a = agentEls[id]; if (!a) return;
+  a.wrap.classList.remove('streaming');
+  if (text) { a.body.innerHTML = marked.parse(text); highlight(a.body); }
+  seatState(id, 'answered', 'answered');
+  scrollDown();
+}
+function agentSearch(id, query) {
+  const a = agentEls[id]; if (!a) return;
+  const chip = el('div', 'search-chip');
+  chip.textContent = '🔍 searched: ' + (query || '…');
+  a.wrap.insertBefore(chip, a.body);
+  scrollDown();
+}
+/* Each member casts ONE vote for the best (non-self) answer. */
+function renderVote(ev) {
+  const vm = agentMeta[ev.voter] || {};
+  const cm = ev.choice ? (agentMeta[ev.choice] || {}) : {};
+  const row = el('div', 'vote-row');
+  row.style.setProperty('--seat', vm.color || 'var(--primary)');
+  const voter = el('span', 'v-voter');
+  voter.textContent = (vm.avatar ? vm.avatar + ' ' : '') + (ev.voter_name || ev.voter);
+  const arrow = el('span', 'v-arrow'); arrow.textContent = '→';
+  const choice = el('span', 'v-choice');
+  if (ev.choice) {
+    choice.style.color = cm.color || 'var(--fg)';
+    choice.textContent = (cm.avatar ? cm.avatar + ' ' : '') + (ev.choice_name || '');
+    bumpSeatVote(ev.choice);
+  } else {
+    choice.textContent = '(abstained)';
+    choice.classList.add('muted');
+  }
+  row.appendChild(voter); row.appendChild(arrow); row.appendChild(choice);
+  if (ev.reason) { const why = el('div', 'v-why'); why.textContent = ev.reason; row.appendChild(why); }
+  messages.appendChild(row);
+  scrollDown();
+}
+function renderVerdict(ev) {
+  const wm = agentMeta[ev.winner_id] || {};
+  const card = el('div', 'verdict');
+  card.style.setProperty('--seat', wm.color || 'var(--warning)');
+  if (ev.winner_id && benchSeats[ev.winner_id]) {
+    seatState(ev.winner_id, 'winner', ev.synthesized ? 'vote leader' : 'chosen');
+  }
+  const h = el('h3');
+  h.textContent = ev.synthesized ? 'Final consolidated answer' : 'Council recommendation: ' + (ev.winner_name || 'No consensus');
+  card.appendChild(h);
+  const sub = el('div', 'verdict-sub');
+  sub.textContent = ev.option_tally ? (ev.tied ? 'Split vote · review the trade-offs' : (ev.votes + ' valid option ballots')) : 'by plurality vote (' + (ev.tally ? (ev.tally[ev.winner_id] || 0) : 0) +
+    ' of ' + (ev.votes || 0) + ' votes)';
+  if (ev.synthesized) { sub.textContent = ev.chairman_name + ' · synthesized from advisor analyses and votes'; }
+  card.appendChild(sub);
+  const tally = ev.option_tally || ev.tally || {};
+  const max = Math.max(1, ...Object.values(tally));
+  const board = el('div', 'leaderboard');
+  Object.keys(tally).sort((a, b) => tally[b] - tally[a]).forEach(id => {
+    const m = agentMeta[id] || {};
+    const r = el('div', 'lb-row' + (id === ev.winner_id ? ' win' : ''));
+    r.style.setProperty('--seat', m.color || 'var(--primary)');
+    const name = el('div', 'lb-name'); name.textContent = (m.avatar ? m.avatar + ' ' : '') + (m.name || id);
+    const bar = el('div', 'lb-bar'); const fill = el('div', 'lb-fill');
+    fill.style.width = Math.round((tally[id] / max) * 100) + '%';
+    bar.appendChild(fill);
+    const pts = el('div', 'lb-pts'); pts.textContent = tally[id] + (tally[id] === 1 ? ' vote' : ' votes');
+    r.appendChild(name); r.appendChild(bar); r.appendChild(pts);
+    board.appendChild(r);
+  });
+  card.appendChild(board);
+  if (ev.answer) {
+    const lbl = el('div', 'winner-label'); lbl.textContent = ev.synthesized ? 'Chairman synthesis' : 'Winning answer';
+    const ans = el('div', 'winner-answer');
+    if (ev.option_tally) { ans.textContent = ev.answer; ans.style.whiteSpace = "pre-wrap"; }
+    else { ans.innerHTML = marked.parse(ev.answer); highlight(ans); }
+    card.appendChild(lbl); card.appendChild(ans);
+  }
+  card.appendChild(buildApproval(ev));
+  messages.appendChild(card);
+  scrollDown(true);
+}
+/* The council's vote is a recommendation. The round is not settled until you
+   say so, so every verdict ends at this gate — and the composer stays open
+   afterwards, so the session keeps going as a conversation. */
+const DECISIONS = {
+  approve: { mark: '✓', text: 'Settled by you', note: 'recorded as approved' },
+  revise:  { mark: '↻', text: 'Changes requested', note: 'ask below, the council will build on it' },
+  reject:  { mark: '✕', text: 'Rejected', note: 'ask below to try a different angle' },
+};
+function buildApproval(ev) {
+  const wrap = el('div', 'approval');
+  const lead = el('div', 'approval-lead');
+  lead.textContent = 'Your decision';
+  wrap.appendChild(lead);
+  const row = el('div', 'approval-row');
+  const settle = (decision) => {
+    // One decision per round: freeze the row, then report it to the server so
+    // it outlives this page. A failure to record must not look like a crash.
+    row.remove();
+    const d = DECISIONS[decision];
+    const state = el('div', 'approval-state');
+    state.dataset.decision = decision;
+    const t = el('span'); t.textContent = d.mark + ' ' + d.text;
+    const n = el('span', 'approval-note'); n.textContent = '· ' + d.note;
+    state.appendChild(t); state.appendChild(n);
+    wrap.replaceChildren(lead, state);
+    const topic = (lastTopic() || '').replace(/^“|”$/g, '');
+    fetch('/api/council/decision', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        topic: topic,
+        decision: decision,
+        winner: ev.chairman_name || ev.winner_name || '',
+        winner_id: ev.synthesized ? 'chairman' : (ev.winner_id || ''),
+      }),
+    }).catch(() => {
+      const warn = el('div', 'approval-note');
+      warn.textContent = '· (could not reach the server to record this)';
+      state.appendChild(warn);
+    });
+    if (decision !== 'approve') { input.focus(); }
+  };
+  [['approve', '✓ Approve'], ['revise', '↻ Request changes'], ['reject', '✕ Reject']]
+    .forEach(([d, label]) => {
+      const b = el('button');
+      b.type = 'button';
+      b.dataset.decision = d;
+      b.textContent = label;
+      b.addEventListener('click', () => settle(d));
+      row.appendChild(b);
+    });
+  wrap.appendChild(row);
+  return wrap;
+}
+/* The topic of the round this verdict belongs to: the banner immediately above
+   it, so a click always reports the right question even with several rounds
+   on screen. */
+function lastTopic() {
+  const banners = messages.querySelectorAll('.topic-banner');
+  return banners.length ? banners[banners.length - 1].textContent : '';
+}
+function endRun() {
+  if (es) { es.close(); es = null; }
+  messages.querySelectorAll('.agent.streaming').forEach(node=>node.classList.remove('streaming'));
+  messages.querySelectorAll('.clarification button,.clarification input').forEach(node=>node.disabled=true);
+  input.disabled = false; sendBtn.disabled = false; input.focus();
+  setRun(false);
+  workspaceEnd();
+}
+function convene() {
+  const topic = input.value.trim();
+  if (!topic || es) return;
+  const optionCount = new Set($('decision-options').value.split('\n').map(v=>v.trim()).filter(Boolean)).size;
+  if (optionCount === 1 || optionCount > 8) { setStatus('Please provide 2–8 distinct options, or leave options empty.'); return; }
+  input.value = ''; input.style.height = 'auto';
+  input.disabled = true; sendBtn.disabled = true;
+  setRun(true);
+  for (const k in agentEls) delete agentEls[k];
+  agentMeta = {};
+  dropWelcome();
+  const banner = el('div', 'topic-banner'); banner.textContent = '“' + topic + '”';
+  messages.appendChild(banner);
+  workspaceBegin();
+  setStatus('convening the council…'); scrollDown(true);
+  const params = new URLSearchParams({topic, options:$('decision-options').value, criteria:$('decision-criteria').value,preset:$('council-preset').value});
+  es = new EventSource('/api/council?' + params);
+  es.addEventListener('question', e => {
+    const d = JSON.parse(e.data), card = el('div', 'clarification');
+    const title = el('h3'); title.textContent = d.name + ' asks';
+    const text = el('p'); text.textContent = d.question;
+    const field = el('input'); field.placeholder = 'Your answer or another option'; field.setAttribute('aria-label', d.question);
+    card.append(title, text, field);
+    const answer = async value => {
+      const response = await fetch('/api/council/answer', {method:'POST', headers:{'Content-Type':'application/json'}, body:JSON.stringify({token:d.token, answer:value})}).catch(()=>null);
+      if (!response || !response.ok) { setStatus('Could not send answer. Try again.'); return; }
+      card.querySelectorAll('button,input').forEach(node=>node.disabled=true);
+      text.textContent = d.question + ' — ' + (value || 'Skipped');
+    };
+    [...(d.choices || []), 'Skip'].forEach(choice=>{const b=el('button');b.textContent=choice;b.onclick=()=>answer(choice==='Skip'?'':choice);card.appendChild(b);});
+    const submit=el('button');submit.textContent='Send answer';submit.onclick=()=>answer(field.value);card.appendChild(submit);
+    messages.appendChild(card); setStatus('waiting for your clarification…'); scrollDown(true);
+  });
+  es.addEventListener('question_answered', () => {messages.querySelectorAll('.clarification button,.clarification input').forEach(node=>node.disabled=true);});
+  es.addEventListener('council_start', e => {
+    const d = JSON.parse(e.data);
+    buildBench([...(d.agents || []),...(d.chairman?[d.chairman]:[])]);
+    workspaceTotal=(d.agents||[]).length;updateWorkspaceMetrics();workspaceStage('analysis','Advisors are evaluating independently…');
+    setStatus('the council deliberates independently…');
+  });
+  es.addEventListener('agent_start', e => {
+    const d = JSON.parse(e.data);
+    agentMeta[d.id] = d; startAgent(d);
+    setStatus((d.name || 'an advisor') + ' is forming an answer…');
+  });
+  es.addEventListener('agent_delta', e => { const d = JSON.parse(e.data); deltaAgent(d.id, d.text); });
+  es.addEventListener('agent_tool', e => { const d = JSON.parse(e.data); agentSearch(d.id, d.query); });
+  es.addEventListener('agent_done', e => { const d = JSON.parse(e.data); finishAgent(d.id, d.text); workspaceAnswered.add(d.id);updateWorkspaceMetrics(); });
+  es.addEventListener('vote_start', e => {
+    workspaceStage('voting','Collecting peer reviews and ballots…');
+    addPhase('The Vote', JSON.parse(e.data).options ? 'each advisor votes for a decision option' : 'each advisor casts one vote for the best answer');
+    Object.keys(benchSeats).forEach(id => {if(id!=='chairman'&&benchSeats[id].seat.dataset.state!=='failed')seatState(id, 'voting', 'voting…');});
+    setStatus('the council is voting…');
+  });
+  es.addEventListener('vote', e => { const d=JSON.parse(e.data);renderVote(d);seatState(d.voter,'answered',d.choice?'voted':'abstained');if(d.choice)workspaceVotes++;updateWorkspaceMetrics(); });
+  es.addEventListener('chairman_start', e => {
+    const d=JSON.parse(e.data);workspaceStage('synthesis','Resolving disagreement and synthesizing…');messages.querySelectorAll('.synthesis-wait').forEach(node=>node.remove()); addPhase('Chairman synthesis', 'weighing agreement, disagreement, and evidence');
+    startAgent({id:'chairman',name:d.name,avatar:'⚖',color:'var(--accent)'});agentEls.chairman.wrap.classList.add('chairman-stream');seatState('chairman','speaking','synthesizing…');
+    agentEls.chairman.wrap.querySelector('.who-tag').textContent='consensus synthesis';
+    setStatus('the chairman is consolidating the council…');
+  });
+  es.addEventListener('chairman_delta', e => {deltaAgent('chairman',JSON.parse(e.data).text);});
+  es.addEventListener('vote_result', e => {const d=JSON.parse(e.data);addPhase('Ballots collected', d.tied ? 'Split vote · the chairman will examine the disagreement' : d.votes+' valid votes · awaiting chairman synthesis');});
+  es.addEventListener('agent_failed', e => {const d=JSON.parse(e.data);finishAgent(d.id,'Advisor unavailable for this round.');seatState(d.id,'failed','unavailable');});
+  es.addEventListener('verdict', e => { workspaceCompleted=true;workspaceStage('complete','Consolidated answer ready');seatState('chairman','answered','complete');messages.querySelectorAll('.synthesis-wait').forEach(node=>node.remove());if(agentEls.chairman){agentEls.chairman.wrap.remove();delete agentEls.chairman;} addPhase('The Verdict'); renderVerdict(JSON.parse(e.data)); });
+  es.addEventListener('council_error', e => {
+    let m = 'The council failed.';
+    try { m = JSON.parse(e.data).message || m; } catch (_) {}
+    addError(m); setStatus('error');workspaceStage('error','Discussion failed · see the message below');
+    // endRun(), not setRun(false): an error has to close the stream and
+    // re-enable the composer exactly like `done` does. Leaving `es` non-null
+    // made convene() return immediately on every later send — the input stayed
+    // disabled and follow-up questions silently did nothing, with no clue why.
+    endRun();
+  });
+  es.addEventListener('done', e => { setStatus('the council has spoken'); endRun(); });
+  es.onerror = () => {
+    if (es) { es.close(); }
+    if (!es || es.readyState === EventSource.CLOSED) {
+      setStatus('connection closed'); endRun();
+    }
+  };
+}
+input.addEventListener('input', () => {
+  input.style.height = 'auto';
+  input.style.height = Math.min(input.scrollHeight, 180) + 'px';
+});
+input.addEventListener('keydown', e => {
+  if (e.key === 'Enter' && !e.shiftKey) { e.preventDefault(); convene(); }
+});
+sendBtn.addEventListener('click', convene);
+$('stop-council').addEventListener('click', () => {fetch('/api/council/stop', {method:'POST'}).catch(()=>{});endRun(); setStatus('discussion stopped');});
+const newThreadBtn = $('new-thread');
+function newThread() {
+  if (es) return;  // don't reset mid-run
+  fetch('/api/council/reset').catch(() => {});
+  messages.innerHTML = '';
+  bench.innerHTML = ''; bench.classList.remove('active');
+  for (const k in agentEls) delete agentEls[k];
+  for (const k in benchSeats) delete benchSeats[k];
+  agentMeta = {};
+  const w = el('div', 'welcome');
+  w.innerHTML = '<h2>Fresh Council</h2><div class="divider"></div>' +
+    '<p>Prior session cleared. Pose a new question to convene the council.</p>';
+  messages.appendChild(w);
+  setStatus('ready'); setRun(false);workspaceAnswered.clear();workspaceVotes=0;workspaceElapsed=0;workspaceCompleted=false;workspaceStage('ready','Ready to convene');updateWorkspaceMetrics();loadCouncilPanel();
+  input.focus();
+}
+newThreadBtn.addEventListener('click', newThread);
+__WORKSPACE_CONTROLS_SCRIPT__
+</script>
+<script>__WORKSPACE_SCRIPT__</script>
+__COUNCIL_SETTINGS_HTML__
+<script>__COUNCIL_SETTINGS_SCRIPT__</script>
+</body>
+</html>""".replace("__WORKSPACE_STYLE__", WORKSPACE_CSS).replace("__WORKSPACE_SCRIPT__", WORKSPACE_SCRIPT).replace("__COUNCIL_STYLE__", COUNCIL_STYLE).replace("__COUNCIL_SETTINGS_HTML__", COUNCIL_SETTINGS_HTML).replace("__COUNCIL_SETTINGS_SCRIPT__", COUNCIL_SETTINGS_SCRIPT).replace("__WORKSPACE_CONTROLS_STYLE__", WORKSPACE_CONTROLS_STYLE).replace("__WORKSPACE_CONTROLS_HTML__", WORKSPACE_CONTROLS_HTML).replace("__WORKSPACE_CONTROLS_SCRIPT__", WORKSPACE_CONTROLS_SCRIPT).replace("__WORKSPACE_METRICS_HTML__", WORKSPACE_METRICS_HTML)
+# ---------------------------------------------------------------------------
+# HTTP request handler
+# ---------------------------------------------------------------------------
+class _ChatHandler(BaseHTTPRequestHandler):
+    """HTTP request handler for the council server."""
+    def log_message(self, format, *args):  # noqa: A002 - signature from stdlib
+        """Silence the default stderr logging; we use Nova's console."""
+    def do_GET(self):
+        parsed = urlparse(self.path)
+        if parsed.path == "/":
+            self._serve_html()
+        elif parsed.path == "/api/council":
+            qs = parse_qs(parsed.query)
+            topic = (qs.get("topic") or [""])[0]
+            self._stream_council(topic)
+        elif parsed.path == "/api/council/panel":
+            from novacode_cli.council_settings import load_settings
+            from novacode_cli.council_workspace import apply_web_preset, panel_descriptor
+            try:
+                preset = parse_qs(parsed.query).get("preset", ["saved"])[0]
+                self._settings_reply(200, panel_descriptor(apply_web_preset(load_settings(), preset)))
+            except ValueError as exc:
+                self._settings_reply(400, {"error": str(exc)})
+            except Exception:
+                self._settings_reply(500, {"error": "Could not load the council panel"})
+        elif parsed.path == "/api/council/settings":
+            self._council_settings(save=False)
+        elif parsed.path == "/api/council/reset":
+            self._reset_history()
+        else:
+            self.send_response(404)
+            self.end_headers()
+    def _reset_history(self) -> None:
+        """Clear the council's cross-round history and decisions (fresh thread)."""
+        global _council_history, _council_decisions
+        with _run_lock:
+            _council_history = []
+            _council_decisions = []
+        self.send_response(204)
+        self.send_header("Access-Control-Allow-Origin", "*")
+        self.end_headers()
+    def do_POST(self):
+        """Record the user's decision on a round."""
+        parsed = urlparse(self.path)
+        if parsed.path == "/api/council/settings":
+            self._council_settings(save=True)
+            return
+        if parsed.path == "/api/council/stop":
+            with _pending_lock:
+                for producer in _producers:
+                    producer.cancel()
+            self._decision_reply(204)
+            return
+        if parsed.path == "/api/council/answer":
+            try:
+                length = int(self.headers.get("Content-Length", "0"))
+                if not 0 < length <= _MAX_DECISION_BODY:
+                    raise ValueError()
+                payload = json.loads(self.rfile.read(length))
+                token, answer = payload.get("token"), payload.get("answer")
+                if not isinstance(token, str) or not isinstance(answer, str) or len(answer) > 4000:
+                    raise ValueError()
+                with _pending_lock:
+                    target = _pending_answers.get(token)
+                if target is None:
+                    self._decision_reply(409)
+                    return
+                target.put_nowait(answer.strip() or "Skipped; state assumptions explicitly.")
+                self._decision_reply(204)
+            except (ValueError, TypeError, AttributeError, queue.Full):
+                self._decision_reply(400)
+            return
+        if parsed.path != "/api/council/decision":
+            self.send_response(404)
+            self.send_header("Content-Length", "0")
+            self.end_headers()
+            return
+        self._record_decision()
+    def _council_settings(self, *, save: bool) -> None:
+        """Share the inline editor's validated settings, never credentials."""
+        from novacode_cli.council_web_settings import save_web_settings, settings_catalog
+        status = 200
+        try:
+            if save:
+                origin = self.headers.get("Origin")
+                if origin and urlparse(origin).netloc != self.headers.get("Host"):
+                    self._settings_reply(403, {"error": "Save settings from the Council page."})
+                    return
+                if self.headers.get_content_type() != "application/json":
+                    raise ValueError("Settings require application/json")
+                length = int(self.headers.get("Content-Length", "0"))
+                if not 0 < length <= 512 * 1024:
+                    raise ValueError("Settings body must be between 1 and 524288 bytes")
+                raw = json.loads(self.rfile.read(length))
+                with _settings_lock:
+                    result = {"settings": save_web_settings(raw)}
+            else:
+                with _settings_lock:
+                    result = settings_catalog()
+        except (ValueError, UnicodeDecodeError) as exc:
+            status, result = 400, {"error": str(exc)}
+        except Exception:
+            logger.exception("Could not access Council settings")
+            status, result = 500, {"error": "Could not read or save Council settings. Check Nova's configuration file permissions."}
+        self._settings_reply(status, result)
+    def _settings_reply(self, status: int, data: dict) -> None:
+        payload = json.dumps(data).encode("utf-8")
+        self.send_response(status)
+        self.send_header("Content-Type", "application/json; charset=utf-8")
+        self.send_header("Content-Length", str(len(payload)))
+        self.send_header("Cache-Control", "no-store")
+        self.end_headers()
+        try:
+            self.wfile.write(payload)
+        except (BrokenPipeError, ConnectionResetError, OSError):
+            pass
+    def _record_decision(self) -> None:
+        """Store one ``{"topic", "decision", ...}`` decision, bounded.
+        Best-effort and never fatal: the page has already rendered the settled
+        state locally, so a rejected write is a lost record, not a broken UI.
+        """
+        try:
+            length = int(self.headers.get("Content-Length") or 0)
+        except (TypeError, ValueError):
+            length = 0
+        if length <= 0 or length > _MAX_DECISION_BODY:
+            self._decision_reply(400)
+            return
+        try:
+            raw = self.rfile.read(length)
+            payload = json.loads(raw.decode("utf-8"))
+        except (OSError, UnicodeDecodeError, json.JSONDecodeError):
+            self._decision_reply(400)
+            return
+        if not isinstance(payload, dict):
+            self._decision_reply(400)
+            return
+        decision = str(payload.get("decision") or "")
+        if decision not in DECISION_KEYS:
+            self._decision_reply(400)
+            return
+        entry = {
+            "topic": str(payload.get("topic") or "")[:500],
+            "decision": decision,
+            "winner": str(payload.get("winner") or "")[:200],
+            "winner_id": str(payload.get("winner_id") or "")[:100],
+            "at": time.time(),
+        }
+        global _council_decisions
+        with _run_lock:
+            _council_decisions.append(entry)
+            if len(_council_decisions) > _MAX_KEPT_ROUNDS:
+                del _council_decisions[:-_MAX_KEPT_ROUNDS]
+        self._decision_reply(204)
+    def _decision_reply(self, status: int) -> None:
+        self.send_response(status)
+        self.send_header("Content-Length", "0")
+        self.send_header("Access-Control-Allow-Origin", "*")
+        self.end_headers()
+    def _serve_html(self):
+        html = _make_chat_html()
+        self.send_response(200)
+        self.send_header("Content-Type", "text/html; charset=utf-8")
+        self.send_header("Cache-Control", "no-cache")
+        self.end_headers()
+        try:
+            self.wfile.write(html.encode("utf-8"))
+        except (BrokenPipeError, ConnectionResetError, OSError):
+            pass
+    # ---- SSE council stream ----
+    def _stream_council(self, topic: str) -> None:
+        """Run a council over *topic* and stream it to the browser as SSE."""
+        self.send_response(200)
+        self.send_header("Content-Type", "text/event-stream; charset=utf-8")
+        self.send_header("Cache-Control", "no-cache")
+        self.send_header("X-Accel-Buffering", "no")
+        self.send_header("Connection", "keep-alive")
+        self.send_header("Access-Control-Allow-Origin", "*")
+        self.end_headers()
+        loop = _main_loop
+        if loop is None or not loop.is_running():
+            self._sse("council_error", {"message": "Agent event loop is not running"})
+            self._sse("done", {})
+            return
+        if not topic.strip():
+            self._sse("council_error", {"message": "A topic is required"})
+            self._sse("done", {})
+            return
+        if not _run_lock.acquire(blocking=False):
+            self._sse("council_error", {"message": "The council is already in session"})
+            self._sse("done", {})
+            return
+        try:
+            self._pump_council(topic, loop)
+        finally:
+            _run_lock.release()
+    def _pump_council(self, topic: str, loop: asyncio.AbstractEventLoop) -> None:
+        """Bridge the async council generator (on *loop*) to this thread as SSE.
+        Carries prior rounds in so the advisors can follow up, and records this
+        round into the shared history once it completes.
+        """
+        q: queue.Queue[Any] = queue.Queue(maxsize=2048)
+        parameters = parse_qs(urlparse(self.path).query)
+        options = list(dict.fromkeys(o.strip()[:200] for o in parameters.get("options", [""])[0].split("\n") if o.strip()))[:8]
+        criteria = parameters.get("criteria", [""])[0][:2000]
+        tokens: list[str] = []
+        async def ask(event):
+            token = event["token"]
+            with _pending_lock:
+                answers = _pending_answers[token]
+            try:
+                deadline = time.monotonic() + 240
+                while time.monotonic() < deadline:
+                    try:
+                        return answers.get_nowait()
+                    except queue.Empty:
+                        await asyncio.sleep(.1)
+                return "No response before timeout; state assumptions explicitly."
+            finally:
+                with _pending_lock:
+                    _pending_answers.pop(token, None)
+        history = list(_council_history)  # snapshot for this run
+        async def enqueue(item):
+            while q.full():
+                await asyncio.sleep(.02)
+            q.put_nowait(item)
+        async def _produce() -> None:
+            from novacode_cli.council import get_council_model, run_council
+            from novacode_cli.council_settings import load_settings, resolve_models
+            try:
+                model = await asyncio.to_thread(get_council_model)
+                settings = await asyncio.to_thread(load_settings)
+                from novacode_cli.council_workspace import apply_web_preset, panel_descriptor
+                settings = apply_web_preset(settings, parameters.get("preset", ["saved"])[0])
+                models = await asyncio.to_thread(resolve_models, settings, model, debate=True)
+                from novacode_cli.council_consensus import resolve_chairman
+                chairman_model = await asyncio.to_thread(resolve_chairman, settings, model, models)
+            except Exception as exc:  # noqa: BLE001
+                await enqueue(("council_error", {"message": f"Model unavailable: {exc}"}))
+                await enqueue(_STREAM_END)
+                return
+            try:
+                kwargs = dict(personas=settings.personas(debate=True), history=history, member_models=models)
+                if len(options) >= 2:
+                    from novacode_cli.council_decision import run_decision
+                    stream = run_decision(topic, model, options=options, criteria=criteria, ask=ask, **kwargs)
+                else:
+                    stream = run_council(topic, model, **kwargs)
+                from novacode_cli.council_consensus import run_web_consensus
+                stream = run_web_consensus(topic, stream, chairman_model, settings.judge)
+                async for event in stream:
+                    if event.get("type") == "council_start":
+                        event.update(panel_descriptor(settings))
+                    if event.get("type") == "question":
+                        event["token"] = secrets.token_urlsafe(24)
+                    event = dict(event)
+                    etype = event.pop("type")
+                    if etype == "question":
+                        tokens.append(event["token"])
+                        # Register before delivery; the browser may answer immediately.
+                        with _pending_lock:
+                            _pending_answers[event["token"]] = queue.Queue(maxsize=1)
+                    await enqueue((etype, event))
+            except Exception as exc:  # noqa: BLE001
+                await enqueue(("council_error", {"message": str(exc)}))
+            finally:
+                # Cancellation must never block the event loop on a full queue.
+                if asyncio.current_task().cancelling():
+                    if q.full():
+                        q.get_nowait()
+                    q.put_nowait(_STREAM_END)
+                else:
+                    await enqueue(_STREAM_END)
+        producer = asyncio.run_coroutine_threadsafe(_produce(), loop)
+        def producer_finished(future):
+            # Also wake the HTTP thread if cancelled during model setup.
+            if future.cancelled():
+                try:
+                    q.put_nowait(_STREAM_END)
+                except queue.Full:
+                    pass
+        producer.add_done_callback(producer_finished)
+        with _pending_lock:
+            _producers.add(producer)
+        # Accumulate this round from the event stream so we can append it to the
+        # shared history once it completes cleanly.
+        id_to_name: dict[str, str] = {}
+        texts: dict[str, str] = {}
+        order: list[str] = []
+        winner_name: str | None = None
+        completed = False
+        last_event = time.monotonic()
+        while True:
+            try:
+                item = q.get(timeout=_HEARTBEAT_SECONDS)
+            except queue.Empty:
+                if time.monotonic() - last_event >= _IDLE_TIMEOUT:
+                    self._sse("council_error", {"message": "The council timed out"})
+                    self._sse("done", {})
+                    producer.cancel()
+                    break
+                if not self._sse("heartbeat", {}):
+                    producer.cancel()
+                    break
+                continue
+            last_event = time.monotonic()
+            if item is _STREAM_END:
+                # Record the round before signalling done, so a follow-up request
+                # (or a test) observing the terminal event sees it persisted.
+                if completed and texts:
+                    transcript = [[id_to_name.get(i, i), texts[i]] for i in order if i in texts]
+                    _council_history.append(
+                        {"topic": topic, "transcript": transcript, "winner": winner_name}
+                    )
+                    # Bounded: the prompt only carries the last few rounds
+                    # (council._MAX_HISTORY_ROUNDS), but the list itself grew
+                    # forever — a long-lived server accumulated every full
+                    # transcript it had ever produced. Keep a small margin over
+                    # what the prompt uses and drop the rest.
+                    if len(_council_history) > _MAX_KEPT_ROUNDS:
+                        del _council_history[:-_MAX_KEPT_ROUNDS]
+                self._sse("done", {})
+                break
+            etype, data = item
+            if etype == "council_start":
+                for a in data.get("agents", []):
+                    id_to_name[a["id"]] = a["name"]
+                    order.append(a["id"])
+            elif etype == "agent_done":
+                texts[data["id"]] = data.get("text", "")
+            elif etype == "verdict":
+                winner_name = data.get("chairman_name") or data.get("winner_name")
+                if data.get("synthesized"):
+                    id_to_name["chairman"] = data.get("chairman_name", "Chairman")
+                    texts["chairman"] = data.get("answer", "")
+                    order.append("chairman")
+                completed = True
+            if etype == "done":
+                continue  # persist history before the single terminal frame
+            if not self._sse(etype, data):
+                producer.cancel()  # client disconnected
+                break
+        producer.cancel()
+        with _pending_lock:
+            _producers.discard(producer)
+            for token in tokens:
+                _pending_answers.pop(token, None)
+    def _sse(self, event: str, data: dict) -> bool:
+        """Write one SSE frame. Returns False if the client has disconnected."""
+        try:
+            frame = f"event: {event}\ndata: {json.dumps(data)}\n\n"
+            self.wfile.write(frame.encode("utf-8"))
+            self.wfile.flush()
+            return True
+        except (BrokenPipeError, ConnectionResetError, OSError):
+            return False
+class _QuietThreadingHTTPServer(ThreadingHTTPServer):
+    """Threading server that doesn't dump a traceback when a client disconnects.
+    Browsers (and the SSE client) routinely drop the connection mid-stream — on
+    ``done``, on navigation, or on reset — which surfaces as a connection error
+    in the handler thread. That's expected, not a server fault, so we swallow it.
+    """
+    daemon_threads = True
+    def handle_error(self, request, client_address) -> None:  # noqa: ANN001, ARG002
+        exc = sys.exc_info()[1]
+        if isinstance(exc, (BrokenPipeError, ConnectionError, OSError)):
+            return
+        logger.exception("Council server error handling %s", client_address)
+# ---------------------------------------------------------------------------
+# Helpers
+# ---------------------------------------------------------------------------
+def _port_is_answered(port: int, *, timeout: float = 0.35) -> bool:
+    """True if something already answers connections on *port*.
+    A successful ``bind("localhost", port)`` is NOT proof the port is usable.
+    When another process holds ``0.0.0.0:port`` (Docker Desktop's proxy is the
+    common case, and WSL's relay behaves the same way), binding the narrower
+    ``localhost`` address still succeeds, but connections are answered by that
+    process — so /council opened to somebody else's 404
+    (``{"detail":"Not Found"}``) instead of Nova's page.
+    Connecting is the only honest test: if the connect succeeds, someone is
+    listening and the port is not ours to take.
+    """
+    for family, addr in (
+        (socket.AF_INET, ("127.0.0.1", port)),
+        (socket.AF_INET6, ("::1", port)),
+    ):
+        try:
+            with socket.socket(family, socket.SOCK_STREAM) as s:
+                s.settimeout(timeout)
+                if s.connect_ex(addr) == 0:
+                    return True
+        except OSError:
+            continue  # e.g. no IPv6 stack — not evidence of a squatter
+    return False
+def _find_available_port(start_port: int = 8000, max_attempts: int = 100) -> int:
+    """Find a port that is both bindable AND not already being answered."""
+    for port in range(start_port, start_port + max_attempts):
+        with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
+            try:
+                s.bind(("localhost", port))
+            except OSError:
+                continue
+        # Bindable is necessary but not sufficient — see _port_is_answered.
+        if _port_is_answered(port):
+            continue
+        return port
+    raise RuntimeError(
+        f"No available ports in range {start_port}-{start_port + max_attempts}"
+    )
+# ---------------------------------------------------------------------------
+# Server lifecycle (shared by CLI handler and TUI)
+# ---------------------------------------------------------------------------
+def want_restart() -> bool:
+    """Return True if the server should restart (state reset requested)."""
+    return False
+def is_server_running() -> bool:
+    """Check if the council server is currently running."""
+    return _server is not None
+def get_server_url() -> str | None:
+    """Return the URL of the running server, or None."""
+    if _server_port is None:
+        return None
+    return f"http://localhost:{_server_port}"
+def set_agent_refs(
+    agent: Any,
+    assistant_id: str | None,
+    session_state: Any,
+    loop: asyncio.AbstractEventLoop,
+) -> None:
+    """Store session references for the background HTTP server thread.
+    The council itself only needs the event ``loop`` (to run model calls), but we
+    keep the agent/session references for parity with the CLI/TUI call sites.
+    """
+    global _agent, _assistant_id, _session_state, _main_loop
+    _agent = agent
+    _assistant_id = assistant_id
+    _session_state = session_state
+    _main_loop = loop
+def start_chat_server() -> str:
+    """Start the HTTP council server in a daemon thread.
+    Must have called :func:`set_agent_refs` first.
+    Returns:
+        The URL the server is listening on.
+    Raises:
+        RuntimeError: If no available port is found.
+    """
+    global _server, _server_thread, _server_port
+    if _server is not None:
+        assert _server_port is not None
+        return f"http://localhost:{_server_port}"
+    port = _find_available_port(8000)
+    _server_port = port
+    _server = _QuietThreadingHTTPServer(("localhost", port), _ChatHandler)
+    _server_thread = threading.Thread(
+        target=_server.serve_forever, daemon=True, name="chat-http-server"
+    )
+    _server_thread.start()
+    return f"http://localhost:{port}"
+def stop_chat_server() -> bool:
+    """Stop the running council server.
+    Returns:
+        True if the server was stopped, False if it wasn't running.
+    """
+    global _server, _server_thread, _server_port, _council_history, _council_decisions
+    if _server is None:
+        return False
+    with _pending_lock:
+        for producer in _producers:
+            producer.cancel()
+        _pending_answers.clear()
+    _server.shutdown()
+    _server.server_close()
+    _server = None
+    _server_thread = None
+    _server_port = None
+    _council_history = []
+    _council_decisions = []
+    return True
+# ---------------------------------------------------------------------------
+# CLI command handler
+# ---------------------------------------------------------------------------
+async def handle_chat_command() -> bool:
+    """Handle the /chat command — start the council web UI (CLI entry point)."""
+    if is_server_running():
+        url = get_server_url()
+        assert url is not None
+        console.print()
+        console.print(f"[green]Council UI already running at [bold]{url}[/bold][/green]")
+        webbrowser.open(url)
+        return True
+    url = start_chat_server()
+    console.print()
+    console.print(f"[bold {COLORS['primary']}]== Nova Council ==[/bold {COLORS['primary']}]")
+    console.print(f"[green]Council UI started at [bold]{url}[/bold][/green]")
+    webbrowser.open(url)
+    console.print("[dim]  Type /chat stop to stop the server.[/dim]")
+    console.print()
+    return True
+async def handle_chat_stop_command() -> bool:
+    """Handle the /chat stop command — stop the council web UI (CLI entry)."""
+    from novacode_cli.commands.share_handler import stop_share
+    stop_share("council")
+    if not is_server_running():
+        console.print("[yellow]Council server is not running.[/yellow]")
+        return True
+    console.print("[dim]Shutting down council server...[/dim]")
+    stop_chat_server()
+    console.print("[green]Council server stopped.[/green]")
+    return True
+# ---------------------------------------------------------------------------
+# Registry
+# ---------------------------------------------------------------------------
+def register_commands(registry) -> None:
+    """Register the /council command."""
+    from novacode_cli.commands import CommandContext
+    async def _handle(ctx: CommandContext) -> bool:
+        set_agent_refs(
+            ctx.agent,
+            ctx.assistant_id,
+            ctx.session_state,
+            asyncio.get_running_loop(),
+        )
+        args = (ctx.cmd_args or "").strip()
+        if args == "stop":
+            return await handle_chat_stop_command()
+        return await handle_chat_command()
+    registry.register("council", _handle)