novacode-cli 1.2.0__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- novacode_cli/__init__.py +29 -0
- novacode_cli/__main__.py +6 -0
- novacode_cli/_lazy_heavy.py +99 -0
- novacode_cli/_version.py +3 -0
- novacode_cli/agent_stream.py +178 -0
- novacode_cli/agents/agent_file.py +250 -0
- novacode_cli/agents/agent_mailbox.py +120 -0
- novacode_cli/agents/approval_decisions.py +146 -0
- novacode_cli/agents/arg_repair.py +196 -0
- novacode_cli/agents/async_agents/__init__.py +6 -0
- novacode_cli/agents/async_agents/_config.py +213 -0
- novacode_cli/agents/async_agents/_mcp_tools.py +192 -0
- novacode_cli/agents/async_agents/_specialist.py +84 -0
- novacode_cli/agents/async_agents/_test_commands.py +89 -0
- novacode_cli/agents/async_agents/_tools.py +432 -0
- novacode_cli/agents/async_agents/general_purpose.py +42 -0
- novacode_cli/agents/async_agents/langgraph.json +9 -0
- novacode_cli/agents/async_agents/research.py +22 -0
- novacode_cli/agents/async_context.py +303 -0
- novacode_cli/agents/async_on_demand.py +52 -0
- novacode_cli/agents/async_task_errors.py +75 -0
- novacode_cli/agents/async_workspace.py +27 -0
- novacode_cli/agents/attribution.py +165 -0
- novacode_cli/agents/browser_mode.py +119 -0
- novacode_cli/agents/btw_agent.py +71 -0
- novacode_cli/agents/caveman.py +352 -0
- novacode_cli/agents/caveman_support.py +370 -0
- novacode_cli/agents/code_mode.py +774 -0
- novacode_cli/agents/code_runtime.py +160 -0
- novacode_cli/agents/context_compaction.py +1339 -0
- novacode_cli/agents/core_agent.py +2710 -0
- novacode_cli/agents/default_subagents/__init__.py +24 -0
- novacode_cli/agents/default_subagents/async_subagents.py +296 -0
- novacode_cli/agents/default_subagents/builtin/browser-automation-agent.md +110 -0
- novacode_cli/agents/default_subagents/builtin/bug-fix-agent.md +22 -0
- novacode_cli/agents/default_subagents/builtin/bug-investigation-agent.md +42 -0
- novacode_cli/agents/default_subagents/builtin/code-explorer.md +37 -0
- novacode_cli/agents/default_subagents/builtin/code-review-agent.md +33 -0
- novacode_cli/agents/default_subagents/builtin/dependency-audit-agent.md +34 -0
- novacode_cli/agents/default_subagents/builtin/documentation-update-agent.md +46 -0
- novacode_cli/agents/default_subagents/builtin/performance-audit-agent.md +41 -0
- novacode_cli/agents/default_subagents/builtin/plan-scout-agent.md +64 -0
- novacode_cli/agents/default_subagents/builtin/refactoring-agent.md +35 -0
- novacode_cli/agents/default_subagents/builtin/refactoring-specialist-agent.md +175 -0
- novacode_cli/agents/default_subagents/builtin/security-audit-agent.md +96 -0
- novacode_cli/agents/default_subagents/builtin/test-generation-agent.md +33 -0
- novacode_cli/agents/default_subagents/builtin/test-runner-agent.md +55 -0
- novacode_cli/agents/default_subagents/prompt.py +88 -0
- novacode_cli/agents/default_subagents/subagents.py +138 -0
- novacode_cli/agents/dream_agent.py +93 -0
- novacode_cli/agents/edit_diagnostics.py +362 -0
- novacode_cli/agents/edit_fallback.py +62 -0
- novacode_cli/agents/handoff.py +166 -0
- novacode_cli/agents/invocation.py +152 -0
- novacode_cli/agents/model_budget.py +42 -0
- novacode_cli/agents/model_retry.py +113 -0
- novacode_cli/agents/model_router.py +420 -0
- novacode_cli/agents/openai_decisions.py +186 -0
- novacode_cli/agents/plan_agent/__init__.py +12 -0
- novacode_cli/agents/plan_agent/plan_agent.py +357 -0
- novacode_cli/agents/plan_agent/plan_mode_middleware.py +64 -0
- novacode_cli/agents/plan_execution.py +237 -0
- novacode_cli/agents/ponytail.py +66 -0
- novacode_cli/agents/prime.py +274 -0
- novacode_cli/agents/provider_caching.py +99 -0
- novacode_cli/agents/server_launcher.py +904 -0
- novacode_cli/agents/strict_tools.py +384 -0
- novacode_cli/agents/task_discipline.py +294 -0
- novacode_cli/agents/tool_call_repair.py +290 -0
- novacode_cli/agents/tool_offload.py +291 -0
- novacode_cli/agents/tool_search.py +806 -0
- novacode_cli/agents/tool_search_variants.py +106 -0
- novacode_cli/agents/tool_verdicts.py +1194 -0
- novacode_cli/agents/user_async_agents.py +312 -0
- novacode_cli/artifacts/__init__.py +10 -0
- novacode_cli/artifacts/registry.py +278 -0
- novacode_cli/artifacts/server.py +426 -0
- novacode_cli/assets/Nova.png +0 -0
- novacode_cli/assets/nova-avatar.png +0 -0
- novacode_cli/audio/__init__.py +301 -0
- novacode_cli/audio/capture.py +137 -0
- novacode_cli/audio/downloads.py +273 -0
- novacode_cli/audio/pipeline.py +391 -0
- novacode_cli/audio/playback.py +87 -0
- novacode_cli/audio/providers.py +208 -0
- novacode_cli/audio/speakable.py +78 -0
- novacode_cli/audio/stt.py +132 -0
- novacode_cli/audio/stt_deepgram.py +69 -0
- novacode_cli/audio/stt_elevenlabs.py +89 -0
- novacode_cli/audio/stt_parakeet.py +94 -0
- novacode_cli/audio/stt_whistle.py +61 -0
- novacode_cli/audio/summarize.py +92 -0
- novacode_cli/audio/tts.py +85 -0
- novacode_cli/audio/tts_kokoro.py +73 -0
- novacode_cli/audio/tts_orpheus.py +180 -0
- novacode_cli/audio/tts_pocket.py +131 -0
- novacode_cli/audio/tts_sano.py +69 -0
- novacode_cli/audio/vad.py +145 -0
- novacode_cli/backends/__init__.py +17 -0
- novacode_cli/backends/filesystem.py +894 -0
- novacode_cli/backends/native_search.py +92 -0
- novacode_cli/bootstrap/__init__.py +9 -0
- novacode_cli/bootstrap/env_snapshot.py +240 -0
- novacode_cli/bootstrap/steering.py +464 -0
- novacode_cli/bootstrap/vision_router.py +604 -0
- novacode_cli/brand.py +362 -0
- novacode_cli/cli_args.py +718 -0
- novacode_cli/commands/__init__.py +237 -0
- novacode_cli/commands/agents_commands.py +231 -0
- novacode_cli/commands/auth_handler.py +40 -0
- novacode_cli/commands/browser_use_handler.py +75 -0
- novacode_cli/commands/cache_handler.py +32 -0
- novacode_cli/commands/chat_handler.py +1357 -0
- novacode_cli/commands/ci_fix.py +171 -0
- novacode_cli/commands/claude_plan.py +331 -0
- novacode_cli/commands/codex_plan.py +195 -0
- novacode_cli/commands/commands.py +1113 -0
- novacode_cli/commands/create_handler.py +124 -0
- novacode_cli/commands/create_server.py +1887 -0
- novacode_cli/commands/cron_handler.py +119 -0
- novacode_cli/commands/dream_handler.py +203 -0
- novacode_cli/commands/effort_handler.py +65 -0
- novacode_cli/commands/evolution_handler.py +214 -0
- novacode_cli/commands/file_commands.py +381 -0
- novacode_cli/commands/handoff_handler.py +68 -0
- novacode_cli/commands/hooks_handler.py +269 -0
- novacode_cli/commands/init_handler.py +146 -0
- novacode_cli/commands/learning_handler.py +160 -0
- novacode_cli/commands/lite_mode_handler.py +76 -0
- novacode_cli/commands/log_commands.py +363 -0
- novacode_cli/commands/mcp_handler.py +29 -0
- novacode_cli/commands/model_handler.py +29 -0
- novacode_cli/commands/notifications_handler.py +158 -0
- novacode_cli/commands/onboard_handler.py +121 -0
- novacode_cli/commands/plan_handler.py +440 -0
- novacode_cli/commands/planner_usage.py +250 -0
- novacode_cli/commands/plugin_install_handler.py +38 -0
- novacode_cli/commands/plugins_handler.py +35 -0
- novacode_cli/commands/prime_handler.py +455 -0
- novacode_cli/commands/prompt_handler.py +149 -0
- novacode_cli/commands/provider_usage.py +160 -0
- novacode_cli/commands/ralph_events.py +106 -0
- novacode_cli/commands/ralph_handler.py +1293 -0
- novacode_cli/commands/refine_handler.py +213 -0
- novacode_cli/commands/research_handler.py +202 -0
- novacode_cli/commands/rootapp_remote.py +83 -0
- novacode_cli/commands/router_handler.py +36 -0
- novacode_cli/commands/server_commands.py +249 -0
- novacode_cli/commands/session_commands.py +203 -0
- novacode_cli/commands/share_handler.py +450 -0
- novacode_cli/commands/side_commands.py +366 -0
- novacode_cli/commands/skill_invoke.py +420 -0
- novacode_cli/commands/skills_commands.py +48 -0
- novacode_cli/commands/trace_handler.py +322 -0
- novacode_cli/commands/trello_handler.py +226 -0
- novacode_cli/commands/trello_remote.py +177 -0
- novacode_cli/commands/trello_server.py +1214 -0
- novacode_cli/commands/vision_handler.py +127 -0
- novacode_cli/commands/voice_handler.py +447 -0
- novacode_cli/commands/webhook_handler.py +134 -0
- novacode_cli/commands/wiki_commands.py +227 -0
- novacode_cli/compaction.py +753 -0
- novacode_cli/computation_cache.py +159 -0
- novacode_cli/computer/__init__.py +1 -0
- novacode_cli/computer/persistent.py +234 -0
- novacode_cli/computer/preview.py +253 -0
- novacode_cli/computer/runtime.py +474 -0
- novacode_cli/computer/windows_console.py +152 -0
- novacode_cli/computer/windows_qemu.py +211 -0
- novacode_cli/config/browser_mode.py +159 -0
- novacode_cli/config/catalog_models.py +95 -0
- novacode_cli/config/config.py +1388 -0
- novacode_cli/config/credentials.py +540 -0
- novacode_cli/config/google_oauth_auth.py +281 -0
- novacode_cli/config/model_capabilities.py +343 -0
- novacode_cli/config/model_catalog.py +275 -0
- novacode_cli/config/model_create.py +1325 -0
- novacode_cli/config/model_manager.py +695 -0
- novacode_cli/config/nova_config.py +1283 -0
- novacode_cli/config/openai_chatgpt_auth.py +384 -0
- novacode_cli/config/opencode_gateway.py +25 -0
- novacode_cli/config/plan_mode.py +188 -0
- novacode_cli/config/provider_auth.py +438 -0
- novacode_cli/config/provider_catalog.json +5127 -0
- novacode_cli/config/provider_registry.py +38 -0
- novacode_cli/config/provider_transports.py +258 -0
- novacode_cli/config/role_models.py +175 -0
- novacode_cli/context/__init__.py +50 -0
- novacode_cli/context/_analysis.py +799 -0
- novacode_cli/context/_budget.py +116 -0
- novacode_cli/context/_conversation.py +73 -0
- novacode_cli/context/_dynamic.py +264 -0
- novacode_cli/context/_model_config.py +380 -0
- novacode_cli/context/_models_dev.py +99 -0
- novacode_cli/context/archives.py +248 -0
- novacode_cli/context/estimates.py +65 -0
- novacode_cli/context/history.py +17 -0
- novacode_cli/context/knowledge_cache.py +292 -0
- novacode_cli/context/manager.py +101 -0
- novacode_cli/context/observations.py +65 -0
- novacode_cli/context/pressure.py +168 -0
- novacode_cli/context/provider_accounting.py +109 -0
- novacode_cli/context/snapshot.py +493 -0
- novacode_cli/context/strategies.py +279 -0
- novacode_cli/context/task_progress.py +122 -0
- novacode_cli/core/__init__.py +0 -0
- novacode_cli/core/agent_loop.py +1821 -0
- novacode_cli/core/autonomous_loop.py +277 -0
- novacode_cli/core/code_approvals.py +57 -0
- novacode_cli/core/input_preparation.py +276 -0
- novacode_cli/core/reasoning.py +67 -0
- novacode_cli/core/streaming.py +326 -0
- novacode_cli/core/subagent_tasks.py +696 -0
- novacode_cli/core/subagent_tracking.py +235 -0
- novacode_cli/core/tool_results.py +116 -0
- novacode_cli/core/verification_loop.py +272 -0
- novacode_cli/council.py +595 -0
- novacode_cli/council_consensus.py +115 -0
- novacode_cli/council_decision.py +157 -0
- novacode_cli/council_planner.py +1421 -0
- novacode_cli/council_settings.py +208 -0
- novacode_cli/council_web_settings.py +41 -0
- novacode_cli/council_workspace.py +56 -0
- novacode_cli/cowork/__init__.py +10 -0
- novacode_cli/cowork/broker_middleware.py +162 -0
- novacode_cli/cowork/launcher.py +102 -0
- novacode_cli/cowork/policy.py +284 -0
- novacode_cli/cowork/ui.py +826 -0
- novacode_cli/daemons/__init__.py +1 -0
- novacode_cli/daemons/registry.py +342 -0
- novacode_cli/desktop_notifications.py +302 -0
- novacode_cli/doctor.py +251 -0
- novacode_cli/embeddings.py +109 -0
- novacode_cli/entrypoint.py +56 -0
- novacode_cli/errors/__init__.py +19 -0
- novacode_cli/errors/handlers.py +648 -0
- novacode_cli/errors/provider_errors.py +249 -0
- novacode_cli/errors/taxonomy.py +80 -0
- novacode_cli/events.py +179 -0
- novacode_cli/file_ops.py +714 -0
- novacode_cli/git_safety.py +281 -0
- novacode_cli/handoff.py +383 -0
- novacode_cli/headless/__init__.py +18 -0
- novacode_cli/headless/input.py +58 -0
- novacode_cli/headless/output.py +224 -0
- novacode_cli/headless/pipe.py +532 -0
- novacode_cli/headless/runner.py +461 -0
- novacode_cli/hermes/__init__.py +39 -0
- novacode_cli/hermes/activation.py +297 -0
- novacode_cli/hermes/config.py +129 -0
- novacode_cli/hermes/curator.py +199 -0
- novacode_cli/hermes/evolution.py +374 -0
- novacode_cli/hermes/ledger.py +364 -0
- novacode_cli/hermes/memory_tiers.py +969 -0
- novacode_cli/hermes/middleware.py +678 -0
- novacode_cli/hermes/overview.py +174 -0
- novacode_cli/hermes/prompt_evolution.py +503 -0
- novacode_cli/hermes/refine_loop.py +643 -0
- novacode_cli/hermes/refinement_log.py +190 -0
- novacode_cli/hermes/review.py +674 -0
- novacode_cli/hermes/skill_debate.py +135 -0
- novacode_cli/hermes/skill_discovery.py +450 -0
- novacode_cli/hermes/skill_manager.py +335 -0
- novacode_cli/hermes/skill_proposals.py +43 -0
- novacode_cli/hermes/test_gaming.py +119 -0
- novacode_cli/hermes/tracker.py +435 -0
- novacode_cli/hermes/tuner.py +206 -0
- novacode_cli/hermes/verification_memory.py +134 -0
- novacode_cli/hermes/verifier.py +277 -0
- novacode_cli/hitl/__init__.py +22 -0
- novacode_cli/hitl/interrupts.py +493 -0
- novacode_cli/hooks.py +359 -0
- novacode_cli/image_utils.py +517 -0
- novacode_cli/init/__init__.py +7 -0
- novacode_cli/init/events.py +43 -0
- novacode_cli/input_utils.py +526 -0
- novacode_cli/install_commands.py +87 -0
- novacode_cli/integrations/__init__.py +82 -0
- novacode_cli/integrations/daytona.py +122 -0
- novacode_cli/integrations/docker.py +309 -0
- novacode_cli/integrations/host_path.py +111 -0
- novacode_cli/integrations/langsmith.py +151 -0
- novacode_cli/integrations/modal.py +134 -0
- novacode_cli/integrations/runloop.py +130 -0
- novacode_cli/integrations/sandbox_factory.py +1388 -0
- novacode_cli/integrations/sandbox_registry.py +312 -0
- novacode_cli/integrations/workdir_backend.py +589 -0
- novacode_cli/main.py +2078 -0
- novacode_cli/mcp/__init__.py +73 -0
- novacode_cli/mcp/auth.py +189 -0
- novacode_cli/mcp/client.py +571 -0
- novacode_cli/mcp/code_mode.py +5 -0
- novacode_cli/mcp/code_runtime.py +5 -0
- novacode_cli/mcp/commands.py +902 -0
- novacode_cli/mcp/config.py +406 -0
- novacode_cli/mcp/generic.py +128 -0
- novacode_cli/mcp/middleware.py +993 -0
- novacode_cli/mcp/presets.py +367 -0
- novacode_cli/memory/__init__.py +1 -0
- novacode_cli/memory/agent_memory.py +1312 -0
- novacode_cli/memory/builtin_lessons.py +60 -0
- novacode_cli/memory/dream_gates.py +192 -0
- novacode_cli/memory/limits.py +59 -0
- novacode_cli/memory/parsed_cache.py +106 -0
- novacode_cli/memory/recall_stats.py +97 -0
- novacode_cli/memory/semantic.py +116 -0
- novacode_cli/memory/store.py +335 -0
- novacode_cli/memory/wiki.py +274 -0
- novacode_cli/migrate.py +185 -0
- novacode_cli/onboarding.py +649 -0
- novacode_cli/onboarding_check.py +119 -0
- novacode_cli/path_approval.py +297 -0
- novacode_cli/plan_archive.py +148 -0
- novacode_cli/plugins/__init__.py +121 -0
- novacode_cli/plugins/claude_plugins.py +538 -0
- novacode_cli/plugins/cli.py +168 -0
- novacode_cli/plugins/components.py +413 -0
- novacode_cli/plugins/hooks.py +356 -0
- novacode_cli/plugins/loader.py +317 -0
- novacode_cli/plugins/marketplaces.py +199 -0
- novacode_cli/plugins/storage.py +70 -0
- novacode_cli/prime.py +759 -0
- novacode_cli/prime_factory/__init__.py +15 -0
- novacode_cli/prime_factory/container.py +198 -0
- novacode_cli/prime_factory/controller.py +565 -0
- novacode_cli/prime_factory/knowledge.py +261 -0
- novacode_cli/prime_factory/publication.py +218 -0
- novacode_cli/prime_factory/recovery.py +50 -0
- novacode_cli/prime_factory/research.py +370 -0
- novacode_cli/prime_factory/runner.py +608 -0
- novacode_cli/prime_factory/runtime.py +261 -0
- novacode_cli/prime_factory/state.py +201 -0
- novacode_cli/prime_factory/store.py +128 -0
- novacode_cli/prime_factory/worker.py +129 -0
- novacode_cli/prime_factory/workflow.py +899 -0
- novacode_cli/prime_factory/workspace.py +317 -0
- novacode_cli/prime_memory.py +290 -0
- novacode_cli/process_manager.py +585 -0
- novacode_cli/project_onboard.py +537 -0
- novacode_cli/prompts/System_Prompt_Nova.jinja +23 -0
- novacode_cli/prompts/__init__.py +168 -0
- novacode_cli/prompts/agent_definitions.jinja +11 -0
- novacode_cli/prompts/agent_generation.jinja +125 -0
- novacode_cli/prompts/async_agents/general_purpose.jinja +22 -0
- novacode_cli/prompts/claude_plan_mode.jinja +12 -0
- novacode_cli/prompts/coding_workflow.jinja +18 -0
- novacode_cli/prompts/computer_use.jinja +17 -0
- novacode_cli/prompts/core_agent_system.jinja +81 -0
- novacode_cli/prompts/delegation.jinja +15 -0
- novacode_cli/prompts/desktop_power.jinja +4 -0
- novacode_cli/prompts/file_paths.jinja +15 -0
- novacode_cli/prompts/file_tracker.jinja +23 -0
- novacode_cli/prompts/init_agents_md.jinja +56 -0
- novacode_cli/prompts/init_exploration.jinja +174 -0
- novacode_cli/prompts/init_semantic_orchestrate.jinja +37 -0
- novacode_cli/prompts/instruction_scope.jinja +5 -0
- novacode_cli/prompts/learnings_extraction.jinja +45 -0
- novacode_cli/prompts/longterm_memory.jinja +54 -0
- novacode_cli/prompts/mcp.jinja +84 -0
- novacode_cli/prompts/memory_consolidation.jinja +40 -0
- novacode_cli/prompts/nova_evolution.jinja +73 -0
- novacode_cli/prompts/nova_review.jinja +158 -0
- novacode_cli/prompts/nova_skill_debate.jinja +36 -0
- novacode_cli/prompts/nova_standing_instructions.jinja +26 -0
- novacode_cli/prompts/nova_verify.jinja +100 -0
- novacode_cli/prompts/onboard_dashboard.jinja +378 -0
- novacode_cli/prompts/plan_agent.jinja +87 -0
- novacode_cli/prompts/plan_scouts.jinja +5 -0
- novacode_cli/prompts/plan_storage.jinja +8 -0
- novacode_cli/prompts/planning.jinja +82 -0
- novacode_cli/prompts/ponytail/LICENSE +21 -0
- novacode_cli/prompts/ponytail/UPSTREAM.json +15 -0
- novacode_cli/prompts/ponytail/hooks/ponytail-config.js +175 -0
- novacode_cli/prompts/ponytail/hooks/ponytail-instructions.js +98 -0
- novacode_cli/prompts/ponytail/skills/ponytail/SKILL.md +52 -0
- novacode_cli/prompts/ponytail/skills/ponytail-audit/SKILL.md +103 -0
- novacode_cli/prompts/ponytail/skills/ponytail-debt/SKILL.md +44 -0
- novacode_cli/prompts/ponytail/skills/ponytail-gain/SKILL.md +52 -0
- novacode_cli/prompts/ponytail/skills/ponytail-help/SKILL.md +76 -0
- novacode_cli/prompts/ponytail/skills/ponytail-review/SKILL.md +101 -0
- novacode_cli/prompts/prompt_evolution.jinja +27 -0
- novacode_cli/prompts/ralph_iteration.jinja +75 -0
- novacode_cli/prompts/refine_gate.jinja +31 -0
- novacode_cli/prompts/refine_plan.jinja +64 -0
- novacode_cli/prompts/refine_review.jinja +34 -0
- novacode_cli/prompts/research_delivery.jinja +9 -0
- novacode_cli/prompts/research_swarm.jinja +130 -0
- novacode_cli/prompts/response_style.jinja +5 -0
- novacode_cli/prompts/session_summarization.jinja +86 -0
- novacode_cli/prompts/skill_creation.jinja +85 -0
- novacode_cli/prompts/subagents/fact_checker.jinja +48 -0
- novacode_cli/prompts/subagents/financial_analyst.jinja +50 -0
- novacode_cli/prompts/subagents/literature_reviewer.jinja +52 -0
- novacode_cli/prompts/subagents/market_analyst.jinja +48 -0
- novacode_cli/prompts/subagents/research_synthesizer.jinja +57 -0
- novacode_cli/prompts/subagents/technical_researcher.jinja +56 -0
- novacode_cli/prompts/subagents/web_researcher.jinja +46 -0
- novacode_cli/prompts/summarization.jinja +107 -0
- novacode_cli/prompts/summarization_answers.jinja +23 -0
- novacode_cli/prompts/summarization_questions.jinja +32 -0
- novacode_cli/prompts/vision_caption.jinja +21 -0
- novacode_cli/prompts/voice_summary.jinja +65 -0
- novacode_cli/prompts/wiki_file.jinja +57 -0
- novacode_cli/prompts/wiki_ingest.jinja +87 -0
- novacode_cli/recovery.py +383 -0
- novacode_cli/remote/__init__.py +45 -0
- novacode_cli/remote/approvals.py +282 -0
- novacode_cli/remote/async_task_clients.py +97 -0
- novacode_cli/remote/async_task_watcher.py +240 -0
- novacode_cli/remote/bridge.py +905 -0
- novacode_cli/remote/command_menu.py +26 -0
- novacode_cli/remote/command_ui.py +243 -0
- novacode_cli/remote/config.py +199 -0
- novacode_cli/remote/discord_bridge.py +530 -0
- novacode_cli/remote/discord_format.py +31 -0
- novacode_cli/remote/discord_threads.py +225 -0
- novacode_cli/remote/images.py +97 -0
- novacode_cli/remote/processor.py +601 -0
- novacode_cli/remote/rootapp_bot/bot.cjs +16 -0
- novacode_cli/remote/rootapp_bot/package-lock.json +2683 -0
- novacode_cli/remote/rootapp_bot/package.json +18 -0
- novacode_cli/remote/rootapp_bot/transport.cjs +80 -0
- novacode_cli/remote/rootapp_bridge.py +370 -0
- novacode_cli/remote/rootapp_setup.py +89 -0
- novacode_cli/remote/routing.py +103 -0
- novacode_cli/remote/scheduler.py +302 -0
- novacode_cli/remote/session.py +164 -0
- novacode_cli/remote/status.py +411 -0
- novacode_cli/remote/streaming.py +188 -0
- novacode_cli/remote/telegram_bridge.py +1118 -0
- novacode_cli/remote/telegram_format.py +215 -0
- novacode_cli/remote/telegram_hub.py +256 -0
- novacode_cli/remote/voice_notes.py +120 -0
- novacode_cli/remote/webhook_adapters.py +167 -0
- novacode_cli/remote/webhook_server.py +154 -0
- novacode_cli/rewind.py +150 -0
- novacode_cli/rooms/__init__.py +1 -0
- novacode_cli/rooms/bridge.py +86 -0
- novacode_cli/rooms/cli.py +231 -0
- novacode_cli/rooms/nova.py +227 -0
- novacode_cli/rooms/runtime.py +299 -0
- novacode_cli/rooms/store.py +538 -0
- novacode_cli/rooms/workspace.py +94 -0
- novacode_cli/security/__init__.py +29 -0
- novacode_cli/security/approval_context.py +45 -0
- novacode_cli/security/delegated_approval.py +68 -0
- novacode_cli/security/local_http.py +85 -0
- novacode_cli/security/middleware.py +87 -0
- novacode_cli/security/paths.py +35 -0
- novacode_cli/security/policy.py +535 -0
- novacode_cli/security/policy_writer.py +90 -0
- novacode_cli/security/prompt_injection.py +203 -0
- novacode_cli/security/remember.py +81 -0
- novacode_cli/security/rule_synthesis.py +116 -0
- novacode_cli/security/secret_files.py +61 -0
- novacode_cli/security/session_allow.py +114 -0
- novacode_cli/security/unicode_security.py +516 -0
- novacode_cli/security/validator.py +173 -0
- novacode_cli/server/__init__.py +9 -0
- novacode_cli/server/app.py +632 -0
- novacode_cli/server/event_adapter.py +189 -0
- novacode_cli/server/session_manager.py +90 -0
- novacode_cli/server_main.py +64 -0
- novacode_cli/server_runner/dev_server.py +530 -0
- novacode_cli/server_runner/test_runner.py +470 -0
- novacode_cli/session/__init__.py +1 -0
- novacode_cli/session/adapters/__init__.py +240 -0
- novacode_cli/session/adapters/claude_code.py +102 -0
- novacode_cli/session/adapters/codex.py +77 -0
- novacode_cli/session/adapters/harness_native.py +75 -0
- novacode_cli/session/checkpoint_coordinator.py +448 -0
- novacode_cli/session/context_restore.py +25 -0
- novacode_cli/session/history_export.py +228 -0
- novacode_cli/session/history_tree.py +174 -0
- novacode_cli/session/imported_context.py +267 -0
- novacode_cli/session/runtime_identity.py +32 -0
- novacode_cli/session/session_persistence.py +1168 -0
- novacode_cli/session/session_prompt_builder.py +279 -0
- novacode_cli/session/session_restore.py +351 -0
- novacode_cli/session/session_summarization.py +20 -0
- novacode_cli/session/transcript_journal.py +153 -0
- novacode_cli/sessions/__init__.py +11 -0
- novacode_cli/sessions/gateway.py +84 -0
- novacode_cli/sessions/launch.py +51 -0
- novacode_cli/sessions/lease.py +213 -0
- novacode_cli/sessions/messaging.py +255 -0
- novacode_cli/sessions/protocol.py +216 -0
- novacode_cli/sessions/resume.py +31 -0
- novacode_cli/sessions/supervisor.py +498 -0
- novacode_cli/sessions/tasks.py +73 -0
- novacode_cli/sessions/tui_messaging.py +413 -0
- novacode_cli/sessions/worker.py +652 -0
- novacode_cli/sessions/worktree.py +262 -0
- novacode_cli/shell/__init__.py +27 -0
- novacode_cli/shell/jobs.py +475 -0
- novacode_cli/shell/middleware.py +1568 -0
- novacode_cli/shell/os_sandbox.py +205 -0
- novacode_cli/shell/output.py +181 -0
- novacode_cli/shell/patterns.py +275 -0
- novacode_cli/shell/processes.py +87 -0
- novacode_cli/shell/utils.py +236 -0
- novacode_cli/skills/__init__.py +26 -0
- novacode_cli/skills/builtin/handoff/SKILL.md +15 -0
- novacode_cli/skills/curation_middleware.py +69 -0
- novacode_cli/skills/executable.py +161 -0
- novacode_cli/skills/libraries.py +102 -0
- novacode_cli/skills/load.py +248 -0
- novacode_cli/skills/prune.py +215 -0
- novacode_cli/skills/refreshing_middleware.py +896 -0
- novacode_cli/skills/retrieval.py +248 -0
- novacode_cli/skills/runtime.py +118 -0
- novacode_cli/skills/schema.py +254 -0
- novacode_cli/skills/skill_creation.py +1549 -0
- novacode_cli/skills/skill_lock.py +75 -0
- novacode_cli/skills/skill_system_prompt.py +16 -0
- novacode_cli/skills/skills_prefs.py +126 -0
- novacode_cli/skills/tool_resolver.py +31 -0
- novacode_cli/skills/upstream.py +50 -0
- novacode_cli/skills/versioning.py +291 -0
- novacode_cli/states/Session.py +847 -0
- novacode_cli/states/__init__.py +31 -0
- novacode_cli/states/slices/__init__.py +17 -0
- novacode_cli/states/slices/agent_runtime.py +249 -0
- novacode_cli/states/slices/background_tasks.py +21 -0
- novacode_cli/states/slices/notifications.py +74 -0
- novacode_cli/states/slices/remote_bridge.py +56 -0
- novacode_cli/states/slices/ui_settings.py +49 -0
- novacode_cli/states/slices/wiki.py +25 -0
- novacode_cli/teammates/__init__.py +1 -0
- novacode_cli/teammates/controller.py +557 -0
- novacode_cli/teammates/graph.py +104 -0
- novacode_cli/teammates/registry.py +175 -0
- novacode_cli/teammates/service.py +254 -0
- novacode_cli/teammates/worker.py +19 -0
- novacode_cli/teams/__init__.py +1 -0
- novacode_cli/teams/adapters/__init__.py +1 -0
- novacode_cli/teams/adapters/container.py +316 -0
- novacode_cli/teams/adapters/inprocess.py +206 -0
- novacode_cli/teams/adapters/process.py +364 -0
- novacode_cli/teams/bootstrap.py +246 -0
- novacode_cli/teams/container_git.py +67 -0
- novacode_cli/teams/context.py +34 -0
- novacode_cli/teams/coordinator.py +815 -0
- novacode_cli/teams/gateway.py +200 -0
- novacode_cli/teams/host.py +64 -0
- novacode_cli/teams/legacy.py +52 -0
- novacode_cli/teams/middleware.py +176 -0
- novacode_cli/teams/models.py +104 -0
- novacode_cli/teams/output.py +47 -0
- novacode_cli/teams/protocol.py +50 -0
- novacode_cli/teams/recovery.py +80 -0
- novacode_cli/teams/scheduler.py +44 -0
- novacode_cli/teams/store.py +631 -0
- novacode_cli/teams/worker.py +251 -0
- novacode_cli/teams/workspace.py +100 -0
- novacode_cli/token_utils.py +256 -0
- novacode_cli/tools/__init__.py +104 -0
- novacode_cli/tools/_shared.py +97 -0
- novacode_cli/tools/_types.py +24 -0
- novacode_cli/tools/artifact_tools.py +137 -0
- novacode_cli/tools/code_search_tools.py +330 -0
- novacode_cli/tools/computer_tools.py +77 -0
- novacode_cli/tools/cron_tools.py +65 -0
- novacode_cli/tools/daemon_tool.py +290 -0
- novacode_cli/tools/desktop_tools.py +161 -0
- novacode_cli/tools/fetch_tools.py +530 -0
- novacode_cli/tools/http_tools.py +279 -0
- novacode_cli/tools/inspection_tools.py +107 -0
- novacode_cli/tools/job_tools.py +143 -0
- novacode_cli/tools/knowledge_tools.py +427 -0
- novacode_cli/tools/memory_tools.py +461 -0
- novacode_cli/tools/memory_wiki_tools.py +40 -0
- novacode_cli/tools/notebook_tools.py +238 -0
- novacode_cli/tools/oracle_tool.py +83 -0
- novacode_cli/tools/plan_archive_tools.py +80 -0
- novacode_cli/tools/plan_mode_tools.py +315 -0
- novacode_cli/tools/python_kernel_loop.py +165 -0
- novacode_cli/tools/python_kernel_tool.py +222 -0
- novacode_cli/tools/reflection_tools.py +34 -0
- novacode_cli/tools/scraper_tools.py +377 -0
- novacode_cli/tools/skill_tools.py +275 -0
- novacode_cli/tools/speak_tool.py +51 -0
- novacode_cli/tools/store_memory_tools.py +227 -0
- novacode_cli/tools/ui_tools.py +62 -0
- novacode_cli/tools/waiter_tools.py +408 -0
- novacode_cli/tools/web_tools.py +349 -0
- novacode_cli/tools/wiki_tools.py +152 -0
- novacode_cli/tools/worktree_tools.py +219 -0
- novacode_cli/tracking/__init__.py +10 -0
- novacode_cli/tracking/file_tracker.py +826 -0
- novacode_cli/tracking/local_metrics.py +170 -0
- novacode_cli/tracking/loop_guard.py +507 -0
- novacode_cli/tracking/request_metrics.py +60 -0
- novacode_cli/tracking/tracing.py +692 -0
- novacode_cli/tracking/usage_tree.py +677 -0
- novacode_cli/tracking/workspace_anchoring.py +231 -0
- novacode_cli/tui/__init__.py +11 -0
- novacode_cli/tui/animation_rate.py +9 -0
- novacode_cli/tui/animations.py +332 -0
- novacode_cli/tui/app.py +19315 -0
- novacode_cli/tui/auth_display.py +87 -0
- novacode_cli/tui/auth_screens.py +826 -0
- novacode_cli/tui/avatar.py +294 -0
- novacode_cli/tui/avatar_frames.py +21 -0
- novacode_cli/tui/background_tasks.py +35 -0
- novacode_cli/tui/browser_settings_screen.py +70 -0
- novacode_cli/tui/caveman_screen.py +185 -0
- novacode_cli/tui/council_settings_screen.py +182 -0
- novacode_cli/tui/council_view.py +535 -0
- novacode_cli/tui/decision_settings.py +268 -0
- novacode_cli/tui/diff_preview.py +199 -0
- novacode_cli/tui/gc_tuning.py +63 -0
- novacode_cli/tui/handoff_screen.py +206 -0
- novacode_cli/tui/harness.py +244 -0
- novacode_cli/tui/history_tree_screen.py +179 -0
- novacode_cli/tui/home.py +328 -0
- novacode_cli/tui/home_scene.py +94 -0
- novacode_cli/tui/icons.py +81 -0
- novacode_cli/tui/interface_styles.tcss +327 -0
- novacode_cli/tui/matrix3.py +108 -0
- novacode_cli/tui/mcp_tools_screen.py +131 -0
- novacode_cli/tui/motion.py +178 -0
- novacode_cli/tui/output_body.py +136 -0
- novacode_cli/tui/output_buffer.py +59 -0
- novacode_cli/tui/palette.py +334 -0
- novacode_cli/tui/pickers.py +237 -0
- novacode_cli/tui/prime_panel.py +506 -0
- novacode_cli/tui/provider_signin.py +213 -0
- novacode_cli/tui/pty_shell.py +159 -0
- novacode_cli/tui/reference_screens.py +444 -0
- novacode_cli/tui/resume_picker.py +346 -0
- novacode_cli/tui/rooms.py +597 -0
- novacode_cli/tui/screens.py +7088 -0
- novacode_cli/tui/session_import.py +333 -0
- novacode_cli/tui/session_pane.py +242 -0
- novacode_cli/tui/session_tab.py +42 -0
- novacode_cli/tui/session_transcript.py +118 -0
- novacode_cli/tui/shell_output.py +7 -0
- novacode_cli/tui/stall_watch.py +174 -0
- novacode_cli/tui/statusline.py +40 -0
- novacode_cli/tui/statusline_screen.py +91 -0
- novacode_cli/tui/teammate_updates.py +162 -0
- novacode_cli/tui/teammates.py +548 -0
- novacode_cli/tui/terminal.py +289 -0
- novacode_cli/tui/terminal_view.py +235 -0
- novacode_cli/tui/themes.py +118 -0
- novacode_cli/tui/update_notice.py +84 -0
- novacode_cli/tui/voice_downloads.py +113 -0
- novacode_cli/tui/widgets.py +2038 -0
- novacode_cli/tui/windows_input.py +38 -0
- novacode_cli/tui/workspace_approval.py +165 -0
- novacode_cli/ui/council_web.py +113 -0
- novacode_cli/ui/council_workspace.py +72 -0
- novacode_cli/ui/cowork_web.py +41 -0
- novacode_cli/ui/diff_highlight.py +160 -0
- novacode_cli/ui/execution.py +1396 -0
- novacode_cli/ui/exit_summary.py +65 -0
- novacode_cli/ui/hitl_approval.py +196 -0
- novacode_cli/ui/input_preparation.py +2 -0
- novacode_cli/ui/interrupt_handlers.py +215 -0
- novacode_cli/ui/question_prompt.py +151 -0
- novacode_cli/ui/status_phrases.py +157 -0
- novacode_cli/ui/stream_preview.py +66 -0
- novacode_cli/ui/streaming.py +2 -0
- novacode_cli/ui/subagent_tracking.py +2 -0
- novacode_cli/ui/ui_elements.py +1585 -0
- novacode_cli/ui/web_workspace.py +244 -0
- novacode_cli/ui_events.py +299 -0
- novacode_cli/update_ui.py +243 -0
- novacode_cli/updates.py +489 -0
- novacode_cli/utils/backend_patches.py +399 -0
- novacode_cli/utils/backend_paths.py +467 -0
- novacode_cli/utils/lazy_providers.py +51 -0
- novacode_cli/utils/model_info.py +223 -0
- novacode_cli/utils/pdf_extraction.py +183 -0
- novacode_cli/utils/startup.py +29 -0
- novacode_cli/utils/tasks.py +42 -0
- novacode_cli/utils/windows.py +9 -0
- novacode_cli/vixie/hook_adapter.py +127 -0
- novacode_cli/vixie/server.py +375 -0
- novacode_cli/wiki/__init__.py +15 -0
- novacode_cli/wiki/ask.py +56 -0
- novacode_cli/wiki/file.py +71 -0
- novacode_cli/wiki/ingest.py +184 -0
- novacode_cli/wiki/manager.py +261 -0
- novacode_cli-1.2.0.dist-info/METADATA +271 -0
- novacode_cli-1.2.0.dist-info/RECORD +691 -0
- novacode_cli-1.2.0.dist-info/WHEEL +5 -0
- novacode_cli-1.2.0.dist-info/entry_points.txt +2 -0
- novacode_cli-1.2.0.dist-info/licenses/LICENSE +21 -0
- novacode_cli-1.2.0.dist-info/top_level.txt +1 -0
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
"""Serialize native speech and prevent cancelled synthesis from playing later."""
|
|
2
|
+
|
|
3
|
+
from __future__ import annotations
|
|
4
|
+
|
|
5
|
+
import asyncio
|
|
6
|
+
import logging
|
|
7
|
+
import threading
|
|
8
|
+
from contextvars import ContextVar
|
|
9
|
+
from dataclasses import dataclass, field
|
|
10
|
+
from typing import TYPE_CHECKING
|
|
11
|
+
|
|
12
|
+
if TYPE_CHECKING:
|
|
13
|
+
from collections.abc import Callable
|
|
14
|
+
|
|
15
|
+
import numpy as np
|
|
16
|
+
|
|
17
|
+
logger = logging.getLogger("nova.audio.playback")
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
@dataclass
|
|
21
|
+
class _Speech:
|
|
22
|
+
cancelled: threading.Event = field(default_factory=threading.Event)
|
|
23
|
+
|
|
24
|
+
|
|
25
|
+
_CURRENT: ContextVar[_Speech | None] = ContextVar("nova_speech", default=None)
|
|
26
|
+
_SYNTHESIS_LOCK = threading.Lock()
|
|
27
|
+
_OUTPUT_LOCK = threading.Lock()
|
|
28
|
+
_active: _Speech | None = None
|
|
29
|
+
|
|
30
|
+
|
|
31
|
+
def _stop_current(speech: _Speech) -> None:
|
|
32
|
+
with _OUTPUT_LOCK:
|
|
33
|
+
if _active is speech:
|
|
34
|
+
import sounddevice as sd
|
|
35
|
+
|
|
36
|
+
sd.stop()
|
|
37
|
+
|
|
38
|
+
|
|
39
|
+
async def run_speech(operation: Callable[[], None]) -> None:
|
|
40
|
+
"""Run blocking speech off-loop; cancellation invalidates future playback."""
|
|
41
|
+
speech = _Speech()
|
|
42
|
+
token = _CURRENT.set(speech)
|
|
43
|
+
|
|
44
|
+
def run() -> None:
|
|
45
|
+
# Cancelled native synthesis can still be finishing in its thread.
|
|
46
|
+
# Serialize successors so they cannot re-enter the same native model.
|
|
47
|
+
with _SYNTHESIS_LOCK:
|
|
48
|
+
if not speech.cancelled.is_set():
|
|
49
|
+
operation()
|
|
50
|
+
|
|
51
|
+
try:
|
|
52
|
+
await asyncio.to_thread(run)
|
|
53
|
+
except asyncio.CancelledError:
|
|
54
|
+
speech.cancelled.set()
|
|
55
|
+
try:
|
|
56
|
+
await asyncio.to_thread(_stop_current, speech)
|
|
57
|
+
except Exception: # noqa: BLE001 -- preserve the original cancellation.
|
|
58
|
+
logger.debug("Could not stop cancelled speech", exc_info=True)
|
|
59
|
+
raise
|
|
60
|
+
finally:
|
|
61
|
+
_CURRENT.reset(token)
|
|
62
|
+
|
|
63
|
+
|
|
64
|
+
def play_and_wait(pcm: np.ndarray, samplerate: int) -> bool:
|
|
65
|
+
"""Play owned PCM; return False if empty or cancelled, to stop further synthesis."""
|
|
66
|
+
import numpy as np
|
|
67
|
+
import sounddevice as sd
|
|
68
|
+
|
|
69
|
+
global _active # noqa: PLW0603 -- sounddevice has one process-wide convenience player.
|
|
70
|
+
|
|
71
|
+
speech = _CURRENT.get() or _Speech()
|
|
72
|
+
if not len(pcm):
|
|
73
|
+
return False
|
|
74
|
+
# Retain existing padding and buffering to avoid cutoff and stuttering.
|
|
75
|
+
audio = np.concatenate([pcm, np.zeros(int(samplerate * 0.25), dtype=pcm.dtype)])
|
|
76
|
+
with _OUTPUT_LOCK:
|
|
77
|
+
if speech.cancelled.is_set():
|
|
78
|
+
return False
|
|
79
|
+
sd.play(audio, samplerate, latency="high")
|
|
80
|
+
_active = speech
|
|
81
|
+
try:
|
|
82
|
+
sd.wait()
|
|
83
|
+
finally:
|
|
84
|
+
with _OUTPUT_LOCK:
|
|
85
|
+
if _active is speech:
|
|
86
|
+
_active = None
|
|
87
|
+
return not speech.cancelled.is_set()
|
|
@@ -0,0 +1,208 @@
|
|
|
1
|
+
"""Voice provider registry — discoverable STT and TTS backends.
|
|
2
|
+
|
|
3
|
+
Every provider is declared in :data:`STT_PROVIDERS` or :data:`TTS_PROVIDERS` so
|
|
4
|
+
the ``/voice settings`` command can enumerate choices without importing anything.
|
|
5
|
+
Actual implementation classes are loaded lazily when the provider is selected.
|
|
6
|
+
|
|
7
|
+
The :class:`VoiceSTT` and :class:`VoiceTTS` Protocols define the interface each
|
|
8
|
+
backend must satisfy.
|
|
9
|
+
"""
|
|
10
|
+
|
|
11
|
+
from __future__ import annotations
|
|
12
|
+
|
|
13
|
+
from typing import TYPE_CHECKING, Any, Protocol, runtime_checkable
|
|
14
|
+
|
|
15
|
+
if TYPE_CHECKING:
|
|
16
|
+
import numpy as np
|
|
17
|
+
|
|
18
|
+
# ---------------------------------------------------------------------------
|
|
19
|
+
# Protocols
|
|
20
|
+
# ---------------------------------------------------------------------------
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
@runtime_checkable
|
|
24
|
+
class VoiceSTT(Protocol):
|
|
25
|
+
"""Speech-to-text. Transcribes raw 16 kHz mono int16 audio to a string."""
|
|
26
|
+
|
|
27
|
+
async def transcribe(self, pcm_int16: np.ndarray) -> str:
|
|
28
|
+
"""Transcribe a spoken utterance.
|
|
29
|
+
|
|
30
|
+
Args:
|
|
31
|
+
pcm_int16: 16 kHz mono int16 numpy array of the utterance.
|
|
32
|
+
|
|
33
|
+
Returns:
|
|
34
|
+
The transcribed text, or ``""`` on silence / failure.
|
|
35
|
+
"""
|
|
36
|
+
...
|
|
37
|
+
|
|
38
|
+
|
|
39
|
+
@runtime_checkable
|
|
40
|
+
class VoiceTTS(Protocol):
|
|
41
|
+
"""Text-to-speech. Synthesises text and plays audio through speakers."""
|
|
42
|
+
|
|
43
|
+
async def speak(self, text: str) -> None:
|
|
44
|
+
"""Speak ``text`` aloud. No-op for empty / whitespace-only text."""
|
|
45
|
+
...
|
|
46
|
+
|
|
47
|
+
|
|
48
|
+
# ---------------------------------------------------------------------------
|
|
49
|
+
# Provider registry
|
|
50
|
+
# ---------------------------------------------------------------------------
|
|
51
|
+
|
|
52
|
+
STT_PROVIDERS: dict[str, dict[str, Any]] = {
|
|
53
|
+
"whistle": {
|
|
54
|
+
"name": "Whistle (Cactus)",
|
|
55
|
+
"description": "Local CPU STT — 16.9 MB, seven languages (Cactus runtime)",
|
|
56
|
+
"local": True,
|
|
57
|
+
"requires_key": False,
|
|
58
|
+
"default_model": "whistle",
|
|
59
|
+
"option_field": "model",
|
|
60
|
+
"options": ["whistle"],
|
|
61
|
+
},
|
|
62
|
+
"faster-whisper": {
|
|
63
|
+
"name": "Faster-Whisper",
|
|
64
|
+
"description": "Local, open-source (CUDA/CPU)",
|
|
65
|
+
"local": True,
|
|
66
|
+
"requires_key": False,
|
|
67
|
+
"default_model": "base",
|
|
68
|
+
"option_field": "model",
|
|
69
|
+
# Whisper's published size names. The list is deliberately short — the
|
|
70
|
+
# picker's free-text field reaches any other build, including ones this
|
|
71
|
+
# table does not know about.
|
|
72
|
+
"options": [
|
|
73
|
+
"base",
|
|
74
|
+
"small",
|
|
75
|
+
"medium",
|
|
76
|
+
"large-v3",
|
|
77
|
+
"distil-large-v3",
|
|
78
|
+
"distil-medium.en",
|
|
79
|
+
"distil-small.en",
|
|
80
|
+
],
|
|
81
|
+
"option_labels": {
|
|
82
|
+
"base": "base (fastest)",
|
|
83
|
+
"large-v3": "large-v3 (most accurate)",
|
|
84
|
+
},
|
|
85
|
+
},
|
|
86
|
+
"deepgram": {
|
|
87
|
+
"name": "Deepgram",
|
|
88
|
+
"description": "Cloud API — high-accuracy STT",
|
|
89
|
+
"local": False,
|
|
90
|
+
"requires_key": True,
|
|
91
|
+
"default_model": "nova-2",
|
|
92
|
+
"option_field": "model",
|
|
93
|
+
# Deepgram's documented model names; `nova-2` is this repo's default.
|
|
94
|
+
"options": ["nova-3", "nova-2", "enhanced", "base"],
|
|
95
|
+
},
|
|
96
|
+
"parakeet": {
|
|
97
|
+
"name": "Parakeet (NVIDIA)",
|
|
98
|
+
"description": "NVIDIA Parakeet-TDT-0.6B-v2 via sherpa-onnx (CPU/CUDA)",
|
|
99
|
+
"local": True,
|
|
100
|
+
"requires_key": False,
|
|
101
|
+
"default_model": "parakeet-tdt-0.6b-v2",
|
|
102
|
+
"option_field": "model",
|
|
103
|
+
"options": ["parakeet-tdt-0.6b-v2"],
|
|
104
|
+
},
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
TTS_PROVIDERS: dict[str, dict[str, Any]] = {
|
|
108
|
+
"kokoro": {
|
|
109
|
+
"name": "Kokoro 82M (INT8 CPU)",
|
|
110
|
+
"description": "Local English TTS — ~92 MB weights + 28 MB voices, CPU only",
|
|
111
|
+
"local": True,
|
|
112
|
+
"requires_key": False,
|
|
113
|
+
"default_voice": "af_heart",
|
|
114
|
+
"option_field": "voice",
|
|
115
|
+
"options": ["af_heart", "af_bella", "af_nova", "am_michael", "bf_emma", "bm_george"],
|
|
116
|
+
},
|
|
117
|
+
"sano": {
|
|
118
|
+
"name": "sanoTTS (tiny CPU)",
|
|
119
|
+
"description": "Local English TTS — 1.1-1.8M parameters, ~2-4 MB per voice",
|
|
120
|
+
"local": True,
|
|
121
|
+
"requires_key": False,
|
|
122
|
+
"default_voice": "amy-1p1m",
|
|
123
|
+
"option_field": "voice",
|
|
124
|
+
"options": ["amy-1p1m", "amy", "kristin", "hfc"],
|
|
125
|
+
"option_labels": {"amy-1p1m": "amy-1p1m (smallest)", "amy": "amy (clearer)"},
|
|
126
|
+
},
|
|
127
|
+
"piper": {
|
|
128
|
+
"name": "Piper",
|
|
129
|
+
"description": "Local, low-latency TTS (CPU)",
|
|
130
|
+
"local": True,
|
|
131
|
+
"requires_key": False,
|
|
132
|
+
"default_voice": "en_US-lessac-medium",
|
|
133
|
+
"option_field": "voice",
|
|
134
|
+
# Only voices this repo already references (the pipeline default and the
|
|
135
|
+
# ones saved in Nova.config.json): Piper publishes hundreds, and listing
|
|
136
|
+
# a name the local install has no model for would fail at synthesis.
|
|
137
|
+
# Anything else goes in the picker's free-text field.
|
|
138
|
+
"options": ["en_US-lessac-medium", "en_US-amy-medium", "en_US-libritts_r-medium"],
|
|
139
|
+
"option_labels": {
|
|
140
|
+
"en_US-lessac-medium": "en_US-lessac-medium (default)",
|
|
141
|
+
},
|
|
142
|
+
},
|
|
143
|
+
"elevenlabs": {
|
|
144
|
+
"name": "ElevenLabs",
|
|
145
|
+
"description": "Cloud API — premium voice quality",
|
|
146
|
+
"local": False,
|
|
147
|
+
"requires_key": True,
|
|
148
|
+
"default_voice": "21m00Tcm4TlvDq8ikWAM",
|
|
149
|
+
"option_field": "voice_id",
|
|
150
|
+
# Rows are voice IDs, not names. Only the repo's default is listed:
|
|
151
|
+
# enumerating an account's other voices needs a network call with the
|
|
152
|
+
# key, and a wrong ID fails at synthesis. Free-text covers the rest.
|
|
153
|
+
"options": ["21m00Tcm4TlvDq8ikWAM"],
|
|
154
|
+
"option_labels": {"21m00Tcm4TlvDq8ikWAM": "21m00Tcm4TlvDq8ikWAM (default)"},
|
|
155
|
+
},
|
|
156
|
+
"orpheus": {
|
|
157
|
+
"name": "Orpheus (local, natural)",
|
|
158
|
+
"description": "LLM-based, very natural — heavy (~2GB, slow on CPU)",
|
|
159
|
+
"local": True,
|
|
160
|
+
"requires_key": False,
|
|
161
|
+
"default_voice": "tara",
|
|
162
|
+
"option_field": "voice",
|
|
163
|
+
# `tara` is this repo's default; `jess` is the other voice already in use
|
|
164
|
+
# on this machine. Orpheus ships more — free-text reaches them.
|
|
165
|
+
"options": ["tara", "jess"],
|
|
166
|
+
},
|
|
167
|
+
"pocket": {
|
|
168
|
+
"name": "Pocket-TTS (Kyutai)",
|
|
169
|
+
"description": "Local, CPU-optimized with voice cloning (CPU)",
|
|
170
|
+
"local": True,
|
|
171
|
+
"requires_key": False,
|
|
172
|
+
"default_voice": "alba",
|
|
173
|
+
"option_field": "voice",
|
|
174
|
+
# As above: the repo default plus the voice already configured locally.
|
|
175
|
+
"options": ["alba", "vera"],
|
|
176
|
+
},
|
|
177
|
+
"none": {
|
|
178
|
+
"name": "Off",
|
|
179
|
+
"description": "Silence — no spoken output",
|
|
180
|
+
"local": True,
|
|
181
|
+
"requires_key": False,
|
|
182
|
+
"default_voice": "",
|
|
183
|
+
"option_field": "voice",
|
|
184
|
+
"options": [],
|
|
185
|
+
},
|
|
186
|
+
}
|
|
187
|
+
|
|
188
|
+
|
|
189
|
+
def stt_provider_names() -> list[str]:
|
|
190
|
+
"""Sorted list of STT provider keys."""
|
|
191
|
+
return sorted(STT_PROVIDERS)
|
|
192
|
+
|
|
193
|
+
|
|
194
|
+
def tts_provider_names() -> list[str]:
|
|
195
|
+
"""Sorted list of TTS provider keys."""
|
|
196
|
+
return sorted(TTS_PROVIDERS)
|
|
197
|
+
|
|
198
|
+
|
|
199
|
+
# ---------------------------------------------------------------------------
|
|
200
|
+
# Null provider (TTS off)
|
|
201
|
+
# ---------------------------------------------------------------------------
|
|
202
|
+
|
|
203
|
+
|
|
204
|
+
class _NullTTS:
|
|
205
|
+
"""No-op TTS provider for when speech output is disabled."""
|
|
206
|
+
|
|
207
|
+
async def speak(self, text: str) -> None:
|
|
208
|
+
"""Silently drop the text — no synthesis or playback."""
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
"""Turn assistant markdown into speakable prose (the "prose only" TTS filter).
|
|
2
|
+
|
|
3
|
+
Reading code, tables, and URLs aloud is unpleasant, so before sending a reply to
|
|
4
|
+
TTS we strip everything that doesn't sound like natural speech and cap the length
|
|
5
|
+
so a long answer doesn't monologue. Pure and dependency-free → unit-tested in
|
|
6
|
+
isolation, and importable even when the audio extras aren't installed.
|
|
7
|
+
"""
|
|
8
|
+
|
|
9
|
+
from __future__ import annotations
|
|
10
|
+
|
|
11
|
+
import re
|
|
12
|
+
|
|
13
|
+
_FENCED_CODE = re.compile(r"```.*?```", re.DOTALL)
|
|
14
|
+
_IMAGE = re.compile(r"!\[[^\]]*\]\([^)]*\)")
|
|
15
|
+
_LINK = re.compile(r"\[([^\]]+)\]\([^)]*\)") # keep the label, drop the URL
|
|
16
|
+
_BARE_URL = re.compile(r"https?://\S+")
|
|
17
|
+
_INLINE_CODE = re.compile(r"`([^`]+)`") # keep the word(s), drop the backticks
|
|
18
|
+
_TABLE_ROW = re.compile(r"^\s*\|.*\|\s*$", re.MULTILINE)
|
|
19
|
+
_HEADING = re.compile(r"^\s{0,3}#{1,6}\s*", re.MULTILINE)
|
|
20
|
+
_BLOCKQUOTE = re.compile(r"^\s*>\s?", re.MULTILINE)
|
|
21
|
+
_BULLET = re.compile(r"^\s*[-*+]\s+", re.MULTILINE)
|
|
22
|
+
_NUM_BULLET = re.compile(r"^\s*\d+\.\s+", re.MULTILINE)
|
|
23
|
+
_EMPHASIS = re.compile(r"(\*\*\*|\*\*|\*|___|__|_)(.+?)\1")
|
|
24
|
+
_MULTI_BLANK = re.compile(r"\n{3,}")
|
|
25
|
+
_MULTI_SPACE = re.compile(r"[ \t]{2,}")
|
|
26
|
+
|
|
27
|
+
_DEFAULT_MAX_CHARS = 1200
|
|
28
|
+
#: Cut at a sentence end within this many chars of the cap, if one exists.
|
|
29
|
+
_SENTENCE_END = re.compile(r"[.!?](?:\s|$)")
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
def speech_sentences(text: str) -> list[str]:
|
|
33
|
+
"""Split prose at sentence boundaries so playback need not await a whole reply."""
|
|
34
|
+
return [part for part in re.split(r"(?<=[.!?])\s+", text.strip()) if part]
|
|
35
|
+
|
|
36
|
+
|
|
37
|
+
def speakable_text(markdown: str, *, max_chars: int = _DEFAULT_MAX_CHARS) -> str:
|
|
38
|
+
"""Reduce ``markdown`` to plain, speakable prose, truncated to ``max_chars``.
|
|
39
|
+
|
|
40
|
+
Drops fenced code, images, tables, and bare URLs entirely; keeps link labels
|
|
41
|
+
and inline-code words; removes markdown markup. Truncates at the nearest
|
|
42
|
+
sentence boundary below the cap (falling back to an ellipsis).
|
|
43
|
+
"""
|
|
44
|
+
if not markdown:
|
|
45
|
+
return ""
|
|
46
|
+
|
|
47
|
+
text = _FENCED_CODE.sub(" ", markdown)
|
|
48
|
+
text = _IMAGE.sub(" ", text)
|
|
49
|
+
text = _LINK.sub(r"\1", text)
|
|
50
|
+
text = _BARE_URL.sub(" ", text)
|
|
51
|
+
text = _INLINE_CODE.sub(r"\1", text)
|
|
52
|
+
text = _TABLE_ROW.sub(" ", text)
|
|
53
|
+
text = _HEADING.sub("", text)
|
|
54
|
+
text = _BLOCKQUOTE.sub("", text)
|
|
55
|
+
text = _BULLET.sub("", text)
|
|
56
|
+
text = _NUM_BULLET.sub("", text)
|
|
57
|
+
text = _EMPHASIS.sub(r"\2", text)
|
|
58
|
+
text = _MULTI_BLANK.sub("\n\n", text)
|
|
59
|
+
text = _MULTI_SPACE.sub(" ", text)
|
|
60
|
+
text = text.strip()
|
|
61
|
+
|
|
62
|
+
if len(text) <= max_chars:
|
|
63
|
+
return text
|
|
64
|
+
return _truncate_to_sentence(text, max_chars)
|
|
65
|
+
|
|
66
|
+
|
|
67
|
+
def _truncate_to_sentence(text: str, max_chars: int) -> str:
|
|
68
|
+
"""Trim to the last sentence end at/under ``max_chars``, else ellipsize."""
|
|
69
|
+
window = text[:max_chars]
|
|
70
|
+
ends = list(_SENTENCE_END.finditer(window))
|
|
71
|
+
if ends:
|
|
72
|
+
return window[: ends[-1].end()].strip()
|
|
73
|
+
return window.rstrip() + "…"
|
|
74
|
+
|
|
75
|
+
|
|
76
|
+
def is_all_code(markdown: str) -> bool:
|
|
77
|
+
"""Return whether nothing speakable remains after filtering (skip TTS)."""
|
|
78
|
+
return not speakable_text(markdown).strip()
|
|
@@ -0,0 +1,132 @@
|
|
|
1
|
+
"""Faster-Whisper speech-to-text wrapper.
|
|
2
|
+
|
|
3
|
+
The model is loaded lazily and cached; transcription is blocking, so callers use
|
|
4
|
+
:meth:`Transcriber.transcribe`, which offloads to a worker thread via
|
|
5
|
+
``asyncio.to_thread`` to keep the event loop responsive. Imports cleanly without
|
|
6
|
+
``faster-whisper`` installed.
|
|
7
|
+
"""
|
|
8
|
+
|
|
9
|
+
from __future__ import annotations
|
|
10
|
+
|
|
11
|
+
import asyncio
|
|
12
|
+
import logging
|
|
13
|
+
from typing import TYPE_CHECKING, Any
|
|
14
|
+
|
|
15
|
+
if TYPE_CHECKING:
|
|
16
|
+
import numpy as np
|
|
17
|
+
|
|
18
|
+
logger = logging.getLogger("nova.audio.stt")
|
|
19
|
+
|
|
20
|
+
#: distil-large-v3 — near-large-v3 accuracy, much faster (good even on CPU).
|
|
21
|
+
_DEFAULT_MODEL = "distil-large-v3"
|
|
22
|
+
#: Default transcription language. Forcing a language avoids per-utterance
|
|
23
|
+
#: language mis-detection that garbles short push-to-talk clips.
|
|
24
|
+
_DEFAULT_LANGUAGE = "en"
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
def _hf_repo_for(model_size: str) -> str:
|
|
28
|
+
"""Map a Whisper model size to its HuggingFace repo (for cache detection).
|
|
29
|
+
|
|
30
|
+
A full ``org/repo`` or local path is returned unchanged. Bare sizes map to
|
|
31
|
+
the Systran faster-whisper conversions that faster-whisper downloads.
|
|
32
|
+
"""
|
|
33
|
+
if "/" in model_size:
|
|
34
|
+
return model_size
|
|
35
|
+
if model_size.startswith("distil-"):
|
|
36
|
+
# distil-large-v3 → Systran/faster-distil-whisper-large-v3
|
|
37
|
+
suffix = model_size.removeprefix("distil-")
|
|
38
|
+
return f"Systran/faster-distil-whisper-{suffix}"
|
|
39
|
+
return f"Systran/faster-whisper-{model_size}"
|
|
40
|
+
|
|
41
|
+
|
|
42
|
+
def _resolve_device(device: str) -> tuple[str, str]:
|
|
43
|
+
"""Map a requested device to a concrete ``(device, compute_type)`` pair.
|
|
44
|
+
|
|
45
|
+
``"auto"`` uses CUDA (float16) when available, else CPU (int8).
|
|
46
|
+
"""
|
|
47
|
+
if device in ("cuda", "gpu"):
|
|
48
|
+
return "cuda", "float16"
|
|
49
|
+
if device == "cpu":
|
|
50
|
+
return "cpu", "int8"
|
|
51
|
+
# auto
|
|
52
|
+
try:
|
|
53
|
+
import torch
|
|
54
|
+
|
|
55
|
+
if torch.cuda.is_available():
|
|
56
|
+
return "cuda", "float16"
|
|
57
|
+
except Exception: # noqa: BLE001 — best-effort hardware probe; any failure ⇒ CPU
|
|
58
|
+
logger.debug("CUDA probe failed; using CPU", exc_info=True)
|
|
59
|
+
return "cpu", "int8"
|
|
60
|
+
|
|
61
|
+
|
|
62
|
+
class Transcriber:
|
|
63
|
+
"""Transcribes 16 kHz int16 audio to text with Faster-Whisper."""
|
|
64
|
+
|
|
65
|
+
def __init__(
|
|
66
|
+
self,
|
|
67
|
+
*,
|
|
68
|
+
model_size: str = _DEFAULT_MODEL,
|
|
69
|
+
device: str = "auto",
|
|
70
|
+
language: str | None = _DEFAULT_LANGUAGE,
|
|
71
|
+
) -> None:
|
|
72
|
+
"""Configure the model; loading is deferred to first transcription.
|
|
73
|
+
|
|
74
|
+
``language`` forces the decode language (e.g. ``"en"``); pass ``None`` to
|
|
75
|
+
auto-detect (less reliable on short utterances).
|
|
76
|
+
"""
|
|
77
|
+
self._model_size = model_size
|
|
78
|
+
self._device_pref = device
|
|
79
|
+
self._language = language or None
|
|
80
|
+
self._model: Any = None
|
|
81
|
+
|
|
82
|
+
@property
|
|
83
|
+
def needs_download(self) -> bool:
|
|
84
|
+
"""Whether the Whisper model isn't in the HF cache yet (cheap, fail-open).
|
|
85
|
+
|
|
86
|
+
Stats the HuggingFace cache only — never loads the model. Any error
|
|
87
|
+
returns ``False`` (assume present) so a detection failure can't show a
|
|
88
|
+
"downloading" state that never clears.
|
|
89
|
+
"""
|
|
90
|
+
try:
|
|
91
|
+
from huggingface_hub import try_to_load_from_cache
|
|
92
|
+
|
|
93
|
+
repo = _hf_repo_for(self._model_size)
|
|
94
|
+
hit = try_to_load_from_cache(repo, "model.bin")
|
|
95
|
+
except Exception: # noqa: BLE001 — best-effort; assume present on any error
|
|
96
|
+
logger.debug("Whisper cache probe failed; assuming present", exc_info=True)
|
|
97
|
+
return False
|
|
98
|
+
else:
|
|
99
|
+
return hit is None
|
|
100
|
+
|
|
101
|
+
def _ensure_model(self) -> None:
|
|
102
|
+
if self._model is None:
|
|
103
|
+
from faster_whisper import WhisperModel
|
|
104
|
+
|
|
105
|
+
device, compute_type = _resolve_device(self._device_pref)
|
|
106
|
+
logger.info(
|
|
107
|
+
"Loading Faster-Whisper '%s' on %s (%s)",
|
|
108
|
+
self._model_size,
|
|
109
|
+
device,
|
|
110
|
+
compute_type,
|
|
111
|
+
)
|
|
112
|
+
self._model = WhisperModel(self._model_size, device=device, compute_type=compute_type)
|
|
113
|
+
|
|
114
|
+
async def transcribe(self, pcm_int16: np.ndarray) -> str:
|
|
115
|
+
"""Return the transcript of an int16 utterance (off the event loop)."""
|
|
116
|
+
return await asyncio.to_thread(self._transcribe_sync, pcm_int16)
|
|
117
|
+
|
|
118
|
+
def _transcribe_sync(self, pcm_int16: np.ndarray) -> str:
|
|
119
|
+
self._ensure_model()
|
|
120
|
+
audio = pcm_int16.astype("float32") / 32768.0
|
|
121
|
+
segments, _info = self._model.transcribe(
|
|
122
|
+
audio,
|
|
123
|
+
language=self._language,
|
|
124
|
+
# Whisper's own VAD trims silence and suppresses phantom transcripts
|
|
125
|
+
# it otherwise hallucinates from breath / room noise.
|
|
126
|
+
vad_filter=True,
|
|
127
|
+
# Wider beam = better accuracy on short clips (negligible cost here).
|
|
128
|
+
beam_size=5,
|
|
129
|
+
# One-shot utterances: don't let a prior segment bias the decode.
|
|
130
|
+
condition_on_previous_text=False,
|
|
131
|
+
)
|
|
132
|
+
return " ".join(seg.text.strip() for seg in segments).strip()
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
"""Deepgram cloud STT — sends 16 kHz int16 audio via aiohttp.
|
|
2
|
+
|
|
3
|
+
Requires a Deepgram API key (stored in config). See
|
|
4
|
+
https://developers.deepgram.com/reference/pre-recorded-audio
|
|
5
|
+
"""
|
|
6
|
+
|
|
7
|
+
from __future__ import annotations
|
|
8
|
+
|
|
9
|
+
import logging
|
|
10
|
+
from typing import TYPE_CHECKING
|
|
11
|
+
|
|
12
|
+
import aiohttp
|
|
13
|
+
|
|
14
|
+
if TYPE_CHECKING:
|
|
15
|
+
import numpy as np
|
|
16
|
+
|
|
17
|
+
logger = logging.getLogger("nova.audio.stt_deepgram")
|
|
18
|
+
|
|
19
|
+
_DEEPGRAM_BASE = "https://api.deepgram.com/v1"
|
|
20
|
+
_STATUS_OK = 200
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
class DeepgramTranscriber:
|
|
24
|
+
"""Transcribes 16 kHz int16 audio via the Deepgram REST API."""
|
|
25
|
+
|
|
26
|
+
def __init__(self, *, api_key: str = "", model: str = "nova-2") -> None:
|
|
27
|
+
"""Store the API key and model name."""
|
|
28
|
+
self._api_key = api_key
|
|
29
|
+
self._model = model
|
|
30
|
+
|
|
31
|
+
async def transcribe(self, pcm_int16: np.ndarray) -> str:
|
|
32
|
+
"""Send PCM audio to Deepgram and return the transcript."""
|
|
33
|
+
if not self._api_key:
|
|
34
|
+
msg = "Deepgram API key is not set."
|
|
35
|
+
raise RuntimeError(msg)
|
|
36
|
+
audio_bytes = pcm_int16.tobytes()
|
|
37
|
+
headers = {
|
|
38
|
+
"Authorization": f"Token {self._api_key}",
|
|
39
|
+
"Content-Type": "audio/l16;rate=16000;channels=1",
|
|
40
|
+
}
|
|
41
|
+
params = {
|
|
42
|
+
"model": self._model,
|
|
43
|
+
"punctuate": "true",
|
|
44
|
+
"encoding": "linear16",
|
|
45
|
+
"sample_rate": "16000",
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
async with (
|
|
49
|
+
aiohttp.ClientSession(headers=headers) as session,
|
|
50
|
+
session.post(
|
|
51
|
+
f"{_DEEPGRAM_BASE}/listen",
|
|
52
|
+
params=params,
|
|
53
|
+
data=audio_bytes,
|
|
54
|
+
timeout=aiohttp.ClientTimeout(total=60),
|
|
55
|
+
) as resp,
|
|
56
|
+
):
|
|
57
|
+
if resp.status != _STATUS_OK:
|
|
58
|
+
text = await resp.text()
|
|
59
|
+
err_msg = f"Deepgram API error ({resp.status}): {text[:200]}"
|
|
60
|
+
raise RuntimeError(err_msg)
|
|
61
|
+
result = await resp.json()
|
|
62
|
+
|
|
63
|
+
try:
|
|
64
|
+
alternatives = result["results"]["channels"][0]["alternatives"]
|
|
65
|
+
transcript = alternatives[0].get("transcript", "")
|
|
66
|
+
return transcript.strip()
|
|
67
|
+
except (KeyError, IndexError, TypeError):
|
|
68
|
+
logger.warning("Unexpected Deepgram response structure: %s", str(result)[:300])
|
|
69
|
+
return ""
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
"""ElevenLabs cloud TTS — text to speech via aiohttp, playback via sounddevice.
|
|
2
|
+
|
|
3
|
+
Requires an ElevenLabs API key (stored in config).
|
|
4
|
+
See https://elevenlabs.io/docs/api-reference/text-to-speech
|
|
5
|
+
"""
|
|
6
|
+
|
|
7
|
+
from __future__ import annotations
|
|
8
|
+
|
|
9
|
+
import asyncio
|
|
10
|
+
import logging
|
|
11
|
+
import subprocess
|
|
12
|
+
from typing import TYPE_CHECKING
|
|
13
|
+
|
|
14
|
+
import aiohttp
|
|
15
|
+
|
|
16
|
+
from novacode_cli.audio.playback import play_and_wait, run_speech
|
|
17
|
+
|
|
18
|
+
if TYPE_CHECKING:
|
|
19
|
+
import numpy as np
|
|
20
|
+
|
|
21
|
+
logger = logging.getLogger("nova.audio.stt_elevenlabs")
|
|
22
|
+
|
|
23
|
+
_ELEVENLABS_BASE = "https://api.elevenlabs.io/v1"
|
|
24
|
+
_DEFAULT_VOICE = "21m00Tcm4TlvDq8ikWAM" # Rachel
|
|
25
|
+
_STATUS_OK = 200
|
|
26
|
+
|
|
27
|
+
|
|
28
|
+
class ElevenLabsSpeaker:
|
|
29
|
+
"""Synthesises text via ElevenLabs and plays through sounddevice."""
|
|
30
|
+
|
|
31
|
+
def __init__(self, *, api_key: str = "", voice_id: str = _DEFAULT_VOICE) -> None:
|
|
32
|
+
"""Store the API key and voice ID."""
|
|
33
|
+
self._api_key = api_key
|
|
34
|
+
self._voice_id = voice_id
|
|
35
|
+
|
|
36
|
+
async def speak(self, text: str) -> None:
|
|
37
|
+
"""Send text to ElevenLabs and play the returned audio."""
|
|
38
|
+
if not self._api_key:
|
|
39
|
+
msg = (
|
|
40
|
+
"ElevenLabs API key is not set. Configure with: "
|
|
41
|
+
"/voice settings tts elevenlabs --key <key>"
|
|
42
|
+
)
|
|
43
|
+
raise RuntimeError(msg)
|
|
44
|
+
if not text.strip():
|
|
45
|
+
return
|
|
46
|
+
|
|
47
|
+
url = f"{_ELEVENLABS_BASE}/text-to-speech/{self._voice_id}"
|
|
48
|
+
headers = {
|
|
49
|
+
"Accept": "audio/mpeg",
|
|
50
|
+
"xi-api-key": self._api_key,
|
|
51
|
+
"Content-Type": "application/json",
|
|
52
|
+
}
|
|
53
|
+
payload = {
|
|
54
|
+
"text": text,
|
|
55
|
+
"model_id": "eleven_turbo_v2_5",
|
|
56
|
+
"voice_settings": {"stability": 0.5, "similarity_boost": 0.5},
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
async with (
|
|
60
|
+
aiohttp.ClientSession(headers=headers) as session,
|
|
61
|
+
session.post(url, json=payload, timeout=aiohttp.ClientTimeout(total=60)) as resp,
|
|
62
|
+
):
|
|
63
|
+
if resp.status != _STATUS_OK:
|
|
64
|
+
err = await resp.text()
|
|
65
|
+
api_msg = f"ElevenLabs API error ({resp.status}): {err[:200]}"
|
|
66
|
+
raise RuntimeError(api_msg)
|
|
67
|
+
mp3_data = await resp.read()
|
|
68
|
+
|
|
69
|
+
proc = await asyncio.to_thread(
|
|
70
|
+
subprocess.run,
|
|
71
|
+
["ffmpeg", "-i", "-", "-f", "s16le", "-ar", "22050", "-ac", "1", "-"],
|
|
72
|
+
input=mp3_data,
|
|
73
|
+
capture_output=True,
|
|
74
|
+
timeout=60,
|
|
75
|
+
)
|
|
76
|
+
if proc.returncode != 0:
|
|
77
|
+
err = proc.stderr.decode(errors="replace")[:200]
|
|
78
|
+
fmsg = f"ffmpeg decode failed: {err}"
|
|
79
|
+
raise RuntimeError(fmsg)
|
|
80
|
+
|
|
81
|
+
import numpy as np
|
|
82
|
+
|
|
83
|
+
pcm = np.frombuffer(proc.stdout, dtype="int16")
|
|
84
|
+
if len(pcm) == 0:
|
|
85
|
+
return
|
|
86
|
+
await run_speech(lambda: self._play_and_wait(pcm))
|
|
87
|
+
|
|
88
|
+
def _play_and_wait(self, pcm: np.ndarray) -> None:
|
|
89
|
+
play_and_wait(pcm, 22050)
|